@ai-ecoverse/slicc-agent 1.0.0 → 1.1.0

package/README.md

@@ -1,9 +1,31 @@
 # slicc-agent
 
-Empty package for SLICC's agent core. It will be rebuilt on pi's `packages/durable`: session storage in wasm SQLite, remoting, compaction, and pi extensions.
+SLICC's agent core, built on pi's [durable](https://github.com/earendil-works/pi/tree/main/packages/durable) harness. It runs in a dedicated worker next to [slicc-kernel](https://github.com/ai-ecoverse/slicc-kernel) and is shown by [slicc-spectrum](https://github.com/ai-ecoverse/slicc-spectrum). The plan is in [ai-ecoverse/slicc-agent#2](https://github.com/ai-ecoverse/slicc-agent/issues/2).
+
+The package ships unbundled ESM: `dist/` holds one file per source file and imports pi's packages by name, so [slicc-bios](https://github.com/ai-ecoverse/slicc-bios) installs it from its lockfile like any other package, and `pnpm upgrade @ai-ecoverse/slicc-agent` updates it in place.
+
+## Use
 
 ```js
-import {} from '@ai-ecoverse/slicc-agent';
+import { connectAgent, openAgent, serveAgent } from '@ai-ecoverse/slicc-agent';
+
+serveAgent(self, openAgent({ models, model: { provider: 'amazon-bedrock', modelId } }));
+
+const agent = connectAgent(new Worker(workerUrl, { type: 'module' }));
+await agent.prompt('What is in /home?');
+```
+
+- `openAgent({ models, model, storage?, registry?, settings? })` opens a durable Harness (in memory unless `storage` is given) and its root conversation. `prompt(text)` submits an input and resolves with the answer's text.
+- `serveAgent(endpoint, agent)` answers prompts that arrive on a worker or `MessagePort`; `connectAgent(endpoint)` is the page side.
+
+## Develop
+
+```sh
+npm install
+npm run build
+npm run test:unit
+npm test
+npm run lint
 ```
 
-Node ≥ 24. `npm run lint` runs `slicc-lint`. Releases use semantic-release on `main`.
+`npm test` builds `dist/`, bundles a test worker that runs the agent on pi's faux provider, and runs the integration tests in Chromium through the [slicc-shared-web harness](https://github.com/ai-ecoverse/slicc-shared-web#integration-test-harness). Unit tests live in `test/unit/`, which stays out of git; the pre-commit hook requires every changed line in `src/` to be covered. No test calls a real model.

package/dist/agent.js

@@ -0,0 +1,45 @@
+import { BACKGROUND_CONTEXT } from "@earendil-works/chord/context";
+import {
+  AssistantEntry,
+  createRegistry,
+  Harness,
+  MemoryStorage
+} from "@earendil-works/pi-durable";
+function answerText(content) {
+  if (typeof content === "string") return content;
+  if (!Array.isArray(content)) return "";
+  return content.filter((block) => block.type === "text").map((block) => block.text ?? "").join("");
+}
+async function prompt(root, text, context) {
+  const submission = await root.submit({ type: "input", content: text }, context);
+  const settled = await submission.wait(context);
+  const { answer, reason } = settled;
+  if (answer === void 0) throw new Error(`unanswered: ${reason}`);
+  const entry = await root.commit((tx) => tx.entry(AssistantEntry, answer), context);
+  return answerText(entry?.model?.[0]?.content);
+}
+async function openAgent(options) {
+  const context = options.context ?? BACKGROUND_CONTEXT;
+  const harness = await Harness.open(
+    options.storage ?? new MemoryStorage(),
+    {
+      models: options.models,
+      registry: options.registry ?? createRegistry(),
+      ...options.settings ? { settings: options.settings } : {}
+    },
+    context
+  );
+  const root = await harness.root(context, { agent: { model: options.model } });
+  harness.resume();
+  return {
+    harness,
+    root,
+    prompt: (text) => prompt(root, text, context),
+    close: () => harness.close(context)
+  };
+}
+export {
+  answerText,
+  openAgent
+};
+//# sourceMappingURL=agent.js.map

package/dist/agent.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../src/agent.ts"],
+  "sourcesContent": ["import type { Context } from '@earendil-works/chord';\nimport { BACKGROUND_CONTEXT } from '@earendil-works/chord/context';\nimport type { Models } from '@earendil-works/pi-ai/models';\nimport {\n  AssistantEntry,\n  type Conversation,\n  createRegistry,\n  type EntryId,\n  Harness,\n  type HarnessOptions,\n  MemoryStorage,\n  type ModelRef,\n  type Registry,\n  type Storage,\n} from '@earendil-works/pi-durable';\n\nexport interface AgentOptions {\n  models: Models;\n  model: ModelRef;\n  storage?: Storage;\n  registry?: Registry;\n  settings?: HarnessOptions['settings'];\n  context?: Context;\n}\n\nexport interface Agent {\n  readonly harness: Harness;\n  readonly root: Conversation;\n  prompt(text: string): Promise<string>;\n  close(): Promise<void>;\n}\n\ninterface Block {\n  type: string;\n  text?: string;\n}\n\nexport function answerText(content: unknown): string {\n  if (typeof content === 'string') return content;\n  if (!Array.isArray(content)) return '';\n  return (content as Block[])\n    .filter((block) => block.type === 'text')\n    .map((block) => block.text ?? '')\n    .join('');\n}\n\nasync function prompt(root: Conversation, text: string, context: Context): Promise<string> {\n  const submission = await root.submit({ type: 'input', content: text }, context);\n  const settled = await submission.wait(context);\n  const { answer, reason } = settled as { answer?: EntryId; reason?: string };\n  if (answer === undefined) throw new Error(`unanswered: ${reason}`);\n  const entry = await root.commit((tx) => tx.entry(AssistantEntry, answer), context);\n  return answerText(entry?.model?.[0]?.content);\n}\n\nexport async function openAgent(options: AgentOptions): Promise<Agent> {\n  const context = options.context ?? BACKGROUND_CONTEXT;\n  const harness = await Harness.open(\n    options.storage ?? new MemoryStorage(),\n    {\n      models: options.models,\n      registry: options.registry ?? createRegistry(),\n      ...(options.settings ? { settings: options.settings } : {}),\n    },\n    context\n  );\n  const root = await harness.root(context, { agent: { model: options.model } });\n  harness.resume();\n  return {\n    harness,\n    root,\n    prompt: (text) => prompt(root, text, context),\n    close: () => harness.close(context),\n  };\n}\n"],
+  "mappings": "AACA,SAAS,0BAA0B;AAEnC;AAAA,EACE;AAAA,EAEA;AAAA,EAEA;AAAA,EAEA;AAAA,OAIK;AAuBA,SAAS,WAAW,SAA0B;AACnD,MAAI,OAAO,YAAY,SAAU,QAAO;AACxC,MAAI,CAAC,MAAM,QAAQ,OAAO,EAAG,QAAO;AACpC,SAAQ,QACL,OAAO,CAAC,UAAU,MAAM,SAAS,MAAM,EACvC,IAAI,CAAC,UAAU,MAAM,QAAQ,EAAE,EAC/B,KAAK,EAAE;AACZ;AAEA,eAAe,OAAO,MAAoB,MAAc,SAAmC;AACzF,QAAM,aAAa,MAAM,KAAK,OAAO,EAAE,MAAM,SAAS,SAAS,KAAK,GAAG,OAAO;AAC9E,QAAM,UAAU,MAAM,WAAW,KAAK,OAAO;AAC7C,QAAM,EAAE,QAAQ,OAAO,IAAI;AAC3B,MAAI,WAAW,OAAW,OAAM,IAAI,MAAM,eAAe,MAAM,EAAE;AACjE,QAAM,QAAQ,MAAM,KAAK,OAAO,CAAC,OAAO,GAAG,MAAM,gBAAgB,MAAM,GAAG,OAAO;AACjF,SAAO,WAAW,OAAO,QAAQ,CAAC,GAAG,OAAO;AAC9C;AAEA,eAAsB,UAAU,SAAuC;AACrE,QAAM,UAAU,QAAQ,WAAW;AACnC,QAAM,UAAU,MAAM,QAAQ;AAAA,IAC5B,QAAQ,WAAW,IAAI,cAAc;AAAA,IACrC;AAAA,MACE,QAAQ,QAAQ;AAAA,MAChB,UAAU,QAAQ,YAAY,eAAe;AAAA,MAC7C,GAAI,QAAQ,WAAW,EAAE,UAAU,QAAQ,SAAS,IAAI,CAAC;AAAA,IAC3D;AAAA,IACA;AAAA,EACF;AACA,QAAM,OAAO,MAAM,QAAQ,KAAK,SAAS,EAAE,OAAO,EAAE,OAAO,QAAQ,MAAM,EAAE,CAAC;AAC5E,UAAQ,OAAO;AACf,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA,QAAQ,CAAC,SAAS,OAAO,MAAM,MAAM,OAAO;AAAA,IAC5C,OAAO,MAAM,QAAQ,MAAM,OAAO;AAAA,EACpC;AACF;",
+  "names": []
+}

package/dist/index.js

@@ -0,0 +1,12 @@
+import { answerText, openAgent } from "./agent.js";
+import {
+  connectAgent,
+  serveAgent
+} from "./port.js";
+export {
+  answerText,
+  connectAgent,
+  openAgent,
+  serveAgent
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../src/index.ts"],
+  "sourcesContent": ["export { type Agent, type AgentOptions, answerText, openAgent } from './agent.ts';\nexport {\n  type AgentClient,\n  type AgentReply,\n  type AgentRequest,\n  connectAgent,\n  type MessageEndpoint,\n  serveAgent,\n} from './port.ts';\n"],
+  "mappings": "AAAA,SAAwC,YAAY,iBAAiB;AACrE;AAAA,EAIE;AAAA,EAEA;AAAA,OACK;",
+  "names": []
+}

package/dist/port.js

@@ -0,0 +1,57 @@
+function isRequest(data) {
+  const value = data;
+  return typeof value?.id === "number" && typeof value.prompt === "string";
+}
+function reason(error) {
+  return error instanceof Error ? error.message : String(error);
+}
+function serveAgent(endpoint, agent) {
+  endpoint.addEventListener("message", ({ data }) => {
+    if (!isRequest(data)) return;
+    agent.then((ready) => ready.prompt(data.prompt)).then(
+      (text) => endpoint.postMessage({ id: data.id, text }),
+      (error) => endpoint.postMessage({ id: data.id, error: reason(error) })
+    );
+  });
+  endpoint.start?.();
+}
+function failure(event) {
+  const message = event.message;
+  return new Error(message ? `agent failed: ${message}` : `agent failed: ${event.type}`);
+}
+function connectAgent(endpoint) {
+  const pending = /* @__PURE__ */ new Map();
+  let broken;
+  let next = 0;
+  const fail = (event) => {
+    broken = failure(event);
+    for (const call of pending.values()) call.reject(broken);
+    pending.clear();
+  };
+  endpoint.addEventListener("message", ({ data }) => {
+    const reply = data;
+    const call = pending.get(reply.id);
+    if (!call) return;
+    pending.delete(reply.id);
+    if ("error" in reply) call.reject(new Error(reply.error));
+    else call.resolve(reply.text);
+  });
+  endpoint.addEventListener("error", fail);
+  endpoint.addEventListener("messageerror", fail);
+  endpoint.start?.();
+  return {
+    prompt(text) {
+      if (broken) return Promise.reject(broken);
+      const id = ++next;
+      return new Promise((resolve, reject) => {
+        pending.set(id, { resolve, reject });
+        endpoint.postMessage({ id, prompt: text });
+      });
+    }
+  };
+}
+export {
+  connectAgent,
+  serveAgent
+};
+//# sourceMappingURL=port.js.map

package/dist/port.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../src/port.ts"],
+  "sourcesContent": ["import type { Agent } from './agent.ts';\n\nexport interface AgentRequest {\n  id: number;\n  prompt: string;\n}\n\nexport type AgentReply = { id: number; text: string } | { id: number; error: string };\n\nexport interface MessageEndpoint {\n  postMessage(message: unknown): void;\n  addEventListener(type: 'message', listener: (event: MessageEvent) => void): void;\n  addEventListener(type: 'error' | 'messageerror', listener: (event: Event) => void): void;\n  start?(): void;\n}\n\nfunction isRequest(data: unknown): data is AgentRequest {\n  const value = data as Partial<AgentRequest> | null;\n  return typeof value?.id === 'number' && typeof value.prompt === 'string';\n}\n\nfunction reason(error: unknown): string {\n  return error instanceof Error ? error.message : String(error);\n}\n\nexport function serveAgent(endpoint: MessageEndpoint, agent: Promise<Agent>): void {\n  endpoint.addEventListener('message', ({ data }) => {\n    if (!isRequest(data)) return;\n    agent\n      .then((ready) => ready.prompt(data.prompt))\n      .then(\n        (text) => endpoint.postMessage({ id: data.id, text } satisfies AgentReply),\n        (error: unknown) =>\n          endpoint.postMessage({ id: data.id, error: reason(error) } satisfies AgentReply)\n      );\n  });\n  endpoint.start?.();\n}\n\nexport interface AgentClient {\n  prompt(text: string): Promise<string>;\n}\n\nfunction failure(event: Event): Error {\n  const message = (event as ErrorEvent).message;\n  return new Error(message ? `agent failed: ${message}` : `agent failed: ${event.type}`);\n}\n\nexport function connectAgent(endpoint: MessageEndpoint): AgentClient {\n  const pending = new Map<number, { resolve(text: string): void; reject(error: Error): void }>();\n  let broken: Error | undefined;\n  let next = 0;\n  const fail = (event: Event) => {\n    broken = failure(event);\n    for (const call of pending.values()) call.reject(broken);\n    pending.clear();\n  };\n  endpoint.addEventListener('message', ({ data }) => {\n    const reply = data as AgentReply;\n    const call = pending.get(reply.id);\n    if (!call) return;\n    pending.delete(reply.id);\n    if ('error' in reply) call.reject(new Error(reply.error));\n    else call.resolve(reply.text);\n  });\n  endpoint.addEventListener('error', fail);\n  endpoint.addEventListener('messageerror', fail);\n  endpoint.start?.();\n  return {\n    prompt(text) {\n      if (broken) return Promise.reject(broken);\n      const id = ++next;\n      return new Promise((resolve, reject) => {\n        pending.set(id, { resolve, reject });\n        endpoint.postMessage({ id, prompt: text } satisfies AgentRequest);\n      });\n    },\n  };\n}\n"],
+  "mappings": "AAgBA,SAAS,UAAU,MAAqC;AACtD,QAAM,QAAQ;AACd,SAAO,OAAO,OAAO,OAAO,YAAY,OAAO,MAAM,WAAW;AAClE;AAEA,SAAS,OAAO,OAAwB;AACtC,SAAO,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK;AAC9D;AAEO,SAAS,WAAW,UAA2B,OAA6B;AACjF,WAAS,iBAAiB,WAAW,CAAC,EAAE,KAAK,MAAM;AACjD,QAAI,CAAC,UAAU,IAAI,EAAG;AACtB,UACG,KAAK,CAAC,UAAU,MAAM,OAAO,KAAK,MAAM,CAAC,EACzC;AAAA,MACC,CAAC,SAAS,SAAS,YAAY,EAAE,IAAI,KAAK,IAAI,KAAK,CAAsB;AAAA,MACzE,CAAC,UACC,SAAS,YAAY,EAAE,IAAI,KAAK,IAAI,OAAO,OAAO,KAAK,EAAE,CAAsB;AAAA,IACnF;AAAA,EACJ,CAAC;AACD,WAAS,QAAQ;AACnB;AAMA,SAAS,QAAQ,OAAqB;AACpC,QAAM,UAAW,MAAqB;AACtC,SAAO,IAAI,MAAM,UAAU,iBAAiB,OAAO,KAAK,iBAAiB,MAAM,IAAI,EAAE;AACvF;AAEO,SAAS,aAAa,UAAwC;AACnE,QAAM,UAAU,oBAAI,IAAyE;AAC7F,MAAI;AACJ,MAAI,OAAO;AACX,QAAM,OAAO,CAAC,UAAiB;AAC7B,aAAS,QAAQ,KAAK;AACtB,eAAW,QAAQ,QAAQ,OAAO,EAAG,MAAK,OAAO,MAAM;AACvD,YAAQ,MAAM;AAAA,EAChB;AACA,WAAS,iBAAiB,WAAW,CAAC,EAAE,KAAK,MAAM;AACjD,UAAM,QAAQ;AACd,UAAM,OAAO,QAAQ,IAAI,MAAM,EAAE;AACjC,QAAI,CAAC,KAAM;AACX,YAAQ,OAAO,MAAM,EAAE;AACvB,QAAI,WAAW,MAAO,MAAK,OAAO,IAAI,MAAM,MAAM,KAAK,CAAC;AAAA,QACnD,MAAK,QAAQ,MAAM,IAAI;AAAA,EAC9B,CAAC;AACD,WAAS,iBAAiB,SAAS,IAAI;AACvC,WAAS,iBAAiB,gBAAgB,IAAI;AAC9C,WAAS,QAAQ;AACjB,SAAO;AAAA,IACL,OAAO,MAAM;AACX,UAAI,OAAQ,QAAO,QAAQ,OAAO,MAAM;AACxC,YAAM,KAAK,EAAE;AACb,aAAO,IAAI,QAAQ,CAAC,SAAS,WAAW;AACtC,gBAAQ,IAAI,IAAI,EAAE,SAAS,OAAO,CAAC;AACnC,iBAAS,YAAY,EAAE,IAAI,QAAQ,KAAK,CAAwB;AAAA,MAClE,CAAC;AAAA,IACH;AAAA,EACF;AACF;",
+  "names": []
+}

package/dist/types/agent.d.ts

@@ -0,0 +1,19 @@
+import type { Context } from '@earendil-works/chord';
+import type { Models } from '@earendil-works/pi-ai/models';
+import { type Conversation, Harness, type HarnessOptions, type ModelRef, type Registry, type Storage } from '@earendil-works/pi-durable';
+export interface AgentOptions {
+    models: Models;
+    model: ModelRef;
+    storage?: Storage;
+    registry?: Registry;
+    settings?: HarnessOptions['settings'];
+    context?: Context;
+}
+export interface Agent {
+    readonly harness: Harness;
+    readonly root: Conversation;
+    prompt(text: string): Promise<string>;
+    close(): Promise<void>;
+}
+export declare function answerText(content: unknown): string;
+export declare function openAgent(options: AgentOptions): Promise<Agent>;

package/dist/types/index.d.ts

@@ -0,0 +1,2 @@
+export { type Agent, type AgentOptions, answerText, openAgent } from './agent.ts';
+export { type AgentClient, type AgentReply, type AgentRequest, connectAgent, type MessageEndpoint, serveAgent, } from './port.ts';

package/dist/types/port.d.ts

@@ -0,0 +1,23 @@
+import type { Agent } from './agent.ts';
+export interface AgentRequest {
+    id: number;
+    prompt: string;
+}
+export type AgentReply = {
+    id: number;
+    text: string;
+} | {
+    id: number;
+    error: string;
+};
+export interface MessageEndpoint {
+    postMessage(message: unknown): void;
+    addEventListener(type: 'message', listener: (event: MessageEvent) => void): void;
+    addEventListener(type: 'error' | 'messageerror', listener: (event: Event) => void): void;
+    start?(): void;
+}
+export declare function serveAgent(endpoint: MessageEndpoint, agent: Promise<Agent>): void;
+export interface AgentClient {
+    prompt(text: string): Promise<string>;
+}
+export declare function connectAgent(endpoint: MessageEndpoint): AgentClient;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@ai-ecoverse/slicc-agent",
-  "version": "1.0.0",
-  "description": "SLICC's agent core: session storage in wasm SQLite, remoting, compaction, and pi extensions",
+  "version": "1.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",
   "repository": {
@@ -22,24 +22,43 @@
     "provenance": true
   },
   "exports": {
-    ".": "./src/index.js"
+    ".": {
+      "types": "./dist/types/index.d.ts",
+      "default": "./dist/index.js"
+    }
   },
   "files": [
-    "src"
+    "dist"
   ],
   "scripts": {
     "prepare": "lefthook install",
+    "build": "node build.mjs && tsc -p tsconfig.build.json",
+    "prepack": "npm run build",
+    "start": "npm run build && node test/integration/chrome.mjs",
+    "pretest": "npm run build && node test/integration/build.mjs && playwright-core install --no-shell chromium",
+    "test": "node --test --test-global-setup=node_modules/@ai-ecoverse/slicc-shared-web/harness/global.mjs 'test/integration/*.test.mjs'",
+    "test:unit": "NODE_NO_WARNINGS=1 mcr -c node_modules/@ai-ecoverse/slicc-shared-web/mcr.config.mjs node --test 'test/unit/**/*.test.mjs'",
+    "typecheck": "tsc",
     "lint": "slicc-lint",
     "format": "biome check --write .",
-    "test": "true",
     "trust": "npx fledgling sync -y --skip-publish",
     "trust:dry": "npx fledgling sync --dry-run -y --skip-publish",
     "release": "semantic-release"
   },
   "devDependencies": {
-    "@ai-ecoverse/slicc-shared-web": "1.1.0",
+    "@ai-ecoverse/slicc-shared-web": "1.5.0",
     "@biomejs/biome": "2.5.15",
+    "@types/node": "24.19.1",
+    "esbuild": "0.28.2",
     "lefthook": "2.1.16",
-    "semantic-release": "25.0.9"
+    "monocart-coverage-reports": "2.13.0",
+    "playwright-core": "1.63.0",
+    "semantic-release": "25.0.9",
+    "typescript": "7.0.2"
+  },
+  "dependencies": {
+    "@earendil-works/chord": "1.0.4",
+    "@earendil-works/pi-ai": "1.0.4",
+    "@earendil-works/pi-durable": "1.0.4"
   }
 }

package/src/index.js

@@ -1 +0,0 @@
-export {};