@openwop/spec-artifacts 2.44.5 → 2.44.7

package/schemas/v2/error-envelope.schema.json

@@ -2,7 +2,7 @@
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "$id": "https://openwop.dev/spec/v2/error-envelope.schema.json",
   "title": "ErrorEnvelope (v2)",
-  "description": "GENERATED from spec/v2/errors.json by scripts/generate-error-envelope.mjs (RFC 0171 §B.1). 111 registered codes; vendor codes match ^(?!openwop\\.)[a-z][a-z0-9]*(-[a-z0-9]+)*\\.[a-z][a-z0-9_]*$. Consumers MUST accept an unknown registered member and MUST NOT act on it (RFC 0171 §A.5).",
+  "description": "GENERATED from spec/v2/errors.json by scripts/generate-error-envelope.mjs (RFC 0171 §B.1). 120 registered codes; vendor codes match ^(?!openwop\\.)[a-z][a-z0-9]*(-[a-z0-9]+)*\\.[a-z][a-z0-9_]*$. Consumers MUST accept an unknown registered member and MUST NOT act on it (RFC 0171 §A.5).",
   "type": "object",
   "additionalProperties": false,
   "required": [
@@ -125,7 +125,16 @@
             "pack_registry_unreachable",
             "runner_unavailable",
             "unknown_envelope_kind",
-            "unknown_schema_version"
+            "unknown_schema_version",
+            "storage_limit_exceeded",
+            "egress_denied",
+            "upstream_unavailable",
+            "budget_exhausted",
+            "budget_model_denied",
+            "service_unavailable",
+            "run_expired",
+            "provider_policy_denied",
+            "eval_gate_unmet"
           ]
         },
         {
@@ -288,6 +297,264 @@
           }
         }
       }
+    },
+    {
+      "if": {
+        "properties": {
+          "error": {
+            "const": "storage_limit_exceeded"
+          }
+        },
+        "required": [
+          "error"
+        ]
+      },
+      "then": {
+        "properties": {
+          "details": {
+            "type": "object",
+            "required": [
+              "service",
+              "limit"
+            ],
+            "properties": {
+              "service": {
+                "type": "string",
+                "minLength": 1,
+                "description": "The host-service family key (`fs`, `kvStorage`, `secrets`, `queueBus`, …)."
+              },
+              "limit": {
+                "type": "string",
+                "minLength": 1,
+                "description": "The advertised field that was exceeded (`maxValueBytes`, `maxTtlSeconds`, `maxRowsPerTable`, …), or `quota`."
+              }
+            },
+            "additionalProperties": true,
+            "x-openwop-error": "storage_limit_exceeded"
+          }
+        }
+      }
+    },
+    {
+      "if": {
+        "properties": {
+          "error": {
+            "const": "egress_denied"
+          }
+        },
+        "required": [
+          "error"
+        ]
+      },
+      "then": {
+        "properties": {
+          "details": {
+            "type": "object",
+            "required": [
+              "reason"
+            ],
+            "properties": {
+              "reason": {
+                "enum": [
+                  "out-of-audience",
+                  "expired",
+                  "ssrf-blocked",
+                  "provenance-unevaluable",
+                  "scope-denied",
+                  "policy-denied"
+                ],
+                "description": "The `egress.decided` reason, from its closed set minus `ok`."
+              }
+            },
+            "additionalProperties": true,
+            "x-openwop-error": "egress_denied"
+          }
+        }
+      }
+    },
+    {
+      "if": {
+        "properties": {
+          "error": {
+            "const": "upstream_unavailable"
+          }
+        },
+        "required": [
+          "error"
+        ]
+      },
+      "then": {
+        "properties": {
+          "details": {
+            "type": "object",
+            "required": [
+              "service"
+            ],
+            "properties": {
+              "service": {
+                "type": "string",
+                "minLength": 1,
+                "description": "The host-service family key (`fs`, `kvStorage`, `secrets`, `queueBus`, …)."
+              }
+            },
+            "additionalProperties": true,
+            "x-openwop-error": "upstream_unavailable"
+          }
+        }
+      }
+    },
+    {
+      "if": {
+        "properties": {
+          "error": {
+            "const": "budget_exhausted"
+          }
+        },
+        "required": [
+          "error"
+        ]
+      },
+      "then": {
+        "properties": {
+          "details": {
+            "type": "object",
+            "required": [
+              "dimension"
+            ],
+            "properties": {
+              "dimension": {
+                "enum": [
+                  "tokens",
+                  "costUsd",
+                  "toolCalls",
+                  "retries"
+                ],
+                "description": "The budget dimension that was exhausted."
+              }
+            },
+            "additionalProperties": true,
+            "x-openwop-error": "budget_exhausted"
+          }
+        }
+      }
+    },
+    {
+      "if": {
+        "properties": {
+          "error": {
+            "const": "budget_model_denied"
+          }
+        },
+        "required": [
+          "error"
+        ]
+      },
+      "then": {
+        "properties": {
+          "details": {
+            "type": "object",
+            "properties": {
+              "model": {
+                "type": "string",
+                "minLength": 1,
+                "description": "OPTIONAL. The refused model."
+              }
+            },
+            "additionalProperties": true,
+            "x-openwop-error": "budget_model_denied"
+          }
+        }
+      }
+    },
+    {
+      "if": {
+        "properties": {
+          "error": {
+            "const": "run_expired"
+          }
+        },
+        "required": [
+          "error"
+        ]
+      },
+      "then": {
+        "properties": {
+          "details": {
+            "type": "object",
+            "properties": {
+              "runId": {
+                "$ref": "ids.schema.json#/$defs/runId",
+                "description": "OPTIONAL. The expired run."
+              }
+            },
+            "additionalProperties": true,
+            "x-openwop-error": "run_expired"
+          }
+        }
+      }
+    },
+    {
+      "if": {
+        "properties": {
+          "error": {
+            "const": "provider_policy_denied"
+          }
+        },
+        "required": [
+          "error"
+        ]
+      },
+      "then": {
+        "properties": {
+          "details": {
+            "type": "object",
+            "required": [
+              "provider"
+            ],
+            "properties": {
+              "provider": {
+                "type": "string",
+                "minLength": 1,
+                "description": "The refused provider."
+              },
+              "reason": {
+                "type": "string",
+                "minLength": 1,
+                "description": "OPTIONAL. The policy cause (`provider-disabled`, `model-not-allowed`, …)."
+              }
+            },
+            "additionalProperties": true,
+            "x-openwop-error": "provider_policy_denied"
+          }
+        }
+      }
+    },
+    {
+      "if": {
+        "properties": {
+          "error": {
+            "const": "eval_gate_unmet"
+          }
+        },
+        "required": [
+          "error"
+        ]
+      },
+      "then": {
+        "properties": {
+          "details": {
+            "type": "object",
+            "properties": {
+              "evalRunId": {
+                "$ref": "ids.schema.json#/$defs/runId",
+                "description": "OPTIONAL. The eval run the gate requires."
+              }
+            },
+            "additionalProperties": true,
+            "x-openwop-error": "eval_gate_unmet"
+          }
+        }
+      }
     }
   ],
   "x-openwop-http-status": {
@@ -401,13 +668,24 @@
     "pack_registry_unreachable": 503,
     "runner_unavailable": 503,
     "unknown_envelope_kind": 422,
-    "unknown_schema_version": 422
+    "unknown_schema_version": 422,
+    "storage_limit_exceeded": 422,
+    "egress_denied": 403,
+    "upstream_unavailable": 502,
+    "budget_exhausted": 422,
+    "budget_model_denied": 422,
+    "service_unavailable": 503,
+    "run_expired": 410,
+    "provider_policy_denied": 422,
+    "eval_gate_unmet": 422
   },
   "x-openwop-retriable": [
     "residency_unavailable",
     "rate_limited",
     "internal_error",
     "pack_registry_unreachable",
-    "runner_unavailable"
+    "runner_unavailable",
+    "upstream_unavailable",
+    "service_unavailable"
   ]
 }

package/schemas/v2/node-pack-manifest.schema.json

@@ -316,7 +316,7 @@
             "provider": {
               "type": "string",
               "pattern": "^[a-z][a-z0-9-]*$",
-              "description": "Provider id per `capabilities.aiProviders.supported` (e.g., `anthropic`, `openai`, `gemini`). MUST be in the host's `capabilities.aiProviders.supported[]` for the substitution to fire; otherwise the host emits `model.capability.insufficient` with `fallbackAttempted: true`."
+              "description": "Provider id per `capabilities.aiProviders.providers` (e.g., `anthropic`, `openai`, `gemini`). MUST be in the host's `capabilities.aiProviders.providers[]` for the substitution to fire; otherwise the host emits `model.capability-insufficient` with `fallbackAttempted: true`."
             },
             "model": {
               "type": "string",
@@ -358,7 +358,7 @@
         },
         "provider": {
           "type": "string",
-          "description": "For `kind: 'ai-provider'`, the provider id (`anthropic`, `openai`, `gemini`, etc.). MUST be in `Capabilities.aiProviders.supported`. Optional for other kinds."
+          "description": "For `kind: 'ai-provider'`, the provider id (`anthropic`, `openai`, `gemini`, etc.). MUST be in `capabilities.aiProviders.providers`. Optional for other kinds."
         },
         "scope": {
           "type": "string",

package/schemas/v2/prompt-ref.schema.json

@@ -2,7 +2,7 @@
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "$id": "https://openwop.dev/spec/v2/prompt-ref.schema.json",
   "title": "PromptRef",
-  "description": "Reference to a PromptTemplate. Two equivalent forms are accepted: a compact stringy URI (`prompt:templateId[@version]`) and a structured object form. The stringy form is canonical for inline use in WorkflowNode.config and AgentManifest.promptOverrides; the object form is canonical when libraryId disambiguation, variable overrides, or pinned versions need to be expressed explicitly. See spec/v1/prompts.md §\"PromptRef\" for the canonical contract and RFC 0027 §B for the rationale.\n\nResolution semantics (host responsibility): the host looks up the referenced template in its library (host built-ins + installed packs + user templates, gated by capabilities.prompts.*). When no `version` is given, the latest version wins. When two installed packs ship the same templateId, the stringy form is rejected with `prompt_ref_ambiguous` and consumers MUST use the object form with `libraryId` to disambiguate (RFC 0028 §B \"Conflict resolution\").",
+  "description": "Reference to a PromptTemplate. Two equivalent forms are accepted: a compact stringy URI (`prompt:templateId[@version]`) and a structured object form. The stringy form is canonical for inline use in WorkflowNode.config and AgentManifest.promptOverrides; the object form is canonical when libraryId disambiguation, variable overrides, or pinned versions need to be expressed explicitly. See spec/v1/prompts.md §\"PromptRef\" for the canonical contract and RFC 0027 §B for the rationale.\n\nResolution semantics (host responsibility): the host looks up the referenced template in its library (host built-ins + installed packs + user templates, gated by capabilities.prompts.*). When no `version` is given, the latest version wins. When two installed packs ship the same templateId, the stringy form is rejected with `validation_error` (`details.field: libraryId`) and consumers MUST use the object form with `libraryId` to disambiguate (RFC 0028 §B \"Conflict resolution\").",
   "oneOf": [
     {
       "type": "string",
@@ -37,6 +37,5 @@
         }
       }
     }
-  ],
-  "x-openwop-seeded-from": "v1"
+  ]
 }

package/schemas/v2/prompt-template.schema.json

@@ -2,7 +2,7 @@
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "$id": "https://openwop.dev/spec/v2/prompt-template.schema.json",
   "title": "PromptTemplate",
-  "description": "Canonical wire shape for a named, versioned, variable-bound prompt body referenced by workflow nodes and agent manifests. See spec/v1/prompts.md §\"PromptTemplate\" for the canonical contract, RFC 0027 for the rationale, and prompt-ref.schema.json for the reference type that points at instances of this shape. Variable interpolation MUST use Mustache-compatible `{{varName}}` placeholders; unresolved required variables MUST cause the node to fail with `prompt_variable_unresolved`; unresolved optional variables render as the empty string per RFC 0027 §A.\n\nThe `text` field MAY contain `<UNTRUSTED>...</UNTRUSTED>` markers verbatim — hosts MUST preserve them through composition per SECURITY/threat-model-prompt-injection.md. Variables sourced from `secret` MUST be replaced with `[REDACTED:<secretId>]` markers in any observability output (e.g., `prompt.composed` events) per SECURITY/threat-model-secret-leakage.md §SR-1.",
+  "description": "Canonical wire shape for a named, versioned, variable-bound prompt body referenced by workflow nodes and agent manifests. See spec/v1/prompts.md §\"PromptTemplate\" for the canonical contract, RFC 0027 for the rationale, and prompt-ref.schema.json for the reference type that points at instances of this shape. Variable interpolation MUST use Mustache-compatible `{{varName}}` placeholders; unresolved required variables MUST cause the node to fail with `node_config_invalid`; unresolved optional variables render as the empty string per RFC 0027 §A.\n\nThe `text` field MAY contain `<UNTRUSTED>...</UNTRUSTED>` markers verbatim — hosts MUST preserve them through composition per SECURITY/threat-model-prompt-injection.md. Variables sourced from `secret` MUST be replaced with `[REDACTED:<secretId>]` markers in any observability output (e.g., `prompt.composed` events) per SECURITY/threat-model-secret-leakage.md §SR-1.",
   "type": "object",
   "additionalProperties": false,
   "required": [
@@ -154,7 +154,7 @@
         "type",
         "required"
       ],
-      "description": "Typed interpolation slot. Bindings are validated against this declaration before composition; unresolved required slots MUST fail the node with `prompt_variable_unresolved`. Variables sourced from `secret` MUST be redacted to `[REDACTED:<secretId>]` markers in observability output per SECURITY/threat-model-secret-leakage.md §SR-1.",
+      "description": "Typed interpolation slot. Bindings are validated against this declaration before composition; unresolved required slots MUST fail the node with `node_config_invalid`. Variables sourced from `secret` MUST be redacted to `[REDACTED:<secretId>]` markers in observability output per SECURITY/threat-model-secret-leakage.md §SR-1.",
       "properties": {
         "name": {
           "type": "string",
@@ -174,7 +174,7 @@
         },
         "required": {
           "type": "boolean",
-          "description": "When true, an absent binding fails the node with `prompt_variable_unresolved`. When false, the variable renders as `defaultValue` (if present) or the empty string."
+          "description": "When true, an absent binding fails the node with `node_config_invalid`. When false, the variable renders as `defaultValue` (if present) or the empty string."
         },
         "source": {
           "type": "string",

package/schemas/v2/run-event-payloads.schema.json

@@ -888,7 +888,7 @@
       }
     },
     "coreWorkflowChainConfidenceEscalated": {
-      "description": "RFC 0039 \u00a7A \u2014 emitted when a supervisor's OrchestratorDecision carries `confidence` below the active confidence floor (spec floor 0.5 OR operator-stricter `capabilities.multiAgent.executionModel.confidenceEscalationFloor`). Recorded BEFORE the host fires the matching clarify-or-escalate interrupt so the run event log carries the decision point even if the user later confirms the original decision. MUST NOT be emitted unless `capabilities.multiAgent.executionModel.version >= 2`.",
+      "description": "RFC 0039 \u00a7A \u2014 emitted when a supervisor's OrchestratorDecision carries `confidence` below the active confidence floor (spec floor 0.5 OR operator-stricter `capabilities.multiAgent.executionModel.confidenceEscalationFloor`). Recorded BEFORE the host fires the matching clarify-or-escalate interrupt so the run event log carries the decision point even if the user later confirms the original decision. MUST NOT be emitted unless `capabilities.multiAgent.executionModel.version >= 2`. It MUST precede both that interrupt and any `core.workflowChain.event` with `phase: dispatch.began` for the escalated decision. Its `causationId` MAY be absent; when present it MUST resolve to an event already on the run's log, and need not be a `runOrchestrator.decided`: a host holding the decision until ratification has none to name.",
       "type": "object",
       "additionalProperties": false,
       "required": [
@@ -1495,7 +1495,7 @@
     },
     "contextSummarized": {
       "type": "object",
-      "description": "RFC 0111. Emitted when the host replaces older in-window orchestrator transcript turns with a host-produced summary to honor `multiAgent.executionModel.contextBudget.transcriptTokenBudget`. CONTENT-FREE: the summary text is NEVER inlined \u2014 `summaryRef` is an artifactId resolved via `GET /runs/{runId}/artifacts/{artifactId}`. The summary is a NONDETERMINISTIC host output governed like an RFC 0041 envelope: on `:fork mode:replay` the host MUST reuse this recorded `summaryRef` and MUST NOT re-summarize (see multi-agent-execution.md \u00a7\"Context economy (RFC 0111)\"). `replacedTurns` lists the event ids the summary stands in for, so a replay engine reconstructs the exact transcript.",
+      "description": "RFC 0111. Emitted when the host replaces older in-window orchestrator transcript turns with a host-produced summary to honor `multiAgent.executionModel.contextBudget.transcriptTokenBudget`. CONTENT-FREE: the summary text is NEVER inlined \u2014 `summaryRef` is an artifactId resolved via `GET /runs/{runId}/artifacts/{artifactId}`. The summary is a NONDETERMINISTIC host output governed like an RFC 0041 envelope: on `:fork mode:replay` the host MUST reuse this recorded `summaryRef` and MUST NOT re-summarize (execution.md \u00a7multiAgent). `replacedTurns` lists the event ids the summary stands in for, so a replay engine reconstructs the exact transcript. A host MUST NOT emit it unless it advertises `multiAgent.executionModel.contextBudget.summarization`.",
       "required": [
         "iteration",
         "replacedTurns",
@@ -2377,7 +2377,7 @@
         "fallbackAttempted": {
           "type": "boolean",
           "default": false,
-          "description": "True if the host attempted to authenticate to a declared `fallbackModel` and that attempt failed (e.g., no credential resolvable, or the fallback provider was outside `capabilities.aiProviders.supported`). False if no `fallbackModel` was declared on the NodeModule."
+          "description": "True if the host attempted to authenticate to a declared `fallbackModel` and that attempt failed (e.g., no credential resolvable, or the fallback provider was outside `capabilities.aiProviders.providers`). False if no `fallbackModel` was declared on the NodeModule."
         }
       }
     },
@@ -3243,7 +3243,7 @@
     },
     "agentInvocationStarted": {
       "type": "object",
-      "description": "RFC 0077. Emitted by a host advertising `capabilities.agents.liveRuntime.supported: true` as the FIRST agent-scoped event of a live manifest invocation, bracketing the existing `agent.*` family with `agent.invocation.completed`. Content-free: identifiers + selection metadata only \u2014 prompt/task content is served by the run's normal projection, never on this event. A recorded-fact event per `replay.md` \u00a7\"Recorded-fact events\": on replay it is re-emitted from the log and the host MUST NOT regenerate its `invocationId` (or any identifier). Distinct from the deterministic RFC 0070 sample floor.",
+      "description": "RFC 0077. Emitted by a host advertising `capabilities.agents.liveRuntime.supported: true` as the FIRST agent-scoped event of a live manifest invocation, bracketing the existing `agent.*` family with `agent.invocation.completed`. Content-free: identifiers + selection metadata only \u2014 prompt/task content is served by the run's normal projection, never on this event. A recorded-fact event per `replay.md` \u00a7\"Recorded-fact events\": on replay it is re-emitted from the log and the host MUST NOT regenerate its `invocationId` (or any identifier). Distinct from the deterministic RFC 0070 sample floor. For one live invocation the agent-scoped events MUST appear in the order `agent.invocation-started` \u2192 `agent.prompt-resolved` \u2192 (`agent.reasoning-delta`* \u2192 `agent.reasoned`)+ \u2192 (`agent.tool-called` \u2192 `agent.tool-returned`)* \u2192 `agent.decided`+ \u2192 `agent.handoff`? \u2192 `agent.invocation-completed`: this event precedes every other agent-scoped event of the invocation, and `agent.invocation-completed` follows them all and, for a sub-run, precedes the run-scoped `output.harvested`. On replay the host MUST NOT regenerate its timestamps either.",
       "required": [
         "invocationId",
         "agentId",
@@ -3278,7 +3278,7 @@
         },
         "resolvedProvider": {
           "type": "string",
-          "description": "MAY \u2014 the concrete provider the host routed to (aligns with `capabilities.aiProviders.supported` / RFC 0067 `authModes`). OPTIONAL, same rationale as `resolvedModel`."
+          "description": "MAY \u2014 the concrete provider the host routed to (aligns with `capabilities.aiProviders.providers` / RFC 0067 `authModes`). OPTIONAL, same rationale as `resolvedModel`."
         },
         "resolvedAgentVersion": {
           "type": "string",

package/spec/v1/alias-detectors.json

@@ -1,7 +1,7 @@
 {
   "$comment": "RFC 0167 §E — the alias inventory as data. Each detector names a literal token that, while present in the named file, proves an alias or legacy spelling is still in the corpus, and the spec/v1/deprecations.json row that must cover it. scripts/check-alias-coverage.mjs fails when a token is present and its row is missing, or when a row's detector token has disappeared (the alias is gone — retire the detector with the surface). Reviewed, not derived: a grep cannot decide what is an alias; this file records the decision.",
   "version": 1,
-  "updated": "2026-09-22",
+  "updated": "2026-09-29",
   "detectors": [
     {
       "alias": "capabilities wrapper object",
@@ -314,6 +314,30 @@
       "file": "spec/v1/i18n.md",
       "token": "## `locale` field on `InterruptPayload`",
       "deprecation": "openwop.deprecation.interrupt-locale-field"
+    },
+    {
+      "alias": "envelopes.reliability.events[] v1 dotted names",
+      "file": "schemas/v2/capabilities.schema.json",
+      "token": "\"envelope.retry.exhausted\"",
+      "deprecation": "openwop.deprecation.v2-reliability-dotted-event-names"
+    },
+    {
+      "alias": "per-provider aiProviders facets (selfHosted[], authModes map, promptPrefixCache.providers, realtimeVoice sub-flags)",
+      "file": "spec/v1/capabilities.md",
+      "token": "`authModes` is an OPTIONAL object whose keys are provider ids",
+      "deprecation": "openwop.deprecation.ai-providers-per-provider-facets"
+    },
+    {
+      "alias": "aiProviders.supported (v2: providers)",
+      "file": "spec/v1/capabilities.md",
+      "token": "| `aiProviders.supported`",
+      "deprecation": "openwop.deprecation.ai-providers-supported-rename"
+    },
+    {
+      "alias": "RunSnapshot.parentNodeId child→parent link",
+      "file": "spec/v1/node-packs.md",
+      "token": "`RunSnapshot.parentNodeId`",
+      "deprecation": "openwop.deprecation.subworkflow-parent-link-fields"
     }
   ]
 }

package/spec/v1/core-standard-manifest.json

@@ -4,7 +4,7 @@
   "provenance": {
     "suite": {
       "package": "@openwop/openwop-conformance",
-      "version": "2.44.5"
+      "version": "2.44.7"
     },
     "note": "Derived from the corpus at generation time. Regenerate with --write; verify with --check."
   },
@@ -421,5 +421,5 @@
       "$id": "https://openwop.dev/spec/v1/workspace-file.schema.json"
     }
   ],
-  "digest": "e78cb4861a7f5f4d1f37aec55ee6e1448e4ecd42a92f0d49ea3c7784b6068c8b"
+  "digest": "c314696b625c3896601e5e6bf4dd080dc414038d0bf29d3a55b957aec6e0f07b"
 }

package/spec/v1/deprecations.json

@@ -1,7 +1,7 @@
 {
   "$schema": "./deprecations.schema.json",
   "version": 1,
-  "updated": "2026-09-22",
+  "updated": "2026-09-29",
   "entries": [
     {
       "id": "openwop.deprecation.capabilities-wrapper",
@@ -1024,6 +1024,94 @@
         }
       ],
       "removalTrigger": "v2.0-cut"
+    },
+    {
+      "id": "openwop.deprecation.v2-reliability-dotted-event-names",
+      "status": "deprecated",
+      "surface": "the four v1 dotted names in `envelopes.reliability.events[]` (`envelope.retry.attempted`, `envelope.retry.exhausted`, `envelope.nlToFormat.engaged`, `envelope.recovery.applied`)",
+      "kind": "discovery-field",
+      "deprecatedIn": "2.45 (RFC 0228)",
+      "authority": "RFCS/0228-v1-host-service-error-codes.md §G (the enum gains the v2 hyphenated names; the dotted names stay as deprecated aliases)",
+      "removeIn": "3.0",
+      "replacement": "the v2 names `envelope.retry-attempted`, `envelope.retry-exhausted`, `envelope.nl-to-format-engaged`, `envelope.recovery-applied` (spec/v2/event-codemap.json); a consumer treats each dotted name as its hyphenated equivalent",
+      "codemod": null,
+      "note": "NOT removed at 2.x: six committed MyndHyve v2 bundles carry the dotted names in their discovery document (checked 2026-09-28), so a replacement fails RFC 0197 R3. v2 only; the v1 schema is unchanged.",
+      "sources": [
+        {
+          "file": "schemas/v2/capabilities.schema.json",
+          "token": "are deprecated aliases, removed in 3.0"
+        },
+        {
+          "file": "RFCS/0228-v1-host-service-error-codes.md",
+          "token": "described as deprecated aliases"
+        }
+      ]
+    },
+    {
+      "id": "openwop.deprecation.ai-providers-per-provider-facets",
+      "status": "deprecated",
+      "surface": "per-provider `aiProviders` facet shapes: `selfHosted[]`, the `realtimeVoice` sub-flag object, `promptPrefixCache.{supported, providers[]}`, the per-provider `authModes` map",
+      "kind": "discovery-field",
+      "deprecatedIn": "RFC 0169 §Migration table row `openwop.migration.C2.11` (v2 narrows the four facets)",
+      "authority": "RFCS/0169-v2-discovery-and-capabilities.md §Migration table, row openwop.migration.C2.11",
+      "removeIn": "2.0",
+      "replacement": "`selfHosted`, `realtimeVoice`, `promptPrefixCache` booleans and one `authModes` list (spec/v2/core/host-services.md §aiProviders)",
+      "codemod": "openwop.codemod.ai-providers-v2-narrow",
+      "sources": [
+        {
+          "file": "RFCS/0169-v2-discovery-and-capabilities.md",
+          "token": "openwop.migration.C2.11"
+        },
+        {
+          "file": "spec/v1/capabilities.md",
+          "token": "**A.1 — Subset constraint.**"
+        }
+      ],
+      "removalTrigger": "v2.0-cut"
+    },
+    {
+      "id": "openwop.deprecation.ai-providers-supported-rename",
+      "status": "deprecated",
+      "surface": "`aiProviders.supported`",
+      "kind": "discovery-field",
+      "deprecatedIn": "RFC 0169 §Migration table row `openwop.migration.C2.12` (v2 renames the list `providers`)",
+      "authority": "RFCS/0169-v2-discovery-and-capabilities.md §Migration table, row openwop.migration.C2.12",
+      "removeIn": "2.0",
+      "replacement": "`aiProviders.providers` (spec/v2/core/host-services.md §aiProviders)",
+      "codemod": "openwop.codemod.ai-providers-v2-narrow",
+      "sources": [
+        {
+          "file": "RFCS/0169-v2-discovery-and-capabilities.md",
+          "token": "openwop.migration.C2.12"
+        },
+        {
+          "file": "spec/v1/capabilities.md",
+          "token": "| `aiProviders.supported`"
+        }
+      ],
+      "removalTrigger": "v2.0-cut"
+    },
+    {
+      "id": "openwop.deprecation.subworkflow-parent-link-fields",
+      "status": "deprecated",
+      "surface": "`RunSnapshot.parentRunId` and `RunSnapshot.parentNodeId` as the `core.subWorkflow` child→parent link",
+      "kind": "schema-field",
+      "deprecatedIn": "RFC 0171 §Migration table row `openwop.migration.C4.18` (v2 `parentRunId` is fork lineage; `parentNodeId` has no v2 place)",
+      "authority": "RFCS/0171-v2-wire-envelope.md §Migration table, row openwop.migration.C4.18",
+      "removeIn": "2.0",
+      "replacement": "`getRunAncestry` `parent.runId` with `cause: \"core.subWorkflow\"` (spec/v2/core/execution.md §subWorkflow)",
+      "codemod": "openwop.codemod.subworkflow-parent-link-drop",
+      "sources": [
+        {
+          "file": "RFCS/0171-v2-wire-envelope.md",
+          "token": "openwop.migration.C4.18"
+        },
+        {
+          "file": "spec/v1/node-packs.md",
+          "token": "**Parent linkage.**"
+        }
+      ],
+      "removalTrigger": "v2.0-cut"
     }
   ]
 }