diff --git a/static/platform-protocol-specs/control-plane-api.openapi.yaml b/static/platform-protocol-specs/control-plane-api.openapi.yaml index 8b5ae1ca08..766ed29efc 100644 --- a/static/platform-protocol-specs/control-plane-api.openapi.yaml +++ b/static/platform-protocol-specs/control-plane-api.openapi.yaml @@ -1,7 +1,7 @@ openapi: 3.1.0 info: title: durable-workflow.v2.control-plane-api - version: "11" + version: "12" summary: Durable Workflow control-plane HTTP+JSON API description: > Normative OpenAPI specification for the standalone Durable Workflow @@ -399,6 +399,53 @@ paths: - $ref: "#/components/parameters/WorkflowIdPath" responses: "200": { $ref: "#/components/responses/ControlPlaneEnvelope" } + /workflows/{workflowId}/observation: + get: + tags: [workflows] + operationId: observeWorkflow + description: >- + Bounded run metadata, projected current waits, the first 50 parent and + child links with independent outcomes, and the ten most recent failure + references and a history page of 200 events by default. Does not load child + histories, decode application values or load the cancellation tree. + External payload references remain opaque. The stored current pointer is observed without repair + or canonical command validation. Missing evidence stays unknown. Use the + existing debug API for full inspection. History cursors authenticate the + selected run and preserve the original sequence ceiling. + parameters: + - $ref: "#/components/parameters/ControlPlaneVersionHeader" + - $ref: "#/components/parameters/WorkflowIdPath" + - name: search_attribute_keys + in: query + schema: { type: array, maxItems: 20, items: { type: string, minLength: 1, maxLength: 255 } } + - name: history_page_size + in: query + schema: { type: integer, minimum: 1, maximum: 1000, default: 200 } + - name: history_page_token + in: query + schema: { type: string, maxLength: 4096 } + responses: + "200": { $ref: "#/components/responses/ControlPlaneEnvelope" } + /workflows/{workflowId}/runs/{runId}/observation: + get: + tags: [workflows] + operationId: observeWorkflowRun + description: The same bounded observation for one explicit retained run. + parameters: + - $ref: "#/components/parameters/ControlPlaneVersionHeader" + - $ref: "#/components/parameters/WorkflowIdPath" + - $ref: "#/components/parameters/RunIdPath" + - name: search_attribute_keys + in: query + schema: { type: array, maxItems: 20, items: { type: string, minLength: 1, maxLength: 255 } } + - name: history_page_size + in: query + schema: { type: integer, minimum: 1, maximum: 1000, default: 200 } + - name: history_page_token + in: query + schema: { type: string, maxLength: 4096 } + responses: + "200": { $ref: "#/components/responses/ControlPlaneEnvelope" } /workflows/{workflowId}/debug: get: tags: [workflows] diff --git a/static/stable-releases.json b/static/stable-releases.json index aab13d1b27..0e0ca70d19 100644 --- a/static/stable-releases.json +++ b/static/stable-releases.json @@ -4,11 +4,11 @@ "updated_at": "2026-10-06", "artifacts": { "cli": "2.2.0", - "sdk-php": "2.2.2", + "sdk-php": "2.2.3", "sdk-python": "2.4.0", "sdk-rust": "3.2.0", - "server": "2.5.4", - "waterline": "2.1.0", - "workflow": "2.4.4" + "server": "2.5.5", + "waterline": "2.2.0", + "workflow": "2.4.5" } }