@robota-sdk/agent-transport 3.0.0-beta.79 → 3.0.0-beta.82

package/README.md

@@ -1,6 +1,42 @@
 # Agent Transport
 
-Protocol-level transport adapters for the Robota SDK — headless, HTTP, WebSocket, MCP, and TUI (Ink/React terminal UI).
+Browser-safe transport protocol and delivery substrate for the Robota SDK. The root exports shared
+wire messages, session bridging, channel codecs, and delivery helpers. Browser decoders are also
+available from `./client`; Node-only admission and handoff integrity helpers are available from
+`./node`.
+
+## Handoff offer migration
+
+`@robota-sdk/agent-transport/node` no longer exports `buildHandoffManifest`,
+`IBuildManifestInput`, `ISourceRuntimeState`, or `TManifestResult`. Handoff readiness and inventory
+classification belong to `@robota-sdk/agent-interface-session-mobility`. A host composing a handoff
+should check readiness before serializing, then pass the integrity of those exact bytes to the
+mobility offer policy:
+
+```typescript
+import {
+  assessHandoffReadiness,
+  prepareHandoffOffer,
+  type IPrepareHandoffOfferInput,
+} from '@robota-sdk/agent-interface-session-mobility';
+import { sealHandoffRecord } from '@robota-sdk/agent-transport/node';
+
+function buildOffer(request: Omit<IPrepareHandoffOfferInput, 'integrity'>) {
+  const readiness = assessHandoffReadiness(request.runtime);
+  if (!readiness.ready) return readiness;
+
+  const { serialized, integrity } = sealHandoffRecord(request.record);
+  const offer = prepareHandoffOffer({ ...request, integrity });
+  if (!offer.built) return offer;
+
+  // Send serialized unchanged: offer.manifest.integrity describes these exact bytes.
+  return { manifest: offer.manifest, serialized };
+}
+```
+
+For types, use `ISourceRuntimeState`, `IPrepareHandoffOfferInput`, and `THandoffOfferResult` from
+session mobility. `IPrepareHandoffOfferInput` includes the integrity metadata produced by
+`sealHandoffRecord`; the serialized payload remains a separate transport value.
 
 ## Installation
 
@@ -10,20 +46,30 @@ npm install @robota-sdk/agent-transport
 
 ## Available Transports
 
-| Transport | Sub-path     | Description                                             |
-| --------- | ------------ | ------------------------------------------------------- |
-| Headless  | `./headless` | Non-interactive text / JSON / stream-JSON output        |
-| HTTP      | `./http`     | Hono-based REST adapter (Node.js / CF Workers / Lambda) |
-| WebSocket | `./ws`       | Framework-agnostic real-time bidirectional adapter      |
-| MCP       | `./mcp`      | Model Context Protocol server adapter                   |
-| TUI       | `./tui`      | Ink/React terminal UI components and `TuiTransport`     |
+Headless execution belongs to `agent-framework`. HTTP, WebSocket, MCP, and WebRTC ship as standalone
+transport packages.
+
+| Transport | Package / Sub-path                   | Description                                             |
+| --------- | ------------------------------------ | ------------------------------------------------------- |
+| Headless  | `@robota-sdk/agent-framework`        | Non-interactive text / JSON / stream-JSON output        |
+| HTTP      | `@robota-sdk/agent-transport-http`   | Hono-based REST adapter (Node.js / CF Workers / Lambda) |
+| WebSocket | `@robota-sdk/agent-transport-ws`     | Framework-agnostic real-time bidirectional adapter      |
+| MCP       | `@robota-sdk/agent-transport-mcp`    | Model Context Protocol server adapter                   |
+| WebRTC    | `@robota-sdk/agent-transport-webrtc` | Peer-to-peer data-channel adapter                       |
+
+Scripted-provider test fixtures live in `@robota-sdk/agent-core/testing` (the former `./testing`
+pass-through was removed, issue #2052).
+
+All session-owning entry points treat `cwd` as provenance, not project trust. Pass a host-issued
+`TWorkspaceProjectAccess` decision through `projectAccess`; omitting it creates a Restricted session
+that does not load project contributions.
 
 ## Quick Start
 
 ### Headless
 
 ```typescript
-import { createHeadlessTransport } from '@robota-sdk/agent-transport/headless';
+import { createHeadlessTransport } from '@robota-sdk/agent-framework';
 
 const transport = createHeadlessTransport({ outputFormat: 'text', prompt: 'Hello!' });
 ```
@@ -52,47 +98,59 @@ import { createMcpTransport } from '@robota-sdk/agent-transport-mcp';
 const transport = createMcpTransport({ name: 'my-agent', version: '1.0.0' });
 ```
 
-### TUI (Ink/React)
+### TUI presentation (Ink/React)
 
 ```typescript
-import { TuiTransport } from '@robota-sdk/agent-transport-tui';
-import type { IRenderOptions } from '@robota-sdk/agent-transport-tui';
+import { renderApp } from '@robota-sdk/agent-ui-terminal';
+import type { IRenderOptions } from '@robota-sdk/agent-ui-terminal';
 
 declare const options: IRenderOptions;
-const transport = new TuiTransport(options);
+await renderApp(options);
 ```
 
-> React and Ink dependencies are confined to the `./tui` sub-path. Importing from
-> other sub-paths keeps your bundle React-free.
+> React and Ink dependencies are confined to the standalone
+> `@robota-sdk/agent-ui-terminal` package. This core package stays React-free.
 
 ## Sub-path Imports
 
 Import only what you need to keep bundles small:
 
 ```typescript
-import { createHeadlessTransport } from '@robota-sdk/agent-transport/headless';
+import { createHeadlessTransport } from '@robota-sdk/agent-framework';
 import { WsTransport } from '@robota-sdk/agent-transport-ws';
-import type { TServerMessage } from '@robota-sdk/agent-transport-ws';
+import type { TServerMessage } from '@robota-sdk/agent-transport';
 import { createHttpTransport } from '@robota-sdk/agent-transport-http';
 import { createMcpTransport } from '@robota-sdk/agent-transport-mcp';
-import { TuiTransport } from '@robota-sdk/agent-transport-tui';
+import { renderApp } from '@robota-sdk/agent-ui-terminal';
 ```
 
-Root import re-exports all transports:
-
-<!-- doc-example-skip: intentional ellipsis fragment (import surface overview, not runnable) -->
+The framework root owns headless and programmatic surfaces plus `TransportRegistry`. The transport
+root owns transport-neutral wire messages, session bridging, channel codecs, and delivery helpers;
+browser decoders are also available from `@robota-sdk/agent-transport/client`, while Node-only
+admission and handoff integrity helpers live under `@robota-sdk/agent-transport/node`.
 
 ```typescript
-import { createHeadlessTransport, WsTransport, TuiTransport, ... } from '@robota-sdk/agent-transport';
+import { createHeadlessTransport } from '@robota-sdk/agent-framework';
 ```
 
+`TransportRegistry` accepts the discriminated base service/runner adapter union. It rejects active
+restart before mutation, rolls partial startup back in reverse order, reports real runner failure
+immediately, and returns a complete ordered aggregate whose pending runners become registry-owned
+`abandoned` records on stop or rollback.
+
 ## Dependencies
 
-- `@robota-sdk/agent-core`
+- `@robota-sdk/agent-interface-analytics`
+- `@robota-sdk/agent-interface-command`
+- `@robota-sdk/agent-interface-execution`
+- `@robota-sdk/agent-interface-session`
+- `@robota-sdk/agent-interface-session-mobility`
 - `@robota-sdk/agent-interface-transport`
-- `@robota-sdk/agent-framework`
-- `ws`, `hono`, `@modelcontextprotocol/sdk`, `zod`
-- `react`, `ink`, `ink-select-input`, `ink-spinner`, `ink-text-input`, `chalk`, `marked`, `marked-terminal`, `string-width` _(TUI sub-path only)_
+
+The heavier protocol dependencies (`ws`, `hono`, `@modelcontextprotocol/sdk`,
+`react`, `ink`, and friends) now live in the split transport packages
+(`@robota-sdk/agent-transport-{http,ws,mcp}`) and presentation packages
+(`@robota-sdk/agent-ui-{terminal,web}`).
 
 ## Links
 

package/dist/browser/client.d.ts

@@ -0,0 +1,2 @@
+import { a as decodeServerMessage, c as TServerMessage, i as decodeFrame, n as TMessageDecodeResult, o as TClientMessage, r as decodeClientMessage, s as TSeqServerMessage, t as MAX_INBOUND_FRAME_BYTES } from "./message-decoders-BB8n-H2X.js";
+export { MAX_INBOUND_FRAME_BYTES, type TClientMessage, type TMessageDecodeResult, type TSeqServerMessage, type TServerMessage, decodeClientMessage, decodeFrame, decodeServerMessage };

package/dist/browser/client.js

@@ -0,0 +1 @@
+import{i as e,n as t,r as n,t as r}from"./message-decoders-CDmDoZPR.js";export{r as MAX_INBOUND_FRAME_BYTES,t as decodeClientMessage,n as decodeFrame,e as decodeServerMessage};