@openwop/spec-artifacts 2.46.20 → 2.46.21

package/spec/v2/id-field-bindings.json

@@ -89,6 +89,7 @@
     "pageId": "no openwop id kind governs this surface; the grammar is the owning schema's own",
     "parentDepartmentId": "no openwop id kind governs this surface; the grammar is the owning schema's own",
     "proposalId": "no openwop id kind governs this surface; the grammar is the owning schema's own",
+    "operationId": "an OpenAPI operationId naming a read in spec/v2/path-manifest.json (RFC 0249 installedArtifact), not an entity id",
     "providerId": "a connection provider id is author-minted in a pack manifest and host-global (connection-packs.md §Provider identity); no openwop id kind governs it",
     "roleId": "no openwop id kind governs this surface; the grammar is the owning schema's own",
     "rosterId": "no openwop id kind governs this surface; the grammar is the owning schema's own",

package/spec/v2/path-manifest.json

@@ -376,6 +376,85 @@
       "authenticated": true,
       "requestBody": true
     },
+    {
+      "method": "GET",
+      "path": "/proposals",
+      "operationId": "listProposals",
+      "requestHeaders": [
+        "OpenWOP-Client-Version",
+        "OpenWOP-Version"
+      ],
+      "authenticated": true,
+      "requestBody": false
+    },
+    {
+      "method": "POST",
+      "path": "/proposals",
+      "operationId": "submitProposal",
+      "requestHeaders": [
+        "Idempotency-Key",
+        "OpenWOP-Client-Version",
+        "OpenWOP-Version"
+      ],
+      "authenticated": true,
+      "requestBody": true
+    },
+    {
+      "method": "DELETE",
+      "path": "/proposals/{proposalId}",
+      "operationId": "archiveProposal",
+      "requestHeaders": [
+        "OpenWOP-Client-Version",
+        "OpenWOP-Version"
+      ],
+      "authenticated": true,
+      "requestBody": false
+    },
+    {
+      "method": "GET",
+      "path": "/proposals/{proposalId}",
+      "operationId": "getProposal",
+      "requestHeaders": [
+        "OpenWOP-Client-Version",
+        "OpenWOP-Version"
+      ],
+      "authenticated": true,
+      "requestBody": false
+    },
+    {
+      "method": "PATCH",
+      "path": "/proposals/{proposalId}",
+      "operationId": "reviseProposal",
+      "requestHeaders": [
+        "OpenWOP-Client-Version",
+        "OpenWOP-Version"
+      ],
+      "authenticated": true,
+      "requestBody": true
+    },
+    {
+      "method": "POST",
+      "path": "/proposals/{proposalId}:apply",
+      "operationId": "applyProposal",
+      "requestHeaders": [
+        "Idempotency-Key",
+        "OpenWOP-Client-Version",
+        "OpenWOP-Version"
+      ],
+      "authenticated": true,
+      "requestBody": true
+    },
+    {
+      "method": "POST",
+      "path": "/proposals/{proposalId}:reject",
+      "operationId": "rejectProposal",
+      "requestHeaders": [
+        "OpenWOP-Client-Version",
+        "OpenWOP-Version"
+      ],
+      "authenticated": true,
+      "requestBody": true
+    },
     {
       "method": "GET",
       "path": "/runs",
@@ -711,7 +790,7 @@
     }
   ],
   "counts": {
-    "operations": 61,
+    "operations": 68,
     "channels": 2
   }
 }

package/spec/v2/release.json

@@ -1,6 +1,6 @@
 {
   "$comment": "RFC 0172 §D.1 — the one release identity the v2 artifacts derive from. `version` is the next corpus tag `v<version>` (the publish workflow's coordinated-release tag pattern `v*`; RFC 0172's `openwop/v2.<minor>.<patch>` spelling is amended to this at its flip). api/v2/*.yaml info.version, the suite's 2.x version and @openwop/spec-artifacts read it. Bumped by the release PR that cuts the tag, never by hand elsewhere.",
-  "version": "2.46.20",
-  "corpusTag": "v2.46.20",
+  "version": "2.46.21",
+  "corpusTag": "v2.46.21",
   "updated": "2026-10-24"
 }

package/spec/v2/surface-baseline.json

@@ -4,7 +4,7 @@
     "schemas/v2/**/*.json",
     "spec/v2/path-manifest.json"
   ],
-  "release": "2.46.20",
+  "release": "2.46.21",
   "kinds": {
     "union": [
       "channel",
@@ -18,7 +18,7 @@
       "type"
     ]
   },
-  "count": 8944,
+  "count": 9024,
   "surfaces": [
     "schemas/v2/a2a-task-state.schema.json#/contextId|type|string",
     "schemas/v2/a2a-task-state.schema.json#/interruptKind|enum-member|\"approval\"",
@@ -1110,11 +1110,20 @@
     "schemas/v2/capabilities.schema.json#/agents/proposals/artifactKinds/[]|enum-member|\"workflow-chain-pack\"",
     "schemas/v2/capabilities.schema.json#/agents/proposals/artifactKinds/[]|type|string",
     "schemas/v2/capabilities.schema.json#/agents/proposals/artifactKinds|type|array",
+    "schemas/v2/capabilities.schema.json#/agents/proposals/clientDrafts|type|boolean",
     "schemas/v2/capabilities.schema.json#/agents/proposals/duplicationDetection|type|boolean",
+    "schemas/v2/capabilities.schema.json#/agents/proposals/readback/[]|enum-member|\"agent-pack\"",
+    "schemas/v2/capabilities.schema.json#/agents/proposals/readback/[]|enum-member|\"automation\"",
+    "schemas/v2/capabilities.schema.json#/agents/proposals/readback/[]|enum-member|\"prompt-template\"",
+    "schemas/v2/capabilities.schema.json#/agents/proposals/readback/[]|enum-member|\"workflow-chain-pack\"",
+    "schemas/v2/capabilities.schema.json#/agents/proposals/readback/[]|type|string",
+    "schemas/v2/capabilities.schema.json#/agents/proposals/readback|type|array",
     "schemas/v2/capabilities.schema.json#/agents/proposals|closed|true",
     "schemas/v2/capabilities.schema.json#/agents/proposals|property|activation",
     "schemas/v2/capabilities.schema.json#/agents/proposals|property|artifactKinds",
+    "schemas/v2/capabilities.schema.json#/agents/proposals|property|clientDrafts",
     "schemas/v2/capabilities.schema.json#/agents/proposals|property|duplicationDetection",
+    "schemas/v2/capabilities.schema.json#/agents/proposals|property|readback",
     "schemas/v2/capabilities.schema.json#/agents/proposals|required|activation",
     "schemas/v2/capabilities.schema.json#/agents/proposals|required|artifactKinds",
     "schemas/v2/capabilities.schema.json#/agents/proposals|type|object",
@@ -5522,6 +5531,7 @@
     "schemas/v2/envelopes/ui.a2ui-surface.schema.json#|property|surfaceId",
     "schemas/v2/envelopes/ui.a2ui-surface.schema.json#|property|version",
     "schemas/v2/envelopes/ui.a2ui-surface.schema.json#|type|object",
+    "schemas/v2/error-envelope.schema.json#/details/action|type|string",
     "schemas/v2/error-envelope.schema.json#/details/dimension|enum-member|\"costUsd\"",
     "schemas/v2/error-envelope.schema.json#/details/dimension|enum-member|\"retries\"",
     "schemas/v2/error-envelope.schema.json#/details/dimension|enum-member|\"tokens\"",
@@ -5537,13 +5547,16 @@
     "schemas/v2/error-envelope.schema.json#/details/reason|enum-member|\"out-of-audience\"",
     "schemas/v2/error-envelope.schema.json#/details/reason|enum-member|\"policy-denied\"",
     "schemas/v2/error-envelope.schema.json#/details/reason|enum-member|\"provenance-unevaluable\"",
+    "schemas/v2/error-envelope.schema.json#/details/reason|enum-member|\"read-only\"",
     "schemas/v2/error-envelope.schema.json#/details/reason|enum-member|\"scope-denied\"",
     "schemas/v2/error-envelope.schema.json#/details/reason|enum-member|\"ssrf-blocked\"",
+    "schemas/v2/error-envelope.schema.json#/details/reason|enum-member|\"version-not-greater\"",
     "schemas/v2/error-envelope.schema.json#/details/reason|type|string",
     "schemas/v2/error-envelope.schema.json#/details/runStatus|type|string",
     "schemas/v2/error-envelope.schema.json#/details/sequence|type|integer",
     "schemas/v2/error-envelope.schema.json#/details/service|type|string",
     "schemas/v2/error-envelope.schema.json#/details/speakerId|type|string",
+    "schemas/v2/error-envelope.schema.json#/details/state|type|string",
     "schemas/v2/error-envelope.schema.json#/details/supported/[]|enum-member|\"debug\"",
     "schemas/v2/error-envelope.schema.json#/details/supported/[]|enum-member|\"messages\"",
     "schemas/v2/error-envelope.schema.json#/details/supported/[]|enum-member|\"updates\"",
@@ -5551,6 +5564,7 @@
     "schemas/v2/error-envelope.schema.json#/details/supported/[]|type|string",
     "schemas/v2/error-envelope.schema.json#/details/supported|type|array",
     "schemas/v2/error-envelope.schema.json#/details/type|type|string",
+    "schemas/v2/error-envelope.schema.json#/details|property|action",
     "schemas/v2/error-envelope.schema.json#/details|property|dimension",
     "schemas/v2/error-envelope.schema.json#/details|property|evalRunId",
     "schemas/v2/error-envelope.schema.json#/details|property|eventId",
@@ -5566,6 +5580,7 @@
     "schemas/v2/error-envelope.schema.json#/details|property|sequence",
     "schemas/v2/error-envelope.schema.json#/details|property|service",
     "schemas/v2/error-envelope.schema.json#/details|property|speakerId",
+    "schemas/v2/error-envelope.schema.json#/details|property|state",
     "schemas/v2/error-envelope.schema.json#/details|property|supported",
     "schemas/v2/error-envelope.schema.json#/details|property|type",
     "schemas/v2/error-envelope.schema.json#/details|type|object",
@@ -5646,6 +5661,9 @@
     "schemas/v2/error-envelope.schema.json#/error|enum-member|\"pack_version_not_found\"",
     "schemas/v2/error-envelope.schema.json#/error|enum-member|\"payload_too_large\"",
     "schemas/v2/error-envelope.schema.json#/error|enum-member|\"payload_unprojectable\"",
+    "schemas/v2/error-envelope.schema.json#/error|enum-member|\"proposal_install_conflict\"",
+    "schemas/v2/error-envelope.schema.json#/error|enum-member|\"proposal_stale\"",
+    "schemas/v2/error-envelope.schema.json#/error|enum-member|\"proposal_state_conflict\"",
     "schemas/v2/error-envelope.schema.json#/error|enum-member|\"protocol_version_mismatch\"",
     "schemas/v2/error-envelope.schema.json#/error|enum-member|\"protocol_version_unsupported\"",
     "schemas/v2/error-envelope.schema.json#/error|enum-member|\"provider_policy_denied\"",
@@ -6895,14 +6913,68 @@
     "schemas/v2/prompt-template.schema.json#|required|text",
     "schemas/v2/prompt-template.schema.json#|required|version",
     "schemas/v2/prompt-template.schema.json#|type|object",
+    "schemas/v2/proposal-apply.schema.json#/artifactDigest|type|string",
+    "schemas/v2/proposal-apply.schema.json#|closed|true",
+    "schemas/v2/proposal-apply.schema.json#|property|artifactDigest",
+    "schemas/v2/proposal-apply.schema.json#|type|object",
+    "schemas/v2/proposal-list-response.schema.json#/items|type|array",
+    "schemas/v2/proposal-list-response.schema.json#/nextCursor|type|string",
+    "schemas/v2/proposal-list-response.schema.json#|closed|true",
+    "schemas/v2/proposal-list-response.schema.json#|property|items",
+    "schemas/v2/proposal-list-response.schema.json#|property|nextCursor",
+    "schemas/v2/proposal-list-response.schema.json#|required|items",
+    "schemas/v2/proposal-list-response.schema.json#|type|object",
+    "schemas/v2/proposal-revise.schema.json#/artifact|type|object",
+    "schemas/v2/proposal-revise.schema.json#/rationale|type|string",
+    "schemas/v2/proposal-revise.schema.json#/title|type|string",
+    "schemas/v2/proposal-revise.schema.json#|closed|true",
+    "schemas/v2/proposal-revise.schema.json#|property|artifact",
+    "schemas/v2/proposal-revise.schema.json#|property|rationale",
+    "schemas/v2/proposal-revise.schema.json#|property|title",
+    "schemas/v2/proposal-revise.schema.json#|type|object",
+    "schemas/v2/proposal-submit.schema.json#/artifact|type|object",
+    "schemas/v2/proposal-submit.schema.json#/kind|enum-member|\"agent-pack\"",
+    "schemas/v2/proposal-submit.schema.json#/kind|enum-member|\"automation\"",
+    "schemas/v2/proposal-submit.schema.json#/kind|enum-member|\"prompt-template\"",
+    "schemas/v2/proposal-submit.schema.json#/kind|enum-member|\"workflow-chain-pack\"",
+    "schemas/v2/proposal-submit.schema.json#/kind|type|string",
+    "schemas/v2/proposal-submit.schema.json#/rationale|type|string",
+    "schemas/v2/proposal-submit.schema.json#/title|type|string",
+    "schemas/v2/proposal-submit.schema.json#|closed|true",
+    "schemas/v2/proposal-submit.schema.json#|property|artifact",
+    "schemas/v2/proposal-submit.schema.json#|property|kind",
+    "schemas/v2/proposal-submit.schema.json#|property|rationale",
+    "schemas/v2/proposal-submit.schema.json#|property|title",
+    "schemas/v2/proposal-submit.schema.json#|required|artifact",
+    "schemas/v2/proposal-submit.schema.json#|required|kind",
+    "schemas/v2/proposal-submit.schema.json#|type|object",
     "schemas/v2/proposal.schema.json#/activation/approvalId|type|null",
     "schemas/v2/proposal.schema.json#/activation/approvalId|type|string",
+    "schemas/v2/proposal.schema.json#/activation/installedArtifact/id|type|string",
+    "schemas/v2/proposal.schema.json#/activation/installedArtifact/kind|enum-member|\"agent-pack\"",
+    "schemas/v2/proposal.schema.json#/activation/installedArtifact/kind|enum-member|\"automation\"",
+    "schemas/v2/proposal.schema.json#/activation/installedArtifact/kind|enum-member|\"prompt-template\"",
+    "schemas/v2/proposal.schema.json#/activation/installedArtifact/kind|enum-member|\"workflow-chain-pack\"",
+    "schemas/v2/proposal.schema.json#/activation/installedArtifact/kind|type|string",
+    "schemas/v2/proposal.schema.json#/activation/installedArtifact/operationId|type|string",
+    "schemas/v2/proposal.schema.json#/activation/installedArtifact/version|type|string",
     "schemas/v2/proposal.schema.json#/activation/installedArtifactRef|type|string",
+    "schemas/v2/proposal.schema.json#/activation/installedArtifact|closed|true",
+    "schemas/v2/proposal.schema.json#/activation/installedArtifact|property|id",
+    "schemas/v2/proposal.schema.json#/activation/installedArtifact|property|kind",
+    "schemas/v2/proposal.schema.json#/activation/installedArtifact|property|operationId",
+    "schemas/v2/proposal.schema.json#/activation/installedArtifact|property|version",
+    "schemas/v2/proposal.schema.json#/activation/installedArtifact|required|id",
+    "schemas/v2/proposal.schema.json#/activation/installedArtifact|required|kind",
+    "schemas/v2/proposal.schema.json#/activation/installedArtifact|required|operationId",
+    "schemas/v2/proposal.schema.json#/activation/installedArtifact|type|object",
     "schemas/v2/proposal.schema.json#/activation|closed|true",
     "schemas/v2/proposal.schema.json#/activation|property|approvalId",
+    "schemas/v2/proposal.schema.json#/activation|property|installedArtifact",
     "schemas/v2/proposal.schema.json#/activation|property|installedArtifactRef",
     "schemas/v2/proposal.schema.json#/activation|type|null",
     "schemas/v2/proposal.schema.json#/activation|type|object",
+    "schemas/v2/proposal.schema.json#/artifactDigest|type|string",
     "schemas/v2/proposal.schema.json#/artifact|type|object",
     "schemas/v2/proposal.schema.json#/createdAt|type|string",
     "schemas/v2/proposal.schema.json#/duplicateOf|type|null",
@@ -6941,6 +7013,7 @@
     "schemas/v2/proposal.schema.json#|closed|true",
     "schemas/v2/proposal.schema.json#|property|activation",
     "schemas/v2/proposal.schema.json#|property|artifact",
+    "schemas/v2/proposal.schema.json#|property|artifactDigest",
     "schemas/v2/proposal.schema.json#|property|createdAt",
     "schemas/v2/proposal.schema.json#|property|duplicateOf",
     "schemas/v2/proposal.schema.json#|property|id",
@@ -8905,6 +8978,7 @@
     "spec/v2/path-manifest.json#|channel|/runs/{runId}/events",
     "spec/v2/path-manifest.json#|operation|DELETE /content/pages/{slug}",
     "spec/v2/path-manifest.json#|operation|DELETE /prompts/{templateId}",
+    "spec/v2/path-manifest.json#|operation|DELETE /proposals/{proposalId}",
     "spec/v2/path-manifest.json#|operation|DELETE /webhooks/{webhookId}",
     "spec/v2/path-manifest.json#|operation|GET /.well-known/openwop",
     "spec/v2/path-manifest.json#|operation|GET /agents",
@@ -8927,6 +9001,8 @@
     "spec/v2/path-manifest.json#|operation|GET /openapi.json",
     "spec/v2/path-manifest.json#|operation|GET /prompts",
     "spec/v2/path-manifest.json#|operation|GET /prompts/{templateId}",
+    "spec/v2/path-manifest.json#|operation|GET /proposals",
+    "spec/v2/path-manifest.json#|operation|GET /proposals/{proposalId}",
     "spec/v2/path-manifest.json#|operation|GET /runs",
     "spec/v2/path-manifest.json#|operation|GET /runs/{runId}",
     "spec/v2/path-manifest.json#|operation|GET /runs/{runId}/ancestry",
@@ -8943,6 +9019,7 @@
     "spec/v2/path-manifest.json#|operation|GET /trigger-subscriptions/{subscriptionId}/dead-letters",
     "spec/v2/path-manifest.json#|operation|GET /webhooks/{webhookId}/dead-letters",
     "spec/v2/path-manifest.json#|operation|GET /workflows/{workflowId}",
+    "spec/v2/path-manifest.json#|operation|PATCH /proposals/{proposalId}",
     "spec/v2/path-manifest.json#|operation|POST /agents/{agentId}/deployments",
     "spec/v2/path-manifest.json#|operation|POST /content/pages",
     "spec/v2/path-manifest.json#|operation|POST /host/events/test",
@@ -8950,6 +9027,9 @@
     "spec/v2/path-manifest.json#|operation|POST /interrupts/{token}",
     "spec/v2/path-manifest.json#|operation|POST /prompts",
     "spec/v2/path-manifest.json#|operation|POST /prompts:render",
+    "spec/v2/path-manifest.json#|operation|POST /proposals",
+    "spec/v2/path-manifest.json#|operation|POST /proposals/{proposalId}:apply",
+    "spec/v2/path-manifest.json#|operation|POST /proposals/{proposalId}:reject",
     "spec/v2/path-manifest.json#|operation|POST /runs",
     "spec/v2/path-manifest.json#|operation|POST /runs/{runId}/annotations",
     "spec/v2/path-manifest.json#|operation|POST /runs/{runId}/cancel",