{"id":"fleet-memory","title":"Fleet memory: your agents' shared observations of endpoints, rate limits, IVR paths and ambiguous submissions","description":"Lets every agent in your fleet record what it observed and read what the others saw, with freshness: endpoint brownouts and latency, rate-limit behaviour, IVR menu paths that worked, whether an ambiguous submission was later accepted or rejected, fixes for an error signature, stale feeds, page recipes, merchant workflow failures, document reputation. record() appends timestamped observations for a subject; query() returns counts per outcome, the latest observations, value percentiles and the age of the newest. Scoped to your wallet or tenantId and never pooled across customers; it only knows what your agents recorded (status unknown when nothing is recent).","roi":"One agent's 20-minute rediscovery becomes every other agent's $0.005 lookup.","audience":"agent-infra","package":"agent-coordination-kit","channels":["x402","mcp"],"endpoint":{"method":"POST","url":"https://agents.writerslogic.com/api/v1/fleet-memory","path":"/api/v1/fleet-memory","contentType":"application/json"},"price":{"amount":"0.005","currency":"USDC","network":"base","perCall":true,"failedCallsCharged":false},"inputSchema":{"type":"object","additionalProperties":false,"required":["op","namespace","subject"],"properties":{"op":{"type":"string","enum":["record","query"]},"namespace":{"type":"string","enum":["endpoint-health","rate-limit","ivr-path","submission-outcome","failure-fix","feed-staleness","page-recipe","merchant-workflow","document-reputation","custom"]},"subject":{"type":"string","pattern":"^[A-Za-z0-9_.:/@+-]{1,200}$","description":"What was observed, e.g. api.stripe.com:POST:/v1/refunds, +18005551234:billing, or an error fingerprint."},"observations":{"type":"array","maxItems":50,"items":{"type":"object","additionalProperties":false,"required":["outcome","observedAt"],"properties":{"outcome":{"type":"string","pattern":"^[A-Za-z0-9_.:-]{1,64}$","description":"e.g. ok, timeout, 429, accepted, rejected, path-worked."},"observedAt":{"type":"string","maxLength":40,"description":"ISO 8601 with offset; within the last 30 days."},"value":{"type":"number","description":"Optional measurement, e.g. latency ms or hold minutes."},"unit":{"type":"string","maxLength":16},"detail":{"type":"string","maxLength":500,"description":"e.g. the menu path 1,3,2 or the fix applied. Do not store personal data."},"by":{"type":"string","maxLength":64,"description":"Recording worker id."}}}},"sinceHours":{"type":"integer","minimum":1,"maximum":720,"description":"query window; default 168 (7 days)."},"tenantId":{"type":"string","pattern":"^[A-Za-z0-9_.-]{1,64}$","description":"Required for API-key callers (namespaced as key:<tenantId>; keep it unguessable). Ignored when a wallet paid: the payer address is the tenant."},"requestId":{"type":"string","pattern":"^[A-Za-z0-9_.:-]{1,128}$","description":"Caller-chosen id for this mutation. A retry with the same id and same input returns the stored response (24 h) instead of applying twice; the same id with different input is rejected. Send one on every mutation you may retry: without it a retry is applied again (fleet-memory record appends a duplicate; a repeated spend-ledger commit or release answers NO_HOLD because the first call already took effect)."}}},"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."},"op":{"type":"string"},"recorded":{"type":"integer"},"window":{"type":"object","properties":{"sinceHours":{"type":"integer"},"observations":{"type":"integer"}}},"byOutcome":{"type":"array","items":{"type":"object","properties":{"outcome":{"type":"string"},"count":{"type":"integer"},"lastObservedAt":{"type":"string"}}}},"latest":{"type":"array","items":{"type":"object"}},"value":{"anyOf":[{"type":"object","properties":{"count":{"type":"integer"},"min":{"type":"number"},"p50":{"type":"number"},"p90":{"type":"number"},"max":{"type":"number"},"unit":{"anyOf":[{"type":"string"},{"type":"null"}]}}},{"type":"null"}]},"newestAgeSeconds":{"anyOf":[{"type":"integer"},{"type":"null"}]},"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."},"op":{"type":"string"},"recorded":{"type":"integer"},"window":{"type":"object","properties":{"sinceHours":{"type":"integer"},"observations":{"type":"integer"}}},"byOutcome":{"type":"array","items":{"type":"object","properties":{"outcome":{"type":"string"},"count":{"type":"integer"},"lastObservedAt":{"type":"string"}}}},"latest":{"type":"array","items":{"type":"object"}},"value":{"anyOf":[{"type":"object","properties":{"count":{"type":"integer"},"min":{"type":"number"},"p50":{"type":"number"},"p90":{"type":"number"},"max":{"type":"number"},"unit":{"anyOf":[{"type":"string"},{"type":"null"}]}}},{"type":"null"}]},"newestAgeSeconds":{"anyOf":[{"type":"integer"},{"type":"null"}]},"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":{"op":"query","namespace":"endpoint-health","subject":"api.example.com:POST:/v1/orders","sinceHours":24},"openapiOperation":{"operationId":"fleet_memory","summary":"Fleet memory: your agents' shared observations of endpoints, rate limits, IVR paths and ambiguous submissions","description":"Lets every agent in your fleet record what it observed and read what the others saw, with freshness: endpoint brownouts and latency, rate-limit behaviour, IVR menu paths that worked, whether an ambiguous submission was later accepted or rejected, fixes for an error signature, stale feeds, page recipes, merchant workflow failures, document reputation. record() appends timestamped observations for a subject; query() returns counts per outcome, the latest observations, value percentiles and the age of the newest. Scoped to your wallet or tenantId and never pooled across customers; it only knows what your agents recorded (status unknown when nothing is recent).\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/fleet-memory","security":[{"x402":[]},{"apiKey":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["op","namespace","subject"],"properties":{"op":{"type":"string","enum":["record","query"]},"namespace":{"type":"string","enum":["endpoint-health","rate-limit","ivr-path","submission-outcome","failure-fix","feed-staleness","page-recipe","merchant-workflow","document-reputation","custom"]},"subject":{"type":"string","pattern":"^[A-Za-z0-9_.:/@+-]{1,200}$","description":"What was observed, e.g. api.stripe.com:POST:/v1/refunds, +18005551234:billing, or an error fingerprint."},"observations":{"type":"array","maxItems":50,"items":{"type":"object","additionalProperties":false,"required":["outcome","observedAt"],"properties":{"outcome":{"type":"string","pattern":"^[A-Za-z0-9_.:-]{1,64}$","description":"e.g. ok, timeout, 429, accepted, rejected, path-worked."},"observedAt":{"type":"string","maxLength":40,"description":"ISO 8601 with offset; within the last 30 days."},"value":{"type":"number","description":"Optional measurement, e.g. latency ms or hold minutes."},"unit":{"type":"string","maxLength":16},"detail":{"type":"string","maxLength":500,"description":"e.g. the menu path 1,3,2 or the fix applied. Do not store personal data."},"by":{"type":"string","maxLength":64,"description":"Recording worker id."}}}},"sinceHours":{"type":"integer","minimum":1,"maximum":720,"description":"query window; default 168 (7 days)."},"tenantId":{"type":"string","pattern":"^[A-Za-z0-9_.-]{1,64}$","description":"Required for API-key callers (namespaced as key:<tenantId>; keep it unguessable). Ignored when a wallet paid: the payer address is the tenant."},"requestId":{"type":"string","pattern":"^[A-Za-z0-9_.:-]{1,128}$","description":"Caller-chosen id for this mutation. A retry with the same id and same input returns the stored response (24 h) instead of applying twice; the same id with different input is rejected. Send one on every mutation you may retry: without it a retry is applied again (fleet-memory record appends a duplicate; a repeated spend-ledger commit or release answers NO_HOLD because the first call already took effect)."}}},"example":{"op":"query","namespace":"endpoint-health","subject":"api.example.com:POST:/v1/orders","sinceHours":24}}}},"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."},"op":{"type":"string"},"recorded":{"type":"integer"},"window":{"type":"object","properties":{"sinceHours":{"type":"integer"},"observations":{"type":"integer"}}},"byOutcome":{"type":"array","items":{"type":"object","properties":{"outcome":{"type":"string"},"count":{"type":"integer"},"lastObservedAt":{"type":"string"}}}},"latest":{"type":"array","items":{"type":"object"}},"value":{"anyOf":[{"type":"object","properties":{"count":{"type":"integer"},"min":{"type":"number"},"p50":{"type":"number"},"p90":{"type":"number"},"max":{"type":"number"},"unit":{"anyOf":[{"type":"string"},{"type":"null"}]}}},{"type":"null"}]},"newestAgeSeconds":{"anyOf":[{"type":"integer"},{"type":"null"}]},"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/fleet-memory/","docsJson":"https://agents.writerslogic.com/docs/fleet-memory.json","sample":"https://agents.writerslogic.com/api/v1/samples/fleet-memory","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"}}