@ai-ecoverse/slicc-agent 2.0.0 → 2.2.0

package/dist/kernel/files.js

@@ -0,0 +1,153 @@
+import {
+  err,
+  FileError,
+  LineScanner,
+  ok
+} from "@earendil-works/pi-durable/env";
+import { basename } from "./paths.js";
+const codes = {
+  ENOENT: "not_found",
+  EACCES: "permission_denied",
+  EPERM: "permission_denied",
+  ENOTDIR: "not_directory",
+  EISDIR: "is_directory",
+  EINVAL: "invalid",
+  ELOOP: "invalid",
+  ENOSYS: "not_supported",
+  ENOTSUP: "not_supported"
+};
+function fileError(error, path) {
+  if (error instanceof FileError) return error;
+  const code = error?.code;
+  const message = error instanceof Error ? error.message : String(error);
+  const cause = error instanceof Error ? error : void 0;
+  return new FileError(code && codes[code] || "unknown", message, path, cause);
+}
+function aborted(context, path) {
+  if (!context.abortSignal?.aborted) return void 0;
+  return err(new FileError("aborted", "The operation was aborted", path));
+}
+async function attempt(context, path, run) {
+  const before = aborted(context, path);
+  if (before) return before;
+  try {
+    const value = await run();
+    return aborted(context, path) ?? ok(value);
+  } catch (error) {
+    return err(fileError(error, path));
+  }
+}
+function info(path, stat) {
+  const kind = stat.isSymbolicLink ? "symlink" : stat.isDirectory ? "directory" : "file";
+  return {
+    name: basename(path),
+    path,
+    kind,
+    size: stat.size,
+    mtimeMs: new Date(stat.mtime).getTime()
+  };
+}
+function closed(what, path) {
+  return err(new FileError("invalid", `${what} is closed`, path));
+}
+class SnapshotReader {
+  #bytes;
+  #info;
+  #closed = false;
+  constructor(bytes, fileInfo) {
+    this.#bytes = bytes;
+    this.#info = fileInfo;
+  }
+  async info() {
+    return this.#closed ? closed("Binary reader", this.#info.path) : ok(this.#info);
+  }
+  async read(offset, length, context) {
+    const path = this.#info.path;
+    const stop = aborted(context, path);
+    if (stop) return stop;
+    if (this.#closed) return closed("Binary reader", path);
+    if (!Number.isSafeInteger(offset) || offset < 0 || !Number.isSafeInteger(length) || length < 0) {
+      return err(new FileError("invalid", "Offset and length must be non-negative integers", path));
+    }
+    return ok(this.#bytes.slice(offset, offset + length));
+  }
+  async scanLines(options, context) {
+    const path = this.#info.path;
+    const stop = aborted(context, path);
+    if (stop) return stop;
+    if (this.#closed) return closed("Binary reader", path);
+    let scanner;
+    try {
+      scanner = new LineScanner(options.startLine, options.endLine);
+    } catch {
+      return err(new FileError("invalid", "Invalid line range", path));
+    }
+    scanner.push(this.#bytes);
+    return ok(scanner.finish());
+  }
+  async close() {
+    this.#closed = true;
+  }
+}
+class SnapshotLines {
+  #lines;
+  #next = 0;
+  constructor(text) {
+    const parts = text.split("\n");
+    const last = parts.pop();
+    this.#lines = parts.map((part) => ({ text: part, terminated: true }));
+    if (last !== "") this.#lines.push({ text: last, terminated: false });
+  }
+  async readLine() {
+    return ok(this.#lines[this.#next++]);
+  }
+  async close() {
+    this.#next = this.#lines.length;
+  }
+}
+class KernelDirReader {
+  #fs;
+  #path;
+  #names;
+  #closed = false;
+  constructor(fs, path, names) {
+    this.#fs = fs;
+    this.#path = path;
+    this.#names = names;
+  }
+  async next(maxEntries, context) {
+    if (this.#closed) return closed("Directory reader", this.#path);
+    if (!Number.isSafeInteger(maxEntries) || maxEntries < 1) {
+      return err(new FileError("invalid", "maxEntries must be a positive integer", this.#path));
+    }
+    const stop = aborted(context, this.#path);
+    if (stop) return stop;
+    const entries = await this.#take(maxEntries);
+    return ok({ entries, done: this.#names.length === 0 });
+  }
+  rest() {
+    return this.#take(Number.MAX_SAFE_INTEGER);
+  }
+  async #take(max) {
+    const entries = [];
+    while (entries.length < max && this.#names.length > 0) {
+      const path = `${this.#path === "/" ? "" : this.#path}/${this.#names.shift()}`;
+      const stat = await this.#fs.lstat(path).catch(() => void 0);
+      if (stat) entries.push(info(path, stat));
+    }
+    return entries;
+  }
+  async close() {
+    this.#closed = true;
+  }
+}
+export {
+  KernelDirReader,
+  SnapshotLines,
+  SnapshotReader,
+  aborted,
+  attempt,
+  fileError,
+  info
+};
+//# sourceMappingURL=files.js.map

package/dist/kernel/files.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/kernel/files.ts"],
+  "sourcesContent": ["import type { Context } from '@earendil-works/chord';\nimport {\n  type BinaryReader,\n  type DirReader,\n  err,\n  FileError,\n  type FileErrorCode,\n  type FileInfo,\n  type LineScan,\n  LineScanner,\n  ok,\n  type Result,\n  type TextLine,\n  type TextLineReader,\n} from '@earendil-works/pi-durable/env';\nimport type { KernelFs, KernelStat } from './client.ts';\nimport { basename } from './paths.ts';\n\nconst codes: Record<string, FileErrorCode> = {\n  ENOENT: 'not_found',\n  EACCES: 'permission_denied',\n  EPERM: 'permission_denied',\n  ENOTDIR: 'not_directory',\n  EISDIR: 'is_directory',\n  EINVAL: 'invalid',\n  ELOOP: 'invalid',\n  ENOSYS: 'not_supported',\n  ENOTSUP: 'not_supported',\n};\n\nexport function fileError(error: unknown, path?: string): FileError {\n  if (error instanceof FileError) return error;\n  const code = (error as { code?: string } | null)?.code;\n  const message = error instanceof Error ? error.message : String(error);\n  const cause = error instanceof Error ? error : undefined;\n  return new FileError((code && codes[code]) || 'unknown', message, path, cause);\n}\n\nexport function aborted(context: Context, path?: string): Result<never, FileError> | undefined {\n  if (!context.abortSignal?.aborted) return undefined;\n  return err(new FileError('aborted', 'The operation was aborted', path));\n}\n\nexport async function attempt<T>(\n  context: Context,\n  path: string,\n  run: () => Promise<T>\n): Promise<Result<T, FileError>> {\n  const before = aborted(context, path);\n  if (before) return before;\n  try {\n    const value = await run();\n    return aborted(context, path) ?? ok(value);\n  } catch (error) {\n    return err(fileError(error, path));\n  }\n}\n\nexport function info(path: string, stat: KernelStat): FileInfo {\n  const kind = stat.isSymbolicLink ? 'symlink' : stat.isDirectory ? 'directory' : 'file';\n  return {\n    name: basename(path),\n    path,\n    kind,\n    size: stat.size,\n    mtimeMs: new Date(stat.mtime).getTime(),\n  };\n}\n\nfunction closed<T>(what: string, path: string): Result<T, FileError> {\n  return err(new FileError('invalid', `${what} is closed`, path));\n}\n\nexport class SnapshotReader implements BinaryReader {\n  readonly #bytes: Uint8Array;\n  readonly #info: FileInfo;\n  #closed = false;\n\n  constructor(bytes: Uint8Array, fileInfo: FileInfo) {\n    this.#bytes = bytes;\n    this.#info = fileInfo;\n  }\n\n  async info(): Promise<Result<FileInfo, FileError>> {\n    return this.#closed ? closed('Binary reader', this.#info.path) : ok(this.#info);\n  }\n\n  async read(\n    offset: number,\n    length: number,\n    context: Context\n  ): Promise<Result<Uint8Array, FileError>> {\n    const path = this.#info.path;\n    const stop = aborted(context, path);\n    if (stop) return stop;\n    if (this.#closed) return closed('Binary reader', path);\n    if (\n      !Number.isSafeInteger(offset) ||\n      offset < 0 ||\n      !Number.isSafeInteger(length) ||\n      length < 0\n    ) {\n      return err(new FileError('invalid', 'Offset and length must be non-negative integers', path));\n    }\n    return ok(this.#bytes.slice(offset, offset + length));\n  }\n\n  async scanLines(\n    options: { startLine: number; endLine?: number },\n    context: Context\n  ): Promise<Result<LineScan, FileError>> {\n    const path = this.#info.path;\n    const stop = aborted(context, path);\n    if (stop) return stop;\n    if (this.#closed) return closed('Binary reader', path);\n    let scanner: LineScanner;\n    try {\n      scanner = new LineScanner(options.startLine, options.endLine);\n    } catch {\n      return err(new FileError('invalid', 'Invalid line range', path));\n    }\n    scanner.push(this.#bytes);\n    return ok(scanner.finish());\n  }\n\n  async close(): Promise<void> {\n    this.#closed = true;\n  }\n}\n\nexport class SnapshotLines implements TextLineReader {\n  readonly #lines: TextLine[];\n  #next = 0;\n\n  constructor(text: string) {\n    const parts = text.split('\\n');\n    const last = parts.pop() as string;\n    this.#lines = parts.map((part) => ({ text: part, terminated: true }));\n    if (last !== '') this.#lines.push({ text: last, terminated: false });\n  }\n\n  async readLine(): Promise<Result<TextLine | undefined, FileError>> {\n    return ok(this.#lines[this.#next++]);\n  }\n\n  async close(): Promise<void> {\n    this.#next = this.#lines.length;\n  }\n}\n\nexport class KernelDirReader implements DirReader {\n  readonly #fs: KernelFs;\n  readonly #path: string;\n  readonly #names: string[];\n  #closed = false;\n\n  constructor(fs: KernelFs, path: string, names: string[]) {\n    this.#fs = fs;\n    this.#path = path;\n    this.#names = names;\n  }\n\n  async next(\n    maxEntries: number,\n    context: Context\n  ): Promise<Result<{ entries: FileInfo[]; done: boolean }, FileError>> {\n    if (this.#closed) return closed('Directory reader', this.#path);\n    if (!Number.isSafeInteger(maxEntries) || maxEntries < 1) {\n      return err(new FileError('invalid', 'maxEntries must be a positive integer', this.#path));\n    }\n    const stop = aborted(context, this.#path);\n    if (stop) return stop;\n    const entries = await this.#take(maxEntries);\n    return ok({ entries, done: this.#names.length === 0 });\n  }\n\n  rest(): Promise<FileInfo[]> {\n    return this.#take(Number.MAX_SAFE_INTEGER);\n  }\n\n  async #take(max: number): Promise<FileInfo[]> {\n    const entries: FileInfo[] = [];\n    while (entries.length < max && this.#names.length > 0) {\n      const path = `${this.#path === '/' ? '' : this.#path}/${this.#names.shift()}`;\n      const stat = await this.#fs.lstat(path).catch(() => undefined);\n      if (stat) entries.push(info(path, stat));\n    }\n    return entries;\n  }\n\n  async close(): Promise<void> {\n    this.#closed = true;\n  }\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/kernel/paths.js

@@ -0,0 +1,31 @@
+function normalize(path) {
+  const absolute = path.startsWith("/");
+  const parts = [];
+  for (const part of path.split("/")) {
+    if (part === "" || part === ".") continue;
+    if (part === "..") {
+      if (parts.length > 0 && parts.at(-1) !== "..") parts.pop();
+      else if (!absolute) parts.push(part);
+    } else parts.push(part);
+  }
+  const joined = parts.join("/");
+  if (absolute) return `/${joined}`;
+  return joined || ".";
+}
+function resolve(cwd, path) {
+  return normalize(path.startsWith("/") ? path : `${cwd}/${path}`);
+}
+function dirname(path) {
+  const index = path.lastIndexOf("/");
+  return index <= 0 ? "/" : path.slice(0, index);
+}
+function basename(path) {
+  return path.slice(path.lastIndexOf("/") + 1);
+}
+export {
+  basename,
+  dirname,
+  normalize,
+  resolve
+};
+//# sourceMappingURL=paths.js.map

package/dist/kernel/paths.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/kernel/paths.ts"],
+  "sourcesContent": ["export function normalize(path: string): string {\n  const absolute = path.startsWith('/');\n  const parts: string[] = [];\n  for (const part of path.split('/')) {\n    if (part === '' || part === '.') continue;\n    if (part === '..') {\n      if (parts.length > 0 && parts.at(-1) !== '..') parts.pop();\n      else if (!absolute) parts.push(part);\n    } else parts.push(part);\n  }\n  const joined = parts.join('/');\n  if (absolute) return `/${joined}`;\n  return joined || '.';\n}\n\nexport function resolve(cwd: string, path: string): string {\n  return normalize(path.startsWith('/') ? path : `${cwd}/${path}`);\n}\n\nexport function dirname(path: string): string {\n  const index = path.lastIndexOf('/');\n  return index <= 0 ? '/' : path.slice(0, index);\n}\n\nexport function basename(path: string): string {\n  return path.slice(path.lastIndexOf('/') + 1);\n}\n"],
+  "mappings": "AAAO,SAAS,UAAU,MAAsB;AAC9C,QAAM,WAAW,KAAK,WAAW,GAAG;AACpC,QAAM,QAAkB,CAAC;AACzB,aAAW,QAAQ,KAAK,MAAM,GAAG,GAAG;AAClC,QAAI,SAAS,MAAM,SAAS,IAAK;AACjC,QAAI,SAAS,MAAM;AACjB,UAAI,MAAM,SAAS,KAAK,MAAM,GAAG,EAAE,MAAM,KAAM,OAAM,IAAI;AAAA,eAChD,CAAC,SAAU,OAAM,KAAK,IAAI;AAAA,IACrC,MAAO,OAAM,KAAK,IAAI;AAAA,EACxB;AACA,QAAM,SAAS,MAAM,KAAK,GAAG;AAC7B,MAAI,SAAU,QAAO,IAAI,MAAM;AAC/B,SAAO,UAAU;AACnB;AAEO,SAAS,QAAQ,KAAa,MAAsB;AACzD,SAAO,UAAU,KAAK,WAAW,GAAG,IAAI,OAAO,GAAG,GAAG,IAAI,IAAI,EAAE;AACjE;AAEO,SAAS,QAAQ,MAAsB;AAC5C,QAAM,QAAQ,KAAK,YAAY,GAAG;AAClC,SAAO,SAAS,IAAI,MAAM,KAAK,MAAM,GAAG,KAAK;AAC/C;AAEO,SAAS,SAAS,MAAsB;AAC7C,SAAO,KAAK,MAAM,KAAK,YAAY,GAAG,IAAI,CAAC;AAC7C;",
+  "names": []
+}

package/dist/kernel/watch.js

@@ -0,0 +1,71 @@
+import { dirname, resolve } from "./paths.js";
+function excluded(name, target) {
+  const rule = target.exclude;
+  if (!rule) return false;
+  return rule.hidden === true && name.startsWith(".") || (rule.names?.includes(name) ?? false);
+}
+async function record(fs, path, into) {
+  const stat = await fs.stat(path).catch(() => void 0);
+  if (!stat) return false;
+  into.set(
+    path,
+    `${stat.isDirectory ? "d" : "f"}:${stat.ino}:${stat.size}:${new Date(stat.mtime).getTime()}`
+  );
+  return stat.isDirectory;
+}
+async function scan(fs, path, target, deep, into) {
+  const directory = await record(fs, path, into);
+  if (!directory || !deep) return;
+  const names = await fs.readdir(path).catch(() => []);
+  for (const name of names) {
+    if (excluded(name, target)) continue;
+    const child = `${path === "/" ? "" : path}/${name}`;
+    await scan(fs, child, target, target.recursive === true, into);
+  }
+}
+async function snapshot(fs, cwd, targets) {
+  const all = /* @__PURE__ */ new Map();
+  for (const target of targets) await scan(fs, resolve(cwd, target.path), target, true, all);
+  return all;
+}
+function differences(before, after) {
+  const changed = /* @__PURE__ */ new Set();
+  const moved = (path) => {
+    changed.add(path);
+    changed.add(dirname(path));
+  };
+  for (const [path, value] of after) {
+    if (!before.has(path)) moved(path);
+    else if (before.get(path) !== value) changed.add(path);
+  }
+  for (const path of before.keys()) if (!after.has(path)) moved(path);
+  return [...changed];
+}
+async function pollWatch(fs, cwd, targets, onChange, options = {}) {
+  let current = await snapshot(fs, cwd, targets);
+  let open = true;
+  let running = Promise.resolve();
+  const tick = async () => {
+    const next = await snapshot(fs, cwd, targets);
+    const paths = differences(current, next);
+    current = next;
+    if (open && paths.length > 0) onChange({ paths });
+  };
+  const timer = setInterval(() => {
+    running = running.then(tick);
+  }, options.intervalMs ?? 100);
+  return {
+    mode: "polling",
+    async close(_context) {
+      open = false;
+      clearInterval(timer);
+      await running;
+    }
+  };
+}
+export {
+  differences,
+  pollWatch,
+  snapshot
+};
+//# sourceMappingURL=watch.js.map

package/dist/kernel/watch.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/kernel/watch.ts"],
+  "sourcesContent": ["import type { Context } from '@earendil-works/chord';\nimport type { FileWatcher, WatchChange, WatchTarget } from '@earendil-works/pi-durable/env';\nimport type { KernelFs } from './client.ts';\nimport { dirname, resolve } from './paths.ts';\n\ntype Snapshot = Map<string, string>;\n\nfunction excluded(name: string, target: WatchTarget): boolean {\n  const rule = target.exclude;\n  if (!rule) return false;\n  return (rule.hidden === true && name.startsWith('.')) || (rule.names?.includes(name) ?? false);\n}\n\nasync function record(fs: KernelFs, path: string, into: Snapshot): Promise<boolean> {\n  const stat = await fs.stat(path).catch(() => undefined);\n  if (!stat) return false;\n  into.set(\n    path,\n    `${stat.isDirectory ? 'd' : 'f'}:${stat.ino}:${stat.size}:${new Date(stat.mtime).getTime()}`\n  );\n  return stat.isDirectory;\n}\n\nasync function scan(\n  fs: KernelFs,\n  path: string,\n  target: WatchTarget,\n  deep: boolean,\n  into: Snapshot\n) {\n  const directory = await record(fs, path, into);\n  if (!directory || !deep) return;\n  const names = await fs.readdir(path).catch(() => [] as string[]);\n  for (const name of names) {\n    if (excluded(name, target)) continue;\n    const child = `${path === '/' ? '' : path}/${name}`;\n    await scan(fs, child, target, target.recursive === true, into);\n  }\n}\n\nexport async function snapshot(\n  fs: KernelFs,\n  cwd: string,\n  targets: readonly WatchTarget[]\n): Promise<Snapshot> {\n  const all: Snapshot = new Map();\n  for (const target of targets) await scan(fs, resolve(cwd, target.path), target, true, all);\n  return all;\n}\n\nexport function differences(before: Snapshot, after: Snapshot): string[] {\n  const changed = new Set<string>();\n  const moved = (path: string) => {\n    changed.add(path);\n    changed.add(dirname(path));\n  };\n  for (const [path, value] of after) {\n    if (!before.has(path)) moved(path);\n    else if (before.get(path) !== value) changed.add(path);\n  }\n  for (const path of before.keys()) if (!after.has(path)) moved(path);\n  return [...changed];\n}\n\nexport interface PollOptions {\n  intervalMs?: number;\n}\n\nexport async function pollWatch(\n  fs: KernelFs,\n  cwd: string,\n  targets: readonly WatchTarget[],\n  onChange: (change: WatchChange) => void,\n  options: PollOptions = {}\n): Promise<FileWatcher> {\n  let current = await snapshot(fs, cwd, targets);\n  let open = true;\n  let running = Promise.resolve();\n  const tick = async () => {\n    const next = await snapshot(fs, cwd, targets);\n    const paths = differences(current, next);\n    current = next;\n    if (open && paths.length > 0) onChange({ paths });\n  };\n  const timer = setInterval(() => {\n    running = running.then(tick);\n  }, options.intervalMs ?? 100);\n  return {\n    mode: 'polling',\n    async close(_context: Context) {\n      open = false;\n      clearInterval(timer);\n      await running;\n    },\n  };\n}\n"],
+  "mappings": "AAGA,SAAS,SAAS,eAAe;AAIjC,SAAS,SAAS,MAAc,QAA8B;AAC5D,QAAM,OAAO,OAAO;AACpB,MAAI,CAAC,KAAM,QAAO;AAClB,SAAQ,KAAK,WAAW,QAAQ,KAAK,WAAW,GAAG,MAAO,KAAK,OAAO,SAAS,IAAI,KAAK;AAC1F;AAEA,eAAe,OAAO,IAAc,MAAc,MAAkC;AAClF,QAAM,OAAO,MAAM,GAAG,KAAK,IAAI,EAAE,MAAM,MAAM,MAAS;AACtD,MAAI,CAAC,KAAM,QAAO;AAClB,OAAK;AAAA,IACH;AAAA,IACA,GAAG,KAAK,cAAc,MAAM,GAAG,IAAI,KAAK,GAAG,IAAI,KAAK,IAAI,IAAI,IAAI,KAAK,KAAK,KAAK,EAAE,QAAQ,CAAC;AAAA,EAC5F;AACA,SAAO,KAAK;AACd;AAEA,eAAe,KACb,IACA,MACA,QACA,MACA,MACA;AACA,QAAM,YAAY,MAAM,OAAO,IAAI,MAAM,IAAI;AAC7C,MAAI,CAAC,aAAa,CAAC,KAAM;AACzB,QAAM,QAAQ,MAAM,GAAG,QAAQ,IAAI,EAAE,MAAM,MAAM,CAAC,CAAa;AAC/D,aAAW,QAAQ,OAAO;AACxB,QAAI,SAAS,MAAM,MAAM,EAAG;AAC5B,UAAM,QAAQ,GAAG,SAAS,MAAM,KAAK,IAAI,IAAI,IAAI;AACjD,UAAM,KAAK,IAAI,OAAO,QAAQ,OAAO,cAAc,MAAM,IAAI;AAAA,EAC/D;AACF;AAEA,eAAsB,SACpB,IACA,KACA,SACmB;AACnB,QAAM,MAAgB,oBAAI,IAAI;AAC9B,aAAW,UAAU,QAAS,OAAM,KAAK,IAAI,QAAQ,KAAK,OAAO,IAAI,GAAG,QAAQ,MAAM,GAAG;AACzF,SAAO;AACT;AAEO,SAAS,YAAY,QAAkB,OAA2B;AACvE,QAAM,UAAU,oBAAI,IAAY;AAChC,QAAM,QAAQ,CAAC,SAAiB;AAC9B,YAAQ,IAAI,IAAI;AAChB,YAAQ,IAAI,QAAQ,IAAI,CAAC;AAAA,EAC3B;AACA,aAAW,CAAC,MAAM,KAAK,KAAK,OAAO;AACjC,QAAI,CAAC,OAAO,IAAI,IAAI,EAAG,OAAM,IAAI;AAAA,aACxB,OAAO,IAAI,IAAI,MAAM,MAAO,SAAQ,IAAI,IAAI;AAAA,EACvD;AACA,aAAW,QAAQ,OAAO,KAAK,EAAG,KAAI,CAAC,MAAM,IAAI,IAAI,EAAG,OAAM,IAAI;AAClE,SAAO,CAAC,GAAG,OAAO;AACpB;AAMA,eAAsB,UACpB,IACA,KACA,SACA,UACA,UAAuB,CAAC,GACF;AACtB,MAAI,UAAU,MAAM,SAAS,IAAI,KAAK,OAAO;AAC7C,MAAI,OAAO;AACX,MAAI,UAAU,QAAQ,QAAQ;AAC9B,QAAM,OAAO,YAAY;AACvB,UAAM,OAAO,MAAM,SAAS,IAAI,KAAK,OAAO;AAC5C,UAAM,QAAQ,YAAY,SAAS,IAAI;AACvC,cAAU;AACV,QAAI,QAAQ,MAAM,SAAS,EAAG,UAAS,EAAE,MAAM,CAAC;AAAA,EAClD;AACA,QAAM,QAAQ,YAAY,MAAM;AAC9B,cAAU,QAAQ,KAAK,IAAI;AAAA,EAC7B,GAAG,QAAQ,cAAc,GAAG;AAC5B,SAAO;AAAA,IACL,MAAM;AAAA,IACN,MAAM,MAAM,UAAmB;AAC7B,aAAO;AACP,oBAAc,KAAK;AACnB,YAAM;AAAA,IACR;AAAA,EACF;AACF;",
+  "names": []
+}

package/dist/owner.js

@@ -4,26 +4,49 @@ const AGENT_LOCK = "slicc-agent";
 async function startAgent(options) {
   const release = await holdLock(options.locks ?? navigator.locks, AGENT_LOCK);
   const channel = options.channel ?? (() => new MessageChannel());
-  let worker;
+  const spawn = async () => {
+    const created = options.worker();
+    try {
+      if (options.kernel) {
+        const port = await options.kernel.connect();
+        created.postMessage({ kernel: port }, [port]);
+      }
+    } catch (error) {
+      created.terminate();
+      throw error;
+    }
+    return created;
+  };
+  let worker = Promise.resolve().then(spawn);
   try {
-    worker = options.worker();
+    await worker;
   } catch (error) {
     release();
     throw error;
   }
   return {
-    connect() {
+    async connect() {
+      const ready = await worker;
+      if (!ready) throw new Error("the agent was released");
       const { port1, port2 } = channel();
-      worker.postMessage({ connect: port2 }, [port2]);
+      ready.postMessage({ connect: port2 }, [port2]);
       return connectAgent(port1);
     },
     restart() {
-      worker.terminate();
-      worker = options.worker();
+      worker = worker.catch(() => void 0).then((old) => {
+        old?.terminate();
+        return spawn();
+      });
+      return worker.then(() => void 0);
     },
-    release() {
-      worker.terminate();
-      release();
+    async release() {
+      const previous = worker;
+      worker = Promise.resolve(void 0);
+      try {
+        (await previous.catch(() => void 0))?.terminate();
+      } finally {
+        release();
+      }
     }
   };
 }

package/dist/owner.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../src/owner.ts"],
-  "sourcesContent": ["import { type AgentConnection, connectAgent } from './client.ts';\nimport { holdLock } from './opfs-pool.ts';\nimport type { PortEndpoint } from './wire.ts';\n\nexport const AGENT_LOCK = 'slicc-agent';\n\nexport interface AgentWorker {\n  postMessage(message: unknown, transfer: Transferable[]): void;\n  terminate(): void;\n}\n\nexport interface AgentOwner {\n  connect(): Promise<AgentConnection>;\n  restart(): void;\n  release(): void;\n}\n\nexport interface OwnerOptions {\n  worker: () => AgentWorker;\n  locks?: LockManager;\n  channel?: () => { port1: PortEndpoint; port2: Transferable };\n}\n\nexport async function startAgent(options: OwnerOptions): Promise<AgentOwner> {\n  const release = await holdLock(options.locks ?? navigator.locks, AGENT_LOCK);\n  const channel = options.channel ?? (() => new MessageChannel());\n  let worker: AgentWorker;\n  try {\n    worker = options.worker();\n  } catch (error) {\n    release();\n    throw error;\n  }\n  return {\n    connect() {\n      const { port1, port2 } = channel();\n      worker.postMessage({ connect: port2 }, [port2]);\n      return connectAgent(port1);\n    },\n    restart() {\n      worker.terminate();\n      worker = options.worker();\n    },\n    release() {\n      worker.terminate();\n      release();\n    },\n  };\n}\n"],
-  "mappings": "AAAA,SAA+B,oBAAoB;AACnD,SAAS,gBAAgB;AAGlB,MAAM,aAAa;AAmB1B,eAAsB,WAAW,SAA4C;AAC3E,QAAM,UAAU,MAAM,SAAS,QAAQ,SAAS,UAAU,OAAO,UAAU;AAC3E,QAAM,UAAU,QAAQ,YAAY,MAAM,IAAI,eAAe;AAC7D,MAAI;AACJ,MAAI;AACF,aAAS,QAAQ,OAAO;AAAA,EAC1B,SAAS,OAAO;AACd,YAAQ;AACR,UAAM;AAAA,EACR;AACA,SAAO;AAAA,IACL,UAAU;AACR,YAAM,EAAE,OAAO,MAAM,IAAI,QAAQ;AACjC,aAAO,YAAY,EAAE,SAAS,MAAM,GAAG,CAAC,KAAK,CAAC;AAC9C,aAAO,aAAa,KAAK;AAAA,IAC3B;AAAA,IACA,UAAU;AACR,aAAO,UAAU;AACjB,eAAS,QAAQ,OAAO;AAAA,IAC1B;AAAA,IACA,UAAU;AACR,aAAO,UAAU;AACjB,cAAQ;AAAA,IACV;AAAA,EACF;AACF;",
+  "sourcesContent": ["import { type AgentConnection, connectAgent } from './client.ts';\nimport { holdLock } from './opfs-pool.ts';\nimport type { PortEndpoint } from './wire.ts';\n\nexport const AGENT_LOCK = 'slicc-agent';\n\nexport interface AgentWorker {\n  postMessage(message: unknown, transfer: Transferable[]): void;\n  terminate(): void;\n}\n\nexport interface AgentOwner {\n  connect(): Promise<AgentConnection>;\n  restart(): Promise<void>;\n  release(): Promise<void>;\n}\n\nexport interface KernelSource {\n  connect(): Promise<Transferable>;\n}\n\nexport interface OwnerOptions {\n  worker: () => AgentWorker;\n  kernel?: KernelSource;\n  locks?: LockManager;\n  channel?: () => { port1: PortEndpoint; port2: Transferable };\n}\n\nexport async function startAgent(options: OwnerOptions): Promise<AgentOwner> {\n  const release = await holdLock(options.locks ?? navigator.locks, AGENT_LOCK);\n  const channel = options.channel ?? (() => new MessageChannel());\n  const spawn = async (): Promise<AgentWorker> => {\n    const created = options.worker();\n    try {\n      if (options.kernel) {\n        const port = await options.kernel.connect();\n        created.postMessage({ kernel: port }, [port]);\n      }\n    } catch (error) {\n      created.terminate();\n      throw error;\n    }\n    return created;\n  };\n  let worker: Promise<AgentWorker | undefined> = Promise.resolve().then(spawn);\n  try {\n    await worker;\n  } catch (error) {\n    release();\n    throw error;\n  }\n  return {\n    async connect() {\n      const ready = await worker;\n      if (!ready) throw new Error('the agent was released');\n      const { port1, port2 } = channel();\n      ready.postMessage({ connect: port2 }, [port2]);\n      return connectAgent(port1);\n    },\n    restart() {\n      worker = worker\n        .catch(() => undefined)\n        .then((old) => {\n          old?.terminate();\n          return spawn();\n        });\n      return worker.then(() => undefined);\n    },\n    async release() {\n      const previous = worker;\n      worker = Promise.resolve(undefined);\n      try {\n        (await previous.catch(() => undefined))?.terminate();\n      } finally {\n        release();\n      }\n    },\n  };\n}\n"],
+  "mappings": "AAAA,SAA+B,oBAAoB;AACnD,SAAS,gBAAgB;AAGlB,MAAM,aAAa;AAwB1B,eAAsB,WAAW,SAA4C;AAC3E,QAAM,UAAU,MAAM,SAAS,QAAQ,SAAS,UAAU,OAAO,UAAU;AAC3E,QAAM,UAAU,QAAQ,YAAY,MAAM,IAAI,eAAe;AAC7D,QAAM,QAAQ,YAAkC;AAC9C,UAAM,UAAU,QAAQ,OAAO;AAC/B,QAAI;AACF,UAAI,QAAQ,QAAQ;AAClB,cAAM,OAAO,MAAM,QAAQ,OAAO,QAAQ;AAC1C,gBAAQ,YAAY,EAAE,QAAQ,KAAK,GAAG,CAAC,IAAI,CAAC;AAAA,MAC9C;AAAA,IACF,SAAS,OAAO;AACd,cAAQ,UAAU;AAClB,YAAM;AAAA,IACR;AACA,WAAO;AAAA,EACT;AACA,MAAI,SAA2C,QAAQ,QAAQ,EAAE,KAAK,KAAK;AAC3E,MAAI;AACF,UAAM;AAAA,EACR,SAAS,OAAO;AACd,YAAQ;AACR,UAAM;AAAA,EACR;AACA,SAAO;AAAA,IACL,MAAM,UAAU;AACd,YAAM,QAAQ,MAAM;AACpB,UAAI,CAAC,MAAO,OAAM,IAAI,MAAM,wBAAwB;AACpD,YAAM,EAAE,OAAO,MAAM,IAAI,QAAQ;AACjC,YAAM,YAAY,EAAE,SAAS,MAAM,GAAG,CAAC,KAAK,CAAC;AAC7C,aAAO,aAAa,KAAK;AAAA,IAC3B;AAAA,IACA,UAAU;AACR,eAAS,OACN,MAAM,MAAM,MAAS,EACrB,KAAK,CAAC,QAAQ;AACb,aAAK,UAAU;AACf,eAAO,MAAM;AAAA,MACf,CAAC;AACH,aAAO,OAAO,KAAK,MAAM,MAAS;AAAA,IACpC;AAAA,IACA,MAAM,UAAU;AACd,YAAM,WAAW;AACjB,eAAS,QAAQ,QAAQ,MAAS;AAClC,UAAI;AACF,SAAC,MAAM,SAAS,MAAM,MAAM,MAAS,IAAI,UAAU;AAAA,MACrD,UAAE;AACA,gBAAQ;AAAA,MACV;AAAA,IACF;AAAA,EACF;AACF;",
   "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"]
+}