@ai-ecoverse/slicc-agent 2.0.0 → 2.2.0

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/agent.d.ts

@@ -7,6 +7,7 @@ export interface AgentOptions {
     storage?: Storage;
     registry?: Registry;
     settings?: HarnessOptions['settings'];
+    env?: HarnessOptions['env'];
     context?: Context;
 }
 export interface Agent {

package/dist/types/index.d.ts

@@ -2,8 +2,10 @@ export { type Agent, type AgentOptions, answerText, openAgent } from './agent.ts
 export { type AgentConnection, connectAgent } from './client.ts';
 export { createAgentControl } from './control.ts';
 export { type AgentHost, hostAgent } from './host.ts';
+export type { KernelClient, KernelFs, KernelProcess, KernelStat, SpawnOptions, } from './kernel/client.ts';
+export { HOME, type KernelEnvOptions, kernelEnvironment, SliccKernelEnv } from './kernel/env.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';
+export { kernelPort, serveConnections, type WorkerScope } from './worker.ts';

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

@@ -0,0 +1,39 @@
+export interface KernelStat {
+    isFile: boolean;
+    isDirectory: boolean;
+    isSymbolicLink: boolean;
+    size: number;
+    mtime: Date | number;
+    ino?: number;
+}
+export interface KernelFs {
+    readFile(path: string): Promise<Uint8Array>;
+    readText(path: string): Promise<string>;
+    writeFile(path: string, data: string | Uint8Array): Promise<void>;
+    stat(path: string): Promise<KernelStat>;
+    lstat(path: string): Promise<KernelStat>;
+    readdir(path: string): Promise<string[]>;
+    mkdir(path: string): Promise<void>;
+    rm(path: string, options?: {
+        force?: boolean;
+    }): Promise<void>;
+    rename(from: string, to: string): Promise<void>;
+    realpath(path: string): Promise<string>;
+    exists(path: string): Promise<boolean>;
+}
+export interface KernelProcess {
+    pid: number;
+    pgid: number;
+    exited: Promise<number>;
+    signal(name?: string): unknown;
+}
+export interface SpawnOptions {
+    cwd?: string;
+    env?: Record<string, string>;
+    onStdout?(bytes: Uint8Array): void;
+    onStderr?(bytes: Uint8Array): void;
+}
+export interface KernelClient {
+    fs: KernelFs;
+    spawn(argv: readonly string[], options: SpawnOptions): Promise<KernelProcess>;
+}

package/dist/types/kernel/env.d.ts

@@ -0,0 +1,57 @@
+import type { Context } from '@earendil-works/chord';
+import { type BinaryReader, type DirReader, type ExecutionEnv, type ExecutionError, FileError, type FileInfo, type FileWatcher, type Result, type ShellExecOptions, type ShellExecResult, type TextLineReader, type WatchChange, type WatchTarget } from '@earendil-works/pi-durable/env';
+import type { KernelClient } from './client.ts';
+import { type PollOptions } from './watch.ts';
+export interface KernelEnvOptions {
+    cwd: string;
+    id?: string;
+    watch?: PollOptions;
+}
+type FileResult<T> = Promise<Result<T, FileError>>;
+export declare class SliccKernelEnv implements ExecutionEnv {
+    #private;
+    readonly id: string;
+    cwd: string;
+    constructor(client: KernelClient, options: KernelEnvOptions);
+    absolutePath(path: string): FileResult<string>;
+    joinPath(parts: string[]): FileResult<string>;
+    readTextFile(path: string, context: Context): FileResult<string>;
+    readBinaryFile(path: string, context: Context): FileResult<Uint8Array>;
+    openTextLineReader(path: string, context: Context): FileResult<TextLineReader>;
+    readTextLines(path: string, options: {
+        maxLines?: number;
+    } | undefined, context: Context): FileResult<string[]>;
+    openBinaryReader(path: string, options: {
+        noFollow?: boolean;
+    } | undefined, context: Context): FileResult<BinaryReader>;
+    writeFile(path: string, content: string | Uint8Array, context: Context): FileResult<void>;
+    appendFile(path: string, content: string | Uint8Array, context: Context): FileResult<void>;
+    truncateFile(path: string, size: number, context: Context): FileResult<void>;
+    flushFile(path: string, context: Context): FileResult<void>;
+    renameFile(sourcePath: string, destinationPath: string, context: Context): FileResult<void>;
+    fileInfo(path: string, context: Context): FileResult<FileInfo>;
+    listDir(path: string, context: Context): FileResult<FileInfo[]>;
+    openDirReader(path: string, context: Context): FileResult<DirReader>;
+    watch(targets: readonly WatchTarget[], onChange: (change: WatchChange) => void, context: Context): FileResult<FileWatcher>;
+    canonicalPath(path: string, context: Context): FileResult<string>;
+    exists(path: string, context: Context): FileResult<boolean>;
+    createDir(path: string, _options: {
+        recursive?: boolean;
+    } | undefined, context: Context): FileResult<void>;
+    remove(path: string, options: {
+        recursive?: boolean;
+        force?: boolean;
+    } | undefined, context: Context): FileResult<void>;
+    createTempDir(prefix: string | undefined, context: Context): FileResult<string>;
+    createTempFile(options: {
+        prefix?: string;
+        suffix?: string;
+    } | undefined, context: Context): FileResult<string>;
+    exec(command: string | readonly string[], options: ShellExecOptions | undefined, context: Context): Promise<Result<ShellExecResult, ExecutionError>>;
+    cleanup(context: Context): Promise<void>;
+}
+export declare const HOME = "/home";
+export declare function kernelEnvironment(client: KernelClient, options?: Omit<KernelEnvOptions, 'cwd'>): (target: {
+    cwd?: string;
+}) => SliccKernelEnv;
+export {};

package/dist/types/kernel/exec.d.ts

@@ -0,0 +1,5 @@
+import type { Context } from '@earendil-works/chord';
+import { ExecutionError, type Result, type ShellExecOptions, type ShellExecResult } from '@earendil-works/pi-durable/env';
+import type { KernelClient } from './client.ts';
+export declare const SHELL: readonly ['bash', '-c'];
+export declare function execute(client: KernelClient, cwd: string, command: string | readonly string[], options: ShellExecOptions | undefined, context: Context): Promise<Result<ShellExecResult, ExecutionError>>;

package/dist/types/kernel/files.d.ts

@@ -0,0 +1,34 @@
+import type { Context } from '@earendil-works/chord';
+import { type BinaryReader, type DirReader, FileError, type FileInfo, type LineScan, type Result, type TextLine, type TextLineReader } from '@earendil-works/pi-durable/env';
+import type { KernelFs, KernelStat } from './client.ts';
+export declare function fileError(error: unknown, path?: string): FileError;
+export declare function aborted(context: Context, path?: string): Result<never, FileError> | undefined;
+export declare function attempt<T>(context: Context, path: string, run: () => Promise<T>): Promise<Result<T, FileError>>;
+export declare function info(path: string, stat: KernelStat): FileInfo;
+export declare class SnapshotReader implements BinaryReader {
+    #private;
+    constructor(bytes: Uint8Array, fileInfo: FileInfo);
+    info(): Promise<Result<FileInfo, FileError>>;
+    read(offset: number, length: number, context: Context): Promise<Result<Uint8Array, FileError>>;
+    scanLines(options: {
+        startLine: number;
+        endLine?: number;
+    }, context: Context): Promise<Result<LineScan, FileError>>;
+    close(): Promise<void>;
+}
+export declare class SnapshotLines implements TextLineReader {
+    #private;
+    constructor(text: string);
+    readLine(): Promise<Result<TextLine | undefined, FileError>>;
+    close(): Promise<void>;
+}
+export declare class KernelDirReader implements DirReader {
+    #private;
+    constructor(fs: KernelFs, path: string, names: string[]);
+    next(maxEntries: number, context: Context): Promise<Result<{
+        entries: FileInfo[];
+        done: boolean;
+    }, FileError>>;
+    rest(): Promise<FileInfo[]>;
+    close(): Promise<void>;
+}

package/dist/types/kernel/paths.d.ts

@@ -0,0 +1,4 @@
+export declare function normalize(path: string): string;
+export declare function resolve(cwd: string, path: string): string;
+export declare function dirname(path: string): string;
+export declare function basename(path: string): string;

package/dist/types/kernel/watch.d.ts

@@ -0,0 +1,10 @@
+import type { FileWatcher, WatchChange, WatchTarget } from '@earendil-works/pi-durable/env';
+import type { KernelFs } from './client.ts';
+type Snapshot = Map<string, string>;
+export declare function snapshot(fs: KernelFs, cwd: string, targets: readonly WatchTarget[]): Promise<Snapshot>;
+export declare function differences(before: Snapshot, after: Snapshot): string[];
+export interface PollOptions {
+    intervalMs?: number;
+}
+export declare function pollWatch(fs: KernelFs, cwd: string, targets: readonly WatchTarget[], onChange: (change: WatchChange) => void, options?: PollOptions): Promise<FileWatcher>;
+export {};

package/dist/types/owner.d.ts

@@ -7,11 +7,15 @@ export interface AgentWorker {
 }
 export interface AgentOwner {
     connect(): Promise<AgentConnection>;
-    restart(): void;
-    release(): void;
+    restart(): Promise<void>;
+    release(): Promise<void>;
+}
+export interface KernelSource {
+    connect(): Promise<Transferable>;
 }
 export interface OwnerOptions {
     worker: () => AgentWorker;
+    kernel?: KernelSource;
     locks?: LockManager;
     channel?: () => {
         port1: PortEndpoint;

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/dist/types/worker.d.ts

@@ -3,3 +3,4 @@ export interface WorkerScope {
     addEventListener(type: 'message', listener: (event: MessageEvent) => void): void;
 }
 export declare function serveConnections(scope: WorkerScope, host: Promise<AgentHost>): void;
+export declare function kernelPort(scope: WorkerScope): Promise<MessagePort>;

package/dist/worker.js

@@ -8,7 +8,16 @@ function serveConnections(scope, host) {
     );
   });
 }
+function kernelPort(scope) {
+  return new Promise((resolve) => {
+    scope.addEventListener("message", ({ data }) => {
+      const port = data?.kernel;
+      if (port) resolve(port);
+    });
+  });
+}
 export {
+  kernelPort,
   serveConnections
 };
 //# sourceMappingURL=worker.js.map

package/dist/worker.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../src/worker.ts"],
-  "sourcesContent": ["import type { AgentHost } from './host.ts';\nimport type { PortEndpoint } from './wire.ts';\n\nexport interface WorkerScope {\n  addEventListener(type: 'message', listener: (event: MessageEvent) => void): void;\n}\n\nexport function serveConnections(scope: WorkerScope, host: Promise<AgentHost>): void {\n  scope.addEventListener('message', ({ data }) => {\n    const port = (data as { connect?: PortEndpoint } | null)?.connect;\n    if (!port) return;\n    host.then(\n      (ready) => ready.connect(port),\n      () => port.close?.()\n    );\n  });\n}\n"],
-  "mappings": "AAOO,SAAS,iBAAiB,OAAoB,MAAgC;AACnF,QAAM,iBAAiB,WAAW,CAAC,EAAE,KAAK,MAAM;AAC9C,UAAM,OAAQ,MAA4C;AAC1D,QAAI,CAAC,KAAM;AACX,SAAK;AAAA,MACH,CAAC,UAAU,MAAM,QAAQ,IAAI;AAAA,MAC7B,MAAM,KAAK,QAAQ;AAAA,IACrB;AAAA,EACF,CAAC;AACH;",
+  "sourcesContent": ["import type { AgentHost } from './host.ts';\nimport type { PortEndpoint } from './wire.ts';\n\nexport interface WorkerScope {\n  addEventListener(type: 'message', listener: (event: MessageEvent) => void): void;\n}\n\nexport function serveConnections(scope: WorkerScope, host: Promise<AgentHost>): void {\n  scope.addEventListener('message', ({ data }) => {\n    const port = (data as { connect?: PortEndpoint } | null)?.connect;\n    if (!port) return;\n    host.then(\n      (ready) => ready.connect(port),\n      () => port.close?.()\n    );\n  });\n}\n\nexport function kernelPort(scope: WorkerScope): Promise<MessagePort> {\n  return new Promise((resolve) => {\n    scope.addEventListener('message', ({ data }) => {\n      const port = (data as { kernel?: MessagePort } | null)?.kernel;\n      if (port) resolve(port);\n    });\n  });\n}\n"],
+  "mappings": "AAOO,SAAS,iBAAiB,OAAoB,MAAgC;AACnF,QAAM,iBAAiB,WAAW,CAAC,EAAE,KAAK,MAAM;AAC9C,UAAM,OAAQ,MAA4C;AAC1D,QAAI,CAAC,KAAM;AACX,SAAK;AAAA,MACH,CAAC,UAAU,MAAM,QAAQ,IAAI;AAAA,MAC7B,MAAM,KAAK,QAAQ;AAAA,IACrB;AAAA,EACF,CAAC;AACH;AAEO,SAAS,WAAW,OAA0C;AACnE,SAAO,IAAI,QAAQ,CAAC,YAAY;AAC9B,UAAM,iBAAiB,WAAW,CAAC,EAAE,KAAK,MAAM;AAC9C,YAAM,OAAQ,MAA0C;AACxD,UAAI,KAAM,SAAQ,IAAI;AAAA,IACxB,CAAC;AAAA,EACH,CAAC;AACH;",
   "names": []
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ai-ecoverse/slicc-agent",
-  "version": "2.0.0",
+  "version": "2.2.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": [
@@ -36,7 +40,7 @@
     "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": "node --test --test-timeout=120000 --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",
@@ -46,7 +50,11 @@
     "release": "semantic-release"
   },
   "devDependencies": {
+    "@ai-ecoverse/slicc-kernel": "1.9.0",
     "@ai-ecoverse/slicc-shared-web": "1.5.0",
+    "@ai-ecoverse/slicc-spectrum": "1.7.0",
+    "@ai-ecoverse/wasm-bash": "5.3.0-7",
+    "@ai-ecoverse/wasm-coreutils": "9.7.0-3",
     "@biomejs/biome": "2.5.15",
     "@types/node": "24.19.1",
     "esbuild": "0.28.2",
@@ -64,5 +72,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"
   }
 }