@ai-ecoverse/slicc-agent 3.40.1 → 3.42.0

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

@@ -24,6 +24,7 @@ type Wait = {
 export type Answer = {
     code: number;
     out: string;
+    err?: string;
     tasks?: number[];
 };
 type WorkState = {

package/dist/types/services.d.ts

@@ -4,6 +4,7 @@ import type { ChangesView } from './changes/git.ts';
 import type { FrozenCone } from './freezer/index.ts';
 import type { MemoryEntry, MemoryScope, MemoryTag } from './memory/format.ts';
 import type { AgentRemote } from './remote/host.ts';
+import type { AgentPages } from './remote/pages.ts';
 import type { Sprinkle } from './sprinkles/kind.ts';
 export type SendMode = 'steer' | 'followUp' | 'reject';
 export interface SendRequest {
@@ -234,6 +235,7 @@ export interface AgentSessions {
 }
 export declare const AgentSessions: import("@earendil-works/chord").Service<AgentSessions>;
 export declare const AgentRemoteService: import("@earendil-works/chord").Service<AgentRemote>;
+export declare const AgentPagesService: import("@earendil-works/chord").Service<AgentPages>;
 export declare const AGENT_SESSION = "agent";
 export interface ModelChoice {
     id: string;

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

@@ -4,6 +4,7 @@ import { AgentAdapter } from './agent-port.ts';
 import { ChangesAdapter } from './changes-port.ts';
 import { MemoryAdapter } from './memory-port.ts';
 import { MonitorAdapter } from './monitor-port.ts';
+import { PageAdapter, type PageOptions } from './page-port.ts';
 import { type Login, SettingsAdapter } from './settings-port.ts';
 import { SprinkleAdapter } from './sprinkle-port.ts';
 import { TrayAdapter } from './tray-port.ts';
@@ -12,6 +13,7 @@ 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';
 export { MonitorAdapter, type MonitorAdapterOptions, type MonitorInput, monitorSnapshot, } from './monitor-port.ts';
+export { PageAdapter, type PageDocument, type PageOptions, type PageRun, type PageTarget, } from './page-port.ts';
 export { type Login, SETTINGS_KEY, SettingsAdapter } from './settings-port.ts';
 export { SprinkleAdapter } from './sprinkle-port.ts';
 export { TrayAdapter } from './tray-port.ts';
@@ -21,6 +23,7 @@ export declare function createAgentModel(connection: AgentConnection, options?:
     monitor?: {
         extra?: () => readonly MonitorSection[];
     };
+    page?: PageOptions;
 }): {
     agent: AgentAdapter;
     settings: SettingsAdapter;
@@ -29,4 +32,5 @@ export declare function createAgentModel(connection: AgentConnection, options?:
     memory: MemoryAdapter;
     changes: ChangesAdapter;
     monitor: MonitorAdapter;
+    page: PageAdapter | null;
 };

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

@@ -0,0 +1,32 @@
+import type { AgentConnection } from '../client.ts';
+import type { PageCaller, PageResult, PageTab } from '../remote/pages.ts';
+import type { AgentAdapter } from './agent-port.ts';
+export declare const REPORT_MS = 250;
+export declare const POLL_MS = 10000;
+export type PageRun = (argv: readonly string[], caller: PageCaller) => PageResult | Promise<PageResult>;
+export interface PageTarget {
+    addEventListener(type: string, listener: () => void, options?: boolean): void;
+    removeEventListener(type: string, listener: () => void, options?: boolean): void;
+}
+export interface PageDocument extends PageTarget {
+    readonly visibilityState: string;
+    hasFocus(): boolean;
+}
+export interface PageOptions {
+    tab: string;
+    run?: PageRun;
+    document?: PageDocument;
+    window?: PageTarget;
+    now?: () => number;
+    reportMs?: number;
+    pollMs?: number;
+}
+export declare class PageAdapter {
+    #private;
+    readonly done: Promise<void>;
+    constructor(connection: AgentConnection, agent: AgentAdapter, options: PageOptions & {
+        run: PageRun;
+    });
+    state(): PageTab;
+    dispose(): Promise<void>;
+}

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

@@ -33,7 +33,7 @@ export interface SprinklesAttach {
     dir?: string;
     intercept?: (id: string, payload: SprinklePayload, context: Context) => Promise<boolean>;
 }
-export declare 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";
+export declare 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";
 export declare function ownerOf(agents: Agents, owner: string | undefined): string;
 export declare function setupSprinkles(): {
     attach(options: SprinklesAttach, context: Context): Promise<SprinklesRuntime>;

package/dist/worker.js

@@ -3,8 +3,9 @@ function serveConnections(scope, host) {
     const message = data;
     const port = message?.connect;
     if (!port) return;
+    const pages = message?.pages === false ? { pages: false } : {};
     host.then(
-      (ready) => ready.connect(port, { readOnly: message?.readOnly === true }),
+      (ready) => ready.connect(port, { readOnly: message?.readOnly === true, ...pages }),
       () => port.close?.()
     );
   });

package/dist/worker.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../src/worker.ts"],
-  "sourcesContent": ["import type { AgentHost } from './host.ts';\nimport type { PortEndpoint } from './wire.ts';\n\nexport interface WorkerScope {\n  addEventListener(type: 'message', listener: (event: MessageEvent) => void): void;\n}\n\nexport function serveConnections(scope: WorkerScope, host: Promise<AgentHost>): void {\n  scope.addEventListener('message', ({ data }) => {\n    const message = data as { connect?: PortEndpoint; readOnly?: boolean } | null;\n    const port = message?.connect;\n    if (!port) return;\n    host.then(\n      (ready) => ready.connect(port, { readOnly: message?.readOnly === true }),\n      () => port.close?.()\n    );\n  });\n}\n\nexport interface KernelPorts {\n  kernel: MessagePort;\n  admin?: MessagePort;\n}\n\nexport function kernelPorts(scope: WorkerScope): Promise<KernelPorts> {\n  return new Promise((resolve) => {\n    scope.addEventListener('message', ({ data }) => {\n      const message = data as { kernel?: MessagePort; admin?: MessagePort } | null;\n      const kernel = message?.kernel;\n      if (!kernel) return;\n      resolve(message.admin ? { kernel, admin: message.admin } : { kernel });\n    });\n  });\n}\n\nexport function kernelPort(scope: WorkerScope): Promise<MessagePort> {\n  return kernelPorts(scope).then((ports) => ports.kernel);\n}\n"],
-  "mappings": "AAOO,SAAS,iBAAiB,OAAoB,MAAgC;AACnF,QAAM,iBAAiB,WAAW,CAAC,EAAE,KAAK,MAAM;AAC9C,UAAM,UAAU;AAChB,UAAM,OAAO,SAAS;AACtB,QAAI,CAAC,KAAM;AACX,SAAK;AAAA,MACH,CAAC,UAAU,MAAM,QAAQ,MAAM,EAAE,UAAU,SAAS,aAAa,KAAK,CAAC;AAAA,MACvE,MAAM,KAAK,QAAQ;AAAA,IACrB;AAAA,EACF,CAAC;AACH;AAOO,SAAS,YAAY,OAA0C;AACpE,SAAO,IAAI,QAAQ,CAAC,YAAY;AAC9B,UAAM,iBAAiB,WAAW,CAAC,EAAE,KAAK,MAAM;AAC9C,YAAM,UAAU;AAChB,YAAM,SAAS,SAAS;AACxB,UAAI,CAAC,OAAQ;AACb,cAAQ,QAAQ,QAAQ,EAAE,QAAQ,OAAO,QAAQ,MAAM,IAAI,EAAE,OAAO,CAAC;AAAA,IACvE,CAAC;AAAA,EACH,CAAC;AACH;AAEO,SAAS,WAAW,OAA0C;AACnE,SAAO,YAAY,KAAK,EAAE,KAAK,CAAC,UAAU,MAAM,MAAM;AACxD;",
+  "sourcesContent": ["import type { AgentHost } from './host.ts';\nimport type { PortEndpoint } from './wire.ts';\n\nexport interface WorkerScope {\n  addEventListener(type: 'message', listener: (event: MessageEvent) => void): void;\n}\n\nexport function serveConnections(scope: WorkerScope, host: Promise<AgentHost>): void {\n  scope.addEventListener('message', ({ data }) => {\n    const message = data as { connect?: PortEndpoint; readOnly?: boolean; pages?: boolean } | null;\n    const port = message?.connect;\n    if (!port) return;\n    const pages = message?.pages === false ? { pages: false } : {};\n    host.then(\n      (ready) => ready.connect(port, { readOnly: message?.readOnly === true, ...pages }),\n      () => port.close?.()\n    );\n  });\n}\n\nexport interface KernelPorts {\n  kernel: MessagePort;\n  admin?: MessagePort;\n}\n\nexport function kernelPorts(scope: WorkerScope): Promise<KernelPorts> {\n  return new Promise((resolve) => {\n    scope.addEventListener('message', ({ data }) => {\n      const message = data as { kernel?: MessagePort; admin?: MessagePort } | null;\n      const kernel = message?.kernel;\n      if (!kernel) return;\n      resolve(message.admin ? { kernel, admin: message.admin } : { kernel });\n    });\n  });\n}\n\nexport function kernelPort(scope: WorkerScope): Promise<MessagePort> {\n  return kernelPorts(scope).then((ports) => ports.kernel);\n}\n"],
+  "mappings": "AAOO,SAAS,iBAAiB,OAAoB,MAAgC;AACnF,QAAM,iBAAiB,WAAW,CAAC,EAAE,KAAK,MAAM;AAC9C,UAAM,UAAU;AAChB,UAAM,OAAO,SAAS;AACtB,QAAI,CAAC,KAAM;AACX,UAAM,QAAQ,SAAS,UAAU,QAAQ,EAAE,OAAO,MAAM,IAAI,CAAC;AAC7D,SAAK;AAAA,MACH,CAAC,UAAU,MAAM,QAAQ,MAAM,EAAE,UAAU,SAAS,aAAa,MAAM,GAAG,MAAM,CAAC;AAAA,MACjF,MAAM,KAAK,QAAQ;AAAA,IACrB;AAAA,EACF,CAAC;AACH;AAOO,SAAS,YAAY,OAA0C;AACpE,SAAO,IAAI,QAAQ,CAAC,YAAY;AAC9B,UAAM,iBAAiB,WAAW,CAAC,EAAE,KAAK,MAAM;AAC9C,YAAM,UAAU;AAChB,YAAM,SAAS,SAAS;AACxB,UAAI,CAAC,OAAQ;AACb,cAAQ,QAAQ,QAAQ,EAAE,QAAQ,OAAO,QAAQ,MAAM,IAAI,EAAE,OAAO,CAAC;AAAA,IACvE,CAAC;AAAA,EACH,CAAC;AACH;AAEO,SAAS,WAAW,OAA0C;AACnE,SAAO,YAAY,KAAK,EAAE,KAAK,CAAC,UAAU,MAAM,MAAM;AACxD;",
   "names": []
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ai-ecoverse/slicc-agent",
-  "version": "3.40.1",
+  "version": "3.42.0",
   "description": "SLICC's agent core on pi durable: an agent worker, session storage, remoting and pi extensions",
   "type": "module",
   "license": "Apache-2.0",

package/packages/vfs-root/skills/agent/SKILL.md

@@ -46,6 +46,8 @@ A scoop starts with your provider, model and thinking level. Use `--model provid
 
 `models` lists the models you can use, `models current` prints yours, and `models use <provider/model> [--thinking <level>]` switches your own model, as the Settings picker does.
 
+`panel list` shows the panels of the SLICC tab showing your cone, and `panel open|close|focus|move <id>` rearranges them (`panel --help` has the rest). Exit 3 means no tab shows your cone, and exit 4 means the tab didn't answer.
+
 Without `--tools`, a scoop gets read, write, edit and bash; `--tools read,bash` is an allowlist. grep, find and ls map to bash, and bash can change files, so no tool list is truly read-only. A scoop's read, write and edit tools reach only its folder, /tmp and its working folder, and read /home; its bash is not confined, and the scoop is told so.
 
 ## Inspect, talk, stop

package/packages/vfs-root/skills/sprinkles/SKILL.md

@@ -55,4 +55,4 @@ sprinkle show <name>           # show it in your chat, inline
 sprinkle own <name> [<agent>]  # send its licks to an agent: cone, cone-<n> or a scoop's handle
 ```
 
-To retire a sprinkle, delete its file. v6's `sprinkle open`, `reload`, `send`, `close` and `chat` don't exist here; the command says what to do instead.
+To retire a sprinkle, delete its file. `sprinkle open <name>` and `sprinkle close <name>` are `panel open sprinkle:<name>` and `panel close sprinkle:<name>`. v6's `reload`, `send` and `chat` don't exist here; the command says what to do instead.