@ai-ecoverse/slicc-agent 2.0.0 → 2.1.0

package/README.md

@@ -31,6 +31,19 @@ await agent.prompt('What is in /home?');
 - `hostAgent(agent)` serves the agent with pi's protocol: a pi-server with one session, `agent`, whose Chord services are `slicc.agent.control` (send with `whenBusy` `steer`, `followUp` or `reject`, wait, withdraw, abort, compact) and `slicc.agent.transcript` (the conversation's durable view as replicated state). `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/control.js

@@ -51,7 +51,15 @@ function createAgentControl(harness, conversation) {
       return { outcome: result === "not_found" ? "not_found" : "already_placed" };
     },
     abort: (context) => conversation.abort(context),
-    compact: (instructions, context) => accepted(() => conversation.compact(instructions ?? void 0, 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 {

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  };\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,EAC3E;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 { 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/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 { 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  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,EACA;AAAA,OAMK;AACP;AAAA,EACE;AAAA,EAEA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AACP,SAAS,aAAgC,cAAc,uBAAuB;AAC9E,SAAS,wBAA0C;",
+  "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/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}\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;AAmC3D,MAAM,eAAe,cAA4B,qBAAqB;AAMtE,MAAM,kBAAkB,cAA+B,wBAAwB;AAO/E,MAAM,gBAAgB,cAA6B,sBAAsB;AAEzE,MAAM,gBAAgB;",
+  "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": "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",
+  "names": []
+}

package/dist/spectrum/emitter.js

@@ -0,0 +1,20 @@
+class Emitter {
+  #listeners = /* @__PURE__ */ new Map();
+  on(type, listener) {
+    let set = this.#listeners.get(type);
+    if (!set) {
+      set = /* @__PURE__ */ new Set();
+      this.#listeners.set(type, set);
+    }
+    set.add(listener);
+    return () => set.delete(listener);
+  }
+  emit(type, detail) {
+    for (const listener of [...this.#listeners.get(type) ?? []])
+      listener(detail);
+  }
+}
+export {
+  Emitter
+};
+//# sourceMappingURL=emitter.js.map

package/dist/spectrum/emitter.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/spectrum/emitter.ts"],
+  "sourcesContent": ["type Listener<T> = (detail: T) => void;\n\nexport class Emitter<Events extends object> {\n  readonly #listeners = new Map<keyof Events, Set<Listener<never>>>();\n\n  on<K extends keyof Events>(type: K, listener: Listener<Events[K]>): () => void {\n    let set = this.#listeners.get(type);\n    if (!set) {\n      set = new Set();\n      this.#listeners.set(type, set);\n    }\n    set.add(listener as Listener<never>);\n    return () => set.delete(listener as Listener<never>);\n  }\n\n  emit<K extends keyof Events>(type: K, detail: Events[K]): void {\n    for (const listener of [...(this.#listeners.get(type) ?? [])])\n      (listener as Listener<Events[K]>)(detail);\n  }\n}\n"],
+  "mappings": "AAEO,MAAM,QAA+B;AAAA,EACjC,aAAa,oBAAI,IAAwC;AAAA,EAElE,GAA2B,MAAS,UAA2C;AAC7E,QAAI,MAAM,KAAK,WAAW,IAAI,IAAI;AAClC,QAAI,CAAC,KAAK;AACR,YAAM,oBAAI,IAAI;AACd,WAAK,WAAW,IAAI,MAAM,GAAG;AAAA,IAC/B;AACA,QAAI,IAAI,QAA2B;AACnC,WAAO,MAAM,IAAI,OAAO,QAA2B;AAAA,EACrD;AAAA,EAEA,KAA6B,MAAS,QAAyB;AAC7D,eAAW,YAAY,CAAC,GAAI,KAAK,WAAW,IAAI,IAAI,KAAK,CAAC,CAAE;AAC1D,MAAC,SAAiC,MAAM;AAAA,EAC5C;AACF;",
+  "names": []
+}

package/dist/spectrum/index.js

@@ -0,0 +1,17 @@
+import { AgentAdapter } from "./agent-port.js";
+import { AgentAdapter as AgentAdapter2, CONE } from "./agent-port.js";
+import { assistant, isBusy, queued, textOf, toMessages } from "./messages.js";
+function createAgentModel(connection) {
+  return { agent: new AgentAdapter(connection) };
+}
+export {
+  AgentAdapter2 as AgentAdapter,
+  CONE,
+  assistant,
+  createAgentModel,
+  isBusy,
+  queued,
+  textOf,
+  toMessages
+};
+//# sourceMappingURL=index.js.map

package/dist/spectrum/index.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/spectrum/index.ts"],
+  "sourcesContent": ["import type { AgentConnection } from '../client.ts';\nimport { AgentAdapter } from './agent-port.ts';\n\nexport { AgentAdapter, CONE } from './agent-port.ts';\nexport { assistant, isBusy, queued, textOf, toMessages } from './messages.ts';\n\nexport function createAgentModel(connection: AgentConnection): { agent: AgentAdapter } {\n  return { agent: new AgentAdapter(connection) };\n}\n"],
+  "mappings": "AACA,SAAS,oBAAoB;AAE7B,SAAS,gBAAAA,eAAc,YAAY;AACnC,SAAS,WAAW,QAAQ,QAAQ,QAAQ,kBAAkB;AAEvD,SAAS,iBAAiB,YAAsD;AACrF,SAAO,EAAE,OAAO,IAAI,aAAa,UAAU,EAAE;AAC/C;",
+  "names": ["AgentAdapter"]
+}

package/dist/spectrum/messages.js

@@ -0,0 +1,161 @@
+function textOf(content) {
+  if (typeof content === "string") return content;
+  return (content ?? []).map((block) => block.type === "text" ? block.text ?? "" : "").join("");
+}
+const paths = (args) => typeof args?.path === "string" ? [args.path] : [];
+function title(name, args) {
+  const subject = args?.command ?? args?.path;
+  return typeof subject === "string" ? `${name} ${subject}` : name;
+}
+function toolCall(block) {
+  return {
+    id: block.id ?? "",
+    name: block.name ?? "tool",
+    title: title(block.name ?? "tool", block.arguments),
+    input: JSON.stringify(block.arguments ?? {}),
+    output: "",
+    status: "running",
+    paths: paths(block.arguments)
+  };
+}
+function part(block) {
+  if (block.type === "text") return { type: "text", text: block.text ?? "" };
+  if (block.type === "thinking") return { type: "thinking", text: block.thinking ?? "" };
+  if (block.type === "toolCall") return { type: "tool", tool: toolCall(block) };
+  return void 0;
+}
+function usage(message) {
+  const used = message.usage;
+  if (!used) return void 0;
+  return {
+    input: used.input ?? 0,
+    output: used.output ?? 0,
+    cost: used.cost?.total ?? 0,
+    cacheRead: used.cacheRead ?? 0,
+    cacheWrite: used.cacheWrite ?? 0
+  };
+}
+const statuses = { error: "error", aborted: "stopped" };
+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" });
+  const used = usage(message);
+  return {
+    id,
+    role: "assistant",
+    parts,
+    status: status ?? statuses[message.stopReason ?? ""] ?? "done",
+    createdAt: message.timestamp ?? 0,
+    ...message.provider && message.model ? { model: `${message.provider}/${message.model}` } : {},
+    ...used ? { usage: used } : {}
+  };
+}
+function user(id, message) {
+  return { id, role: "user", text: textOf(message.content), createdAt: message.timestamp ?? 0 };
+}
+function system(id, entry, text) {
+  const reason = entry.data?.reason;
+  return {
+    id,
+    role: "system",
+    kind: "compaction",
+    text,
+    createdAt: 0,
+    state: "summarized",
+    ...reason ? { trigger: reason } : {}
+  };
+}
+function tools(messages) {
+  const found = /* @__PURE__ */ new Map();
+  for (const message of messages) {
+    if (message.role !== "assistant") continue;
+    for (const item of message.parts) if (item.type === "tool") found.set(item.tool.id, item.tool);
+  }
+  return found;
+}
+function settle(calls, result) {
+  const call = calls.get(result.toolCallId ?? "");
+  if (!call) return;
+  call.output = textOf(result.content);
+  call.status = result.isError ? "error" : "done";
+}
+function entryMessage(entry, out, calls) {
+  const id = `e${entry.id}`;
+  const model = entry.model?.[0];
+  if (entry.kind === "pi.user" && model) out.push(user(id, model));
+  else if (entry.kind === "pi.assistant" && model) {
+    const message = assistant(id, model);
+    out.push(message);
+    for (const [key, value] of tools([message])) calls.set(key, value);
+  } else if (entry.kind === "pi.tool-result" && model) settle(calls, model);
+  else if (entry.kind === "pi.compaction") out.push(system(id, entry, textOf(model?.content)));
+}
+const slotStatus = {
+  pending: "running",
+  running: "running",
+  done: "done"
+};
+function live(view, out, calls) {
+  const state = view.docs["pi.live"];
+  for (const slot of state?.tools ?? []) {
+    const call = calls.get(slot.callId);
+    if (call && call.status === "running") {
+      call.status = slotStatus[slot.status] ?? "running";
+      call.output = slot.output ?? call.output;
+    }
+  }
+  const partial = state?.generation?.message;
+  if (partial) out.push(assistant("live", partial, "streaming"));
+  for (const compaction of state?.compactions ?? []) {
+    out.push({
+      id: `compaction-${compaction.taskId}`,
+      role: "system",
+      kind: "compaction",
+      text: "",
+      createdAt: 0,
+      state: "summarizing",
+      trigger: compaction.reason
+    });
+  }
+  const retry = state?.generation?.retry;
+  if (retry)
+    out.push({
+      id: "retry",
+      role: "system",
+      kind: "notice",
+      text: retry.error,
+      createdAt: retry.at
+    });
+}
+function toMessages(view) {
+  const out = [];
+  if (!view) return out;
+  const calls = /* @__PURE__ */ new Map();
+  for (const entry of view.entries) entryMessage(entry, out, calls);
+  live(view, out, calls);
+  return out;
+}
+function isBusy(view) {
+  return Boolean(view?.docs["pi.live"]?.run);
+}
+function queued(view) {
+  const items = view?.docs["pi.inbox"]?.items ?? [];
+  return items.filter((item) => item.mode !== "write").map((item) => ({
+    id: `q${item.id}`,
+    role: "user",
+    text: textOf(item.content),
+    createdAt: 0,
+    queued: true,
+    mode: item.mode === "steer" ? "steer" : "queue"
+  }));
+}
+export {
+  assistant,
+  isBusy,
+  queued,
+  textOf,
+  toMessages
+};
+//# sourceMappingURL=messages.js.map

package/dist/spectrum/messages.js.map

@@ -0,0 +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(name: string, args: Json | undefined): string {\n  const subject = args?.command ?? args?.path;\n  return typeof subject === 'string' ? `${name} ${subject}` : name;\n}\n\nfunction toolCall(block: Block): ToolCall {\n  return {\n    id: block.id ?? '',\n    name: block.name ?? 'tool',\n    title: title(block.name ?? 'tool', 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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",
+  "names": []
+}

package/dist/types/index.d.ts

@@ -3,7 +3,7 @@ export { type AgentConnection, connectAgent } from './client.ts';
 export { createAgentControl } from './control.ts';
 export { type AgentHost, hostAgent } from './host.ts';
 export { AGENT_LOCK, type AgentOwner, type AgentWorker, type OwnerOptions, startAgent, } from './owner.ts';
-export { AGENT_SESSION, AgentControl, AgentSessions, AgentTranscript, type OperationError, type PromptResult, type SendMode, type SendRequest, type SendResponse, } from './services.ts';
+export { AGENT_SESSION, AgentControl, AgentSessions, type AgentSettingsChange, AgentTranscript, type OperationError, type PromptResult, type SendMode, type SendRequest, type SendResponse, } from './services.ts';
 export { AGENT_DIRECTORY, type OpfsSqliteOptions, openMemorySqliteStorage, openOpfsSqliteStorage, WasmSqliteDatabase, } from './sqlite.ts';
 export { PortChannel, type PortEndpoint, PortListener, withUnrefTimers } from './wire.ts';
 export { serveConnections, type WorkerScope } from './worker.ts';

package/dist/types/services.d.ts

@@ -36,6 +36,15 @@ export interface AgentControl {
     }>;
     abort(context: Context): Promise<void>;
     compact(instructions: string | null, context: Context): Promise<SendResponse>;
+    reset(handoff: string | null, context: Context): Promise<void>;
+    configure(change: AgentSettingsChange, context: Context): Promise<void>;
+}
+export interface AgentSettingsChange {
+    model: {
+        provider: string;
+        modelId: string;
+    } | null;
+    thinkingLevel: 'off' | 'minimal' | 'low' | 'medium' | 'high' | 'xhigh' | 'max' | null;
 }
 export declare const AgentControl: import("@earendil-works/chord").Service<AgentControl>;
 export interface AgentTranscript {

package/dist/types/spectrum/agent-port.d.ts

@@ -0,0 +1,32 @@
+import type { Agent, AgentEvents, AgentPort, FrozenCone, Message, Outgoing, SlashCommand, Thinking, UserMessage } from '@ai-ecoverse/slicc-spectrum/ui';
+import type { AgentConnection } from '../client.ts';
+import { Emitter } from './emitter.ts';
+export declare const CONE = "cone";
+export declare class AgentAdapter extends Emitter<AgentEvents> implements AgentPort {
+    #private;
+    constructor(connection: AgentConnection);
+    ready(): Promise<void>;
+    list(): readonly Agent[];
+    active(): string;
+    select(): void;
+    messages(): readonly Message[];
+    send(_agentId: string, input: string | Outgoing): Promise<void>;
+    stop(): void;
+    busy(): boolean;
+    queue(): readonly UserMessage[];
+    unqueue(_agentId: string, messageId: string): void;
+    suggestion(): string | null;
+    answer(): void;
+    resolveLick(): void;
+    compact(): void;
+    clear(): void;
+    setModel(_agentId: string, model: string): void;
+    setThinking(_agentId: string, level: Thinking): void;
+    older(): Promise<readonly Message[]>;
+    commands(): readonly SlashCommand[];
+    createScoop(): Agent;
+    frozen(): readonly FrozenCone[];
+    freeze(): void;
+    thaw(): Agent | null;
+    discard(): void;
+}

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

@@ -0,0 +1,7 @@
+type Listener<T> = (detail: T) => void;
+export declare class Emitter<Events extends object> {
+    #private;
+    on<K extends keyof Events>(type: K, listener: Listener<Events[K]>): () => void;
+    emit<K extends keyof Events>(type: K, detail: Events[K]): void;
+}
+export {};

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

@@ -0,0 +1,7 @@
+import type { AgentConnection } from '../client.ts';
+import { AgentAdapter } from './agent-port.ts';
+export { AgentAdapter, CONE } from './agent-port.ts';
+export { assistant, isBusy, queued, textOf, toMessages } from './messages.ts';
+export declare function createAgentModel(connection: AgentConnection): {
+    agent: AgentAdapter;
+};

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

@@ -0,0 +1,37 @@
+import type { AssistantMessage, AssistantStatus, Message, UserMessage } from '@ai-ecoverse/slicc-spectrum/ui';
+import type { ConversationView } from '@earendil-works/pi-durable';
+type Json = Record<string, unknown>;
+interface Block {
+    type: string;
+    text?: string;
+    thinking?: string;
+    id?: string;
+    name?: string;
+    arguments?: Json;
+}
+interface ModelMessage {
+    role: string;
+    content?: string | Block[];
+    timestamp?: number;
+    stopReason?: string;
+    errorMessage?: string;
+    provider?: string;
+    model?: string;
+    usage?: {
+        input?: number;
+        output?: number;
+        cacheRead?: number;
+        cacheWrite?: number;
+        cost?: {
+            total?: number;
+        };
+    };
+    toolCallId?: string;
+    isError?: boolean;
+}
+export declare function textOf(content: ModelMessage['content']): string;
+export declare function assistant(id: string, message: ModelMessage, status?: AssistantStatus): AssistantMessage;
+export declare function toMessages(view: ConversationView | undefined): 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.0.0",
+  "version": "2.1.0",
   "description": "SLICC's agent core on pi durable: an agent worker, session storage, remoting and pi extensions",
   "type": "module",
   "license": "Apache-2.0",
@@ -25,6 +25,10 @@
     ".": {
       "types": "./dist/types/index.d.ts",
       "default": "./dist/index.js"
+    },
+    "./spectrum": {
+      "types": "./dist/types/spectrum/index.d.ts",
+      "default": "./dist/spectrum/index.js"
     }
   },
   "files": [
@@ -47,6 +51,7 @@
   },
   "devDependencies": {
     "@ai-ecoverse/slicc-shared-web": "1.5.0",
+    "@ai-ecoverse/slicc-spectrum": "1.7.0",
     "@biomejs/biome": "2.5.15",
     "@types/node": "24.19.1",
     "esbuild": "0.28.2",
@@ -64,5 +69,8 @@
     "@earendil-works/pi-protocol": "1.0.4",
     "@earendil-works/pi-server": "1.0.4",
     "@sqlite.org/sqlite-wasm": "3.53.4-build2"
+  },
+  "peerDependencies": {
+    "@ai-ecoverse/slicc-spectrum": "^1.7.0"
   }
 }