Files
lda-wf/contracts/workflow-api.manifest.json
T

8913 lines
208 KiB
JSON

{
"components": {
"errors": {
"5000": {
"code": 5000,
"data": {
"additionalProperties": false,
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
}
},
"required": [
"code",
"message"
],
"type": "object"
},
"message": "Workflow operation failed"
}
},
"schemas": {
"AdminEventPayload": {
"additionalProperties": true,
"description": "Chronological platform event with provider-specific payload preserved.",
"properties": {
"capability_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"connection_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"kind": {
"type": "string"
},
"payload": {
"$ref": "#/components/schemas/JsonObject"
},
"timestamp_epoch_ms": {
"type": "integer"
},
"workflow_name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"kind",
"timestamp_epoch_ms",
"payload"
],
"type": "object"
},
"ApplyRegistryChangesResult": {
"additionalProperties": true,
"description": "Summary of reconciling desired registry state into the live service.",
"properties": {
"applied": {
"type": "boolean"
},
"auth_diagnostics": {
"items": {
"$ref": "#/components/schemas/DependencyDiagnosticPayload"
},
"type": "array"
},
"connection_count": {
"type": "integer"
},
"registered": {
"items": {
"type": "string"
},
"type": "array"
},
"registry_entry_count": {
"type": "integer"
},
"removed": {
"items": {
"type": "string"
},
"type": "array"
},
"updated": {
"items": {
"type": "string"
},
"type": "array"
}
},
"required": [
"applied",
"registered",
"updated",
"removed",
"connection_count",
"registry_entry_count"
],
"type": "object"
},
"ArrayExpression": {
"additionalProperties": false,
"description": "Resolve ordered child expressions into one JSON array.",
"properties": {
"items": {
"items": {
"$ref": "#/components/schemas/InputExpression"
},
"type": "array"
},
"kind": {
"const": "array",
"type": "string"
}
},
"required": [
"kind",
"items"
],
"type": "object"
},
"ArtifactCatalogEntryPayload": {
"description": "Compact artifact row returned by discovery operations.",
"properties": {
"artifact_id": {
"type": "string"
},
"description": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"diagnostics": {
"items": {
"$ref": "#/components/schemas/DependencyDiagnosticPayload"
},
"type": "array"
},
"display_name": {
"type": "string"
},
"input_schema": {
"$ref": "#/components/schemas/JsonObject"
},
"kind": {
"type": "string"
},
"name": {
"type": "string"
},
"outcomes": {
"items": {
"type": "string"
},
"type": "array"
},
"output_schema": {
"$ref": "#/components/schemas/JsonObject"
},
"required_sources": {
"items": {
"type": "string"
},
"type": "array"
},
"version": {
"type": "integer"
}
},
"required": [
"name",
"artifact_id",
"version",
"kind",
"display_name",
"description",
"outcomes",
"input_schema",
"output_schema",
"required_sources",
"diagnostics"
],
"type": "object"
},
"ArtifactKindPayload": {
"enum": [
"workflow",
"wrapper"
],
"type": "string"
},
"ArtifactPlanDiagnosticPayload": {
"description": "Stable diagnostic projected when an artifact plan is invalid.",
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
},
"path": {
"type": "string"
},
"repair_hint": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"severity": {
"enum": [
"error",
"warning"
],
"type": "string"
}
},
"required": [
"severity",
"code",
"path",
"message",
"repair_hint"
],
"type": "object"
},
"AuthRecordSummaryPayload": {
"additionalProperties": false,
"description": "Auth record summary without credential payload values.\n\n``metadata`` is explicitly non-secret display data. Credential material\nbelongs in the omitted auth payload and is represented only by key names.",
"properties": {
"id": {
"type": "string"
},
"metadata": {
"$ref": "#/components/schemas/JsonObject"
},
"payload_keys": {
"items": {
"type": "string"
},
"type": "array"
},
"scheme": {
"type": "string"
}
},
"required": [
"id",
"scheme",
"metadata",
"payload_keys"
],
"type": "object"
},
"AuthoringContractInventoryPayload": {
"description": "Revision-scoped readable sources and writable authoring targets.",
"properties": {
"entry_steps": {
"items": {
"$ref": "#/components/schemas/AuthoringStepContractPayload"
},
"type": "array"
},
"readable_sources": {
"items": {
"$ref": "#/components/schemas/AuthoringPathOptionPayload"
},
"type": "array"
},
"revision": {
"type": "integer"
},
"selected_step_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"state_targets": {
"items": {
"$ref": "#/components/schemas/AuthoringPathOptionPayload"
},
"type": "array"
},
"step_input_targets": {
"items": {
"$ref": "#/components/schemas/AuthoringPathOptionPayload"
},
"type": "array"
},
"step_output_sources": {
"items": {
"$ref": "#/components/schemas/AuthoringPathOptionPayload"
},
"type": "array"
},
"warnings": {
"items": {
"type": "string"
},
"type": "array"
},
"workflow_outcomes": {
"items": {
"type": "string"
},
"type": "array"
},
"workflow_output_targets": {
"items": {
"$ref": "#/components/schemas/AuthoringPathOptionPayload"
},
"type": "array"
},
"workspace_id": {
"type": "string"
}
},
"required": [
"workspace_id",
"revision",
"selected_step_id",
"readable_sources",
"step_input_targets",
"step_output_sources",
"state_targets",
"workflow_output_targets",
"entry_steps",
"workflow_outcomes",
"warnings"
],
"type": "object"
},
"AuthoringPathAvailability": {
"enum": [
"available",
"conditional"
],
"type": "string"
},
"AuthoringPathOptionPayload": {
"description": "One schema-derived source or target available to an author.",
"properties": {
"availability": {
"$ref": "#/components/schemas/AuthoringPathAvailability"
},
"description": {
"type": "string"
},
"label": {
"type": "string"
},
"origin": {
"$ref": "#/components/schemas/AuthoringPathOrigin"
},
"path": {
"type": "string"
},
"reason": {
"type": "string"
},
"required": {
"type": "boolean"
},
"schema": {
"$ref": "#/components/schemas/JsonObject"
},
"uses": {
"items": {
"$ref": "#/components/schemas/AuthoringPathUse"
},
"type": "array"
}
},
"required": [
"path",
"label",
"origin",
"schema",
"required",
"availability",
"uses"
],
"type": "object"
},
"AuthoringPathOrigin": {
"enum": [
"workflow_input",
"workflow_state",
"runtime_context",
"step_input",
"step_output",
"workflow_output"
],
"type": "string"
},
"AuthoringPathUse": {
"enum": [
"step_input",
"step_output_source",
"state_target",
"workflow_output"
],
"type": "string"
},
"AuthoringStepContractPayload": {
"description": "Compact executable-step choice used by authoring inventories.",
"properties": {
"description": {
"type": "string"
},
"input_targets": {
"items": {
"$ref": "#/components/schemas/AuthoringPathOptionPayload"
},
"type": "array"
},
"label": {
"type": "string"
},
"outcomes": {
"items": {
"type": "string"
},
"type": "array"
},
"output_sources": {
"items": {
"$ref": "#/components/schemas/AuthoringPathOptionPayload"
},
"type": "array"
},
"step_id": {
"type": "string"
}
},
"required": [
"step_id",
"label"
],
"type": "object"
},
"BinaryCondition": {
"description": "Condition that compares two operands.",
"properties": {
"left": {
"anyOf": [
{
"$ref": "#/components/schemas/PathOperand"
},
{
"$ref": "#/components/schemas/LiteralOperand"
}
]
},
"op": {
"enum": [
"eq",
"ne",
"gt",
"ge",
"lt",
"le"
],
"type": "string"
},
"right": {
"anyOf": [
{
"$ref": "#/components/schemas/PathOperand"
},
{
"$ref": "#/components/schemas/LiteralOperand"
}
]
}
},
"required": [
"op",
"left",
"right"
],
"type": "object"
},
"CapabilityCallResult": {
"description": "Outcome returned by a direct node-spec or wrapper capability call.",
"properties": {
"deployment_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"diagnostics": {
"items": {
"$ref": "#/components/schemas/DependencyDiagnosticPayload"
},
"type": "array"
},
"kind": {
"enum": [
"node_spec",
"wrapper_artifact"
],
"type": "string"
},
"outcome": {
"type": "string"
},
"output": {
"anyOf": [
{
"$ref": "#/components/schemas/JsonObject"
},
{
"type": "null"
}
]
},
"qualified_name": {
"type": "string"
},
"source_id": {
"type": "string"
}
},
"required": [
"qualified_name",
"source_id",
"kind",
"deployment_id",
"outcome",
"output",
"diagnostics"
],
"type": "object"
},
"CapabilityKindPayload": {
"enum": [
"tool",
"resource",
"prompt",
"node_spec",
"reducer",
"workflow"
],
"type": "string"
},
"CapabilityRefPayload": {
"properties": {
"capability_key": {
"type": "string"
},
"source": {
"type": "string"
}
},
"required": [
"source",
"capability_key"
],
"type": "object"
},
"CapabilityStepUpdate": {
"additionalProperties": false,
"description": "Presence-aware patch for one existing capability-backed draft step.",
"properties": {
"desc": {
"anyOf": [
{
"minLength": 1,
"type": "string"
},
{
"type": "null"
}
],
"default": null
},
"input": {
"anyOf": [
{
"items": {
"$ref": "#/components/schemas/StepInputBinding"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null
},
"retry": {
"anyOf": [
{
"minimum": 0,
"type": "integer"
},
{
"type": "null"
}
],
"default": null
},
"timeout_seconds": {
"anyOf": [
{
"exclusiveMinimum": 0,
"type": "integer"
},
{
"type": "null"
}
],
"default": null
}
},
"type": "object"
},
"CompileDraftWorkspaceResult": {
"anyOf": [
{
"$ref": "#/components/schemas/CompileDraftWorkspaceSuccess"
},
{
"$ref": "#/components/schemas/InvalidDraftResult"
}
]
},
"CompileDraftWorkspaceSuccess": {
"description": "Compiled raw plan and dependencies for one valid draft workspace.",
"properties": {
"compiled_plan": {
"$ref": "#/components/schemas/JsonObject"
},
"required_capabilities": {
"additionalProperties": {
"$ref": "#/components/schemas/RequiredCapabilityPayload"
},
"type": "object"
}
},
"required": [
"compiled_plan",
"required_capabilities"
],
"type": "object"
},
"ConnectionPayload": {
"additionalProperties": true,
"description": "Configured connection inventory row with provider extensions preserved.",
"properties": {
"account": {
"type": "string"
},
"enabled": {
"type": "boolean"
},
"id": {
"type": "string"
},
"metadata": {
"$ref": "#/components/schemas/JsonObject"
},
"server": {
"type": "string"
},
"source_config_ownership": {
"type": "string"
}
},
"required": [
"id",
"server",
"account",
"enabled",
"metadata"
],
"type": "object"
},
"ConnectionStatusPayload": {
"additionalProperties": true,
"description": "Connection readiness row with optional catalog snapshot facts.",
"properties": {
"account": {
"type": "string"
},
"connection_id": {
"type": "string"
},
"enabled": {
"type": "boolean"
},
"fetched_at_epoch_ms": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
]
},
"has_snapshot": {
"type": "boolean"
},
"max_age_seconds": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
]
},
"node_count": {
"type": "integer"
},
"prompt_count": {
"type": "integer"
},
"resource_count": {
"type": "integer"
},
"server": {
"type": "string"
}
},
"required": [
"connection_id",
"enabled"
],
"type": "object"
},
"CreateArtifactFromWorkspaceResult": {
"anyOf": [
{
"$ref": "#/components/schemas/SavedDraftArtifactResult"
},
{
"$ref": "#/components/schemas/UnsavedDraftArtifactResult"
}
]
},
"CreateDraftWorkspaceFromCapabilityResult": {
"description": "Bootstrapped workspace plus the hints and next actions that shaped it.",
"properties": {
"diagnostics": {
"items": {
"$ref": "#/components/schemas/DraftDiagnosticPayload"
},
"type": "array"
},
"draft": {
"$ref": "#/components/schemas/JsonObject"
},
"next_actions": {
"$ref": "#/components/schemas/NextActionsPayload"
},
"revision": {
"type": "integer"
},
"status": {
"enum": [
"valid",
"invalid",
"conflict"
],
"type": "string"
},
"summary": {
"$ref": "#/components/schemas/DraftWorkspaceSummary"
},
"title": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"workspace_id": {
"type": "string"
},
"wrapper_hints": {
"$ref": "#/components/schemas/WrapperAuthoringHintsPayload"
}
},
"required": [
"workspace_id",
"revision",
"title",
"status",
"diagnostics",
"summary",
"wrapper_hints",
"next_actions"
],
"type": "object"
},
"DeleteArtifactResult": {
"properties": {
"artifact_id": {
"type": "string"
},
"blocked_by_deployments": {
"items": {
"type": "string"
},
"type": "array"
},
"deleted": {
"type": "boolean"
},
"version": {
"type": "integer"
}
},
"required": [
"artifact_id",
"version",
"deleted",
"blocked_by_deployments"
],
"type": "object"
},
"DeleteAuthRecordResult": {
"additionalProperties": false,
"description": "Outcome of deleting one auth record.",
"properties": {
"deleted": {
"type": "boolean"
},
"id": {
"type": "string"
}
},
"required": [
"deleted",
"id"
],
"type": "object"
},
"DeleteDeploymentResult": {
"properties": {
"deleted": {
"type": "boolean"
},
"deployment_id": {
"type": "string"
}
},
"required": [
"deployment_id",
"deleted"
],
"type": "object"
},
"DeleteDraftWorkspaceResult": {
"description": "Outcome of deleting one persisted draft workspace.",
"properties": {
"deleted": {
"type": "boolean"
},
"status": {
"enum": [
"deleted",
"not_found"
],
"type": "string"
},
"workspace_id": {
"type": "string"
}
},
"required": [
"workspace_id",
"deleted",
"status"
],
"type": "object"
},
"DependencyDiagnosticPayload": {
"additionalProperties": true,
"description": "JSON projection of one deployment dependency diagnostic.",
"properties": {
"bound_source": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"code": {
"type": "string"
},
"logical_ref": {
"type": "string"
},
"message": {
"type": "string"
},
"repair_hint": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"severity": {
"type": "string"
}
},
"required": [
"severity",
"code",
"logical_ref",
"bound_source",
"message",
"repair_hint"
],
"type": "object"
},
"DeploymentSummary": {
"description": "Compact deployment row used by list operations.",
"properties": {
"artifact_id": {
"type": "string"
},
"artifact_version": {
"type": "integer"
},
"binding_count": {
"type": "integer"
},
"drift_policy": {
"type": "string"
},
"id": {
"type": "string"
}
},
"required": [
"artifact_id",
"artifact_version",
"id",
"binding_count",
"drift_policy"
],
"type": "object"
},
"DraftChooseClause": {
"additionalProperties": false,
"description": "One ordered boolean clause in a draft choose decision.",
"properties": {
"if": {
"discriminator": {
"mapping": {
"and": "#/components/schemas/VariadicCondition",
"eq": "#/components/schemas/BinaryCondition",
"exists": "#/components/schemas/ExistsCondition",
"ge": "#/components/schemas/BinaryCondition",
"gt": "#/components/schemas/BinaryCondition",
"le": "#/components/schemas/BinaryCondition",
"lt": "#/components/schemas/BinaryCondition",
"ne": "#/components/schemas/BinaryCondition",
"not": "#/components/schemas/NotCondition",
"or": "#/components/schemas/VariadicCondition"
},
"propertyName": "op"
},
"oneOf": [
{
"$ref": "#/components/schemas/ExistsCondition"
},
{
"$ref": "#/components/schemas/NotCondition"
},
{
"$ref": "#/components/schemas/VariadicCondition"
},
{
"$ref": "#/components/schemas/BinaryCondition"
}
]
},
"then": {
"type": "string"
}
},
"required": [
"if",
"then"
],
"type": "object"
},
"DraftChoosePayload": {
"additionalProperties": false,
"description": "Payload for an ordered first-true draft decision.",
"properties": {
"clauses": {
"items": {
"$ref": "#/components/schemas/DraftChooseClause"
},
"minItems": 1,
"type": "array"
},
"default": {
"default": "__end__",
"type": "string"
}
},
"required": [
"clauses"
],
"type": "object"
},
"DraftChooseStep": {
"additionalProperties": false,
"description": "Draft step that delegates ordered decisions to `WorkflowBuilder.choose`.",
"properties": {
"choose": {
"$ref": "#/components/schemas/DraftChoosePayload"
}
},
"required": [
"choose"
],
"type": "object"
},
"DraftDiagnosticPayload": {
"description": "One validation or revision diagnostic attached to a draft workspace.",
"properties": {
"code": {
"type": "string"
},
"details": {
"$ref": "#/components/schemas/JsonObject"
},
"message": {
"type": "string"
},
"path": {
"type": "string"
},
"repair_hint": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"step_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"code",
"path",
"message"
],
"type": "object"
},
"DraftEndPayload": {
"additionalProperties": false,
"description": "Payload for one explicit workflow terminal outcome.",
"properties": {
"outcome": {
"default": "ok",
"minLength": 1,
"type": "string"
}
},
"type": "object"
},
"DraftEndStep": {
"additionalProperties": false,
"description": "Draft step that lowers to core `EndNode`.\n\nRoute to this step when the workflow should finish with a non-`ok` public\noutcome. Routing directly to `__end__` remains the shorthand for `ok`.",
"properties": {
"end": {
"$ref": "#/components/schemas/DraftEndPayload"
}
},
"type": "object"
},
"DraftForeachPayload": {
"additionalProperties": false,
"description": "Payload for one draft foreach step.",
"properties": {
"as": {
"type": "string"
},
"concurrent": {
"anyOf": [
{
"$ref": "#/components/schemas/ForeachConcurrentPolicy"
},
{
"type": "null"
}
],
"default": null
},
"item_error": {
"$ref": "#/components/schemas/ForeachItemErrorPolicy"
},
"mode": {
"default": "serial",
"enum": [
"serial",
"concurrent"
],
"type": "string"
},
"on_item_error": {
"anyOf": [
{
"enum": [
"fail",
"collect",
"skip"
],
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Deprecated parse-only shorthand; use item_error."
},
"over": {
"description": "Readable graph path rooted at input, state, or context.",
"oneOf": [
{
"description": "Canonical TOML-key path string.",
"type": "string"
},
{
"additionalProperties": false,
"description": "Structural path object accepted as input.",
"properties": {
"parts": {
"items": {
"minLength": 1,
"type": "string"
},
"minItems": 0,
"type": "array"
},
"root": {
"enum": [
"input",
"state",
"context"
],
"type": "string"
}
},
"required": [
"root",
"parts"
],
"type": "object"
}
]
}
},
"required": [
"over",
"as"
],
"type": "object"
},
"DraftForeachStep": {
"additionalProperties": false,
"description": "Draft step that delegates foreach construction to `WorkflowBuilder`.",
"properties": {
"foreach": {
"$ref": "#/components/schemas/DraftForeachPayload"
}
},
"required": [
"foreach"
],
"type": "object"
},
"DraftInterruptPayload": {
"additionalProperties": false,
"description": "Payload for one draft interrupt step.",
"properties": {
"kind": {
"type": "string"
},
"outcomes": {
"items": {
"type": "string"
},
"type": "array"
},
"request": {
"items": {
"$ref": "#/components/schemas/StepInputBinding"
},
"type": "array"
},
"request_schema": {
"anyOf": [
{
"$ref": "#/components/schemas/SchemaRef"
},
{
"type": "null"
}
],
"default": null
},
"resume": {
"items": {
"$ref": "#/components/schemas/OutputBinding"
},
"type": "array"
},
"resume_schema": {
"anyOf": [
{
"$ref": "#/components/schemas/SchemaRef"
},
{
"type": "null"
}
],
"default": null
}
},
"required": [
"kind"
],
"type": "object"
},
"DraftInterruptStep": {
"additionalProperties": false,
"description": "Draft step that pauses execution and waits for resume input.",
"properties": {
"interrupt": {
"$ref": "#/components/schemas/DraftInterruptPayload"
}
},
"required": [
"interrupt"
],
"type": "object"
},
"DraftMatchCase": {
"additionalProperties": false,
"description": "One ordered equality case in a draft match decision.",
"properties": {
"equals": {},
"then": {
"type": "string"
}
},
"required": [
"equals",
"then"
],
"type": "object"
},
"DraftMatchPayload": {
"additionalProperties": false,
"description": "Payload for matching one graph value against ordered equality cases.",
"properties": {
"cases": {
"items": {
"$ref": "#/components/schemas/DraftMatchCase"
},
"minItems": 1,
"type": "array"
},
"default": {
"default": "__end__",
"type": "string"
},
"value": {
"type": "string"
}
},
"required": [
"value",
"cases"
],
"type": "object"
},
"DraftMatchStep": {
"additionalProperties": false,
"description": "Draft step that delegates equality decisions to `WorkflowBuilder.match`.",
"properties": {
"match": {
"$ref": "#/components/schemas/DraftMatchPayload"
}
},
"required": [
"match"
],
"type": "object"
},
"DraftSubgraphPayload": {
"additionalProperties": false,
"description": "Declarative boundary contract for a referenced child workflow.",
"properties": {
"desc": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null
},
"input": {
"items": {
"$ref": "#/components/schemas/StepInputBinding"
},
"type": "array"
},
"input_schema": {
"$ref": "#/components/schemas/SchemaRef"
},
"outcomes": {
"items": {
"type": "string"
},
"minItems": 1,
"type": "array"
},
"output": {
"items": {
"$ref": "#/components/schemas/OutputBinding"
},
"type": "array"
},
"output_schema": {
"$ref": "#/components/schemas/SchemaRef"
},
"workflow": {
"$ref": "#/components/schemas/WorkflowRef"
}
},
"required": [
"workflow"
],
"type": "object"
},
"DraftSubgraphStep": {
"additionalProperties": false,
"description": "Draft step that lowers to a native `SubgraphNode` boundary.",
"properties": {
"subgraph": {
"$ref": "#/components/schemas/DraftSubgraphPayload"
}
},
"required": [
"subgraph"
],
"type": "object"
},
"DraftUseStep": {
"additionalProperties": false,
"description": "Draft step that calls one externally resolvable workflow capability.\n\n`output` writes node-local output fields into workflow state. Root\nworkflow output bindings live on `WorkflowDraft.output`.",
"properties": {
"desc": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null
},
"input": {
"description": "Canonical input bindings for this capability. Use path bindings for graph-to-local input and value bindings for literals.",
"items": {
"$ref": "#/components/schemas/StepInputBinding"
},
"type": "array"
},
"output": {
"description": "Canonical output bindings from node-local output paths to workflow state destinations.",
"items": {
"$ref": "#/components/schemas/OutputBinding"
},
"type": "array"
},
"retry": {
"anyOf": [
{
"minimum": 0,
"type": "integer"
},
{
"type": "null"
}
],
"default": null
},
"timeout_seconds": {
"anyOf": [
{
"exclusiveMinimum": 0,
"type": "integer"
},
{
"type": "null"
}
],
"default": null
},
"use": {
"type": "string"
}
},
"required": [
"use"
],
"type": "object"
},
"DraftWhenPayload": {
"additionalProperties": false,
"description": "Payload for one boolean draft decision.",
"properties": {
"if": {
"discriminator": {
"mapping": {
"and": "#/components/schemas/VariadicCondition",
"eq": "#/components/schemas/BinaryCondition",
"exists": "#/components/schemas/ExistsCondition",
"ge": "#/components/schemas/BinaryCondition",
"gt": "#/components/schemas/BinaryCondition",
"le": "#/components/schemas/BinaryCondition",
"lt": "#/components/schemas/BinaryCondition",
"ne": "#/components/schemas/BinaryCondition",
"not": "#/components/schemas/NotCondition",
"or": "#/components/schemas/VariadicCondition"
},
"propertyName": "op"
},
"oneOf": [
{
"$ref": "#/components/schemas/ExistsCondition"
},
{
"$ref": "#/components/schemas/NotCondition"
},
{
"$ref": "#/components/schemas/VariadicCondition"
},
{
"$ref": "#/components/schemas/BinaryCondition"
}
]
},
"otherwise": {
"default": "__end__",
"type": "string"
},
"then": {
"type": "string"
}
},
"required": [
"if",
"then"
],
"type": "object"
},
"DraftWhenStep": {
"additionalProperties": false,
"description": "Draft step that delegates one boolean decision to `WorkflowBuilder.when`.",
"properties": {
"when": {
"$ref": "#/components/schemas/DraftWhenPayload"
}
},
"required": [
"when"
],
"type": "object"
},
"DraftWorkspaceResult": {
"description": "Canonical persisted workspace envelope returned after reads and edits.",
"properties": {
"diagnostics": {
"items": {
"$ref": "#/components/schemas/DraftDiagnosticPayload"
},
"type": "array"
},
"draft": {
"$ref": "#/components/schemas/JsonObject"
},
"revision": {
"type": "integer"
},
"status": {
"enum": [
"valid",
"invalid",
"conflict"
],
"type": "string"
},
"summary": {
"$ref": "#/components/schemas/DraftWorkspaceSummary"
},
"title": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"workspace_id": {
"type": "string"
}
},
"required": [
"workspace_id",
"revision",
"title",
"status",
"diagnostics",
"summary"
],
"type": "object"
},
"DraftWorkspaceSummary": {
"description": "Compact graph facts included with every persisted workspace result.",
"properties": {
"name": {},
"route_count": {
"type": "integer"
},
"start": {},
"step_count": {
"type": "integer"
},
"steps": {
"items": {
"type": "string"
},
"type": "array"
}
},
"required": [
"name",
"start",
"step_count",
"route_count",
"steps"
],
"type": "object"
},
"ExistsCondition": {
"description": "Condition that is true when a graph path resolves to a present value.",
"properties": {
"op": {
"const": "exists",
"type": "string"
},
"path": {
"description": "Readable graph path rooted at input, state, or context.",
"oneOf": [
{
"description": "Canonical TOML-key path string.",
"type": "string"
},
{
"additionalProperties": false,
"description": "Structural path object accepted as input.",
"properties": {
"parts": {
"items": {
"minLength": 1,
"type": "string"
},
"minItems": 0,
"type": "array"
},
"root": {
"enum": [
"input",
"state",
"context"
],
"type": "string"
}
},
"required": [
"root",
"parts"
],
"type": "object"
}
]
}
},
"required": [
"op",
"path"
],
"type": "object"
},
"ForeachConcurrentPolicy": {
"additionalProperties": false,
"description": "Concurrency policy for foreach frame admission.\n\nThis controls workflow-level child frame admission. It does not imply\nthread/process execution for sync node handlers; async runtime can use the\nsame policy to admit simultaneous async handler calls later.",
"properties": {
"interrupt": {
"const": "quiesce",
"default": "quiesce",
"type": "string"
},
"max_active": {
"default": 4,
"minimum": 1,
"type": "integer"
},
"max_outstanding": {
"default": 20,
"minimum": 1,
"type": "integer"
}
},
"type": "object"
},
"ForeachItemErrorPolicy": {
"additionalProperties": false,
"description": "Policy for runtime failures inside one foreach item lineage.",
"properties": {
"action": {
"default": "fail",
"enum": [
"fail",
"skip",
"collect"
],
"type": "string"
},
"collect_to": {
"anyOf": [
{
"description": "Writable workflow state path.",
"oneOf": [
{
"description": "Canonical TOML-key path string.",
"type": "string"
},
{
"additionalProperties": false,
"description": "Structural path object accepted as input.",
"properties": {
"parts": {
"items": {
"minLength": 1,
"type": "string"
},
"minItems": 1,
"type": "array"
},
"root": {
"const": "state",
"type": "string"
}
},
"required": [
"root",
"parts"
],
"type": "object"
}
]
},
{
"type": "null"
}
],
"default": null
}
},
"type": "object"
},
"HandleDraftBranch": {
"additionalProperties": false,
"properties": {
"outcome": {
"minLength": 1,
"type": "string"
},
"step_id": {
"minLength": 1,
"type": "string"
}
},
"required": [
"step_id",
"outcome"
],
"type": "object"
},
"HealthResult": {
"description": "Health response shared by self-describing workflow transports.",
"properties": {
"status": {
"const": "ok",
"type": "string"
},
"store_root": {
"type": "string"
}
},
"required": [
"status",
"store_root"
],
"type": "object"
},
"InputExpression": {
"discriminator": {
"mapping": {
"array": "#/components/schemas/ArrayExpression",
"literal": "#/components/schemas/LiteralExpression",
"object": "#/components/schemas/ObjectExpression",
"path": "#/components/schemas/PathExpression"
},
"propertyName": "kind"
},
"oneOf": [
{
"$ref": "#/components/schemas/LiteralExpression"
},
{
"$ref": "#/components/schemas/PathExpression"
},
{
"$ref": "#/components/schemas/ArrayExpression"
},
{
"$ref": "#/components/schemas/ObjectExpression"
}
]
},
"InputExpressionBinding": {
"additionalProperties": false,
"description": "Assign one recursively composed expression to a node-local target.",
"properties": {
"expression": {
"$ref": "#/components/schemas/InputExpression"
},
"target": {
"description": "Node-local path. Use the root marker `.` for the whole payload.",
"oneOf": [
{
"description": "Canonical TOML-key path string.",
"type": "string"
},
{
"additionalProperties": false,
"description": "Structural path object accepted as input.",
"properties": {
"parts": {
"items": {
"minLength": 1,
"type": "string"
},
"minItems": 0,
"type": "array"
},
"root": {
"const": "local",
"type": "string"
}
},
"required": [
"root",
"parts"
],
"type": "object"
}
]
}
},
"required": [
"target",
"expression"
],
"type": "object"
},
"InputPathBinding": {
"additionalProperties": false,
"description": "Map one workflow graph source path into one node-local input path.",
"properties": {
"path": {
"description": "Workflow source path to read from input, state, or context. Prefer canonical strings such as `input.text` or `state.report`. Structural objects such as {'root': 'input', 'parts': ['text']} are also accepted as input.",
"oneOf": [
{
"description": "Canonical TOML-key path string.",
"type": "string"
},
{
"additionalProperties": false,
"description": "Structural path object accepted as input.",
"properties": {
"parts": {
"items": {
"minLength": 1,
"type": "string"
},
"minItems": 0,
"type": "array"
},
"root": {
"enum": [
"input",
"state",
"context"
],
"type": "string"
}
},
"required": [
"root",
"parts"
],
"type": "object"
}
]
},
"target": {
"description": "Node-local input path to populate. Prefer canonical strings such as `field` or `.` for the whole node input payload. Structural objects such as {'root': 'local', 'parts': ['field']} are also accepted as input.",
"oneOf": [
{
"description": "Canonical TOML-key path string.",
"type": "string"
},
{
"additionalProperties": false,
"description": "Structural path object accepted as input.",
"properties": {
"parts": {
"items": {
"minLength": 1,
"type": "string"
},
"minItems": 0,
"type": "array"
},
"root": {
"const": "local",
"type": "string"
}
},
"required": [
"root",
"parts"
],
"type": "object"
}
]
}
},
"required": [
"target",
"path"
],
"type": "object"
},
"InputValueBinding": {
"additionalProperties": false,
"description": "Map one static value into one node-local input path.",
"properties": {
"target": {
"description": "Node-local input path that receives this literal JSON value.",
"oneOf": [
{
"description": "Canonical TOML-key path string.",
"type": "string"
},
{
"additionalProperties": false,
"description": "Structural path object accepted as input.",
"properties": {
"parts": {
"items": {
"minLength": 1,
"type": "string"
},
"minItems": 0,
"type": "array"
},
"root": {
"const": "local",
"type": "string"
}
},
"required": [
"root",
"parts"
],
"type": "object"
}
]
},
"value": {
"$ref": "#/components/schemas/JsonValue",
"description": "Literal JSON-compatible value to pass to the node. Use this for constants, not for values read from workflow input or state."
}
},
"required": [
"target",
"value"
],
"type": "object"
},
"InspectCapabilityResult": {
"anyOf": [
{
"$ref": "#/components/schemas/NodeSpecCapabilityDetail"
},
{
"$ref": "#/components/schemas/WrapperArtifactCapabilityDetail"
}
]
},
"InspectRegistryEntryResult": {
"description": "Full desired source entry with config precedence facts.",
"properties": {
"config_ownership": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"entry": {
"$ref": "#/components/schemas/RegistryEntryPayload"
},
"mutable": {
"type": "boolean"
},
"shadowed_by_config": {
"type": "boolean"
}
},
"required": [
"entry",
"shadowed_by_config",
"config_ownership",
"mutable"
],
"type": "object"
},
"InspectSourceResult": {
"description": "Full source inventory with optional diagnostics supplied by the runtime.",
"properties": {
"capabilities": {
"$ref": "#/components/schemas/SourceCapabilityInventoryPayload"
},
"description": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"diagnostics": {
"anyOf": [
{
"$ref": "#/components/schemas/SourceDiagnosisResult"
},
{
"$ref": "#/components/schemas/SourceDiagnosticsUnavailablePayload"
}
]
},
"enabled": {
"type": "boolean"
},
"has_more": {
"$ref": "#/components/schemas/SourceCapabilityHasMorePayload"
},
"id": {
"type": "string"
},
"kind": {
"enum": [
"system",
"connection",
"python"
],
"type": "string"
},
"node_spec_count": {
"type": "integer"
},
"permissions": {
"$ref": "#/components/schemas/SourcePermissionsPayload"
},
"policy": {
"$ref": "#/components/schemas/SourcePolicyPayload"
},
"preview": {
"$ref": "#/components/schemas/SourceCapabilityPreviewPayload"
},
"prompt_count": {
"type": "integer"
},
"reducer_count": {
"type": "integer"
},
"resource_count": {
"type": "integer"
},
"tool_count": {
"type": "integer"
},
"visibility": {
"$ref": "#/components/schemas/SourceVisibilityPayload"
}
},
"required": [
"id",
"kind",
"enabled",
"visibility",
"permissions",
"policy",
"description",
"tool_count",
"node_spec_count",
"reducer_count",
"prompt_count",
"resource_count",
"preview",
"has_more",
"capabilities"
],
"type": "object"
},
"InterruptPayload": {
"description": "Persisted typed interrupt contract exposed to API clients.",
"properties": {
"frame_id": {
"type": "string"
},
"id": {
"type": "string"
},
"kind": {
"type": "string"
},
"node_id": {
"type": "string"
},
"outcomes": {
"items": {
"type": "string"
},
"type": "array"
},
"payload": {
"$ref": "#/components/schemas/JsonObject"
},
"request_schema": {
"$ref": "#/components/schemas/JsonSchema"
},
"resumable": {
"type": "boolean"
},
"resume_schema": {
"$ref": "#/components/schemas/JsonSchema"
},
"route": {
"anyOf": [
{
"$ref": "#/components/schemas/InterruptRoutePayload"
},
{
"type": "null"
}
]
},
"typed": {
"type": "boolean"
}
},
"required": [
"id",
"frame_id",
"node_id",
"kind",
"payload",
"resumable",
"route",
"outcomes",
"request_schema",
"resume_schema",
"typed"
],
"type": "object"
},
"InterruptRoutePayload": {
"properties": {
"frame_id": {
"type": "string"
},
"lineage_id": {
"type": "string"
},
"node_id": {
"type": "string"
},
"parent_frame_id": {
"type": "string"
},
"scope_id": {
"type": "string"
},
"workflow_ref": {
"$ref": "#/components/schemas/WorkflowRefPayload"
}
},
"required": [
"frame_id",
"node_id",
"scope_id",
"lineage_id",
"parent_frame_id",
"workflow_ref"
],
"type": "object"
},
"InvalidDraftResult": {
"description": "Validation-only result returned when a draft cannot be compiled.",
"properties": {
"diagnostics": {
"items": {
"$ref": "#/components/schemas/DraftDiagnosticPayload"
},
"type": "array"
},
"status": {
"const": "invalid",
"type": "string"
}
},
"required": [
"status",
"diagnostics"
],
"type": "object"
},
"JsonObject": {
"additionalProperties": true,
"type": "object"
},
"JsonSchema": {
"additionalProperties": true,
"type": "object"
},
"JsonValue": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "integer"
},
{
"type": "number"
},
{
"type": "string"
},
{
"items": {
"$ref": "#/components/schemas/JsonValue"
},
"type": "array"
},
{
"additionalProperties": {
"$ref": "#/components/schemas/JsonValue"
},
"type": "object"
},
{
"type": "null"
}
]
},
"ListAdminEventsResult": {
"description": "Chronological platform event history.",
"properties": {
"events": {
"items": {
"$ref": "#/components/schemas/AdminEventPayload"
},
"type": "array"
},
"total": {
"type": "integer"
}
},
"required": [
"events",
"total"
],
"type": "object"
},
"ListArtifactsResult": {
"properties": {
"next_cursor": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"nodes": {
"items": {
"$ref": "#/components/schemas/ArtifactCatalogEntryPayload"
},
"type": "array"
},
"total": {
"type": "integer"
}
},
"required": [
"next_cursor",
"total",
"nodes"
],
"type": "object"
},
"ListAuthRecordsResult": {
"description": "Sorted secret-safe auth record inventory.",
"properties": {
"auth_records": {
"items": {
"$ref": "#/components/schemas/AuthRecordSummaryPayload"
},
"type": "array"
},
"total": {
"type": "integer"
}
},
"required": [
"auth_records",
"total"
],
"type": "object"
},
"ListCapabilitiesResult": {
"description": "Cursor-paged planner-visible capability discovery result.",
"properties": {
"capabilities": {
"items": {
"anyOf": [
{
"$ref": "#/components/schemas/NodeSpecCapabilitySummary"
},
{
"$ref": "#/components/schemas/WrapperArtifactCapabilitySummary"
}
]
},
"type": "array"
},
"next_cursor": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"total": {
"type": "integer"
}
},
"required": [
"next_cursor",
"total",
"capabilities"
],
"type": "object"
},
"ListConnectionStatusesResult": {
"description": "Sorted connection readiness inventory.",
"properties": {
"statuses": {
"items": {
"$ref": "#/components/schemas/ConnectionStatusPayload"
},
"type": "array"
},
"total": {
"type": "integer"
}
},
"required": [
"statuses",
"total"
],
"type": "object"
},
"ListConnectionsResult": {
"description": "Sorted configured connection inventory.",
"properties": {
"connections": {
"items": {
"$ref": "#/components/schemas/ConnectionPayload"
},
"type": "array"
},
"total": {
"type": "integer"
}
},
"required": [
"connections",
"total"
],
"type": "object"
},
"ListDeploymentsResult": {
"properties": {
"deployments": {
"items": {
"$ref": "#/components/schemas/DeploymentSummary"
},
"type": "array"
}
},
"required": [
"deployments"
],
"type": "object"
},
"ListDraftWorkspacesResult": {
"description": "All persisted draft-workspace summaries.",
"properties": {
"workspaces": {
"items": {
"$ref": "#/components/schemas/DraftWorkspaceResult"
},
"type": "array"
}
},
"required": [
"workspaces"
],
"type": "object"
},
"ListRegistryEntriesResult": {
"description": "Cursor-paged desired source registry entries.",
"properties": {
"entries": {
"items": {
"$ref": "#/components/schemas/RegistryEntrySummaryPayload"
},
"type": "array"
},
"next_cursor": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"total": {
"type": "integer"
}
},
"required": [
"next_cursor",
"total",
"entries"
],
"type": "object"
},
"ListRunsResult": {
"properties": {
"cursor": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"limit": {
"type": "integer"
},
"next_cursor": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"runs": {
"items": {
"$ref": "#/components/schemas/RunSummary"
},
"type": "array"
},
"total": {
"type": "integer"
}
},
"required": [
"runs",
"total",
"cursor",
"next_cursor",
"limit"
],
"type": "object"
},
"ListSourcesResult": {
"description": "Cursor-paged compact source discovery result.",
"properties": {
"next_cursor": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"sources": {
"items": {
"$ref": "#/components/schemas/SourceStatusPayload"
},
"type": "array"
},
"total": {
"type": "integer"
}
},
"required": [
"next_cursor",
"total",
"sources"
],
"type": "object"
},
"LiteralExpression": {
"additionalProperties": false,
"description": "A strict JSON literal embedded in a node-local input expression.",
"properties": {
"kind": {
"const": "literal",
"type": "string"
},
"value": {
"$ref": "#/components/schemas/JsonValue"
}
},
"required": [
"kind",
"value"
],
"type": "object"
},
"LiteralOperand": {
"description": "Condition operand that carries a literal value.",
"properties": {
"value": {}
},
"required": [
"value"
],
"type": "object"
},
"NextActionPatchExamplePayload": {
"description": "Concrete follow-up operation suggested to an API caller.",
"properties": {
"description": {
"type": "string"
},
"request": {
"$ref": "#/components/schemas/JsonObject"
},
"tool": {
"type": "string"
}
},
"required": [
"description",
"tool",
"request"
],
"type": "object"
},
"NextActionsPayload": {
"description": "JSON projection of advisory workflow continuation guidance.",
"properties": {
"can_continue": {
"type": "boolean"
},
"can_save_now": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
]
},
"patch_examples": {
"items": {
"$ref": "#/components/schemas/NextActionPatchExamplePayload"
},
"type": "array"
},
"reason": {
"type": "string"
},
"recommended_next_tool": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"warnings": {
"items": {
"type": "string"
},
"type": "array"
}
},
"required": [
"can_continue",
"can_save_now",
"recommended_next_tool",
"reason",
"patch_examples",
"warnings"
],
"type": "object"
},
"NodeSpecCapabilityDetail": {
"description": "Full executable contract for one source node spec.",
"properties": {
"accepts_context": {
"type": "boolean"
},
"description": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"input_schema": {
"$ref": "#/components/schemas/JsonObject"
},
"is_async": {
"type": "boolean"
},
"kind": {
"const": "node_spec",
"type": "string"
},
"name": {
"type": "string"
},
"outcomes": {
"items": {
"type": "string"
},
"type": "array"
},
"output_schema": {
"$ref": "#/components/schemas/JsonObject"
},
"source_id": {
"type": "string"
},
"wrapper_hints": {
"$ref": "#/components/schemas/WrapperAuthoringHintsPayload"
}
},
"required": [
"name",
"source_id",
"description",
"outcomes",
"is_async",
"input_schema",
"output_schema",
"wrapper_hints",
"kind",
"accepts_context"
],
"type": "object"
},
"NodeSpecCapabilitySummary": {
"description": "Compact discovery row for one executable source node spec.",
"properties": {
"description": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"input_fields": {
"items": {
"type": "string"
},
"type": "array"
},
"is_async": {
"type": "boolean"
},
"kind": {
"const": "node_spec",
"type": "string"
},
"name": {
"type": "string"
},
"outcomes": {
"items": {
"type": "string"
},
"type": "array"
},
"output_fields": {
"items": {
"type": "string"
},
"type": "array"
},
"source_id": {
"type": "string"
}
},
"required": [
"name",
"source_id",
"description",
"outcomes",
"is_async",
"input_fields",
"output_fields",
"kind"
],
"type": "object"
},
"NodeSpecInventoryPayload": {
"description": "Serializable executable contract owned by one capability source.",
"properties": {
"accepts_context": {
"type": "boolean"
},
"description": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"input_schema": {
"$ref": "#/components/schemas/JsonObject"
},
"is_async": {
"type": "boolean"
},
"name": {
"type": "string"
},
"outcomes": {
"items": {
"type": "string"
},
"type": "array"
},
"output_schema": {
"$ref": "#/components/schemas/JsonObject"
}
},
"required": [
"name",
"description",
"outcomes",
"input_schema",
"output_schema",
"is_async",
"accepts_context"
],
"type": "object"
},
"NotCondition": {
"description": "Condition that negates another condition expression.",
"properties": {
"arg": {
"discriminator": {
"mapping": {
"and": "#/components/schemas/VariadicCondition",
"eq": "#/components/schemas/BinaryCondition",
"exists": "#/components/schemas/ExistsCondition",
"ge": "#/components/schemas/BinaryCondition",
"gt": "#/components/schemas/BinaryCondition",
"le": "#/components/schemas/BinaryCondition",
"lt": "#/components/schemas/BinaryCondition",
"ne": "#/components/schemas/BinaryCondition",
"not": "#/components/schemas/NotCondition",
"or": "#/components/schemas/VariadicCondition"
},
"propertyName": "op"
},
"oneOf": [
{
"$ref": "#/components/schemas/ExistsCondition"
},
{
"$ref": "#/components/schemas/NotCondition"
},
{
"$ref": "#/components/schemas/VariadicCondition"
},
{
"$ref": "#/components/schemas/BinaryCondition"
}
]
},
"op": {
"const": "not",
"type": "string"
}
},
"required": [
"op",
"arg"
],
"type": "object"
},
"ObjectExpression": {
"additionalProperties": false,
"description": "Resolve named child expressions into one JSON object.",
"properties": {
"fields": {
"additionalProperties": {
"$ref": "#/components/schemas/InputExpression"
},
"type": "object"
},
"kind": {
"const": "object",
"type": "string"
}
},
"required": [
"kind",
"fields"
],
"type": "object"
},
"OutputBinding": {
"additionalProperties": false,
"description": "Map one node-local output path into one workflow state path.",
"properties": {
"source": {
"description": "Node-local output path to read. Prefer canonical strings such as `result` or `.` for the whole node output payload. Structural objects such as {'root': 'local', 'parts': []} are also accepted as input.",
"oneOf": [
{
"description": "Canonical TOML-key path string.",
"type": "string"
},
{
"additionalProperties": false,
"description": "Structural path object accepted as input.",
"properties": {
"parts": {
"items": {
"minLength": 1,
"type": "string"
},
"minItems": 0,
"type": "array"
},
"root": {
"const": "local",
"type": "string"
}
},
"required": [
"root",
"parts"
],
"type": "object"
}
]
},
"target": {
"description": "Writable workflow state path. Bare state is invalid; use a field path such as `state.echoed`. Structural objects such as {'root': 'state', 'parts': ['echoed']} are also accepted as input.",
"oneOf": [
{
"description": "Canonical TOML-key path string.",
"type": "string"
},
{
"additionalProperties": false,
"description": "Structural path object accepted as input.",
"properties": {
"parts": {
"items": {
"minLength": 1,
"type": "string"
},
"minItems": 1,
"type": "array"
},
"root": {
"const": "state",
"type": "string"
}
},
"required": [
"root",
"parts"
],
"type": "object"
}
]
}
},
"required": [
"source",
"target"
],
"type": "object"
},
"PatchDraftResult": {
"anyOf": [
{
"$ref": "#/components/schemas/PatchedDraftValidResult"
},
{
"$ref": "#/components/schemas/PatchedDraftInvalidResult"
}
]
},
"PatchedDraftInvalidResult": {
"description": "Invalid patch result, optionally retaining the applied draft document.",
"properties": {
"diagnostics": {
"items": {
"$ref": "#/components/schemas/DraftDiagnosticPayload"
},
"type": "array"
},
"draft": {
"$ref": "#/components/schemas/JsonObject"
},
"status": {
"const": "invalid",
"type": "string"
}
},
"required": [
"status",
"diagnostics"
],
"type": "object"
},
"PatchedDraftValidResult": {
"description": "Valid draft document produced after applying a JSON Patch.",
"properties": {
"compiled_plan": {
"$ref": "#/components/schemas/JsonObject"
},
"diagnostics": {
"items": {
"$ref": "#/components/schemas/DraftDiagnosticPayload"
},
"type": "array"
},
"draft": {
"$ref": "#/components/schemas/JsonObject"
},
"status": {
"const": "valid",
"type": "string"
}
},
"required": [
"status",
"diagnostics",
"compiled_plan",
"draft"
],
"type": "object"
},
"PathExpression": {
"additionalProperties": false,
"description": "Read one graph source path while resolving a composite input.",
"properties": {
"kind": {
"const": "path",
"type": "string"
},
"path": {
"description": "Readable graph path rooted at input, state, or context.",
"oneOf": [
{
"description": "Canonical TOML-key path string.",
"type": "string"
},
{
"additionalProperties": false,
"description": "Structural path object accepted as input.",
"properties": {
"parts": {
"items": {
"minLength": 1,
"type": "string"
},
"minItems": 0,
"type": "array"
},
"root": {
"enum": [
"input",
"state",
"context"
],
"type": "string"
}
},
"required": [
"root",
"parts"
],
"type": "object"
}
]
}
},
"required": [
"kind",
"path"
],
"type": "object"
},
"PathOperand": {
"description": "Condition operand resolved from a workflow graph path.",
"properties": {
"path": {
"description": "Readable graph path rooted at input, state, or context.",
"oneOf": [
{
"description": "Canonical TOML-key path string.",
"type": "string"
},
{
"additionalProperties": false,
"description": "Structural path object accepted as input.",
"properties": {
"parts": {
"items": {
"minLength": 1,
"type": "string"
},
"minItems": 0,
"type": "array"
},
"root": {
"enum": [
"input",
"state",
"context"
],
"type": "string"
}
},
"required": [
"root",
"parts"
],
"type": "object"
}
]
}
},
"required": [
"path"
],
"type": "object"
},
"ReducerInventoryPayload": {
"description": "Serializable pure-reducer contract owned by one capability source.",
"properties": {
"config_schema": {
"$ref": "#/components/schemas/JsonObject"
},
"description": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"name": {
"type": "string"
},
"ref": {
"$ref": "#/components/schemas/CapabilityRefPayload"
}
},
"required": [
"name",
"ref",
"description",
"config_schema"
],
"type": "object"
},
"RegistryEntryMutationResult": {
"description": "Desired source entry returned after add, update, or enablement changes.",
"properties": {
"entry": {
"$ref": "#/components/schemas/RegistryEntryPayload"
},
"shadowed_by_config": {
"type": "boolean"
}
},
"required": [
"entry",
"shadowed_by_config"
],
"type": "object"
},
"RegistryEntryPayload": {
"additionalProperties": true,
"description": "Desired source entry with provider-specific configuration preserved.",
"properties": {
"account": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"auth_ref": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"enabled": {
"type": "boolean"
},
"id": {
"type": "string"
},
"kind": {
"type": "string"
},
"metadata": {
"$ref": "#/components/schemas/JsonObject"
},
"profile": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"provider": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"transport": {
"anyOf": [
{
"$ref": "#/components/schemas/JsonObject"
},
{
"type": "null"
}
]
}
},
"required": [
"id",
"kind",
"enabled"
],
"type": "object"
},
"RegistryEntrySummaryPayload": {
"description": "Compact desired-source row including config precedence facts.",
"properties": {
"account": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"auth_ref": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"config_ownership": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"enabled": {
"type": "boolean"
},
"id": {
"type": "string"
},
"kind": {
"type": "string"
},
"mutable": {
"type": "boolean"
},
"profile": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"provider": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"shadowed_by_config": {
"type": "boolean"
},
"transport_kind": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"id",
"kind",
"enabled",
"provider",
"account",
"profile",
"transport_kind",
"auth_ref",
"shadowed_by_config",
"config_ownership",
"mutable"
],
"type": "object"
},
"RemoveRegistryEntryResult": {
"description": "Outcome of removing one desired source registry entry.",
"properties": {
"removed": {
"type": "boolean"
},
"source_id": {
"type": "string"
}
},
"required": [
"removed",
"source_id"
],
"type": "object"
},
"RequiredCapabilityPayload": {
"description": "Saved dependency contract for one artifact capability reference.",
"properties": {
"input_schema_hash": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"input_schema_snapshot": {
"anyOf": [
{
"$ref": "#/components/schemas/JsonObject"
},
{
"type": "null"
}
]
},
"kind": {
"$ref": "#/components/schemas/CapabilityKindPayload"
},
"observed_at_epoch_ms": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
]
},
"observed_concrete_source": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"output_schema_hash": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"output_schema_snapshot": {
"anyOf": [
{
"$ref": "#/components/schemas/JsonObject"
},
{
"type": "null"
}
]
},
"ref": {
"$ref": "#/components/schemas/CapabilityRefPayload"
}
},
"required": [
"ref",
"kind",
"input_schema_hash",
"input_schema_snapshot",
"output_schema_hash",
"output_schema_snapshot",
"observed_concrete_source",
"observed_at_epoch_ms"
],
"type": "object"
},
"ResumeReadiness": {
"type": "string"
},
"RouteSourceParams": {
"additionalProperties": false,
"properties": {
"outcome": {
"default": "ok",
"minLength": 1,
"type": "string"
},
"step_id": {
"minLength": 1,
"type": "string"
}
},
"required": [
"step_id"
],
"type": "object"
},
"RunResult": {
"description": "Run operation result with an optional caller-requested trace slice.",
"properties": {
"artifact_id": {
"type": "string"
},
"artifact_version": {
"type": "integer"
},
"deployment_id": {
"type": "string"
},
"diagnostics": {
"items": {
"$ref": "#/components/schemas/DependencyDiagnosticPayload"
},
"type": "array"
},
"error": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"interrupt": {
"anyOf": [
{
"$ref": "#/components/schemas/InterruptPayload"
},
{
"type": "null"
}
]
},
"next_actions": {
"$ref": "#/components/schemas/NextActionsPayload"
},
"outcome": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"output": {
"anyOf": [
{
"$ref": "#/components/schemas/JsonObject"
},
{
"type": "null"
}
]
},
"resume_readiness": {
"anyOf": [
{
"$ref": "#/components/schemas/ResumeReadiness"
},
{
"type": "null"
}
]
},
"run_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"status": {
"$ref": "#/components/schemas/RunStatus"
},
"trace": {
"items": {
"$ref": "#/components/schemas/TraceEntryPayload"
},
"type": "array"
},
"trace_count": {
"type": "integer"
},
"trace_limit": {
"type": "integer"
},
"trace_start": {
"type": "integer"
},
"trace_truncated": {
"type": "boolean"
}
},
"required": [
"artifact_id",
"artifact_version",
"diagnostics",
"next_actions",
"deployment_id",
"status",
"run_id",
"resume_readiness",
"interrupt",
"outcome",
"error",
"output",
"trace_count"
],
"type": "object"
},
"RunStatus": {
"type": "string"
},
"RunSummary": {
"properties": {
"artifact_id": {
"type": "string"
},
"artifact_version": {
"type": "integer"
},
"created_at": {
"type": "string"
},
"deployment_id": {
"type": "string"
},
"diagnostic_count": {
"type": "integer"
},
"resume_readiness": {
"$ref": "#/components/schemas/ResumeReadiness"
},
"run_id": {
"type": "string"
},
"status": {
"$ref": "#/components/schemas/RunStatus"
},
"updated_at": {
"type": "string"
}
},
"required": [
"artifact_id",
"artifact_version",
"run_id",
"deployment_id",
"status",
"resume_readiness",
"diagnostic_count",
"created_at",
"updated_at"
],
"type": "object"
},
"RunTraceResult": {
"description": "Run result where a bounded trace slice is always present.",
"properties": {
"artifact_id": {
"type": "string"
},
"artifact_version": {
"type": "integer"
},
"deployment_id": {
"type": "string"
},
"diagnostics": {
"items": {
"$ref": "#/components/schemas/DependencyDiagnosticPayload"
},
"type": "array"
},
"error": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"interrupt": {
"anyOf": [
{
"$ref": "#/components/schemas/InterruptPayload"
},
{
"type": "null"
}
]
},
"next_actions": {
"$ref": "#/components/schemas/NextActionsPayload"
},
"outcome": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"output": {
"anyOf": [
{
"$ref": "#/components/schemas/JsonObject"
},
{
"type": "null"
}
]
},
"resume_readiness": {
"anyOf": [
{
"$ref": "#/components/schemas/ResumeReadiness"
},
{
"type": "null"
}
]
},
"run_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"status": {
"$ref": "#/components/schemas/RunStatus"
},
"trace": {
"items": {
"$ref": "#/components/schemas/TraceEntryPayload"
},
"type": "array"
},
"trace_count": {
"type": "integer"
},
"trace_limit": {
"type": "integer"
},
"trace_start": {
"type": "integer"
},
"trace_truncated": {
"type": "boolean"
}
},
"required": [
"artifact_id",
"artifact_version",
"diagnostics",
"next_actions",
"deployment_id",
"status",
"run_id",
"resume_readiness",
"interrupt",
"outcome",
"error",
"output",
"trace_count",
"trace",
"trace_start",
"trace_limit",
"trace_truncated"
],
"type": "object"
},
"SaveArtifactResult": {
"properties": {
"artifact_id": {
"type": "string"
},
"saved": {
"type": "boolean"
},
"version": {
"type": "integer"
}
},
"required": [
"artifact_id",
"version",
"saved"
],
"type": "object"
},
"SaveDeploymentResult": {
"properties": {
"artifact_id": {
"type": "string"
},
"artifact_version": {
"type": "integer"
},
"deployment_id": {
"type": "string"
},
"saved": {
"type": "boolean"
}
},
"required": [
"artifact_id",
"artifact_version",
"deployment_id",
"saved"
],
"type": "object"
},
"SavedDraftArtifactResult": {
"description": "Saved artifact result with source-binding guidance derived from a draft.",
"properties": {
"artifact_id": {
"type": "string"
},
"required_logical_sources": {
"items": {
"type": "string"
},
"type": "array"
},
"saved": {
"const": true,
"type": "boolean"
},
"suggested_bindings": {
"additionalProperties": {
"type": "string"
},
"type": "object"
},
"version": {
"type": "integer"
}
},
"required": [
"artifact_id",
"version",
"saved",
"required_logical_sources",
"suggested_bindings"
],
"type": "object"
},
"SchemaRef": {
"additionalProperties": true,
"description": "JSON Schema object used at workflow and node boundaries.",
"properties": {
"properties": {
"additionalProperties": true,
"type": "object"
},
"required": {
"items": {
"type": "string"
},
"type": "array"
},
"title": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null
},
"type": {
"anyOf": [
{
"type": "string"
},
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null
}
},
"type": "object"
},
"SourceAuthDiagnosisPayload": {
"additionalProperties": true,
"description": "Known auth-health fields reported by a diagnostics provider.",
"properties": {
"auth_ref": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"record_present": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
]
},
"scheme": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"transport_supported": {
"type": "boolean"
}
},
"type": "object"
},
"SourceBindingPayload": {
"description": "JSON projection of a logical-to-concrete deployment source binding.",
"properties": {
"concrete_source": {
"type": "string"
},
"logical_source": {
"type": "string"
}
},
"required": [
"logical_source",
"concrete_source"
],
"type": "object"
},
"SourceCapabilityHasMorePayload": {
"description": "Whether each compact capability preview omitted owned names.",
"properties": {
"node_specs": {
"type": "boolean"
},
"prompts": {
"type": "boolean"
},
"reducers": {
"type": "boolean"
},
"resources": {
"type": "boolean"
},
"tools": {
"type": "boolean"
}
},
"required": [
"tools",
"node_specs",
"reducers",
"prompts",
"resources"
],
"type": "object"
},
"SourceCapabilityInventoryPayload": {
"description": "Capability names and detailed executable contracts owned by a source.",
"properties": {
"node_spec_details": {
"items": {
"$ref": "#/components/schemas/NodeSpecInventoryPayload"
},
"type": "array"
},
"node_specs": {
"items": {
"type": "string"
},
"type": "array"
},
"prompts": {
"items": {
"type": "string"
},
"type": "array"
},
"reducer_details": {
"items": {
"$ref": "#/components/schemas/ReducerInventoryPayload"
},
"type": "array"
},
"reducers": {
"items": {
"type": "string"
},
"type": "array"
},
"resources": {
"items": {
"type": "string"
},
"type": "array"
},
"tools": {
"items": {
"type": "string"
},
"type": "array"
}
},
"required": [
"tools",
"node_specs",
"node_spec_details",
"reducers",
"reducer_details",
"prompts",
"resources"
],
"type": "object"
},
"SourceCapabilityPreviewPayload": {
"description": "Small sorted capability-name sample used by compact source rows.",
"properties": {
"node_specs": {
"items": {
"type": "string"
},
"type": "array"
},
"prompts": {
"items": {
"type": "string"
},
"type": "array"
},
"reducers": {
"items": {
"type": "string"
},
"type": "array"
},
"resources": {
"items": {
"type": "string"
},
"type": "array"
},
"tools": {
"items": {
"type": "string"
},
"type": "array"
}
},
"required": [
"tools",
"node_specs",
"reducers",
"prompts",
"resources"
],
"type": "object"
},
"SourceCatalogDiagnosisPayload": {
"additionalProperties": true,
"description": "Known catalog-health fields reported by a diagnostics provider.",
"properties": {
"fetched_at_epoch_ms": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
]
},
"has_snapshot": {
"type": "boolean"
},
"max_age_seconds": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
]
},
"node_count": {
"type": "integer"
},
"prompt_count": {
"type": "integer"
},
"resource_count": {
"type": "integer"
}
},
"type": "object"
},
"SourceDiagnosisResult": {
"additionalProperties": true,
"description": "Stable source-diagnostics envelope with provider-specific extensions.",
"properties": {
"auth": {
"$ref": "#/components/schemas/SourceAuthDiagnosisPayload"
},
"catalog": {
"$ref": "#/components/schemas/SourceCatalogDiagnosisPayload"
},
"diagnostics": {
"items": {
"$ref": "#/components/schemas/DependencyDiagnosticPayload"
},
"type": "array"
},
"enabled": {
"type": "boolean"
},
"message": {
"type": "string"
},
"source_id": {
"type": "string"
},
"status": {
"type": "string"
},
"transport": {
"$ref": "#/components/schemas/SourceTransportDiagnosisPayload"
}
},
"required": [
"source_id",
"status",
"diagnostics"
],
"type": "object"
},
"SourceDiagnosticsUnavailablePayload": {
"description": "Fallback embedded in inspect results when diagnostics collection fails.",
"properties": {
"message": {
"type": "string"
},
"status": {
"const": "error",
"type": "string"
}
},
"required": [
"status",
"message"
],
"type": "object"
},
"SourcePermissionsPayload": {
"description": "JSON projection of source permission flags.",
"properties": {
"calls_upstream": {
"type": "boolean"
},
"mutates_auth": {
"type": "boolean"
},
"mutates_config": {
"type": "boolean"
},
"safe_for_workflow": {
"type": "boolean"
}
},
"required": [
"safe_for_workflow",
"calls_upstream",
"mutates_config",
"mutates_auth"
],
"type": "object"
},
"SourcePolicyPayload": {
"description": "JSON projection of deployment-binding policy for one source.",
"properties": {
"binding_required": {
"type": "boolean"
},
"platform": {
"type": "boolean"
}
},
"required": [
"platform",
"binding_required"
],
"type": "object"
},
"SourceStatusPayload": {
"description": "Compact source metadata returned by source discovery.",
"properties": {
"description": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"enabled": {
"type": "boolean"
},
"has_more": {
"$ref": "#/components/schemas/SourceCapabilityHasMorePayload"
},
"id": {
"type": "string"
},
"kind": {
"enum": [
"system",
"connection",
"python"
],
"type": "string"
},
"node_spec_count": {
"type": "integer"
},
"permissions": {
"$ref": "#/components/schemas/SourcePermissionsPayload"
},
"policy": {
"$ref": "#/components/schemas/SourcePolicyPayload"
},
"preview": {
"$ref": "#/components/schemas/SourceCapabilityPreviewPayload"
},
"prompt_count": {
"type": "integer"
},
"reducer_count": {
"type": "integer"
},
"resource_count": {
"type": "integer"
},
"tool_count": {
"type": "integer"
},
"visibility": {
"$ref": "#/components/schemas/SourceVisibilityPayload"
}
},
"required": [
"id",
"kind",
"enabled",
"visibility",
"permissions",
"policy",
"description",
"tool_count",
"node_spec_count",
"reducer_count",
"prompt_count",
"resource_count",
"preview",
"has_more"
],
"type": "object"
},
"SourceTransportDiagnosisPayload": {
"additionalProperties": true,
"description": "Known transport-health fields reported by a diagnostics provider.",
"properties": {
"configured": {
"type": "boolean"
},
"kind": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"type": "object"
},
"SourceVisibilityPayload": {
"description": "JSON projection of source visibility flags.",
"properties": {
"admin_dashboard": {
"type": "boolean"
},
"client": {
"type": "boolean"
},
"planner": {
"type": "boolean"
}
},
"required": [
"planner",
"client",
"admin_dashboard"
],
"type": "object"
},
"StepInputBinding": {
"anyOf": [
{
"$ref": "#/components/schemas/InputPathBinding"
},
{
"$ref": "#/components/schemas/InputValueBinding"
},
{
"$ref": "#/components/schemas/InputExpressionBinding"
}
]
},
"TraceEntryPayload": {
"properties": {
"frame_id": {
"type": "string"
},
"next_node_id": {
"type": "string"
},
"node_id": {
"type": "string"
},
"outcome": {
"type": "string"
},
"output": {
"$ref": "#/components/schemas/JsonObject"
},
"resolved_input": {
"$ref": "#/components/schemas/JsonObject"
},
"state_changes": {
"$ref": "#/components/schemas/JsonObject"
},
"step_type": {
"type": "string"
}
},
"required": [
"frame_id",
"node_id",
"step_type",
"resolved_input",
"outcome",
"next_node_id",
"output",
"state_changes"
],
"type": "object"
},
"TraceRangeParams": {
"additionalProperties": false,
"properties": {
"limit": {
"default": 20,
"description": "Maximum trace entries to return; full traces are never implicit.",
"maximum": 100,
"minimum": 1,
"type": "integer"
},
"start": {
"default": 0,
"description": "Zero-based trace offset.",
"minimum": 0,
"type": "integer"
}
},
"type": "object"
},
"UnsavedDraftArtifactResult": {
"description": "Validation result when an invalid workspace is not saved as an artifact.",
"properties": {
"diagnostics": {
"items": {
"$ref": "#/components/schemas/DraftDiagnosticPayload"
},
"type": "array"
},
"revision": {
"type": "integer"
},
"saved": {
"const": false,
"type": "boolean"
},
"status": {
"const": "invalid",
"type": "string"
},
"workspace_id": {
"type": "string"
}
},
"required": [
"saved",
"workspace_id",
"revision",
"status",
"diagnostics"
],
"type": "object"
},
"ValidDraftResult": {
"description": "Successful validation of one stateless draft document.",
"properties": {
"compiled_plan": {
"$ref": "#/components/schemas/JsonObject"
},
"diagnostics": {
"items": {
"$ref": "#/components/schemas/DraftDiagnosticPayload"
},
"type": "array"
},
"status": {
"const": "valid",
"type": "string"
}
},
"required": [
"status",
"diagnostics",
"compiled_plan"
],
"type": "object"
},
"ValidateArtifactPlanResult": {
"description": "Non-persisting artifact-plan validation and dependency inventory.",
"properties": {
"diagnostics": {
"items": {
"$ref": "#/components/schemas/ArtifactPlanDiagnosticPayload"
},
"type": "array"
},
"required_capabilities": {
"items": {
"$ref": "#/components/schemas/RequiredCapabilityPayload"
},
"type": "array"
},
"status": {
"enum": [
"valid",
"invalid"
],
"type": "string"
},
"workflow_dependencies": {
"additionalProperties": {
"type": "integer"
},
"type": "object"
}
},
"required": [
"status",
"diagnostics",
"required_capabilities",
"workflow_dependencies"
],
"type": "object"
},
"ValidateDeploymentResult": {
"properties": {
"artifact_id": {
"type": "string"
},
"artifact_version": {
"type": "integer"
},
"deployment_id": {
"type": "string"
},
"diagnostics": {
"items": {
"$ref": "#/components/schemas/DependencyDiagnosticPayload"
},
"type": "array"
},
"next_actions": {
"$ref": "#/components/schemas/NextActionsPayload"
},
"status": {
"enum": [
"runnable",
"unrunnable"
],
"type": "string"
}
},
"required": [
"artifact_id",
"artifact_version",
"diagnostics",
"next_actions",
"deployment_id",
"status"
],
"type": "object"
},
"ValidateDraftResult": {
"anyOf": [
{
"$ref": "#/components/schemas/ValidDraftResult"
},
{
"$ref": "#/components/schemas/InvalidDraftResult"
}
]
},
"VariadicCondition": {
"description": "Condition that combines one or more child conditions.",
"properties": {
"args": {
"items": {
"discriminator": {
"mapping": {
"and": "#/components/schemas/VariadicCondition",
"eq": "#/components/schemas/BinaryCondition",
"exists": "#/components/schemas/ExistsCondition",
"ge": "#/components/schemas/BinaryCondition",
"gt": "#/components/schemas/BinaryCondition",
"le": "#/components/schemas/BinaryCondition",
"lt": "#/components/schemas/BinaryCondition",
"ne": "#/components/schemas/BinaryCondition",
"not": "#/components/schemas/NotCondition",
"or": "#/components/schemas/VariadicCondition"
},
"propertyName": "op"
},
"oneOf": [
{
"$ref": "#/components/schemas/ExistsCondition"
},
{
"$ref": "#/components/schemas/NotCondition"
},
{
"$ref": "#/components/schemas/VariadicCondition"
},
{
"$ref": "#/components/schemas/BinaryCondition"
}
]
},
"minItems": 1,
"type": "array"
},
"op": {
"enum": [
"and",
"or"
],
"type": "string"
}
},
"required": [
"op",
"args"
],
"type": "object"
},
"WorkflowArtifactPayload": {
"description": "Normalized immutable artifact returned by inspect operations.",
"properties": {
"created_from_catalog_version": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"description": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"id": {
"type": "string"
},
"input_schema": {
"$ref": "#/components/schemas/JsonObject"
},
"kind": {
"$ref": "#/components/schemas/ArtifactKindPayload"
},
"outcomes": {
"items": {
"type": "string"
},
"type": "array"
},
"output_schema": {
"$ref": "#/components/schemas/JsonObject"
},
"plan": {
"$ref": "#/components/schemas/JsonObject"
},
"required_capabilities": {
"items": {
"$ref": "#/components/schemas/RequiredCapabilityPayload"
},
"type": "array"
},
"title": {
"type": "string"
},
"version": {
"type": "integer"
},
"workflow_dependencies": {
"additionalProperties": {
"type": "integer"
},
"type": "object"
}
},
"required": [
"id",
"version",
"title",
"kind",
"description",
"input_schema",
"output_schema",
"outcomes",
"plan",
"required_capabilities",
"workflow_dependencies",
"created_from_catalog_version"
],
"type": "object"
},
"WorkflowDeploymentPayload": {
"description": "Serialized deployment accepted and returned by workflow API surfaces.",
"properties": {
"artifact_id": {
"type": "string"
},
"artifact_version": {
"type": "integer"
},
"bindings": {
"items": {
"$ref": "#/components/schemas/SourceBindingPayload"
},
"type": "array"
},
"drift_policy": {
"type": "string"
},
"id": {
"type": "string"
}
},
"required": [
"artifact_id",
"artifact_version",
"id",
"bindings",
"drift_policy"
],
"type": "object"
},
"WorkflowRef": {
"additionalProperties": false,
"description": "Structural reference to a child workflow contract.\n\nCore needs a workflow reference for graph shape and validation, but it must\nnot depend on artifact stores or MCP capability naming. Saved workflow\nartifacts can use ``artifact_id`` plus ``version``; local compiled workflows\ncan use ``name``. Legacy strings parse as ``name`` unless they use the old\n``workflow.<artifact>.v<version>`` display format.",
"properties": {
"artifact_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Saved workflow artifact id, when referencing an immutable artifact."
},
"name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Local workflow registry name."
},
"version": {
"anyOf": [
{
"minimum": 1,
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Saved workflow artifact version. Requires artifact_id."
}
},
"type": "object"
},
"WorkflowRefPayload": {
"properties": {
"artifact_id": {
"type": "string"
},
"name": {
"type": "string"
},
"version": {
"type": "integer"
}
},
"type": "object"
},
"WrapperArtifactCapabilityDetail": {
"description": "Full callable contract for one saved wrapper artifact.",
"properties": {
"artifact_id": {
"type": "string"
},
"description": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"input_schema": {
"$ref": "#/components/schemas/JsonObject"
},
"is_async": {
"type": "boolean"
},
"kind": {
"const": "wrapper_artifact",
"type": "string"
},
"name": {
"type": "string"
},
"outcomes": {
"items": {
"type": "string"
},
"type": "array"
},
"output_schema": {
"$ref": "#/components/schemas/JsonObject"
},
"required_capabilities": {
"additionalProperties": {
"$ref": "#/components/schemas/RequiredCapabilityPayload"
},
"type": "object"
},
"source_id": {
"type": "string"
},
"title": {
"type": "string"
},
"version": {
"type": "integer"
},
"wrapper_hints": {
"$ref": "#/components/schemas/WrapperAuthoringHintsPayload"
}
},
"required": [
"name",
"source_id",
"description",
"outcomes",
"is_async",
"input_schema",
"output_schema",
"wrapper_hints",
"kind",
"artifact_id",
"version",
"title",
"required_capabilities"
],
"type": "object"
},
"WrapperArtifactCapabilitySummary": {
"description": "Compact discovery row for one saved wrapper artifact.",
"properties": {
"artifact_id": {
"type": "string"
},
"description": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"input_fields": {
"items": {
"type": "string"
},
"type": "array"
},
"is_async": {
"type": "boolean"
},
"kind": {
"const": "wrapper_artifact",
"type": "string"
},
"name": {
"type": "string"
},
"outcomes": {
"items": {
"type": "string"
},
"type": "array"
},
"output_fields": {
"items": {
"type": "string"
},
"type": "array"
},
"source_id": {
"type": "string"
},
"title": {
"type": "string"
},
"version": {
"type": "integer"
}
},
"required": [
"name",
"source_id",
"description",
"outcomes",
"is_async",
"input_fields",
"output_fields",
"kind",
"artifact_id",
"version",
"title"
],
"type": "object"
},
"WrapperAuthoringHintsPayload": {
"description": "Transport-neutral projection of conservative wrapper scaffolding hints.",
"properties": {
"capability_name": {
"type": "string"
},
"confidence": {
"enum": [
"high",
"medium",
"low"
],
"type": "string"
},
"declared_outcomes": {
"items": {
"type": "string"
},
"type": "array"
},
"input_map": {
"additionalProperties": {
"type": "string"
},
"type": "object"
},
"input_schema": {
"$ref": "#/components/schemas/JsonObject"
},
"missing_decisions": {
"items": {
"$ref": "#/components/schemas/WrapperMissingDecisionPayload"
},
"type": "array"
},
"notes": {
"items": {
"type": "string"
},
"type": "array"
},
"outcome_candidates": {
"items": {
"$ref": "#/components/schemas/WrapperOutcomeCandidatePayload"
},
"type": "array"
},
"outcome_policy": {
"enum": [
"preserve_declared",
"manual_mapping_required"
],
"type": "string"
},
"output_map": {
"additionalProperties": {
"type": "string"
},
"type": "object"
},
"output_schema": {
"$ref": "#/components/schemas/JsonObject"
},
"state_schema": {
"$ref": "#/components/schemas/JsonObject"
},
"suggested_wrapper_outcomes": {
"items": {
"type": "string"
},
"type": "array"
}
},
"required": [
"capability_name",
"confidence",
"declared_outcomes",
"suggested_wrapper_outcomes",
"outcome_policy",
"input_schema",
"state_schema",
"output_schema",
"input_map",
"output_map",
"outcome_candidates",
"missing_decisions",
"notes"
],
"type": "object"
},
"WrapperMissingDecisionPayload": {
"description": "One unresolved wrapper-authoring decision.",
"properties": {
"kind": {
"enum": [
"choose_output_fields",
"review_nested_output",
"confirm_boolean_outcomes",
"choose_error_mapping"
],
"type": "string"
},
"message": {
"type": "string"
}
},
"required": [
"kind",
"message"
],
"type": "object"
},
"WrapperOutcomeCandidatePayload": {
"description": "Possible wrapper outcome mapping that still requires caller judgment.",
"properties": {
"automatic": {
"type": "boolean"
},
"candidate_outcomes": {
"items": {
"type": "string"
},
"type": "array"
},
"confidence": {
"enum": [
"high",
"medium",
"low"
],
"type": "string"
},
"kind": {
"const": "boolean_control_field",
"type": "string"
},
"reason": {
"type": "string"
},
"source": {
"type": "string"
}
},
"required": [
"kind",
"source",
"candidate_outcomes",
"confidence",
"reason",
"automatic"
],
"type": "object"
}
}
},
"manifest_version": 1,
"operations": [
{
"action": "delete",
"errors": [
{
"$ref": "#/components/errors/5000"
}
],
"method": "workflow.admin.auth.delete",
"namespace": [
"workflow",
"admin",
"auth"
],
"params": [
{
"name": "auth_ref",
"required": true,
"schema": {
"minLength": 1,
"type": "string"
}
}
],
"result": {
"schema": {
"$ref": "#/components/schemas/DeleteAuthRecordResult"
}
}
},
{
"action": "inspect",
"errors": [
{
"$ref": "#/components/errors/5000"
}
],
"method": "workflow.admin.auth.inspect",
"namespace": [
"workflow",
"admin",
"auth"
],
"params": [
{
"name": "auth_ref",
"required": true,
"schema": {
"minLength": 1,
"type": "string"
}
}
],
"result": {
"schema": {
"$ref": "#/components/schemas/AuthRecordSummaryPayload"
}
}
},
{
"action": "list",
"errors": [
{
"$ref": "#/components/errors/5000"
}
],
"method": "workflow.admin.auth.list",
"namespace": [
"workflow",
"admin",
"auth"
],
"params": [],
"result": {
"schema": {
"$ref": "#/components/schemas/ListAuthRecordsResult"
}
}
},
{
"action": "save",
"errors": [
{
"$ref": "#/components/errors/5000"
}
],
"method": "workflow.admin.auth.save",
"namespace": [
"workflow",
"admin",
"auth"
],
"params": [
{
"name": "auth_ref",
"required": true,
"schema": {
"minLength": 1,
"type": "string"
}
},
{
"name": "scheme",
"required": true,
"schema": {
"minLength": 1,
"type": "string"
}
},
{
"name": "payload",
"required": false,
"schema": {
"additionalProperties": true,
"type": "object"
}
},
{
"name": "metadata",
"required": false,
"schema": {
"additionalProperties": true,
"type": "object"
}
}
],
"result": {
"schema": {
"$ref": "#/components/schemas/AuthRecordSummaryPayload"
}
}
},
{
"action": "list",
"errors": [
{
"$ref": "#/components/errors/5000"
}
],
"method": "workflow.admin.connection_statuses.list",
"namespace": [
"workflow",
"admin",
"connection_statuses"
],
"params": [],
"result": {
"schema": {
"$ref": "#/components/schemas/ListConnectionStatusesResult"
}
}
},
{
"action": "list",
"errors": [
{
"$ref": "#/components/errors/5000"
}
],
"method": "workflow.admin.connections.list",
"namespace": [
"workflow",
"admin",
"connections"
],
"params": [],
"result": {
"schema": {
"$ref": "#/components/schemas/ListConnectionsResult"
}
}
},
{
"action": "list",
"errors": [
{
"$ref": "#/components/errors/5000"
}
],
"method": "workflow.admin.events.list",
"namespace": [
"workflow",
"admin",
"events"
],
"params": [],
"result": {
"schema": {
"$ref": "#/components/schemas/ListAdminEventsResult"
}
}
},
{
"action": "add",
"errors": [
{
"$ref": "#/components/errors/5000"
}
],
"method": "workflow.admin.source_registry.add",
"namespace": [
"workflow",
"admin",
"source_registry"
],
"params": [
{
"name": "entry",
"required": true,
"schema": {
"additionalProperties": true,
"type": "object"
}
}
],
"result": {
"schema": {
"$ref": "#/components/schemas/RegistryEntryMutationResult"
}
}
},
{
"action": "apply",
"errors": [
{
"$ref": "#/components/errors/5000"
}
],
"method": "workflow.admin.source_registry.apply",
"namespace": [
"workflow",
"admin",
"source_registry"
],
"params": [],
"result": {
"schema": {
"$ref": "#/components/schemas/ApplyRegistryChangesResult"
}
}
},
{
"action": "disable",
"errors": [
{
"$ref": "#/components/errors/5000"
}
],
"method": "workflow.admin.source_registry.disable",
"namespace": [
"workflow",
"admin",
"source_registry"
],
"params": [
{
"name": "source_id",
"required": true,
"schema": {
"minLength": 1,
"type": "string"
}
}
],
"result": {
"schema": {
"$ref": "#/components/schemas/RegistryEntryMutationResult"
}
}
},
{
"action": "enable",
"errors": [
{
"$ref": "#/components/errors/5000"
}
],
"method": "workflow.admin.source_registry.enable",
"namespace": [
"workflow",
"admin",
"source_registry"
],
"params": [
{
"name": "source_id",
"required": true,
"schema": {
"minLength": 1,
"type": "string"
}
}
],
"result": {
"schema": {
"$ref": "#/components/schemas/RegistryEntryMutationResult"
}
}
},
{
"action": "inspect",
"errors": [
{
"$ref": "#/components/errors/5000"
}
],
"method": "workflow.admin.source_registry.inspect",
"namespace": [
"workflow",
"admin",
"source_registry"
],
"params": [
{
"name": "source_id",
"required": true,
"schema": {
"minLength": 1,
"type": "string"
}
}
],
"result": {
"schema": {
"$ref": "#/components/schemas/InspectRegistryEntryResult"
}
}
},
{
"action": "list",
"errors": [
{
"$ref": "#/components/errors/5000"
}
],
"method": "workflow.admin.source_registry.list",
"namespace": [
"workflow",
"admin",
"source_registry"
],
"params": [
{
"name": "cursor",
"required": false,
"schema": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null
}
},
{
"name": "limit",
"required": false,
"schema": {
"default": 50,
"maximum": 100,
"minimum": 1,
"type": "integer"
}
}
],
"result": {
"schema": {
"$ref": "#/components/schemas/ListRegistryEntriesResult"
}
}
},
{
"action": "remove",
"errors": [
{
"$ref": "#/components/errors/5000"
}
],
"method": "workflow.admin.source_registry.remove",
"namespace": [
"workflow",
"admin",
"source_registry"
],
"params": [
{
"name": "source_id",
"required": true,
"schema": {
"minLength": 1,
"type": "string"
}
}
],
"result": {
"schema": {
"$ref": "#/components/schemas/RemoveRegistryEntryResult"
}
}
},
{
"action": "update",
"errors": [
{
"$ref": "#/components/errors/5000"
}
],
"method": "workflow.admin.source_registry.update",
"namespace": [
"workflow",
"admin",
"source_registry"
],
"params": [
{
"name": "source_id",
"required": true,
"schema": {
"minLength": 1,
"type": "string"
}
},
{
"name": "patch",
"required": true,
"schema": {
"additionalProperties": true,
"type": "object"
}
}
],
"result": {
"schema": {
"$ref": "#/components/schemas/RegistryEntryMutationResult"
}
}
},
{
"action": "create_from_plan",
"errors": [
{
"$ref": "#/components/errors/5000"
}
],
"method": "workflow.artifacts.create_from_plan",
"namespace": [
"workflow",
"artifacts"
],
"params": [
{
"name": "artifact_id",
"required": true,
"schema": {
"minLength": 1,
"type": "string"
}
},
{
"name": "version",
"required": true,
"schema": {
"minimum": 1,
"type": "integer"
}
},
{
"name": "title",
"required": true,
"schema": {
"minLength": 1,
"type": "string"
}
},
{
"name": "plan",
"required": true,
"schema": {
"additionalProperties": true,
"type": "object"
}
},
{
"name": "outcomes",
"required": true,
"schema": {
"items": {
"type": "string"
},
"type": "array"
}
},
{
"name": "kind",
"required": false,
"schema": {
"default": "workflow",
"enum": [
"workflow",
"wrapper"
],
"type": "string"
}
},
{
"name": "description",
"required": false,
"schema": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null
}
},
{
"name": "required_capabilities",
"required": false,
"schema": {
"anyOf": [
{
"additionalProperties": {
"additionalProperties": true,
"type": "object"
},
"type": "object"
},
{
"type": "null"
}
],
"default": null
}
},
{
"name": "source_bindings",
"required": false,
"schema": {
"anyOf": [
{
"additionalProperties": {
"type": "string"
},
"type": "object"
},
{
"type": "null"
}
],
"default": null
}
},
{
"name": "created_from_catalog_version",
"required": false,
"schema": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null
}
}
],
"result": {
"schema": {
"$ref": "#/components/schemas/SaveArtifactResult"
}
}
},
{
"action": "delete",
"errors": [
{
"$ref": "#/components/errors/5000"
}
],
"method": "workflow.artifacts.delete",
"namespace": [
"workflow",
"artifacts"
],
"params": [
{
"name": "artifact_id",
"required": true,
"schema": {
"minLength": 1,
"type": "string"
}
},
{
"name": "version",
"required": true,
"schema": {
"minimum": 1,
"type": "integer"
}
}
],
"result": {
"schema": {
"$ref": "#/components/schemas/DeleteArtifactResult"
}
}
},
{
"action": "inspect",
"errors": [
{
"$ref": "#/components/errors/5000"
}
],
"method": "workflow.artifacts.inspect",
"namespace": [
"workflow",
"artifacts"
],
"params": [
{
"name": "artifact_id",
"required": true,
"schema": {
"minLength": 1,
"type": "string"
}
},
{
"name": "version",
"required": true,
"schema": {
"minimum": 1,
"type": "integer"
}
}
],
"result": {
"schema": {
"$ref": "#/components/schemas/WorkflowArtifactPayload"
}
}
},
{
"action": "list",
"errors": [
{
"$ref": "#/components/errors/5000"
}
],
"method": "workflow.artifacts.list",
"namespace": [
"workflow",
"artifacts"
],
"params": [
{
"name": "query",
"required": false,
"schema": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null
}
},
{
"name": "kind",
"required": false,
"schema": {
"anyOf": [
{
"enum": [
"workflow",
"wrapper"
],
"type": "string"
},
{
"type": "null"
}
],
"default": null
}
},
{
"name": "cursor",
"required": false,
"schema": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null
}
},
{
"name": "limit",
"required": false,
"schema": {
"default": 50,
"maximum": 100,
"minimum": 1,
"type": "integer"
}
}
],
"result": {
"schema": {
"$ref": "#/components/schemas/ListArtifactsResult"
}
}
},
{
"action": "save",
"errors": [
{
"$ref": "#/components/errors/5000"
}
],
"method": "workflow.artifacts.save",
"namespace": [
"workflow",
"artifacts"
],
"params": [
{
"name": "artifact",
"required": true,
"schema": {
"additionalProperties": true,
"type": "object"
}
}
],
"result": {
"schema": {
"$ref": "#/components/schemas/SaveArtifactResult"
}
}
},
{
"action": "validate_plan",
"errors": [
{
"$ref": "#/components/errors/5000"
}
],
"method": "workflow.artifacts.validate_plan",
"namespace": [
"workflow",
"artifacts"
],
"params": [
{
"name": "plan",
"required": true,
"schema": {
"additionalProperties": true,
"type": "object"
}
},
{
"name": "outcomes",
"required": true,
"schema": {
"items": {
"type": "string"
},
"type": "array"
}
},
{
"name": "required_capabilities",
"required": false,
"schema": {
"anyOf": [
{
"additionalProperties": {
"additionalProperties": true,
"type": "object"
},
"type": "object"
},
{
"type": "null"
}
],
"default": null
}
},
{
"name": "source_bindings",
"required": false,
"schema": {
"anyOf": [
{
"additionalProperties": {
"type": "string"
},
"type": "object"
},
{
"type": "null"
}
],
"default": null
}
}
],
"result": {
"schema": {
"$ref": "#/components/schemas/ValidateArtifactPlanResult"
}
}
},
{
"action": "call",
"errors": [
{
"$ref": "#/components/errors/5000"
}
],
"method": "workflow.capabilities.call",
"namespace": [
"workflow",
"capabilities"
],
"params": [
{
"name": "qualified_name",
"required": true,
"schema": {
"minLength": 1,
"type": "string"
}
},
{
"name": "payload",
"required": false,
"schema": {
"additionalProperties": true,
"type": "object"
}
},
{
"name": "deployment_id",
"required": false,
"schema": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null
}
}
],
"result": {
"schema": {
"$ref": "#/components/schemas/CapabilityCallResult"
}
}
},
{
"action": "inspect",
"errors": [
{
"$ref": "#/components/errors/5000"
}
],
"method": "workflow.capabilities.inspect",
"namespace": [
"workflow",
"capabilities"
],
"params": [
{
"name": "qualified_name",
"required": true,
"schema": {
"minLength": 1,
"type": "string"
}
}
],
"result": {
"schema": {
"$ref": "#/components/schemas/InspectCapabilityResult"
}
}
},
{
"action": "list",
"errors": [
{
"$ref": "#/components/errors/5000"
}
],
"method": "workflow.capabilities.list",
"namespace": [
"workflow",
"capabilities"
],
"params": [
{
"name": "query",
"required": false,
"schema": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null
}
},
{
"name": "source_id",
"required": false,
"schema": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null
}
},
{
"name": "cursor",
"required": false,
"schema": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null
}
},
{
"name": "limit",
"required": false,
"schema": {
"default": 50,
"maximum": 200,
"minimum": 1,
"type": "integer"
}
}
],
"result": {
"schema": {
"$ref": "#/components/schemas/ListCapabilitiesResult"
}
}
},
{
"action": "delete",
"errors": [
{
"$ref": "#/components/errors/5000"
}
],
"method": "workflow.deployments.delete",
"namespace": [
"workflow",
"deployments"
],
"params": [
{
"name": "deployment_id",
"required": true,
"schema": {
"minLength": 1,
"type": "string"
}
}
],
"result": {
"schema": {
"$ref": "#/components/schemas/DeleteDeploymentResult"
}
}
},
{
"action": "inspect",
"errors": [
{
"$ref": "#/components/errors/5000"
}
],
"method": "workflow.deployments.inspect",
"namespace": [
"workflow",
"deployments"
],
"params": [
{
"name": "deployment_id",
"required": true,
"schema": {
"minLength": 1,
"type": "string"
}
}
],
"result": {
"schema": {
"$ref": "#/components/schemas/WorkflowDeploymentPayload"
}
}
},
{
"action": "list",
"errors": [
{
"$ref": "#/components/errors/5000"
}
],
"method": "workflow.deployments.list",
"namespace": [
"workflow",
"deployments"
],
"params": [],
"result": {
"schema": {
"$ref": "#/components/schemas/ListDeploymentsResult"
}
}
},
{
"action": "save",
"errors": [
{
"$ref": "#/components/errors/5000"
}
],
"method": "workflow.deployments.save",
"namespace": [
"workflow",
"deployments"
],
"params": [
{
"name": "deployment",
"required": true,
"schema": {
"additionalProperties": true,
"type": "object"
}
}
],
"result": {
"schema": {
"$ref": "#/components/schemas/SaveDeploymentResult"
}
}
},
{
"action": "validate",
"errors": [
{
"$ref": "#/components/errors/5000"
}
],
"method": "workflow.deployments.validate",
"namespace": [
"workflow",
"deployments"
],
"params": [
{
"name": "deployment_id",
"required": true,
"schema": {
"minLength": 1,
"type": "string"
}
},
{
"name": "live_check",
"required": false,
"schema": {
"default": false,
"type": "boolean"
}
}
],
"result": {
"schema": {
"$ref": "#/components/schemas/ValidateDeploymentResult"
}
}
},
{
"action": "add_step",
"errors": [
{
"$ref": "#/components/errors/5000"
}
],
"method": "workflow.draft_workspaces.add_step",
"namespace": [
"workflow",
"draft_workspaces"
],
"params": [
{
"name": "workspace_id",
"required": true,
"schema": {
"minLength": 1,
"type": "string"
}
},
{
"name": "revision",
"required": true,
"schema": {
"minimum": 1,
"type": "integer"
}
},
{
"name": "step_id",
"required": true,
"schema": {
"minLength": 1,
"type": "string"
}
},
{
"name": "step",
"required": true,
"schema": {
"anyOf": [
{
"$ref": "#/components/schemas/DraftUseStep"
},
{
"$ref": "#/components/schemas/DraftForeachStep"
},
{
"$ref": "#/components/schemas/DraftInterruptStep"
},
{
"$ref": "#/components/schemas/DraftEndStep"
},
{
"$ref": "#/components/schemas/DraftWhenStep"
},
{
"$ref": "#/components/schemas/DraftChooseStep"
},
{
"$ref": "#/components/schemas/DraftMatchStep"
},
{
"$ref": "#/components/schemas/DraftSubgraphStep"
}
]
}
},
{
"name": "incoming",
"required": false,
"schema": {
"anyOf": [
{
"$ref": "#/components/schemas/RouteSourceParams"
},
{
"type": "null"
}
],
"default": null
}
},
{
"name": "routes",
"required": false,
"schema": {
"anyOf": [
{
"additionalProperties": {
"type": "string"
},
"type": "object"
},
{
"type": "null"
}
],
"default": null
}
}
],
"result": {
"schema": {
"$ref": "#/components/schemas/DraftWorkspaceResult"
}
}
},
{
"action": "add_step_from_capability",
"errors": [
{
"$ref": "#/components/errors/5000"
}
],
"method": "workflow.draft_workspaces.add_step_from_capability",
"namespace": [
"workflow",
"draft_workspaces"
],
"params": [
{
"name": "workspace_id",
"required": true,
"schema": {
"minLength": 1,
"type": "string"
}
},
{
"name": "revision",
"required": true,
"schema": {
"minimum": 1,
"type": "integer"
}
},
{
"name": "step_id",
"required": true,
"schema": {
"minLength": 1,
"type": "string"
}
},
{
"name": "capability_name",
"required": true,
"schema": {
"minLength": 1,
"type": "string"
}
},
{
"name": "route_from_step",
"required": false,
"schema": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null
}
},
{
"name": "route_from_outcome",
"required": false,
"schema": {
"default": "ok",
"minLength": 1,
"type": "string"
}
},
{
"name": "routes",
"required": false,
"schema": {
"anyOf": [
{
"additionalProperties": {
"type": "string"
},
"type": "object"
},
{
"type": "null"
}
],
"default": null
}
},
{
"name": "input_map",
"required": false,
"schema": {
"anyOf": [
{
"additionalProperties": {
"type": "string"
},
"type": "object"
},
{
"type": "null"
}
],
"default": null
}
},
{
"name": "input_bindings",
"required": false,
"schema": {
"anyOf": [
{
"items": {
"$ref": "#/components/schemas/StepInputBinding"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null
}
},
{
"name": "bind_outputs",
"required": false,
"schema": {
"additionalProperties": {
"type": "string"
},
"type": "object"
}
},
{
"name": "desc",
"required": false,
"schema": {
"anyOf": [
{
"minLength": 1,
"type": "string"
},
{
"type": "null"
}
],
"default": null
}
},
{
"name": "retry",
"required": false,
"schema": {
"anyOf": [
{
"minimum": 0,
"type": "integer"
},
{
"type": "null"
}
],
"default": null
}
},
{
"name": "timeout_seconds",
"required": false,
"schema": {
"anyOf": [
{
"exclusiveMinimum": 0,
"type": "integer"
},
{
"type": "null"
}
],
"default": null
}
}
],
"result": {
"schema": {
"$ref": "#/components/schemas/DraftWorkspaceResult"
}
}
},
{
"action": "bind",
"errors": [
{
"$ref": "#/components/errors/5000"
}
],
"method": "workflow.draft_workspaces.bind",
"namespace": [
"workflow",
"draft_workspaces"
],
"params": [
{
"name": "workspace_id",
"required": true,
"schema": {
"minLength": 1,
"type": "string"
}
},
{
"name": "revision",
"required": true,
"schema": {
"minimum": 1,
"type": "integer"
}
},
{
"name": "step_id",
"required": true,
"schema": {
"minLength": 1,
"type": "string"
}
},
{
"name": "source_path",
"required": true,
"schema": {
"minLength": 1,
"type": "string"
}
},
{
"name": "target_path",
"required": true,
"schema": {
"minLength": 1,
"type": "string"
}
}
],
"result": {
"schema": {
"$ref": "#/components/schemas/DraftWorkspaceResult"
}
}
},
{
"action": "branch",
"errors": [
{
"$ref": "#/components/errors/5000"
}
],
"method": "workflow.draft_workspaces.branch",
"namespace": [
"workflow",
"draft_workspaces"
],
"params": [
{
"name": "workspace_id",
"required": true,
"schema": {
"minLength": 1,
"type": "string"
}
},
{
"name": "revision",
"required": true,
"schema": {
"minimum": 1,
"type": "integer"
}
},
{
"name": "step_id",
"required": true,
"schema": {
"minLength": 1,
"type": "string"
}
},
{
"name": "routes",
"required": true,
"schema": {
"additionalProperties": {
"type": "string"
},
"type": "object"
}
}
],
"result": {
"schema": {
"$ref": "#/components/schemas/DraftWorkspaceResult"
}
}
},
{
"action": "compile",
"errors": [
{
"$ref": "#/components/errors/5000"
}
],
"method": "workflow.draft_workspaces.compile",
"namespace": [
"workflow",
"draft_workspaces"
],
"params": [
{
"name": "workspace_id",
"required": true,
"schema": {
"minLength": 1,
"type": "string"
}
}
],
"result": {
"schema": {
"$ref": "#/components/schemas/CompileDraftWorkspaceResult"
}
}
},
{
"action": "create_artifact",
"errors": [
{
"$ref": "#/components/errors/5000"
}
],
"method": "workflow.draft_workspaces.create_artifact",
"namespace": [
"workflow",
"draft_workspaces"
],
"params": [
{
"name": "workspace_id",
"required": true,
"schema": {
"minLength": 1,
"type": "string"
}
},
{
"name": "artifact_id",
"required": true,
"schema": {
"minLength": 1,
"type": "string"
}
},
{
"name": "version",
"required": true,
"schema": {
"minimum": 1,
"type": "integer"
}
},
{
"name": "title",
"required": true,
"schema": {
"minLength": 1,
"type": "string"
}
},
{
"name": "outcomes",
"required": true,
"schema": {
"items": {
"type": "string"
},
"type": "array"
}
},
{
"name": "kind",
"required": false,
"schema": {
"default": "workflow",
"enum": [
"workflow",
"wrapper"
],
"type": "string"
}
},
{
"name": "description",
"required": false,
"schema": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null
}
},
{
"name": "required_capabilities",
"required": false,
"schema": {
"anyOf": [
{
"additionalProperties": {
"additionalProperties": true,
"type": "object"
},
"type": "object"
},
{
"type": "null"
}
],
"default": null
}
},
{
"name": "source_bindings",
"required": false,
"schema": {
"anyOf": [
{
"additionalProperties": {
"type": "string"
},
"type": "object"
},
{
"type": "null"
}
],
"default": null
}
},
{
"name": "created_from_catalog_version",
"required": false,
"schema": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null
}
}
],
"result": {
"schema": {
"$ref": "#/components/schemas/CreateArtifactFromWorkspaceResult"
}
}
},
{
"action": "create_empty",
"errors": [
{
"$ref": "#/components/errors/5000"
}
],
"method": "workflow.draft_workspaces.create_empty",
"namespace": [
"workflow",
"draft_workspaces"
],
"params": [
{
"name": "workspace_id",
"required": true,
"schema": {
"minLength": 1,
"type": "string"
}
},
{
"name": "name",
"required": true,
"schema": {
"minLength": 1,
"type": "string"
}
},
{
"name": "title",
"required": false,
"schema": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null
}
},
{
"name": "input_schema",
"required": false,
"schema": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"default": null
}
},
{
"name": "state_schema",
"required": false,
"schema": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"default": null
}
},
{
"name": "output_schema",
"required": false,
"schema": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"default": null
}
},
{
"name": "outcomes",
"required": false,
"schema": {
"items": {
"type": "string"
},
"type": "array"
}
}
],
"result": {
"schema": {
"$ref": "#/components/schemas/DraftWorkspaceResult"
}
}
},
{
"action": "create_from_capability",
"errors": [
{
"$ref": "#/components/errors/5000"
}
],
"method": "workflow.draft_workspaces.create_from_capability",
"namespace": [
"workflow",
"draft_workspaces"
],
"params": [
{
"name": "workspace_id",
"required": true,
"schema": {
"minLength": 1,
"type": "string"
}
},
{
"name": "capability_name",
"required": true,
"schema": {
"minLength": 1,
"type": "string"
}
},
{
"name": "name",
"required": false,
"schema": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null
}
},
{
"name": "title",
"required": false,
"schema": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null
}
},
{
"name": "input_schema",
"required": false,
"schema": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"default": null
}
},
{
"name": "state_schema",
"required": false,
"schema": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"default": null
}
},
{
"name": "output_schema",
"required": false,
"schema": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"default": null
}
},
{
"name": "input",
"required": false,
"schema": {
"anyOf": [
{
"items": {
"$ref": "#/components/schemas/StepInputBinding"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null
}
},
{
"name": "output",
"required": false,
"schema": {
"anyOf": [
{
"items": {
"$ref": "#/components/schemas/OutputBinding"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null
}
},
{
"name": "input_map",
"required": false,
"schema": {
"anyOf": [
{
"additionalProperties": {
"type": "string"
},
"type": "object"
},
{
"type": "null"
}
],
"default": null
}
},
{
"name": "output_map",
"required": false,
"schema": {
"anyOf": [
{
"additionalProperties": {
"type": "string"
},
"type": "object"
},
{
"type": "null"
}
],
"default": null
}
},
{
"name": "error_message_source",
"required": false,
"schema": {
"anyOf": [
{},
{
"type": "null"
}
],
"default": null
}
}
],
"result": {
"schema": {
"$ref": "#/components/schemas/CreateDraftWorkspaceFromCapabilityResult"
}
}
},
{
"action": "create_wrapper",
"errors": [
{
"$ref": "#/components/errors/5000"
}
],
"method": "workflow.draft_workspaces.create_wrapper",
"namespace": [
"workflow",
"draft_workspaces"
],
"params": [
{
"name": "workspace_id",
"required": true,
"schema": {
"minLength": 1,
"type": "string"
}
},
{
"name": "artifact_id",
"required": true,
"schema": {
"minLength": 1,
"type": "string"
}
},
{
"name": "version",
"required": true,
"schema": {
"minimum": 1,
"type": "integer"
}
},
{
"name": "title",
"required": true,
"schema": {
"minLength": 1,
"type": "string"
}
},
{
"name": "outcomes",
"required": true,
"schema": {
"items": {
"type": "string"
},
"type": "array"
}
},
{
"name": "description",
"required": false,
"schema": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null
}
},
{
"name": "required_capabilities",
"required": false,
"schema": {
"anyOf": [
{
"additionalProperties": {
"additionalProperties": true,
"type": "object"
},
"type": "object"
},
{
"type": "null"
}
],
"default": null
}
},
{
"name": "source_bindings",
"required": false,
"schema": {
"anyOf": [
{
"additionalProperties": {
"type": "string"
},
"type": "object"
},
{
"type": "null"
}
],
"default": null
}
},
{
"name": "created_from_catalog_version",
"required": false,
"schema": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null
}
}
],
"result": {
"schema": {
"$ref": "#/components/schemas/CreateArtifactFromWorkspaceResult"
}
}
},
{
"action": "delete",
"errors": [
{
"$ref": "#/components/errors/5000"
}
],
"method": "workflow.draft_workspaces.delete",
"namespace": [
"workflow",
"draft_workspaces"
],
"params": [
{
"name": "workspace_id",
"required": true,
"schema": {
"minLength": 1,
"type": "string"
}
}
],
"result": {
"schema": {
"$ref": "#/components/schemas/DeleteDraftWorkspaceResult"
}
}
},
{
"action": "get",
"errors": [
{
"$ref": "#/components/errors/5000"
}
],
"method": "workflow.draft_workspaces.get",
"namespace": [
"workflow",
"draft_workspaces"
],
"params": [
{
"name": "workspace_id",
"required": true,
"schema": {
"minLength": 1,
"type": "string"
}
},
{
"name": "include_draft",
"required": false,
"schema": {
"default": false,
"type": "boolean"
}
}
],
"result": {
"schema": {
"$ref": "#/components/schemas/DraftWorkspaceResult"
}
}
},
{
"action": "handle",
"errors": [
{
"$ref": "#/components/errors/5000"
}
],
"method": "workflow.draft_workspaces.handle",
"namespace": [
"workflow",
"draft_workspaces"
],
"params": [
{
"name": "workspace_id",
"required": true,
"schema": {
"minLength": 1,
"type": "string"
}
},
{
"name": "revision",
"required": true,
"schema": {
"minimum": 1,
"type": "integer"
}
},
{
"name": "branches",
"required": true,
"schema": {
"items": {
"$ref": "#/components/schemas/HandleDraftBranch"
},
"type": "array"
}
},
{
"name": "target",
"required": true,
"schema": {
"minLength": 1,
"type": "string"
}
}
],
"result": {
"schema": {
"$ref": "#/components/schemas/DraftWorkspaceResult"
}
}
},
{
"action": "inspect_authoring_contract",
"errors": [
{
"$ref": "#/components/errors/5000"
}
],
"method": "workflow.draft_workspaces.inspect_authoring_contract",
"namespace": [
"workflow",
"draft_workspaces"
],
"params": [
{
"name": "workspace_id",
"required": true,
"schema": {
"minLength": 1,
"type": "string"
}
},
{
"name": "revision",
"required": true,
"schema": {
"minimum": 1,
"type": "integer"
}
},
{
"name": "selected_step_id",
"required": false,
"schema": {
"anyOf": [
{
"minLength": 1,
"type": "string"
},
{
"type": "null"
}
],
"default": null
}
}
],
"result": {
"schema": {
"anyOf": [
{
"$ref": "#/components/schemas/AuthoringContractInventoryPayload"
},
{
"$ref": "#/components/schemas/DraftWorkspaceResult"
}
]
}
}
},
{
"action": "list",
"errors": [
{
"$ref": "#/components/errors/5000"
}
],
"method": "workflow.draft_workspaces.list",
"namespace": [
"workflow",
"draft_workspaces"
],
"params": [],
"result": {
"schema": {
"$ref": "#/components/schemas/ListDraftWorkspacesResult"
}
}
},
{
"action": "patch",
"errors": [
{
"$ref": "#/components/errors/5000"
}
],
"method": "workflow.draft_workspaces.patch",
"namespace": [
"workflow",
"draft_workspaces"
],
"params": [
{
"name": "workspace_id",
"required": true,
"schema": {
"minLength": 1,
"type": "string"
}
},
{
"name": "revision",
"required": true,
"schema": {
"minimum": 1,
"type": "integer"
}
},
{
"name": "patch",
"required": true,
"schema": {
"items": {
"additionalProperties": true,
"type": "object"
},
"type": "array"
}
}
],
"result": {
"schema": {
"$ref": "#/components/schemas/DraftWorkspaceResult"
}
}
},
{
"action": "remove_binding",
"errors": [
{
"$ref": "#/components/errors/5000"
}
],
"method": "workflow.draft_workspaces.remove_binding",
"namespace": [
"workflow",
"draft_workspaces"
],
"params": [
{
"name": "workspace_id",
"required": true,
"schema": {
"minLength": 1,
"type": "string"
}
},
{
"name": "revision",
"required": true,
"schema": {
"minimum": 1,
"type": "integer"
}
},
{
"name": "step_id",
"required": true,
"schema": {
"minLength": 1,
"type": "string"
}
},
{
"name": "inputs",
"required": false,
"schema": {
"items": {
"type": "string"
},
"type": "array"
}
},
{
"name": "outputs",
"required": false,
"schema": {
"items": {
"type": "string"
},
"type": "array"
}
}
],
"result": {
"schema": {
"$ref": "#/components/schemas/DraftWorkspaceResult"
}
}
},
{
"action": "remove_route",
"errors": [
{
"$ref": "#/components/errors/5000"
}
],
"method": "workflow.draft_workspaces.remove_route",
"namespace": [
"workflow",
"draft_workspaces"
],
"params": [
{
"name": "workspace_id",
"required": true,
"schema": {
"minLength": 1,
"type": "string"
}
},
{
"name": "revision",
"required": true,
"schema": {
"minimum": 1,
"type": "integer"
}
},
{
"name": "step_id",
"required": true,
"schema": {
"minLength": 1,
"type": "string"
}
},
{
"name": "outcome",
"required": true,
"schema": {
"minLength": 1,
"type": "string"
}
}
],
"result": {
"schema": {
"$ref": "#/components/schemas/DraftWorkspaceResult"
}
}
},
{
"action": "remove_step",
"errors": [
{
"$ref": "#/components/errors/5000"
}
],
"method": "workflow.draft_workspaces.remove_step",
"namespace": [
"workflow",
"draft_workspaces"
],
"params": [
{
"name": "workspace_id",
"required": true,
"schema": {
"minLength": 1,
"type": "string"
}
},
{
"name": "revision",
"required": true,
"schema": {
"minimum": 1,
"type": "integer"
}
},
{
"name": "step_id",
"required": true,
"schema": {
"minLength": 1,
"type": "string"
}
}
],
"result": {
"schema": {
"$ref": "#/components/schemas/DraftWorkspaceResult"
}
}
},
{
"action": "replace_document",
"errors": [
{
"$ref": "#/components/errors/5000"
}
],
"method": "workflow.draft_workspaces.replace_document",
"namespace": [
"workflow",
"draft_workspaces"
],
"params": [
{
"name": "workspace_id",
"required": true,
"schema": {
"minLength": 1,
"type": "string"
}
},
{
"name": "revision",
"required": true,
"schema": {
"minimum": 1,
"type": "integer"
}
},
{
"name": "draft",
"required": true,
"schema": {
"additionalProperties": true,
"type": "object"
}
}
],
"result": {
"schema": {
"$ref": "#/components/schemas/DraftWorkspaceResult"
}
}
},
{
"action": "set_contract",
"errors": [
{
"$ref": "#/components/errors/5000"
}
],
"method": "workflow.draft_workspaces.set_contract",
"namespace": [
"workflow",
"draft_workspaces"
],
"params": [
{
"name": "workspace_id",
"required": true,
"schema": {
"minLength": 1,
"type": "string"
}
},
{
"name": "revision",
"required": true,
"schema": {
"minimum": 1,
"type": "integer"
}
},
{
"name": "input_schema",
"required": false,
"schema": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"default": null
}
},
{
"name": "state_schema",
"required": false,
"schema": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"default": null
}
},
{
"name": "output_schema",
"required": false,
"schema": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"default": null
}
},
{
"name": "outcomes",
"required": false,
"schema": {
"anyOf": [
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null
}
}
],
"result": {
"schema": {
"$ref": "#/components/schemas/DraftWorkspaceResult"
}
}
},
{
"action": "set_name",
"errors": [
{
"$ref": "#/components/errors/5000"
}
],
"method": "workflow.draft_workspaces.set_name",
"namespace": [
"workflow",
"draft_workspaces"
],
"params": [
{
"name": "workspace_id",
"required": true,
"schema": {
"minLength": 1,
"type": "string"
}
},
{
"name": "revision",
"required": true,
"schema": {
"minimum": 1,
"type": "integer"
}
},
{
"name": "name",
"required": true,
"schema": {
"minLength": 1,
"type": "string"
}
}
],
"result": {
"schema": {
"$ref": "#/components/schemas/DraftWorkspaceResult"
}
}
},
{
"action": "set_route",
"errors": [
{
"$ref": "#/components/errors/5000"
}
],
"method": "workflow.draft_workspaces.set_route",
"namespace": [
"workflow",
"draft_workspaces"
],
"params": [
{
"name": "workspace_id",
"required": true,
"schema": {
"minLength": 1,
"type": "string"
}
},
{
"name": "revision",
"required": true,
"schema": {
"minimum": 1,
"type": "integer"
}
},
{
"name": "step_id",
"required": true,
"schema": {
"minLength": 1,
"type": "string"
}
},
{
"name": "outcome",
"required": true,
"schema": {
"minLength": 1,
"type": "string"
}
},
{
"name": "target",
"required": true,
"schema": {
"minLength": 1,
"type": "string"
}
}
],
"result": {
"schema": {
"$ref": "#/components/schemas/DraftWorkspaceResult"
}
}
},
{
"action": "set_start",
"errors": [
{
"$ref": "#/components/errors/5000"
}
],
"method": "workflow.draft_workspaces.set_start",
"namespace": [
"workflow",
"draft_workspaces"
],
"params": [
{
"name": "workspace_id",
"required": true,
"schema": {
"minLength": 1,
"type": "string"
}
},
{
"name": "revision",
"required": true,
"schema": {
"minimum": 1,
"type": "integer"
}
},
{
"name": "step_id",
"required": true,
"schema": {
"minLength": 1,
"type": "string"
}
}
],
"result": {
"schema": {
"$ref": "#/components/schemas/DraftWorkspaceResult"
}
}
},
{
"action": "set_step_input_bindings",
"errors": [
{
"$ref": "#/components/errors/5000"
}
],
"method": "workflow.draft_workspaces.set_step_input_bindings",
"namespace": [
"workflow",
"draft_workspaces"
],
"params": [
{
"name": "workspace_id",
"required": true,
"schema": {
"minLength": 1,
"type": "string"
}
},
{
"name": "revision",
"required": true,
"schema": {
"minimum": 1,
"type": "integer"
}
},
{
"name": "step_id",
"required": true,
"schema": {
"minLength": 1,
"type": "string"
}
},
{
"name": "bindings",
"required": true,
"schema": {
"items": {
"$ref": "#/components/schemas/StepInputBinding"
},
"type": "array"
}
}
],
"result": {
"schema": {
"$ref": "#/components/schemas/DraftWorkspaceResult"
}
}
},
{
"action": "set_step_input_map",
"errors": [
{
"$ref": "#/components/errors/5000"
}
],
"method": "workflow.draft_workspaces.set_step_input_map",
"namespace": [
"workflow",
"draft_workspaces"
],
"params": [
{
"name": "workspace_id",
"required": true,
"schema": {
"minLength": 1,
"type": "string"
}
},
{
"name": "revision",
"required": true,
"schema": {
"minimum": 1,
"type": "integer"
}
},
{
"name": "step_id",
"required": true,
"schema": {
"minLength": 1,
"type": "string"
}
},
{
"name": "input_map",
"required": true,
"schema": {
"additionalProperties": {
"type": "string"
},
"type": "object"
}
},
{
"name": "merge",
"required": false,
"schema": {
"default": false,
"type": "boolean"
}
}
],
"result": {
"schema": {
"$ref": "#/components/schemas/DraftWorkspaceResult"
}
}
},
{
"action": "set_step_output_bindings",
"errors": [
{
"$ref": "#/components/errors/5000"
}
],
"method": "workflow.draft_workspaces.set_step_output_bindings",
"namespace": [
"workflow",
"draft_workspaces"
],
"params": [
{
"name": "workspace_id",
"required": true,
"schema": {
"minLength": 1,
"type": "string"
}
},
{
"name": "revision",
"required": true,
"schema": {
"minimum": 1,
"type": "integer"
}
},
{
"name": "step_id",
"required": true,
"schema": {
"minLength": 1,
"type": "string"
}
},
{
"name": "bindings",
"required": true,
"schema": {
"items": {
"$ref": "#/components/schemas/OutputBinding"
},
"type": "array"
}
}
],
"result": {
"schema": {
"$ref": "#/components/schemas/DraftWorkspaceResult"
}
}
},
{
"action": "set_step_output_map",
"errors": [
{
"$ref": "#/components/errors/5000"
}
],
"method": "workflow.draft_workspaces.set_step_output_map",
"namespace": [
"workflow",
"draft_workspaces"
],
"params": [
{
"name": "workspace_id",
"required": true,
"schema": {
"minLength": 1,
"type": "string"
}
},
{
"name": "revision",
"required": true,
"schema": {
"minimum": 1,
"type": "integer"
}
},
{
"name": "step_id",
"required": true,
"schema": {
"minLength": 1,
"type": "string"
}
},
{
"name": "output_map",
"required": true,
"schema": {
"additionalProperties": {
"type": "string"
},
"type": "object"
}
},
{
"name": "merge",
"required": false,
"schema": {
"default": false,
"type": "boolean"
}
}
],
"result": {
"schema": {
"$ref": "#/components/schemas/DraftWorkspaceResult"
}
}
},
{
"action": "set_workflow_output_bindings",
"errors": [
{
"$ref": "#/components/errors/5000"
}
],
"method": "workflow.draft_workspaces.set_workflow_output_bindings",
"namespace": [
"workflow",
"draft_workspaces"
],
"params": [
{
"name": "workspace_id",
"required": true,
"schema": {
"minLength": 1,
"type": "string"
}
},
{
"name": "revision",
"required": true,
"schema": {
"minimum": 1,
"type": "integer"
}
},
{
"name": "bindings",
"required": true,
"schema": {
"items": {
"anyOf": [
{
"$ref": "#/components/schemas/InputPathBinding"
},
{
"$ref": "#/components/schemas/InputValueBinding"
}
],
"description": "Simple canonical binding for node inputs or workflow outputs. Use either a path binding with `path`, or a literal binding with `value`; composite `expression` bindings are node-local only."
},
"type": "array"
}
}
],
"result": {
"schema": {
"$ref": "#/components/schemas/DraftWorkspaceResult"
}
}
},
{
"action": "set_workflow_output_map",
"errors": [
{
"$ref": "#/components/errors/5000"
}
],
"method": "workflow.draft_workspaces.set_workflow_output_map",
"namespace": [
"workflow",
"draft_workspaces"
],
"params": [
{
"name": "workspace_id",
"required": true,
"schema": {
"minLength": 1,
"type": "string"
}
},
{
"name": "revision",
"required": true,
"schema": {
"minimum": 1,
"type": "integer"
}
},
{
"name": "output_map",
"required": true,
"schema": {
"additionalProperties": {
"type": "string"
},
"type": "object"
}
},
{
"name": "merge",
"required": false,
"schema": {
"default": false,
"type": "boolean"
}
}
],
"result": {
"schema": {
"$ref": "#/components/schemas/DraftWorkspaceResult"
}
}
},
{
"action": "update_capability_step",
"errors": [
{
"$ref": "#/components/errors/5000"
}
],
"method": "workflow.draft_workspaces.update_capability_step",
"namespace": [
"workflow",
"draft_workspaces"
],
"params": [
{
"name": "workspace_id",
"required": true,
"schema": {
"minLength": 1,
"type": "string"
}
},
{
"name": "revision",
"required": true,
"schema": {
"minimum": 1,
"type": "integer"
}
},
{
"name": "step_id",
"required": true,
"schema": {
"minLength": 1,
"type": "string"
}
},
{
"name": "update",
"required": true,
"schema": {
"$ref": "#/components/schemas/CapabilityStepUpdate"
}
}
],
"result": {
"schema": {
"$ref": "#/components/schemas/DraftWorkspaceResult"
}
}
},
{
"action": "validate",
"errors": [
{
"$ref": "#/components/errors/5000"
}
],
"method": "workflow.draft_workspaces.validate",
"namespace": [
"workflow",
"draft_workspaces"
],
"params": [
{
"name": "workspace_id",
"required": true,
"schema": {
"minLength": 1,
"type": "string"
}
}
],
"result": {
"schema": {
"$ref": "#/components/schemas/DraftWorkspaceResult"
}
}
},
{
"action": "create_from_capability",
"errors": [
{
"$ref": "#/components/errors/5000"
}
],
"method": "workflow.drafts.create_from_capability",
"namespace": [
"workflow",
"drafts"
],
"params": [
{
"name": "workspace_id",
"required": true,
"schema": {
"minLength": 1,
"type": "string"
}
},
{
"name": "capability_name",
"required": true,
"schema": {
"minLength": 1,
"type": "string"
}
},
{
"name": "name",
"required": false,
"schema": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null
}
},
{
"name": "title",
"required": false,
"schema": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null
}
},
{
"name": "input_schema",
"required": false,
"schema": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"default": null
}
},
{
"name": "state_schema",
"required": false,
"schema": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"default": null
}
},
{
"name": "output_schema",
"required": false,
"schema": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"default": null
}
},
{
"name": "input",
"required": false,
"schema": {
"anyOf": [
{
"items": {
"$ref": "#/components/schemas/StepInputBinding"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null
}
},
{
"name": "output",
"required": false,
"schema": {
"anyOf": [
{
"items": {
"$ref": "#/components/schemas/OutputBinding"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null
}
},
{
"name": "input_map",
"required": false,
"schema": {
"anyOf": [
{
"additionalProperties": {
"type": "string"
},
"type": "object"
},
{
"type": "null"
}
],
"default": null
}
},
{
"name": "output_map",
"required": false,
"schema": {
"anyOf": [
{
"additionalProperties": {
"type": "string"
},
"type": "object"
},
{
"type": "null"
}
],
"default": null
}
},
{
"name": "error_message_source",
"required": false,
"schema": {
"anyOf": [
{},
{
"type": "null"
}
],
"default": null
}
}
],
"result": {
"schema": {
"$ref": "#/components/schemas/CreateDraftWorkspaceFromCapabilityResult"
}
}
},
{
"action": "patch",
"errors": [
{
"$ref": "#/components/errors/5000"
}
],
"method": "workflow.drafts.patch",
"namespace": [
"workflow",
"drafts"
],
"params": [
{
"name": "draft",
"required": true,
"schema": {
"additionalProperties": true,
"type": "object"
}
},
{
"name": "patch",
"required": true,
"schema": {
"items": {
"additionalProperties": true,
"type": "object"
},
"type": "array"
}
}
],
"result": {
"schema": {
"$ref": "#/components/schemas/PatchDraftResult"
}
}
},
{
"action": "validate",
"errors": [
{
"$ref": "#/components/errors/5000"
}
],
"method": "workflow.drafts.validate",
"namespace": [
"workflow",
"drafts"
],
"params": [
{
"name": "draft",
"required": true,
"schema": {
"additionalProperties": true,
"type": "object"
}
}
],
"result": {
"schema": {
"$ref": "#/components/schemas/ValidateDraftResult"
}
}
},
{
"action": "health",
"errors": [
{
"$ref": "#/components/errors/5000"
}
],
"method": "workflow.health",
"namespace": [
"workflow"
],
"params": [],
"result": {
"schema": {
"$ref": "#/components/schemas/HealthResult"
}
}
},
{
"action": "inspect",
"errors": [
{
"$ref": "#/components/errors/5000"
}
],
"method": "workflow.runs.inspect",
"namespace": [
"workflow",
"runs"
],
"params": [
{
"name": "run_id",
"required": true,
"schema": {
"minLength": 1,
"type": "string"
}
}
],
"result": {
"schema": {
"$ref": "#/components/schemas/RunResult"
}
}
},
{
"action": "list",
"errors": [
{
"$ref": "#/components/errors/5000"
}
],
"method": "workflow.runs.list",
"namespace": [
"workflow",
"runs"
],
"params": [
{
"name": "status",
"required": false,
"schema": {
"anyOf": [
{
"enum": [
"completed",
"failed",
"interrupted"
],
"type": "string"
},
{
"type": "null"
}
],
"default": null
}
},
{
"name": "cursor",
"required": false,
"schema": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null
}
},
{
"name": "limit",
"required": false,
"schema": {
"default": 50,
"maximum": 100,
"minimum": 1,
"type": "integer"
}
}
],
"result": {
"schema": {
"$ref": "#/components/schemas/ListRunsResult"
}
}
},
{
"action": "resume",
"errors": [
{
"$ref": "#/components/errors/5000"
}
],
"method": "workflow.runs.resume",
"namespace": [
"workflow",
"runs"
],
"params": [
{
"name": "run_id",
"required": true,
"schema": {
"minLength": 1,
"type": "string"
}
},
{
"name": "resume_payload",
"required": false,
"schema": {
"additionalProperties": true,
"type": "object"
}
},
{
"name": "resume_outcome",
"required": false,
"schema": {
"default": "submitted",
"minLength": 1,
"type": "string"
}
},
{
"name": "trace_range",
"required": false,
"schema": {
"anyOf": [
{
"$ref": "#/components/schemas/TraceRangeParams"
},
{
"type": "null"
}
],
"default": null
}
}
],
"result": {
"schema": {
"$ref": "#/components/schemas/RunResult"
}
}
},
{
"action": "start",
"errors": [
{
"$ref": "#/components/errors/5000"
}
],
"method": "workflow.runs.start",
"namespace": [
"workflow",
"runs"
],
"params": [
{
"name": "deployment_id",
"required": true,
"schema": {
"minLength": 1,
"type": "string"
}
},
{
"name": "workflow_input",
"required": false,
"schema": {
"additionalProperties": true,
"type": "object"
}
},
{
"name": "trace_range",
"required": false,
"schema": {
"anyOf": [
{
"$ref": "#/components/schemas/TraceRangeParams"
},
{
"type": "null"
}
],
"default": null
}
}
],
"result": {
"schema": {
"$ref": "#/components/schemas/RunResult"
}
}
},
{
"action": "trace",
"errors": [
{
"$ref": "#/components/errors/5000"
}
],
"method": "workflow.runs.trace",
"namespace": [
"workflow",
"runs"
],
"params": [
{
"name": "run_id",
"required": true,
"schema": {
"minLength": 1,
"type": "string"
}
},
{
"name": "trace_range",
"required": true,
"schema": {
"$ref": "#/components/schemas/TraceRangeParams"
}
}
],
"result": {
"schema": {
"$ref": "#/components/schemas/RunTraceResult"
}
}
},
{
"action": "diagnose",
"errors": [
{
"$ref": "#/components/errors/5000"
}
],
"method": "workflow.sources.diagnose",
"namespace": [
"workflow",
"sources"
],
"params": [
{
"name": "source_id",
"required": true,
"schema": {
"minLength": 1,
"type": "string"
}
}
],
"result": {
"schema": {
"$ref": "#/components/schemas/SourceDiagnosisResult"
}
}
},
{
"action": "inspect",
"errors": [
{
"$ref": "#/components/errors/5000"
}
],
"method": "workflow.sources.inspect",
"namespace": [
"workflow",
"sources"
],
"params": [
{
"name": "source_id",
"required": true,
"schema": {
"minLength": 1,
"type": "string"
}
}
],
"result": {
"schema": {
"$ref": "#/components/schemas/InspectSourceResult"
}
}
},
{
"action": "list",
"errors": [
{
"$ref": "#/components/errors/5000"
}
],
"method": "workflow.sources.list",
"namespace": [
"workflow",
"sources"
],
"params": [
{
"name": "cursor",
"required": false,
"schema": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null
}
},
{
"name": "limit",
"required": false,
"schema": {
"default": 50,
"maximum": 100,
"minimum": 1,
"type": "integer"
}
}
],
"result": {
"schema": {
"$ref": "#/components/schemas/ListSourcesResult"
}
}
}
],
"source": {
"format": "openrpc",
"openrpc_version": "1.2.6"
}
}