@ai-ecoverse/slicc-agent 5.0.3 → 5.1.0

package/dist/spectrum/approvals-port.js

@@ -0,0 +1,135 @@
+import { BACKGROUND_CONTEXT } from "@earendil-works/chord/context";
+import { Emitter } from "./emitter.js";
+const ENDS = {
+  approved: "answered",
+  rejected: "answered",
+  unanswered: "expired",
+  withdrawn: "withdrawn"
+};
+function requesterOf(item) {
+  const { kind, name, agentId, where } = item.requester;
+  return {
+    kind,
+    name,
+    ...agentId ? { agentId } : {},
+    ...where ? { where } : {}
+  };
+}
+function shown(item, agentName) {
+  const base = {
+    id: item.id,
+    requester: requesterOf(item),
+    createdAt: item.createdAt,
+    expiresAt: item.expiresAt
+  };
+  if (item.kind === "sudo") {
+    const { command, target, cwd, alwaysScope } = item.detail;
+    return {
+      ...base,
+      kind: "sudo",
+      command,
+      ...target ? { target } : {},
+      ...cwd ? { cwd } : {},
+      always: item.always,
+      ...alwaysScope ? { alwaysScope } : {}
+    };
+  }
+  const guest = {
+    ...base,
+    agentId: item.agentId,
+    ...agentName ? { agentName } : {},
+    always: false,
+    ...item.verdict ? { verdict: { ...item.verdict } } : {}
+  };
+  if (item.kind === "guest-tool")
+    return { ...guest, kind: "guest-tool", tool: item.detail.tool, summary: item.detail.summary };
+  return {
+    ...guest,
+    kind: "guest-message",
+    text: item.detail.text,
+    ...item.detail.attachments.length ? { attachments: item.detail.attachments.map((file) => ({ ...file })) } : {}
+  };
+}
+const NOT_HERE = "This request can't be answered in this tab.";
+const asked = (item) => item.state === "pending" && item.tier === "user";
+class ApprovalsAdapter extends Emitter {
+  #connection;
+  #host;
+  #ours;
+  #mine = /* @__PURE__ */ new Set();
+  #deciding = /* @__PURE__ */ new Set();
+  #listed = /* @__PURE__ */ new Set();
+  decide;
+  constructor(connection, host) {
+    super();
+    this.#connection = connection;
+    this.#host = host;
+    this.#ours = !connection.readOnly && !connection.mismatch;
+    if (this.#ours || host?.decide) this.decide = (...args) => this.#route(...args);
+    this.#listed = new Set(this.#agent().map((approval) => approval.id));
+    connection.approvals?.subscribe(() => this.#changed());
+    host?.on("approvals", () => this.emit("approvals", this.list()));
+    host?.on("ended", (detail) => this.emit("ended", detail));
+  }
+  #items() {
+    return this.#connection.approvals?.value ?? [];
+  }
+  list() {
+    return [...this.#host?.list() ?? [], ...this.#agent()].sort(
+      (a, b) => a.createdAt - b.createdAt
+    );
+  }
+  #agent() {
+    const names = new Map(
+      (this.#connection.agents?.value?.agents ?? []).map((agent) => [agent.id, agent.name])
+    );
+    return this.#items().filter((item) => asked(item) && !this.#mine.has(item.id)).sort((a, b) => a.createdAt - b.createdAt).map((item) => shown(item, names.get(item.agentId)));
+  }
+  #changed() {
+    const items = new Map(this.#items().map((item) => [item.id, item]));
+    const listed = this.#agent();
+    const now = new Set(listed.map((approval) => approval.id));
+    for (const id of this.#listed) {
+      if (now.has(id) || this.#mine.has(id) || this.#deciding.has(id)) continue;
+      const state = items.get(id)?.state;
+      this.emit("ended", { id, reason: state && ENDS[state] || "answered" });
+    }
+    for (const id of this.#mine) {
+      const item = items.get(id);
+      if (!item || !asked(item)) this.#mine.delete(id);
+    }
+    this.#listed = now;
+    this.emit("approvals", this.list());
+  }
+  #route(id, decision, reason) {
+    const host = this.#host;
+    if (host?.list().some((approval) => approval.id === id)) {
+      if (!host.decide) return Promise.reject(new Error(NOT_HERE));
+      return host.decide(id, decision, reason);
+    }
+    if (!this.#ours) return Promise.reject(new Error(NOT_HERE));
+    return this.#decide(id, decision, reason);
+  }
+  async #decide(id, decision, reason) {
+    this.#deciding.add(id);
+    try {
+      const answer = await this.#connection.control.decide(
+        id,
+        decision,
+        reason ?? null,
+        BACKGROUND_CONTEXT
+      );
+      if (!answer.done) throw new Error(answer.error);
+      this.#mine.add(id);
+    } finally {
+      this.#deciding.delete(id);
+    }
+    this.#changed();
+  }
+}
+export {
+  ApprovalsAdapter,
+  NOT_HERE,
+  shown
+};
+//# sourceMappingURL=approvals-port.js.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/spectrum/approvals-port.ts"],
+  "sourcesContent": ["import type {\n  Approval,\n  ApprovalDecision,\n  ApprovalEnd,\n  ApprovalRequester,\n  ApprovalsEvents,\n  ApprovalsPort,\n} from '@ai-ecoverse/slicc-spectrum/ui';\nimport { BACKGROUND_CONTEXT } from '@earendil-works/chord/context';\nimport type { Approval as Item } from '../approvals/record.ts';\nimport type { AgentConnection } from '../client.ts';\nimport { Emitter } from './emitter.ts';\n\nconst ENDS: Record<string, ApprovalEnd> = {\n  approved: 'answered',\n  rejected: 'answered',\n  unanswered: 'expired',\n  withdrawn: 'withdrawn',\n};\n\nfunction requesterOf(item: Item): ApprovalRequester {\n  const { kind, name, agentId, where } = item.requester;\n  return {\n    kind,\n    name,\n    ...(agentId ? { agentId } : {}),\n    ...(where ? { where } : {}),\n  };\n}\n\nexport function shown(item: Item, agentName: string | undefined): Approval {\n  const base = {\n    id: item.id,\n    requester: requesterOf(item),\n    createdAt: item.createdAt,\n    expiresAt: item.expiresAt,\n  };\n  if (item.kind === 'sudo') {\n    const { command, target, cwd, alwaysScope } = item.detail;\n    return {\n      ...base,\n      kind: 'sudo',\n      command,\n      ...(target ? { target } : {}),\n      ...(cwd ? { cwd } : {}),\n      always: item.always,\n      ...(alwaysScope ? { alwaysScope } : {}),\n    };\n  }\n  const guest = {\n    ...base,\n    agentId: item.agentId,\n    ...(agentName ? { agentName } : {}),\n    always: false as const,\n    ...(item.verdict ? { verdict: { ...item.verdict } } : {}),\n  };\n  if (item.kind === 'guest-tool')\n    return { ...guest, kind: 'guest-tool', tool: item.detail.tool, summary: item.detail.summary };\n  return {\n    ...guest,\n    kind: 'guest-message',\n    text: item.detail.text,\n    ...(item.detail.attachments.length\n      ? { attachments: item.detail.attachments.map((file) => ({ ...file })) }\n      : {}),\n  };\n}\n\nexport type HostApprovals = ApprovalsPort;\n\nexport const NOT_HERE = \"This request can't be answered in this tab.\";\n\nconst asked = (item: Item) => item.state === 'pending' && item.tier === 'user';\n\nexport class ApprovalsAdapter extends Emitter<ApprovalsEvents> implements ApprovalsPort {\n  readonly #connection: AgentConnection;\n  readonly #host: HostApprovals | undefined;\n  readonly #ours: boolean;\n  readonly #mine = new Set<string>();\n  readonly #deciding = new Set<string>();\n  #listed = new Set<string>();\n  readonly decide?: (id: string, decision: ApprovalDecision, reason?: string) => Promise<void>;\n\n  constructor(connection: AgentConnection, host?: HostApprovals) {\n    super();\n    this.#connection = connection;\n    this.#host = host;\n    this.#ours = !connection.readOnly && !connection.mismatch;\n    if (this.#ours || host?.decide) this.decide = (...args) => this.#route(...args);\n    this.#listed = new Set(this.#agent().map((approval) => approval.id));\n    connection.approvals?.subscribe(() => this.#changed());\n    host?.on('approvals', () => this.emit('approvals', this.list()));\n    host?.on('ended', (detail) => this.emit('ended', detail));\n  }\n\n  #items(): readonly Item[] {\n    return this.#connection.approvals?.value ?? [];\n  }\n\n  list(): readonly Approval[] {\n    return [...(this.#host?.list() ?? []), ...this.#agent()].sort(\n      (a, b) => a.createdAt - b.createdAt\n    );\n  }\n\n  #agent(): readonly Approval[] {\n    const names = new Map(\n      (this.#connection.agents?.value?.agents ?? []).map((agent) => [agent.id, agent.name])\n    );\n    return this.#items()\n      .filter((item) => asked(item) && !this.#mine.has(item.id))\n      .sort((a, b) => a.createdAt - b.createdAt)\n      .map((item) => shown(item, names.get(item.agentId)));\n  }\n\n  #changed(): void {\n    const items = new Map(this.#items().map((item) => [item.id, item]));\n    const listed = this.#agent();\n    const now = new Set(listed.map((approval) => approval.id));\n    for (const id of this.#listed) {\n      if (now.has(id) || this.#mine.has(id) || this.#deciding.has(id)) continue;\n      const state = items.get(id)?.state;\n      this.emit('ended', { id, reason: (state && ENDS[state]) || 'answered' });\n    }\n    for (const id of this.#mine) {\n      const item = items.get(id);\n      if (!item || !asked(item)) this.#mine.delete(id);\n    }\n    this.#listed = now;\n    this.emit('approvals', this.list());\n  }\n\n  #route(id: string, decision: ApprovalDecision, reason?: string): Promise<void> {\n    const host = this.#host;\n    if (host?.list().some((approval) => approval.id === id)) {\n      if (!host.decide) return Promise.reject(new Error(NOT_HERE));\n      return host.decide(id, decision, reason);\n    }\n    if (!this.#ours) return Promise.reject(new Error(NOT_HERE));\n    return this.#decide(id, decision, reason);\n  }\n\n  async #decide(id: string, decision: ApprovalDecision, reason?: string): Promise<void> {\n    this.#deciding.add(id);\n    try {\n      const answer = await this.#connection.control.decide(\n        id,\n        decision,\n        reason ?? null,\n        BACKGROUND_CONTEXT\n      );\n      if (!answer.done) throw new Error(answer.error);\n      this.#mine.add(id);\n    } finally {\n      this.#deciding.delete(id);\n    }\n    this.#changed();\n  }\n}\n"],
+  "mappings": "AAQA,SAAS,0BAA0B;AAGnC,SAAS,eAAe;AAExB,MAAM,OAAoC;AAAA,EACxC,UAAU;AAAA,EACV,UAAU;AAAA,EACV,YAAY;AAAA,EACZ,WAAW;AACb;AAEA,SAAS,YAAY,MAA+B;AAClD,QAAM,EAAE,MAAM,MAAM,SAAS,MAAM,IAAI,KAAK;AAC5C,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA,GAAI,UAAU,EAAE,QAAQ,IAAI,CAAC;AAAA,IAC7B,GAAI,QAAQ,EAAE,MAAM,IAAI,CAAC;AAAA,EAC3B;AACF;AAEO,SAAS,MAAM,MAAY,WAAyC;AACzE,QAAM,OAAO;AAAA,IACX,IAAI,KAAK;AAAA,IACT,WAAW,YAAY,IAAI;AAAA,IAC3B,WAAW,KAAK;AAAA,IAChB,WAAW,KAAK;AAAA,EAClB;AACA,MAAI,KAAK,SAAS,QAAQ;AACxB,UAAM,EAAE,SAAS,QAAQ,KAAK,YAAY,IAAI,KAAK;AACnD,WAAO;AAAA,MACL,GAAG;AAAA,MACH,MAAM;AAAA,MACN;AAAA,MACA,GAAI,SAAS,EAAE,OAAO,IAAI,CAAC;AAAA,MAC3B,GAAI,MAAM,EAAE,IAAI,IAAI,CAAC;AAAA,MACrB,QAAQ,KAAK;AAAA,MACb,GAAI,cAAc,EAAE,YAAY,IAAI,CAAC;AAAA,IACvC;AAAA,EACF;AACA,QAAM,QAAQ;AAAA,IACZ,GAAG;AAAA,IACH,SAAS,KAAK;AAAA,IACd,GAAI,YAAY,EAAE,UAAU,IAAI,CAAC;AAAA,IACjC,QAAQ;AAAA,IACR,GAAI,KAAK,UAAU,EAAE,SAAS,EAAE,GAAG,KAAK,QAAQ,EAAE,IAAI,CAAC;AAAA,EACzD;AACA,MAAI,KAAK,SAAS;AAChB,WAAO,EAAE,GAAG,OAAO,MAAM,cAAc,MAAM,KAAK,OAAO,MAAM,SAAS,KAAK,OAAO,QAAQ;AAC9F,SAAO;AAAA,IACL,GAAG;AAAA,IACH,MAAM;AAAA,IACN,MAAM,KAAK,OAAO;AAAA,IAClB,GAAI,KAAK,OAAO,YAAY,SACxB,EAAE,aAAa,KAAK,OAAO,YAAY,IAAI,CAAC,UAAU,EAAE,GAAG,KAAK,EAAE,EAAE,IACpE,CAAC;AAAA,EACP;AACF;AAIO,MAAM,WAAW;AAExB,MAAM,QAAQ,CAAC,SAAe,KAAK,UAAU,aAAa,KAAK,SAAS;AAEjE,MAAM,yBAAyB,QAAkD;AAAA,EAC7E;AAAA,EACA;AAAA,EACA;AAAA,EACA,QAAQ,oBAAI,IAAY;AAAA,EACxB,YAAY,oBAAI,IAAY;AAAA,EACrC,UAAU,oBAAI,IAAY;AAAA,EACjB;AAAA,EAET,YAAY,YAA6B,MAAsB;AAC7D,UAAM;AACN,SAAK,cAAc;AACnB,SAAK,QAAQ;AACb,SAAK,QAAQ,CAAC,WAAW,YAAY,CAAC,WAAW;AACjD,QAAI,KAAK,SAAS,MAAM,OAAQ,MAAK,SAAS,IAAI,SAAS,KAAK,OAAO,GAAG,IAAI;AAC9E,SAAK,UAAU,IAAI,IAAI,KAAK,OAAO,EAAE,IAAI,CAAC,aAAa,SAAS,EAAE,CAAC;AACnE,eAAW,WAAW,UAAU,MAAM,KAAK,SAAS,CAAC;AACrD,UAAM,GAAG,aAAa,MAAM,KAAK,KAAK,aAAa,KAAK,KAAK,CAAC,CAAC;AAC/D,UAAM,GAAG,SAAS,CAAC,WAAW,KAAK,KAAK,SAAS,MAAM,CAAC;AAAA,EAC1D;AAAA,EAEA,SAA0B;AACxB,WAAO,KAAK,YAAY,WAAW,SAAS,CAAC;AAAA,EAC/C;AAAA,EAEA,OAA4B;AAC1B,WAAO,CAAC,GAAI,KAAK,OAAO,KAAK,KAAK,CAAC,GAAI,GAAG,KAAK,OAAO,CAAC,EAAE;AAAA,MACvD,CAAC,GAAG,MAAM,EAAE,YAAY,EAAE;AAAA,IAC5B;AAAA,EACF;AAAA,EAEA,SAA8B;AAC5B,UAAM,QAAQ,IAAI;AAAA,OACf,KAAK,YAAY,QAAQ,OAAO,UAAU,CAAC,GAAG,IAAI,CAAC,UAAU,CAAC,MAAM,IAAI,MAAM,IAAI,CAAC;AAAA,IACtF;AACA,WAAO,KAAK,OAAO,EAChB,OAAO,CAAC,SAAS,MAAM,IAAI,KAAK,CAAC,KAAK,MAAM,IAAI,KAAK,EAAE,CAAC,EACxD,KAAK,CAAC,GAAG,MAAM,EAAE,YAAY,EAAE,SAAS,EACxC,IAAI,CAAC,SAAS,MAAM,MAAM,MAAM,IAAI,KAAK,OAAO,CAAC,CAAC;AAAA,EACvD;AAAA,EAEA,WAAiB;AACf,UAAM,QAAQ,IAAI,IAAI,KAAK,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,IAAI,IAAI,CAAC,CAAC;AAClE,UAAM,SAAS,KAAK,OAAO;AAC3B,UAAM,MAAM,IAAI,IAAI,OAAO,IAAI,CAAC,aAAa,SAAS,EAAE,CAAC;AACzD,eAAW,MAAM,KAAK,SAAS;AAC7B,UAAI,IAAI,IAAI,EAAE,KAAK,KAAK,MAAM,IAAI,EAAE,KAAK,KAAK,UAAU,IAAI,EAAE,EAAG;AACjE,YAAM,QAAQ,MAAM,IAAI,EAAE,GAAG;AAC7B,WAAK,KAAK,SAAS,EAAE,IAAI,QAAS,SAAS,KAAK,KAAK,KAAM,WAAW,CAAC;AAAA,IACzE;AACA,eAAW,MAAM,KAAK,OAAO;AAC3B,YAAM,OAAO,MAAM,IAAI,EAAE;AACzB,UAAI,CAAC,QAAQ,CAAC,MAAM,IAAI,EAAG,MAAK,MAAM,OAAO,EAAE;AAAA,IACjD;AACA,SAAK,UAAU;AACf,SAAK,KAAK,aAAa,KAAK,KAAK,CAAC;AAAA,EACpC;AAAA,EAEA,OAAO,IAAY,UAA4B,QAAgC;AAC7E,UAAM,OAAO,KAAK;AAClB,QAAI,MAAM,KAAK,EAAE,KAAK,CAAC,aAAa,SAAS,OAAO,EAAE,GAAG;AACvD,UAAI,CAAC,KAAK,OAAQ,QAAO,QAAQ,OAAO,IAAI,MAAM,QAAQ,CAAC;AAC3D,aAAO,KAAK,OAAO,IAAI,UAAU,MAAM;AAAA,IACzC;AACA,QAAI,CAAC,KAAK,MAAO,QAAO,QAAQ,OAAO,IAAI,MAAM,QAAQ,CAAC;AAC1D,WAAO,KAAK,QAAQ,IAAI,UAAU,MAAM;AAAA,EAC1C;AAAA,EAEA,MAAM,QAAQ,IAAY,UAA4B,QAAgC;AACpF,SAAK,UAAU,IAAI,EAAE;AACrB,QAAI;AACF,YAAM,SAAS,MAAM,KAAK,YAAY,QAAQ;AAAA,QAC5C;AAAA,QACA;AAAA,QACA,UAAU;AAAA,QACV;AAAA,MACF;AACA,UAAI,CAAC,OAAO,KAAM,OAAM,IAAI,MAAM,OAAO,KAAK;AAC9C,WAAK,MAAM,IAAI,EAAE;AAAA,IACnB,UAAE;AACA,WAAK,UAAU,OAAO,EAAE;AAAA,IAC1B;AACA,SAAK,SAAS;AAAA,EAChB;AACF;",
+  "names": []
+}

package/dist/spectrum/index.js

@@ -1,4 +1,5 @@
 import { AgentAdapter } from "./agent-port.js";
+import { ApprovalsAdapter } from "./approvals-port.js";
 import { ChangesAdapter } from "./changes-port.js";
 import { MemoryAdapter } from "./memory-port.js";
 import { MonitorAdapter } from "./monitor-port.js";
@@ -8,6 +9,11 @@ import { SettingsAdapter } from "./settings-port.js";
 import { SprinkleAdapter } from "./sprinkle-port.js";
 import { TrayAdapter } from "./tray-port.js";
 import { AgentAdapter as AgentAdapter2, CONE } from "./agent-port.js";
+import {
+  ApprovalsAdapter as ApprovalsAdapter2,
+  NOT_HERE,
+  shown
+} from "./approvals-port.js";
 import { ChangesAdapter as ChangesAdapter2 } from "./changes-port.js";
 import { MemoryAdapter as MemoryAdapter2 } from "./memory-port.js";
 import {
@@ -43,6 +49,7 @@ function createAgentModel(connection, options = {}) {
   const run = options.page?.run;
   return {
     agent,
+    approvals: new ApprovalsAdapter(connection, options.approvals),
     page: options.page && run ? new PageAdapter(connection, agent, { ...options.page, run }) : null,
     settings: new SettingsAdapter(
       connection.settings,
@@ -63,12 +70,14 @@ function createAgentModel(connection, options = {}) {
 }
 export {
   AgentAdapter2 as AgentAdapter,
+  ApprovalsAdapter2 as ApprovalsAdapter,
   CONE,
   ChangesAdapter2 as ChangesAdapter,
   KEYS_MOVED,
   MISMATCH,
   MemoryAdapter2 as MemoryAdapter,
   MonitorAdapter2 as MonitorAdapter,
+  NOT_HERE,
   NoticesAdapter2 as NoticesAdapter,
   PageAdapter2 as PageAdapter,
   SETTINGS_KEY,
@@ -85,6 +94,7 @@ export {
   movedList,
   movedNotice,
   queued,
+  shown as shownApproval,
   textOf,
   toMessages
 };

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 HostNotices, NoticesAdapter } from './notices-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  type HostNotices,\n  KEYS_MOVED,\n  MISMATCH,\n  mismatchBanner,\n  movedList,\n  movedNotice,\n  NoticesAdapter,\n} from './notices-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    notices?: HostNotices;\n  } = {}\n): {\n  agent: AgentAdapter;\n  settings: SettingsAdapter;\n  tray: TrayAdapter;\n  sprinkles: SprinkleAdapter;\n  memory: MemoryAdapter;\n  changes: ChangesAdapter;\n  monitor: MonitorAdapter;\n  notices: NoticesAdapter;\n  page: PageAdapter | null;\n} {\n  const agent = new AgentAdapter(connection);\n  const report = (text: string) => agent.notify(text);\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, report),\n    memory: new MemoryAdapter(connection, report),\n    changes: new ChangesAdapter(connection, report),\n    notices: new NoticesAdapter(connection.settings, report, connection.mismatch, options.notices),\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,SAA2B,sBAAsB;AACjD,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,EAEE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA,kBAAAC;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,UAMI,CAAC,GAWL;AACA,QAAM,QAAQ,IAAI,aAAa,UAAU;AACzC,QAAM,SAAS,CAAC,SAAiB,MAAM,OAAO,IAAI;AAClD,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,YAAY,MAAM;AAAA,IACjD,QAAQ,IAAI,cAAc,YAAY,MAAM;AAAA,IAC5C,SAAS,IAAI,eAAe,YAAY,MAAM;AAAA,IAC9C,SAAS,IAAI,eAAe,WAAW,UAAU,QAAQ,WAAW,UAAU,QAAQ,OAAO;AAAA,IAC7F,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", "NoticesAdapter", "PageAdapter", "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 { ApprovalsAdapter, type HostApprovals } from './approvals-port.ts';\nimport { ChangesAdapter } from './changes-port.ts';\nimport { MemoryAdapter } from './memory-port.ts';\nimport { MonitorAdapter } from './monitor-port.ts';\nimport { type HostNotices, NoticesAdapter } from './notices-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 {\n  ApprovalsAdapter,\n  type HostApprovals,\n  NOT_HERE,\n  shown as shownApproval,\n} from './approvals-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  type HostNotices,\n  KEYS_MOVED,\n  MISMATCH,\n  mismatchBanner,\n  movedList,\n  movedNotice,\n  NoticesAdapter,\n} from './notices-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    approvals?: HostApprovals;\n    notices?: HostNotices;\n  } = {}\n): {\n  agent: AgentAdapter;\n  approvals: ApprovalsAdapter;\n  settings: SettingsAdapter;\n  tray: TrayAdapter;\n  sprinkles: SprinkleAdapter;\n  memory: MemoryAdapter;\n  changes: ChangesAdapter;\n  monitor: MonitorAdapter;\n  notices: NoticesAdapter;\n  page: PageAdapter | null;\n} {\n  const agent = new AgentAdapter(connection);\n  const report = (text: string) => agent.notify(text);\n  const run = options.page?.run;\n  return {\n    agent,\n    approvals: new ApprovalsAdapter(connection, options.approvals),\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, report),\n    memory: new MemoryAdapter(connection, report),\n    changes: new ChangesAdapter(connection, report),\n    notices: new NoticesAdapter(connection.settings, report, connection.mismatch, options.notices),\n    monitor: new MonitorAdapter(\n      connection,\n      options.monitor?.extra ? { extra: options.monitor.extra } : {}\n    ),\n  };\n}\n"],
+  "mappings": "AAEA,SAAS,oBAAoB;AAC7B,SAAS,wBAA4C;AACrD,SAAS,sBAAsB;AAC/B,SAAS,qBAAqB;AAC9B,SAAS,sBAAsB;AAC/B,SAA2B,sBAAsB;AACjD,SAAS,mBAAqC;AAC9C,SAAqB,uBAAuB;AAC5C,SAAS,uBAAuB;AAChC,SAAS,mBAAmB;AAE5B,SAAS,gBAAAA,eAAc,YAAY;AACnC;AAAA,EACE,oBAAAC;AAAA,EAEA;AAAA,EACS;AAAA,OACJ;AACP,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,EAEE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA,kBAAAC;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,UAOI,CAAC,GAYL;AACA,QAAM,QAAQ,IAAI,aAAa,UAAU;AACzC,QAAM,SAAS,CAAC,SAAiB,MAAM,OAAO,IAAI;AAClD,QAAM,MAAM,QAAQ,MAAM;AAC1B,SAAO;AAAA,IACL;AAAA,IACA,WAAW,IAAI,iBAAiB,YAAY,QAAQ,SAAS;AAAA,IAC7D,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,YAAY,MAAM;AAAA,IACjD,QAAQ,IAAI,cAAc,YAAY,MAAM;AAAA,IAC5C,SAAS,IAAI,eAAe,YAAY,MAAM;AAAA,IAC9C,SAAS,IAAI,eAAe,WAAW,UAAU,QAAQ,WAAW,UAAU,QAAQ,OAAO;AAAA,IAC7F,SAAS,IAAI;AAAA,MACX;AAAA,MACA,QAAQ,SAAS,QAAQ,EAAE,OAAO,QAAQ,QAAQ,MAAM,IAAI,CAAC;AAAA,IAC/D;AAAA,EACF;AACF;",
+  "names": ["AgentAdapter", "ApprovalsAdapter", "ChangesAdapter", "MemoryAdapter", "MonitorAdapter", "NoticesAdapter", "PageAdapter", "SettingsAdapter", "SprinkleAdapter", "TrayAdapter"]
 }

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

@@ -0,0 +1,28 @@
+import { type Context, type ReplicatedState } from '@earendil-works/chord';
+import type { Harness } from '@earendil-works/pi-durable';
+import { type Approval, type ApprovalDraft, type ApprovalState, type DecidedBy } from './record.ts';
+export * from './record.ts';
+export type ApprovalDecided = {
+    done: true;
+    state: ApprovalState;
+    error: null;
+} | {
+    done: false;
+    state: null;
+    error: string;
+};
+export interface Approvals {
+    readonly state: ReplicatedState<Approval[]>;
+    request(draft: ApprovalDraft, context: Context): Promise<Approval>;
+    decide(id: string, answer: unknown, reason: string | null, by: DecidedBy, context: Context): Promise<ApprovalDecided>;
+    settled(id: string, context: Context): Promise<Approval>;
+    withdraw(id: string, reason: string | null, context: Context): Promise<Approval | undefined>;
+    withdrawSeat(seat: string, context: Context): Promise<number>;
+    close(): void;
+}
+export interface ApprovalsAttach {
+    harness: Pick<Harness, 'commit'>;
+    now?: () => number;
+    ttlMs?: number;
+}
+export declare function attachApprovals(options: ApprovalsAttach, context?: Context): Promise<Approvals>;

package/dist/types/approvals/record.d.ts

@@ -0,0 +1,108 @@
+export type ApprovalKind = 'guest-message' | 'guest-tool' | 'sudo';
+export type ApprovalState = 'pending' | 'approved' | 'rejected' | 'unanswered' | 'withdrawn';
+export type ApprovalTier = 'user' | 'agent' | 'cone' | `scoop:${string}`;
+export type ApprovalAnswer = 'once' | 'always' | 'deny';
+export type DecidedBy = 'owner' | 'follower' | 'judge' | 'host';
+export type ApprovalRequester = {
+    kind: 'guest' | 'agent' | 'user';
+    name: string;
+    seat?: string;
+    agentId?: string;
+    where?: string;
+};
+export type ApprovalVerdict = {
+    decision: 'allow' | 'deny';
+    reason: string;
+};
+export type ApprovalAttachment = {
+    name: string;
+    mimeType: string;
+    size: number;
+};
+export type GuestMessageDetail = {
+    text: string;
+    attachments: ApprovalAttachment[];
+};
+export type GuestToolDetail = {
+    tool: string;
+    summary: string;
+};
+export type SudoDetail = {
+    command: string;
+    target?: string;
+    cwd?: string;
+    alwaysScope?: 'cwd';
+};
+type Base = {
+    id: string;
+    seat?: string;
+    agentId: string;
+    requester: ApprovalRequester;
+    tier: string;
+    state: ApprovalState;
+    decidedBy: DecidedBy | null;
+    answer?: 'once' | 'always';
+    reason?: string;
+    verdict?: ApprovalVerdict;
+    always: boolean;
+    createdAt: number;
+    expiresAt: number;
+    decidedAt?: number;
+};
+export type GuestMessageApproval = Base & {
+    kind: 'guest-message';
+    detail: GuestMessageDetail;
+};
+export type GuestToolApproval = Base & {
+    kind: 'guest-tool';
+    detail: GuestToolDetail;
+};
+export type SudoApproval = Base & {
+    kind: 'sudo';
+    detail: SudoDetail;
+};
+export type Approval = GuestMessageApproval | GuestToolApproval | SudoApproval;
+type DraftOf<T extends Approval> = Pick<T, 'kind' | 'detail' | 'agentId' | 'requester'> & {
+    seat?: string;
+    tier: string;
+    always?: boolean;
+    expiresAt?: number;
+};
+export type ApprovalDraft = DraftOf<GuestMessageApproval> | DraftOf<GuestToolApproval> | DraftOf<SudoApproval>;
+export type ApprovalsState = {
+    items: Approval[];
+};
+export declare const ApprovalsDoc: import("@earendil-works/pi-durable").SessionDocToken<ApprovalsState>;
+export declare const APPROVAL_MS = 300000;
+export declare const APPROVALS_KEPT = 100;
+export declare const MAX_DELAY = 2147483647;
+export declare const REASON_LENGTH = 500;
+export declare const REASONS: {
+    readonly timeout: 'timeout';
+    readonly unknownTier: 'unknown-tier';
+    readonly unroutable: 'unroutable';
+    readonly unknownAnswer: 'unknown-answer';
+    readonly restart: 'restart';
+    readonly revoked: 'revoked';
+};
+export declare const guestKind: (kind: ApprovalKind) => boolean;
+export declare function knownTier(tier: unknown): tier is ApprovalTier;
+export declare function routable(kind: ApprovalKind, tier: ApprovalTier): boolean;
+export declare function answerOf(value: unknown): ApprovalAnswer | null;
+export declare const personal: (by: DecidedBy) => boolean;
+export declare function answerer(by: DecidedBy, tier: string): boolean;
+export declare function gone(state: ApprovalState): string;
+export declare function cleanReason(reason: unknown): string | undefined;
+export declare function prune(items: Approval[], kept?: number): Approval[];
+export type Settle = {
+    state: Exclude<ApprovalState, 'pending'>;
+    by: DecidedBy;
+    reason?: string;
+};
+export type Ruling = {
+    error?: string;
+    settle?: Settle;
+    answer?: 'once' | 'always';
+};
+export declare function ruled(item: Approval, answer: unknown, reason: unknown, by: DecidedBy, at: number): Ruling;
+export {};

package/dist/types/client.d.ts

@@ -1,5 +1,6 @@
 import { type Context, type ReplicatedState } from '@earendil-works/chord';
 import type { ConversationView } from '@earendil-works/pi-durable';
+import type { Approval } from './approvals/record.ts';
 import type { ChangesView } from './changes/git.ts';
 import type { FrozenCone } from './freezer/index.ts';
 import type { MemoryEntry, MemoryScope } from './memory/format.ts';
@@ -26,11 +27,13 @@ export interface AgentConnection {
     readonly monitor?: ReplicatedState<MonitorFeed>;
     readonly vault?: ReplicatedState<VaultState>;
     readonly labels?: ReplicatedState<Record<string, string>>;
+    readonly approvals?: ReplicatedState<Approval[]>;
     readonly settings: AgentSettings;
     readonly remote?: AgentRemote;
     readonly pages?: AgentPages;
     readonly closed: Promise<Error | undefined>;
     readonly mismatch?: string;
+    readonly readOnly?: boolean;
     prompt(text: string, whenBusy?: SendMode): Promise<string>;
     webhook(name: string, delivery: {
         id?: string | null;

package/dist/types/host.d.ts

@@ -1,5 +1,6 @@
 import { type Context, type Host, type ReplicatedState } from '@earendil-works/chord';
 import type { Agent } from './agent.ts';
+import { type Approvals, type DecidedBy } from './approvals/index.ts';
 import type { ChangesRuntime } from './changes/index.ts';
 import { type HostLicks, type HostScoops } from './control.ts';
 import type { FreezerRuntime } from './freezer/index.ts';
@@ -27,6 +28,7 @@ export interface AgentHost {
     readonly agent: Agent;
     readonly users?: UserClients;
     readonly pages: Pages;
+    readonly approvals: Approvals;
     connect(endpoint: PortEndpoint, options?: ConnectOptions): void;
     close(): Promise<void>;
 }
@@ -54,6 +56,7 @@ export declare function hostAgent(agent: Agent, options?: {
     uploads?: Uploads;
     thumbnail?: Thumbnail;
     labels?: LabelsRuntime;
+    approvals?: Approvals;
 }): Promise<AgentHost>;
 interface Served {
     trusted: AgentControl;
@@ -63,6 +66,7 @@ interface Served {
     settings: AgentSettings;
     remote: AgentRemote;
     pages: Pages;
+    decide: (by: DecidedBy) => AgentControl['decide'];
 }
 export declare function serveAgent(serving: Served): Host;
 export {};

package/dist/types/index.d.ts

@@ -1,5 +1,6 @@
 export { ADOBE, ADOBE_PROXY, type AdobeConfig, type AdobeModelInfo, adobeClassifiers, adobeConfig, adobeIdentity, adobeModel, adobeProvider, adobeUsage, type Budget, SESSION_HEADER, VERSION_HEADER, withAdobeIdentity, } from './adobe.ts';
 export { type Agent, type AgentOptions, answerText, openAgent } from './agent.ts';
+export { APPROVAL_MS, type Approval, type ApprovalAnswer, type ApprovalDecided, type ApprovalDraft, type ApprovalKind, type ApprovalRequester, type ApprovalState, type Approvals, ApprovalsDoc, type ApprovalTier, type ApprovalVerdict, attachApprovals, type DecidedBy, REASONS, } from './approvals/index.ts';
 export { FILE_LIMIT, IMAGE_LIMIT, type SendAttachment, type ShownAttachment, splitUser, TOTAL_LIMIT, userParts, } from './attachments.ts';
 export { type AgentConnection, connectAgent } from './client.ts';
 export { createAgentControl } from './control.ts';

package/dist/types/services.d.ts

@@ -1,5 +1,6 @@
 import type { Context, JsonValue, RemoteContract, ReplicatedState } from '@earendil-works/chord';
 import type { ConversationView } from '@earendil-works/pi-durable';
+import type { Approval, ApprovalAnswer, ApprovalDecided } from './approvals/index.ts';
 import type { SendAttachment, ShownAttachment } from './attachments.ts';
 import type { ChangesView } from './changes/git.ts';
 import type { FrozenCone } from './freezer/index.ts';
@@ -87,6 +88,7 @@ export interface AgentControl {
     image(ref: ImageRef, context: Context): Promise<StoredImage>;
     agentCommands(agentId: string, context: Context): Promise<Command[]>;
     toolLabel(agentId: string, callIds: string[], context: Context): Promise<string | null>;
+    decide(id: string, decision: ApprovalAnswer, reason: string | null, context: Context): Promise<ApprovalDecided>;
 }
 export interface ImageRef {
     entry: number;
@@ -231,7 +233,7 @@ export interface AgentSettingsChange {
     thinkingLevel: 'off' | 'minimal' | 'low' | 'medium' | 'high' | 'xhigh' | 'max' | null;
     agentId?: string | null;
 }
-export declare const CONTROL_METHODS: ("abort" | "agentCommands" | "changeAccept" | "changeRevert" | "changesOpen" | "compact" | "compactAgent" | "configure" | "createCone" | "createScoop" | "discard" | "drop" | "freeze" | "image" | "memoryRemove" | "memorySave" | "monitorClose" | "monitorOpen" | "newChat" | "reset" | "resolveAgentLick" | "resolveLick" | "rewind" | "rewindAgent" | "selectCone" | "send" | "sprinkleCall" | "sprinkleSend" | "stopAgent" | "thaw" | "toolLabel" | "unqueue" | "wait" | "webhook" | "withdraw")[];
+export declare const CONTROL_METHODS: ("abort" | "agentCommands" | "changeAccept" | "changeRevert" | "changesOpen" | "compact" | "compactAgent" | "configure" | "createCone" | "createScoop" | "decide" | "discard" | "drop" | "freeze" | "image" | "memoryRemove" | "memorySave" | "monitorClose" | "monitorOpen" | "newChat" | "reset" | "resolveAgentLick" | "resolveLick" | "rewind" | "rewindAgent" | "selectCone" | "send" | "sprinkleCall" | "sprinkleSend" | "stopAgent" | "thaw" | "toolLabel" | "unqueue" | "wait" | "webhook" | "withdraw")[];
 export declare const CONTROL_READS: readonly (keyof AgentControl & string)[];
 export declare const AgentControl: RemoteContract;
 export type Delivered = 'run' | 'steer' | 'follow-up';
@@ -250,6 +252,7 @@ export interface AgentTranscript {
     readonly monitor: ReplicatedState<MonitorFeed>;
     readonly vault: ReplicatedState<VaultState>;
     readonly labels: ReplicatedState<Record<string, string>>;
+    readonly approvals: ReplicatedState<Approval[]>;
 }
 export interface PrivateRevision {
     revision: number;
@@ -259,7 +262,7 @@ export interface Command {
     description: string;
     kind: 'prompt' | 'skill' | 'action';
 }
-export declare const TRANSCRIPT_STATES: ("agents" | "changes" | "commands" | "deliveries" | "frozen" | "labels" | "memories" | "memoryScopes" | "monitor" | "privateRevision" | "sprinkles" | "state" | "vault" | "views")[];
+export declare const TRANSCRIPT_STATES: ("agents" | "approvals" | "changes" | "commands" | "deliveries" | "frozen" | "labels" | "memories" | "memoryScopes" | "monitor" | "privateRevision" | "sprinkles" | "state" | "vault" | "views")[];
 export declare const AgentTranscript: RemoteContract;
 export declare const REMOTE_METHODS: ("abort" | "close" | "next" | "prompt" | "watch")[];
 export declare const REMOTE_READS: readonly (keyof AgentRemote & string)[];

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

@@ -0,0 +1,13 @@
+import type { Approval, ApprovalDecision, ApprovalsEvents, ApprovalsPort } from '@ai-ecoverse/slicc-spectrum/ui';
+import type { Approval as Item } from '../approvals/record.ts';
+import type { AgentConnection } from '../client.ts';
+import { Emitter } from './emitter.ts';
+export declare function shown(item: Item, agentName: string | undefined): Approval;
+export type HostApprovals = ApprovalsPort;
+export declare const NOT_HERE = "This request can't be answered in this tab.";
+export declare class ApprovalsAdapter extends Emitter<ApprovalsEvents> implements ApprovalsPort {
+    #private;
+    readonly decide?: (id: string, decision: ApprovalDecision, reason?: string) => Promise<void>;
+    constructor(connection: AgentConnection, host?: HostApprovals);
+    list(): readonly Approval[];
+}

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

@@ -1,6 +1,7 @@
 import type { MonitorSection } from '@ai-ecoverse/slicc-spectrum/ui';
 import type { AgentConnection } from '../client.ts';
 import { AgentAdapter } from './agent-port.ts';
+import { ApprovalsAdapter, type HostApprovals } from './approvals-port.ts';
 import { ChangesAdapter } from './changes-port.ts';
 import { MemoryAdapter } from './memory-port.ts';
 import { MonitorAdapter } from './monitor-port.ts';
@@ -10,6 +11,7 @@ import { type Login, SettingsAdapter } from './settings-port.ts';
 import { SprinkleAdapter } from './sprinkle-port.ts';
 import { TrayAdapter } from './tray-port.ts';
 export { AgentAdapter, CONE } from './agent-port.ts';
+export { ApprovalsAdapter, type HostApprovals, NOT_HERE, shown as shownApproval, } from './approvals-port.ts';
 export { ChangesAdapter, type ChangesEvents } from './changes-port.ts';
 export { MemoryAdapter } from './memory-port.ts';
 export { assistant, errorAction, errorPart, isBusy, queued, textOf, toMessages, } from './messages.ts';
@@ -26,9 +28,11 @@ export declare function createAgentModel(connection: AgentConnection, options?:
         extra?: () => readonly MonitorSection[];
     };
     page?: PageOptions;
+    approvals?: HostApprovals;
     notices?: HostNotices;
 }): {
     agent: AgentAdapter;
+    approvals: ApprovalsAdapter;
     settings: SettingsAdapter;
     tray: TrayAdapter;
     sprinkles: SprinkleAdapter;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ai-ecoverse/slicc-agent",
-  "version": "5.0.3",
+  "version": "5.1.0",
   "description": "SLICC's agent core on pi durable: an agent worker, session storage, remoting and pi extensions",
   "type": "module",
   "license": "Apache-2.0",
@@ -64,7 +64,7 @@
     "@ai-ecoverse/slicc-kernel": "1.94.0",
     "@ai-ecoverse/slicc-scrub": "1.0.0",
     "@ai-ecoverse/slicc-shared-web": "1.20.0",
-    "@ai-ecoverse/slicc-spectrum": "1.77.1",
+    "@ai-ecoverse/slicc-spectrum": "1.79.0",
     "@ai-ecoverse/wasm-bash": "5.3.0-18",
     "@ai-ecoverse/wasm-coreutils": "9.12.0-6",
     "@ai-ecoverse/wasm-git": "2.55.0-15",
@@ -92,7 +92,7 @@
   },
   "peerDependencies": {
     "@ai-ecoverse/slicc-kernel": ">=1.90.0 <2",
-    "@ai-ecoverse/slicc-spectrum": "^1.75.0"
+    "@ai-ecoverse/slicc-spectrum": "^1.78.0"
   },
   "peerDependenciesMeta": {
     "@ai-ecoverse/slicc-spectrum": {