@ai-ecoverse/slicc-agent 1.2.0 → 2.1.0

package/README.md

@@ -6,18 +6,45 @@ The package ships unbundled ESM: `dist/` holds one file per source file and impo
 
 ## Use
 
+In the agent's dedicated worker:
+
 ```js
-import { connectAgent, openAgent, serveAgent } from '@ai-ecoverse/slicc-agent';
+import { hostAgent, openAgent, openOpfsSqliteStorage, serveConnections } from '@ai-ecoverse/slicc-agent';
+
+const storage = await openOpfsSqliteStorage();
+serveConnections(self, openAgent({ models, model, storage }).then((agent) => hostAgent(agent)));
+```
 
-serveAgent(self, openAgent({ models, model: { provider: 'amazon-bedrock', modelId } }));
+In the page:
 
-const agent = connectAgent(new Worker(workerUrl, { type: 'module' }));
+```js
+import { startAgent } from '@ai-ecoverse/slicc-agent';
+
+const owner = await startAgent({ worker: () => new Worker(workerUrl, { type: 'module' }) });
+const agent = await owner.connect();
+agent.transcript.subscribe((view) => render(view));
 await agent.prompt('What is in /home?');
 ```
 
-- `openAgent({ models, model, storage?, registry?, settings? })` opens a durable Harness (in memory unless `storage` is given) and its root conversation. `prompt(text)` submits an input and resolves with the answer's text.
-- `openOpfsSqliteStorage({ directory?, file? })` keeps the session in wasm SQLite ([`@sqlite.org/sqlite-wasm`](https://www.npmjs.com/package/@sqlite.org/sqlite-wasm)) in an `opfs-sahpool` pool, by default `/.slicc/agent/` in OPFS. It needs a dedicated worker. Only one worker holds a pool at a time: the opener takes a Web Lock per directory and waits until every file of the pool can be opened before sqlite-wasm installs it, because a failed install deletes the pool's directory. `openMemorySqliteStorage()` keeps the same database in memory. Pass either as `storage`.
-- `serveAgent(endpoint, agent)` answers prompts that arrive on a worker or `MessagePort`; `connectAgent(endpoint)` is the page side.
+- `openAgent({ models, model, storage?, registry?, settings? })` opens a durable Harness (in memory unless `storage` is given) and its root conversation, and resumes work a previous worker left unfinished.
+- `openOpfsSqliteStorage({ directory?, file? })` keeps the session in wasm SQLite ([`@sqlite.org/sqlite-wasm`](https://www.npmjs.com/package/@sqlite.org/sqlite-wasm)) in an `opfs-sahpool` pool, by default `/.slicc/agent/` in OPFS. It needs a dedicated worker. Only one worker holds a pool at a time: the opener takes a Web Lock per directory and waits until every file of the pool can be opened before sqlite-wasm installs it, because a failed install deletes the pool's directory. `openMemorySqliteStorage()` keeps the same database in memory.
+- `hostAgent(agent)` serves the agent with pi's protocol: a pi-server with one session, `agent`, whose Chord services are `slicc.agent.control` (send with `whenBusy` `steer`, `followUp` or `reject`, wait, withdraw, abort, compact) and `slicc.agent.transcript` (the conversation's durable view as replicated state). `serveConnections(self, host)` hands it every `MessagePort` the page sends.
+- `startAgent({ worker })` takes the Web Lock `slicc-agent`, so one tab at a time owns the agent worker, and waits while another tab holds it. `connect()` returns an `AgentConnection` (`control`, `transcript`, `prompt()`), `restart()` replaces the worker (durable resumes from SQLite), and `release()` stops it and lets the next tab take over.
+
+### In slicc-spectrum
+
+`@ai-ecoverse/slicc-agent/spectrum` turns an `AgentConnection` into slicc-spectrum's `AgentPort`, so `<slicc-app>` shows the real agent:
+
+```js
+import { createAgentModel } from '@ai-ecoverse/slicc-agent/spectrum';
+
+const agent = await owner.connect();
+app.model = { ...createKernelModel({ kernel, root }), ...createAgentModel(agent) };
+```
+
+The adapter keeps the replicated transcript and maps it on every update. User, assistant and compaction entries become messages; tool results fill in the tool calls they answer; the generation in flight shows as a streaming message; retries and running compactions show as system messages. `busy()` and `queue()` read durable's live and inbox documents. A plain send queues a follow-up, and a steer send steers, as slicc-spectrum's composer asks today. There is one cone so far; scoops, the freezer, licks and questions come later. slicc-spectrum is a peer dependency (≥ 1.7.0) used for types only.
+
+pi-server 1.0.4 calls `unref()` on a `setTimeout` handle when it accepts a connection, which browsers don't have. `PortListener` wraps that one call so its timers get a no-op `unref`.
 
 ## Develop
 

package/dist/client.js

@@ -0,0 +1,64 @@
+import {
+  createRemoteServiceBinding
+} from "@earendil-works/chord";
+import { BACKGROUND_CONTEXT } from "@earendil-works/chord/context";
+import { Client, createClientServiceTransport } from "@earendil-works/pi-client";
+import {
+  AGENT_SESSION,
+  AgentControl,
+  AgentSessions,
+  AgentTranscript
+} from "./services.js";
+import { PortChannel } from "./wire.js";
+function attached(client) {
+  return new Promise((resolve) => {
+    const stop = client.onAttachmentChange(() => {
+      stop();
+      resolve();
+    });
+  });
+}
+async function connectAgent(endpoint, options = {}) {
+  const context = options.context ?? BACKGROUND_CONTEXT;
+  const channel = new PortChannel(endpoint);
+  const serverId = await channel.hello;
+  const client = await Client.connect({ serverId, transportFactory: channel.transport });
+  const server = createRemoteServiceBinding({
+    services: [AgentSessions],
+    transport: createClientServiceTransport(client, () => ({ serverId })),
+    bound: true
+  });
+  const ready = attached(client);
+  await server.use(AgentSessions).attach(AGENT_SESSION, context);
+  await ready;
+  const session = createRemoteServiceBinding({
+    services: [AgentControl, AgentTranscript],
+    transport: createClientServiceTransport(client, () => client.attachment),
+    bound: true
+  });
+  const control = session.use(AgentControl);
+  const transcript = session.use(AgentTranscript).state;
+  await session.ready(context);
+  return {
+    serverId,
+    control,
+    transcript,
+    async prompt(text, whenBusy = "followUp") {
+      const sent = await control.send({ text, whenBusy, requestId: null }, context);
+      if (!sent.accepted) throw new Error(`${sent.error.code}: ${sent.error.message}`);
+      const settled = await control.wait(sent.submissionId, context);
+      if (settled.status !== "done") throw new Error(`unanswered: ${settled.reason}`);
+      return settled.text;
+    },
+    async close() {
+      await server.use(AgentSessions).detach(context);
+      await session.dispose(context);
+      await server.dispose(context);
+      await client.dispose();
+    }
+  };
+}
+export {
+  connectAgent
+};
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -0,0 +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 {\n  AGENT_SESSION,\n  AgentControl,\n  AgentSessions,\n  AgentTranscript,\n  type SendMode,\n} from './services.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  prompt(text: string, whenBusy?: SendMode): Promise<string>;\n  close(): Promise<void>;\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],\n    transport: createClientServiceTransport(client, () => client.attachment),\n    bound: true,\n  });\n  const control = session.use(AgentControl);\n  const transcript = session.use(AgentTranscript).state;\n  await session.ready(context);\n  return {\n    serverId,\n    control,\n    transcript,\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      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;AAErD;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OAEK;AACP,SAAS,mBAAsC;AAU/C,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,eAAe;AAAA,IACxC,WAAW,6BAA6B,QAAQ,MAAM,OAAO,UAAU;AAAA,IACvE,OAAO;AAAA,EACT,CAAC;AACD,QAAM,UAAU,QAAQ,IAAI,YAAY;AACxC,QAAM,aAAa,QAAQ,IAAI,eAAe,EAAE;AAChD,QAAM,QAAQ,MAAM,OAAO;AAC3B,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA;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,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;",
+  "names": []
+}

package/dist/control.js

@@ -0,0 +1,69 @@
+import {
+  AssistantEntry,
+  ConversationBusy
+} from "@earendil-works/pi-durable";
+import { answerText } from "./agent.js";
+function submissionId(value) {
+  const id = Number(value);
+  return /^[1-9][0-9]*$/.test(value) && Number.isSafeInteger(id) ? id : void 0;
+}
+function operationError(error) {
+  if (error instanceof ConversationBusy) return { code: "busy", message: error.message };
+  return { code: "failed", message: error instanceof Error ? error.message : String(error) };
+}
+async function accepted(operation) {
+  try {
+    const result = await operation();
+    const id = typeof result === "number" ? result : result.id;
+    return { accepted: true, submissionId: String(id), error: null };
+  } catch (error) {
+    return { accepted: false, submissionId: null, error: operationError(error) };
+  }
+}
+function createAgentControl(harness, conversation) {
+  return {
+    send: (request, context) => accepted(
+      () => conversation.submit(
+        {
+          type: "input",
+          content: request.text,
+          whenBusy: request.whenBusy,
+          ...request.requestId ? { requestId: request.requestId } : {}
+        },
+        context
+      )
+    ),
+    async wait(id, context) {
+      const parsed = submissionId(id);
+      const submission = parsed === void 0 ? void 0 : await harness.submission(parsed, context);
+      if (!submission) throw new Error(`unknown submission ${id}`);
+      const settled = await submission.wait(context);
+      const { answer, reason } = settled;
+      if (answer === void 0) return { status: "unanswered", text: null, reason: String(reason) };
+      const entry = await harness.commit((tx) => tx.entry(AssistantEntry, answer), context);
+      return { status: "done", text: answerText(entry?.model?.[0]?.content), reason: null };
+    },
+    async withdraw(id, context) {
+      const parsed = submissionId(id);
+      if (parsed === void 0) return { outcome: "not_found" };
+      const result = await harness.abortSubmission(parsed, context, conversation.id);
+      if (result === "aborted") return { outcome: "withdrawn" };
+      return { outcome: result === "not_found" ? "not_found" : "already_placed" };
+    },
+    abort: (context) => conversation.abort(context),
+    compact: (instructions, context) => accepted(() => conversation.compact(instructions ?? void 0, context)),
+    reset: (handoff, context) => conversation.reset(handoff ?? void 0, context),
+    configure: (change, context) => conversation.configure(
+      {
+        ...change.model ? { model: change.model } : {},
+        ...change.thinkingLevel ? { thinkingLevel: change.thinkingLevel } : {}
+      },
+      context
+    )
+  };
+}
+export {
+  createAgentControl,
+  submissionId
+};
+//# sourceMappingURL=control.js.map

package/dist/control.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../src/control.ts"],
+  "sourcesContent": ["import {\n  AssistantEntry,\n  type Conversation,\n  ConversationBusy,\n  type EntryId,\n  type Harness,\n  type SubmissionId,\n} from '@earendil-works/pi-durable';\nimport { answerText } from './agent.ts';\nimport type { AgentControl, OperationError, SendResponse } from './services.ts';\n\nexport function submissionId(value: string): SubmissionId | undefined {\n  const id = Number(value);\n  return /^[1-9][0-9]*$/.test(value) && Number.isSafeInteger(id) ? (id as SubmissionId) : undefined;\n}\n\nfunction operationError(error: unknown): OperationError {\n  if (error instanceof ConversationBusy) return { code: 'busy', message: error.message };\n  return { code: 'failed', message: error instanceof Error ? error.message : String(error) };\n}\n\nasync function accepted(operation: () => Promise<{ id: number } | number>): Promise<SendResponse> {\n  try {\n    const result = await operation();\n    const id = typeof result === 'number' ? result : result.id;\n    return { accepted: true, submissionId: String(id), error: null };\n  } catch (error) {\n    return { accepted: false, submissionId: null, error: operationError(error) };\n  }\n}\n\nexport function createAgentControl(harness: Harness, conversation: Conversation): AgentControl {\n  return {\n    send: (request, context) =>\n      accepted(() =>\n        conversation.submit(\n          {\n            type: 'input',\n            content: request.text,\n            whenBusy: request.whenBusy,\n            ...(request.requestId ? { requestId: request.requestId } : {}),\n          },\n          context\n        )\n      ),\n    async wait(id, context) {\n      const parsed = submissionId(id);\n      const submission =\n        parsed === undefined ? undefined : await harness.submission(parsed, context);\n      if (!submission) throw new Error(`unknown submission ${id}`);\n      const settled = await submission.wait(context);\n      const { answer, reason } = settled as { answer?: EntryId; reason?: string };\n      if (answer === undefined) return { status: 'unanswered', text: null, reason: String(reason) };\n      const entry = await harness.commit((tx) => tx.entry(AssistantEntry, answer), context);\n      return { status: 'done', text: answerText(entry?.model?.[0]?.content), reason: null };\n    },\n    async withdraw(id, context) {\n      const parsed = submissionId(id);\n      if (parsed === undefined) return { outcome: 'not_found' };\n      const result = await harness.abortSubmission(parsed, context, conversation.id);\n      if (result === 'aborted') return { outcome: 'withdrawn' };\n      return { outcome: result === 'not_found' ? 'not_found' : 'already_placed' };\n    },\n    abort: (context) => conversation.abort(context),\n    compact: (instructions, context) =>\n      accepted(() => conversation.compact(instructions ?? undefined, context)),\n    reset: (handoff, context) => conversation.reset(handoff ?? undefined, context),\n    configure: (change, context) =>\n      conversation.configure(\n        {\n          ...(change.model ? { model: change.model } : {}),\n          ...(change.thinkingLevel ? { thinkingLevel: change.thinkingLevel } : {}),\n        },\n        context\n      ),\n  };\n}\n"],
+  "mappings": "AAAA;AAAA,EACE;AAAA,EAEA;AAAA,OAIK;AACP,SAAS,kBAAkB;AAGpB,SAAS,aAAa,OAAyC;AACpE,QAAM,KAAK,OAAO,KAAK;AACvB,SAAO,gBAAgB,KAAK,KAAK,KAAK,OAAO,cAAc,EAAE,IAAK,KAAsB;AAC1F;AAEA,SAAS,eAAe,OAAgC;AACtD,MAAI,iBAAiB,iBAAkB,QAAO,EAAE,MAAM,QAAQ,SAAS,MAAM,QAAQ;AACrF,SAAO,EAAE,MAAM,UAAU,SAAS,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK,EAAE;AAC3F;AAEA,eAAe,SAAS,WAA0E;AAChG,MAAI;AACF,UAAM,SAAS,MAAM,UAAU;AAC/B,UAAM,KAAK,OAAO,WAAW,WAAW,SAAS,OAAO;AACxD,WAAO,EAAE,UAAU,MAAM,cAAc,OAAO,EAAE,GAAG,OAAO,KAAK;AAAA,EACjE,SAAS,OAAO;AACd,WAAO,EAAE,UAAU,OAAO,cAAc,MAAM,OAAO,eAAe,KAAK,EAAE;AAAA,EAC7E;AACF;AAEO,SAAS,mBAAmB,SAAkB,cAA0C;AAC7F,SAAO;AAAA,IACL,MAAM,CAAC,SAAS,YACd;AAAA,MAAS,MACP,aAAa;AAAA,QACX;AAAA,UACE,MAAM;AAAA,UACN,SAAS,QAAQ;AAAA,UACjB,UAAU,QAAQ;AAAA,UAClB,GAAI,QAAQ,YAAY,EAAE,WAAW,QAAQ,UAAU,IAAI,CAAC;AAAA,QAC9D;AAAA,QACA;AAAA,MACF;AAAA,IACF;AAAA,IACF,MAAM,KAAK,IAAI,SAAS;AACtB,YAAM,SAAS,aAAa,EAAE;AAC9B,YAAM,aACJ,WAAW,SAAY,SAAY,MAAM,QAAQ,WAAW,QAAQ,OAAO;AAC7E,UAAI,CAAC,WAAY,OAAM,IAAI,MAAM,sBAAsB,EAAE,EAAE;AAC3D,YAAM,UAAU,MAAM,WAAW,KAAK,OAAO;AAC7C,YAAM,EAAE,QAAQ,OAAO,IAAI;AAC3B,UAAI,WAAW,OAAW,QAAO,EAAE,QAAQ,cAAc,MAAM,MAAM,QAAQ,OAAO,MAAM,EAAE;AAC5F,YAAM,QAAQ,MAAM,QAAQ,OAAO,CAAC,OAAO,GAAG,MAAM,gBAAgB,MAAM,GAAG,OAAO;AACpF,aAAO,EAAE,QAAQ,QAAQ,MAAM,WAAW,OAAO,QAAQ,CAAC,GAAG,OAAO,GAAG,QAAQ,KAAK;AAAA,IACtF;AAAA,IACA,MAAM,SAAS,IAAI,SAAS;AAC1B,YAAM,SAAS,aAAa,EAAE;AAC9B,UAAI,WAAW,OAAW,QAAO,EAAE,SAAS,YAAY;AACxD,YAAM,SAAS,MAAM,QAAQ,gBAAgB,QAAQ,SAAS,aAAa,EAAE;AAC7E,UAAI,WAAW,UAAW,QAAO,EAAE,SAAS,YAAY;AACxD,aAAO,EAAE,SAAS,WAAW,cAAc,cAAc,iBAAiB;AAAA,IAC5E;AAAA,IACA,OAAO,CAAC,YAAY,aAAa,MAAM,OAAO;AAAA,IAC9C,SAAS,CAAC,cAAc,YACtB,SAAS,MAAM,aAAa,QAAQ,gBAAgB,QAAW,OAAO,CAAC;AAAA,IACzE,OAAO,CAAC,SAAS,YAAY,aAAa,MAAM,WAAW,QAAW,OAAO;AAAA,IAC7E,WAAW,CAAC,QAAQ,YAClB,aAAa;AAAA,MACX;AAAA,QACE,GAAI,OAAO,QAAQ,EAAE,OAAO,OAAO,MAAM,IAAI,CAAC;AAAA,QAC9C,GAAI,OAAO,gBAAgB,EAAE,eAAe,OAAO,cAAc,IAAI,CAAC;AAAA,MACxE;AAAA,MACA;AAAA,IACF;AAAA,EACJ;AACF;",
+  "names": []
+}

package/dist/host.js

@@ -0,0 +1,82 @@
+import {
+  createRemoteServiceEndpoint,
+  RemoteServiceProvider
+} from "@earendil-works/chord";
+import { BACKGROUND_CONTEXT } from "@earendil-works/chord/context";
+import {
+  Server,
+  SessionNotFoundError
+} from "@earendil-works/pi-server";
+import { createAgentControl } from "./control.js";
+import { AGENT_SESSION, AgentControl, AgentSessions, AgentTranscript } from "./services.js";
+import { PortListener } from "./wire.js";
+function endpointFor(provider) {
+  const endpoint = createRemoteServiceEndpoint(provider);
+  return {
+    invokeService: (call, publish, context) => endpoint.invoke(call, (id, update) => publish(id, update, context), context),
+    release: () => endpoint.dispose()
+  };
+}
+function sessionServices(provider) {
+  return {
+    attachClient: () => endpointFor(provider),
+    close: async () => {
+    }
+  };
+}
+function serverServices() {
+  return {
+    attachClient(presentation) {
+      const provider = new RemoteServiceProvider([{ service: AgentSessions, mode: "singleton" }]);
+      provider.provide(AgentSessions, {
+        attach: (sessionId, context) => presentation.attachSession(sessionId, context),
+        detach: (context) => presentation.detachSession(context)
+      });
+      const attachment = endpointFor(provider);
+      return {
+        invokeService: attachment.invokeService,
+        release(context) {
+          attachment.release(context);
+          provider.dispose();
+        }
+      };
+    }
+  };
+}
+async function hostAgent(agent, options = {}) {
+  const context = options.context ?? BACKGROUND_CONTEXT;
+  const serverId = options.serverId ?? crypto.randomUUID();
+  const state = await agent.root.viewState(context);
+  const provider = new RemoteServiceProvider([
+    { service: AgentControl, mode: "singleton" },
+    { service: AgentTranscript, mode: "singleton" }
+  ]);
+  provider.provide(AgentControl, createAgentControl(agent.harness, agent.root));
+  provider.provide(AgentTranscript, { state });
+  const host = {
+    serverServices: serverServices(),
+    async resolveSession(sessionId) {
+      if (sessionId !== AGENT_SESSION)
+        throw new SessionNotFoundError(`unknown session ${sessionId}`);
+      return { id: sessionId };
+    },
+    openSession: async () => sessionServices(provider)
+  };
+  const listener = new PortListener(serverId);
+  const server = await new Server(host, { serverId, listeners: [listener] }).start();
+  return {
+    serverId,
+    agent,
+    connect: (endpoint) => listener.connect(endpoint),
+    async close() {
+      await server.close();
+      provider.dispose();
+      state.dispose();
+      await agent.close();
+    }
+  };
+}
+export {
+  hostAgent
+};
+//# sourceMappingURL=host.js.map

package/dist/host.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../src/host.ts"],
+  "sourcesContent": ["import {\n  type Context,\n  createRemoteServiceEndpoint,\n  RemoteServiceProvider,\n} from '@earendil-works/chord';\nimport { BACKGROUND_CONTEXT } from '@earendil-works/chord/context';\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 { createAgentControl } from './control.ts';\nimport { AGENT_SESSION, AgentControl, AgentSessions, AgentTranscript } from './services.ts';\nimport { type PortEndpoint, PortListener } 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\nexport async function hostAgent(\n  agent: Agent,\n  options: { serverId?: string; context?: Context } = {}\n): Promise<AgentHost> {\n  const context = options.context ?? BACKGROUND_CONTEXT;\n  const serverId = options.serverId ?? crypto.randomUUID();\n  const state = await agent.root.viewState(context);\n  const provider = new RemoteServiceProvider([\n    { service: AgentControl, mode: 'singleton' },\n    { service: AgentTranscript, mode: 'singleton' },\n  ]);\n  provider.provide(AgentControl, createAgentControl(agent.harness, agent.root));\n  provider.provide(AgentTranscript, { state });\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      state.dispose();\n      await agent.close();\n    },\n  };\n}\n"],
+  "mappings": "AAAA;AAAA,EAEE;AAAA,EACA;AAAA,OACK;AACP,SAAS,0BAA0B;AACnC;AAAA,EAIE;AAAA,EAEA;AAAA,OACK;AAEP,SAAS,0BAA0B;AACnC,SAAS,eAAe,cAAc,eAAe,uBAAuB;AAC5E,SAA4B,oBAAoB;AAShD,SAAS,YAAY,UAA0D;AAC7E,QAAM,WAAW,4BAA4B,QAAQ;AACrD,SAAO;AAAA,IACL,eAAe,CAAC,MAAM,SAAS,YAC7B,SAAS,OAAO,MAAM,CAAC,IAAI,WAAW,QAAQ,IAAI,QAAQ,OAAO,GAAG,OAAO;AAAA,IAC7E,SAAS,MAAM,SAAS,QAAQ;AAAA,EAClC;AACF;AAEA,SAAS,gBAAgB,UAAsD;AAC7E,SAAO;AAAA,IACL,cAAc,MAAM,YAAY,QAAQ;AAAA,IACxC,OAAO,YAAY;AAAA,IAAC;AAAA,EACtB;AACF;AAEA,SAAS,iBAA0C;AACjD,SAAO;AAAA,IACL,aAAa,cAAc;AACzB,YAAM,WAAW,IAAI,sBAAsB,CAAC,EAAE,SAAS,eAAe,MAAM,YAAY,CAAC,CAAC;AAC1F,eAAS,QAAQ,eAAe;AAAA,QAC9B,QAAQ,CAAC,WAAW,YAAY,aAAa,cAAc,WAAW,OAAO;AAAA,QAC7E,QAAQ,CAAC,YAAY,aAAa,cAAc,OAAO;AAAA,MACzD,CAAC;AACD,YAAM,aAAa,YAAY,QAAQ;AACvC,aAAO;AAAA,QACL,eAAe,WAAW;AAAA,QAC1B,QAAQ,SAAS;AACf,qBAAW,QAAQ,OAAO;AAC1B,mBAAS,QAAQ;AAAA,QACnB;AAAA,MACF;AAAA,IACF;AAAA,EACF;AACF;AAEA,eAAsB,UACpB,OACA,UAAoD,CAAC,GACjC;AACpB,QAAM,UAAU,QAAQ,WAAW;AACnC,QAAM,WAAW,QAAQ,YAAY,OAAO,WAAW;AACvD,QAAM,QAAQ,MAAM,MAAM,KAAK,UAAU,OAAO;AAChD,QAAM,WAAW,IAAI,sBAAsB;AAAA,IACzC,EAAE,SAAS,cAAc,MAAM,YAAY;AAAA,IAC3C,EAAE,SAAS,iBAAiB,MAAM,YAAY;AAAA,EAChD,CAAC;AACD,WAAS,QAAQ,cAAc,mBAAmB,MAAM,SAAS,MAAM,IAAI,CAAC;AAC5E,WAAS,QAAQ,iBAAiB,EAAE,MAAM,CAAC;AAC3C,QAAM,OAAmB;AAAA,IACvB,gBAAgB,eAAe;AAAA,IAC/B,MAAM,eAAe,WAAW;AAC9B,UAAI,cAAc;AAChB,cAAM,IAAI,qBAAqB,mBAAmB,SAAS,EAAE;AAC/D,aAAO,EAAE,IAAI,UAAU;AAAA,IACzB;AAAA,IACA,aAAa,YAAY,gBAAgB,QAAQ;AAAA,EACnD;AACA,QAAM,WAAW,IAAI,aAAa,QAAQ;AAC1C,QAAM,SAAS,MAAM,IAAI,OAAO,MAAM,EAAE,UAAU,WAAW,CAAC,QAAQ,EAAE,CAAC,EAAE,MAAM;AACjF,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA,SAAS,CAAC,aAAa,SAAS,QAAQ,QAAQ;AAAA,IAChD,MAAM,QAAQ;AACZ,YAAM,OAAO,MAAM;AACnB,eAAS,QAAQ;AACjB,YAAM,QAAQ;AACd,YAAM,MAAM,MAAM;AAAA,IACpB;AAAA,EACF;AACF;",
+  "names": []
+}

package/dist/index.js

@@ -1,22 +1,44 @@
 import { answerText, openAgent } from "./agent.js";
+import { connectAgent } from "./client.js";
+import { createAgentControl } from "./control.js";
+import { hostAgent } from "./host.js";
 import {
-  connectAgent,
-  serveAgent
-} from "./port.js";
+  AGENT_LOCK,
+  startAgent
+} from "./owner.js";
+import {
+  AGENT_SESSION,
+  AgentControl,
+  AgentSessions,
+  AgentTranscript
+} from "./services.js";
 import {
   AGENT_DIRECTORY,
   openMemorySqliteStorage,
   openOpfsSqliteStorage,
   WasmSqliteDatabase
 } from "./sqlite.js";
+import { PortChannel, PortListener, withUnrefTimers } from "./wire.js";
+import { serveConnections } from "./worker.js";
 export {
   AGENT_DIRECTORY,
+  AGENT_LOCK,
+  AGENT_SESSION,
+  AgentControl,
+  AgentSessions,
+  AgentTranscript,
+  PortChannel,
+  PortListener,
   WasmSqliteDatabase,
   answerText,
   connectAgent,
+  createAgentControl,
+  hostAgent,
   openAgent,
   openMemorySqliteStorage,
   openOpfsSqliteStorage,
-  serveAgent
+  serveConnections,
+  startAgent,
+  withUnrefTimers
 };
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../src/index.ts"],
-  "sourcesContent": ["export { type Agent, type AgentOptions, answerText, openAgent } from './agent.ts';\nexport {\n  type AgentClient,\n  type AgentReply,\n  type AgentRequest,\n  connectAgent,\n  type MessageEndpoint,\n  serveAgent,\n} from './port.ts';\nexport {\n  AGENT_DIRECTORY,\n  type OpfsSqliteOptions,\n  openMemorySqliteStorage,\n  openOpfsSqliteStorage,\n  WasmSqliteDatabase,\n} from './sqlite.ts';\n"],
-  "mappings": "AAAA,SAAwC,YAAY,iBAAiB;AACrE;AAAA,EAIE;AAAA,EAEA;AAAA,OACK;AACP;AAAA,EACE;AAAA,EAEA;AAAA,EACA;AAAA,EACA;AAAA,OACK;",
+  "sourcesContent": ["export { type Agent, type AgentOptions, answerText, openAgent } from './agent.ts';\nexport { type AgentConnection, connectAgent } from './client.ts';\nexport { createAgentControl } from './control.ts';\nexport { type AgentHost, hostAgent } from './host.ts';\nexport {\n  AGENT_LOCK,\n  type AgentOwner,\n  type AgentWorker,\n  type OwnerOptions,\n  startAgent,\n} from './owner.ts';\nexport {\n  AGENT_SESSION,\n  AgentControl,\n  AgentSessions,\n  type AgentSettingsChange,\n  AgentTranscript,\n  type OperationError,\n  type PromptResult,\n  type SendMode,\n  type SendRequest,\n  type SendResponse,\n} from './services.ts';\nexport {\n  AGENT_DIRECTORY,\n  type OpfsSqliteOptions,\n  openMemorySqliteStorage,\n  openOpfsSqliteStorage,\n  WasmSqliteDatabase,\n} from './sqlite.ts';\nexport { PortChannel, type PortEndpoint, PortListener, withUnrefTimers } from './wire.ts';\nexport { serveConnections, type WorkerScope } from './worker.ts';\n"],
+  "mappings": "AAAA,SAAwC,YAAY,iBAAiB;AACrE,SAA+B,oBAAoB;AACnD,SAAS,0BAA0B;AACnC,SAAyB,iBAAiB;AAC1C;AAAA,EACE;AAAA,EAIA;AAAA,OACK;AACP;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EAEA;AAAA,OAMK;AACP;AAAA,EACE;AAAA,EAEA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AACP,SAAS,aAAgC,cAAc,uBAAuB;AAC9E,SAAS,wBAA0C;",
   "names": []
 }

package/dist/owner.js

@@ -0,0 +1,34 @@
+import { connectAgent } from "./client.js";
+import { holdLock } from "./opfs-pool.js";
+const AGENT_LOCK = "slicc-agent";
+async function startAgent(options) {
+  const release = await holdLock(options.locks ?? navigator.locks, AGENT_LOCK);
+  const channel = options.channel ?? (() => new MessageChannel());
+  let worker;
+  try {
+    worker = options.worker();
+  } catch (error) {
+    release();
+    throw error;
+  }
+  return {
+    connect() {
+      const { port1, port2 } = channel();
+      worker.postMessage({ connect: port2 }, [port2]);
+      return connectAgent(port1);
+    },
+    restart() {
+      worker.terminate();
+      worker = options.worker();
+    },
+    release() {
+      worker.terminate();
+      release();
+    }
+  };
+}
+export {
+  AGENT_LOCK,
+  startAgent
+};
+//# sourceMappingURL=owner.js.map

package/dist/owner.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../src/owner.ts"],
+  "sourcesContent": ["import { type AgentConnection, connectAgent } from './client.ts';\nimport { holdLock } from './opfs-pool.ts';\nimport type { PortEndpoint } from './wire.ts';\n\nexport const AGENT_LOCK = 'slicc-agent';\n\nexport interface AgentWorker {\n  postMessage(message: unknown, transfer: Transferable[]): void;\n  terminate(): void;\n}\n\nexport interface AgentOwner {\n  connect(): Promise<AgentConnection>;\n  restart(): void;\n  release(): void;\n}\n\nexport interface OwnerOptions {\n  worker: () => AgentWorker;\n  locks?: LockManager;\n  channel?: () => { port1: PortEndpoint; port2: Transferable };\n}\n\nexport async function startAgent(options: OwnerOptions): Promise<AgentOwner> {\n  const release = await holdLock(options.locks ?? navigator.locks, AGENT_LOCK);\n  const channel = options.channel ?? (() => new MessageChannel());\n  let worker: AgentWorker;\n  try {\n    worker = options.worker();\n  } catch (error) {\n    release();\n    throw error;\n  }\n  return {\n    connect() {\n      const { port1, port2 } = channel();\n      worker.postMessage({ connect: port2 }, [port2]);\n      return connectAgent(port1);\n    },\n    restart() {\n      worker.terminate();\n      worker = options.worker();\n    },\n    release() {\n      worker.terminate();\n      release();\n    },\n  };\n}\n"],
+  "mappings": "AAAA,SAA+B,oBAAoB;AACnD,SAAS,gBAAgB;AAGlB,MAAM,aAAa;AAmB1B,eAAsB,WAAW,SAA4C;AAC3E,QAAM,UAAU,MAAM,SAAS,QAAQ,SAAS,UAAU,OAAO,UAAU;AAC3E,QAAM,UAAU,QAAQ,YAAY,MAAM,IAAI,eAAe;AAC7D,MAAI;AACJ,MAAI;AACF,aAAS,QAAQ,OAAO;AAAA,EAC1B,SAAS,OAAO;AACd,YAAQ;AACR,UAAM;AAAA,EACR;AACA,SAAO;AAAA,IACL,UAAU;AACR,YAAM,EAAE,OAAO,MAAM,IAAI,QAAQ;AACjC,aAAO,YAAY,EAAE,SAAS,MAAM,GAAG,CAAC,KAAK,CAAC;AAC9C,aAAO,aAAa,KAAK;AAAA,IAC3B;AAAA,IACA,UAAU;AACR,aAAO,UAAU;AACjB,eAAS,QAAQ,OAAO;AAAA,IAC1B;AAAA,IACA,UAAU;AACR,aAAO,UAAU;AACjB,cAAQ;AAAA,IACV;AAAA,EACF;AACF;",
+  "names": []
+}

package/dist/services.js

@@ -0,0 +1,12 @@
+import { defineService } from "@earendil-works/chord";
+const AgentControl = defineService("slicc.agent.control");
+const AgentTranscript = defineService("slicc.agent.transcript");
+const AgentSessions = defineService("slicc.agent.sessions");
+const AGENT_SESSION = "agent";
+export {
+  AGENT_SESSION,
+  AgentControl,
+  AgentSessions,
+  AgentTranscript
+};
+//# sourceMappingURL=services.js.map

package/dist/services.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../src/services.ts"],
+  "sourcesContent": ["import { type Context, defineService, type ReplicatedState } from '@earendil-works/chord';\nimport type { ConversationView } from '@earendil-works/pi-durable';\n\nexport type SendMode = 'steer' | 'followUp' | 'reject';\n\nexport interface SendRequest {\n  text: string;\n  whenBusy: SendMode;\n  requestId: 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  reset(handoff: string | null, context: Context): Promise<void>;\n  configure(change: AgentSettingsChange, context: Context): Promise<void>;\n}\n\nexport interface AgentSettingsChange {\n  model: { provider: string; modelId: string } | null;\n  thinkingLevel: 'off' | 'minimal' | 'low' | 'medium' | 'high' | 'xhigh' | 'max' | null;\n}\n\nexport const AgentControl = defineService<AgentControl>('slicc.agent.control');\n\nexport interface AgentTranscript {\n  readonly state: ReplicatedState<ConversationView>;\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"],
+  "mappings": "AAAA,SAAuB,qBAA2C;AA0C3D,MAAM,eAAe,cAA4B,qBAAqB;AAMtE,MAAM,kBAAkB,cAA+B,wBAAwB;AAO/E,MAAM,gBAAgB,cAA6B,sBAAsB;AAEzE,MAAM,gBAAgB;",
+  "names": []
+}

package/dist/spectrum/agent-port.js

@@ -0,0 +1,156 @@
+import { BACKGROUND_CONTEXT } from "@earendil-works/chord/context";
+import { Emitter } from "./emitter.js";
+import { isBusy, queued, toMessages } from "./messages.js";
+const CONE = "cone";
+const thinking = {
+  off: "off",
+  minimal: "low",
+  low: "low",
+  medium: "medium",
+  high: "high",
+  xhigh: "high",
+  max: "high"
+};
+function status(view, messages) {
+  if (isBusy(view)) {
+    const live = view?.docs["pi.live"];
+    return live?.tools?.some((slot) => slot.status === "running") ? "working" : "thinking";
+  }
+  const last = messages.at(-1);
+  return last?.role === "assistant" && last.status === "error" ? "error" : "idle";
+}
+class AgentAdapter extends Emitter {
+  #connection;
+  #ready;
+  #messages = [];
+  constructor(connection) {
+    super();
+    this.#connection = connection;
+    this.#ready = new Promise((resolve) => {
+      connection.transcript.subscribe((view) => {
+        this.#update(view);
+        resolve();
+      });
+    });
+  }
+  #view() {
+    return this.#connection.transcript.value;
+  }
+  #update(view) {
+    const before = this.#messages;
+    this.#messages = toMessages(view);
+    this.emit("agents", this.list());
+    if (before.length !== this.#messages.length) {
+      this.emit("messages", CONE);
+      return;
+    }
+    const changed = this.#messages.filter(
+      (message, index) => JSON.stringify(message) !== JSON.stringify(before[index])
+    );
+    if (changed.length === 1)
+      this.emit("message", { agentId: CONE, message: changed[0] });
+    else if (changed.length > 1) this.emit("messages", CONE);
+  }
+  ready() {
+    return this.#ready;
+  }
+  list() {
+    const doc = this.#view()?.docs["pi.agent"];
+    return [
+      {
+        id: CONE,
+        name: "sliccy",
+        kind: "cone",
+        parentId: null,
+        status: status(this.#view(), this.#messages),
+        model: doc?.model ? `${doc.model.provider}/${doc.model.modelId}` : "",
+        contextFill: 0,
+        unread: 0,
+        thinking: thinking[doc?.thinkingLevel ?? "off"] ?? "off"
+      }
+    ];
+  }
+  active() {
+    return CONE;
+  }
+  select() {
+  }
+  messages() {
+    return this.#messages;
+  }
+  async send(_agentId, input) {
+    const outgoing = typeof input === "string" ? { text: input } : input;
+    const sent = await this.#connection.control.send(
+      {
+        text: outgoing.text,
+        whenBusy: outgoing.mode === "steer" ? "steer" : "followUp",
+        requestId: crypto.randomUUID()
+      },
+      BACKGROUND_CONTEXT
+    );
+    if (!sent.accepted) throw new Error(sent.error.message);
+  }
+  stop() {
+    void this.#connection.control.abort(BACKGROUND_CONTEXT);
+  }
+  busy() {
+    return isBusy(this.#view());
+  }
+  queue() {
+    return queued(this.#view());
+  }
+  unqueue(_agentId, messageId) {
+    void this.#connection.control.withdraw(messageId.replace(/^q/, ""), BACKGROUND_CONTEXT);
+  }
+  suggestion() {
+    return null;
+  }
+  answer() {
+  }
+  resolveLick() {
+  }
+  compact() {
+    void this.#connection.control.compact(null, BACKGROUND_CONTEXT);
+  }
+  clear() {
+    void this.#connection.control.reset(null, BACKGROUND_CONTEXT);
+  }
+  #configure(change) {
+    void this.#connection.control.configure(
+      { model: change.model ?? null, thinkingLevel: change.thinkingLevel ?? null },
+      BACKGROUND_CONTEXT
+    );
+  }
+  setModel(_agentId, model) {
+    const at = model.indexOf("/");
+    if (at <= 0) return;
+    this.#configure({ model: { provider: model.slice(0, at), modelId: model.slice(at + 1) } });
+  }
+  setThinking(_agentId, level) {
+    this.#configure({ thinkingLevel: level });
+  }
+  async older() {
+    return [];
+  }
+  commands() {
+    return [];
+  }
+  createScoop() {
+    throw new Error("Scoops come with a later slicc-agent");
+  }
+  frozen() {
+    return [];
+  }
+  freeze() {
+  }
+  thaw() {
+    return null;
+  }
+  discard() {
+  }
+}
+export {
+  AgentAdapter,
+  CONE
+};
+//# sourceMappingURL=agent-port.js.map

package/dist/spectrum/agent-port.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/spectrum/agent-port.ts"],
+  "sourcesContent": ["import type {\n  Agent,\n  AgentEvents,\n  AgentPort,\n  AgentStatus,\n  FrozenCone,\n  Message,\n  Outgoing,\n  SlashCommand,\n  Thinking,\n  UserMessage,\n} from '@ai-ecoverse/slicc-spectrum/ui';\nimport { BACKGROUND_CONTEXT } from '@earendil-works/chord/context';\nimport type { ConversationView } from '@earendil-works/pi-durable';\nimport type { AgentConnection } from '../client.ts';\nimport type { AgentSettingsChange } from '../services.ts';\nimport { Emitter } from './emitter.ts';\nimport { isBusy, queued, toMessages } from './messages.ts';\n\nexport const CONE = 'cone';\n\nconst thinking: Record<string, Thinking> = {\n  off: 'off',\n  minimal: 'low',\n  low: 'low',\n  medium: 'medium',\n  high: 'high',\n  xhigh: 'high',\n  max: 'high',\n};\n\ninterface AgentDoc {\n  model?: { provider: string; modelId: string };\n  thinkingLevel?: string;\n}\n\nfunction status(view: ConversationView | undefined, messages: readonly Message[]): AgentStatus {\n  if (isBusy(view)) {\n    const live = view?.docs['pi.live'] as { tools?: { status: string }[] } | undefined;\n    return live?.tools?.some((slot) => slot.status === 'running') ? 'working' : 'thinking';\n  }\n  const last = messages.at(-1);\n  return last?.role === 'assistant' && last.status === 'error' ? 'error' : 'idle';\n}\n\nexport class AgentAdapter extends Emitter<AgentEvents> implements AgentPort {\n  readonly #connection: AgentConnection;\n  readonly #ready: Promise<void>;\n  #messages: Message[] = [];\n\n  constructor(connection: AgentConnection) {\n    super();\n    this.#connection = connection;\n    this.#ready = new Promise((resolve) => {\n      connection.transcript.subscribe((view) => {\n        this.#update(view);\n        resolve();\n      });\n    });\n  }\n\n  #view(): ConversationView | undefined {\n    return this.#connection.transcript.value;\n  }\n\n  #update(view: ConversationView): void {\n    const before = this.#messages;\n    this.#messages = toMessages(view);\n    this.emit('agents', this.list());\n    if (before.length !== this.#messages.length) {\n      this.emit('messages', CONE);\n      return;\n    }\n    const changed = this.#messages.filter(\n      (message, index) => JSON.stringify(message) !== JSON.stringify(before[index])\n    );\n    if (changed.length === 1)\n      this.emit('message', { agentId: CONE, message: changed[0] as Message });\n    else if (changed.length > 1) this.emit('messages', CONE);\n  }\n\n  ready(): Promise<void> {\n    return this.#ready;\n  }\n\n  list(): readonly Agent[] {\n    const doc = this.#view()?.docs['pi.agent'] as AgentDoc | undefined;\n    return [\n      {\n        id: CONE,\n        name: 'sliccy',\n        kind: 'cone',\n        parentId: null,\n        status: status(this.#view(), this.#messages),\n        model: doc?.model ? `${doc.model.provider}/${doc.model.modelId}` : '',\n        contextFill: 0,\n        unread: 0,\n        thinking: thinking[doc?.thinkingLevel ?? 'off'] ?? 'off',\n      },\n    ];\n  }\n\n  active(): string {\n    return CONE;\n  }\n\n  select(): void {}\n\n  messages(): readonly Message[] {\n    return this.#messages;\n  }\n\n  async send(_agentId: string, input: string | Outgoing): Promise<void> {\n    const outgoing = typeof input === 'string' ? { text: input } : input;\n    const sent = await this.#connection.control.send(\n      {\n        text: outgoing.text,\n        whenBusy: outgoing.mode === 'steer' ? 'steer' : 'followUp',\n        requestId: crypto.randomUUID(),\n      },\n      BACKGROUND_CONTEXT\n    );\n    if (!sent.accepted) throw new Error(sent.error.message);\n  }\n\n  stop(): void {\n    void this.#connection.control.abort(BACKGROUND_CONTEXT);\n  }\n\n  busy(): boolean {\n    return isBusy(this.#view());\n  }\n\n  queue(): readonly UserMessage[] {\n    return queued(this.#view());\n  }\n\n  unqueue(_agentId: string, messageId: string): void {\n    void this.#connection.control.withdraw(messageId.replace(/^q/, ''), BACKGROUND_CONTEXT);\n  }\n\n  suggestion(): string | null {\n    return null;\n  }\n\n  answer(): void {}\n\n  resolveLick(): void {}\n\n  compact(): void {\n    void this.#connection.control.compact(null, BACKGROUND_CONTEXT);\n  }\n\n  clear(): void {\n    void this.#connection.control.reset(null, BACKGROUND_CONTEXT);\n  }\n\n  #configure(change: Partial<AgentSettingsChange>): void {\n    void this.#connection.control.configure(\n      { model: change.model ?? null, thinkingLevel: change.thinkingLevel ?? null },\n      BACKGROUND_CONTEXT\n    );\n  }\n\n  setModel(_agentId: string, model: string): void {\n    const at = model.indexOf('/');\n    if (at <= 0) return;\n    this.#configure({ model: { provider: model.slice(0, at), modelId: model.slice(at + 1) } });\n  }\n\n  setThinking(_agentId: string, level: Thinking): void {\n    this.#configure({ thinkingLevel: level });\n  }\n\n  async older(): Promise<readonly Message[]> {\n    return [];\n  }\n\n  commands(): readonly SlashCommand[] {\n    return [];\n  }\n\n  createScoop(): Agent {\n    throw new Error('Scoops come with a later slicc-agent');\n  }\n\n  frozen(): readonly FrozenCone[] {\n    return [];\n  }\n\n  freeze(): void {}\n\n  thaw(): Agent | null {\n    return null;\n  }\n\n  discard(): void {}\n}\n"],
+  "mappings": "AAYA,SAAS,0BAA0B;AAInC,SAAS,eAAe;AACxB,SAAS,QAAQ,QAAQ,kBAAkB;AAEpC,MAAM,OAAO;AAEpB,MAAM,WAAqC;AAAA,EACzC,KAAK;AAAA,EACL,SAAS;AAAA,EACT,KAAK;AAAA,EACL,QAAQ;AAAA,EACR,MAAM;AAAA,EACN,OAAO;AAAA,EACP,KAAK;AACP;AAOA,SAAS,OAAO,MAAoC,UAA2C;AAC7F,MAAI,OAAO,IAAI,GAAG;AAChB,UAAM,OAAO,MAAM,KAAK,SAAS;AACjC,WAAO,MAAM,OAAO,KAAK,CAAC,SAAS,KAAK,WAAW,SAAS,IAAI,YAAY;AAAA,EAC9E;AACA,QAAM,OAAO,SAAS,GAAG,EAAE;AAC3B,SAAO,MAAM,SAAS,eAAe,KAAK,WAAW,UAAU,UAAU;AAC3E;AAEO,MAAM,qBAAqB,QAA0C;AAAA,EACjE;AAAA,EACA;AAAA,EACT,YAAuB,CAAC;AAAA,EAExB,YAAY,YAA6B;AACvC,UAAM;AACN,SAAK,cAAc;AACnB,SAAK,SAAS,IAAI,QAAQ,CAAC,YAAY;AACrC,iBAAW,WAAW,UAAU,CAAC,SAAS;AACxC,aAAK,QAAQ,IAAI;AACjB,gBAAQ;AAAA,MACV,CAAC;AAAA,IACH,CAAC;AAAA,EACH;AAAA,EAEA,QAAsC;AACpC,WAAO,KAAK,YAAY,WAAW;AAAA,EACrC;AAAA,EAEA,QAAQ,MAA8B;AACpC,UAAM,SAAS,KAAK;AACpB,SAAK,YAAY,WAAW,IAAI;AAChC,SAAK,KAAK,UAAU,KAAK,KAAK,CAAC;AAC/B,QAAI,OAAO,WAAW,KAAK,UAAU,QAAQ;AAC3C,WAAK,KAAK,YAAY,IAAI;AAC1B;AAAA,IACF;AACA,UAAM,UAAU,KAAK,UAAU;AAAA,MAC7B,CAAC,SAAS,UAAU,KAAK,UAAU,OAAO,MAAM,KAAK,UAAU,OAAO,KAAK,CAAC;AAAA,IAC9E;AACA,QAAI,QAAQ,WAAW;AACrB,WAAK,KAAK,WAAW,EAAE,SAAS,MAAM,SAAS,QAAQ,CAAC,EAAa,CAAC;AAAA,aAC/D,QAAQ,SAAS,EAAG,MAAK,KAAK,YAAY,IAAI;AAAA,EACzD;AAAA,EAEA,QAAuB;AACrB,WAAO,KAAK;AAAA,EACd;AAAA,EAEA,OAAyB;AACvB,UAAM,MAAM,KAAK,MAAM,GAAG,KAAK,UAAU;AACzC,WAAO;AAAA,MACL;AAAA,QACE,IAAI;AAAA,QACJ,MAAM;AAAA,QACN,MAAM;AAAA,QACN,UAAU;AAAA,QACV,QAAQ,OAAO,KAAK,MAAM,GAAG,KAAK,SAAS;AAAA,QAC3C,OAAO,KAAK,QAAQ,GAAG,IAAI,MAAM,QAAQ,IAAI,IAAI,MAAM,OAAO,KAAK;AAAA,QACnE,aAAa;AAAA,QACb,QAAQ;AAAA,QACR,UAAU,SAAS,KAAK,iBAAiB,KAAK,KAAK;AAAA,MACrD;AAAA,IACF;AAAA,EACF;AAAA,EAEA,SAAiB;AACf,WAAO;AAAA,EACT;AAAA,EAEA,SAAe;AAAA,EAAC;AAAA,EAEhB,WAA+B;AAC7B,WAAO,KAAK;AAAA,EACd;AAAA,EAEA,MAAM,KAAK,UAAkB,OAAyC;AACpE,UAAM,WAAW,OAAO,UAAU,WAAW,EAAE,MAAM,MAAM,IAAI;AAC/D,UAAM,OAAO,MAAM,KAAK,YAAY,QAAQ;AAAA,MAC1C;AAAA,QACE,MAAM,SAAS;AAAA,QACf,UAAU,SAAS,SAAS,UAAU,UAAU;AAAA,QAChD,WAAW,OAAO,WAAW;AAAA,MAC/B;AAAA,MACA;AAAA,IACF;AACA,QAAI,CAAC,KAAK,SAAU,OAAM,IAAI,MAAM,KAAK,MAAM,OAAO;AAAA,EACxD;AAAA,EAEA,OAAa;AACX,SAAK,KAAK,YAAY,QAAQ,MAAM,kBAAkB;AAAA,EACxD;AAAA,EAEA,OAAgB;AACd,WAAO,OAAO,KAAK,MAAM,CAAC;AAAA,EAC5B;AAAA,EAEA,QAAgC;AAC9B,WAAO,OAAO,KAAK,MAAM,CAAC;AAAA,EAC5B;AAAA,EAEA,QAAQ,UAAkB,WAAyB;AACjD,SAAK,KAAK,YAAY,QAAQ,SAAS,UAAU,QAAQ,MAAM,EAAE,GAAG,kBAAkB;AAAA,EACxF;AAAA,EAEA,aAA4B;AAC1B,WAAO;AAAA,EACT;AAAA,EAEA,SAAe;AAAA,EAAC;AAAA,EAEhB,cAAoB;AAAA,EAAC;AAAA,EAErB,UAAgB;AACd,SAAK,KAAK,YAAY,QAAQ,QAAQ,MAAM,kBAAkB;AAAA,EAChE;AAAA,EAEA,QAAc;AACZ,SAAK,KAAK,YAAY,QAAQ,MAAM,MAAM,kBAAkB;AAAA,EAC9D;AAAA,EAEA,WAAW,QAA4C;AACrD,SAAK,KAAK,YAAY,QAAQ;AAAA,MAC5B,EAAE,OAAO,OAAO,SAAS,MAAM,eAAe,OAAO,iBAAiB,KAAK;AAAA,MAC3E;AAAA,IACF;AAAA,EACF;AAAA,EAEA,SAAS,UAAkB,OAAqB;AAC9C,UAAM,KAAK,MAAM,QAAQ,GAAG;AAC5B,QAAI,MAAM,EAAG;AACb,SAAK,WAAW,EAAE,OAAO,EAAE,UAAU,MAAM,MAAM,GAAG,EAAE,GAAG,SAAS,MAAM,MAAM,KAAK,CAAC,EAAE,EAAE,CAAC;AAAA,EAC3F;AAAA,EAEA,YAAY,UAAkB,OAAuB;AACnD,SAAK,WAAW,EAAE,eAAe,MAAM,CAAC;AAAA,EAC1C;AAAA,EAEA,MAAM,QAAqC;AACzC,WAAO,CAAC;AAAA,EACV;AAAA,EAEA,WAAoC;AAClC,WAAO,CAAC;AAAA,EACV;AAAA,EAEA,cAAqB;AACnB,UAAM,IAAI,MAAM,sCAAsC;AAAA,EACxD;AAAA,EAEA,SAAgC;AAC9B,WAAO,CAAC;AAAA,EACV;AAAA,EAEA,SAAe;AAAA,EAAC;AAAA,EAEhB,OAAqB;AACnB,WAAO;AAAA,EACT;AAAA,EAEA,UAAgB;AAAA,EAAC;AACnB;",
+  "names": []
+}