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

package/CHANGELOG.md

@@ -3,18 +3,29 @@
 Wire-protocol and schema contracts for the OpenClaw Gateway (WebSocket JSON-RPC-style
 frames, handshake, and method/event payload schemas). Protocol version is negotiated
 per connection via `minProtocol`/`maxProtocol`. This log covers the wire protocol
-version and the additive schema surface. Dates are authoring dates (2026).
+version and schema surface, including removals and semantic changes. Dates are
+authoring dates (2026), not package publication dates.
 
 ## Unreleased
 
-- Add bounded `sessions.patchMany` session mutation orchestration.
-- Preserve required legacy agent-default fields while adding honest `ownership` and `selectionRequired` state to agent lists and initial snapshots.
-- Add semantic `agent` / `system` roster kinds negotiated through the `agent-kind` client capability.
-- Rename structured-question item `id` to `questionId` and flatten keyed answer arrays.
-- Slim worker and session-catalog payloads to the active wire contract.
-- Remove dead protocol surfaces and add since-vintage metadata to retained schemas and methods.
-- Add optional `step` on `SystemAgentChatResult` carrying the full awaited wizard step.
-- Project plugin tab `placement` in `hello-ok` so active plugins can target native Control UI routes.
+No changes outside the dated history below.
+
+## Deferred to the next wire version
+
+Changes that are agreed but intentionally NOT shipped, because they alter the
+negotiated shape of the current wire version. A version bump is an explicit
+breaking event for third-party clients (see "Notes for external versioning"), so
+each entry stays here until an owner approves the bump and lands it together with
+client follow-through. Add an entry whenever you defer a shape change; remove it
+in the commit that bumps the version.
+
+- **Remove `execSecurity` / `execAsk` from `SessionsPatchMutation`.** Retired in
+  favour of `permissionMode` (PR #132740, landed `a151c1e0d35`). The properties
+  remain declared in the closed v4 mutation schema so existing v4 callers keep a
+  valid request shape; the applier rejects either field before any mutation with
+  guidance naming `permissionMode` and `/exec`. Deleting the properties changes
+  the closed-object shape, so it waits for the bump. Code marker:
+  `packages/gateway-protocol/src/schema/sessions-patch.ts`.
 
 ## Protocol v4 (current)
 
@@ -62,7 +73,7 @@ wizard. (v3 `hello-ok` carried `canvasHostUrl`; v4 replaced it — see above.)
 
 ## Schema surface history
 
-Additive method/event/schema families added over time. Pure refactors, test-only, and
+Method/event/schema changes over time. Pure refactors, test-only, and
 docs commits are omitted. The package was extracted from `src/gateway/protocol` to
 `packages/gateway-protocol` on 2026-05-29 (#87797); paths before that date lived under
 the old tree.
@@ -103,7 +114,8 @@ Enhancement-only month (no new schema modules):
 ### 2026-07 (largest expansion)
 
 - Add terminal family: `terminal.*` RPC methods/events, detach/reattach with output
-  replay, `terminal.list`/`terminal.text`, and file uploads into terminals (#107364).
+  replay, `terminal.list`/`terminal.text`, and file uploads into terminals (#107364;
+  `terminal.text` removed in August by #121387).
 - Add managed git worktrees: lifecycle create/provision/snapshot/restore/GC (#100535),
   new-session-in-worktree (#100788), session worktree targeting and branch listing
   (#103432); add read-only `agents.workspace` browsing RPCs (#100738).
@@ -130,20 +142,102 @@ Enhancement-only month (no new schema modules):
 - Add cron event triggers via polled condition-watcher scripts (#101195) and native
   mobile Automations parity (#106355).
 - Add system-agent conversational onboarding (#99935); rename `crestodian.*` methods to
-  `openclaw.chat` / `openclaw.setup.*` (2026-07-14, `a6a0716`); add typed hosted-wizard
-  steps and answers to `openclaw.chat` (#114631).
+  `openclaw.chat` / `openclaw.setup.*` (2026-07-14, `a6a0716`).
 - Add typed structured questions / `ask_user` with live option cards (#109922, #110242)
   and the questions schema module.
 - Add ui-command / screen-tool Control UI layout control and capability-gated
   `show_widget` inline web chat widgets (#101840).
 - Add direct watch/watchOS node connect to Gateway (#102893); widen node/probe protocol
   acceptance to N-1 (#101109).
+- Add session boards: `board.get` / `board.update`, widget put/grant and event schemas; pinned MCP apps, `board.widget.appView`, lease re-mint, declared network/tool grants, and ticketed widget actions (#110960, #111524, #111687).
+- Add session visibility (`shared`, `read-only`, `suggest`, `draft`), `session.members.*`, `session.visibility.set`, and server-enforced participation (#112787).
+- Add canonical session lineage and typed `SessionRow`: creation provenance, fork ancestry, generation links, and catalog `createdBy` renamed to `createdActor`; remove writable spawn-lineage fields from `sessions.patch` (#111861).
+- Add durable `users.*` profiles with email aliases, display names, and avatars (#111224).
+- Add `session.discussion.info` / `session.discussion.open` with discussion state and URLs (#111337).
+- Add paginated `openclaw.changes.list` with typed change sources and summaries (#111286).
+- Add durable client voice sessions: `voiceSessionId`, `voice-transcript` capability, `talk.client.transcript`, and `talk.client.close` (#111216).
+- Add `session.suggestions.*`, suggestion resolution events, and `session.typing` indicators (#113173).
+- Add machine-readable `FORBIDDEN` / `MISSING_SCOPE` errors with `missingScope` and `requiredScopes` (#110925, #111013).
+- Add Skill Workshop evaluation and lifecycle replay through `skills.proposals.evaluate` / `skills.proposals.events.list`, revision hashes, and evaluation outcomes (#115606).
+- Add `channels.pairing.list` / `approve` / `dismiss` for pending DM sender access requests (#112401).
+- Add custom session `icon` values (emoji, named icon, or SVG; removed in August by #121263) (#110682).
+- Add semantic `agent` / `system` roster kinds negotiated through the `agent-kind` client capability (#111920).
+- Rename structured-question item `id` to `questionId`, flatten keyed answer arrays, and cap input headers at 12 characters; rename catalog `openClawSessionKey` to `sessionKey`, make cursor maps optional, and type the health snapshot (#111041).
+- Add release-vintage metadata to core methods and selected schemas; consolidate worker schema/type exports without changing their payload shape (#111041).
+
+### 2026-08
+
+#### Removed
+
+- Remove `terminal.text`, `sessions.compaction.get`, `sessions.unsubscribe`, `doctor.memory.remHarness`, and `voicewake.routing.set` (#121387). `terminal.list` remains; `gateway.restart.preflight` was removed in the same change and restored by #121757.
+- Remove `talk.session.join` / `startTurn` / `endTurn` / `cancelTurn` and their unused join/turn/cancel-turn schemas (#121387). `TalkSessionTurnParams` / `TalkSessionTurnResult` disappear; `TalkEvent` and `talk.event` remain. `talk.session.cancelOutput` remains, with a new result contract described below.
+- Remove the July custom session `icon` contract (#121263); restore emoji icons and then named glyphs with a new shape, without the former SVG support (#124034, #124629).
+- Remove `hello-ok.deviceAuthMigration` (#124667) and beta-only `chat.send.expectedRunId` (#125921; introduced by #120285); active-run start-or-steer becomes Gateway-owned (#125808).
+- Replace same-month `sessions.archiveMany` with `sessions.patchMany` (#120493, #120629), and `node.protocolFeatures.update` with `node.runnerInventory.update` (#122939, #123094).
+- Remove same-month `users.setGitHubIdentity` / `users.clearGitHubIdentity` in favor of authenticated sign-in facts (#125827, #126114); remove `delivery.failures.resubmit` and retained failed-delivery payloads (#123410, #123642).
+- Replace `audit.run.inspect.decisions` with required bounded `decisionDisplays` (#126007); replace flat GitHub status fields with `selected` / `effective` identity facts and require `selectedScope` (#126474).
+- Replace worker machine-option `description` with `cpu` / `memoryGb` (#125696), and participant actor arrays with tagged `SessionParticipant.identity` records (#130986).
+- Remove `acknowledgeClawHubRisk` from skill install/update and plugin install, plus `clawhub_risk_acknowledgement_required`; expose security-audit metadata instead (#131233).
+- Retire session `execSecurity` / `execAsk`: both stay wire-valid in v4 but `sessions.patch` / `sessions.patchMany` now reject them with guidance naming `permissionMode` (#132740). Schema deletion remains deferred above.
+
+#### Handshake and capabilities
+
+- Add optional `hello-ok.policy.attachments` with required `maxBytes` / `maxImageBytes` decoded per-attachment ceilings (#116188).
+- Add `hello-ok.auth.recoveryMigrationAllowed` / `recoveryScope` (#121671), connect `computerUse` (#123544), client/server `buildId` and server `controlUiBuildSource` (#123660), server `bootId` (#128365), and client/presence `timeZone` (#128438).
+- Add node `workerRuns` admission metadata (#122966), then deprecate that envelope in favor of runner inventory while retaining its accepted v1 shape (#124356); add bundle-prewarm negotiation (#124427).
+- Project plugin tab `placement` in `hello-ok` so active plugins can target native Control UI routes (#125473).
+- Add the client `usage-refreshing` capability (#121799), `CONTROL_UI_BUILD_MISMATCH` reload details (#123882), identity-header-required errors (#125132, #125700), and structured `gateway-restarting` / `gateway-suspending` unavailability reasons (#130025).
+- Advertise server capabilities through `hello-ok.features.capabilities`: `gateway-restart-target-safe-v1`, `node-worker-bundle-retention-v1`, `node-worker-bundle-status-v1`, `node-worker-environment-session-v1`, `node-worker-portal-stream-v1`, `session-scoped-chat-metadata`, `session-unread-ack-contract`, `session-goal-start-v1`, `openclaw-chat-wizard-cancel`, `openclaw-setup-model-ref`, `taskSuggestions.acceptModes`, `board-widget-put-canvas-doc`, and `chat-send-routing-contract` (current `GATEWAY_SERVER_CAPS`; additions span #121173, #123920, #124590, #124640, #129386, #130105, #131370).
+- Replace advertised worker `worker-launch-v2` with execution-context negotiation (#120534); advance `worker-execution-context-v1` to `worker-execution-context-v2` for permission context (#125326). These are worker-dialect tokens, not changes to `PROTOCOL_VERSION`.
+
+#### Method and event families
+
+- Add bounded `sessions.patchMany` mutation orchestration with per-target outcomes (#120629), restart recovery through `sessions.recover` (#122644), and folder defaults through `sessions.groups.defaults` / `update` (#123276).
+- Add projects: `projects.list` / `register` / `remove` / `add` / `searchRemote`, typed records/checkouts/remotes, session project targeting, clone progress/errors, and per-project worker-profile defaults (#121465, #120804, #121818, #126238, #130192).
+- Add `secrets.store.list` / `set` / `delete`, redacted entry metadata, destination-bound `allowedHosts`, and credential-question `secretStore` / `secretStoreExisting` bindings (#121559, #121724, #123216, #129670).
+- Add `users.prefs.get` / `set`, `users.prefs.changed`, bounded preference-limit errors, appearance/font preferences, and `users.setRole` with optional profile `role` (#121816, #128548, #130340, #131275).
+- Add GitHub identity facts, per-agent `tools.github.status` / `configure` and `tools.github.authorize.start` / `poll` / `cancel`, plus brokered `sessions.github.publish` outcomes; project verified participant co-author identities and their preference (#125199, #125827, #126114, #126474, #126306, #131964).
+- Add `worker.desktop.observe` / `launch` and local/paired-node `desktop.observe` / `launch` with `DesktopSource` and app-launch results (#120727, #121475, #122545, #122724).
+- Add `portal.list` / `open` / `close` and `portal.changed`, including portals on node-backed workers (#122536, #130105).
+- Add `sessions.move` between Gateway and runners, machine-class targeting, optional device/automatic-device dispatch, and atomic `node.runnerInventory.update` / `node.runnerInventory.changed` (#125036, #125292, #122769, #128421, #123094).
+- Add `sessions.assignOwner`, `SessionOwner`, participant/person projections, and owner/participant roster filters; add `session.members.listEvidence` and `session.sharing.evidence` (#125057, #125579, #125645, #129093, #130986).
+- Add `progressCard.get` / `put` and `progressCard.changed`, typed steps/statuses, and dismissal (#125125, #126102); add `sessions.goal.update` / `clear` and goal-start `chat.send.intent` (#131370).
+- Add `device.scopes.requestUpgrade` / `waitUpgrade`, one-paste pairing links, `device.pair.setupStatus`, `device.pair.setup.completed` / `device.pair.setup.deliveryUncertain`, and `device.pair.changed` after device edits (#121459, #120768, #122499, #120933, #126432).
+- Add `exec.approval.grants.list` / `revoke`, standing-grant expiry/revocation records, typed `ApprovalScope`, and reviewer/grant-term fields (#129526, #130116, #131602).
+- Add `plugins.inspect`, declared capability surfaces, artifact-bound operator grants, install/enable consent, and install security-audit metadata (#130168, #131233).
+- Add `push.web.preferences.get` / `set`, notification category/detail level, quiet hours, and approval-notification preferences (#129348).
+- Add `hooks.status` (#118288), `audit.run.inspect` with execution identity/receipt/display contracts (#117034, #120534, #126007, #126082), and command-lane `diagnostics.lanes` (#125591).
+- Add `tasks.retry` / `dismiss` with `TasksRecoveryParams` / `Result` and delivery outcomes (`d9393bd3cbe`, `1f78c39bd82`, `6ca16f7f3d2`, `d0439b9ce0f`); add task-suggestion acceptance `mode` / `cloudProfileId` and reject whitespace-only title/prompt/TLDR values (#121173, #120940).
+- Extend worker RPCs with `worker.sessions.spawn` / `send`, `worker.github.publish`, and `worker.portal`, negotiated by `worker-session-tools-v1`, `worker-github-publication-v1`, and `worker-portal-v1` (#121846, #126306, #130105); add public `/__openclaw__/worker` ingress and `admission-rejected` close reason (#122578).
+- Add scheduled-update `update.hold`, `UpdateScheduleState`, update status/availability projections, checkout-lag `refreshCheckout`, and exact update/restart targets (#120506, #120769, #118518, #124891, #128868); extend cooperative suspension with terminal policy and renewable `draining` results (#121601, #130003).
+- Add `sessions.catalog.startTerminal` plans (#121020), `controlUi.sessionPreview` (#125014), and short-reference/candidate results on existing `sessions.resolve` (#120512, #128778).
+
+#### Fields and payload contracts
+
+- Preserve required legacy agent-default fields while adding honest `ownership` and `selectionRequired` state to agent lists and initial snapshots; carry explicit `agentId` through session, board, companion, discussion, plugin, and UI requests, and require nonempty model-list agent IDs when supplied (#114388). Add agent creation hierarchy, resolved-name provenance, and purge-failure results (#124967, #122463, #125217).
+- Project optional `defaultPermissionMode` on agent rows so clients can label the inherited session permission default; omitted whenever the effective policy cannot be stated truthfully (#132989).
+- Add session `permissionMode` (`SessionPermissionMode`) on create/patch/rows (#124909), emoji/glyph icons (#124034, #124629), and `color` on patch/row/catalog projections (#132570).
+- Extend session rows with classification/peer-kind facts (#106832), conversation avatar (#125668), restart recovery and terminal placement reasons (#122644, #121122, #120976), `lastRunId` (#126180), inherited-model provenance (#120805), and queued `SessionRunStatus` (#125654, #131444). Add roster bootstrap/people projections and remove the implicit row cap (#130294, #131202).
+- Extend session creation with `forkFrom`, category, tool overrides, idempotency, context-window and fast-mode selection, and worktree startup phases (#123718, #123276, #128081, #128661, #127951, #131272, #131559); carry catalog `sourceHomeId` and explicit owner targeting (#123899).
+- Allow write-scoped folder browsing/session creation within configured agent workspaces; arbitrary host and node paths remain admin-scoped (#121417).
+- Add chat-history cursors with delta/reset results, delta `inFlightRun`, pending-input pagination and steering status (`ChatPendingInputsPage`), and session-scoped chat metadata plus `chat.metadata.changed` (#125606, #129640, #132887, #131697, #132179). Add `markedUnreadAt` / `expectedMarkedUnreadAt` acknowledgment fencing (#129386), bounded typing previews (#126994), and terminal-open `sessionKey` with agent-owned terminal detach semantics (#125758).
+- Add typed hosted-wizard answers and optional `SystemAgentChatResult.step` (#114631), wizard cancellation (`890a4b0089f`, `2300de71627`), prepared-model references (`dea04651b9c`), snapshot `modelConfigured` (#128135), setup `agentId` (#123429), restart-required activation (#127713), and terminal `modelActivation` / `SetupAdmissionBusyErrorDetails` (#131757).
+- Add gateway-owned realtime `gateway-control-v1` / `clientControl.owner` (#121054); add `TalkSessionCancelOutputResult` with `applied` / `stale` / `idle` status and optional `turnId` (#127186).
+- Extend model catalogs with per-agent availability/provider outcomes, mutually exclusive `preparedOnly: true` / `refresh: true` requests, thinking choices/defaults, tags, context-window choices/defaults, effective fast mode, and auth-unavailability reasons/deadlines (#121852, #122125, #126194, #127951, #131272, #131697; `d83f7b815db`, `639e7718f39`). Align fallback-reason values across cron, sessions, and worker events (#117909, #121285, #121334, #121898).
+- Extend worker/environment placements with desktop apps, disk-space facts, offline host presence/trust, runtime-target issues, worker profiles/execution modes, bundle status/retention, exact slot counts, and service/profile/runner projections (#121475, #122531, #123177, #123198, #124037, #124864, #124640, #124590, #125708, #127752, #132405). Add runtime cloud/device support, `invocableCommands`/slot requirements, and local-or-reclaimed results; make dispatch `profileId` optional for mutually exclusive device/automatic targeting and add offline-runner `abandonSource` (#123743, #122769, #124791, #126067, #126284, #126585, #127202, #128421).
+- Add worker transcript/inference `providerReplay`, expand its bounded replay budget, and add versioned compaction-token provenance (#120457, #120803, #120497); raise worker transcript image-data ceiling to 25 MiB (#132114).
+- Extend session diffs with commit/scope selection, commits, merge base and ahead count (#122470); record worktree run-end cleanup, removal `snapshotError` even when removal stops, and typed preserved-worktree deletion outcomes (#120434, #126174, #126347). Add live task `lastActivity` / `diffStat` (#121549).
+- Add generated board-widget identities and canonical put results (#117132), registered/A2UI content and content-owner projections (#125803, #128489); add command client presentation and skill display names (#120855, #124017).
+- Extend cron with auto-disable state, Date-range timestamp bounds, `if-enabled` run mode and trigger filtering, typed delivery traces/completion status/suppression reasons, and system-owned skill-review status (#118113, #121394, #125170, #126534, #124856, #126164, #130811, #130030). Add missing-job `CronJobNotFoundErrorDetails` (#124663).
+- Require source-qualified skill-search `installRef`, distinguish install-only/unscanned results, carry install-policy warnings and update conflicts, and require `expectedRevisionHash` for proposal apply/reject/revision requests (#119672, #121697, #124250, #120900, #118190, #126156). Report curator collection/experience reviews; retired curator actions remain wire-valid but return guidance (#129769).
+- Require `avatarRevision` in avatar-save results (#120791) and nullable `githubIdentity` in user profiles (#125827). Add bounded user preference values and default-on co-author credit for verified identities (#121816, #131964).
+- Extend channel/health snapshots with nullable status timestamps/errors, credential/audience/webhook and active-run facts, event-loop degradation age, ingress failure/pressure, and heartbeat session targeting (#117817, #118193, #123234, #121892). Add presence activity timestamps and qualified profile/viewer identities (#130664, #132038, #132250).
+- Add outbound-delivery audit/error details, typed queued-delivery outcomes, reply metadata, and payload-free failed-row retention (#123709, #128202, #126205, #123410, #123642); reject impossible audit filter combinations (#124513). Bind approval requests to channel accounts, project resolved exec defaults, and surface controlling-chat source sessions (#121673, #125756, #131829); clarify other-device token-rotation delivery in `DeviceTokenRotateResult` (#121361).
 
 ## Notes for external versioning
 
-- Post-v4 changes are additive except: the transient v5 rename (reverted, net-zero) and
-  the 2026-07-14 `crestodian.*` -> `openclaw.*` method rename. The renamed feature was
-  introduced only 9 days earlier (2026-07-05, #99935), never left the v4 window, and
-  predates public publish, so no released method name changed under v4.
+- Removals and semantic breaks have shipped in v4 builds without a wire-version bump, including the July question/catalog reshaping and August RPC/field removals above. The negotiated version remains `4`, with minimum client/node/probe versions `4` / `3` / `3`; it does not identify a fixed schema vintage. Monthly history records authoring, not a guarantee that every intermediate shape reached a stable package release.
+- Discover current methods, events, and capabilities through `hello-ok.features`; consult the matching release's schemas for payload contracts. The Deferred section records shape changes still waiting for an owner-approved version bump, not changes already made under v4.
+- Core method `since` values are release-train metadata (`<=2026.7` predates tracking), not exact authoring dates. Use the method table for retained methods, generated Kotlin catalog history for method/event changes, and schema/generated Swift diffs for field changes; the sparse `x-openclaw-since` annotations are not a complete schema history.
 - `schema/types.ts` was removed 2026-07-11 (#103679); it re-exported compile-time type
   aliases only and has no wire impact.

package/dist/client-info.d.mts

@@ -1,6 +1,6 @@
 //#region src/client-info.d.ts
 /** Canonical client ids accepted in gateway hello/connect payloads. */
-declare const GATEWAY_CLIENT_IDS: {
+export declare const GATEWAY_CLIENT_IDS: {
   readonly WEBCHAT_UI: "webchat-ui";
   readonly CONTROL_UI: "openclaw-control-ui";
   readonly BROWSER_COPILOT: "openclaw-browser-copilot";
@@ -20,8 +20,8 @@ declare const GATEWAY_CLIENT_IDS: {
   readonly PROBE: "openclaw-probe";
 };
 /** Stable gateway client ids used on the wire during hello/connect handshakes. */
-type GatewayClientId = (typeof GATEWAY_CLIENT_IDS)[keyof typeof GATEWAY_CLIENT_IDS];
-declare const GATEWAY_CLIENT_NAMES: {
+export type GatewayClientId = (typeof GATEWAY_CLIENT_IDS)[keyof typeof GATEWAY_CLIENT_IDS];
+export declare const GATEWAY_CLIENT_NAMES: {
   readonly WEBCHAT_UI: "webchat-ui";
   readonly CONTROL_UI: "openclaw-control-ui";
   readonly BROWSER_COPILOT: "openclaw-browser-copilot";
@@ -41,9 +41,9 @@ declare const GATEWAY_CLIENT_NAMES: {
   readonly PROBE: "openclaw-probe";
 };
 /** Compatibility alias for internal callers that still use "name" terminology. */
-type GatewayClientName = GatewayClientId;
+export type GatewayClientName = GatewayClientId;
 /** Coarse modes let policy group clients without matching every product id. */
-declare const GATEWAY_CLIENT_MODES: {
+export declare const GATEWAY_CLIENT_MODES: {
   readonly WEBCHAT: "webchat";
   readonly CLI: "cli";
   readonly UI: "ui";
@@ -54,21 +54,32 @@ declare const GATEWAY_CLIENT_MODES: {
   readonly TEST: "test";
 };
 /** Coarse client category used for gateway policy and diagnostics. */
-type GatewayClientMode = (typeof GATEWAY_CLIENT_MODES)[keyof typeof GATEWAY_CLIENT_MODES];
+export 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. */
+export 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;
+  /** 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. */
-declare const GATEWAY_CLIENT_CAPS: {
+export declare const GATEWAY_CLIENT_CAPS: {
   readonly AGENT_KIND: "agent-kind";
   readonly APPROVALS: "approvals";
   readonly EXEC_APPROVALS: "exec-approvals";
@@ -80,16 +91,16 @@ 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];
+export type GatewayClientCap = (typeof GATEWAY_CLIENT_CAPS)[keyof typeof GATEWAY_CLIENT_CAPS];
 /** Normalizes untrusted client ids and rejects unknown values. */
-declare function normalizeGatewayClientId(raw?: string | null): GatewayClientId | undefined;
+export declare function normalizeGatewayClientId(raw?: string | null): GatewayClientId | undefined;
 /** Normalizes legacy client-name fields through the canonical client-id registry. */
-declare function normalizeGatewayClientName(raw?: string | null): GatewayClientName | undefined;
+export declare function normalizeGatewayClientName(raw?: string | null): GatewayClientName | undefined;
 /** Normalizes untrusted client modes and rejects unknown values. */
-declare function normalizeGatewayClientMode(raw?: string | null): GatewayClientMode | undefined;
+export declare function normalizeGatewayClientMode(raw?: string | null): GatewayClientMode | undefined;
 /** Checks a client-advertised capability list without treating missing caps as errors. */
-declare function hasGatewayClientCap(caps: string[] | null | undefined, cap: GatewayClientCap): boolean;
-//#endregion
-export { GATEWAY_CLIENT_CAPS, GATEWAY_CLIENT_IDS, GATEWAY_CLIENT_MODES, GATEWAY_CLIENT_NAMES, GatewayClientCap, GatewayClientId, GatewayClientInfo, GatewayClientMode, GatewayClientName, hasGatewayClientCap, normalizeGatewayClientId, normalizeGatewayClientMode, normalizeGatewayClientName };
+export declare function hasGatewayClientCap(caps: string[] | null | undefined, cap: GatewayClientCap): boolean;
+//#endregion

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/connect-error-details.d.mts

@@ -1,6 +1,6 @@
 //#region src/connect-error-details.d.ts
 /** Structured connect-error codes carried in gateway error `details.code`. */
-declare const ConnectErrorDetailCodes: {
+export declare const ConnectErrorDetailCodes: {
   readonly AUTH_REQUIRED: "AUTH_REQUIRED";
   readonly AUTH_UNAUTHORIZED: "AUTH_UNAUTHORIZED";
   readonly AUTH_TOKEN_MISSING: "AUTH_TOKEN_MISSING";
@@ -41,7 +41,7 @@ declare const ConnectPairingRequiredReasons: {
   readonly SCOPE_UPGRADE: "scope-upgrade";
   readonly METADATA_UPGRADE: "metadata-upgrade";
 };
-type ConnectPairingRequiredReason = (typeof ConnectPairingRequiredReasons)[keyof typeof ConnectPairingRequiredReasons];
+export type ConnectPairingRequiredReason = (typeof ConnectPairingRequiredReasons)[keyof typeof ConnectPairingRequiredReasons];
 /** Suggested client-side recovery action for structured connect errors. */
 type ConnectRecoveryNextStep = "retry_with_device_token" | "update_auth_configuration" | "update_auth_credentials" | "wait_then_retry" | "review_auth_configuration";
 /** Optional retry guidance extracted from gateway connect-error details. */
@@ -65,27 +65,27 @@ type PairingConnectErrorDetails = {
   approvedScopes?: string[];
 };
 /** Compact pairing-required subset used by reconnect/status surfaces. */
-type ConnectPairingRequiredDetails = Pick<PairingConnectErrorDetails, "reason" | "requestId">;
+export type ConnectPairingRequiredDetails = Pick<PairingConnectErrorDetails, "reason" | "requestId">;
 /** Maps internal auth failure reasons to public connect-error detail codes. */
-declare function resolveAuthConnectErrorDetailCode(reason: string | undefined): ConnectErrorDetailCode;
+export declare function resolveAuthConnectErrorDetailCode(reason: string | undefined): ConnectErrorDetailCode;
 /** Maps device-auth verifier reasons to public connect-error detail codes. */
-declare function resolveDeviceAuthConnectErrorDetailCode(reason: string | undefined): ConnectErrorDetailCode;
+export declare function resolveDeviceAuthConnectErrorDetailCode(reason: string | undefined): ConnectErrorDetailCode;
 /** Reads a non-empty detail code from an untrusted error details payload. */
-declare function readConnectErrorDetailCode(details: unknown): string | null;
+export declare function readConnectErrorDetailCode(details: unknown): string | null;
 /** Read the exact target artifact from an untrusted reload-required rejection. */
-declare function readControlUiBuildMismatchId(details: unknown): string | null;
+export declare function readControlUiBuildMismatchId(details: unknown): string | null;
 /** Extracts normalized retry advice from untrusted connect-error details. */
-declare function readConnectErrorRecoveryAdvice(details: unknown): ConnectErrorRecoveryAdvice;
+export declare function readConnectErrorRecoveryAdvice(details: unknown): ConnectErrorRecoveryAdvice;
 /** Normalizes pairing request ids before echoing them in close reasons or UI text. */
-declare function normalizePairingConnectRequestId(value: unknown): string | undefined;
+export declare function normalizePairingConnectRequestId(value: unknown): string | undefined;
 /** Human-readable requirement summary for a pairing-required reason. */
-declare function describePairingConnectRequirement(reason: ConnectPairingRequiredReason | undefined): string;
+export declare function describePairingConnectRequirement(reason: ConnectPairingRequiredReason | undefined): string;
 /** Builds the gateway close/error message for a pairing-required connect failure. */
-declare function buildPairingConnectErrorMessage(reason: ConnectPairingRequiredReason | undefined): string;
+export declare function buildPairingConnectErrorMessage(reason: ConnectPairingRequiredReason | undefined): string;
 /** Short user-facing recovery title for pairing-required connect failures. */
-declare function buildPairingConnectRecoveryTitle(reason: ConnectPairingRequiredReason | undefined): string;
+export declare function buildPairingConnectRecoveryTitle(reason: ConnectPairingRequiredReason | undefined): string;
 /** Builds sanitized structured details for a pairing-required connect failure. */
-declare function buildPairingConnectErrorDetails(params: {
+export declare function buildPairingConnectErrorDetails(params: {
   reason: ConnectPairingRequiredReason | undefined;
   requestId?: string;
   remediationHint?: string;
@@ -99,16 +99,16 @@ declare function buildPairingConnectErrorDetails(params: {
   approvedScopes?: string[];
 }): PairingConnectErrorDetails;
 /** Builds a sanitized close reason string for WebSocket pairing rejections. */
-declare function buildPairingConnectCloseReason(params: {
+export declare function buildPairingConnectCloseReason(params: {
   reason: ConnectPairingRequiredReason | undefined;
   requestId?: string;
 }): string;
 /** Reads and backfills pairing-required details from an untrusted details object. */
-declare function readPairingConnectErrorDetails(details: unknown): PairingConnectErrorDetails | null;
+export declare function readPairingConnectErrorDetails(details: unknown): PairingConnectErrorDetails | null;
 /** Parses legacy/string-only pairing-required messages into structured details. */
-declare function readConnectPairingRequiredMessage(message: string | null | undefined): ConnectPairingRequiredDetails | null;
+export declare function readConnectPairingRequiredMessage(message: string | null | undefined): ConnectPairingRequiredDetails | null;
 /** Classifies Gateway connect failures from structured details, with one legacy text fallback. */
-declare function classifyGatewayConnectFailure(input: {
+export declare function classifyGatewayConnectFailure(input: {
   details?: unknown;
   reason?: string | null;
   message?: string | null;
@@ -126,11 +126,10 @@ declare function classifyGatewayConnectFailure(input: {
   userMessage: string;
 };
 /** Formats pairing-required details into the canonical user-facing message. */
-declare function formatConnectPairingRequiredMessage(details: unknown): string;
+export declare function formatConnectPairingRequiredMessage(details: unknown): string;
 /** Formats connect errors using structured details before falling back to raw messages. */
-declare function formatConnectErrorMessage(params: {
+export declare function formatConnectErrorMessage(params: {
   message?: string;
   details?: unknown;
 }): string;
-//#endregion
-export { ConnectErrorDetailCodes, ConnectPairingRequiredDetails, ConnectPairingRequiredReason, buildPairingConnectCloseReason, buildPairingConnectErrorDetails, buildPairingConnectErrorMessage, buildPairingConnectRecoveryTitle, classifyGatewayConnectFailure, describePairingConnectRequirement, formatConnectErrorMessage, formatConnectPairingRequiredMessage, normalizePairingConnectRequestId, readConnectErrorDetailCode, readConnectErrorRecoveryAdvice, readConnectPairingRequiredMessage, readControlUiBuildMismatchId, readPairingConnectErrorDetails, resolveAuthConnectErrorDetailCode, resolveDeviceAuthConnectErrorDetailCode };
+//#endregion

package/dist/frame-guards.d.mts

@@ -1,7 +1,6 @@
-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-CAy_vx4s.mjs";
 //#region src/frame-guards.d.ts
-declare function isGatewayEventFrame(value: unknown): value is EventFrame;
-declare function isGatewayResponseFrame(value: unknown): value is ResponseFrame;
+export declare function isGatewayEventFrame(value: unknown): value is EventFrame;
+export declare function isGatewayResponseFrame(value: unknown): value is ResponseFrame;
 //#endregion
-export { type ConnectParams, type ErrorShape, type EventFrame, type GatewayFrame, type HelloOk, type RequestFrame, type ResponseFrame, isGatewayEventFrame, isGatewayResponseFrame };
+export type { ConnectParams, ErrorShape, EventFrame, GatewayFrame, HelloOk, RequestFrame, ResponseFrame };

package/dist/{frames-BKvowx_k.d.mts → frames-CAy_vx4s.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,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>;
@@ -443,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-DR-CyzeW.d.mts → gateway-error-details-GvUeus2z.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. */
@@ -23,6 +30,7 @@ declare const GatewayErrorDetailCodes: {
   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 = {
@@ -52,6 +60,10 @@ 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;
@@ -68,7 +80,7 @@ type SkillProposalRevisionChangedErrorDetails = {
   currentRevisionHash: string;
 };
 /** Structured details emitted by method-level failures. */
-type GatewayErrorDetails = CronJobNotFoundErrorDetails | MissingScopeErrorDetails | McpAppViewExpiredErrorDetails | OutboundDeliveryQueuedErrorDetails | UserPrefsLimitExceededErrorDetails | SkillProposalRevisionChangedErrorDetails | ProjectCloneErrorDetails | UnknownAgentIdErrorDetails | WizardNotFoundErrorDetails;
+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. */
@@ -87,4 +99,4 @@ declare function isMcpAppViewExpiredError(error: unknown): boolean;
  */
 declare function readMissingScopeError(error: unknown): MissingScopeErrorDetails | null;
 //#endregion
-export { readCronJobNotFoundError as _, GatewayErrorDetails as a, readSkillProposalRevisionChangedError as b, OutboundDeliveryQueuedErrorDetails as c, SkillProposalRevisionChangedErrorDetails as d, UnknownAgentIdErrorDetails as f, isMcpAppViewExpiredError as g, buildSkillProposalRevisionChangedErrorDetails as h, GatewayErrorDetailCodes as i, ProjectCloneErrorDetails as l, WizardNotFoundErrorDetails as m, ErrorCode as n, McpAppViewExpiredErrorDetails as o, UserPrefsLimitExceededErrorDetails as p, ErrorCodes as r, MissingScopeErrorDetails as s, CronJobNotFoundErrorDetails as t, ProjectCloneFailureCause as u, readMissingScopeError as v, readMissingScopeErrorDetails as y };
+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 { _ 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";
-export { CronJobNotFoundErrorDetails, ErrorCode, ErrorCodes, GatewayErrorDetailCodes, GatewayErrorDetails, McpAppViewExpiredErrorDetails, MissingScopeErrorDetails, OutboundDeliveryQueuedErrorDetails, ProjectCloneErrorDetails, ProjectCloneFailureCause, SkillProposalRevisionChangedErrorDetails, UnknownAgentIdErrorDetails, UserPrefsLimitExceededErrorDetails, WizardNotFoundErrorDetails, buildSkillProposalRevisionChangedErrorDetails, isMcpAppViewExpiredError, readCronJobNotFoundError, readMissingScopeError, readMissingScopeErrorDetails, readSkillProposalRevisionChangedError };
+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

@@ -28,7 +28,8 @@ const GatewayErrorDetailCodes = {
 	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}$/;