@openclaw/gateway-protocol 2026.8.1-beta.3 → 2026.9.1-beta.1

package/dist/client-info.d.mts

@@ -57,14 +57,25 @@ declare const GATEWAY_CLIENT_MODES: {
 type GatewayClientMode = (typeof GATEWAY_CLIENT_MODES)[keyof typeof GATEWAY_CLIENT_MODES];
 /** Client metadata sent during gateway connection setup. */
 type GatewayClientInfo = {
-  /** Stable product/client identifier from `GATEWAY_CLIENT_IDS`. */id: GatewayClientId; /** Human-readable label for diagnostics; not used for policy decisions. */
-  displayName?: string; /** Client app or package version reported by the connecting process. */
-  version: string; /** Exact immutable artifact identity when the client can report one. */
-  buildId?: string; /** Runtime platform string, such as `darwin`, `ios`, `android`, or `web`. */
-  platform: string; /** Optional device family used by native clients for display and routing hints. */
-  deviceFamily?: string; /** Native hardware/model identifier when available. */
-  modelIdentifier?: string; /** Coarse category from `GATEWAY_CLIENT_MODES` for policy and diagnostics. */
-  mode: GatewayClientMode; /** Per-installation or per-process id used to distinguish same-product clients. */
+  /** Stable product/client identifier from `GATEWAY_CLIENT_IDS`. */
+  id: GatewayClientId;
+  /** Human-readable label for diagnostics; not used for policy decisions. */
+  displayName?: string;
+  /** Client app or package version reported by the connecting process. */
+  version: string;
+  /** Exact immutable artifact identity when the client can report one. */
+  buildId?: string;
+  /** Runtime platform string, such as `darwin`, `ios`, `android`, or `web`. */
+  platform: string;
+  /** Optional device family used by native clients for display and routing hints. */
+  deviceFamily?: string;
+  /** Native hardware/model identifier when available. */
+  modelIdentifier?: string;
+  /** Self-reported IANA time zone, such as `Europe/Vienna`, for presence display. */
+  timeZone?: string;
+  /** Coarse category from `GATEWAY_CLIENT_MODES` for policy and diagnostics. */
+  mode: GatewayClientMode;
+  /** Per-installation or per-process id used to distinguish same-product clients. */
   instanceId?: string;
 };
 /** Capability flags a client may advertise during the gateway handshake. */
@@ -80,6 +91,7 @@ declare const GATEWAY_CLIENT_CAPS: {
   readonly TERMINAL_OFFSET_SEQ: "terminal-offset-seq";
   readonly TOOL_EVENTS: "tool-events";
   readonly UI_COMMANDS: "ui-commands";
+  readonly USAGE_REFRESHING: "usage-refreshing";
 };
 /** Optional capability advertised by clients during gateway handshake. */
 type GatewayClientCap = (typeof GATEWAY_CLIENT_CAPS)[keyof typeof GATEWAY_CLIENT_CAPS];

package/dist/client-info.mjs

@@ -53,7 +53,8 @@ const GATEWAY_CLIENT_CAPS = {
 	TASK_SUGGESTIONS: "task-suggestions",
 	TERMINAL_OFFSET_SEQ: "terminal-offset-seq",
 	TOOL_EVENTS: "tool-events",
-	UI_COMMANDS: "ui-commands"
+	UI_COMMANDS: "ui-commands",
+	USAGE_REFRESHING: "usage-refreshing"
 };
 const GATEWAY_CLIENT_ID_SET = new Set(Object.values(GATEWAY_CLIENT_IDS));
 const GATEWAY_CLIENT_MODE_SET = new Set(Object.values(GATEWAY_CLIENT_MODES));

package/dist/frame-guards.d.mts

@@ -1,5 +1,4 @@
-import { a as EventFrame, c as GatewayFrame, f as RequestFrame, m as ResponseFrame, r as ErrorShape, t as ConnectParams, u as HelloOk } from "./frames-BKvowx_k.mjs";
-
+import { a as EventFrame, d as RequestFrame, l as HelloOk, p as ResponseFrame, r as ErrorShape, s as GatewayFrame, t as ConnectParams } from "./frames-BmksHL6e.mjs";
 //#region src/frame-guards.d.ts
 declare function isGatewayEventFrame(value: unknown): value is EventFrame;
 declare function isGatewayResponseFrame(value: unknown): value is ResponseFrame;

package/dist/{frames-BKvowx_k.d.mts → frames-BmksHL6e.d.mts}

@@ -1,16 +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 GATEWAY_RESTART_TARGET_SAFE: "gateway-restart-target-safe-v1";
-  readonly NODE_WORKER_BUNDLE_RETENTION: "node-worker-bundle-retention-v1";
-  readonly NODE_WORKER_BUNDLE_STATUS: "node-worker-bundle-status-v1";
-  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.
  *
@@ -38,12 +27,16 @@ 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>; /** @deprecated Accepted for the shipped v1 node-host envelope; current hosts use runner inventory. */
+  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;
@@ -79,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;
   }>;
@@ -95,6 +89,7 @@ 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>;
@@ -443,4 +438,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-DR-CyzeW.d.mts → gateway-error-details-yO9RdEKe.d.mts}

@@ -1,12 +1,19 @@
 //#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. */
+  /** @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. */

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

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