@openclaw/gateway-protocol 2026.8.1-beta.2 → 2026.8.1

package/dist/{frames-B9De7i2H.d.mts → frames-CAy_vx4s.d.mts}

@@ -1,13 +1,5 @@
 import { Static, Type } from "typebox";
-
 //#region src/schema/frames.d.ts
-declare const GATEWAY_SERVER_CAPS: {
-  readonly BOARD_WIDGET_PUT_CANVAS_DOC: "board-widget-put-canvas-doc";
-  readonly CHAT_SEND_ROUTING_CONTRACT: "chat-send-routing-contract";
-  readonly SYSTEM_AGENT_WIZARD_CANCEL: "openclaw-chat-wizard-cancel";
-  readonly SYSTEM_AGENT_SETUP_MODEL_REF: "openclaw-setup-model-ref";
-  readonly TASK_SUGGESTIONS_ACCEPT_MODES: "taskSuggestions.acceptModes";
-};
 /**
  * Top-level gateway frame schemas.
  *
@@ -35,16 +27,21 @@ declare const ConnectParamsSchema: Type.TObject<{
     platform: Type.TString;
     deviceFamily: Type.TOptional<Type.TString>;
     modelIdentifier: Type.TOptional<Type.TString>;
+    /** Self-reported IANA zone. Bounded because the longest real name is well under this cap. */
+    timeZone: Type.TOptional<Type.TString>;
     mode: Type.TEnum<["webchat", "cli", "worker", "test", "probe", "ui", "backend", "node"]>;
     instanceId: Type.TOptional<Type.TString>;
   }>;
   caps: Type.TOptional<Type.TArray<Type.TString>>;
-  commands: Type.TOptional<Type.TArray<Type.TString>>; /** Additive Computer Use declaration; the owning core contract validates its bounded shape. */
-  computerUse: Type.TOptional<Type.TUnknown>; /** Additive node-local worker build identity; presence advertises session hosting. */
+  commands: Type.TOptional<Type.TArray<Type.TString>>;
+  /** Additive Computer Use declaration; the owning core contract validates its bounded shape. */
+  computerUse: Type.TOptional<Type.TUnknown>;
+  /** @deprecated Accepted for the shipped v1 node-host envelope; current hosts use runner inventory. */
   workerRuns: Type.TOptional<Type.TObject<{
     bundleHash: Type.TString;
     openclawVersion: Type.TString;
     protocolFeatures: Type.TArray<Type.TString>;
+    bundlePrewarm: Type.TOptional<Type.TInteger>;
   }>>;
   permissions: Type.TOptional<Type.TRecord<"^.*$", Type.TBoolean>>;
   pathEnv: Type.TOptional<Type.TString>;
@@ -75,6 +72,7 @@ declare const HelloOkSchema: Type.TObject<{
   server: Type.TObject<{
     version: Type.TString;
     buildId: Type.TOptional<Type.TString>;
+    bootId: Type.TOptional<Type.TString>;
     controlUiBuildSource: Type.TOptional<Type.TUnion<[Type.TLiteral<"bundled">, Type.TLiteral<"configured">]>>;
     connId: Type.TString;
   }>;
@@ -91,18 +89,25 @@ declare const HelloOkSchema: Type.TObject<{
       platform: Type.TOptional<Type.TString>;
       deviceFamily: Type.TOptional<Type.TString>;
       modelIdentifier: Type.TOptional<Type.TString>;
+      timeZone: Type.TOptional<Type.TString>;
       mode: Type.TOptional<Type.TString>;
       lastInputSeconds: Type.TOptional<Type.TInteger>;
       reason: Type.TOptional<Type.TString>;
       tags: Type.TOptional<Type.TArray<Type.TString>>;
       text: Type.TOptional<Type.TString>;
       ts: Type.TInteger;
+      onlineSince: Type.TOptional<Type.TInteger>;
+      lastActivityAt: Type.TOptional<Type.TInteger>;
       deviceId: Type.TOptional<Type.TString>;
       roles: Type.TOptional<Type.TArray<Type.TString>>;
       scopes: Type.TOptional<Type.TArray<Type.TString>>;
       instanceId: Type.TOptional<Type.TString>;
       user: Type.TOptional<Type.TObject<{
         id: Type.TString;
+        identity: Type.TOptional<Type.TObject<{
+          type: Type.TLiteral<"profile">;
+          id: Type.TString;
+        }>>;
         email: Type.TOptional<Type.TString>;
         name: Type.TOptional<Type.TString>;
         avatarUrl: Type.TOptional<Type.TString>;
@@ -238,6 +243,7 @@ declare const HelloOkSchema: Type.TObject<{
     stateDir: Type.TOptional<Type.TString>;
     sessionDefaults: Type.TOptional<Type.TObject<{
       defaultAgentId: Type.TString;
+      modelConfigured: Type.TOptional<Type.TBoolean>;
       ownership: Type.TOptional<Type.TUnion<[Type.TLiteral<"sole">, Type.TLiteral<"legacy">, Type.TLiteral<"explicit">]>>;
       selectionRequired: Type.TOptional<Type.TBoolean>;
       mainKey: Type.TString;
@@ -322,6 +328,7 @@ declare const HelloOkSchema: Type.TObject<{
     description: Type.TOptional<Type.TString>;
     icon: Type.TOptional<Type.TString>;
     path: Type.TOptional<Type.TString>;
+    placement: Type.TOptional<Type.TString>;
     requiresGatewayAuth: Type.TOptional<Type.TBoolean>;
     group: Type.TOptional<Type.TUnion<[Type.TLiteral<"control">, Type.TLiteral<"agent">]>>;
     order: Type.TOptional<Type.TNumber>;
@@ -332,9 +339,6 @@ declare const HelloOkSchema: Type.TObject<{
     label: Type.TString;
   }>>>;
   pluginSurfaceUrls: Type.TOptional<Type.TRecord<"^.*$", Type.TString>>;
-  deviceAuthMigration: Type.TOptional<Type.TObject<{
-    pending: Type.TLiteral<true>;
-  }>>;
   auth: Type.TObject<{
     deviceToken: Type.TOptional<Type.TString>;
     recoveryMigrationAllowed: Type.TOptional<Type.TLiteral<true>>;
@@ -440,4 +444,4 @@ type GatewayFrame = Static<typeof GatewayFrameSchema>;
 type TickEvent = Static<typeof TickEventSchema>;
 type ShutdownEvent = Static<typeof ShutdownEventSchema>;
 //#endregion
-export { ShutdownEventSchema as _, EventFrame as a, GatewayFrame as c, HelloOkSchema as d, RequestFrame as f, ShutdownEvent as g, ResponseFrameSchema as h, ErrorShapeSchema as i, GatewayFrameSchema as l, ResponseFrame as m, ConnectParamsSchema as n, EventFrameSchema as o, RequestFrameSchema as p, ErrorShape as r, GATEWAY_SERVER_CAPS as s, ConnectParams as t, HelloOk as u, TickEvent as v, TickEventSchema as y };
+export { TickEvent as _, EventFrame as a, GatewayFrameSchema as c, RequestFrame as d, RequestFrameSchema as f, ShutdownEventSchema as g, ShutdownEvent as h, ErrorShapeSchema as i, HelloOk as l, ResponseFrameSchema as m, ConnectParamsSchema as n, EventFrameSchema as o, ResponseFrame as p, ErrorShape as r, GatewayFrame as s, ConnectParams as t, HelloOkSchema as u, TickEventSchema as v };

package/dist/gateway-error-details-GvUeus2z.d.mts

@@ -0,0 +1,102 @@
+//#region src/gateway-error-details.d.ts
+/** Gateway JSON-RPC style error codes shared by clients and server handlers. */
+declare const ErrorCodes: {
+  /** @deprecated Retained for source compatibility; no current server emitter. */
+  readonly NOT_LINKED: "NOT_LINKED";
+  /** Device exists but still needs an explicit pairing approval. */
+  readonly NOT_PAIRED: "NOT_PAIRED";
+  /** @deprecated Retained for source compatibility; no current server emitter. */
+  readonly AGENT_TIMEOUT: "AGENT_TIMEOUT";
+  /** Request payload failed protocol validation or method preconditions. */
+  readonly INVALID_REQUEST: "INVALID_REQUEST";
+  /** Authenticated caller lacks permission for the requested operation. */
+  readonly FORBIDDEN: "FORBIDDEN";
+  /** Approval resolution referenced a missing or expired approval request. */
+  readonly APPROVAL_NOT_FOUND: "APPROVAL_NOT_FOUND";
+  /** Gateway service or required backend is temporarily unavailable. */
+  readonly UNAVAILABLE: "UNAVAILABLE";
+};
+/** Closed set of canonical gateway error code strings. */
+type ErrorCode = (typeof ErrorCodes)[keyof typeof ErrorCodes];
+/** Stable discriminants for structured method-level failures. */
+declare const GatewayErrorDetailCodes: {
+  readonly CRON_JOB_NOT_FOUND: "CRON_JOB_NOT_FOUND";
+  readonly MISSING_SCOPE: "MISSING_SCOPE";
+  readonly MCP_APP_VIEW_EXPIRED: "MCP_APP_VIEW_EXPIRED";
+  readonly OUTBOUND_DELIVERY_QUEUED: "OUTBOUND_DELIVERY_QUEUED";
+  readonly USER_PREFS_LIMIT_EXCEEDED: "USER_PREFS_LIMIT_EXCEEDED";
+  readonly SESSION_COMPANION_BUSY: "SESSION_COMPANION_BUSY";
+  readonly SKILL_PROPOSAL_REVISION_CHANGED: "SKILL_PROPOSAL_REVISION_CHANGED";
+  readonly PROJECT_CLONE_FAILED: "PROJECT_CLONE_FAILED";
+  readonly UNKNOWN_AGENT_ID: "UNKNOWN_AGENT_ID";
+  readonly WIZARD_NOT_FOUND: "WIZARD_NOT_FOUND";
+  readonly SETUP_ADMISSION_BUSY: "SETUP_ADMISSION_BUSY";
+};
+/** Missing cron automation identified by its exact store key. */
+type CronJobNotFoundErrorDetails = {
+  code: typeof GatewayErrorDetailCodes.CRON_JOB_NOT_FOUND;
+  jobId: string;
+};
+/** Missing operator-scope details shared by WebSocket and HTTP responses. */
+type MissingScopeErrorDetails = {
+  code: typeof GatewayErrorDetailCodes.MISSING_SCOPE;
+  missingScope: string;
+  requiredScopes: string[];
+};
+type McpAppViewExpiredErrorDetails = {
+  code: typeof GatewayErrorDetailCodes.MCP_APP_VIEW_EXPIRED;
+};
+type OutboundDeliveryQueuedErrorDetails = {
+  code: typeof GatewayErrorDetailCodes.OUTBOUND_DELIVERY_QUEUED;
+};
+/** Per-profile preference quota details returned by users.prefs.set. */
+type UserPrefsLimitExceededErrorDetails = {
+  code: typeof GatewayErrorDetailCodes.USER_PREFS_LIMIT_EXCEEDED;
+  limit: number;
+  currentCount: number;
+};
+/** Unknown agent details carried by agent-scoped method validation failures. */
+type UnknownAgentIdErrorDetails = {
+  code: typeof GatewayErrorDetailCodes.UNKNOWN_AGENT_ID;
+  agentId: string;
+};
+/** Setup rejected before its task or wizard session was admitted. */
+type SetupAdmissionBusyErrorDetails = {
+  code: typeof GatewayErrorDetailCodes.SETUP_ADMISSION_BUSY;
+};
+/** Missing or expired process-local setup wizard session. */
+type WizardNotFoundErrorDetails = {
+  code: typeof GatewayErrorDetailCodes.WIZARD_NOT_FOUND;
+};
+type ProjectCloneFailureCause = "invalid_url" | "auth_required" | "not_found" | "network" | "target_exists" | "clone_failed";
+type ProjectCloneErrorDetails = {
+  code: typeof GatewayErrorDetailCodes.PROJECT_CLONE_FAILED;
+  cause: ProjectCloneFailureCause;
+};
+/** Optimistic-concurrency mismatch for an operator-reviewed Skill Workshop draft. */
+type SkillProposalRevisionChangedErrorDetails = {
+  code: typeof GatewayErrorDetailCodes.SKILL_PROPOSAL_REVISION_CHANGED;
+  expectedRevisionHash: string;
+  currentRevisionHash: string;
+};
+/** Structured details emitted by method-level failures. */
+type GatewayErrorDetails = CronJobNotFoundErrorDetails | MissingScopeErrorDetails | McpAppViewExpiredErrorDetails | OutboundDeliveryQueuedErrorDetails | UserPrefsLimitExceededErrorDetails | SkillProposalRevisionChangedErrorDetails | ProjectCloneErrorDetails | UnknownAgentIdErrorDetails | WizardNotFoundErrorDetails | SetupAdmissionBusyErrorDetails;
+/** Reads a typed cron lookup miss without parsing operator-facing prose. */
+declare function readCronJobNotFoundError(error: unknown): CronJobNotFoundErrorDetails | null;
+/** Builds the canonical stale-draft details shared by Skill Workshop RPCs. */
+declare function buildSkillProposalRevisionChangedErrorDetails(params: {
+  expectedRevisionHash: string;
+  currentRevisionHash: string;
+}): SkillProposalRevisionChangedErrorDetails;
+/** Reads a stale Skill Workshop decision without parsing operator-facing prose. */
+declare function readSkillProposalRevisionChangedError(error: unknown): SkillProposalRevisionChangedErrorDetails | null;
+/** Reads validated missing-scope details from an untrusted protocol payload. */
+declare function readMissingScopeErrorDetails(details: unknown): MissingScopeErrorDetails | null;
+declare function isMcpAppViewExpiredError(error: unknown): boolean;
+/**
+ * Reads a method-level missing-scope failure, preferring structured details.
+ * The message fallback keeps clients compatible with gateways predating structured details.
+ */
+declare function readMissingScopeError(error: unknown): MissingScopeErrorDetails | null;
+//#endregion
+export { isMcpAppViewExpiredError as _, GatewayErrorDetails as a, readMissingScopeErrorDetails as b, OutboundDeliveryQueuedErrorDetails as c, SetupAdmissionBusyErrorDetails as d, SkillProposalRevisionChangedErrorDetails as f, buildSkillProposalRevisionChangedErrorDetails as g, WizardNotFoundErrorDetails as h, GatewayErrorDetailCodes as i, ProjectCloneErrorDetails as l, UserPrefsLimitExceededErrorDetails as m, ErrorCode as n, McpAppViewExpiredErrorDetails as o, UnknownAgentIdErrorDetails as p, ErrorCodes as r, MissingScopeErrorDetails as s, CronJobNotFoundErrorDetails as t, ProjectCloneFailureCause as u, readCronJobNotFoundError as v, readSkillProposalRevisionChangedError as x, readMissingScopeError as y };

package/dist/gateway-error-details.d.mts

@@ -1,2 +1,2 @@
-import { a as McpAppViewExpiredErrorDetails, c as ProjectCloneFailureCause, d as WizardNotFoundErrorDetails, f as isMcpAppViewExpiredError, i as GatewayErrorDetails, l as UnknownAgentIdErrorDetails, m as readMissingScopeErrorDetails, n as ErrorCodes, o as MissingScopeErrorDetails, p as readMissingScopeError, r as GatewayErrorDetailCodes, s as ProjectCloneErrorDetails, t as ErrorCode, u as UserPrefsLimitExceededErrorDetails } from "./gateway-error-details-BXoMHq1i.mjs";
-export { ErrorCode, ErrorCodes, GatewayErrorDetailCodes, GatewayErrorDetails, McpAppViewExpiredErrorDetails, MissingScopeErrorDetails, ProjectCloneErrorDetails, ProjectCloneFailureCause, UnknownAgentIdErrorDetails, UserPrefsLimitExceededErrorDetails, WizardNotFoundErrorDetails, isMcpAppViewExpiredError, readMissingScopeError, readMissingScopeErrorDetails };
+import { _ as isMcpAppViewExpiredError, a as GatewayErrorDetails, b as readMissingScopeErrorDetails, c as OutboundDeliveryQueuedErrorDetails, d as SetupAdmissionBusyErrorDetails, f as SkillProposalRevisionChangedErrorDetails, g as buildSkillProposalRevisionChangedErrorDetails, h as WizardNotFoundErrorDetails, i as GatewayErrorDetailCodes, l as ProjectCloneErrorDetails, m as UserPrefsLimitExceededErrorDetails, n as ErrorCode, o as McpAppViewExpiredErrorDetails, p as UnknownAgentIdErrorDetails, r as ErrorCodes, s as MissingScopeErrorDetails, t as CronJobNotFoundErrorDetails, u as ProjectCloneFailureCause, v as readCronJobNotFoundError, x as readSkillProposalRevisionChangedError, y as readMissingScopeError } from "./gateway-error-details-GvUeus2z.mjs";
+export { CronJobNotFoundErrorDetails, ErrorCode, ErrorCodes, GatewayErrorDetailCodes, GatewayErrorDetails, McpAppViewExpiredErrorDetails, MissingScopeErrorDetails, OutboundDeliveryQueuedErrorDetails, ProjectCloneErrorDetails, ProjectCloneFailureCause, SetupAdmissionBusyErrorDetails, SkillProposalRevisionChangedErrorDetails, UnknownAgentIdErrorDetails, UserPrefsLimitExceededErrorDetails, WizardNotFoundErrorDetails, buildSkillProposalRevisionChangedErrorDetails, isMcpAppViewExpiredError, readCronJobNotFoundError, readMissingScopeError, readMissingScopeErrorDetails, readSkillProposalRevisionChangedError };

package/dist/gateway-error-details.mjs

@@ -1,4 +1,4 @@
-import { t as asProtocolRecord } from "./protocol-value-normalization-Bexl3yr1.mjs";
+import { t as asNullableRecord } from "./record-coerce-BKHrZ46I.mjs";
 //#region src/gateway-error-details.ts
 /** Gateway JSON-RPC style error codes shared by clients and server handlers. */
 const ErrorCodes = {
@@ -19,18 +19,53 @@ const ErrorCodes = {
 };
 /** Stable discriminants for structured method-level failures. */
 const GatewayErrorDetailCodes = {
+	CRON_JOB_NOT_FOUND: "CRON_JOB_NOT_FOUND",
 	MISSING_SCOPE: "MISSING_SCOPE",
 	MCP_APP_VIEW_EXPIRED: "MCP_APP_VIEW_EXPIRED",
+	OUTBOUND_DELIVERY_QUEUED: "OUTBOUND_DELIVERY_QUEUED",
 	USER_PREFS_LIMIT_EXCEEDED: "USER_PREFS_LIMIT_EXCEEDED",
 	SESSION_COMPANION_BUSY: "SESSION_COMPANION_BUSY",
+	SKILL_PROPOSAL_REVISION_CHANGED: "SKILL_PROPOSAL_REVISION_CHANGED",
 	PROJECT_CLONE_FAILED: "PROJECT_CLONE_FAILED",
 	UNKNOWN_AGENT_ID: "UNKNOWN_AGENT_ID",
-	WIZARD_NOT_FOUND: "WIZARD_NOT_FOUND"
+	WIZARD_NOT_FOUND: "WIZARD_NOT_FOUND",
+	SETUP_ADMISSION_BUSY: "SETUP_ADMISSION_BUSY"
 };
 const LEGACY_MISSING_SCOPE_PATTERN = /\bmissing scope:\s*([a-z0-9._-]+)/i;
+const SHA256_PATTERN = /^[a-fA-F0-9]{64}$/;
+/** Reads a typed cron lookup miss without parsing operator-facing prose. */
+function readCronJobNotFoundError(error) {
+	const details = asNullableRecord(asNullableRecord(error)?.details);
+	if (details?.code !== GatewayErrorDetailCodes.CRON_JOB_NOT_FOUND) return null;
+	const jobId = typeof details.jobId === "string" ? details.jobId.trim() : "";
+	return jobId ? {
+		code: GatewayErrorDetailCodes.CRON_JOB_NOT_FOUND,
+		jobId
+	} : null;
+}
+/** Builds the canonical stale-draft details shared by Skill Workshop RPCs. */
+function buildSkillProposalRevisionChangedErrorDetails(params) {
+	return {
+		code: GatewayErrorDetailCodes.SKILL_PROPOSAL_REVISION_CHANGED,
+		expectedRevisionHash: params.expectedRevisionHash,
+		currentRevisionHash: params.currentRevisionHash
+	};
+}
+/** Reads a stale Skill Workshop decision without parsing operator-facing prose. */
+function readSkillProposalRevisionChangedError(error) {
+	const details = asNullableRecord(asNullableRecord(error)?.details);
+	if (details?.code !== GatewayErrorDetailCodes.SKILL_PROPOSAL_REVISION_CHANGED) return null;
+	const expectedRevisionHash = typeof details.expectedRevisionHash === "string" ? details.expectedRevisionHash : "";
+	const currentRevisionHash = typeof details.currentRevisionHash === "string" ? details.currentRevisionHash : "";
+	if (!SHA256_PATTERN.test(expectedRevisionHash) || !SHA256_PATTERN.test(currentRevisionHash)) return null;
+	return buildSkillProposalRevisionChangedErrorDetails({
+		expectedRevisionHash,
+		currentRevisionHash
+	});
+}
 /** Reads validated missing-scope details from an untrusted protocol payload. */
 function readMissingScopeErrorDetails(details) {
-	const record = asProtocolRecord(details);
+	const record = asNullableRecord(details);
 	if (record?.code !== GatewayErrorDetailCodes.MISSING_SCOPE) return null;
 	const missingScope = typeof record.missingScope === "string" ? record.missingScope.trim() : "";
 	const requiredScopes = Array.isArray(record.requiredScopes) ? record.requiredScopes.map((scope) => typeof scope === "string" ? scope.trim() : "") : [];
@@ -42,14 +77,14 @@ function readMissingScopeErrorDetails(details) {
 	};
 }
 function isMcpAppViewExpiredError(error) {
-	return asProtocolRecord(asProtocolRecord(error)?.details)?.code === GatewayErrorDetailCodes.MCP_APP_VIEW_EXPIRED;
+	return asNullableRecord(asNullableRecord(error)?.details)?.code === GatewayErrorDetailCodes.MCP_APP_VIEW_EXPIRED;
 }
 /**
 * Reads a method-level missing-scope failure, preferring structured details.
 * The message fallback keeps clients compatible with gateways predating structured details.
 */
 function readMissingScopeError(error) {
-	const record = asProtocolRecord(error);
+	const record = asNullableRecord(error);
 	if (!record) return null;
 	const structured = readMissingScopeErrorDetails(record.details);
 	if (structured) return structured;
@@ -64,4 +99,4 @@ function readMissingScopeError(error) {
 	} : null;
 }
 //#endregion
-export { ErrorCodes, GatewayErrorDetailCodes, isMcpAppViewExpiredError, readMissingScopeError, readMissingScopeErrorDetails };
+export { ErrorCodes, GatewayErrorDetailCodes, buildSkillProposalRevisionChangedErrorDetails, isMcpAppViewExpiredError, readCronJobNotFoundError, readMissingScopeError, readMissingScopeErrorDetails, readSkillProposalRevisionChangedError };