@openclaw/gateway-protocol 2026.9.3 → 2026.9.5

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -84,12 +84,15 @@ export declare const GATEWAY_CLIENT_CAPS: {
84
84
  readonly APPROVALS: "approvals";
85
85
  readonly EXEC_APPROVALS: "exec-approvals";
86
86
  readonly INLINE_WIDGETS: "inline-widgets";
87
+ readonly MODEL_CATALOG_SNAPSHOT: "model-catalog-snapshot";
88
+ readonly MODEL_SELECTION_POLICY: "model-selection-policy";
87
89
  readonly RUN_TOOL_BINDINGS: "run-tool-bindings";
88
90
  readonly SESSION_SCOPED_EVENTS: "session-scoped-events";
89
91
  readonly PLUGIN_APPROVALS: "plugin-approvals";
90
92
  readonly TASK_SUGGESTIONS: "task-suggestions";
91
93
  readonly TERMINAL_OFFSET_SEQ: "terminal-offset-seq";
92
94
  readonly TERMINAL_SESSION_METADATA: "terminal-session-metadata";
95
+ readonly TERMINAL_UPLOAD_PATH_STYLE: "terminal-upload-path-style";
93
96
  readonly TOOL_EVENTS: "tool-events";
94
97
  readonly UI_COMMANDS: "ui-commands";
95
98
  readonly USAGE_REFRESHING: "usage-refreshing";
@@ -44,12 +44,15 @@ const GATEWAY_CLIENT_CAPS = {
44
44
  APPROVALS: "approvals",
45
45
  EXEC_APPROVALS: "exec-approvals",
46
46
  INLINE_WIDGETS: "inline-widgets",
47
+ MODEL_CATALOG_SNAPSHOT: "model-catalog-snapshot",
48
+ MODEL_SELECTION_POLICY: "model-selection-policy",
47
49
  RUN_TOOL_BINDINGS: "run-tool-bindings",
48
50
  SESSION_SCOPED_EVENTS: "session-scoped-events",
49
51
  PLUGIN_APPROVALS: "plugin-approvals",
50
52
  TASK_SUGGESTIONS: "task-suggestions",
51
53
  TERMINAL_OFFSET_SEQ: "terminal-offset-seq",
52
54
  TERMINAL_SESSION_METADATA: "terminal-session-metadata",
55
+ TERMINAL_UPLOAD_PATH_STYLE: "terminal-upload-path-style",
53
56
  TOOL_EVENTS: "tool-events",
54
57
  UI_COMMANDS: "ui-commands",
55
58
  USAGE_REFRESHING: "usage-refreshing"
@@ -1,6 +1,6 @@
1
- import { a as EventFrame, d as RequestFrame, l as HelloOk, p as ResponseFrame, r as ErrorShape, s as GatewayFrame, t as ConnectParams } from "./frames-8A7sw44F.mjs";
1
+ import { a as EventFrame, d as RequestFrame, l as HelloOk, p as ResponseFrame, r as ErrorShape, s as GatewayFrame, t as ConnectParams, y as GATEWAY_SERVER_CAPS } from "./frames-X2k-UkK8.mjs";
2
2
  //#region src/frame-guards.d.ts
3
3
  export declare function isGatewayEventFrame(value: unknown): value is EventFrame;
4
4
  export declare function isGatewayResponseFrame(value: unknown): value is ResponseFrame;
5
5
  //#endregion
6
- export type { ConnectParams, ErrorShape, EventFrame, GatewayFrame, HelloOk, RequestFrame, ResponseFrame };
6
+ export { type ConnectParams, type ErrorShape, type EventFrame, GATEWAY_SERVER_CAPS, type GatewayFrame, type HelloOk, type RequestFrame, type ResponseFrame };
@@ -1,5 +1,6 @@
1
1
  import { r as isRecord } from "./record-coerce-BVp8Dr-B.mjs";
2
2
  import { t as isNonEmptyProtocolString } from "./protocol-value-normalization-DfM01tqg.mjs";
3
+ import { t as GATEWAY_SERVER_CAPS } from "./server-capabilities-Gfkxm7Ho.mjs";
3
4
  //#region src/frame-guards.ts
4
5
  function isNonNegativeInteger(value) {
5
6
  return typeof value === "number" && Number.isInteger(value) && value >= 0;
@@ -19,4 +20,4 @@ function isGatewayResponseFrame(value) {
19
20
  return value.error === void 0 || isGatewayErrorShape(value.error);
20
21
  }
21
22
  //#endregion
22
- export { isGatewayEventFrame, isGatewayResponseFrame };
23
+ export { GATEWAY_SERVER_CAPS, isGatewayEventFrame, isGatewayResponseFrame };
@@ -1,4 +1,29 @@
1
1
  import { Static, Type } from "typebox";
2
+ //#region src/server-capabilities.d.ts
3
+ /** Stable feature names advertised in Gateway hello responses. */
4
+ declare const GATEWAY_SERVER_CAPS: {
5
+ readonly BOARD_WIDGET_PUT_CANVAS_DOC: "board-widget-put-canvas-doc";
6
+ readonly CHAT_SEND_ROUTING_CONTRACT: "chat-send-routing-contract";
7
+ readonly GATEWAY_RESTART_TARGET_SAFE: "gateway-restart-target-safe-v1";
8
+ readonly MODEL_CATALOG_SNAPSHOT: "model-catalog-snapshot";
9
+ readonly NODE_WORKER_BUNDLE_RETENTION: "node-worker-bundle-retention-v1";
10
+ readonly NODE_WORKER_BUNDLE_STATUS: "node-worker-bundle-status-v1";
11
+ readonly NODE_WORKER_ENVIRONMENT_SESSION: "node-worker-environment-session-v1";
12
+ readonly NODE_WORKER_PORTAL_STREAM: "node-worker-portal-stream-v1";
13
+ readonly PUBLISHED_MODEL_CATALOG: "published-model-catalog";
14
+ readonly PROFILE_BINDING: "profile-binding-v1";
15
+ readonly PROGRESS_CARD_AGENT_SCOPE: "progress-card-agent-scope-v1";
16
+ readonly SESSION_SCOPED_CHAT_METADATA: "session-scoped-chat-metadata";
17
+ readonly SESSION_SCOPED_MODEL_CATALOG: "session-scoped-model-catalog";
18
+ readonly SESSION_UNREAD_ACK_CONTRACT: "session-unread-ack-contract";
19
+ readonly SESSION_GOAL_START: "session-goal-start-v1";
20
+ readonly SESSION_SETTINGS_CONTRACT: "session-settings-contract";
21
+ readonly SESSION_SETTINGS_CAS: "session-settings-cas-v1";
22
+ readonly SYSTEM_AGENT_WIZARD_CANCEL: "openclaw-chat-wizard-cancel";
23
+ readonly SYSTEM_AGENT_SETUP_MODEL_REF: "openclaw-setup-model-ref";
24
+ readonly TASK_SUGGESTIONS_ACCEPT_MODES: "taskSuggestions.acceptModes";
25
+ };
26
+ //#endregion
2
27
  //#region src/schema/frames.d.ts
3
28
  /**
4
29
  * Top-level gateway frame schemas.
@@ -47,6 +72,15 @@ declare const ConnectParamsSchema: Type.TObject<{
47
72
  pathEnv: Type.TOptional<Type.TString>;
48
73
  role: Type.TOptional<Type.TString>;
49
74
  scopes: Type.TOptional<Type.TArray<Type.TString>>;
75
+ /** Initial catalog read scope; method authorization still owns access. */
76
+ modelCatalog: Type.TOptional<Type.TUnion<[Type.TObject<{
77
+ agentId: Type.TOptional<Type.TString>;
78
+ sessionKey: Type.TOptional<Type.TString>;
79
+ }>, Type.TObject<{
80
+ agentId: Type.TOptional<Type.TString>;
81
+ shortId: Type.TString;
82
+ slugHint: Type.TOptional<Type.TString>;
83
+ }>]>>;
50
84
  device: Type.TOptional<Type.TObject<{
51
85
  id: Type.TString;
52
86
  publicKey: Type.TString;
@@ -87,6 +121,7 @@ declare const HelloOkSchema: Type.TObject<{
87
121
  }>>;
88
122
  presence: Type.TArray<Type.TObject<{
89
123
  host: Type.TOptional<Type.TString>;
124
+ clientId: Type.TOptional<Type.TString>;
90
125
  ip: Type.TOptional<Type.TString>;
91
126
  version: Type.TOptional<Type.TString>;
92
127
  platform: Type.TOptional<Type.TString>;
@@ -334,6 +369,7 @@ declare const HelloOkSchema: Type.TObject<{
334
369
  icon: Type.TOptional<Type.TString>;
335
370
  path: Type.TOptional<Type.TString>;
336
371
  placement: Type.TOptional<Type.TString>;
372
+ slug: Type.TOptional<Type.TString>;
337
373
  requiresGatewayAuth: Type.TOptional<Type.TBoolean>;
338
374
  group: Type.TOptional<Type.TUnion<[Type.TLiteral<"control">, Type.TLiteral<"agent">]>>;
339
375
  order: Type.TOptional<Type.TNumber>;
@@ -345,6 +381,7 @@ declare const HelloOkSchema: Type.TObject<{
345
381
  }>>>;
346
382
  pluginSurfaceUrls: Type.TOptional<Type.TRecord<"^.*$", Type.TString>>;
347
383
  auth: Type.TObject<{
384
+ method: Type.TOptional<Type.TUnion<[Type.TLiteral<"none">, Type.TLiteral<"token">, Type.TLiteral<"password">, Type.TLiteral<"tailscale">, Type.TLiteral<"device-token">, Type.TLiteral<"bootstrap-token">, Type.TLiteral<"trusted-proxy">]>>;
348
385
  deviceToken: Type.TOptional<Type.TString>;
349
386
  recoveryMigrationAllowed: Type.TOptional<Type.TLiteral<true>>;
350
387
  recoveryScope: Type.TOptional<Type.TString>;
@@ -385,6 +422,7 @@ declare const RequestFrameSchema: Type.TObject<{
385
422
  method: Type.TString;
386
423
  params: Type.TOptional<Type.TUnknown>;
387
424
  traceparent: Type.TOptional<Type.TString>;
425
+ expectedProfileId: Type.TOptional<Type.TString>;
388
426
  }>;
389
427
  /** Server response frame envelope paired with a prior request id. */
390
428
  declare const ResponseFrameSchema: Type.TObject<{
@@ -410,6 +448,7 @@ declare const EventFrameSchema: Type.TObject<{
410
448
  presence: Type.TInteger;
411
449
  health: Type.TInteger;
412
450
  }>>;
451
+ recipientProfileId: Type.TOptional<Type.TString>;
413
452
  }>;
414
453
  declare const GatewayFrameSchema: Type.TUnion<[Type.TObject<{
415
454
  type: Type.TLiteral<"req">;
@@ -417,6 +456,7 @@ declare const GatewayFrameSchema: Type.TUnion<[Type.TObject<{
417
456
  method: Type.TString;
418
457
  params: Type.TOptional<Type.TUnknown>;
419
458
  traceparent: Type.TOptional<Type.TString>;
459
+ expectedProfileId: Type.TOptional<Type.TString>;
420
460
  }>, Type.TObject<{
421
461
  type: Type.TLiteral<"res">;
422
462
  id: Type.TString;
@@ -438,6 +478,7 @@ declare const GatewayFrameSchema: Type.TUnion<[Type.TObject<{
438
478
  presence: Type.TInteger;
439
479
  health: Type.TInteger;
440
480
  }>>;
481
+ recipientProfileId: Type.TOptional<Type.TString>;
441
482
  }>]>;
442
483
  type ConnectParams = Static<typeof ConnectParamsSchema>;
443
484
  type HelloOk = Static<typeof HelloOkSchema>;
@@ -449,4 +490,4 @@ type GatewayFrame = Static<typeof GatewayFrameSchema>;
449
490
  type TickEvent = Static<typeof TickEventSchema>;
450
491
  type ShutdownEvent = Static<typeof ShutdownEventSchema>;
451
492
  //#endregion
452
- 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 };
493
+ 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, GATEWAY_SERVER_CAPS as y };