@the-open-engine/zeroshot 6.11.0 → 6.13.0

package/src/cluster/generated/protocol-schema.ts

@@ -0,0 +1,2 @@
+// Generated from protocol/openengine-cluster/v1/schema.json. Do not edit.
+export const CLUSTER_PROTOCOL_SCHEMA: unknown = {"$defs":{"AdmissionTransition":{"additionalProperties":false,"properties":{"runId":{"type":"string"},"seedInput":true,"spec":{"$ref":"#/$defs/GraphSpec"}},"required":["runId","spec","seedInput"],"type":"object"},"AgentAttachClosedNotification":{"additionalProperties":false,"description":"Wire body of the terminal `subscription/closed` server notification for an `agent/attach`\nsubscription. Deliberately carries no cursor field -- `agent/attach` gives a type-level\n\"cursorless\" guarantee, unlike [`crate::SubscriptionClosedNotification`].","properties":{"reason":{"$ref":"#/$defs/SubscriptionCloseReason"},"subscriptionId":{"type":"string"}},"required":["subscriptionId","reason"],"type":"object"},"AgentAttachEvent":{"description":"The closed public agent-attach progress algebra. This is the only representable shape:\nreasoning, tools, provider frames, usage, and session identifiers have no variant. `Working`\nand `Settled` are empty struct variants rather than bare units: serde's internally tagged enum\ndeserialization silently ignores unknown fields on a unit variant regardless of\n`deny_unknown_fields`, which would otherwise let an unrepresentable field ride along\nundetected on either of these two variants.","oneOf":[{"additionalProperties":false,"properties":{"type":{"const":"working","type":"string"}},"required":["type"],"type":"object"},{"additionalProperties":false,"properties":{"text":{"maxLength":16384,"pattern":"^[^\\u0000-\\u001f\\u007f-\\u009f]*$","type":"string"},"type":{"const":"output","type":"string"}},"required":["type","text"],"type":"object"},{"additionalProperties":false,"properties":{"type":{"const":"settled","type":"string"}},"required":["type"],"type":"object"}]},"AgentAttachEventNotification":{"$ref":"#/$defs/AgentAttachEventNotificationWire"},"AgentAttachEventNotificationWire":{"additionalProperties":false,"properties":{"event":{"$ref":"#/$defs/AgentAttachEvent"},"subscriptionId":{"type":"string"}},"required":["subscriptionId","event"],"type":"object"},"AgentAttachParams":{"additionalProperties":false,"description":"`agent/attach` establishment parameters: the named `{execution}` request. Deliberately closed,\nrejecting any unknown field.","properties":{"execution":{"maxLength":128,"minLength":1,"pattern":"^[^\\u0000-\\u001f\\u007f-\\u009f]+$","type":"string"}},"required":["execution"],"type":"object"},"AgentAttachResult":{"additionalProperties":false,"description":"The `agent/attach` establishment result: only a `subscriptionId`. Deliberately carries no\n`runId` or `atCursor` -- `agent/attach` is not run-scoped and has no cursor.","properties":{"subscriptionId":{"type":"string"}},"required":["subscriptionId"],"type":"object"},"ApplyParams":{"additionalProperties":false,"properties":{"dryRun":{"default":false,"type":"boolean"},"graph":{"$ref":"#/$defs/GraphSpec"},"idempotencyKey":{"maxLength":256,"minLength":1,"pattern":"^[^\\u0000-\\u001f\\u007f-\\u009f]+$","type":"string"},"ifGeneration":{"maximum":9007199254740991,"minimum":0,"type":"integer"},"input":true},"required":["graph"],"type":"object"},"ApplyResult":{"additionalProperties":false,"properties":{"deduped":{"type":"boolean"},"diff":{"anyOf":[{"$ref":"#/$defs/GraphDiff"},{"type":"null"}]},"generation":{"maximum":9007199254740991,"minimum":0,"type":["integer","null"]},"phase":{"$ref":"#/$defs/Phase"},"runId":{"type":["string","null"]}},"required":["phase","deduped"],"type":"object"},"ArtifactLineage":{"additionalProperties":false,"properties":{"attempt":{"maximum":9007199254740991,"minimum":1,"type":"integer"},"generation":{"maximum":9007199254740991,"minimum":0,"type":"integer"},"runId":{"type":"string"}},"required":["generation","runId","attempt"],"type":"object"},"ArtifactProducer":{"additionalProperties":false,"properties":{"node":{"maxLength":128,"minLength":1,"pattern":"^[A-Za-z_][A-Za-z0-9_.-]*$","type":"string"},"worker":{"maxLength":256,"pattern":"^[A-Za-z_][A-Za-z0-9_.-]*@[1-9][0-9]*$","type":"string"}},"required":["node","worker"],"type":"object"},"ArtifactRef":{"additionalProperties":false,"properties":{"artifactId":{"maxLength":256,"minLength":1,"pattern":"^[^\\u0000-\\u001f\\u007f-\\u009f]+$","type":"string"},"byteLength":{"maximum":9007199254740991,"minimum":0,"type":"integer"},"lineage":{"$ref":"#/$defs/ArtifactLineage"},"mediaType":{"maxLength":256,"minLength":1,"pattern":"^[^\\u0000-\\u001f\\u007f-\\u009f]+$","type":"string"},"producer":{"$ref":"#/$defs/ArtifactProducer"},"redaction":{"$ref":"#/$defs/RedactionClass"},"sha256":{"pattern":"^[0-9a-f]{64}$","type":"string"},"typeId":{"maxLength":256,"pattern":"^[A-Za-z_][A-Za-z0-9_.-]*@[1-9][0-9]*$","type":"string"}},"required":["artifactId","sha256","byteLength","mediaType","typeId","producer","lineage","redaction"],"type":"object"},"BackendFault":{"$ref":"#/$defs/BackendFaultWire"},"BackendFaultWire":{"additionalProperties":false,"properties":{"action":{"$ref":"#/$defs/FaultAction"},"code":{"$ref":"#/$defs/FaultCode"},"consequence":{"$ref":"#/$defs/FaultConsequence"},"eventId":{"maxLength":256,"minLength":1,"pattern":"^[^\\u0000-\\u001f\\u007f-\\u009f]+$","type":"string"},"executionRef":{"default":null,"maxLength":256,"minLength":1,"pattern":"^[^\\u0000-\\u001f\\u007f-\\u009f]+$","type":["string","null"]},"retry":{"$ref":"#/$defs/FaultRetryDisposition"},"severity":{"$ref":"#/$defs/FaultSeverity"},"source":{"items":{"$ref":"#/$defs/FaultSourceFrame"},"maxItems":8,"type":"array"},"summary":{"maxLength":256,"minLength":1,"pattern":"^[^\\u0000-\\u001f\\u007f-\\u009f]+$","type":"string"}},"required":["eventId","code","consequence","retry","action","severity","summary","source"],"type":"object"},"CancelRequestParams":{"additionalProperties":false,"description":"Wire body of the `$/cancelRequest` client notification: best-effort cancellation of an\nin-flight unary request by its `RequestId`. Unknown or already-completed ids are a silent\nno-op; cancelling after the backend has committed leaves that committed state unchanged and\nemits no response or compensation.","properties":{"id":{"$ref":"#/$defs/RequestId"}},"required":["id"],"type":"object"},"ChoiceBranch":{"additionalProperties":false,"properties":{"node":{"$ref":"#/$defs/GraphNode"},"when":{"$ref":"#/$defs/Guard"}},"required":["when","node"],"type":"object"},"ClusterStatus":{"properties":{"atCursor":{"type":["string","null"]},"currentRunId":{"type":["string","null"]},"observedGeneration":{"maximum":9007199254740991,"minimum":0,"type":["integer","null"]},"operational":{"anyOf":[{"$ref":"#/$defs/OperationalStatus"},{"type":"null"}]},"phase":{"$ref":"#/$defs/Phase"}},"required":["phase"],"type":"object"},"ControlSelector":{"additionalProperties":false,"properties":{"field":{"maxLength":128,"minLength":1,"pattern":"^[A-Za-z_][A-Za-z0-9_.-]*$","type":["string","null"]},"name":{"maxLength":128,"minLength":1,"pattern":"^[A-Za-z_][A-Za-z0-9_.-]*$","type":"string"},"source":{"$ref":"#/$defs/ControlSource"}},"required":["name","source"],"type":"object"},"ControlSource":{"enum":["signal","error","group"],"type":"string"},"DataSelector":{"oneOf":[{"additionalProperties":false,"properties":{"path":{"items":{"maxLength":128,"minLength":1,"pattern":"^[A-Za-z_][A-Za-z0-9_.-]*$","type":"string"},"maxItems":64,"minItems":1,"type":"array"},"source":{"const":"state","type":"string"}},"required":["source","path"],"type":"object"},{"additionalProperties":false,"properties":{"path":{"items":{"maxLength":128,"minLength":1,"pattern":"^[A-Za-z_][A-Za-z0-9_.-]*$","type":"string"},"maxItems":64,"minItems":1,"type":"array"},"source":{"const":"item","type":"string"}},"required":["source","path"],"type":"object"}]},"DeleteParams":{"additionalProperties":false,"properties":{"idempotencyKey":{"maxLength":256,"minLength":1,"pattern":"^[^\\u0000-\\u001f\\u007f-\\u009f]+$","type":"string"},"ifGeneration":{"maximum":9007199254740991,"minimum":0,"type":"integer"},"ifRunId":{"type":["string","null"]}},"required":["ifGeneration","idempotencyKey"],"type":"object"},"DeleteResult":{"additionalProperties":false,"properties":{"atCursor":{"type":["string","null"]},"deduped":{"type":"boolean"},"deleted":{"type":"boolean"},"generation":{"maximum":9007199254740991,"minimum":0,"type":["integer","null"]},"phase":{"$ref":"#/$defs/Phase"},"runId":{"type":["string","null"]}},"required":["deleted","phase","deduped"],"type":"object"},"DiagnosticPathSegment":{"oneOf":[{"additionalProperties":false,"properties":{"kind":{"const":"field","type":"string"},"name":{"maxLength":128,"minLength":1,"pattern":"^[A-Za-z_][A-Za-z0-9_.-]*$","type":"string"}},"required":["kind","name"],"type":"object"},{"additionalProperties":false,"properties":{"index":{"format":"uint32","maximum":4294967295,"minimum":0,"type":"integer"},"kind":{"const":"index","type":"string"}},"required":["kind","index"],"type":"object"},{"additionalProperties":false,"properties":{"kind":{"const":"node","type":"string"},"name":{"maxLength":128,"minLength":1,"pattern":"^[A-Za-z_][A-Za-z0-9_.-]*$","type":"string"}},"required":["kind","name"],"type":"object"}]},"DiagnosticSeverity":{"enum":["error","warning","info"],"type":"string"},"DispatchState":{"enum":["active","suspended","draining","force_stopping","stopped"],"type":"string"},"DomainErrorData":{"properties":{"code":{"type":"string"},"details":true},"required":["code"],"type":"object"},"EventNotification":{"additionalProperties":false,"description":"Wire body of the generic `event` server notification.","properties":{"cursor":{"type":"string"},"event":{"$ref":"#/$defs/WatchEvent"},"runId":{"type":"string"},"subscriptionId":{"type":"string"}},"required":["subscriptionId","runId","cursor","event"],"type":"object"},"FaultAction":{"description":"Descriptive only, like [`FaultRetryDisposition`]: naming `Retry` never itself retries or\nauthorizes a retry.","enum":["none","retry","wait","escalate","abort"],"type":"string"},"FaultCode":{"enum":["unavailable","resource_exhausted","deadline_exceeded","permission_denied","failed_precondition","not_found","aborted","internal","unknown"],"type":"string"},"FaultConsequence":{"enum":["turn_failed","run_failed","run_degraded","no_observable_effect"],"type":"string"},"FaultRetryDisposition":{"description":"Descriptive only: no `BackendFault` and no `fault` event ever performs or authorizes a retry.\nEvent ordering and emission never themselves change terminal semantics.","enum":["retryable","retryable_after_backoff","not_retryable","indeterminate"],"type":"string"},"FaultSeverity":{"enum":["info","warning","error","critical"],"type":"string"},"FaultSourceFrame":{"additionalProperties":false,"properties":{"component":{"maxLength":256,"minLength":1,"pattern":"^[^\\u0000-\\u001f\\u007f-\\u009f]+$","type":"string"}},"required":["component"],"type":"object"},"GetParams":{"additionalProperties":false,"properties":{"atCursor":{"default":null,"type":["string","null"]}},"type":"object"},"GetResult":{"properties":{"atCursor":{"type":["string","null"]},"spec":{"anyOf":[{"$ref":"#/$defs/GraphSpec"},{"type":"null"}]},"status":{"$ref":"#/$defs/ClusterStatus"}},"required":["status"],"type":"object"},"GraphDiagnostic":{"additionalProperties":false,"properties":{"code":{"$ref":"#/$defs/GraphDiagnosticCode"},"message":{"type":"string"},"path":{"items":{"$ref":"#/$defs/DiagnosticPathSegment"},"type":"array"},"relatedNodes":{"items":{"maxLength":128,"minLength":1,"pattern":"^[A-Za-z_][A-Za-z0-9_.-]*$","type":"string"},"type":"array"},"severity":{"$ref":"#/$defs/DiagnosticSeverity"}},"required":["severity","code","message","path","relatedNodes"],"type":"object"},"GraphDiagnosticCode":{"enum":["schema_safety","reachability","choice_exhaustiveness","loop_exit_satisfiability","missing_bound","write_conflict","ceiling_exceeded","cyclic_reference","undefined_read","invalid_graph_shape"],"type":"string"},"GraphDiff":{"additionalProperties":false,"properties":{"added":{"items":{"maxLength":128,"minLength":1,"pattern":"^[A-Za-z_][A-Za-z0-9_.-]*$","type":"string"},"type":"array"},"changed":{"items":{"maxLength":128,"minLength":1,"pattern":"^[A-Za-z_][A-Za-z0-9_.-]*$","type":"string"},"type":"array"},"removed":{"items":{"maxLength":128,"minLength":1,"pattern":"^[A-Za-z_][A-Za-z0-9_.-]*$","type":"string"},"type":"array"}},"required":["added","removed","changed"],"type":"object"},"GraphNode":{"oneOf":[{"additionalProperties":false,"properties":{"attempts":{"maximum":9007199254740991,"minimum":1,"type":"integer"},"input":{"$ref":"#/$defs/PayloadType"},"inputBindings":{"items":{"$ref":"#/$defs/InputBinding"},"type":"array"},"kind":{"const":"step","type":"string"},"name":{"maxLength":128,"minLength":1,"pattern":"^[A-Za-z_][A-Za-z0-9_.-]*$","type":"string"},"output":{"$ref":"#/$defs/PayloadType"},"timeoutMs":{"maximum":9007199254740991,"minimum":1,"type":"integer"},"worker":{"maxLength":256,"pattern":"^[A-Za-z_][A-Za-z0-9_.-]*@[1-9][0-9]*$","type":"string"},"writeBindings":{"items":{"$ref":"#/$defs/WriteBinding"},"type":"array"}},"required":["kind","name","worker","input","output","inputBindings","writeBindings","timeoutMs","attempts"],"type":"object"},{"additionalProperties":false,"properties":{"attempts":{"maximum":9007199254740991,"minimum":1,"type":"integer"},"diagnostic":{"$ref":"#/$defs/PayloadType"},"input":{"$ref":"#/$defs/PayloadType"},"inputBindings":{"items":{"$ref":"#/$defs/InputBinding"},"type":"array"},"kind":{"const":"verifier","type":"string"},"name":{"maxLength":128,"minLength":1,"pattern":"^[A-Za-z_][A-Za-z0-9_.-]*$","type":"string"},"output":{"$ref":"#/$defs/PayloadType"},"signals":{"additionalProperties":{"items":{"maxLength":128,"minLength":1,"pattern":"^[A-Za-z_][A-Za-z0-9_.-]*$","type":"string"},"maxItems":4096,"minItems":1,"type":"array","uniqueItems":true},"propertyNames":{"maxLength":128,"minLength":1,"pattern":"^[A-Za-z_][A-Za-z0-9_.-]*$","type":"string"},"type":"object"},"timeoutMs":{"maximum":9007199254740991,"minimum":1,"type":"integer"},"worker":{"maxLength":256,"pattern":"^[A-Za-z_][A-Za-z0-9_.-]*@[1-9][0-9]*$","type":"string"},"writeBindings":{"items":{"$ref":"#/$defs/WriteBinding"},"type":"array"}},"required":["kind","name","worker","input","output","inputBindings","writeBindings","timeoutMs","attempts","signals","diagnostic"],"type":"object"},{"additionalProperties":false,"properties":{"children":{"$ref":"#/$defs/NonEmptyVec_of_GraphNode"},"kind":{"const":"seq","type":"string"},"name":{"maxLength":128,"minLength":1,"pattern":"^[A-Za-z_][A-Za-z0-9_.-]*$","type":"string"},"promotedStatePaths":{"items":{"items":{"maxLength":128,"minLength":1,"pattern":"^[A-Za-z_][A-Za-z0-9_.-]*$","type":"string"},"maxItems":64,"minItems":1,"type":"array"},"type":"array"},"state":{"$ref":"#/$defs/PayloadType"}},"required":["kind","name","state","children","promotedStatePaths"],"type":"object"},{"additionalProperties":false,"properties":{"branches":{"$ref":"#/$defs/NonEmptyVec_of_ChoiceBranch"},"kind":{"const":"choice","type":"string"},"name":{"maxLength":128,"minLength":1,"pattern":"^[A-Za-z_][A-Za-z0-9_.-]*$","type":"string"},"otherwise":{"anyOf":[{"$ref":"#/$defs/GraphNode"},{"type":"null"}]},"promotedStatePaths":{"items":{"items":{"maxLength":128,"minLength":1,"pattern":"^[A-Za-z_][A-Za-z0-9_.-]*$","type":"string"},"maxItems":64,"minItems":1,"type":"array"},"type":"array"},"state":{"$ref":"#/$defs/PayloadType"}},"required":["kind","name","state","branches","promotedStatePaths"],"type":"object"},{"additionalProperties":false,"properties":{"branches":{"$ref":"#/$defs/NonEmptyVec_of_GraphNode"},"join":{"$ref":"#/$defs/Join"},"kind":{"const":"par","type":"string"},"name":{"maxLength":128,"minLength":1,"pattern":"^[A-Za-z_][A-Za-z0-9_.-]*$","type":"string"},"promotedStatePaths":{"items":{"items":{"maxLength":128,"minLength":1,"pattern":"^[A-Za-z_][A-Za-z0-9_.-]*$","type":"string"},"maxItems":64,"minItems":1,"type":"array"},"type":"array"},"state":{"$ref":"#/$defs/PayloadType"}},"required":["kind","name","state","branches","promotedStatePaths","join"],"type":"object"},{"additionalProperties":false,"properties":{"body":{"$ref":"#/$defs/GraphNode"},"kind":{"const":"loop","type":"string"},"maxIterations":{"maximum":9007199254740991,"minimum":1,"type":"integer"},"name":{"maxLength":128,"minLength":1,"pattern":"^[A-Za-z_][A-Za-z0-9_.-]*$","type":"string"},"promotedStatePaths":{"items":{"items":{"maxLength":128,"minLength":1,"pattern":"^[A-Za-z_][A-Za-z0-9_.-]*$","type":"string"},"maxItems":64,"minItems":1,"type":"array"},"type":"array"},"state":{"$ref":"#/$defs/PayloadType"},"until":{"$ref":"#/$defs/Guard"}},"required":["kind","name","state","body","until","maxIterations","promotedStatePaths"],"type":"object"},{"additionalProperties":false,"properties":{"body":{"$ref":"#/$defs/GraphNode"},"kind":{"const":"map","type":"string"},"maxItems":{"maximum":9007199254740991,"minimum":1,"type":"integer"},"name":{"maxLength":128,"minLength":1,"pattern":"^[A-Za-z_][A-Za-z0-9_.-]*$","type":"string"},"over":{"$ref":"#/$defs/DataSelector"},"promotedStatePaths":{"items":{"items":{"maxLength":128,"minLength":1,"pattern":"^[A-Za-z_][A-Za-z0-9_.-]*$","type":"string"},"maxItems":64,"minItems":1,"type":"array"},"type":"array"},"state":{"$ref":"#/$defs/PayloadType"}},"required":["kind","name","state","body","over","maxItems","promotedStatePaths"],"type":"object"},{"additionalProperties":false,"properties":{"bindings":{"items":{"$ref":"#/$defs/InputBinding"},"type":"array"},"kind":{"const":"succeed","type":"string"},"name":{"maxLength":128,"minLength":1,"pattern":"^[A-Za-z_][A-Za-z0-9_.-]*$","type":"string"},"output":{"$ref":"#/$defs/PayloadType"}},"required":["kind","name","output","bindings"],"type":"object"},{"additionalProperties":false,"properties":{"kind":{"const":"fail","type":"string"},"name":{"maxLength":128,"minLength":1,"pattern":"^[A-Za-z_][A-Za-z0-9_.-]*$","type":"string"},"reason":{"maxLength":128,"minLength":1,"pattern":"^(?!unhandled$)[A-Za-z_][A-Za-z0-9_.-]*$","type":"string"}},"required":["kind","name","reason"],"type":"object"}]},"GraphProfile":{"enum":["openengine.graph.full/v1","openengine.graph.single-worker/v1"],"type":"string"},"GraphSpec":{"additionalProperties":false,"properties":{"initialInput":{"$ref":"#/$defs/PayloadType"},"policy":{"$ref":"#/$defs/PolicyBinding"},"profile":{"$ref":"#/$defs/GraphProfile"},"root":{"$ref":"#/$defs/GraphNode"}},"required":["profile","initialInput","policy","root"],"type":"object"},"Guard":{"oneOf":[{"additionalProperties":false,"properties":{"kind":{"const":"in","type":"string"},"labels":{"items":{"maxLength":128,"minLength":1,"pattern":"^[A-Za-z_][A-Za-z0-9_.-]*$","type":"string"},"maxItems":4096,"minItems":1,"type":"array","uniqueItems":true},"value":{"$ref":"#/$defs/ControlSelector"}},"required":["kind","value","labels"],"type":"object"},{"additionalProperties":false,"properties":{"guards":{"$ref":"#/$defs/NonEmptyVec_of_Guard"},"kind":{"const":"all","type":"string"}},"required":["kind","guards"],"type":"object"},{"additionalProperties":false,"properties":{"guards":{"$ref":"#/$defs/NonEmptyVec_of_Guard"},"kind":{"const":"any","type":"string"}},"required":["kind","guards"],"type":"object"},{"additionalProperties":false,"properties":{"guard":{"$ref":"#/$defs/Guard"},"kind":{"const":"not","type":"string"}},"required":["kind","guard"],"type":"object"},{"additionalProperties":false,"properties":{"count":{"maximum":9007199254740991,"minimum":1,"type":"integer"},"kind":{"const":"k_of_n","type":"string"},"labels":{"items":{"maxLength":128,"minLength":1,"pattern":"^[A-Za-z_][A-Za-z0-9_.-]*$","type":"string"},"maxItems":4096,"minItems":1,"type":"array","uniqueItems":true},"values":{"$ref":"#/$defs/NonEmptyVec_of_ControlSelector"}},"required":["kind","count","values","labels"],"type":"object"},{"additionalProperties":false,"properties":{"count":{"maximum":9007199254740991,"minimum":1,"type":"integer"},"kind":{"const":"k_of_map","type":"string"},"labels":{"items":{"maxLength":128,"minLength":1,"pattern":"^[A-Za-z_][A-Za-z0-9_.-]*$","type":"string"},"maxItems":4096,"minItems":1,"type":"array","uniqueItems":true},"value":{"$ref":"#/$defs/ControlSelector"}},"required":["kind","count","value","labels"],"type":"object"}]},"InitializeParams":{"additionalProperties":false,"properties":{"protocolVersion":{"const":"openengine.cluster/v1","type":"string"}},"required":["protocolVersion"],"type":"object"},"InitializeResult":{"properties":{"capabilities":{"$ref":"#/$defs/ServerCapabilities"},"protocolVersion":{"const":"openengine.cluster/v1","type":"string"},"status":{"$ref":"#/$defs/ClusterStatus"}},"required":["protocolVersion","capabilities","status"],"type":"object"},"InputBinding":{"additionalProperties":false,"properties":{"target":{"items":{"maxLength":128,"minLength":1,"pattern":"^[A-Za-z_][A-Za-z0-9_.-]*$","type":"string"},"maxItems":64,"minItems":1,"type":"array"},"value":{"$ref":"#/$defs/DataSelector"}},"required":["target","value"],"type":"object"},"Join":{"oneOf":[{"additionalProperties":false,"properties":{"kind":{"const":"all","type":"string"}},"required":["kind"],"type":"object"},{"additionalProperties":false,"properties":{"kind":{"const":"any","type":"string"}},"required":["kind"],"type":"object"},{"additionalProperties":false,"properties":{"count":{"maximum":9007199254740991,"minimum":1,"type":"integer"},"kind":{"const":"quorum","type":"string"}},"required":["kind","count"],"type":"object"},{"additionalProperties":false,"properties":{"kind":{"const":"first","type":"string"},"when":{"$ref":"#/$defs/Guard"}},"required":["kind","when"],"type":"object"}]},"JsonRpcError":{"properties":{"code":{"format":"int64","type":"integer"},"data":{"anyOf":[{"$ref":"#/$defs/DomainErrorData"},{"type":"null"}]},"message":{"type":"string"}},"required":["code","message"],"type":"object"},"JsonRpcErrorResponse":{"properties":{"error":{"$ref":"#/$defs/JsonRpcError"},"id":{"anyOf":[{"$ref":"#/$defs/RequestId"},{"type":"null"}]},"jsonrpc":{"type":"string"}},"required":["jsonrpc","error"],"type":"object"},"JsonRpcNotification":{"properties":{"jsonrpc":{"type":"string"},"method":{"type":"string"},"params":{"$ref":"#/$defs/EventNotification"}},"required":["jsonrpc","method","params"],"type":"object"},"JsonRpcNotification2":{"properties":{"jsonrpc":{"type":"string"},"method":{"type":"string"},"params":{"$ref":"#/$defs/SubscriptionCancelParams"}},"required":["jsonrpc","method","params"],"type":"object"},"JsonRpcNotification3":{"properties":{"jsonrpc":{"type":"string"},"method":{"type":"string"},"params":{"$ref":"#/$defs/SubscriptionClosedNotification"}},"required":["jsonrpc","method","params"],"type":"object"},"JsonRpcNotification4":{"properties":{"jsonrpc":{"type":"string"},"method":{"type":"string"},"params":{"$ref":"#/$defs/CancelRequestParams"}},"required":["jsonrpc","method","params"],"type":"object"},"JsonRpcNotification5":{"properties":{"jsonrpc":{"type":"string"},"method":{"type":"string"},"params":{"$ref":"#/$defs/LogEventNotification"}},"required":["jsonrpc","method","params"],"type":"object"},"JsonRpcNotification6":{"properties":{"jsonrpc":{"type":"string"},"method":{"type":"string"},"params":{"$ref":"#/$defs/LogsClosedNotification"}},"required":["jsonrpc","method","params"],"type":"object"},"JsonRpcNotification7":{"properties":{"jsonrpc":{"type":"string"},"method":{"type":"string"},"params":{"$ref":"#/$defs/AgentAttachEventNotification"}},"required":["jsonrpc","method","params"],"type":"object"},"JsonRpcNotification8":{"properties":{"jsonrpc":{"type":"string"},"method":{"type":"string"},"params":{"$ref":"#/$defs/AgentAttachClosedNotification"}},"required":["jsonrpc","method","params"],"type":"object"},"JsonRpcRequest":{"properties":{"id":{"$ref":"#/$defs/RequestId"},"jsonrpc":{"type":"string"},"method":{"type":"string"},"params":{"$ref":"#/$defs/InitializeParams"}},"required":["jsonrpc","id","method","params"],"type":"object"},"JsonRpcRequest10":{"properties":{"id":{"$ref":"#/$defs/RequestId"},"jsonrpc":{"type":"string"},"method":{"type":"string"},"params":{"$ref":"#/$defs/WatchParams"}},"required":["jsonrpc","id","method","params"],"type":"object"},"JsonRpcRequest11":{"properties":{"id":{"$ref":"#/$defs/RequestId"},"jsonrpc":{"type":"string"},"method":{"type":"string"},"params":{"$ref":"#/$defs/LogsParams"}},"required":["jsonrpc","id","method","params"],"type":"object"},"JsonRpcRequest12":{"properties":{"id":{"$ref":"#/$defs/RequestId"},"jsonrpc":{"type":"string"},"method":{"type":"string"},"params":{"$ref":"#/$defs/AgentAttachParams"}},"required":["jsonrpc","id","method","params"],"type":"object"},"JsonRpcRequest2":{"properties":{"id":{"$ref":"#/$defs/RequestId"},"jsonrpc":{"type":"string"},"method":{"type":"string"},"params":{"$ref":"#/$defs/PlanParams"}},"required":["jsonrpc","id","method","params"],"type":"object"},"JsonRpcRequest3":{"properties":{"id":{"$ref":"#/$defs/RequestId"},"jsonrpc":{"type":"string"},"method":{"type":"string"},"params":{"$ref":"#/$defs/ApplyParams"}},"required":["jsonrpc","id","method","params"],"type":"object"},"JsonRpcRequest4":{"properties":{"id":{"$ref":"#/$defs/RequestId"},"jsonrpc":{"type":"string"},"method":{"type":"string"},"params":{"$ref":"#/$defs/GetParams"}},"required":["jsonrpc","id","method","params"],"type":"object"},"JsonRpcRequest5":{"properties":{"id":{"$ref":"#/$defs/RequestId"},"jsonrpc":{"type":"string"},"method":{"type":"string"},"params":{"$ref":"#/$defs/UpdateParams"}},"required":["jsonrpc","id","method","params"],"type":"object"},"JsonRpcRequest6":{"properties":{"id":{"$ref":"#/$defs/RequestId"},"jsonrpc":{"type":"string"},"method":{"type":"string"},"params":{"$ref":"#/$defs/StopParams"}},"required":["jsonrpc","id","method","params"],"type":"object"},"JsonRpcRequest7":{"properties":{"id":{"$ref":"#/$defs/RequestId"},"jsonrpc":{"type":"string"},"method":{"type":"string"},"params":{"$ref":"#/$defs/RetryParams"}},"required":["jsonrpc","id","method","params"],"type":"object"},"JsonRpcRequest8":{"properties":{"id":{"$ref":"#/$defs/RequestId"},"jsonrpc":{"type":"string"},"method":{"type":"string"},"params":{"$ref":"#/$defs/ResubmitParams"}},"required":["jsonrpc","id","method","params"],"type":"object"},"JsonRpcRequest9":{"properties":{"id":{"$ref":"#/$defs/RequestId"},"jsonrpc":{"type":"string"},"method":{"type":"string"},"params":{"$ref":"#/$defs/DeleteParams"}},"required":["jsonrpc","id","method","params"],"type":"object"},"JsonRpcResponse":{"anyOf":[{"$ref":"#/$defs/JsonRpcSuccess"},{"$ref":"#/$defs/JsonRpcErrorResponse"}]},"JsonRpcResponse10":{"anyOf":[{"$ref":"#/$defs/JsonRpcSuccess10"},{"$ref":"#/$defs/JsonRpcErrorResponse"}]},"JsonRpcResponse11":{"anyOf":[{"$ref":"#/$defs/JsonRpcSuccess11"},{"$ref":"#/$defs/JsonRpcErrorResponse"}]},"JsonRpcResponse12":{"anyOf":[{"$ref":"#/$defs/JsonRpcSuccess12"},{"$ref":"#/$defs/JsonRpcErrorResponse"}]},"JsonRpcResponse2":{"anyOf":[{"$ref":"#/$defs/JsonRpcSuccess2"},{"$ref":"#/$defs/JsonRpcErrorResponse"}]},"JsonRpcResponse3":{"anyOf":[{"$ref":"#/$defs/JsonRpcSuccess3"},{"$ref":"#/$defs/JsonRpcErrorResponse"}]},"JsonRpcResponse4":{"anyOf":[{"$ref":"#/$defs/JsonRpcSuccess4"},{"$ref":"#/$defs/JsonRpcErrorResponse"}]},"JsonRpcResponse5":{"anyOf":[{"$ref":"#/$defs/JsonRpcSuccess5"},{"$ref":"#/$defs/JsonRpcErrorResponse"}]},"JsonRpcResponse6":{"anyOf":[{"$ref":"#/$defs/JsonRpcSuccess6"},{"$ref":"#/$defs/JsonRpcErrorResponse"}]},"JsonRpcResponse7":{"anyOf":[{"$ref":"#/$defs/JsonRpcSuccess7"},{"$ref":"#/$defs/JsonRpcErrorResponse"}]},"JsonRpcResponse8":{"anyOf":[{"$ref":"#/$defs/JsonRpcSuccess8"},{"$ref":"#/$defs/JsonRpcErrorResponse"}]},"JsonRpcResponse9":{"anyOf":[{"$ref":"#/$defs/JsonRpcSuccess9"},{"$ref":"#/$defs/JsonRpcErrorResponse"}]},"JsonRpcSuccess":{"properties":{"id":{"$ref":"#/$defs/RequestId"},"jsonrpc":{"type":"string"},"result":{"$ref":"#/$defs/InitializeResult"}},"required":["jsonrpc","id","result"],"type":"object"},"JsonRpcSuccess10":{"properties":{"id":{"$ref":"#/$defs/RequestId"},"jsonrpc":{"type":"string"},"result":{"$ref":"#/$defs/WatchResult"}},"required":["jsonrpc","id","result"],"type":"object"},"JsonRpcSuccess11":{"properties":{"id":{"$ref":"#/$defs/RequestId"},"jsonrpc":{"type":"string"},"result":{"$ref":"#/$defs/LogsResult"}},"required":["jsonrpc","id","result"],"type":"object"},"JsonRpcSuccess12":{"properties":{"id":{"$ref":"#/$defs/RequestId"},"jsonrpc":{"type":"string"},"result":{"$ref":"#/$defs/AgentAttachResult"}},"required":["jsonrpc","id","result"],"type":"object"},"JsonRpcSuccess2":{"properties":{"id":{"$ref":"#/$defs/RequestId"},"jsonrpc":{"type":"string"},"result":{"$ref":"#/$defs/PlanResult"}},"required":["jsonrpc","id","result"],"type":"object"},"JsonRpcSuccess3":{"properties":{"id":{"$ref":"#/$defs/RequestId"},"jsonrpc":{"type":"string"},"result":{"$ref":"#/$defs/ApplyResult"}},"required":["jsonrpc","id","result"],"type":"object"},"JsonRpcSuccess4":{"properties":{"id":{"$ref":"#/$defs/RequestId"},"jsonrpc":{"type":"string"},"result":{"$ref":"#/$defs/GetResult"}},"required":["jsonrpc","id","result"],"type":"object"},"JsonRpcSuccess5":{"properties":{"id":{"$ref":"#/$defs/RequestId"},"jsonrpc":{"type":"string"},"result":{"$ref":"#/$defs/UpdateResult"}},"required":["jsonrpc","id","result"],"type":"object"},"JsonRpcSuccess6":{"properties":{"id":{"$ref":"#/$defs/RequestId"},"jsonrpc":{"type":"string"},"result":{"$ref":"#/$defs/StopResult"}},"required":["jsonrpc","id","result"],"type":"object"},"JsonRpcSuccess7":{"properties":{"id":{"$ref":"#/$defs/RequestId"},"jsonrpc":{"type":"string"},"result":{"$ref":"#/$defs/RetryResult"}},"required":["jsonrpc","id","result"],"type":"object"},"JsonRpcSuccess8":{"properties":{"id":{"$ref":"#/$defs/RequestId"},"jsonrpc":{"type":"string"},"result":{"$ref":"#/$defs/ResubmitResult"}},"required":["jsonrpc","id","result"],"type":"object"},"JsonRpcSuccess9":{"properties":{"id":{"$ref":"#/$defs/RequestId"},"jsonrpc":{"type":"string"},"result":{"$ref":"#/$defs/DeleteResult"}},"required":["jsonrpc","id","result"],"type":"object"},"Labels":{"additionalProperties":{"maxLength":256,"minLength":1,"pattern":"^[^\\u0000-\\u001f\\u007f-\\u009f]+$","type":"string"},"maxProperties":64,"propertyNames":{"maxLength":256,"minLength":1,"pattern":"^[^\\u0000-\\u001f\\u007f-\\u009f]+$","type":"string"},"type":"object"},"LogEventNotification":{"$ref":"#/$defs/LogEventNotificationWire"},"LogEventNotificationWire":{"additionalProperties":false,"properties":{"record":{"$ref":"#/$defs/LogRecord"},"subscriptionId":{"type":"string"}},"required":["subscriptionId","record"],"type":"object"},"LogLevel":{"enum":["trace","debug","info","warn","error"],"type":"string"},"LogRecord":{"additionalProperties":false,"description":"The closed public log record shape: a level, a bounded target, and a bounded (possibly\nredacted) message. No raw bytes, reasoning, tools, credentials, env, or provider/session IDs\nare representable.","properties":{"level":{"$ref":"#/$defs/LogLevel"},"message":{"maxLength":16384,"pattern":"^[^\\u0000-\\u001f\\u007f-\\u009f]*$","type":"string"},"target":{"maxLength":128,"minLength":1,"pattern":"^[^\\u0000-\\u001f\\u007f-\\u009f]+$","type":"string"}},"required":["level","target","message"],"type":"object"},"LogsClosedNotification":{"additionalProperties":false,"description":"Wire body of the terminal `subscription/closed` server notification for a `logs` subscription.\nDeliberately carries no cursor field -- `logs` gives a type-level \"cursorless\" guarantee, unlike\n[`crate::SubscriptionClosedNotification`].","properties":{"reason":{"$ref":"#/$defs/SubscriptionCloseReason"},"subscriptionId":{"type":"string"}},"required":["subscriptionId","reason"],"type":"object"},"LogsParams":{"additionalProperties":false,"description":"`logs` establishment parameters. v1 has zero caller filters: this is deliberately empty and\nclosed, rejecting any unknown field.","type":"object"},"LogsResult":{"additionalProperties":false,"description":"The `logs` establishment result: only a `subscriptionId`. Deliberately carries no `runId` or\n`atCursor` -- `logs` is not run-scoped and has no cursor.","properties":{"subscriptionId":{"type":"string"}},"required":["subscriptionId"],"type":"object"},"NodeAddress":{"additionalProperties":false,"properties":{"attempt":{"maximum":9007199254740991,"minimum":1,"type":"integer"},"node":{"maxLength":128,"minLength":1,"pattern":"^[A-Za-z_][A-Za-z0-9_.-]*$","type":"string"}},"required":["node","attempt"],"type":"object"},"NodeOutputChannel":{"enum":["out","signal","diagnostic"],"type":"string"},"NodeOutputSelector":{"additionalProperties":false,"properties":{"channel":{"$ref":"#/$defs/NodeOutputChannel"},"node":{"maxLength":128,"minLength":1,"pattern":"^[A-Za-z_][A-Za-z0-9_.-]*$","type":"string"},"path":{"items":{"maxLength":128,"minLength":1,"pattern":"^[A-Za-z_][A-Za-z0-9_.-]*$","type":"string"},"maxItems":64,"minItems":1,"type":"array"}},"required":["node","channel","path"],"type":"object"},"NonEmptyVec_of_ChoiceBranch":{"items":{"$ref":"#/$defs/ChoiceBranch"},"maxItems":4096,"minItems":1,"type":"array"},"NonEmptyVec_of_ControlSelector":{"items":{"$ref":"#/$defs/ControlSelector"},"maxItems":4096,"minItems":1,"type":"array"},"NonEmptyVec_of_FieldPath":{"items":{"items":{"maxLength":128,"minLength":1,"pattern":"^[A-Za-z_][A-Za-z0-9_.-]*$","type":"string"},"maxItems":64,"minItems":1,"type":"array"},"maxItems":4096,"minItems":1,"type":"array"},"NonEmptyVec_of_GraphNode":{"items":{"$ref":"#/$defs/GraphNode"},"maxItems":4096,"minItems":1,"type":"array"},"NonEmptyVec_of_Guard":{"items":{"$ref":"#/$defs/Guard"},"maxItems":4096,"minItems":1,"type":"array"},"NonEmptyVec_of_NodeName":{"items":{"maxLength":128,"minLength":1,"pattern":"^[A-Za-z_][A-Za-z0-9_.-]*$","type":"string"},"maxItems":4096,"minItems":1,"type":"array"},"OperationalStatus":{"additionalProperties":false,"properties":{"dispatchState":{"$ref":"#/$defs/DispatchState"},"inFlight":{"format":"uint32","minimum":0,"type":"integer"},"labels":{"$ref":"#/$defs/Labels"},"logLevel":{"$ref":"#/$defs/LogLevel"},"stopMode":{"anyOf":[{"$ref":"#/$defs/StopMode"},{"type":"null"}]}},"required":["labels","logLevel","dispatchState","inFlight"],"type":"object"},"PayloadType":{"oneOf":[{"additionalProperties":false,"properties":{"kind":{"const":"null","type":"string"}},"required":["kind"],"type":"object"},{"additionalProperties":false,"properties":{"kind":{"const":"boolean","type":"string"}},"required":["kind"],"type":"object"},{"additionalProperties":false,"properties":{"kind":{"const":"integer","type":"string"}},"required":["kind"],"type":"object"},{"additionalProperties":false,"properties":{"kind":{"const":"number","type":"string"}},"required":["kind"],"type":"object"},{"additionalProperties":false,"properties":{"kind":{"const":"string","type":"string"}},"required":["kind"],"type":"object"},{"additionalProperties":false,"properties":{"fields":{"additionalProperties":{"$ref":"#/$defs/RecordField"},"propertyNames":{"maxLength":128,"minLength":1,"pattern":"^[A-Za-z_][A-Za-z0-9_.-]*$","type":"string"},"type":"object"},"kind":{"const":"record","type":"string"}},"required":["kind","fields"],"type":"object"},{"additionalProperties":false,"properties":{"items":{"$ref":"#/$defs/PayloadType"},"kind":{"const":"array","type":"string"}},"required":["kind","items"],"type":"object"},{"additionalProperties":false,"properties":{"kind":{"const":"enum","type":"string"},"values":{"items":{"maxLength":128,"minLength":1,"pattern":"^[A-Za-z_][A-Za-z0-9_.-]*$","type":"string"},"maxItems":4096,"minItems":1,"type":"array","uniqueItems":true}},"required":["kind","values"],"type":"object"}]},"Phase":{"enum":["empty","admitting","running","finished","deleting"],"type":"string"},"PlanParams":{"additionalProperties":false,"properties":{"graph":{"$ref":"#/$defs/GraphSpec"}},"required":["graph"],"type":"object"},"PlanResult":{"additionalProperties":false,"properties":{"bounds":{"anyOf":[{"$ref":"#/$defs/StructuralBounds"},{"type":"null"}]},"diagnostics":{"items":{"$ref":"#/$defs/GraphDiagnostic"},"type":"array"},"ok":{"type":"boolean"}},"required":["ok","diagnostics"],"type":"object"},"PolicyBinding":{"additionalProperties":false,"properties":{"default":{"$ref":"#/$defs/PolicyDefault"},"policy":{"maxLength":256,"pattern":"^[A-Za-z_][A-Za-z0-9_.-]*@[1-9][0-9]*$","type":"string"}},"required":["policy","default"],"type":"object"},"PolicyDefault":{"enum":["deny"],"type":"string"},"RecordField":{"additionalProperties":false,"properties":{"required":{"type":"boolean"},"type":{"$ref":"#/$defs/PayloadType"}},"required":["type","required"],"type":"object"},"RedactionClass":{"enum":["public","internal","confidential","restricted"],"type":"string"},"RequestId":{"anyOf":[{"type":"string"},{"format":"int64","type":"integer"}]},"ResubmitParams":{"additionalProperties":false,"properties":{"idempotencyKey":{"maxLength":256,"minLength":1,"pattern":"^[^\\u0000-\\u001f\\u007f-\\u009f]+$","type":"string"},"ifGeneration":{"maximum":9007199254740991,"minimum":0,"type":"integer"},"ifRunId":{"type":"string"},"replacementInput":true},"required":["ifGeneration","ifRunId","idempotencyKey"],"type":"object"},"ResubmitResult":{"additionalProperties":false,"properties":{"atCursor":{"type":"string"},"deduped":{"type":"boolean"},"generation":{"maximum":9007199254740991,"minimum":0,"type":"integer"},"operational":{"$ref":"#/$defs/OperationalStatus"},"phase":{"$ref":"#/$defs/Phase"},"priorRunId":{"type":"string"},"runId":{"type":"string"}},"required":["generation","priorRunId","runId","phase","operational","atCursor","deduped"],"type":"object"},"RetryParams":{"additionalProperties":false,"properties":{"idempotencyKey":{"maxLength":256,"minLength":1,"pattern":"^[^\\u0000-\\u001f\\u007f-\\u009f]+$","type":"string"},"ifGeneration":{"maximum":9007199254740991,"minimum":0,"type":"integer"}},"required":["ifGeneration","idempotencyKey"],"type":"object"},"RetryResult":{"additionalProperties":false,"properties":{"atCursor":{"type":"string"},"deduped":{"type":"boolean"},"generation":{"maximum":9007199254740991,"minimum":0,"type":"integer"},"operational":{"$ref":"#/$defs/OperationalStatus"},"phase":{"$ref":"#/$defs/Phase"},"retriedTurnId":{"type":"string"},"retryTurnId":{"type":"string"},"runId":{"type":"string"}},"required":["generation","runId","phase","retriedTurnId","retryTurnId","operational","atCursor","deduped"],"type":"object"},"ServerCapabilities":{"additionalProperties":false,"properties":{"agentAttach":{"default":false,"type":"boolean"},"graphProfiles":{"default":[],"items":{"$ref":"#/$defs/GraphProfile"},"maxItems":2,"not":{"minItems":2,"prefixItems":[{"const":"openengine.graph.single-worker/v1"},{"const":"openengine.graph.full/v1"}]},"type":"array","uniqueItems":true},"logs":{"default":false,"type":"boolean"}},"type":"object"},"StopMode":{"enum":["drain","force"],"type":"string"},"StopParams":{"additionalProperties":false,"properties":{"idempotencyKey":{"maxLength":256,"minLength":1,"pattern":"^[^\\u0000-\\u001f\\u007f-\\u009f]+$","type":"string"},"ifGeneration":{"maximum":9007199254740991,"minimum":0,"type":"integer"},"mode":{"$ref":"#/$defs/StopMode"}},"required":["mode","ifGeneration","idempotencyKey"],"type":"object"},"StopResult":{"additionalProperties":false,"properties":{"acceptedMode":{"$ref":"#/$defs/StopMode"},"atCursor":{"type":"string"},"deduped":{"type":"boolean"},"effectiveMode":{"$ref":"#/$defs/StopMode"},"generation":{"maximum":9007199254740991,"minimum":0,"type":"integer"},"operational":{"$ref":"#/$defs/OperationalStatus"},"phase":{"$ref":"#/$defs/Phase"},"runId":{"type":"string"}},"required":["generation","runId","phase","acceptedMode","effectiveMode","operational","atCursor","deduped"],"type":"object"},"StructuralBounds":{"additionalProperties":false,"properties":{"attemptsPerNode":{"additionalProperties":{"maximum":9007199254740991,"minimum":1,"type":"integer"},"propertyNames":{"maxLength":128,"minLength":1,"pattern":"^[A-Za-z_][A-Za-z0-9_.-]*$","type":"string"},"type":"object"},"maxNodeExecutions":{"maximum":9007199254740991,"minimum":1,"type":"integer"},"peakConcurrency":{"maximum":9007199254740991,"minimum":1,"type":"integer"},"termination":{"$ref":"#/$defs/TerminationWitness"}},"required":["termination","maxNodeExecutions","peakConcurrency","attemptsPerNode"],"type":"object"},"SubscriptionCancelParams":{"additionalProperties":false,"description":"Wire body of the generic `subscription/cancel` client notification.","properties":{"subscriptionId":{"type":"string"}},"required":["subscriptionId"],"type":"object"},"SubscriptionCloseReason":{"enum":["done","SLOW_CONSUMER"],"type":"string"},"SubscriptionClosedNotification":{"additionalProperties":false,"description":"Wire body of the terminal `subscription/closed` server notification.","properties":{"lastDeliveredCursor":{"type":["string","null"]},"reason":{"$ref":"#/$defs/SubscriptionCloseReason"},"subscriptionId":{"type":"string"}},"required":["subscriptionId","reason"],"type":"object"},"TerminationWitness":{"oneOf":[{"additionalProperties":false,"properties":{"kind":{"const":"acyclic","type":"string"},"order":{"$ref":"#/$defs/NonEmptyVec_of_NodeName"}},"required":["kind","order"],"type":"object"},{"additionalProperties":false,"properties":{"kind":{"const":"bounded","type":"string"},"maxIterations":{"maximum":9007199254740991,"minimum":1,"type":"integer"},"ranking":{"$ref":"#/$defs/NonEmptyVec_of_FieldPath"}},"required":["kind","ranking","maxIterations"],"type":"object"}]},"UpdateParams":{"additionalProperties":false,"anyOf":[{"required":["labels"]},{"required":["logLevel"]},{"required":["suspended"]}],"properties":{"idempotencyKey":{"maxLength":256,"minLength":1,"pattern":"^[^\\u0000-\\u001f\\u007f-\\u009f]+$","type":"string"},"ifGeneration":{"maximum":9007199254740991,"minimum":0,"type":"integer"},"labels":{"$ref":"#/$defs/Labels"},"logLevel":{"$ref":"#/$defs/LogLevel"},"suspended":{"type":"boolean"}},"required":["ifGeneration","idempotencyKey"],"type":"object"},"UpdateResult":{"additionalProperties":false,"properties":{"atCursor":{"type":"string"},"deduped":{"type":"boolean"},"generation":{"maximum":9007199254740991,"minimum":0,"type":"integer"},"operational":{"$ref":"#/$defs/OperationalStatus"},"phase":{"$ref":"#/$defs/Phase"},"runId":{"type":"string"}},"required":["generation","runId","phase","operational","atCursor","deduped"],"type":"object"},"WatchEvent":{"description":"The closed public event algebra. `Phase` folds the observable cluster status (admission\ncommit, update, suspend/resume, stop-request); `NodeBegin`/`NodeEnd` are a testkit-only\nsynthetic hook decoupled from the real dispatch/lease turn mechanism, since no native graph\nexecutor exists yet; `Bookmark` advances the cursor without changing folded public state;\n`Fault` carries a durable, backend-neutral projected `BackendFault`: it correlates to the\nenclosing `EventNotification.run_id` plus its own optional opaque `executionRef`, and its\nordering/emission never itself authorizes a retry or changes terminal semantics -- it folds to\nno public status change, exactly like `Bookmark`; `Finished` is always the last event for a\nrun.","oneOf":[{"additionalProperties":false,"properties":{"admission":{"anyOf":[{"$ref":"#/$defs/AdmissionTransition"},{"type":"null"}]},"status":{"$ref":"#/$defs/ClusterStatus"},"type":{"const":"phase","type":"string"}},"required":["type","status"],"type":"object"},{"additionalProperties":false,"properties":{"input":true,"node":{"$ref":"#/$defs/NodeAddress"},"type":{"const":"node_begin","type":"string"}},"required":["type","node","input"],"type":"object"},{"additionalProperties":false,"properties":{"node":{"$ref":"#/$defs/NodeAddress"},"outcome":{"$ref":"#/$defs/WorkerOutcome"},"type":{"const":"node_end","type":"string"}},"required":["type","node","outcome"],"type":"object"},{"additionalProperties":false,"properties":{"type":{"const":"bookmark","type":"string"}},"required":["type"],"type":"object"},{"additionalProperties":false,"properties":{"fault":{"$ref":"#/$defs/BackendFault"},"type":{"const":"fault","type":"string"}},"required":["type","fault"],"type":"object"},{"additionalProperties":false,"properties":{"final_status":{"$ref":"#/$defs/ClusterStatus"},"stop_mode":{"anyOf":[{"$ref":"#/$defs/StopMode"},{"type":"null"}]},"type":{"const":"finished","type":"string"}},"required":["type","final_status"],"type":"object"}]},"WatchParams":{"additionalProperties":false,"properties":{"fromCursor":{"default":null,"type":["string","null"]},"runId":{"default":null,"type":["string","null"]}},"type":"object"},"WatchResult":{"properties":{"atCursor":{"type":["string","null"]},"runId":{"type":["string","null"]},"subscriptionId":{"type":"string"}},"required":["subscriptionId"],"type":"object"},"WorkerErrorCode":{"enum":["timeout","crash","malformed","refusal"],"type":"string"},"WorkerFailureReason":{"enum":["declared_failure","policy_denied","interactive_input_required","authentication_required","malformed_result"],"type":"string"},"WorkerOutcome":{"allOf":[{"$ref":"#/$defs/WorkerOutcomeWire"},{"if":{"properties":{"status":{"const":"error"}},"required":["status"]},"then":{"oneOf":[{"properties":{"reason":{"const":"declared_failure"}},"required":["reason"]},{"properties":{"code":{"const":"refusal"},"reason":{"enum":["policy_denied","interactive_input_required","authentication_required"]}},"required":["code","reason"]},{"properties":{"code":{"const":"malformed"},"reason":{"const":"malformed_result"}},"required":["code","reason"]}]}}]},"WorkerOutcomeWire":{"oneOf":[{"additionalProperties":false,"properties":{"artifacts":{"items":{"$ref":"#/$defs/ArtifactRef"},"type":"array"},"output":true,"status":{"const":"verified","type":"string"}},"required":["status","output","artifacts"],"type":"object"},{"additionalProperties":false,"properties":{"artifacts":{"items":{"$ref":"#/$defs/ArtifactRef"},"type":"array"},"diagnostic":true,"output":true,"signals":{"additionalProperties":{"maxLength":128,"minLength":1,"pattern":"^[A-Za-z_][A-Za-z0-9_.-]*$","type":"string"},"propertyNames":{"maxLength":128,"minLength":1,"pattern":"^[A-Za-z_][A-Za-z0-9_.-]*$","type":"string"},"type":"object"},"status":{"const":"verifier","type":"string"}},"required":["status","output","signals","diagnostic","artifacts"],"type":"object"},{"additionalProperties":false,"properties":{"code":{"$ref":"#/$defs/WorkerErrorCode"},"reason":{"$ref":"#/$defs/WorkerFailureReason"},"status":{"const":"error","type":"string"}},"required":["status","code","reason"],"type":"object"}]},"WriteBinding":{"additionalProperties":false,"properties":{"target":{"items":{"maxLength":128,"minLength":1,"pattern":"^[A-Za-z_][A-Za-z0-9_.-]*$","type":"string"},"maxItems":64,"minItems":1,"type":"array"},"value":{"$ref":"#/$defs/NodeOutputSelector"}},"required":["value","target"],"type":"object"}},"$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"agent_attach_closed_notification":{"$ref":"#/$defs/JsonRpcNotification8"},"agent_attach_event_notification":{"$ref":"#/$defs/JsonRpcNotification7"},"agent_attach_request":{"$ref":"#/$defs/JsonRpcRequest12"},"agent_attach_response":{"$ref":"#/$defs/JsonRpcResponse12"},"apply_request":{"$ref":"#/$defs/JsonRpcRequest3"},"apply_response":{"$ref":"#/$defs/JsonRpcResponse3"},"cancel_request_notification":{"$ref":"#/$defs/JsonRpcNotification4"},"delete_request":{"$ref":"#/$defs/JsonRpcRequest9"},"delete_response":{"$ref":"#/$defs/JsonRpcResponse9"},"event_notification":{"$ref":"#/$defs/JsonRpcNotification"},"get_request":{"$ref":"#/$defs/JsonRpcRequest4"},"get_response":{"$ref":"#/$defs/JsonRpcResponse4"},"initialize_request":{"$ref":"#/$defs/JsonRpcRequest"},"initialize_response":{"$ref":"#/$defs/JsonRpcResponse"},"log_event_notification":{"$ref":"#/$defs/JsonRpcNotification5"},"logs_closed_notification":{"$ref":"#/$defs/JsonRpcNotification6"},"logs_request":{"$ref":"#/$defs/JsonRpcRequest11"},"logs_response":{"$ref":"#/$defs/JsonRpcResponse11"},"plan_request":{"$ref":"#/$defs/JsonRpcRequest2"},"plan_response":{"$ref":"#/$defs/JsonRpcResponse2"},"resubmit_request":{"$ref":"#/$defs/JsonRpcRequest8"},"resubmit_response":{"$ref":"#/$defs/JsonRpcResponse8"},"retry_request":{"$ref":"#/$defs/JsonRpcRequest7"},"retry_response":{"$ref":"#/$defs/JsonRpcResponse7"},"stop_request":{"$ref":"#/$defs/JsonRpcRequest6"},"stop_response":{"$ref":"#/$defs/JsonRpcResponse6"},"subscription_cancel_notification":{"$ref":"#/$defs/JsonRpcNotification2"},"subscription_closed_notification":{"$ref":"#/$defs/JsonRpcNotification3"},"update_request":{"$ref":"#/$defs/JsonRpcRequest5"},"update_response":{"$ref":"#/$defs/JsonRpcResponse5"},"watch_request":{"$ref":"#/$defs/JsonRpcRequest10"},"watch_response":{"$ref":"#/$defs/JsonRpcResponse10"}},"required":["initialize_request","initialize_response","plan_request","plan_response","apply_request","apply_response","get_request","get_response","update_request","update_response","stop_request","stop_response","retry_request","retry_response","resubmit_request","resubmit_response","delete_request","delete_response","watch_request","watch_response","event_notification","subscription_cancel_notification","subscription_closed_notification","cancel_request_notification","logs_request","logs_response","log_event_notification","logs_closed_notification","agent_attach_request","agent_attach_response","agent_attach_event_notification","agent_attach_closed_notification"],"title":"ImplementedProtocolSchema","type":"object"};

package/src/cluster/generated/protocol.ts

@@ -0,0 +1,183 @@
+// Generated by scripts/generate-cluster-types.js from the checked-in Cluster Protocol v1 artifacts.
+// Do not edit this file by hand. Run npm run protocol:generate.
+
+export const JSON_RPC_VERSION = "2.0" as const;
+export const PROTOCOL_VERSION = "openengine.cluster/v1" as const;
+export const SUBSCRIPTION_QUEUE_CAPACITY = 1024 as const;
+export const MAX_FRAME_BYTES = 1048576 as const;
+export const CLUSTER_METHODS = ["initialize","plan","apply","update","stop","retry","resubmit","delete","get","watch","logs","agent/attach"] as const;
+export type ClusterMethod = (typeof CLUSTER_METHODS)[number];
+
+export const UNARY_METHODS = ["initialize","plan","apply","update","stop","retry","resubmit","delete","get"] as const;
+export type UnaryClusterMethod = (typeof UNARY_METHODS)[number];
+export const SUBSCRIPTION_METHODS = ["watch","logs","agent/attach"] as const;
+export type SubscriptionMethod = (typeof SUBSCRIPTION_METHODS)[number];
+export const METHOD_RESULT_DEFINITIONS = {"initialize":"InitializeResult","plan":"PlanResult","apply":"ApplyResult","update":"UpdateResult","stop":"StopResult","retry":"RetryResult","resubmit":"ResubmitResult","delete":"DeleteResult","get":"GetResult","watch":"WatchResult","logs":"LogsResult","agent/attach":"AgentAttachResult"} as const;
+
+export const JSON_RPC_ERROR_CODES = {
+  PARSE_ERROR: -32700,
+  INVALID_REQUEST: -32600,
+  METHOD_NOT_FOUND: -32601,
+  INVALID_PARAMS: -32602,
+  INTERNAL_ERROR: -32603,
+  APPLICATION_ERROR: -32000,
+} as const;
+
+export const DOMAIN_ERROR_CODES = ["NOT_FOUND","GONE","SLOW_CONSUMER","UNSUPPORTED_PROTOCOL_VERSION","INTERNAL_ERROR"] as const;
+
+export type AdmissionTransition = { readonly "runId": string; readonly "seedInput": unknown; readonly "spec": GraphSpec; };
+export type AgentAttachClosedNotification = { readonly "reason": SubscriptionCloseReason; readonly "subscriptionId": string; };
+export type AgentAttachEvent = { readonly "type": "working"; } | { readonly "text": string; readonly "type": "output"; } | { readonly "type": "settled"; };
+export type AgentAttachEventNotification = AgentAttachEventNotificationWire;
+export type AgentAttachEventNotificationWire = { readonly "event": AgentAttachEvent; readonly "subscriptionId": string; };
+export type AgentAttachParams = { readonly "execution": string; };
+export type AgentAttachResult = { readonly "subscriptionId": string; };
+export type ApplyParams = { readonly "dryRun"?: boolean; readonly "graph": GraphSpec; readonly "idempotencyKey"?: string; readonly "ifGeneration"?: number; readonly "input"?: unknown; };
+export type ApplyResult = { readonly "deduped": boolean; readonly "diff"?: GraphDiff | null; readonly "generation"?: number | null; readonly "phase": Phase; readonly "runId"?: string | null; };
+export type ArtifactLineage = { readonly "attempt": number; readonly "generation": number; readonly "runId": string; };
+export type ArtifactProducer = { readonly "node": string; readonly "worker": string; };
+export type ArtifactRef = { readonly "artifactId": string; readonly "byteLength": number; readonly "lineage": ArtifactLineage; readonly "mediaType": string; readonly "producer": ArtifactProducer; readonly "redaction": RedactionClass; readonly "sha256": string; readonly "typeId": string; };
+export type BackendFault = BackendFaultWire;
+export type BackendFaultWire = { readonly "action": FaultAction; readonly "code": FaultCode; readonly "consequence": FaultConsequence; readonly "eventId": string; readonly "executionRef"?: string | null; readonly "retry": FaultRetryDisposition; readonly "severity": FaultSeverity; readonly "source": ReadonlyArray<FaultSourceFrame>; readonly "summary": string; };
+export type CancelRequestParams = { readonly "id": RequestId; };
+export type ChoiceBranch = { readonly "node": GraphNode; readonly "when": Guard; };
+export type ClusterStatus = { readonly "atCursor"?: string | null; readonly "currentRunId"?: string | null; readonly "observedGeneration"?: number | null; readonly "operational"?: OperationalStatus | null; readonly "phase": Phase; };
+export type ControlSelector = { readonly "field"?: string | null; readonly "name": string; readonly "source": ControlSource; };
+export type ControlSource = "signal" | "error" | "group";
+export type DataSelector = { readonly "path": ReadonlyArray<string>; readonly "source": "state"; } | { readonly "path": ReadonlyArray<string>; readonly "source": "item"; };
+export type DeleteParams = { readonly "idempotencyKey": string; readonly "ifGeneration": number; readonly "ifRunId"?: string | null; };
+export type DeleteResult = { readonly "atCursor"?: string | null; readonly "deduped": boolean; readonly "deleted": boolean; readonly "generation"?: number | null; readonly "phase": Phase; readonly "runId"?: string | null; };
+export type DiagnosticPathSegment = { readonly "kind": "field"; readonly "name": string; } | { readonly "index": number; readonly "kind": "index"; } | { readonly "kind": "node"; readonly "name": string; };
+export type DiagnosticSeverity = "error" | "warning" | "info";
+export type DispatchState = "active" | "suspended" | "draining" | "force_stopping" | "stopped";
+export type DomainErrorData = { readonly "code": string; readonly "details"?: unknown; };
+export type EventNotification = { readonly "cursor": string; readonly "event": WatchEvent; readonly "runId": string; readonly "subscriptionId": string; };
+export type FaultAction = "none" | "retry" | "wait" | "escalate" | "abort";
+export type FaultCode = "unavailable" | "resource_exhausted" | "deadline_exceeded" | "permission_denied" | "failed_precondition" | "not_found" | "aborted" | "internal" | "unknown";
+export type FaultConsequence = "turn_failed" | "run_failed" | "run_degraded" | "no_observable_effect";
+export type FaultRetryDisposition = "retryable" | "retryable_after_backoff" | "not_retryable" | "indeterminate";
+export type FaultSeverity = "info" | "warning" | "error" | "critical";
+export type FaultSourceFrame = { readonly "component": string; };
+export type GetParams = { readonly "atCursor"?: string | null; };
+export type GetResult = { readonly "atCursor"?: string | null; readonly "spec"?: GraphSpec | null; readonly "status": ClusterStatus; };
+export type GraphDiagnostic = { readonly "code": GraphDiagnosticCode; readonly "message": string; readonly "path": ReadonlyArray<DiagnosticPathSegment>; readonly "relatedNodes": ReadonlyArray<string>; readonly "severity": DiagnosticSeverity; };
+export type GraphDiagnosticCode = "schema_safety" | "reachability" | "choice_exhaustiveness" | "loop_exit_satisfiability" | "missing_bound" | "write_conflict" | "ceiling_exceeded" | "cyclic_reference" | "undefined_read" | "invalid_graph_shape";
+export type GraphDiff = { readonly "added": ReadonlyArray<string>; readonly "changed": ReadonlyArray<string>; readonly "removed": ReadonlyArray<string>; };
+export type GraphNode = { readonly "attempts": number; readonly "input": PayloadType; readonly "inputBindings": ReadonlyArray<InputBinding>; readonly "kind": "step"; readonly "name": string; readonly "output": PayloadType; readonly "timeoutMs": number; readonly "worker": string; readonly "writeBindings": ReadonlyArray<WriteBinding>; } | { readonly "attempts": number; readonly "diagnostic": PayloadType; readonly "input": PayloadType; readonly "inputBindings": ReadonlyArray<InputBinding>; readonly "kind": "verifier"; readonly "name": string; readonly "output": PayloadType; readonly "signals": { readonly [key: string]: ReadonlyArray<string> }; readonly "timeoutMs": number; readonly "worker": string; readonly "writeBindings": ReadonlyArray<WriteBinding>; } | { readonly "children": NonEmptyVec_of_GraphNode; readonly "kind": "seq"; readonly "name": string; readonly "promotedStatePaths": ReadonlyArray<ReadonlyArray<string>>; readonly "state": PayloadType; } | ({ readonly "branches": NonEmptyVec_of_ChoiceBranch; readonly "kind": "choice"; readonly "name": string; readonly "otherwise"?: GraphNode | null; readonly "promotedStatePaths": ReadonlyArray<ReadonlyArray<string>>; readonly "state": PayloadType; }) | { readonly "branches": NonEmptyVec_of_GraphNode; readonly "join": Join; readonly "kind": "par"; readonly "name": string; readonly "promotedStatePaths": ReadonlyArray<ReadonlyArray<string>>; readonly "state": PayloadType; } | { readonly "body": GraphNode; readonly "kind": "loop"; readonly "maxIterations": number; readonly "name": string; readonly "promotedStatePaths": ReadonlyArray<ReadonlyArray<string>>; readonly "state": PayloadType; readonly "until": Guard; } | { readonly "body": GraphNode; readonly "kind": "map"; readonly "maxItems": number; readonly "name": string; readonly "over": DataSelector; readonly "promotedStatePaths": ReadonlyArray<ReadonlyArray<string>>; readonly "state": PayloadType; } | { readonly "bindings": ReadonlyArray<InputBinding>; readonly "kind": "succeed"; readonly "name": string; readonly "output": PayloadType; } | { readonly "kind": "fail"; readonly "name": string; readonly "reason": string; };
+export type GraphProfile = "openengine.graph.full/v1" | "openengine.graph.single-worker/v1";
+export type GraphSpec = { readonly "initialInput": PayloadType; readonly "policy": PolicyBinding; readonly "profile": GraphProfile; readonly "root": GraphNode; };
+export type Guard = { readonly "kind": "in"; readonly "labels": ReadonlyArray<string>; readonly "value": ControlSelector; } | { readonly "guards": NonEmptyVec_of_Guard; readonly "kind": "all"; } | { readonly "guards": NonEmptyVec_of_Guard; readonly "kind": "any"; } | { readonly "guard": Guard; readonly "kind": "not"; } | { readonly "count": number; readonly "kind": "k_of_n"; readonly "labels": ReadonlyArray<string>; readonly "values": NonEmptyVec_of_ControlSelector; } | { readonly "count": number; readonly "kind": "k_of_map"; readonly "labels": ReadonlyArray<string>; readonly "value": ControlSelector; };
+export type InitializeParams = { readonly "protocolVersion": "openengine.cluster/v1"; };
+export type InitializeResult = { readonly "capabilities": ServerCapabilities; readonly "protocolVersion": "openengine.cluster/v1"; readonly "status": ClusterStatus; };
+export type InputBinding = { readonly "target": ReadonlyArray<string>; readonly "value": DataSelector; };
+export type Join = { readonly "kind": "all"; } | { readonly "kind": "any"; } | { readonly "count": number; readonly "kind": "quorum"; } | { readonly "kind": "first"; readonly "when": Guard; };
+export type JsonRpcError = { readonly "code": number; readonly "data"?: DomainErrorData | null; readonly "message": string; };
+export type JsonRpcErrorResponse = { readonly "error": JsonRpcError; readonly "id"?: RequestId | null; readonly "jsonrpc": string; };
+export type JsonRpcNotification = { readonly "jsonrpc": string; readonly "method": string; readonly "params": EventNotification; };
+export type JsonRpcNotification2 = { readonly "jsonrpc": string; readonly "method": string; readonly "params": SubscriptionCancelParams; };
+export type JsonRpcNotification3 = { readonly "jsonrpc": string; readonly "method": string; readonly "params": SubscriptionClosedNotification; };
+export type JsonRpcNotification4 = { readonly "jsonrpc": string; readonly "method": string; readonly "params": CancelRequestParams; };
+export type JsonRpcNotification5 = { readonly "jsonrpc": string; readonly "method": string; readonly "params": LogEventNotification; };
+export type JsonRpcNotification6 = { readonly "jsonrpc": string; readonly "method": string; readonly "params": LogsClosedNotification; };
+export type JsonRpcNotification7 = { readonly "jsonrpc": string; readonly "method": string; readonly "params": AgentAttachEventNotification; };
+export type JsonRpcNotification8 = { readonly "jsonrpc": string; readonly "method": string; readonly "params": AgentAttachClosedNotification; };
+export type JsonRpcRequest = { readonly "id": RequestId; readonly "jsonrpc": string; readonly "method": string; readonly "params": InitializeParams; };
+export type JsonRpcRequest10 = { readonly "id": RequestId; readonly "jsonrpc": string; readonly "method": string; readonly "params": WatchParams; };
+export type JsonRpcRequest11 = { readonly "id": RequestId; readonly "jsonrpc": string; readonly "method": string; readonly "params": LogsParams; };
+export type JsonRpcRequest12 = { readonly "id": RequestId; readonly "jsonrpc": string; readonly "method": string; readonly "params": AgentAttachParams; };
+export type JsonRpcRequest2 = { readonly "id": RequestId; readonly "jsonrpc": string; readonly "method": string; readonly "params": PlanParams; };
+export type JsonRpcRequest3 = { readonly "id": RequestId; readonly "jsonrpc": string; readonly "method": string; readonly "params": ApplyParams; };
+export type JsonRpcRequest4 = { readonly "id": RequestId; readonly "jsonrpc": string; readonly "method": string; readonly "params": GetParams; };
+export type JsonRpcRequest5 = { readonly "id": RequestId; readonly "jsonrpc": string; readonly "method": string; readonly "params": UpdateParams; };
+export type JsonRpcRequest6 = { readonly "id": RequestId; readonly "jsonrpc": string; readonly "method": string; readonly "params": StopParams; };
+export type JsonRpcRequest7 = { readonly "id": RequestId; readonly "jsonrpc": string; readonly "method": string; readonly "params": RetryParams; };
+export type JsonRpcRequest8 = { readonly "id": RequestId; readonly "jsonrpc": string; readonly "method": string; readonly "params": ResubmitParams; };
+export type JsonRpcRequest9 = { readonly "id": RequestId; readonly "jsonrpc": string; readonly "method": string; readonly "params": DeleteParams; };
+export type JsonRpcResponse = JsonRpcSuccess | JsonRpcErrorResponse;
+export type JsonRpcResponse10 = JsonRpcSuccess10 | JsonRpcErrorResponse;
+export type JsonRpcResponse11 = JsonRpcSuccess11 | JsonRpcErrorResponse;
+export type JsonRpcResponse12 = JsonRpcSuccess12 | JsonRpcErrorResponse;
+export type JsonRpcResponse2 = JsonRpcSuccess2 | JsonRpcErrorResponse;
+export type JsonRpcResponse3 = JsonRpcSuccess3 | JsonRpcErrorResponse;
+export type JsonRpcResponse4 = JsonRpcSuccess4 | JsonRpcErrorResponse;
+export type JsonRpcResponse5 = JsonRpcSuccess5 | JsonRpcErrorResponse;
+export type JsonRpcResponse6 = JsonRpcSuccess6 | JsonRpcErrorResponse;
+export type JsonRpcResponse7 = JsonRpcSuccess7 | JsonRpcErrorResponse;
+export type JsonRpcResponse8 = JsonRpcSuccess8 | JsonRpcErrorResponse;
+export type JsonRpcResponse9 = JsonRpcSuccess9 | JsonRpcErrorResponse;
+export type JsonRpcSuccess = { readonly "id": RequestId; readonly "jsonrpc": string; readonly "result": InitializeResult; };
+export type JsonRpcSuccess10 = { readonly "id": RequestId; readonly "jsonrpc": string; readonly "result": WatchResult; };
+export type JsonRpcSuccess11 = { readonly "id": RequestId; readonly "jsonrpc": string; readonly "result": LogsResult; };
+export type JsonRpcSuccess12 = { readonly "id": RequestId; readonly "jsonrpc": string; readonly "result": AgentAttachResult; };
+export type JsonRpcSuccess2 = { readonly "id": RequestId; readonly "jsonrpc": string; readonly "result": PlanResult; };
+export type JsonRpcSuccess3 = { readonly "id": RequestId; readonly "jsonrpc": string; readonly "result": ApplyResult; };
+export type JsonRpcSuccess4 = { readonly "id": RequestId; readonly "jsonrpc": string; readonly "result": GetResult; };
+export type JsonRpcSuccess5 = { readonly "id": RequestId; readonly "jsonrpc": string; readonly "result": UpdateResult; };
+export type JsonRpcSuccess6 = { readonly "id": RequestId; readonly "jsonrpc": string; readonly "result": StopResult; };
+export type JsonRpcSuccess7 = { readonly "id": RequestId; readonly "jsonrpc": string; readonly "result": RetryResult; };
+export type JsonRpcSuccess8 = { readonly "id": RequestId; readonly "jsonrpc": string; readonly "result": ResubmitResult; };
+export type JsonRpcSuccess9 = { readonly "id": RequestId; readonly "jsonrpc": string; readonly "result": DeleteResult; };
+export type Labels = { readonly [key: string]: string };
+export type LogEventNotification = LogEventNotificationWire;
+export type LogEventNotificationWire = { readonly "record": LogRecord; readonly "subscriptionId": string; };
+export type LogLevel = "trace" | "debug" | "info" | "warn" | "error";
+export type LogRecord = { readonly "level": LogLevel; readonly "message": string; readonly "target": string; };
+export type LogsClosedNotification = { readonly "reason": SubscriptionCloseReason; readonly "subscriptionId": string; };
+export type LogsParams = Record<string, never>;
+export type LogsResult = { readonly "subscriptionId": string; };
+export type NodeAddress = { readonly "attempt": number; readonly "node": string; };
+export type NodeOutputChannel = "out" | "signal" | "diagnostic";
+export type NodeOutputSelector = { readonly "channel": NodeOutputChannel; readonly "node": string; readonly "path": ReadonlyArray<string>; };
+export type NonEmptyVec_of_ChoiceBranch = ReadonlyArray<ChoiceBranch>;
+export type NonEmptyVec_of_ControlSelector = ReadonlyArray<ControlSelector>;
+export type NonEmptyVec_of_FieldPath = ReadonlyArray<ReadonlyArray<string>>;
+export type NonEmptyVec_of_GraphNode = ReadonlyArray<GraphNode>;
+export type NonEmptyVec_of_Guard = ReadonlyArray<Guard>;
+export type NonEmptyVec_of_NodeName = ReadonlyArray<string>;
+export type OperationalStatus = { readonly "dispatchState": DispatchState; readonly "inFlight": number; readonly "labels": Labels; readonly "logLevel": LogLevel; readonly "stopMode"?: StopMode | null; };
+export type PayloadType = { readonly "kind": "null"; } | { readonly "kind": "boolean"; } | { readonly "kind": "integer"; } | { readonly "kind": "number"; } | { readonly "kind": "string"; } | { readonly "fields": { readonly [key: string]: RecordField }; readonly "kind": "record"; } | { readonly "items": PayloadType; readonly "kind": "array"; } | { readonly "kind": "enum"; readonly "values": ReadonlyArray<string>; };
+export type Phase = "empty" | "admitting" | "running" | "finished" | "deleting";
+export type PlanParams = { readonly "graph": GraphSpec; };
+export type PlanResult = { readonly "bounds"?: StructuralBounds | null; readonly "diagnostics": ReadonlyArray<GraphDiagnostic>; readonly "ok": boolean; };
+export type PolicyBinding = { readonly "default": PolicyDefault; readonly "policy": string; };
+export type PolicyDefault = "deny";
+export type RecordField = { readonly "required": boolean; readonly "type": PayloadType; };
+export type RedactionClass = "public" | "internal" | "confidential" | "restricted";
+export type RequestId = string | number;
+export type ResubmitParams = { readonly "idempotencyKey": string; readonly "ifGeneration": number; readonly "ifRunId": string; readonly "replacementInput"?: unknown; };
+export type ResubmitResult = { readonly "atCursor": string; readonly "deduped": boolean; readonly "generation": number; readonly "operational": OperationalStatus; readonly "phase": Phase; readonly "priorRunId": string; readonly "runId": string; };
+export type RetryParams = { readonly "idempotencyKey": string; readonly "ifGeneration": number; };
+export type RetryResult = { readonly "atCursor": string; readonly "deduped": boolean; readonly "generation": number; readonly "operational": OperationalStatus; readonly "phase": Phase; readonly "retriedTurnId": string; readonly "retryTurnId": string; readonly "runId": string; };
+export type ServerCapabilities = { readonly "agentAttach"?: boolean; readonly "graphProfiles"?: ReadonlyArray<GraphProfile>; readonly "logs"?: boolean; };
+export type StopMode = "drain" | "force";
+export type StopParams = { readonly "idempotencyKey": string; readonly "ifGeneration": number; readonly "mode": StopMode; };
+export type StopResult = { readonly "acceptedMode": StopMode; readonly "atCursor": string; readonly "deduped": boolean; readonly "effectiveMode": StopMode; readonly "generation": number; readonly "operational": OperationalStatus; readonly "phase": Phase; readonly "runId": string; };
+export type StructuralBounds = { readonly "attemptsPerNode": { readonly [key: string]: number }; readonly "maxNodeExecutions": number; readonly "peakConcurrency": number; readonly "termination": TerminationWitness; };
+export type SubscriptionCancelParams = { readonly "subscriptionId": string; };
+export type SubscriptionCloseReason = "done" | "SLOW_CONSUMER";
+export type SubscriptionClosedNotification = { readonly "lastDeliveredCursor"?: string | null; readonly "reason": SubscriptionCloseReason; readonly "subscriptionId": string; };
+export type TerminationWitness = { readonly "kind": "acyclic"; readonly "order": NonEmptyVec_of_NodeName; } | { readonly "kind": "bounded"; readonly "maxIterations": number; readonly "ranking": NonEmptyVec_of_FieldPath; };
+export type UpdateParams = ({ readonly "idempotencyKey": string; readonly "ifGeneration": number; readonly "labels"?: Labels; readonly "logLevel"?: LogLevel; readonly "suspended"?: boolean; }) & ({ readonly "labels": unknown; } | { readonly "logLevel": unknown; } | { readonly "suspended": unknown; });
+export type UpdateResult = { readonly "atCursor": string; readonly "deduped": boolean; readonly "generation": number; readonly "operational": OperationalStatus; readonly "phase": Phase; readonly "runId": string; };
+export type WatchEvent = ({ readonly "admission"?: AdmissionTransition | null; readonly "status": ClusterStatus; readonly "type": "phase"; }) | { readonly "input": unknown; readonly "node": NodeAddress; readonly "type": "node_begin"; } | { readonly "node": NodeAddress; readonly "outcome": WorkerOutcome; readonly "type": "node_end"; } | { readonly "type": "bookmark"; } | { readonly "fault": BackendFault; readonly "type": "fault"; } | ({ readonly "final_status": ClusterStatus; readonly "stop_mode"?: StopMode | null; readonly "type": "finished"; });
+export type WatchParams = { readonly "fromCursor"?: string | null; readonly "runId"?: string | null; };
+export type WatchResult = { readonly "atCursor"?: string | null; readonly "runId"?: string | null; readonly "subscriptionId": string; };
+export type WorkerErrorCode = "timeout" | "crash" | "malformed" | "refusal";
+export type WorkerFailureReason = "declared_failure" | "policy_denied" | "interactive_input_required" | "authentication_required" | "malformed_result";
+export type WorkerOutcome = WorkerOutcomeWire & unknown;
+export type WorkerOutcomeWire = { readonly "artifacts": ReadonlyArray<ArtifactRef>; readonly "output": unknown; readonly "status": "verified"; } | { readonly "artifacts": ReadonlyArray<ArtifactRef>; readonly "diagnostic": unknown; readonly "output": unknown; readonly "signals": { readonly [key: string]: string }; readonly "status": "verifier"; } | { readonly "code": WorkerErrorCode; readonly "reason": WorkerFailureReason; readonly "status": "error"; };
+export type WriteBinding = { readonly "target": ReadonlyArray<string>; readonly "value": NodeOutputSelector; };
+
+export interface ClusterMethodParams {
+  readonly initialize: InitializeParams; readonly plan: PlanParams; readonly apply: ApplyParams;
+  readonly update: UpdateParams; readonly stop: StopParams; readonly retry: RetryParams;
+  readonly resubmit: ResubmitParams; readonly delete: DeleteParams; readonly get: GetParams;
+  readonly watch: WatchParams; readonly logs: LogsParams; readonly 'agent/attach': AgentAttachParams;
+}
+
+export interface ClusterMethodResults {
+  readonly initialize: InitializeResult; readonly plan: PlanResult; readonly apply: ApplyResult;
+  readonly update: UpdateResult; readonly stop: StopResult; readonly retry: RetryResult;
+  readonly resubmit: ResubmitResult; readonly delete: DeleteResult; readonly get: GetResult;
+  readonly watch: WatchResult; readonly logs: LogsResult; readonly 'agent/attach': AgentAttachResult;
+}

package/src/cluster/index.ts

@@ -0,0 +1,38 @@
+export * from './generated/protocol.js';
+export { SUBSCRIPTION_QUEUE_MAX_BYTES } from './queue.js';
+export {
+  ClusterConfigError,
+  ClusterError,
+  ClusterInternalError,
+  ClusterProtocolError,
+  ClusterRpcError,
+  ClusterStateError,
+  ClusterTimeoutError,
+  ClusterTransportError,
+} from './errors.js';
+export { CONNECTION_TRANSITIONS, PROTOCOL_DIAGNOSTIC_CAPACITY, Connection } from './connection.js';
+export type {
+  CallOptions,
+  ConnectionState,
+} from './connection.js';
+export type { WebSocketLike } from './socket.js';
+export {
+  AgentAttachSubscriptionStream,
+  LogsSubscriptionStream,
+  WatchSubscriptionStream,
+} from './subscriptions.js';
+export type {
+  Subscription,
+  SubscriptionClosedItem,
+  SubscriptionItem,
+  WatchSubscriptionItem,
+  WatchSubscriptionClosedItem,
+} from './subscriptions.js';
+export { ClusterClient, connect } from './client.js';
+export type {
+  AgentAttachSubscription,
+  CoherentWatchSubscription,
+  ConnectOptions,
+  LogsSubscription,
+  WatchSubscription,
+} from './client.js';

package/src/cluster/queue.ts

@@ -0,0 +1,84 @@
+import { SUBSCRIPTION_QUEUE_CAPACITY } from './generated/protocol.js';
+import { ClusterInternalError } from './errors.js';
+
+export const SUBSCRIPTION_QUEUE_MAX_BYTES = 8 * 1024 * 1024;
+
+type Deferred<T> = {
+  readonly promise: Promise<T>;
+  readonly resolve: (value: T) => void;
+};
+
+function deferred<T>(): Deferred<T> {
+  let resolve!: (value: T) => void;
+  const promise = new Promise<T>((onResolve) => { resolve = onResolve; });
+  return { promise, resolve };
+}
+
+export type QueueValue<T> =
+  | { readonly done: false; readonly value: T }
+  | { readonly done: true };
+
+export class BoundedQueue<T> {
+  readonly #items: Array<{ readonly value: T; readonly bytes: number }> = [];
+  readonly #waiters: Array<Deferred<QueueValue<T>>> = [];
+  #bytes = 0;
+  #producerClosed = false;
+
+  get retainedCount(): number { return this.#items.length; }
+
+  push(value: T, bytes: number): 'buffered' | 'delivered' | 'overflow' | 'closed' {
+    if (this.#producerClosed) return 'closed';
+    const waiter = this.#waiters.shift();
+    if (waiter) {
+      waiter.resolve({ done: false, value });
+      this.#assertInvariant();
+      return 'delivered';
+    }
+    if (
+      this.#items.length >= SUBSCRIPTION_QUEUE_CAPACITY ||
+      this.#bytes + bytes > SUBSCRIPTION_QUEUE_MAX_BYTES
+    ) return 'overflow';
+    this.#items.push({ value, bytes });
+    this.#bytes += bytes;
+    this.#assertInvariant();
+    return 'buffered';
+  }
+
+  recv(): Promise<QueueValue<T>> {
+    const item = this.#items.shift();
+    if (item) {
+      this.#bytes -= item.bytes;
+      this.#assertInvariant();
+      return Promise.resolve({ done: false, value: item.value });
+    }
+    if (this.#producerClosed) return Promise.resolve({ done: true });
+    const waiter = deferred<QueueValue<T>>();
+    this.#waiters.push(waiter);
+    this.#assertInvariant();
+    return waiter.promise;
+  }
+
+  endRetainingBuffer(): void {
+    if (this.#producerClosed) return;
+    this.#producerClosed = true;
+    while (this.#waiters.length > 0) this.#waiters.shift()!.resolve({ done: true });
+    this.#assertInvariant();
+  }
+
+  closeAndDiscard(): void {
+    this.#producerClosed = true;
+    this.#items.length = 0;
+    this.#bytes = 0;
+    while (this.#waiters.length > 0) this.#waiters.shift()!.resolve({ done: true });
+    this.#assertInvariant();
+  }
+
+  #assertInvariant(): void {
+    if (this.#items.length > 0 && this.#waiters.length > 0) {
+      throw new ClusterInternalError(
+        'queue contains both buffered items and waiters',
+        'QUEUE_INVARIANT',
+      );
+    }
+  }
+}

package/src/cluster/socket.ts

@@ -0,0 +1,31 @@
+import { ClusterConfigError } from './errors.js';
+
+export interface WebSocketLike {
+  readonly readyState: number;
+  send(data: string, callback?: (error?: Error) => void): void | Promise<void>;
+  close(code?: number, reason?: string): void | Promise<void>;
+  addEventListener?(type: string, listener: (...args: unknown[]) => void): void;
+  removeEventListener?(type: string, listener: (...args: unknown[]) => void): void;
+  on?(type: string, listener: (...args: unknown[]) => void): void;
+  off?(type: string, listener: (...args: unknown[]) => void): void;
+  removeListener?(type: string, listener: (...args: unknown[]) => void): void;
+}
+
+export function addSocketListener(
+  socket: WebSocketLike,
+  type: string,
+  listener: (...args: unknown[]) => void,
+): () => void {
+  if (socket.addEventListener) {
+    socket.addEventListener(type, listener);
+    return () => socket.removeEventListener?.(type, listener);
+  }
+  if (socket.on) {
+    socket.on(type, listener);
+    return () => (socket.off ?? socket.removeListener)?.call(socket, type, listener);
+  }
+  throw new ClusterConfigError(
+    'WebSocket implementation must support event listeners',
+    'INVALID_WEBSOCKET',
+  );
+}