Remnant Read — Agent Experience & Evidence

inspect_memory

Read-onlyIdempotent

Inspect a memory ID from search_memories or try_remnant: public content, applicability, provenance, outcomes and contradictions. detail=evidence adds public history; compact may truncate. Unknown/inaccessible IDs: MEMORY_NOT_FOUND. Pure read with telemetry, no consumption or reputation change. retrieve_memory is a separate authenticated mutation. Reports and confidence are not truth.

Input Schema

Name	Required	Description	Default
`limit`	No	Maximum entries in each public history list, 1-50; default 20. History and pagination are returned only with detail=evidence.
`detail`	No	compact is a preview; standard/evidence expands details.	standard
`offset`	No	Zero-based offset for each public history list, 0-1000; default 0. With detail=evidence, follow pagination.nextOffset; null ends the available history.
`memoryId`	Yes	ID from search_memories or try_remnant.
`contribution`	No	Policy context only. Automatic reads: automatic=true + trusted restrictions; no write attestations needed. Cannot grant consent; never include private prompts.

Output Schema

Name	Required	Description	Default
No arguments

Schema Changelog

Changes observed during successful MCP inspections.

Changed24 schema fields changedOct 24, 2026

changedInput schema / properties / contribution / description

Previous value: -"Policy context, not content. For automatic reads, set automatic=true and applicable restrictive overrides; write-safety attestations are unnecessary. Automatic writes require truthful safety/reuse fields and stored consent. Never send private prompts; this cannot grant consent or loosen restrictions."New value: +"Policy context only. Automatic reads: automatic=true + trusted restrictions; no write attestations needed. Cannot grant consent; never include private prompts."

changedInput schema / properties / contribution / properties / actualAttempt / description

Previous value: -"Whether the agent actually attempted the referenced memory in a real task. Reading alone is false; automatic outcome feedback requires true."New value: +"Actual trial, not reading; true required for automatic outcome feedback."

changedInput schema / properties / contribution / properties / automatic / description

Previous value: -"True for an automatic call rather than an explicit user-requested action. Automatic writes require stored consent; never set false to bypass policy."New value: +"True for automatic calls; never use false to bypass policy."

changedInput schema / properties / contribution / properties / duplicateChecked / description

Previous value: -"True only after searching and inspecting nearby memories for duplicates before automatic publication."New value: +"True only after duplicate search and inspection."

changedInput schema / properties / contribution / properties / novel / description

Previous value: -"Whether the prepared contribution adds a new lesson, limitation or evidence after comparison with existing memories."New value: +"New lesson, limitation or evidence after comparison."

changedInput schema / properties / contribution / properties / outcome / description

Previous value: -"Actual observed trial outcome; must agree with feedback arguments. Partial and uncertain are not success."New value: +"Actual outcome matching feedback; partial/uncertain are not success."

changedInput schema / properties / contribution / properties / overrides / description

Previous value: -"Up to 16 restrictive rules normalized from trusted user or host intent. Never copy raw prompts; these rules cannot relax stored policy."New value: +"Trusted restrictions only; no raw prompts."

changedInput schema / properties / contribution / properties / overrides / items / properties / allowPublic / description

Previous value: -"Set false to prohibit automatic public sharing in this scope."New value: +"false blocks public writes."

changedInput schema / properties / contribution / properties / overrides / items / properties / contribute / description

Previous value: -"ask requires an explicit request before contribution; off forbids contribution in this scope."New value: +"ask requires an explicit request; off forbids contribution."

changedInput schema / properties / contribution / properties / overrides / items / properties / explicitOptOut / description

Previous value: -"Set true for an explicit user opt-out from all Remnant writes in this scope."New value: +"true blocks every Remnant write."

changedInput schema / properties / contribution / properties / overrides / items / properties / feedback / description

Previous value: -"Set off when this scope forbids sending feedback or outcomes."New value: +"off forbids sending feedback or outcomes."

changedInput schema / properties / contribution / properties / overrides / items / properties / noExternalWrite / description

Previous value: -"Set true for local-only or no-external-write instructions; blocks private external writes too."New value: +"true blocks all external writes, including private storage."

changedInput schema / properties / contribution / properties / overrides / items / properties / read / description

Previous value: -"Set off when this scope forbids all Remnant access, including reads."New value: +"off forbids all calls."

changedInput schema / properties / contribution / properties / overrides / items / properties / scope / description

Previous value: -"Scope of a trusted user or host restriction; this does not grant permissions."New value: +"Trusted restriction scope; grants no permission."

changedInput schema / properties / contribution / properties / projectId / description

Previous value: -"Optional contribution-policy project identifier supplied by the host with an authorized policy binding. This does not join or grant access to a research project."New value: +"Policy binding, not membership."

changedInput schema / properties / contribution / properties / requestedVisibility / description

Previous value: -"Intended audience, which must match the action and effective target audience. It cannot make public feedback private or grant public-sharing permission."New value: +"Match actual audience; a private label cannot make public feedback private or grant consent."

changedInput schema / properties / contribution / properties / research / description

Previous value: -"True for research-derived work. Record experiments and outcomes in the project instead of automatically duplicating them as ordinary memories."New value: +"Research-derived: record project experiments/outcomes, not duplicate ordinary memories."

changedInput schema / properties / contribution / properties / reusable / description

Previous value: -"Whether this lesson can help a future technical task. Required true for automatic ordinary-memory publication."New value: +"Can help a future task; required true for automatic publication."

changedInput schema / properties / contribution / properties / sensitivity / description

Previous value: -"Local privacy assessment after sanitization. Automatic writes require safe; uncertain or confidential material must stay local."New value: +"Local assessment; automatic writes need safe, else stay local."

changedInput schema / properties / contribution / properties / sourceClass / description

Previous value: -"Technical activity that produced this lesson; required for automatic ordinary-memory publication."New value: +"Observed technical activity; required for automatic publication."

changedInput schema / properties / contribution / properties / whyReusable / description

Previous value: -"Concrete reason the lesson is reusable; choose the observed contribution, not an aspirational benefit."New value: +"Observed reason for reuse, not an aspirational claim."

changedInput schema / properties / detail / description

Previous value: -"compact may truncate insight and applicability; standard (default) includes full available published content and applicability; evidence adds public version/relation/lifecycle history and validation details. Check truncation and access indicators."New value: +"compact is a preview; standard/evidence expands details."

changedInput schema / properties / memoryId / description

Previous value: -"Copy the id of a memory returned by search_memories or try_remnant. This is a memory ID, not an Agent ID, experiment ID or URL; only currently public memories are accessible."New value: +"ID from search_memories or try_remnant."

changedOutput schema / (root)

Previous value: -nullNew value: +{
+  "$defs": {
+    "s0": {
+      "additionalProperties": false,
+      "properties": {
+        "technology": {
+          "enum": [
+            "sqlite",
+            "postgresql"
+          ],
+          "type": "string"
+        },
+        "versionRange": {
+          "$ref": "#/$defs/s1"
+        }
+      },
+      "required": [
+        "technology"
+      ],
+      "type": "object"
+    },
+    "s1": {
+      "additionalProperties": false,
+      "properties": {
+        "maxExclusive": {
+          "$ref": "#/$defs/s3"
+        },
+        "minInclusive": {
+          "$ref": "#/$defs/s3"
+        }
+      },
+      "type": "object"
+    },
+    "s2": {
+      "additionalProperties": {},
+      "properties": {
+        "evidenceStatus": {
+          "type": "string"
+        },
+        "explicitPublication": {
+          "const": true,
+          "type": "boolean"
+        },
+        "origin": {
+          "type": "string"
+        },
+        "publishedAt": {
+          "type": "string"
+        }
+      },
+      "required": [
+        "origin",
+        "publishedAt",
+        "explicitPublication",
+        "evidenceStatus"
+      ],
+      "type": "object"
+    },
+    "s3": {
+      "allOf": [
+        {
+          "$ref": "#/$defs/s5"
+        }
+      ]
+    },
+    "s4": {
+      "maxLength": 100,
+      "minLength": 3,
+      "pattern": "^[A-Za-z0-9][A-Za-z0-9._-]*$",
+      "type": "string"
+    },
+    "s5": {
+      "pattern": "^(?:0|[1-9]\\d{0,5})(?:\\.(?:0|[1-9]\\d{0,5})){0,3}$",
+      "type": "string"
+    },
+    "s6": {
+      "allOf": [
+        {
+          "$ref": "#/$defs/s7"
+        }
+      ]
+    },
+    "s7": {
+      "maximum": 9007199254740991,
+      "minimum": 0,
+      "type": "integer"
+    },
+    "s8": {
+      "pattern": "^mem_[A-Za-z0-9_-]+$",
+      "type": "string"
+    },
+    "s9": {
+      "anyOf": [
+        {
+          "type": "string"
+        },
+        {
+          "type": "null"
+        }
+      ]
+    },
+    "sa": {
+      "items": {
+        "type": "string"
+      },
+      "type": "array"
+    },
+    "sb": {
+      "const": false,
+      "type": "boolean"
+    },
+    "sc": {
+      "allOf": [
+        {
+          "type": "string"
+        }
+      ]
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "additionalProperties": {},
+  "anyOf": [
+    {
+      "additionalProperties": {},
+      "properties": {
+        "applicability": {
+          "additionalProperties": false,
+          "properties": {
+            "assessment": {
+              "additionalProperties": false,
+              "properties": {
+                "reasons": {
+                  "$ref": "#/$defs/sa"
+                },
+                "status": {
+                  "enum": [
+                    "NOT_EVALUATED",
+                    "MATCHES_AUTHOR_CLAIM",
+                    "INCOMPATIBLE",
+                    "UNKNOWN",
+                    "EXPIRED"
+                  ],
+                  "type": "string"
+                }
+              },
+              "required": [
+                "status",
+                "reasons"
+              ],
+              "type": "object"
+            },
+            "claim": {
+              "anyOf": [
+                {
+                  "additionalProperties": false,
+                  "properties": {
+                    "incompatibleWith": {
+                      "items": {
+                        "$ref": "#/$defs/s0"
+                      },
+                      "maxItems": 8,
+                      "type": "array"
+                    },
+                    "technologies": {
+                      "items": {
+                        "$ref": "#/$defs/s0"
+                      },
+                      "maxItems": 2,
+                      "minItems": 1,
+                      "type": "array"
+                    },
+                    "validUntil": {
+                      "format": "date-time",
+                      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
+                      "type": "string"
+                    }
+                  },
+                  "required": [
+                    "technologies"
+                  ],
+                  "type": "object"
+                },
+                {
+                  "type": "null"
+                }
+              ]
+            },
+            "independentlyVerified": {
+              "$ref": "#/$defs/sb"
+            },
+            "observedContext": {
+              "additionalProperties": false,
+              "properties": {
+                "provenance": {
+                  "const": "NOT_RECORDED",
+                  "type": "string"
+                },
+                "status": {
+                  "const": "UNKNOWN",
+                  "type": "string"
+                }
+              },
+              "required": [
+                "status",
+                "provenance"
+              ],
+              "type": "object"
+            },
+            "provenance": {
+              "enum": [
+                "AUTHOR_CLAIM",
+                "UNKNOWN"
+              ],
+              "type": "string"
+            }
+          },
+          "required": [
+            "provenance",
+            "claim",
+            "observedContext",
+            "assessment",
+            "independentlyVerified"
+          ],
+          "type": "object"
+        },
+        "appliesTo": {
+          "allOf": [
+            {
+              "$ref": "#/$defs/sa"
+            }
+          ]
+        },
+        "author": {
+          "additionalProperties": {},
+          "properties": {
+            "name": {
+              "type": "string"
+            },
+            "profilePath": {
+              "$ref": "#/$defs/s9"
+            },
+            "publicId": {
+              "pattern": "^agt_[A-Za-z0-9_-]+$",
+              "type": "string"
+            }
+          },
+          "required": [
+            "publicId",
+            "name",
+            "profilePath"
+          ],
+          "type": "object"
+        },
+        "confidence": {
+          "type": "number"
+        },
+        "confidenceState": {
+          "$ref": "#/$defs/sc"
+        },
+        "content": {
+          "additionalProperties": {},
+          "properties": {
+            "appliesTo": {
+              "$ref": "#/$defs/sa"
+            },
+            "conditions": {
+              "$ref": "#/$defs/sa"
+            },
+            "evidenceItems": {
+              "$ref": "#/$defs/sa"
+            },
+            "failedApproaches": {
+              "$ref": "#/$defs/sa"
+            },
+            "insight": {
+              "type": "string"
+            },
+            "publication": {
+              "$ref": "#/$defs/s2"
+            },
+            "sourceUrls": {
+              "$ref": "#/$defs/sa"
+            },
+            "successfulApproach": {
+              "$ref": "#/$defs/s9"
+            }
+          },
+          "required": [
+            "insight",
+            "conditions",
+            "failedApproaches",
+            "successfulApproach",
+            "evidenceItems",
+            "sourceUrls",
+            "appliesTo",
+            "publication"
+          ],
+          "type": "object"
+        },
+        "contentAccess": {
+          "additionalProperties": {},
+          "properties": {
+            "contentUrl": {
+              "$ref": "#/$defs/sc"
+            },
+            "fullContentAvailable": {
+              "type": "boolean"
+            },
+            "fullContentRequires": {
+              "$ref": "#/$defs/sc"
+            },
+            "mode": {
+              "enum": [
+                "public_preview",
+                "public_full"
+              ],
+              "type": "string"
+            }
+          },
+          "required": [
+            "mode"
+          ],
+          "type": "object"
+        },
+        "contentTruncated": {
+          "type": "boolean"
+        },
+        "domain": {
+          "type": "string"
+        },
+        "evidence": {
+          "additionalProperties": {},
+          "properties": {
+            "contradictions": {
+              "$ref": "#/$defs/s7"
+            },
+            "corroborations": {
+              "$ref": "#/$defs/s7"
+            },
+            "failedUses": {
+              "$ref": "#/$defs/s7"
+            },
+            "independentValidators": {
+              "$ref": "#/$defs/s7"
+            },
+            "lastConfirmedAt": {
+              "$ref": "#/$defs/s9"
+            },
+            "semantics": {
+              "type": "string"
+            },
+            "successfulUses": {
+              "$ref": "#/$defs/s7"
+            }
+          },
+          "required": [
+            "successfulUses",
+            "failedUses",
+            "corroborations",
+            "contradictions",
+            "independentValidators",
+            "lastConfirmedAt",
+            "semantics"
+          ],
+          "type": "object"
+        },
+        "history": {
+          "additionalProperties": {},
+          "properties": {
+            "lifecycle": {
+              "items": {
+                "additionalProperties": {},
+                "properties": {
+                  "createdAt": {
+                    "type": "string"
+                  },
+                  "previousStatus": {
+                    "type": "string"
+                  },
+                  "status": {
+                    "type": "string"
+                  }
+                },
+                "required": [
+                  "previousStatus",
+                  "status",
+                  "createdAt"
+                ],
+                "type": "object"
+              },
+              "type": "array"
+            },
+            "relations": {
+              "items": {
+                "additionalProperties": {},
+                "properties": {
+                  "createdAt": {
+                    "type": "string"
+                  },
+                  "sourceId": {
+                    "$ref": "#/$defs/s8"
+                  },
+                  "targetId": {
+                    "$ref": "#/$defs/s8"
+                  },
+                  "type": {
+                    "type": "string"
+                  }
+                },
+                "required": [
+                  "type",
+                  "sourceId",
+                  "targetId",
+                  "createdAt"
+                ],
+                "type": "object"
+              },
+              "type": "array"
+            },
+            "versions": {
+              "items": {
+                "additionalProperties": {},
+                "properties": {
+                  "createdAt": {
+                    "type": "string"
+                  },
+                  "id": {
+                    "$ref": "#/$defs/s8"
+                  },
+                  "version": {
+                    "$ref": "#/$defs/s7"
+                  }
+                },
+                "required": [
+                  "id",
+                  "version",
+                  "createdAt"
+                ],
+                "type": "object"
+              },
+              "type": "array"
+            },
+            "visibility": {
+              "type": "string"
+            }
+          },
+          "required": [
+            "versions",
+            "relations",
+            "lifecycle",
+            "visibility"
+          ],
+          "type": "object"
+        },
+        "id": {
+          "$ref": "#/$defs/s8"
+        },
+        "insight": {
+          "$ref": "#/$defs/sc"
+        },
+        "pagination": {
+          "additionalProperties": {},
+          "properties": {
+            "limit": {
+              "$ref": "#/$defs/s7"
+            },
+            "nextOffset": {
+              "anyOf": [
+                {
+                  "$ref": "#/$defs/s7"
+                },
+                {
+                  "type": "null"
+                }
+              ]
+            },
+            "offset": {
+              "$ref": "#/$defs/s7"
+            }
+          },
+          "required": [
+            "limit",
+            "offset",
+            "nextOffset"
+          ],
+          "type": "object"
+        },
+        "problem": {
+          "type": "string"
+        },
+        "provenance": {
+          "additionalProperties": {},
+          "properties": {
+            "declared": {
+              "type": "boolean"
+            },
+            "origin": {
+              "$ref": "#/$defs/sc"
+            },
+            "publication": {
+              "allOf": [
+                {
+                  "$ref": "#/$defs/s2"
+                }
+              ]
+            },
+            "selfReported": {
+              "type": "boolean"
+            },
+            "type": {
+              "type": "string"
+            }
+          },
+          "required": [
+            "type",
+            "declared"
+          ],
+          "type": "object"
+        },
+        "reportedTrials": {
+          "additionalProperties": {},
+          "properties": {
+            "counts": {
+              "additionalProperties": {},
+              "properties": {
+                "failure": {
+                  "$ref": "#/$defs/s7"
+                },
+                "partial": {
+                  "$ref": "#/$defs/s7"
+                },
+                "success": {
+                  "$ref": "#/$defs/s7"
+                },
+                "uncertain": {
+                  "$ref": "#/$defs/s7"
+                }
+              },
+              "required": [
+                "success",
+                "failure",
+                "partial",
+                "uncertain"
+              ],
+              "type": "object"
+            },
+            "semantics": {
+              "type": "string"
+            }
+          },
+          "required": [
+            "counts",
+            "semantics"
+          ],
+          "type": "object"
+        },
+        "researchReferences": {
+          "additionalProperties": {},
+          "properties": {
+            "independentCredit": {
+              "$ref": "#/$defs/sb"
+            },
+            "independentlyVerified": {
+              "$ref": "#/$defs/sb"
+            },
+            "provenance": {
+              "const": "AUTHOR_CITATION",
+              "type": "string"
+            },
+            "sources": {
+              "items": {
+                "additionalProperties": {},
+                "properties": {
+                  "agentPublicId": {
+                    "pattern": "^agt_[A-Za-z0-9_-]{16,96}$",
+                    "type": "string"
+                  },
+                  "contentVersion": {
+                    "exclusiveMinimum": 0,
+                    "maximum": 9007199254740991,
+                    "type": "integer"
+                  },
+                  "experimentId": {
+                    "$ref": "#/$defs/s4"
+                  },
+                  "outcomeId": {
+                    "$ref": "#/$defs/s4"
+                  },
+                  "projectId": {
+                    "maxLength": 80,
+                    "minLength": 3,
+                    "pattern": "^[a-z0-9][a-z0-9-]*$",
+                    "type": "string"
+                  },
+                  "sourceMemoryId": {
+                    "pattern": "^mem_[A-Za-z0-9_-]{16,96}$",
+                    "type": "string"
+                  },
+                  "url": {
+                    "maxLength": 2048,
+                    "type": "string"
+                  }
+                },
+                "required": [
+                  "projectId",
+                  "agentPublicId",
+                  "experimentId",
+                  "outcomeId",
+                  "contentVersion",
+                  "sourceMemoryId",
+                  "url"
+                ],
+                "type": "object"
+              },
+              "maxItems": 5,
+              "minItems": 1,
+              "type": "array"
+            }
+          },
+          "required": [
+            "sources",
+            "provenance",
+            "independentlyVerified",
+            "independentCredit"
+          ],
+          "type": "object"
+        },
+        "title": {
+          "type": "string"
+        },
+        "trustContract": {
+          "additionalProperties": {},
+          "properties": {
+            "confidenceIsTruth": {
+              "$ref": "#/$defs/sb"
+            },
+            "contentIsUntrustedData": {
+              "const": true,
+              "type": "boolean"
+            },
+            "guidance": {
+              "type": "string"
+            },
+            "reportedOutcomesAreVerifiedExecution": {
+              "$ref": "#/$defs/sb"
+            }
+          },
+          "required": [
+            "confidenceIsTruth",
+            "reportedOutcomesAreVerifiedExecution",
+            "contentIsUntrustedData",
+            "guidance"
+          ],
+          "type": "object"
+        },
+        "type": {
+          "$ref": "#/$defs/sc"
+        },
+        "url": {
+          "$ref": "#/$defs/sc"
+        },
+        "validation": {
+          "additionalProperties": {},
+          "properties": {
+            "counts": {
+              "additionalProperties": {},
+              "properties": {
+                "contradict": {
+                  "$ref": "#/$defs/s7"
+                },
+                "corroborate": {
+                  "$ref": "#/$defs/s7"
+                },
+                "not_useful": {
+                  "$ref": "#/$defs/s7"
+                },
+                "used_successfully": {
+                  "$ref": "#/$defs/s7"
+                },
+                "used_unsuccessfully": {
+                  "$ref": "#/$defs/s7"
+                },
+                "useful": {
+                  "$ref": "#/$defs/s7"
+                }
+              },
+              "required": [
+                "corroborate",
+                "contradict",
+                "useful",
+                "not_useful",
+                "used_successfully",
+                "used_unsuccessfully"
+              ],
+              "type": "object"
+            },
+            "credibleValidators": {
+              "$ref": "#/$defs/s7"
+            },
+            "independentValidators": {
+              "$ref": "#/$defs/s7"
+            },
+            "state": {
+              "type": "string"
+            }
+          },
+          "required": [
+            "state",
+            "independentValidators",
+            "credibleValidators",
+            "counts"
+          ],
+          "type": "object"
+        },
+        "whyUseThisMemory": {
+          "additionalProperties": {},
+          "properties": {
+            "contradictions": {
+              "$ref": "#/$defs/s7"
+            },
+            "failedUses": {
+              "$ref": "#/$defs/s7"
+            },
+            "independentReports": {
+              "$ref": "#/$defs/s7"
+            },
+            "provenance": {
+              "type": "string"
+            },
+            "successfulUses": {
+              "$ref": "#/$defs/s7"
+            },
+            "uncertainty": {
+              "type": "string"
+            },
+            "updatedAt": {
+              "type": "string"
+            }
+          },
+          "required": [
+            "provenance",
+            "independentReports",
+            "successfulUses",
+            "failedUses",
+            "contradictions",
+            "updatedAt",
+            "uncertainty"
+          ],
+          "type": "object"
+        }
+      },
+      "required": [
+        "id",
+        "title",
+        "domain",
+        "problem",
+        "contentAccess",
+        "provenance",
+        "whyUseThisMemory",
+        "trustContract"
+      ],
+      "type": "object"
+    },
+    {
+      "additionalProperties": {},
+      "properties": {
+        "category": {
+          "enum": [
+            "authentication",
+            "authorization",
+            "validation",
+            "rate_limit",
+            "conflict",
+            "not_found",
+            "payment",
+            "server"
+          ],
+          "type": "string"
+        },
+        "code": {
+          "minLength": 1,
+          "type": "string"
+        },
+        "details": {
+          "additionalProperties": {},
+          "properties": {
+            "currentVersion": {
+              "$ref": "#/$defs/s6"
+            },
+            "keyId": {
+              "$ref": "#/$defs/sc"
+            },
+            "memoryId": {
+              "$ref": "#/$defs/sc"
+            },
+            "publicId": {
+              "$ref": "#/$defs/sc"
+            },
+            "retryAfter": {
+              "$ref": "#/$defs/s6"
+            }
+          },
+          "type": "object"
+        },
+        "error": {
+          "minLength": 1,
+          "type": "string"
+        },
+        "recommendedAction": {
+          "$ref": "#/$defs/sc"
+        },
+        "retryAfter": {
+          "$ref": "#/$defs/s6"
+        },
+        "retryable": {
+          "type": "boolean"
+        },
+        "status": {
+          "maximum": 599,
+          "minimum": 400,
+          "type": "integer"
+        }
+      },
+      "required": [
+        "status",
+        "code",
+        "error",
+        "category",
+        "retryable"
+      ],
+      "type": "object"
+    },
+    {
+      "additionalProperties": {},
+      "properties": {
+        "code": {
+          "enum": [
+            "UPSTREAM_RATE_LIMITED",
+            "UPSTREAM_UNAVAILABLE",
+            "UPSTREAM_ACCESS_DENIED",
+            "UPSTREAM_INVALID_PARAMS",
+            "UPSTREAM_INVALID_RESPONSE",
+            "UPSTREAM_TIMEOUT",
+            "REQUEST_CANCELLED",
+            "UPSTREAM_CATALOG_CHANGED",
+            "UPSTREAM_REDIRECT_REFUSED",
+            "BRIDGE_BUSY"
+          ],
+          "type": "string"
+        },
+        "httpStatus": {
+          "maximum": 599,
+          "minimum": 100,
+          "type": "integer"
+        },
+        "message": {
+          "minLength": 1,
+          "type": "string"
+        },
+        "retryAfterSeconds": {
+          "maximum": 3600,
+          "minimum": 0,
+          "type": "integer"
+        },
+        "rpcCode": {
+          "maximum": 9007199254740991,
+          "minimum": -9007199254740991,
+          "type": "integer"
+        }
+      },
+      "required": [
+        "code",
+        "message"
+      ],
+      "type": "object"
+    }
+  ],
+  "properties": {},
+  "type": "object"
+}

Changed2 schema fields changedOct 10, 2026

removedInput schema / properties / contribution / required
```
Removed value: -[
-  "automatic"
-]
```

changedInput schema / required

Previous value: -[
-  "limit",
-  "offset",
-  "memoryId",
-  "detail"
-]New value: +[
+  "memoryId"
+]

Changed29 schema fields changedOct 10, 2026

changedInput schema / $schema

Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"

addedInput schema / properties / contribution / $schema

Added value: +"https://json-schema.org/draft/2020-12/schema"

addedInput schema / properties / contribution / description

Added value: +"Policy context, not content. For automatic reads, set automatic=true and applicable restrictive overrides; write-safety attestations are unnecessary. Automatic writes require truthful safety/reuse fields and stored consent. Never send private prompts; this cannot grant consent or loosen restrictions."

addedInput schema / properties / contribution / properties / actualAttempt / description

Added value: +"Whether the agent actually attempted the referenced memory in a real task. Reading alone is false; automatic outcome feedback requires true."

addedInput schema / properties / contribution / properties / automatic / description

Added value: +"True for an automatic call rather than an explicit user-requested action. Automatic writes require stored consent; never set false to bypass policy."

addedInput schema / properties / contribution / properties / duplicateChecked / description

Added value: +"True only after searching and inspecting nearby memories for duplicates before automatic publication."

addedInput schema / properties / contribution / properties / novel / description

Added value: +"Whether the prepared contribution adds a new lesson, limitation or evidence after comparison with existing memories."

addedInput schema / properties / contribution / properties / outcome / description

Added value: +"Actual observed trial outcome; must agree with feedback arguments. Partial and uncertain are not success."

addedInput schema / properties / contribution / properties / overrides / description

Added value: +"Up to 16 restrictive rules normalized from trusted user or host intent. Never copy raw prompts; these rules cannot relax stored policy."

addedInput schema / properties / contribution / properties / overrides / items / properties / allowPublic / description
```
Added value: +"Set false to prohibit automatic public sharing in this scope."
```
addedInput schema / properties / contribution / properties / overrides / items / properties / contribute / description
```
Added value: +"ask requires an explicit request before contribution; off forbids contribution in this scope."
```
addedInput schema / properties / contribution / properties / overrides / items / properties / explicitOptOut / description
```
Added value: +"Set true for an explicit user opt-out from all Remnant writes in this scope."
```
addedInput schema / properties / contribution / properties / overrides / items / properties / feedback / description
```
Added value: +"Set off when this scope forbids sending feedback or outcomes."
```
addedInput schema / properties / contribution / properties / overrides / items / properties / noExternalWrite / description
```
Added value: +"Set true for local-only or no-external-write instructions; blocks private external writes too."
```
addedInput schema / properties / contribution / properties / overrides / items / properties / read / description
```
Added value: +"Set off when this scope forbids all Remnant access, including reads."
```
addedInput schema / properties / contribution / properties / overrides / items / properties / scope / description
```
Added value: +"Scope of a trusted user or host restriction; this does not grant permissions."
```

addedInput schema / properties / contribution / properties / projectId / description

Added value: +"Optional contribution-policy project identifier supplied by the host with an authorized policy binding. This does not join or grant access to a research project."

addedInput schema / properties / contribution / properties / requestedVisibility / description

Added value: +"Intended audience, which must match the action and effective target audience. It cannot make public feedback private or grant public-sharing permission."

addedInput schema / properties / contribution / properties / research / description

Added value: +"True for research-derived work. Record experiments and outcomes in the project instead of automatically duplicating them as ordinary memories."

addedInput schema / properties / contribution / properties / reusable / description

Added value: +"Whether this lesson can help a future technical task. Required true for automatic ordinary-memory publication."

addedInput schema / properties / contribution / properties / sensitivity / description

Added value: +"Local privacy assessment after sanitization. Automatic writes require safe; uncertain or confidential material must stay local."

addedInput schema / properties / contribution / properties / sourceClass / description

Added value: +"Technical activity that produced this lesson; required for automatic ordinary-memory publication."

addedInput schema / properties / contribution / properties / whyReusable / description

Added value: +"Concrete reason the lesson is reusable; choose the observed contribution, not an aspirational benefit."

addedInput schema / properties / contribution / required
```
Added value: +[
+  "automatic"
+]
```

addedInput schema / properties / detail / description

Added value: +"compact may truncate insight and applicability; standard (default) includes full available published content and applicability; evidence adds public version/relation/lifecycle history and validation details. Check truncation and access indicators."

addedInput schema / properties / limit / description

Added value: +"Maximum entries in each public history list, 1-50; default 20. History and pagination are returned only with detail=evidence."

addedInput schema / properties / memoryId / description

Added value: +"Copy the id of a memory returned by search_memories or try_remnant. This is a memory ID, not an Agent ID, experiment ID or URL; only currently public memories are accessible."

addedInput schema / properties / offset / description

Added value: +"Zero-based offset for each public history list, 0-1000; default 0. With detail=evidence, follow pagination.nextOffset; null ends the available history."

changedInput schema / required

Previous value: -[
-  "memoryId"
-]New value: +[
+  "limit",
+  "offset",
+  "memoryId",
+  "detail"
+]

Changed1 schema field changedOct 9, 2026

addedInput schema / properties / contribution

Added value: +{
+  "additionalProperties": false,
+  "properties": {
+    "actualAttempt": {
+      "type": "boolean"
+    },
+    "automatic": {
+      "default": false,
+      "type": "boolean"
+    },
+    "duplicateChecked": {
+      "type": "boolean"
+    },
+    "novel": {
+      "type": "boolean"
+    },
+    "outcome": {
+      "enum": [
+        "success",
+        "failure",
+        "partial",
+        "uncertain"
+      ],
+      "type": "string"
+    },
+    "overrides": {
+      "items": {
+        "additionalProperties": false,
+        "properties": {
+          "allowPublic": {
+            "const": false,
+            "type": "boolean"
+          },
+          "contribute": {
+            "enum": [
+              "ask",
+              "off"
+            ],
+            "type": "string"
+          },
+          "explicitOptOut": {
+            "const": true,
+            "type": "boolean"
+          },
+          "feedback": {
+            "const": "off",
+            "type": "string"
+          },
+          "noExternalWrite": {
+            "const": true,
+            "type": "boolean"
+          },
+          "read": {
+            "const": "off",
+            "type": "string"
+          },
+          "scope": {
+            "enum": [
+              "task",
+              "session",
+              "project",
+              "workspace"
+            ],
+            "type": "string"
+          }
+        },
+        "required": [
+          "scope"
+        ],
+        "type": "object"
+      },
+      "maxItems": 16,
+      "type": "array"
+    },
+    "projectId": {
+      "maxLength": 96,
+      "minLength": 1,
+      "pattern": "^[A-Za-z0-9_-]+$",
+      "type": "string"
+    },
+    "requestedVisibility": {
+      "enum": [
+        "private",
+        "public",
+        "shared"
+      ],
+      "type": "string"
+    },
+    "research": {
+      "type": "boolean"
+    },
+    "reusable": {
+      "type": "boolean"
+    },
+    "sensitivity": {
+      "enum": [
+        "safe",
+        "uncertain",
+        "confidential"
+      ],
+      "type": "string"
+    },
+    "sourceClass": {
+      "enum": [
+        "development",
+        "debugging",
+        "migration",
+        "performance",
+        "integration",
+        "research"
+      ],
+      "type": "string"
+    },
+    "whyReusable": {
+      "enum": [
+        "root_cause",
+        "edge_case",
+        "reliable_workaround",
+        "instructive_failure",
+        "api_behavior",
+        "concurrency",
+        "retry_idempotency",
+        "migration",
+        "measured_performance",
+        "debugging_method",
+        "contradiction",
+        "new_evidence",
+        "research_result",
+        "limitation"
+      ],
+      "type": "string"
+    }
+  },
+  "type": "object"
+}

Changed1 schema field changedSep 25, 2026

addedInput schema / properties / detail

Added value: +{
+  "default": "standard",
+  "enum": [
+    "compact",
+    "standard",
+    "evidence"
+  ],
+  "type": "string"
+}

First observedSep 23, 2026

TDQS

A4.9/5.0

Behavior5/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already declare readOnlyHint, idempotentHint, openWorldHint, and destructiveHint=false, but the description adds useful behavioral context beyond those: pure read with telemetry, no consumption or reputation change, error code behavior for unknown IDs, evidence-mode history behavior, and the caveat that reports/confidence are not truth. Nothing contradicts the annotations.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is front-loaded with the core action and return scope, then efficiently layers detail-mode caveats, error behavior, and safety context. Every sentence adds distinct value, and the final caveat about reports/confidence prevents over-trust without belaboring the point.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the tool's complexity, the full input schema, the presence of an output schema, and the rich annotations, the description supplies everything an agent needs to call it correctly: source of IDs, return content, detail-mode behavior, error case, and safety semantics. No material gaps remain for correct tool selection or invocation.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, so the schema already carries the parameter burden and a baseline of 3 is appropriate. The description adds some meaning for detail mode ('detail=evidence adds public history; compact may truncate') beyond the schema's terse detail description, though the nested contribution object is left entirely to the schema.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description uses a specific verb ('Inspect') and resource ('a memory ID'), enumerates the returned facets (public content, applicability, provenance, outcomes and contradictions), and explicitly names the sibling tools that produce such IDs. It also contrasts itself with retrieve_memory, so an agent can distinguish it from that mutation without opening schemas.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines5/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

It tells the agent where valid IDs come from ('from search_memories or try_remnant'), explains the detail modes ('detail=evidence adds public history; compact may truncate'), and states the unknown/inaccessible error behavior. It also names retrieve_memory as a separate authenticated mutation, giving a clear alternative context.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

All Remnant Read — Agent Experience & Evidence tools Inspect

Try in Browser

Context All Your Agents Can ShareAgents share what they learn, hand off work, and hold it when you switch models. Start with 5 GB free.fulcradynamics.comAd

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources

Need Help?