@robota-sdk/agent-interface-session 3.0.0-beta.81 → 3.0.0-beta.83

package/CHANGELOG.md

@@ -0,0 +1,336 @@
+# @robota-sdk/agent-interface-session
+
+## 3.0.0-beta.83
+
+### Major Changes
+
+- 7b72344: Every client can offer the session's commands and skills and show its status. The GUI uses them as a
+  desktop-style composer.
+
+  - `agent-interface-session` is **`major` because `IInteractiveSession` gains required members**:
+    `ISessionCommands.listSkills()` and a `statusRead` capability, `getStatusSnapshot()`. The snapshot
+    holds session, model, permission mode, effort, context and goal. An external implementation stops
+    compiling until it adds both.
+  - `agent-transport` is **`major` for the same reason on `IProtocolSession`**. It also gains the wire
+    messages `get-commands` → `commands` and `get-status` → `session_status`. Both are reads that the
+    observe role may send.
+  - `agent-interface-command` gains `ICommandSkillListEntry`, moved from `agent-framework`, which
+    re-exports it unchanged.
+  - `agent-ui-web` is **`major` because its state changes shape**:
+    - A command's outcome and a finished turn's tool calls are now conversation entries: `messages` is
+      `TConversationEntry[]`.
+    - The `uiIntentNotices` list, `dismissUiIntentNotice`, `applyUiIntentEvent`,
+      `removeUiIntentNotice` and `IUiIntentNotice` are removed. An intent now answers with an info
+      line in the conversation.
+    - Session notices keep only `session-error` and `protocol-error`.
+    - The state gains `commandCatalog` and `sessionStatus`.
+  - `agent-command` registers `/theme` and `/keybindings` even without a terminal. They then answer
+    that they belong to the robota terminal, instead of being unknown.
+  - `agent-framework`:
+    - `InteractiveSession.getStatusSnapshot()`.
+    - The main-thread row previews the last chat message instead of the last record's type.
+  - `agent-cli` serves the full GUI web app, renamed from `agent-cli-web` to `agent-gui-web`, on
+    `robota --serve --open`.
+
+- 6ae3f28: A served runtime can list its workspace's sessions, start a new one and switch to another without the
+  process or any client connection restarting. The GUI shows them in a sessions sidebar.
+
+  - `agent-interface-session` is **`major`** for two reasons:
+    - It adds `ISessionListing`, `ISessionDirectory` and `ISessionSwitchedEvent`.
+    - `IInteractiveSessionEvents` gains a required `session_switched` event. An exhaustive map over the
+      event names stops compiling until it classifies the new event.
+  - `agent-transport` is **`major`** for the same kind of reason:
+    - It adds the wire messages `list-sessions` → `sessions`/`sessions_error`, `new-session`,
+      `switch-session`, and the broadcast `session_switched`.
+    - It adds a `sessionDirectory` handler option. A refusal to switch comes back as a
+      `protocol_error` carrying the reason.
+    - An exhaustive map over message types must add the new variants.
+  - `agent-transport-ws` passes a configured `sessionDirectory` to every connection.
+  - `agent-framework` is **`major` because `IRuntimeHostHandle.session` is now a `SessionSlot`**, not the
+    `InteractiveSession`, and `bindTransports` receives the slot.
+    - The slot is an `IInteractiveSession` that forwards to the current session. Members outside that
+      interface are read through `host.session.current`, which changes on a switch.
+    - Adds `InteractiveSession.whenInitialized()`.
+    - Exports `listUnreadableSessions`.
+  - `agent-ui-web` is **`major`**:
+    - `IWsSessionState` gains session listing state and actions.
+    - It adds a `SessionSidebar`.
+    - `/resume` opens the sidebar.
+  - `agent-cli`: `robota --serve` provides the session directory, and refuses a switch that would lose
+    work in progress. External-event grants belong to the run: a switch reopens them on the new session,
+    as the TUI already does.
+  - External-event grant history (spent tokens, rate windows, revocations) belongs to the run. The new
+    option `externalEventGrantHistory` (from `createExternalEventGrantHistory()`) is shared by every
+    session that a served runtime or the TUI builds. A session switch therefore replays no spent token
+    and resets no rate limit. The TUI previously had this gap when it switched sessions.
+
+- ba822c1: An attached client reads a workspace entry's detail, stops a waiting self-paced loop, completes
+  subcommands, and sees status changes another client made.
+
+  - `agent-interface-session` (major): `IInteractiveSession` gains the required roles
+    `ISessionExecutionDetail` and `ISessionSelfPacedLoopControl` (`TWaitingLoopStopOutcome`), and the
+    exhaustively mapped event map gains `status_changed`.
+  - `agent-transport` (major): `IProtocolSession` gains both roles; the wire unions gain
+    `read-execution-detail`, `stop-waiting-loop`, `execution_detail`, `execution_detail_error` and
+    `waiting_loop_stop`; `status_changed` is pushed as `session_status`; `isObserverMessageType` is
+    exported from the root and `./client`.
+  - `agent-interface-command` (minor): `ICommandListEntry` gains optional `argumentHint` and
+    `subcommands` (`ICommandSubcommandEntry`).
+  - `agent-cli` (minor):
+    - `robota session attach` and an attach from `robota session view` open the full terminal UI,
+      the one `robota --attach` opens, in drive mode or, with `--observe`, read-only. The reduced
+      attached view is gone.
+    - A served runtime names each of its sessions after the session's first real turn.
+  - `agent-framework` (minor):
+    - `InteractiveSession` gains `stopWaitingSelfPacedLoop(reason?)`: it stops the one waiting loop,
+      or stops none and names `/loop stop` when several wait. `SessionSlot` forwards it and
+      `readExecutionWorkspaceDetail`.
+    - The session emits `status_changed` when its mode, model, effort, goal or name changes, after a
+      command, a turn, a rename or a goal or plan transition.
+    - A new option `autoName: true` makes the session name itself once, after its first turn, with its
+      current provider; it keeps a name it already has and lets a rename made meanwhile win. Off by
+      default.
+    - The command catalog carries each command's `argumentHint` and `subcommands`.
+  - `agent-ui-terminal` (major):
+    - The full terminal UI attached to a host's session reads a workspace entry's detail, sends input
+      to a background task, stops a waiting self-paced loop on Esc, and completes subcommands.
+    - `renderAttachedApp` takes `mode: 'drive' | 'observe'` (default `'drive'`) and `announce`. In
+      observe mode the terminal sends only what an observer may send, refuses prompts, host commands,
+      abort and loop stop with a read-only notice, still runs `/exit` and its own commands, and its
+      status bar says it is observing. `ITuiChannelSnapshot` gains `readOnly`.
+    - The in-process terminal no longer names sessions; it builds its session with `autoName: true`.
+      `ITuiInteractionChannelOptions.onAutoNamed` is removed.
+
+- 6e6b06b: A wire client can now render the whole session the way the in-process terminal UI does: the full
+  history, the context window as it changes, when the history changes, and where each turn came from.
+
+  - `agent-interface-session` is **`major`**: `ISessionConversationRead` gains a required
+    `getFullHistory()`. Any implementation of it, or of `IInteractiveSession`, must add it.
+  - `agent-transport` is **`major`**:
+    - It adds `get-history { fromIndex? }` → `history { startIndex, total, entries }`. The history
+      crosses one bounded page at a time (at most 256 KiB of entries; a single larger entry is sent
+      alone), from `fromIndex` (default 0), so no reply grows with the session. The client asks for
+      the next page after the previous one arrived. Entries are `IWireHistoryEntry`: a history entry
+      with an ISO 8601 `timestamp`. An observer may send it.
+    - `complete` and `interrupted` carry the turn's result without the session's history
+      (`TWireExecutionResult`); a client reads the history with `get-history`.
+    - It adds `get-prompts`: the host sends the permission and ask prompts still open as the
+      `permission_request` / `ask_request` frames that asked them, for a client that attached later.
+      An observer may not send it.
+    - `pending` gains an optional `pendingCount`: a host sends it when it knows how many prompts are
+      queued, and a client that gets none counts the prompt it shows. The host sends `pending` in
+      reply to a `submit` once it has taken the prompt, so a prompt queued behind a running turn shows
+      as queued.
+    - `command` takes an optional `requestId`, which the host echoes on the command's
+      `command_result` or `protocol_error`.
+    - The session's `context_update` is pushed as the `context` frame that `get-context` answers with.
+    - `compact`, `skill_activation` and `memory_event` push the new `history_changed`; the client
+      reads the history again.
+    - `turn_source` is pushed as the new `turn_source` frame.
+    - An exhaustive map over `TClientMessage` or `TServerMessage` types must add the new variants,
+      and `IProtocolSession` now requires `getFullHistory()`.
+  - `agent-transport-http` is **`major`** only because `IHttpTransportSession` includes the conversation
+    read role, so a session handed to it must now provide `getFullHistory()`.
+  - `agent-framework`: `SessionSlot` forwards `getFullHistory()` to the current session.
+  - `agent-ui-web` receives the new frames and does not render them.
+
+### Minor Changes
+
+- 57f57f5: A daemon keeps several sessions live, and each client is bound to its own: one client's switch moves
+  only that client.
+
+  - `agent-interface-session`: `ISessionBinder`/`ISessionBinding`, the session-change refusal codes with
+    `isSessionChangeRefusal`, and listing rows that may say `live` and `clients`.
+  - `agent-framework`: `SessionPool` and `SessionChangeRefusal`.
+  - `agent-transport` (**major**): a new server frame, `session_change_failed`, which an exhaustive
+    consumer must handle. A refused `new-session` or `switch-session` now answers with it, carrying a
+    `code`, instead of `protocol_error`; both requests take an optional `requestId` that it echoes.
+  - `agent-transport-ws`: the `sessionBinder` option binds each connection to its own session and
+    releases the binding when the connection closes.
+  - `agent-cli`: `robota --serve` and the daemon keep up to four sessions live. Each WebSocket client and
+    attached terminal is bound to its own session; leaving a busy session is no longer refused, and only
+    the last driver of a session with a pending prompt is kept from leaving it. Grants and the supervised
+    name stay on the runtime's first session, and its reported activity covers every live session.
+  - `agent-ui-web`: a refused new or switch shows the host's reason as a notice (an older host's
+    `protocol_error` still does); the session sidebar marks live sessions and counts the other clients
+    on each; after a reconnect to a host that keeps sessions live, the GUI returns to the session it was on.
+  - `agent-ui-terminal`: an attached terminal shows why a switch was refused, and the picker's switch
+    stays pending until the host answers; the session picker marks live sessions and their clients.
+
+### Patch Changes
+
+- 57280bf: Every published package now declares `"engines": { "node": ">=22.12.0" }`. Before, 27 of the 38
+  packages declared no floor (`agent-core`, `agent-tools` and every provider among them),
+  `agent-session` and `agent-file-authority` declared `>=20.19.0`, and the other nine declared
+  `>=22.0.0`, so a consumer on Node 20 saw at most a warning from a transitive dependency.
+
+  Why 22.12: `agent-cli` and `agent-ui-terminal` need Node 22 through `ink` 7, and the CommonJS entries
+  of `agent-tools` and its dependents, `agent-transport`/`node` and its dependents, and
+  `agent-ui-terminal` `require()` ESM-only dependencies (`p-limit`, `jose`, `chalk`), which Node 22
+  supports unflagged only from 22.12. `engines` is advisory unless the consumer enables `engine-strict`.
+
+  No code changes: `tsdown` now reads `node22.12.0` as its build target from the field.
+
+- 18c0d5c: Every published package now exports `./package.json`, so `require('<package>/package.json')` and
+  `import('<package>/package.json', { with: { type: 'json' } })` work instead of failing with
+  `ERR_PACKAGE_PATH_NOT_EXPORTED`, and each tarball now ships the package's `CHANGELOG.md`.
+- Updated dependencies [3c81769]
+- Updated dependencies [e689c8e]
+- Updated dependencies [7b72344]
+- Updated dependencies [be0e53c]
+- Updated dependencies [ba822c1]
+- Updated dependencies [9721162]
+- Updated dependencies [8bd5fac]
+- Updated dependencies [57280bf]
+- Updated dependencies [5033dd9]
+- Updated dependencies [18c0d5c]
+- Updated dependencies [dbd888d]
+- Updated dependencies [1887e54]
+  - @robota-sdk/agent-interface-analytics@3.0.0-beta.83
+  - @robota-sdk/agent-core@3.0.0-beta.83
+  - @robota-sdk/agent-interface-command@3.0.0-beta.83
+  - @robota-sdk/agent-interface-execution@3.0.0-beta.83
+
+## 3.0.0-beta.82
+
+### Patch Changes
+
+- Updated dependencies [c7f9203]
+  - @robota-sdk/agent-core@3.0.0-beta.82
+  - @robota-sdk/agent-interface-command@3.0.0-beta.82
+  - @robota-sdk/agent-interface-execution@3.0.0-beta.82
+  - @robota-sdk/agent-interface-analytics@3.0.0-beta.82
+
+## 3.0.0-beta.81
+
+### Minor Changes
+
+- 3038eb7: A message from another session is instant messaging: text from an untrusted third party that
+  carries no authority. What the model does with it is decided by the session's ordinary permissions —
+  rules, permission mode and remembered consent — exactly like the session's own work. The per-origin
+  peer policy is gone.
+
+  **BREAKING**
+
+  - `agent-core`: `IPermissionEvaluationContext.peerTurn` is now a boolean. It decides only whether a
+    `repliesToPeer` tool exists; every other call in a peer turn is decided as in any turn. Removed:
+    `isToolAvailableInPeerTurn`, `isSecretPath`, `IPeerTurnAuthority`, `TPeerReach` (now exported by
+    `agent-interface-session-mobility`) and `IToolPermissionProfile.workspacePaths`.
+  - `agent-tools`: `Read` and `Glob` no longer declare `workspacePaths`.
+  - `agent-session`: `ISessionRunOptions.peerReach` is replaced by `peerTurn?: boolean`, and
+    `ISessionOptions.allowPeerChanges` is removed. An ask in a peer turn is answered like any other:
+    a consent the operator remembered answers it, and an "always allow" given there is remembered.
+  - `agent-interface-session`: `IPeerTurnContext` no longer has `reach`; it carries only the reply
+    route.
+  - `agent-interface-session-mobility`: `peerReachOf` is removed; `TPeerReach` moves here. A delegated
+    turn carries no reach.
+  - `agent-framework`: the `peers.allowChanges` setting is removed (an existing value is ignored). A
+    peer turn is offered the ordinary tools, plus `peer_reply`.
+
+  **Changes**
+
+  - `agent-framework`: the per-turn statement tells the model the message is an opinion from an
+    untrusted third party, not its owner's instruction, and that it decides for itself whether and how
+    to act. A message still expands no `@path` and attaches no context reference, and its requests
+    still carry no provider-hosted tool, since no permission step can decide one. The session takes
+    at most 6 messages a minute and 30 an hour from each sender for a turn; a message over the limit
+    is refused with a reason the sender receives. A prompt answer given in the name of a `peer:` or `external:`
+    driver is ignored. External-event turns keep their tool-less baseline.
+  - `agent-cli`: incoming peer turns carry only their reply route.
+
+### Patch Changes
+
+- Updated dependencies [3038eb7]
+- Updated dependencies [02b7452]
+- Updated dependencies [ec5e477]
+- Updated dependencies [18b52cc]
+  - @robota-sdk/agent-core@3.0.0-beta.81
+  - @robota-sdk/agent-interface-command@3.0.0-beta.81
+  - @robota-sdk/agent-interface-execution@3.0.0-beta.81
+  - @robota-sdk/agent-interface-analytics@3.0.0-beta.81
+
+## 3.0.0-beta.80
+
+### Minor Changes
+
+- 37b4bd7: `readAssistantReplies`, `readErrors`, `readLastAssistantText` and `readToolCalls` are exported from
+  `@robota-sdk/agent-interface-session`, which is now published alongside
+  `@robota-sdk/agent-interface-transport` (issue #2260).
+
+  The four helpers shipped from `agent-interface-transport@3.0.0-beta.79` and moved to the session
+  package on `develop` (ARCH-103..108), which was not yet on the registry. A consumer importing them
+  from the transport package migrates the import to `@robota-sdk/agent-interface-session`; the session
+  package is in the changeset fixed group, so it versions and publishes with the transport package.
+
+### Patch Changes
+
+- 4f3c075: Assemble complete, verified package generations before switching build output; preserve the previous generation on build failure and pack only verified regular-file images. Include copied CLI web assets in affected-build ordering and artifact transfer. Preserve the CLI version in managed build paths. Public runtime contracts remain compatible (patch).
+- 07b627f: A local peer can now be answered, and what its turn may do depends on where it runs.
+
+  - `agent-core`: the permission evaluator takes a peer turn's authority as one more input
+    (`IPermissionEvaluationContext.peerTurn`), decided after the deny list and ceiling and before
+    bypass and allow rules. A peer on another host uses no tool. A peer on the same host may use an
+    inspect-class tool that declares `workspacePaths`, only when every named location resolves inside
+    the workspace and is not a credential (`isSecretPath`); write and execute tools are refused unless
+    enabled, and then every use asks. A tool declaring `repliesToPeer` exists only in a peer turn and
+    asks once the turn used another tool. New: `isToolAvailableInPeerTurn`, `TPeerReach`,
+    `IPeerTurnAuthority`. `IRunOptions.withholdHostedTools` leaves a provider's hosted tools out of a
+    run's requests (`nativeWebTools` with `false` withholds a hosted tool for one call).
+  - `agent-tools`: `Read` and `Glob` declare the arguments that say where they look. `Grep` does not:
+    it reads files it was never named, so a peer turn does not get it.
+  - `agent-session`: `ISessionRunOptions.peerReach` makes a run a peer turn for the permission policy;
+    every ask in it needs a fresh approval, and its requests carry no provider-hosted tool. `ISessionOptions.allowPeerChanges` enables write and execute
+    tools for same-host peer turns.
+  - `agent-interface-session`: `ISubmitOptions.peer` (`IPeerTurnContext`) carries a peer turn's reach,
+    the message it answers and the session a reply goes to.
+  - `agent-interface-session-mobility`: `IPeerMessage.inReplyTo` threads a conversation;
+    `peerReachOf(admission)` maps admission to a reach.
+  - `agent-framework`: a peer turn is offered what its origin allows, and a new `peer_reply` tool
+    answers the peer that sent the message, threaded to it. The setting `peers.allowChanges` enables
+    write and execute tools for same-host peer turns.
+  - `agent-ui-terminal`: a permission prompt in a peer turn names the requesting peer.
+  - `agent-cli`: incoming peer turns carry their reach and reply route; a conversation is limited in
+    depth and in how often this session answers it, and a reply over a limit is not sent and the
+    operator is told.
+  - `agent-provider-anthropic`, `agent-provider-openai-compatible` (Qwen): a request whose
+    `nativeWebTools` sets a hosted tool to `false` is sent without it.
+
+- Updated dependencies [9c19c50]
+- Updated dependencies [7b6234c]
+- Updated dependencies [5307f8a]
+- Updated dependencies [b462ee7]
+- Updated dependencies [4eea54b]
+- Updated dependencies [1698be4]
+- Updated dependencies [d4189b9]
+- Updated dependencies [9edae52]
+- Updated dependencies [4078a72]
+- Updated dependencies [4c73a0b]
+- Updated dependencies [af2f2ad]
+- Updated dependencies [196a900]
+- Updated dependencies [f336838]
+- Updated dependencies [34e50f0]
+- Updated dependencies [722e88a]
+- Updated dependencies [d23c848]
+- Updated dependencies [fec722f]
+- Updated dependencies [2d3b2c0]
+- Updated dependencies [4772067]
+- Updated dependencies [9fbab1b]
+- Updated dependencies [a009f5b]
+- Updated dependencies [4f3c075]
+- Updated dependencies [475e085]
+- Updated dependencies [e477440]
+- Updated dependencies [9dcb5da]
+- Updated dependencies [a95ca85]
+- Updated dependencies [b6d14ce]
+- Updated dependencies [0382a51]
+- Updated dependencies [93d061d]
+- Updated dependencies [39554a1]
+- Updated dependencies [d28430a]
+- Updated dependencies [07b627f]
+- Updated dependencies [d0de5b2]
+- Updated dependencies [d6b9404]
+- Updated dependencies [9814afc]
+  - @robota-sdk/agent-interface-execution@3.0.0-beta.80
+  - @robota-sdk/agent-interface-command@3.0.0-beta.80
+  - @robota-sdk/agent-core@3.0.0-beta.80
+  - @robota-sdk/agent-interface-analytics@3.0.0-beta.80

package/dist/node/index.cjs

@@ -1 +1 @@
-Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("./session-capability-contracts-D1Oi21Hn.cjs");function t(e){return e.filter(e=>e.type===`assistant-done`).map(e=>e.fullText)}function n(e){return t(e).at(-1)}function r(e){return e.filter(e=>e.type===`tool-call`).map(e=>({id:e.id,name:e.name,args:e.args}))}function i(e){return e.filter(e=>e.type===`error`).map(e=>e.error)}function a(e){return e instanceof Error&&e.name===`TurnNotRunError`}exports.AGENT_DRIVER_ID=`agent`,exports.OWNER_DRIVER_ID=`owner`,exports.SESSION_CAPABILITY_MEMBER_KEYS=e.t,exports.isTurnNotRunError=a,exports.readAssistantReplies=t,exports.readErrors=i,exports.readLastAssistantText=n,exports.readToolCalls=r;
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("./session-capability-contracts-D-hom_lk.cjs"),t=Object.freeze([`not_available`,`stopping`,`in_progress`,`prompt_pending`,`unknown_session`,`unreadable`,`start_failed`,`limit`,`failed`]);function n(e){return e instanceof Error&&e.name===`SessionChangeRefusal`&&t.includes(e.code)}function r(e){return e.filter(e=>e.type===`assistant-done`).map(e=>e.fullText)}function i(e){return r(e).at(-1)}function a(e){return e.filter(e=>e.type===`tool-call`).map(e=>({id:e.id,name:e.name,args:e.args}))}function o(e){return e.filter(e=>e.type===`error`).map(e=>e.error)}function s(e){return e instanceof Error&&e.name===`TurnNotRunError`}exports.AGENT_DRIVER_ID=`agent`,exports.OWNER_DRIVER_ID=`owner`,exports.SESSION_CAPABILITY_MEMBER_KEYS=e.t,exports.SESSION_CHANGE_REFUSAL_CODES=t,exports.isSessionChangeRefusal=n,exports.isTurnNotRunError=s,exports.readAssistantReplies=r,exports.readErrors=o,exports.readLastAssistantText=i,exports.readToolCalls=a;

package/dist/node/index.d.cts

@@ -1,15 +1,45 @@
-import { $ as TDriverId, A as IGoalEvent, B as TGoalStatus, C as TSessionCapabilityHost, Ct as TCompactTrigger, D as IBranchEvent, E as IAskRequestEvent, F as IPlanApprovalEvent, G as TPlanPhase, H as TInteractiveEventName, I as IPlanArtifact, J as IPeerTurnContext, K as TPlanStepStatus, L as IPlanStep, M as IGoalState, N as IInteractiveSessionEvents, O as IContextFileRefreshedEvent, P as IPermissionRequestEvent, Q as OWNER_DRIVER_ID, R as IPromptResolvedEvent, S as SESSION_CAPABILITY_MEMBER_KEYS, St as ICompactEvent, T as IActiveBranchPointer, U as TInteractivePermissionHandler, V as TGoalStopReason, W as TPermissionResultValue, X as ISubmitOptions, Y as ISessionRenamedEvent, Z as IUiIntentEvent, _ as ISessionPromptResolution, _t as TSkillActivationStatus, a as ISessionBackgroundTasks, at as isTurnNotRunError, b as ISessionTurnSubmission, bt as ISessionLoopState, c as ISessionCommands, ct as IMemoryEvent, d as ISessionEvents, dt as TContextReferenceLoadType, et as IExecutionResult, f as ISessionExecutionState, ft as TContextReferenceStatus, g as ISessionLifecycle, gt as TSkillActivationSource, h as ISessionIdentity, ht as TSkillActivationMode, i as ISessionBackgroundGroups, it as TTurnSource, j as IGoalProgressEntry, k as IDiffLine, l as ISessionConversationRead, lt as IMemoryReference, m as ISessionGoal, mt as TSkillActivationInvocation, n as IInteractiveSessionRecord, nt as ITurnNotRunError, o as ISessionCapabilityHost, ot as IToolSummary, p as ISessionExecutionWorkspace, pt as TMemoryType, q as AGENT_DRIVER_ID, r as ISessionAgentJobs, rt as TTurnNotRunReason, s as ISessionCapabilityMap, st as IContextReferenceItem, t as IInteractiveSession, tt as ITurnHandle, u as ISessionDriverAttribution, ut as ISkillActivationEvent, v as ISessionRuntimeTools, vt as IPromptFileReferenceRecord, w as TSessionCapabilityReadResult, x as ISessionWorkspaceLocation, xt as TSessionLoopPhase, y as ISessionTurnControl, yt as TPromptFileReferenceReason, z as IToolState } from "./session-contracts-BVCzd3uY.cjs";
+import { $ as ISessionRenamedEvent, A as IBranchEvent, At as ISessionListingEntry, B as IPlanStep, C as ISessionTurnSubmission, Ct as TPromptFileReferenceReason, D as TSessionCapabilityReadResult, Dt as IResumableSessionSummary, E as TSessionCapabilityHost, Et as TWaitingLoopStopOutcome, F as IGoalState, G as TGoalStopReason, H as ISessionStatusSnapshot, I as IInteractiveSessionEvents, J as TPermissionResultValue, K as TInteractiveEventName, L as IPermissionRequestEvent, M as IDiffLine, Mt as ICompactEvent, N as IGoalEvent, Nt as TCompactTrigger, O as IActiveBranchPointer, Ot as ISessionDirectory, P as IGoalProgressEntry, Q as IPeerTurnContext, R as IPlanApprovalEvent, S as ISessionTurnControl, St as IPromptFileReferenceRecord, T as SESSION_CAPABILITY_MEMBER_KEYS, Tt as TSessionLoopPhase, U as IToolState, V as IPromptResolvedEvent, W as TGoalStatus, X as TPlanStepStatus, Y as TPlanPhase, Z as AGENT_DRIVER_ID, _ as ISessionLifecycle, _t as TMemoryType, a as ISessionBackgroundTasks, at as ITurnHandle, b as ISessionSelfPacedLoopControl, bt as TSkillActivationSource, c as ISessionCommands, ct as TTurnSource, d as ISessionEvents, dt as IContextReferenceItem, et as ISubmitOptions, f as ISessionExecutionDetail, ft as IMemoryEvent, g as ISessionIdentity, gt as TContextReferenceStatus, h as ISessionGoal, ht as TContextReferenceLoadType, i as ISessionBackgroundGroups, it as IExecutionResult, j as IContextFileRefreshedEvent, jt as ISessionSwitchedEvent, k as IAskRequestEvent, kt as ISessionListing, l as ISessionConversationRead, lt as isTurnNotRunError, m as ISessionExecutionWorkspace, mt as ISkillActivationEvent, n as IInteractiveSessionRecord, nt as OWNER_DRIVER_ID, o as ISessionCapabilityHost, ot as ITurnNotRunError, p as ISessionExecutionState, pt as IMemoryReference, q as TInteractivePermissionHandler, r as ISessionAgentJobs, rt as TDriverId, s as ISessionCapabilityMap, st as TTurnNotRunReason, t as IInteractiveSession, tt as IUiIntentEvent, u as ISessionDriverAttribution, ut as IToolSummary, v as ISessionPromptResolution, vt as TSkillActivationInvocation, w as ISessionWorkspaceLocation, wt as ISessionLoopState, x as ISessionStatusRead, xt as TSkillActivationStatus, y as ISessionRuntimeTools, yt as TSkillActivationMode, z as IPlanArtifact } from "./session-contracts-Cv9Jeiyw.cjs";
 import { IActionRequest, TActionResponse } from "@robota-sdk/agent-core";
-//#region src/session-summary-contracts.d.ts
-/** Projection used to render a resume picker. */
-interface IResumableSessionSummary {
-  id: string;
-  name?: string;
-  cwd: string;
-  updatedAt: string;
-  messageCount: number;
-  preview: string;
+//#region src/session-binding-contracts.d.ts
+/**
+ * What a binding may do. A `drive` binding submits and answers prompts; an `observe` binding only
+ * watches. The difference matters when a binding leaves: a prompt pending on the session needs a
+ * driver left to answer it.
+ */
+type TSessionBindingRole = 'drive' | 'observe';
+/** One client's hold on a session. */
+interface ISessionBinding<TSession = IInteractiveSession> {
+  /** The session this client is on, stable across its switches: calls reach whichever is current. */
+  readonly session: TSession;
+  /**
+   * This client's directory. `listSessions().currentSessionId` is the session THIS binding is on, and
+   * a switch through it moves this binding alone.
+   */
+  readonly directory: ISessionDirectory;
+  /** The client has gone. A session nobody is bound to may then be shut down once it is idle. */
+  release(): void;
+}
+/** Hands each client connection a binding of its own. */
+interface ISessionBinder<TSession = IInteractiveSession> {
+  bind(role: TSessionBindingRole): ISessionBinding<TSession>;
 }
+/** Every reason a session change can be refused, in one place so a wire decoder can check a code. */
+declare const SESSION_CHANGE_REFUSAL_CODES: readonly ["not_available", "stopping", "in_progress", "prompt_pending", "unknown_session", "unreadable", "start_failed", "limit", "failed"];
+/** Why a session change was refused. */
+type TSessionChangeRefusalCode = (typeof SESSION_CHANGE_REFUSAL_CODES)[number];
+/**
+ * The error a refused session change carries. A client shows `message` and may branch on `code`; it
+ * never has to parse the message to tell a limit from a pending prompt.
+ */
+interface ISessionChangeRefusal extends Error {
+  readonly name: 'SessionChangeRefusal';
+  readonly code: TSessionChangeRefusalCode;
+}
+/**
+ * Is this error a declared refusal, or a real failure? A refusal is an outcome to report to the
+ * client that asked; anything else should surface as the fault it is.
+ */
+declare function isSessionChangeRefusal(value: unknown): value is ISessionChangeRefusal;
 //#endregion
 //#region src/session-store-contracts.d.ts
 /**
@@ -235,5 +265,5 @@ interface ITerminalHandoff {
   runWithTerminal<T>(fn: () => Promise<T>): Promise<T>;
 }
 //#endregion
-export { AGENT_DRIVER_ID, type IActiveBranchPointer, type IAgentDriver, type IAskRequestEvent, type IBranchEvent, type ICommandInfo, type ICompactEvent, type IContextFileRefreshedEvent, type IContextReferenceItem, type IDiffLine, type IExecutionResult, type IGoalEvent, type IGoalProgressEntry, type IGoalState, type IInteractionChannel, type IInteractiveSession, type IInteractiveSessionEvents, type IInteractiveSessionRecord, type IInteractiveSessionStore, type IMemoryEvent, type IMemoryReference, type IPeerTurnContext, type IPermissionRequestEvent, type IPlanApprovalEvent, type IPlanArtifact, type IPlanStep, type IPromptFileReferenceRecord, type IPromptHistoryBlock, type IPromptHistoryEntry, type IPromptHistoryReadOptions, type IPromptHistorySource, type IPromptHistoryWriter, type IPromptResolvedEvent, type IResumableSessionSummary, type ISessionAgentJobs, type ISessionBackgroundGroups, type ISessionBackgroundTasks, type ISessionCapabilityHost, type ISessionCapabilityMap, type ISessionCommands, type ISessionConversationRead, type ISessionDriverAttribution, type ISessionEvents, type ISessionExecutionState, type ISessionExecutionWorkspace, type ISessionGoal, type ISessionIdentity, type ISessionLifecycle, type ISessionListEntry, type ISessionLoopState, type ISessionPromptResolution, type ISessionRecordDecodeIssue, type ISessionRenamedEvent, type ISessionRuntimeTools, type ISessionTurnControl, type ISessionTurnSubmission, type ISessionWorkspaceLocation, type ISkillActivationEvent, type ISubmitOptions, type ITerminalHandoff, type IToolCallObservation, type IToolState, type IToolSummary, type ITurnHandle, type ITurnNotRunError, type IUiIntentEvent, type InteractionEvent, OWNER_DRIVER_ID, SESSION_CAPABILITY_MEMBER_KEYS, type TCompactTrigger, type TContextReferenceLoadType, type TContextReferenceStatus, type TDriverId, type TGoalStatus, type TGoalStopReason, type TInteractiveEventName, type TInteractivePermissionHandler, type TMemoryType, type TPermissionResultValue, type TPlanPhase, type TPlanStepStatus, type TPromptFileReferenceReason, type TSessionCapabilityHost, type TSessionCapabilityReadResult, type TSessionLoadOutcome, type TSessionLoopPhase, type TSkillActivationInvocation, type TSkillActivationMode, type TSkillActivationSource, type TSkillActivationStatus, type TTurnNotRunReason, type TTurnSource, isTurnNotRunError, readAssistantReplies, readErrors, readLastAssistantText, readToolCalls };
+export { AGENT_DRIVER_ID, type IActiveBranchPointer, type IAgentDriver, type IAskRequestEvent, type IBranchEvent, type ICommandInfo, type ICompactEvent, type IContextFileRefreshedEvent, type IContextReferenceItem, type IDiffLine, type IExecutionResult, type IGoalEvent, type IGoalProgressEntry, type IGoalState, type IInteractionChannel, type IInteractiveSession, type IInteractiveSessionEvents, type IInteractiveSessionRecord, type IInteractiveSessionStore, type IMemoryEvent, type IMemoryReference, type IPeerTurnContext, type IPermissionRequestEvent, type IPlanApprovalEvent, type IPlanArtifact, type IPlanStep, type IPromptFileReferenceRecord, type IPromptHistoryBlock, type IPromptHistoryEntry, type IPromptHistoryReadOptions, type IPromptHistorySource, type IPromptHistoryWriter, type IPromptResolvedEvent, type IResumableSessionSummary, type ISessionAgentJobs, type ISessionBackgroundGroups, type ISessionBackgroundTasks, type ISessionBinder, type ISessionBinding, type ISessionCapabilityHost, type ISessionCapabilityMap, type ISessionChangeRefusal, type ISessionCommands, type ISessionConversationRead, type ISessionDirectory, type ISessionDriverAttribution, type ISessionEvents, type ISessionExecutionDetail, type ISessionExecutionState, type ISessionExecutionWorkspace, type ISessionGoal, type ISessionIdentity, type ISessionLifecycle, type ISessionListEntry, type ISessionListing, type ISessionListingEntry, type ISessionLoopState, type ISessionPromptResolution, type ISessionRecordDecodeIssue, type ISessionRenamedEvent, type ISessionRuntimeTools, type ISessionSelfPacedLoopControl, type ISessionStatusRead, type ISessionStatusSnapshot, type ISessionSwitchedEvent, type ISessionTurnControl, type ISessionTurnSubmission, type ISessionWorkspaceLocation, type ISkillActivationEvent, type ISubmitOptions, type ITerminalHandoff, type IToolCallObservation, type IToolState, type IToolSummary, type ITurnHandle, type ITurnNotRunError, type IUiIntentEvent, type InteractionEvent, OWNER_DRIVER_ID, SESSION_CAPABILITY_MEMBER_KEYS, SESSION_CHANGE_REFUSAL_CODES, type TCompactTrigger, type TContextReferenceLoadType, type TContextReferenceStatus, type TDriverId, type TGoalStatus, type TGoalStopReason, type TInteractiveEventName, type TInteractivePermissionHandler, type TMemoryType, type TPermissionResultValue, type TPlanPhase, type TPlanStepStatus, type TPromptFileReferenceReason, type TSessionBindingRole, type TSessionCapabilityHost, type TSessionCapabilityReadResult, type TSessionChangeRefusalCode, type TSessionLoadOutcome, type TSessionLoopPhase, type TSkillActivationInvocation, type TSkillActivationMode, type TSkillActivationSource, type TSkillActivationStatus, type TTurnNotRunReason, type TTurnSource, type TWaitingLoopStopOutcome, isSessionChangeRefusal, isTurnNotRunError, readAssistantReplies, readErrors, readLastAssistantText, readToolCalls };
 //# sourceMappingURL=index.d.cts.map

package/dist/node/index.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.cts","names":[],"sources":["../../src/session-summary-contracts.ts","../../src/session-store-contracts.ts","../../src/prompt-history-contracts.ts","../../src/interaction-contracts.ts"],"mappings":";;;;UACiB;EACf;EACA;EACA;EACA;EACA;EACA;;;;;;;;;;;;;UCae;WACN;WACA;;;;;;;;;;;;;;;;;;KAmBC;WACG;WAA0B,QAAQ;;;;WAElC;;;;WAEA;WAA4B,iBAAiB;;;;WAE7C;WAAgC;;;;;;;;;UAS9B;WACN;WACA,SAAS;;;UAIH;EACf,KAAK,SAAS;EACd,KAAK,aAAa;EAClB,iBAAiB;EACjB,OAAO;;;;;;;;;;;UC3DQ;;WAEN;WACA;;WAEA;;WAEA;;;UAIM;EACf,OAAO,OAAO;;;UAIC;WACN,kBAAkB;;WAElB;;UAGM;;WAEN,QAAQ;;;UAIF;EACf,KAAK,SAAS,4BAA4B,cAAc;;;;;KC1B9C;EACN;EAAsB;;EACtB;EAAyB;;EACzB;EAAwB;;EACxB;EAAmB;EAAY;EAAc;;EAC7C;EAAqB;EAAY;EAAc;;EAC/C;EAAwB;EAAc;;EACtC;EAAe,OAAO;;UAEX;EACf;EACA;EACA,cAAc;;UAGC;;EAEf,SAAS,UAAU,iBAAiB;;EAGpC,MAAM,OAAO;;;;;;EAOb,QAAQ,SAAS,iBAAiB,QAAQ;;EAG1C,qBAAqB,UAAU;;EAG/B,QAAQ;EAER,SAAS;EACT,QAAQ;;;UAIO;EACf;EACA;EACA;;;;;;;;;;;;;;UAee;;EAEf,SAAS;;;;;EAKT,KAAK,eAAe;;EAEpB,gBAAgB,UAAU;;WAEjB,iBAAiB;;EAE1B;;EAEA;;EAEA,aAAa;;EAEb,UAAU;;EAEV,QAAQ;;;iBAQM,qBAAqB,iBAAiB;;iBAUtC,sBAAsB,iBAAiB;;iBAKvC,cAAc,iBAAiB,qBAAqB;;iBAOpD,WAAW,iBAAiB,qBAAqB;;;;;;;;;;UAehD;;WAEN;;;;;;EAOT,gBAAgB,GAAG,UAAU,QAAQ,KAAK,QAAQ"}
+{"version":3,"file":"index.d.cts","names":[],"sources":["../../src/session-binding-contracts.ts","../../src/session-store-contracts.ts","../../src/prompt-history-contracts.ts","../../src/interaction-contracts.ts"],"mappings":";;;;;;;;KAoBY;;UAGK,gBAAgB,WAAW;;WAEjC,SAAS;;;;;WAKT,WAAW;;EAEpB;;;UAIe,eAAe,WAAW;EACzC,KAAK,MAAM,sBAAsB,gBAAgB;;;cAItC;;KAsBD,oCAAoC;;;;;UAM/B,8BAA8B;WACpC;WACA,MAAM;;;;;;iBAOD,uBAAuB,iBAAiB,SAAS;;;;;;;;;;;;UC1DhD;WACN;WACA;;;;;;;;;;;;;;;;;;KAmBC;WACG;WAA0B,QAAQ;;;;WAElC;;;;WAEA;WAA4B,iBAAiB;;;;WAE7C;WAAgC;;;;;;;;;UAS9B;WACN;WACA,SAAS;;;UAIH;EACf,KAAK,SAAS;EACd,KAAK,aAAa;EAClB,iBAAiB;EACjB,OAAO;;;;;;;;;;;UC3DQ;;WAEN;WACA;;WAEA;;WAEA;;;UAIM;EACf,OAAO,OAAO;;;UAIC;WACN,kBAAkB;;WAElB;;UAGM;;WAEN,QAAQ;;;UAIF;EACf,KAAK,SAAS,4BAA4B,cAAc;;;;;KC1B9C;EACN;EAAsB;;EACtB;EAAyB;;EACzB;EAAwB;;EACxB;EAAmB;EAAY;EAAc;;EAC7C;EAAqB;EAAY;EAAc;;EAC/C;EAAwB;EAAc;;EACtC;EAAe,OAAO;;UAEX;EACf;EACA;EACA,cAAc;;UAGC;;EAEf,SAAS,UAAU,iBAAiB;;EAGpC,MAAM,OAAO;;;;;;EAOb,QAAQ,SAAS,iBAAiB,QAAQ;;EAG1C,qBAAqB,UAAU;;EAG/B,QAAQ;EAER,SAAS;EACT,QAAQ;;;UAIO;EACf;EACA;EACA;;;;;;;;;;;;;;UAee;;EAEf,SAAS;;;;;EAKT,KAAK,eAAe;;EAEpB,gBAAgB,UAAU;;WAEjB,iBAAiB;;EAE1B;;EAEA;;EAEA,aAAa;;EAEb,UAAU;;EAEV,QAAQ;;;iBAQM,qBAAqB,iBAAiB;;iBAUtC,sBAAsB,iBAAiB;;iBAKvC,cAAc,iBAAiB,qBAAqB;;iBAOpD,WAAW,iBAAiB,qBAAqB;;;;;;;;;;UAehD;;WAEN;;;;;;EAOT,gBAAgB,GAAG,UAAU,QAAQ,KAAK,QAAQ"}

package/dist/node/index.d.ts

@@ -1,15 +1,45 @@
-import { $ as TDriverId, A as IGoalEvent, B as TGoalStatus, C as TSessionCapabilityHost, Ct as TCompactTrigger, D as IBranchEvent, E as IAskRequestEvent, F as IPlanApprovalEvent, G as TPlanPhase, H as TInteractiveEventName, I as IPlanArtifact, J as IPeerTurnContext, K as TPlanStepStatus, L as IPlanStep, M as IGoalState, N as IInteractiveSessionEvents, O as IContextFileRefreshedEvent, P as IPermissionRequestEvent, Q as OWNER_DRIVER_ID, R as IPromptResolvedEvent, S as SESSION_CAPABILITY_MEMBER_KEYS, St as ICompactEvent, T as IActiveBranchPointer, U as TInteractivePermissionHandler, V as TGoalStopReason, W as TPermissionResultValue, X as ISubmitOptions, Y as ISessionRenamedEvent, Z as IUiIntentEvent, _ as ISessionPromptResolution, _t as TSkillActivationStatus, a as ISessionBackgroundTasks, at as isTurnNotRunError, b as ISessionTurnSubmission, bt as ISessionLoopState, c as ISessionCommands, ct as IMemoryEvent, d as ISessionEvents, dt as TContextReferenceLoadType, et as IExecutionResult, f as ISessionExecutionState, ft as TContextReferenceStatus, g as ISessionLifecycle, gt as TSkillActivationSource, h as ISessionIdentity, ht as TSkillActivationMode, i as ISessionBackgroundGroups, it as TTurnSource, j as IGoalProgressEntry, k as IDiffLine, l as ISessionConversationRead, lt as IMemoryReference, m as ISessionGoal, mt as TSkillActivationInvocation, n as IInteractiveSessionRecord, nt as ITurnNotRunError, o as ISessionCapabilityHost, ot as IToolSummary, p as ISessionExecutionWorkspace, pt as TMemoryType, q as AGENT_DRIVER_ID, r as ISessionAgentJobs, rt as TTurnNotRunReason, s as ISessionCapabilityMap, st as IContextReferenceItem, t as IInteractiveSession, tt as ITurnHandle, u as ISessionDriverAttribution, ut as ISkillActivationEvent, v as ISessionRuntimeTools, vt as IPromptFileReferenceRecord, w as TSessionCapabilityReadResult, x as ISessionWorkspaceLocation, xt as TSessionLoopPhase, y as ISessionTurnControl, yt as TPromptFileReferenceReason, z as IToolState } from "./session-contracts-BVCzd3uY.js";
+import { $ as ISessionRenamedEvent, A as IBranchEvent, At as ISessionListingEntry, B as IPlanStep, C as ISessionTurnSubmission, Ct as TPromptFileReferenceReason, D as TSessionCapabilityReadResult, Dt as IResumableSessionSummary, E as TSessionCapabilityHost, Et as TWaitingLoopStopOutcome, F as IGoalState, G as TGoalStopReason, H as ISessionStatusSnapshot, I as IInteractiveSessionEvents, J as TPermissionResultValue, K as TInteractiveEventName, L as IPermissionRequestEvent, M as IDiffLine, Mt as ICompactEvent, N as IGoalEvent, Nt as TCompactTrigger, O as IActiveBranchPointer, Ot as ISessionDirectory, P as IGoalProgressEntry, Q as IPeerTurnContext, R as IPlanApprovalEvent, S as ISessionTurnControl, St as IPromptFileReferenceRecord, T as SESSION_CAPABILITY_MEMBER_KEYS, Tt as TSessionLoopPhase, U as IToolState, V as IPromptResolvedEvent, W as TGoalStatus, X as TPlanStepStatus, Y as TPlanPhase, Z as AGENT_DRIVER_ID, _ as ISessionLifecycle, _t as TMemoryType, a as ISessionBackgroundTasks, at as ITurnHandle, b as ISessionSelfPacedLoopControl, bt as TSkillActivationSource, c as ISessionCommands, ct as TTurnSource, d as ISessionEvents, dt as IContextReferenceItem, et as ISubmitOptions, f as ISessionExecutionDetail, ft as IMemoryEvent, g as ISessionIdentity, gt as TContextReferenceStatus, h as ISessionGoal, ht as TContextReferenceLoadType, i as ISessionBackgroundGroups, it as IExecutionResult, j as IContextFileRefreshedEvent, jt as ISessionSwitchedEvent, k as IAskRequestEvent, kt as ISessionListing, l as ISessionConversationRead, lt as isTurnNotRunError, m as ISessionExecutionWorkspace, mt as ISkillActivationEvent, n as IInteractiveSessionRecord, nt as OWNER_DRIVER_ID, o as ISessionCapabilityHost, ot as ITurnNotRunError, p as ISessionExecutionState, pt as IMemoryReference, q as TInteractivePermissionHandler, r as ISessionAgentJobs, rt as TDriverId, s as ISessionCapabilityMap, st as TTurnNotRunReason, t as IInteractiveSession, tt as IUiIntentEvent, u as ISessionDriverAttribution, ut as IToolSummary, v as ISessionPromptResolution, vt as TSkillActivationInvocation, w as ISessionWorkspaceLocation, wt as ISessionLoopState, x as ISessionStatusRead, xt as TSkillActivationStatus, y as ISessionRuntimeTools, yt as TSkillActivationMode, z as IPlanArtifact } from "./session-contracts-Cv9Jeiyw.js";
 import { IActionRequest, TActionResponse } from "@robota-sdk/agent-core";
-//#region src/session-summary-contracts.d.ts
-/** Projection used to render a resume picker. */
-interface IResumableSessionSummary {
-  id: string;
-  name?: string;
-  cwd: string;
-  updatedAt: string;
-  messageCount: number;
-  preview: string;
+//#region src/session-binding-contracts.d.ts
+/**
+ * What a binding may do. A `drive` binding submits and answers prompts; an `observe` binding only
+ * watches. The difference matters when a binding leaves: a prompt pending on the session needs a
+ * driver left to answer it.
+ */
+type TSessionBindingRole = 'drive' | 'observe';
+/** One client's hold on a session. */
+interface ISessionBinding<TSession = IInteractiveSession> {
+  /** The session this client is on, stable across its switches: calls reach whichever is current. */
+  readonly session: TSession;
+  /**
+   * This client's directory. `listSessions().currentSessionId` is the session THIS binding is on, and
+   * a switch through it moves this binding alone.
+   */
+  readonly directory: ISessionDirectory;
+  /** The client has gone. A session nobody is bound to may then be shut down once it is idle. */
+  release(): void;
+}
+/** Hands each client connection a binding of its own. */
+interface ISessionBinder<TSession = IInteractiveSession> {
+  bind(role: TSessionBindingRole): ISessionBinding<TSession>;
 }
+/** Every reason a session change can be refused, in one place so a wire decoder can check a code. */
+declare const SESSION_CHANGE_REFUSAL_CODES: readonly ["not_available", "stopping", "in_progress", "prompt_pending", "unknown_session", "unreadable", "start_failed", "limit", "failed"];
+/** Why a session change was refused. */
+type TSessionChangeRefusalCode = (typeof SESSION_CHANGE_REFUSAL_CODES)[number];
+/**
+ * The error a refused session change carries. A client shows `message` and may branch on `code`; it
+ * never has to parse the message to tell a limit from a pending prompt.
+ */
+interface ISessionChangeRefusal extends Error {
+  readonly name: 'SessionChangeRefusal';
+  readonly code: TSessionChangeRefusalCode;
+}
+/**
+ * Is this error a declared refusal, or a real failure? A refusal is an outcome to report to the
+ * client that asked; anything else should surface as the fault it is.
+ */
+declare function isSessionChangeRefusal(value: unknown): value is ISessionChangeRefusal;
 //#endregion
 //#region src/session-store-contracts.d.ts
 /**
@@ -235,5 +265,5 @@ interface ITerminalHandoff {
   runWithTerminal<T>(fn: () => Promise<T>): Promise<T>;
 }
 //#endregion
-export { AGENT_DRIVER_ID, type IActiveBranchPointer, type IAgentDriver, type IAskRequestEvent, type IBranchEvent, type ICommandInfo, type ICompactEvent, type IContextFileRefreshedEvent, type IContextReferenceItem, type IDiffLine, type IExecutionResult, type IGoalEvent, type IGoalProgressEntry, type IGoalState, type IInteractionChannel, type IInteractiveSession, type IInteractiveSessionEvents, type IInteractiveSessionRecord, type IInteractiveSessionStore, type IMemoryEvent, type IMemoryReference, type IPeerTurnContext, type IPermissionRequestEvent, type IPlanApprovalEvent, type IPlanArtifact, type IPlanStep, type IPromptFileReferenceRecord, type IPromptHistoryBlock, type IPromptHistoryEntry, type IPromptHistoryReadOptions, type IPromptHistorySource, type IPromptHistoryWriter, type IPromptResolvedEvent, type IResumableSessionSummary, type ISessionAgentJobs, type ISessionBackgroundGroups, type ISessionBackgroundTasks, type ISessionCapabilityHost, type ISessionCapabilityMap, type ISessionCommands, type ISessionConversationRead, type ISessionDriverAttribution, type ISessionEvents, type ISessionExecutionState, type ISessionExecutionWorkspace, type ISessionGoal, type ISessionIdentity, type ISessionLifecycle, type ISessionListEntry, type ISessionLoopState, type ISessionPromptResolution, type ISessionRecordDecodeIssue, type ISessionRenamedEvent, type ISessionRuntimeTools, type ISessionTurnControl, type ISessionTurnSubmission, type ISessionWorkspaceLocation, type ISkillActivationEvent, type ISubmitOptions, type ITerminalHandoff, type IToolCallObservation, type IToolState, type IToolSummary, type ITurnHandle, type ITurnNotRunError, type IUiIntentEvent, type InteractionEvent, OWNER_DRIVER_ID, SESSION_CAPABILITY_MEMBER_KEYS, type TCompactTrigger, type TContextReferenceLoadType, type TContextReferenceStatus, type TDriverId, type TGoalStatus, type TGoalStopReason, type TInteractiveEventName, type TInteractivePermissionHandler, type TMemoryType, type TPermissionResultValue, type TPlanPhase, type TPlanStepStatus, type TPromptFileReferenceReason, type TSessionCapabilityHost, type TSessionCapabilityReadResult, type TSessionLoadOutcome, type TSessionLoopPhase, type TSkillActivationInvocation, type TSkillActivationMode, type TSkillActivationSource, type TSkillActivationStatus, type TTurnNotRunReason, type TTurnSource, isTurnNotRunError, readAssistantReplies, readErrors, readLastAssistantText, readToolCalls };
+export { AGENT_DRIVER_ID, type IActiveBranchPointer, type IAgentDriver, type IAskRequestEvent, type IBranchEvent, type ICommandInfo, type ICompactEvent, type IContextFileRefreshedEvent, type IContextReferenceItem, type IDiffLine, type IExecutionResult, type IGoalEvent, type IGoalProgressEntry, type IGoalState, type IInteractionChannel, type IInteractiveSession, type IInteractiveSessionEvents, type IInteractiveSessionRecord, type IInteractiveSessionStore, type IMemoryEvent, type IMemoryReference, type IPeerTurnContext, type IPermissionRequestEvent, type IPlanApprovalEvent, type IPlanArtifact, type IPlanStep, type IPromptFileReferenceRecord, type IPromptHistoryBlock, type IPromptHistoryEntry, type IPromptHistoryReadOptions, type IPromptHistorySource, type IPromptHistoryWriter, type IPromptResolvedEvent, type IResumableSessionSummary, type ISessionAgentJobs, type ISessionBackgroundGroups, type ISessionBackgroundTasks, type ISessionBinder, type ISessionBinding, type ISessionCapabilityHost, type ISessionCapabilityMap, type ISessionChangeRefusal, type ISessionCommands, type ISessionConversationRead, type ISessionDirectory, type ISessionDriverAttribution, type ISessionEvents, type ISessionExecutionDetail, type ISessionExecutionState, type ISessionExecutionWorkspace, type ISessionGoal, type ISessionIdentity, type ISessionLifecycle, type ISessionListEntry, type ISessionListing, type ISessionListingEntry, type ISessionLoopState, type ISessionPromptResolution, type ISessionRecordDecodeIssue, type ISessionRenamedEvent, type ISessionRuntimeTools, type ISessionSelfPacedLoopControl, type ISessionStatusRead, type ISessionStatusSnapshot, type ISessionSwitchedEvent, type ISessionTurnControl, type ISessionTurnSubmission, type ISessionWorkspaceLocation, type ISkillActivationEvent, type ISubmitOptions, type ITerminalHandoff, type IToolCallObservation, type IToolState, type IToolSummary, type ITurnHandle, type ITurnNotRunError, type IUiIntentEvent, type InteractionEvent, OWNER_DRIVER_ID, SESSION_CAPABILITY_MEMBER_KEYS, SESSION_CHANGE_REFUSAL_CODES, type TCompactTrigger, type TContextReferenceLoadType, type TContextReferenceStatus, type TDriverId, type TGoalStatus, type TGoalStopReason, type TInteractiveEventName, type TInteractivePermissionHandler, type TMemoryType, type TPermissionResultValue, type TPlanPhase, type TPlanStepStatus, type TPromptFileReferenceReason, type TSessionBindingRole, type TSessionCapabilityHost, type TSessionCapabilityReadResult, type TSessionChangeRefusalCode, type TSessionLoadOutcome, type TSessionLoopPhase, type TSkillActivationInvocation, type TSkillActivationMode, type TSkillActivationSource, type TSkillActivationStatus, type TTurnNotRunReason, type TTurnSource, type TWaitingLoopStopOutcome, isSessionChangeRefusal, isTurnNotRunError, readAssistantReplies, readErrors, readLastAssistantText, readToolCalls };
 //# sourceMappingURL=index.d.ts.map

package/dist/node/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","names":[],"sources":["../../src/session-summary-contracts.ts","../../src/session-store-contracts.ts","../../src/prompt-history-contracts.ts","../../src/interaction-contracts.ts"],"mappings":";;;;UACiB;EACf;EACA;EACA;EACA;EACA;EACA;;;;;;;;;;;;;UCae;WACN;WACA;;;;;;;;;;;;;;;;;;KAmBC;WACG;WAA0B,QAAQ;;;;WAElC;;;;WAEA;WAA4B,iBAAiB;;;;WAE7C;WAAgC;;;;;;;;;UAS9B;WACN;WACA,SAAS;;;UAIH;EACf,KAAK,SAAS;EACd,KAAK,aAAa;EAClB,iBAAiB;EACjB,OAAO;;;;;;;;;;;UC3DQ;;WAEN;WACA;;WAEA;;WAEA;;;UAIM;EACf,OAAO,OAAO;;;UAIC;WACN,kBAAkB;;WAElB;;UAGM;;WAEN,QAAQ;;;UAIF;EACf,KAAK,SAAS,4BAA4B,cAAc;;;;;KC1B9C;EACN;EAAsB;;EACtB;EAAyB;;EACzB;EAAwB;;EACxB;EAAmB;EAAY;EAAc;;EAC7C;EAAqB;EAAY;EAAc;;EAC/C;EAAwB;EAAc;;EACtC;EAAe,OAAO;;UAEX;EACf;EACA;EACA,cAAc;;UAGC;;EAEf,SAAS,UAAU,iBAAiB;;EAGpC,MAAM,OAAO;;;;;;EAOb,QAAQ,SAAS,iBAAiB,QAAQ;;EAG1C,qBAAqB,UAAU;;EAG/B,QAAQ;EAER,SAAS;EACT,QAAQ;;;UAIO;EACf;EACA;EACA;;;;;;;;;;;;;;UAee;;EAEf,SAAS;;;;;EAKT,KAAK,eAAe;;EAEpB,gBAAgB,UAAU;;WAEjB,iBAAiB;;EAE1B;;EAEA;;EAEA,aAAa;;EAEb,UAAU;;EAEV,QAAQ;;;iBAQM,qBAAqB,iBAAiB;;iBAUtC,sBAAsB,iBAAiB;;iBAKvC,cAAc,iBAAiB,qBAAqB;;iBAOpD,WAAW,iBAAiB,qBAAqB;;;;;;;;;;UAehD;;WAEN;;;;;;EAOT,gBAAgB,GAAG,UAAU,QAAQ,KAAK,QAAQ"}
+{"version":3,"file":"index.d.ts","names":[],"sources":["../../src/session-binding-contracts.ts","../../src/session-store-contracts.ts","../../src/prompt-history-contracts.ts","../../src/interaction-contracts.ts"],"mappings":";;;;;;;;KAoBY;;UAGK,gBAAgB,WAAW;;WAEjC,SAAS;;;;;WAKT,WAAW;;EAEpB;;;UAIe,eAAe,WAAW;EACzC,KAAK,MAAM,sBAAsB,gBAAgB;;;cAItC;;KAsBD,oCAAoC;;;;;UAM/B,8BAA8B;WACpC;WACA,MAAM;;;;;;iBAOD,uBAAuB,iBAAiB,SAAS;;;;;;;;;;;;UC1DhD;WACN;WACA;;;;;;;;;;;;;;;;;;KAmBC;WACG;WAA0B,QAAQ;;;;WAElC;;;;WAEA;WAA4B,iBAAiB;;;;WAE7C;WAAgC;;;;;;;;;UAS9B;WACN;WACA,SAAS;;;UAIH;EACf,KAAK,SAAS;EACd,KAAK,aAAa;EAClB,iBAAiB;EACjB,OAAO;;;;;;;;;;;UC3DQ;;WAEN;WACA;;WAEA;;WAEA;;;UAIM;EACf,OAAO,OAAO;;;UAIC;WACN,kBAAkB;;WAElB;;UAGM;;WAEN,QAAQ;;;UAIF;EACf,KAAK,SAAS,4BAA4B,cAAc;;;;;KC1B9C;EACN;EAAsB;;EACtB;EAAyB;;EACzB;EAAwB;;EACxB;EAAmB;EAAY;EAAc;;EAC7C;EAAqB;EAAY;EAAc;;EAC/C;EAAwB;EAAc;;EACtC;EAAe,OAAO;;UAEX;EACf;EACA;EACA,cAAc;;UAGC;;EAEf,SAAS,UAAU,iBAAiB;;EAGpC,MAAM,OAAO;;;;;;EAOb,QAAQ,SAAS,iBAAiB,QAAQ;;EAG1C,qBAAqB,UAAU;;EAG/B,QAAQ;EAER,SAAS;EACT,QAAQ;;;UAIO;EACf;EACA;EACA;;;;;;;;;;;;;;UAee;;EAEf,SAAS;;;;;EAKT,KAAK,eAAe;;EAEpB,gBAAgB,UAAU;;WAEjB,iBAAiB;;EAE1B;;EAEA;;EAEA,aAAa;;EAEb,UAAU;;EAEV,QAAQ;;;iBAQM,qBAAqB,iBAAiB;;iBAUtC,sBAAsB,iBAAiB;;iBAKvC,cAAc,iBAAiB,qBAAqB;;iBAOpD,WAAW,iBAAiB,qBAAqB;;;;;;;;;;UAehD;;WAEN;;;;;;EAOT,gBAAgB,GAAG,UAAU,QAAQ,KAAK,QAAQ"}

package/dist/node/index.js

@@ -1,2 +1,2 @@
-import{t as e}from"./session-capability-contracts-LonmBQKB.js";const t=`owner`,n=`agent`;function r(e){return e.filter(e=>e.type===`assistant-done`).map(e=>e.fullText)}function i(e){return r(e).at(-1)}function a(e){return e.filter(e=>e.type===`tool-call`).map(e=>({id:e.id,name:e.name,args:e.args}))}function o(e){return e.filter(e=>e.type===`error`).map(e=>e.error)}function s(e){return e instanceof Error&&e.name===`TurnNotRunError`}export{n as AGENT_DRIVER_ID,t as OWNER_DRIVER_ID,e as SESSION_CAPABILITY_MEMBER_KEYS,s as isTurnNotRunError,r as readAssistantReplies,o as readErrors,i as readLastAssistantText,a as readToolCalls};
+import{t as e}from"./session-capability-contracts-CKIDmkEQ.js";const t=Object.freeze([`not_available`,`stopping`,`in_progress`,`prompt_pending`,`unknown_session`,`unreadable`,`start_failed`,`limit`,`failed`]);function n(e){return e instanceof Error&&e.name===`SessionChangeRefusal`&&t.includes(e.code)}const r=`owner`,i=`agent`;function a(e){return e.filter(e=>e.type===`assistant-done`).map(e=>e.fullText)}function o(e){return a(e).at(-1)}function s(e){return e.filter(e=>e.type===`tool-call`).map(e=>({id:e.id,name:e.name,args:e.args}))}function c(e){return e.filter(e=>e.type===`error`).map(e=>e.error)}function l(e){return e instanceof Error&&e.name===`TurnNotRunError`}export{i as AGENT_DRIVER_ID,r as OWNER_DRIVER_ID,e as SESSION_CAPABILITY_MEMBER_KEYS,t as SESSION_CHANGE_REFUSAL_CODES,n as isSessionChangeRefusal,l as isTurnNotRunError,a as readAssistantReplies,c as readErrors,o as readLastAssistantText,s as readToolCalls};
 //# sourceMappingURL=index.js.map