@smthrs/gateway 0.34.0 → 0.35.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@smthrs/gateway",
-  "version": "0.34.0",
+  "version": "0.35.0",
   "description": "Stable Smithers Gateway RPC contracts, auth scopes, and deployment metadata",
   "type": "module",
   "sideEffects": false,
@@ -31,7 +31,7 @@
     "openapi.yaml"
   ],
   "dependencies": {
-    "@smthrs/protocol": "0.34.0"
+    "@smthrs/protocol": "0.35.0"
   },
   "devDependencies": {
     "@types/bun": "latest",

package/src/api/serializeRunRow.js

@@ -22,6 +22,33 @@ function validStartedBy(value) {
   };
 }
 
+const CANCELLATION_SOURCE_KINDS = new Set(["signal", "rpc", "cli", "engine"]);
+
+/** @param {Record<string, unknown>} row */
+function cancellationSourceFromRow(row) {
+  if (typeof row.cancelRequestSource !== "string") return undefined;
+  const rawKind = row.cancelRequestSource;
+  const legacyTransport = rawKind === "http" || rawKind === "websocket" || rawKind === "gateway";
+  const kind = legacyTransport ? "rpc" : rawKind;
+  if (!CANCELLATION_SOURCE_KINDS.has(kind)) return undefined;
+  const detail =
+    typeof row.cancelRequestDetail === "string"
+      ? row.cancelRequestDetail
+      : legacyTransport
+        ? `${rawKind} cancellation request`
+        : undefined;
+  return {
+    kind,
+    ...(detail !== undefined ? { detail } : {}),
+    ...(typeof row.cancelRequestSignal === "string" ? { signal: row.cancelRequestSignal } : {}),
+    ...(Number.isSafeInteger(row.cancelRequestClientPid) && Number(row.cancelRequestClientPid) > 0
+      ? { clientPid: Number(row.cancelRequestClientPid) }
+      : {}),
+    ...(typeof row.cancelRequestId === "string" ? { requestId: row.cancelRequestId } : {}),
+    ...(typeof row.cancelRequestClientIdentity === "string" ? { clientIdentity: row.cancelRequestClientIdentity } : {}),
+  };
+}
+
 /**
  * @template {Record<string, unknown>} Row
  * @param {Row} row
@@ -29,6 +56,11 @@ function validStartedBy(value) {
  */
 export function serializeRunRow(row) {
   const normalized = normalizeApiRow(row);
+  const cancellationSource = cancellationSourceFromRow(normalized);
+  if (cancellationSource) normalized.cancellationSource = cancellationSource;
+  if (typeof normalized.owner === "string" && typeof normalized.app === "string") {
+    normalized.ownership = { owner: normalized.owner, app: normalized.app };
+  }
   let config;
   if (typeof normalized.configJson === "string") {
     try {

package/src/rpc/gatewayRpcTypes.ts

@@ -47,6 +47,7 @@ export type {
   ListRunDescendantsRequest,
   ListRunDescendantsResponse,
   GatewayRunDescendant,
+  GetRunResponse,
   RunTokenUsageEvent,
   GetRunDiffRequest,
   GetRunDiffResponse,
@@ -134,6 +135,8 @@ export type {
   BrowserActivityEvent,
   BrowserScreenshot,
   BrowserSelection,
+  RunCancellationSource,
+  RunOwnership,
 } from "@smthrs/protocol/gateway-rpc";
 
 export type GatewayRpcErrorDetails = ProtocolGatewayRpcErrorDetails;

package/src/rpc/index.d.ts

@@ -1,4 +1,4 @@
-import { SmithersApiVersion as SmithersApiVersion$1, GatewayRpcMethod as GatewayRpcMethod$1, GatewayRpcErrorCode as GatewayRpcErrorCode$1, GatewayRpcErrorDetails as GatewayRpcErrorDetails$2, BrowserActRequest as BrowserActRequest$1, BrowserActResponse as BrowserActResponse$1, BrowserAction as BrowserAction$1, BrowserActivityEvent as BrowserActivityEvent$1, BrowserActor as BrowserActor$1, BrowserClickAction as BrowserClickAction$1, BrowserContextRequest as BrowserContextRequest$1, BrowserContextResponse as BrowserContextResponse$1, BrowserContextSlice as BrowserContextSlice$1, BrowserFrameEvent as BrowserFrameEvent$1, BrowserJournalEntry as BrowserJournalEntry$1, BrowserLocator as BrowserLocator$1, BrowserModifier as BrowserModifier$1, BrowserOutcome as BrowserOutcome$1, BrowserPickRequest as BrowserPickRequest$1, BrowserPickResponse as BrowserPickResponse$1, BrowserPoint as BrowserPoint$1, BrowserRectangle as BrowserRectangle$1, BrowserRedaction as BrowserRedaction$1, BrowserScreenshot as BrowserScreenshot$1, BrowserSelection as BrowserSelection$1, BrowserSnapshot as BrowserSnapshot$1, BrowserSource as BrowserSource$1, BrowserSummary as BrowserSummary$1, BrowserViewport as BrowserViewport$1, CancelRunRequest as CancelRunRequest$1, CancelRunResponse as CancelRunResponse$1, CloseBrowserSessionRequest as CloseBrowserSessionRequest$1, CloseBrowserSessionResponse as CloseBrowserSessionResponse$1, CreateBrowserSessionRequest as CreateBrowserSessionRequest$1, CreateBrowserSessionResponse as CreateBrowserSessionResponse$1, CreateTicketRequest as CreateTicketRequest$1, CronCreateRequest as CronCreateRequest$1, CronDeleteRequest as CronDeleteRequest$1, CronListRequest as CronListRequest$1, CronRunRequest as CronRunRequest$1, CrossedEffect as CrossedEffect$1, DeleteTicketRequest as DeleteTicketRequest$1, EffectBoundaryReport as EffectBoundaryReport$1, EffectRevertFailed as EffectRevertFailed$1, EffectRevertFinished as EffectRevertFinished$1, EffectRevertStarted as EffectRevertStarted$1, GatewayAccount as GatewayAccount$1, GatewayApprovalSummary as GatewayApprovalSummary$1, GatewayComparisonScoreRow as GatewayComparisonScoreRow$1, GatewayDiffBundle as GatewayDiffBundle$1, GatewayDiffPatch as GatewayDiffPatch$1, GatewayDocKind as GatewayDocKind$1, GatewayDocRow as GatewayDocRow$1, GatewayMemoryFact as GatewayMemoryFact$1, GatewayPrompt as GatewayPrompt$1, GatewayResponseFrame as GatewayResponseFrame$1, GatewayRunDescendant as GatewayRunDescendant$1, GatewayRunSummary as GatewayRunSummary$1, GatewayScoreDetail as GatewayScoreDetail$1, GatewayScoreRow as GatewayScoreRow$1, GatewayTicketRow as GatewayTicketRow$1, GatewayWorkflowSummary as GatewayWorkflowSummary$1, GetDevToolsSnapshotRequest as GetDevToolsSnapshotRequest$1, GetDevToolsSnapshotResponse as GetDevToolsSnapshotResponse$1, GetRunDiffOversizedResponse as GetRunDiffOversizedResponse$1, GetRunDiffRequest as GetRunDiffRequest$1, GetRunDiffResponse as GetRunDiffResponse$1, GetRunRequest as GetRunRequest$1, GetSchemaSignatureRequest as GetSchemaSignatureRequest$1, GetSchemaSignatureResponse as GetSchemaSignatureResponse$1, GetScoreDetailRequest as GetScoreDetailRequest$1, GetScoreDetailResponse as GetScoreDetailResponse$1, HijackRunRequest as HijackRunRequest$1, HijackRunResponse as HijackRunResponse$1, LaunchRunRequest as LaunchRunRequest$1, LaunchRunResponse as LaunchRunResponse$1, ListAccountsRequest as ListAccountsRequest$1, ListAccountsResponse as ListAccountsResponse$1, ListApprovalsRequest as ListApprovalsRequest$1, ListApprovalsResponse as ListApprovalsResponse$1, ListBrowserSessionsResponse as ListBrowserSessionsResponse$1, ListDocsRequest as ListDocsRequest$1, ListDocsResponse as ListDocsResponse$1, ListMemoryFactsRequest as ListMemoryFactsRequest$1, ListMemoryFactsResponse as ListMemoryFactsResponse$1, ListPromptsRequest as ListPromptsRequest$1, ListPromptsResponse as ListPromptsResponse$1, ListRunDescendantsRequest as ListRunDescendantsRequest$1, ListRunDescendantsResponse as ListRunDescendantsResponse$1, ListRunTokenUsageRequest as ListRunTokenUsageRequest$1, ListRunTokenUsageResponse as ListRunTokenUsageResponse$1, ListRunsRequest as ListRunsRequest$1, ListRunsResponse as ListRunsResponse$1, ListScoresForRunsRequest as ListScoresForRunsRequest$1, ListScoresForRunsResponse as ListScoresForRunsResponse$1, ListScoresRequest as ListScoresRequest$1, ListScoresResponse as ListScoresResponse$1, ListTicketsRequest as ListTicketsRequest$1, ListTicketsResponse as ListTicketsResponse$1, ListWorkflowsRequest as ListWorkflowsRequest$1, ListWorkflowsResponse as ListWorkflowsResponse$1, NodeRequest as NodeRequest$1, PauseRunRequest as PauseRunRequest$1, PauseRunResponse as PauseRunResponse$1, ResumeRunRequest as ResumeRunRequest$1, ResumeRunResponse as ResumeRunResponse$1, RewindRunRequest as RewindRunRequest$1, RewindRunResponse as RewindRunResponse$1, RunTokenUsageEvent as RunTokenUsageEvent$1, SideEffectBoundaryCrossed as SideEffectBoundaryCrossed$1, StreamDevToolsRequest as StreamDevToolsRequest$1, StreamRunEventsRequest as StreamRunEventsRequest$1, StreamRunEventsResponse as StreamRunEventsResponse$1, SubmitApprovalRequest as SubmitApprovalRequest$1, SubmitApprovalResponse as SubmitApprovalResponse$1, SubmitSignalRequest as SubmitSignalRequest$1, UpdateTicketRequest as UpdateTicketRequest$1, WhatHappenedRequest as WhatHappenedRequest$1, WhatHappenedResponse as WhatHappenedResponse$1 } from '@smthrs/protocol/gateway-rpc';
+import { SmithersApiVersion as SmithersApiVersion$1, GatewayRpcMethod as GatewayRpcMethod$1, GatewayRpcErrorCode as GatewayRpcErrorCode$1, GatewayRpcErrorDetails as GatewayRpcErrorDetails$2, BrowserActRequest as BrowserActRequest$1, BrowserActResponse as BrowserActResponse$1, BrowserAction as BrowserAction$1, BrowserActivityEvent as BrowserActivityEvent$1, BrowserActor as BrowserActor$1, BrowserClickAction as BrowserClickAction$1, BrowserContextRequest as BrowserContextRequest$1, BrowserContextResponse as BrowserContextResponse$1, BrowserContextSlice as BrowserContextSlice$1, BrowserFrameEvent as BrowserFrameEvent$1, BrowserJournalEntry as BrowserJournalEntry$1, BrowserLocator as BrowserLocator$1, BrowserModifier as BrowserModifier$1, BrowserOutcome as BrowserOutcome$1, BrowserPickRequest as BrowserPickRequest$1, BrowserPickResponse as BrowserPickResponse$1, BrowserPoint as BrowserPoint$1, BrowserRectangle as BrowserRectangle$1, BrowserRedaction as BrowserRedaction$1, BrowserScreenshot as BrowserScreenshot$1, BrowserSelection as BrowserSelection$1, BrowserSnapshot as BrowserSnapshot$1, BrowserSource as BrowserSource$1, BrowserSummary as BrowserSummary$1, BrowserViewport as BrowserViewport$1, CancelRunRequest as CancelRunRequest$1, CancelRunResponse as CancelRunResponse$1, CloseBrowserSessionRequest as CloseBrowserSessionRequest$1, CloseBrowserSessionResponse as CloseBrowserSessionResponse$1, CreateBrowserSessionRequest as CreateBrowserSessionRequest$1, CreateBrowserSessionResponse as CreateBrowserSessionResponse$1, CreateTicketRequest as CreateTicketRequest$1, CronCreateRequest as CronCreateRequest$1, CronDeleteRequest as CronDeleteRequest$1, CronListRequest as CronListRequest$1, CronRunRequest as CronRunRequest$1, CrossedEffect as CrossedEffect$1, DeleteTicketRequest as DeleteTicketRequest$1, EffectBoundaryReport as EffectBoundaryReport$1, EffectRevertFailed as EffectRevertFailed$1, EffectRevertFinished as EffectRevertFinished$1, EffectRevertStarted as EffectRevertStarted$1, GatewayAccount as GatewayAccount$1, GatewayApprovalSummary as GatewayApprovalSummary$1, GatewayComparisonScoreRow as GatewayComparisonScoreRow$1, GatewayDiffBundle as GatewayDiffBundle$1, GatewayDiffPatch as GatewayDiffPatch$1, GatewayDocKind as GatewayDocKind$1, GatewayDocRow as GatewayDocRow$1, GatewayMemoryFact as GatewayMemoryFact$1, GatewayPrompt as GatewayPrompt$1, GatewayResponseFrame as GatewayResponseFrame$1, GatewayRunDescendant as GatewayRunDescendant$1, GatewayRunSummary as GatewayRunSummary$1, GatewayScoreDetail as GatewayScoreDetail$1, GatewayScoreRow as GatewayScoreRow$1, GatewayTicketRow as GatewayTicketRow$1, GatewayWorkflowSummary as GatewayWorkflowSummary$1, GetDevToolsSnapshotRequest as GetDevToolsSnapshotRequest$1, GetDevToolsSnapshotResponse as GetDevToolsSnapshotResponse$1, GetRunDiffOversizedResponse as GetRunDiffOversizedResponse$1, GetRunDiffRequest as GetRunDiffRequest$1, GetRunDiffResponse as GetRunDiffResponse$1, GetRunRequest as GetRunRequest$1, GetRunResponse as GetRunResponse$1, GetSchemaSignatureRequest as GetSchemaSignatureRequest$1, GetSchemaSignatureResponse as GetSchemaSignatureResponse$1, GetScoreDetailRequest as GetScoreDetailRequest$1, GetScoreDetailResponse as GetScoreDetailResponse$1, HijackRunRequest as HijackRunRequest$1, HijackRunResponse as HijackRunResponse$1, LaunchRunRequest as LaunchRunRequest$1, LaunchRunResponse as LaunchRunResponse$1, ListAccountsRequest as ListAccountsRequest$1, ListAccountsResponse as ListAccountsResponse$1, ListApprovalsRequest as ListApprovalsRequest$1, ListApprovalsResponse as ListApprovalsResponse$1, ListBrowserSessionsResponse as ListBrowserSessionsResponse$1, ListDocsRequest as ListDocsRequest$1, ListDocsResponse as ListDocsResponse$1, ListMemoryFactsRequest as ListMemoryFactsRequest$1, ListMemoryFactsResponse as ListMemoryFactsResponse$1, ListPromptsRequest as ListPromptsRequest$1, ListPromptsResponse as ListPromptsResponse$1, ListRunDescendantsRequest as ListRunDescendantsRequest$1, ListRunDescendantsResponse as ListRunDescendantsResponse$1, ListRunTokenUsageRequest as ListRunTokenUsageRequest$1, ListRunTokenUsageResponse as ListRunTokenUsageResponse$1, ListRunsRequest as ListRunsRequest$1, ListRunsResponse as ListRunsResponse$1, ListScoresForRunsRequest as ListScoresForRunsRequest$1, ListScoresForRunsResponse as ListScoresForRunsResponse$1, ListScoresRequest as ListScoresRequest$1, ListScoresResponse as ListScoresResponse$1, ListTicketsRequest as ListTicketsRequest$1, ListTicketsResponse as ListTicketsResponse$1, ListWorkflowsRequest as ListWorkflowsRequest$1, ListWorkflowsResponse as ListWorkflowsResponse$1, NodeRequest as NodeRequest$1, PauseRunRequest as PauseRunRequest$1, PauseRunResponse as PauseRunResponse$1, ResumeRunRequest as ResumeRunRequest$1, ResumeRunResponse as ResumeRunResponse$1, RewindRunRequest as RewindRunRequest$1, RewindRunResponse as RewindRunResponse$1, RunCancellationSource as RunCancellationSource$1, RunTokenUsageEvent as RunTokenUsageEvent$1, SideEffectBoundaryCrossed as SideEffectBoundaryCrossed$1, StreamDevToolsRequest as StreamDevToolsRequest$1, StreamRunEventsRequest as StreamRunEventsRequest$1, StreamRunEventsResponse as StreamRunEventsResponse$1, SubmitApprovalRequest as SubmitApprovalRequest$1, SubmitApprovalResponse as SubmitApprovalResponse$1, SubmitSignalRequest as SubmitSignalRequest$1, UpdateTicketRequest as UpdateTicketRequest$1, WhatHappenedRequest as WhatHappenedRequest$1, WhatHappenedResponse as WhatHappenedResponse$1 } from '@smthrs/protocol/gateway-rpc';
 
 /** @typedef {(typeof GATEWAY_SCOPE_VALUES)[number]} GatewayScope */
 declare const GATEWAY_SCOPE_VALUES: readonly ["run:read", "run:write", "run:admin", "approval:submit", "signal:submit", "cron:read", "cron:write", "account:read", "memory:read", "prompt:read", "score:read", "ticket:read", "ticket:write", "observability:read"];
@@ -102,6 +102,7 @@ type GatewayRpcErrorDefinition = GatewayRpcErrorDefinition$1;
 type GatewayRpcDefinition = GatewayRpcDefinition$1;
 type GatewayRpcMethod = GatewayRpcMethod$1;
 type GatewayResponseFrame = GatewayResponseFrame$1;
+type RunCancellationSource = RunCancellationSource$1;
 type LaunchRunRequest = LaunchRunRequest$1;
 type LaunchRunResponse = LaunchRunResponse$1;
 type ResumeRunRequest = ResumeRunRequest$1;
@@ -124,6 +125,7 @@ type SubmitApprovalRequest = SubmitApprovalRequest$1;
 type SubmitApprovalResponse = SubmitApprovalResponse$1;
 type SubmitSignalRequest = SubmitSignalRequest$1;
 type GetRunRequest = GetRunRequest$1;
+type GetRunResponse = GetRunResponse$1;
 type RunTokenUsageEvent = RunTokenUsageEvent$1;
 type ListRunTokenUsageRequest = ListRunTokenUsageRequest$1;
 type ListRunTokenUsageResponse = ListRunTokenUsageResponse$1;
@@ -218,4 +220,4 @@ type BrowserScreenshot = BrowserScreenshot$1;
 type BrowserSelection = BrowserSelection$1;
 type GatewayScope = GatewayScope$1;
 
-export { type BrowserActRequest, type BrowserActResponse, type BrowserAction, type BrowserActivityEvent, type BrowserActor, type BrowserClickAction, type BrowserContextRequest, type BrowserContextResponse, type BrowserContextSlice, type BrowserFrameEvent, type BrowserJournalEntry, type BrowserLocator, type BrowserModifier, type BrowserOutcome, type BrowserPickRequest, type BrowserPickResponse, type BrowserPoint, type BrowserRectangle, type BrowserRedaction, type BrowserScreenshot, type BrowserSelection, type BrowserSnapshot, type BrowserSource, type BrowserSummary, type BrowserViewport, type CancelRunRequest, type CancelRunResponse, type CloseBrowserSessionRequest, type CloseBrowserSessionResponse, type CreateBrowserSessionRequest, type CreateBrowserSessionResponse, type CreateTicketRequest, type CronCreateRequest, type CronDeleteRequest, type CronListRequest, type CronRunRequest, type CrossedEffect, type DeleteTicketRequest, type EffectBoundaryReport, type EffectRevertFailed, type EffectRevertFinished, type EffectRevertStarted, GATEWAY_EVENT_WINDOW_DEFAULT, GATEWAY_RPC_DEFINITIONS, GATEWAY_RPC_ERRORS, GATEWAY_RPC_LEGACY_METHOD_ALIASES, type GatewayAccount, type GatewayApprovalSummary, type GatewayComparisonScoreRow, type GatewayDiffBundle, type GatewayDiffPatch, type GatewayDocKind, type GatewayDocRow, type GatewayMemoryFact, type GatewayPrompt, type GatewayResponseFrame, type GatewayRpcDefinition, type GatewayRpcErrorCode, type GatewayRpcErrorDefinition, type GatewayRpcErrorDetails, type GatewayRpcMethod, type GatewayRunDescendant, type GatewayRunSummary, type GatewayScope, type GatewayScoreDetail, type GatewayScoreRow, type GatewayTicketRow, type GatewayWorkflowSummary, type GetDevToolsSnapshotRequest, type GetDevToolsSnapshotResponse, type GetRunDiffOversizedResponse, type GetRunDiffRequest, type GetRunDiffResponse, type GetRunRequest, type GetSchemaSignatureRequest, type GetSchemaSignatureResponse, type GetScoreDetailRequest, type GetScoreDetailResponse, type HijackRunRequest, type HijackRunResponse, type JsonSchema, type LaunchRunRequest, type LaunchRunResponse, type ListAccountsRequest, type ListAccountsResponse, type ListApprovalsRequest, type ListApprovalsResponse, type ListBrowserSessionsResponse, type ListDocsRequest, type ListDocsResponse, type ListMemoryFactsRequest, type ListMemoryFactsResponse, type ListPromptsRequest, type ListPromptsResponse, type ListRunDescendantsRequest, type ListRunDescendantsResponse, type ListRunTokenUsageRequest, type ListRunTokenUsageResponse, type ListRunsRequest, type ListRunsResponse, type ListScoresForRunsRequest, type ListScoresForRunsResponse, type ListScoresRequest, type ListScoresResponse, type ListTicketsRequest, type ListTicketsResponse, type ListWorkflowsRequest, type ListWorkflowsResponse, type NodeRequest, type PauseRunRequest, type PauseRunResponse, type ResumeRunRequest, type ResumeRunResponse, type RewindRunRequest, type RewindRunResponse, type RunTokenUsageEvent, SMITHERS_API_VERSION, type SideEffectBoundaryCrossed, type SmithersApiVersion, type StreamDevToolsRequest, type StreamRunEventsRequest, type StreamRunEventsResponse, type SubmitApprovalRequest, type SubmitApprovalResponse, type SubmitSignalRequest, type UpdateTicketRequest, type WhatHappenedRequest, type WhatHappenedResponse, anyJsonSchema, canonicalGatewayRpcMethod, getGatewayRpcDefinition, getGatewayScopeValues, getRequiredScopeForGatewayMethod, isGatewayRpcMethod, listGatewayRpcMethods };
+export { type BrowserActRequest, type BrowserActResponse, type BrowserAction, type BrowserActivityEvent, type BrowserActor, type BrowserClickAction, type BrowserContextRequest, type BrowserContextResponse, type BrowserContextSlice, type BrowserFrameEvent, type BrowserJournalEntry, type BrowserLocator, type BrowserModifier, type BrowserOutcome, type BrowserPickRequest, type BrowserPickResponse, type BrowserPoint, type BrowserRectangle, type BrowserRedaction, type BrowserScreenshot, type BrowserSelection, type BrowserSnapshot, type BrowserSource, type BrowserSummary, type BrowserViewport, type CancelRunRequest, type CancelRunResponse, type CloseBrowserSessionRequest, type CloseBrowserSessionResponse, type CreateBrowserSessionRequest, type CreateBrowserSessionResponse, type CreateTicketRequest, type CronCreateRequest, type CronDeleteRequest, type CronListRequest, type CronRunRequest, type CrossedEffect, type DeleteTicketRequest, type EffectBoundaryReport, type EffectRevertFailed, type EffectRevertFinished, type EffectRevertStarted, GATEWAY_EVENT_WINDOW_DEFAULT, GATEWAY_RPC_DEFINITIONS, GATEWAY_RPC_ERRORS, GATEWAY_RPC_LEGACY_METHOD_ALIASES, type GatewayAccount, type GatewayApprovalSummary, type GatewayComparisonScoreRow, type GatewayDiffBundle, type GatewayDiffPatch, type GatewayDocKind, type GatewayDocRow, type GatewayMemoryFact, type GatewayPrompt, type GatewayResponseFrame, type GatewayRpcDefinition, type GatewayRpcErrorCode, type GatewayRpcErrorDefinition, type GatewayRpcErrorDetails, type GatewayRpcMethod, type GatewayRunDescendant, type GatewayRunSummary, type GatewayScope, type GatewayScoreDetail, type GatewayScoreRow, type GatewayTicketRow, type GatewayWorkflowSummary, type GetDevToolsSnapshotRequest, type GetDevToolsSnapshotResponse, type GetRunDiffOversizedResponse, type GetRunDiffRequest, type GetRunDiffResponse, type GetRunRequest, type GetRunResponse, type GetSchemaSignatureRequest, type GetSchemaSignatureResponse, type GetScoreDetailRequest, type GetScoreDetailResponse, type HijackRunRequest, type HijackRunResponse, type JsonSchema, type LaunchRunRequest, type LaunchRunResponse, type ListAccountsRequest, type ListAccountsResponse, type ListApprovalsRequest, type ListApprovalsResponse, type ListBrowserSessionsResponse, type ListDocsRequest, type ListDocsResponse, type ListMemoryFactsRequest, type ListMemoryFactsResponse, type ListPromptsRequest, type ListPromptsResponse, type ListRunDescendantsRequest, type ListRunDescendantsResponse, type ListRunTokenUsageRequest, type ListRunTokenUsageResponse, type ListRunsRequest, type ListRunsResponse, type ListScoresForRunsRequest, type ListScoresForRunsResponse, type ListScoresRequest, type ListScoresResponse, type ListTicketsRequest, type ListTicketsResponse, type ListWorkflowsRequest, type ListWorkflowsResponse, type NodeRequest, type PauseRunRequest, type PauseRunResponse, type ResumeRunRequest, type ResumeRunResponse, type RewindRunRequest, type RewindRunResponse, type RunCancellationSource, type RunTokenUsageEvent, SMITHERS_API_VERSION, type SideEffectBoundaryCrossed, type SmithersApiVersion, type StreamDevToolsRequest, type StreamRunEventsRequest, type StreamRunEventsResponse, type SubmitApprovalRequest, type SubmitApprovalResponse, type SubmitSignalRequest, type UpdateTicketRequest, type WhatHappenedRequest, type WhatHappenedResponse, anyJsonSchema, canonicalGatewayRpcMethod, getGatewayRpcDefinition, getGatewayScopeValues, getRequiredScopeForGatewayMethod, isGatewayRpcMethod, listGatewayRpcMethods };

package/src/rpc/index.js

@@ -7,6 +7,7 @@
 /** @typedef {import("./gatewayRpcTypes.ts").GatewayRpcDefinition} GatewayRpcDefinition */
 /** @typedef {import("./gatewayRpcTypes.ts").GatewayRpcMethod} GatewayRpcMethod */
 /** @typedef {import("./gatewayRpcTypes.ts").GatewayResponseFrame} GatewayResponseFrame */
+/** @typedef {import("./gatewayRpcTypes.ts").RunCancellationSource} RunCancellationSource */
 /** @typedef {import("./gatewayRpcTypes.ts").LaunchRunRequest} LaunchRunRequest */
 /** @typedef {import("./gatewayRpcTypes.ts").LaunchRunResponse} LaunchRunResponse */
 /** @typedef {import("./gatewayRpcTypes.ts").ResumeRunRequest} ResumeRunRequest */
@@ -29,6 +30,7 @@
 /** @typedef {import("./gatewayRpcTypes.ts").SubmitApprovalResponse} SubmitApprovalResponse */
 /** @typedef {import("./gatewayRpcTypes.ts").SubmitSignalRequest} SubmitSignalRequest */
 /** @typedef {import("./gatewayRpcTypes.ts").GetRunRequest} GetRunRequest */
+/** @typedef {import("./gatewayRpcTypes.ts").GetRunResponse} GetRunResponse */
 /** @typedef {import("./gatewayRpcTypes.ts").RunTokenUsageEvent} RunTokenUsageEvent */
 /** @typedef {import("./gatewayRpcTypes.ts").ListRunTokenUsageRequest} ListRunTokenUsageRequest */
 /** @typedef {import("./gatewayRpcTypes.ts").ListRunTokenUsageResponse} ListRunTokenUsageResponse */
@@ -141,9 +143,11 @@ const ACCOUNT_PROVIDERS = [
   "codex",
   "gemini",
   "kimi",
+  "grok",
   "anthropic-api",
   "openai-api",
   "gemini-api",
+  "xai-api",
 ];
 
 // The closed set of work-doc kinds in `_smithers_docs`. The GatewayDocKind
@@ -219,6 +223,26 @@ const nodeId = stringSchema("Workflow node id.");
 const iteration = integerSchema("Node iteration.", 0);
 const afterSeq = integerSchema("Replay events with sequence numbers greater than this value.", 0);
 const fromSeq = integerSchema("Legacy alias for afterSeq on DevTools streams.", 0);
+const cancellationSource = objectSchema(
+  {
+    kind: { type: "string", enum: ["signal", "rpc", "cli", "engine"] },
+    detail: stringSchema("Human-readable cancellation detail."),
+    signal: stringSchema("POSIX signal that initiated cancellation."),
+    clientPid: integerSchema("Process id of the cancellation caller.", 1),
+    requestId: stringSchema("Request id of the first cancellation caller."),
+    clientIdentity: stringSchema("Authenticated identity of the first cancellation caller."),
+  },
+  ["kind"],
+  "Durable attribution for the first caller that cancelled the run.",
+);
+const runOwnership = objectSchema(
+  {
+    owner: stringSchema("Authenticated tenant owner key.", 1),
+    app: stringSchema("Authenticated application key.", 1),
+  },
+  ["owner", "app"],
+  "Exact persisted run ownership pair.",
+);
 const runSummary = objectSchema(
   {
     runId,
@@ -227,11 +251,30 @@ const runSummary = objectSchema(
     createdAtMs: integerSchema("Unix epoch milliseconds.", 0),
     parentRunId: { type: ["string", "null"], description: "Immediate parent run id, if this is a child run." },
     system: booleanSchema("Whether this run belongs to an internal system workflow."),
+    cancellationSource,
+    ownership: runOwnership,
   },
   ["runId", "status", "system"],
   "Run summary view.",
   true,
 );
+const cancelledRunOutcome = objectSchema(
+  {
+    runId,
+    depth: integerSchema("Distance from the requested root run.", 0),
+    action: { type: "string", enum: ["cancel-requested", "cancelled", "already-terminal", "missing"] },
+  },
+  ["runId", "depth", "action"],
+  "What recursive cancellation did to one run in the cancelled subtree.",
+);
+const cancelledProcess = objectSchema(
+  {
+    runId: { type: ["string", "null"], description: "Run the process belonged to." },
+    pid: integerSchema("Terminated process id.", 1),
+  },
+  ["runId", "pid"],
+  "A process tree cancellation terminated so work cannot outlive its run.",
+);
 const runDescendant = objectSchema(
   {
     runId,
@@ -264,6 +307,8 @@ const runRecord = objectSchema(
     finishedAtMs: { type: ["integer", "null"], minimum: 0, description: "Unix epoch milliseconds." },
     summary: objectSchema({}, [], "Counts keyed by persisted node state.", true),
     runState: runStateView,
+    cancellationSource,
+    ownership: runOwnership,
   },
   ["runId", "system"],
   "Current run record, including node-state counts and optional derived runState.",
@@ -623,6 +668,12 @@ export const GATEWAY_RPC_ERRORS = {
     httpStatus: 409,
     description: "The run is not currently active and cannot be cancelled.",
   },
+  CONFLICT: {
+    version: SMITHERS_API_VERSION,
+    code: "CONFLICT",
+    httpStatus: 409,
+    description: "The requested run id is already taken by an existing run.",
+  },
   CronNotFound: {
     version: SMITHERS_API_VERSION,
     code: "CronNotFound",
@@ -840,10 +891,15 @@ export const GATEWAY_RPC_DEFINITIONS = [
       ["workflow"],
     ),
     responseSchema: objectSchema(
-      { runId, workflow, system: booleanSchema("Whether the launched workflow is an internal system workflow.") },
+      {
+        runId,
+        workflow,
+        system: booleanSchema("Whether the launched workflow is an internal system workflow."),
+        ownership: runOwnership,
+      },
       ["runId", "workflow", "system"],
     ),
-    errors: ["InvalidRequest", "InvalidInput", "Unauthorized", "Forbidden", "Internal"],
+    errors: ["InvalidRequest", "InvalidInput", "Unauthorized", "Forbidden", "CONFLICT", "Internal"],
     exampleRequest: {
       workflow: "deploy",
       input: { sha: "abc123" },
@@ -874,15 +930,47 @@ export const GATEWAY_RPC_DEFINITIONS = [
     version: SMITHERS_API_VERSION,
     method: "cancelRun",
     title: "Cancel Run",
-    description: "Cancel an active run.",
+    description:
+      "Cancel a run AND every transitive child-workflow descendant as one recursive operation. Time-travel forks are spared; continue-as-new continuations are not.",
     maturity: "stable",
     transport: "http+websocket",
     requiredScope: "run:write",
     requestSchema: objectSchema({ runId }, ["runId"]),
-    responseSchema: objectSchema({ runId, status: { type: "string", enum: ["cancelling"] } }, ["runId", "status"]),
-    errors: ["InvalidRequest", "Unauthorized", "Forbidden", "RUN_NOT_ACTIVE", "Internal"],
+    responseSchema: objectSchema(
+      {
+        runId,
+        won: booleanSchema("Whether this request won the durable cancellation claim."),
+        status: { type: "string", enum: ["cancelled", "already-terminal", "not-found"] },
+        terminalStatus: stringSchema("Persisted terminal status after cancellation finalization."),
+        repaired: booleanSchema("Whether replay repaired incomplete cancellation cleanup."),
+        cancellationSource,
+        cancelledAttempts: integerSchema("Attempts closed across the whole cancelled subtree.", 0),
+        descendants: arraySchema(cancelledRunOutcome, "Every descendant the cascade reached, excluding the root run."),
+        terminatedOwners: arraySchema(cancelledProcess, "Detached owner processes terminated by the cascade."),
+        terminatedAgents: arraySchema(cancelledProcess, "Agent process trees terminated for the cancelled subtree."),
+      },
+      ["runId", "won", "status", "repaired"],
+    ),
+    errors: ["InvalidRequest", "Unauthorized", "Forbidden", "RunNotFound", "RUN_NOT_ACTIVE", "Internal"],
     exampleRequest: { runId: "run_01" },
-    exampleResponse: { runId: "run_01", status: "cancelling" },
+    exampleResponse: {
+      runId: "run_01",
+      won: true,
+      status: "cancelled",
+      terminalStatus: "cancelled",
+      repaired: false,
+      cancellationSource: {
+        kind: "rpc",
+        detail: "websocket cancellation request",
+        clientPid: 4321,
+        requestId: "cancelRun-1",
+        clientIdentity: "user:operator",
+      },
+      cancelledAttempts: 2,
+      descendants: [{ runId: "run_01:child:review:0", depth: 1, action: "cancelled" }],
+      terminatedOwners: [{ runId: "run_01:child:review:0", pid: 4711 }],
+      terminatedAgents: [{ runId: "run_01:child:review:0", pid: 4712 }],
+    },
   },
   {
     version: SMITHERS_API_VERSION,
@@ -1098,10 +1186,12 @@ export const GATEWAY_RPC_DEFINITIONS = [
               model: stringSchema("Resolved provider model id."),
               agent: stringSchema("Agent id or adapter name."),
               inputTokens: integerSchema("Reported input tokens.", 0),
+              freshInputTokens: integerSchema("Reported input tokens excluding cache reads.", 0),
               outputTokens: integerSchema("Reported output tokens.", 0),
               cacheReadTokens: integerSchema("Reported cache-read tokens.", 0),
               cacheWriteTokens: integerSchema("Reported cache-write tokens.", 0),
               reasoningTokens: integerSchema("Reported reasoning tokens.", 0),
+              costUsd: { type: ["number", "null"], description: "Reported cost in USD, null when unknown." },
               timestampMs: integerSchema("Event timestamp in Unix epoch milliseconds.", 0),
             },
             [
@@ -1111,10 +1201,12 @@ export const GATEWAY_RPC_DEFINITIONS = [
               "model",
               "agent",
               "inputTokens",
+              "freshInputTokens",
               "outputTokens",
               "cacheReadTokens",
               "cacheWriteTokens",
               "reasoningTokens",
+              "costUsd",
               "timestampMs",
             ],
           ),
@@ -1135,10 +1227,12 @@ export const GATEWAY_RPC_DEFINITIONS = [
           model: "gpt-5.4-codex",
           agent: "codex-work",
           inputTokens: 120,
+          freshInputTokens: 80,
           outputTokens: 30,
           cacheReadTokens: 40,
           cacheWriteTokens: 5,
           reasoningTokens: 12,
+          costUsd: null,
           timestampMs: 1710000000000,
         },
       ],
@@ -1166,6 +1260,8 @@ export const GATEWAY_RPC_DEFINITIONS = [
         workflow: stringSchema("Optional workflow key filter."),
         parentRunId: stringSchema("Return only direct children of this run."),
         includeSystem: booleanSchema("Include internal system runs; they are excluded by default."),
+        owner: stringSchema("Admin-only owner filter; must be paired with app.", 1),
+        app: stringSchema("Admin-only application filter; must be paired with owner.", 1),
       }),
     }),
     responseSchema: arraySchema(runSummary, "Run summaries."),