@robota-sdk/agent-ui-terminal 3.0.0-beta.81 → 3.0.0-beta.83

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (67) hide show
  1. package/CHANGELOG.md +858 -0
  2. package/README.md +5 -1
  3. package/dist/node/index.d.ts +189 -54
  4. package/dist/node/index.d.ts.map +1 -1
  5. package/dist/node/index.js +21 -21
  6. package/dist/node/index.js.map +1 -1
  7. package/package.json +16 -21
  8. package/src/App.tsx +14 -3
  9. package/src/AppPresentation.tsx +1 -1
  10. package/src/PermissionPrompt.tsx +50 -17
  11. package/src/SessionPicker.tsx +27 -7
  12. package/src/SessionStatusBar.tsx +6 -2
  13. package/src/StatusBar.tsx +24 -0
  14. package/src/SupervisedSessionView.tsx +479 -157
  15. package/src/TuiInteractionChannel.ts +8 -53
  16. package/src/__tests__/SupervisedSessionView-render.test.tsx +28 -0
  17. package/src/__tests__/SupervisedSessionView.test.tsx +453 -82
  18. package/src/__tests__/TuiInteractionChannel.display-contract.test.ts +32 -22
  19. package/src/__tests__/TuiInteractionChannel.lifecycle.test.ts +10 -2
  20. package/src/__tests__/attached-app-session-switch.test.tsx +317 -0
  21. package/src/__tests__/checkpoint-store-per-channel.test.ts +81 -0
  22. package/src/__tests__/command-handoff-pty-e2e.test.ts +2 -2
  23. package/src/__tests__/default-tui-cli-adapter-host-settings.test.ts +3 -1
  24. package/src/__tests__/fixtures/command-handoff-driver.tsx +8 -5
  25. package/src/__tests__/grant-history-reaches-the-session.test.ts +31 -0
  26. package/src/__tests__/numbered-selection-chunk.test.tsx +41 -0
  27. package/src/__tests__/palette-consistency.test.ts +0 -1
  28. package/src/__tests__/permission-prompt-arming.test.tsx +153 -0
  29. package/src/__tests__/pty/screen-005-prompt-footers.ptytest.ts +2 -1
  30. package/src/__tests__/pty/screen-006-no-color.ptytest.ts +2 -0
  31. package/src/__tests__/pty/session-attach.ptytest.ts +144 -0
  32. package/src/__tests__/render-channel-options.test.ts +6 -6
  33. package/src/__tests__/sandbox-reaches-the-session.test.ts +37 -0
  34. package/src/__tests__/screen-reader-menus.test.tsx +1 -1
  35. package/src/__tests__/session-picker.test.tsx +93 -0
  36. package/src/__tests__/status-bar.test.tsx +8 -0
  37. package/src/__tests__/tui-channel-init-failure.test.ts +10 -2
  38. package/src/__tests__/wire-tui-channel.test.ts +1445 -0
  39. package/src/__tests__/wire-tui-client-commands.test.ts +243 -0
  40. package/src/app-view-model.ts +6 -2
  41. package/src/attached-session-connection.ts +14 -0
  42. package/src/hooks/__tests__/use-app-detach-key.test.tsx +72 -0
  43. package/src/hooks/__tests__/use-app-loop-escape.test.tsx +13 -0
  44. package/src/hooks/useAppController.ts +6 -2
  45. package/src/hooks/useAppInputBindings.ts +20 -2
  46. package/src/hooks/useAppInteractionState.ts +3 -0
  47. package/src/hooks/useAppOverlays.ts +20 -4
  48. package/src/hooks/useNumberedSelection.ts +19 -2
  49. package/src/hooks/useTuiChannel.ts +13 -1
  50. package/src/index.ts +17 -3
  51. package/src/render.tsx +218 -27
  52. package/src/short-session-id.ts +9 -0
  53. package/src/slash-command-input.ts +11 -0
  54. package/src/tui-app-channel-port.ts +29 -1
  55. package/src/tui-channel-options.ts +11 -2
  56. package/src/tui-session-event-projector.ts +0 -2
  57. package/src/tui-session-events.ts +6 -0
  58. package/src/tui-session-options.ts +9 -0
  59. package/src/tui-state-manager.ts +17 -3
  60. package/src/waiting-loop-stop-notice.ts +23 -0
  61. package/src/wire-history-sync.ts +159 -0
  62. package/src/wire-tui-channel.ts +962 -0
  63. package/src/wire-tui-client-commands.ts +142 -0
  64. package/src/wire-tui-projection.ts +136 -0
  65. package/dist/node/index.cjs +0 -32
  66. package/dist/node/index.d.cts +0 -1066
  67. package/dist/node/index.d.cts.map +0 -1
package/CHANGELOG.md ADDED
@@ -0,0 +1,858 @@
1
+ # @robota-sdk/agent-ui-terminal
2
+
3
+ ## 3.0.0-beta.83
4
+
5
+ ### Major Changes
6
+
7
+ - ba822c1: An attached client reads a workspace entry's detail, stops a waiting self-paced loop, completes
8
+ subcommands, and sees status changes another client made.
9
+
10
+ - `agent-interface-session` (major): `IInteractiveSession` gains the required roles
11
+ `ISessionExecutionDetail` and `ISessionSelfPacedLoopControl` (`TWaitingLoopStopOutcome`), and the
12
+ exhaustively mapped event map gains `status_changed`.
13
+ - `agent-transport` (major): `IProtocolSession` gains both roles; the wire unions gain
14
+ `read-execution-detail`, `stop-waiting-loop`, `execution_detail`, `execution_detail_error` and
15
+ `waiting_loop_stop`; `status_changed` is pushed as `session_status`; `isObserverMessageType` is
16
+ exported from the root and `./client`.
17
+ - `agent-interface-command` (minor): `ICommandListEntry` gains optional `argumentHint` and
18
+ `subcommands` (`ICommandSubcommandEntry`).
19
+ - `agent-cli` (minor):
20
+ - `robota session attach` and an attach from `robota session view` open the full terminal UI,
21
+ the one `robota --attach` opens, in drive mode or, with `--observe`, read-only. The reduced
22
+ attached view is gone.
23
+ - A served runtime names each of its sessions after the session's first real turn.
24
+ - `agent-framework` (minor):
25
+ - `InteractiveSession` gains `stopWaitingSelfPacedLoop(reason?)`: it stops the one waiting loop,
26
+ or stops none and names `/loop stop` when several wait. `SessionSlot` forwards it and
27
+ `readExecutionWorkspaceDetail`.
28
+ - The session emits `status_changed` when its mode, model, effort, goal or name changes, after a
29
+ command, a turn, a rename or a goal or plan transition.
30
+ - A new option `autoName: true` makes the session name itself once, after its first turn, with its
31
+ current provider; it keeps a name it already has and lets a rename made meanwhile win. Off by
32
+ default.
33
+ - The command catalog carries each command's `argumentHint` and `subcommands`.
34
+ - `agent-ui-terminal` (major):
35
+ - The full terminal UI attached to a host's session reads a workspace entry's detail, sends input
36
+ to a background task, stops a waiting self-paced loop on Esc, and completes subcommands.
37
+ - `renderAttachedApp` takes `mode: 'drive' | 'observe'` (default `'drive'`) and `announce`. In
38
+ observe mode the terminal sends only what an observer may send, refuses prompts, host commands,
39
+ abort and loop stop with a read-only notice, still runs `/exit` and its own commands, and its
40
+ status bar says it is observing. `ITuiChannelSnapshot` gains `readOnly`.
41
+ - The in-process terminal no longer names sessions; it builds its session with `autoName: true`.
42
+ `ITuiInteractionChannelOptions.onAutoNamed` is removed.
43
+
44
+ ### Minor Changes
45
+
46
+ - 617b795: `robota session attach <id> [--observe]` puts this terminal on a live supervised session.
47
+
48
+ - It asks first, on the controlling terminal, naming the session and the role: drive (send prompts,
49
+ answer its questions) or observe (read only). The yes holds only for the process start it named: if
50
+ the session restarted meanwhile, the attach is refused.
51
+ - It needs an interactive terminal. Without one (a script, or an agent running shell commands) it is
52
+ refused and prints the command for the user to run. It is not available as a slash command or a
53
+ model tool.
54
+ - The terminal view shows the conversation so far, then follows the session live: streaming replies,
55
+ tools, other terminals' prompts, queued input and questions. In drive mode it sends prompts and
56
+ `/commands` and answers permission prompts and questions; a question answered on another surface is
57
+ dismissed. Observe mode is labelled read-only and sends nothing but reads.
58
+ - `/exit`, `/quit`, Ctrl-C and Ctrl-] detach. Nothing is sent to the session, so its turn continues and
59
+ it keeps running; stop it with `robota session stop` or from `robota session view`.
60
+ - The attached terminal is the full terminal UI (`renderAttachedApp` in `agent-ui-terminal`).
61
+ - A handshake from a connection that already closed no longer holds one of the session's attach slots.
62
+
63
+ - 724fabb: External-event grants are given at start, carried exactly to a background session, listed without their
64
+ principal, and revoked by the owner.
65
+
66
+ - `agent-framework` (breaking) — `openExternalEventSource` and `ExternalEventIngress.open` take only
67
+ `{ grant, audit? }`: the session builds each grant's verifier from `grant.verifier` with the
68
+ `externalEventVerifierFactory` its host passed when the session was built (without one, no grant opens), and an
69
+ open that supplies a verifier or a factory is refused. `IExternalEventSource.revoke()` stops the grant's queued and running turns,
70
+ refuses its later events as `grant-revoked`, and keeps the label from being opened again. A submission the
71
+ session refuses is `shutting-down` only while it shuts down, and `session-unavailable` otherwise. New command
72
+ host adapter `externalEvents` (`ICommandExternalEventsAdapter`).
73
+ - `agent-ui-terminal` — forwards `externalEventVerifierFactory` from the render options to the session.
74
+ - `agent-interface-transport` — `TExternalEventRefusal` gains `session-unavailable`.
75
+ - `agent-command` — `/events` lists the session's grants (label, principal kind, state, counts) and
76
+ `/events revoke <grant-id>` withdraws one. User-only.
77
+ - `agent-cli` — a grant file (`grantId`, `issuer`, `resource` ending in `/events/<grantId>`, exactly one of
78
+ `subject` or `client`, `scopes`, optional `algorithms` and `rate`) is validated before anything starts, with a
79
+ reason that names the grant and no configured value. `robota --external-event-grant <file>` (TUI) and
80
+ `robota session start --background --external-event-grant <file>` open every grant or fail the start; a
81
+ background session receives its grants through a private file, opens them before it reports ready, and the
82
+ launcher refuses a readiness that names other grants. `robota session events list <id> [--json]` and
83
+ `robota session events revoke <id> <grant-id>` work over the generation-bound control socket, and
84
+ `robota session list --format json` shows each grant's counts. The retired `--external-event-allow` now points
85
+ at `--external-event-grant`.
86
+
87
+ - 1706d29: `robota session view` attaches to and peeks at sessions.
88
+
89
+ - `a` attaches to the selected session to drive it, and `p` peeks at it read-only. Both are offered, in
90
+ the footer and in help, only on a row that is alive, controllable and verified. The view asks first,
91
+ naming the role. The yes is held to the process start the row showed: if the session restarted or
92
+ lost control meanwhile, the attach is refused. Detaching returns to the view, on the same row and
93
+ grouping, without printing the screen-reader line again.
94
+ - **Breaking:** opening a row's linked PR moves from `p` to `o`.
95
+ - The attached view shows the keys for what is on screen: sending, answering a permission, or
96
+ answering a question. With a screen reader it words every line ("Prompt from attach:2: …",
97
+ "Tool started: …", "Permission needed: …") and uses no symbols.
98
+ - Questions wait their turn: a second permission request or question no longer replaces the one on
99
+ screen, and one settled elsewhere leaves the queue.
100
+ - Line breaks inside pasted text become spaces instead of sending the text. In a masked answer they are
101
+ dropped, so a copied key that ends with a line break is kept exactly.
102
+ - `robota session attach` accepts `--screen-reader` and `--no-screen-reader`.
103
+ - The attach client closes a connection that sends more frames than it can hold before the view reads
104
+ them.
105
+
106
+ - 57f57f5: A daemon keeps several sessions live, and each client is bound to its own: one client's switch moves
107
+ only that client.
108
+
109
+ - `agent-interface-session`: `ISessionBinder`/`ISessionBinding`, the session-change refusal codes with
110
+ `isSessionChangeRefusal`, and listing rows that may say `live` and `clients`.
111
+ - `agent-framework`: `SessionPool` and `SessionChangeRefusal`.
112
+ - `agent-transport` (**major**): a new server frame, `session_change_failed`, which an exhaustive
113
+ consumer must handle. A refused `new-session` or `switch-session` now answers with it, carrying a
114
+ `code`, instead of `protocol_error`; both requests take an optional `requestId` that it echoes.
115
+ - `agent-transport-ws`: the `sessionBinder` option binds each connection to its own session and
116
+ releases the binding when the connection closes.
117
+ - `agent-cli`: `robota --serve` and the daemon keep up to four sessions live. Each WebSocket client and
118
+ attached terminal is bound to its own session; leaving a busy session is no longer refused, and only
119
+ the last driver of a session with a pending prompt is kept from leaving it. Grants and the supervised
120
+ name stay on the runtime's first session, and its reported activity covers every live session.
121
+ - `agent-ui-web`: a refused new or switch shows the host's reason as a notice (an older host's
122
+ `protocol_error` still does); the session sidebar marks live sessions and counts the other clients
123
+ on each; after a reconnect to a host that keeps sessions live, the GUI returns to the session it was on.
124
+ - `agent-ui-terminal`: an attached terminal shows why a switch was refused, and the picker's switch
125
+ stays pending until the host answers; the session picker marks live sessions and their clients.
126
+
127
+ - 6e6b06b: `robota --attach` puts the full terminal UI on this workspace's running daemon.
128
+
129
+ - **`agent-ui-terminal`:**
130
+ - `renderAttachedApp` renders the same App over a wire connection, through `WireTuiChannel`, a second implementation of the TUI's channel port.
131
+ - Leaving detaches; the daemon keeps running.
132
+ - The session picker lists and switches the daemon's sessions. It opens on the daemon's answer to `/resume`; a daemon that cannot list its sessions says why instead.
133
+ - With no saved sessions to resume, `/resume` says so and keeps the prompt, instead of opening an empty picker that blocks input. This applies to the in-process TUI too.
134
+ - The session picker lists an unnamed session by the part of its id that differs, not by the `session_` prefix every id shares. This applies to the in-process TUI too.
135
+ - The status bar names the daemon's current session: its name, or else its short id.
136
+ - A question already open when the terminal attaches is shown, and a long session's history reaches the terminal without the daemon cutting it off.
137
+ - Features that belong to the runtime process say they are unavailable while attached: the plugin manager, background task details and sending to an agent job.
138
+ - **`agent-cli`:**
139
+ - `robota --attach` finds the workspace daemon and asks the user to confirm on the terminal, as `robota session attach` does, then attaches.
140
+ - Options that shape a session are refused, because the daemon shapes its session.
141
+ - A terminal attached over the supervised socket can now list, start and switch sessions.
142
+ - A client's command no longer stops or restarts the workspace daemon. `/language`, `/reset`, `/exit` and provider setup or switch keep their saved change, and the client is told to run `robota daemon stop`, then `robota daemon start`.
143
+ - `robota --attach` installs the plain TUI's process guards, so an error the plain TUI survives no longer ends the attached terminal.
144
+ - A client's command no longer stops or restarts any supervised session either; the client is told to run `robota session stop <id>`, and the saved change applies to a new session from `robota session start --background`.
145
+
146
+ - caaab20: `/rewind` works again. Every session the CLI builds for a trusted workspace captures edit
147
+ checkpoints; before, none did, and `/rewind` failed everywhere with "Edit checkpoints require
148
+ project authority."
149
+
150
+ - `agent-cli` (patch): a trusted workspace composes an edit checkpoint store for the terminal UI, a
151
+ print run, a served runtime and each session a daemon keeps live. Every session gets its own
152
+ store, pooled or switched to in the terminal UI, since two can run turns at the same time. On a host that cannot prove a project write
153
+ stays inside the project (every platform but Linux), none is composed: a checkpoint could be
154
+ neither saved nor restored there.
155
+ - `agent-command` (patch): where a session has no checkpoints, `/rewind` says why: a restricted
156
+ workspace is told to run `robota trust --yes` and restart robota, and a host that cannot write
157
+ the project safely says so. `/rewind list` reports this as a failed command instead of throwing.
158
+ - `agent-framework` (minor): a checkpoint operation on a session without a store throws
159
+ `EditCheckpointsUnavailableError`, whose `reason` is `host-cannot-write-project`,
160
+ `restricted-workspace` or `no-checkpoint-store`. It is a `WorkspaceAuthorityRequiredError`, as
161
+ before, named `EditCheckpointsUnavailableError`. `HeadlessInteractionChannel` takes an
162
+ `editCheckpointStore` option.
163
+ - `agent-ui-terminal` (minor): `renderApp` takes `createEditCheckpointStore` in place of
164
+ `editCheckpointStore`, and builds each session its own store, since a session switch can build the
165
+ next session before the old one's turn ends. `TuiInteractionChannel` keeps `editCheckpointStore`:
166
+ a channel runs one session.
167
+
168
+ - f01868f: `sandbox.autoAllowBashIfSandboxed` takes effect. The CLI confined shell commands in the OS sandbox,
169
+ but no session learned about the sandbox, so a confined command still asked for approval in the
170
+ terminal UI, a served runtime and MCP serve, and a print run with no one to approve it refused it.
171
+
172
+ - `agent-cli` (patch): a served session, and each session a daemon keeps live, receives the sandbox
173
+ the shell tools run under.
174
+ - `agent-framework` (minor): `HeadlessInteractionChannel` takes a `sandboxClient` option and hands it
175
+ to the session.
176
+ - `agent-ui-terminal` (minor): `renderApp` and `TuiInteractionChannel` take a `sandboxClient` option
177
+ and hand it to each session they build.
178
+
179
+ ### Patch Changes
180
+
181
+ - 8625a14: Supervised session control is bound to one process start.
182
+
183
+ - Each supervised session start writes a fresh random generation into its private registration. Its
184
+ control endpoint echoes that generation in every reply and refuses any request that carries a
185
+ different one, or none.
186
+ - `session view` keeps the generation each row was verified with. Stop and linked-PR opening send it,
187
+ so a session that restarted under the same id since the row was shown is refused instead of acted
188
+ on. A stop confirmation also refuses when the row's generation changed while it was open.
189
+ - `session stop`, `rename`, `link-pr` and `unlink-pr` read the generation at request time and the
190
+ session itself checks it, closing the window between the liveness check and the action.
191
+ - A registration without a generation (written by an earlier version) is listed but never
192
+ controllable; restart that session to control it again.
193
+ - The generation is never printed by `session list` in text or JSON.
194
+
195
+ - 6ae3f28: A served runtime can list its workspace's sessions, start a new one and switch to another without the
196
+ process or any client connection restarting. The GUI shows them in a sessions sidebar.
197
+
198
+ - `agent-interface-session` is **`major`** for two reasons:
199
+ - It adds `ISessionListing`, `ISessionDirectory` and `ISessionSwitchedEvent`.
200
+ - `IInteractiveSessionEvents` gains a required `session_switched` event. An exhaustive map over the
201
+ event names stops compiling until it classifies the new event.
202
+ - `agent-transport` is **`major`** for the same kind of reason:
203
+ - It adds the wire messages `list-sessions` → `sessions`/`sessions_error`, `new-session`,
204
+ `switch-session`, and the broadcast `session_switched`.
205
+ - It adds a `sessionDirectory` handler option. A refusal to switch comes back as a
206
+ `protocol_error` carrying the reason.
207
+ - An exhaustive map over message types must add the new variants.
208
+ - `agent-transport-ws` passes a configured `sessionDirectory` to every connection.
209
+ - `agent-framework` is **`major` because `IRuntimeHostHandle.session` is now a `SessionSlot`**, not the
210
+ `InteractiveSession`, and `bindTransports` receives the slot.
211
+ - The slot is an `IInteractiveSession` that forwards to the current session. Members outside that
212
+ interface are read through `host.session.current`, which changes on a switch.
213
+ - Adds `InteractiveSession.whenInitialized()`.
214
+ - Exports `listUnreadableSessions`.
215
+ - `agent-ui-web` is **`major`**:
216
+ - `IWsSessionState` gains session listing state and actions.
217
+ - It adds a `SessionSidebar`.
218
+ - `/resume` opens the sidebar.
219
+ - `agent-cli`: `robota --serve` provides the session directory, and refuses a switch that would lose
220
+ work in progress. External-event grants belong to the run: a switch reopens them on the new session,
221
+ as the TUI already does.
222
+ - External-event grant history (spent tokens, rate windows, revocations) belongs to the run. The new
223
+ option `externalEventGrantHistory` (from `createExternalEventGrantHistory()`) is shared by every
224
+ session that a served runtime or the TUI builds. A session switch therefore replays no spent token
225
+ and resets no rate limit. The TUI previously had this gap when it switched sessions.
226
+
227
+ - 9721162: A key typed just as a prompt appears no longer answers it: in the terminal UI the permission prompt, and in the web UI both the permission and the ask dock.
228
+
229
+ - **`agent-ui-terminal`:** the permission prompt ignores its keys for a short pause after it appears (`PERMISSION_PROMPT_ARM_DELAY_MS`). While it waits it shows "keys answer in a moment" and no selection cursor. In screen-reader mode, a number typed during the pause, or typed for the previous request, is not kept for a later Enter.
230
+ - **`agent-ui-web`:** the docked permission or ask prompt waits a short pause (`PROMPT_ARM_DELAY_MS`) before it takes focus, so keys typed during that pause stay in the composer. While it waits it says so. A mouse click on a button answers at once, and Esc still denies or cancels; Enter or Space on a focused button waits like any other key, and a button focused to answer one prompt hands focus back to the dock when the next appears.
231
+
232
+ - 57280bf: Every published package now declares `"engines": { "node": ">=22.12.0" }`. Before, 27 of the 38
233
+ packages declared no floor (`agent-core`, `agent-tools` and every provider among them),
234
+ `agent-session` and `agent-file-authority` declared `>=20.19.0`, and the other nine declared
235
+ `>=22.0.0`, so a consumer on Node 20 saw at most a warning from a transitive dependency.
236
+
237
+ Why 22.12: `agent-cli` and `agent-ui-terminal` need Node 22 through `ink` 7, and the CommonJS entries
238
+ of `agent-tools` and its dependents, `agent-transport`/`node` and its dependents, and
239
+ `agent-ui-terminal` `require()` ESM-only dependencies (`p-limit`, `jose`, `chalk`), which Node 22
240
+ supports unflagged only from 22.12. `engines` is advisory unless the consumer enables `engine-strict`.
241
+
242
+ No code changes: `tsdown` now reads `node22.12.0` as its build target from the field.
243
+
244
+ - 1efb124: `@robota-sdk/agent-cli` and `@robota-sdk/agent-ui-terminal` are now ESM-only. Their CommonJS entry
245
+ could never load: it pulls in Ink, whose `yoga-layout` dependency starts with a top-level `await`, so
246
+ `require()` failed on every Node version with `ERR_REQUIRE_ASYNC_MODULE`. The packages no longer
247
+ declare a `require` condition or ship `index.cjs`/`index.d.cts`, so `require()` now fails at resolution
248
+ with `ERR_PACKAGE_PATH_NOT_EXPORTED`. Load them with `import` or `import()`, which is unchanged. The
249
+ `robota` executable is unaffected.
250
+ - 18c0d5c: Every published package now exports `./package.json`, so `require('<package>/package.json')` and
251
+ `import('<package>/package.json', { with: { type: 'json' } })` work instead of failing with
252
+ `ERR_PACKAGE_PATH_NOT_EXPORTED`, and each tarball now ships the package's `CHANGELOG.md`.
253
+ - Updated dependencies [3c81769]
254
+ - Updated dependencies [724fabb]
255
+ - Updated dependencies [d877de2]
256
+ - Updated dependencies [d61e159]
257
+ - Updated dependencies [997f2fb]
258
+ - Updated dependencies [bfe8ed5]
259
+ - Updated dependencies [e689c8e]
260
+ - Updated dependencies [4241fc5]
261
+ - Updated dependencies [4f49d14]
262
+ - Updated dependencies [7b72344]
263
+ - Updated dependencies [6ae3f28]
264
+ - Updated dependencies [9721162]
265
+ - Updated dependencies [be0e53c]
266
+ - Updated dependencies [57f57f5]
267
+ - Updated dependencies [ba822c1]
268
+ - Updated dependencies [9721162]
269
+ - Updated dependencies [6e6b06b]
270
+ - Updated dependencies [7d77ce4]
271
+ - Updated dependencies [8bd5fac]
272
+ - Updated dependencies [57280bf]
273
+ - Updated dependencies [5033dd9]
274
+ - Updated dependencies [18c0d5c]
275
+ - Updated dependencies [dbd888d]
276
+ - Updated dependencies [1887e54]
277
+ - Updated dependencies [caaab20]
278
+ - Updated dependencies [f01868f]
279
+ - Updated dependencies [e8779c9]
280
+ - Updated dependencies [5a0ee96]
281
+ - @robota-sdk/agent-interface-analytics@3.0.0-beta.83
282
+ - @robota-sdk/agent-framework@3.0.0-beta.83
283
+ - @robota-sdk/agent-interface-transport@3.0.0-beta.83
284
+ - @robota-sdk/agent-transport@3.0.0-beta.83
285
+ - @robota-sdk/agent-core@3.0.0-beta.83
286
+ - @robota-sdk/agent-interface-session@3.0.0-beta.83
287
+ - @robota-sdk/agent-interface-command@3.0.0-beta.83
288
+ - @robota-sdk/agent-interface-execution@3.0.0-beta.83
289
+ - @robota-sdk/agent-interface-tui@3.0.0-beta.83
290
+
291
+ ## 3.0.0-beta.82
292
+
293
+ ### Patch Changes
294
+
295
+ - Updated dependencies [c7f9203]
296
+ - @robota-sdk/agent-core@3.0.0-beta.82
297
+ - @robota-sdk/agent-framework@3.0.0-beta.82
298
+ - @robota-sdk/agent-interface-command@3.0.0-beta.82
299
+ - @robota-sdk/agent-interface-execution@3.0.0-beta.82
300
+ - @robota-sdk/agent-interface-session@3.0.0-beta.82
301
+ - @robota-sdk/agent-interface-transport@3.0.0-beta.82
302
+ - @robota-sdk/agent-interface-analytics@3.0.0-beta.82
303
+ - @robota-sdk/agent-interface-tui@3.0.0-beta.82
304
+
305
+ ## 3.0.0-beta.81
306
+
307
+ ### Patch Changes
308
+
309
+ - 18b52cc: Built-in commands are offered to the model deliberately, each described for the model, and never
310
+ with a trust, credential or permission-widening action.
311
+
312
+ - `agent-interface-command` — `ICommand` gains `modelDescription?` (what the model is told, beside the
313
+ short `/help` line), and `modelInvocable` on a subcommand entry now narrows what the model may run.
314
+ - `agent-framework` — `ISystemCommand` gains `modelDescription?` and `modelRequiresPermission?`.
315
+ Once any subcommand of a model-invocable command declares `modelInvocable`, the model may run only
316
+ the bare command and the subcommands declared `true`; everything else, including an alias or an
317
+ undeclared subcommand, is refused before the command runs. The model-facing descriptor lists only
318
+ that subset. A model-requested monitor's command is now decided by the shell tool's gate (its
319
+ Bash/Shell rules, the mode and the prompt) and a refusal rejects with the new
320
+ `MonitorCommandRefusedError`. The `scriptedSession` test harness accepts `permissions` patterns.
321
+ - `agent-session` — `Session.checkToolPermission(toolName, toolArgs)` decides an action that has a
322
+ tool's effect by another route: that tool's PreToolUse hooks, then the gate's rules, mode,
323
+ remembered consent and prompt — never the command sandbox's auto-approval, since the action does
324
+ not run inside the sandbox.
325
+ - `agent-framework` also: `ICommandMCPActivationAdapter.userActionSurface?` tells `/mcp` whether the
326
+ user can type a session command, so the model's status names the terminal sign-in otherwise.
327
+ - `agent-command` — `/context` (bare and `list`), `/cost` (the report, not `budget`) and `/mcp`
328
+ (`status` only, without a prompt) are now model-invocable; `/memory approve` and `/memory reject`
329
+ are now user-only; the model's `/monitor` is decided by the shell gate rather than by consent to
330
+ the command's name. Every model-invocable command carries a model-facing description. The model's
331
+ `/mcp status` shows only safe names, states and the command to suggest, and a caller that does not
332
+ identify itself gets that view. `/context list` accounts only for turns still in context. New
333
+ `mcpUserActionNotice`, `mcpUserActionCommand` and `mcpUnavailableServersNotice` build the fixed
334
+ notices.
335
+ - `agent-command-workflows` — `/workflows` carries a model-facing description.
336
+ - `agent-mcp` — `createDiscoveredTool` accepts `authFailureNotice`: a call the server refuses for
337
+ authentication returns that host text instead of the generic failure.
338
+ - `agent-cli` — an MCP server that did not start because the user must approve it, trust the
339
+ workspace or sign in is named to the model at the start of an interactive session with the
340
+ command to suggest, and a
341
+ signed-in OAuth server that refuses a call tells the model to suggest `/mcp login <server>` — or, in print and serve runs, the terminal
342
+ `robota mcp login <server>`.
343
+
344
+ A command whose bare form is a complete action declares `runsBare`, so choosing `/cost` or `/mcp`
345
+ from the autocomplete menu still runs it even though they now declare subcommands.
346
+
347
+ - Updated dependencies [3038eb7]
348
+ - Updated dependencies [02b7452]
349
+ - Updated dependencies [ec5e477]
350
+ - Updated dependencies [007fd90]
351
+ - Updated dependencies [18b52cc]
352
+ - Updated dependencies [9843fe6]
353
+ - @robota-sdk/agent-core@3.0.0-beta.81
354
+ - @robota-sdk/agent-interface-session@3.0.0-beta.81
355
+ - @robota-sdk/agent-framework@3.0.0-beta.81
356
+ - @robota-sdk/agent-interface-command@3.0.0-beta.81
357
+ - @robota-sdk/agent-interface-execution@3.0.0-beta.81
358
+ - @robota-sdk/agent-interface-transport@3.0.0-beta.81
359
+ - @robota-sdk/agent-interface-analytics@3.0.0-beta.81
360
+ - @robota-sdk/agent-interface-tui@3.0.0-beta.81
361
+
362
+ ## 3.0.0-beta.80
363
+
364
+ ### Major Changes
365
+
366
+ - e82215f: **ARCH-011: replace the ambiguous transport lifecycle stub with executable conformance.**
367
+
368
+ `ITransportAdapter` now requires a frozen `service | runner` lifecycle descriptor. `start()` resolves
369
+ at the concrete transport's documented readiness boundary; start before attach and repeated active
370
+ start reject a stable lifecycle error, repeated stop is safe, and stopped adapters can reattach and
371
+ restart.
372
+
373
+ Runner adapters launch separately and expose a typed terminal outcome through
374
+ `waitForCompletion()`. The registry accepts base adapters, rejects duplicate names, keeps
375
+ configuration as an optional capability, returns complete ordered records whose pending slots become
376
+ registry-owned `abandoned` outcomes on stop/rollback, and exposes a real-runner-only first-failure
377
+ wait. It serializes startup/stop, rejects active restart before mutation, and reverses partial startup
378
+ from the currently failing adapter with typed safe rollback details. Runtime host and serve mode
379
+ propagate real nonzero runner results without treating normal shutdown abandonment as failure.
380
+
381
+ HTTP, MCP, both WebSocket adapters, WebRTC, and headless invoke one shared public conformance kit.
382
+ The former `TuiTransport` export is removed because it ignored the attached session; use `renderApp`
383
+ or `TuiInteractionChannel`, which honestly own their session lifecycle.
384
+
385
+ - 2ebff01: Stop presenting `TuiInteractionChannel` as an `IInteractionChannel`: the TUI owns its session and
386
+ subscribes to the full session-event surface, so its unused no-op `write()` method is removed.
387
+ - 64ba748: **BREAKING — ARCH-042: project filesystem access is now an explicit, host-issued authority instead of an ambient consequence of `cwd`.**
388
+
389
+ `@robota-sdk/agent-framework` adds `WorkspaceTrustService` and the opaque
390
+ `IWorkspaceProjectAuthority`, plus bounded reader, settings-writer, state-storage, and mutation
391
+ facets. Public session, settings, context, checkpoint, memory, contribution, query, and replay
392
+ contracts consume those facets. A caller that does not supply `projectAccess` is deliberately
393
+ restricted to user-owned host state and receives no project filesystem capability.
394
+
395
+ The framework removes or renames ambient Node/project exports. Migrate `checkSettingsFile` to
396
+ `checkNodeHostSettingsFile`, `readMergedProviderSettingsFromPaths` to
397
+ `readMergedProviderSettingsFromSources`, `resolveProviderSettingsWriteTargetPath` to
398
+ `resolveProviderSettingsWriteTarget`, `FileSystemMemoryStore` / `createFileSystemMemoryStore` to
399
+ `WorkspaceMemoryStore` / `createWorkspaceMemoryStore`, and `PluginSettingsStore` to
400
+ `NodeHostPluginSettingsStore`. Host-only git helpers now carry the `FromNodeHost` suffix.
401
+ `projectPaths`, `resolveSettingsPathForScope`, and `getProviderSettingsPaths` are removed; project
402
+ consumers must use the authority facets rather than recover absolute paths.
403
+
404
+ `@robota-sdk/agent-session` renames the Node filesystem implementation `SessionStore` to
405
+ `NodeSessionStore` and adds explicit session-log/external-payload source and sink ports. Session
406
+ replay no longer resolves external payload files from an ambient directory.
407
+
408
+ `@robota-sdk/agent-interface-transport` changes `ISkillExecutionPort.loadCommands(cwd, home?)` to
409
+ the authority-bound `loadCommands()` and removes the optional absolute-path leak
410
+ `IInteractiveSessionStore.getFilePath`. `@robota-sdk/agent-command` consequently replaces the
411
+ `cwd` option of `createSkillsCommandModule` with required `contributionSources`; default command
412
+ composition accepts explicit contribution sources and discovers no project skills when none are
413
+ provided.
414
+
415
+ `@robota-sdk/agent-cli`, `@robota-sdk/agent-transport`, and
416
+ `@robota-sdk/agent-transport-tui` thread the trusted-or-restricted project decision through every
417
+ session surface. Embedded callers that need project settings, state, context, skills, checkpoints,
418
+ or mutation must mint access through `WorkspaceTrustService` and pass the returned
419
+ `projectAccess` (and a separately approved mutation/settings facet where required). Omitting it is
420
+ still type-compatible but is behaviorally breaking: the surface now fails closed instead of
421
+ reading or writing the current directory.
422
+
423
+ - f3fe3db: The terminal renderer no longer reads `ROBOTA_SCREEN_READER_STARTUP_QUIET_MS` or
424
+ `ROBOTA_SCREEN_READER_PREPARK_MS` from the process environment. SDK hosts calling `renderApp`
425
+ directly should pass raw timing choices and diagnostic labels through the new optional
426
+ `screenReaderPacing` render option. Without it, the renderer uses its existing 900 ms startup
427
+ quiet period and 50 ms pre-write park when screen-reader mode is enabled. The Robota CLI still
428
+ reads the same environment variables and preserves their validation, bounds, and warnings.
429
+ - 724d5b6: The terminal renderer no longer reads `ROBOTA_IME_CURSOR` or `ROBOTA_TURN_MARKS` from the process environment. SDK hosts calling `renderApp` directly should pass cursor and turn-mark choices through the optional `terminalCapabilities` render option. Without a host choice, the renderer keeps its terminal and TTY defaults. The Robota CLI still reads both environment variables and preserves its exact `1` and `0` overrides.
430
+
431
+ ### Minor Changes
432
+
433
+ - 9c19c50: `/fork [name] [--same-dir]` copies the live conversation into a background session.
434
+
435
+ The session writes a copy of its own record under a fresh id — messages, system prompt, tool schemas
436
+ and full history, and deliberately not the sandbox snapshot, goal, plan or branch — then spawns a
437
+ background job carrying only `resumeSessionId`. The child restores that record itself, so no
438
+ conversation crosses the child-process boundary and the worker start payload's key set is unchanged.
439
+ The background panel gains an `attach` control that switches the terminal onto the forked session; it
440
+ is a view switch, never a merge, and a missing record or a terminal task is refused with the task's
441
+ own status.
442
+
443
+ **`@robota-sdk/agent-framework` is `major` for one reason: `ICommandHostSessionAccess` gains a
444
+ required member.** `forkSession({ name? })` is not optional, so an external implementation of that
445
+ role port stops compiling until it adds the method. Every other change in this set is additive:
446
+
447
+ - `agent-interface-execution` — `TExecutionControl` gains `'attach'`.
448
+ - `agent-interface-command` — `TCommandUiIntent` gains `{ type: 'switch-session'; sessionId }`.
449
+ - `agent-subagent-runner` — `ISubagentWorkerComposition` gains the optional `openSessionStore`, and
450
+ the worker resumes a record when the job names one. A composition that registers no store and
451
+ receives no `resumeSessionId` behaves exactly as before.
452
+ - `agent-framework` also gains the fork-record builder, `SessionTurnMemory`, and
453
+ `IAgentBackgroundTaskRequest.resumeSessionId?`; `loadSessionRecord` now returns
454
+ `restoredSystemPrompt`, which makes a record field that was written and never read take effect on
455
+ restore.
456
+ - `agent-executor`, `agent-command`, `agent-transport-tui`, `agent-cli` — the spawn input, the
457
+ `/fork` module and the attach control that carry it to the surface.
458
+
459
+ - af2f2ad: `/cd <directory>` continues the conversation in another directory.
460
+
461
+ - **A move is a new session in the target directory.** In the TUI, robota saves a copy of the
462
+ conversation where the target's session store will find it, ends the current run through its
463
+ normal end-of-life flow, and starts again in the target directory resuming that copy. The target's
464
+ settings, trust decision, tools, skills and `AGENTS.md` apply, exactly as if robota had been
465
+ launched there. The process boundary makes the move atomic, so no tool call can straddle it.
466
+ - **The system prompt is kept as recorded**, so a provider's prompt cache survives. One appended
467
+ `<workspace-move>` message tells the model the new directory, and which project instructions now
468
+ apply.
469
+ - **Refused** while a turn is running or a background task is still running, for a missing directory
470
+ or the current one, and for a target a `Cd(...)` deny rule names.
471
+ - **Access never widens:** a restricted session stays restricted after a move, and a trusted session
472
+ takes the target's own trust decision.
473
+ - New contracts: the `workspace-move` host action, `ICommandWorkspaceAdapter` /
474
+ `IWorkspaceMoveRequest`, `InteractiveSession.moveWorkspace`, and the `workspaceMovedFrom` session
475
+ option. The CLI's `--moved-from` and `--restricted-workspace` flags are internal.
476
+
477
+ - 4c5148e: ARCH-005 Stage S2 — `robota` is now expressed as an `IProductProfile` and assembled by `assembleProduct`;
478
+ the hand-wired composition root in `agent-cli` is gone.
479
+
480
+ - **`@robota-sdk/agent-product`** — provider construction returns IN-KERNEL. `assembleProduct` builds the
481
+ provider from `providerDefinitions` + the shell's already-resolved `providerSettings` via agent-core's
482
+ pure `createProviderFromConfig`; `provider` is now an OPTIONAL injected override. Both are optional, so a
483
+ Mode A profile can carry only `providerDefinitions`. The fold stays pure and IO-free — every
484
+ settings/env/file read still happens in the shell. Adds `IAssembledProduct.buildRuntimeOptions`, the pure
485
+ overlay `buildRuntime` delegates through, and `IAssembledProduct.providerDefinitions`.
486
+ **Breaking for pre-release consumers:** `IProductProfile.providerDefinitions` is now required and
487
+ `IProductProfile.provider` / `IAssembledProduct.provider` are now optional.
488
+ - **`@robota-sdk/agent-framework`** — a scoped, additive session seam: `agentDefinitions` on
489
+ `TInteractiveSessionOptions` / `ICreateSessionOptions`, composed into the built-in agent tier ahead of
490
+ `BUILT_IN_AGENTS`, so capability-pack subagents actually reach the runtime. Precedence: discovered
491
+ project/user definitions > injected > built-in. `AgentDefinitionLoader` now dedupes within that tier
492
+ (first wins). Absent ⇒ unchanged behavior.
493
+ - **`@robota-sdk/agent-transport` / `@robota-sdk/agent-transport-tui`** — forward the optional
494
+ `agentDefinitions` through the headless and TUI channels so every robota surface carries the seam.
495
+ - **`@robota-sdk/agent-cli`** — `robota`'s identity (branding, provider surface, presets,
496
+ `packs: [codingPack]`, base command modules, injected transports/runners/subagent factory) is declared as
497
+ data in a product profile and folded by `assembleProduct`. The coding command modules (`/shell`,
498
+ `/editor`) now come from `pack-coding` rather than the base set, so the pack is load-bearing. What remains
499
+ in the CLI is product-shell only: arg parsing, settings/file IO, terminal notices, first-run/init/
500
+ `--configure`, memory + session-resume UX, and print/serve/TUI mode dispatch.
501
+
502
+ End-user `robota` behavior is unchanged in substance — the assembled command-module set, provider surface,
503
+ tool set, subagent roster, and preset resolution all match the pre-change assembly — with one accepted
504
+ cosmetic delta: `/shell` and `/editor` now appear at the END of `/help` output and of the slash-command
505
+ autocomplete popup rather than mid-list, because they arrive from `pack-coding` and both surfaces render in
506
+ module-insertion order. Same commands, same behavior, different position.
507
+
508
+ - 0116a29: ARCH-006 completion — robota's capability packs now OWN its tool surface, and `pack-coding` is built by a
509
+ context-bound factory.
510
+
511
+ - **`@robota-sdk/pack-coding` (BREAKING)** — the module-level `codingPack` constant is **removed** and
512
+ replaced by `createCodingPack({ cwd, sandboxClient })`, with `cwd` **required**. This is a safety change,
513
+ not a style one: `agent-tools` disarms its working-directory path guard when `cwd` is `undefined`, so a
514
+ pack whose file tools are built with no options contributes an **unsandboxed** `Read`/`Write`/`Edit`.
515
+ That was inert while `agent-framework` always supplied its own context-bound default tier, but ARCH-006
516
+ lets a product hand the whole tool surface to its packs (`defaultTools: []`) — and a context-free pack in
517
+ that position is a real hole. Keeping a zero-option export beside that seam would be a loaded gun, so it
518
+ is gone rather than deprecated. Each call returns fresh instances bound to the supplied context, so two
519
+ products in one process get independently-scoped file tools. Migration: replace `codingPack` with
520
+ `createCodingPack({ cwd: process.cwd() })`.
521
+ - **`@robota-sdk/agent-cli`** — `robota`'s packs are built from the shell's resolved `cwd`
522
+ (`createRobotaPacks({ cwd })`) before command setup, and the runtime seam passes
523
+ `ROBOTA_PACKS_OWN_TOOL_SURFACE` (an empty `defaultTools`) so the framework's `createDefaultTools()` tier
524
+ is REPLACED. Every tool robota runs now arrives from a capability pack: dropping a pack drops its tools,
525
+ exactly as it already dropped its command modules and subagents.
526
+ - **`@robota-sdk/agent-transport` / `@robota-sdk/agent-transport-tui`** — forward the optional
527
+ `additionalTools` and `defaultTools` through the headless and TUI channels, mirroring the existing
528
+ `agentDefinitions` pass-through, so print, serve and TUI carry an identical tool surface.
529
+
530
+ End-user `robota` behavior is unchanged, including the security property: the real binary still answers a
531
+ read outside the working directory with `Access denied: "…" is outside the working directory`.
532
+
533
+ - 2ebff01: Emit the complete persisted checkpoint and branch lifecycle, forward plan, context-refresh, and
534
+ branch events through protocol transports, and render deterministic bounded notices in the TUI.
535
+ Transport-owned delivery failures now enter the owning carrier cleanup lifecycle without reversing
536
+ an already-committed session operation.
537
+ - 1e3f91a: CMD-004 Phase 2 Stage E (breaking, beta line): the legacy `TCommandEffect` union and
538
+ `ICommandResult.effects` are DELETED. Commands emit the split contract directly —
539
+ `hostActions` (session-executed via `ICommandHostAdapters`; works headless and remote) and
540
+ `uiIntents` (requester-routed `ui_intent` session events with UI-neutral `show-*` names).
541
+ Final carriers for the former notification effects: `session_renamed` and the new
542
+ `history_cleared` are BROADCAST session events (forwarded to every WS surface, folded by the
543
+ TUI transcript/title and the GUI reducer's new `sessionName`/transcript-reset state);
544
+ `session-execution-started` rides `result.data.sessionExecution`; the plugin-registry refresh
545
+ rides `result.data.pluginRegistryReloaded`. A mechanical grep floor
546
+ (`command-effect-grep-floor.test.ts`) keeps `tui-requested`/`TCommandEffect`/`effects:` out of
547
+ every `packages/*/src` production tree.
548
+ - 90e7a10: The default background observer warning code and exported `OBSERVER_FAILURE_WARNING_CODE` value
549
+ change from `ROBOTA_BACKGROUND_OBSERVER_FAILURE` to `BACKGROUND_OBSERVER_FAILURE`. Hosts matching
550
+ the old warning code should match the new neutral code or provide `observerFailureWarningCode` in
551
+ their background manager or session options. The Robota CLI supplies its existing code explicitly
552
+ across print, goal, serve, MCP, and TUI sessions.
553
+ - 44393be: Add the `/remote-control` enable path (REMOTE-008 Stage B4-2b) — turn on P2P remote control locally, get
554
+ a QR + link, and a paired device co-drives the SAME live session over pairing-gated WebRTC. The command
555
+ is a declarative trigger returning `remote-control-enable-requested`/`-stop-requested` effects (SSOT
556
+ agent-interface-transport) and reads state via a new `ICommandHostAdapters.remoteControl.getStatus()`;
557
+ the TUI dispatches the effects to injected callbacks; all transport construction lives at the agent-cli
558
+ composition root (`WsSignalingClient` + pairing-gated `WebRtcTransport`, relay URL from
559
+ `transports.webrtc.options.relayUrl`, QR/link rendered into history). Fail-closed: no relay configured ⇒
560
+ does nothing; pairing mismatch/timeout ⇒ the session is never exposed. Consumes REMOTE-007 so a paired
561
+ remote owner answers their own permission/ask prompts over the WebRTC channel.
562
+ - fde558e: Forward organization policy through TUI, print, and goal sessions so blocked commands are enforced consistently. Preserve print/goal preset generation, language, prompt-seed, and structured-response options through the headless channel, and guard declared session-capability projections against silent field loss.
563
+
564
+ ### Patch Changes
565
+
566
+ - 9368d00: Advisor escalation: the main model can consult a second model at the decision points it chooses.
567
+
568
+ With an advisor configured (`--advisor <profile>[:<model>]`, or the `advisorModel` setting that
569
+ `/advisor` saves; the flag wins), the session gets an `Advisor({ question? })` tool. The advisor reads
570
+ the whole conversation — system prompt, messages, tool calls and results — serialized into one prompt
571
+ and sent with `toolChoice: 'none'`, truncated from the front to fit its window with the system prompt
572
+ kept, and declines when even that does not fit. Its answer comes back framed as guidance to verify;
573
+ an empty or refusing answer reads as declined. Calls are limited to two per turn and a fixed number
574
+ per session, parallel calls in one round share those limits, and a repeated question in the same
575
+ turn returns the earlier answer. A request that was sent counts even when the provider failed (the
576
+ decline is reported by class, never by its text); only a call declined before sending gives its slot
577
+ back.
578
+
579
+ Advisor usage, including in-process subagents', is recorded where each turn's usage is recorded —
580
+ the persisted session history, under the advisor's own provider and model — so `/cost`, usage reports
581
+ and resumed sessions include it. `/cost` now totals that history and prices each part on its own
582
+ model, showing "mixed" when more than one model was priced.
583
+
584
+ `/advisor <model>` and `/advisor off` change only where calls go, never the tool list, so the main
585
+ model's prompt cache is not invalidated mid-session; the tool is added only when a session starts
586
+ with an advisor. Sending history to a destination (provider type and endpoint host) the main model
587
+ does not already use needs a one-time consent per destination, kept in the user settings file; a
588
+ refusal is remembered for the session. The organization's `allowedProviders` applies, and
589
+ `ROBOTA_DISABLE_ADVISOR=1` turns it off completely. In-process subagents inherit the advisor, bound
590
+ to their own conversation; child-process subagents do not get it.
591
+
592
+ **`@robota-sdk/agent-framework` is `major` for one reason: `ICommandHostSessionAccess` gains a
593
+ required member,** `getSessionUsage()`, the session's persisted usage records. An external
594
+ implementation of that role port stops compiling until it adds the method. The rest is additive.
595
+
596
+ - `agent-session` — `formatConversationEntries`, the one text rendering of a conversation, now used
597
+ by compaction too. It keeps tool calls and results, marks a user message a peer session sent
598
+ (`user [from "peer:<id>"]`), and JSON-encodes every message onto one line so no content can forge
599
+ another entry; compaction previously flattened all of this. `Session.getProvider()` returns the
600
+ provider the session currently uses.
601
+ - `agent-framework` — `AdvisorController`, `createAdvisorTool`, the advisor spec helpers, provider
602
+ destinations (`describeProviderDestination`, `rememberProviderDestination`), `getSessionUsage` and
603
+ `ISessionUsageRecord`, the `onUsageRecorded` session option, and the optional `advisor` command
604
+ host adapter. Session assembly binds a host-supplied Advisor tool to the session holding it.
605
+ - `agent-command` — the `/advisor` command module; `/cost` reads the session's persisted usage.
606
+ - `agent-cli` — the `--advisor` flag, `advisorModel` setting, per-destination consent store and kill
607
+ switch.
608
+ - `agent-ui-terminal` — a usage line from another source (the advisor, a background task) names that
609
+ source and leaves out the context window it does not have.
610
+ - `agent-session-analytics` — personal usage counts an advisor call's tokens and cost toward its
611
+ turn without counting it as a turn.
612
+
613
+ - 2711ec6: One broken skill or agent file no longer stops the session.
614
+
615
+ Skill, command and agent definitions are shared with other hosts through `.claude`, and those hosts
616
+ define fields of their own. The frontmatter decoder now validates only the fields robota owns and
617
+ ignores the rest (nested `metadata` entries included); a malformed value of an owned field is still
618
+ refused. A refused file is skipped with a single warning and still claims its name, so a
619
+ lower-priority definition cannot stand in for it. An empty `argument-hint` reads as no hint. When
620
+ initialization does fail, the session reports the cause to readiness probes instead of "not
621
+ initialized", so the terminal shows the reason at once rather than a 15-second timeout.
622
+
623
+ The terminal also stops printing type names for message-less telemetry records, keeps its own notices
624
+ in place across a history sync so the following answer is not skipped, and CLI diagnostics print
625
+ their context instead of `[object Object]`, through the console so Ink renders them above the frame.
626
+
627
+ - 2ebff01: Remove the obsolete session-level permission and ask callback options and the stale
628
+ `permission-resolved` display event. Prompt requests now settle exclusively through the canonical
629
+ request events and session resolution methods, while leaf adapters fail closed when callbacks reject.
630
+ - 3a8876b: ARCH-029: decompose the command host into role ports
631
+
632
+ `ICommandHostContext`, `ICommandSessionRuntime` and `IAgentJobHostContext` are now empty `extends`
633
+ aggregates over 26 named role ports, so a command declares only the capability it uses. A role port
634
+ is a supertype of the aggregate, so narrowing a declared parameter still satisfies
635
+ `ISystemCommand.execute` by contravariance.
636
+
637
+ All 79 members are preserved (46 + 18 + 15) with the declaration kind unchanged, so implementors and
638
+ callers stay source-compatible.
639
+
640
+ **Breaking:** every role-port member is now required except the adapter bag, whose contents are
641
+ genuinely variational. 38 members went from optional to required. A host that previously omitted a
642
+ member must now provide one — including `validateCurrentSessionReplayLog`, which was an override
643
+ with a framework-computed default and no implementor. `createTestCommandHost`,
644
+ `createTestAgentJobHost` and `createTestSessionRuntime` are published from
645
+ `@robota-sdk/agent-framework/testing` as conformant, cast-free doubles for exactly this.
646
+
647
+ Also removed: the `clearConversationHistory` fallback that reached past the host into
648
+ `getSession().clearHistory()`. Those were never the same operation — the host path also broadcasts
649
+ `history_cleared` to every attached surface, so a fallback clear left other surfaces still showing
650
+ the transcript.
651
+
652
+ - 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).
653
+ - 07b627f: A local peer can now be answered, and what its turn may do depends on where it runs.
654
+
655
+ - `agent-core`: the permission evaluator takes a peer turn's authority as one more input
656
+ (`IPermissionEvaluationContext.peerTurn`), decided after the deny list and ceiling and before
657
+ bypass and allow rules. A peer on another host uses no tool. A peer on the same host may use an
658
+ inspect-class tool that declares `workspacePaths`, only when every named location resolves inside
659
+ the workspace and is not a credential (`isSecretPath`); write and execute tools are refused unless
660
+ enabled, and then every use asks. A tool declaring `repliesToPeer` exists only in a peer turn and
661
+ asks once the turn used another tool. New: `isToolAvailableInPeerTurn`, `TPeerReach`,
662
+ `IPeerTurnAuthority`. `IRunOptions.withholdHostedTools` leaves a provider's hosted tools out of a
663
+ run's requests (`nativeWebTools` with `false` withholds a hosted tool for one call).
664
+ - `agent-tools`: `Read` and `Glob` declare the arguments that say where they look. `Grep` does not:
665
+ it reads files it was never named, so a peer turn does not get it.
666
+ - `agent-session`: `ISessionRunOptions.peerReach` makes a run a peer turn for the permission policy;
667
+ every ask in it needs a fresh approval, and its requests carry no provider-hosted tool. `ISessionOptions.allowPeerChanges` enables write and execute
668
+ tools for same-host peer turns.
669
+ - `agent-interface-session`: `ISubmitOptions.peer` (`IPeerTurnContext`) carries a peer turn's reach,
670
+ the message it answers and the session a reply goes to.
671
+ - `agent-interface-session-mobility`: `IPeerMessage.inReplyTo` threads a conversation;
672
+ `peerReachOf(admission)` maps admission to a reach.
673
+ - `agent-framework`: a peer turn is offered what its origin allows, and a new `peer_reply` tool
674
+ answers the peer that sent the message, threaded to it. The setting `peers.allowChanges` enables
675
+ write and execute tools for same-host peer turns.
676
+ - `agent-ui-terminal`: a permission prompt in a peer turn names the requesting peer.
677
+ - `agent-cli`: incoming peer turns carry their reach and reply route; a conversation is limited in
678
+ depth and in how often this session answers it, and a reply over a limit is not sent and the
679
+ operator is told.
680
+ - `agent-provider-anthropic`, `agent-provider-openai-compatible` (Qwen): a request whose
681
+ `nativeWebTools` sets a hosted tool to `false` is sent without it.
682
+
683
+ - 9665c6e: Make the permission and "ask the user" flows transport-neutral (REMOTE-007 / B4-2a). A session now
684
+ emits `permission_request` / `ask_request` / `prompt_resolved` events and exposes
685
+ `resolvePermission` / `resolveAsk`, so any attached surface — local TUI, a WS/WebRTC driver, or a web
686
+ UI — can render and answer the SAME prompt (local == remote). The framework builds event-emitting
687
+ default handlers bound to the session emitter (id-keyed parking, fail-closed on zero listeners / on
688
+ detach / backstop, teardown drain on abort/cancelQueue/shutdown), replacing the injected
689
+ askHandler/permissionHandler at their source. `getUserInteraction()` is gated on the `ask_request`
690
+ listener count so the headless "no-human ⇒ proceed" contract is preserved. The WS protocol carries the
691
+ new events + `permission-response` / `ask-response` verbs, and WebRTC gets them for free via the shared
692
+ handler. No `/remote-control` enable path is added.
693
+ - c7fa299: REMOTE-003 + REMOTE-006 (merged — net behavior; the interim deny-by-default gate never appeared in a
694
+ published version): commands now carry an invocation source. A `'remote'` value is added to the command
695
+ invocation source (SSOT relocated to `@robota-sdk/agent-interface-transport`, re-exported by
696
+ `agent-framework`) and an optional `source` is threaded into
697
+ `IInteractiveSession.executeCommand(name, args, source?)` (defaults to `'user'`, so all local callers are
698
+ unchanged). The shared `createWsHandler` tags transport-origin commands `'remote'`. Policy: local == remote
699
+ (owner principle) — pairing is the sole trust boundary, so a transport-origin command runs exactly as a
700
+ locally-typed one under the universal permission system (permission modes + PermissionEnforcer + the
701
+ ask/approval handler); `createDefaultRemoteCommandPolicy()` allows by default. The `IRemoteCommandPolicy`
702
+ seam remains as an OPTIONAL, user-configured restriction, and the genuinely-remote WebRTC path stays
703
+ pairing-gated.
704
+ - 1c8fbdf: Stabilize the TUI input box bottom border during active output: hand-draw it as a `<Text>` row (mirroring the top border) instead of a Yoga-synthesized Box border, which could drop glyphs under rapid re-render at full terminal height (SCREEN-003).
705
+ - Updated dependencies [9c19c50]
706
+ - Updated dependencies [7b6234c]
707
+ - Updated dependencies [5307f8a]
708
+ - Updated dependencies [b462ee7]
709
+ - Updated dependencies [08a9bd6]
710
+ - Updated dependencies [37b4bd7]
711
+ - Updated dependencies [818f0c8]
712
+ - Updated dependencies [4eea54b]
713
+ - Updated dependencies [1698be4]
714
+ - Updated dependencies [a5961c9]
715
+ - Updated dependencies [9368d00]
716
+ - Updated dependencies [d4189b9]
717
+ - Updated dependencies [9edae52]
718
+ - Updated dependencies [4078a72]
719
+ - Updated dependencies [4c73a0b]
720
+ - Updated dependencies [af2f2ad]
721
+ - Updated dependencies [267af5f]
722
+ - Updated dependencies [196a900]
723
+ - Updated dependencies [f336838]
724
+ - Updated dependencies [34e50f0]
725
+ - Updated dependencies [722e88a]
726
+ - Updated dependencies [a5cc36e]
727
+ - Updated dependencies [d23c848]
728
+ - Updated dependencies [b70fa3d]
729
+ - Updated dependencies [2711ec6]
730
+ - Updated dependencies [4dd45cc]
731
+ - Updated dependencies [4c5148e]
732
+ - Updated dependencies [37af5dc]
733
+ - Updated dependencies [807d161]
734
+ - Updated dependencies [fec722f]
735
+ - Updated dependencies [e82215f]
736
+ - Updated dependencies [52b7346]
737
+ - Updated dependencies [9db63ee]
738
+ - Updated dependencies [b078afa]
739
+ - Updated dependencies [2ebff01]
740
+ - Updated dependencies [9db63ee]
741
+ - Updated dependencies [2ebff01]
742
+ - Updated dependencies [2d3b2c0]
743
+ - Updated dependencies [b078afa]
744
+ - Updated dependencies [2d3b2c0]
745
+ - Updated dependencies [baa6863]
746
+ - Updated dependencies [2d3b2c0]
747
+ - Updated dependencies [3a8876b]
748
+ - Updated dependencies [4772067]
749
+ - Updated dependencies [7b85767]
750
+ - Updated dependencies [0f98419]
751
+ - Updated dependencies [64ba748]
752
+ - Updated dependencies [9fbab1b]
753
+ - Updated dependencies [d312755]
754
+ - Updated dependencies [a009f5b]
755
+ - Updated dependencies [1e3f91a]
756
+ - Updated dependencies [4f3c075]
757
+ - Updated dependencies [475e085]
758
+ - Updated dependencies [e477440]
759
+ - Updated dependencies [9dcb5da]
760
+ - Updated dependencies [a95ca85]
761
+ - Updated dependencies [b6d14ce]
762
+ - Updated dependencies [0382a51]
763
+ - Updated dependencies [93d061d]
764
+ - Updated dependencies [39554a1]
765
+ - Updated dependencies [d28430a]
766
+ - Updated dependencies [bed26ea]
767
+ - Updated dependencies [fe48835]
768
+ - Updated dependencies [1e40b5b]
769
+ - Updated dependencies [7669851]
770
+ - Updated dependencies [4b76cfa]
771
+ - Updated dependencies [d9bd9ec]
772
+ - Updated dependencies [8865acf]
773
+ - Updated dependencies [90e7a10]
774
+ - Updated dependencies [fcb0da3]
775
+ - Updated dependencies [07b627f]
776
+ - Updated dependencies [d0de5b2]
777
+ - Updated dependencies [9665c6e]
778
+ - Updated dependencies [44393be]
779
+ - Updated dependencies [c7fa299]
780
+ - Updated dependencies [5134b3b]
781
+ - Updated dependencies [dd444c1]
782
+ - Updated dependencies [1f57e7f]
783
+ - Updated dependencies [833afe1]
784
+ - Updated dependencies [d6b9404]
785
+ - Updated dependencies [7863b16]
786
+ - Updated dependencies [fde558e]
787
+ - Updated dependencies [db5c439]
788
+ - Updated dependencies [4a01a87]
789
+ - Updated dependencies [cbee54e]
790
+ - Updated dependencies [5c5ff23]
791
+ - Updated dependencies [9814afc]
792
+ - Updated dependencies [242a644]
793
+ - @robota-sdk/agent-interface-execution@3.0.0-beta.80
794
+ - @robota-sdk/agent-interface-command@3.0.0-beta.80
795
+ - @robota-sdk/agent-framework@3.0.0-beta.80
796
+ - @robota-sdk/agent-core@3.0.0-beta.80
797
+ - @robota-sdk/agent-interface-session@3.0.0-beta.80
798
+ - @robota-sdk/agent-interface-transport@3.0.0-beta.80
799
+ - @robota-sdk/agent-interface-analytics@3.0.0-beta.80
800
+ - @robota-sdk/agent-interface-tui@3.0.0-beta.80
801
+
802
+ ## 3.0.0-beta.79
803
+
804
+ ### Patch Changes
805
+
806
+ - @robota-sdk/agent-core@3.0.0-beta.79
807
+ - @robota-sdk/agent-framework@3.0.0-beta.79
808
+ - @robota-sdk/agent-interface-transport@3.0.0-beta.79
809
+ - @robota-sdk/agent-interface-tui@3.0.0-beta.79
810
+
811
+ ## 3.0.0-beta.78
812
+
813
+ ### Patch Changes
814
+
815
+ - Updated dependencies [6f308d1]
816
+ - @robota-sdk/agent-core@3.0.0-beta.78
817
+ - @robota-sdk/agent-framework@3.0.0-beta.78
818
+ - @robota-sdk/agent-interface-transport@3.0.0-beta.78
819
+ - @robota-sdk/agent-interface-tui@3.0.0-beta.78
820
+
821
+ ## 3.0.0-beta.77
822
+
823
+ ### Patch Changes
824
+
825
+ - Updated dependencies
826
+ - @robota-sdk/agent-core@3.0.0-beta.77
827
+ - @robota-sdk/agent-framework@3.0.0-beta.77
828
+ - @robota-sdk/agent-interface-transport@3.0.0-beta.77
829
+ - @robota-sdk/agent-interface-tui@3.0.0-beta.77
830
+
831
+ ## 3.0.0-beta.76
832
+
833
+ ### Minor Changes
834
+
835
+ - 9df3a88: Split the consolidated `@robota-sdk/agent-transport` package into per-concern transport packages (DQ-AUDIT-005) so unrelated heavy dependencies (React/Ink, ws, Hono, MCP SDK) no longer share one publishable unit and are not dragged into non-TUI consumers' graphs:
836
+
837
+ - `@robota-sdk/agent-transport` — lean core: headless adapter + `TransportRegistry` + scripted-provider testing fixtures (no external runtime deps).
838
+ - `@robota-sdk/agent-transport-tui` — React + Ink terminal UI.
839
+ - `@robota-sdk/agent-transport-ws` — WebSocket transport + protocol (`agent-web-ui` now depends only on this for WS types).
840
+ - `@robota-sdk/agent-transport-http` — Hono HTTP transport.
841
+ - `@robota-sdk/agent-transport-mcp` — MCP server transport.
842
+
843
+ The default transport-registry wiring (pre-registering `WsTransport`) moves to the CLI composition root, removing the core→ws edge.
844
+
845
+ ### Patch Changes
846
+
847
+ - DQ-AUDIT-003 — restore agent-interface-tui to type-contracts only by removing its runtime type-guards (`isPickerInteraction`/`isConfirmInteraction`, which had zero call sites); narrow `TAnyTuiCommandInteraction` on its `onMissingArgs` discriminant instead. Documented the type-only downward references in agent-interface-transport.
848
+ - Updated dependencies
849
+ - Updated dependencies
850
+ - Updated dependencies [c0a6287]
851
+ - Updated dependencies [9df3a88]
852
+ - Updated dependencies
853
+ - Updated dependencies
854
+ - Updated dependencies [576af62]
855
+ - @robota-sdk/agent-core@3.0.0-beta.76
856
+ - @robota-sdk/agent-interface-tui@3.0.0-beta.76
857
+ - @robota-sdk/agent-framework@3.0.0-beta.76
858
+ - @robota-sdk/agent-interface-transport@3.0.0-beta.76