@ai-ecoverse/slicc-agent 3.40.1 → 3.42.0

package/dist/spectrum/index.js

@@ -2,6 +2,7 @@ import { AgentAdapter } from "./agent-port.js";
 import { ChangesAdapter } from "./changes-port.js";
 import { MemoryAdapter } from "./memory-port.js";
 import { MonitorAdapter } from "./monitor-port.js";
+import { PageAdapter } from "./page-port.js";
 import { SettingsAdapter } from "./settings-port.js";
 import { SprinkleAdapter } from "./sprinkle-port.js";
 import { TrayAdapter } from "./tray-port.js";
@@ -21,13 +22,18 @@ import {
   MonitorAdapter as MonitorAdapter2,
   monitorSnapshot
 } from "./monitor-port.js";
+import {
+  PageAdapter as PageAdapter2
+} from "./page-port.js";
 import { SETTINGS_KEY, SettingsAdapter as SettingsAdapter2 } from "./settings-port.js";
 import { SprinkleAdapter as SprinkleAdapter2 } from "./sprinkle-port.js";
 import { TrayAdapter as TrayAdapter2 } from "./tray-port.js";
 function createAgentModel(connection, options = {}) {
   const agent = new AgentAdapter(connection);
+  const run = options.page?.run;
   return {
     agent,
+    page: options.page && run ? new PageAdapter(connection, agent, { ...options.page, run }) : null,
     settings: new SettingsAdapter(
       connection.settings,
       agent,
@@ -50,6 +56,7 @@ export {
   ChangesAdapter2 as ChangesAdapter,
   MemoryAdapter2 as MemoryAdapter,
   MonitorAdapter2 as MonitorAdapter,
+  PageAdapter2 as PageAdapter,
   SETTINGS_KEY,
   SettingsAdapter2 as SettingsAdapter,
   SprinkleAdapter2 as SprinkleAdapter,

package/dist/spectrum/index.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/spectrum/index.ts"],
-  "sourcesContent": ["import type { MonitorSection } from '@ai-ecoverse/slicc-spectrum/ui';\nimport type { AgentConnection } from '../client.ts';\nimport { AgentAdapter } from './agent-port.ts';\nimport { ChangesAdapter } from './changes-port.ts';\nimport { MemoryAdapter } from './memory-port.ts';\nimport { MonitorAdapter } from './monitor-port.ts';\nimport { type Login, SettingsAdapter } from './settings-port.ts';\nimport { SprinkleAdapter } from './sprinkle-port.ts';\nimport { TrayAdapter } from './tray-port.ts';\n\nexport { AgentAdapter, CONE } from './agent-port.ts';\nexport { ChangesAdapter, type ChangesEvents } from './changes-port.ts';\nexport { MemoryAdapter } from './memory-port.ts';\nexport {\n  assistant,\n  errorAction,\n  errorPart,\n  isBusy,\n  queued,\n  textOf,\n  toMessages,\n} from './messages.ts';\nexport {\n  MonitorAdapter,\n  type MonitorAdapterOptions,\n  type MonitorInput,\n  monitorSnapshot,\n} from './monitor-port.ts';\nexport { type Login, SETTINGS_KEY, SettingsAdapter } from './settings-port.ts';\nexport { SprinkleAdapter } from './sprinkle-port.ts';\nexport { TrayAdapter } from './tray-port.ts';\n\nexport function createAgentModel(\n  connection: AgentConnection,\n  options: {\n    storage?: Pick<Storage, 'getItem' | 'setItem'> | null;\n    login?: Login;\n    monitor?: { extra?: () => readonly MonitorSection[] };\n  } = {}\n): {\n  agent: AgentAdapter;\n  settings: SettingsAdapter;\n  tray: TrayAdapter;\n  sprinkles: SprinkleAdapter;\n  memory: MemoryAdapter;\n  changes: ChangesAdapter;\n  monitor: MonitorAdapter;\n} {\n  const agent = new AgentAdapter(connection);\n  return {\n    agent,\n    settings: new SettingsAdapter(\n      connection.settings,\n      agent,\n      options.storage ?? null,\n      options.login ?? null\n    ),\n    tray: new TrayAdapter(connection.settings),\n    sprinkles: new SprinkleAdapter(connection),\n    memory: new MemoryAdapter(connection),\n    changes: new ChangesAdapter(connection),\n    monitor: new MonitorAdapter(\n      connection,\n      options.monitor?.extra ? { extra: options.monitor.extra } : {}\n    ),\n  };\n}\n"],
-  "mappings": "AAEA,SAAS,oBAAoB;AAC7B,SAAS,sBAAsB;AAC/B,SAAS,qBAAqB;AAC9B,SAAS,sBAAsB;AAC/B,SAAqB,uBAAuB;AAC5C,SAAS,uBAAuB;AAChC,SAAS,mBAAmB;AAE5B,SAAS,gBAAAA,eAAc,YAAY;AACnC,SAAS,kBAAAC,uBAA0C;AACnD,SAAS,iBAAAC,sBAAqB;AAC9B;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AACP;AAAA,EACE,kBAAAC;AAAA,EAGA;AAAA,OACK;AACP,SAAqB,cAAc,mBAAAC,wBAAuB;AAC1D,SAAS,mBAAAC,wBAAuB;AAChC,SAAS,eAAAC,oBAAmB;AAErB,SAAS,iBACd,YACA,UAII,CAAC,GASL;AACA,QAAM,QAAQ,IAAI,aAAa,UAAU;AACzC,SAAO;AAAA,IACL;AAAA,IACA,UAAU,IAAI;AAAA,MACZ,WAAW;AAAA,MACX;AAAA,MACA,QAAQ,WAAW;AAAA,MACnB,QAAQ,SAAS;AAAA,IACnB;AAAA,IACA,MAAM,IAAI,YAAY,WAAW,QAAQ;AAAA,IACzC,WAAW,IAAI,gBAAgB,UAAU;AAAA,IACzC,QAAQ,IAAI,cAAc,UAAU;AAAA,IACpC,SAAS,IAAI,eAAe,UAAU;AAAA,IACtC,SAAS,IAAI;AAAA,MACX;AAAA,MACA,QAAQ,SAAS,QAAQ,EAAE,OAAO,QAAQ,QAAQ,MAAM,IAAI,CAAC;AAAA,IAC/D;AAAA,EACF;AACF;",
-  "names": ["AgentAdapter", "ChangesAdapter", "MemoryAdapter", "MonitorAdapter", "SettingsAdapter", "SprinkleAdapter", "TrayAdapter"]
+  "sourcesContent": ["import type { MonitorSection } from '@ai-ecoverse/slicc-spectrum/ui';\nimport type { AgentConnection } from '../client.ts';\nimport { AgentAdapter } from './agent-port.ts';\nimport { ChangesAdapter } from './changes-port.ts';\nimport { MemoryAdapter } from './memory-port.ts';\nimport { MonitorAdapter } from './monitor-port.ts';\nimport { PageAdapter, type PageOptions } from './page-port.ts';\nimport { type Login, SettingsAdapter } from './settings-port.ts';\nimport { SprinkleAdapter } from './sprinkle-port.ts';\nimport { TrayAdapter } from './tray-port.ts';\n\nexport { AgentAdapter, CONE } from './agent-port.ts';\nexport { ChangesAdapter, type ChangesEvents } from './changes-port.ts';\nexport { MemoryAdapter } from './memory-port.ts';\nexport {\n  assistant,\n  errorAction,\n  errorPart,\n  isBusy,\n  queued,\n  textOf,\n  toMessages,\n} from './messages.ts';\nexport {\n  MonitorAdapter,\n  type MonitorAdapterOptions,\n  type MonitorInput,\n  monitorSnapshot,\n} from './monitor-port.ts';\nexport {\n  PageAdapter,\n  type PageDocument,\n  type PageOptions,\n  type PageRun,\n  type PageTarget,\n} from './page-port.ts';\nexport { type Login, SETTINGS_KEY, SettingsAdapter } from './settings-port.ts';\nexport { SprinkleAdapter } from './sprinkle-port.ts';\nexport { TrayAdapter } from './tray-port.ts';\n\nexport function createAgentModel(\n  connection: AgentConnection,\n  options: {\n    storage?: Pick<Storage, 'getItem' | 'setItem'> | null;\n    login?: Login;\n    monitor?: { extra?: () => readonly MonitorSection[] };\n    page?: PageOptions;\n  } = {}\n): {\n  agent: AgentAdapter;\n  settings: SettingsAdapter;\n  tray: TrayAdapter;\n  sprinkles: SprinkleAdapter;\n  memory: MemoryAdapter;\n  changes: ChangesAdapter;\n  monitor: MonitorAdapter;\n  page: PageAdapter | null;\n} {\n  const agent = new AgentAdapter(connection);\n  const run = options.page?.run;\n  return {\n    agent,\n    page: options.page && run ? new PageAdapter(connection, agent, { ...options.page, run }) : null,\n    settings: new SettingsAdapter(\n      connection.settings,\n      agent,\n      options.storage ?? null,\n      options.login ?? null\n    ),\n    tray: new TrayAdapter(connection.settings),\n    sprinkles: new SprinkleAdapter(connection),\n    memory: new MemoryAdapter(connection),\n    changes: new ChangesAdapter(connection),\n    monitor: new MonitorAdapter(\n      connection,\n      options.monitor?.extra ? { extra: options.monitor.extra } : {}\n    ),\n  };\n}\n"],
+  "mappings": "AAEA,SAAS,oBAAoB;AAC7B,SAAS,sBAAsB;AAC/B,SAAS,qBAAqB;AAC9B,SAAS,sBAAsB;AAC/B,SAAS,mBAAqC;AAC9C,SAAqB,uBAAuB;AAC5C,SAAS,uBAAuB;AAChC,SAAS,mBAAmB;AAE5B,SAAS,gBAAAA,eAAc,YAAY;AACnC,SAAS,kBAAAC,uBAA0C;AACnD,SAAS,iBAAAC,sBAAqB;AAC9B;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AACP;AAAA,EACE,kBAAAC;AAAA,EAGA;AAAA,OACK;AACP;AAAA,EACE,eAAAC;AAAA,OAKK;AACP,SAAqB,cAAc,mBAAAC,wBAAuB;AAC1D,SAAS,mBAAAC,wBAAuB;AAChC,SAAS,eAAAC,oBAAmB;AAErB,SAAS,iBACd,YACA,UAKI,CAAC,GAUL;AACA,QAAM,QAAQ,IAAI,aAAa,UAAU;AACzC,QAAM,MAAM,QAAQ,MAAM;AAC1B,SAAO;AAAA,IACL;AAAA,IACA,MAAM,QAAQ,QAAQ,MAAM,IAAI,YAAY,YAAY,OAAO,EAAE,GAAG,QAAQ,MAAM,IAAI,CAAC,IAAI;AAAA,IAC3F,UAAU,IAAI;AAAA,MACZ,WAAW;AAAA,MACX;AAAA,MACA,QAAQ,WAAW;AAAA,MACnB,QAAQ,SAAS;AAAA,IACnB;AAAA,IACA,MAAM,IAAI,YAAY,WAAW,QAAQ;AAAA,IACzC,WAAW,IAAI,gBAAgB,UAAU;AAAA,IACzC,QAAQ,IAAI,cAAc,UAAU;AAAA,IACpC,SAAS,IAAI,eAAe,UAAU;AAAA,IACtC,SAAS,IAAI;AAAA,MACX;AAAA,MACA,QAAQ,SAAS,QAAQ,EAAE,OAAO,QAAQ,QAAQ,MAAM,IAAI,CAAC;AAAA,IAC/D;AAAA,EACF;AACF;",
+  "names": ["AgentAdapter", "ChangesAdapter", "MemoryAdapter", "MonitorAdapter", "PageAdapter", "SettingsAdapter", "SprinkleAdapter", "TrayAdapter"]
 }

package/dist/spectrum/page-port.js

@@ -0,0 +1,132 @@
+import { BACKGROUND_CONTEXT } from "@earendil-works/chord/context";
+const REPORT_MS = 250;
+const POLL_MS = 1e4;
+async function quietly(call) {
+  try {
+    await call();
+  } catch {
+  }
+}
+const ACTIVITY = ["pointerdown", "keydown"];
+const FOCUS = ["focus", "blur"];
+class PageAdapter {
+  #connection;
+  #agent;
+  #options;
+  #run;
+  #now;
+  #off = [];
+  #stream = null;
+  #lastActive;
+  #timer;
+  #disposed = false;
+  done;
+  constructor(connection, agent, options) {
+    this.#connection = connection;
+    this.#agent = agent;
+    this.#options = options;
+    this.#run = options.run;
+    this.#now = options.now ?? Date.now;
+    this.#lastActive = this.#now();
+    const doc = options.document ?? globalThis.document;
+    const win = options.window ?? globalThis.window;
+    const schedule = () => this.#schedule();
+    const active = () => {
+      this.#lastActive = this.#now();
+      this.#schedule();
+    };
+    if (doc) this.#listen(doc, "visibilitychange", schedule);
+    if (win) {
+      for (const type of FOCUS) this.#listen(win, type, schedule);
+      for (const type of ACTIVITY) this.#listen(win, type, active);
+    }
+    this.#off.push(agent.on("active", schedule));
+    const agents = connection.agents?.subscribe(schedule);
+    if (agents) this.#off.push(agents);
+    this.done = this.#loop().catch(() => void 0);
+  }
+  #listen(target, type, listener) {
+    target.addEventListener(type, listener, true);
+    this.#off.push(() => target.removeEventListener(type, listener, true));
+  }
+  #cone() {
+    const summary = this.#connection.agents?.value;
+    const agents = summary?.agents ?? [];
+    let id = this.#agent.active();
+    for (let hops = 0; id && hops <= agents.length; hops++) {
+      const found = agents.find((agent) => agent.id === id);
+      if (!found || found.kind === "cone") return id;
+      id = found.parentId;
+    }
+    return summary?.active ?? id;
+  }
+  state() {
+    const doc = this.#options.document ?? globalThis.document;
+    return {
+      tab: this.#options.tab,
+      kinds: ["panel"],
+      cone: this.#cone(),
+      visible: doc ? doc.visibilityState === "visible" : false,
+      focused: doc ? doc.hasFocus() : false,
+      lastActive: this.#lastActive
+    };
+  }
+  #schedule() {
+    if (this.#disposed || this.#timer !== void 0) return;
+    this.#timer = setTimeout(() => {
+      this.#timer = void 0;
+      const stream = this.#stream;
+      if (!stream || this.#disposed) return;
+      void quietly(() => this.#connection.pages?.report(stream, this.state(), BACKGROUND_CONTEXT));
+    }, this.#options.reportMs ?? REPORT_MS);
+  }
+  async #loop() {
+    const pages = this.#connection.pages;
+    if (!pages) return;
+    while (!this.#disposed) {
+      const opened = await pages.open(this.state(), BACKGROUND_CONTEXT);
+      if ("error" in opened) return;
+      this.#stream = opened.stream;
+      if (this.#disposed) break;
+      let done = false;
+      while (!done && !this.#disposed) {
+        const batch = await pages.next(
+          opened.stream,
+          this.#options.pollMs ?? POLL_MS,
+          BACKGROUND_CONTEXT
+        );
+        for (const request of batch.requests) void this.#handle(opened.stream, request);
+        done = batch.done;
+      }
+    }
+    const stream = this.#stream;
+    if (stream) await pages.close(stream, BACKGROUND_CONTEXT);
+  }
+  async #handle(stream, request) {
+    let result;
+    try {
+      result = await this.#run(request.argv, request.caller);
+    } catch (error) {
+      result = { stdout: "", stderr: `panel: ${error.message}
+`, code: 1 };
+    }
+    await quietly(
+      () => this.#connection.pages?.answer(stream, request.id, result, BACKGROUND_CONTEXT)
+    );
+  }
+  dispose() {
+    this.#disposed = true;
+    clearTimeout(this.#timer);
+    this.#timer = void 0;
+    for (const off of this.#off.splice(0)) off();
+    const stream = this.#stream;
+    if (stream) void quietly(() => this.#connection.pages?.close(stream, BACKGROUND_CONTEXT));
+    return this.done;
+  }
+}
+export {
+  POLL_MS,
+  PageAdapter,
+  REPORT_MS
+};
+//# sourceMappingURL=page-port.js.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/spectrum/page-port.ts"],
+  "sourcesContent": ["import { BACKGROUND_CONTEXT } from '@earendil-works/chord/context';\nimport type { AgentConnection } from '../client.ts';\nimport type { PageCaller, PageRequest, PageResult, PageTab } from '../remote/pages.ts';\nimport type { AgentAdapter } from './agent-port.ts';\n\nexport const REPORT_MS = 250;\nexport const POLL_MS = 10000;\n\nexport type PageRun = (\n  argv: readonly string[],\n  caller: PageCaller\n) => PageResult | Promise<PageResult>;\n\nexport interface PageTarget {\n  addEventListener(type: string, listener: () => void, options?: boolean): void;\n  removeEventListener(type: string, listener: () => void, options?: boolean): void;\n}\n\nexport interface PageDocument extends PageTarget {\n  readonly visibilityState: string;\n  hasFocus(): boolean;\n}\n\nexport interface PageOptions {\n  tab: string;\n  run?: PageRun;\n  document?: PageDocument;\n  window?: PageTarget;\n  now?: () => number;\n  reportMs?: number;\n  pollMs?: number;\n}\n\nasync function quietly(call: () => Promise<void> | undefined): Promise<void> {\n  try {\n    await call();\n  } catch {}\n}\n\nconst ACTIVITY = ['pointerdown', 'keydown'];\nconst FOCUS = ['focus', 'blur'];\n\nexport class PageAdapter {\n  readonly #connection: AgentConnection;\n  readonly #agent: AgentAdapter;\n  readonly #options: PageOptions;\n  readonly #run: PageRun;\n  readonly #now: () => number;\n  readonly #off: (() => void)[] = [];\n  #stream: string | null = null;\n  #lastActive: number;\n  #timer: ReturnType<typeof setTimeout> | undefined;\n  #disposed = false;\n  readonly done: Promise<void>;\n\n  constructor(\n    connection: AgentConnection,\n    agent: AgentAdapter,\n    options: PageOptions & { run: PageRun }\n  ) {\n    this.#connection = connection;\n    this.#agent = agent;\n    this.#options = options;\n    this.#run = options.run;\n    this.#now = options.now ?? Date.now;\n    this.#lastActive = this.#now();\n    const doc = options.document ?? (globalThis as { document?: PageDocument }).document;\n    const win = options.window ?? (globalThis as { window?: PageTarget }).window;\n    const schedule = () => this.#schedule();\n    const active = () => {\n      this.#lastActive = this.#now();\n      this.#schedule();\n    };\n    if (doc) this.#listen(doc, 'visibilitychange', schedule);\n    if (win) {\n      for (const type of FOCUS) this.#listen(win, type, schedule);\n      for (const type of ACTIVITY) this.#listen(win, type, active);\n    }\n    this.#off.push(agent.on('active', schedule));\n    const agents = connection.agents?.subscribe(schedule);\n    if (agents) this.#off.push(agents);\n    this.done = this.#loop().catch(() => undefined);\n  }\n\n  #listen(target: PageTarget, type: string, listener: () => void): void {\n    target.addEventListener(type, listener, true);\n    this.#off.push(() => target.removeEventListener(type, listener, true));\n  }\n\n  #cone(): string | null {\n    const summary = this.#connection.agents?.value;\n    const agents = summary?.agents ?? [];\n    let id: string | null = this.#agent.active();\n    for (let hops = 0; id && hops <= agents.length; hops++) {\n      const found = agents.find((agent) => agent.id === id);\n      if (!found || found.kind === 'cone') return id;\n      id = found.parentId;\n    }\n    return summary?.active ?? id;\n  }\n\n  state(): PageTab {\n    const doc = this.#options.document ?? (globalThis as { document?: PageDocument }).document;\n    return {\n      tab: this.#options.tab,\n      kinds: ['panel'],\n      cone: this.#cone(),\n      visible: doc ? doc.visibilityState === 'visible' : false,\n      focused: doc ? doc.hasFocus() : false,\n      lastActive: this.#lastActive,\n    };\n  }\n\n  #schedule(): void {\n    if (this.#disposed || this.#timer !== undefined) return;\n    this.#timer = setTimeout(() => {\n      this.#timer = undefined;\n      const stream = this.#stream;\n      if (!stream || this.#disposed) return;\n      void quietly(() => this.#connection.pages?.report(stream, this.state(), BACKGROUND_CONTEXT));\n    }, this.#options.reportMs ?? REPORT_MS);\n  }\n\n  async #loop(): Promise<void> {\n    const pages = this.#connection.pages;\n    if (!pages) return;\n    while (!this.#disposed) {\n      const opened = await pages.open(this.state(), BACKGROUND_CONTEXT);\n      if ('error' in opened) return;\n      this.#stream = opened.stream;\n      if (this.#disposed) break;\n      let done = false;\n      while (!done && !this.#disposed) {\n        const batch = await pages.next(\n          opened.stream,\n          this.#options.pollMs ?? POLL_MS,\n          BACKGROUND_CONTEXT\n        );\n        for (const request of batch.requests) void this.#handle(opened.stream, request);\n        done = batch.done;\n      }\n    }\n    const stream = this.#stream;\n    if (stream) await pages.close(stream, BACKGROUND_CONTEXT);\n  }\n\n  async #handle(stream: string, request: PageRequest): Promise<void> {\n    let result: PageResult;\n    try {\n      result = await this.#run(request.argv, request.caller);\n    } catch (error) {\n      result = { stdout: '', stderr: `panel: ${(error as Error).message}\\n`, code: 1 };\n    }\n    await quietly(() =>\n      this.#connection.pages?.answer(stream, request.id, result, BACKGROUND_CONTEXT)\n    );\n  }\n\n  dispose(): Promise<void> {\n    this.#disposed = true;\n    clearTimeout(this.#timer);\n    this.#timer = undefined;\n    for (const off of this.#off.splice(0)) off();\n    const stream = this.#stream;\n    if (stream) void quietly(() => this.#connection.pages?.close(stream, BACKGROUND_CONTEXT));\n    return this.done;\n  }\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/sprinkles/index.js

@@ -21,14 +21,13 @@ const USAGE = `usage:
   sprinkle list                 every sprinkle in /home/sprinkles, with its owner
   sprinkle show <name>          show a sprinkle in your chat
   sprinkle own <name> [<agent>] send its messages to <agent> (cone, cone-<n> or a scoop's handle)
+  sprinkle open|close <name>    the same as panel open|close sprinkle:<name>
 
 A sprinkle is an .shtml file in /home/sprinkles, as <name>.shtml or <name>/<name>.shtml.
 Every one of them has a button in the rail; edit the file and the open panel reloads.
 `;
 const RETIRED = {
-  open: "every sprinkle in /home/sprinkles already has a button in the rail; sprinkle show <name> shows one in the chat",
   reload: "editing the .shtml file reloads the sprinkle",
-  close: "delete the .shtml file to retire a sprinkle; the user closes panels",
   send: "a sprinkle reads data with slicc.readFile() or keeps it with slicc.setState(); write the file it reads",
   chat: "show the sprinkle with sprinkle show <name> and wait for its lick"
 };

package/dist/sprinkles/index.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/sprinkles/index.ts"],
-  "sourcesContent": ["import {\n  type Context,\n  type JsonValue,\n  type ReplicatedState,\n  replicatedState,\n} from '@earendil-works/chord';\nimport type { Harness } from '@earendil-works/pi-durable';\nimport type { ExecutionEnv, FileWatcher } from '@earendil-works/pi-durable/env';\nimport { type Agents, live } from '../agents.ts';\nimport type { LickTarget } from '../licks/lick.ts';\nimport type { Licks } from '../licks/licks.ts';\nimport {\n  describe,\n  homePath,\n  NO_EXEC,\n  SPRINKLE_KIND,\n  SPRINKLES_DIR,\n  type Sprinkle,\n  type SprinkleMethod,\n  SprinklesDoc,\n  SUGGESTIONS,\n  SUGGESTIONS_DIR,\n  SUGGESTIONS_STORE,\n  sprinkleFiles,\n  WELCOME,\n  WELCOME_PROFILE,\n  WELCOMED,\n} from './sprinkles.ts';\n\nexport type Answer = { code: number; out: string };\n\nexport interface SprinklePayload {\n  action: string;\n  data: JsonValue | null;\n  target: string | null;\n}\n\nexport interface SprinklesRuntime {\n  readonly sprinkles: ReplicatedState<Sprinkle[]>;\n  send(id: string, payload: SprinklePayload, context: Context): Promise<{ delivered: boolean }>;\n  call(id: string, method: string, args: readonly unknown[], context: Context): Promise<JsonValue>;\n  command(argv: readonly string[], caller: string | null, context: Context): Promise<Answer>;\n  reload(context: Context): Promise<void>;\n  close(context: Context): Promise<void>;\n}\n\nexport interface SprinklesAttach {\n  harness: Harness;\n  agents: Agents;\n  licks: Licks;\n  env: ExecutionEnv;\n  assets?: (path: string) => Promise<string>;\n  reloadMs: number;\n  dir?: string;\n  intercept?: (id: string, payload: SprinklePayload, context: Context) => Promise<boolean>;\n}\n\nexport const USAGE = `usage:\n  sprinkle list                 every sprinkle in /home/sprinkles, with its owner\n  sprinkle show <name>          show a sprinkle in your chat\n  sprinkle own <name> [<agent>] send its messages to <agent> (cone, cone-<n> or a scoop's handle)\n\nA sprinkle is an .shtml file in /home/sprinkles, as <name>.shtml or <name>/<name>.shtml.\nEvery one of them has a button in the rail; edit the file and the open panel reloads.\n`;\n\nconst RETIRED: Record<string, string> = {\n  open: 'every sprinkle in /home/sprinkles already has a button in the rail; sprinkle show <name> shows one in the chat',\n  reload: 'editing the .shtml file reloads the sprinkle',\n  close: 'delete the .shtml file to retire a sprinkle; the user closes panels',\n  send: 'a sprinkle reads data with slicc.readFile() or keeps it with slicc.setState(); write the file it reads',\n  chat: 'show the sprinkle with sprinkle show <name> and wait for its lick',\n};\n\nfunction targetOf(agentId: string): LickTarget {\n  return agentId.startsWith('scoop:') ? (agentId as LickTarget) : `cone:${agentId}`;\n}\n\nfunction agentOf(caller: string | null, agents: Agents): string {\n  if (caller?.startsWith('cone:')) return caller.slice('cone:'.length);\n  return caller ?? agents.activeCone();\n}\n\nfunction named(agents: Agents, value: string): string | undefined {\n  const state = agents.state();\n  if (value in state.cones) return value;\n  const id = value.startsWith('scoop:') ? value : `scoop:${value}`;\n  return id in state.scoops ? id : undefined;\n}\n\nexport function ownerOf(agents: Agents, owner: string | undefined): string {\n  const state = agents.state();\n  if (owner && state.cones[owner]) return owner;\n  const scoop = owner ? state.scoops[owner] : undefined;\n  return scoop && live(scoop) ? (owner as string) : agents.activeCone();\n}\n\nfunction entry(name: string, html: string, agentId: string): Sprinkle {\n  return { id: name, name, ...describe(name, html), agentId, html };\n}\n\nfunction reloader(\n  options: SprinklesAttach,\n  dir: string,\n  builtins: { welcome: string | undefined; suggestions: string | undefined },\n  sprinkles: ReplicatedState<Sprinkle[]> & { replace(context: Context, value: Sprinkle[]): void },\n  owners: (context: Context) => Promise<Record<string, string>>\n) {\n  const { env, agents } = options;\n  const { welcome, suggestions } = builtins;\n  return async (using: Context) => {\n    const owned = await owners(using);\n    const stored =\n      suggestions === undefined ? undefined : await env.exists(SUGGESTIONS_STORE, using);\n    const offered = stored?.ok === true && stored.value;\n    const reserved = new Set([WELCOME, ...(offered ? [SUGGESTIONS] : [])]);\n    const out: Sprinkle[] = [];\n    for (const { name, path } of await sprinkleFiles(env, dir, using)) {\n      if (reserved.has(name)) continue;\n      const read = await env.readTextFile(path, using);\n      if (read.ok) out.push(entry(name, read.value, ownerOf(agents, owned[name])));\n    }\n    if (offered)\n      out.push(entry(SUGGESTIONS, suggestions as string, ownerOf(agents, owned[SUGGESTIONS])));\n    if (welcome !== undefined)\n      out.push({\n        ...entry(WELCOME, welcome, ownerOf(agents, owned[WELCOME] ?? 'cone')),\n        inline: true,\n      });\n    sprinkles.replace(using, out);\n  };\n}\n\nexport function setupSprinkles() {\n  return {\n    async attach(options: SprinklesAttach, context: Context): Promise<SprinklesRuntime> {\n      const { harness, agents, licks, env } = options;\n      const dir = options.dir ?? SPRINKLES_DIR;\n      const sprinkles = replicatedState<Sprinkle[]>([]);\n      const builtin = (name: string) =>\n        options.assets\n          ? options.assets(`packages/vfs-root/sprinkles/${name}.shtml`).catch(() => undefined)\n          : Promise.resolve(undefined);\n      const welcome = await builtin(WELCOME);\n      const suggestions = await builtin(SUGGESTIONS);\n      const owners = async (using: Context) =>\n        (await harness.snapshot(SprinklesDoc, using))?.owners ?? {};\n      const reload = reloader(options, dir, { welcome, suggestions }, sprinkles, owners);\n      const inside = async (path: unknown, using: Context) => {\n        const asked = homePath(path);\n        const real = await env.canonicalPath(asked, using);\n        return real.ok ? homePath(real.value) : asked;\n      };\n      const offCone = agents.onCone(() => reload(context).catch(() => undefined));\n      const find = (id: string) => sprinkles.value.find((item) => item.id === id);\n      const post = async (id: string, agentId: string, using: Context) => {\n        const conversation = await agents.conversation(agentId, using);\n        if (!conversation) throw new Error(`there is no agent ${agentId}`);\n        await conversation.submit(\n          { type: 'write', entry: { kind: SPRINKLE_KIND, data: { sprinkle: id, at: Date.now() } } },\n          using\n        );\n      };\n      const setOwner = async (name: string, agentId: string, using: Context) => {\n        await harness.commit(async (tx) => {\n          (await tx.doc(SprinklesDoc)).owners[name] = agentId;\n        }, using);\n        await reload(using);\n      };\n      await reload(context);\n      const state = await harness.snapshot(SprinklesDoc, context);\n      if (welcome !== undefined && !state?.welcomed) {\n        await post(WELCOME, 'cone', context);\n        await harness.commit(async (tx) => {\n          (await tx.doc(SprinklesDoc)).welcomed = true;\n        }, context);\n      }\n      let timer: ReturnType<typeof setTimeout> | undefined;\n      const watched = await env.watch(\n        [{ path: dir, recursive: true }, { path: SUGGESTIONS_DIR }],\n        () => {\n          clearTimeout(timer);\n          timer = setTimeout(() => void reload(context).catch(() => undefined), options.reloadMs);\n        },\n        context\n      );\n      const watcher: FileWatcher | undefined = watched.ok ? watched.value : undefined;\n      const commands: Record<\n        string,\n        (argv: readonly string[], caller: string | null, using: Context) => Promise<Answer>\n      > = {\n        async list(_argv, _caller, using) {\n          await reload(using);\n          const rows = sprinkles.value\n            .filter((item) => !item.inline)\n            .map((item) => `${item.name}\\t${item.title}\\t${item.agentId}`);\n          return { code: 0, out: rows.length ? `${rows.join('\\n')}\\n` : 'no sprinkles\\n' };\n        },\n        async show(argv, caller, using) {\n          await reload(using);\n          const name = argv[1] ?? '';\n          if (!find(name)) return { code: 1, out: `sprinkle: there is no sprinkle ${name}\\n` };\n          const agentId = agentOf(caller, agents);\n          await post(name, agentId, using);\n          if (name !== SUGGESTIONS && !(await owners(using))[name])\n            await setOwner(name, agentId, using);\n          return { code: 0, out: `showed ${name} in the chat of ${agentId}\\n` };\n        },\n        async own(argv, caller, using) {\n          const name = argv[1] ?? '';\n          if (!find(name)) return { code: 1, out: `sprinkle: there is no sprinkle ${name}\\n` };\n          const agentId = argv[2] ? named(agents, argv[2]) : agentOf(caller, agents);\n          if (!agentId) return { code: 1, out: `sprinkle: there is no agent ${argv[2]}\\n` };\n          await setOwner(name, agentId, using);\n          return { code: 0, out: `${name} now talks to ${agentId}\\n` };\n        },\n      };\n      return {\n        sprinkles,\n        async send(id, payload, using) {\n          const sprinkle = find(id);\n          if (!sprinkle) return { delivered: false };\n          if (await options.intercept?.(id, payload, using)) return { delivered: true };\n          if (id === WELCOME && payload.action === 'onboarding-complete') {\n            await env.writeFile(WELCOMED, `${new Date().toISOString()}\\n`, using);\n            if (payload.data && typeof payload.data === 'object' && !Array.isArray(payload.data))\n              await env.writeFile(\n                WELCOME_PROFILE,\n                `${JSON.stringify(payload.data, null, 2)}\\n`,\n                using\n              );\n          }\n          await licks.deliver(\n            {\n              channel: 'sprinkle',\n              source: `sprinkle:${id}`,\n              title: sprinkle.title,\n              text: payload.action || '(no action)',\n              ...(payload.data === null ? {} : { body: JSON.stringify(payload.data, null, 2) }),\n              target: targetOf(ownerOf(agents, (await owners(using))[id])),\n            },\n            using\n          );\n          return { delivered: true };\n        },\n        async call(id, method, args, using) {\n          if (!find(id)) throw new Error(`there is no sprinkle ${id}`);\n          const handlers: Record<SprinkleMethod, () => Promise<JsonValue>> = {\n            async readFile() {\n              const read = await env.readTextFile(await inside(args[0], using), using);\n              if (!read.ok) throw new Error(read.error.message);\n              return read.value;\n            },\n            async exists() {\n              const found = await env.exists(await inside(args[0], using), using);\n              return found.ok && found.value;\n            },\n            async getState() {\n              return (await harness.snapshot(SprinklesDoc, using))?.state[id] ?? null;\n            },\n            async setState() {\n              await harness.commit(async (tx) => {\n                (await tx.doc(SprinklesDoc)).state[id] = (args[0] ?? null) as JsonValue;\n              }, using);\n              return null;\n            },\n          };\n          const handler = handlers[method as SprinkleMethod];\n          if (!handler) throw new Error(NO_EXEC);\n          return handler();\n        },\n        async command(argv, caller, using) {\n          const verb = argv[0] ?? 'help';\n          const run = commands[verb];\n          if (run) return run(argv, caller, using);\n          if (verb in RETIRED)\n            return { code: 2, out: `sprinkle ${verb} isn't in SLICC: ${RETIRED[verb]}\\n` };\n          return { code: verb === 'help' || verb === '--help' ? 0 : 2, out: USAGE };\n        },\n        reload,\n        async close(using) {\n          offCone();\n          clearTimeout(timer);\n          await watcher?.close(using);\n        },\n      };\n    },\n  };\n}\n"],
-  "mappings": "AAAA;AAAA,EAIE;AAAA,OACK;AAGP,SAAsB,YAAY;AAGlC;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EAGA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AA8BA,MAAM,QAAQ;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AASrB,MAAM,UAAkC;AAAA,EACtC,MAAM;AAAA,EACN,QAAQ;AAAA,EACR,OAAO;AAAA,EACP,MAAM;AAAA,EACN,MAAM;AACR;AAEA,SAAS,SAAS,SAA6B;AAC7C,SAAO,QAAQ,WAAW,QAAQ,IAAK,UAAyB,QAAQ,OAAO;AACjF;AAEA,SAAS,QAAQ,QAAuB,QAAwB;AAC9D,MAAI,QAAQ,WAAW,OAAO,EAAG,QAAO,OAAO,MAAM,QAAQ,MAAM;AACnE,SAAO,UAAU,OAAO,WAAW;AACrC;AAEA,SAAS,MAAM,QAAgB,OAAmC;AAChE,QAAM,QAAQ,OAAO,MAAM;AAC3B,MAAI,SAAS,MAAM,MAAO,QAAO;AACjC,QAAM,KAAK,MAAM,WAAW,QAAQ,IAAI,QAAQ,SAAS,KAAK;AAC9D,SAAO,MAAM,MAAM,SAAS,KAAK;AACnC;AAEO,SAAS,QAAQ,QAAgB,OAAmC;AACzE,QAAM,QAAQ,OAAO,MAAM;AAC3B,MAAI,SAAS,MAAM,MAAM,KAAK,EAAG,QAAO;AACxC,QAAM,QAAQ,QAAQ,MAAM,OAAO,KAAK,IAAI;AAC5C,SAAO,SAAS,KAAK,KAAK,IAAK,QAAmB,OAAO,WAAW;AACtE;AAEA,SAAS,MAAM,MAAc,MAAc,SAA2B;AACpE,SAAO,EAAE,IAAI,MAAM,MAAM,GAAG,SAAS,MAAM,IAAI,GAAG,SAAS,KAAK;AAClE;AAEA,SAAS,SACP,SACA,KACA,UACA,WACA,QACA;AACA,QAAM,EAAE,KAAK,OAAO,IAAI;AACxB,QAAM,EAAE,SAAS,YAAY,IAAI;AACjC,SAAO,OAAO,UAAmB;AAC/B,UAAM,QAAQ,MAAM,OAAO,KAAK;AAChC,UAAM,SACJ,gBAAgB,SAAY,SAAY,MAAM,IAAI,OAAO,mBAAmB,KAAK;AACnF,UAAM,UAAU,QAAQ,OAAO,QAAQ,OAAO;AAC9C,UAAM,WAAW,oBAAI,IAAI,CAAC,SAAS,GAAI,UAAU,CAAC,WAAW,IAAI,CAAC,CAAE,CAAC;AACrE,UAAM,MAAkB,CAAC;AACzB,eAAW,EAAE,MAAM,KAAK,KAAK,MAAM,cAAc,KAAK,KAAK,KAAK,GAAG;AACjE,UAAI,SAAS,IAAI,IAAI,EAAG;AACxB,YAAM,OAAO,MAAM,IAAI,aAAa,MAAM,KAAK;AAC/C,UAAI,KAAK,GAAI,KAAI,KAAK,MAAM,MAAM,KAAK,OAAO,QAAQ,QAAQ,MAAM,IAAI,CAAC,CAAC,CAAC;AAAA,IAC7E;AACA,QAAI;AACF,UAAI,KAAK,MAAM,aAAa,aAAuB,QAAQ,QAAQ,MAAM,WAAW,CAAC,CAAC,CAAC;AACzF,QAAI,YAAY;AACd,UAAI,KAAK;AAAA,QACP,GAAG,MAAM,SAAS,SAAS,QAAQ,QAAQ,MAAM,OAAO,KAAK,MAAM,CAAC;AAAA,QACpE,QAAQ;AAAA,MACV,CAAC;AACH,cAAU,QAAQ,OAAO,GAAG;AAAA,EAC9B;AACF;AAEO,SAAS,iBAAiB;AAC/B,SAAO;AAAA,IACL,MAAM,OAAO,SAA0B,SAA6C;AAClF,YAAM,EAAE,SAAS,QAAQ,OAAO,IAAI,IAAI;AACxC,YAAM,MAAM,QAAQ,OAAO;AAC3B,YAAM,YAAY,gBAA4B,CAAC,CAAC;AAChD,YAAM,UAAU,CAAC,SACf,QAAQ,SACJ,QAAQ,OAAO,+BAA+B,IAAI,QAAQ,EAAE,MAAM,MAAM,MAAS,IACjF,QAAQ,QAAQ,MAAS;AAC/B,YAAM,UAAU,MAAM,QAAQ,OAAO;AACrC,YAAM,cAAc,MAAM,QAAQ,WAAW;AAC7C,YAAM,SAAS,OAAO,WACnB,MAAM,QAAQ,SAAS,cAAc,KAAK,IAAI,UAAU,CAAC;AAC5D,YAAM,SAAS,SAAS,SAAS,KAAK,EAAE,SAAS,YAAY,GAAG,WAAW,MAAM;AACjF,YAAM,SAAS,OAAO,MAAe,UAAmB;AACtD,cAAM,QAAQ,SAAS,IAAI;AAC3B,cAAM,OAAO,MAAM,IAAI,cAAc,OAAO,KAAK;AACjD,eAAO,KAAK,KAAK,SAAS,KAAK,KAAK,IAAI;AAAA,MAC1C;AACA,YAAM,UAAU,OAAO,OAAO,MAAM,OAAO,OAAO,EAAE,MAAM,MAAM,MAAS,CAAC;AAC1E,YAAM,OAAO,CAAC,OAAe,UAAU,MAAM,KAAK,CAAC,SAAS,KAAK,OAAO,EAAE;AAC1E,YAAM,OAAO,OAAO,IAAY,SAAiB,UAAmB;AAClE,cAAM,eAAe,MAAM,OAAO,aAAa,SAAS,KAAK;AAC7D,YAAI,CAAC,aAAc,OAAM,IAAI,MAAM,qBAAqB,OAAO,EAAE;AACjE,cAAM,aAAa;AAAA,UACjB,EAAE,MAAM,SAAS,OAAO,EAAE,MAAM,eAAe,MAAM,EAAE,UAAU,IAAI,IAAI,KAAK,IAAI,EAAE,EAAE,EAAE;AAAA,UACxF;AAAA,QACF;AAAA,MACF;AACA,YAAM,WAAW,OAAO,MAAc,SAAiB,UAAmB;AACxE,cAAM,QAAQ,OAAO,OAAO,OAAO;AACjC,WAAC,MAAM,GAAG,IAAI,YAAY,GAAG,OAAO,IAAI,IAAI;AAAA,QAC9C,GAAG,KAAK;AACR,cAAM,OAAO,KAAK;AAAA,MACpB;AACA,YAAM,OAAO,OAAO;AACpB,YAAM,QAAQ,MAAM,QAAQ,SAAS,cAAc,OAAO;AAC1D,UAAI,YAAY,UAAa,CAAC,OAAO,UAAU;AAC7C,cAAM,KAAK,SAAS,QAAQ,OAAO;AACnC,cAAM,QAAQ,OAAO,OAAO,OAAO;AACjC,WAAC,MAAM,GAAG,IAAI,YAAY,GAAG,WAAW;AAAA,QAC1C,GAAG,OAAO;AAAA,MACZ;AACA,UAAI;AACJ,YAAM,UAAU,MAAM,IAAI;AAAA,QACxB,CAAC,EAAE,MAAM,KAAK,WAAW,KAAK,GAAG,EAAE,MAAM,gBAAgB,CAAC;AAAA,QAC1D,MAAM;AACJ,uBAAa,KAAK;AAClB,kBAAQ,WAAW,MAAM,KAAK,OAAO,OAAO,EAAE,MAAM,MAAM,MAAS,GAAG,QAAQ,QAAQ;AAAA,QACxF;AAAA,QACA;AAAA,MACF;AACA,YAAM,UAAmC,QAAQ,KAAK,QAAQ,QAAQ;AACtE,YAAM,WAGF;AAAA,QACF,MAAM,KAAK,OAAO,SAAS,OAAO;AAChC,gBAAM,OAAO,KAAK;AAClB,gBAAM,OAAO,UAAU,MACpB,OAAO,CAAC,SAAS,CAAC,KAAK,MAAM,EAC7B,IAAI,CAAC,SAAS,GAAG,KAAK,IAAI,IAAK,KAAK,KAAK,IAAK,KAAK,OAAO,EAAE;AAC/D,iBAAO,EAAE,MAAM,GAAG,KAAK,KAAK,SAAS,GAAG,KAAK,KAAK,IAAI,CAAC;AAAA,IAAO,iBAAiB;AAAA,QACjF;AAAA,QACA,MAAM,KAAK,MAAM,QAAQ,OAAO;AAC9B,gBAAM,OAAO,KAAK;AAClB,gBAAM,OAAO,KAAK,CAAC,KAAK;AACxB,cAAI,CAAC,KAAK,IAAI,EAAG,QAAO,EAAE,MAAM,GAAG,KAAK,kCAAkC,IAAI;AAAA,EAAK;AACnF,gBAAM,UAAU,QAAQ,QAAQ,MAAM;AACtC,gBAAM,KAAK,MAAM,SAAS,KAAK;AAC/B,cAAI,SAAS,eAAe,EAAE,MAAM,OAAO,KAAK,GAAG,IAAI;AACrD,kBAAM,SAAS,MAAM,SAAS,KAAK;AACrC,iBAAO,EAAE,MAAM,GAAG,KAAK,UAAU,IAAI,mBAAmB,OAAO;AAAA,EAAK;AAAA,QACtE;AAAA,QACA,MAAM,IAAI,MAAM,QAAQ,OAAO;AAC7B,gBAAM,OAAO,KAAK,CAAC,KAAK;AACxB,cAAI,CAAC,KAAK,IAAI,EAAG,QAAO,EAAE,MAAM,GAAG,KAAK,kCAAkC,IAAI;AAAA,EAAK;AACnF,gBAAM,UAAU,KAAK,CAAC,IAAI,MAAM,QAAQ,KAAK,CAAC,CAAC,IAAI,QAAQ,QAAQ,MAAM;AACzE,cAAI,CAAC,QAAS,QAAO,EAAE,MAAM,GAAG,KAAK,+BAA+B,KAAK,CAAC,CAAC;AAAA,EAAK;AAChF,gBAAM,SAAS,MAAM,SAAS,KAAK;AACnC,iBAAO,EAAE,MAAM,GAAG,KAAK,GAAG,IAAI,iBAAiB,OAAO;AAAA,EAAK;AAAA,QAC7D;AAAA,MACF;AACA,aAAO;AAAA,QACL;AAAA,QACA,MAAM,KAAK,IAAI,SAAS,OAAO;AAC7B,gBAAM,WAAW,KAAK,EAAE;AACxB,cAAI,CAAC,SAAU,QAAO,EAAE,WAAW,MAAM;AACzC,cAAI,MAAM,QAAQ,YAAY,IAAI,SAAS,KAAK,EAAG,QAAO,EAAE,WAAW,KAAK;AAC5E,cAAI,OAAO,WAAW,QAAQ,WAAW,uBAAuB;AAC9D,kBAAM,IAAI,UAAU,UAAU,IAAG,oBAAI,KAAK,GAAE,YAAY,CAAC;AAAA,GAAM,KAAK;AACpE,gBAAI,QAAQ,QAAQ,OAAO,QAAQ,SAAS,YAAY,CAAC,MAAM,QAAQ,QAAQ,IAAI;AACjF,oBAAM,IAAI;AAAA,gBACR;AAAA,gBACA,GAAG,KAAK,UAAU,QAAQ,MAAM,MAAM,CAAC,CAAC;AAAA;AAAA,gBACxC;AAAA,cACF;AAAA,UACJ;AACA,gBAAM,MAAM;AAAA,YACV;AAAA,cACE,SAAS;AAAA,cACT,QAAQ,YAAY,EAAE;AAAA,cACtB,OAAO,SAAS;AAAA,cAChB,MAAM,QAAQ,UAAU;AAAA,cACxB,GAAI,QAAQ,SAAS,OAAO,CAAC,IAAI,EAAE,MAAM,KAAK,UAAU,QAAQ,MAAM,MAAM,CAAC,EAAE;AAAA,cAC/E,QAAQ,SAAS,QAAQ,SAAS,MAAM,OAAO,KAAK,GAAG,EAAE,CAAC,CAAC;AAAA,YAC7D;AAAA,YACA;AAAA,UACF;AACA,iBAAO,EAAE,WAAW,KAAK;AAAA,QAC3B;AAAA,QACA,MAAM,KAAK,IAAI,QAAQ,MAAM,OAAO;AAClC,cAAI,CAAC,KAAK,EAAE,EAAG,OAAM,IAAI,MAAM,wBAAwB,EAAE,EAAE;AAC3D,gBAAM,WAA6D;AAAA,YACjE,MAAM,WAAW;AACf,oBAAM,OAAO,MAAM,IAAI,aAAa,MAAM,OAAO,KAAK,CAAC,GAAG,KAAK,GAAG,KAAK;AACvE,kBAAI,CAAC,KAAK,GAAI,OAAM,IAAI,MAAM,KAAK,MAAM,OAAO;AAChD,qBAAO,KAAK;AAAA,YACd;AAAA,YACA,MAAM,SAAS;AACb,oBAAM,QAAQ,MAAM,IAAI,OAAO,MAAM,OAAO,KAAK,CAAC,GAAG,KAAK,GAAG,KAAK;AAClE,qBAAO,MAAM,MAAM,MAAM;AAAA,YAC3B;AAAA,YACA,MAAM,WAAW;AACf,sBAAQ,MAAM,QAAQ,SAAS,cAAc,KAAK,IAAI,MAAM,EAAE,KAAK;AAAA,YACrE;AAAA,YACA,MAAM,WAAW;AACf,oBAAM,QAAQ,OAAO,OAAO,OAAO;AACjC,iBAAC,MAAM,GAAG,IAAI,YAAY,GAAG,MAAM,EAAE,IAAK,KAAK,CAAC,KAAK;AAAA,cACvD,GAAG,KAAK;AACR,qBAAO;AAAA,YACT;AAAA,UACF;AACA,gBAAM,UAAU,SAAS,MAAwB;AACjD,cAAI,CAAC,QAAS,OAAM,IAAI,MAAM,OAAO;AACrC,iBAAO,QAAQ;AAAA,QACjB;AAAA,QACA,MAAM,QAAQ,MAAM,QAAQ,OAAO;AACjC,gBAAM,OAAO,KAAK,CAAC,KAAK;AACxB,gBAAM,MAAM,SAAS,IAAI;AACzB,cAAI,IAAK,QAAO,IAAI,MAAM,QAAQ,KAAK;AACvC,cAAI,QAAQ;AACV,mBAAO,EAAE,MAAM,GAAG,KAAK,YAAY,IAAI,oBAAoB,QAAQ,IAAI,CAAC;AAAA,EAAK;AAC/E,iBAAO,EAAE,MAAM,SAAS,UAAU,SAAS,WAAW,IAAI,GAAG,KAAK,MAAM;AAAA,QAC1E;AAAA,QACA;AAAA,QACA,MAAM,MAAM,OAAO;AACjB,kBAAQ;AACR,uBAAa,KAAK;AAClB,gBAAM,SAAS,MAAM,KAAK;AAAA,QAC5B;AAAA,MACF;AAAA,IACF;AAAA,EACF;AACF;",
+  "sourcesContent": ["import {\n  type Context,\n  type JsonValue,\n  type ReplicatedState,\n  replicatedState,\n} from '@earendil-works/chord';\nimport type { Harness } from '@earendil-works/pi-durable';\nimport type { ExecutionEnv, FileWatcher } from '@earendil-works/pi-durable/env';\nimport { type Agents, live } from '../agents.ts';\nimport type { LickTarget } from '../licks/lick.ts';\nimport type { Licks } from '../licks/licks.ts';\nimport {\n  describe,\n  homePath,\n  NO_EXEC,\n  SPRINKLE_KIND,\n  SPRINKLES_DIR,\n  type Sprinkle,\n  type SprinkleMethod,\n  SprinklesDoc,\n  SUGGESTIONS,\n  SUGGESTIONS_DIR,\n  SUGGESTIONS_STORE,\n  sprinkleFiles,\n  WELCOME,\n  WELCOME_PROFILE,\n  WELCOMED,\n} from './sprinkles.ts';\n\nexport type Answer = { code: number; out: string };\n\nexport interface SprinklePayload {\n  action: string;\n  data: JsonValue | null;\n  target: string | null;\n}\n\nexport interface SprinklesRuntime {\n  readonly sprinkles: ReplicatedState<Sprinkle[]>;\n  send(id: string, payload: SprinklePayload, context: Context): Promise<{ delivered: boolean }>;\n  call(id: string, method: string, args: readonly unknown[], context: Context): Promise<JsonValue>;\n  command(argv: readonly string[], caller: string | null, context: Context): Promise<Answer>;\n  reload(context: Context): Promise<void>;\n  close(context: Context): Promise<void>;\n}\n\nexport interface SprinklesAttach {\n  harness: Harness;\n  agents: Agents;\n  licks: Licks;\n  env: ExecutionEnv;\n  assets?: (path: string) => Promise<string>;\n  reloadMs: number;\n  dir?: string;\n  intercept?: (id: string, payload: SprinklePayload, context: Context) => Promise<boolean>;\n}\n\nexport const USAGE = `usage:\n  sprinkle list                 every sprinkle in /home/sprinkles, with its owner\n  sprinkle show <name>          show a sprinkle in your chat\n  sprinkle own <name> [<agent>] send its messages to <agent> (cone, cone-<n> or a scoop's handle)\n  sprinkle open|close <name>    the same as panel open|close sprinkle:<name>\n\nA sprinkle is an .shtml file in /home/sprinkles, as <name>.shtml or <name>/<name>.shtml.\nEvery one of them has a button in the rail; edit the file and the open panel reloads.\n`;\n\nconst RETIRED: Record<string, string> = {\n  reload: 'editing the .shtml file reloads the sprinkle',\n  send: 'a sprinkle reads data with slicc.readFile() or keeps it with slicc.setState(); write the file it reads',\n  chat: 'show the sprinkle with sprinkle show <name> and wait for its lick',\n};\n\nfunction targetOf(agentId: string): LickTarget {\n  return agentId.startsWith('scoop:') ? (agentId as LickTarget) : `cone:${agentId}`;\n}\n\nfunction agentOf(caller: string | null, agents: Agents): string {\n  if (caller?.startsWith('cone:')) return caller.slice('cone:'.length);\n  return caller ?? agents.activeCone();\n}\n\nfunction named(agents: Agents, value: string): string | undefined {\n  const state = agents.state();\n  if (value in state.cones) return value;\n  const id = value.startsWith('scoop:') ? value : `scoop:${value}`;\n  return id in state.scoops ? id : undefined;\n}\n\nexport function ownerOf(agents: Agents, owner: string | undefined): string {\n  const state = agents.state();\n  if (owner && state.cones[owner]) return owner;\n  const scoop = owner ? state.scoops[owner] : undefined;\n  return scoop && live(scoop) ? (owner as string) : agents.activeCone();\n}\n\nfunction entry(name: string, html: string, agentId: string): Sprinkle {\n  return { id: name, name, ...describe(name, html), agentId, html };\n}\n\nfunction reloader(\n  options: SprinklesAttach,\n  dir: string,\n  builtins: { welcome: string | undefined; suggestions: string | undefined },\n  sprinkles: ReplicatedState<Sprinkle[]> & { replace(context: Context, value: Sprinkle[]): void },\n  owners: (context: Context) => Promise<Record<string, string>>\n) {\n  const { env, agents } = options;\n  const { welcome, suggestions } = builtins;\n  return async (using: Context) => {\n    const owned = await owners(using);\n    const stored =\n      suggestions === undefined ? undefined : await env.exists(SUGGESTIONS_STORE, using);\n    const offered = stored?.ok === true && stored.value;\n    const reserved = new Set([WELCOME, ...(offered ? [SUGGESTIONS] : [])]);\n    const out: Sprinkle[] = [];\n    for (const { name, path } of await sprinkleFiles(env, dir, using)) {\n      if (reserved.has(name)) continue;\n      const read = await env.readTextFile(path, using);\n      if (read.ok) out.push(entry(name, read.value, ownerOf(agents, owned[name])));\n    }\n    if (offered)\n      out.push(entry(SUGGESTIONS, suggestions as string, ownerOf(agents, owned[SUGGESTIONS])));\n    if (welcome !== undefined)\n      out.push({\n        ...entry(WELCOME, welcome, ownerOf(agents, owned[WELCOME] ?? 'cone')),\n        inline: true,\n      });\n    sprinkles.replace(using, out);\n  };\n}\n\nexport function setupSprinkles() {\n  return {\n    async attach(options: SprinklesAttach, context: Context): Promise<SprinklesRuntime> {\n      const { harness, agents, licks, env } = options;\n      const dir = options.dir ?? SPRINKLES_DIR;\n      const sprinkles = replicatedState<Sprinkle[]>([]);\n      const builtin = (name: string) =>\n        options.assets\n          ? options.assets(`packages/vfs-root/sprinkles/${name}.shtml`).catch(() => undefined)\n          : Promise.resolve(undefined);\n      const welcome = await builtin(WELCOME);\n      const suggestions = await builtin(SUGGESTIONS);\n      const owners = async (using: Context) =>\n        (await harness.snapshot(SprinklesDoc, using))?.owners ?? {};\n      const reload = reloader(options, dir, { welcome, suggestions }, sprinkles, owners);\n      const inside = async (path: unknown, using: Context) => {\n        const asked = homePath(path);\n        const real = await env.canonicalPath(asked, using);\n        return real.ok ? homePath(real.value) : asked;\n      };\n      const offCone = agents.onCone(() => reload(context).catch(() => undefined));\n      const find = (id: string) => sprinkles.value.find((item) => item.id === id);\n      const post = async (id: string, agentId: string, using: Context) => {\n        const conversation = await agents.conversation(agentId, using);\n        if (!conversation) throw new Error(`there is no agent ${agentId}`);\n        await conversation.submit(\n          { type: 'write', entry: { kind: SPRINKLE_KIND, data: { sprinkle: id, at: Date.now() } } },\n          using\n        );\n      };\n      const setOwner = async (name: string, agentId: string, using: Context) => {\n        await harness.commit(async (tx) => {\n          (await tx.doc(SprinklesDoc)).owners[name] = agentId;\n        }, using);\n        await reload(using);\n      };\n      await reload(context);\n      const state = await harness.snapshot(SprinklesDoc, context);\n      if (welcome !== undefined && !state?.welcomed) {\n        await post(WELCOME, 'cone', context);\n        await harness.commit(async (tx) => {\n          (await tx.doc(SprinklesDoc)).welcomed = true;\n        }, context);\n      }\n      let timer: ReturnType<typeof setTimeout> | undefined;\n      const watched = await env.watch(\n        [{ path: dir, recursive: true }, { path: SUGGESTIONS_DIR }],\n        () => {\n          clearTimeout(timer);\n          timer = setTimeout(() => void reload(context).catch(() => undefined), options.reloadMs);\n        },\n        context\n      );\n      const watcher: FileWatcher | undefined = watched.ok ? watched.value : undefined;\n      const commands: Record<\n        string,\n        (argv: readonly string[], caller: string | null, using: Context) => Promise<Answer>\n      > = {\n        async list(_argv, _caller, using) {\n          await reload(using);\n          const rows = sprinkles.value\n            .filter((item) => !item.inline)\n            .map((item) => `${item.name}\\t${item.title}\\t${item.agentId}`);\n          return { code: 0, out: rows.length ? `${rows.join('\\n')}\\n` : 'no sprinkles\\n' };\n        },\n        async show(argv, caller, using) {\n          await reload(using);\n          const name = argv[1] ?? '';\n          if (!find(name)) return { code: 1, out: `sprinkle: there is no sprinkle ${name}\\n` };\n          const agentId = agentOf(caller, agents);\n          await post(name, agentId, using);\n          if (name !== SUGGESTIONS && !(await owners(using))[name])\n            await setOwner(name, agentId, using);\n          return { code: 0, out: `showed ${name} in the chat of ${agentId}\\n` };\n        },\n        async own(argv, caller, using) {\n          const name = argv[1] ?? '';\n          if (!find(name)) return { code: 1, out: `sprinkle: there is no sprinkle ${name}\\n` };\n          const agentId = argv[2] ? named(agents, argv[2]) : agentOf(caller, agents);\n          if (!agentId) return { code: 1, out: `sprinkle: there is no agent ${argv[2]}\\n` };\n          await setOwner(name, agentId, using);\n          return { code: 0, out: `${name} now talks to ${agentId}\\n` };\n        },\n      };\n      return {\n        sprinkles,\n        async send(id, payload, using) {\n          const sprinkle = find(id);\n          if (!sprinkle) return { delivered: false };\n          if (await options.intercept?.(id, payload, using)) return { delivered: true };\n          if (id === WELCOME && payload.action === 'onboarding-complete') {\n            await env.writeFile(WELCOMED, `${new Date().toISOString()}\\n`, using);\n            if (payload.data && typeof payload.data === 'object' && !Array.isArray(payload.data))\n              await env.writeFile(\n                WELCOME_PROFILE,\n                `${JSON.stringify(payload.data, null, 2)}\\n`,\n                using\n              );\n          }\n          await licks.deliver(\n            {\n              channel: 'sprinkle',\n              source: `sprinkle:${id}`,\n              title: sprinkle.title,\n              text: payload.action || '(no action)',\n              ...(payload.data === null ? {} : { body: JSON.stringify(payload.data, null, 2) }),\n              target: targetOf(ownerOf(agents, (await owners(using))[id])),\n            },\n            using\n          );\n          return { delivered: true };\n        },\n        async call(id, method, args, using) {\n          if (!find(id)) throw new Error(`there is no sprinkle ${id}`);\n          const handlers: Record<SprinkleMethod, () => Promise<JsonValue>> = {\n            async readFile() {\n              const read = await env.readTextFile(await inside(args[0], using), using);\n              if (!read.ok) throw new Error(read.error.message);\n              return read.value;\n            },\n            async exists() {\n              const found = await env.exists(await inside(args[0], using), using);\n              return found.ok && found.value;\n            },\n            async getState() {\n              return (await harness.snapshot(SprinklesDoc, using))?.state[id] ?? null;\n            },\n            async setState() {\n              await harness.commit(async (tx) => {\n                (await tx.doc(SprinklesDoc)).state[id] = (args[0] ?? null) as JsonValue;\n              }, using);\n              return null;\n            },\n          };\n          const handler = handlers[method as SprinkleMethod];\n          if (!handler) throw new Error(NO_EXEC);\n          return handler();\n        },\n        async command(argv, caller, using) {\n          const verb = argv[0] ?? 'help';\n          const run = commands[verb];\n          if (run) return run(argv, caller, using);\n          if (verb in RETIRED)\n            return { code: 2, out: `sprinkle ${verb} isn't in SLICC: ${RETIRED[verb]}\\n` };\n          return { code: verb === 'help' || verb === '--help' ? 0 : 2, out: USAGE };\n        },\n        reload,\n        async close(using) {\n          offCone();\n          clearTimeout(timer);\n          await watcher?.close(using);\n        },\n      };\n    },\n  };\n}\n"],
+  "mappings": "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",
   "names": []
 }

package/dist/types/client.d.ts

@@ -4,6 +4,7 @@ import type { ChangesView } from './changes/git.ts';
 import type { FrozenCone } from './freezer/index.ts';
 import type { MemoryEntry, MemoryScope } from './memory/format.ts';
 import type { AgentRemote } from './remote/host.ts';
+import type { AgentPages } from './remote/pages.ts';
 import { AgentControl, AgentSettings, type AgentsSummary, type Command, type Delivered, type MonitorFeed, type SendMode } from './services.ts';
 import type { Sprinkle } from './sprinkles/kind.ts';
 import { type PortEndpoint } from './wire.ts';
@@ -23,6 +24,7 @@ export interface AgentConnection {
     readonly monitor?: ReplicatedState<MonitorFeed>;
     readonly settings: AgentSettings;
     readonly remote?: AgentRemote;
+    readonly pages?: AgentPages;
     readonly closed: Promise<Error | undefined>;
     prompt(text: string, whenBusy?: SendMode): Promise<string>;
     webhook(name: string, delivery: {

package/dist/types/host.d.ts

@@ -7,17 +7,21 @@ import type { UserClients } from './kernel/users.ts';
 import type { McpRuntime } from './mcp/index.ts';
 import type { MemoryRuntime } from './memory/index.ts';
 import { type MonitorOptions } from './monitor/index.ts';
+import { type Pages } from './remote/pages.ts';
 import { AgentSettings } from './services.ts';
 import type { SkillsRuntime } from './skills/index.ts';
 import type { SprinklesRuntime } from './sprinkles/index.ts';
 import type { PortEndpoint } from './wire.ts';
+export interface ConnectOptions {
+    readOnly?: boolean;
+    pages?: boolean;
+}
 export interface AgentHost {
     readonly serverId: string;
     readonly agent: Agent;
     readonly users?: UserClients;
-    connect(endpoint: PortEndpoint, options?: {
-        readOnly?: boolean;
-    }): void;
+    readonly pages: Pages;
+    connect(endpoint: PortEndpoint, options?: ConnectOptions): void;
     close(): Promise<void>;
 }
 export declare function hostAgent(agent: Agent, options?: {
@@ -34,4 +38,5 @@ export declare function hostAgent(agent: Agent, options?: {
     mcp?: Pick<McpRuntime, 'close'>;
     users?: UserClients;
     monitor?: Pick<MonitorOptions, 'kernel' | 'groups' | 'users' | 'secrets'>;
+    pages?: Pages;
 }): Promise<AgentHost>;

package/dist/types/index.d.ts

@@ -3,7 +3,7 @@ export { type Agent, type AgentOptions, answerText, openAgent } from './agent.ts
 export { type AgentConnection, connectAgent } from './client.ts';
 export { createAgentControl } from './control.ts';
 export { CREDENTIALS_DATABASE, EncryptedCredentialStore } from './credentials.ts';
-export { type AgentHost, hostAgent } from './host.ts';
+export { type AgentHost, type ConnectOptions, 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 { adminOver, type KernelAdmin, type KernelUser, type KernelUsers, serveAdmin, type UserClient, type UserClients, type UserConnect, type UserSpec, userClients, } from './kernel/users.ts';
@@ -13,7 +13,8 @@ export { type Transport, type TransportResponse, transportFetch } from './net.ts
 export { AGENT_LOCK, type AgentOwner, type AgentWorker, type KernelSource, type OwnerOptions, startAgent, } from './owner.ts';
 export { applyPatches, patchServerAccept } from './patches.ts';
 export { SliccPrompt, sliccPrompt } from './prompt.ts';
-export { type AccountState, AGENT_SESSION, AgentControl, AgentSessions, AgentSettings, type AgentSettingsChange, AgentTranscript, type BudgetState, type ModelChoice, type OperationError, type PromptResult, type SendMode, type SendRequest, type SendResponse, type SettingsState, type SignIn, } from './services.ts';
+export { type AgentPages, createPages, type PageBatch, type PageCaller, type PageRequest, type PageResult, type Pages, type PagesOpened, type PageTab, } from './remote/pages.ts';
+export { type AccountState, AGENT_SESSION, AgentControl, AgentPagesService, AgentSessions, AgentSettings, type AgentSettingsChange, AgentTranscript, type BudgetState, type ModelChoice, type OperationError, type PromptResult, type SendMode, type SendRequest, type SendResponse, type SettingsState, type SignIn, } from './services.ts';
 export { BEDROCK, createAgentSettings, createSliccModels, DEFAULT_MODEL, DEFAULT_REGIONS, sliccProviders, withDefaultRegions, } from './settings.ts';
 export { AGENT_DIRECTORY, type OpfsSqliteOptions, openMemorySqliteStorage, openOpfsSqliteStorage, WasmSqliteDatabase, } from './sqlite.ts';
 export { type SystemFacts, systemSection } from './system.ts';

package/dist/types/licks/config.d.ts

@@ -12,11 +12,13 @@ export interface WatchEntry {
     target: LickTarget;
     message: string;
     debounce: number;
+    triage?: string;
 }
 export interface WebhookEntry {
     name: string;
     target: LickTarget;
     message: string;
+    triage?: string;
 }
 export interface ConfigError {
     file: string;

package/dist/types/licks/licks.d.ts

@@ -2,6 +2,7 @@ import type { Context } from '@earendil-works/chord';
 import { type Conversation, type Harness } from '@earendil-works/pi-durable';
 import { type Lick, type LickAction, type LickChannel, type LickSeverity, type LickTarget } from './lick.ts';
 import { LICK_STATE_KIND, type LickDecision } from './state.ts';
+import { type Triage } from './triage.ts';
 export interface LickEvent {
     channel: LickChannel;
     source: string;
@@ -15,6 +16,7 @@ export interface LickEvent {
     severity?: LickSeverity;
     eventId?: string;
     at?: number;
+    triage?: string;
 }
 type Pending = {
     lick: Lick;
@@ -47,6 +49,7 @@ export interface Licks {
     pending(context: Context): Promise<number>;
     forget(target: LickTarget, channel: LickChannel, source: string, context: Context): Promise<void>;
     guard(check: (target: LickTarget) => Blocked | undefined): void;
+    triage(judge: Triage): void;
 }
 export type Blocked = {
     id: string;

package/dist/types/licks/triage.d.ts

@@ -0,0 +1,42 @@
+import type { Context } from '@earendil-works/chord';
+import type { Models } from '@earendil-works/pi-ai/models';
+import type { LickEvent } from './licks.ts';
+export declare const TRIAGE_MODEL = "clef-flash";
+export declare const TRIAGE_SKIP = 0.75;
+export declare const TRIAGE_KIND = "slicc.lick-triage";
+export declare const TRIAGE_LIMIT = 4000;
+export interface Verdict {
+    decision: 'act' | 'ignore';
+    confidence: number;
+    probabilities: Record<string, number>;
+    model: string;
+    cost: number | null;
+}
+export type Triage = (event: LickEvent, context: Context) => Promise<Verdict | undefined>;
+export declare function clip(text: string): string;
+export declare function skips(verdict: Verdict | undefined): verdict is Verdict;
+export declare function lickTriage(models: Pick<Models, 'getModelOfType' | 'classify'>): Triage;
+export declare function skipEntry(event: LickEvent, verdict: Verdict, now: number): {
+    type: 'write';
+    requestId: string;
+    entry: {
+        kind: string;
+        data: {
+            decision: 'act' | 'ignore';
+            confidence: number;
+            probabilities: Record<string, number>;
+            model: string;
+            cost: number | null;
+            channel: "bash" | "cherry" | "cron" | "discovery" | "fswatch" | "jshd" | "navigate" | "preview" | "scoop-idle" | "scoop-notify" | "scoop-wait" | "session-reload" | "sprinkle" | "sudo-request" | "upgrade" | "webhook" | "workflow";
+            source: string;
+            title: string;
+            text: string;
+            body?: string | undefined;
+            items?: string[] | undefined;
+            lick: string;
+            count: number;
+            at: number;
+            triage: string;
+        };
+    };
+};

package/dist/types/owner.d.ts

@@ -8,6 +8,7 @@ export interface AgentWorker {
 }
 export interface PortOptions {
     readOnly?: boolean;
+    pages?: boolean;
 }
 export interface AgentOwner {
     connect(options?: PortOptions): Promise<AgentConnection>;

package/dist/types/readonly.d.ts

@@ -1,7 +1,9 @@
 import type { AgentRemote } from './remote/host.ts';
+import type { AgentPages } from './remote/pages.ts';
 import type { AgentControl, AgentSettings } from './services.ts';
 import { VIEW_ONLY } from './view-only.ts';
 export { VIEW_ONLY };
 export declare function viewControl(control: AgentControl): AgentControl;
 export declare function viewSettings(settings: AgentSettings): AgentSettings;
+export declare function viewPages(): AgentPages;
 export declare function viewRemote(remote: AgentRemote): AgentRemote;

package/dist/types/remote/host.d.ts

@@ -45,6 +45,16 @@ export interface RemoteHost {
     limit?: number;
     sweepMs?: number;
 }
+export declare class Stream<T = RemoteEvent> {
+    #private;
+    readonly queue: T[];
+    done: boolean;
+    touched: number;
+    constructor(stop: () => Promise<unknown>, now: number, limit: number, overflow: readonly T[]);
+    push(events: readonly T[]): void;
+    finish(): Promise<void>;
+    wait(ms: number, signal?: AbortSignal): Promise<void>;
+}
 export declare function followed(mapper: Mapper, event: AgentEvent): RemoteEvent[];
 export declare function resync(mapper: Mapper, snapshot: SnapshotEvent): RemoteEvent[];
 export declare class Follower {

package/dist/types/remote/pages.d.ts

@@ -0,0 +1,76 @@
+import type { Context } from '@earendil-works/chord';
+import type { Answer } from '../scoops/service.ts';
+export declare const PAGES_IDLE_MS = 30000;
+export declare const PICK_MS = 5000;
+export declare const ANSWER_MS = 5000;
+export declare const MAX_PENDING = 100;
+export interface PageTab {
+    tab: string;
+    kinds: string[];
+    cone: string | null;
+    visible: boolean;
+    focused: boolean;
+    lastActive: number;
+}
+export interface PageCaller {
+    agentId: string | null;
+    cone: string;
+    readOnly?: boolean;
+}
+export interface PageRequest {
+    id: string;
+    kind: 'panel';
+    argv: string[];
+    caller: PageCaller;
+}
+export interface PageResult {
+    stdout: string;
+    stderr: string;
+    code: number;
+}
+export type PagesOpened = {
+    stream: string;
+} | {
+    error: string;
+};
+export interface PageBatch {
+    requests: PageRequest[];
+    done: boolean;
+}
+export interface AgentPages {
+    open(tab: PageTab, context: Context): Promise<PagesOpened>;
+    report(stream: string, tab: PageTab, context: Context): Promise<void>;
+    next(stream: string, waitMs: number, context: Context): Promise<PageBatch>;
+    answer(stream: string, id: string, result: PageResult, context: Context): Promise<void>;
+    close(stream: string, context: Context): Promise<void>;
+}
+export interface PageAsk {
+    kind: 'panel';
+    argv: readonly string[];
+    agentId: string | null;
+    cone: string;
+    tab: string | null;
+}
+export interface Pages extends AgentPages {
+    request(ask: PageAsk): Promise<PageResult>;
+    command(argv: readonly string[], caller: {
+        agentId: string | null;
+        cone: string;
+        tab: string | null;
+    }, context: Context): Promise<Answer>;
+    tabs(): PageTab[];
+    dispose(): Promise<void>;
+}
+export interface PagesOptions {
+    now?: () => number;
+    idleMs?: number;
+    sweepMs?: number;
+    pickMs?: number;
+    answerMs?: number;
+}
+export declare function noTab(cone: string): PageResult;
+export declare function noAnswer(cone: string): PageResult;
+export declare function ownedPages(pages: AgentPages): AgentPages & {
+    release(): void;
+};
+export declare function createPages(options?: PagesOptions): Pages;

package/dist/types/scoops/cli.d.ts

@@ -24,6 +24,12 @@ export interface CliOptions {
     gelatiere?: (argv: readonly string[], caller: string | null, context: Context) => Promise<Answer>;
     freezer?: (argv: readonly string[], caller: string | null, context: Context) => Promise<Answer>;
     models?: (argv: readonly string[], caller: string | null, context: Context) => Promise<Answer>;
+    panel?: (argv: readonly string[], caller: PanelCaller, context: Context) => Promise<Answer>;
+}
+export interface PanelCaller {
+    agentId: string | null;
+    cone: string;
+    tab: string | null;
 }
 export type Deps = CliOptions & {
     now: () => number;
@@ -69,4 +75,5 @@ export declare function role(deps: Deps, parsed: Flags): Promise<{
 }>;
 export declare function unsupported(argv: readonly string[]): Answer | undefined;
 export declare function noScoop(state: Readonly<AgentsState>, name: string): string;
+export declare function panelCaller(request: Request, who: Caller): PanelCaller;
 export declare function createCli(options: CliOptions): Runner;

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

@@ -30,6 +30,7 @@ export interface AttachOptions {
     gelatiere?: CliOptions['gelatiere'];
     freezer?: CliOptions['freezer'];
     models?: CliOptions['models'];
+    panel?: CliOptions['panel'];
     mcp?: (names: readonly string[]) => ToolRegistration[];
 }
 export interface ScoopsRuntime {

package/dist/types/scoops/requests.d.ts

@@ -6,8 +6,9 @@ export declare const PROTOCOL = "slicc-agent/1";
 export declare const STALE_MS: number;
 export interface Request {
     id: string;
-    as: 'agent' | 'subagent' | 'sprinkle' | 'memory' | 'gelatiere' | 'freezer' | 'models';
+    as: 'agent' | 'subagent' | 'sprinkle' | 'memory' | 'gelatiere' | 'freezer' | 'models' | 'panel';
     caller: string;
+    tab?: string | null;
     cwd: string;
     pid: number | null;
     argv: string[];