@kortix/sdk 0.13.4 → 0.13.7

package/dist/core/runtime/opencode-v2-event-aliases.d.ts

@@ -0,0 +1,184 @@
+/**
+ * Back-compat aliases for the `V2Event*` type names @opencode-ai/sdk exported
+ * up to 1.17.x. The 1.18.x generator dropped the `V2` prefix and exports the
+ * same event types as `Event*`. These names are part of @kortix/sdk's public
+ * type surface (public-type-surface.snapshot.json), so removing them is a
+ * breaking change — keep them until the next major.
+ */
+/** @deprecated Renamed upstream in @opencode-ai/sdk 1.18 — use `EventCatalogUpdated`. */
+export type { EventCatalogUpdated as V2EventCatalogUpdated } from '@opencode-ai/sdk/v2/client';
+/** @deprecated Renamed upstream in @opencode-ai/sdk 1.18 — use `EventCommandExecuted`. */
+export type { EventCommandExecuted as V2EventCommandExecuted } from '@opencode-ai/sdk/v2/client';
+/** @deprecated Renamed upstream in @opencode-ai/sdk 1.18 — use `EventFileEdited`. */
+export type { EventFileEdited as V2EventFileEdited } from '@opencode-ai/sdk/v2/client';
+/** @deprecated Renamed upstream in @opencode-ai/sdk 1.18 — use `EventFileWatcherUpdated`. */
+export type { EventFileWatcherUpdated as V2EventFileWatcherUpdated } from '@opencode-ai/sdk/v2/client';
+/** @deprecated Renamed upstream in @opencode-ai/sdk 1.18 — use `EventGlobalDisposed`. */
+export type { EventGlobalDisposed as V2EventGlobalDisposed } from '@opencode-ai/sdk/v2/client';
+/** @deprecated Renamed upstream in @opencode-ai/sdk 1.18 — use `EventInstallationUpdateAvailable`. */
+export type { EventInstallationUpdateAvailable as V2EventInstallationUpdateAvailable } from '@opencode-ai/sdk/v2/client';
+/** @deprecated Renamed upstream in @opencode-ai/sdk 1.18 — use `EventInstallationUpdated`. */
+export type { EventInstallationUpdated as V2EventInstallationUpdated } from '@opencode-ai/sdk/v2/client';
+/** @deprecated Renamed upstream in @opencode-ai/sdk 1.18 — use `EventIntegrationConnectionUpdated`. */
+export type { EventIntegrationConnectionUpdated as V2EventIntegrationConnectionUpdated } from '@opencode-ai/sdk/v2/client';
+/** @deprecated Renamed upstream in @opencode-ai/sdk 1.18 — use `EventIntegrationUpdated`. */
+export type { EventIntegrationUpdated as V2EventIntegrationUpdated } from '@opencode-ai/sdk/v2/client';
+/** @deprecated Renamed upstream in @opencode-ai/sdk 1.18 — use `EventLspUpdated`. */
+export type { EventLspUpdated as V2EventLspUpdated } from '@opencode-ai/sdk/v2/client';
+/** @deprecated Renamed upstream in @opencode-ai/sdk 1.18 — use `EventMcpBrowserOpenFailed`. */
+export type { EventMcpBrowserOpenFailed as V2EventMcpBrowserOpenFailed } from '@opencode-ai/sdk/v2/client';
+/** @deprecated Renamed upstream in @opencode-ai/sdk 1.18 — use `EventMcpToolsChanged`. */
+export type { EventMcpToolsChanged as V2EventMcpToolsChanged } from '@opencode-ai/sdk/v2/client';
+/** @deprecated Renamed upstream in @opencode-ai/sdk 1.18 — use `EventMessagePartDelta`. */
+export type { EventMessagePartDelta as V2EventMessagePartDelta } from '@opencode-ai/sdk/v2/client';
+/** @deprecated Renamed upstream in @opencode-ai/sdk 1.18 — use `EventMessagePartRemoved`. */
+export type { EventMessagePartRemoved as V2EventMessagePartRemoved } from '@opencode-ai/sdk/v2/client';
+/** @deprecated Renamed upstream in @opencode-ai/sdk 1.18 — use `EventMessagePartUpdated`. */
+export type { EventMessagePartUpdated as V2EventMessagePartUpdated } from '@opencode-ai/sdk/v2/client';
+/** @deprecated Renamed upstream in @opencode-ai/sdk 1.18 — use `EventMessageRemoved`. */
+export type { EventMessageRemoved as V2EventMessageRemoved } from '@opencode-ai/sdk/v2/client';
+/** @deprecated Renamed upstream in @opencode-ai/sdk 1.18 — use `EventMessageUpdated`. */
+export type { EventMessageUpdated as V2EventMessageUpdated } from '@opencode-ai/sdk/v2/client';
+/** @deprecated Renamed upstream in @opencode-ai/sdk 1.18 — use `EventModelsDevRefreshed`. */
+export type { EventModelsDevRefreshed as V2EventModelsDevRefreshed } from '@opencode-ai/sdk/v2/client';
+/** @deprecated Renamed upstream in @opencode-ai/sdk 1.18 — use `EventPermissionAsked`. */
+export type { EventPermissionAsked as V2EventPermissionAsked } from '@opencode-ai/sdk/v2/client';
+/** @deprecated Renamed upstream in @opencode-ai/sdk 1.18 — use `EventPermissionReplied`. */
+export type { EventPermissionReplied as V2EventPermissionReplied } from '@opencode-ai/sdk/v2/client';
+/** @deprecated Renamed upstream in @opencode-ai/sdk 1.18 — use `EventPermissionV2Asked`. */
+export type { EventPermissionV2Asked as V2EventPermissionV2Asked } from '@opencode-ai/sdk/v2/client';
+/** @deprecated Renamed upstream in @opencode-ai/sdk 1.18 — use `EventPermissionV2Replied`. */
+export type { EventPermissionV2Replied as V2EventPermissionV2Replied } from '@opencode-ai/sdk/v2/client';
+/** @deprecated Renamed upstream in @opencode-ai/sdk 1.18 — use `EventPluginAdded`. */
+export type { EventPluginAdded as V2EventPluginAdded } from '@opencode-ai/sdk/v2/client';
+/** @deprecated Renamed upstream in @opencode-ai/sdk 1.18 — use `EventProjectDirectoriesUpdated`. */
+export type { EventProjectDirectoriesUpdated as V2EventProjectDirectoriesUpdated } from '@opencode-ai/sdk/v2/client';
+/** @deprecated Renamed upstream in @opencode-ai/sdk 1.18 — use `EventProjectUpdated`. */
+export type { EventProjectUpdated as V2EventProjectUpdated } from '@opencode-ai/sdk/v2/client';
+/** @deprecated Renamed upstream in @opencode-ai/sdk 1.18 — use `EventPtyCreated`. */
+export type { EventPtyCreated as V2EventPtyCreated } from '@opencode-ai/sdk/v2/client';
+/** @deprecated Renamed upstream in @opencode-ai/sdk 1.18 — use `EventPtyDeleted`. */
+export type { EventPtyDeleted as V2EventPtyDeleted } from '@opencode-ai/sdk/v2/client';
+/** @deprecated Renamed upstream in @opencode-ai/sdk 1.18 — use `EventPtyExited`. */
+export type { EventPtyExited as V2EventPtyExited } from '@opencode-ai/sdk/v2/client';
+/** @deprecated Renamed upstream in @opencode-ai/sdk 1.18 — use `EventPtyUpdated`. */
+export type { EventPtyUpdated as V2EventPtyUpdated } from '@opencode-ai/sdk/v2/client';
+/** @deprecated Renamed upstream in @opencode-ai/sdk 1.18 — use `EventQuestionAsked`. */
+export type { EventQuestionAsked as V2EventQuestionAsked } from '@opencode-ai/sdk/v2/client';
+/** @deprecated Renamed upstream in @opencode-ai/sdk 1.18 — use `EventQuestionRejected`. */
+export type { EventQuestionRejected as V2EventQuestionRejected } from '@opencode-ai/sdk/v2/client';
+/** @deprecated Renamed upstream in @opencode-ai/sdk 1.18 — use `EventQuestionReplied`. */
+export type { EventQuestionReplied as V2EventQuestionReplied } from '@opencode-ai/sdk/v2/client';
+/** @deprecated Renamed upstream in @opencode-ai/sdk 1.18 — use `EventQuestionV2Asked`. */
+export type { EventQuestionV2Asked as V2EventQuestionV2Asked } from '@opencode-ai/sdk/v2/client';
+/** @deprecated Renamed upstream in @opencode-ai/sdk 1.18 — use `EventQuestionV2Rejected`. */
+export type { EventQuestionV2Rejected as V2EventQuestionV2Rejected } from '@opencode-ai/sdk/v2/client';
+/** @deprecated Renamed upstream in @opencode-ai/sdk 1.18 — use `EventQuestionV2Replied`. */
+export type { EventQuestionV2Replied as V2EventQuestionV2Replied } from '@opencode-ai/sdk/v2/client';
+/** @deprecated Renamed upstream in @opencode-ai/sdk 1.18 — use `EventReferenceUpdated`. */
+export type { EventReferenceUpdated as V2EventReferenceUpdated } from '@opencode-ai/sdk/v2/client';
+/** @deprecated Renamed upstream in @opencode-ai/sdk 1.18 — use `EventServerConnected`. */
+export type { EventServerConnected as V2EventServerConnected } from '@opencode-ai/sdk/v2/client';
+/** @deprecated Renamed upstream in @opencode-ai/sdk 1.18 — use `EventSessionCompacted`. */
+export type { EventSessionCompacted as V2EventSessionCompacted } from '@opencode-ai/sdk/v2/client';
+/** @deprecated Renamed upstream in @opencode-ai/sdk 1.18 — use `EventSessionCreated`. */
+export type { EventSessionCreated as V2EventSessionCreated } from '@opencode-ai/sdk/v2/client';
+/** @deprecated Renamed upstream in @opencode-ai/sdk 1.18 — use `EventSessionDeleted`. */
+export type { EventSessionDeleted as V2EventSessionDeleted } from '@opencode-ai/sdk/v2/client';
+/** @deprecated Renamed upstream in @opencode-ai/sdk 1.18 — use `EventSessionDiff`. */
+export type { EventSessionDiff as V2EventSessionDiff } from '@opencode-ai/sdk/v2/client';
+/** @deprecated Renamed upstream in @opencode-ai/sdk 1.18 — use `EventSessionError`. */
+export type { EventSessionError as V2EventSessionError } from '@opencode-ai/sdk/v2/client';
+/** @deprecated Renamed upstream in @opencode-ai/sdk 1.18 — use `EventSessionIdle`. */
+export type { EventSessionIdle as V2EventSessionIdle } from '@opencode-ai/sdk/v2/client';
+/** @deprecated Renamed upstream in @opencode-ai/sdk 1.18 — use `EventSessionNextAgentSwitched`. */
+export type { EventSessionNextAgentSwitched as V2EventSessionNextAgentSwitched } from '@opencode-ai/sdk/v2/client';
+/** @deprecated Renamed upstream in @opencode-ai/sdk 1.18 — use `EventSessionNextCompactionDelta`. */
+export type { EventSessionNextCompactionDelta as V2EventSessionNextCompactionDelta } from '@opencode-ai/sdk/v2/client';
+/** @deprecated Renamed upstream in @opencode-ai/sdk 1.18 — use `EventSessionNextCompactionEnded`. */
+export type { EventSessionNextCompactionEnded as V2EventSessionNextCompactionEnded } from '@opencode-ai/sdk/v2/client';
+/** @deprecated Renamed upstream in @opencode-ai/sdk 1.18 — use `EventSessionNextCompactionStarted`. */
+export type { EventSessionNextCompactionStarted as V2EventSessionNextCompactionStarted } from '@opencode-ai/sdk/v2/client';
+/** @deprecated Renamed upstream in @opencode-ai/sdk 1.18 — use `EventSessionNextContextUpdated`. */
+export type { EventSessionNextContextUpdated as V2EventSessionNextContextUpdated } from '@opencode-ai/sdk/v2/client';
+/** @deprecated Renamed upstream in @opencode-ai/sdk 1.18 — use `EventSessionNextModelSwitched`. */
+export type { EventSessionNextModelSwitched as V2EventSessionNextModelSwitched } from '@opencode-ai/sdk/v2/client';
+/** @deprecated Renamed upstream in @opencode-ai/sdk 1.18 — use `EventSessionNextMoved`. */
+export type { EventSessionNextMoved as V2EventSessionNextMoved } from '@opencode-ai/sdk/v2/client';
+/** @deprecated Renamed upstream in @opencode-ai/sdk 1.18 — use `EventSessionNextPromptAdmitted`. */
+export type { EventSessionNextPromptAdmitted as V2EventSessionNextPromptAdmitted } from '@opencode-ai/sdk/v2/client';
+/** @deprecated Renamed upstream in @opencode-ai/sdk 1.18 — use `EventSessionNextPrompted`. */
+export type { EventSessionNextPrompted as V2EventSessionNextPrompted } from '@opencode-ai/sdk/v2/client';
+/** @deprecated Renamed upstream in @opencode-ai/sdk 1.18 — use `EventSessionNextReasoningDelta`. */
+export type { EventSessionNextReasoningDelta as V2EventSessionNextReasoningDelta } from '@opencode-ai/sdk/v2/client';
+/** @deprecated Renamed upstream in @opencode-ai/sdk 1.18 — use `EventSessionNextReasoningEnded`. */
+export type { EventSessionNextReasoningEnded as V2EventSessionNextReasoningEnded } from '@opencode-ai/sdk/v2/client';
+/** @deprecated Renamed upstream in @opencode-ai/sdk 1.18 — use `EventSessionNextReasoningStarted`. */
+export type { EventSessionNextReasoningStarted as V2EventSessionNextReasoningStarted } from '@opencode-ai/sdk/v2/client';
+/** @deprecated Renamed upstream in @opencode-ai/sdk 1.18 — use `EventSessionNextRetried`. */
+export type { EventSessionNextRetried as V2EventSessionNextRetried } from '@opencode-ai/sdk/v2/client';
+/** @deprecated Renamed upstream in @opencode-ai/sdk 1.18 — use `EventSessionNextRevertCleared`. */
+export type { EventSessionNextRevertCleared as V2EventSessionNextRevertCleared } from '@opencode-ai/sdk/v2/client';
+/** @deprecated Renamed upstream in @opencode-ai/sdk 1.18 — use `EventSessionNextRevertCommitted`. */
+export type { EventSessionNextRevertCommitted as V2EventSessionNextRevertCommitted } from '@opencode-ai/sdk/v2/client';
+/** @deprecated Renamed upstream in @opencode-ai/sdk 1.18 — use `EventSessionNextRevertStaged`. */
+export type { EventSessionNextRevertStaged as V2EventSessionNextRevertStaged } from '@opencode-ai/sdk/v2/client';
+/** @deprecated Renamed upstream in @opencode-ai/sdk 1.18 — use `EventSessionNextShellEnded`. */
+export type { EventSessionNextShellEnded as V2EventSessionNextShellEnded } from '@opencode-ai/sdk/v2/client';
+/** @deprecated Renamed upstream in @opencode-ai/sdk 1.18 — use `EventSessionNextShellStarted`. */
+export type { EventSessionNextShellStarted as V2EventSessionNextShellStarted } from '@opencode-ai/sdk/v2/client';
+/** @deprecated Renamed upstream in @opencode-ai/sdk 1.18 — use `EventSessionNextStepEnded`. */
+export type { EventSessionNextStepEnded as V2EventSessionNextStepEnded } from '@opencode-ai/sdk/v2/client';
+/** @deprecated Renamed upstream in @opencode-ai/sdk 1.18 — use `EventSessionNextStepFailed`. */
+export type { EventSessionNextStepFailed as V2EventSessionNextStepFailed } from '@opencode-ai/sdk/v2/client';
+/** @deprecated Renamed upstream in @opencode-ai/sdk 1.18 — use `EventSessionNextStepStarted`. */
+export type { EventSessionNextStepStarted as V2EventSessionNextStepStarted } from '@opencode-ai/sdk/v2/client';
+/** @deprecated Renamed upstream in @opencode-ai/sdk 1.18 — use `EventSessionNextSynthetic`. */
+export type { EventSessionNextSynthetic as V2EventSessionNextSynthetic } from '@opencode-ai/sdk/v2/client';
+/** @deprecated Renamed upstream in @opencode-ai/sdk 1.18 — use `EventSessionNextTextDelta`. */
+export type { EventSessionNextTextDelta as V2EventSessionNextTextDelta } from '@opencode-ai/sdk/v2/client';
+/** @deprecated Renamed upstream in @opencode-ai/sdk 1.18 — use `EventSessionNextTextEnded`. */
+export type { EventSessionNextTextEnded as V2EventSessionNextTextEnded } from '@opencode-ai/sdk/v2/client';
+/** @deprecated Renamed upstream in @opencode-ai/sdk 1.18 — use `EventSessionNextTextStarted`. */
+export type { EventSessionNextTextStarted as V2EventSessionNextTextStarted } from '@opencode-ai/sdk/v2/client';
+/** @deprecated Renamed upstream in @opencode-ai/sdk 1.18 — use `EventSessionNextToolCalled`. */
+export type { EventSessionNextToolCalled as V2EventSessionNextToolCalled } from '@opencode-ai/sdk/v2/client';
+/** @deprecated Renamed upstream in @opencode-ai/sdk 1.18 — use `EventSessionNextToolFailed`. */
+export type { EventSessionNextToolFailed as V2EventSessionNextToolFailed } from '@opencode-ai/sdk/v2/client';
+/** @deprecated Renamed upstream in @opencode-ai/sdk 1.18 — use `EventSessionNextToolInputDelta`. */
+export type { EventSessionNextToolInputDelta as V2EventSessionNextToolInputDelta } from '@opencode-ai/sdk/v2/client';
+/** @deprecated Renamed upstream in @opencode-ai/sdk 1.18 — use `EventSessionNextToolInputEnded`. */
+export type { EventSessionNextToolInputEnded as V2EventSessionNextToolInputEnded } from '@opencode-ai/sdk/v2/client';
+/** @deprecated Renamed upstream in @opencode-ai/sdk 1.18 — use `EventSessionNextToolInputStarted`. */
+export type { EventSessionNextToolInputStarted as V2EventSessionNextToolInputStarted } from '@opencode-ai/sdk/v2/client';
+/** @deprecated Renamed upstream in @opencode-ai/sdk 1.18 — use `EventSessionNextToolProgress`. */
+export type { EventSessionNextToolProgress as V2EventSessionNextToolProgress } from '@opencode-ai/sdk/v2/client';
+/** @deprecated Renamed upstream in @opencode-ai/sdk 1.18 — use `EventSessionNextToolSuccess`. */
+export type { EventSessionNextToolSuccess as V2EventSessionNextToolSuccess } from '@opencode-ai/sdk/v2/client';
+/** @deprecated Renamed upstream in @opencode-ai/sdk 1.18 — use `EventSessionStatus`. */
+export type { EventSessionStatus as V2EventSessionStatus } from '@opencode-ai/sdk/v2/client';
+/** @deprecated Renamed upstream in @opencode-ai/sdk 1.18 — use `EventSessionUpdated`. */
+export type { EventSessionUpdated as V2EventSessionUpdated } from '@opencode-ai/sdk/v2/client';
+/** @deprecated Renamed upstream in @opencode-ai/sdk 1.18 — use `EventTodoUpdated`. */
+export type { EventTodoUpdated as V2EventTodoUpdated } from '@opencode-ai/sdk/v2/client';
+/** @deprecated Renamed upstream in @opencode-ai/sdk 1.18 — use `EventTuiCommandExecute`. */
+export type { EventTuiCommandExecute as V2EventTuiCommandExecute } from '@opencode-ai/sdk/v2/client';
+/** @deprecated Renamed upstream in @opencode-ai/sdk 1.18 — use `EventTuiPromptAppend`. */
+export type { EventTuiPromptAppend as V2EventTuiPromptAppend } from '@opencode-ai/sdk/v2/client';
+/** @deprecated Renamed upstream in @opencode-ai/sdk 1.18 — use `EventTuiSessionSelect`. */
+export type { EventTuiSessionSelect as V2EventTuiSessionSelect } from '@opencode-ai/sdk/v2/client';
+/** @deprecated Renamed upstream in @opencode-ai/sdk 1.18 — use `EventTuiToastShow`. */
+export type { EventTuiToastShow as V2EventTuiToastShow } from '@opencode-ai/sdk/v2/client';
+/** @deprecated Renamed upstream in @opencode-ai/sdk 1.18 — use `EventVcsBranchUpdated`. */
+export type { EventVcsBranchUpdated as V2EventVcsBranchUpdated } from '@opencode-ai/sdk/v2/client';
+/** @deprecated Renamed upstream in @opencode-ai/sdk 1.18 — use `EventWorkspaceFailed`. */
+export type { EventWorkspaceFailed as V2EventWorkspaceFailed } from '@opencode-ai/sdk/v2/client';
+/** @deprecated Renamed upstream in @opencode-ai/sdk 1.18 — use `EventWorkspaceReady`. */
+export type { EventWorkspaceReady as V2EventWorkspaceReady } from '@opencode-ai/sdk/v2/client';
+/** @deprecated Renamed upstream in @opencode-ai/sdk 1.18 — use `EventWorkspaceStatus`. */
+export type { EventWorkspaceStatus as V2EventWorkspaceStatus } from '@opencode-ai/sdk/v2/client';
+/** @deprecated Renamed upstream in @opencode-ai/sdk 1.18 — use `EventWorktreeFailed`. */
+export type { EventWorktreeFailed as V2EventWorktreeFailed } from '@opencode-ai/sdk/v2/client';
+/** @deprecated Renamed upstream in @opencode-ai/sdk 1.18 — use `EventWorktreeReady`. */
+export type { EventWorktreeReady as V2EventWorktreeReady } from '@opencode-ai/sdk/v2/client';
+//# sourceMappingURL=opencode-v2-event-aliases.d.ts.map

package/dist/core/runtime/opencode-v2-event-aliases.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"opencode-v2-event-aliases.d.ts","sourceRoot":"","sources":["../../../src/core/runtime/opencode-v2-event-aliases.ts"],"names":[],"mappings":"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"}

package/dist/core/runtime/opencode-v2-event-aliases.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=opencode-v2-event-aliases.js.map

package/dist/core/runtime/opencode-v2-event-aliases.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"opencode-v2-event-aliases.js","sourceRoot":"","sources":["../../../src/core/runtime/opencode-v2-event-aliases.ts"],"names":[],"mappings":""}

package/dist/core/runtime/pty.d.ts

@@ -33,8 +33,18 @@ export declare function removeKortixPty(baseUrl: string, ptyId: string): Promise
  * mixed-content upgrade, and `?token=` query auth (WebSocket can't set
  * custom headers) the OpenCode-backed terminal used, just pointed at
  * `/kortix/pty` instead of OpenCode's `/pty`.
+ *
+ * `opts.wake` marks the attach as USER-INITIATED (the panel's first connect, or
+ * "Reconnect now"). A parked sandbox refuses the upgrade with 503, which the
+ * browser can only surface as close code 1006 — so without this marker the
+ * terminal reconnects forever against a box that nothing in the loop will ever
+ * wake. The API resumes a stopped box only for a marked attach
+ * (`shouldWakeStoppedSandboxForWsAttach`), so automatic backoff retries — which
+ * must never resurrect a box — leave it off.
  */
-export declare function getKortixPtyWebSocketUrl(ptyId: string, baseUrl: string): Promise<string>;
+export declare function getKortixPtyWebSocketUrl(ptyId: string, baseUrl: string, opts?: {
+    wake?: boolean;
+}): Promise<string>;
 /** Grouped namespace for ergonomic use (also available as named exports). */
 export declare const kortixPty: {
     list: typeof listKortixPty;

package/dist/core/runtime/pty.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pty.d.ts","sourceRoot":"","sources":["../../../src/core/runtime/pty.ts"],"names":[],"mappings":"AAiBA,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,SAAS,GAAG,QAAQ,CAAC;IAC7B,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAcD,+DAA+D;AAC/D,wBAAsB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC,CAKzE;AAED,uDAAuD;AACvD,wBAAsB,eAAe,CACnC,OAAO,EAAE,MAAM,EACf,IAAI,CAAC,EAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,GACvG,OAAO,CAAC,SAAS,CAAC,CASpB;AAED,gEAAgE;AAChE,wBAAsB,eAAe,CACnC,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,EACb,IAAI,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,GAC9D,OAAO,CAAC,SAAS,CAAC,CASpB;AAED,iEAAiE;AACjE,wBAAsB,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAInF;AAED;;;;;GAKG;AACH,wBAAsB,wBAAwB,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAwB9F;AAED,6EAA6E;AAC7E,eAAO,MAAM,SAAS;;;;;;CAMrB,CAAC"}
+{"version":3,"file":"pty.d.ts","sourceRoot":"","sources":["../../../src/core/runtime/pty.ts"],"names":[],"mappings":"AAiBA,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,SAAS,GAAG,QAAQ,CAAC;IAC7B,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAcD,+DAA+D;AAC/D,wBAAsB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC,CAKzE;AAED,uDAAuD;AACvD,wBAAsB,eAAe,CACnC,OAAO,EAAE,MAAM,EACf,IAAI,CAAC,EAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,GACvG,OAAO,CAAC,SAAS,CAAC,CASpB;AAED,gEAAgE;AAChE,wBAAsB,eAAe,CACnC,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,EACb,IAAI,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,GAC9D,OAAO,CAAC,SAAS,CAAC,CASpB;AAED,iEAAiE;AACjE,wBAAsB,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAInF;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,wBAAwB,CAC5C,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,MAAM,EACf,IAAI,CAAC,EAAE;IAAE,IAAI,CAAC,EAAE,OAAO,CAAA;CAAE,GACxB,OAAO,CAAC,MAAM,CAAC,CA2BjB;AAED,6EAA6E;AAC7E,eAAO,MAAM,SAAS;;;;;;CAMrB,CAAC"}

package/dist/core/runtime/pty.js

@@ -68,8 +68,16 @@ export async function removeKortixPty(baseUrl, ptyId) {
  * mixed-content upgrade, and `?token=` query auth (WebSocket can't set
  * custom headers) the OpenCode-backed terminal used, just pointed at
  * `/kortix/pty` instead of OpenCode's `/pty`.
+ *
+ * `opts.wake` marks the attach as USER-INITIATED (the panel's first connect, or
+ * "Reconnect now"). A parked sandbox refuses the upgrade with 503, which the
+ * browser can only surface as close code 1006 — so without this marker the
+ * terminal reconnects forever against a box that nothing in the loop will ever
+ * wake. The API resumes a stopped box only for a marked attach
+ * (`shouldWakeStoppedSandboxForWsAttach`), so automatic backoff retries — which
+ * must never resurrect a box — leave it off.
  */
-export async function getKortixPtyWebSocketUrl(ptyId, baseUrl) {
+export async function getKortixPtyWebSocketUrl(ptyId, baseUrl, opts) {
     const base = requireBaseUrl(baseUrl);
     const wsBase = (() => {
         try {
@@ -89,14 +97,19 @@ export async function getKortixPtyWebSocketUrl(ptyId, baseUrl) {
             return base.replace('https://', 'wss://').replace('http://', 'ws://');
         }
     })();
-    const url = `${wsBase}/kortix/pty/${encodeURIComponent(ptyId)}/connect`;
+    const connectUrl = `${wsBase}/kortix/pty/${encodeURIComponent(ptyId)}/connect`;
+    const params = new URLSearchParams();
     // Browser WebSocket API doesn't support custom headers, so inject the auth
     // token as a query param for the daemon (via the backend proxy) to check.
     const token = await getAuthToken();
-    if (!token)
-        return url;
-    const sep = url.includes('?') ? '&' : '?';
-    return `${url}${sep}token=${encodeURIComponent(token)}`;
+    if (token)
+        params.set('token', token);
+    if (opts?.wake)
+        params.set('wake', '1');
+    const query = params.toString();
+    if (!query)
+        return connectUrl;
+    return `${connectUrl}${connectUrl.includes('?') ? '&' : '?'}${query}`;
 }
 /** Grouped namespace for ergonomic use (also available as named exports). */
 export const kortixPty = {

package/dist/core/runtime/pty.js.map

@@ -1 +1 @@
-{"version":3,"file":"pty.js","sourceRoot":"","sources":["../../../src/core/runtime/pty.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"pty.js","sourceRoot":"","sources":["../../../src/core/runtime/pty.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAChE,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAa9D,KAAK,UAAU,eAAe,CAAC,GAAa,EAAE,QAAgB;IAC5D,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,CAAyC,CAAC,CAAC;IACxF,OAAO,IAAI,EAAE,KAAK,IAAI,IAAI,EAAE,OAAO,IAAI,GAAG,CAAC,UAAU,IAAI,QAAQ,CAAC;AACpE,CAAC;AAED,SAAS,cAAc,CAAC,OAAe;IACrC,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CAAC,8DAA8D,CAAC,CAAC;IAClF,CAAC;IACD,OAAO,oBAAoB,CAAC,OAAO,CAAC,CAAC;AACvC,CAAC;AAED,+DAA+D;AAC/D,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,OAAe;IACjD,MAAM,GAAG,GAAG,cAAc,CAAC,OAAO,CAAC,CAAC;IACpC,MAAM,GAAG,GAAG,MAAM,kBAAkB,CAAC,GAAG,GAAG,aAAa,CAAC,CAAC;IAC1D,IAAI,CAAC,GAAG,CAAC,EAAE;QAAE,MAAM,IAAI,KAAK,CAAC,MAAM,eAAe,CAAC,GAAG,EAAE,0BAA0B,CAAC,CAAC,CAAC;IACrF,OAAO,GAAG,CAAC,IAAI,EAAE,CAAC;AACpB,CAAC;AAED,uDAAuD;AACvD,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,OAAe,EACf,IAAwG;IAExG,MAAM,GAAG,GAAG,cAAc,CAAC,OAAO,CAAC,CAAC;IACpC,MAAM,GAAG,GAAG,MAAM,kBAAkB,CAAC,GAAG,GAAG,aAAa,EAAE;QACxD,MAAM,EAAE,MAAM;QACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;QAC/C,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,IAAI,EAAE,CAAC;KACjC,CAAC,CAAC;IACH,IAAI,CAAC,GAAG,CAAC,EAAE;QAAE,MAAM,IAAI,KAAK,CAAC,MAAM,eAAe,CAAC,GAAG,EAAE,2BAA2B,CAAC,CAAC,CAAC;IACtF,OAAO,GAAG,CAAC,IAAI,EAAE,CAAC;AACpB,CAAC;AAED,gEAAgE;AAChE,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,OAAe,EACf,KAAa,EACb,IAA+D;IAE/D,MAAM,GAAG,GAAG,cAAc,CAAC,OAAO,CAAC,CAAC;IACpC,MAAM,GAAG,GAAG,MAAM,kBAAkB,CAAC,GAAG,GAAG,eAAe,kBAAkB,CAAC,KAAK,CAAC,EAAE,EAAE;QACrF,MAAM,EAAE,OAAO;QACf,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;QAC/C,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;KAC3B,CAAC,CAAC;IACH,IAAI,CAAC,GAAG,CAAC,EAAE;QAAE,MAAM,IAAI,KAAK,CAAC,MAAM,eAAe,CAAC,GAAG,EAAE,2BAA2B,CAAC,CAAC,CAAC;IACtF,OAAO,GAAG,CAAC,IAAI,EAAE,CAAC;AACpB,CAAC;AAED,iEAAiE;AACjE,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,OAAe,EAAE,KAAa;IAClE,MAAM,GAAG,GAAG,cAAc,CAAC,OAAO,CAAC,CAAC;IACpC,MAAM,GAAG,GAAG,MAAM,kBAAkB,CAAC,GAAG,GAAG,eAAe,kBAAkB,CAAC,KAAK,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,CAAC;IAC7G,IAAI,CAAC,GAAG,CAAC,EAAE;QAAE,MAAM,IAAI,KAAK,CAAC,MAAM,eAAe,CAAC,GAAG,EAAE,2BAA2B,CAAC,CAAC,CAAC;AACxF,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAC5C,KAAa,EACb,OAAe,EACf,IAAyB;IAEzB,MAAM,IAAI,GAAG,cAAc,CAAC,OAAO,CAAC,CAAC;IACrC,MAAM,MAAM,GAAG,CAAC,GAAG,EAAE;QACnB,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,CAAC;YAC7B,IAAI,MAAM,CAAC,QAAQ,KAAK,QAAQ;gBAAE,MAAM,CAAC,QAAQ,GAAG,MAAM,CAAC;iBACtD,IAAI,MAAM,CAAC,QAAQ,KAAK,OAAO;gBAAE,MAAM,CAAC,QAAQ,GAAG,KAAK,CAAC;YAC9D,uEAAuE;YACvE,+DAA+D;YAC/D,IAAI,OAAO,MAAM,KAAK,WAAW,IAAI,MAAM,CAAC,QAAQ,CAAC,QAAQ,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,KAAK,KAAK,EAAE,CAAC;gBACxG,MAAM,CAAC,QAAQ,GAAG,MAAM,CAAC;YAC3B,CAAC;YACD,OAAO,oBAAoB,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC;QACjD,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC,OAAO,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;QACxE,CAAC;IACH,CAAC,CAAC,EAAE,CAAC;IACL,MAAM,UAAU,GAAG,GAAG,MAAM,eAAe,kBAAkB,CAAC,KAAK,CAAC,UAAU,CAAC;IAC/E,MAAM,MAAM,GAAG,IAAI,eAAe,EAAE,CAAC;IACrC,2EAA2E;IAC3E,0EAA0E;IAC1E,MAAM,KAAK,GAAG,MAAM,YAAY,EAAE,CAAC;IACnC,IAAI,KAAK;QAAE,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IACtC,IAAI,IAAI,EAAE,IAAI;QAAE,MAAM,CAAC,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IACxC,MAAM,KAAK,GAAG,MAAM,CAAC,QAAQ,EAAE,CAAC;IAChC,IAAI,CAAC,KAAK;QAAE,OAAO,UAAU,CAAC;IAC9B,OAAO,GAAG,UAAU,GAAG,UAAU,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,GAAG,KAAK,EAAE,CAAC;AACxE,CAAC;AAED,6EAA6E;AAC7E,MAAM,CAAC,MAAM,SAAS,GAAG;IACvB,IAAI,EAAE,aAAa;IACnB,MAAM,EAAE,eAAe;IACvB,MAAM,EAAE,eAAe;IACvB,MAAM,EAAE,eAAe;IACvB,YAAY,EAAE,wBAAwB;CACvC,CAAC"}

package/dist/core/session/connection.d.ts

@@ -0,0 +1,64 @@
+/**
+ * ONE answer to "what is this session's runtime doing", for every surface that
+ * draws it.
+ *
+ * ## Why this exists
+ *
+ * The frontend had four independent sources for that question — the control
+ * plane's session row, a health probe, the runtime's SSE frames, and the
+ * control plane's turn ledger — and every surface picked its own subset. The
+ * composer's notice read the probe, the sidebar dot read the row, the Stop
+ * button read the ledger and the stream. Each source has its own latency and
+ * its own failure mode, so on a cold load they answer in an arbitrary order and
+ * the surfaces disagree with each other and with the screen.
+ *
+ * Worse, the composer's notice treated the ABSENCE of an answer as an answer.
+ * A page reload of a session whose sandbox is up and mid-turn showed "Waking
+ * this session up…" for seconds before the runtime replied (screen recording,
+ * essentia 2026-08-24) — a negative claim asserted from having asked nobody.
+ *
+ * ## The rule
+ *
+ * A negative claim needs positive evidence. `unknown` is a real state and it is
+ * the honest one until something answers; nothing may render an alarm from it.
+ *
+ * Pure, so each rule below is a test rather than a habit.
+ */
+export type SessionConnection = 
+/** Nothing has answered yet. Say nothing; this is a cold load, not a fault. */
+'unknown'
+/** The control plane says the sandbox is not up. THIS is when "waking" is true. */
+ | 'waking'
+/** The sandbox is up and the runtime has not answered this tab yet. */
+ | 'connecting'
+/** The runtime is answering — a health pass, or its own output arriving. */
+ | 'live'
+/** Probed and failed past the threshold, or reachable-but-never-healthy. */
+ | 'unreachable';
+/** The control plane's statement about the sandbox behind this session. `null`
+ *  when the session row has not loaded — which is NOT the same as "stopped". */
+export type SandboxLifecycle = 
+/** Every value `ProjectSessionStatus` can take, plus `null` for "the row has
+ *  not loaded" — which is NOT the same as "stopped" and must never be read as
+ *  one. `archived` is accepted for a caller reading a sandbox row rather than
+ *  a session row. */
+'queued' | 'branching' | 'provisioning' | 'running' | 'stopped' | 'archived' | 'failed' | 'completed' | null;
+export interface SessionConnectionInputs {
+    /** `project_sessions.status` — the control plane's view of the box. */
+    sandbox: SandboxLifecycle;
+    /** The health probe passed (`useRuntimeReady`). */
+    runtimeReady: boolean;
+    /** The probe has given up (`useRuntimePhase() === 'unreachable'`). */
+    unreachable?: boolean;
+    /** Reachable, but never healthy for longer than the boot-stall grace period. */
+    stalled?: boolean;
+    /** The runtime's OWN OUTPUT is arriving right now — see `WorkingActivityInput`.
+     *  The strongest evidence there is: not a report about the runtime, the
+     *  runtime itself. */
+    activityFresh?: boolean;
+}
+export declare function projectSessionConnection(input: SessionConnectionInputs): SessionConnection;
+/** Whether a surface may draw an alarm (a notice, a warning colour) from this
+ *  state. `unknown` and `connecting` are waits, not faults. */
+export declare function connectionIsFaulted(connection: SessionConnection): boolean;
+//# sourceMappingURL=connection.d.ts.map

package/dist/core/session/connection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection.d.ts","sourceRoot":"","sources":["../../../src/core/session/connection.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,MAAM,iBAAiB;AAC3B,+EAA+E;AAC7E,SAAS;AACX,mFAAmF;GACjF,QAAQ;AACV,uEAAuE;GACrE,YAAY;AACd,4EAA4E;GAC1E,MAAM;AACR,4EAA4E;GAC1E,aAAa,CAAC;AAElB;gFACgF;AAChF,MAAM,MAAM,gBAAgB;AAC1B;;;qBAGqB;AACnB,QAAQ,GACR,WAAW,GACX,cAAc,GACd,SAAS,GACT,SAAS,GACT,UAAU,GACV,QAAQ,GACR,WAAW,GACX,IAAI,CAAC;AAET,MAAM,WAAW,uBAAuB;IACtC,uEAAuE;IACvE,OAAO,EAAE,gBAAgB,CAAC;IAC1B,mDAAmD;IACnD,YAAY,EAAE,OAAO,CAAC;IACtB,sEAAsE;IACtE,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,gFAAgF;IAChF,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;0BAEsB;IACtB,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,uBAAuB,GAAG,iBAAiB,CAwB1F;AAED;+DAC+D;AAC/D,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,iBAAiB,GAAG,OAAO,CAE1E"}

package/dist/core/session/connection.js

@@ -0,0 +1,36 @@
+export function projectSessionConnection(input) {
+    // Content outranks every probe, including one that has given up: a runtime
+    // that is emitting parts is reachable by definition, whatever a health check
+    // on a different path concluded.
+    if (input.activityFresh)
+        return 'live';
+    if (input.runtimeReady)
+        return 'live';
+    if (input.unreachable || input.stalled)
+        return 'unreachable';
+    // Positive evidence, and the ONLY thing that earns the word "waking".
+    if (input.sandbox === 'stopped' || input.sandbox === 'archived')
+        return 'waking';
+    if (input.sandbox === 'provisioning' ||
+        input.sandbox === 'queued' ||
+        input.sandbox === 'branching') {
+        return 'waking';
+    }
+    // A finished session has no runtime to reach and nothing to wake. Nothing is
+    // wrong with it, so nothing is announced.
+    if (input.sandbox === 'completed')
+        return 'unknown';
+    if (input.sandbox === 'failed')
+        return 'unreachable';
+    // The box is up; we simply have not reached it yet. Not an alarm.
+    if (input.sandbox === 'running')
+        return 'connecting';
+    // The row has not loaded. We know nothing, and we say nothing.
+    return 'unknown';
+}
+/** Whether a surface may draw an alarm (a notice, a warning colour) from this
+ *  state. `unknown` and `connecting` are waits, not faults. */
+export function connectionIsFaulted(connection) {
+    return connection === 'unreachable';
+}
+//# sourceMappingURL=connection.js.map

package/dist/core/session/connection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection.js","sourceRoot":"","sources":["../../../src/core/session/connection.ts"],"names":[],"mappings":"AAsEA,MAAM,UAAU,wBAAwB,CAAC,KAA8B;IACrE,2EAA2E;IAC3E,6EAA6E;IAC7E,iCAAiC;IACjC,IAAI,KAAK,CAAC,aAAa;QAAE,OAAO,MAAM,CAAC;IACvC,IAAI,KAAK,CAAC,YAAY;QAAE,OAAO,MAAM,CAAC;IACtC,IAAI,KAAK,CAAC,WAAW,IAAI,KAAK,CAAC,OAAO;QAAE,OAAO,aAAa,CAAC;IAC7D,sEAAsE;IACtE,IAAI,KAAK,CAAC,OAAO,KAAK,SAAS,IAAI,KAAK,CAAC,OAAO,KAAK,UAAU;QAAE,OAAO,QAAQ,CAAC;IACjF,IACE,KAAK,CAAC,OAAO,KAAK,cAAc;QAChC,KAAK,CAAC,OAAO,KAAK,QAAQ;QAC1B,KAAK,CAAC,OAAO,KAAK,WAAW,EAC7B,CAAC;QACD,OAAO,QAAQ,CAAC;IAClB,CAAC;IACD,6EAA6E;IAC7E,0CAA0C;IAC1C,IAAI,KAAK,CAAC,OAAO,KAAK,WAAW;QAAE,OAAO,SAAS,CAAC;IACpD,IAAI,KAAK,CAAC,OAAO,KAAK,QAAQ;QAAE,OAAO,aAAa,CAAC;IACrD,kEAAkE;IAClE,IAAI,KAAK,CAAC,OAAO,KAAK,SAAS;QAAE,OAAO,YAAY,CAAC;IACrD,+DAA+D;IAC/D,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;+DAC+D;AAC/D,MAAM,UAAU,mBAAmB,CAAC,UAA6B;IAC/D,OAAO,UAAU,KAAK,aAAa,CAAC;AACtC,CAAC"}

package/dist/core/session/index.d.ts

@@ -19,6 +19,8 @@ export * from './preview.js';
 export * from './preview-auth.js';
 export * from './preview-probe.js';
 export * from './presentation.js';
+export * from './connection.js';
 export * from './working.js';
 export * from './compaction.js';
+export * from './wake-escalation.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/core/session/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/session/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,cAAc,OAAO,CAAC;AACtB,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC;AAC1B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,WAAW,CAAC;AAC1B,cAAc,cAAc,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/session/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,cAAc,OAAO,CAAC;AACtB,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC;AAC1B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC;AAC1B,cAAc,cAAc,CAAC;AAC7B,cAAc,mBAAmB,CAAC"}

package/dist/core/session/index.js

@@ -19,6 +19,8 @@ export * from './preview.js';
 export * from './preview-auth.js';
 export * from './preview-probe.js';
 export * from './presentation.js';
+export * from './connection.js';
 export * from './working.js';
 export * from './compaction.js';
+export * from './wake-escalation.js';
 //# sourceMappingURL=index.js.map

package/dist/core/session/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/session/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,cAAc,OAAO,CAAC;AACtB,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC;AAC1B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,WAAW,CAAC;AAC1B,cAAc,cAAc,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/session/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,cAAc,OAAO,CAAC;AACtB,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC;AAC1B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC;AAC1B,cAAc,cAAc,CAAC;AAC7B,cAAc,mBAAmB,CAAC"}

package/dist/core/session/open-bundle.d.ts

@@ -0,0 +1,110 @@
+/**
+ * ONE session-open read, shared by every consumer that would otherwise issue
+ * its own.
+ *
+ * THE PROBLEM. Opening a session made 6 serial control-plane round trips before
+ * the first honest frame — the session row, `/turn`, `/prompts`,
+ * `/transcript?shape=sync`, `/detail`, `/model-defaults` — and then kept making
+ * them, because the hooks that need those facts each own their own query. On a
+ * real deployment that is 0.3-2.3 s per read at the median (measured over 20
+ * session opens, 2026-08-26), and the last one cannot start until the first
+ * lands.
+ *
+ * THE SHAPE. `GET .../open-bundle` answers all of it at once, and this module
+ * is the seam that lets the EXISTING consumers use it without knowing it exists:
+ *
+ *   1. The open path calls `openSessionBundle()` ONCE, in a LAYOUT effect. React
+ *      runs every layout effect, tree-wide, before any passive effect, and
+ *      TanStack starts a query's fetch from a passive effect — so the bundle is
+ *      always in flight before the first `/turn` or `/prompts` fetch begins.
+ *   2. Each consumer's own `queryFn` calls `claimOpenBundle()` FIRST. A claim
+ *      returns the shared promise while the bundle is in flight, or the resolved
+ *      bundle inside a short share window, and `null` otherwise.
+ *   3. `null` means "answer the way you always did". Every consumer keeps its
+ *      own endpoint, so an old server, a failed bundle and a steady-state poll
+ *      all still work. The bundle is an ACCELERATOR, never a dependency.
+ *
+ * WHY A CLAIM CANNOT START ONE. A `/turn` poll that could start a bundle would
+ * re-read the transcript and the model catalogue every 15 s for the life of the
+ * tab. Starting is the open path's decision; claiming is everyone else's.
+ *
+ * WHY THE TRANSCRIPT IS A SEPARATE, ONE-SHOT STASH. The mirror is hydrated once
+ * the session's OpenCode root is known, which on a cold box is 18.9-24.5 s after
+ * the open (measured) — long past the share window the turn and queue legs want.
+ * It is also the one leg that must never be served twice: a second hydrate over
+ * a store the runtime has already filled is how a transcript grows ghosts.
+ *
+ * EVERY LEG IS TRI-STATE. `known: false` projects to `null`, which sends the
+ * consumer to its endpoint. It must never project to the NEGATIVE answer — an
+ * empty queue, an idle turn, an empty thread — because a default rendered as an
+ * answer is the defect the bundle exists to remove.
+ */
+import { type SessionOpenBundle, type SessionPrompt, type SessionTranscriptSyncEnvelope, type SessionTurn, type SessionTurnEnded } from '../rest/projects-client/sessions.js';
+/**
+ * How long a resolved bundle keeps answering claims.
+ *
+ * It only has to outlast ONE session open's burst of first reads, not the
+ * session. Long enough and the steady-state `/turn` poll (5 s working / 15 s
+ * idle) would be answered from a snapshot instead of from the server; this
+ * window sits just under the fastest of those cadences on purpose.
+ */
+export declare const OPEN_BUNDLE_SHARE_MS = 5000;
+/** How long the one-shot transcript stash survives. Sized for the slowest
+ *  measured cold box (24.5 s Platinum) with headroom, because the hydrate that
+ *  consumes it cannot run until the runtime identity resolves. */
+export declare const OPEN_BUNDLE_TRANSCRIPT_TTL_MS = 60000;
+/** The mirrored-message window an open asks for — the same span the sync
+ *  controller's own first read covers. */
+export declare const OPEN_BUNDLE_TRANSCRIPT_LIMIT = 40;
+/** Drop everything. Tests only — a module singleton with no reset is a test
+ *  that passes because of the one before it. */
+export declare function resetSessionOpenBundles(): void;
+export interface OpenSessionBundleOptions {
+    /** Mirrored messages to ask for. `0` requests the POINTER only — what a
+     *  client whose store is already warm wants. */
+    transcript?: number;
+    /** Injected clock, for tests. */
+    now?: () => number;
+}
+/**
+ * Start the session-open read for `(projectId, sessionId)`.
+ *
+ * Fire-and-forget and idempotent within the share window: calling it twice for
+ * one open (two hooks, StrictMode's double mount) issues one request. Never
+ * throws and never rejects — a failed bundle simply resolves `null` and every
+ * consumer falls back to its own endpoint.
+ */
+export declare function openSessionBundle(projectId: string, sessionId: string, options?: OpenSessionBundleOptions): void;
+/**
+ * Claim the in-flight or freshly-resolved bundle for this session.
+ *
+ * Returns the shared promise, or `null` when there is nothing to share — which
+ * is the signal to read the endpoint the normal way. Synchronous in the `null`
+ * case on purpose: a consumer must be able to decide without awaiting.
+ */
+export declare function claimOpenBundle(projectId: string, sessionId: string, nowMs?: number): Promise<SessionOpenBundle | null> | null;
+/** One `GET .../turn` answer plus the instant the SERVER took it. Structurally
+ *  the observation `useSessionWorking` stamps for itself — the ranking rule it
+ *  feeds only works if the stamp is the read's own instant, never arrival. */
+export interface OpenBundleTurnObservation {
+    turns: SessionTurn[];
+    last_ended: SessionTurnEnded | undefined;
+    atMs: number;
+}
+/**
+ * Project the turn leg. `null` for an unknown leg — never `{ turns: [] }`,
+ * which would be an idle claim made by something that did not know.
+ */
+export declare function openBundleTurn(bundle: SessionOpenBundle): OpenBundleTurnObservation | null;
+/** Project the queue leg. `null` for an unknown leg — never `[]`, which would
+ *  render as "nothing queued" for a queue nobody could read. */
+export declare function openBundleQueue(bundle: SessionOpenBundle): SessionPrompt[] | null;
+/**
+ * Take the mirrored transcript this open fetched, ONCE.
+ *
+ * One-shot by design: the hydrate that consumes it is the only reader that may
+ * paint a snapshot, and a second paint over a store the runtime has already
+ * filled is how a transcript grows ghosts.
+ */
+export declare function takeOpenBundleTranscript(projectId: string, sessionId: string, nowMs?: number): SessionTranscriptSyncEnvelope | null;
+//# sourceMappingURL=open-bundle.d.ts.map

package/dist/core/session/open-bundle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"open-bundle.d.ts","sourceRoot":"","sources":["../../../src/core/session/open-bundle.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AAEH,OAAO,EACL,KAAK,iBAAiB,EACtB,KAAK,aAAa,EAClB,KAAK,6BAA6B,EAClC,KAAK,WAAW,EAChB,KAAK,gBAAgB,EAEtB,MAAM,kCAAkC,CAAC;AAE1C;;;;;;;GAOG;AACH,eAAO,MAAM,oBAAoB,OAAQ,CAAC;AAE1C;;kEAEkE;AAClE,eAAO,MAAM,6BAA6B,QAAS,CAAC;AAEpD;0CAC0C;AAC1C,eAAO,MAAM,4BAA4B,KAAK,CAAC;AAyB/C;gDACgD;AAChD,wBAAgB,uBAAuB,IAAI,IAAI,CAG9C;AAED,MAAM,WAAW,wBAAwB;IACvC;oDACgD;IAChD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,iCAAiC;IACjC,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;CACpB;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAC/B,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE,wBAA6B,GACrC,IAAI,CAyBN;AASD;;;;;;GAMG;AACH,wBAAgB,eAAe,CAC7B,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,KAAK,GAAE,MAAmB,GACzB,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC,GAAG,IAAI,CAU1C;AAED;;8EAE8E;AAC9E,MAAM,WAAW,yBAAyB;IACxC,KAAK,EAAE,WAAW,EAAE,CAAC;IACrB,UAAU,EAAE,gBAAgB,GAAG,SAAS,CAAC;IACzC,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,iBAAiB,GAAG,yBAAyB,GAAG,IAAI,CAS1F;AAED;gEACgE;AAChE,wBAAgB,eAAe,CAAC,MAAM,EAAE,iBAAiB,GAAG,aAAa,EAAE,GAAG,IAAI,CAIjF;AAYD;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CACtC,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,KAAK,GAAE,MAAmB,GACzB,6BAA6B,GAAG,IAAI,CAOtC"}