{"id":"cache-key-check","title":"Check that a result-cache key contains every input that changes the result, and nothing volatile","description":"Given the inputs of a cached computation (each declared as influencing the output or not, optionally volatile) and the list of inputs the cache key is built from, finds influential inputs missing from the key (stale or wrong hits), volatile inputs inside it (the cache never hits), unknown-influence inputs left out, and, for private results, a missing tenant dimension (cross-tenant leak). When values are given it also returns a deterministic key digest (RFC 8785 JSON + SHA-256). Does not inspect code to find what influences the output: that is declared by the caller.","roi":"A cache key that omits one input serves one user's answer to another; one that includes a timestamp is a cache that never hits.","audience":"agent-infra","package":"execution-safety-kit","channels":["x402","mcp"],"endpoint":{"method":"POST","url":"https://agents.writerslogic.com/api/v1/cache-key-check","path":"/api/v1/cache-key-check","contentType":"application/json"},"price":{"amount":"0.005","currency":"USDC","network":"base","perCall":true,"failedCallsCharged":false},"inputSchema":{"type":"object","additionalProperties":false,"required":["inputs","keyParts"],"properties":{"inputs":{"type":"array","minItems":1,"maxItems":100,"items":{"type":"object","additionalProperties":false,"required":["name","influencesOutput"],"properties":{"name":{"type":"string","minLength":1,"maxLength":200},"influencesOutput":{"type":"string","enum":["yes","no","unknown"]},"volatile":{"type":"boolean","description":"Changes on every call (timestamp, request id, nonce)."},"value":{"description":"Optional value, used only to compute the key digest."}}}},"keyParts":{"type":"array","maxItems":100,"items":{"type":"string","minLength":1,"maxLength":200},"description":"Names of the inputs the key is built from."},"scope":{"type":"string","maxLength":200,"description":"Namespace mixed into the digest."},"private":{"type":"boolean","description":"The result is per-tenant or per-user."},"tenantInput":{"type":"string","minLength":1,"maxLength":200,"description":"Name of the input that identifies the tenant or user; required in the key when private."}}},"resultSchema":{"type":"object","properties":{"status":{"type":"string","enum":["pass","fail","unknown","unsupported"],"description":"pass: every rule held. fail: a rule was violated (see witnesses). unknown: the input lacks the evidence to decide. unsupported: outside what this engine covers. Missing evidence is never a pass."},"missing":{"type":"array","items":{"type":"string"},"description":"Influential inputs absent from the key."},"unclassifiedMissing":{"type":"array","items":{"type":"string"},"description":"Unknown-influence inputs absent from the key."},"volatileInKey":{"type":"array","items":{"type":"string"}},"unknownKeyParts":{"type":"array","items":{"type":"string"},"description":"Key parts that are not declared inputs."},"keyDigest":{"type":"string","description":"Present when every key part has a value."},"witnesses":{"type":"array","items":{"type":"object","properties":{"ruleId":{"type":"string"},"detail":{"type":"string"},"path":{"type":"string","description":"JSON pointer or dotted path into the input."},"offset":{"type":"integer"},"index":{"type":"integer"},"expected":{"description":"What the rule required."},"actual":{"description":"What the input had."}}}},"versions":{"type":"object","description":"Every semantic dependency of this answer (engine, tables and their as-of dates, tokenizer, calendar, rounding profile)."},"limits":{"type":"array","items":{"type":"string"}},"deterministic":{"type":"boolean","description":"Always true: pure code, no model."}}},"outputSchema":{"type":"object","properties":{"data":{"type":"object","properties":{"status":{"type":"string","enum":["pass","fail","unknown","unsupported"],"description":"pass: every rule held. fail: a rule was violated (see witnesses). unknown: the input lacks the evidence to decide. unsupported: outside what this engine covers. Missing evidence is never a pass."},"missing":{"type":"array","items":{"type":"string"},"description":"Influential inputs absent from the key."},"unclassifiedMissing":{"type":"array","items":{"type":"string"},"description":"Unknown-influence inputs absent from the key."},"volatileInKey":{"type":"array","items":{"type":"string"}},"unknownKeyParts":{"type":"array","items":{"type":"string"},"description":"Key parts that are not declared inputs."},"keyDigest":{"type":"string","description":"Present when every key part has a value."},"witnesses":{"type":"array","items":{"type":"object","properties":{"ruleId":{"type":"string"},"detail":{"type":"string"},"path":{"type":"string","description":"JSON pointer or dotted path into the input."},"offset":{"type":"integer"},"index":{"type":"integer"},"expected":{"description":"What the rule required."},"actual":{"description":"What the input had."}}}},"versions":{"type":"object","description":"Every semantic dependency of this answer (engine, tables and their as-of dates, tokenizer, calendar, rounding profile)."},"limits":{"type":"array","items":{"type":"string"}},"deterministic":{"type":"boolean","description":"Always true: pure code, no model."}}},"_provenance":{"type":"object","description":"C2PA-aligned manifest and W3C VC 2.0 (eddsa-jcs-2022) issued by the hub DID; verify at POST /api/v1/verify-provenance"}},"required":["data","_provenance"]},"example":{"inputs":[{"name":"query","influencesOutput":"yes","value":"shoes"},{"name":"locale","influencesOutput":"yes","value":"de-DE"},{"name":"requestId","influencesOutput":"no","volatile":true,"value":"r-1"}],"keyParts":["query"],"scope":"search:v3"},"openapiOperation":{"operationId":"cache_key_check","summary":"Check that a result-cache key contains every input that changes the result, and nothing volatile","description":"Given the inputs of a cached computation (each declared as influencing the output or not, optionally volatile) and the list of inputs the cache key is built from, finds influential inputs missing from the key (stale or wrong hits), volatile inputs inside it (the cache never hits), unknown-influence inputs left out, and, for private results, a missing tenant dimension (cross-tenant leak). When values are given it also returns a deterministic key digest (RFC 8785 JSON + SHA-256). Does not inspect code to find what influences the output: that is declared by the caller.\n\nPrice: 0.005 USDC on Base (x402).","x-x402-price-usdc":"0.005","x-x402-amount":"5000","x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.005"}},"x-audience":"agent-infra","x-sample-url":"https://agents.writerslogic.com/api/v1/samples/cache-key-check","security":[{"x402":[]},{"apiKey":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["inputs","keyParts"],"properties":{"inputs":{"type":"array","minItems":1,"maxItems":100,"items":{"type":"object","additionalProperties":false,"required":["name","influencesOutput"],"properties":{"name":{"type":"string","minLength":1,"maxLength":200},"influencesOutput":{"type":"string","enum":["yes","no","unknown"]},"volatile":{"type":"boolean","description":"Changes on every call (timestamp, request id, nonce)."},"value":{"description":"Optional value, used only to compute the key digest."}}}},"keyParts":{"type":"array","maxItems":100,"items":{"type":"string","minLength":1,"maxLength":200},"description":"Names of the inputs the key is built from."},"scope":{"type":"string","maxLength":200,"description":"Namespace mixed into the digest."},"private":{"type":"boolean","description":"The result is per-tenant or per-user."},"tenantInput":{"type":"string","minLength":1,"maxLength":200,"description":"Name of the input that identifies the tenant or user; required in the key when private."}}},"example":{"inputs":[{"name":"query","influencesOutput":"yes","value":"shoes"},{"name":"locale","influencesOutput":"yes","value":"de-DE"},{"name":"requestId","influencesOutput":"no","volatile":true,"value":"r-1"}],"keyParts":["query"],"scope":"search:v3"}}}},"responses":{"200":{"description":"Paid result with provenance","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"status":{"type":"string","enum":["pass","fail","unknown","unsupported"],"description":"pass: every rule held. fail: a rule was violated (see witnesses). unknown: the input lacks the evidence to decide. unsupported: outside what this engine covers. Missing evidence is never a pass."},"missing":{"type":"array","items":{"type":"string"},"description":"Influential inputs absent from the key."},"unclassifiedMissing":{"type":"array","items":{"type":"string"},"description":"Unknown-influence inputs absent from the key."},"volatileInKey":{"type":"array","items":{"type":"string"}},"unknownKeyParts":{"type":"array","items":{"type":"string"},"description":"Key parts that are not declared inputs."},"keyDigest":{"type":"string","description":"Present when every key part has a value."},"witnesses":{"type":"array","items":{"type":"object","properties":{"ruleId":{"type":"string"},"detail":{"type":"string"},"path":{"type":"string","description":"JSON pointer or dotted path into the input."},"offset":{"type":"integer"},"index":{"type":"integer"},"expected":{"description":"What the rule required."},"actual":{"description":"What the input had."}}}},"versions":{"type":"object","description":"Every semantic dependency of this answer (engine, tables and their as-of dates, tokenizer, calendar, rounding profile)."},"limits":{"type":"array","items":{"type":"string"}},"deterministic":{"type":"boolean","description":"Always true: pure code, no model."}}},"_provenance":{"type":"object","description":"C2PA-aligned manifest and W3C VC 2.0 (eddsa-jcs-2022) issued by the hub DID; verify at POST /api/v1/verify-provenance"}},"required":["data","_provenance"]}}}},"400":{"description":"Invalid request (no payment consumed)","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}},"401":{"description":"Invalid X-API-KEY","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}},"402":{"description":"Payment required or invalid","content":{"application/json":{"schema":{"type":"object","description":"x402 v2 PaymentRequired (also base64 in the PAYMENT-REQUIRED header)","properties":{"x402Version":{"type":"integer"},"error":{"type":"string"},"code":{"type":"string"},"resource":{"type":"object"},"accepts":{"type":"array","items":{"type":"object"}},"extensions":{"type":"object"}}}}}},"502":{"description":"Upstream failure; the payment is released or not settled","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}}}},"links":{"docs":"https://agents.writerslogic.com/docs/cache-key-check/","docsJson":"https://agents.writerslogic.com/docs/cache-key-check.json","sample":"https://agents.writerslogic.com/api/v1/samples/cache-key-check","openapi":"https://agents.writerslogic.com/openapi.json","catalog":"https://agents.writerslogic.com/api/v1/catalog","verifyProvenance":"https://agents.writerslogic.com/api/v1/verify-provenance","index":"https://agents.writerslogic.com/docs/index.json"}}