@ai-ecoverse/slicc-agent 3.30.0 → 3.32.0

package/README.md

@@ -31,6 +31,11 @@ await agent.prompt('What is in /home?');
 - `hostAgent(agent)` serves the agent with pi's protocol: a pi-server with one session, `agent`, whose Chord services are `slicc.agent.control` (send with `whenBusy` `steer`, `followUp` or `reject`, wait, withdraw, abort, compact) and `slicc.agent.transcript` (the conversation's durable view as replicated state, plus `deliveries`: how each user entry was delivered, `run`, `steer` or `follow-up`, derived by the host from where each send it accepted was placed: after a tool result it steered, queued first it's a follow-up or a late steer per its `whenBusy`, placed at once it started a run). `serveConnections(self, host)` hands it every `MessagePort` the page sends.
 - `@ai-ecoverse/slicc-agent/page` has what the page needs (`startAgent`, `connectAgent`) without the agent's runtime: no pi-durable, pi-ai, providers or SQLite, which load only in the worker. `@ai-ecoverse/slicc-agent/spectrum` is just as light, and a test keeps both that way.
 - `startAgent({ worker })` takes the Web Lock `slicc-agent`, so one tab at a time owns the agent worker, and waits while another tab holds it. `connect()` returns an `AgentConnection` (`control`, `transcript`, `prompt()`), `restart()` replaces the worker (durable resumes from SQLite), and `release()` stops it and lets the next tab take over. `port()` returns a raw `MessagePort` into the worker instead, for another tab: hand it over (through a SharedWorker, say), and that tab calls `connectAgent(port)`. A caller that already holds the lock passes `held: true`. A connection's `closed` resolves when its port ends (with the error, if any), and from then on its states keep their last values.
+- **Followers over a link** (PR 18): `port({ readOnly: true })` and `connect({ readOnly: true })` give a view-only connection.
+  - **What a view-only connection can do:** it sees the transcript, the agents, settings state and remote-control `watch`, and may call `wait` and `changesOpen`.
+  - **What it can't:** every other `AgentControl` method, settings action and remote-control `prompt` or `abort` is refused with `EACCES` ("this follower can watch, but not send, steer or abort"). Send and compact answer `accepted: false` with that code. The worker serves view-only ports from a second pi-server whose session gets these narrowed services.
+  - **Carrying the connection over a byte stream:** `linkEndpoint({ write, close })` is a `PortEndpoint` that `connectAgent` accepts. Feed it the stream's bytes with `receive(bytes)` and its end with `end(error?)`. On the owner's side, `bridgePort(port, { write, close })` does the same for the `MessagePort` from `port()`.
+  - **The bytes:** each `PortChannel` message becomes a frame: a `u32` big-endian length, then a tag (0 data, 1 hello with the server id, 2 close), then the payload. A frame is at most 16 MiB, and a malformed one ends the link.
 
 ### Bash and files on slicc-kernel
 
@@ -428,7 +433,7 @@ The built-in `sprinkles` skill teaches the files, the bridge and the command.
 
 ## The kernel
 
-`@ai-ecoverse/slicc-kernel` is a peer dependency (`>=1.26.3 <2`; older kernels have an IPv6-to-loopback security bug): the agent only calls `attachKernel`, the client end of the page kernel's port, so it must match the kernel the page runs. Seven chooses that version: slicc-bios pins the certified kernel next to the agent in `src/packages/agent/package.json`, and pnpm fills the peer from that pin. The devDependency is the lowest certified kernel the range allows (1.26.3), and the unit and integration tests run on it. A second CI job reruns the integration tests on the newest certified kernel (`NEWEST_CERTIFIED_KERNEL` in `.github/workflows/ci.yml`), with the wasm commands certified for it (`NEWEST_CERTIFIED_WASM`; wasm-git 2.55.0-14 and later need kernel ≥ 1.47.1, so the devDependencies stay on builds the floor runs). Today the floor is 1.26.3 and the newest certified kernel 1.47.1; the second job moves by hand to each newer certified kernel, so both ends of the range are tested. If the port protocol ever breaks within 1.x, a patch release narrows the upper bound. Renovate opens PRs for the kernel, `wasi-pnpm`, the `wasm-*` packages and `slicc-cdp` but never merges them, because they move only after the homescoop coordinator certifies them.
+`@ai-ecoverse/slicc-kernel` is a peer dependency (`>=1.47.1 <2`, the first kernel with users and the H1 wasm commands; until 3.31.0 the floor was 1.26.3): the agent only calls `attachKernel`, the client end of the page kernel's port, so it must match the kernel the page runs. Seven chooses that version: slicc-bios pins the certified kernel next to the agent in `src/packages/agent/package.json`, and pnpm fills the peer from that pin. The devDependency is the lowest certified kernel the range allows (1.47.1), and the unit and integration tests run on it with the H1 wasm commands as devDependencies. A second CI job reruns the integration tests on the newest certified kernel (`NEWEST_CERTIFIED_KERNEL` in `.github/workflows/ci.yml`), with the wasm commands certified for it (`NEWEST_CERTIFIED_WASM`). Today the floor is 1.47.1 and the newest certified kernel 1.53.3; the second job moves by hand to each newer certified kernel, so both ends of the range are tested. If the port protocol ever breaks within 1.x, a patch release narrows the upper bound. Renovate opens PRs for the kernel, `wasi-pnpm`, the `wasm-*` packages and `slicc-cdp` but never merges them, because they move only after the homescoop coordinator certifies them.
 
 ## Patched dependencies
 

package/dist/host.js

@@ -11,6 +11,7 @@ import {
 import { createAgentControl } from "./control.js";
 import { trackDeliveries } from "./deliveries.js";
 import { PortListener } from "./listener.js";
+import { viewControl, viewRemote, viewSettings } from "./readonly.js";
 import { createRemote } from "./remote/host.js";
 import {
   AGENT_SESSION,
@@ -124,7 +125,7 @@ async function hostAgent(agent, options = {}) {
     }
   });
   provider.provide(AgentRemoteService, remote);
-  provider.provide(AgentTranscript, {
+  const transcriptService = {
     state,
     deliveries: deliveries.state,
     agents: mounted.agents,
@@ -135,25 +136,44 @@ async function hostAgent(agent, options = {}) {
     memoryScopes: options.memory?.scopes ?? replicatedState([]),
     frozen: options.freezer?.frozen ?? replicatedState([]),
     changes: options.changes?.view ?? replicatedState({ unavailable: null, changes: [] })
-  });
-  provider.provide(AgentSettings, options.settings ?? noSettings);
-  const host = {
-    serverServices: serverServices(),
-    async resolveSession(sessionId) {
-      if (sessionId !== AGENT_SESSION)
-        throw new SessionNotFoundError(`unknown session ${sessionId}`);
-      return { id: sessionId };
-    },
-    openSession: async () => sessionServices(provider)
   };
-  const listener = new PortListener(serverId);
-  const server = await new Server(host, { serverId, listeners: [listener] }).start();
+  provider.provide(AgentTranscript, transcriptService);
+  const settings = options.settings ?? noSettings;
+  provider.provide(AgentSettings, settings);
+  const viewer = new RemoteServiceProvider([
+    { service: AgentControl, mode: "singleton" },
+    { service: AgentTranscript, mode: "singleton" },
+    { service: AgentSettings, mode: "singleton" },
+    { service: AgentRemoteService, mode: "singleton" }
+  ]);
+  viewer.provide(AgentControl, viewControl(control));
+  viewer.provide(AgentTranscript, transcriptService);
+  viewer.provide(AgentSettings, viewSettings(settings));
+  viewer.provide(AgentRemoteService, viewRemote(remote));
+  const serve = async (id, services) => {
+    const host = {
+      serverServices: serverServices(),
+      async resolveSession(sessionId) {
+        if (sessionId !== AGENT_SESSION)
+          throw new SessionNotFoundError(`unknown session ${sessionId}`);
+        return { id: sessionId };
+      },
+      openSession: async () => sessionServices(services)
+    };
+    const listener = new PortListener(id);
+    const server = await new Server(host, { serverId: id, listeners: [listener] }).start();
+    return { listener, server };
+  };
+  const full = await serve(serverId, provider);
+  const view = await serve(crypto.randomUUID(), viewer);
   return {
     serverId,
     agent,
-    connect: (endpoint) => listener.connect(endpoint),
+    connect: (endpoint, connectOptions) => (connectOptions?.readOnly ? view : full).listener.connect(endpoint),
     async close() {
-      await server.close();
+      await full.server.close();
+      await view.server.close();
+      viewer.dispose();
       await remote.dispose();
       provider.dispose();
       deliveries.dispose();

package/dist/host.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../src/host.ts"],
-  "sourcesContent": ["import {\n  type Context,\n  createRemoteServiceEndpoint,\n  RemoteServiceProvider,\n  replicatedState,\n} from '@earendil-works/chord';\nimport { BACKGROUND_CONTEXT } from '@earendil-works/chord/context';\nimport type { ConversationView } from '@earendil-works/pi-durable';\nimport {\n  type RoutedServerServiceHost,\n  type RoutedSessionAttachment,\n  type RoutedSessionHandle,\n  Server,\n  type ServerHost,\n  SessionNotFoundError,\n} from '@earendil-works/pi-server';\nimport type { Agent } from './agent.ts';\nimport type { ChangesView } from './changes/git.ts';\nimport type { ChangesRuntime } from './changes/index.ts';\nimport { createAgentControl, type HostLicks, type HostScoops } from './control.ts';\nimport { trackDeliveries } from './deliveries.ts';\nimport type { FreezerRuntime, FrozenCone } from './freezer/index.ts';\nimport { PortListener } from './listener.ts';\nimport type { McpRuntime } from './mcp/index.ts';\nimport type { MemoryEntry, MemoryScope } from './memory/format.ts';\nimport type { MemoryRuntime } from './memory/index.ts';\nimport { createRemote } from './remote/host.ts';\nimport {\n  AGENT_SESSION,\n  AgentControl,\n  AgentRemoteService,\n  AgentSessions,\n  AgentSettings,\n  AgentTranscript,\n  type Command,\n} from './services.ts';\nimport type { SkillsRuntime } from './skills/index.ts';\nimport type { SprinklesRuntime } from './sprinkles/index.ts';\nimport type { Sprinkle } from './sprinkles/kind.ts';\nimport { agentViews } from './views.ts';\nimport type { PortEndpoint } from './wire.ts';\n\nexport interface AgentHost {\n  readonly serverId: string;\n  readonly agent: Agent;\n  connect(endpoint: PortEndpoint): void;\n  close(): Promise<void>;\n}\n\nfunction endpointFor(provider: RemoteServiceProvider): RoutedSessionAttachment {\n  const endpoint = createRemoteServiceEndpoint(provider);\n  return {\n    invokeService: (call, publish, context) =>\n      endpoint.invoke(call, (id, update) => publish(id, update, context), context),\n    release: () => endpoint.dispose(),\n  };\n}\n\nfunction sessionServices(provider: RemoteServiceProvider): RoutedSessionHandle {\n  return {\n    attachClient: () => endpointFor(provider),\n    close: async () => {},\n  };\n}\n\nfunction serverServices(): RoutedServerServiceHost {\n  return {\n    attachClient(presentation) {\n      const provider = new RemoteServiceProvider([{ service: AgentSessions, mode: 'singleton' }]);\n      provider.provide(AgentSessions, {\n        attach: (sessionId, context) => presentation.attachSession(sessionId, context),\n        detach: (context) => presentation.detachSession(context),\n      });\n      const attachment = endpointFor(provider);\n      return {\n        invokeService: attachment.invokeService,\n        release(context) {\n          attachment.release(context);\n          provider.dispose();\n        },\n      };\n    },\n  };\n}\n\nconst noSettings: AgentSettings = {\n  state: replicatedState({ models: [], accounts: [] }),\n  connect: async () => {\n    throw new Error('this agent has no accounts');\n  },\n  disconnect: async () => {},\n  signIn: async () => null,\n};\n\nasync function follow(agent: Agent, context: Context) {\n  let attached = await agent.cone().viewState(context);\n  const state = replicatedState<ConversationView>(attached.value);\n  const mirror = (value: ConversationView, from: Context) => state.replace(from, value);\n  let off = attached.subscribe(mirror);\n  const stop = agent.onCone(async (conversation) => {\n    const next = await conversation.viewState(context);\n    off();\n    attached.dispose();\n    attached = next;\n    state.replace(context, next.value);\n    off = next.subscribe(mirror);\n  });\n  return {\n    state,\n    dispose() {\n      stop();\n      off();\n      attached.dispose();\n    },\n  };\n}\n\nexport async function hostAgent(\n  agent: Agent,\n  options: {\n    serverId?: string;\n    context?: Context;\n    settings?: AgentSettings;\n    licks?: HostLicks;\n    scoops?: HostScoops;\n    skills?: SkillsRuntime;\n    sprinkles?: SprinklesRuntime;\n    memory?: MemoryRuntime;\n    freezer?: FreezerRuntime;\n    changes?: ChangesRuntime;\n    mcp?: Pick<McpRuntime, 'close'>;\n  } = {}\n): Promise<AgentHost> {\n  const context = options.context ?? BACKGROUND_CONTEXT;\n  const serverId = options.serverId ?? crypto.randomUUID();\n  const transcript = await follow(agent, context);\n  const { state } = transcript;\n  const mounted = await agentViews(agent, context);\n  const touch = () => options.freezer?.touch();\n  const untouch = [state.subscribe(touch), mounted.views.subscribe(touch)];\n  const provider = new RemoteServiceProvider([\n    { service: AgentControl, mode: 'singleton' },\n    { service: AgentTranscript, mode: 'singleton' },\n    { service: AgentSettings, mode: 'singleton' },\n    { service: AgentRemoteService, mode: 'singleton' },\n  ]);\n  const deliveries = trackDeliveries(agent.harness, state, context);\n  const control = createAgentControl(\n    agent.harness,\n    agent,\n    deliveries,\n    options.licks,\n    options.scoops,\n    options.skills,\n    options.sprinkles,\n    options.memory,\n    options.freezer,\n    options.changes\n  );\n  provider.provide(AgentControl, control);\n  const remote = createRemote({\n    harness: agent.harness,\n    send: (request, using) => control.send(request, using),\n    async conversation(agentId, using) {\n      if (!agentId) return agent.cone();\n      const found = await agent.agents.conversation(agentId, using);\n      if (!found) throw new Error(`There is no agent ${agentId}.`);\n      return found;\n    },\n  });\n  provider.provide(AgentRemoteService, remote);\n  provider.provide(AgentTranscript, {\n    state,\n    deliveries: deliveries.state,\n    agents: mounted.agents,\n    views: mounted.views,\n    commands: options.skills?.commands ?? replicatedState<Command[]>([]),\n    sprinkles: options.sprinkles?.sprinkles ?? replicatedState<Sprinkle[]>([]),\n    memories: options.memory?.memories ?? replicatedState<MemoryEntry[]>([]),\n    memoryScopes: options.memory?.scopes ?? replicatedState<MemoryScope[]>([]),\n    frozen: options.freezer?.frozen ?? replicatedState<FrozenCone[]>([]),\n    changes:\n      options.changes?.view ?? replicatedState<ChangesView>({ unavailable: null, changes: [] }),\n  });\n  provider.provide(AgentSettings, options.settings ?? noSettings);\n  const host: ServerHost = {\n    serverServices: serverServices(),\n    async resolveSession(sessionId) {\n      if (sessionId !== AGENT_SESSION)\n        throw new SessionNotFoundError(`unknown session ${sessionId}`);\n      return { id: sessionId };\n    },\n    openSession: async () => sessionServices(provider),\n  };\n  const listener = new PortListener(serverId);\n  const server = await new Server(host, { serverId, listeners: [listener] }).start();\n  return {\n    serverId,\n    agent,\n    connect: (endpoint) => listener.connect(endpoint),\n    async close() {\n      await server.close();\n      await remote.dispose();\n      provider.dispose();\n      deliveries.dispose();\n      transcript.dispose();\n      mounted.dispose();\n      for (const off of untouch) off();\n      options.freezer?.close();\n      await options.changes?.close(context);\n      await options.memory?.close(context);\n      await options.sprinkles?.close(context);\n      await options.skills?.close(context);\n      await options.mcp?.close(context);\n      await options.scoops?.runtime.close(context);\n      await options.licks?.sources.close(context);\n      await agent.close();\n    },\n  };\n}\n"],
-  "mappings": "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",
+  "sourcesContent": ["import {\n  type Context,\n  createRemoteServiceEndpoint,\n  RemoteServiceProvider,\n  replicatedState,\n} from '@earendil-works/chord';\nimport { BACKGROUND_CONTEXT } from '@earendil-works/chord/context';\nimport type { ConversationView } from '@earendil-works/pi-durable';\nimport {\n  type RoutedServerServiceHost,\n  type RoutedSessionAttachment,\n  type RoutedSessionHandle,\n  Server,\n  type ServerHost,\n  SessionNotFoundError,\n} from '@earendil-works/pi-server';\nimport type { Agent } from './agent.ts';\nimport type { ChangesView } from './changes/git.ts';\nimport type { ChangesRuntime } from './changes/index.ts';\nimport { createAgentControl, type HostLicks, type HostScoops } from './control.ts';\nimport { trackDeliveries } from './deliveries.ts';\nimport type { FreezerRuntime, FrozenCone } from './freezer/index.ts';\nimport { PortListener } from './listener.ts';\nimport type { McpRuntime } from './mcp/index.ts';\nimport type { MemoryEntry, MemoryScope } from './memory/format.ts';\nimport type { MemoryRuntime } from './memory/index.ts';\nimport { viewControl, viewRemote, viewSettings } from './readonly.ts';\nimport { createRemote } from './remote/host.ts';\nimport {\n  AGENT_SESSION,\n  AgentControl,\n  AgentRemoteService,\n  AgentSessions,\n  AgentSettings,\n  AgentTranscript,\n  type Command,\n} from './services.ts';\nimport type { SkillsRuntime } from './skills/index.ts';\nimport type { SprinklesRuntime } from './sprinkles/index.ts';\nimport type { Sprinkle } from './sprinkles/kind.ts';\nimport { agentViews } from './views.ts';\nimport type { PortEndpoint } from './wire.ts';\n\nexport interface AgentHost {\n  readonly serverId: string;\n  readonly agent: Agent;\n  connect(endpoint: PortEndpoint, options?: { readOnly?: boolean }): void;\n  close(): Promise<void>;\n}\n\nfunction endpointFor(provider: RemoteServiceProvider): RoutedSessionAttachment {\n  const endpoint = createRemoteServiceEndpoint(provider);\n  return {\n    invokeService: (call, publish, context) =>\n      endpoint.invoke(call, (id, update) => publish(id, update, context), context),\n    release: () => endpoint.dispose(),\n  };\n}\n\nfunction sessionServices(provider: RemoteServiceProvider): RoutedSessionHandle {\n  return {\n    attachClient: () => endpointFor(provider),\n    close: async () => {},\n  };\n}\n\nfunction serverServices(): RoutedServerServiceHost {\n  return {\n    attachClient(presentation) {\n      const provider = new RemoteServiceProvider([{ service: AgentSessions, mode: 'singleton' }]);\n      provider.provide(AgentSessions, {\n        attach: (sessionId, context) => presentation.attachSession(sessionId, context),\n        detach: (context) => presentation.detachSession(context),\n      });\n      const attachment = endpointFor(provider);\n      return {\n        invokeService: attachment.invokeService,\n        release(context) {\n          attachment.release(context);\n          provider.dispose();\n        },\n      };\n    },\n  };\n}\n\nconst noSettings: AgentSettings = {\n  state: replicatedState({ models: [], accounts: [] }),\n  connect: async () => {\n    throw new Error('this agent has no accounts');\n  },\n  disconnect: async () => {},\n  signIn: async () => null,\n};\n\nasync function follow(agent: Agent, context: Context) {\n  let attached = await agent.cone().viewState(context);\n  const state = replicatedState<ConversationView>(attached.value);\n  const mirror = (value: ConversationView, from: Context) => state.replace(from, value);\n  let off = attached.subscribe(mirror);\n  const stop = agent.onCone(async (conversation) => {\n    const next = await conversation.viewState(context);\n    off();\n    attached.dispose();\n    attached = next;\n    state.replace(context, next.value);\n    off = next.subscribe(mirror);\n  });\n  return {\n    state,\n    dispose() {\n      stop();\n      off();\n      attached.dispose();\n    },\n  };\n}\n\nexport async function hostAgent(\n  agent: Agent,\n  options: {\n    serverId?: string;\n    context?: Context;\n    settings?: AgentSettings;\n    licks?: HostLicks;\n    scoops?: HostScoops;\n    skills?: SkillsRuntime;\n    sprinkles?: SprinklesRuntime;\n    memory?: MemoryRuntime;\n    freezer?: FreezerRuntime;\n    changes?: ChangesRuntime;\n    mcp?: Pick<McpRuntime, 'close'>;\n  } = {}\n): Promise<AgentHost> {\n  const context = options.context ?? BACKGROUND_CONTEXT;\n  const serverId = options.serverId ?? crypto.randomUUID();\n  const transcript = await follow(agent, context);\n  const { state } = transcript;\n  const mounted = await agentViews(agent, context);\n  const touch = () => options.freezer?.touch();\n  const untouch = [state.subscribe(touch), mounted.views.subscribe(touch)];\n  const provider = new RemoteServiceProvider([\n    { service: AgentControl, mode: 'singleton' },\n    { service: AgentTranscript, mode: 'singleton' },\n    { service: AgentSettings, mode: 'singleton' },\n    { service: AgentRemoteService, mode: 'singleton' },\n  ]);\n  const deliveries = trackDeliveries(agent.harness, state, context);\n  const control = createAgentControl(\n    agent.harness,\n    agent,\n    deliveries,\n    options.licks,\n    options.scoops,\n    options.skills,\n    options.sprinkles,\n    options.memory,\n    options.freezer,\n    options.changes\n  );\n  provider.provide(AgentControl, control);\n  const remote = createRemote({\n    harness: agent.harness,\n    send: (request, using) => control.send(request, using),\n    async conversation(agentId, using) {\n      if (!agentId) return agent.cone();\n      const found = await agent.agents.conversation(agentId, using);\n      if (!found) throw new Error(`There is no agent ${agentId}.`);\n      return found;\n    },\n  });\n  provider.provide(AgentRemoteService, remote);\n  const transcriptService = {\n    state,\n    deliveries: deliveries.state,\n    agents: mounted.agents,\n    views: mounted.views,\n    commands: options.skills?.commands ?? replicatedState<Command[]>([]),\n    sprinkles: options.sprinkles?.sprinkles ?? replicatedState<Sprinkle[]>([]),\n    memories: options.memory?.memories ?? replicatedState<MemoryEntry[]>([]),\n    memoryScopes: options.memory?.scopes ?? replicatedState<MemoryScope[]>([]),\n    frozen: options.freezer?.frozen ?? replicatedState<FrozenCone[]>([]),\n    changes:\n      options.changes?.view ?? replicatedState<ChangesView>({ unavailable: null, changes: [] }),\n  };\n  provider.provide(AgentTranscript, transcriptService);\n  const settings = options.settings ?? noSettings;\n  provider.provide(AgentSettings, settings);\n  const viewer = new RemoteServiceProvider([\n    { service: AgentControl, mode: 'singleton' },\n    { service: AgentTranscript, mode: 'singleton' },\n    { service: AgentSettings, mode: 'singleton' },\n    { service: AgentRemoteService, mode: 'singleton' },\n  ]);\n  viewer.provide(AgentControl, viewControl(control));\n  viewer.provide(AgentTranscript, transcriptService);\n  viewer.provide(AgentSettings, viewSettings(settings));\n  viewer.provide(AgentRemoteService, viewRemote(remote));\n  const serve = async (id: string, services: RemoteServiceProvider) => {\n    const host: ServerHost = {\n      serverServices: serverServices(),\n      async resolveSession(sessionId) {\n        if (sessionId !== AGENT_SESSION)\n          throw new SessionNotFoundError(`unknown session ${sessionId}`);\n        return { id: sessionId };\n      },\n      openSession: async () => sessionServices(services),\n    };\n    const listener = new PortListener(id);\n    const server = await new Server(host, { serverId: id, listeners: [listener] }).start();\n    return { listener, server };\n  };\n  const full = await serve(serverId, provider);\n  const view = await serve(crypto.randomUUID(), viewer);\n  return {\n    serverId,\n    agent,\n    connect: (endpoint, connectOptions) =>\n      (connectOptions?.readOnly ? view : full).listener.connect(endpoint),\n    async close() {\n      await full.server.close();\n      await view.server.close();\n      viewer.dispose();\n      await remote.dispose();\n      provider.dispose();\n      deliveries.dispose();\n      transcript.dispose();\n      mounted.dispose();\n      for (const off of untouch) off();\n      options.freezer?.close();\n      await options.changes?.close(context);\n      await options.memory?.close(context);\n      await options.sprinkles?.close(context);\n      await options.skills?.close(context);\n      await options.mcp?.close(context);\n      await options.scoops?.runtime.close(context);\n      await options.licks?.sources.close(context);\n      await agent.close();\n    },\n  };\n}\n"],
+  "mappings": "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",
   "names": []
 }

package/dist/link.js

@@ -0,0 +1,146 @@
+const MAX_FRAME = 16 * 1024 * 1024;
+const DATA = 0;
+const HELLO = 1;
+const CLOSE = 2;
+function encodeFrame(frame) {
+  const body = frame instanceof Uint8Array ? frame : "hello" in frame ? new TextEncoder().encode(frame.hello) : new Uint8Array();
+  const tag = frame instanceof Uint8Array ? DATA : "hello" in frame ? HELLO : CLOSE;
+  const out = new Uint8Array(5 + body.length);
+  new DataView(out.buffer).setUint32(0, body.length + 1);
+  out[4] = tag;
+  out.set(body, 5);
+  return out;
+}
+class FrameReader {
+  #chunks = [];
+  #size = 0;
+  #take(count) {
+    const out = new Uint8Array(count);
+    let filled = 0;
+    while (filled < count) {
+      const head = this.#chunks[0];
+      const used = Math.min(head.length, count - filled);
+      out.set(head.subarray(0, used), filled);
+      filled += used;
+      if (used === head.length) this.#chunks.shift();
+      else this.#chunks[0] = head.subarray(used);
+    }
+    this.#size -= count;
+    return out;
+  }
+  #peek() {
+    const header = new Uint8Array(4);
+    let filled = 0;
+    for (const chunk of this.#chunks) {
+      const used = Math.min(chunk.length, 4 - filled);
+      header.set(chunk.subarray(0, used), filled);
+      filled += used;
+      if (filled === 4) break;
+    }
+    return new DataView(header.buffer).getUint32(0);
+  }
+  push(chunk) {
+    if (chunk.length) {
+      this.#chunks.push(chunk);
+      this.#size += chunk.length;
+    }
+    const frames = [];
+    while (this.#size >= 4) {
+      const length = this.#peek();
+      if (length < 1 || length > MAX_FRAME) throw new Error(`agent link frame of ${length} bytes`);
+      if (this.#size - 4 < length) break;
+      this.#take(4);
+      const frame = this.#take(length);
+      const tag = frame[0];
+      const body = frame.subarray(1);
+      if (tag === DATA) frames.push(body.slice());
+      else if (tag === HELLO) frames.push({ hello: new TextDecoder().decode(body) });
+      else if (tag === CLOSE) frames.push({ close: true });
+      else throw new Error(`agent link frame tag ${tag}`);
+    }
+    return frames;
+  }
+}
+function linkEndpoint(sink) {
+  const listeners = /* @__PURE__ */ new Map();
+  const reader = new FrameReader();
+  let ended = false;
+  const emit = (type, data) => {
+    for (const listener of listeners.get(type) ?? []) listener({ type, data });
+  };
+  const finish = (error) => {
+    if (ended) return;
+    ended = true;
+    emit(error ? "error" : "close");
+  };
+  return {
+    postMessage(message) {
+      if (!ended) sink.write(encodeFrame(message));
+    },
+    addEventListener(type, listener) {
+      listeners.set(type, [...listeners.get(type) ?? [], listener]);
+    },
+    close() {
+      if (ended) return;
+      ended = true;
+      sink.close();
+    },
+    receive(chunk) {
+      if (ended) return;
+      try {
+        for (const frame of reader.push(chunk)) emit("message", frame);
+      } catch (error) {
+        finish(error);
+        sink.close();
+      }
+    },
+    end: finish
+  };
+}
+function bridgePort(port, sink) {
+  const reader = new FrameReader();
+  let ended = false;
+  const stop = () => {
+    if (ended) return;
+    ended = true;
+    sink.close();
+  };
+  port.addEventListener("message", ({ data }) => {
+    if (!ended) sink.write(encodeFrame(data));
+    if (!(data instanceof Uint8Array) && data?.close) stop();
+  });
+  port.addEventListener("close", stop);
+  port.start?.();
+  const close = () => {
+    port.postMessage({ close: true });
+    port.close?.();
+  };
+  return {
+    receive(chunk) {
+      if (ended) return;
+      try {
+        for (const frame of reader.push(chunk)) {
+          if (frame instanceof Uint8Array) port.postMessage(frame, [frame.buffer]);
+          else port.postMessage(frame);
+        }
+      } catch {
+        ended = true;
+        close();
+        sink.close();
+      }
+    },
+    end() {
+      if (ended) return;
+      ended = true;
+      close();
+    }
+  };
+}
+export {
+  FrameReader,
+  MAX_FRAME,
+  bridgePort,
+  encodeFrame,
+  linkEndpoint
+};
+//# sourceMappingURL=link.js.map

package/dist/link.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../src/link.ts"],
+  "sourcesContent": ["import type { Frame, PortEndpoint } from './wire.ts';\n\nexport const MAX_FRAME = 16 * 1024 * 1024;\n\nconst DATA = 0;\nconst HELLO = 1;\nconst CLOSE = 2;\n\nexport interface ByteSink {\n  write(chunk: Uint8Array): void;\n  close(): void;\n}\n\nexport interface LinkEnd {\n  receive(chunk: Uint8Array): void;\n  end(error?: Error): void;\n}\n\nexport function encodeFrame(frame: Frame): Uint8Array {\n  const body =\n    frame instanceof Uint8Array\n      ? frame\n      : 'hello' in frame\n        ? new TextEncoder().encode(frame.hello)\n        : new Uint8Array();\n  const tag = frame instanceof Uint8Array ? DATA : 'hello' in frame ? HELLO : CLOSE;\n  const out = new Uint8Array(5 + body.length);\n  new DataView(out.buffer).setUint32(0, body.length + 1);\n  out[4] = tag;\n  out.set(body, 5);\n  return out;\n}\n\nexport class FrameReader {\n  readonly #chunks: Uint8Array[] = [];\n  #size = 0;\n\n  #take(count: number): Uint8Array {\n    const out = new Uint8Array(count);\n    let filled = 0;\n    while (filled < count) {\n      const head = this.#chunks[0] as Uint8Array;\n      const used = Math.min(head.length, count - filled);\n      out.set(head.subarray(0, used), filled);\n      filled += used;\n      if (used === head.length) this.#chunks.shift();\n      else this.#chunks[0] = head.subarray(used);\n    }\n    this.#size -= count;\n    return out;\n  }\n\n  #peek(): number {\n    const header = new Uint8Array(4);\n    let filled = 0;\n    for (const chunk of this.#chunks) {\n      const used = Math.min(chunk.length, 4 - filled);\n      header.set(chunk.subarray(0, used), filled);\n      filled += used;\n      if (filled === 4) break;\n    }\n    return new DataView(header.buffer).getUint32(0);\n  }\n\n  push(chunk: Uint8Array): Frame[] {\n    if (chunk.length) {\n      this.#chunks.push(chunk);\n      this.#size += chunk.length;\n    }\n    const frames: Frame[] = [];\n    while (this.#size >= 4) {\n      const length = this.#peek();\n      if (length < 1 || length > MAX_FRAME) throw new Error(`agent link frame of ${length} bytes`);\n      if (this.#size - 4 < length) break;\n      this.#take(4);\n      const frame = this.#take(length);\n      const tag = frame[0];\n      const body = frame.subarray(1);\n      if (tag === DATA) frames.push(body.slice());\n      else if (tag === HELLO) frames.push({ hello: new TextDecoder().decode(body) });\n      else if (tag === CLOSE) frames.push({ close: true });\n      else throw new Error(`agent link frame tag ${tag}`);\n    }\n    return frames;\n  }\n}\n\ntype Listener = (event: { type: string; data?: unknown }) => void;\n\nexport function linkEndpoint(sink: ByteSink): PortEndpoint & LinkEnd {\n  const listeners = new Map<string, Listener[]>();\n  const reader = new FrameReader();\n  let ended = false;\n  const emit = (type: string, data?: unknown) => {\n    for (const listener of listeners.get(type) ?? []) listener({ type, data });\n  };\n  const finish = (error?: Error) => {\n    if (ended) return;\n    ended = true;\n    emit(error ? 'error' : 'close');\n  };\n  return {\n    postMessage(message) {\n      if (!ended) sink.write(encodeFrame(message as Frame));\n    },\n    addEventListener(type: string, listener: Listener) {\n      listeners.set(type, [...(listeners.get(type) ?? []), listener]);\n    },\n    close() {\n      if (ended) return;\n      ended = true;\n      sink.close();\n    },\n    receive(chunk) {\n      if (ended) return;\n      try {\n        for (const frame of reader.push(chunk)) emit('message', frame);\n      } catch (error) {\n        finish(error as Error);\n        sink.close();\n      }\n    },\n    end: finish,\n  } as PortEndpoint & LinkEnd;\n}\n\nexport function bridgePort(port: PortEndpoint, sink: ByteSink): LinkEnd {\n  const reader = new FrameReader();\n  let ended = false;\n  const stop = () => {\n    if (ended) return;\n    ended = true;\n    sink.close();\n  };\n  port.addEventListener('message', ({ data }) => {\n    if (!ended) sink.write(encodeFrame(data as Frame));\n    if (!(data instanceof Uint8Array) && (data as { close?: boolean } | null)?.close) stop();\n  });\n  port.addEventListener('close', stop);\n  port.start?.();\n  const close = () => {\n    port.postMessage({ close: true } satisfies Frame);\n    port.close?.();\n  };\n  return {\n    receive(chunk) {\n      if (ended) return;\n      try {\n        for (const frame of reader.push(chunk)) {\n          if (frame instanceof Uint8Array) port.postMessage(frame, [frame.buffer]);\n          else port.postMessage(frame);\n        }\n      } catch {\n        ended = true;\n        close();\n        sink.close();\n      }\n    },\n    end() {\n      if (ended) return;\n      ended = true;\n      close();\n    },\n  };\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/owner.js

@@ -24,16 +24,17 @@ async function startAgent(options) {
     release();
     throw error;
   }
-  const open = async () => {
+  const open = async (portOptions = {}) => {
     const ready = await worker;
     if (!ready) throw new Error("the agent was released");
     const { port1, port2 } = channel();
-    ready.postMessage({ connect: port2 }, [port2]);
+    const readOnly = portOptions.readOnly === true ? { readOnly: true } : {};
+    ready.postMessage({ connect: port2, ...readOnly }, [port2]);
     return port1;
   };
   return {
-    async connect() {
-      return connectAgent(await open());
+    async connect(portOptions) {
+      return connectAgent(await open(portOptions));
     },
     port: open,
     restart() {

package/dist/owner.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../src/owner.ts"],
-  "sourcesContent": ["import { type AgentConnection, connectAgent } from './client.ts';\nimport { holdLock } from './opfs-pool.ts';\nimport type { PortEndpoint } from './wire.ts';\n\nexport const AGENT_LOCK = 'slicc-agent';\n\nexport interface AgentWorker {\n  postMessage(message: unknown, transfer: Transferable[]): void;\n  terminate(): void;\n}\n\nexport interface AgentOwner {\n  connect(): Promise<AgentConnection>;\n  port(): Promise<Transferable>;\n  restart(): Promise<void>;\n  release(): Promise<void>;\n}\n\nexport interface KernelSource {\n  connect(): Promise<Transferable>;\n}\n\nexport interface OwnerOptions {\n  worker: () => AgentWorker;\n  kernel?: KernelSource;\n  locks?: LockManager;\n  held?: boolean;\n  channel?: () => { port1: PortEndpoint & Transferable; port2: Transferable };\n}\n\nexport async function startAgent(options: OwnerOptions): Promise<AgentOwner> {\n  const release = options.held\n    ? () => undefined\n    : await holdLock(options.locks ?? navigator.locks, AGENT_LOCK);\n  const channel = options.channel ?? (() => new MessageChannel());\n  const spawn = async (): Promise<AgentWorker> => {\n    const created = options.worker();\n    try {\n      if (options.kernel) {\n        const port = await options.kernel.connect();\n        created.postMessage({ kernel: port }, [port]);\n      }\n    } catch (error) {\n      created.terminate();\n      throw error;\n    }\n    return created;\n  };\n  let worker: Promise<AgentWorker | undefined> = Promise.resolve().then(spawn);\n  try {\n    await worker;\n  } catch (error) {\n    release();\n    throw error;\n  }\n  const open = async (): Promise<PortEndpoint & Transferable> => {\n    const ready = await worker;\n    if (!ready) throw new Error('the agent was released');\n    const { port1, port2 } = channel();\n    ready.postMessage({ connect: port2 }, [port2]);\n    return port1;\n  };\n  return {\n    async connect() {\n      return connectAgent(await open());\n    },\n    port: open,\n    restart() {\n      worker = worker\n        .catch(() => undefined)\n        .then((old) => {\n          old?.terminate();\n          return spawn();\n        });\n      return worker.then(() => undefined);\n    },\n    async release() {\n      const previous = worker;\n      worker = Promise.resolve(undefined);\n      try {\n        (await previous.catch(() => undefined))?.terminate();\n      } finally {\n        release();\n      }\n    },\n  };\n}\n"],
-  "mappings": "AAAA,SAA+B,oBAAoB;AACnD,SAAS,gBAAgB;AAGlB,MAAM,aAAa;AA0B1B,eAAsB,WAAW,SAA4C;AAC3E,QAAM,UAAU,QAAQ,OACpB,MAAM,SACN,MAAM,SAAS,QAAQ,SAAS,UAAU,OAAO,UAAU;AAC/D,QAAM,UAAU,QAAQ,YAAY,MAAM,IAAI,eAAe;AAC7D,QAAM,QAAQ,YAAkC;AAC9C,UAAM,UAAU,QAAQ,OAAO;AAC/B,QAAI;AACF,UAAI,QAAQ,QAAQ;AAClB,cAAM,OAAO,MAAM,QAAQ,OAAO,QAAQ;AAC1C,gBAAQ,YAAY,EAAE,QAAQ,KAAK,GAAG,CAAC,IAAI,CAAC;AAAA,MAC9C;AAAA,IACF,SAAS,OAAO;AACd,cAAQ,UAAU;AAClB,YAAM;AAAA,IACR;AACA,WAAO;AAAA,EACT;AACA,MAAI,SAA2C,QAAQ,QAAQ,EAAE,KAAK,KAAK;AAC3E,MAAI;AACF,UAAM;AAAA,EACR,SAAS,OAAO;AACd,YAAQ;AACR,UAAM;AAAA,EACR;AACA,QAAM,OAAO,YAAkD;AAC7D,UAAM,QAAQ,MAAM;AACpB,QAAI,CAAC,MAAO,OAAM,IAAI,MAAM,wBAAwB;AACpD,UAAM,EAAE,OAAO,MAAM,IAAI,QAAQ;AACjC,UAAM,YAAY,EAAE,SAAS,MAAM,GAAG,CAAC,KAAK,CAAC;AAC7C,WAAO;AAAA,EACT;AACA,SAAO;AAAA,IACL,MAAM,UAAU;AACd,aAAO,aAAa,MAAM,KAAK,CAAC;AAAA,IAClC;AAAA,IACA,MAAM;AAAA,IACN,UAAU;AACR,eAAS,OACN,MAAM,MAAM,MAAS,EACrB,KAAK,CAAC,QAAQ;AACb,aAAK,UAAU;AACf,eAAO,MAAM;AAAA,MACf,CAAC;AACH,aAAO,OAAO,KAAK,MAAM,MAAS;AAAA,IACpC;AAAA,IACA,MAAM,UAAU;AACd,YAAM,WAAW;AACjB,eAAS,QAAQ,QAAQ,MAAS;AAClC,UAAI;AACF,SAAC,MAAM,SAAS,MAAM,MAAM,MAAS,IAAI,UAAU;AAAA,MACrD,UAAE;AACA,gBAAQ;AAAA,MACV;AAAA,IACF;AAAA,EACF;AACF;",
+  "sourcesContent": ["import { type AgentConnection, connectAgent } from './client.ts';\nimport { holdLock } from './opfs-pool.ts';\nimport type { PortEndpoint } from './wire.ts';\n\nexport const AGENT_LOCK = 'slicc-agent';\n\nexport interface AgentWorker {\n  postMessage(message: unknown, transfer: Transferable[]): void;\n  terminate(): void;\n}\n\nexport interface PortOptions {\n  readOnly?: boolean;\n}\n\nexport interface AgentOwner {\n  connect(options?: PortOptions): Promise<AgentConnection>;\n  port(options?: PortOptions): Promise<PortEndpoint & Transferable>;\n  restart(): Promise<void>;\n  release(): Promise<void>;\n}\n\nexport interface KernelSource {\n  connect(): Promise<Transferable>;\n}\n\nexport interface OwnerOptions {\n  worker: () => AgentWorker;\n  kernel?: KernelSource;\n  locks?: LockManager;\n  held?: boolean;\n  channel?: () => { port1: PortEndpoint & Transferable; port2: Transferable };\n}\n\nexport async function startAgent(options: OwnerOptions): Promise<AgentOwner> {\n  const release = options.held\n    ? () => undefined\n    : await holdLock(options.locks ?? navigator.locks, AGENT_LOCK);\n  const channel = options.channel ?? (() => new MessageChannel());\n  const spawn = async (): Promise<AgentWorker> => {\n    const created = options.worker();\n    try {\n      if (options.kernel) {\n        const port = await options.kernel.connect();\n        created.postMessage({ kernel: port }, [port]);\n      }\n    } catch (error) {\n      created.terminate();\n      throw error;\n    }\n    return created;\n  };\n  let worker: Promise<AgentWorker | undefined> = Promise.resolve().then(spawn);\n  try {\n    await worker;\n  } catch (error) {\n    release();\n    throw error;\n  }\n  const open = async (portOptions: PortOptions = {}): Promise<PortEndpoint & Transferable> => {\n    const ready = await worker;\n    if (!ready) throw new Error('the agent was released');\n    const { port1, port2 } = channel();\n    const readOnly = portOptions.readOnly === true ? { readOnly: true } : {};\n    ready.postMessage({ connect: port2, ...readOnly }, [port2]);\n    return port1;\n  };\n  return {\n    async connect(portOptions) {\n      return connectAgent(await open(portOptions));\n    },\n    port: open,\n    restart() {\n      worker = worker\n        .catch(() => undefined)\n        .then((old) => {\n          old?.terminate();\n          return spawn();\n        });\n      return worker.then(() => undefined);\n    },\n    async release() {\n      const previous = worker;\n      worker = Promise.resolve(undefined);\n      try {\n        (await previous.catch(() => undefined))?.terminate();\n      } finally {\n        release();\n      }\n    },\n  };\n}\n"],
+  "mappings": "AAAA,SAA+B,oBAAoB;AACnD,SAAS,gBAAgB;AAGlB,MAAM,aAAa;AA8B1B,eAAsB,WAAW,SAA4C;AAC3E,QAAM,UAAU,QAAQ,OACpB,MAAM,SACN,MAAM,SAAS,QAAQ,SAAS,UAAU,OAAO,UAAU;AAC/D,QAAM,UAAU,QAAQ,YAAY,MAAM,IAAI,eAAe;AAC7D,QAAM,QAAQ,YAAkC;AAC9C,UAAM,UAAU,QAAQ,OAAO;AAC/B,QAAI;AACF,UAAI,QAAQ,QAAQ;AAClB,cAAM,OAAO,MAAM,QAAQ,OAAO,QAAQ;AAC1C,gBAAQ,YAAY,EAAE,QAAQ,KAAK,GAAG,CAAC,IAAI,CAAC;AAAA,MAC9C;AAAA,IACF,SAAS,OAAO;AACd,cAAQ,UAAU;AAClB,YAAM;AAAA,IACR;AACA,WAAO;AAAA,EACT;AACA,MAAI,SAA2C,QAAQ,QAAQ,EAAE,KAAK,KAAK;AAC3E,MAAI;AACF,UAAM;AAAA,EACR,SAAS,OAAO;AACd,YAAQ;AACR,UAAM;AAAA,EACR;AACA,QAAM,OAAO,OAAO,cAA2B,CAAC,MAA4C;AAC1F,UAAM,QAAQ,MAAM;AACpB,QAAI,CAAC,MAAO,OAAM,IAAI,MAAM,wBAAwB;AACpD,UAAM,EAAE,OAAO,MAAM,IAAI,QAAQ;AACjC,UAAM,WAAW,YAAY,aAAa,OAAO,EAAE,UAAU,KAAK,IAAI,CAAC;AACvE,UAAM,YAAY,EAAE,SAAS,OAAO,GAAG,SAAS,GAAG,CAAC,KAAK,CAAC;AAC1D,WAAO;AAAA,EACT;AACA,SAAO;AAAA,IACL,MAAM,QAAQ,aAAa;AACzB,aAAO,aAAa,MAAM,KAAK,WAAW,CAAC;AAAA,IAC7C;AAAA,IACA,MAAM;AAAA,IACN,UAAU;AACR,eAAS,OACN,MAAM,MAAM,MAAS,EACrB,KAAK,CAAC,QAAQ;AACb,aAAK,UAAU;AACf,eAAO,MAAM;AAAA,MACf,CAAC;AACH,aAAO,OAAO,KAAK,MAAM,MAAS;AAAA,IACpC;AAAA,IACA,MAAM,UAAU;AACd,YAAM,WAAW;AACjB,eAAS,QAAQ,QAAQ,MAAS;AAClC,UAAI;AACF,SAAC,MAAM,SAAS,MAAM,MAAM,MAAS,IAAI,UAAU;AAAA,MACrD,UAAE;AACA,gBAAQ;AAAA,MACV;AAAA,IACF;AAAA,EACF;AACF;",
   "names": []
 }

package/dist/page.js

@@ -1,4 +1,11 @@
 import { connectAgent } from "./client.js";
+import {
+  bridgePort,
+  encodeFrame,
+  FrameReader,
+  linkEndpoint,
+  MAX_FRAME
+} from "./link.js";
 import {
   AGENT_LOCK,
   startAgent
@@ -6,9 +13,16 @@ import {
 import {
   remoteControl
 } from "./remote/client.js";
+import { VIEW_ONLY } from "./view-only.js";
 export {
   AGENT_LOCK,
+  FrameReader,
+  MAX_FRAME,
+  VIEW_ONLY,
+  bridgePort,
   connectAgent,
+  encodeFrame,
+  linkEndpoint,
   remoteControl,
   startAgent
 };

package/dist/page.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../src/page.ts"],
-  "sourcesContent": ["export { type AgentConnection, connectAgent } from './client.ts';\nexport {\n  AGENT_LOCK,\n  type AgentOwner,\n  type AgentWorker,\n  type KernelSource,\n  type OwnerOptions,\n  startAgent,\n} from './owner.ts';\nexport {\n  type RemoteControl,\n  type RemoteEvent,\n  type RemoteOptions,\n  remoteControl,\n} from './remote/client.ts';\n"],
-  "mappings": "AAAA,SAA+B,oBAAoB;AACnD;AAAA,EACE;AAAA,EAKA;AAAA,OACK;AACP;AAAA,EAIE;AAAA,OACK;",
+  "sourcesContent": ["export { type AgentConnection, connectAgent } from './client.ts';\nexport {\n  type ByteSink,\n  bridgePort,\n  encodeFrame,\n  FrameReader,\n  type LinkEnd,\n  linkEndpoint,\n  MAX_FRAME,\n} from './link.ts';\nexport {\n  AGENT_LOCK,\n  type AgentOwner,\n  type AgentWorker,\n  type KernelSource,\n  type OwnerOptions,\n  type PortOptions,\n  startAgent,\n} from './owner.ts';\nexport {\n  type RemoteControl,\n  type RemoteEvent,\n  type RemoteOptions,\n  remoteControl,\n} from './remote/client.ts';\nexport { VIEW_ONLY } from './view-only.ts';\n"],
+  "mappings": "AAAA,SAA+B,oBAAoB;AACnD;AAAA,EAEE;AAAA,EACA;AAAA,EACA;AAAA,EAEA;AAAA,EACA;AAAA,OACK;AACP;AAAA,EACE;AAAA,EAMA;AAAA,OACK;AACP;AAAA,EAIE;AAAA,OACK;AACP,SAAS,iBAAiB;",
   "names": []
 }

package/dist/readonly.js

@@ -0,0 +1,54 @@
+import { ServerError } from "@earendil-works/pi-server";
+import { VIEW_ONLY } from "./view-only.js";
+const READS = /* @__PURE__ */ new Set(["wait", "changesOpen"]);
+function refuse() {
+  return Promise.reject(new ServerError("EACCES", VIEW_ONLY));
+}
+const refused = async () => ({
+  accepted: false,
+  submissionId: null,
+  error: { code: "EACCES", message: VIEW_ONLY }
+});
+const ANSWERS = {
+  send: refused,
+  compact: refused,
+  compactAgent: refused
+};
+function viewControl(control) {
+  const view = {};
+  for (const [key, value] of Object.entries(control))
+    view[key] = typeof value !== "function" || READS.has(key) ? value : ANSWERS[key] ?? refuse;
+  return view;
+}
+function viewSettings(settings) {
+  return { state: settings.state, connect: refuse, disconnect: refuse, signIn: refuse };
+}
+function viewRemote(remote) {
+  const mine = /* @__PURE__ */ new Set();
+  return {
+    prompt: async () => ({ ok: false, code: "EACCES", message: VIEW_ONLY }),
+    async watch(request, context) {
+      const opened = await remote.watch(request, context);
+      if (opened.ok) mine.add(opened.stream);
+      return opened;
+    },
+    async next(stream, waitMs, context) {
+      if (!mine.has(stream)) return { events: [], done: true };
+      const batch = await remote.next(stream, waitMs, context);
+      if (batch.done) mine.delete(stream);
+      return batch;
+    },
+    async close(stream, context) {
+      if (!mine.delete(stream)) return;
+      await remote.close(stream, context);
+    },
+    abort: refuse
+  };
+}
+export {
+  VIEW_ONLY,
+  viewControl,
+  viewRemote,
+  viewSettings
+};
+//# sourceMappingURL=readonly.js.map

package/dist/readonly.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../src/readonly.ts"],
+  "sourcesContent": ["import { ServerError } from '@earendil-works/pi-server';\nimport type { AgentRemote } from './remote/host.ts';\nimport type { AgentControl, AgentSettings } from './services.ts';\nimport { VIEW_ONLY } from './view-only.ts';\n\nexport { VIEW_ONLY };\n\nconst READS = new Set<keyof AgentControl>(['wait', 'changesOpen']);\n\nfunction refuse(): Promise<never> {\n  return Promise.reject(new ServerError('EACCES' as never, VIEW_ONLY));\n}\n\nconst refused = async () => ({\n  accepted: false as const,\n  submissionId: null,\n  error: { code: 'EACCES', message: VIEW_ONLY },\n});\n\nconst ANSWERS: Partial<Record<keyof AgentControl, () => Promise<unknown>>> = {\n  send: refused,\n  compact: refused,\n  compactAgent: refused,\n};\n\nexport function viewControl(control: AgentControl): AgentControl {\n  const view: Record<string, unknown> = {};\n  for (const [key, value] of Object.entries(control))\n    view[key] =\n      typeof value !== 'function' || READS.has(key as keyof AgentControl)\n        ? value\n        : (ANSWERS[key as keyof AgentControl] ?? refuse);\n  return view as unknown as AgentControl;\n}\n\nexport function viewSettings(settings: AgentSettings): AgentSettings {\n  return { state: settings.state, connect: refuse, disconnect: refuse, signIn: refuse };\n}\n\nexport function viewRemote(remote: AgentRemote): AgentRemote {\n  const mine = new Set<string>();\n  return {\n    prompt: async () => ({ ok: false, code: 'EACCES', message: VIEW_ONLY }),\n    async watch(request, context) {\n      const opened = await remote.watch(request, context);\n      if (opened.ok) mine.add(opened.stream);\n      return opened;\n    },\n    async next(stream, waitMs, context) {\n      if (!mine.has(stream)) return { events: [], done: true };\n      const batch = await remote.next(stream, waitMs, context);\n      if (batch.done) mine.delete(stream);\n      return batch;\n    },\n    async close(stream, context) {\n      if (!mine.delete(stream)) return;\n      await remote.close(stream, context);\n    },\n    abort: refuse,\n  };\n}\n"],
+  "mappings": "AAAA,SAAS,mBAAmB;AAG5B,SAAS,iBAAiB;AAI1B,MAAM,QAAQ,oBAAI,IAAwB,CAAC,QAAQ,aAAa,CAAC;AAEjE,SAAS,SAAyB;AAChC,SAAO,QAAQ,OAAO,IAAI,YAAY,UAAmB,SAAS,CAAC;AACrE;AAEA,MAAM,UAAU,aAAa;AAAA,EAC3B,UAAU;AAAA,EACV,cAAc;AAAA,EACd,OAAO,EAAE,MAAM,UAAU,SAAS,UAAU;AAC9C;AAEA,MAAM,UAAuE;AAAA,EAC3E,MAAM;AAAA,EACN,SAAS;AAAA,EACT,cAAc;AAChB;AAEO,SAAS,YAAY,SAAqC;AAC/D,QAAM,OAAgC,CAAC;AACvC,aAAW,CAAC,KAAK,KAAK,KAAK,OAAO,QAAQ,OAAO;AAC/C,SAAK,GAAG,IACN,OAAO,UAAU,cAAc,MAAM,IAAI,GAAyB,IAC9D,QACC,QAAQ,GAAyB,KAAK;AAC/C,SAAO;AACT;AAEO,SAAS,aAAa,UAAwC;AACnE,SAAO,EAAE,OAAO,SAAS,OAAO,SAAS,QAAQ,YAAY,QAAQ,QAAQ,OAAO;AACtF;AAEO,SAAS,WAAW,QAAkC;AAC3D,QAAM,OAAO,oBAAI,IAAY;AAC7B,SAAO;AAAA,IACL,QAAQ,aAAa,EAAE,IAAI,OAAO,MAAM,UAAU,SAAS,UAAU;AAAA,IACrE,MAAM,MAAM,SAAS,SAAS;AAC5B,YAAM,SAAS,MAAM,OAAO,MAAM,SAAS,OAAO;AAClD,UAAI,OAAO,GAAI,MAAK,IAAI,OAAO,MAAM;AACrC,aAAO;AAAA,IACT;AAAA,IACA,MAAM,KAAK,QAAQ,QAAQ,SAAS;AAClC,UAAI,CAAC,KAAK,IAAI,MAAM,EAAG,QAAO,EAAE,QAAQ,CAAC,GAAG,MAAM,KAAK;AACvD,YAAM,QAAQ,MAAM,OAAO,KAAK,QAAQ,QAAQ,OAAO;AACvD,UAAI,MAAM,KAAM,MAAK,OAAO,MAAM;AAClC,aAAO;AAAA,IACT;AAAA,IACA,MAAM,MAAM,QAAQ,SAAS;AAC3B,UAAI,CAAC,KAAK,OAAO,MAAM,EAAG;AAC1B,YAAM,OAAO,MAAM,QAAQ,OAAO;AAAA,IACpC;AAAA,IACA,OAAO;AAAA,EACT;AACF;",
+  "names": []
+}

package/dist/remote/host.js

@@ -159,7 +159,7 @@ function createRemote(host) {
         now(),
         host.limit ?? MAX_QUEUED
       );
-      const id = `s${++serial}`;
+      const id = `s${++serial}-${crypto.randomUUID()}`;
       track(id, stream);
       events.start(async (batch) => onEvents(batch));
       return { id, stream };

package/dist/remote/host.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/remote/host.ts"],
-  "sourcesContent": ["import type { Context } from '@earendil-works/chord';\nimport { BACKGROUND_CONTEXT, withCancel } from '@earendil-works/chord/context';\nimport {\n  type AgentEvent,\n  type AgentEventStream,\n  type Conversation,\n  type EntryRecord,\n  type Harness,\n  type SnapshotEvent,\n  type SubmissionId,\n  watchEvents,\n} from '@earendil-works/pi-durable';\nimport type { Delivered, SendMode, SendRequest, SendResponse } from '../services.ts';\nimport { type EndReason, idOf, Mapper, type RemoteEvent, replayOf } from './events.ts';\n\nexport const MAX_QUEUED = 10000;\nexport const IDLE_MS = 120000;\n\nexport type RemoteOpened =\n  | { ok: true; stream: string; delivered: Delivered | null; head: string | null; gap: boolean }\n  | { ok: false; code: string; message: string };\n\nexport interface RemoteBatch {\n  events: RemoteEvent[];\n  done: boolean;\n}\n\nexport interface AgentRemote {\n  prompt(\n    request: { agentId: string | null; text: string; whenBusy: SendMode; thinking: boolean },\n    context: Context\n  ): Promise<RemoteOpened>;\n  watch(\n    request: { agentId: string | null; since: string | null; thinking: boolean },\n    context: Context\n  ): Promise<RemoteOpened>;\n  next(stream: string, waitMs: number, context: Context): Promise<RemoteBatch>;\n  close(stream: string, context: Context): Promise<void>;\n  abort(agentId: string | null, context: Context): Promise<{ aborted: boolean }>;\n}\n\nexport interface RemoteHost {\n  harness: Harness;\n  conversation(agentId: string | null, context: Context): Promise<Conversation>;\n  send(request: SendRequest, context: Context): Promise<SendResponse>;\n  now?: () => number;\n  limit?: number;\n  sweepMs?: number;\n}\n\nclass Stream {\n  readonly queue: RemoteEvent[] = [];\n  done = false;\n  touched: number;\n  #wake: (() => void) | undefined;\n  readonly #stop: () => Promise<unknown>;\n  readonly #limit: number;\n\n  constructor(stop: () => Promise<unknown>, now: number, limit: number) {\n    this.#stop = stop;\n    this.touched = now;\n    this.#limit = limit;\n  }\n\n  push(events: readonly RemoteEvent[]): void {\n    if (this.done || !events.length) return;\n    this.queue.push(...events);\n    if (this.queue.length > this.#limit) {\n      this.queue.length = 0;\n      this.queue.push({ t: 'end', reason: 'error', message: 'the stream fell too far behind' });\n      void this.finish();\n    }\n    this.#wake?.();\n  }\n\n  async finish(): Promise<void> {\n    if (this.done) return;\n    this.done = true;\n    this.#wake?.();\n    await this.#stop().catch(() => undefined);\n  }\n\n  wait(ms: number): Promise<void> {\n    if (this.queue.length || this.done) return Promise.resolve();\n    return new Promise((resolve) => {\n      const timer = setTimeout(done, ms);\n      function done() {\n        clearTimeout(timer);\n        resolve();\n      }\n      this.#wake = () => {\n        this.#wake = undefined;\n        done();\n      };\n    });\n  }\n}\n\nfunction deliveredOf(\n  status: { status: string } | undefined,\n  whenBusy: SendMode,\n  busy: boolean\n): Delivered {\n  if (status?.status === 'queued') return whenBusy === 'followUp' ? 'follow-up' : 'steer';\n  return busy ? 'steer' : 'run';\n}\n\nfunction headOf(events: readonly RemoteEvent[]): string | null {\n  for (let at = events.length - 1; at >= 0; at--) {\n    const id = idOf(events[at] as RemoteEvent);\n    if (id) return id;\n  }\n  return null;\n}\n\nexport function followed(mapper: Mapper, event: AgentEvent): RemoteEvent[] {\n  return event.type === 'snapshot' ? resync(mapper, event) : mapper.event(event);\n}\n\nexport function resync(mapper: Mapper, snapshot: SnapshotEvent): RemoteEvent[] {\n  const last = mapper.last();\n  return [\n    ...snapshot.entries.filter((entry) => entry.id > last).flatMap((entry) => mapper.entry(entry)),\n    ...mapper.partial(snapshot.generation?.message as never),\n  ];\n}\n\nfunction placedEntry(value: unknown): number | undefined {\n  const entry = (value as { entry?: unknown } | undefined)?.entry;\n  return typeof entry === 'number' ? entry : undefined;\n}\n\nexport class Follower {\n  readonly #mapper: Mapper;\n  readonly #entries: Map<number, EntryRecord>;\n  readonly #submission: SubmissionId;\n  readonly #delivered: Delivered;\n  readonly #out: RemoteEvent[] = [];\n  #user: number | undefined;\n  #started = false;\n\n  constructor(\n    mapper: Mapper,\n    entries: readonly EntryRecord[],\n    submission: SubmissionId,\n    delivered: Delivered,\n    record: unknown\n  ) {\n    this.#mapper = mapper;\n    this.#entries = new Map(entries.map((entry) => [entry.id, entry]));\n    this.#submission = submission;\n    this.#delivered = delivered;\n    this.#user = placedEntry(record);\n  }\n\n  drain(): RemoteEvent[] {\n    return this.#out.splice(0);\n  }\n\n  #begin(): void {\n    const entry = this.#user === undefined ? undefined : this.#entries.get(this.#user);\n    if (!entry) return;\n    this.#started = true;\n    this.#out.push(...this.#mapper.entry(entry, this.#delivered));\n  }\n\n  #end(reason: EndReason, message?: string): true {\n    this.#out.push({ t: 'end', reason, ...(message ? { message } : {}) });\n    return true;\n  }\n\n  #ours(event: AgentEvent): boolean {\n    if (event.type !== 'submission' || event.record.id !== this.#submission) return false;\n    this.#user = placedEntry(event.record) ?? this.#user;\n    return this.#user === undefined && !['queued', 'placed'].includes(event.record.status);\n  }\n\n  take(batch: readonly AgentEvent[]): boolean {\n    for (const event of batch) {\n      if (event.type === 'message_end') this.#entries.set(event.entry.id, event.entry);\n      if (this.#ours(event)) return this.#end('aborted');\n      if (!this.#started) {\n        this.#begin();\n        continue;\n      }\n      const mapped = this.#mapper.event(event).filter((item) => item.t !== 'user');\n      this.#out.push(...mapped);\n      if (mapped.some((item) => item.t === 'run' && item.state === 'end'))\n        return this.#end(this.#mapper.reason, this.#mapper.error);\n    }\n    return false;\n  }\n}\n\nexport function createRemote(host: RemoteHost): AgentRemote & { dispose(): Promise<void> } {\n  const now = host.now ?? Date.now;\n  const streams = new Map<string, Stream>();\n  let serial = 0;\n  let timer: ReturnType<typeof setInterval> | undefined;\n  const sweep = () => {\n    for (const [id, stream] of streams)\n      if (now() - stream.touched > IDLE_MS) {\n        streams.delete(id);\n        void stream.finish();\n      }\n    if (!streams.size && timer !== undefined) {\n      clearInterval(timer);\n      timer = undefined;\n    }\n  };\n  const track = (id: string, stream: Stream) => {\n    streams.set(id, stream);\n    timer ??= setInterval(sweep, host.sweepMs ?? IDLE_MS / 4);\n  };\n  const watching = async (agentId: string | null, context: Context) => {\n    const conversation = await host.conversation(agentId, context);\n    const cancel = withCancel(BACKGROUND_CONTEXT);\n    const events: AgentEventStream = await watchEvents(\n      host.harness,\n      conversation.id,\n      cancel.context\n    );\n    const open = (onEvents: (batch: readonly AgentEvent[]) => void) => {\n      const stream = new Stream(\n        async () => {\n          await events.stop();\n          cancel.cancel();\n        },\n        now(),\n        host.limit ?? MAX_QUEUED\n      );\n      const id = `s${++serial}`;\n      track(id, stream);\n      events.start(async (batch) => onEvents(batch));\n      return { id, stream };\n    };\n    return { conversation, snapshot: events.snapshot, open, stop: () => events.stop() };\n  };\n  return {\n    async prompt(request, context) {\n      sweep();\n      const watched = await watching(request.agentId, context);\n      const busy = Boolean(watched.snapshot.run);\n      const response = await host.send(\n        {\n          text: request.text,\n          whenBusy: request.whenBusy,\n          requestId: null,\n          ...(request.agentId ? { agentId: request.agentId } : {}),\n        },\n        context\n      );\n      if (!response.accepted) {\n        await watched.stop();\n        return {\n          ok: false,\n          code: response.error.code === 'busy' ? 'EBUSY' : 'EIO',\n          message: response.error.message,\n        };\n      }\n      const submission = Number(response.submissionId) as SubmissionId;\n      const record = await (await host.harness.submission(submission, context))?.status(context);\n      const delivered = deliveredOf(record, request.whenBusy, busy);\n      const follower = new Follower(\n        new Mapper(request.thinking),\n        watched.snapshot.entries,\n        submission,\n        delivered,\n        record\n      );\n      const { id, stream } = watched.open((batch) => {\n        const ended = follower.take(batch);\n        stream.push(follower.drain());\n        if (ended) void stream.finish();\n      });\n      return { ok: true, stream: id, delivered, head: null, gap: false };\n    },\n    async watch(request, context) {\n      sweep();\n      const watched = await watching(request.agentId, context);\n      const partial = watched.snapshot.generation?.message as never;\n      const all = replayOf(watched.snapshot.entries, partial, request.thinking);\n      const head = headOf(all);\n      const at = request.since === null ? -1 : all.findIndex((e) => idOf(e) === request.since);\n      const gap = request.since !== null && at < 0;\n      const mapper = new Mapper(request.thinking);\n      for (const entry of watched.snapshot.entries) mapper.entry(entry);\n      mapper.partial(partial);\n      const { id, stream } = watched.open((batch) =>\n        stream.push(batch.flatMap((event) => followed(mapper, event)))\n      );\n      if (at >= 0) {\n        const own = all[at] as RemoteEvent;\n        const sinceId = idOf(own);\n        let last = at;\n        while (last + 1 < all.length && idOf(all[last + 1] as RemoteEvent) === sinceId) last++;\n        const replay = own.t === 'text' || own.t === 'thinking' ? [own] : [];\n        stream.push([...replay, ...all.slice(last + 1)]);\n      }\n      return { ok: true, stream: id, delivered: null, head, gap };\n    },\n    async next(id, waitMs, context) {\n      const stream = streams.get(id);\n      if (!stream) return { events: [], done: true };\n      stream.touched = now();\n      await stream.wait(Math.max(0, Math.min(waitMs, 30000)));\n      context.abortSignal?.throwIfAborted();\n      const events = stream.queue.splice(0);\n      const done = stream.done && stream.queue.length === 0;\n      if (done) streams.delete(id);\n      return { events, done };\n    },\n    async close(id) {\n      const stream = streams.get(id);\n      streams.delete(id);\n      await stream?.finish();\n    },\n    async abort(agentId, context) {\n      const conversation = await host.conversation(agentId, context);\n      const watched = await watchEvents(host.harness, conversation.id, context);\n      const busy = Boolean(watched.snapshot.run);\n      await watched.stop();\n      if (busy) await conversation.abort(context);\n      return { aborted: busy };\n    },\n    async dispose() {\n      clearInterval(timer);\n      timer = undefined;\n      const all = [...streams.values()];\n      streams.clear();\n      await Promise.all(all.map((stream) => stream.finish()));\n    },\n  };\n}\n"],
-  "mappings": "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",
+  "sourcesContent": ["import type { Context } from '@earendil-works/chord';\nimport { BACKGROUND_CONTEXT, withCancel } from '@earendil-works/chord/context';\nimport {\n  type AgentEvent,\n  type AgentEventStream,\n  type Conversation,\n  type EntryRecord,\n  type Harness,\n  type SnapshotEvent,\n  type SubmissionId,\n  watchEvents,\n} from '@earendil-works/pi-durable';\nimport type { Delivered, SendMode, SendRequest, SendResponse } from '../services.ts';\nimport { type EndReason, idOf, Mapper, type RemoteEvent, replayOf } from './events.ts';\n\nexport const MAX_QUEUED = 10000;\nexport const IDLE_MS = 120000;\n\nexport type RemoteOpened =\n  | { ok: true; stream: string; delivered: Delivered | null; head: string | null; gap: boolean }\n  | { ok: false; code: string; message: string };\n\nexport interface RemoteBatch {\n  events: RemoteEvent[];\n  done: boolean;\n}\n\nexport interface AgentRemote {\n  prompt(\n    request: { agentId: string | null; text: string; whenBusy: SendMode; thinking: boolean },\n    context: Context\n  ): Promise<RemoteOpened>;\n  watch(\n    request: { agentId: string | null; since: string | null; thinking: boolean },\n    context: Context\n  ): Promise<RemoteOpened>;\n  next(stream: string, waitMs: number, context: Context): Promise<RemoteBatch>;\n  close(stream: string, context: Context): Promise<void>;\n  abort(agentId: string | null, context: Context): Promise<{ aborted: boolean }>;\n}\n\nexport interface RemoteHost {\n  harness: Harness;\n  conversation(agentId: string | null, context: Context): Promise<Conversation>;\n  send(request: SendRequest, context: Context): Promise<SendResponse>;\n  now?: () => number;\n  limit?: number;\n  sweepMs?: number;\n}\n\nclass Stream {\n  readonly queue: RemoteEvent[] = [];\n  done = false;\n  touched: number;\n  #wake: (() => void) | undefined;\n  readonly #stop: () => Promise<unknown>;\n  readonly #limit: number;\n\n  constructor(stop: () => Promise<unknown>, now: number, limit: number) {\n    this.#stop = stop;\n    this.touched = now;\n    this.#limit = limit;\n  }\n\n  push(events: readonly RemoteEvent[]): void {\n    if (this.done || !events.length) return;\n    this.queue.push(...events);\n    if (this.queue.length > this.#limit) {\n      this.queue.length = 0;\n      this.queue.push({ t: 'end', reason: 'error', message: 'the stream fell too far behind' });\n      void this.finish();\n    }\n    this.#wake?.();\n  }\n\n  async finish(): Promise<void> {\n    if (this.done) return;\n    this.done = true;\n    this.#wake?.();\n    await this.#stop().catch(() => undefined);\n  }\n\n  wait(ms: number): Promise<void> {\n    if (this.queue.length || this.done) return Promise.resolve();\n    return new Promise((resolve) => {\n      const timer = setTimeout(done, ms);\n      function done() {\n        clearTimeout(timer);\n        resolve();\n      }\n      this.#wake = () => {\n        this.#wake = undefined;\n        done();\n      };\n    });\n  }\n}\n\nfunction deliveredOf(\n  status: { status: string } | undefined,\n  whenBusy: SendMode,\n  busy: boolean\n): Delivered {\n  if (status?.status === 'queued') return whenBusy === 'followUp' ? 'follow-up' : 'steer';\n  return busy ? 'steer' : 'run';\n}\n\nfunction headOf(events: readonly RemoteEvent[]): string | null {\n  for (let at = events.length - 1; at >= 0; at--) {\n    const id = idOf(events[at] as RemoteEvent);\n    if (id) return id;\n  }\n  return null;\n}\n\nexport function followed(mapper: Mapper, event: AgentEvent): RemoteEvent[] {\n  return event.type === 'snapshot' ? resync(mapper, event) : mapper.event(event);\n}\n\nexport function resync(mapper: Mapper, snapshot: SnapshotEvent): RemoteEvent[] {\n  const last = mapper.last();\n  return [\n    ...snapshot.entries.filter((entry) => entry.id > last).flatMap((entry) => mapper.entry(entry)),\n    ...mapper.partial(snapshot.generation?.message as never),\n  ];\n}\n\nfunction placedEntry(value: unknown): number | undefined {\n  const entry = (value as { entry?: unknown } | undefined)?.entry;\n  return typeof entry === 'number' ? entry : undefined;\n}\n\nexport class Follower {\n  readonly #mapper: Mapper;\n  readonly #entries: Map<number, EntryRecord>;\n  readonly #submission: SubmissionId;\n  readonly #delivered: Delivered;\n  readonly #out: RemoteEvent[] = [];\n  #user: number | undefined;\n  #started = false;\n\n  constructor(\n    mapper: Mapper,\n    entries: readonly EntryRecord[],\n    submission: SubmissionId,\n    delivered: Delivered,\n    record: unknown\n  ) {\n    this.#mapper = mapper;\n    this.#entries = new Map(entries.map((entry) => [entry.id, entry]));\n    this.#submission = submission;\n    this.#delivered = delivered;\n    this.#user = placedEntry(record);\n  }\n\n  drain(): RemoteEvent[] {\n    return this.#out.splice(0);\n  }\n\n  #begin(): void {\n    const entry = this.#user === undefined ? undefined : this.#entries.get(this.#user);\n    if (!entry) return;\n    this.#started = true;\n    this.#out.push(...this.#mapper.entry(entry, this.#delivered));\n  }\n\n  #end(reason: EndReason, message?: string): true {\n    this.#out.push({ t: 'end', reason, ...(message ? { message } : {}) });\n    return true;\n  }\n\n  #ours(event: AgentEvent): boolean {\n    if (event.type !== 'submission' || event.record.id !== this.#submission) return false;\n    this.#user = placedEntry(event.record) ?? this.#user;\n    return this.#user === undefined && !['queued', 'placed'].includes(event.record.status);\n  }\n\n  take(batch: readonly AgentEvent[]): boolean {\n    for (const event of batch) {\n      if (event.type === 'message_end') this.#entries.set(event.entry.id, event.entry);\n      if (this.#ours(event)) return this.#end('aborted');\n      if (!this.#started) {\n        this.#begin();\n        continue;\n      }\n      const mapped = this.#mapper.event(event).filter((item) => item.t !== 'user');\n      this.#out.push(...mapped);\n      if (mapped.some((item) => item.t === 'run' && item.state === 'end'))\n        return this.#end(this.#mapper.reason, this.#mapper.error);\n    }\n    return false;\n  }\n}\n\nexport function createRemote(host: RemoteHost): AgentRemote & { dispose(): Promise<void> } {\n  const now = host.now ?? Date.now;\n  const streams = new Map<string, Stream>();\n  let serial = 0;\n  let timer: ReturnType<typeof setInterval> | undefined;\n  const sweep = () => {\n    for (const [id, stream] of streams)\n      if (now() - stream.touched > IDLE_MS) {\n        streams.delete(id);\n        void stream.finish();\n      }\n    if (!streams.size && timer !== undefined) {\n      clearInterval(timer);\n      timer = undefined;\n    }\n  };\n  const track = (id: string, stream: Stream) => {\n    streams.set(id, stream);\n    timer ??= setInterval(sweep, host.sweepMs ?? IDLE_MS / 4);\n  };\n  const watching = async (agentId: string | null, context: Context) => {\n    const conversation = await host.conversation(agentId, context);\n    const cancel = withCancel(BACKGROUND_CONTEXT);\n    const events: AgentEventStream = await watchEvents(\n      host.harness,\n      conversation.id,\n      cancel.context\n    );\n    const open = (onEvents: (batch: readonly AgentEvent[]) => void) => {\n      const stream = new Stream(\n        async () => {\n          await events.stop();\n          cancel.cancel();\n        },\n        now(),\n        host.limit ?? MAX_QUEUED\n      );\n      const id = `s${++serial}-${crypto.randomUUID()}`;\n      track(id, stream);\n      events.start(async (batch) => onEvents(batch));\n      return { id, stream };\n    };\n    return { conversation, snapshot: events.snapshot, open, stop: () => events.stop() };\n  };\n  return {\n    async prompt(request, context) {\n      sweep();\n      const watched = await watching(request.agentId, context);\n      const busy = Boolean(watched.snapshot.run);\n      const response = await host.send(\n        {\n          text: request.text,\n          whenBusy: request.whenBusy,\n          requestId: null,\n          ...(request.agentId ? { agentId: request.agentId } : {}),\n        },\n        context\n      );\n      if (!response.accepted) {\n        await watched.stop();\n        return {\n          ok: false,\n          code: response.error.code === 'busy' ? 'EBUSY' : 'EIO',\n          message: response.error.message,\n        };\n      }\n      const submission = Number(response.submissionId) as SubmissionId;\n      const record = await (await host.harness.submission(submission, context))?.status(context);\n      const delivered = deliveredOf(record, request.whenBusy, busy);\n      const follower = new Follower(\n        new Mapper(request.thinking),\n        watched.snapshot.entries,\n        submission,\n        delivered,\n        record\n      );\n      const { id, stream } = watched.open((batch) => {\n        const ended = follower.take(batch);\n        stream.push(follower.drain());\n        if (ended) void stream.finish();\n      });\n      return { ok: true, stream: id, delivered, head: null, gap: false };\n    },\n    async watch(request, context) {\n      sweep();\n      const watched = await watching(request.agentId, context);\n      const partial = watched.snapshot.generation?.message as never;\n      const all = replayOf(watched.snapshot.entries, partial, request.thinking);\n      const head = headOf(all);\n      const at = request.since === null ? -1 : all.findIndex((e) => idOf(e) === request.since);\n      const gap = request.since !== null && at < 0;\n      const mapper = new Mapper(request.thinking);\n      for (const entry of watched.snapshot.entries) mapper.entry(entry);\n      mapper.partial(partial);\n      const { id, stream } = watched.open((batch) =>\n        stream.push(batch.flatMap((event) => followed(mapper, event)))\n      );\n      if (at >= 0) {\n        const own = all[at] as RemoteEvent;\n        const sinceId = idOf(own);\n        let last = at;\n        while (last + 1 < all.length && idOf(all[last + 1] as RemoteEvent) === sinceId) last++;\n        const replay = own.t === 'text' || own.t === 'thinking' ? [own] : [];\n        stream.push([...replay, ...all.slice(last + 1)]);\n      }\n      return { ok: true, stream: id, delivered: null, head, gap };\n    },\n    async next(id, waitMs, context) {\n      const stream = streams.get(id);\n      if (!stream) return { events: [], done: true };\n      stream.touched = now();\n      await stream.wait(Math.max(0, Math.min(waitMs, 30000)));\n      context.abortSignal?.throwIfAborted();\n      const events = stream.queue.splice(0);\n      const done = stream.done && stream.queue.length === 0;\n      if (done) streams.delete(id);\n      return { events, done };\n    },\n    async close(id) {\n      const stream = streams.get(id);\n      streams.delete(id);\n      await stream?.finish();\n    },\n    async abort(agentId, context) {\n      const conversation = await host.conversation(agentId, context);\n      const watched = await watchEvents(host.harness, conversation.id, context);\n      const busy = Boolean(watched.snapshot.run);\n      await watched.stop();\n      if (busy) await conversation.abort(context);\n      return { aborted: busy };\n    },\n    async dispose() {\n      clearInterval(timer);\n      timer = undefined;\n      const all = [...streams.values()];\n      streams.clear();\n      await Promise.all(all.map((stream) => stream.finish()));\n    },\n  };\n}\n"],
+  "mappings": "AACA,SAAS,oBAAoB,kBAAkB;AAC/C;AAAA,EAQE;AAAA,OACK;AAEP,SAAyB,MAAM,QAA0B,gBAAgB;AAElE,MAAM,aAAa;AACnB,MAAM,UAAU;AAkCvB,MAAM,OAAO;AAAA,EACF,QAAuB,CAAC;AAAA,EACjC,OAAO;AAAA,EACP;AAAA,EACA;AAAA,EACS;AAAA,EACA;AAAA,EAET,YAAY,MAA8B,KAAa,OAAe;AACpE,SAAK,QAAQ;AACb,SAAK,UAAU;AACf,SAAK,SAAS;AAAA,EAChB;AAAA,EAEA,KAAK,QAAsC;AACzC,QAAI,KAAK,QAAQ,CAAC,OAAO,OAAQ;AACjC,SAAK,MAAM,KAAK,GAAG,MAAM;AACzB,QAAI,KAAK,MAAM,SAAS,KAAK,QAAQ;AACnC,WAAK,MAAM,SAAS;AACpB,WAAK,MAAM,KAAK,EAAE,GAAG,OAAO,QAAQ,SAAS,SAAS,iCAAiC,CAAC;AACxF,WAAK,KAAK,OAAO;AAAA,IACnB;AACA,SAAK,QAAQ;AAAA,EACf;AAAA,EAEA,MAAM,SAAwB;AAC5B,QAAI,KAAK,KAAM;AACf,SAAK,OAAO;AACZ,SAAK,QAAQ;AACb,UAAM,KAAK,MAAM,EAAE,MAAM,MAAM,MAAS;AAAA,EAC1C;AAAA,EAEA,KAAK,IAA2B;AAC9B,QAAI,KAAK,MAAM,UAAU,KAAK,KAAM,QAAO,QAAQ,QAAQ;AAC3D,WAAO,IAAI,QAAQ,CAAC,YAAY;AAC9B,YAAM,QAAQ,WAAW,MAAM,EAAE;AACjC,eAAS,OAAO;AACd,qBAAa,KAAK;AAClB,gBAAQ;AAAA,MACV;AACA,WAAK,QAAQ,MAAM;AACjB,aAAK,QAAQ;AACb,aAAK;AAAA,MACP;AAAA,IACF,CAAC;AAAA,EACH;AACF;AAEA,SAAS,YACP,QACA,UACA,MACW;AACX,MAAI,QAAQ,WAAW,SAAU,QAAO,aAAa,aAAa,cAAc;AAChF,SAAO,OAAO,UAAU;AAC1B;AAEA,SAAS,OAAO,QAA+C;AAC7D,WAAS,KAAK,OAAO,SAAS,GAAG,MAAM,GAAG,MAAM;AAC9C,UAAM,KAAK,KAAK,OAAO,EAAE,CAAgB;AACzC,QAAI,GAAI,QAAO;AAAA,EACjB;AACA,SAAO;AACT;AAEO,SAAS,SAAS,QAAgB,OAAkC;AACzE,SAAO,MAAM,SAAS,aAAa,OAAO,QAAQ,KAAK,IAAI,OAAO,MAAM,KAAK;AAC/E;AAEO,SAAS,OAAO,QAAgB,UAAwC;AAC7E,QAAM,OAAO,OAAO,KAAK;AACzB,SAAO;AAAA,IACL,GAAG,SAAS,QAAQ,OAAO,CAAC,UAAU,MAAM,KAAK,IAAI,EAAE,QAAQ,CAAC,UAAU,OAAO,MAAM,KAAK,CAAC;AAAA,IAC7F,GAAG,OAAO,QAAQ,SAAS,YAAY,OAAgB;AAAA,EACzD;AACF;AAEA,SAAS,YAAY,OAAoC;AACvD,QAAM,QAAS,OAA2C;AAC1D,SAAO,OAAO,UAAU,WAAW,QAAQ;AAC7C;AAEO,MAAM,SAAS;AAAA,EACX;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA,OAAsB,CAAC;AAAA,EAChC;AAAA,EACA,WAAW;AAAA,EAEX,YACE,QACA,SACA,YACA,WACA,QACA;AACA,SAAK,UAAU;AACf,SAAK,WAAW,IAAI,IAAI,QAAQ,IAAI,CAAC,UAAU,CAAC,MAAM,IAAI,KAAK,CAAC,CAAC;AACjE,SAAK,cAAc;AACnB,SAAK,aAAa;AAClB,SAAK,QAAQ,YAAY,MAAM;AAAA,EACjC;AAAA,EAEA,QAAuB;AACrB,WAAO,KAAK,KAAK,OAAO,CAAC;AAAA,EAC3B;AAAA,EAEA,SAAe;AACb,UAAM,QAAQ,KAAK,UAAU,SAAY,SAAY,KAAK,SAAS,IAAI,KAAK,KAAK;AACjF,QAAI,CAAC,MAAO;AACZ,SAAK,WAAW;AAChB,SAAK,KAAK,KAAK,GAAG,KAAK,QAAQ,MAAM,OAAO,KAAK,UAAU,CAAC;AAAA,EAC9D;AAAA,EAEA,KAAK,QAAmB,SAAwB;AAC9C,SAAK,KAAK,KAAK,EAAE,GAAG,OAAO,QAAQ,GAAI,UAAU,EAAE,QAAQ,IAAI,CAAC,EAAG,CAAC;AACpE,WAAO;AAAA,EACT;AAAA,EAEA,MAAM,OAA4B;AAChC,QAAI,MAAM,SAAS,gBAAgB,MAAM,OAAO,OAAO,KAAK,YAAa,QAAO;AAChF,SAAK,QAAQ,YAAY,MAAM,MAAM,KAAK,KAAK;AAC/C,WAAO,KAAK,UAAU,UAAa,CAAC,CAAC,UAAU,QAAQ,EAAE,SAAS,MAAM,OAAO,MAAM;AAAA,EACvF;AAAA,EAEA,KAAK,OAAuC;AAC1C,eAAW,SAAS,OAAO;AACzB,UAAI,MAAM,SAAS,cAAe,MAAK,SAAS,IAAI,MAAM,MAAM,IAAI,MAAM,KAAK;AAC/E,UAAI,KAAK,MAAM,KAAK,EAAG,QAAO,KAAK,KAAK,SAAS;AACjD,UAAI,CAAC,KAAK,UAAU;AAClB,aAAK,OAAO;AACZ;AAAA,MACF;AACA,YAAM,SAAS,KAAK,QAAQ,MAAM,KAAK,EAAE,OAAO,CAAC,SAAS,KAAK,MAAM,MAAM;AAC3E,WAAK,KAAK,KAAK,GAAG,MAAM;AACxB,UAAI,OAAO,KAAK,CAAC,SAAS,KAAK,MAAM,SAAS,KAAK,UAAU,KAAK;AAChE,eAAO,KAAK,KAAK,KAAK,QAAQ,QAAQ,KAAK,QAAQ,KAAK;AAAA,IAC5D;AACA,WAAO;AAAA,EACT;AACF;AAEO,SAAS,aAAa,MAA8D;AACzF,QAAM,MAAM,KAAK,OAAO,KAAK;AAC7B,QAAM,UAAU,oBAAI,IAAoB;AACxC,MAAI,SAAS;AACb,MAAI;AACJ,QAAM,QAAQ,MAAM;AAClB,eAAW,CAAC,IAAI,MAAM,KAAK;AACzB,UAAI,IAAI,IAAI,OAAO,UAAU,SAAS;AACpC,gBAAQ,OAAO,EAAE;AACjB,aAAK,OAAO,OAAO;AAAA,MACrB;AACF,QAAI,CAAC,QAAQ,QAAQ,UAAU,QAAW;AACxC,oBAAc,KAAK;AACnB,cAAQ;AAAA,IACV;AAAA,EACF;AACA,QAAM,QAAQ,CAAC,IAAY,WAAmB;AAC5C,YAAQ,IAAI,IAAI,MAAM;AACtB,cAAU,YAAY,OAAO,KAAK,WAAW,UAAU,CAAC;AAAA,EAC1D;AACA,QAAM,WAAW,OAAO,SAAwB,YAAqB;AACnE,UAAM,eAAe,MAAM,KAAK,aAAa,SAAS,OAAO;AAC7D,UAAM,SAAS,WAAW,kBAAkB;AAC5C,UAAM,SAA2B,MAAM;AAAA,MACrC,KAAK;AAAA,MACL,aAAa;AAAA,MACb,OAAO;AAAA,IACT;AACA,UAAM,OAAO,CAAC,aAAqD;AACjE,YAAM,SAAS,IAAI;AAAA,QACjB,YAAY;AACV,gBAAM,OAAO,KAAK;AAClB,iBAAO,OAAO;AAAA,QAChB;AAAA,QACA,IAAI;AAAA,QACJ,KAAK,SAAS;AAAA,MAChB;AACA,YAAM,KAAK,IAAI,EAAE,MAAM,IAAI,OAAO,WAAW,CAAC;AAC9C,YAAM,IAAI,MAAM;AAChB,aAAO,MAAM,OAAO,UAAU,SAAS,KAAK,CAAC;AAC7C,aAAO,EAAE,IAAI,OAAO;AAAA,IACtB;AACA,WAAO,EAAE,cAAc,UAAU,OAAO,UAAU,MAAM,MAAM,MAAM,OAAO,KAAK,EAAE;AAAA,EACpF;AACA,SAAO;AAAA,IACL,MAAM,OAAO,SAAS,SAAS;AAC7B,YAAM;AACN,YAAM,UAAU,MAAM,SAAS,QAAQ,SAAS,OAAO;AACvD,YAAM,OAAO,QAAQ,QAAQ,SAAS,GAAG;AACzC,YAAM,WAAW,MAAM,KAAK;AAAA,QAC1B;AAAA,UACE,MAAM,QAAQ;AAAA,UACd,UAAU,QAAQ;AAAA,UAClB,WAAW;AAAA,UACX,GAAI,QAAQ,UAAU,EAAE,SAAS,QAAQ,QAAQ,IAAI,CAAC;AAAA,QACxD;AAAA,QACA;AAAA,MACF;AACA,UAAI,CAAC,SAAS,UAAU;AACtB,cAAM,QAAQ,KAAK;AACnB,eAAO;AAAA,UACL,IAAI;AAAA,UACJ,MAAM,SAAS,MAAM,SAAS,SAAS,UAAU;AAAA,UACjD,SAAS,SAAS,MAAM;AAAA,QAC1B;AAAA,MACF;AACA,YAAM,aAAa,OAAO,SAAS,YAAY;AAC/C,YAAM,SAAS,OAAO,MAAM,KAAK,QAAQ,WAAW,YAAY,OAAO,IAAI,OAAO,OAAO;AACzF,YAAM,YAAY,YAAY,QAAQ,QAAQ,UAAU,IAAI;AAC5D,YAAM,WAAW,IAAI;AAAA,QACnB,IAAI,OAAO,QAAQ,QAAQ;AAAA,QAC3B,QAAQ,SAAS;AAAA,QACjB;AAAA,QACA;AAAA,QACA;AAAA,MACF;AACA,YAAM,EAAE,IAAI,OAAO,IAAI,QAAQ,KAAK,CAAC,UAAU;AAC7C,cAAM,QAAQ,SAAS,KAAK,KAAK;AACjC,eAAO,KAAK,SAAS,MAAM,CAAC;AAC5B,YAAI,MAAO,MAAK,OAAO,OAAO;AAAA,MAChC,CAAC;AACD,aAAO,EAAE,IAAI,MAAM,QAAQ,IAAI,WAAW,MAAM,MAAM,KAAK,MAAM;AAAA,IACnE;AAAA,IACA,MAAM,MAAM,SAAS,SAAS;AAC5B,YAAM;AACN,YAAM,UAAU,MAAM,SAAS,QAAQ,SAAS,OAAO;AACvD,YAAM,UAAU,QAAQ,SAAS,YAAY;AAC7C,YAAM,MAAM,SAAS,QAAQ,SAAS,SAAS,SAAS,QAAQ,QAAQ;AACxE,YAAM,OAAO,OAAO,GAAG;AACvB,YAAM,KAAK,QAAQ,UAAU,OAAO,KAAK,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,MAAM,QAAQ,KAAK;AACvF,YAAM,MAAM,QAAQ,UAAU,QAAQ,KAAK;AAC3C,YAAM,SAAS,IAAI,OAAO,QAAQ,QAAQ;AAC1C,iBAAW,SAAS,QAAQ,SAAS,QAAS,QAAO,MAAM,KAAK;AAChE,aAAO,QAAQ,OAAO;AACtB,YAAM,EAAE,IAAI,OAAO,IAAI,QAAQ;AAAA,QAAK,CAAC,UACnC,OAAO,KAAK,MAAM,QAAQ,CAAC,UAAU,SAAS,QAAQ,KAAK,CAAC,CAAC;AAAA,MAC/D;AACA,UAAI,MAAM,GAAG;AACX,cAAM,MAAM,IAAI,EAAE;AAClB,cAAM,UAAU,KAAK,GAAG;AACxB,YAAI,OAAO;AACX,eAAO,OAAO,IAAI,IAAI,UAAU,KAAK,IAAI,OAAO,CAAC,CAAgB,MAAM,QAAS;AAChF,cAAM,SAAS,IAAI,MAAM,UAAU,IAAI,MAAM,aAAa,CAAC,GAAG,IAAI,CAAC;AACnE,eAAO,KAAK,CAAC,GAAG,QAAQ,GAAG,IAAI,MAAM,OAAO,CAAC,CAAC,CAAC;AAAA,MACjD;AACA,aAAO,EAAE,IAAI,MAAM,QAAQ,IAAI,WAAW,MAAM,MAAM,IAAI;AAAA,IAC5D;AAAA,IACA,MAAM,KAAK,IAAI,QAAQ,SAAS;AAC9B,YAAM,SAAS,QAAQ,IAAI,EAAE;AAC7B,UAAI,CAAC,OAAQ,QAAO,EAAE,QAAQ,CAAC,GAAG,MAAM,KAAK;AAC7C,aAAO,UAAU,IAAI;AACrB,YAAM,OAAO,KAAK,KAAK,IAAI,GAAG,KAAK,IAAI,QAAQ,GAAK,CAAC,CAAC;AACtD,cAAQ,aAAa,eAAe;AACpC,YAAM,SAAS,OAAO,MAAM,OAAO,CAAC;AACpC,YAAM,OAAO,OAAO,QAAQ,OAAO,MAAM,WAAW;AACpD,UAAI,KAAM,SAAQ,OAAO,EAAE;AAC3B,aAAO,EAAE,QAAQ,KAAK;AAAA,IACxB;AAAA,IACA,MAAM,MAAM,IAAI;AACd,YAAM,SAAS,QAAQ,IAAI,EAAE;AAC7B,cAAQ,OAAO,EAAE;AACjB,YAAM,QAAQ,OAAO;AAAA,IACvB;AAAA,IACA,MAAM,MAAM,SAAS,SAAS;AAC5B,YAAM,eAAe,MAAM,KAAK,aAAa,SAAS,OAAO;AAC7D,YAAM,UAAU,MAAM,YAAY,KAAK,SAAS,aAAa,IAAI,OAAO;AACxE,YAAM,OAAO,QAAQ,QAAQ,SAAS,GAAG;AACzC,YAAM,QAAQ,KAAK;AACnB,UAAI,KAAM,OAAM,aAAa,MAAM,OAAO;AAC1C,aAAO,EAAE,SAAS,KAAK;AAAA,IACzB;AAAA,IACA,MAAM,UAAU;AACd,oBAAc,KAAK;AACnB,cAAQ;AACR,YAAM,MAAM,CAAC,GAAG,QAAQ,OAAO,CAAC;AAChC,cAAQ,MAAM;AACd,YAAM,QAAQ,IAAI,IAAI,IAAI,CAAC,WAAW,OAAO,OAAO,CAAC,CAAC;AAAA,IACxD;AAAA,EACF;AACF;",
   "names": []
 }

package/dist/types/host.d.ts

@@ -12,7 +12,9 @@ import type { PortEndpoint } from './wire.ts';
 export interface AgentHost {
     readonly serverId: string;
     readonly agent: Agent;
-    connect(endpoint: PortEndpoint): void;
+    connect(endpoint: PortEndpoint, options?: {
+        readOnly?: boolean;
+    }): void;
     close(): Promise<void>;
 }
 export declare function hostAgent(agent: Agent, options?: {

package/dist/types/link.d.ts

@@ -0,0 +1,17 @@
+import type { Frame, PortEndpoint } from './wire.ts';
+export declare const MAX_FRAME: number;
+export interface ByteSink {
+    write(chunk: Uint8Array): void;
+    close(): void;
+}
+export interface LinkEnd {
+    receive(chunk: Uint8Array): void;
+    end(error?: Error): void;
+}
+export declare function encodeFrame(frame: Frame): Uint8Array;
+export declare class FrameReader {
+    #private;
+    push(chunk: Uint8Array): Frame[];
+}
+export declare function linkEndpoint(sink: ByteSink): PortEndpoint & LinkEnd;
+export declare function bridgePort(port: PortEndpoint, sink: ByteSink): LinkEnd;

package/dist/types/owner.d.ts

@@ -5,9 +5,12 @@ export interface AgentWorker {
     postMessage(message: unknown, transfer: Transferable[]): void;
     terminate(): void;
 }
+export interface PortOptions {
+    readOnly?: boolean;
+}
 export interface AgentOwner {
-    connect(): Promise<AgentConnection>;
-    port(): Promise<Transferable>;
+    connect(options?: PortOptions): Promise<AgentConnection>;
+    port(options?: PortOptions): Promise<PortEndpoint & Transferable>;
     restart(): Promise<void>;
     release(): Promise<void>;
 }

package/dist/types/page.d.ts

@@ -1,3 +1,5 @@
 export { type AgentConnection, connectAgent } from './client.ts';
-export { AGENT_LOCK, type AgentOwner, type AgentWorker, type KernelSource, type OwnerOptions, startAgent, } from './owner.ts';
+export { type ByteSink, bridgePort, encodeFrame, FrameReader, type LinkEnd, linkEndpoint, MAX_FRAME, } from './link.ts';
+export { AGENT_LOCK, type AgentOwner, type AgentWorker, type KernelSource, type OwnerOptions, type PortOptions, startAgent, } from './owner.ts';
 export { type RemoteControl, type RemoteEvent, type RemoteOptions, remoteControl, } from './remote/client.ts';
+export { VIEW_ONLY } from './view-only.ts';

package/dist/types/readonly.d.ts

@@ -0,0 +1,7 @@
+import type { AgentRemote } from './remote/host.ts';
+import type { AgentControl, AgentSettings } from './services.ts';
+import { VIEW_ONLY } from './view-only.ts';
+export { VIEW_ONLY };
+export declare function viewControl(control: AgentControl): AgentControl;
+export declare function viewSettings(settings: AgentSettings): AgentSettings;
+export declare function viewRemote(remote: AgentRemote): AgentRemote;

package/dist/types/view-only.d.ts

@@ -0,0 +1 @@
+export declare const VIEW_ONLY = "this follower can watch, but not send, steer or abort";

package/dist/view-only.js

@@ -0,0 +1,5 @@
+const VIEW_ONLY = "this follower can watch, but not send, steer or abort";
+export {
+  VIEW_ONLY
+};
+//# sourceMappingURL=view-only.js.map

package/dist/view-only.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../src/view-only.ts"],
+  "sourcesContent": ["export const VIEW_ONLY = 'this follower can watch, but not send, steer or abort';\n"],
+  "mappings": "AAAO,MAAM,YAAY;",
+  "names": []
+}

package/dist/worker.js

@@ -1,9 +1,10 @@
 function serveConnections(scope, host) {
   scope.addEventListener("message", ({ data }) => {
-    const port = data?.connect;
+    const message = data;
+    const port = message?.connect;
     if (!port) return;
     host.then(
-      (ready) => ready.connect(port),
+      (ready) => ready.connect(port, { readOnly: message?.readOnly === true }),
       () => port.close?.()
     );
   });

package/dist/worker.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../src/worker.ts"],
-  "sourcesContent": ["import type { AgentHost } from './host.ts';\nimport type { PortEndpoint } from './wire.ts';\n\nexport interface WorkerScope {\n  addEventListener(type: 'message', listener: (event: MessageEvent) => void): void;\n}\n\nexport function serveConnections(scope: WorkerScope, host: Promise<AgentHost>): void {\n  scope.addEventListener('message', ({ data }) => {\n    const port = (data as { connect?: PortEndpoint } | null)?.connect;\n    if (!port) return;\n    host.then(\n      (ready) => ready.connect(port),\n      () => port.close?.()\n    );\n  });\n}\n\nexport function kernelPort(scope: WorkerScope): Promise<MessagePort> {\n  return new Promise((resolve) => {\n    scope.addEventListener('message', ({ data }) => {\n      const port = (data as { kernel?: MessagePort } | null)?.kernel;\n      if (port) resolve(port);\n    });\n  });\n}\n"],
-  "mappings": "AAOO,SAAS,iBAAiB,OAAoB,MAAgC;AACnF,QAAM,iBAAiB,WAAW,CAAC,EAAE,KAAK,MAAM;AAC9C,UAAM,OAAQ,MAA4C;AAC1D,QAAI,CAAC,KAAM;AACX,SAAK;AAAA,MACH,CAAC,UAAU,MAAM,QAAQ,IAAI;AAAA,MAC7B,MAAM,KAAK,QAAQ;AAAA,IACrB;AAAA,EACF,CAAC;AACH;AAEO,SAAS,WAAW,OAA0C;AACnE,SAAO,IAAI,QAAQ,CAAC,YAAY;AAC9B,UAAM,iBAAiB,WAAW,CAAC,EAAE,KAAK,MAAM;AAC9C,YAAM,OAAQ,MAA0C;AACxD,UAAI,KAAM,SAAQ,IAAI;AAAA,IACxB,CAAC;AAAA,EACH,CAAC;AACH;",
+  "sourcesContent": ["import type { AgentHost } from './host.ts';\nimport type { PortEndpoint } from './wire.ts';\n\nexport interface WorkerScope {\n  addEventListener(type: 'message', listener: (event: MessageEvent) => void): void;\n}\n\nexport function serveConnections(scope: WorkerScope, host: Promise<AgentHost>): void {\n  scope.addEventListener('message', ({ data }) => {\n    const message = data as { connect?: PortEndpoint; readOnly?: boolean } | null;\n    const port = message?.connect;\n    if (!port) return;\n    host.then(\n      (ready) => ready.connect(port, { readOnly: message?.readOnly === true }),\n      () => port.close?.()\n    );\n  });\n}\n\nexport function kernelPort(scope: WorkerScope): Promise<MessagePort> {\n  return new Promise((resolve) => {\n    scope.addEventListener('message', ({ data }) => {\n      const port = (data as { kernel?: MessagePort } | null)?.kernel;\n      if (port) resolve(port);\n    });\n  });\n}\n"],
+  "mappings": "AAOO,SAAS,iBAAiB,OAAoB,MAAgC;AACnF,QAAM,iBAAiB,WAAW,CAAC,EAAE,KAAK,MAAM;AAC9C,UAAM,UAAU;AAChB,UAAM,OAAO,SAAS;AACtB,QAAI,CAAC,KAAM;AACX,SAAK;AAAA,MACH,CAAC,UAAU,MAAM,QAAQ,MAAM,EAAE,UAAU,SAAS,aAAa,KAAK,CAAC;AAAA,MACvE,MAAM,KAAK,QAAQ;AAAA,IACrB;AAAA,EACF,CAAC;AACH;AAEO,SAAS,WAAW,OAA0C;AACnE,SAAO,IAAI,QAAQ,CAAC,YAAY;AAC9B,UAAM,iBAAiB,WAAW,CAAC,EAAE,KAAK,MAAM;AAC9C,YAAM,OAAQ,MAA0C;AACxD,UAAI,KAAM,SAAQ,IAAI;AAAA,IACxB,CAAC;AAAA,EACH,CAAC;AACH;",
   "names": []
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ai-ecoverse/slicc-agent",
-  "version": "3.30.0",
+  "version": "3.32.0",
   "description": "SLICC's agent core on pi durable: an agent worker, session storage, remoting and pi extensions",
   "type": "module",
   "license": "Apache-2.0",
@@ -61,12 +61,12 @@
     "release": "semantic-release"
   },
   "devDependencies": {
-    "@ai-ecoverse/slicc-kernel": "1.26.3",
+    "@ai-ecoverse/slicc-kernel": "1.47.1",
     "@ai-ecoverse/slicc-shared-web": "1.12.1",
-    "@ai-ecoverse/slicc-spectrum": "1.48.0",
+    "@ai-ecoverse/slicc-spectrum": "1.50.0",
     "@ai-ecoverse/wasm-bash": "5.3.0-17",
-    "@ai-ecoverse/wasm-coreutils": "9.7.0-3",
-    "@ai-ecoverse/wasm-git": "2.55.0-13",
+    "@ai-ecoverse/wasm-coreutils": "9.12.0-5",
+    "@ai-ecoverse/wasm-git": "2.55.0-15",
     "@biomejs/biome": "2.5.15",
     "@types/node": "24.19.1",
     "esbuild": "0.28.2",
@@ -89,7 +89,7 @@
     "@sqlite.org/sqlite-wasm": "3.53.4-build2"
   },
   "peerDependencies": {
-    "@ai-ecoverse/slicc-kernel": ">=1.26.3 <2",
+    "@ai-ecoverse/slicc-kernel": ">=1.47.1 <2",
     "@ai-ecoverse/slicc-spectrum": "^1.39.0"
   },
   "peerDependenciesMeta": {