@ai-ecoverse/slicc-agent 3.29.1 → 3.31.0

package/README.md

@@ -414,9 +414,21 @@ v6's `open`, `reload`, `close`, `send` and `chat` answer with what to do instead
 
 The built-in `sprinkles` skill teaches the files, the bridge and the command.
 
+### Remote control
+
+`remoteControl(connection, { agent? })` from `@ai-ecoverse/slicc-agent/page` gives a linked CLI's `slicc prompt`, `slicc watch` and `slicc abort` (the `agent` stream of the slicc link protocol, §5.11) as plain objects the page writes to the link as NDJSON. `agent()` names the agent, by default the cone the worker treats as current.
+
+- **`prompt({ text, whenBusy = 'followUp', thinking = false })`** sends the prompt and resolves `{ delivered, events }`. `delivered` is `run`, `steer` or `follow-up`. A `reject` while busy throws an `Error` with `code: 'EBUSY'`, and any other refusal `EIO`. `events` starts at the prompt's own `user` event and ends with `{ t: 'end', reason, message? }` after the run that holds it. Leaving the loop closes the stream but never aborts the run.
+- **`watch({ since, thinking })`** resolves `{ head, gap?, events }`. Without `since` it follows from the next event; with it, it first replays `since`'s own text or thinking whole, then everything after it, or answers `gap: true` when the transcript no longer holds it.
+- **`abort()`** resolves `{ aborted }`, `false` when nothing was running.
+- **Events** are `user`, `text`, `thinking` (only with `thinking`), `tool`, `tool-result`, `run`, `notice` and `error`. They are mapped in the worker from pi-durable's agent events (`watchEvents`: `run_start`/`run_end` with their inputs, message deltas, tool ends, retries, compactions) and polled by the page over the `slicc.agent.remote` service.
+- **Ids:** entry ids for committed entries, `a<timestamp>.<block>` for an assistant message's blocks (stable from the first delta to the committed entry; `~n` when timestamps collide), and unique ids for transient notices.
+- **What leaves the worker:** tool summaries of at most 200 characters (the tool's name and main argument), result summaries (a line count, or an error's first line), secrets redacted; never tool output.
+- **Bounds:** a stream nobody polls for two minutes is dropped, and one more than 10 000 events behind ends with `{ t: 'end', reason: 'error' }`.
+
 ## 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/client.js

@@ -6,6 +6,7 @@ import { Client, createClientServiceTransport } from "@earendil-works/pi-client"
 import {
   AGENT_SESSION,
   AgentControl,
+  AgentRemoteService,
   AgentSessions,
   AgentSettings,
   AgentTranscript
@@ -65,7 +66,7 @@ async function connectAgent(endpoint, options = {}) {
   await server.use(AgentSessions).attach(AGENT_SESSION, context);
   await ready;
   const session = createRemoteServiceBinding({
-    services: [AgentControl, AgentTranscript, AgentSettings],
+    services: [AgentControl, AgentTranscript, AgentSettings, AgentRemoteService],
     transport: createClientServiceTransport(client, () => client.attachment),
     bound: true
   });
@@ -83,6 +84,7 @@ async function connectAgent(endpoint, options = {}) {
     changes
   } = session.use(AgentTranscript);
   const settings = session.use(AgentSettings);
+  const remote = session.use(AgentRemoteService);
   await session.ready(context);
   const held = [];
   const hold = (state) => {
@@ -111,6 +113,7 @@ async function connectAgent(endpoint, options = {}) {
     frozen: hold(frozen),
     changes: hold(changes),
     settings: lastingSettings(settings, hold),
+    remote,
     closed,
     async prompt(text, whenBusy = "followUp") {
       const sent = await control.send({ text, whenBusy, requestId: null }, context);

package/dist/client.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../src/client.ts"],
-  "sourcesContent": ["import {\n  type Context,\n  createRemoteServiceBinding,\n  type ReplicatedState,\n} from '@earendil-works/chord';\nimport { BACKGROUND_CONTEXT } from '@earendil-works/chord/context';\nimport { Client, createClientServiceTransport } from '@earendil-works/pi-client';\nimport type { ConversationView } from '@earendil-works/pi-durable';\nimport type { ChangesView } from './changes/git.ts';\nimport type { FrozenCone } from './freezer/index.ts';\nimport type { MemoryEntry, MemoryScope } from './memory/format.ts';\nimport {\n  AGENT_SESSION,\n  AgentControl,\n  AgentSessions,\n  AgentSettings,\n  type AgentsSummary,\n  AgentTranscript,\n  type Command,\n  type Delivered,\n  type SendMode,\n} from './services.ts';\nimport type { Sprinkle } from './sprinkles/kind.ts';\nimport { PortChannel, type PortEndpoint } from './wire.ts';\n\nexport interface AgentConnection {\n  readonly serverId: string;\n  readonly control: AgentControl;\n  readonly transcript: ReplicatedState<ConversationView>;\n  readonly deliveries: ReplicatedState<Record<string, Delivered>>;\n  readonly agents?: ReplicatedState<AgentsSummary>;\n  readonly views?: ReplicatedState<Record<string, ConversationView>>;\n  readonly commands?: ReplicatedState<Command[]>;\n  readonly sprinkles?: ReplicatedState<Sprinkle[]>;\n  readonly memories?: ReplicatedState<MemoryEntry[]>;\n  readonly memoryScopes?: ReplicatedState<MemoryScope[]>;\n  readonly frozen?: ReplicatedState<FrozenCone[]>;\n  readonly changes?: ReplicatedState<ChangesView>;\n  readonly settings: AgentSettings;\n  readonly closed: Promise<Error | undefined>;\n  prompt(text: string, whenBusy?: SendMode): Promise<string>;\n  close(): Promise<void>;\n}\n\nexport interface Lasting<T> {\n  readonly state: ReplicatedState<T>;\n  freeze(): void;\n}\n\nexport function lasting<T>(state: ReplicatedState<T>): Lasting<T> {\n  let last: T | undefined;\n  let frozen = false;\n  const read = () => {\n    if (frozen) return last;\n    try {\n      last = state.value;\n    } catch {}\n    return last;\n  };\n  return {\n    state: {\n      get value() {\n        return read();\n      },\n      subscribe: (listener) => (frozen ? () => undefined : state.subscribe(listener)),\n    },\n    freeze() {\n      read();\n      frozen = true;\n    },\n  };\n}\n\nfunction lastingSettings(\n  settings: AgentSettings,\n  hold: <T>(state: ReplicatedState<T>) => ReplicatedState<T>\n): AgentSettings {\n  return {\n    state: hold(settings.state),\n    connect: (providerId, secret, region, context) =>\n      settings.connect(providerId, secret, region, context),\n    disconnect: (providerId, context) => settings.disconnect(providerId, context),\n    signIn: (providerId, context) => settings.signIn(providerId, context),\n  };\n}\n\nfunction attached(client: Client): Promise<void> {\n  return new Promise((resolve) => {\n    const stop = client.onAttachmentChange(() => {\n      stop();\n      resolve();\n    });\n  });\n}\n\nexport async function connectAgent(\n  endpoint: PortEndpoint,\n  options: { context?: Context } = {}\n): Promise<AgentConnection> {\n  const context = options.context ?? BACKGROUND_CONTEXT;\n  const channel = new PortChannel(endpoint);\n  const serverId = await channel.hello;\n  const client = await Client.connect({ serverId, transportFactory: channel.transport });\n  const server = createRemoteServiceBinding({\n    services: [AgentSessions],\n    transport: createClientServiceTransport(client, () => ({ serverId })),\n    bound: true,\n  });\n  const ready = attached(client);\n  await server.use(AgentSessions).attach(AGENT_SESSION, context);\n  await ready;\n  const session = createRemoteServiceBinding({\n    services: [AgentControl, AgentTranscript, AgentSettings],\n    transport: createClientServiceTransport(client, () => client.attachment),\n    bound: true,\n  });\n  const control = session.use(AgentControl);\n  const {\n    state: transcript,\n    deliveries,\n    agents,\n    views,\n    commands,\n    sprinkles,\n    memories,\n    memoryScopes,\n    frozen,\n    changes,\n  } = session.use(AgentTranscript);\n  const settings = session.use(AgentSettings);\n  await session.ready(context);\n  const held: Lasting<unknown>[] = [];\n  const hold = <T>(state: ReplicatedState<T>): ReplicatedState<T> => {\n    const kept = lasting(state);\n    held.push(kept as Lasting<unknown>);\n    return kept.state;\n  };\n  const freeze = () => {\n    for (const kept of held) kept.freeze();\n  };\n  const closed = channel.ended.then((reason) => {\n    freeze();\n    return reason;\n  });\n  return {\n    serverId,\n    control,\n    transcript: hold(transcript),\n    deliveries: hold(deliveries),\n    agents: hold(agents),\n    views: hold(views),\n    commands: hold(commands),\n    sprinkles: hold(sprinkles),\n    memories: hold(memories),\n    memoryScopes: hold(memoryScopes),\n    frozen: hold(frozen),\n    changes: hold(changes),\n    settings: lastingSettings(settings, hold),\n    closed,\n    async prompt(text, whenBusy = 'followUp') {\n      const sent = await control.send({ text, whenBusy, requestId: null }, context);\n      if (!sent.accepted) throw new Error(`${sent.error.code}: ${sent.error.message}`);\n      const settled = await control.wait(sent.submissionId, context);\n      if (settled.status !== 'done') throw new Error(`unanswered: ${settled.reason}`);\n      return settled.text;\n    },\n    async close() {\n      freeze();\n      await server.use(AgentSessions).detach(context);\n      await session.dispose(context);\n      await server.dispose(context);\n      await client.dispose();\n    },\n  };\n}\n"],
-  "mappings": "AAAA;AAAA,EAEE;AAAA,OAEK;AACP,SAAS,0BAA0B;AACnC,SAAS,QAAQ,oCAAoC;AAKrD;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EAEA;AAAA,OAIK;AAEP,SAAS,mBAAsC;AA0BxC,SAAS,QAAW,OAAuC;AAChE,MAAI;AACJ,MAAI,SAAS;AACb,QAAM,OAAO,MAAM;AACjB,QAAI,OAAQ,QAAO;AACnB,QAAI;AACF,aAAO,MAAM;AAAA,IACf,QAAQ;AAAA,IAAC;AACT,WAAO;AAAA,EACT;AACA,SAAO;AAAA,IACL,OAAO;AAAA,MACL,IAAI,QAAQ;AACV,eAAO,KAAK;AAAA,MACd;AAAA,MACA,WAAW,CAAC,aAAc,SAAS,MAAM,SAAY,MAAM,UAAU,QAAQ;AAAA,IAC/E;AAAA,IACA,SAAS;AACP,WAAK;AACL,eAAS;AAAA,IACX;AAAA,EACF;AACF;AAEA,SAAS,gBACP,UACA,MACe;AACf,SAAO;AAAA,IACL,OAAO,KAAK,SAAS,KAAK;AAAA,IAC1B,SAAS,CAAC,YAAY,QAAQ,QAAQ,YACpC,SAAS,QAAQ,YAAY,QAAQ,QAAQ,OAAO;AAAA,IACtD,YAAY,CAAC,YAAY,YAAY,SAAS,WAAW,YAAY,OAAO;AAAA,IAC5E,QAAQ,CAAC,YAAY,YAAY,SAAS,OAAO,YAAY,OAAO;AAAA,EACtE;AACF;AAEA,SAAS,SAAS,QAA+B;AAC/C,SAAO,IAAI,QAAQ,CAAC,YAAY;AAC9B,UAAM,OAAO,OAAO,mBAAmB,MAAM;AAC3C,WAAK;AACL,cAAQ;AAAA,IACV,CAAC;AAAA,EACH,CAAC;AACH;AAEA,eAAsB,aACpB,UACA,UAAiC,CAAC,GACR;AAC1B,QAAM,UAAU,QAAQ,WAAW;AACnC,QAAM,UAAU,IAAI,YAAY,QAAQ;AACxC,QAAM,WAAW,MAAM,QAAQ;AAC/B,QAAM,SAAS,MAAM,OAAO,QAAQ,EAAE,UAAU,kBAAkB,QAAQ,UAAU,CAAC;AACrF,QAAM,SAAS,2BAA2B;AAAA,IACxC,UAAU,CAAC,aAAa;AAAA,IACxB,WAAW,6BAA6B,QAAQ,OAAO,EAAE,SAAS,EAAE;AAAA,IACpE,OAAO;AAAA,EACT,CAAC;AACD,QAAM,QAAQ,SAAS,MAAM;AAC7B,QAAM,OAAO,IAAI,aAAa,EAAE,OAAO,eAAe,OAAO;AAC7D,QAAM;AACN,QAAM,UAAU,2BAA2B;AAAA,IACzC,UAAU,CAAC,cAAc,iBAAiB,aAAa;AAAA,IACvD,WAAW,6BAA6B,QAAQ,MAAM,OAAO,UAAU;AAAA,IACvE,OAAO;AAAA,EACT,CAAC;AACD,QAAM,UAAU,QAAQ,IAAI,YAAY;AACxC,QAAM;AAAA,IACJ,OAAO;AAAA,IACP;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF,IAAI,QAAQ,IAAI,eAAe;AAC/B,QAAM,WAAW,QAAQ,IAAI,aAAa;AAC1C,QAAM,QAAQ,MAAM,OAAO;AAC3B,QAAM,OAA2B,CAAC;AAClC,QAAM,OAAO,CAAI,UAAkD;AACjE,UAAM,OAAO,QAAQ,KAAK;AAC1B,SAAK,KAAK,IAAwB;AAClC,WAAO,KAAK;AAAA,EACd;AACA,QAAM,SAAS,MAAM;AACnB,eAAW,QAAQ,KAAM,MAAK,OAAO;AAAA,EACvC;AACA,QAAM,SAAS,QAAQ,MAAM,KAAK,CAAC,WAAW;AAC5C,WAAO;AACP,WAAO;AAAA,EACT,CAAC;AACD,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA,YAAY,KAAK,UAAU;AAAA,IAC3B,YAAY,KAAK,UAAU;AAAA,IAC3B,QAAQ,KAAK,MAAM;AAAA,IACnB,OAAO,KAAK,KAAK;AAAA,IACjB,UAAU,KAAK,QAAQ;AAAA,IACvB,WAAW,KAAK,SAAS;AAAA,IACzB,UAAU,KAAK,QAAQ;AAAA,IACvB,cAAc,KAAK,YAAY;AAAA,IAC/B,QAAQ,KAAK,MAAM;AAAA,IACnB,SAAS,KAAK,OAAO;AAAA,IACrB,UAAU,gBAAgB,UAAU,IAAI;AAAA,IACxC;AAAA,IACA,MAAM,OAAO,MAAM,WAAW,YAAY;AACxC,YAAM,OAAO,MAAM,QAAQ,KAAK,EAAE,MAAM,UAAU,WAAW,KAAK,GAAG,OAAO;AAC5E,UAAI,CAAC,KAAK,SAAU,OAAM,IAAI,MAAM,GAAG,KAAK,MAAM,IAAI,KAAK,KAAK,MAAM,OAAO,EAAE;AAC/E,YAAM,UAAU,MAAM,QAAQ,KAAK,KAAK,cAAc,OAAO;AAC7D,UAAI,QAAQ,WAAW,OAAQ,OAAM,IAAI,MAAM,eAAe,QAAQ,MAAM,EAAE;AAC9E,aAAO,QAAQ;AAAA,IACjB;AAAA,IACA,MAAM,QAAQ;AACZ,aAAO;AACP,YAAM,OAAO,IAAI,aAAa,EAAE,OAAO,OAAO;AAC9C,YAAM,QAAQ,QAAQ,OAAO;AAC7B,YAAM,OAAO,QAAQ,OAAO;AAC5B,YAAM,OAAO,QAAQ;AAAA,IACvB;AAAA,EACF;AACF;",
+  "sourcesContent": ["import {\n  type Context,\n  createRemoteServiceBinding,\n  type ReplicatedState,\n} from '@earendil-works/chord';\nimport { BACKGROUND_CONTEXT } from '@earendil-works/chord/context';\nimport { Client, createClientServiceTransport } from '@earendil-works/pi-client';\nimport type { ConversationView } from '@earendil-works/pi-durable';\nimport type { ChangesView } from './changes/git.ts';\nimport type { FrozenCone } from './freezer/index.ts';\nimport type { MemoryEntry, MemoryScope } from './memory/format.ts';\nimport type { AgentRemote } from './remote/host.ts';\nimport {\n  AGENT_SESSION,\n  AgentControl,\n  AgentRemoteService,\n  AgentSessions,\n  AgentSettings,\n  type AgentsSummary,\n  AgentTranscript,\n  type Command,\n  type Delivered,\n  type SendMode,\n} from './services.ts';\nimport type { Sprinkle } from './sprinkles/kind.ts';\nimport { PortChannel, type PortEndpoint } from './wire.ts';\n\nexport interface AgentConnection {\n  readonly serverId: string;\n  readonly control: AgentControl;\n  readonly transcript: ReplicatedState<ConversationView>;\n  readonly deliveries: ReplicatedState<Record<string, Delivered>>;\n  readonly agents?: ReplicatedState<AgentsSummary>;\n  readonly views?: ReplicatedState<Record<string, ConversationView>>;\n  readonly commands?: ReplicatedState<Command[]>;\n  readonly sprinkles?: ReplicatedState<Sprinkle[]>;\n  readonly memories?: ReplicatedState<MemoryEntry[]>;\n  readonly memoryScopes?: ReplicatedState<MemoryScope[]>;\n  readonly frozen?: ReplicatedState<FrozenCone[]>;\n  readonly changes?: ReplicatedState<ChangesView>;\n  readonly settings: AgentSettings;\n  readonly remote?: AgentRemote;\n  readonly closed: Promise<Error | undefined>;\n  prompt(text: string, whenBusy?: SendMode): Promise<string>;\n  close(): Promise<void>;\n}\n\nexport interface Lasting<T> {\n  readonly state: ReplicatedState<T>;\n  freeze(): void;\n}\n\nexport function lasting<T>(state: ReplicatedState<T>): Lasting<T> {\n  let last: T | undefined;\n  let frozen = false;\n  const read = () => {\n    if (frozen) return last;\n    try {\n      last = state.value;\n    } catch {}\n    return last;\n  };\n  return {\n    state: {\n      get value() {\n        return read();\n      },\n      subscribe: (listener) => (frozen ? () => undefined : state.subscribe(listener)),\n    },\n    freeze() {\n      read();\n      frozen = true;\n    },\n  };\n}\n\nfunction lastingSettings(\n  settings: AgentSettings,\n  hold: <T>(state: ReplicatedState<T>) => ReplicatedState<T>\n): AgentSettings {\n  return {\n    state: hold(settings.state),\n    connect: (providerId, secret, region, context) =>\n      settings.connect(providerId, secret, region, context),\n    disconnect: (providerId, context) => settings.disconnect(providerId, context),\n    signIn: (providerId, context) => settings.signIn(providerId, context),\n  };\n}\n\nfunction attached(client: Client): Promise<void> {\n  return new Promise((resolve) => {\n    const stop = client.onAttachmentChange(() => {\n      stop();\n      resolve();\n    });\n  });\n}\n\nexport async function connectAgent(\n  endpoint: PortEndpoint,\n  options: { context?: Context } = {}\n): Promise<AgentConnection> {\n  const context = options.context ?? BACKGROUND_CONTEXT;\n  const channel = new PortChannel(endpoint);\n  const serverId = await channel.hello;\n  const client = await Client.connect({ serverId, transportFactory: channel.transport });\n  const server = createRemoteServiceBinding({\n    services: [AgentSessions],\n    transport: createClientServiceTransport(client, () => ({ serverId })),\n    bound: true,\n  });\n  const ready = attached(client);\n  await server.use(AgentSessions).attach(AGENT_SESSION, context);\n  await ready;\n  const session = createRemoteServiceBinding({\n    services: [AgentControl, AgentTranscript, AgentSettings, AgentRemoteService],\n    transport: createClientServiceTransport(client, () => client.attachment),\n    bound: true,\n  });\n  const control = session.use(AgentControl);\n  const {\n    state: transcript,\n    deliveries,\n    agents,\n    views,\n    commands,\n    sprinkles,\n    memories,\n    memoryScopes,\n    frozen,\n    changes,\n  } = session.use(AgentTranscript);\n  const settings = session.use(AgentSettings);\n  const remote = session.use(AgentRemoteService);\n  await session.ready(context);\n  const held: Lasting<unknown>[] = [];\n  const hold = <T>(state: ReplicatedState<T>): ReplicatedState<T> => {\n    const kept = lasting(state);\n    held.push(kept as Lasting<unknown>);\n    return kept.state;\n  };\n  const freeze = () => {\n    for (const kept of held) kept.freeze();\n  };\n  const closed = channel.ended.then((reason) => {\n    freeze();\n    return reason;\n  });\n  return {\n    serverId,\n    control,\n    transcript: hold(transcript),\n    deliveries: hold(deliveries),\n    agents: hold(agents),\n    views: hold(views),\n    commands: hold(commands),\n    sprinkles: hold(sprinkles),\n    memories: hold(memories),\n    memoryScopes: hold(memoryScopes),\n    frozen: hold(frozen),\n    changes: hold(changes),\n    settings: lastingSettings(settings, hold),\n    remote,\n    closed,\n    async prompt(text, whenBusy = 'followUp') {\n      const sent = await control.send({ text, whenBusy, requestId: null }, context);\n      if (!sent.accepted) throw new Error(`${sent.error.code}: ${sent.error.message}`);\n      const settled = await control.wait(sent.submissionId, context);\n      if (settled.status !== 'done') throw new Error(`unanswered: ${settled.reason}`);\n      return settled.text;\n    },\n    async close() {\n      freeze();\n      await server.use(AgentSessions).detach(context);\n      await session.dispose(context);\n      await server.dispose(context);\n      await client.dispose();\n    },\n  };\n}\n"],
+  "mappings": "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",
   "names": []
 }

package/dist/host.js

@@ -11,9 +11,11 @@ import {
 import { createAgentControl } from "./control.js";
 import { trackDeliveries } from "./deliveries.js";
 import { PortListener } from "./listener.js";
+import { createRemote } from "./remote/host.js";
 import {
   AGENT_SESSION,
   AgentControl,
+  AgentRemoteService,
   AgentSessions,
   AgentSettings,
   AgentTranscript
@@ -94,24 +96,34 @@ async function hostAgent(agent, options = {}) {
   const provider = new RemoteServiceProvider([
     { service: AgentControl, mode: "singleton" },
     { service: AgentTranscript, mode: "singleton" },
-    { service: AgentSettings, mode: "singleton" }
+    { service: AgentSettings, mode: "singleton" },
+    { service: AgentRemoteService, mode: "singleton" }
   ]);
   const deliveries = trackDeliveries(agent.harness, state, context);
-  provider.provide(
-    AgentControl,
-    createAgentControl(
-      agent.harness,
-      agent,
-      deliveries,
-      options.licks,
-      options.scoops,
-      options.skills,
-      options.sprinkles,
-      options.memory,
-      options.freezer,
-      options.changes
-    )
+  const control = createAgentControl(
+    agent.harness,
+    agent,
+    deliveries,
+    options.licks,
+    options.scoops,
+    options.skills,
+    options.sprinkles,
+    options.memory,
+    options.freezer,
+    options.changes
   );
+  provider.provide(AgentControl, control);
+  const remote = createRemote({
+    harness: agent.harness,
+    send: (request, using) => control.send(request, using),
+    async conversation(agentId, using) {
+      if (!agentId) return agent.cone();
+      const found = await agent.agents.conversation(agentId, using);
+      if (!found) throw new Error(`There is no agent ${agentId}.`);
+      return found;
+    }
+  });
+  provider.provide(AgentRemoteService, remote);
   provider.provide(AgentTranscript, {
     state,
     deliveries: deliveries.state,
@@ -142,6 +154,7 @@ async function hostAgent(agent, options = {}) {
     connect: (endpoint) => listener.connect(endpoint),
     async close() {
       await server.close();
+      await remote.dispose();
       provider.dispose();
       deliveries.dispose();
       transcript.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 {\n  AGENT_SESSION,\n  AgentControl,\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  ]);\n  const deliveries = trackDeliveries(agent.harness, state, context);\n  provider.provide(\n    AgentControl,\n    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  );\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      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 { 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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",
   "names": []
 }

package/dist/page.js

@@ -3,9 +3,13 @@ import {
   AGENT_LOCK,
   startAgent
 } from "./owner.js";
+import {
+  remoteControl
+} from "./remote/client.js";
 export {
   AGENT_LOCK,
   connectAgent,
+  remoteControl,
   startAgent
 };
 //# sourceMappingURL=page.js.map

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';\n"],
-  "mappings": "AAAA,SAA+B,oBAAoB;AACnD;AAAA,EACE;AAAA,EAKA;AAAA,OACK;",
+  "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;",
   "names": []
 }

package/dist/remote/client.js

@@ -0,0 +1,79 @@
+import { BACKGROUND_CONTEXT } from "@earendil-works/chord/context";
+const POLL_MS = 25e3;
+function failure(code, message) {
+  return Object.assign(new Error(`${code}: ${message}`), { code });
+}
+function opened(result) {
+  if (!result.ok) throw failure(result.code, result.message);
+  return result;
+}
+function events(remote, stream) {
+  return {
+    [Symbol.asyncIterator]() {
+      let buffer = [];
+      let done = false;
+      let closed = false;
+      const close = async () => {
+        if (closed) return;
+        closed = true;
+        await remote.close(stream, BACKGROUND_CONTEXT).catch(() => void 0);
+      };
+      return {
+        async next() {
+          while (!buffer.length && !done && !closed) {
+            const batch = await remote.next(stream, POLL_MS, BACKGROUND_CONTEXT);
+            buffer = batch.events;
+            done = batch.done;
+          }
+          const value = buffer.shift();
+          if (value) return { value, done: false };
+          await close();
+          return { value: void 0, done: true };
+        },
+        async return() {
+          await close();
+          return { value: void 0, done: true };
+        }
+      };
+    }
+  };
+}
+function remoteControl(connection, options = {}) {
+  const remote = connection.remote;
+  const agent = () => options.agent?.() ?? null;
+  const need = () => {
+    if (!remote) throw failure("ENOSYS", "this agent has no remote control");
+    return remote;
+  };
+  return {
+    async prompt({ text, whenBusy = "followUp", thinking = false }) {
+      const service = need();
+      const result = opened(
+        await service.prompt({ agentId: agent(), text, whenBusy, thinking }, BACKGROUND_CONTEXT)
+      );
+      return {
+        delivered: result.delivered,
+        events: events(service, result.stream)
+      };
+    },
+    async watch({ since = null, thinking = false } = {}) {
+      const service = need();
+      const result = opened(
+        await service.watch({ agentId: agent(), since, thinking }, BACKGROUND_CONTEXT)
+      );
+      return {
+        head: result.head ?? "",
+        ...result.gap ? { gap: true } : {},
+        events: events(service, result.stream)
+      };
+    },
+    async abort() {
+      return need().abort(agent(), BACKGROUND_CONTEXT);
+    }
+  };
+}
+export {
+  POLL_MS,
+  remoteControl
+};
+//# sourceMappingURL=client.js.map

package/dist/remote/client.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/remote/client.ts"],
+  "sourcesContent": ["import { BACKGROUND_CONTEXT } from '@earendil-works/chord/context';\nimport type { AgentConnection } from '../client.ts';\nimport type { Delivered, SendMode } from '../services.ts';\nimport type { RemoteEvent } from './events.ts';\nimport type { AgentRemote, RemoteOpened } from './host.ts';\n\nexport type { RemoteEvent } from './events.ts';\n\nexport const POLL_MS = 25000;\n\nexport interface RemoteOptions {\n  agent?: () => string | null;\n}\n\nexport interface RemoteControl {\n  prompt(request: {\n    text: string;\n    whenBusy?: SendMode;\n    thinking?: boolean;\n  }): Promise<{ delivered: Delivered; events: AsyncIterable<RemoteEvent> }>;\n  watch(request?: {\n    since?: string | null;\n    thinking?: boolean;\n  }): Promise<{ head: string; gap?: true; events: AsyncIterable<RemoteEvent> }>;\n  abort(): Promise<{ aborted: boolean }>;\n}\n\nfunction failure(code: string, message: string): Error {\n  return Object.assign(new Error(`${code}: ${message}`), { code });\n}\n\nfunction opened(result: RemoteOpened): Extract<RemoteOpened, { ok: true }> {\n  if (!result.ok) throw failure(result.code, result.message);\n  return result;\n}\n\nfunction events(remote: AgentRemote, stream: string): AsyncIterable<RemoteEvent> {\n  return {\n    [Symbol.asyncIterator]() {\n      let buffer: RemoteEvent[] = [];\n      let done = false;\n      let closed = false;\n      const close = async () => {\n        if (closed) return;\n        closed = true;\n        await remote.close(stream, BACKGROUND_CONTEXT).catch(() => undefined);\n      };\n      return {\n        async next(): Promise<IteratorResult<RemoteEvent>> {\n          while (!buffer.length && !done && !closed) {\n            const batch = await remote.next(stream, POLL_MS, BACKGROUND_CONTEXT);\n            buffer = batch.events;\n            done = batch.done;\n          }\n          const value = buffer.shift();\n          if (value) return { value, done: false };\n          await close();\n          return { value: undefined, done: true };\n        },\n        async return(): Promise<IteratorResult<RemoteEvent>> {\n          await close();\n          return { value: undefined, done: true };\n        },\n      };\n    },\n  };\n}\n\nexport function remoteControl(\n  connection: Pick<AgentConnection, 'remote'>,\n  options: RemoteOptions = {}\n): RemoteControl {\n  const remote = connection.remote;\n  const agent = () => options.agent?.() ?? null;\n  const need = (): AgentRemote => {\n    if (!remote) throw failure('ENOSYS', 'this agent has no remote control');\n    return remote;\n  };\n  return {\n    async prompt({ text, whenBusy = 'followUp', thinking = false }) {\n      const service = need();\n      const result = opened(\n        await service.prompt({ agentId: agent(), text, whenBusy, thinking }, BACKGROUND_CONTEXT)\n      );\n      return {\n        delivered: result.delivered as Delivered,\n        events: events(service, result.stream),\n      };\n    },\n    async watch({ since = null, thinking = false } = {}) {\n      const service = need();\n      const result = opened(\n        await service.watch({ agentId: agent(), since, thinking }, BACKGROUND_CONTEXT)\n      );\n      return {\n        head: result.head ?? '',\n        ...(result.gap ? { gap: true as const } : {}),\n        events: events(service, result.stream),\n      };\n    },\n    async abort() {\n      return need().abort(agent(), BACKGROUND_CONTEXT);\n    },\n  };\n}\n"],
+  "mappings": "AAAA,SAAS,0BAA0B;AAQ5B,MAAM,UAAU;AAmBvB,SAAS,QAAQ,MAAc,SAAwB;AACrD,SAAO,OAAO,OAAO,IAAI,MAAM,GAAG,IAAI,KAAK,OAAO,EAAE,GAAG,EAAE,KAAK,CAAC;AACjE;AAEA,SAAS,OAAO,QAA2D;AACzE,MAAI,CAAC,OAAO,GAAI,OAAM,QAAQ,OAAO,MAAM,OAAO,OAAO;AACzD,SAAO;AACT;AAEA,SAAS,OAAO,QAAqB,QAA4C;AAC/E,SAAO;AAAA,IACL,CAAC,OAAO,aAAa,IAAI;AACvB,UAAI,SAAwB,CAAC;AAC7B,UAAI,OAAO;AACX,UAAI,SAAS;AACb,YAAM,QAAQ,YAAY;AACxB,YAAI,OAAQ;AACZ,iBAAS;AACT,cAAM,OAAO,MAAM,QAAQ,kBAAkB,EAAE,MAAM,MAAM,MAAS;AAAA,MACtE;AACA,aAAO;AAAA,QACL,MAAM,OAA6C;AACjD,iBAAO,CAAC,OAAO,UAAU,CAAC,QAAQ,CAAC,QAAQ;AACzC,kBAAM,QAAQ,MAAM,OAAO,KAAK,QAAQ,SAAS,kBAAkB;AACnE,qBAAS,MAAM;AACf,mBAAO,MAAM;AAAA,UACf;AACA,gBAAM,QAAQ,OAAO,MAAM;AAC3B,cAAI,MAAO,QAAO,EAAE,OAAO,MAAM,MAAM;AACvC,gBAAM,MAAM;AACZ,iBAAO,EAAE,OAAO,QAAW,MAAM,KAAK;AAAA,QACxC;AAAA,QACA,MAAM,SAA+C;AACnD,gBAAM,MAAM;AACZ,iBAAO,EAAE,OAAO,QAAW,MAAM,KAAK;AAAA,QACxC;AAAA,MACF;AAAA,IACF;AAAA,EACF;AACF;AAEO,SAAS,cACd,YACA,UAAyB,CAAC,GACX;AACf,QAAM,SAAS,WAAW;AAC1B,QAAM,QAAQ,MAAM,QAAQ,QAAQ,KAAK;AACzC,QAAM,OAAO,MAAmB;AAC9B,QAAI,CAAC,OAAQ,OAAM,QAAQ,UAAU,kCAAkC;AACvE,WAAO;AAAA,EACT;AACA,SAAO;AAAA,IACL,MAAM,OAAO,EAAE,MAAM,WAAW,YAAY,WAAW,MAAM,GAAG;AAC9D,YAAM,UAAU,KAAK;AACrB,YAAM,SAAS;AAAA,QACb,MAAM,QAAQ,OAAO,EAAE,SAAS,MAAM,GAAG,MAAM,UAAU,SAAS,GAAG,kBAAkB;AAAA,MACzF;AACA,aAAO;AAAA,QACL,WAAW,OAAO;AAAA,QAClB,QAAQ,OAAO,SAAS,OAAO,MAAM;AAAA,MACvC;AAAA,IACF;AAAA,IACA,MAAM,MAAM,EAAE,QAAQ,MAAM,WAAW,MAAM,IAAI,CAAC,GAAG;AACnD,YAAM,UAAU,KAAK;AACrB,YAAM,SAAS;AAAA,QACb,MAAM,QAAQ,MAAM,EAAE,SAAS,MAAM,GAAG,OAAO,SAAS,GAAG,kBAAkB;AAAA,MAC/E;AACA,aAAO;AAAA,QACL,MAAM,OAAO,QAAQ;AAAA,QACrB,GAAI,OAAO,MAAM,EAAE,KAAK,KAAc,IAAI,CAAC;AAAA,QAC3C,QAAQ,OAAO,SAAS,OAAO,MAAM;AAAA,MACvC;AAAA,IACF;AAAA,IACA,MAAM,QAAQ;AACZ,aAAO,KAAK,EAAE,MAAM,MAAM,GAAG,kBAAkB;AAAA,IACjD;AAAA,EACF;AACF;",
+  "names": []
+}

package/dist/remote/events.js

@@ -0,0 +1,216 @@
+import { entryLick } from "../licks/state.js";
+import { redactSecrets } from "../memory/format.js";
+const SUMMARY = 200;
+function clip(text, limit = SUMMARY) {
+  const flat = redactSecrets(text).text.replace(/\s+/g, " ").trim();
+  return flat.length > limit ? `${flat.slice(0, limit - 1)}\u2026` : flat;
+}
+function textOf(content) {
+  if (typeof content === "string") return content;
+  return (content ?? []).map((block) => block.type === "text" ? block.text ?? "" : "").join("");
+}
+const SUBJECTS = ["command", "path", "pattern", "url", "query", "code", "name"];
+function toolSummary(name, args) {
+  const subject = SUBJECTS.map((key) => args?.[key]).find((value) => typeof value === "string");
+  const detail = typeof subject === "string" ? subject : JSON.stringify(args ?? {});
+  return clip(`${name} ${detail}`);
+}
+function resultSummary(message) {
+  const text = textOf(message.content);
+  if (message.isError)
+    return clip(
+      text.split("\n").find((line) => line.trim() && !/^<\/?harness>$/.test(line.trim())) ?? "failed"
+    );
+  const lines = text ? text.split("\n").length : 0;
+  return lines === 1 ? "1 line" : `${lines} lines`;
+}
+function keyOf(timestamp, at) {
+  return at > 0 ? `a${timestamp ?? 0}~${at}` : `a${timestamp ?? 0}`;
+}
+function reasonOf(stopReason) {
+  if (stopReason === "aborted") return "aborted";
+  return stopReason === "error" ? "error" : "stop";
+}
+class Mapper {
+  #thinking;
+  #emitted = /* @__PURE__ */ new Map();
+  #seen = /* @__PURE__ */ new Set();
+  #current;
+  #previous;
+  #ending = [];
+  #stamps = /* @__PURE__ */ new Map();
+  reason = "stop";
+  error;
+  constructor(thinking) {
+    this.#thinking = thinking;
+  }
+  #key(message, entry) {
+    const stamp = message?.timestamp ?? 0;
+    const list = this.#stamps.get(stamp) ?? [];
+    this.#stamps.set(stamp, list);
+    if (entry === void 0) return keyOf(stamp, list.length);
+    if (!list.includes(entry)) list.push(entry);
+    return keyOf(stamp, list.indexOf(entry));
+  }
+  #delta(t, id, full) {
+    if (t === "thinking" && !this.#thinking) return [];
+    const done = this.#emitted.get(id) ?? 0;
+    if (full.length <= done) return [];
+    this.#emitted.set(id, full.length);
+    return [{ t, id, delta: full.slice(done) }];
+  }
+  partial(message) {
+    if (!message || !Array.isArray(message.content)) return [];
+    const key = this.#key(message);
+    this.#current = key;
+    return message.content.flatMap((block, at) => {
+      if (block.type === "text") return this.#delta("text", `${key}.${at}`, block.text ?? "");
+      if (block.type === "thinking")
+        return this.#delta("thinking", `${key}.${at}`, block.thinking ?? "");
+      return [];
+    });
+  }
+  #assistant(message, entry) {
+    const key = this.#key(message, entry.id);
+    const blocks = Array.isArray(message.content) ? message.content : [];
+    const out = blocks.flatMap((block, at) => {
+      const id = `${key}.${at}`;
+      if (block.type === "text") return this.#delta("text", id, block.text ?? "");
+      if (block.type === "thinking") return this.#delta("thinking", id, block.thinking ?? "");
+      if (block.type !== "toolCall") return [];
+      const name = block.name ?? "tool";
+      return [
+        { t: "tool", id, call: block.id ?? "", name, summary: toolSummary(name, block.arguments) }
+      ];
+    });
+    if (typeof message.content === "string")
+      out.push(...this.#delta("text", `${key}.0`, message.content));
+    this.reason = reasonOf(message.stopReason);
+    this.error = message.stopReason === "error" ? clip(message.errorMessage ?? "error", 1e3) : void 0;
+    if (this.error) out.push({ t: "error", id: String(entry.id), message: this.error });
+    return out;
+  }
+  #delivered(entry) {
+    if (entry.byTaskId === void 0) return "run";
+    return this.#previous === "pi.tool-result" ? "steer" : "follow-up";
+  }
+  entry(entry, delivered = this.#delivered(entry)) {
+    if (this.#seen.has(entry.id)) return [];
+    this.#seen.add(entry.id);
+    this.#previous = entry.kind;
+    const id = String(entry.id);
+    const message = entry.model?.[0];
+    if (entry.kind === "pi.user" && message) {
+      const lick = entryLick(entry);
+      if (lick) return [{ t: "notice", id, text: clip(`lick ${lick.channel}: ${lick.title}`) }];
+      return [{ t: "user", id, text: redactSecrets(textOf(message.content)).text, delivered }];
+    }
+    if (entry.kind === "pi.assistant" && message) return this.#assistant(message, entry);
+    if (entry.kind === "pi.tool-result" && message)
+      return [
+        {
+          t: "tool-result",
+          id,
+          call: message.toolCallId ?? "",
+          ok: !message.isError,
+          summary: resultSummary(message)
+        }
+      ];
+    if (entry.kind === "pi.compaction") return [{ t: "notice", id, text: "compacted" }];
+    if (entry.kind === "slicc.rewound") return [{ t: "notice", id, text: "rewound" }];
+    return [];
+  }
+  #ended(reason) {
+    if (!this.#ending.length) return [];
+    this.#ending = [];
+    this.reason = reason;
+    return [{ t: "run", state: "end", reason }];
+  }
+  #settled(record) {
+    if (!this.#ending.includes(record.id) || ["queued", "placed"].includes(record.status))
+      return [];
+    if (record.status !== "unanswered") return this.#ended(this.reason);
+    if (record.reason === "aborted") return this.#ended("aborted");
+    this.error ??= clip(String(record.reason ?? "error"), 1e3);
+    return this.#ended("error");
+  }
+  last() {
+    return Math.max(0, ...this.#seen);
+  }
+  event(event) {
+    switch (event.type) {
+      case "run_start": {
+        const ended = this.#ended(this.reason);
+        this.reason = "stop";
+        this.error = void 0;
+        return [...ended, { t: "run", state: "start" }];
+      }
+      case "run_end":
+        this.#ending = event.inputs;
+        return [];
+      case "submission":
+        return this.#settled(event.record);
+      case "message_start":
+        if (event.message.role === "assistant")
+          this.#current = this.#key(event.message);
+        return [];
+      case "message_update":
+        return event.changes.flatMap((change) => {
+          if (change.type !== "text_delta" && change.type !== "thinking_delta") return [];
+          const id = `${this.#current}.${change.contentIndex}`;
+          const t = change.type === "text_delta" ? "text" : "thinking";
+          const done = this.#emitted.get(id) ?? 0;
+          if (t === "thinking" && !this.#thinking) return [];
+          this.#emitted.set(id, done + change.delta.length);
+          return [{ t, id, delta: change.delta }];
+        });
+      case "message_end":
+        return this.entry(event.entry);
+      case "tool_execution_end":
+        return event.entry ? this.entry(event.entry) : [
+          {
+            t: "tool-result",
+            id: `x${event.toolCallId}`,
+            call: event.toolCallId,
+            ok: false,
+            summary: "the tool did not finish"
+          }
+        ];
+      case "auto_retry_start":
+        return [
+          {
+            t: "notice",
+            id: `retry-${event.at}`,
+            text: clip(`retrying (attempt ${event.attempt}): ${event.errorMessage}`)
+          }
+        ];
+      case "compaction_start":
+        return [{ t: "notice", id: `compaction-${event.taskId}`, text: "compacting" }];
+      case "task_failed":
+        return [{ t: "error", id: `task-${event.taskId}`, message: clip(event.message, 1e3) }];
+      default:
+        return [];
+    }
+  }
+}
+function replayOf(entries, partial, thinking) {
+  const mapper = new Mapper(thinking);
+  const out = [];
+  for (const entry of entries) out.push(...mapper.entry(entry));
+  out.push(...mapper.partial(partial));
+  return out;
+}
+function idOf(event) {
+  return "id" in event ? event.id : void 0;
+}
+export {
+  Mapper,
+  SUMMARY,
+  clip,
+  idOf,
+  keyOf,
+  replayOf,
+  resultSummary,
+  toolSummary
+};
+//# sourceMappingURL=events.js.map

package/dist/remote/events.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/remote/events.ts"],
+  "sourcesContent": ["import type { AgentEvent, EntryRecord } from '@earendil-works/pi-durable';\nimport { entryLick } from '../licks/state.ts';\nimport { redactSecrets } from '../memory/format.ts';\nimport type { Delivered } from '../services.ts';\n\nexport const SUMMARY = 200;\n\nexport type EndReason = 'stop' | 'aborted' | 'error';\n\nexport type RemoteEvent =\n  | { t: 'user'; id: string; text: string; delivered: Delivered }\n  | { t: 'text'; id: string; delta: string }\n  | { t: 'thinking'; id: string; delta: string }\n  | { t: 'tool'; id: string; call: string; name: string; summary: string }\n  | { t: 'tool-result'; id: string; call: string; ok: boolean; summary: string }\n  | { t: 'run'; state: 'start' | 'end'; reason?: EndReason }\n  | { t: 'notice'; id: string; text: string }\n  | { t: 'error'; id: string; message: string; detail?: string }\n  | { t: 'end'; reason: EndReason; message?: string };\n\ntype Json = Record<string, unknown>;\n\ninterface Block {\n  type: string;\n  text?: string;\n  thinking?: string;\n  id?: string;\n  name?: string;\n  arguments?: Json;\n}\n\ninterface ModelMessage {\n  role?: string;\n  content?: string | Block[];\n  timestamp?: number;\n  stopReason?: string;\n  errorMessage?: string;\n  toolCallId?: string;\n  toolName?: string;\n  isError?: boolean;\n}\n\nexport function clip(text: string, limit = SUMMARY): string {\n  const flat = redactSecrets(text).text.replace(/\\s+/g, ' ').trim();\n  return flat.length > limit ? `${flat.slice(0, limit - 1)}\u2026` : flat;\n}\n\nfunction textOf(content: ModelMessage['content']): string {\n  if (typeof content === 'string') return content;\n  return (content ?? []).map((block) => (block.type === 'text' ? (block.text ?? '') : '')).join('');\n}\n\nconst SUBJECTS = ['command', 'path', 'pattern', 'url', 'query', 'code', 'name'];\n\nexport function toolSummary(name: string, args: Json | undefined): string {\n  const subject = SUBJECTS.map((key) => args?.[key]).find((value) => typeof value === 'string');\n  const detail = typeof subject === 'string' ? subject : JSON.stringify(args ?? {});\n  return clip(`${name} ${detail}`);\n}\n\nexport function resultSummary(message: ModelMessage): string {\n  const text = textOf(message.content);\n  if (message.isError)\n    return clip(\n      text.split('\\n').find((line) => line.trim() && !/^<\\/?harness>$/.test(line.trim())) ??\n        'failed'\n    );\n  const lines = text ? text.split('\\n').length : 0;\n  return lines === 1 ? '1 line' : `${lines} lines`;\n}\n\nexport function keyOf(timestamp: number | undefined, at: number): string {\n  return at > 0 ? `a${timestamp ?? 0}~${at}` : `a${timestamp ?? 0}`;\n}\n\nfunction reasonOf(stopReason: string | undefined): EndReason {\n  if (stopReason === 'aborted') return 'aborted';\n  return stopReason === 'error' ? 'error' : 'stop';\n}\n\nexport class Mapper {\n  readonly #thinking: boolean;\n  readonly #emitted = new Map<string, number>();\n  readonly #seen = new Set<number>();\n  #current: string | undefined;\n  #previous: string | undefined;\n  #ending: readonly number[] = [];\n  readonly #stamps = new Map<number, number[]>();\n  reason: EndReason = 'stop';\n  error: string | undefined;\n\n  constructor(thinking: boolean) {\n    this.#thinking = thinking;\n  }\n\n  #key(message: ModelMessage | undefined, entry?: number): string {\n    const stamp = message?.timestamp ?? 0;\n    const list = this.#stamps.get(stamp) ?? [];\n    this.#stamps.set(stamp, list);\n    if (entry === undefined) return keyOf(stamp, list.length);\n    if (!list.includes(entry)) list.push(entry);\n    return keyOf(stamp, list.indexOf(entry));\n  }\n\n  #delta(t: 'text' | 'thinking', id: string, full: string): RemoteEvent[] {\n    if (t === 'thinking' && !this.#thinking) return [];\n    const done = this.#emitted.get(id) ?? 0;\n    if (full.length <= done) return [];\n    this.#emitted.set(id, full.length);\n    return [{ t, id, delta: full.slice(done) }];\n  }\n\n  partial(message: ModelMessage | undefined): RemoteEvent[] {\n    if (!message || !Array.isArray(message.content)) return [];\n    const key = this.#key(message);\n    this.#current = key;\n    return message.content.flatMap((block, at) => {\n      if (block.type === 'text') return this.#delta('text', `${key}.${at}`, block.text ?? '');\n      if (block.type === 'thinking')\n        return this.#delta('thinking', `${key}.${at}`, block.thinking ?? '');\n      return [];\n    });\n  }\n\n  #assistant(message: ModelMessage, entry: EntryRecord): RemoteEvent[] {\n    const key = this.#key(message, entry.id);\n    const blocks = Array.isArray(message.content) ? message.content : [];\n    const out = blocks.flatMap((block, at): RemoteEvent[] => {\n      const id = `${key}.${at}`;\n      if (block.type === 'text') return this.#delta('text', id, block.text ?? '');\n      if (block.type === 'thinking') return this.#delta('thinking', id, block.thinking ?? '');\n      if (block.type !== 'toolCall') return [];\n      const name = block.name ?? 'tool';\n      return [\n        { t: 'tool', id, call: block.id ?? '', name, summary: toolSummary(name, block.arguments) },\n      ];\n    });\n    if (typeof message.content === 'string')\n      out.push(...this.#delta('text', `${key}.0`, message.content));\n    this.reason = reasonOf(message.stopReason);\n    this.error =\n      message.stopReason === 'error' ? clip(message.errorMessage ?? 'error', 1000) : undefined;\n    if (this.error) out.push({ t: 'error', id: String(entry.id), message: this.error });\n    return out;\n  }\n\n  #delivered(entry: EntryRecord): Delivered {\n    if (entry.byTaskId === undefined) return 'run';\n    return this.#previous === 'pi.tool-result' ? 'steer' : 'follow-up';\n  }\n\n  entry(entry: EntryRecord, delivered: Delivered = this.#delivered(entry)): RemoteEvent[] {\n    if (this.#seen.has(entry.id)) return [];\n    this.#seen.add(entry.id);\n    this.#previous = entry.kind;\n    const id = String(entry.id);\n    const message = entry.model?.[0] as ModelMessage | undefined;\n    if (entry.kind === 'pi.user' && message) {\n      const lick = entryLick(entry);\n      if (lick) return [{ t: 'notice', id, text: clip(`lick ${lick.channel}: ${lick.title}`) }];\n      return [{ t: 'user', id, text: redactSecrets(textOf(message.content)).text, delivered }];\n    }\n    if (entry.kind === 'pi.assistant' && message) return this.#assistant(message, entry);\n    if (entry.kind === 'pi.tool-result' && message)\n      return [\n        {\n          t: 'tool-result',\n          id,\n          call: message.toolCallId ?? '',\n          ok: !message.isError,\n          summary: resultSummary(message),\n        },\n      ];\n    if (entry.kind === 'pi.compaction') return [{ t: 'notice', id, text: 'compacted' }];\n    if (entry.kind === 'slicc.rewound') return [{ t: 'notice', id, text: 'rewound' }];\n    return [];\n  }\n\n  #ended(reason: EndReason): RemoteEvent[] {\n    if (!this.#ending.length) return [];\n    this.#ending = [];\n    this.reason = reason;\n    return [{ t: 'run', state: 'end', reason }];\n  }\n\n  #settled(record: { id: number; status: string; reason?: unknown }): RemoteEvent[] {\n    if (!this.#ending.includes(record.id) || ['queued', 'placed'].includes(record.status))\n      return [];\n    if (record.status !== 'unanswered') return this.#ended(this.reason);\n    if (record.reason === 'aborted') return this.#ended('aborted');\n    this.error ??= clip(String(record.reason ?? 'error'), 1000);\n    return this.#ended('error');\n  }\n\n  last(): number {\n    return Math.max(0, ...this.#seen);\n  }\n\n  event(event: AgentEvent): RemoteEvent[] {\n    switch (event.type) {\n      case 'run_start': {\n        const ended = this.#ended(this.reason);\n        this.reason = 'stop';\n        this.error = undefined;\n        return [...ended, { t: 'run', state: 'start' }];\n      }\n      case 'run_end':\n        this.#ending = event.inputs;\n        return [];\n      case 'submission':\n        return this.#settled(event.record);\n      case 'message_start':\n        if ((event.message as ModelMessage).role === 'assistant')\n          this.#current = this.#key(event.message as ModelMessage);\n        return [];\n      case 'message_update':\n        return event.changes.flatMap((change) => {\n          if (change.type !== 'text_delta' && change.type !== 'thinking_delta') return [];\n          const id = `${this.#current}.${change.contentIndex}`;\n          const t = change.type === 'text_delta' ? 'text' : 'thinking';\n          const done = this.#emitted.get(id) ?? 0;\n          if (t === 'thinking' && !this.#thinking) return [];\n          this.#emitted.set(id, done + change.delta.length);\n          return [{ t, id, delta: change.delta }];\n        });\n      case 'message_end':\n        return this.entry(event.entry);\n      case 'tool_execution_end':\n        return event.entry\n          ? this.entry(event.entry)\n          : [\n              {\n                t: 'tool-result',\n                id: `x${event.toolCallId}`,\n                call: event.toolCallId,\n                ok: false,\n                summary: 'the tool did not finish',\n              },\n            ];\n      case 'auto_retry_start':\n        return [\n          {\n            t: 'notice',\n            id: `retry-${event.at}`,\n            text: clip(`retrying (attempt ${event.attempt}): ${event.errorMessage}`),\n          },\n        ];\n      case 'compaction_start':\n        return [{ t: 'notice', id: `compaction-${event.taskId}`, text: 'compacting' }];\n      case 'task_failed':\n        return [{ t: 'error', id: `task-${event.taskId}`, message: clip(event.message, 1000) }];\n      default:\n        return [];\n    }\n  }\n}\n\nexport function replayOf(\n  entries: readonly EntryRecord[],\n  partial: ModelMessage | undefined,\n  thinking: boolean\n): RemoteEvent[] {\n  const mapper = new Mapper(thinking);\n  const out: RemoteEvent[] = [];\n  for (const entry of entries) out.push(...mapper.entry(entry));\n  out.push(...mapper.partial(partial));\n  return out;\n}\n\nexport function idOf(event: RemoteEvent): string | undefined {\n  return 'id' in event ? event.id : undefined;\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/remote/host.js

@@ -0,0 +1,273 @@
+import { BACKGROUND_CONTEXT, withCancel } from "@earendil-works/chord/context";
+import {
+  watchEvents
+} from "@earendil-works/pi-durable";
+import { idOf, Mapper, replayOf } from "./events.js";
+const MAX_QUEUED = 1e4;
+const IDLE_MS = 12e4;
+class Stream {
+  queue = [];
+  done = false;
+  touched;
+  #wake;
+  #stop;
+  #limit;
+  constructor(stop, now, limit) {
+    this.#stop = stop;
+    this.touched = now;
+    this.#limit = limit;
+  }
+  push(events) {
+    if (this.done || !events.length) return;
+    this.queue.push(...events);
+    if (this.queue.length > this.#limit) {
+      this.queue.length = 0;
+      this.queue.push({ t: "end", reason: "error", message: "the stream fell too far behind" });
+      void this.finish();
+    }
+    this.#wake?.();
+  }
+  async finish() {
+    if (this.done) return;
+    this.done = true;
+    this.#wake?.();
+    await this.#stop().catch(() => void 0);
+  }
+  wait(ms) {
+    if (this.queue.length || this.done) return Promise.resolve();
+    return new Promise((resolve) => {
+      const timer = setTimeout(done, ms);
+      function done() {
+        clearTimeout(timer);
+        resolve();
+      }
+      this.#wake = () => {
+        this.#wake = void 0;
+        done();
+      };
+    });
+  }
+}
+function deliveredOf(status, whenBusy, busy) {
+  if (status?.status === "queued") return whenBusy === "followUp" ? "follow-up" : "steer";
+  return busy ? "steer" : "run";
+}
+function headOf(events) {
+  for (let at = events.length - 1; at >= 0; at--) {
+    const id = idOf(events[at]);
+    if (id) return id;
+  }
+  return null;
+}
+function followed(mapper, event) {
+  return event.type === "snapshot" ? resync(mapper, event) : mapper.event(event);
+}
+function resync(mapper, snapshot) {
+  const last = mapper.last();
+  return [
+    ...snapshot.entries.filter((entry) => entry.id > last).flatMap((entry) => mapper.entry(entry)),
+    ...mapper.partial(snapshot.generation?.message)
+  ];
+}
+function placedEntry(value) {
+  const entry = value?.entry;
+  return typeof entry === "number" ? entry : void 0;
+}
+class Follower {
+  #mapper;
+  #entries;
+  #submission;
+  #delivered;
+  #out = [];
+  #user;
+  #started = false;
+  constructor(mapper, entries, submission, delivered, record) {
+    this.#mapper = mapper;
+    this.#entries = new Map(entries.map((entry) => [entry.id, entry]));
+    this.#submission = submission;
+    this.#delivered = delivered;
+    this.#user = placedEntry(record);
+  }
+  drain() {
+    return this.#out.splice(0);
+  }
+  #begin() {
+    const entry = this.#user === void 0 ? void 0 : this.#entries.get(this.#user);
+    if (!entry) return;
+    this.#started = true;
+    this.#out.push(...this.#mapper.entry(entry, this.#delivered));
+  }
+  #end(reason, message) {
+    this.#out.push({ t: "end", reason, ...message ? { message } : {} });
+    return true;
+  }
+  #ours(event) {
+    if (event.type !== "submission" || event.record.id !== this.#submission) return false;
+    this.#user = placedEntry(event.record) ?? this.#user;
+    return this.#user === void 0 && !["queued", "placed"].includes(event.record.status);
+  }
+  take(batch) {
+    for (const event of batch) {
+      if (event.type === "message_end") this.#entries.set(event.entry.id, event.entry);
+      if (this.#ours(event)) return this.#end("aborted");
+      if (!this.#started) {
+        this.#begin();
+        continue;
+      }
+      const mapped = this.#mapper.event(event).filter((item) => item.t !== "user");
+      this.#out.push(...mapped);
+      if (mapped.some((item) => item.t === "run" && item.state === "end"))
+        return this.#end(this.#mapper.reason, this.#mapper.error);
+    }
+    return false;
+  }
+}
+function createRemote(host) {
+  const now = host.now ?? Date.now;
+  const streams = /* @__PURE__ */ new Map();
+  let serial = 0;
+  let timer;
+  const sweep = () => {
+    for (const [id, stream] of streams)
+      if (now() - stream.touched > IDLE_MS) {
+        streams.delete(id);
+        void stream.finish();
+      }
+    if (!streams.size && timer !== void 0) {
+      clearInterval(timer);
+      timer = void 0;
+    }
+  };
+  const track = (id, stream) => {
+    streams.set(id, stream);
+    timer ??= setInterval(sweep, host.sweepMs ?? IDLE_MS / 4);
+  };
+  const watching = async (agentId, context) => {
+    const conversation = await host.conversation(agentId, context);
+    const cancel = withCancel(BACKGROUND_CONTEXT);
+    const events = await watchEvents(
+      host.harness,
+      conversation.id,
+      cancel.context
+    );
+    const open = (onEvents) => {
+      const stream = new Stream(
+        async () => {
+          await events.stop();
+          cancel.cancel();
+        },
+        now(),
+        host.limit ?? MAX_QUEUED
+      );
+      const id = `s${++serial}`;
+      track(id, stream);
+      events.start(async (batch) => onEvents(batch));
+      return { id, stream };
+    };
+    return { conversation, snapshot: events.snapshot, open, stop: () => events.stop() };
+  };
+  return {
+    async prompt(request, context) {
+      sweep();
+      const watched = await watching(request.agentId, context);
+      const busy = Boolean(watched.snapshot.run);
+      const response = await host.send(
+        {
+          text: request.text,
+          whenBusy: request.whenBusy,
+          requestId: null,
+          ...request.agentId ? { agentId: request.agentId } : {}
+        },
+        context
+      );
+      if (!response.accepted) {
+        await watched.stop();
+        return {
+          ok: false,
+          code: response.error.code === "busy" ? "EBUSY" : "EIO",
+          message: response.error.message
+        };
+      }
+      const submission = Number(response.submissionId);
+      const record = await (await host.harness.submission(submission, context))?.status(context);
+      const delivered = deliveredOf(record, request.whenBusy, busy);
+      const follower = new Follower(
+        new Mapper(request.thinking),
+        watched.snapshot.entries,
+        submission,
+        delivered,
+        record
+      );
+      const { id, stream } = watched.open((batch) => {
+        const ended = follower.take(batch);
+        stream.push(follower.drain());
+        if (ended) void stream.finish();
+      });
+      return { ok: true, stream: id, delivered, head: null, gap: false };
+    },
+    async watch(request, context) {
+      sweep();
+      const watched = await watching(request.agentId, context);
+      const partial = watched.snapshot.generation?.message;
+      const all = replayOf(watched.snapshot.entries, partial, request.thinking);
+      const head = headOf(all);
+      const at = request.since === null ? -1 : all.findIndex((e) => idOf(e) === request.since);
+      const gap = request.since !== null && at < 0;
+      const mapper = new Mapper(request.thinking);
+      for (const entry of watched.snapshot.entries) mapper.entry(entry);
+      mapper.partial(partial);
+      const { id, stream } = watched.open(
+        (batch) => stream.push(batch.flatMap((event) => followed(mapper, event)))
+      );
+      if (at >= 0) {
+        const own = all[at];
+        const sinceId = idOf(own);
+        let last = at;
+        while (last + 1 < all.length && idOf(all[last + 1]) === sinceId) last++;
+        const replay = own.t === "text" || own.t === "thinking" ? [own] : [];
+        stream.push([...replay, ...all.slice(last + 1)]);
+      }
+      return { ok: true, stream: id, delivered: null, head, gap };
+    },
+    async next(id, waitMs, context) {
+      const stream = streams.get(id);
+      if (!stream) return { events: [], done: true };
+      stream.touched = now();
+      await stream.wait(Math.max(0, Math.min(waitMs, 3e4)));
+      context.abortSignal?.throwIfAborted();
+      const events = stream.queue.splice(0);
+      const done = stream.done && stream.queue.length === 0;
+      if (done) streams.delete(id);
+      return { events, done };
+    },
+    async close(id) {
+      const stream = streams.get(id);
+      streams.delete(id);
+      await stream?.finish();
+    },
+    async abort(agentId, context) {
+      const conversation = await host.conversation(agentId, context);
+      const watched = await watchEvents(host.harness, conversation.id, context);
+      const busy = Boolean(watched.snapshot.run);
+      await watched.stop();
+      if (busy) await conversation.abort(context);
+      return { aborted: busy };
+    },
+    async dispose() {
+      clearInterval(timer);
+      timer = void 0;
+      const all = [...streams.values()];
+      streams.clear();
+      await Promise.all(all.map((stream) => stream.finish()));
+    }
+  };
+}
+export {
+  Follower,
+  IDLE_MS,
+  MAX_QUEUED,
+  createRemote,
+  followed,
+  resync
+};
+//# sourceMappingURL=host.js.map

package/dist/remote/host.js.map

@@ -0,0 +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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",
+  "names": []
+}

package/dist/services.js

@@ -4,11 +4,13 @@ import {
 const AgentControl = defineService("slicc.agent.control");
 const AgentTranscript = defineService("slicc.agent.transcript");
 const AgentSessions = defineService("slicc.agent.sessions");
+const AgentRemoteService = defineService("slicc.agent.remote");
 const AGENT_SESSION = "agent";
 const AgentSettings = defineService("slicc.agent.settings");
 export {
   AGENT_SESSION,
   AgentControl,
+  AgentRemoteService,
   AgentSessions,
   AgentSettings,
   AgentTranscript

package/dist/services.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../src/services.ts"],
-  "sourcesContent": ["import {\n  type Context,\n  defineService,\n  type JsonValue,\n  type ReplicatedState,\n} from '@earendil-works/chord';\nimport type { ConversationView } from '@earendil-works/pi-durable';\nimport type { ChangesView } from './changes/git.ts';\nimport type { FrozenCone } from './freezer/index.ts';\nimport type { MemoryEntry, MemoryScope, MemoryTag } from './memory/format.ts';\nimport type { Sprinkle } from './sprinkles/kind.ts';\n\nexport type SendMode = 'steer' | 'followUp' | 'reject';\n\nexport interface SendRequest {\n  text: string;\n  whenBusy: SendMode;\n  requestId: string | null;\n  agentId?: string | null;\n}\n\nexport interface OperationError {\n  code: string;\n  message: string;\n}\n\nexport type SendResponse =\n  | { accepted: true; submissionId: string; error: null }\n  | { accepted: false; submissionId: null; error: OperationError };\n\nexport type PromptResult =\n  | { status: 'done'; text: string; reason: null }\n  | { status: 'unanswered'; text: null; reason: string };\n\nexport interface AgentControl {\n  send(request: SendRequest, context: Context): Promise<SendResponse>;\n  wait(submissionId: string, context: Context): Promise<PromptResult>;\n  withdraw(\n    submissionId: string,\n    context: Context\n  ): Promise<{ outcome: 'withdrawn' | 'already_placed' | 'not_found' }>;\n  abort(context: Context): Promise<void>;\n  compact(instructions: string | null, context: Context): Promise<SendResponse>;\n  compactAgent(\n    agentId: string,\n    instructions: string | null,\n    context: Context\n  ): Promise<SendResponse>;\n  reset(handoff: string | null, context: Context): Promise<void>;\n  configure(change: AgentSettingsChange, context: Context): Promise<void>;\n  rewind(messageId: string | null, context: Context): Promise<Rewound>;\n  rewindAgent(agentId: string, messageId: string | null, context: Context): Promise<Rewound>;\n  resolveLick(\n    lickId: string,\n    state: 'confirmed' | 'dismissed',\n    context: Context\n  ): Promise<LickResolved>;\n  resolveAgentLick(\n    agentId: string,\n    lickId: string,\n    state: 'confirmed' | 'dismissed',\n    context: Context\n  ): Promise<LickResolved>;\n  webhook(\n    name: string,\n    delivery: WebhookRequest,\n    context: Context\n  ): Promise<{ delivered: boolean }>;\n  stopAgent(agentId: string, context: Context): Promise<void>;\n  selectCone(agentId: string, context: Context): Promise<void>;\n  createCone(name: string, context: Context): Promise<Created>;\n  createScoop(parentId: string, name: string, context: Context): Promise<Created>;\n  drop(agentId: string, context: Context): Promise<Created>;\n  unqueue(\n    agentId: string | null,\n    submissionId: string,\n    context: Context\n  ): Promise<{ outcome: 'withdrawn' | 'already_placed' | 'not_found' }>;\n  sprinkleSend(\n    sprinkleId: string,\n    payload: { action: string; data: JsonValue | null; target: string | null },\n    context: Context\n  ): Promise<{ delivered: boolean }>;\n  sprinkleCall(\n    sprinkleId: string,\n    method: string,\n    args: JsonValue[],\n    context: Context\n  ): Promise<JsonValue>;\n  memorySave(draft: MemoryDraft, context: Context): Promise<MemoryEntry>;\n  memoryRemove(id: string, context: Context): Promise<{ removed: boolean }>;\n  freeze(agentId: string, context: Context): Promise<Created>;\n  newChat(agentId: string, context: Context): Promise<Created>;\n  thaw(frozenId: string, context: Context): Promise<Created>;\n  discard(frozenId: string, context: Context): Promise<Created>;\n  changesOpen(context: Context): Promise<void>;\n  changeAccept(path: string, context: Context): Promise<Created>;\n  changeRevert(path: string, context: Context): Promise<Created>;\n}\n\nexport interface MemoryDraft {\n  id: string | null;\n  scope: string;\n  section: string;\n  title: string;\n  body: string;\n  tag: MemoryTag | null;\n}\n\nexport type Created = { id: string; error: null } | { id: null; error: string };\n\nexport interface AgentSummary {\n  id: string;\n  name: string;\n  kind: 'cone' | 'scoop';\n  parentId: string | null;\n  role: string | null;\n}\n\nexport interface AgentsSummary {\n  active: string;\n  agents: AgentSummary[];\n}\n\nexport type LickResolved =\n  | { done: true; text: string; error: null }\n  | { done: false; text: null; error: string };\n\nexport interface WebhookRequest {\n  id: string | null;\n  headers: Record<string, string>;\n  body: string;\n}\n\nexport type Rewound =\n  | { done: true; text: string; reason: null }\n  | { done: false; text: null; reason: 'busy' | 'no-turn' };\n\nexport interface AgentSettingsChange {\n  model: { provider: string; modelId: string } | null;\n  thinkingLevel: 'off' | 'minimal' | 'low' | 'medium' | 'high' | 'xhigh' | 'max' | null;\n  agentId?: string | null;\n}\n\nexport const AgentControl = defineService<AgentControl>('slicc.agent.control');\n\nexport type Delivered = 'run' | 'steer' | 'follow-up';\n\nexport interface AgentTranscript {\n  readonly state: ReplicatedState<ConversationView>;\n  readonly deliveries: ReplicatedState<Record<string, Delivered>>;\n  readonly agents: ReplicatedState<AgentsSummary>;\n  readonly views: ReplicatedState<Record<string, ConversationView>>;\n  readonly commands: ReplicatedState<Command[]>;\n  readonly sprinkles: ReplicatedState<Sprinkle[]>;\n  readonly memories: ReplicatedState<MemoryEntry[]>;\n  readonly memoryScopes: ReplicatedState<MemoryScope[]>;\n  readonly frozen: ReplicatedState<FrozenCone[]>;\n  readonly changes: ReplicatedState<ChangesView>;\n}\n\nexport interface Command {\n  name: string;\n  description: string;\n  kind: 'prompt' | 'skill';\n}\n\nexport const AgentTranscript = defineService<AgentTranscript>('slicc.agent.transcript');\n\nexport interface AgentSessions {\n  attach(sessionId: string, context: Context): Promise<void>;\n  detach(context: Context): Promise<void>;\n}\n\nexport const AgentSessions = defineService<AgentSessions>('slicc.agent.sessions');\n\nexport const AGENT_SESSION = 'agent';\n\nexport interface ModelChoice {\n  id: string;\n  label: string;\n  provider: string;\n  kind: 'chat' | 'classifier';\n  reasoning: boolean;\n  images?: boolean;\n  contextWindow: number;\n}\n\nexport interface AccountState {\n  id: string;\n  provider: string;\n  identity: string;\n  status: 'connected' | 'disconnected';\n  auth: 'api-key' | 'oauth';\n  needs: 'cors-free-transport' | null;\n}\n\nexport interface BudgetState {\n  provider: string;\n  percent: number;\n  window: 'weekly';\n  resets: string;\n}\n\nexport interface SignIn {\n  clientId: string;\n  scopes: string;\n  imsEnvironment: string;\n}\n\nexport interface SettingsState {\n  models: ModelChoice[];\n  accounts: AccountState[];\n  budget?: BudgetState | null;\n}\n\nexport interface AgentSettings {\n  readonly state: ReplicatedState<SettingsState>;\n  connect(\n    providerId: string,\n    secret: string,\n    region: string | null,\n    context: Context\n  ): Promise<void>;\n  disconnect(providerId: string, context: Context): Promise<void>;\n  signIn(providerId: string, context: Context): Promise<SignIn | null>;\n}\n\nexport const AgentSettings = defineService<AgentSettings>('slicc.agent.settings');\n"],
-  "mappings": "AAAA;AAAA,EAEE;AAAA,OAGK;AA2IA,MAAM,eAAe,cAA4B,qBAAqB;AAuBtE,MAAM,kBAAkB,cAA+B,wBAAwB;AAO/E,MAAM,gBAAgB,cAA6B,sBAAsB;AAEzE,MAAM,gBAAgB;AAoDtB,MAAM,gBAAgB,cAA6B,sBAAsB;",
+  "sourcesContent": ["import {\n  type Context,\n  defineService,\n  type JsonValue,\n  type ReplicatedState,\n} from '@earendil-works/chord';\nimport type { ConversationView } from '@earendil-works/pi-durable';\nimport type { ChangesView } from './changes/git.ts';\nimport type { FrozenCone } from './freezer/index.ts';\nimport type { MemoryEntry, MemoryScope, MemoryTag } from './memory/format.ts';\nimport type { AgentRemote } from './remote/host.ts';\nimport type { Sprinkle } from './sprinkles/kind.ts';\n\nexport type SendMode = 'steer' | 'followUp' | 'reject';\n\nexport interface SendRequest {\n  text: string;\n  whenBusy: SendMode;\n  requestId: string | null;\n  agentId?: string | null;\n}\n\nexport interface OperationError {\n  code: string;\n  message: string;\n}\n\nexport type SendResponse =\n  | { accepted: true; submissionId: string; error: null }\n  | { accepted: false; submissionId: null; error: OperationError };\n\nexport type PromptResult =\n  | { status: 'done'; text: string; reason: null }\n  | { status: 'unanswered'; text: null; reason: string };\n\nexport interface AgentControl {\n  send(request: SendRequest, context: Context): Promise<SendResponse>;\n  wait(submissionId: string, context: Context): Promise<PromptResult>;\n  withdraw(\n    submissionId: string,\n    context: Context\n  ): Promise<{ outcome: 'withdrawn' | 'already_placed' | 'not_found' }>;\n  abort(context: Context): Promise<void>;\n  compact(instructions: string | null, context: Context): Promise<SendResponse>;\n  compactAgent(\n    agentId: string,\n    instructions: string | null,\n    context: Context\n  ): Promise<SendResponse>;\n  reset(handoff: string | null, context: Context): Promise<void>;\n  configure(change: AgentSettingsChange, context: Context): Promise<void>;\n  rewind(messageId: string | null, context: Context): Promise<Rewound>;\n  rewindAgent(agentId: string, messageId: string | null, context: Context): Promise<Rewound>;\n  resolveLick(\n    lickId: string,\n    state: 'confirmed' | 'dismissed',\n    context: Context\n  ): Promise<LickResolved>;\n  resolveAgentLick(\n    agentId: string,\n    lickId: string,\n    state: 'confirmed' | 'dismissed',\n    context: Context\n  ): Promise<LickResolved>;\n  webhook(\n    name: string,\n    delivery: WebhookRequest,\n    context: Context\n  ): Promise<{ delivered: boolean }>;\n  stopAgent(agentId: string, context: Context): Promise<void>;\n  selectCone(agentId: string, context: Context): Promise<void>;\n  createCone(name: string, context: Context): Promise<Created>;\n  createScoop(parentId: string, name: string, context: Context): Promise<Created>;\n  drop(agentId: string, context: Context): Promise<Created>;\n  unqueue(\n    agentId: string | null,\n    submissionId: string,\n    context: Context\n  ): Promise<{ outcome: 'withdrawn' | 'already_placed' | 'not_found' }>;\n  sprinkleSend(\n    sprinkleId: string,\n    payload: { action: string; data: JsonValue | null; target: string | null },\n    context: Context\n  ): Promise<{ delivered: boolean }>;\n  sprinkleCall(\n    sprinkleId: string,\n    method: string,\n    args: JsonValue[],\n    context: Context\n  ): Promise<JsonValue>;\n  memorySave(draft: MemoryDraft, context: Context): Promise<MemoryEntry>;\n  memoryRemove(id: string, context: Context): Promise<{ removed: boolean }>;\n  freeze(agentId: string, context: Context): Promise<Created>;\n  newChat(agentId: string, context: Context): Promise<Created>;\n  thaw(frozenId: string, context: Context): Promise<Created>;\n  discard(frozenId: string, context: Context): Promise<Created>;\n  changesOpen(context: Context): Promise<void>;\n  changeAccept(path: string, context: Context): Promise<Created>;\n  changeRevert(path: string, context: Context): Promise<Created>;\n}\n\nexport interface MemoryDraft {\n  id: string | null;\n  scope: string;\n  section: string;\n  title: string;\n  body: string;\n  tag: MemoryTag | null;\n}\n\nexport type Created = { id: string; error: null } | { id: null; error: string };\n\nexport interface AgentSummary {\n  id: string;\n  name: string;\n  kind: 'cone' | 'scoop';\n  parentId: string | null;\n  role: string | null;\n}\n\nexport interface AgentsSummary {\n  active: string;\n  agents: AgentSummary[];\n}\n\nexport type LickResolved =\n  | { done: true; text: string; error: null }\n  | { done: false; text: null; error: string };\n\nexport interface WebhookRequest {\n  id: string | null;\n  headers: Record<string, string>;\n  body: string;\n}\n\nexport type Rewound =\n  | { done: true; text: string; reason: null }\n  | { done: false; text: null; reason: 'busy' | 'no-turn' };\n\nexport interface AgentSettingsChange {\n  model: { provider: string; modelId: string } | null;\n  thinkingLevel: 'off' | 'minimal' | 'low' | 'medium' | 'high' | 'xhigh' | 'max' | null;\n  agentId?: string | null;\n}\n\nexport const AgentControl = defineService<AgentControl>('slicc.agent.control');\n\nexport type Delivered = 'run' | 'steer' | 'follow-up';\n\nexport interface AgentTranscript {\n  readonly state: ReplicatedState<ConversationView>;\n  readonly deliveries: ReplicatedState<Record<string, Delivered>>;\n  readonly agents: ReplicatedState<AgentsSummary>;\n  readonly views: ReplicatedState<Record<string, ConversationView>>;\n  readonly commands: ReplicatedState<Command[]>;\n  readonly sprinkles: ReplicatedState<Sprinkle[]>;\n  readonly memories: ReplicatedState<MemoryEntry[]>;\n  readonly memoryScopes: ReplicatedState<MemoryScope[]>;\n  readonly frozen: ReplicatedState<FrozenCone[]>;\n  readonly changes: ReplicatedState<ChangesView>;\n}\n\nexport interface Command {\n  name: string;\n  description: string;\n  kind: 'prompt' | 'skill';\n}\n\nexport const AgentTranscript = defineService<AgentTranscript>('slicc.agent.transcript');\n\nexport interface AgentSessions {\n  attach(sessionId: string, context: Context): Promise<void>;\n  detach(context: Context): Promise<void>;\n}\n\nexport const AgentSessions = defineService<AgentSessions>('slicc.agent.sessions');\n\nexport const AgentRemoteService = defineService<AgentRemote>('slicc.agent.remote');\n\nexport const AGENT_SESSION = 'agent';\n\nexport interface ModelChoice {\n  id: string;\n  label: string;\n  provider: string;\n  kind: 'chat' | 'classifier';\n  reasoning: boolean;\n  images?: boolean;\n  contextWindow: number;\n}\n\nexport interface AccountState {\n  id: string;\n  provider: string;\n  identity: string;\n  status: 'connected' | 'disconnected';\n  auth: 'api-key' | 'oauth';\n  needs: 'cors-free-transport' | null;\n}\n\nexport interface BudgetState {\n  provider: string;\n  percent: number;\n  window: 'weekly';\n  resets: string;\n}\n\nexport interface SignIn {\n  clientId: string;\n  scopes: string;\n  imsEnvironment: string;\n}\n\nexport interface SettingsState {\n  models: ModelChoice[];\n  accounts: AccountState[];\n  budget?: BudgetState | null;\n}\n\nexport interface AgentSettings {\n  readonly state: ReplicatedState<SettingsState>;\n  connect(\n    providerId: string,\n    secret: string,\n    region: string | null,\n    context: Context\n  ): Promise<void>;\n  disconnect(providerId: string, context: Context): Promise<void>;\n  signIn(providerId: string, context: Context): Promise<SignIn | null>;\n}\n\nexport const AgentSettings = defineService<AgentSettings>('slicc.agent.settings');\n"],
+  "mappings": "AAAA;AAAA,EAEE;AAAA,OAGK;AA4IA,MAAM,eAAe,cAA4B,qBAAqB;AAuBtE,MAAM,kBAAkB,cAA+B,wBAAwB;AAO/E,MAAM,gBAAgB,cAA6B,sBAAsB;AAEzE,MAAM,qBAAqB,cAA2B,oBAAoB;AAE1E,MAAM,gBAAgB;AAoDtB,MAAM,gBAAgB,cAA6B,sBAAsB;",
   "names": []
 }

package/dist/types/client.d.ts

@@ -3,6 +3,7 @@ import type { ConversationView } from '@earendil-works/pi-durable';
 import type { ChangesView } from './changes/git.ts';
 import type { FrozenCone } from './freezer/index.ts';
 import type { MemoryEntry, MemoryScope } from './memory/format.ts';
+import type { AgentRemote } from './remote/host.ts';
 import { AgentControl, AgentSettings, type AgentsSummary, type Command, type Delivered, type SendMode } from './services.ts';
 import type { Sprinkle } from './sprinkles/kind.ts';
 import { type PortEndpoint } from './wire.ts';
@@ -20,6 +21,7 @@ export interface AgentConnection {
     readonly frozen?: ReplicatedState<FrozenCone[]>;
     readonly changes?: ReplicatedState<ChangesView>;
     readonly settings: AgentSettings;
+    readonly remote?: AgentRemote;
     readonly closed: Promise<Error | undefined>;
     prompt(text: string, whenBusy?: SendMode): Promise<string>;
     close(): Promise<void>;

package/dist/types/page.d.ts

@@ -1,2 +1,3 @@
 export { type AgentConnection, connectAgent } from './client.ts';
 export { AGENT_LOCK, type AgentOwner, type AgentWorker, type KernelSource, type OwnerOptions, startAgent, } from './owner.ts';
+export { type RemoteControl, type RemoteEvent, type RemoteOptions, remoteControl, } from './remote/client.ts';

package/dist/types/remote/client.d.ts

@@ -0,0 +1,30 @@
+import type { AgentConnection } from '../client.ts';
+import type { Delivered, SendMode } from '../services.ts';
+import type { RemoteEvent } from './events.ts';
+export type { RemoteEvent } from './events.ts';
+export declare const POLL_MS = 25000;
+export interface RemoteOptions {
+    agent?: () => string | null;
+}
+export interface RemoteControl {
+    prompt(request: {
+        text: string;
+        whenBusy?: SendMode;
+        thinking?: boolean;
+    }): Promise<{
+        delivered: Delivered;
+        events: AsyncIterable<RemoteEvent>;
+    }>;
+    watch(request?: {
+        since?: string | null;
+        thinking?: boolean;
+    }): Promise<{
+        head: string;
+        gap?: true;
+        events: AsyncIterable<RemoteEvent>;
+    }>;
+    abort(): Promise<{
+        aborted: boolean;
+    }>;
+}
+export declare function remoteControl(connection: Pick<AgentConnection, 'remote'>, options?: RemoteOptions): RemoteControl;

package/dist/types/remote/events.d.ts

@@ -0,0 +1,83 @@
+import type { AgentEvent, EntryRecord } from '@earendil-works/pi-durable';
+import type { Delivered } from '../services.ts';
+export declare const SUMMARY = 200;
+export type EndReason = 'stop' | 'aborted' | 'error';
+export type RemoteEvent = {
+    t: 'user';
+    id: string;
+    text: string;
+    delivered: Delivered;
+} | {
+    t: 'text';
+    id: string;
+    delta: string;
+} | {
+    t: 'thinking';
+    id: string;
+    delta: string;
+} | {
+    t: 'tool';
+    id: string;
+    call: string;
+    name: string;
+    summary: string;
+} | {
+    t: 'tool-result';
+    id: string;
+    call: string;
+    ok: boolean;
+    summary: string;
+} | {
+    t: 'run';
+    state: 'start' | 'end';
+    reason?: EndReason;
+} | {
+    t: 'notice';
+    id: string;
+    text: string;
+} | {
+    t: 'error';
+    id: string;
+    message: string;
+    detail?: string;
+} | {
+    t: 'end';
+    reason: EndReason;
+    message?: string;
+};
+type Json = Record<string, unknown>;
+interface Block {
+    type: string;
+    text?: string;
+    thinking?: string;
+    id?: string;
+    name?: string;
+    arguments?: Json;
+}
+interface ModelMessage {
+    role?: string;
+    content?: string | Block[];
+    timestamp?: number;
+    stopReason?: string;
+    errorMessage?: string;
+    toolCallId?: string;
+    toolName?: string;
+    isError?: boolean;
+}
+export declare function clip(text: string, limit?: number): string;
+export declare function toolSummary(name: string, args: Json | undefined): string;
+export declare function resultSummary(message: ModelMessage): string;
+export declare function keyOf(timestamp: number | undefined, at: number): string;
+export declare class Mapper {
+    #private;
+    reason: EndReason;
+    error: string | undefined;
+    constructor(thinking: boolean);
+    partial(message: ModelMessage | undefined): RemoteEvent[];
+    entry(entry: EntryRecord, delivered?: Delivered): RemoteEvent[];
+    last(): number;
+    event(event: AgentEvent): RemoteEvent[];
+}
+export declare function replayOf(entries: readonly EntryRecord[], partial: ModelMessage | undefined, thinking: boolean): RemoteEvent[];
+export declare function idOf(event: RemoteEvent): string | undefined;
+export {};

package/dist/types/remote/host.d.ts

@@ -0,0 +1,58 @@
+import type { Context } from '@earendil-works/chord';
+import { type AgentEvent, type Conversation, type EntryRecord, type Harness, type SnapshotEvent, type SubmissionId } from '@earendil-works/pi-durable';
+import type { Delivered, SendMode, SendRequest, SendResponse } from '../services.ts';
+import { Mapper, type RemoteEvent } from './events.ts';
+export declare const MAX_QUEUED = 10000;
+export declare const IDLE_MS = 120000;
+export type RemoteOpened = {
+    ok: true;
+    stream: string;
+    delivered: Delivered | null;
+    head: string | null;
+    gap: boolean;
+} | {
+    ok: false;
+    code: string;
+    message: string;
+};
+export interface RemoteBatch {
+    events: RemoteEvent[];
+    done: boolean;
+}
+export interface AgentRemote {
+    prompt(request: {
+        agentId: string | null;
+        text: string;
+        whenBusy: SendMode;
+        thinking: boolean;
+    }, context: Context): Promise<RemoteOpened>;
+    watch(request: {
+        agentId: string | null;
+        since: string | null;
+        thinking: boolean;
+    }, context: Context): Promise<RemoteOpened>;
+    next(stream: string, waitMs: number, context: Context): Promise<RemoteBatch>;
+    close(stream: string, context: Context): Promise<void>;
+    abort(agentId: string | null, context: Context): Promise<{
+        aborted: boolean;
+    }>;
+}
+export interface RemoteHost {
+    harness: Harness;
+    conversation(agentId: string | null, context: Context): Promise<Conversation>;
+    send(request: SendRequest, context: Context): Promise<SendResponse>;
+    now?: () => number;
+    limit?: number;
+    sweepMs?: number;
+}
+export declare function followed(mapper: Mapper, event: AgentEvent): RemoteEvent[];
+export declare function resync(mapper: Mapper, snapshot: SnapshotEvent): RemoteEvent[];
+export declare class Follower {
+    #private;
+    constructor(mapper: Mapper, entries: readonly EntryRecord[], submission: SubmissionId, delivered: Delivered, record: unknown);
+    drain(): RemoteEvent[];
+    take(batch: readonly AgentEvent[]): boolean;
+}
+export declare function createRemote(host: RemoteHost): AgentRemote & {
+    dispose(): Promise<void>;
+};

package/dist/types/services.d.ts

@@ -3,6 +3,7 @@ import type { ConversationView } from '@earendil-works/pi-durable';
 import type { ChangesView } from './changes/git.ts';
 import type { FrozenCone } from './freezer/index.ts';
 import type { MemoryEntry, MemoryScope, MemoryTag } from './memory/format.ts';
+import type { AgentRemote } from './remote/host.ts';
 import type { Sprinkle } from './sprinkles/kind.ts';
 export type SendMode = 'steer' | 'followUp' | 'reject';
 export interface SendRequest {
@@ -161,6 +162,7 @@ export interface AgentSessions {
     detach(context: Context): Promise<void>;
 }
 export declare const AgentSessions: import("@earendil-works/chord").Service<AgentSessions>;
+export declare const AgentRemoteService: import("@earendil-works/chord").Service<AgentRemote>;
 export declare const AGENT_SESSION = "agent";
 export interface ModelChoice {
     id: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ai-ecoverse/slicc-agent",
-  "version": "3.29.1",
+  "version": "3.31.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.47.3",
-    "@ai-ecoverse/wasm-bash": "5.3.0-12",
-    "@ai-ecoverse/wasm-coreutils": "9.7.0-3",
-    "@ai-ecoverse/wasm-git": "2.55.0-13",
+    "@ai-ecoverse/slicc-spectrum": "1.50.0",
+    "@ai-ecoverse/wasm-bash": "5.3.0-17",
+    "@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": {