@ai-ecoverse/slicc-agent 2.6.3 → 2.8.0

package/README.md

@@ -28,7 +28,7 @@ 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, 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.
+- `hostAgent(agent)` serves the agent with pi's protocol: a pi-server with one session, `agent`, whose Chord services are `slicc.agent.control` (send with `whenBusy` `steer`, `followUp` or `reject`, wait, withdraw, abort, compact) and `slicc.agent.transcript` (the conversation's durable view as replicated state, plus `deliveries`: how each user entry was delivered, `run`, `steer` or `follow-up`, derived by the host from where each send it accepted was placed: after a tool result it steered, queued first it's a follow-up or a late steer per its `whenBusy`, placed at once it started a run). `serveConnections(self, host)` hands it every `MessagePort` the page sends.
 - `@ai-ecoverse/slicc-agent/page` has what the page needs (`startAgent`, `connectAgent`) without the agent's runtime: no pi-durable, pi-ai, providers or SQLite, which load only in the worker. `@ai-ecoverse/slicc-agent/spectrum` is just as light, and a test keeps both that way.
 - `startAgent({ worker })` takes the Web Lock `slicc-agent`, so one tab at a time owns the agent worker, and waits while another tab holds it. `connect()` returns an `AgentConnection` (`control`, `transcript`, `prompt()`), `restart()` replaces the worker (durable resumes from SQLite), and `release()` stops it and lets the next tab take over.
 
@@ -93,7 +93,7 @@ app.model = { ...createKernelModel({ kernel, root }), ...createAgentModel(agent,
 
 `createAgentModel()` returns the `agent` and `settings` ports. Settings keeps the UI preferences in `storage`; model and thinking belong to the conversation, and accounts and models come from the worker.
 
-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 an optional peer dependency (≥ 1.7.0), used for types only, so package managers don't install it next to the 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. A failed generation ends in an error card whose action fits the error: credential errors (an invalid or missing key, 401/403, not authorized) open settings, a model the account can't use offers the model picker, and anything else offers Retry. `busy()` and `queue()` read durable's live and inbox documents. Steering is the default (#4): a send or a steer goes out with `whenBusy: 'steer'`, so while a run is going it joins after the current tool round, and a `queue` send is a follow-up. User messages carry `delivered` from the host's deliveries; entries the host didn't record (from before a reload) count as steered when they follow a tool result. There is one cone so far; scoops, the freezer, licks and questions come later. slicc-spectrum is an optional peer dependency (≥ 1.7.0), used for types only, so package managers don't install it next to the agent.
 
 ## Patched dependencies
 

package/dist/client.js

@@ -38,13 +38,14 @@ async function connectAgent(endpoint, options = {}) {
     bound: true
   });
   const control = session.use(AgentControl);
-  const transcript = session.use(AgentTranscript).state;
+  const { state: transcript, deliveries } = session.use(AgentTranscript);
   const settings = session.use(AgentSettings);
   await session.ready(context);
   return {
     serverId,
     control,
     transcript,
+    deliveries,
     settings,
     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 {\n  AGENT_SESSION,\n  AgentControl,\n  AgentSessions,\n  AgentSettings,\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  readonly settings: AgentSettings;\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, AgentSettings],\n    transport: createClientServiceTransport(client, () => client.attachment),\n    bound: true,\n  });\n  const control = session.use(AgentControl);\n  const transcript = session.use(AgentTranscript).state;\n  const settings = session.use(AgentSettings);\n  await session.ready(context);\n  return {\n    serverId,\n    control,\n    transcript,\n    settings,\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,EACA;AAAA,OAEK;AACP,SAAS,mBAAsC;AAW/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,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,QAAQ,IAAI,eAAe,EAAE;AAChD,QAAM,WAAW,QAAQ,IAAI,aAAa;AAC1C,QAAM,QAAQ,MAAM,OAAO;AAC3B,SAAO;AAAA,IACL;AAAA,IACA;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;",
+  "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  AgentSettings,\n  AgentTranscript,\n  type Delivered,\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  readonly deliveries: ReplicatedState<Record<string, Delivered>>;\n  readonly settings: AgentSettings;\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, AgentSettings],\n    transport: createClientServiceTransport(client, () => client.attachment),\n    bound: true,\n  });\n  const control = session.use(AgentControl);\n  const { state: transcript, deliveries } = session.use(AgentTranscript);\n  const settings = session.use(AgentSettings);\n  await session.ready(context);\n  return {\n    serverId,\n    control,\n    transcript,\n    deliveries,\n    settings,\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,EACA;AAAA,OAGK;AACP,SAAS,mBAAsC;AAY/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,iBAAiB,aAAa;AAAA,IACvD,WAAW,6BAA6B,QAAQ,MAAM,OAAO,UAAU;AAAA,IACvE,OAAO;AAAA,EACT,CAAC;AACD,QAAM,UAAU,QAAQ,IAAI,YAAY;AACxC,QAAM,EAAE,OAAO,YAAY,WAAW,IAAI,QAAQ,IAAI,eAAe;AACrE,QAAM,WAAW,QAAQ,IAAI,aAAa;AAC1C,QAAM,QAAQ,MAAM,OAAO;AAC3B,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA;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

@@ -20,19 +20,24 @@ async function accepted(operation) {
     return { accepted: false, submissionId: null, error: operationError(error) };
   }
 }
-function createAgentControl(harness, conversation) {
+function createAgentControl(harness, conversation, deliveries) {
   return {
-    send: (request, context) => accepted(
-      () => conversation.submit(
-        {
-          type: "input",
-          content: request.text,
-          whenBusy: request.whenBusy,
-          ...request.requestId ? { requestId: request.requestId } : {}
-        },
-        context
-      )
-    ),
+    async send(request, context) {
+      const response = await accepted(
+        () => conversation.submit(
+          {
+            type: "input",
+            content: request.text,
+            whenBusy: request.whenBusy,
+            ...request.requestId ? { requestId: request.requestId } : {}
+          },
+          context
+        )
+      );
+      const id = response.submissionId === null ? void 0 : submissionId(response.submissionId);
+      if (id !== void 0) deliveries?.expect(id, request.whenBusy);
+      return response;
+    },
     async wait(id, context) {
       const parsed = submissionId(id);
       const submission = parsed === void 0 ? void 0 : await harness.submission(parsed, context);

package/dist/control.js.map

@@ -1,7 +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;",
+  "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 { Deliveries } from './deliveries.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(\n  harness: Harness,\n  conversation: Conversation,\n  deliveries?: Deliveries\n): AgentControl {\n  return {\n    async send(request, context) {\n      const response = await 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      const id = response.submissionId === null ? undefined : submissionId(response.submissionId);\n      if (id !== undefined) deliveries?.expect(id, request.whenBusy);\n      return response;\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": "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",
   "names": []
 }

package/dist/deliveries.js

@@ -0,0 +1,48 @@
+import { replicatedState } from "@earendil-works/chord";
+function delivery(view, entry, whenBusy, queued) {
+  const entries = view?.entries ?? [];
+  const at = entries.findIndex((candidate) => Number(candidate.id) === entry);
+  if (at < 0) return void 0;
+  if (entries[at - 1]?.kind === "pi.tool-result") return "steer";
+  if (!queued) return "run";
+  return whenBusy === "followUp" ? "follow-up" : "steer";
+}
+function trackDeliveries(harness, view, context) {
+  const state = replicatedState({});
+  const pending = /* @__PURE__ */ new Map();
+  const settle = async () => {
+    for (const [id, item] of [...pending]) {
+      const record = await (await harness.submission(id, context))?.status(context);
+      if (record?.status === "queued") {
+        item.queued = true;
+        continue;
+      }
+      const entry = record && "entry" in record ? record.entry : void 0;
+      if (entry === void 0) {
+        pending.delete(id);
+        continue;
+      }
+      const delivered = delivery(view.value, Number(entry), item.whenBusy, item.queued);
+      if (!delivered) continue;
+      pending.delete(id);
+      state.change(context, (draft) => {
+        draft[String(entry)] = delivered;
+      });
+    }
+  };
+  const off = view.subscribe(() => void settle().catch(() => void 0));
+  return {
+    state,
+    expect(submissionId, whenBusy) {
+      pending.set(submissionId, { whenBusy, queued: false });
+      void settle().catch(() => void 0);
+    },
+    settle,
+    dispose: off
+  };
+}
+export {
+  delivery,
+  trackDeliveries
+};
+//# sourceMappingURL=deliveries.js.map

package/dist/deliveries.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../src/deliveries.ts"],
+  "sourcesContent": ["import { type Context, type MutableReplicatedState, replicatedState } from '@earendil-works/chord';\nimport type { ConversationView, Harness, SubmissionId } from '@earendil-works/pi-durable';\nimport type { Delivered } from './services.ts';\n\ntype WhenBusy = 'steer' | 'followUp' | 'reject' | undefined;\n\nexport interface Deliveries {\n  readonly state: MutableReplicatedState<Record<string, Delivered>>;\n  expect(submissionId: SubmissionId, whenBusy: WhenBusy): void;\n  settle(): Promise<void>;\n  dispose(): void;\n}\n\nexport function delivery(\n  view: ConversationView | undefined,\n  entry: number,\n  whenBusy: WhenBusy,\n  queued: boolean\n): Delivered | undefined {\n  const entries = view?.entries ?? [];\n  const at = entries.findIndex((candidate) => Number(candidate.id) === entry);\n  if (at < 0) return undefined;\n  if (entries[at - 1]?.kind === 'pi.tool-result') return 'steer';\n  if (!queued) return 'run';\n  return whenBusy === 'followUp' ? 'follow-up' : 'steer';\n}\n\nexport function trackDeliveries(\n  harness: Pick<Harness, 'submission'>,\n  view: {\n    readonly value: ConversationView | undefined;\n    subscribe(listener: () => void): () => void;\n  },\n  context: Context\n): Deliveries {\n  const state = replicatedState<Record<string, Delivered>>({});\n  const pending = new Map<SubmissionId, { whenBusy: WhenBusy; queued: boolean }>();\n  const settle = async () => {\n    for (const [id, item] of [...pending]) {\n      const record = await (await harness.submission(id, context))?.status(context);\n      if (record?.status === 'queued') {\n        item.queued = true;\n        continue;\n      }\n      const entry = record && 'entry' in record ? record.entry : undefined;\n      if (entry === undefined) {\n        pending.delete(id);\n        continue;\n      }\n      const delivered = delivery(view.value, Number(entry), item.whenBusy, item.queued);\n      if (!delivered) continue;\n      pending.delete(id);\n      state.change(context, (draft) => {\n        draft[String(entry)] = delivered;\n      });\n    }\n  };\n  const off = view.subscribe(() => void settle().catch(() => undefined));\n  return {\n    state,\n    expect(submissionId, whenBusy) {\n      pending.set(submissionId, { whenBusy, queued: false });\n      void settle().catch(() => undefined);\n    },\n    settle,\n    dispose: off,\n  };\n}\n"],
+  "mappings": "AAAA,SAAoD,uBAAuB;AAapE,SAAS,SACd,MACA,OACA,UACA,QACuB;AACvB,QAAM,UAAU,MAAM,WAAW,CAAC;AAClC,QAAM,KAAK,QAAQ,UAAU,CAAC,cAAc,OAAO,UAAU,EAAE,MAAM,KAAK;AAC1E,MAAI,KAAK,EAAG,QAAO;AACnB,MAAI,QAAQ,KAAK,CAAC,GAAG,SAAS,iBAAkB,QAAO;AACvD,MAAI,CAAC,OAAQ,QAAO;AACpB,SAAO,aAAa,aAAa,cAAc;AACjD;AAEO,SAAS,gBACd,SACA,MAIA,SACY;AACZ,QAAM,QAAQ,gBAA2C,CAAC,CAAC;AAC3D,QAAM,UAAU,oBAAI,IAA2D;AAC/E,QAAM,SAAS,YAAY;AACzB,eAAW,CAAC,IAAI,IAAI,KAAK,CAAC,GAAG,OAAO,GAAG;AACrC,YAAM,SAAS,OAAO,MAAM,QAAQ,WAAW,IAAI,OAAO,IAAI,OAAO,OAAO;AAC5E,UAAI,QAAQ,WAAW,UAAU;AAC/B,aAAK,SAAS;AACd;AAAA,MACF;AACA,YAAM,QAAQ,UAAU,WAAW,SAAS,OAAO,QAAQ;AAC3D,UAAI,UAAU,QAAW;AACvB,gBAAQ,OAAO,EAAE;AACjB;AAAA,MACF;AACA,YAAM,YAAY,SAAS,KAAK,OAAO,OAAO,KAAK,GAAG,KAAK,UAAU,KAAK,MAAM;AAChF,UAAI,CAAC,UAAW;AAChB,cAAQ,OAAO,EAAE;AACjB,YAAM,OAAO,SAAS,CAAC,UAAU;AAC/B,cAAM,OAAO,KAAK,CAAC,IAAI;AAAA,MACzB,CAAC;AAAA,IACH;AAAA,EACF;AACA,QAAM,MAAM,KAAK,UAAU,MAAM,KAAK,OAAO,EAAE,MAAM,MAAM,MAAS,CAAC;AACrE,SAAO;AAAA,IACL;AAAA,IACA,OAAO,cAAc,UAAU;AAC7B,cAAQ,IAAI,cAAc,EAAE,UAAU,QAAQ,MAAM,CAAC;AACrD,WAAK,OAAO,EAAE,MAAM,MAAM,MAAS;AAAA,IACrC;AAAA,IACA;AAAA,IACA,SAAS;AAAA,EACX;AACF;",
+  "names": []
+}

package/dist/host.js

@@ -9,6 +9,7 @@ import {
   SessionNotFoundError
 } from "@earendil-works/pi-server";
 import { createAgentControl } from "./control.js";
+import { trackDeliveries } from "./deliveries.js";
 import { PortListener } from "./listener.js";
 import {
   AGENT_SESSION,
@@ -67,8 +68,9 @@ async function hostAgent(agent, options = {}) {
     { service: AgentTranscript, mode: "singleton" },
     { service: AgentSettings, mode: "singleton" }
   ]);
-  provider.provide(AgentControl, createAgentControl(agent.harness, agent.root));
-  provider.provide(AgentTranscript, { state });
+  const deliveries = trackDeliveries(agent.harness, state, context);
+  provider.provide(AgentControl, createAgentControl(agent.harness, agent.root, deliveries));
+  provider.provide(AgentTranscript, { state, deliveries: deliveries.state });
   provider.provide(AgentSettings, options.settings ?? noSettings);
   const host = {
     serverServices: serverServices(),
@@ -88,6 +90,7 @@ async function hostAgent(agent, options = {}) {
     async close() {
       await server.close();
       provider.dispose();
+      deliveries.dispose();
       state.dispose();
       await agent.close();
     }

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 {\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 { PortListener } from './listener.ts';\nimport {\n  AGENT_SESSION,\n  AgentControl,\n  AgentSessions,\n  AgentSettings,\n  AgentTranscript,\n} from './services.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};\n\nexport async function hostAgent(\n  agent: Agent,\n  options: { serverId?: string; context?: Context; settings?: AgentSettings } = {}\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    { service: AgentSettings, mode: 'singleton' },\n  ]);\n  provider.provide(AgentControl, createAgentControl(agent.harness, agent.root));\n  provider.provide(AgentTranscript, { state });\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      state.dispose();\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 {\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 { trackDeliveries } from './deliveries.ts';\nimport { PortListener } from './listener.ts';\nimport {\n  AGENT_SESSION,\n  AgentControl,\n  AgentSessions,\n  AgentSettings,\n  AgentTranscript,\n} from './services.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};\n\nexport async function hostAgent(\n  agent: Agent,\n  options: { serverId?: string; context?: Context; settings?: AgentSettings } = {}\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    { service: AgentSettings, mode: 'singleton' },\n  ]);\n  const deliveries = trackDeliveries(agent.harness, state, context);\n  provider.provide(AgentControl, createAgentControl(agent.harness, agent.root, deliveries));\n  provider.provide(AgentTranscript, { state, deliveries: deliveries.state });\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      state.dispose();\n      await agent.close();\n    },\n  };\n}\n"],
+  "mappings": "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",
   "names": []
 }

package/dist/services.js.map

@@ -1,7 +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\nexport interface ModelChoice {\n  id: string;\n  label: string;\n  provider: string;\n  kind: 'chat' | 'classifier';\n  reasoning: 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';\n  needs: 'cors-free-transport' | null;\n}\n\nexport interface SettingsState {\n  models: ModelChoice[];\n  accounts: AccountState[];\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}\n\nexport const AgentSettings = defineService<AgentSettings>('slicc.agent.settings');\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;AAoCtB,MAAM,gBAAgB,cAA6B,sBAAsB;",
+  "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 type Delivered = 'run' | 'steer' | 'follow-up';\n\nexport interface AgentTranscript {\n  readonly state: ReplicatedState<ConversationView>;\n  readonly deliveries: ReplicatedState<Record<string, Delivered>>;\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  contextWindow: number;\n}\n\nexport interface AccountState {\n  id: string;\n  provider: string;\n  identity: string;\n  status: 'connected' | 'disconnected';\n  auth: 'api-key';\n  needs: 'cors-free-transport' | null;\n}\n\nexport interface SettingsState {\n  models: ModelChoice[];\n  accounts: AccountState[];\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}\n\nexport const AgentSettings = defineService<AgentSettings>('slicc.agent.settings');\n"],
+  "mappings": "AAAA,SAAuB,qBAA2C;AA0C3D,MAAM,eAAe,cAA4B,qBAAqB;AAStE,MAAM,kBAAkB,cAA+B,wBAAwB;AAO/E,MAAM,gBAAgB,cAA6B,sBAAsB;AAEzE,MAAM,gBAAgB;AAoCtB,MAAM,gBAAgB,cAA6B,sBAAsB;",
   "names": []
 }

package/dist/spectrum/agent-port.js

@@ -31,6 +31,10 @@ class AgentAdapter extends Emitter {
         this.#update(view);
         resolve();
       });
+      connection.deliveries.subscribe(() => {
+        const view = this.#view();
+        if (view) this.#update(view);
+      });
     });
   }
   #view() {
@@ -38,7 +42,7 @@ class AgentAdapter extends Emitter {
   }
   #update(view) {
     const before = this.#messages;
-    this.#messages = toMessages(view);
+    this.#messages = toMessages(view, this.#connection.deliveries.value);
     this.emit("agents", this.list());
     if (before.length !== this.#messages.length) {
       this.emit("messages", CONE);
@@ -83,7 +87,7 @@ class AgentAdapter extends Emitter {
     const sent = await this.#connection.control.send(
       {
         text: outgoing.text,
-        whenBusy: outgoing.mode === "steer" ? "steer" : "followUp",
+        whenBusy: outgoing.mode === "queue" ? "followUp" : "steer",
         requestId: crypto.randomUUID()
       },
       BACKGROUND_CONTEXT

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

@@ -1,7 +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": "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",
+  "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      connection.deliveries.subscribe(() => {\n        const view = this.#view();\n        if (view) this.#update(view);\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, this.#connection.deliveries.value);\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 === 'queue' ? 'followUp' : 'steer',\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": "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",
   "names": []
 }

package/dist/spectrum/index.js

@@ -1,7 +1,7 @@
 import { AgentAdapter } from "./agent-port.js";
 import { SettingsAdapter } from "./settings-port.js";
 import { AgentAdapter as AgentAdapter2, CONE } from "./agent-port.js";
-import { assistant, isBusy, queued, textOf, toMessages } from "./messages.js";
+import { assistant, errorAction, isBusy, queued, textOf, toMessages } from "./messages.js";
 import { SETTINGS_KEY, SettingsAdapter as SettingsAdapter2 } from "./settings-port.js";
 function createAgentModel(connection, options = {}) {
   const agent = new AgentAdapter(connection);
@@ -17,6 +17,7 @@ export {
   SettingsAdapter2 as SettingsAdapter,
   assistant,
   createAgentModel,
+  errorAction,
   isBusy,
   queued,
   textOf,

package/dist/spectrum/index.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/spectrum/index.ts"],
-  "sourcesContent": ["import type { AgentConnection } from '../client.ts';\nimport { AgentAdapter } from './agent-port.ts';\nimport { SettingsAdapter } from './settings-port.ts';\n\nexport { AgentAdapter, CONE } from './agent-port.ts';\nexport { assistant, isBusy, queued, textOf, toMessages } from './messages.ts';\nexport { SETTINGS_KEY, SettingsAdapter } from './settings-port.ts';\n\nexport function createAgentModel(\n  connection: AgentConnection,\n  options: { storage?: Pick<Storage, 'getItem' | 'setItem'> | null } = {}\n): { agent: AgentAdapter; settings: SettingsAdapter } {\n  const agent = new AgentAdapter(connection);\n  return {\n    agent,\n    settings: new SettingsAdapter(connection.settings, agent, options.storage ?? null),\n  };\n}\n"],
-  "mappings": "AACA,SAAS,oBAAoB;AAC7B,SAAS,uBAAuB;AAEhC,SAAS,gBAAAA,eAAc,YAAY;AACnC,SAAS,WAAW,QAAQ,QAAQ,QAAQ,kBAAkB;AAC9D,SAAS,cAAc,mBAAAC,wBAAuB;AAEvC,SAAS,iBACd,YACA,UAAqE,CAAC,GAClB;AACpD,QAAM,QAAQ,IAAI,aAAa,UAAU;AACzC,SAAO;AAAA,IACL;AAAA,IACA,UAAU,IAAI,gBAAgB,WAAW,UAAU,OAAO,QAAQ,WAAW,IAAI;AAAA,EACnF;AACF;",
+  "sourcesContent": ["import type { AgentConnection } from '../client.ts';\nimport { AgentAdapter } from './agent-port.ts';\nimport { SettingsAdapter } from './settings-port.ts';\n\nexport { AgentAdapter, CONE } from './agent-port.ts';\nexport { assistant, errorAction, isBusy, queued, textOf, toMessages } from './messages.ts';\nexport { SETTINGS_KEY, SettingsAdapter } from './settings-port.ts';\n\nexport function createAgentModel(\n  connection: AgentConnection,\n  options: { storage?: Pick<Storage, 'getItem' | 'setItem'> | null } = {}\n): { agent: AgentAdapter; settings: SettingsAdapter } {\n  const agent = new AgentAdapter(connection);\n  return {\n    agent,\n    settings: new SettingsAdapter(connection.settings, agent, options.storage ?? null),\n  };\n}\n"],
+  "mappings": "AACA,SAAS,oBAAoB;AAC7B,SAAS,uBAAuB;AAEhC,SAAS,gBAAAA,eAAc,YAAY;AACnC,SAAS,WAAW,aAAa,QAAQ,QAAQ,QAAQ,kBAAkB;AAC3E,SAAS,cAAc,mBAAAC,wBAAuB;AAEvC,SAAS,iBACd,YACA,UAAqE,CAAC,GAClB;AACpD,QAAM,QAAQ,IAAI,aAAa,UAAU;AACzC,SAAO;AAAA,IACL;AAAA,IACA,UAAU,IAAI,gBAAgB,WAAW,UAAU,OAAO,QAAQ,WAAW,IAAI;AAAA,EACnF;AACF;",
   "names": ["AgentAdapter", "SettingsAdapter"]
 }

package/dist/spectrum/messages.js

@@ -36,11 +36,23 @@ function usage(message) {
   };
 }
 const statuses = { error: "error", aborted: "stopped" };
+const credentials = /security token|unrecognizedclient|not authori[sz]ed|unauthori[sz]ed|forbidden|\b40[13]\b|api key|credential|bearer/i;
+const models = /model/i;
+const unavailable = /access|invalid|not found|identifier|unsupported|not supported|isn['’]t supported|not available|isn['’]t available/i;
+function errorAction(message) {
+  if (credentials.test(message)) return "settings";
+  if (models.test(message) && unavailable.test(message)) return "change-model";
+  return "retry";
+}
 function assistant(id, message, status) {
   const blocks = Array.isArray(message.content) ? message.content : [];
   const parts = blocks.map(part).filter((item) => item !== void 0);
   if (message.errorMessage)
-    parts.push({ type: "error", message: message.errorMessage, action: "retry" });
+    parts.push({
+      type: "error",
+      message: message.errorMessage,
+      action: errorAction(message.errorMessage)
+    });
   const used = usage(message);
   return {
     id,
@@ -52,8 +64,14 @@ function assistant(id, message, status) {
     ...used ? { usage: used } : {}
   };
 }
-function user(id, message) {
-  return { id, role: "user", text: textOf(message.content), createdAt: message.timestamp ?? 0 };
+function user(id, message, delivered) {
+  return {
+    id,
+    role: "user",
+    text: textOf(message.content),
+    createdAt: message.timestamp ?? 0,
+    ...delivered ? { delivered } : {}
+  };
 }
 function system(id, entry, text) {
   const reason = entry.data?.reason;
@@ -81,10 +99,10 @@ function settle(calls, result) {
   call.output = textOf(result.content);
   call.status = result.isError ? "error" : "done";
 }
-function entryMessage(entry, out, calls) {
+function entryMessage(entry, out, calls, delivered) {
   const id = `e${entry.id}`;
   const model = entry.model?.[0];
-  if (entry.kind === "pi.user" && model) out.push(user(id, model));
+  if (entry.kind === "pi.user" && model) out.push(user(id, model, delivered));
   else if (entry.kind === "pi.assistant" && model) {
     const message = assistant(id, model);
     out.push(message);
@@ -129,11 +147,16 @@ function live(view, out, calls) {
       createdAt: retry.at
     });
 }
-function toMessages(view) {
+function toMessages(view, deliveries = {}) {
   const out = [];
   if (!view) return out;
   const calls = /* @__PURE__ */ new Map();
-  for (const entry of view.entries) entryMessage(entry, out, calls);
+  let previous;
+  for (const entry of view.entries) {
+    const steered = previous?.kind === "pi.tool-result" ? "steer" : void 0;
+    entryMessage(entry, out, calls, deliveries[String(entry.id)] ?? steered);
+    previous = entry;
+  }
   live(view, out, calls);
   return out;
 }
@@ -153,6 +176,7 @@ function queued(view) {
 }
 export {
   assistant,
+  errorAction,
   isBusy,
   queued,
   textOf,

package/dist/spectrum/messages.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/spectrum/messages.ts"],
-  "sourcesContent": ["import type {\n  AssistantMessage,\n  AssistantStatus,\n  Message,\n  MessagePart,\n  SystemMessage,\n  ToolCall,\n  ToolStatus,\n  Usage,\n  UserMessage,\n} from '@ai-ecoverse/slicc-spectrum/ui';\nimport type { ConversationView, EntryRecord } from '@earendil-works/pi-durable';\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  provider?: string;\n  model?: string;\n  usage?: {\n    input?: number;\n    output?: number;\n    cacheRead?: number;\n    cacheWrite?: number;\n    cost?: { total?: number };\n  };\n  toolCallId?: string;\n  isError?: boolean;\n}\n\ninterface Slot {\n  callId: string;\n  status: string;\n  output?: string;\n}\n\ninterface Live {\n  run?: unknown;\n  generation?: { message?: ModelMessage; retry?: { at: number; error: string } };\n  tools?: Slot[];\n  compactions?: { taskId: number; reason: string }[];\n}\n\nexport function 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 paths = (args: Json | undefined): string[] =>\n  typeof args?.path === 'string' ? [args.path] : [];\n\nfunction title(args: Json | undefined): string {\n  const subject = args?.command ?? args?.path;\n  return typeof subject === 'string' ? subject : '';\n}\n\nfunction toolCall(block: Block): ToolCall {\n  return {\n    id: block.id ?? '',\n    name: block.name ?? 'tool',\n    title: title(block.arguments),\n    input: JSON.stringify(block.arguments ?? {}),\n    output: '',\n    status: 'running',\n    paths: paths(block.arguments),\n  };\n}\n\nfunction part(block: Block): MessagePart | undefined {\n  if (block.type === 'text') return { type: 'text', text: block.text ?? '' };\n  if (block.type === 'thinking') return { type: 'thinking', text: block.thinking ?? '' };\n  if (block.type === 'toolCall') return { type: 'tool', tool: toolCall(block) };\n  return undefined;\n}\n\nfunction usage(message: ModelMessage): Usage | undefined {\n  const used = message.usage;\n  if (!used) return undefined;\n  return {\n    input: used.input ?? 0,\n    output: used.output ?? 0,\n    cost: used.cost?.total ?? 0,\n    cacheRead: used.cacheRead ?? 0,\n    cacheWrite: used.cacheWrite ?? 0,\n  };\n}\n\nconst statuses: Record<string, AssistantStatus> = { error: 'error', aborted: 'stopped' };\n\nexport function assistant(\n  id: string,\n  message: ModelMessage,\n  status?: AssistantStatus\n): AssistantMessage {\n  const blocks = Array.isArray(message.content) ? message.content : [];\n  const parts = blocks.map(part).filter((item): item is MessagePart => item !== undefined);\n  if (message.errorMessage)\n    parts.push({ type: 'error', message: message.errorMessage, action: 'retry' });\n  const used = usage(message);\n  return {\n    id,\n    role: 'assistant',\n    parts,\n    status: status ?? statuses[message.stopReason ?? ''] ?? 'done',\n    createdAt: message.timestamp ?? 0,\n    ...(message.provider && message.model ? { model: `${message.provider}/${message.model}` } : {}),\n    ...(used ? { usage: used } : {}),\n  };\n}\n\nfunction user(id: string, message: ModelMessage): UserMessage {\n  return { id, role: 'user', text: textOf(message.content), createdAt: message.timestamp ?? 0 };\n}\n\nfunction system(id: string, entry: EntryRecord, text: string): SystemMessage {\n  const reason = (entry.data as Json | undefined)?.reason as SystemMessage['trigger'] | undefined;\n  return {\n    id,\n    role: 'system',\n    kind: 'compaction',\n    text,\n    createdAt: 0,\n    state: 'summarized',\n    ...(reason ? { trigger: reason } : {}),\n  };\n}\n\nfunction tools(messages: Message[]): Map<string, ToolCall> {\n  const found = new Map<string, ToolCall>();\n  for (const message of messages) {\n    if (message.role !== 'assistant') continue;\n    for (const item of message.parts) if (item.type === 'tool') found.set(item.tool.id, item.tool);\n  }\n  return found;\n}\n\nfunction settle(calls: Map<string, ToolCall>, result: ModelMessage): void {\n  const call = calls.get(result.toolCallId ?? '');\n  if (!call) return;\n  call.output = textOf(result.content);\n  call.status = result.isError ? 'error' : 'done';\n}\n\nfunction entryMessage(entry: EntryRecord, out: Message[], calls: Map<string, ToolCall>): void {\n  const id = `e${entry.id}`;\n  const model = entry.model?.[0] as ModelMessage | undefined;\n  if (entry.kind === 'pi.user' && model) out.push(user(id, model));\n  else if (entry.kind === 'pi.assistant' && model) {\n    const message = assistant(id, model);\n    out.push(message);\n    for (const [key, value] of tools([message])) calls.set(key, value);\n  } else if (entry.kind === 'pi.tool-result' && model) settle(calls, model);\n  else if (entry.kind === 'pi.compaction') out.push(system(id, entry, textOf(model?.content)));\n}\n\nconst slotStatus: Record<string, ToolStatus> = {\n  pending: 'running',\n  running: 'running',\n  done: 'done',\n};\n\nfunction live(view: ConversationView, out: Message[], calls: Map<string, ToolCall>): void {\n  const state = view.docs['pi.live'] as Live | undefined;\n  for (const slot of state?.tools ?? []) {\n    const call = calls.get(slot.callId);\n    if (call && call.status === 'running') {\n      call.status = slotStatus[slot.status] ?? 'running';\n      call.output = slot.output ?? call.output;\n    }\n  }\n  const partial = state?.generation?.message;\n  if (partial) out.push(assistant('live', partial, 'streaming'));\n  for (const compaction of state?.compactions ?? []) {\n    out.push({\n      id: `compaction-${compaction.taskId}`,\n      role: 'system',\n      kind: 'compaction',\n      text: '',\n      createdAt: 0,\n      state: 'summarizing',\n      trigger: compaction.reason as SystemMessage['trigger'],\n    });\n  }\n  const retry = state?.generation?.retry;\n  if (retry)\n    out.push({\n      id: 'retry',\n      role: 'system',\n      kind: 'notice',\n      text: retry.error,\n      createdAt: retry.at,\n    });\n}\n\nexport function toMessages(view: ConversationView | undefined): Message[] {\n  const out: Message[] = [];\n  if (!view) return out;\n  const calls = new Map<string, ToolCall>();\n  for (const entry of view.entries) entryMessage(entry, out, calls);\n  live(view, out, calls);\n  return out;\n}\n\nexport function isBusy(view: ConversationView | undefined): boolean {\n  return Boolean((view?.docs['pi.live'] as Live | undefined)?.run);\n}\n\nexport function queued(view: ConversationView | undefined): UserMessage[] {\n  const items = ((view?.docs['pi.inbox'] as { items?: Json[] } | undefined)?.items ?? []) as {\n    id: number;\n    mode: string;\n    content?: ModelMessage['content'];\n  }[];\n  return items\n    .filter((item) => item.mode !== 'write')\n    .map((item) => ({\n      id: `q${item.id}`,\n      role: 'user',\n      text: textOf(item.content),\n      createdAt: 0,\n      queued: true,\n      mode: item.mode === 'steer' ? 'steer' : 'queue',\n    }));\n}\n"],
-  "mappings": "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",
+  "sourcesContent": ["import type {\n  AssistantMessage,\n  AssistantStatus,\n  ErrorAction,\n  Message,\n  MessagePart,\n  SystemMessage,\n  ToolCall,\n  ToolStatus,\n  Usage,\n  UserMessage,\n} from '@ai-ecoverse/slicc-spectrum/ui';\nimport type { ConversationView, EntryRecord } from '@earendil-works/pi-durable';\nimport type { Delivered } from '../services.ts';\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  provider?: string;\n  model?: string;\n  usage?: {\n    input?: number;\n    output?: number;\n    cacheRead?: number;\n    cacheWrite?: number;\n    cost?: { total?: number };\n  };\n  toolCallId?: string;\n  isError?: boolean;\n}\n\ninterface Slot {\n  callId: string;\n  status: string;\n  output?: string;\n}\n\ninterface Live {\n  run?: unknown;\n  generation?: { message?: ModelMessage; retry?: { at: number; error: string } };\n  tools?: Slot[];\n  compactions?: { taskId: number; reason: string }[];\n}\n\nexport function 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 paths = (args: Json | undefined): string[] =>\n  typeof args?.path === 'string' ? [args.path] : [];\n\nfunction title(args: Json | undefined): string {\n  const subject = args?.command ?? args?.path;\n  return typeof subject === 'string' ? subject : '';\n}\n\nfunction toolCall(block: Block): ToolCall {\n  return {\n    id: block.id ?? '',\n    name: block.name ?? 'tool',\n    title: title(block.arguments),\n    input: JSON.stringify(block.arguments ?? {}),\n    output: '',\n    status: 'running',\n    paths: paths(block.arguments),\n  };\n}\n\nfunction part(block: Block): MessagePart | undefined {\n  if (block.type === 'text') return { type: 'text', text: block.text ?? '' };\n  if (block.type === 'thinking') return { type: 'thinking', text: block.thinking ?? '' };\n  if (block.type === 'toolCall') return { type: 'tool', tool: toolCall(block) };\n  return undefined;\n}\n\nfunction usage(message: ModelMessage): Usage | undefined {\n  const used = message.usage;\n  if (!used) return undefined;\n  return {\n    input: used.input ?? 0,\n    output: used.output ?? 0,\n    cost: used.cost?.total ?? 0,\n    cacheRead: used.cacheRead ?? 0,\n    cacheWrite: used.cacheWrite ?? 0,\n  };\n}\n\nconst statuses: Record<string, AssistantStatus> = { error: 'error', aborted: 'stopped' };\n\nconst credentials =\n  /security token|unrecognizedclient|not authori[sz]ed|unauthori[sz]ed|forbidden|\\b40[13]\\b|api key|credential|bearer/i;\nconst models = /model/i;\nconst unavailable =\n  /access|invalid|not found|identifier|unsupported|not supported|isn['\u2019]t supported|not available|isn['\u2019]t available/i;\n\nexport function errorAction(message: string): ErrorAction {\n  if (credentials.test(message)) return 'settings';\n  if (models.test(message) && unavailable.test(message)) return 'change-model';\n  return 'retry';\n}\n\nexport function assistant(\n  id: string,\n  message: ModelMessage,\n  status?: AssistantStatus\n): AssistantMessage {\n  const blocks = Array.isArray(message.content) ? message.content : [];\n  const parts = blocks.map(part).filter((item): item is MessagePart => item !== undefined);\n  if (message.errorMessage)\n    parts.push({\n      type: 'error',\n      message: message.errorMessage,\n      action: errorAction(message.errorMessage),\n    });\n  const used = usage(message);\n  return {\n    id,\n    role: 'assistant',\n    parts,\n    status: status ?? statuses[message.stopReason ?? ''] ?? 'done',\n    createdAt: message.timestamp ?? 0,\n    ...(message.provider && message.model ? { model: `${message.provider}/${message.model}` } : {}),\n    ...(used ? { usage: used } : {}),\n  };\n}\n\nfunction user(id: string, message: ModelMessage, delivered: Delivered | undefined): UserMessage {\n  return {\n    id,\n    role: 'user',\n    text: textOf(message.content),\n    createdAt: message.timestamp ?? 0,\n    ...(delivered ? { delivered } : {}),\n  };\n}\n\nfunction system(id: string, entry: EntryRecord, text: string): SystemMessage {\n  const reason = (entry.data as Json | undefined)?.reason as SystemMessage['trigger'] | undefined;\n  return {\n    id,\n    role: 'system',\n    kind: 'compaction',\n    text,\n    createdAt: 0,\n    state: 'summarized',\n    ...(reason ? { trigger: reason } : {}),\n  };\n}\n\nfunction tools(messages: Message[]): Map<string, ToolCall> {\n  const found = new Map<string, ToolCall>();\n  for (const message of messages) {\n    if (message.role !== 'assistant') continue;\n    for (const item of message.parts) if (item.type === 'tool') found.set(item.tool.id, item.tool);\n  }\n  return found;\n}\n\nfunction settle(calls: Map<string, ToolCall>, result: ModelMessage): void {\n  const call = calls.get(result.toolCallId ?? '');\n  if (!call) return;\n  call.output = textOf(result.content);\n  call.status = result.isError ? 'error' : 'done';\n}\n\nfunction entryMessage(\n  entry: EntryRecord,\n  out: Message[],\n  calls: Map<string, ToolCall>,\n  delivered: Delivered | undefined\n): void {\n  const id = `e${entry.id}`;\n  const model = entry.model?.[0] as ModelMessage | undefined;\n  if (entry.kind === 'pi.user' && model) out.push(user(id, model, delivered));\n  else if (entry.kind === 'pi.assistant' && model) {\n    const message = assistant(id, model);\n    out.push(message);\n    for (const [key, value] of tools([message])) calls.set(key, value);\n  } else if (entry.kind === 'pi.tool-result' && model) settle(calls, model);\n  else if (entry.kind === 'pi.compaction') out.push(system(id, entry, textOf(model?.content)));\n}\n\nconst slotStatus: Record<string, ToolStatus> = {\n  pending: 'running',\n  running: 'running',\n  done: 'done',\n};\n\nfunction live(view: ConversationView, out: Message[], calls: Map<string, ToolCall>): void {\n  const state = view.docs['pi.live'] as Live | undefined;\n  for (const slot of state?.tools ?? []) {\n    const call = calls.get(slot.callId);\n    if (call && call.status === 'running') {\n      call.status = slotStatus[slot.status] ?? 'running';\n      call.output = slot.output ?? call.output;\n    }\n  }\n  const partial = state?.generation?.message;\n  if (partial) out.push(assistant('live', partial, 'streaming'));\n  for (const compaction of state?.compactions ?? []) {\n    out.push({\n      id: `compaction-${compaction.taskId}`,\n      role: 'system',\n      kind: 'compaction',\n      text: '',\n      createdAt: 0,\n      state: 'summarizing',\n      trigger: compaction.reason as SystemMessage['trigger'],\n    });\n  }\n  const retry = state?.generation?.retry;\n  if (retry)\n    out.push({\n      id: 'retry',\n      role: 'system',\n      kind: 'notice',\n      text: retry.error,\n      createdAt: retry.at,\n    });\n}\n\nexport function toMessages(\n  view: ConversationView | undefined,\n  deliveries: Readonly<Record<string, Delivered>> = {}\n): Message[] {\n  const out: Message[] = [];\n  if (!view) return out;\n  const calls = new Map<string, ToolCall>();\n  let previous: EntryRecord | undefined;\n  for (const entry of view.entries) {\n    const steered = previous?.kind === 'pi.tool-result' ? 'steer' : undefined;\n    entryMessage(entry, out, calls, deliveries[String(entry.id)] ?? steered);\n    previous = entry;\n  }\n  live(view, out, calls);\n  return out;\n}\n\nexport function isBusy(view: ConversationView | undefined): boolean {\n  return Boolean((view?.docs['pi.live'] as Live | undefined)?.run);\n}\n\nexport function queued(view: ConversationView | undefined): UserMessage[] {\n  const items = ((view?.docs['pi.inbox'] as { items?: Json[] } | undefined)?.items ?? []) as {\n    id: number;\n    mode: string;\n    content?: ModelMessage['content'];\n  }[];\n  return items\n    .filter((item) => item.mode !== 'write')\n    .map((item) => ({\n      id: `q${item.id}`,\n      role: 'user',\n      text: textOf(item.content),\n      createdAt: 0,\n      queued: true,\n      mode: item.mode === 'steer' ? 'steer' : 'queue',\n    }));\n}\n"],
+  "mappings": "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",
   "names": []
 }

package/dist/types/client.d.ts

@@ -1,11 +1,12 @@
 import { type Context, type ReplicatedState } from '@earendil-works/chord';
 import type { ConversationView } from '@earendil-works/pi-durable';
-import { AgentControl, AgentSettings, type SendMode } from './services.ts';
+import { AgentControl, AgentSettings, type Delivered, type SendMode } from './services.ts';
 import { type PortEndpoint } from './wire.ts';
 export interface AgentConnection {
     readonly serverId: string;
     readonly control: AgentControl;
     readonly transcript: ReplicatedState<ConversationView>;
+    readonly deliveries: ReplicatedState<Record<string, Delivered>>;
     readonly settings: AgentSettings;
     prompt(text: string, whenBusy?: SendMode): Promise<string>;
     close(): Promise<void>;

package/dist/types/control.d.ts

@@ -1,4 +1,5 @@
 import { type Conversation, type Harness, type SubmissionId } from '@earendil-works/pi-durable';
+import type { Deliveries } from './deliveries.ts';
 import type { AgentControl } from './services.ts';
 export declare function submissionId(value: string): SubmissionId | undefined;
-export declare function createAgentControl(harness: Harness, conversation: Conversation): AgentControl;
+export declare function createAgentControl(harness: Harness, conversation: Conversation, deliveries?: Deliveries): AgentControl;

package/dist/types/deliveries.d.ts

@@ -0,0 +1,16 @@
+import { type Context, type MutableReplicatedState } from '@earendil-works/chord';
+import type { ConversationView, Harness, SubmissionId } from '@earendil-works/pi-durable';
+import type { Delivered } from './services.ts';
+type WhenBusy = 'steer' | 'followUp' | 'reject' | undefined;
+export interface Deliveries {
+    readonly state: MutableReplicatedState<Record<string, Delivered>>;
+    expect(submissionId: SubmissionId, whenBusy: WhenBusy): void;
+    settle(): Promise<void>;
+    dispose(): void;
+}
+export declare function delivery(view: ConversationView | undefined, entry: number, whenBusy: WhenBusy, queued: boolean): Delivered | undefined;
+export declare function trackDeliveries(harness: Pick<Harness, 'submission'>, view: {
+    readonly value: ConversationView | undefined;
+    subscribe(listener: () => void): () => void;
+}, context: Context): Deliveries;
+export {};

package/dist/types/services.d.ts

@@ -47,8 +47,10 @@ export interface AgentSettingsChange {
     thinkingLevel: 'off' | 'minimal' | 'low' | 'medium' | 'high' | 'xhigh' | 'max' | null;
 }
 export declare const AgentControl: import("@earendil-works/chord").Service<AgentControl>;
+export type Delivered = 'run' | 'steer' | 'follow-up';
 export interface AgentTranscript {
     readonly state: ReplicatedState<ConversationView>;
+    readonly deliveries: ReplicatedState<Record<string, Delivered>>;
 }
 export declare const AgentTranscript: import("@earendil-works/chord").Service<AgentTranscript>;
 export interface AgentSessions {

package/dist/types/spectrum/index.d.ts

@@ -2,7 +2,7 @@ import type { AgentConnection } from '../client.ts';
 import { AgentAdapter } from './agent-port.ts';
 import { SettingsAdapter } from './settings-port.ts';
 export { AgentAdapter, CONE } from './agent-port.ts';
-export { assistant, isBusy, queued, textOf, toMessages } from './messages.ts';
+export { assistant, errorAction, isBusy, queued, textOf, toMessages } from './messages.ts';
 export { SETTINGS_KEY, SettingsAdapter } from './settings-port.ts';
 export declare function createAgentModel(connection: AgentConnection, options?: {
     storage?: Pick<Storage, 'getItem' | 'setItem'> | null;

package/dist/types/spectrum/messages.d.ts

@@ -1,5 +1,6 @@
-import type { AssistantMessage, AssistantStatus, Message, UserMessage } from '@ai-ecoverse/slicc-spectrum/ui';
+import type { AssistantMessage, AssistantStatus, ErrorAction, Message, UserMessage } from '@ai-ecoverse/slicc-spectrum/ui';
 import type { ConversationView } from '@earendil-works/pi-durable';
+import type { Delivered } from '../services.ts';
 type Json = Record<string, unknown>;
 interface Block {
     type: string;
@@ -30,8 +31,9 @@ interface ModelMessage {
     isError?: boolean;
 }
 export declare function textOf(content: ModelMessage['content']): string;
+export declare function errorAction(message: string): ErrorAction;
 export declare function assistant(id: string, message: ModelMessage, status?: AssistantStatus): AssistantMessage;
-export declare function toMessages(view: ConversationView | undefined): Message[];
+export declare function toMessages(view: ConversationView | undefined, deliveries?: Readonly<Record<string, Delivered>>): Message[];
 export declare function isBusy(view: ConversationView | undefined): boolean;
 export declare function queued(view: ConversationView | undefined): UserMessage[];
 export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ai-ecoverse/slicc-agent",
-  "version": "2.6.3",
+  "version": "2.8.0",
   "description": "SLICC's agent core on pi durable: an agent worker, session storage, remoting and pi extensions",
   "type": "module",
   "license": "Apache-2.0",
@@ -74,7 +74,7 @@
     "typescript": "7.0.2"
   },
   "dependencies": {
-    "@ai-ecoverse/slicc-kernel": "1.12.0",
+    "@ai-ecoverse/slicc-kernel": "1.13.0",
     "@earendil-works/chord": "1.0.4",
     "@earendil-works/pi-ai": "1.0.4",
     "@earendil-works/pi-client": "1.0.4",