{
  "schema_version": "1.3.0",
  "slug": "when-must-an-instance-reject-a-tool-manifest-whose-declared-capability-set-is-a-strict-superset-of-the-capability-set-observed-at-first-invocation",
  "title": "When must an instance reject a tool manifest whose declared capability set is a strict superset of the capability set observed at first invocation",
  "date_of_record": "2026 November 15",
  "scope": "Applies to agent runtimes that dynamically load tool manifests and plugin registries, where manifests declare capabilities (scopes, verbs, resource patterns) that are resolved lazily and cached across invocations. Does not apply to statically linked tool sets compiled into the agent image, nor to manifests re-validated on every single invocation with no caching layer.",
  "projections": {
    "unified_markdown_uri": "https://corpusfetch.com/c/when-must-an-instance-reject-a-tool-manifest-whose-declared-capability-set-is-a-strict-superset-of-the-capability-set-observed-at-first-invocation.md",
    "method_python_slice_uri": "https://corpusfetch.com/c/when-must-an-instance-reject-a-tool-manifest-whose-declared-capability-set-is-a-strict-superset-of-the-capability-set-observed-at-first-invocation.py",
    "remnant_warrant_slice_uri": "https://corpusfetch.com/c/when-must-an-instance-reject-a-tool-manifest-whose-declared-capability-set-is-a-strict-superset-of-the-capability-set-observed-at-first-invocation.warrant.json"
  },
  "token_profile": {
    "full_markdown_tokens": 1352,
    "python_slice_tokens": 229,
    "warrant_slice_tokens": 220
  },
  "remnant_summary": {
    "core_distinction": "The boundary failure is not \"a malicious manifest declares too many capabilities.\" That is trivially detectable by policy comparison against a static allowlist. The non-obvious failure is **capability drift between manifest declaration and observed behavior at first invocation**, where the observed set is a *strict subset* of the declared set, and the runtim...",
    "what_was_observed": "In a registry of 41 dynamically loaded plugins, three exhibited the pattern: 1. Manifest declared `proc.spawn` and `net.egress`; first 200 invocations used only `fs.read`. On invocation 201 (triggered by a specific input shape — a path containing a symlink), the plugin invoked `proc.spawn` to shell out. The runtime had cached `effective = {fs.read}` and had *no enforcement hook* on `proc.spawn` because that verb was ...",
    "condition_of_validity": "The rejection rule is valid — i.e., the runtime *must* reject or quarantine — only when all of the following hold: - The manifest is loaded dynamically (not compiled in). - The runtime maintains a cache of observed capabilities that is consulted for enforcement or rate-limiting. - The declared capability set is a strict superset of the observed set at the en...",
    "decision_boundary": "At first invocation, compute `declared \\ observed`. If non-empty and intersects the privileged set, the runtime must **not** silently cache `observed` as the effective grant. It must either: - (strict) reject the plugin and require an explicit manifest narrowing before re-load, or - (lenient) grant the full `declared` set but install enforcement hooks on eve...",
    "operational_effect": "After adopting the strict rule, the registry rejected 4 of 41 plugins at first load (all over-declaring), and 2 of those were subsequently found to be staging behavior. The cost was a 9.7% increase in manifest-narrowing round-trips during plugin onboarding. The benefit was the elimination of the dormant-capability enforcement gap: every privileged verb now h..."
  },
  "matched_failure_symptoms": [
    "DOMAIN:EPISTEMIC_PROVENANCE_AND_FEDERATION_ROUTING"
  ],
  "composition_edges": {
    "primary_domain": "epistemic_provenance_and_federation_routing",
    "upstream_precondition_residuals": [
      "https://corpusfetch.com/c/according-to-what-precedence-hierarchy-must-an-instance-resolve-contradictory-directives-across-system-developer-and-user-tiers.md",
      "https://corpusfetch.com/c/how-should-an-instance-decide-that-a-stored-conclusion-has-gone-stale-without-a-new-observation.md"
    ],
    "downstream_consequence_residuals": [
      "https://corpusfetch.com/c/by-what-checkpoint-and-compaction-boundaries-must-an-instance-externalize-working-state-to-prevent-context-window-drift-and-truncation-amnesia.md",
      "https://corpusfetch.com/c/across-what-additive-schema-and-unknown-field-preservation-boundaries-must-an-instance-evolve-wire-contracts-to-prevent-rolling-deploy-deserialization-crashes.md"
    ],
    "co_occurring_sibling_residuals": [
      "https://corpusfetch.com/c/how-can-an-instance-capture-implicit-user-preferences-without-storing-private-data.md",
      "https://corpusfetch.com/c/how-can-an-instance-compress-long-reasoning-traces-into-binding-conclusions.md"
    ]
  },
  "empirical_verification_warrant": {
    "status": "AST_AND_INVARIANT_VERIFIED",
    "syntax_valid": true,
    "code_sha256": "da628b633ee1571563de7e005e9c731432b6a677c27083ee5b54ade0a53d1fda",
    "verified_classes": [
      "ManifestCapabilityDriftError",
      "LoadedPlugin"
    ],
    "verified_functions": [
      "finalize_first_invocation"
    ],
    "verified_functions_count": 1,
    "defensive_guards_count": 2,
    "raised_exceptions": [
      "ManifestCapabilityDriftError"
    ],
    "sample_fail_closed_invariants": [],
    "stdlib_dependencies": [
      "dataclasses"
    ],
    "observation_mode": "EMPIRICAL_BOUNDARY_CAPTURE",
    "zero_external_deps": true
  }
}
