@opensoftware/contracts 0.0.0-stage → 1.4.0

package/openapi/openapi.json

@@ -0,0 +1,1715 @@
+{
+  "openapi": "3.1.0",
+  "info": {
+    "title": "Open Software Factory contracts",
+    "version": "1.4.0",
+    "description": "The shared formats as named models. No operations: module APIs are added per module. Generated by `pnpm build` in contracts/ from typespec/. Do not edit.",
+    "license": {
+      "name": "Apache-2.0",
+      "identifier": "Apache-2.0"
+    }
+  },
+  "paths": {},
+  "components": {
+    "schemas": {
+      "Actor": {
+        "type": "object",
+        "properties": {
+          "kind": {
+            "$ref": "#/components/schemas/ActorKind"
+          },
+          "id": {
+            "type": "string",
+            "minLength": 1,
+            "description": "Stable ID in the source system, prefixed with the source, for example \"slack:U024BE7LH\"."
+          },
+          "displayName": {
+            "type": "string",
+            "description": "Shown to people, for example \"Varun\"."
+          }
+        },
+        "required": [
+          "kind",
+          "id"
+        ],
+        "description": "A person or trigger. RUNTIME-008: every run is attributed to one."
+      },
+      "ActorKind": {
+        "type": "string",
+        "enum": [
+          "person",
+          "trigger"
+        ],
+        "description": "Who caused something: a person, or an automated trigger such as a cron rule or an alert."
+      },
+      "Agent": {
+        "type": "object",
+        "properties": {
+          "description": {
+            "type": "string"
+          },
+          "harness": {
+            "$ref": "#/components/schemas/Name",
+            "description": "Harness adapter, declared under `providers.harness`, for example \"claude-code\"."
+          },
+          "model": {
+            "type": "string",
+            "minLength": 1,
+            "description": "A model ID or a routing alias of the inference gateway, for example \"routes/triage\"."
+          },
+          "prompt": {
+            "type": "string",
+            "minLength": 1,
+            "description": "Path to the Markdown prompt."
+          },
+          "repositories": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            },
+            "description": "Repositories the agent operates on, as clone URLs or \"<owner>/<name>\"."
+          },
+          "mcp": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            },
+            "description": "MCP servers: `registry:<name>@<version>` or `<name>@<version>`."
+          },
+          "skills": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            },
+            "description": "Paths to skill folders."
+          },
+          "secrets": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/SecretReference"
+            }
+          },
+          "sandbox": {
+            "$ref": "#/components/schemas/Sandbox",
+            "description": "Runtime of the agent."
+          }
+        },
+        "required": [
+          "harness",
+          "model",
+          "prompt"
+        ],
+        "additionalProperties": false
+      },
+      "Artifact": {
+        "type": "object",
+        "properties": {
+          "path": {
+            "$ref": "#/components/schemas/BundlePath"
+          },
+          "kind": {
+            "$ref": "#/components/schemas/ArtifactKind"
+          },
+          "mediaType": {
+            "type": "string",
+            "minLength": 1,
+            "description": "IANA media type, for example \"image/png\"."
+          },
+          "sha256": {
+            "$ref": "#/components/schemas/Sha256"
+          },
+          "bytes": {
+            "type": "integer",
+            "minimum": 0
+          }
+        },
+        "required": [
+          "path",
+          "kind",
+          "mediaType",
+          "sha256"
+        ]
+      },
+      "ArtifactKind": {
+        "type": "string",
+        "enum": [
+          "screenshot",
+          "video",
+          "playwright-trace",
+          "junit",
+          "log",
+          "report",
+          "other"
+        ]
+      },
+      "Automation": {
+        "type": "object",
+        "properties": {
+          "on": {
+            "type": "string",
+            "minLength": 1,
+            "description": "Event filter, for example \"github.issue.labeled(auto-implement)\" or \"sentry.fatal\"."
+          },
+          "cron": {
+            "type": "string",
+            "minLength": 1,
+            "description": "Five-field cron expression in UTC."
+          },
+          "run": {
+            "$ref": "#/components/schemas/Name",
+            "description": "Job to run. Required with `cron`; without it an event starts the workflow."
+          }
+        },
+        "description": "Starts the workflow, or the named job, on an event (`on`) or a schedule (`cron`). Exactly one of the two; a\nschedule names its job. One model rather than a union, so every generated client reads it without guessing.",
+        "oneOf": [
+          {
+            "required": [
+              "on"
+            ],
+            "not": {
+              "required": [
+                "cron"
+              ]
+            }
+          },
+          {
+            "required": [
+              "cron",
+              "run"
+            ],
+            "not": {
+              "required": [
+                "on"
+              ]
+            }
+          }
+        ],
+        "additionalProperties": false
+      },
+      "Benchmark": {
+        "type": "object",
+        "properties": {
+          "suite": {
+            "type": "string",
+            "minLength": 1,
+            "description": "Path to the Harbor task suite."
+          },
+          "schedule": {
+            "type": "string",
+            "description": "Five-field cron expression in UTC. Without it the suite runs on request."
+          }
+        },
+        "required": [
+          "suite"
+        ],
+        "additionalProperties": false
+      },
+      "BundlePath": {
+        "type": "string",
+        "pattern": "^(?!/)(?!.*(^|/)\\.\\.(/|$))[^\\\\]+$",
+        "description": "A path inside the bundle: relative, forward slashes, no \"..\"."
+      },
+      "CommitHash": {
+        "type": "string",
+        "pattern": "^[0-9a-f]{7,40}$",
+        "description": "A Git commit hash, abbreviated (7+) or full. The factory version is the commit of the factory definition."
+      },
+      "EvidenceManifest": {
+        "type": "object",
+        "properties": {
+          "manifestVersion": {
+            "$ref": "#/components/schemas/FormatVersion",
+            "description": "Version of this format."
+          },
+          "id": {
+            "$ref": "#/components/schemas/Identifier"
+          },
+          "createdAt": {
+            "type": "string",
+            "format": "date-time"
+          },
+          "subject": {
+            "$ref": "#/components/schemas/EvidenceSubject",
+            "description": "The change that was verified."
+          },
+          "runId": {
+            "$ref": "#/components/schemas/Identifier"
+          },
+          "workItemId": {
+            "$ref": "#/components/schemas/Identifier"
+          },
+          "producer": {
+            "$ref": "#/components/schemas/Producer",
+            "description": "The tool that wrote the bundle, for example proof 1.2.0."
+          },
+          "result": {
+            "$ref": "#/components/schemas/VerificationResult",
+            "description": "Passed only when every scenario passed."
+          },
+          "scenarios": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/ScenarioEvidence"
+            }
+          },
+          "artifacts": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/Artifact"
+            }
+          }
+        },
+        "required": [
+          "manifestVersion",
+          "id",
+          "createdAt",
+          "subject",
+          "producer",
+          "result",
+          "scenarios",
+          "artifacts"
+        ],
+        "description": "`evidence.json` at the root of an evidence bundle: what was verified, against which scenario IDs, with which\nartifacts and result (P10)."
+      },
+      "EvidenceRequirement": {
+        "type": "string",
+        "enum": [
+          "required",
+          "optional"
+        ]
+      },
+      "EvidenceSubject": {
+        "type": "object",
+        "properties": {
+          "repository": {
+            "type": "string",
+            "format": "uri"
+          },
+          "commit": {
+            "$ref": "#/components/schemas/CommitHash"
+          },
+          "pullRequest": {
+            "type": "string",
+            "format": "uri"
+          }
+        },
+        "required": [
+          "repository",
+          "commit"
+        ]
+      },
+      "FactoryDefinition": {
+        "type": "object",
+        "properties": {
+          "$schema": {
+            "type": "string",
+            "description": "Editors may point at this schema. Ignored by every tool."
+          },
+          "version": {
+            "$ref": "#/components/schemas/FormatVersion",
+            "description": "Version of this format. A new major version of the format gets a new value."
+          },
+          "factory": {
+            "$ref": "#/components/schemas/Name",
+            "description": "Name of the factory."
+          },
+          "description": {
+            "type": "string"
+          },
+          "providers": {
+            "$ref": "#/components/schemas/Providers",
+            "description": "Adapters per port with a version range, pinned in `factory.lock` by `factory plan`."
+          },
+          "agents": {
+            "type": "object",
+            "properties": {},
+            "unevaluatedProperties": {
+              "$ref": "#/components/schemas/Agent"
+            },
+            "minProperties": 1,
+            "description": "Agents by name."
+          },
+          "workflow": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/Stage"
+            },
+            "description": "Stages in order. Each stage runs one agent; the agent defaults to the stage name."
+          },
+          "automations": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/Automation"
+            },
+            "description": "What starts work without a person asking."
+          },
+          "scorers": {
+            "type": "object",
+            "properties": {},
+            "unevaluatedProperties": {
+              "$ref": "#/components/schemas/Scorer"
+            },
+            "description": "Scorers by name."
+          },
+          "benchmarks": {
+            "type": "object",
+            "properties": {},
+            "unevaluatedProperties": {
+              "$ref": "#/components/schemas/Benchmark"
+            },
+            "description": "Benchmark suites by name."
+          }
+        },
+        "required": [
+          "version",
+          "factory",
+          "agents"
+        ],
+        "description": "`factory.yaml`: the desired state of one factory (P3). Paths are relative to the file.\nRealizes SCN-FACTORY-CODE-001: agents and prompts; MCP servers, skills and secrets per agent;\nrepositories; model and runtime; automations; scorers and benchmarks.",
+        "additionalProperties": false
+      },
+      "FormatVersion": {
+        "type": "integer",
+        "minimum": 1,
+        "maximum": 2147483647,
+        "description": "The version of a format inside its documents. Only 1 exists; a new major version of a format adds the next.",
+        "const": 1
+      },
+      "Gate": {
+        "type": "object",
+        "properties": {
+          "policy": {
+            "type": "string",
+            "minLength": 1,
+            "description": "Path to the Rego policy that decides or picks the approvers."
+          },
+          "approvers": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/Name"
+            },
+            "description": "Approver groups. The policy may narrow them."
+          }
+        },
+        "required": [
+          "policy"
+        ],
+        "additionalProperties": false
+      },
+      "GateDecided": {
+        "type": "object",
+        "properties": {
+          "specversion": {
+            "type": "string",
+            "const": "1.0"
+          },
+          "id": {
+            "$ref": "#/components/schemas/Identifier",
+            "description": "Unique per source. A consumer that sees the same source and id twice handles the event once."
+          },
+          "source": {
+            "type": "string",
+            "minLength": 1,
+            "description": "The producing module, for example \"/osf/intake\"."
+          },
+          "type": {
+            "type": "string",
+            "const": "gate.decided@v1"
+          },
+          "time": {
+            "type": "string",
+            "format": "date-time"
+          },
+          "subject": {
+            "type": "string",
+            "description": "The ID of the thing the event is about: work item, gate, run, score or pull request."
+          },
+          "datacontenttype": {
+            "type": "string",
+            "const": "application/json"
+          },
+          "dataschema": {
+            "type": "string",
+            "format": "uri"
+          },
+          "traceparent": {
+            "type": "string",
+            "description": "W3C trace context (CloudEvents distributed tracing extension)."
+          },
+          "data": {
+            "$ref": "#/components/schemas/GateDecidedData"
+          }
+        },
+        "required": [
+          "specversion",
+          "id",
+          "source",
+          "type",
+          "time",
+          "data"
+        ],
+        "description": "gatekeeper: a gate was decided."
+      },
+      "GateDecidedData": {
+        "type": "object",
+        "properties": {
+          "gateId": {
+            "$ref": "#/components/schemas/Identifier"
+          },
+          "workItemId": {
+            "$ref": "#/components/schemas/Identifier"
+          },
+          "decision": {
+            "$ref": "#/components/schemas/GateDecision"
+          },
+          "decidedBy": {
+            "$ref": "#/components/schemas/Actor",
+            "description": "The person who decided. Absent only when the gate expired."
+          },
+          "decidedAt": {
+            "type": "string",
+            "format": "date-time"
+          },
+          "reason": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "gateId",
+          "workItemId",
+          "decision",
+          "decidedAt"
+        ]
+      },
+      "GateDecision": {
+        "type": "string",
+        "enum": [
+          "approved",
+          "rejected",
+          "expired"
+        ]
+      },
+      "GateRequested": {
+        "type": "object",
+        "properties": {
+          "specversion": {
+            "type": "string",
+            "const": "1.0"
+          },
+          "id": {
+            "$ref": "#/components/schemas/Identifier",
+            "description": "Unique per source. A consumer that sees the same source and id twice handles the event once."
+          },
+          "source": {
+            "type": "string",
+            "minLength": 1,
+            "description": "The producing module, for example \"/osf/intake\"."
+          },
+          "type": {
+            "type": "string",
+            "const": "gate.requested@v1"
+          },
+          "time": {
+            "type": "string",
+            "format": "date-time"
+          },
+          "subject": {
+            "type": "string",
+            "description": "The ID of the thing the event is about: work item, gate, run, score or pull request."
+          },
+          "datacontenttype": {
+            "type": "string",
+            "const": "application/json"
+          },
+          "dataschema": {
+            "type": "string",
+            "format": "uri"
+          },
+          "traceparent": {
+            "type": "string",
+            "description": "W3C trace context (CloudEvents distributed tracing extension)."
+          },
+          "data": {
+            "$ref": "#/components/schemas/GateRequestedData"
+          }
+        },
+        "required": [
+          "specversion",
+          "id",
+          "source",
+          "type",
+          "time",
+          "data"
+        ],
+        "description": "gatekeeper: a decision is needed before a stage starts."
+      },
+      "GateRequestedData": {
+        "type": "object",
+        "properties": {
+          "gateId": {
+            "$ref": "#/components/schemas/Identifier"
+          },
+          "workItemId": {
+            "$ref": "#/components/schemas/Identifier"
+          },
+          "runId": {
+            "$ref": "#/components/schemas/Identifier"
+          },
+          "stage": {
+            "$ref": "#/components/schemas/Name",
+            "description": "The stage that waits."
+          },
+          "policy": {
+            "type": "string",
+            "minLength": 1,
+            "description": "Path to the policy in the factory definition."
+          },
+          "approvers": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/Name"
+            },
+            "minItems": 1,
+            "description": "Approver groups picked by the policy."
+          },
+          "summary": {
+            "type": "string",
+            "minLength": 1,
+            "description": "What the approver is asked to decide, shown in the channel."
+          },
+          "links": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/Link"
+            }
+          },
+          "expiresAt": {
+            "type": "string",
+            "format": "date-time"
+          }
+        },
+        "required": [
+          "gateId",
+          "workItemId",
+          "stage",
+          "policy",
+          "approvers",
+          "summary"
+        ]
+      },
+      "Identifier": {
+        "type": "string",
+        "minLength": 1,
+        "maxLength": 128,
+        "description": "An identifier chosen by the producer. ULIDs are recommended; consumers treat it as opaque."
+      },
+      "Link": {
+        "type": "object",
+        "properties": {
+          "url": {
+            "type": "string",
+            "format": "uri"
+          },
+          "title": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "url"
+        ]
+      },
+      "Name": {
+        "type": "string",
+        "pattern": "^[a-z][a-z0-9-]{0,62}$",
+        "description": "A lowercase name: letters, digits and hyphens, starting with a letter. Agents, stages, adapters, sources."
+      },
+      "Origin": {
+        "type": "object",
+        "properties": {
+          "source": {
+            "$ref": "#/components/schemas/Name",
+            "description": "The channel or system, for example \"slack\", \"github\", \"sentry\", \"cron\", \"mcp\"."
+          },
+          "url": {
+            "type": "string",
+            "format": "uri",
+            "description": "Link back to the origin, for example the Slack thread. Absent for a schedule."
+          },
+          "externalId": {
+            "type": "string",
+            "description": "ID in the source system."
+          }
+        },
+        "required": [
+          "source"
+        ]
+      },
+      "PrClosed": {
+        "type": "object",
+        "properties": {
+          "specversion": {
+            "type": "string",
+            "const": "1.0"
+          },
+          "id": {
+            "$ref": "#/components/schemas/Identifier",
+            "description": "Unique per source. A consumer that sees the same source and id twice handles the event once."
+          },
+          "source": {
+            "type": "string",
+            "minLength": 1,
+            "description": "The producing module, for example \"/osf/intake\"."
+          },
+          "type": {
+            "type": "string",
+            "const": "pr.closed@v1"
+          },
+          "time": {
+            "type": "string",
+            "format": "date-time"
+          },
+          "subject": {
+            "type": "string",
+            "description": "The ID of the thing the event is about: work item, gate, run, score or pull request."
+          },
+          "datacontenttype": {
+            "type": "string",
+            "const": "application/json"
+          },
+          "dataschema": {
+            "type": "string",
+            "format": "uri"
+          },
+          "traceparent": {
+            "type": "string",
+            "description": "W3C trace context (CloudEvents distributed tracing extension)."
+          },
+          "data": {
+            "$ref": "#/components/schemas/PrClosedData"
+          }
+        },
+        "required": [
+          "specversion",
+          "id",
+          "source",
+          "type",
+          "time",
+          "data"
+        ],
+        "description": "forge adapters: a pull request was merged or closed without a merge."
+      },
+      "PrClosedData": {
+        "type": "object",
+        "properties": {
+          "url": {
+            "type": "string",
+            "format": "uri",
+            "description": "The pull request."
+          },
+          "merged": {
+            "type": "boolean",
+            "description": "True when the pull request was merged, false when it was closed without a merge."
+          },
+          "mergeCommit": {
+            "$ref": "#/components/schemas/CommitHash"
+          }
+        },
+        "required": [
+          "url",
+          "merged"
+        ]
+      },
+      "PrOpened": {
+        "type": "object",
+        "properties": {
+          "specversion": {
+            "type": "string",
+            "const": "1.0"
+          },
+          "id": {
+            "$ref": "#/components/schemas/Identifier",
+            "description": "Unique per source. A consumer that sees the same source and id twice handles the event once."
+          },
+          "source": {
+            "type": "string",
+            "minLength": 1,
+            "description": "The producing module, for example \"/osf/intake\"."
+          },
+          "type": {
+            "type": "string",
+            "const": "pr.opened@v1"
+          },
+          "time": {
+            "type": "string",
+            "format": "date-time"
+          },
+          "subject": {
+            "type": "string",
+            "description": "The ID of the thing the event is about: work item, gate, run, score or pull request."
+          },
+          "datacontenttype": {
+            "type": "string",
+            "const": "application/json"
+          },
+          "dataschema": {
+            "type": "string",
+            "format": "uri"
+          },
+          "traceparent": {
+            "type": "string",
+            "description": "W3C trace context (CloudEvents distributed tracing extension)."
+          },
+          "data": {
+            "$ref": "#/components/schemas/PrOpenedData"
+          }
+        },
+        "required": [
+          "specversion",
+          "id",
+          "source",
+          "type",
+          "time",
+          "data"
+        ],
+        "description": "forge adapters: the factory opened a pull request."
+      },
+      "PrOpenedData": {
+        "type": "object",
+        "properties": {
+          "url": {
+            "type": "string",
+            "format": "uri"
+          },
+          "repository": {
+            "type": "string",
+            "format": "uri"
+          },
+          "number": {
+            "type": "integer",
+            "minimum": 1
+          },
+          "title": {
+            "type": "string",
+            "minLength": 1
+          },
+          "headBranch": {
+            "type": "string"
+          },
+          "baseBranch": {
+            "type": "string"
+          },
+          "headCommit": {
+            "$ref": "#/components/schemas/CommitHash"
+          },
+          "author": {
+            "$ref": "#/components/schemas/Actor"
+          },
+          "workItemId": {
+            "$ref": "#/components/schemas/Identifier"
+          },
+          "runId": {
+            "$ref": "#/components/schemas/Identifier"
+          }
+        },
+        "required": [
+          "url",
+          "repository",
+          "number",
+          "title",
+          "headBranch",
+          "baseBranch",
+          "headCommit",
+          "author"
+        ]
+      },
+      "PrReviewed": {
+        "type": "object",
+        "properties": {
+          "specversion": {
+            "type": "string",
+            "const": "1.0"
+          },
+          "id": {
+            "$ref": "#/components/schemas/Identifier",
+            "description": "Unique per source. A consumer that sees the same source and id twice handles the event once."
+          },
+          "source": {
+            "type": "string",
+            "minLength": 1,
+            "description": "The producing module, for example \"/osf/intake\"."
+          },
+          "type": {
+            "type": "string",
+            "const": "pr.reviewed@v1"
+          },
+          "time": {
+            "type": "string",
+            "format": "date-time"
+          },
+          "subject": {
+            "type": "string",
+            "description": "The ID of the thing the event is about: work item, gate, run, score or pull request."
+          },
+          "datacontenttype": {
+            "type": "string",
+            "const": "application/json"
+          },
+          "dataschema": {
+            "type": "string",
+            "format": "uri"
+          },
+          "traceparent": {
+            "type": "string",
+            "description": "W3C trace context (CloudEvents distributed tracing extension)."
+          },
+          "data": {
+            "$ref": "#/components/schemas/PrReviewedData"
+          }
+        },
+        "required": [
+          "specversion",
+          "id",
+          "source",
+          "type",
+          "time",
+          "data"
+        ],
+        "description": "forge adapters: a person, an agent or a bot reviewed or commented on a pull request."
+      },
+      "PrReviewedData": {
+        "type": "object",
+        "properties": {
+          "url": {
+            "type": "string",
+            "format": "uri",
+            "description": "The pull request."
+          },
+          "reviewer": {
+            "$ref": "#/components/schemas/Actor"
+          },
+          "automated": {
+            "type": "boolean",
+            "description": "True when an agent or a bot wrote the review, not a person."
+          },
+          "state": {
+            "$ref": "#/components/schemas/ReviewState"
+          }
+        },
+        "required": [
+          "url",
+          "reviewer",
+          "state"
+        ]
+      },
+      "Priority": {
+        "type": "string",
+        "enum": [
+          "urgent",
+          "high",
+          "normal",
+          "low"
+        ]
+      },
+      "Producer": {
+        "type": "object",
+        "properties": {
+          "name": {
+            "type": "string",
+            "minLength": 1
+          },
+          "version": {
+            "type": "string",
+            "minLength": 1
+          }
+        },
+        "required": [
+          "name",
+          "version"
+        ]
+      },
+      "Providers": {
+        "type": "object",
+        "properties": {
+          "harness": {
+            "type": "object",
+            "properties": {},
+            "unevaluatedProperties": {
+              "$ref": "#/components/schemas/VersionRange"
+            }
+          },
+          "sandbox": {
+            "type": "object",
+            "properties": {},
+            "unevaluatedProperties": {
+              "$ref": "#/components/schemas/VersionRange"
+            }
+          },
+          "channel": {
+            "type": "object",
+            "properties": {},
+            "unevaluatedProperties": {
+              "$ref": "#/components/schemas/VersionRange"
+            }
+          },
+          "tracker": {
+            "type": "object",
+            "properties": {},
+            "unevaluatedProperties": {
+              "$ref": "#/components/schemas/VersionRange"
+            }
+          },
+          "forge": {
+            "type": "object",
+            "properties": {},
+            "unevaluatedProperties": {
+              "$ref": "#/components/schemas/VersionRange"
+            }
+          },
+          "inference": {
+            "type": "object",
+            "properties": {},
+            "unevaluatedProperties": {
+              "$ref": "#/components/schemas/VersionRange"
+            }
+          },
+          "secrets": {
+            "type": "object",
+            "properties": {},
+            "unevaluatedProperties": {
+              "$ref": "#/components/schemas/VersionRange"
+            }
+          },
+          "telemetry": {
+            "type": "object",
+            "properties": {},
+            "unevaluatedProperties": {
+              "$ref": "#/components/schemas/VersionRange"
+            }
+          },
+          "policy": {
+            "type": "object",
+            "properties": {},
+            "unevaluatedProperties": {
+              "$ref": "#/components/schemas/VersionRange"
+            }
+          }
+        },
+        "description": "The adapters a factory uses, per port (docs/architecture/internals.md). Keys are adapter names.",
+        "additionalProperties": false
+      },
+      "ReviewState": {
+        "type": "string",
+        "enum": [
+          "approved",
+          "changes_requested",
+          "commented"
+        ]
+      },
+      "RunCompleted": {
+        "type": "object",
+        "properties": {
+          "specversion": {
+            "type": "string",
+            "const": "1.0"
+          },
+          "id": {
+            "$ref": "#/components/schemas/Identifier",
+            "description": "Unique per source. A consumer that sees the same source and id twice handles the event once."
+          },
+          "source": {
+            "type": "string",
+            "minLength": 1,
+            "description": "The producing module, for example \"/osf/intake\"."
+          },
+          "type": {
+            "type": "string",
+            "const": "run.completed@v1"
+          },
+          "time": {
+            "type": "string",
+            "format": "date-time"
+          },
+          "subject": {
+            "type": "string",
+            "description": "The ID of the thing the event is about: work item, gate, run, score or pull request."
+          },
+          "datacontenttype": {
+            "type": "string",
+            "const": "application/json"
+          },
+          "dataschema": {
+            "type": "string",
+            "format": "uri"
+          },
+          "traceparent": {
+            "type": "string",
+            "description": "W3C trace context (CloudEvents distributed tracing extension)."
+          },
+          "data": {
+            "$ref": "#/components/schemas/RunCompletedData"
+          }
+        },
+        "required": [
+          "specversion",
+          "id",
+          "source",
+          "type",
+          "time",
+          "data"
+        ],
+        "description": "foreman: a run ended."
+      },
+      "RunCompletedData": {
+        "type": "object",
+        "properties": {
+          "runId": {
+            "$ref": "#/components/schemas/Identifier"
+          },
+          "workItemId": {
+            "$ref": "#/components/schemas/Identifier"
+          },
+          "stage": {
+            "$ref": "#/components/schemas/Name"
+          },
+          "factoryVersion": {
+            "$ref": "#/components/schemas/CommitHash"
+          },
+          "outcome": {
+            "$ref": "#/components/schemas/RunOutcome"
+          },
+          "startedAt": {
+            "type": "string",
+            "format": "date-time"
+          },
+          "endedAt": {
+            "type": "string",
+            "format": "date-time"
+          },
+          "requester": {
+            "$ref": "#/components/schemas/Actor"
+          },
+          "source": {
+            "$ref": "#/components/schemas/Name"
+          },
+          "costUsd": {
+            "type": "number",
+            "minimum": 0
+          },
+          "traceId": {
+            "$ref": "#/components/schemas/TraceId"
+          },
+          "pullRequests": {
+            "type": "array",
+            "items": {
+              "type": "string",
+              "format": "uri"
+            }
+          },
+          "evidenceBundle": {
+            "type": "string",
+            "format": "uri"
+          }
+        },
+        "required": [
+          "runId",
+          "workItemId",
+          "factoryVersion",
+          "outcome",
+          "startedAt",
+          "endedAt",
+          "requester",
+          "source"
+        ]
+      },
+      "RunOutcome": {
+        "type": "string",
+        "enum": [
+          "succeeded",
+          "failed",
+          "cancelled"
+        ],
+        "description": "How a run ended."
+      },
+      "RunRecord": {
+        "type": "object",
+        "properties": {
+          "resource": {
+            "$ref": "#/components/schemas/RunResource"
+          },
+          "span": {
+            "$ref": "#/components/schemas/RunSpan"
+          }
+        },
+        "required": [
+          "resource",
+          "span"
+        ],
+        "description": "The attributes of one run: the OTel resource of every span of the run, and the attributes of its root\n`invoke_agent` span. The run record travels as OTLP; this schema fixes the attribute names and types.\nRealizes SCN-FACTORY-DATA-001 (record shape) and SCN-FACTORY-RUNTIME-008 (attribution)."
+      },
+      "RunResource": {
+        "type": "object",
+        "properties": {
+          "service.name": {
+            "type": "string"
+          },
+          "osf.run.id": {
+            "$ref": "#/components/schemas/Identifier"
+          },
+          "osf.work_item.id": {
+            "$ref": "#/components/schemas/Identifier"
+          },
+          "osf.factory.version": {
+            "$ref": "#/components/schemas/CommitHash",
+            "description": "Commit of the factory definition the run used."
+          },
+          "osf.stage": {
+            "$ref": "#/components/schemas/Name"
+          },
+          "osf.requester.kind": {
+            "$ref": "#/components/schemas/ActorKind"
+          },
+          "osf.requester.id": {
+            "type": "string"
+          },
+          "osf.source": {
+            "$ref": "#/components/schemas/Name",
+            "description": "Where the run was started from, for example \"slack\", \"github\", \"cli\"."
+          },
+          "osf.origin.url": {
+            "type": "string",
+            "format": "uri"
+          },
+          "osf.harness.name": {
+            "$ref": "#/components/schemas/Name",
+            "description": "Harness adapter, for example \"claude-code\"."
+          },
+          "osf.harness.version": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "service.name",
+          "osf.run.id",
+          "osf.work_item.id",
+          "osf.factory.version",
+          "osf.requester.kind",
+          "osf.requester.id",
+          "osf.source",
+          "osf.harness.name"
+        ],
+        "description": "Set at launch through OTEL_RESOURCE_ATTRIBUTES, so it is on every span of the run."
+      },
+      "RunSpan": {
+        "type": "object",
+        "properties": {
+          "gen_ai.operation.name": {
+            "type": "string",
+            "const": "invoke_agent"
+          },
+          "gen_ai.provider.name": {
+            "type": "string"
+          },
+          "gen_ai.agent.name": {
+            "type": "string"
+          },
+          "gen_ai.conversation.id": {
+            "type": "string",
+            "description": "The harness session ID."
+          },
+          "gen_ai.request.model": {
+            "type": "string"
+          },
+          "gen_ai.response.model": {
+            "type": "string"
+          },
+          "gen_ai.usage.input_tokens": {
+            "type": "integer",
+            "minimum": 0
+          },
+          "gen_ai.usage.output_tokens": {
+            "type": "integer",
+            "minimum": 0
+          },
+          "gen_ai.usage.cache_read.input_tokens": {
+            "type": "integer",
+            "minimum": 0
+          },
+          "gen_ai.usage.cache_write.input_tokens": {
+            "type": "integer",
+            "minimum": 0
+          },
+          "osf.outcome": {
+            "$ref": "#/components/schemas/RunOutcome"
+          },
+          "osf.cost.usd": {
+            "type": "number",
+            "minimum": 0,
+            "description": "Cost of all model calls of the run, from the inference gateway."
+          },
+          "osf.transcript.uri": {
+            "type": "string",
+            "format": "uri",
+            "description": "Full transcript, stored when the run ends."
+          },
+          "osf.artifact.uris": {
+            "type": "array",
+            "items": {
+              "type": "string",
+              "format": "uri"
+            },
+            "description": "Artifacts of the run: reports, screenshots, videos."
+          },
+          "osf.pull_request.urls": {
+            "type": "array",
+            "items": {
+              "type": "string",
+              "format": "uri"
+            }
+          },
+          "osf.issue.urls": {
+            "type": "array",
+            "items": {
+              "type": "string",
+              "format": "uri"
+            }
+          },
+          "osf.evidence_bundle.uri": {
+            "type": "string",
+            "format": "uri"
+          },
+          "osf.agent_trace.uri": {
+            "type": "string",
+            "format": "uri",
+            "description": "Agent Trace record with line attribution of the run's changes."
+          }
+        },
+        "required": [
+          "gen_ai.operation.name",
+          "osf.outcome"
+        ],
+        "description": "Attributes of the root span of the run. GenAI names where a convention exists."
+      },
+      "Sandbox": {
+        "type": "object",
+        "properties": {
+          "template": {
+            "type": "string",
+            "minLength": 1,
+            "description": "Sandbox template name, for example \"node-24\"."
+          },
+          "cpu": {
+            "type": "number",
+            "minimum": 0.001,
+            "description": "CPU cores. The smallest unit is 0.001 (one millicore)."
+          },
+          "memory": {
+            "type": "string",
+            "pattern": "^[0-9]+(Ki|Mi|Gi|Ti)?$",
+            "description": "Kubernetes quantity, for example \"8Gi\"."
+          },
+          "egress": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            },
+            "description": "Hostnames the sandbox may reach. Everything else is blocked."
+          }
+        },
+        "required": [
+          "template"
+        ],
+        "additionalProperties": false
+      },
+      "ScenarioEvidence": {
+        "type": "object",
+        "properties": {
+          "id": {
+            "$ref": "#/components/schemas/ScenarioId"
+          },
+          "result": {
+            "$ref": "#/components/schemas/ScenarioResult"
+          },
+          "artifacts": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/BundlePath"
+            },
+            "description": "Paths of the artifacts in this bundle that prove the scenario."
+          },
+          "summary": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "id",
+          "result",
+          "artifacts"
+        ]
+      },
+      "ScenarioId": {
+        "type": "string",
+        "pattern": "^SCN-[A-Z][A-Z0-9]*(-[A-Z][A-Z0-9]*)*-[0-9]{3}$",
+        "description": "A scenario ID as checked by SPEC, for example SCN-PROOF-004."
+      },
+      "ScenarioResult": {
+        "type": "string",
+        "enum": [
+          "passed",
+          "failed",
+          "skipped"
+        ]
+      },
+      "Score": {
+        "type": "object",
+        "properties": {
+          "id": {
+            "$ref": "#/components/schemas/Identifier"
+          },
+          "name": {
+            "type": "string",
+            "minLength": 1,
+            "description": "Scorer name, for example \"redundant-tests\"."
+          },
+          "value": {
+            "anyOf": [
+              {
+                "type": "number"
+              },
+              {
+                "type": "string"
+              }
+            ],
+            "description": "A number for NUMERIC, 0 or 1 for BOOLEAN, a string for CATEGORICAL."
+          },
+          "dataType": {
+            "$ref": "#/components/schemas/ScoreDataType"
+          },
+          "traceId": {
+            "$ref": "#/components/schemas/TraceId",
+            "description": "Trace of the run (the OTel trace ID)."
+          },
+          "observationId": {
+            "type": "string",
+            "description": "Span the score is about, when it is not the whole run."
+          },
+          "sessionId": {
+            "type": "string"
+          },
+          "comment": {
+            "type": "string",
+            "description": "The reason."
+          },
+          "timestamp": {
+            "type": "string",
+            "format": "date-time"
+          },
+          "source": {
+            "$ref": "#/components/schemas/ScoreSource",
+            "description": "API for scorers, ANNOTATION for scores a person reviews."
+          },
+          "configId": {
+            "type": "string"
+          },
+          "environment": {
+            "type": "string"
+          },
+          "metadata": {
+            "$ref": "#/components/schemas/ScoreMetadata"
+          }
+        },
+        "required": [
+          "id",
+          "name",
+          "value",
+          "dataType",
+          "traceId",
+          "timestamp",
+          "metadata"
+        ],
+        "description": "The result of one scorer on one run. The fields are a subset of Langfuse's create-score request\n(POST /api/public/scores), so a score can be sent to Langfuse as is. Factory fields live in `metadata`."
+      },
+      "ScoreDataType": {
+        "type": "string",
+        "enum": [
+          "NUMERIC",
+          "BOOLEAN",
+          "CATEGORICAL"
+        ]
+      },
+      "ScoreMetadata": {
+        "type": "object",
+        "properties": {
+          "osf.run.id": {
+            "$ref": "#/components/schemas/Identifier"
+          },
+          "osf.scorer.version": {
+            "type": "string"
+          },
+          "osf.judge.model": {
+            "type": "string",
+            "description": "Judge model of an LLM scorer."
+          },
+          "osf.judge.cost.usd": {
+            "type": "number",
+            "minimum": 0,
+            "description": "Cost of the judge call."
+          }
+        },
+        "required": [
+          "osf.run.id"
+        ],
+        "unevaluatedProperties": {}
+      },
+      "ScoreRecorded": {
+        "type": "object",
+        "properties": {
+          "specversion": {
+            "type": "string",
+            "const": "1.0"
+          },
+          "id": {
+            "$ref": "#/components/schemas/Identifier",
+            "description": "Unique per source. A consumer that sees the same source and id twice handles the event once."
+          },
+          "source": {
+            "type": "string",
+            "minLength": 1,
+            "description": "The producing module, for example \"/osf/intake\"."
+          },
+          "type": {
+            "type": "string",
+            "const": "score.recorded@v1"
+          },
+          "time": {
+            "type": "string",
+            "format": "date-time"
+          },
+          "subject": {
+            "type": "string",
+            "description": "The ID of the thing the event is about: work item, gate, run, score or pull request."
+          },
+          "datacontenttype": {
+            "type": "string",
+            "const": "application/json"
+          },
+          "dataschema": {
+            "type": "string",
+            "format": "uri"
+          },
+          "traceparent": {
+            "type": "string",
+            "description": "W3C trace context (CloudEvents distributed tracing extension)."
+          },
+          "data": {
+            "$ref": "#/components/schemas/Score"
+          }
+        },
+        "required": [
+          "specversion",
+          "id",
+          "source",
+          "type",
+          "time",
+          "data"
+        ],
+        "description": "scorekit: a scorer scored a run."
+      },
+      "ScoreSource": {
+        "type": "string",
+        "enum": [
+          "API",
+          "ANNOTATION"
+        ]
+      },
+      "Scorer": {
+        "type": "object",
+        "properties": {
+          "judge": {
+            "type": "string",
+            "minLength": 1,
+            "description": "Path to the Markdown judge prompt."
+          },
+          "sample": {
+            "type": "number",
+            "minimum": 0,
+            "maximum": 1,
+            "description": "Share of runs to score, 0 to 1. Default 1."
+          }
+        },
+        "required": [
+          "judge"
+        ],
+        "additionalProperties": false
+      },
+      "SecretReference": {
+        "type": "string",
+        "pattern": "^ref:[a-z][a-z0-9-]*/[A-Za-z0-9_./-]+$",
+        "description": "A reference to a secret, resolved at the egress proxy, never in the sandbox: \"ref:<provider>/<name>\"."
+      },
+      "Sha256": {
+        "type": "string",
+        "pattern": "^[0-9a-f]{64}$"
+      },
+      "Stage": {
+        "type": "object",
+        "properties": {
+          "stage": {
+            "$ref": "#/components/schemas/Name"
+          },
+          "agent": {
+            "$ref": "#/components/schemas/Name",
+            "description": "Agent that runs the stage. Defaults to the agent with the stage's name."
+          },
+          "gate": {
+            "$ref": "#/components/schemas/Gate",
+            "description": "The stage waits for a decision before it starts."
+          },
+          "evidence": {
+            "$ref": "#/components/schemas/EvidenceRequirement",
+            "description": "Whether the stage must produce an evidence bundle."
+          }
+        },
+        "required": [
+          "stage"
+        ],
+        "additionalProperties": false
+      },
+      "TraceId": {
+        "type": "string",
+        "pattern": "^[0-9a-f]{32}$",
+        "description": "An OpenTelemetry trace ID: 32 lowercase hex characters."
+      },
+      "VerificationResult": {
+        "type": "string",
+        "enum": [
+          "passed",
+          "failed"
+        ]
+      },
+      "VersionRange": {
+        "type": "string",
+        "minLength": 1,
+        "description": "A semver range of an adapter, for example \"^2\"."
+      },
+      "WorkItem": {
+        "type": "object",
+        "properties": {
+          "id": {
+            "$ref": "#/components/schemas/Identifier"
+          },
+          "type": {
+            "$ref": "#/components/schemas/WorkItemType"
+          },
+          "title": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 300
+          },
+          "description": {
+            "type": "string"
+          },
+          "requester": {
+            "$ref": "#/components/schemas/Actor",
+            "description": "The person or trigger that asked for the work."
+          },
+          "origin": {
+            "$ref": "#/components/schemas/Origin",
+            "description": "Where the work came from."
+          },
+          "dedupeKey": {
+            "type": "string",
+            "minLength": 1,
+            "description": "Requests with the same key become one work item, for example \"github:acme/web#42\"."
+          },
+          "surface": {
+            "type": "string",
+            "description": "Product surface the work is about, for example \"checkout\"."
+          },
+          "priority": {
+            "$ref": "#/components/schemas/Priority",
+            "description": "Set by triage."
+          },
+          "links": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/Link"
+            },
+            "description": "Related material: an error report, a change, a document."
+          }
+        },
+        "required": [
+          "id",
+          "type",
+          "title",
+          "requester",
+          "origin",
+          "dedupeKey"
+        ],
+        "description": "One unit of requested work: the `data` of a `work.received@v1` CloudEvent."
+      },
+      "WorkItemType": {
+        "type": "string",
+        "enum": [
+          "idea",
+          "bug",
+          "task",
+          "automation"
+        ]
+      },
+      "WorkReceived": {
+        "type": "object",
+        "properties": {
+          "specversion": {
+            "type": "string",
+            "const": "1.0"
+          },
+          "id": {
+            "$ref": "#/components/schemas/Identifier",
+            "description": "Unique per source. A consumer that sees the same source and id twice handles the event once."
+          },
+          "source": {
+            "type": "string",
+            "minLength": 1,
+            "description": "The producing module, for example \"/osf/intake\"."
+          },
+          "type": {
+            "type": "string",
+            "const": "work.received@v1"
+          },
+          "time": {
+            "type": "string",
+            "format": "date-time"
+          },
+          "subject": {
+            "type": "string",
+            "description": "The ID of the thing the event is about: work item, gate, run, score or pull request."
+          },
+          "datacontenttype": {
+            "type": "string",
+            "const": "application/json"
+          },
+          "dataschema": {
+            "type": "string",
+            "format": "uri"
+          },
+          "traceparent": {
+            "type": "string",
+            "description": "W3C trace context (CloudEvents distributed tracing extension)."
+          },
+          "data": {
+            "$ref": "#/components/schemas/WorkItem"
+          }
+        },
+        "required": [
+          "specversion",
+          "id",
+          "source",
+          "type",
+          "time",
+          "data"
+        ],
+        "description": "intake: a work item was accepted."
+      }
+    }
+  }
+}