{ "generatedBy": "weft catalog snapshot", "version": 1, "operations": [ { "name": "weft.activities.complete", "kind": "unary", "summary": "Complete a deferred activity by task token", "description": "Resolve an out-of-band (\"async\") activity with a result, resuming its parked workflow as though the activity had returned that result inline. Requires the durable task token announced through the `activity:async-pending` event. Faults with NotFound when the token is unknown or already completed/failed (tokens are single-use), and InvalidParams when the result exceeds the payload size limit. A success response is durable — the completion is persisted before the operation returns, and a crash afterward cannot lose it. A failed call leaves the token completable, so treat storage-side faults as retryable.", "tags": ["Activities"], "destructive": true, "access": { "kind": "scoped", "scopes": ["workflows:write"] }, "transports": { "http": true, "jsonRpcHttp": true, "jsonRpcStdio": true, "jsonRpcWebSocket": true }, "producibleFaults": ["InvalidParams", "NotFound"], "inputSchema": { "additionalProperties": false, "properties": { "result": {}, "token": { "minLength": 1, "type": "string" } }, "required": ["token"], "type": "object" }, "outputSchema": { "additionalProperties": false, "properties": { "ok": { "const": true, "type": "boolean" } }, "required": ["ok"], "type": "object" } }, { "name": "weft.activities.fail", "kind": "unary", "summary": "Fail a deferred activity by task token", "description": "Fail an out-of-band (\"async\") activity, throwing the supplied error into its parked workflow at the deferred step — identical to an inline activity that threw, so the workflow’s own try/catch and retry policy apply unchanged. Requires the durable task token from the `activity:async-pending` event. Faults with NotFound when the token is unknown or already completed/failed (tokens are single-use), and InvalidParams when the failure message exceeds the payload size limit. A success response is durable — the failure outcome is persisted before the operation returns, and a crash afterward cannot lose it. A failed call leaves the token completable, so treat storage-side faults as retryable.", "tags": ["Activities"], "destructive": true, "access": { "kind": "scoped", "scopes": ["workflows:write"] }, "transports": { "http": true, "jsonRpcHttp": true, "jsonRpcStdio": true, "jsonRpcWebSocket": true }, "producibleFaults": ["InvalidParams", "NotFound"], "inputSchema": { "additionalProperties": false, "properties": { "error": { "additionalProperties": false, "properties": { "message": { "type": "string" }, "name": { "type": "string" } }, "required": ["message"], "type": "object" }, "token": { "minLength": 1, "type": "string" } }, "required": ["token", "error"], "type": "object" }, "outputSchema": { "additionalProperties": false, "properties": { "ok": { "const": true, "type": "boolean" } }, "required": ["ok"], "type": "object" } }, { "name": "weft.alerts.list", "kind": "unary", "summary": "List currently firing alerts", "description": "List the alert rules that are currently firing, including their metric, threshold, current value, configured window, and firing timestamp. Read-only and limited to active in-memory alert state; resolved alerts are not returned.", "tags": ["Observability"], "destructive": false, "access": { "kind": "scoped", "scopes": ["system:read"] }, "transports": { "http": true, "jsonRpcHttp": true, "jsonRpcWebSocket": true, "jsonRpcStdio": true }, "producibleFaults": [], "inputSchema": { "additionalProperties": false, "properties": {}, "type": "object" }, "outputSchema": { "additionalProperties": false, "properties": { "items": { "items": { "additionalProperties": false, "properties": { "currentValue": { "type": "number" }, "firedAt": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "metric": { "enum": ["workflow.failure_rate", "activity.p99_duration", "storage.size"], "type": "string" }, "threshold": { "type": "number" }, "window": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": ["metric", "threshold", "currentValue", "window", "firedAt"], "type": "object" }, "type": "array" } }, "required": ["items"], "type": "object" } }, { "name": "weft.catalog.diagnostics", "kind": "unary", "summary": "Get bounded reference-count and removability diagnostics for one workflow revision", "description": "Report whether a `(name, revision)` workflow catalog entry is installed, whether it is currently the active revision, its full reference-count breakdown, and whether it's currently removable. When `name` was ever registered as a dynamic workflow source (`engine.registerSource()`), also reports its bounded load-state diagnostics: source kind, load state, load duration, last failure category, and outstanding waiter count. Never returns manifest or contract content.", "tags": ["Observability"], "destructive": false, "access": { "kind": "scoped", "scopes": ["system:read"] }, "transports": { "http": true, "jsonRpcHttp": true, "jsonRpcWebSocket": true, "jsonRpcStdio": true }, "producibleFaults": [], "inputSchema": { "additionalProperties": false, "properties": { "name": { "minLength": 1, "type": "string" }, "revision": { "minLength": 1, "type": "string" } }, "required": ["name", "revision"], "type": "object" }, "outputSchema": { "additionalProperties": false, "properties": { "active": { "type": "boolean" }, "activeRevision": { "type": "string" }, "installed": { "type": "boolean" }, "name": { "type": "string" }, "references": { "additionalProperties": false, "properties": { "activeExecutionRealms": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "inFlightStarts": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "nonTerminalRuns": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "pendingDispatches": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "pinnedSchedules": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "registeredDefinitions": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "retainedRecoveryRecords": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" } }, "required": [ "registeredDefinitions", "inFlightStarts", "nonTerminalRuns", "pinnedSchedules", "pendingDispatches", "activeExecutionRealms", "retainedRecoveryRecords" ], "type": "object" }, "removable": { "type": "boolean" }, "revision": { "type": "string" }, "source": { "additionalProperties": false, "properties": { "kind": { "const": "module", "type": "string" }, "lastFailureCategory": { "enum": ["application", "timeout", "cancellation", "resource", "system"], "type": "string" }, "loadDurationMs": { "minimum": 0, "type": "number" }, "requestedRevision": { "type": "string" }, "state": { "enum": ["idle", "loading", "ready", "failed", "cancelled"], "type": "string" }, "waiterCount": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" } }, "required": ["kind", "requestedRevision", "state", "waiterCount"], "type": "object" } }, "required": ["name", "revision", "installed", "active", "references", "removable"], "type": "object" } }, { "name": "weft.events.sse", "kind": "stream", "summary": "Stream fleet events as Server-Sent Events", "description": "Streams the server-level event feed across workflows. Optional filters narrow delivery by workflow id or event kind after the single fleet cursor has been applied. The stream emits `ping` keepalives while idle.", "tags": ["Events"], "destructive": false, "access": { "kind": "scoped", "scopes": ["events:read"] }, "transports": { "http": true, "jsonRpcHttp": false, "jsonRpcWebSocket": false, "jsonRpcStdio": false }, "producibleFaults": ["InvalidParams", "UnsupportedTransport"], "inputSchema": { "additionalProperties": false, "properties": { "fromCursor": { "type": "string" }, "kind": { "enum": [ "workflow:started", "workflow:completed", "workflow:failed", "workflow:cancelled", "workflow:timed-out", "workflow:resumed", "workflow:suspended", "workflow:teardown", "activity:started", "activity:completed", "activity:failed", "activity:async-pending", "task:dead-lettered", "signal:received", "signal:delivered", "attributes:changed", "update:received", "update:completed", "schedule:fired", "schedule:missed-fire", "checkpoint:size-warning", "development:warning", "cleanup:warning", "storage:size-reported", "human-review:requested", "human-review:completed", "alert:fired", "alert:resolved", "constraint:violated", "worker:connected", "worker:disconnected" ], "type": "string" }, "lastEventId": { "type": "string" }, "workflowId": { "minLength": 1, "type": "string" } }, "type": "object" }, "outputSchema": {}, "eventSchema": { "anyOf": [ { "additionalProperties": false, "properties": { "cursor": { "type": "string" }, "emittedAtMs": { "type": "number" }, "kind": { "type": "string" }, "payload": {}, "sequence": { "type": "number" }, "workflowId": { "type": "string" } }, "required": ["kind", "sequence", "cursor", "emittedAtMs", "payload"], "type": "object" }, { "additionalProperties": false, "properties": { "cursor": { "type": "string" }, "emittedAtMs": { "type": "number" }, "kind": { "const": "fleet:gap", "type": "string" }, "payload": { "additionalProperties": false, "properties": { "firstRetainedSequence": { "type": "number" }, "requestedCursor": { "type": "string" } }, "required": ["requestedCursor", "firstRetainedSequence"], "type": "object" }, "sequence": { "type": "number" } }, "required": ["kind", "sequence", "cursor", "emittedAtMs", "payload"], "type": "object" } ] } }, { "name": "weft.events.subscribe", "kind": "subscription", "summary": "Subscribe to fleet-wide events with replay-from-cursor", "description": "Subscribes to the server-level event feed across workflows. Optional filters narrow delivery by workflow id or event kind after the single fleet cursor has been applied. Historical replay is capped at 1,000 matching retained events per subscription; use a recent fromCursor for older feeds.", "tags": ["Events"], "destructive": false, "access": { "kind": "scoped", "scopes": ["events:read"] }, "transports": { "http": false, "jsonRpcHttp": false, "jsonRpcWebSocket": true, "jsonRpcStdio": false }, "producibleFaults": ["InvalidParams", "UnsupportedTransport"], "inputSchema": { "additionalProperties": false, "properties": { "fromCursor": { "pattern": "^(?:-1|\\d+)$", "type": "string" }, "kind": { "enum": [ "workflow:started", "workflow:completed", "workflow:failed", "workflow:cancelled", "workflow:timed-out", "workflow:resumed", "workflow:suspended", "workflow:teardown", "activity:started", "activity:completed", "activity:failed", "activity:async-pending", "task:dead-lettered", "signal:received", "signal:delivered", "attributes:changed", "update:received", "update:completed", "schedule:fired", "schedule:missed-fire", "checkpoint:size-warning", "development:warning", "cleanup:warning", "storage:size-reported", "human-review:requested", "human-review:completed", "alert:fired", "alert:resolved", "constraint:violated", "worker:connected", "worker:disconnected" ], "type": "string" }, "workflowId": { "minLength": 1, "type": "string" } }, "type": "object" }, "outputSchema": { "additionalProperties": false, "properties": { "cursor": { "type": "string" }, "subscriptionId": { "type": "string" } }, "required": ["subscriptionId", "cursor"], "type": "object" }, "eventSchema": { "anyOf": [ { "additionalProperties": false, "properties": { "cursor": { "type": "string" }, "emittedAtMs": { "type": "number" }, "kind": { "type": "string" }, "payload": {}, "sequence": { "type": "number" }, "workflowId": { "type": "string" } }, "required": ["kind", "sequence", "cursor", "emittedAtMs", "payload"], "type": "object" }, { "additionalProperties": false, "properties": { "cursor": { "type": "string" }, "emittedAtMs": { "type": "number" }, "kind": { "const": "fleet:gap", "type": "string" }, "payload": { "additionalProperties": false, "properties": { "firstRetainedSequence": { "type": "number" }, "requestedCursor": { "type": "string" } }, "required": ["requestedCursor", "firstRetainedSequence"], "type": "object" }, "sequence": { "type": "number" } }, "required": ["kind", "sequence", "cursor", "emittedAtMs", "payload"], "type": "object" } ] } }, { "name": "weft.recover.all", "kind": "unary", "summary": "Recover all interrupted workflows", "tags": ["System"], "destructive": true, "access": { "kind": "public" }, "transports": { "http": true, "jsonRpcHttp": true, "jsonRpcWebSocket": true, "jsonRpcStdio": true }, "producibleFaults": ["Conflict"], "inputSchema": { "additionalProperties": false, "properties": {}, "type": "object" }, "outputSchema": { "additionalProperties": false, "properties": { "recovered": { "items": { "type": "string" }, "type": "array" } }, "required": ["recovered"], "type": "object" } }, { "name": "weft.retention.get", "kind": "unary", "summary": "Get retention policy overview", "tags": ["System"], "destructive": false, "access": { "kind": "public" }, "transports": { "http": true, "jsonRpcHttp": true, "jsonRpcWebSocket": true, "jsonRpcStdio": true }, "producibleFaults": [], "inputSchema": { "additionalProperties": false, "properties": {}, "type": "object" }, "outputSchema": {} }, { "name": "weft.reviews.decision.submit", "kind": "unary", "summary": "Submit a decision for a human review", "description": "Submit an approve/reject (or option) decision for a pending human review, resuming the waiting workflow down the corresponding branch. The decision is final and cannot be retracted — the same finality as a signal. Faults with NotFound when the review is not visible.", "tags": ["Reviews"], "destructive": true, "access": { "kind": "public" }, "transports": { "http": true, "jsonRpcHttp": true, "jsonRpcWebSocket": true, "jsonRpcStdio": true }, "producibleFaults": ["NotFound"], "inputSchema": { "additionalProperties": false, "properties": { "decision": {}, "feedback": {}, "reviewId": { "minLength": 1, "type": "string" }, "reviewer": {}, "sectionDecisions": {}, "workflowId": {} }, "required": ["reviewId"], "type": "object" }, "outputSchema": { "additionalProperties": false, "properties": { "ok": { "const": true, "type": "boolean" } }, "required": ["ok"], "type": "object" } }, { "name": "weft.reviews.get", "kind": "unary", "summary": "Get a specific review for a workflow", "description": "Read a single human review request for a workflow by its identifiers, including the review prompt, available options, and current decision state. Read-only. Faults with NotFound when the review is not visible.", "tags": ["Reviews"], "destructive": false, "access": { "kind": "public" }, "transports": { "http": true, "jsonRpcHttp": true, "jsonRpcWebSocket": true, "jsonRpcStdio": true }, "producibleFaults": ["NotFound"], "inputSchema": { "additionalProperties": false, "properties": { "reviewId": { "minLength": 1, "type": "string" }, "workflowId": { "minLength": 1, "type": "string" } }, "required": ["workflowId", "reviewId"], "type": "object" }, "outputSchema": {} }, { "name": "weft.reviews.list", "kind": "unary", "summary": "List human review requests", "description": "List pending human-in-the-loop review requests, optionally filtered by workflow. Read-only. Returns each review request with its prompt, options, and originating workflow so an operator or agent can decide on it via the review-decision operation.", "tags": ["Reviews"], "destructive": false, "access": { "kind": "scoped", "scopes": ["reviews:read"] }, "transports": { "http": true, "jsonRpcHttp": true, "jsonRpcWebSocket": true, "jsonRpcStdio": true }, "producibleFaults": [], "inputSchema": { "additionalProperties": false, "properties": { "reviewType": { "minLength": 1, "type": "string" }, "status": { "enum": ["pending", "completed"], "type": "string" }, "workflowId": { "minLength": 1, "type": "string" } }, "type": "object" }, "outputSchema": { "additionalProperties": false, "properties": { "items": { "items": { "anyOf": [ { "additionalProperties": false, "properties": { "allowPartial": { "type": "boolean" }, "artifact": {}, "createdAt": { "type": "number" }, "reviewId": { "type": "string" }, "reviewType": { "type": "string" }, "reviewers": { "items": { "type": "string" }, "type": "array" }, "status": { "const": "pending", "type": "string" }, "timeout": { "type": "number" }, "webhookUrl": { "type": "string" }, "workflowId": { "type": "string" } }, "required": [ "status", "reviewId", "workflowId", "artifact", "reviewType", "reviewers", "allowPartial", "createdAt" ], "type": "object" }, { "additionalProperties": false, "properties": { "allowPartial": { "type": "boolean" }, "artifact": {}, "createdAt": { "type": "number" }, "decision": { "enum": ["approved", "rejected", "needs-changes"], "type": "string" }, "feedback": { "type": "string" }, "reviewId": { "type": "string" }, "reviewType": { "type": "string" }, "reviewer": { "type": "string" }, "reviewers": { "items": { "type": "string" }, "type": "array" }, "sectionDecisions": { "additionalProperties": { "enum": ["approved", "rejected"], "type": "string" }, "propertyNames": { "type": "string" }, "type": "object" }, "status": { "const": "completed", "type": "string" }, "timeout": { "type": "number" }, "timestamp": { "type": "number" }, "webhookUrl": { "type": "string" }, "workflowId": { "type": "string" } }, "required": [ "status", "reviewId", "workflowId", "artifact", "reviewType", "reviewers", "allowPartial", "createdAt", "decision", "reviewer", "timestamp" ], "type": "object" } ] }, "type": "array" } }, "required": ["items"], "type": "object" } }, { "name": "weft.schedules.cancel", "kind": "unary", "summary": "Cancel a recurring schedule", "description": "Permanently cancel a recurring schedule by `scheduleId` so it stops launching new workflows. Irreversible — recreate the schedule to resume the cadence. Already-started workflows are unaffected. Faults with NotFound when no schedule with the given id exists.", "tags": ["Schedules"], "destructive": true, "access": { "kind": "public" }, "transports": { "http": true, "jsonRpcHttp": true, "jsonRpcWebSocket": true, "jsonRpcStdio": true }, "producibleFaults": ["Conflict", "NotFound"], "inputSchema": { "additionalProperties": false, "properties": { "scheduleId": { "minLength": 1, "type": "string" } }, "required": ["scheduleId"], "type": "object" }, "outputSchema": {} }, { "name": "weft.schedules.create", "kind": "unary", "summary": "Create a recurring schedule", "description": "Create a schedule that starts a workflow on a recurring cadence. Requires a schedule `id`, the target workflow `type`, and a recurrence specification (cron expression or interval); accepts the workflow `input` and start options. Returns the created schedule id. Faults with Conflict when a schedule with the same id already exists and InvalidParams for a malformed recurrence specification.", "tags": ["Schedules"], "destructive": false, "access": { "kind": "public" }, "transports": { "http": true, "jsonRpcHttp": true, "jsonRpcWebSocket": true, "jsonRpcStdio": true }, "producibleFaults": ["Conflict", "NotFound"], "inputSchema": { "additionalProperties": false, "properties": { "backfill": {}, "cronExpression": { "description": "Cron expression. Supply exactly one of cronExpression or every; runtime validation requires a non-empty string." }, "description": { "description": "Operator-facing schedule description. Runtime validation requires a string." }, "every": { "description": "Interval period (duration string or milliseconds). Supply exactly one of cronExpression or every." }, "id": {}, "input": {}, "jitter": {}, "overlap": {}, "revisionPolicy": { "description": "Revision policy (WFT-20). Runtime validation requires \"active-at-fire\" or \"pinned\"; defaults to \"active-at-fire\"." }, "type": { "description": "Workflow type name. Runtime validation requires a non-empty string." } }, "required": ["type"], "type": "object" }, "outputSchema": { "additionalProperties": false, "properties": { "id": { "type": "string" } }, "required": ["id"], "type": "object" } }, { "name": "weft.schedules.get", "kind": "unary", "summary": "Get a recurring schedule by id", "description": "Read a single recurring schedule by `id`, including its recurrence specification, target workflow type, paused state, and next-run information. Read-only. Faults with NotFound when no schedule with the given id exists.", "tags": ["Schedules"], "destructive": false, "access": { "kind": "authenticated" }, "transports": { "http": true, "jsonRpcHttp": true, "jsonRpcWebSocket": true, "jsonRpcStdio": true }, "producibleFaults": ["Conflict", "NotFound"], "inputSchema": { "additionalProperties": false, "properties": { "scheduleId": { "minLength": 1, "type": "string" } }, "required": ["scheduleId"], "type": "object" }, "outputSchema": {} }, { "name": "weft.schedules.list", "kind": "unary", "summary": "List recurring schedules", "description": "List recurring schedules with pagination. Read-only. Returns each schedule with its recurrence specification, target workflow type, and paused state.", "tags": ["Schedules"], "destructive": false, "access": { "kind": "authenticated" }, "transports": { "http": true, "jsonRpcHttp": true, "jsonRpcWebSocket": true, "jsonRpcStdio": true }, "producibleFaults": ["Conflict"], "inputSchema": { "additionalProperties": false, "properties": { "limit": {}, "offset": {}, "status": {}, "workflowType": {} }, "type": "object" }, "outputSchema": {} }, { "name": "weft.schedules.pause", "kind": "unary", "summary": "Pause a recurring schedule", "description": "Pause a recurring schedule by `scheduleId` so it stops launching new workflows while retaining its definition. Reversible via resume. Faults with NotFound when no schedule with the given id exists.", "tags": ["Schedules"], "destructive": false, "access": { "kind": "public" }, "transports": { "http": true, "jsonRpcHttp": true, "jsonRpcWebSocket": true, "jsonRpcStdio": true }, "producibleFaults": ["Conflict", "NotFound"], "inputSchema": { "additionalProperties": false, "properties": { "scheduleId": { "minLength": 1, "type": "string" } }, "required": ["scheduleId"], "type": "object" }, "outputSchema": {} }, { "name": "weft.schedules.resume", "kind": "unary", "summary": "Resume a recurring schedule", "description": "Resume a paused recurring schedule by `scheduleId` so it begins launching workflows on its cadence again. Faults with NotFound when no schedule with the given id exists.", "tags": ["Schedules"], "destructive": false, "access": { "kind": "public" }, "transports": { "http": true, "jsonRpcHttp": true, "jsonRpcWebSocket": true, "jsonRpcStdio": true }, "producibleFaults": ["Conflict", "NotFound"], "inputSchema": { "additionalProperties": false, "properties": { "scheduleId": { "minLength": 1, "type": "string" } }, "required": ["scheduleId"], "type": "object" }, "outputSchema": {} }, { "name": "weft.schedules.update", "kind": "unary", "summary": "Update a recurring schedule", "description": "Update an existing recurring schedule by `id`, replacing its recurrence specification and optionally changing description, overlap, backfill, or jitter. Omitted options retain their persisted values; schedule id, workflow type, and input remain unchanged. Returns null on success. Faults with NotFound when no schedule with the given id exists and InvalidParams for malformed fields.", "tags": ["Schedules"], "destructive": false, "access": { "kind": "public" }, "transports": { "http": true, "jsonRpcHttp": true, "jsonRpcWebSocket": true, "jsonRpcStdio": true }, "producibleFaults": ["Conflict", "InvalidParams", "NotFound"], "inputSchema": { "additionalProperties": false, "properties": { "backfill": {}, "cronExpression": { "description": "Cron expression. Supply exactly one of cronExpression or every; runtime validation requires a non-empty string." }, "description": { "description": "Operator-facing schedule description. Runtime validation requires a string." }, "every": { "description": "Interval period (duration string or milliseconds). Supply exactly one of cronExpression or every." }, "jitter": {}, "overlap": {}, "revisionPolicy": { "description": "Revision policy (WFT-20). Runtime validation requires \"active-at-fire\" or \"pinned\". Omitted preserves the current policy (and pin); \"pinned\" always re-resolves and re-captures the pin against the revision active right now." }, "scheduleId": { "minLength": 1, "type": "string" } }, "required": ["scheduleId"], "type": "object" }, "outputSchema": { "type": "null" } }, { "name": "weft.storage.batch", "kind": "unary", "summary": "Apply a raw storage batch", "tags": ["Storage"], "destructive": true, "access": { "kind": "scoped", "scopes": ["storage:admin"] }, "transports": { "http": true, "jsonRpcHttp": false, "jsonRpcStdio": false, "jsonRpcWebSocket": false }, "producibleFaults": [], "inputSchema": { "additionalProperties": false, "properties": { "operations": { "items": { "oneOf": [ { "additionalProperties": false, "properties": { "key": { "minLength": 1, "type": "string" }, "type": { "const": "put", "type": "string" }, "value": { "type": "string" } }, "required": ["type", "key", "value"], "type": "object" }, { "additionalProperties": false, "properties": { "key": { "minLength": 1, "type": "string" }, "type": { "const": "delete", "type": "string" } }, "required": ["type", "key"], "type": "object" } ] }, "maxItems": 10000, "type": "array" } }, "required": ["operations"], "type": "object" }, "outputSchema": { "type": "null" } }, { "name": "weft.storage.capabilities", "kind": "unary", "summary": "Report the connected storage backend's capability profile", "tags": ["Storage"], "destructive": false, "access": { "kind": "scoped", "scopes": ["storage:admin", "storage:read"] }, "transports": { "http": true, "jsonRpcHttp": true, "jsonRpcWebSocket": true, "jsonRpcStdio": true }, "producibleFaults": [], "inputSchema": { "additionalProperties": false, "properties": {}, "type": "object" }, "outputSchema": { "additionalProperties": false, "properties": { "atomicBatch": { "type": "boolean" }, "boundedRangeDelete": { "type": "boolean" }, "conditionalBatch": { "type": "boolean" }, "persistence": { "enum": ["ephemeral", "local", "remote"], "type": "string" }, "readAfterWrite": { "enum": ["linearizable", "session", "eventual"], "type": "string" }, "scanConsistency": { "enum": ["snapshot", "best-effort"], "type": "string" } }, "required": [ "persistence", "readAfterWrite", "scanConsistency", "atomicBatch", "conditionalBatch", "boundedRangeDelete" ], "type": "object" } }, { "name": "weft.storage.conditionalbatch", "kind": "unary", "summary": "Apply a raw storage conditional batch", "tags": ["Storage"], "destructive": true, "access": { "kind": "scoped", "scopes": ["storage:admin"] }, "transports": { "http": true, "jsonRpcHttp": false, "jsonRpcStdio": false, "jsonRpcWebSocket": false }, "producibleFaults": ["NotImplemented"], "inputSchema": { "additionalProperties": false, "properties": { "conditions": { "items": { "additionalProperties": false, "properties": { "expectedValue": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "key": { "minLength": 1, "type": "string" } }, "required": ["key", "expectedValue"], "type": "object" }, "maxItems": 10000, "type": "array" }, "operations": { "items": { "oneOf": [ { "additionalProperties": false, "properties": { "key": { "minLength": 1, "type": "string" }, "type": { "const": "put", "type": "string" }, "value": { "type": "string" } }, "required": ["type", "key", "value"], "type": "object" }, { "additionalProperties": false, "properties": { "key": { "minLength": 1, "type": "string" }, "type": { "const": "delete", "type": "string" } }, "required": ["type", "key"], "type": "object" } ] }, "maxItems": 10000, "type": "array" } }, "required": ["conditions", "operations"], "type": "object" }, "outputSchema": { "additionalProperties": false, "properties": { "applied": { "type": "boolean" } }, "required": ["applied"], "type": "object" } }, { "name": "weft.storage.delete", "kind": "unary", "summary": "Delete a raw storage value", "tags": ["Storage"], "destructive": true, "access": { "kind": "scoped", "scopes": ["storage:admin"] }, "transports": { "http": true, "jsonRpcHttp": false, "jsonRpcStdio": false, "jsonRpcWebSocket": false }, "producibleFaults": [], "inputSchema": { "additionalProperties": false, "properties": { "key": { "minLength": 1, "type": "string" } }, "required": ["key"], "type": "object" }, "outputSchema": { "type": "null" } }, { "name": "weft.storage.get", "kind": "unary", "summary": "Get a raw storage value", "tags": ["Storage"], "destructive": false, "access": { "kind": "scoped", "scopes": ["storage:admin"] }, "transports": { "http": true, "jsonRpcHttp": false, "jsonRpcStdio": false, "jsonRpcWebSocket": false }, "producibleFaults": [], "inputSchema": { "additionalProperties": false, "properties": { "key": { "minLength": 1, "type": "string" } }, "required": ["key"], "type": "object" }, "outputSchema": { "anyOf": [ { "format": "binary", "type": "string" }, { "type": "null" } ] } }, { "name": "weft.storage.put", "kind": "unary", "summary": "Put a raw storage value", "tags": ["Storage"], "destructive": true, "access": { "kind": "scoped", "scopes": ["storage:admin"] }, "transports": { "http": true, "jsonRpcHttp": false, "jsonRpcStdio": false, "jsonRpcWebSocket": false }, "producibleFaults": [], "inputSchema": { "additionalProperties": false, "properties": { "key": { "minLength": 1, "type": "string" }, "value": { "format": "binary", "type": "string" } }, "required": ["key", "value"], "type": "object" }, "outputSchema": { "type": "null" } }, { "name": "weft.storage.scan", "kind": "unary", "summary": "Scan raw storage values", "tags": ["Storage"], "destructive": false, "access": { "kind": "scoped", "scopes": ["storage:admin"] }, "transports": { "http": true, "jsonRpcHttp": false, "jsonRpcStdio": false, "jsonRpcWebSocket": false }, "producibleFaults": [], "inputSchema": { "additionalProperties": false, "properties": { "gt": { "type": "string" }, "gte": { "type": "string" }, "limit": { "exclusiveMinimum": 0, "maximum": 10000, "type": "integer" }, "lt": { "type": "string" }, "lte": { "type": "string" }, "prefix": { "type": "string" }, "reverse": { "type": "boolean" } }, "required": ["prefix"], "type": "object" }, "outputSchema": {} }, { "name": "weft.system.lease", "kind": "unary", "summary": "Get ownership-lease health for this engine process", "description": "Reports whether lease ownership is disabled, not yet held, healthy, or contested. Contested results preserve the confirmed deposed or renewal-unconfirmable reason.", "tags": ["System"], "destructive": false, "access": { "kind": "scoped", "scopes": ["system:read"] }, "transports": { "http": true, "jsonRpcHttp": true, "jsonRpcWebSocket": true, "jsonRpcStdio": true }, "producibleFaults": [], "inputSchema": { "additionalProperties": false, "properties": {}, "type": "object" }, "outputSchema": { "additionalProperties": false, "properties": { "expiresAt": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "fencingEpoch": { "exclusiveMinimum": 0, "maximum": 9007199254740991, "type": "integer" }, "heldSince": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "holderId": { "minLength": 1, "type": "string" }, "holdsLease": { "type": "boolean" }, "lastRenewedAt": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "lossReason": { "enum": ["deposed", "renewal-unconfirmable"], "type": "string" }, "mode": { "enum": ["none", "lease"], "type": "string" }, "status": { "enum": ["disabled", "healthy", "no-lease", "contested"], "type": "string" } }, "required": ["mode", "status", "holdsLease"], "type": "object" } }, { "name": "weft.system.metrics", "kind": "unary", "summary": "Get JSON-shaped system metrics", "tags": ["Observability"], "destructive": false, "access": { "kind": "scoped", "scopes": ["system:read"] }, "transports": { "http": true, "jsonRpcHttp": true, "jsonRpcWebSocket": true, "jsonRpcStdio": true }, "producibleFaults": [], "inputSchema": { "additionalProperties": false, "properties": {}, "type": "object" }, "outputSchema": {} }, { "name": "weft.system.principal", "kind": "unary", "summary": "Report the caller's resolved principal and granted scopes", "description": "Report the caller's own resolved principal: the authentication method ('jwt', 'api-key', 'mtls', 'stdio-local', or 'unauthenticated'), the normalized subject when one exists, and the granted authorization scopes, sorted. Public access: an unauthenticated caller receives method 'unauthenticated' with an empty scope list rather than an error, so clients can distinguish \"no credential\" from \"credential with few scopes\" without probing other operations. Reflects only the request credential — never server auth configuration.", "tags": ["System"], "destructive": false, "access": { "kind": "public" }, "transports": { "http": true, "jsonRpcHttp": true, "jsonRpcWebSocket": true, "jsonRpcStdio": true }, "producibleFaults": [], "inputSchema": { "additionalProperties": false, "properties": {}, "type": "object" }, "outputSchema": { "additionalProperties": false, "properties": { "method": { "enum": ["jwt", "api-key", "mtls", "stdio-local", "unauthenticated"], "type": "string" }, "scopes": { "items": { "enum": [ "workflows:read", "workflows:write", "workflows:admin", "schedules:read", "schedules:write", "signals:write", "updates:write", "queries:read", "reviews:read", "reviews:write", "attributes:read", "attributes:write", "tags:write", "streams:read", "events:read", "storage:read", "storage:write", "storage:admin", "workers:write", "system:read", "system:admin" ], "type": "string" }, "type": "array" }, "subject": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": ["method", "subject", "scopes"], "type": "object" } }, { "name": "weft.system.registry", "kind": "unary", "summary": "Get a snapshot of registered workflows and activities with their JSON Schemas", "tags": ["System"], "destructive": false, "access": { "kind": "scoped", "scopes": ["system:read"] }, "transports": { "http": true, "jsonRpcHttp": true, "jsonRpcWebSocket": true, "jsonRpcStdio": true }, "producibleFaults": [], "inputSchema": { "additionalProperties": false, "properties": {}, "type": "object" }, "outputSchema": { "additionalProperties": false, "properties": { "activeRevisions": {}, "activities": {}, "generatedAt": { "type": "string" }, "registryVersion": { "const": 2, "type": "number" }, "workflows": { "items": {}, "type": "array" } }, "required": [ "registryVersion", "generatedAt", "workflows", "activeRevisions", "activities" ], "type": "object" } }, { "name": "weft.task.queues.list", "kind": "unary", "summary": "List task queues with backlog, waiting pollers, and per-queue saturation", "tags": ["System"], "destructive": false, "access": { "kind": "scoped", "scopes": ["system:read"] }, "transports": { "http": true, "jsonRpcHttp": true, "jsonRpcWebSocket": true, "jsonRpcStdio": true }, "producibleFaults": [], "inputSchema": { "additionalProperties": false, "properties": {}, "type": "object" }, "outputSchema": { "additionalProperties": false, "properties": { "items": { "items": { "additionalProperties": false, "properties": { "backlog": { "type": "number" }, "connectedWorkers": { "type": "number" }, "inFlight": { "type": "number" }, "oldestEnqueuedAt": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "oldestQueuedAgeMs": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "queue": { "type": "string" }, "schedulingPolicy": { "enum": ["priority", "fifo", "lifo"], "type": "string" }, "waitingPollers": { "type": "number" } }, "required": [ "queue", "backlog", "oldestEnqueuedAt", "oldestQueuedAgeMs", "waitingPollers", "schedulingPolicy", "inFlight", "connectedWorkers" ], "type": "object" }, "type": "array" } }, "required": ["items"], "type": "object" } }, { "name": "weft.tasks.diagnostics", "kind": "unary", "summary": "Get bounded task latency and stuck-work diagnostics", "tags": ["Observability"], "destructive": false, "access": { "kind": "scoped", "scopes": ["system:read"] }, "transports": { "http": true, "jsonRpcHttp": true, "jsonRpcWebSocket": true, "jsonRpcStdio": true }, "producibleFaults": [], "inputSchema": { "additionalProperties": false, "properties": { "includeExpectedDelayed": { "default": false, "type": "boolean" }, "limit": { "default": 50, "maximum": 200, "minimum": 1, "type": "integer" }, "operationId": { "minLength": 1, "type": "string" }, "queue": { "minLength": 1, "type": "string" }, "retryStormMinimumAttempts": { "default": 3, "maximum": 9007199254740991, "minimum": 1, "type": "integer" }, "staleHeartbeatAfterMs": { "default": 60000, "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "staleQueuedAfterMs": { "default": 60000, "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "unadoptedAfterMs": { "default": 60000, "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "workflowId": { "minLength": 1, "type": "string" } }, "required": [ "staleQueuedAfterMs", "staleHeartbeatAfterMs", "retryStormMinimumAttempts", "includeExpectedDelayed", "unadoptedAfterMs", "limit" ], "type": "object" }, "outputSchema": { "additionalProperties": false, "properties": { "items": { "items": { "anyOf": [ { "additionalProperties": false, "properties": { "activityName": { "type": "string" }, "deadLetterReason": { "const": "result-resolution-storage-exhausted", "type": "string" }, "deadLetteredAt": { "minimum": 0, "type": "number" }, "evidence": { "items": { "type": "string" }, "type": "array" }, "executionLatencyMs": { "minimum": 0, "type": "number" }, "heartbeatAgeMs": { "minimum": 0, "type": "number" }, "kind": { "enum": [ "stuck-queued", "stale-inflight", "retry-storm", "all-workers-at-capacity", "dead-lettered" ], "type": "string" }, "lastRequeueReason": { "type": "string" }, "operationId": { "type": "string" }, "queue": { "type": "string" }, "queueLatencyMs": { "minimum": 0, "type": "number" }, "requeueCount": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "resolutionReason": { "type": "string" }, "retryAttempts": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "retryCount": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "state": { "enum": ["queued", "inflight", "resolved", "capacity", "dead-lettered"], "type": "string" }, "storageError": { "type": "string" }, "workerId": { "type": "string" }, "workflowId": { "type": "string" } }, "required": ["kind", "state", "retryCount", "requeueCount", "evidence"], "type": "object" }, { "additionalProperties": false, "properties": { "availableAt": { "minimum": 0, "type": "number" }, "evidence": { "items": { "type": "string" }, "type": "array" }, "kind": { "const": "delayed", "type": "string" }, "operationId": { "type": "string" }, "queue": { "type": "string" }, "requeueCount": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "retryCount": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "state": { "const": "queued", "type": "string" }, "workflowId": { "type": "string" } }, "required": [ "kind", "state", "operationId", "queue", "retryCount", "requeueCount", "availableAt", "evidence" ], "type": "object" }, { "additionalProperties": false, "properties": { "adopted": { "const": false, "type": "boolean" }, "evidence": { "items": { "type": "string" }, "type": "array" }, "kind": { "const": "unadopted-terminal", "type": "string" }, "operationId": { "type": "string" }, "queue": { "type": "string" }, "state": { "const": "resolved", "type": "string" }, "terminalAt": { "minimum": 0, "type": "number" }, "workflowId": { "type": "string" } }, "required": [ "kind", "state", "operationId", "queue", "terminalAt", "adopted", "evidence" ], "type": "object" } ] }, "type": "array" }, "limit": { "maximum": 200, "minimum": 1, "type": "integer" }, "summary": { "additionalProperties": false, "properties": { "allWorkersAtCapacity": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "deadLettered": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "delayed": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "retryStorms": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "staleInflight": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "stuckQueued": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "unadoptedTerminal": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" } }, "required": [ "stuckQueued", "staleInflight", "retryStorms", "allWorkersAtCapacity", "deadLettered", "delayed", "unadoptedTerminal" ], "type": "object" } }, "required": ["items", "summary", "limit"], "type": "object" } }, { "name": "weft.tasks.diagnostics.deadletters.clear", "kind": "unary", "summary": "Clear a task-result dead-letter diagnostic entry", "tags": ["Observability"], "destructive": true, "access": { "kind": "scoped", "scopes": ["system:admin"] }, "transports": { "http": true, "jsonRpcHttp": false, "jsonRpcWebSocket": false, "jsonRpcStdio": false }, "producibleFaults": ["NotFound"], "inputSchema": { "additionalProperties": false, "properties": { "operationId": { "minLength": 1, "type": "string" } }, "required": ["operationId"], "type": "object" }, "outputSchema": { "additionalProperties": false, "properties": { "ok": { "const": true, "type": "boolean" } }, "required": ["ok"], "type": "object" }, "rest": { "method": "DELETE", "path": "/v1/tasks/diagnostics/dead-letter/:operationId", "inputSources": { "operationId": { "kind": "path", "pathParam": "operationId" } }, "success": { "kind": "json", "status": 200 } } }, { "name": "weft.tasks.get", "kind": "unary", "summary": "Get one task's full durable ledger state", "tags": ["Observability"], "destructive": false, "access": { "kind": "scoped", "scopes": ["system:read"] }, "transports": { "http": true, "jsonRpcHttp": true, "jsonRpcWebSocket": true, "jsonRpcStdio": true }, "producibleFaults": ["NotFound"], "inputSchema": { "additionalProperties": false, "properties": { "operationId": { "minLength": 1, "type": "string" } }, "required": ["operationId"], "type": "object" }, "outputSchema": { "oneOf": [ { "additionalProperties": false, "properties": { "activityName": { "type": "string" }, "attempt": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "availableAt": { "type": "number" }, "createdAt": { "type": "number" }, "executionRequirement": { "additionalProperties": false, "properties": { "activityContractHash": { "type": "string" }, "artifactDigest": { "type": "string" }, "buildId": { "type": "string" }, "deploymentName": { "type": "string" }, "workflowRevision": { "type": "string" } }, "type": "object" }, "fairShareKey": { "type": "string" }, "firstQueuedAt": { "type": "number" }, "headerKeys": { "items": { "type": "string" }, "type": "array" }, "lastDispatchedAt": { "type": "number" }, "lastQueuedAt": { "type": "number" }, "lastRequeueReason": { "type": "string" }, "operationId": { "type": "string" }, "priority": { "type": "number" }, "queue": { "type": "string" }, "requeueCount": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "retryCount": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "retryPolicy": { "additionalProperties": false, "properties": { "backoffMultiplier": { "type": "number" }, "initialBackoff": { "anyOf": [ { "type": "number" }, { "type": "string" } ] }, "maxAttempts": { "type": "number" }, "maxBackoff": { "anyOf": [ { "type": "number" }, { "type": "string" } ] }, "nonRetryableErrors": { "items": { "type": "string" }, "type": "array" } }, "required": ["maxAttempts", "initialBackoff", "backoffMultiplier", "maxBackoff"], "type": "object" }, "scheduleToCloseDeadline": { "type": "number" }, "startedAt": { "type": "number" }, "state": { "const": "queued", "type": "string" }, "stickyWorkflowId": { "type": "string" }, "visibilityTimeoutMilliseconds": { "type": "number" }, "workflowExecutionToken": { "type": "string" }, "workflowId": { "type": "string" }, "workflowRevision": { "type": "string" }, "workflowType": { "type": "string" } }, "required": [ "operationId", "workflowType", "activityName", "queue", "headerKeys", "visibilityTimeoutMilliseconds", "createdAt", "attempt", "retryCount", "requeueCount", "state", "availableAt", "firstQueuedAt", "lastQueuedAt" ], "type": "object" }, { "additionalProperties": false, "properties": { "activityName": { "type": "string" }, "attempt": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "createdAt": { "type": "number" }, "executionRequirement": { "additionalProperties": false, "properties": { "activityContractHash": { "type": "string" }, "artifactDigest": { "type": "string" }, "buildId": { "type": "string" }, "deploymentName": { "type": "string" }, "workflowRevision": { "type": "string" } }, "type": "object" }, "fairShareKey": { "type": "string" }, "firstQueuedAt": { "type": "number" }, "headerKeys": { "items": { "type": "string" }, "type": "array" }, "lastHeartbeatAt": { "type": "number" }, "lastQueuedAt": { "type": "number" }, "lastRequeueReason": { "type": "string" }, "leaseDeadline": { "type": "number" }, "operationId": { "type": "string" }, "priority": { "type": "number" }, "queue": { "type": "string" }, "requeueCount": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "retryCount": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "retryPolicy": { "additionalProperties": false, "properties": { "backoffMultiplier": { "type": "number" }, "initialBackoff": { "anyOf": [ { "type": "number" }, { "type": "string" } ] }, "maxAttempts": { "type": "number" }, "maxBackoff": { "anyOf": [ { "type": "number" }, { "type": "string" } ] }, "nonRetryableErrors": { "items": { "type": "string" }, "type": "array" } }, "required": ["maxAttempts", "initialBackoff", "backoffMultiplier", "maxBackoff"], "type": "object" }, "scheduleToCloseDeadline": { "type": "number" }, "startedAt": { "type": "number" }, "state": { "const": "leased", "type": "string" }, "stickyWorkflowId": { "type": "string" }, "visibilityTimeoutMilliseconds": { "type": "number" }, "workflowExecutionToken": { "type": "string" }, "workflowId": { "type": "string" }, "workflowRevision": { "type": "string" }, "workflowType": { "type": "string" } }, "required": [ "operationId", "workflowType", "activityName", "queue", "headerKeys", "visibilityTimeoutMilliseconds", "createdAt", "attempt", "retryCount", "requeueCount", "state", "leaseDeadline", "firstQueuedAt", "lastQueuedAt", "startedAt", "lastHeartbeatAt" ], "type": "object" }, { "additionalProperties": false, "properties": { "activityName": { "type": "string" }, "attempt": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "createdAt": { "type": "number" }, "executionRequirement": { "additionalProperties": false, "properties": { "activityContractHash": { "type": "string" }, "artifactDigest": { "type": "string" }, "buildId": { "type": "string" }, "deploymentName": { "type": "string" }, "workflowRevision": { "type": "string" } }, "type": "object" }, "fairShareKey": { "type": "string" }, "firstQueuedAt": { "type": "number" }, "headerKeys": { "items": { "type": "string" }, "type": "array" }, "lastHeartbeatAt": { "type": "number" }, "lastQueuedAt": { "type": "number" }, "lastRequeueReason": { "type": "string" }, "leaseDeadline": { "type": "number" }, "operationId": { "type": "string" }, "pendingStatus": { "enum": ["completed", "failed"], "type": "string" }, "priority": { "type": "number" }, "queue": { "type": "string" }, "requeueCount": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "resultDigest": { "type": "string" }, "retryCount": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "retryPolicy": { "additionalProperties": false, "properties": { "backoffMultiplier": { "type": "number" }, "initialBackoff": { "anyOf": [ { "type": "number" }, { "type": "string" } ] }, "maxAttempts": { "type": "number" }, "maxBackoff": { "anyOf": [ { "type": "number" }, { "type": "string" } ] }, "nonRetryableErrors": { "items": { "type": "string" }, "type": "array" } }, "required": ["maxAttempts", "initialBackoff", "backoffMultiplier", "maxBackoff"], "type": "object" }, "scheduleToCloseDeadline": { "type": "number" }, "startedAt": { "type": "number" }, "state": { "const": "completing", "type": "string" }, "stickyWorkflowId": { "type": "string" }, "visibilityTimeoutMilliseconds": { "type": "number" }, "workflowExecutionToken": { "type": "string" }, "workflowId": { "type": "string" }, "workflowRevision": { "type": "string" }, "workflowType": { "type": "string" } }, "required": [ "operationId", "workflowType", "activityName", "queue", "headerKeys", "visibilityTimeoutMilliseconds", "createdAt", "attempt", "retryCount", "requeueCount", "state", "leaseDeadline", "firstQueuedAt", "lastQueuedAt", "startedAt", "lastHeartbeatAt", "pendingStatus", "resultDigest" ], "type": "object" }, { "additionalProperties": false, "properties": { "activityName": { "type": "string" }, "attempt": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "cancellationReason": { "type": "string" }, "cancellationRequestedAt": { "type": "number" }, "createdAt": { "type": "number" }, "executionRequirement": { "additionalProperties": false, "properties": { "activityContractHash": { "type": "string" }, "artifactDigest": { "type": "string" }, "buildId": { "type": "string" }, "deploymentName": { "type": "string" }, "workflowRevision": { "type": "string" } }, "type": "object" }, "fairShareKey": { "type": "string" }, "firstQueuedAt": { "type": "number" }, "headerKeys": { "items": { "type": "string" }, "type": "array" }, "lastHeartbeatAt": { "type": "number" }, "lastQueuedAt": { "type": "number" }, "lastRequeueReason": { "type": "string" }, "leaseDeadline": { "type": "number" }, "operationId": { "type": "string" }, "priority": { "type": "number" }, "queue": { "type": "string" }, "requeueCount": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "retryCount": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "retryPolicy": { "additionalProperties": false, "properties": { "backoffMultiplier": { "type": "number" }, "initialBackoff": { "anyOf": [ { "type": "number" }, { "type": "string" } ] }, "maxAttempts": { "type": "number" }, "maxBackoff": { "anyOf": [ { "type": "number" }, { "type": "string" } ] }, "nonRetryableErrors": { "items": { "type": "string" }, "type": "array" } }, "required": ["maxAttempts", "initialBackoff", "backoffMultiplier", "maxBackoff"], "type": "object" }, "scheduleToCloseDeadline": { "type": "number" }, "startedAt": { "type": "number" }, "state": { "const": "cancelling", "type": "string" }, "stickyWorkflowId": { "type": "string" }, "visibilityTimeoutMilliseconds": { "type": "number" }, "workflowExecutionToken": { "type": "string" }, "workflowId": { "type": "string" }, "workflowRevision": { "type": "string" }, "workflowType": { "type": "string" } }, "required": [ "operationId", "workflowType", "activityName", "queue", "headerKeys", "visibilityTimeoutMilliseconds", "createdAt", "attempt", "retryCount", "requeueCount", "state", "leaseDeadline", "firstQueuedAt", "lastQueuedAt", "startedAt", "lastHeartbeatAt", "cancellationReason", "cancellationRequestedAt" ], "type": "object" }, { "oneOf": [ { "additionalProperties": false, "properties": { "activityName": { "type": "string" }, "adopted": { "type": "boolean" }, "adoptedAt": { "type": "number" }, "attempt": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "createdAt": { "type": "number" }, "disposition": { "const": "resolved", "type": "string" }, "error": { "type": "string" }, "executionRequirement": { "additionalProperties": false, "properties": { "activityContractHash": { "type": "string" }, "artifactDigest": { "type": "string" }, "buildId": { "type": "string" }, "deploymentName": { "type": "string" }, "workflowRevision": { "type": "string" } }, "type": "object" }, "fairShareKey": { "type": "string" }, "headerKeys": { "items": { "type": "string" }, "type": "array" }, "operationId": { "type": "string" }, "priority": { "type": "number" }, "queue": { "type": "string" }, "resultDigest": { "type": "string" }, "resultStatus": { "enum": ["completed", "failed"], "type": "string" }, "retryPolicy": { "additionalProperties": false, "properties": { "backoffMultiplier": { "type": "number" }, "initialBackoff": { "anyOf": [ { "type": "number" }, { "type": "string" } ] }, "maxAttempts": { "type": "number" }, "maxBackoff": { "anyOf": [ { "type": "number" }, { "type": "string" } ] }, "nonRetryableErrors": { "items": { "type": "string" }, "type": "array" } }, "required": [ "maxAttempts", "initialBackoff", "backoffMultiplier", "maxBackoff" ], "type": "object" }, "scheduleToCloseDeadline": { "type": "number" }, "state": { "const": "terminal", "type": "string" }, "stickyWorkflowId": { "type": "string" }, "terminalAt": { "type": "number" }, "visibilityTimeoutMilliseconds": { "type": "number" }, "workflowExecutionToken": { "type": "string" }, "workflowId": { "type": "string" }, "workflowRevision": { "type": "string" }, "workflowType": { "type": "string" } }, "required": [ "operationId", "workflowType", "activityName", "queue", "headerKeys", "visibilityTimeoutMilliseconds", "createdAt", "attempt", "state", "terminalAt", "adopted", "disposition", "resultDigest", "resultStatus" ], "type": "object" }, { "additionalProperties": false, "properties": { "activityName": { "type": "string" }, "adopted": { "type": "boolean" }, "adoptedAt": { "type": "number" }, "attempt": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "cancellationReason": { "type": "string" }, "createdAt": { "type": "number" }, "disposition": { "const": "cancelled", "type": "string" }, "executionRequirement": { "additionalProperties": false, "properties": { "activityContractHash": { "type": "string" }, "artifactDigest": { "type": "string" }, "buildId": { "type": "string" }, "deploymentName": { "type": "string" }, "workflowRevision": { "type": "string" } }, "type": "object" }, "fairShareKey": { "type": "string" }, "headerKeys": { "items": { "type": "string" }, "type": "array" }, "operationId": { "type": "string" }, "priority": { "type": "number" }, "queue": { "type": "string" }, "retryPolicy": { "additionalProperties": false, "properties": { "backoffMultiplier": { "type": "number" }, "initialBackoff": { "anyOf": [ { "type": "number" }, { "type": "string" } ] }, "maxAttempts": { "type": "number" }, "maxBackoff": { "anyOf": [ { "type": "number" }, { "type": "string" } ] }, "nonRetryableErrors": { "items": { "type": "string" }, "type": "array" } }, "required": [ "maxAttempts", "initialBackoff", "backoffMultiplier", "maxBackoff" ], "type": "object" }, "scheduleToCloseDeadline": { "type": "number" }, "state": { "const": "terminal", "type": "string" }, "stickyWorkflowId": { "type": "string" }, "terminalAt": { "type": "number" }, "visibilityTimeoutMilliseconds": { "type": "number" }, "workflowExecutionToken": { "type": "string" }, "workflowId": { "type": "string" }, "workflowRevision": { "type": "string" }, "workflowType": { "type": "string" } }, "required": [ "operationId", "workflowType", "activityName", "queue", "headerKeys", "visibilityTimeoutMilliseconds", "createdAt", "attempt", "state", "terminalAt", "adopted", "disposition", "cancellationReason" ], "type": "object" }, { "additionalProperties": false, "properties": { "activityName": { "type": "string" }, "adopted": { "type": "boolean" }, "adoptedAt": { "type": "number" }, "attempt": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "createdAt": { "type": "number" }, "disposition": { "const": "retryExhausted", "type": "string" }, "error": { "type": "string" }, "executionRequirement": { "additionalProperties": false, "properties": { "activityContractHash": { "type": "string" }, "artifactDigest": { "type": "string" }, "buildId": { "type": "string" }, "deploymentName": { "type": "string" }, "workflowRevision": { "type": "string" } }, "type": "object" }, "fairShareKey": { "type": "string" }, "headerKeys": { "items": { "type": "string" }, "type": "array" }, "operationId": { "type": "string" }, "priority": { "type": "number" }, "queue": { "type": "string" }, "retryPolicy": { "additionalProperties": false, "properties": { "backoffMultiplier": { "type": "number" }, "initialBackoff": { "anyOf": [ { "type": "number" }, { "type": "string" } ] }, "maxAttempts": { "type": "number" }, "maxBackoff": { "anyOf": [ { "type": "number" }, { "type": "string" } ] }, "nonRetryableErrors": { "items": { "type": "string" }, "type": "array" } }, "required": [ "maxAttempts", "initialBackoff", "backoffMultiplier", "maxBackoff" ], "type": "object" }, "scheduleToCloseDeadline": { "type": "number" }, "state": { "const": "terminal", "type": "string" }, "stickyWorkflowId": { "type": "string" }, "terminalAt": { "type": "number" }, "visibilityTimeoutMilliseconds": { "type": "number" }, "workflowExecutionToken": { "type": "string" }, "workflowId": { "type": "string" }, "workflowRevision": { "type": "string" }, "workflowType": { "type": "string" } }, "required": [ "operationId", "workflowType", "activityName", "queue", "headerKeys", "visibilityTimeoutMilliseconds", "createdAt", "attempt", "state", "terminalAt", "adopted", "disposition", "error" ], "type": "object" } ] }, { "additionalProperties": false, "properties": { "activityName": { "type": "string" }, "attempt": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "createdAt": { "type": "number" }, "deadLetteredAt": { "type": "number" }, "error": { "type": "string" }, "executionRequirement": { "additionalProperties": false, "properties": { "activityContractHash": { "type": "string" }, "artifactDigest": { "type": "string" }, "buildId": { "type": "string" }, "deploymentName": { "type": "string" }, "workflowRevision": { "type": "string" } }, "type": "object" }, "fairShareKey": { "type": "string" }, "headerKeys": { "items": { "type": "string" }, "type": "array" }, "lastRequeueReason": { "type": "string" }, "operationId": { "type": "string" }, "pendingStatus": { "enum": ["completed", "failed"], "type": "string" }, "persistenceFailureReason": { "type": "string" }, "priority": { "type": "number" }, "queue": { "type": "string" }, "requeueCount": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "resultDigest": { "type": "string" }, "retryCount": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "retryPolicy": { "additionalProperties": false, "properties": { "backoffMultiplier": { "type": "number" }, "initialBackoff": { "anyOf": [ { "type": "number" }, { "type": "string" } ] }, "maxAttempts": { "type": "number" }, "maxBackoff": { "anyOf": [ { "type": "number" }, { "type": "string" } ] }, "nonRetryableErrors": { "items": { "type": "string" }, "type": "array" } }, "required": ["maxAttempts", "initialBackoff", "backoffMultiplier", "maxBackoff"], "type": "object" }, "scheduleToCloseDeadline": { "type": "number" }, "state": { "const": "deadLettered", "type": "string" }, "stickyWorkflowId": { "type": "string" }, "visibilityTimeoutMilliseconds": { "type": "number" }, "workflowExecutionToken": { "type": "string" }, "workflowId": { "type": "string" }, "workflowRevision": { "type": "string" }, "workflowType": { "type": "string" } }, "required": [ "operationId", "workflowType", "activityName", "queue", "headerKeys", "visibilityTimeoutMilliseconds", "createdAt", "attempt", "retryCount", "requeueCount", "state", "pendingStatus", "resultDigest", "deadLetteredAt", "persistenceFailureReason" ], "type": "object" } ] } }, { "name": "weft.updates.result.get", "kind": "unary", "summary": "Get the result of an update request", "tags": ["Updates"], "destructive": false, "access": { "kind": "public" }, "transports": { "http": true, "jsonRpcHttp": true, "jsonRpcWebSocket": true, "jsonRpcStdio": true }, "producibleFaults": [], "inputSchema": { "additionalProperties": false, "properties": { "updateId": { "minLength": 1, "type": "string" } }, "required": ["updateId"], "type": "object" }, "outputSchema": {} }, { "name": "weft.worker.deployments.drain", "kind": "unary", "summary": "Mark a worker deployment as draining", "tags": ["System"], "destructive": true, "access": { "kind": "scoped", "scopes": ["system:admin"] }, "transports": { "http": true, "jsonRpcHttp": true, "jsonRpcWebSocket": true, "jsonRpcStdio": true }, "producibleFaults": [], "inputSchema": { "additionalProperties": false, "properties": { "deploymentName": { "minLength": 1, "type": "string" }, "reason": { "maxLength": 256, "minLength": 1, "type": "string" } }, "required": ["deploymentName"], "type": "object" }, "outputSchema": { "oneOf": [ { "additionalProperties": false, "properties": { "affectedWorkers": { "type": "number" }, "health": { "enum": ["active", "draining", "drained"], "type": "string" }, "inFlight": { "type": "number" }, "target": { "const": "worker", "type": "string" }, "workerId": { "type": "string" } }, "required": ["target", "workerId", "affectedWorkers", "inFlight", "health"], "type": "object" }, { "additionalProperties": false, "properties": { "affectedWorkers": { "type": "number" }, "deploymentName": { "type": "string" }, "health": { "enum": ["active", "draining", "drained"], "type": "string" }, "inFlight": { "type": "number" }, "target": { "const": "deployment", "type": "string" } }, "required": ["target", "deploymentName", "affectedWorkers", "inFlight", "health"], "type": "object" } ] } }, { "name": "weft.worker.deployments.resume", "kind": "unary", "summary": "Clear a worker deployment drain marker", "tags": ["System"], "destructive": false, "access": { "kind": "scoped", "scopes": ["system:admin"] }, "transports": { "http": true, "jsonRpcHttp": true, "jsonRpcWebSocket": true, "jsonRpcStdio": true }, "producibleFaults": [], "inputSchema": { "additionalProperties": false, "properties": { "deploymentName": { "minLength": 1, "type": "string" } }, "required": ["deploymentName"], "type": "object" }, "outputSchema": { "oneOf": [ { "additionalProperties": false, "properties": { "affectedWorkers": { "type": "number" }, "health": { "enum": ["active", "draining", "drained"], "type": "string" }, "inFlight": { "type": "number" }, "target": { "const": "worker", "type": "string" }, "workerId": { "type": "string" } }, "required": ["target", "workerId", "affectedWorkers", "inFlight", "health"], "type": "object" }, { "additionalProperties": false, "properties": { "affectedWorkers": { "type": "number" }, "deploymentName": { "type": "string" }, "health": { "enum": ["active", "draining", "drained"], "type": "string" }, "inFlight": { "type": "number" }, "target": { "const": "deployment", "type": "string" } }, "required": ["target", "deploymentName", "affectedWorkers", "inFlight", "health"], "type": "object" } ] } }, { "name": "weft.workers.diagnostics", "kind": "unary", "summary": "Get bounded instance and deployment-version diagnostics for one connected worker", "description": "Report one connected worker's identity split into two parts: `instance` (this live connection — queue, health, connection timestamps) and `deploymentVersion` (the artifact it loaded — SDK/runtime identity, manifest digest, and every advertised workflow's version, revision, and contract hash). Returns `worker: null` when the workerId is not currently connected. Excludes capabilities and raw payload schemas.", "tags": ["Observability"], "destructive": false, "access": { "kind": "scoped", "scopes": ["system:read"] }, "transports": { "http": true, "jsonRpcHttp": true, "jsonRpcWebSocket": true, "jsonRpcStdio": true }, "producibleFaults": [], "inputSchema": { "additionalProperties": false, "properties": { "workerId": { "minLength": 1, "type": "string" } }, "required": ["workerId"], "type": "object" }, "outputSchema": { "additionalProperties": false, "properties": { "worker": { "anyOf": [ { "additionalProperties": false, "properties": { "deploymentVersion": { "additionalProperties": false, "properties": { "artifactDigest": { "type": "string" }, "buildId": { "type": "string" }, "deploymentName": { "type": "string" }, "manifestDigest": { "type": "string" }, "manifestVersion": { "type": "number" }, "protocolVersion": { "type": "number" }, "runtimeName": { "type": "string" }, "runtimeVersion": { "type": "string" }, "sdkVersion": { "type": "string" }, "workflows": { "additionalProperties": { "additionalProperties": false, "properties": { "activities": { "additionalProperties": { "additionalProperties": false, "properties": { "contractHash": { "type": "string" }, "implementationRevision": { "type": "string" } }, "required": ["contractHash", "implementationRevision"], "type": "object" }, "propertyNames": { "type": "string" }, "type": "object" }, "contractHash": { "type": "string" }, "workflowRevision": { "type": "string" }, "workflowVersion": { "type": "string" } }, "required": [ "workflowVersion", "workflowRevision", "contractHash", "activities" ], "type": "object" }, "propertyNames": { "type": "string" }, "type": "object" } }, "required": [ "deploymentName", "buildId", "artifactDigest", "runtimeName", "runtimeVersion", "sdkVersion", "manifestVersion", "protocolVersion", "manifestDigest", "workflows" ], "type": "object" }, "instance": { "additionalProperties": false, "properties": { "connectedAt": { "type": "number" }, "health": { "enum": ["active", "draining", "drained"], "type": "string" }, "heartbeatAgeMs": { "type": "number" }, "lastHeartbeatAt": { "type": "number" }, "queue": { "type": "string" }, "startedAt": { "type": "number" }, "workerId": { "type": "string" } }, "required": [ "workerId", "queue", "health", "connectedAt", "startedAt", "lastHeartbeatAt", "heartbeatAgeMs" ], "type": "object" } }, "required": ["instance", "deploymentVersion"], "type": "object" }, { "type": "null" } ] } }, "required": ["worker"], "type": "object" } }, { "name": "weft.workers.drain", "kind": "unary", "summary": "Mark a connected worker as draining", "description": "Mark a connected worker as draining by `workerId` so the engine stops dispatching new tasks to it while in-flight tasks finish, with an optional `reason`. Used for graceful shutdown and rolling deploys; clear the marker with the worker-resume operation. Faults with NotFound when no worker with the given id is connected.", "tags": ["System"], "destructive": true, "access": { "kind": "scoped", "scopes": ["system:admin"] }, "transports": { "http": true, "jsonRpcHttp": true, "jsonRpcWebSocket": true, "jsonRpcStdio": true }, "producibleFaults": ["NotFound"], "inputSchema": { "additionalProperties": false, "properties": { "reason": { "maxLength": 256, "minLength": 1, "type": "string" }, "workerId": { "minLength": 1, "type": "string" } }, "required": ["workerId"], "type": "object" }, "outputSchema": { "oneOf": [ { "additionalProperties": false, "properties": { "affectedWorkers": { "type": "number" }, "health": { "enum": ["active", "draining", "drained"], "type": "string" }, "inFlight": { "type": "number" }, "target": { "const": "worker", "type": "string" }, "workerId": { "type": "string" } }, "required": ["target", "workerId", "affectedWorkers", "inFlight", "health"], "type": "object" }, { "additionalProperties": false, "properties": { "affectedWorkers": { "type": "number" }, "deploymentName": { "type": "string" }, "health": { "enum": ["active", "draining", "drained"], "type": "string" }, "inFlight": { "type": "number" }, "target": { "const": "deployment", "type": "string" } }, "required": ["target", "deploymentName", "affectedWorkers", "inFlight", "health"], "type": "object" } ] } }, { "name": "weft.workers.list", "kind": "unary", "summary": "List connected workers, their advertised activities, and saturation", "description": "List workers currently connected to the engine, including each worker id, its advertised activities and workflows, drain state, and saturation. Read-only. Use this to observe the worker fleet before draining or rebalancing.", "tags": ["System"], "destructive": false, "access": { "kind": "scoped", "scopes": ["system:read"] }, "transports": { "http": true, "jsonRpcHttp": true, "jsonRpcWebSocket": true, "jsonRpcStdio": true }, "producibleFaults": [], "inputSchema": { "additionalProperties": false, "properties": {}, "type": "object" }, "outputSchema": { "$defs": { "__schema0": { "anyOf": [ { "type": "null" }, { "type": "boolean" }, { "type": "number" }, { "type": "string" }, { "items": { "$ref": "#/$defs/__schema0" }, "type": "array" }, { "additionalProperties": { "$ref": "#/$defs/__schema0" }, "propertyNames": { "type": "string" }, "type": "object" } ] } }, "additionalProperties": false, "properties": { "deployments": { "items": { "additionalProperties": false, "properties": { "activeWorkers": { "type": "number" }, "buildId": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "deploymentName": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "drainedWorkers": { "type": "number" }, "drainingWorkers": { "type": "number" }, "health": { "enum": ["active", "draining", "drained"], "type": "string" }, "inFlight": { "type": "number" }, "oldestStartedAt": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "runtimeVersion": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "workers": { "type": "number" } }, "required": [ "deploymentName", "buildId", "runtimeVersion", "health", "workers", "activeWorkers", "drainingWorkers", "drainedWorkers", "inFlight", "oldestStartedAt" ], "type": "object" }, "type": "array" }, "items": { "items": { "additionalProperties": false, "properties": { "activities": { "items": { "type": "string" }, "type": "array" }, "availableCapacity": { "type": "number" }, "buildId": { "type": "string" }, "capabilities": { "additionalProperties": { "$ref": "#/$defs/__schema0" }, "propertyNames": { "type": "string" }, "type": "object" }, "concurrency": { "type": "number" }, "connectedAt": { "type": "number" }, "deploymentName": { "type": "string" }, "health": { "enum": ["active", "draining", "drained"], "type": "string" }, "heartbeatAgeMs": { "type": "number" }, "id": { "type": "string" }, "inFlight": { "type": "number" }, "lastHeartbeatAt": { "type": "number" }, "queue": { "type": "string" }, "runtimeVersion": { "type": "string" }, "startedAt": { "type": "number" } }, "required": [ "id", "queue", "activities", "concurrency", "inFlight", "availableCapacity", "connectedAt", "lastHeartbeatAt", "heartbeatAgeMs", "startedAt", "capabilities", "health" ], "type": "object" }, "type": "array" }, "routingPolicy": { "enum": ["least-loaded", "round-robin", "fair-share"], "type": "string" } }, "required": ["items", "deployments", "routingPolicy"], "type": "object" } }, { "name": "weft.workers.rejections", "kind": "unary", "summary": "List recently declined worker registration attempts", "description": "Bounded, most-recent-first log of declined `register` attempts: rejection code, attempted workerId when known, and whatever deployment/queue identity had already been parsed by the time the rejecting gate ran. No free-text message and no manifest content.", "tags": ["Observability"], "destructive": false, "access": { "kind": "scoped", "scopes": ["system:read"] }, "transports": { "http": true, "jsonRpcHttp": true, "jsonRpcWebSocket": true, "jsonRpcStdio": true }, "producibleFaults": [], "inputSchema": { "additionalProperties": false, "properties": { "limit": { "default": 20, "maximum": 100, "minimum": 1, "type": "integer" } }, "required": ["limit"], "type": "object" }, "outputSchema": { "additionalProperties": false, "properties": { "items": { "items": { "additionalProperties": false, "properties": { "buildId": { "type": "string" }, "code": { "enum": [ "invalid_registration", "unsupported_protocol_version", "deployment_conflict", "registration_rejected" ], "type": "string" }, "deploymentName": { "type": "string" }, "queue": { "type": "string" }, "rejectedAt": { "type": "number" }, "workerId": { "type": "string" } }, "required": ["code", "rejectedAt"], "type": "object" }, "type": "array" }, "limit": { "maximum": 100, "minimum": 1, "type": "integer" } }, "required": ["items", "limit"], "type": "object" } }, { "name": "weft.workers.resume", "kind": "unary", "summary": "Clear a connected worker drain marker", "tags": ["System"], "destructive": false, "access": { "kind": "scoped", "scopes": ["system:admin"] }, "transports": { "http": true, "jsonRpcHttp": true, "jsonRpcWebSocket": true, "jsonRpcStdio": true }, "producibleFaults": ["NotFound"], "inputSchema": { "additionalProperties": false, "properties": { "workerId": { "minLength": 1, "type": "string" } }, "required": ["workerId"], "type": "object" }, "outputSchema": { "oneOf": [ { "additionalProperties": false, "properties": { "affectedWorkers": { "type": "number" }, "health": { "enum": ["active", "draining", "drained"], "type": "string" }, "inFlight": { "type": "number" }, "target": { "const": "worker", "type": "string" }, "workerId": { "type": "string" } }, "required": ["target", "workerId", "affectedWorkers", "inFlight", "health"], "type": "object" }, { "additionalProperties": false, "properties": { "affectedWorkers": { "type": "number" }, "deploymentName": { "type": "string" }, "health": { "enum": ["active", "draining", "drained"], "type": "string" }, "inFlight": { "type": "number" }, "target": { "const": "deployment", "type": "string" } }, "required": ["target", "deploymentName", "affectedWorkers", "inFlight", "health"], "type": "object" } ] } }, { "name": "weft.workflows.active.get", "kind": "unary", "summary": "Get the currently active revision pointer for a workflow", "description": "Read the current `{ revision, generation, activatedAt }` active pointer for `name`. Read-only, in-memory (matches `RegistrySnapshot.activeRevisions`' staleness contract exactly). Faults with NotFound when `name` has never been activated.", "tags": ["Workflow Catalog"], "destructive": false, "access": { "kind": "scoped", "scopes": ["workflows:read"] }, "transports": { "http": true, "jsonRpcHttp": true, "jsonRpcWebSocket": true, "jsonRpcStdio": true }, "producibleFaults": ["InvalidParams", "NotFound"], "inputSchema": { "additionalProperties": false, "properties": { "name": { "description": "Workflow name. Runtime validation requires a wire-safe identifier." } }, "required": ["name"], "type": "object" }, "outputSchema": {} }, { "name": "weft.workflows.activities.pending.list", "kind": "unary", "summary": "List pending async activities for a workflow", "description": "Read a bounded, deterministic page of durable activity task tokens awaiting out-of-band completion. The cursor is opaque and scoped to the selected workflow. A listed token may be consumed concurrently, so a later completion can return NotFound.", "tags": ["Activities"], "destructive": false, "access": { "kind": "scoped", "scopes": ["workflows:read"] }, "transports": { "http": true, "jsonRpcHttp": true, "jsonRpcStdio": true, "jsonRpcWebSocket": true }, "producibleFaults": ["InvalidParams", "NotFound"], "inputSchema": { "additionalProperties": false, "properties": { "cursor": { "maxLength": 8192, "type": "string" }, "limit": { "default": 50, "maximum": 200, "minimum": 1, "type": "integer" }, "workflowId": { "minLength": 1, "type": "string" } }, "required": ["workflowId", "limit"], "type": "object" }, "outputSchema": { "additionalProperties": false, "properties": { "items": { "items": { "additionalProperties": false, "properties": { "activityName": { "type": "string" }, "attempt": { "exclusiveMinimum": 0, "maximum": 9007199254740991, "type": "integer" }, "createdAt": { "type": "number" }, "operationId": { "type": "string" }, "step": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "token": { "type": "string" } }, "required": ["token", "operationId", "activityName", "step", "attempt", "createdAt"], "type": "object" }, "type": "array" }, "nextCursor": { "type": "string" } }, "required": ["items"], "type": "object" } }, { "name": "weft.workflows.aggregate", "kind": "unary", "summary": "Aggregate workflows by a single dimension", "tags": ["Workflows"], "destructive": false, "access": { "kind": "public" }, "transports": { "http": true, "jsonRpcHttp": true, "jsonRpcWebSocket": true, "jsonRpcStdio": true }, "producibleFaults": ["Unprocessable"], "inputSchema": { "additionalProperties": false, "properties": { "attributes": { "items": { "additionalProperties": false, "properties": { "gt": { "anyOf": [ { "type": "string" }, { "type": "number" }, { "type": "boolean" }, {}, { "items": { "type": "string" }, "type": "array" } ] }, "gte": { "anyOf": [ { "type": "string" }, { "type": "number" }, { "type": "boolean" }, {}, { "items": { "type": "string" }, "type": "array" } ] }, "key": { "anyOf": [ { "minLength": 1, "type": "string" }, {} ] }, "lt": { "anyOf": [ { "type": "string" }, { "type": "number" }, { "type": "boolean" }, {}, { "items": { "type": "string" }, "type": "array" } ] }, "lte": { "anyOf": [ { "type": "string" }, { "type": "number" }, { "type": "boolean" }, {}, { "items": { "type": "string" }, "type": "array" } ] }, "value": { "anyOf": [ { "type": "string" }, { "type": "number" }, { "type": "boolean" }, {}, { "items": { "type": "string" }, "type": "array" } ] } }, "required": ["key"], "type": "object" }, "type": "array" }, "createdAt": { "additionalProperties": false, "properties": { "gt": { "type": "number" }, "gte": { "type": "number" }, "lt": { "type": "number" }, "lte": { "type": "number" } }, "type": "object" }, "executionDeadline": { "additionalProperties": false, "properties": { "gt": { "type": "number" }, "gte": { "type": "number" }, "lt": { "type": "number" }, "lte": { "type": "number" } }, "type": "object" }, "failureCategory": { "anyOf": [ { "enum": ["application", "timeout", "cancellation", "resource", "system"], "type": "string" }, { "items": { "enum": ["application", "timeout", "cancellation", "resource", "system"], "type": "string" }, "minItems": 1, "type": "array" } ] }, "groupBy": { "anyOf": [ { "const": "status", "type": "string" }, { "const": "type", "type": "string" }, { "const": "failureCategory", "type": "string" }, { "additionalProperties": false, "properties": { "attribute": { "minLength": 1, "type": "string" } }, "required": ["attribute"], "type": "object" } ] }, "idPrefix": { "minLength": 1, "pattern": "^[A-Za-z0-9_-]+$", "type": "string" }, "limit": { "maximum": 10000, "minimum": 1, "type": "integer" }, "parentWorkflowExecutionToken": { "minLength": 1, "type": "string" }, "parentWorkflowId": { "minLength": 1, "type": "string" }, "scheduleId": { "minLength": 1, "type": "string" }, "status": { "anyOf": [ { "enum": [ "pending", "running", "completed", "failed", "cancelled", "timed-out", "suspended" ], "type": "string" }, { "items": { "enum": [ "pending", "running", "completed", "failed", "cancelled", "timed-out", "suspended" ], "type": "string" }, "type": "array" } ] }, "tags": { "items": { "type": "string" }, "type": "array" }, "type": { "minLength": 1, "type": "string" }, "updatedAt": { "additionalProperties": false, "properties": { "gt": { "type": "number" }, "gte": { "type": "number" }, "lt": { "type": "number" }, "lte": { "type": "number" } }, "type": "object" } }, "required": ["groupBy"], "type": "object" }, "outputSchema": { "additionalProperties": false, "properties": { "groups": { "items": { "additionalProperties": false, "properties": { "count": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "key": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": ["key", "count"], "type": "object" }, "type": "array" }, "total": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "truncated": { "type": "boolean" } }, "required": ["total", "groups", "truncated"], "type": "object" } }, { "name": "weft.workflows.attributes.get", "kind": "unary", "summary": "Get workflow attributes by id", "tags": ["Attributes"], "destructive": false, "access": { "kind": "public" }, "transports": { "http": true, "jsonRpcHttp": true, "jsonRpcWebSocket": true, "jsonRpcStdio": true }, "producibleFaults": ["NotFound"], "inputSchema": { "additionalProperties": false, "properties": { "workflowId": { "minLength": 1, "type": "string" } }, "required": ["workflowId"], "type": "object" }, "outputSchema": {} }, { "name": "weft.workflows.attributes.set", "kind": "unary", "summary": "Update search attributes for a workflow", "tags": ["Attributes"], "destructive": false, "access": { "kind": "public" }, "transports": { "http": true, "jsonRpcHttp": true, "jsonRpcWebSocket": true, "jsonRpcStdio": true }, "producibleFaults": [], "inputSchema": { "additionalProperties": false, "properties": { "attributes": {}, "workflowId": { "minLength": 1, "type": "string" } }, "required": ["workflowId"], "type": "object" }, "outputSchema": { "additionalProperties": false, "properties": { "ok": { "const": true, "type": "boolean" } }, "required": ["ok"], "type": "object" } }, { "name": "weft.workflows.bulk.cancel", "kind": "unary", "summary": "Cancel workflows in bulk", "tags": ["Workflows"], "destructive": true, "access": { "kind": "scoped", "scopes": ["workflows:admin"] }, "transports": { "http": true, "jsonRpcHttp": true, "jsonRpcWebSocket": true, "jsonRpcStdio": true }, "producibleFaults": [], "inputSchema": { "additionalProperties": false, "properties": { "attributes": { "items": { "additionalProperties": false, "properties": { "gt": { "anyOf": [ { "type": "string" }, { "type": "number" }, { "type": "boolean" }, {}, { "items": { "type": "string" }, "type": "array" } ] }, "gte": { "anyOf": [ { "type": "string" }, { "type": "number" }, { "type": "boolean" }, {}, { "items": { "type": "string" }, "type": "array" } ] }, "key": { "anyOf": [ { "minLength": 1, "type": "string" }, {} ] }, "lt": { "anyOf": [ { "type": "string" }, { "type": "number" }, { "type": "boolean" }, {}, { "items": { "type": "string" }, "type": "array" } ] }, "lte": { "anyOf": [ { "type": "string" }, { "type": "number" }, { "type": "boolean" }, {}, { "items": { "type": "string" }, "type": "array" } ] }, "value": { "anyOf": [ { "type": "string" }, { "type": "number" }, { "type": "boolean" }, {}, { "items": { "type": "string" }, "type": "array" } ] } }, "required": ["key"], "type": "object" }, "type": "array" }, "bulkConcurrency": { "maximum": 9007199254740991, "minimum": 1, "type": "integer" }, "confirmationToken": { "maxLength": 256, "minLength": 1, "type": "string" }, "createdAt": { "additionalProperties": false, "properties": { "gt": { "type": "number" }, "gte": { "type": "number" }, "lt": { "type": "number" }, "lte": { "type": "number" } }, "type": "object" }, "dryRun": { "type": "boolean" }, "executionDeadline": { "additionalProperties": false, "properties": { "gt": { "type": "number" }, "gte": { "type": "number" }, "lt": { "type": "number" }, "lte": { "type": "number" } }, "type": "object" }, "failureCategory": { "anyOf": [ { "enum": ["application", "timeout", "cancellation", "resource", "system"], "type": "string" }, { "items": { "enum": ["application", "timeout", "cancellation", "resource", "system"], "type": "string" }, "minItems": 1, "type": "array" } ] }, "idPrefix": { "minLength": 1, "pattern": "^[A-Za-z0-9_-]+$", "type": "string" }, "limit": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "offset": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "parentWorkflowExecutionToken": { "minLength": 1, "type": "string" }, "parentWorkflowId": { "minLength": 1, "type": "string" }, "requestId": { "maxLength": 200, "minLength": 1, "type": "string" }, "scheduleId": { "minLength": 1, "type": "string" }, "status": { "anyOf": [ { "enum": [ "pending", "running", "completed", "failed", "cancelled", "timed-out", "suspended" ], "type": "string" }, { "items": { "enum": [ "pending", "running", "completed", "failed", "cancelled", "timed-out", "suspended" ], "type": "string" }, "type": "array" } ] }, "tags": { "items": { "type": "string" }, "type": "array" }, "type": { "minLength": 1, "type": "string" }, "updatedAt": { "additionalProperties": false, "properties": { "gt": { "type": "number" }, "gte": { "type": "number" }, "lt": { "type": "number" }, "lte": { "type": "number" } }, "type": "object" } }, "type": "object" }, "outputSchema": {} }, { "name": "weft.workflows.bulk.delete", "kind": "unary", "summary": "Delete terminal workflows in bulk", "tags": ["Workflows"], "destructive": true, "access": { "kind": "scoped", "scopes": ["workflows:admin"] }, "transports": { "http": true, "jsonRpcHttp": true, "jsonRpcWebSocket": true, "jsonRpcStdio": true }, "producibleFaults": ["Unprocessable"], "inputSchema": { "additionalProperties": false, "properties": { "attributes": { "items": { "additionalProperties": false, "properties": { "gt": { "anyOf": [ { "type": "string" }, { "type": "number" }, { "type": "boolean" }, {}, { "items": { "type": "string" }, "type": "array" } ] }, "gte": { "anyOf": [ { "type": "string" }, { "type": "number" }, { "type": "boolean" }, {}, { "items": { "type": "string" }, "type": "array" } ] }, "key": { "anyOf": [ { "minLength": 1, "type": "string" }, {} ] }, "lt": { "anyOf": [ { "type": "string" }, { "type": "number" }, { "type": "boolean" }, {}, { "items": { "type": "string" }, "type": "array" } ] }, "lte": { "anyOf": [ { "type": "string" }, { "type": "number" }, { "type": "boolean" }, {}, { "items": { "type": "string" }, "type": "array" } ] }, "value": { "anyOf": [ { "type": "string" }, { "type": "number" }, { "type": "boolean" }, {}, { "items": { "type": "string" }, "type": "array" } ] } }, "required": ["key"], "type": "object" }, "type": "array" }, "bulkConcurrency": { "maximum": 9007199254740991, "minimum": 1, "type": "integer" }, "confirmationToken": { "maxLength": 256, "minLength": 1, "type": "string" }, "createdAt": { "additionalProperties": false, "properties": { "gt": { "type": "number" }, "gte": { "type": "number" }, "lt": { "type": "number" }, "lte": { "type": "number" } }, "type": "object" }, "dryRun": { "type": "boolean" }, "executionDeadline": { "additionalProperties": false, "properties": { "gt": { "type": "number" }, "gte": { "type": "number" }, "lt": { "type": "number" }, "lte": { "type": "number" } }, "type": "object" }, "failureCategory": { "anyOf": [ { "enum": ["application", "timeout", "cancellation", "resource", "system"], "type": "string" }, { "items": { "enum": ["application", "timeout", "cancellation", "resource", "system"], "type": "string" }, "minItems": 1, "type": "array" } ] }, "idPrefix": { "minLength": 1, "pattern": "^[A-Za-z0-9_-]+$", "type": "string" }, "limit": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "offset": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "parentWorkflowExecutionToken": { "minLength": 1, "type": "string" }, "parentWorkflowId": { "minLength": 1, "type": "string" }, "requestId": { "maxLength": 200, "minLength": 1, "type": "string" }, "scheduleId": { "minLength": 1, "type": "string" }, "status": { "anyOf": [ { "enum": [ "pending", "running", "completed", "failed", "cancelled", "timed-out", "suspended" ], "type": "string" }, { "items": { "enum": [ "pending", "running", "completed", "failed", "cancelled", "timed-out", "suspended" ], "type": "string" }, "type": "array" } ] }, "tags": { "items": { "type": "string" }, "type": "array" }, "type": { "minLength": 1, "type": "string" }, "updatedAt": { "additionalProperties": false, "properties": { "gt": { "type": "number" }, "gte": { "type": "number" }, "lt": { "type": "number" }, "lte": { "type": "number" } }, "type": "object" } }, "type": "object" }, "outputSchema": {} }, { "name": "weft.workflows.bulk.retryfailed", "kind": "unary", "summary": "Retry failed workflows in bulk", "tags": ["Workflows"], "destructive": true, "access": { "kind": "scoped", "scopes": ["workflows:admin"] }, "transports": { "http": true, "jsonRpcHttp": true, "jsonRpcWebSocket": true, "jsonRpcStdio": true }, "producibleFaults": [], "inputSchema": { "additionalProperties": false, "properties": { "attributes": { "items": { "additionalProperties": false, "properties": { "gt": { "anyOf": [ { "type": "string" }, { "type": "number" }, { "type": "boolean" }, {}, { "items": { "type": "string" }, "type": "array" } ] }, "gte": { "anyOf": [ { "type": "string" }, { "type": "number" }, { "type": "boolean" }, {}, { "items": { "type": "string" }, "type": "array" } ] }, "key": { "anyOf": [ { "minLength": 1, "type": "string" }, {} ] }, "lt": { "anyOf": [ { "type": "string" }, { "type": "number" }, { "type": "boolean" }, {}, { "items": { "type": "string" }, "type": "array" } ] }, "lte": { "anyOf": [ { "type": "string" }, { "type": "number" }, { "type": "boolean" }, {}, { "items": { "type": "string" }, "type": "array" } ] }, "value": { "anyOf": [ { "type": "string" }, { "type": "number" }, { "type": "boolean" }, {}, { "items": { "type": "string" }, "type": "array" } ] } }, "required": ["key"], "type": "object" }, "type": "array" }, "bulkConcurrency": { "maximum": 9007199254740991, "minimum": 1, "type": "integer" }, "confirmationToken": { "maxLength": 256, "minLength": 1, "type": "string" }, "createdAt": { "additionalProperties": false, "properties": { "gt": { "type": "number" }, "gte": { "type": "number" }, "lt": { "type": "number" }, "lte": { "type": "number" } }, "type": "object" }, "dryRun": { "type": "boolean" }, "executionDeadline": { "additionalProperties": false, "properties": { "gt": { "type": "number" }, "gte": { "type": "number" }, "lt": { "type": "number" }, "lte": { "type": "number" } }, "type": "object" }, "failureCategory": { "anyOf": [ { "enum": ["application", "timeout", "cancellation", "resource", "system"], "type": "string" }, { "items": { "enum": ["application", "timeout", "cancellation", "resource", "system"], "type": "string" }, "minItems": 1, "type": "array" } ] }, "idPrefix": { "minLength": 1, "pattern": "^[A-Za-z0-9_-]+$", "type": "string" }, "limit": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "offset": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "parentWorkflowExecutionToken": { "minLength": 1, "type": "string" }, "parentWorkflowId": { "minLength": 1, "type": "string" }, "requestId": { "maxLength": 200, "minLength": 1, "type": "string" }, "scheduleId": { "minLength": 1, "type": "string" }, "status": { "anyOf": [ { "enum": [ "pending", "running", "completed", "failed", "cancelled", "timed-out", "suspended" ], "type": "string" }, { "items": { "enum": [ "pending", "running", "completed", "failed", "cancelled", "timed-out", "suspended" ], "type": "string" }, "type": "array" } ] }, "tags": { "items": { "type": "string" }, "type": "array" }, "type": { "minLength": 1, "type": "string" }, "updatedAt": { "additionalProperties": false, "properties": { "gt": { "type": "number" }, "gte": { "type": "number" }, "lt": { "type": "number" }, "lte": { "type": "number" } }, "type": "object" } }, "type": "object" }, "outputSchema": {} }, { "name": "weft.workflows.bulk.signal", "kind": "unary", "summary": "Signal workflows in bulk", "tags": ["Workflows"], "destructive": true, "access": { "kind": "scoped", "scopes": ["workflows:admin"] }, "transports": { "http": true, "jsonRpcHttp": true, "jsonRpcWebSocket": true, "jsonRpcStdio": true }, "producibleFaults": [], "inputSchema": { "additionalProperties": false, "properties": { "attributes": { "items": { "additionalProperties": false, "properties": { "gt": { "anyOf": [ { "type": "string" }, { "type": "number" }, { "type": "boolean" }, {}, { "items": { "type": "string" }, "type": "array" } ] }, "gte": { "anyOf": [ { "type": "string" }, { "type": "number" }, { "type": "boolean" }, {}, { "items": { "type": "string" }, "type": "array" } ] }, "key": { "anyOf": [ { "minLength": 1, "type": "string" }, {} ] }, "lt": { "anyOf": [ { "type": "string" }, { "type": "number" }, { "type": "boolean" }, {}, { "items": { "type": "string" }, "type": "array" } ] }, "lte": { "anyOf": [ { "type": "string" }, { "type": "number" }, { "type": "boolean" }, {}, { "items": { "type": "string" }, "type": "array" } ] }, "value": { "anyOf": [ { "type": "string" }, { "type": "number" }, { "type": "boolean" }, {}, { "items": { "type": "string" }, "type": "array" } ] } }, "required": ["key"], "type": "object" }, "type": "array" }, "bulkConcurrency": { "maximum": 9007199254740991, "minimum": 1, "type": "integer" }, "confirmationToken": { "maxLength": 256, "minLength": 1, "type": "string" }, "createdAt": { "additionalProperties": false, "properties": { "gt": { "type": "number" }, "gte": { "type": "number" }, "lt": { "type": "number" }, "lte": { "type": "number" } }, "type": "object" }, "dryRun": { "type": "boolean" }, "executionDeadline": { "additionalProperties": false, "properties": { "gt": { "type": "number" }, "gte": { "type": "number" }, "lt": { "type": "number" }, "lte": { "type": "number" } }, "type": "object" }, "failureCategory": { "anyOf": [ { "enum": ["application", "timeout", "cancellation", "resource", "system"], "type": "string" }, { "items": { "enum": ["application", "timeout", "cancellation", "resource", "system"], "type": "string" }, "minItems": 1, "type": "array" } ] }, "idPrefix": { "minLength": 1, "pattern": "^[A-Za-z0-9_-]+$", "type": "string" }, "limit": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "name": { "minLength": 1, "type": "string" }, "offset": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "parentWorkflowExecutionToken": { "minLength": 1, "type": "string" }, "parentWorkflowId": { "minLength": 1, "type": "string" }, "payload": {}, "requestId": { "maxLength": 200, "minLength": 1, "type": "string" }, "scheduleId": { "minLength": 1, "type": "string" }, "status": { "anyOf": [ { "enum": [ "pending", "running", "completed", "failed", "cancelled", "timed-out", "suspended" ], "type": "string" }, { "items": { "enum": [ "pending", "running", "completed", "failed", "cancelled", "timed-out", "suspended" ], "type": "string" }, "type": "array" } ] }, "tags": { "items": { "type": "string" }, "type": "array" }, "type": { "minLength": 1, "type": "string" }, "updatedAt": { "additionalProperties": false, "properties": { "gt": { "type": "number" }, "gte": { "type": "number" }, "lt": { "type": "number" }, "lte": { "type": "number" } }, "type": "object" } }, "required": ["name"], "type": "object" }, "outputSchema": {} }, { "name": "weft.workflows.bulk.tags", "kind": "unary", "summary": "Add or remove workflow tags in bulk", "tags": ["Workflows"], "destructive": true, "access": { "kind": "scoped", "scopes": ["workflows:admin"] }, "transports": { "http": true, "jsonRpcHttp": true, "jsonRpcWebSocket": true, "jsonRpcStdio": true }, "producibleFaults": [], "inputSchema": { "additionalProperties": false, "properties": { "bulkConcurrency": { "maximum": 9007199254740991, "minimum": 1, "type": "integer" }, "confirmationToken": { "maxLength": 256, "minLength": 1, "type": "string" }, "dryRun": { "type": "boolean" }, "filter": { "additionalProperties": false, "properties": { "attributes": { "items": { "additionalProperties": false, "properties": { "gt": { "anyOf": [ { "type": "string" }, { "type": "number" }, { "type": "boolean" }, {}, { "items": { "type": "string" }, "type": "array" } ] }, "gte": { "anyOf": [ { "type": "string" }, { "type": "number" }, { "type": "boolean" }, {}, { "items": { "type": "string" }, "type": "array" } ] }, "key": { "anyOf": [ { "minLength": 1, "type": "string" }, {} ] }, "lt": { "anyOf": [ { "type": "string" }, { "type": "number" }, { "type": "boolean" }, {}, { "items": { "type": "string" }, "type": "array" } ] }, "lte": { "anyOf": [ { "type": "string" }, { "type": "number" }, { "type": "boolean" }, {}, { "items": { "type": "string" }, "type": "array" } ] }, "value": { "anyOf": [ { "type": "string" }, { "type": "number" }, { "type": "boolean" }, {}, { "items": { "type": "string" }, "type": "array" } ] } }, "required": ["key"], "type": "object" }, "type": "array" }, "createdAt": { "additionalProperties": false, "properties": { "gt": { "type": "number" }, "gte": { "type": "number" }, "lt": { "type": "number" }, "lte": { "type": "number" } }, "type": "object" }, "executionDeadline": { "additionalProperties": false, "properties": { "gt": { "type": "number" }, "gte": { "type": "number" }, "lt": { "type": "number" }, "lte": { "type": "number" } }, "type": "object" }, "failureCategory": { "anyOf": [ { "enum": ["application", "timeout", "cancellation", "resource", "system"], "type": "string" }, { "items": { "enum": ["application", "timeout", "cancellation", "resource", "system"], "type": "string" }, "minItems": 1, "type": "array" } ] }, "idPrefix": { "minLength": 1, "pattern": "^[A-Za-z0-9_-]+$", "type": "string" }, "limit": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "offset": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "parentWorkflowExecutionToken": { "minLength": 1, "type": "string" }, "parentWorkflowId": { "minLength": 1, "type": "string" }, "scheduleId": { "minLength": 1, "type": "string" }, "status": { "anyOf": [ { "enum": [ "pending", "running", "completed", "failed", "cancelled", "timed-out", "suspended" ], "type": "string" }, { "items": { "enum": [ "pending", "running", "completed", "failed", "cancelled", "timed-out", "suspended" ], "type": "string" }, "type": "array" } ] }, "tags": { "items": { "type": "string" }, "type": "array" }, "type": { "minLength": 1, "type": "string" }, "updatedAt": { "additionalProperties": false, "properties": { "gt": { "type": "number" }, "gte": { "type": "number" }, "lt": { "type": "number" }, "lte": { "type": "number" } }, "type": "object" } }, "type": "object" }, "operation": { "enum": ["add", "remove"], "type": "string" }, "requestId": { "maxLength": 200, "minLength": 1, "type": "string" }, "tags": { "items": { "type": "string" }, "type": "array" } }, "required": ["tags", "operation"], "type": "object" }, "outputSchema": {} }, { "name": "weft.workflows.cancel", "kind": "unary", "summary": "Cancel a running workflow", "description": "Request cancellation of a running workflow by `id`. Cancellation is cooperative: the workflow observes a cancellation signal and unwinds via its own cleanup logic, so this is irreversible from the caller perspective. Faults with NotFound when the workflow is not visible.", "tags": ["Workflows"], "destructive": true, "access": { "kind": "public" }, "transports": { "http": true, "jsonRpcHttp": true, "jsonRpcWebSocket": true, "jsonRpcStdio": true }, "producibleFaults": ["NotFound"], "inputSchema": { "additionalProperties": false, "properties": { "workflowId": { "minLength": 1, "type": "string" } }, "required": ["workflowId"], "type": "object" }, "outputSchema": {} }, { "name": "weft.workflows.checkpoints.get", "kind": "unary", "summary": "Get a specific checkpoint by step number", "tags": ["Checkpoints"], "destructive": false, "access": { "kind": "public" }, "transports": { "http": true, "jsonRpcHttp": true, "jsonRpcWebSocket": true, "jsonRpcStdio": true }, "producibleFaults": ["NotFound"], "inputSchema": { "additionalProperties": false, "properties": { "step": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "workflowId": { "minLength": 1, "type": "string" } }, "required": ["workflowId", "step"], "type": "object" }, "outputSchema": {} }, { "name": "weft.workflows.checkpoints.list", "kind": "unary", "summary": "List checkpoint history for a workflow", "tags": ["Checkpoints"], "destructive": false, "access": { "kind": "public" }, "transports": { "http": true, "jsonRpcHttp": true, "jsonRpcWebSocket": true, "jsonRpcStdio": true }, "producibleFaults": [], "inputSchema": { "additionalProperties": false, "properties": { "workflowId": { "minLength": 1, "type": "string" } }, "required": ["workflowId"], "type": "object" }, "outputSchema": {} }, { "name": "weft.workflows.events", "kind": "subscription", "summary": "Subscribe to workflow events with replay-from-cursor", "description": "`selector: \"events\"` requires `events:read`; `selector: \"tokens\"` requires `streams:read`. The grant is checked when the WebSocket subscription starts and remains active until unsubscribe, socket close, or feed termination.", "tags": ["Events"], "destructive": false, "access": { "kind": "authenticated" }, "parameterizedAccess": { "discriminator": "selector", "defaultValue": "events", "variants": [ { "value": "events", "access": { "kind": "scoped", "scopes": ["events:read"] } }, { "value": "tokens", "access": { "kind": "scoped", "scopes": ["streams:read"] } } ] }, "transports": { "http": false, "jsonRpcHttp": false, "jsonRpcWebSocket": true, "jsonRpcStdio": false }, "producibleFaults": ["InvalidParams"], "inputSchema": { "additionalProperties": false, "properties": { "fromCursor": { "type": "string" }, "selector": { "default": "events", "enum": ["events", "tokens"], "type": "string" }, "workflowId": { "minLength": 1, "type": "string" } }, "required": ["workflowId", "selector"], "type": "object" }, "outputSchema": { "additionalProperties": false, "properties": { "cursor": { "type": "string" }, "subscriptionId": { "type": "string" } }, "required": ["subscriptionId", "cursor"], "type": "object" }, "eventSchema": { "additionalProperties": false, "properties": { "cursor": { "type": "string" }, "emittedAtMs": { "type": "number" }, "kind": { "type": "string" }, "payload": {}, "selector": { "enum": ["events", "tokens"], "type": "string" }, "sequence": { "type": "number" }, "workflowId": { "type": "string" } }, "required": [ "kind", "workflowId", "selector", "sequence", "cursor", "emittedAtMs", "payload" ], "type": "object" } }, { "name": "weft.workflows.events.list", "kind": "unary", "summary": "Get workflow events by id", "tags": ["Events"], "destructive": false, "access": { "kind": "public" }, "transports": { "http": true, "jsonRpcHttp": true, "jsonRpcWebSocket": true, "jsonRpcStdio": true }, "producibleFaults": ["NotFound"], "inputSchema": { "additionalProperties": false, "properties": { "workflowId": { "minLength": 1, "type": "string" } }, "required": ["workflowId"], "type": "object" }, "outputSchema": {} }, { "name": "weft.workflows.events.sse", "kind": "stream", "summary": "Stream workflow events as Server-Sent Events", "description": "`selector: \"events\"` requires `events:read`; `selector: \"tokens\"` requires `streams:read`. The stream replays from `fromCursor` or `Last-Event-ID`, then remains open for live events and `ping` keepalives.", "tags": ["Events"], "destructive": false, "access": { "kind": "authenticated" }, "parameterizedAccess": { "discriminator": "selector", "defaultValue": "events", "variants": [ { "value": "events", "access": { "kind": "scoped", "scopes": ["events:read"] } }, { "value": "tokens", "access": { "kind": "scoped", "scopes": ["streams:read"] } } ] }, "transports": { "http": true, "jsonRpcHttp": false, "jsonRpcWebSocket": false, "jsonRpcStdio": false }, "producibleFaults": ["InvalidParams", "UnsupportedTransport"], "inputSchema": { "additionalProperties": false, "properties": { "fromCursor": { "type": "string" }, "lastEventId": { "type": "string" }, "selector": { "default": "events", "enum": ["events", "tokens"], "type": "string" }, "workflowId": { "minLength": 1, "type": "string" } }, "required": ["workflowId", "selector"], "type": "object" }, "outputSchema": {}, "eventSchema": { "additionalProperties": false, "properties": { "cursor": { "type": "string" }, "emittedAtMs": { "type": "number" }, "kind": { "type": "string" }, "payload": {}, "selector": { "enum": ["events", "tokens"], "type": "string" }, "sequence": { "type": "number" }, "workflowId": { "type": "string" } }, "required": [ "kind", "workflowId", "selector", "sequence", "cursor", "emittedAtMs", "payload" ], "type": "object" } }, { "name": "weft.workflows.finalizer.get", "kind": "unary", "summary": "Get workflow finalizer progress and outcome", "description": "Read durable post-terminal finalizer progress or its succeeded or failed outcome. Returns null when the workflow did not record finalizer work.", "tags": ["Workflows"], "destructive": false, "access": { "kind": "public" }, "transports": { "http": true, "jsonRpcHttp": true, "jsonRpcWebSocket": true, "jsonRpcStdio": true }, "producibleFaults": [], "inputSchema": { "additionalProperties": false, "properties": { "workflowId": { "minLength": 1, "type": "string" } }, "required": ["workflowId"], "type": "object" }, "outputSchema": { "anyOf": [ { "oneOf": [ { "additionalProperties": false, "properties": { "attempts": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "status": { "const": "pending", "type": "string" } }, "required": ["status", "attempts"], "type": "object" }, { "additionalProperties": false, "properties": { "attempts": { "exclusiveMinimum": 0, "maximum": 9007199254740991, "type": "integer" }, "startedAt": { "minimum": 0, "type": "number" }, "status": { "const": "running", "type": "string" } }, "required": ["status", "attempts", "startedAt"], "type": "object" }, { "additionalProperties": false, "properties": { "attempts": { "exclusiveMinimum": 0, "maximum": 9007199254740991, "type": "integer" }, "completedAt": { "minimum": 0, "type": "number" }, "status": { "const": "succeeded", "type": "string" } }, "required": ["status", "attempts", "completedAt"], "type": "object" }, { "additionalProperties": false, "properties": { "attempts": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "error": { "type": "string" }, "failedAt": { "minimum": 0, "type": "number" }, "status": { "const": "failed", "type": "string" } }, "required": ["status", "attempts", "failedAt", "error"], "type": "object" } ] }, { "type": "null" } ] } }, { "name": "weft.workflows.fork", "kind": "unary", "summary": "Fork a workflow from a checkpoint", "tags": ["Workflows"], "destructive": false, "access": { "kind": "public" }, "transports": { "http": true, "jsonRpcHttp": true, "jsonRpcWebSocket": true, "jsonRpcStdio": true }, "producibleFaults": ["Conflict", "NotFound"], "inputSchema": { "additionalProperties": false, "properties": { "fromStep": {}, "revision": { "minLength": 1, "type": "string" }, "workflowId": { "minLength": 1, "type": "string" } }, "required": ["workflowId"], "type": "object" }, "outputSchema": { "additionalProperties": false, "properties": { "id": { "type": "string" } }, "required": ["id"], "type": "object" } }, { "name": "weft.workflows.get", "kind": "unary", "summary": "Get workflow state by id", "description": "Read the current state of a single workflow by `id`, including its status, timestamps, tags, and search attributes. Read-only. Faults with NotFound when no workflow with the given id is visible.", "tags": ["Workflows"], "destructive": false, "access": { "kind": "public" }, "transports": { "http": true, "jsonRpcHttp": true, "jsonRpcWebSocket": true, "jsonRpcStdio": true }, "producibleFaults": ["NotFound"], "inputSchema": { "additionalProperties": false, "properties": { "workflowId": { "minLength": 1, "type": "string" } }, "required": ["workflowId"], "type": "object" }, "outputSchema": {} }, { "name": "weft.workflows.list", "kind": "unary", "summary": "List workflows", "description": "List workflows visible to the caller, optionally filtered by status, type, originating schedule, direct parent run, tags, id prefix, failure category, and time range, with pagination via `limit`/`offset`. Read-only. Returns the matching workflow summaries in the engine default ordering.", "tags": ["Workflows"], "destructive": false, "access": { "kind": "public" }, "transports": { "http": true, "jsonRpcHttp": true, "jsonRpcWebSocket": true, "jsonRpcStdio": true }, "producibleFaults": ["Unprocessable"], "inputSchema": { "additionalProperties": false, "properties": { "attributes": { "items": { "additionalProperties": false, "properties": { "gt": { "anyOf": [ { "type": "string" }, { "type": "number" }, { "type": "boolean" }, {}, { "items": { "type": "string" }, "type": "array" } ] }, "gte": { "anyOf": [ { "type": "string" }, { "type": "number" }, { "type": "boolean" }, {}, { "items": { "type": "string" }, "type": "array" } ] }, "key": { "anyOf": [ { "minLength": 1, "type": "string" }, {} ] }, "lt": { "anyOf": [ { "type": "string" }, { "type": "number" }, { "type": "boolean" }, {}, { "items": { "type": "string" }, "type": "array" } ] }, "lte": { "anyOf": [ { "type": "string" }, { "type": "number" }, { "type": "boolean" }, {}, { "items": { "type": "string" }, "type": "array" } ] }, "value": { "anyOf": [ { "type": "string" }, { "type": "number" }, { "type": "boolean" }, {}, { "items": { "type": "string" }, "type": "array" } ] } }, "required": ["key"], "type": "object" }, "type": "array" }, "createdAt": { "additionalProperties": false, "properties": { "gt": { "type": "number" }, "gte": { "type": "number" }, "lt": { "type": "number" }, "lte": { "type": "number" } }, "type": "object" }, "executionDeadline": { "additionalProperties": false, "properties": { "gt": { "type": "number" }, "gte": { "type": "number" }, "lt": { "type": "number" }, "lte": { "type": "number" } }, "type": "object" }, "failureCategory": { "anyOf": [ { "type": "string" }, { "items": { "type": "string" }, "type": "array" } ] }, "idPrefix": { "type": "string" }, "include": { "anyOf": [ { "type": "string" }, { "items": { "type": "string" }, "minItems": 1, "type": "array" } ] }, "limit": { "maximum": 1000, "minimum": 1, "type": "integer" }, "offset": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "parentWorkflowExecutionToken": { "minLength": 1, "type": "string" }, "parentWorkflowId": { "minLength": 1, "type": "string" }, "scheduleId": { "minLength": 1, "type": "string" }, "status": { "anyOf": [ { "type": "string" }, { "items": { "type": "string" }, "type": "array" } ] }, "tags": { "items": { "type": "string" }, "type": "array" }, "type": { "type": "string" }, "updatedAt": { "additionalProperties": false, "properties": { "gt": { "type": "number" }, "gte": { "type": "number" }, "lt": { "type": "number" }, "lte": { "type": "number" } }, "type": "object" } }, "type": "object" }, "outputSchema": {} }, { "name": "weft.workflows.purge", "kind": "unary", "summary": "Purge terminal workflows", "tags": ["Workflows"], "destructive": true, "access": { "kind": "public" }, "transports": { "http": true, "jsonRpcHttp": true, "jsonRpcWebSocket": true, "jsonRpcStdio": true }, "producibleFaults": [], "inputSchema": { "additionalProperties": false, "properties": { "attributes": { "items": { "additionalProperties": false, "properties": { "gt": { "anyOf": [ { "type": "string" }, { "type": "number" }, { "type": "boolean" }, {}, { "items": { "type": "string" }, "type": "array" } ] }, "gte": { "anyOf": [ { "type": "string" }, { "type": "number" }, { "type": "boolean" }, {}, { "items": { "type": "string" }, "type": "array" } ] }, "key": { "anyOf": [ { "minLength": 1, "type": "string" }, {} ] }, "lt": { "anyOf": [ { "type": "string" }, { "type": "number" }, { "type": "boolean" }, {}, { "items": { "type": "string" }, "type": "array" } ] }, "lte": { "anyOf": [ { "type": "string" }, { "type": "number" }, { "type": "boolean" }, {}, { "items": { "type": "string" }, "type": "array" } ] }, "value": { "anyOf": [ { "type": "string" }, { "type": "number" }, { "type": "boolean" }, {}, { "items": { "type": "string" }, "type": "array" } ] } }, "required": ["key"], "type": "object" }, "type": "array" }, "createdAt": { "additionalProperties": false, "properties": { "gt": { "type": "number" }, "gte": { "type": "number" }, "lt": { "type": "number" }, "lte": { "type": "number" } }, "type": "object" }, "executionDeadline": { "additionalProperties": false, "properties": { "gt": { "type": "number" }, "gte": { "type": "number" }, "lt": { "type": "number" }, "lte": { "type": "number" } }, "type": "object" }, "failureCategory": { "anyOf": [ { "enum": ["application", "timeout", "cancellation", "resource", "system"], "type": "string" }, { "items": { "enum": ["application", "timeout", "cancellation", "resource", "system"], "type": "string" }, "minItems": 1, "type": "array" } ] }, "idPrefix": { "minLength": 1, "pattern": "^[A-Za-z0-9_-]+$", "type": "string" }, "limit": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "offset": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "parentWorkflowExecutionToken": { "minLength": 1, "type": "string" }, "parentWorkflowId": { "minLength": 1, "type": "string" }, "scheduleId": { "minLength": 1, "type": "string" }, "status": { "anyOf": [ { "enum": [ "pending", "running", "completed", "failed", "cancelled", "timed-out", "suspended" ], "type": "string" }, { "items": { "enum": [ "pending", "running", "completed", "failed", "cancelled", "timed-out", "suspended" ], "type": "string" }, "type": "array" } ] }, "tags": { "items": { "type": "string" }, "type": "array" }, "type": { "minLength": 1, "type": "string" }, "updatedAt": { "additionalProperties": false, "properties": { "gt": { "type": "number" }, "gte": { "type": "number" }, "lt": { "type": "number" }, "lte": { "type": "number" } }, "type": "object" } }, "type": "object" }, "outputSchema": {} }, { "name": "weft.workflows.query", "kind": "unary", "summary": "Query workflow state by id", "description": "Run a named read-only query handler against a workflow and return its result. Requires the workflow `id` and the query `name`; `input` is optional. Queries do not mutate workflow state. Faults with NotFound when the workflow is not visible.", "tags": ["Workflows"], "destructive": false, "access": { "kind": "public" }, "transports": { "http": true, "jsonRpcHttp": true, "jsonRpcWebSocket": true, "jsonRpcStdio": true }, "producibleFaults": ["NotImplemented"], "inputSchema": { "additionalProperties": false, "properties": { "input": {}, "queryName": { "minLength": 1, "type": "string" }, "workflowId": { "minLength": 1, "type": "string" } }, "required": ["workflowId", "queryName"], "type": "object" }, "outputSchema": {} }, { "name": "weft.workflows.replay", "kind": "unary", "summary": "Replay a workflow to a historical checkpoint step", "description": "Reconstruct the historical state of a workflow at a given checkpoint step and return a replay view. This is a read-only reconstruction via the engine replay machinery — the live workflow is never mutated or rewound. Faults with NotFound when the workflow or checkpoint step is not visible.", "tags": ["Checkpoints"], "destructive": false, "access": { "kind": "scoped", "scopes": ["workflows:read"] }, "transports": { "http": true, "jsonRpcHttp": true, "jsonRpcWebSocket": true, "jsonRpcStdio": true }, "producibleFaults": ["Conflict", "NotFound"], "inputSchema": { "additionalProperties": false, "properties": { "step": { "anyOf": [ { "type": "string" }, { "type": "number" } ] }, "workflowId": { "minLength": 1, "type": "string" } }, "required": ["workflowId", "step"], "type": "object" }, "outputSchema": {} }, { "name": "weft.workflows.result.get", "kind": "unary", "summary": "Get workflow result by id", "tags": ["Workflows"], "destructive": false, "access": { "kind": "public" }, "transports": { "http": true, "jsonRpcHttp": true, "jsonRpcWebSocket": true, "jsonRpcStdio": true }, "producibleFaults": ["NotFound", "Timeout", "Unprocessable"], "inputSchema": { "additionalProperties": false, "properties": { "workflowId": { "minLength": 1, "type": "string" } }, "required": ["workflowId"], "type": "object" }, "outputSchema": {} }, { "name": "weft.workflows.resume", "kind": "unary", "summary": "Resume a suspended or recovered workflow", "description": "Re-drive a workflow from its persisted checkpoint by `workflowId`, returning the workflow `id`. Accepts a workflow that was explicitly suspended (`weft.workflows.suspend`) or one left running by a prior process; a suspended workflow is durably flipped back to running as part of resuming. Faults with NotFound when the workflow is not visible, or Conflict when it is in a status that cannot be resumed (terminal or pending).", "tags": ["Workflows"], "destructive": false, "access": { "kind": "public" }, "transports": { "http": true, "jsonRpcHttp": true, "jsonRpcWebSocket": true, "jsonRpcStdio": true }, "producibleFaults": ["Conflict", "NotFound"], "inputSchema": { "additionalProperties": false, "properties": { "workflowId": { "minLength": 1, "type": "string" } }, "required": ["workflowId"], "type": "object" }, "outputSchema": { "additionalProperties": false, "properties": { "id": { "type": "string" } }, "required": ["id"], "type": "object" } }, { "name": "weft.workflows.revisions.activate", "kind": "unary", "summary": "Activate an installed workflow revision", "description": "Activate an already-installed `(name, revision)` as the durably advertised active revision for `name`. Returns the structured result verbatim: `{ applied: true, pointer }` on success, or `{ applied: false, reason, ... }` on refusal — surfaced as a Conflict fault with `reason` one of `incompatible`, `stale-generation`, `expected-generation-required`, or `conflict`. Faults with NotFound when the revision was never installed. Never changes which in-process handler `engine.start()` dispatches to — see the workflow-versioning guide.", "tags": ["Workflow Catalog"], "destructive": true, "access": { "kind": "scoped", "scopes": ["workflows:admin"] }, "transports": { "http": true, "jsonRpcHttp": true, "jsonRpcWebSocket": true, "jsonRpcStdio": true }, "producibleFaults": ["Conflict", "InvalidParams", "NotFound"], "inputSchema": { "additionalProperties": false, "properties": { "expectedGeneration": { "description": "The durable generation this caller last observed. Required once the workflow has an active revision — omitting it there refuses with expected-generation-required." }, "name": { "description": "Workflow name. Runtime validation requires a wire-safe identifier." }, "policy": { "description": "Optional compatibility policy override." }, "revision": { "description": "Installed revision to activate. Runtime validation requires a non-empty string." } }, "required": ["name", "revision"], "type": "object" }, "outputSchema": {} }, { "name": "weft.workflows.revisions.get", "kind": "unary", "summary": "Get one installed workflow revision", "description": "Read one durably installed `(name, revision)` workflow catalog record. Read-only. Faults with NotFound when no such revision was installed.", "tags": ["Workflow Catalog"], "destructive": false, "access": { "kind": "scoped", "scopes": ["workflows:read"] }, "transports": { "http": true, "jsonRpcHttp": true, "jsonRpcWebSocket": true, "jsonRpcStdio": true }, "producibleFaults": ["InvalidParams", "NotFound"], "inputSchema": { "additionalProperties": false, "properties": { "name": { "description": "Workflow name. Runtime validation requires a wire-safe identifier." }, "revision": { "description": "Installed revision. Runtime validation requires a non-empty string." } }, "required": ["name", "revision"], "type": "object" }, "outputSchema": {} }, { "name": "weft.workflows.revisions.install", "kind": "unary", "summary": "Durably install a workflow revision manifest", "description": "Validate and durably install a `WorkflowRevisionManifest` for a workflow the engine already has an in-process definition for. Idempotent on a byte-identical reinstall of the same (name, revision). Faults with InvalidParams when the manifest fails validation or names a workflow with no in-process definition, and Conflict when (name, revision) is already installed with different contract content. Does not check `manifest.workflowVersion` against the in-process definition's own version — that mismatch is a normal activation-time `incompatible` refusal, not an install-time error. Never changes which in-process handler `engine.start()` dispatches to.", "tags": ["Workflow Catalog"], "destructive": false, "access": { "kind": "scoped", "scopes": ["workflows:admin"] }, "transports": { "http": true, "jsonRpcHttp": true, "jsonRpcWebSocket": true, "jsonRpcStdio": true }, "producibleFaults": ["Conflict", "InvalidParams"], "inputSchema": { "additionalProperties": false, "properties": { "manifest": { "description": "An untrusted WorkflowRevisionManifest, validated at invoke time." } }, "required": ["manifest"], "type": "object" }, "outputSchema": {} }, { "name": "weft.workflows.revisions.list", "kind": "unary", "summary": "List every installed revision of a workflow", "description": "Read every durably installed revision of `name`, sorted deterministically by revision. Read-only. Returns an empty array for a name with no installed revisions, rather than a NotFound fault — an empty catalog is not an error.", "tags": ["Workflow Catalog"], "destructive": false, "access": { "kind": "scoped", "scopes": ["workflows:read"] }, "transports": { "http": true, "jsonRpcHttp": true, "jsonRpcWebSocket": true, "jsonRpcStdio": true }, "producibleFaults": ["InvalidParams"], "inputSchema": { "additionalProperties": false, "properties": { "name": { "description": "Workflow name. Runtime validation requires a wire-safe identifier." } }, "required": ["name"], "type": "object" }, "outputSchema": {} }, { "name": "weft.workflows.revisions.preload", "kind": "unary", "summary": "Load, validate, and install a registered dynamic workflow source revision", "description": "Load, validate, and install `(name, revision)` — previously recorded via engine.registerSource() — durably into the workflow catalog. Faults NotFound when no source was ever registered for this exact key, and Conflict when the load fails or the loaded module fails validation.", "tags": ["Workflow Catalog"], "destructive": false, "access": { "kind": "scoped", "scopes": ["workflows:admin"] }, "transports": { "http": true, "jsonRpcHttp": true, "jsonRpcWebSocket": true, "jsonRpcStdio": true }, "producibleFaults": ["Conflict", "InvalidParams", "NotFound"], "inputSchema": { "additionalProperties": false, "properties": { "name": { "description": "Workflow name. Runtime validation requires a wire-safe identifier." }, "revision": { "description": "The registerSource()-registered revision to load, validate, and install. Runtime validation requires a non-empty string." } }, "required": ["name", "revision"], "type": "object" }, "outputSchema": {} }, { "name": "weft.workflows.scheduleprovenance.get", "kind": "unary", "summary": "Get the schedule occurrence that launched a workflow", "description": "Read the durable schedule id and optional occurrence timestamp that launched a workflow. Returns null for runs that were not launched by a schedule or whose workflow history was purged.", "tags": ["Workflows"], "destructive": false, "access": { "kind": "public" }, "transports": { "http": true, "jsonRpcHttp": true, "jsonRpcWebSocket": true, "jsonRpcStdio": true }, "producibleFaults": [], "inputSchema": { "additionalProperties": false, "properties": { "workflowId": { "minLength": 1, "type": "string" } }, "required": ["workflowId"], "type": "object" }, "outputSchema": { "anyOf": [ { "additionalProperties": false, "properties": { "occurrence": { "type": "number" }, "scheduleId": { "type": "string" } }, "required": ["scheduleId"], "type": "object" }, { "type": "null" } ] } }, { "name": "weft.workflows.signal", "kind": "unary", "summary": "Send a signal to a workflow", "description": "Deliver a named signal with an optional payload to a running workflow. Requires the workflow `id` and the signal `name`; `payload` is optional. Signals are fire-and-forget from the caller perspective and do not return a handler result. Faults with NotFound when the workflow is not visible and InvalidParams when the payload exceeds the size limit.", "tags": ["Signals"], "destructive": true, "access": { "kind": "public" }, "transports": { "http": true, "jsonRpcHttp": true, "jsonRpcWebSocket": true, "jsonRpcStdio": true }, "producibleFaults": ["NotFound"], "inputSchema": { "additionalProperties": false, "properties": { "payload": {}, "signalId": { "minLength": 1, "type": "string" }, "signalName": { "minLength": 1, "type": "string" }, "workflowId": { "minLength": 1, "type": "string" } }, "required": ["workflowId", "signalName"], "type": "object" }, "outputSchema": { "additionalProperties": false, "properties": { "ok": { "const": true, "type": "boolean" } }, "required": ["ok"], "type": "object" } }, { "name": "weft.workflows.start", "kind": "unary", "summary": "Start a new workflow", "description": "Start a new workflow execution of a registered type. Requires `type` (the registered workflow type name) and accepts an optional `input` payload plus start options: `id` (client-supplied workflow id), `executionTimeout`, `startAt`/`startAfter` (mutually exclusive scheduling), `tags`, `idempotencyKey` (at-most-once dedup: a repeated key returns the existing run instead of starting a second), and `searchAttributes`. Returns the workflow `id`. Faults with InvalidParams for an unregistered type or malformed options, and Conflict when a workflow with the same id already exists or the supplied `idempotencyKey` has been spent (its run was purged or swept by retention).", "tags": ["Workflows"], "destructive": false, "access": { "kind": "public" }, "transports": { "http": true, "jsonRpcHttp": true, "jsonRpcWebSocket": true, "jsonRpcStdio": true }, "producibleFaults": ["Conflict"], "inputSchema": { "additionalProperties": false, "properties": { "executionTimeout": {}, "id": {}, "idempotencyKey": {}, "input": {}, "searchAttributes": {}, "startAfter": {}, "startAt": {}, "tags": {}, "type": { "description": "Workflow type name. Runtime validation requires a non-empty string." } }, "required": ["type"], "type": "object" }, "outputSchema": { "additionalProperties": false, "properties": { "id": { "type": "string" } }, "required": ["id"], "type": "object" } }, { "name": "weft.workflows.startorsignal", "kind": "unary", "summary": "Atomically start a workflow or signal it if it already exists", "description": "Start a workflow or deliver a signal to it if it already exists (signal-with-start). An absent target is created and delivered the signal in one batch; a non-terminal target (running, pending, or suspended) is signalled; a terminal target faults with Conflict unless `onTerminalConflict: \"start-new\"` is supplied with `id` and `signalId`, in which case the prior terminal run is replaced through the shared terminal-replacement path and the initial signal is delivered to the fresh run. A spent `idempotencyKey` whose run was purged or swept by retention also faults with Conflict. Requires `type`, `signalName`, and exactly one of `signalId` or `idempotencyKey` (not both). Accepts `input`, `signalPayload`, and the non-idempotency start options from weft.workflows.start (`id`, `executionTimeout`, `startAt`/`startAfter`, `tags`, `searchAttributes`) plus `onTerminalConflict`; `idempotencyKey` is governed by the \"exactly one of\" rule above and cannot be combined with restart. Returns the workflow `id`. Concurrent callers converge on one workflow and one signal only with a shared `idempotencyKey`, or a shared `id` plus `signalId`; a bare `signalId` (no `id`/`idempotencyKey`) starts a fresh run per caller and does not converge.", "tags": ["Signals", "Workflows"], "destructive": true, "access": { "kind": "public" }, "transports": { "http": true, "jsonRpcHttp": true, "jsonRpcWebSocket": true, "jsonRpcStdio": true }, "producibleFaults": ["Conflict"], "inputSchema": { "additionalProperties": false, "properties": { "executionTimeout": {}, "id": {}, "idempotencyKey": {}, "input": {}, "onTerminalConflict": {}, "searchAttributes": {}, "signalId": { "minLength": 1, "type": "string" }, "signalName": { "description": "Signal name. Must be a non-empty string.", "minLength": 1, "type": "string" }, "signalPayload": {}, "startAfter": {}, "startAt": {}, "tags": {}, "type": { "description": "Workflow type name. Runtime validation requires a non-empty string." } }, "required": ["type", "signalName"], "type": "object" }, "outputSchema": { "additionalProperties": false, "properties": { "id": { "type": "string" }, "outcome": { "enum": ["started", "signalled"], "type": "string" } }, "required": ["id", "outcome"], "type": "object" } }, { "name": "weft.workflows.streams.chunks", "kind": "unary", "summary": "Read stored stream chunks for a workflow stream key", "tags": ["Streams"], "destructive": false, "access": { "kind": "public" }, "transports": { "http": true, "jsonRpcHttp": true, "jsonRpcWebSocket": true, "jsonRpcStdio": true }, "producibleFaults": [], "inputSchema": { "additionalProperties": false, "properties": { "after": {}, "key": { "minLength": 1, "type": "string" }, "workflowId": { "minLength": 1, "type": "string" } }, "required": ["workflowId", "key"], "type": "object" }, "outputSchema": { "additionalProperties": false, "properties": { "chunks": { "items": {}, "type": "array" } }, "required": ["chunks"], "type": "object" } }, { "name": "weft.workflows.streams.sse", "kind": "stream", "summary": "Stream workflow tokens as Server-Sent Events", "tags": ["Streams"], "destructive": false, "access": { "kind": "public" }, "transports": { "http": true, "jsonRpcHttp": true, "jsonRpcWebSocket": true, "jsonRpcStdio": true }, "producibleFaults": ["NotFound"], "inputSchema": { "additionalProperties": false, "properties": { "after": {}, "workflowId": { "minLength": 1, "type": "string" } }, "required": ["workflowId"], "type": "object" }, "outputSchema": { "additionalProperties": false, "properties": { "chunks": { "items": {}, "type": "array" } }, "required": ["chunks"], "type": "object" }, "eventSchema": { "additionalProperties": false, "properties": { "sequence": { "type": "number" }, "value": {} }, "required": ["sequence", "value"], "type": "object" } }, { "name": "weft.workflows.suspend", "kind": "unary", "summary": "Suspend a running workflow", "description": "Request suspension of a running workflow by `id` without terminating it. The workflow transitions to the non-terminal `suspended` status, keeps its durable checkpoint, and is later resumable via `resume`. Unlike cancellation, suspension does not run cancel handlers and does not settle the result. Suspending a workflow that is not running is a no-op. Faults with Unprocessable when the engine runs in worker execution mode (which cannot pause a run without cancelling it).", "tags": ["Workflows"], "destructive": false, "access": { "kind": "public" }, "transports": { "http": true, "jsonRpcHttp": true, "jsonRpcWebSocket": true, "jsonRpcStdio": true }, "producibleFaults": ["Unprocessable"], "inputSchema": { "additionalProperties": false, "properties": { "workflowId": { "minLength": 1, "type": "string" } }, "required": ["workflowId"], "type": "object" }, "outputSchema": {} }, { "name": "weft.workflows.tags.add", "kind": "unary", "summary": "Add workflow tags", "tags": ["Tags"], "destructive": false, "access": { "kind": "public" }, "transports": { "http": true, "jsonRpcHttp": true, "jsonRpcWebSocket": true, "jsonRpcStdio": true }, "producibleFaults": ["NotFound", "Unprocessable"], "inputSchema": { "additionalProperties": false, "properties": { "tags": {}, "workflowId": { "minLength": 1, "type": "string" } }, "required": ["workflowId"], "type": "object" }, "outputSchema": { "additionalProperties": false, "properties": { "ok": { "const": true, "type": "boolean" } }, "required": ["ok"], "type": "object" } }, { "name": "weft.workflows.tags.remove", "kind": "unary", "summary": "Remove workflow tags", "tags": ["Tags"], "destructive": false, "access": { "kind": "public" }, "transports": { "http": true, "jsonRpcHttp": true, "jsonRpcWebSocket": true, "jsonRpcStdio": true }, "producibleFaults": ["NotFound", "Unprocessable"], "inputSchema": { "additionalProperties": false, "properties": { "tags": {}, "workflowId": { "minLength": 1, "type": "string" } }, "required": ["workflowId"], "type": "object" }, "outputSchema": { "additionalProperties": false, "properties": { "ok": { "const": true, "type": "boolean" } }, "required": ["ok"], "type": "object" } }, { "name": "weft.workflows.timeline.get", "kind": "unary", "summary": "Get the structured execution timeline for a workflow", "tags": ["Checkpoints"], "destructive": false, "access": { "kind": "public" }, "transports": { "http": true, "jsonRpcHttp": true, "jsonRpcWebSocket": true, "jsonRpcStdio": true }, "producibleFaults": ["NotFound"], "inputSchema": { "additionalProperties": false, "properties": { "workflowId": { "minLength": 1, "type": "string" } }, "required": ["workflowId"], "type": "object" }, "outputSchema": {} }, { "name": "weft.workflows.timeout", "kind": "unary", "summary": "Force-timeout a workflow", "description": "Force a running workflow into the timed-out terminal state by `id`, as if its execution timeout had elapsed. Irreversible. Use for operator intervention on stuck workflows. Faults with NotFound when the workflow is not visible.", "tags": ["Workflows"], "destructive": true, "access": { "kind": "public" }, "transports": { "http": true, "jsonRpcHttp": true, "jsonRpcWebSocket": true, "jsonRpcStdio": true }, "producibleFaults": ["NotFound"], "inputSchema": { "additionalProperties": false, "properties": { "workflowId": { "minLength": 1, "type": "string" } }, "required": ["workflowId"], "type": "object" }, "outputSchema": { "type": "null" } }, { "name": "weft.workflows.update", "kind": "unary", "summary": "Send a synchronous update to a workflow", "description": "Invoke a named update handler on a workflow and wait for its result. Requires the workflow `id` and the update `name`; `payload` is optional. Unlike signals, updates return the handler result synchronously. Faults with NotFound when the workflow is not visible and InvalidParams when the payload exceeds the size limit.", "tags": ["Updates"], "destructive": true, "access": { "kind": "public" }, "transports": { "http": true, "jsonRpcHttp": true, "jsonRpcWebSocket": true, "jsonRpcStdio": true }, "producibleFaults": ["Timeout", "Unprocessable"], "inputSchema": { "additionalProperties": false, "properties": { "idempotencyKey": {}, "payload": {}, "timeout": {}, "updateName": { "minLength": 1, "type": "string" }, "workflowId": { "minLength": 1, "type": "string" } }, "required": ["workflowId", "updateName"], "type": "object" }, "outputSchema": { "additionalProperties": false, "properties": { "result": {}, "updateId": { "type": "string" } }, "required": ["updateId", "result"], "type": "object" } } ] }