@openwop/spec-artifacts 2.0.0-rc.0

package/spec/v1/migrations.schema.json

@@ -0,0 +1,44 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://openwop.dev/spec/v1/migrations.schema.json",
+  "title": "OpenWOP v1→v2 migration register",
+  "description": "Shape of spec/v1/migrations.json (RFC 0167 §D). One row per surface the v2 major changes: what it was in v1, what it becomes in v2, which umbrella child owns the change, the codemod that rewrites a persisted or emitted artifact, the disposition of data a v1 host already persisted, and the requirement / gap ids that witness it. Data, not a wire artifact; kept out of schemas/. Each child RFC's §Migration table is checked against this file by scripts/check-migrations.mjs.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["$schema", "version", "updated", "rows"],
+  "properties": {
+    "$schema": { "type": "string", "const": "./migrations.schema.json" },
+    "version": { "type": "integer", "const": 1 },
+    "updated": { "type": "string", "pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}$" },
+    "rows": { "type": "array", "minItems": 1, "items": { "$ref": "#/$defs/row" } }
+  },
+  "$defs": {
+    "surface": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["surface"],
+      "properties": {
+        "surface": { "type": "string", "minLength": 1, "description": "Wire-visible name: a field path, header, profile id, event type, schema file, endpoint, or `none` when the v2 side removes the surface." },
+        "path": { "type": "string", "description": "Where it lives: a JSON path in a document, an HTTP header slot, a file under schemas/ or spec/." }
+      }
+    },
+    "row": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["id", "child", "kind", "v1", "v2", "codemod", "persistedData", "requirementIds", "gapIds", "deprecationId"],
+      "properties": {
+        "id": { "type": "string", "pattern": "^openwop\\.migration\\.C[0-9]{1,2}\\.[0-9]+$", "description": "openwop.migration.<child>.<n>; child is the charter item (C1…C11)." },
+        "child": { "type": "string", "pattern": "^C(?:[1-9]|1[01])$", "description": "The umbrella child (RFC 0167 §C) that owns the row." },
+        "kind": { "type": "string", "enum": ["rename", "remove", "require", "retype", "unify", "delete-alias", "behavior", "add"], "description": "rename/remove/require/retype/unify/delete-alias/add are codemod-able shape changes; behavior is an obligation change with no artifact rewrite." },
+        "v1": { "$ref": "#/$defs/surface" },
+        "v2": { "$ref": "#/$defs/surface" },
+        "codemod": { "type": ["string", "null"], "pattern": "^openwop\\.codemod\\.[a-z0-9]+(-[a-z0-9]+)*$", "description": "Id of the committed codemod under codemods/<id>/ (scripts/check-codemods.mjs). Required for kind ∈ {rename, remove, retype, unify, delete-alias} at the umbrella's Active predicate; null while the child is Draft." },
+        "persistedData": { "type": "string", "enum": ["unchanged", "translated", "drained", "legacy-stamped", "never-upgraded", "not-persisted"], "description": "What happens to data a v1 host already persisted under the v1 surface (RFC 0167 §C.9): unchanged (readable as-is), translated (read through the declared adapter / codemod), drained (in-flight only; ends by policy), legacy-stamped (marked with a legacy value, never rewritten), never-upgraded (stays valid v1 evidence), not-persisted (transient wire only)." },
+        "requirementIds": { "type": "array", "items": { "type": "string", "pattern": "^openwop\\." }, "description": "conformance/requirements.json ids (or planned v2 ids) that witness the v2 side." },
+        "gapIds": { "type": "array", "items": { "type": "string", "pattern": "^openwop\\.gap\\.[0-9]{4}\\.[0-9]+$" }, "description": "spec/v1/gaps.json rows this migration closes or carries." },
+        "deprecationId": { "type": ["string", "null"], "pattern": "^openwop\\.deprecation\\.[a-z0-9]+(-[a-z0-9]+)*$", "description": "The spec/v1/deprecations.json row for the v1 surface, when one exists (every rename/remove/delete-alias row MUST have one — scripts/check-migrations.mjs)." },
+        "note": { "type": "string" }
+      }
+    }
+  }
+}

package/spec/v1/operation-path-manifest.json

@@ -0,0 +1,462 @@
+{
+  "$comment": "GENERATED by scripts/generate-operation-path-manifest.mjs — do not edit. RFC 0149 §A/§Conformance: the canonical resolved operation-path manifest SDK repositories consume. `resolvedPath` is what an SDK MUST issue against a bare base URL. `class`: canonical | host-extension (tags: [host]) | test-catalog (tags: [packs-test]).",
+  "generatedFrom": "api/openapi.yaml",
+  "serverUrl": "https://{host}",
+  "operations": [
+    {
+      "operationId": "getCapabilities",
+      "method": "GET",
+      "pathKey": "/.well-known/openwop",
+      "resolvedPath": "/.well-known/openwop",
+      "tag": "discovery",
+      "class": "canonical"
+    },
+    {
+      "operationId": "listAgents",
+      "method": "GET",
+      "pathKey": "/v1/agents",
+      "resolvedPath": "/v1/agents",
+      "tag": "agents",
+      "class": "canonical"
+    },
+    {
+      "operationId": "getAgent",
+      "method": "GET",
+      "pathKey": "/v1/agents/{agentId}",
+      "resolvedPath": "/v1/agents/{agentId}",
+      "tag": "agents",
+      "class": "canonical"
+    },
+    {
+      "operationId": "listAgentDeployments",
+      "method": "GET",
+      "pathKey": "/v1/agents/{agentId}/deployments",
+      "resolvedPath": "/v1/agents/{agentId}/deployments",
+      "tag": "agents",
+      "class": "canonical"
+    },
+    {
+      "operationId": "transitionAgentDeployment",
+      "method": "POST",
+      "pathKey": "/v1/agents/{agentId}/deployments",
+      "resolvedPath": "/v1/agents/{agentId}/deployments",
+      "tag": "agents",
+      "class": "canonical"
+    },
+    {
+      "operationId": "getAgentOrgChart",
+      "method": "GET",
+      "pathKey": "/v1/agents/org-chart",
+      "resolvedPath": "/v1/agents/org-chart",
+      "tag": "agents",
+      "class": "canonical"
+    },
+    {
+      "operationId": "getAgentOrgChartDepartment",
+      "method": "GET",
+      "pathKey": "/v1/agents/org-chart/{departmentId}",
+      "resolvedPath": "/v1/agents/org-chart/{departmentId}",
+      "tag": "agents",
+      "class": "canonical"
+    },
+    {
+      "operationId": "listAgentRoster",
+      "method": "GET",
+      "pathKey": "/v1/agents/roster",
+      "resolvedPath": "/v1/agents/roster",
+      "tag": "agents",
+      "class": "canonical"
+    },
+    {
+      "operationId": "getAgentRosterEntry",
+      "method": "GET",
+      "pathKey": "/v1/agents/roster/{rosterId}",
+      "resolvedPath": "/v1/agents/roster/{rosterId}",
+      "tag": "agents",
+      "class": "canonical"
+    },
+    {
+      "operationId": "verifyAuditLog",
+      "method": "GET",
+      "pathKey": "/v1/audit/verify",
+      "resolvedPath": "/v1/audit/verify",
+      "tag": "audit",
+      "class": "canonical"
+    },
+    {
+      "operationId": "listContentPages",
+      "method": "GET",
+      "pathKey": "/v1/content/pages",
+      "resolvedPath": "/v1/content/pages",
+      "tag": "content",
+      "class": "canonical"
+    },
+    {
+      "operationId": "createContentPage",
+      "method": "POST",
+      "pathKey": "/v1/content/pages",
+      "resolvedPath": "/v1/content/pages",
+      "tag": "content",
+      "class": "canonical"
+    },
+    {
+      "operationId": "putContentSection",
+      "method": "PUT",
+      "pathKey": "/v1/content/pages/{pageId}/sections/{sectionId}",
+      "resolvedPath": "/v1/content/pages/{pageId}/sections/{sectionId}",
+      "tag": "content",
+      "class": "canonical"
+    },
+    {
+      "operationId": "getContentPage",
+      "method": "GET",
+      "pathKey": "/v1/content/pages/{slug}",
+      "resolvedPath": "/v1/content/pages/{slug}",
+      "tag": "content",
+      "class": "canonical"
+    },
+    {
+      "operationId": "getContentSettings",
+      "method": "GET",
+      "pathKey": "/v1/content/settings",
+      "resolvedPath": "/v1/content/settings",
+      "tag": "content",
+      "class": "canonical"
+    },
+    {
+      "operationId": "putContentSettings",
+      "method": "PUT",
+      "pathKey": "/v1/content/settings",
+      "resolvedPath": "/v1/content/settings",
+      "tag": "content",
+      "class": "canonical"
+    },
+    {
+      "operationId": "getA2ATaskState",
+      "method": "GET",
+      "pathKey": "/v1/host/sample/a2a/tasks/{taskId}",
+      "resolvedPath": "/v1/host/sample/a2a/tasks/{taskId}",
+      "tag": "host",
+      "class": "host-extension"
+    },
+    {
+      "operationId": "listWorkspaceFiles",
+      "method": "GET",
+      "pathKey": "/v1/host/workspace/files",
+      "resolvedPath": "/v1/host/workspace/files",
+      "tag": "host",
+      "class": "host-extension"
+    },
+    {
+      "operationId": "deleteWorkspaceFile",
+      "method": "DELETE",
+      "pathKey": "/v1/host/workspace/files/{path}",
+      "resolvedPath": "/v1/host/workspace/files/{path}",
+      "tag": "host",
+      "class": "host-extension"
+    },
+    {
+      "operationId": "getWorkspaceFile",
+      "method": "GET",
+      "pathKey": "/v1/host/workspace/files/{path}",
+      "resolvedPath": "/v1/host/workspace/files/{path}",
+      "tag": "host",
+      "class": "host-extension"
+    },
+    {
+      "operationId": "putWorkspaceFile",
+      "method": "PUT",
+      "pathKey": "/v1/host/workspace/files/{path}",
+      "resolvedPath": "/v1/host/workspace/files/{path}",
+      "tag": "host",
+      "class": "host-extension"
+    },
+    {
+      "operationId": "inspectInterruptByToken",
+      "method": "GET",
+      "pathKey": "/v1/interrupts/{token}",
+      "resolvedPath": "/v1/interrupts/{token}",
+      "tag": "hitl",
+      "class": "canonical"
+    },
+    {
+      "operationId": "resolveInterruptByToken",
+      "method": "POST",
+      "pathKey": "/v1/interrupts/{token}",
+      "resolvedPath": "/v1/interrupts/{token}",
+      "tag": "hitl",
+      "class": "canonical"
+    },
+    {
+      "operationId": "getOpenApiSpec",
+      "method": "GET",
+      "pathKey": "/v1/openapi.json",
+      "resolvedPath": "/v1/openapi.json",
+      "tag": "discovery",
+      "class": "canonical"
+    },
+    {
+      "operationId": "deleteTestPackVersion",
+      "method": "DELETE",
+      "pathKey": "/v1/packs-test/{name}/-/{version}",
+      "resolvedPath": "/v1/packs-test/{name}/-/{version}",
+      "tag": "packs-test",
+      "class": "test-catalog"
+    },
+    {
+      "operationId": "getTestPackSignature",
+      "method": "GET",
+      "pathKey": "/v1/packs-test/{name}/-/{version}.sig",
+      "resolvedPath": "/v1/packs-test/{name}/-/{version}.sig",
+      "tag": "packs-test",
+      "class": "test-catalog"
+    },
+    {
+      "operationId": "getTestPackTarball",
+      "method": "GET",
+      "pathKey": "/v1/packs-test/{name}/-/{version}.tgz",
+      "resolvedPath": "/v1/packs-test/{name}/-/{version}.tgz",
+      "tag": "packs-test",
+      "class": "test-catalog"
+    },
+    {
+      "operationId": "putTestPackTarball",
+      "method": "PUT",
+      "pathKey": "/v1/packs-test/{name}/-/{version}.tgz",
+      "resolvedPath": "/v1/packs-test/{name}/-/{version}.tgz",
+      "tag": "packs-test",
+      "class": "test-catalog"
+    },
+    {
+      "operationId": "listPromptTemplates",
+      "method": "GET",
+      "pathKey": "/v1/prompts",
+      "resolvedPath": "/v1/prompts",
+      "tag": "prompts",
+      "class": "canonical"
+    },
+    {
+      "operationId": "createPromptTemplate",
+      "method": "POST",
+      "pathKey": "/v1/prompts",
+      "resolvedPath": "/v1/prompts",
+      "tag": "prompts",
+      "class": "canonical"
+    },
+    {
+      "operationId": "renderPromptTemplate",
+      "method": "POST",
+      "pathKey": "/v1/prompts:render",
+      "resolvedPath": "/v1/prompts:render",
+      "tag": "prompts",
+      "class": "canonical"
+    },
+    {
+      "operationId": "deletePromptTemplate",
+      "method": "DELETE",
+      "pathKey": "/v1/prompts/{templateId}",
+      "resolvedPath": "/v1/prompts/{templateId}",
+      "tag": "prompts",
+      "class": "canonical"
+    },
+    {
+      "operationId": "getPromptTemplate",
+      "method": "GET",
+      "pathKey": "/v1/prompts/{templateId}",
+      "resolvedPath": "/v1/prompts/{templateId}",
+      "tag": "prompts",
+      "class": "canonical"
+    },
+    {
+      "operationId": "updatePromptTemplate",
+      "method": "PUT",
+      "pathKey": "/v1/prompts/{templateId}",
+      "resolvedPath": "/v1/prompts/{templateId}",
+      "tag": "prompts",
+      "class": "canonical"
+    },
+    {
+      "operationId": "createRun",
+      "method": "POST",
+      "pathKey": "/v1/runs",
+      "resolvedPath": "/v1/runs",
+      "tag": "runs",
+      "class": "canonical"
+    },
+    {
+      "operationId": "bulkCancelRuns",
+      "method": "POST",
+      "pathKey": "/v1/runs:bulk-cancel",
+      "resolvedPath": "/v1/runs:bulk-cancel",
+      "tag": "runs",
+      "class": "canonical"
+    },
+    {
+      "operationId": "getRun",
+      "method": "GET",
+      "pathKey": "/v1/runs/{runId}",
+      "resolvedPath": "/v1/runs/{runId}",
+      "tag": "runs",
+      "class": "canonical"
+    },
+    {
+      "operationId": "diffRun",
+      "method": "GET",
+      "pathKey": "/v1/runs/{runId}:diff",
+      "resolvedPath": "/v1/runs/{runId}:diff",
+      "tag": "runs",
+      "class": "canonical"
+    },
+    {
+      "operationId": "forkRun",
+      "method": "POST",
+      "pathKey": "/v1/runs/{runId}:fork",
+      "resolvedPath": "/v1/runs/{runId}:fork",
+      "tag": "runs",
+      "class": "canonical"
+    },
+    {
+      "operationId": "pauseRun",
+      "method": "POST",
+      "pathKey": "/v1/runs/{runId}:pause",
+      "resolvedPath": "/v1/runs/{runId}:pause",
+      "tag": "runs",
+      "class": "canonical"
+    },
+    {
+      "operationId": "resumeRun",
+      "method": "POST",
+      "pathKey": "/v1/runs/{runId}:resume",
+      "resolvedPath": "/v1/runs/{runId}:resume",
+      "tag": "runs",
+      "class": "canonical"
+    },
+    {
+      "operationId": "getRunAncestry",
+      "method": "GET",
+      "pathKey": "/v1/runs/{runId}/ancestry",
+      "resolvedPath": "/v1/runs/{runId}/ancestry",
+      "tag": "runs",
+      "class": "canonical"
+    },
+    {
+      "operationId": "listAnnotations",
+      "method": "GET",
+      "pathKey": "/v1/runs/{runId}/annotations",
+      "resolvedPath": "/v1/runs/{runId}/annotations",
+      "tag": "runs",
+      "class": "canonical"
+    },
+    {
+      "operationId": "createAnnotation",
+      "method": "POST",
+      "pathKey": "/v1/runs/{runId}/annotations",
+      "resolvedPath": "/v1/runs/{runId}/annotations",
+      "tag": "runs",
+      "class": "canonical"
+    },
+    {
+      "operationId": "getArtifact",
+      "method": "GET",
+      "pathKey": "/v1/runs/{runId}/artifacts/{artifactId}",
+      "resolvedPath": "/v1/runs/{runId}/artifacts/{artifactId}",
+      "tag": "artifacts",
+      "class": "canonical"
+    },
+    {
+      "operationId": "cancelRun",
+      "method": "POST",
+      "pathKey": "/v1/runs/{runId}/cancel",
+      "resolvedPath": "/v1/runs/{runId}/cancel",
+      "tag": "runs",
+      "class": "canonical"
+    },
+    {
+      "operationId": "getEvalSummary",
+      "method": "GET",
+      "pathKey": "/v1/runs/{runId}/eval-summary",
+      "resolvedPath": "/v1/runs/{runId}/eval-summary",
+      "tag": "runs",
+      "class": "canonical"
+    },
+    {
+      "operationId": "streamRunEvents",
+      "method": "GET",
+      "pathKey": "/v1/runs/{runId}/events",
+      "resolvedPath": "/v1/runs/{runId}/events",
+      "tag": "runs",
+      "class": "canonical"
+    },
+    {
+      "operationId": "pollRunEvents",
+      "method": "GET",
+      "pathKey": "/v1/runs/{runId}/events/poll",
+      "resolvedPath": "/v1/runs/{runId}/events/poll",
+      "tag": "runs",
+      "class": "canonical"
+    },
+    {
+      "operationId": "resolveInterruptByRun",
+      "method": "POST",
+      "pathKey": "/v1/runs/{runId}/interrupts/{nodeId}",
+      "resolvedPath": "/v1/runs/{runId}/interrupts/{nodeId}",
+      "tag": "hitl",
+      "class": "canonical"
+    },
+    {
+      "operationId": "listTools",
+      "method": "GET",
+      "pathKey": "/v1/tools",
+      "resolvedPath": "/v1/tools",
+      "tag": "tools",
+      "class": "canonical"
+    },
+    {
+      "operationId": "getTool",
+      "method": "GET",
+      "pathKey": "/v1/tools/{toolId}",
+      "resolvedPath": "/v1/tools/{toolId}",
+      "tag": "tools",
+      "class": "canonical"
+    },
+    {
+      "operationId": "createTriggerSubscription",
+      "method": "POST",
+      "pathKey": "/v1/trigger-subscriptions",
+      "resolvedPath": "/v1/trigger-subscriptions",
+      "tag": "triggers",
+      "class": "canonical"
+    },
+    {
+      "operationId": "registerWebhook",
+      "method": "POST",
+      "pathKey": "/v1/webhooks",
+      "resolvedPath": "/v1/webhooks",
+      "tag": "webhooks",
+      "class": "canonical"
+    },
+    {
+      "operationId": "unregisterWebhook",
+      "method": "DELETE",
+      "pathKey": "/v1/webhooks/{webhookId}",
+      "resolvedPath": "/v1/webhooks/{webhookId}",
+      "tag": "webhooks",
+      "class": "canonical"
+    },
+    {
+      "operationId": "getWorkflow",
+      "method": "GET",
+      "pathKey": "/v1/workflows/{workflowId}",
+      "resolvedPath": "/v1/workflows/{workflowId}",
+      "tag": "workflows",
+      "class": "canonical"
+    }
+  ],
+  "counts": {
+    "total": 56,
+    "canonical": 47,
+    "hostExtension": 5,
+    "testCatalog": 4
+  },
+  "digest": "ef8c07388acc57ac48c30a7600d5197039cbf32cbf8117a286664dd2388b4a60"
+}