@ai-ecoverse/slicc-agent 3.33.0 → 3.35.0

package/dist/scoops/requests.js

@@ -1,7 +1,7 @@
 const CONTROL_DIR = "/var/lib/slicc/agent/requests";
 const PROTOCOL = "slicc-agent/1";
 const STALE_MS = 10 * 6e4;
-const COMMAND_NAMES = /* @__PURE__ */ new Set(["subagent", "sprinkle", "memory", "gelatiere", "freezer"]);
+const COMMAND_NAMES = /* @__PURE__ */ new Set(["subagent", "sprinkle", "memory", "gelatiere", "freezer", "models"]);
 const HEADER = 6;
 function parseRequest(id, bytes) {
   const decoder = new TextDecoder();

package/dist/scoops/requests.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/scoops/requests.ts"],
-  "sourcesContent": ["import type { Context } from '@earendil-works/chord';\nimport type { ExecutionEnv, FileWatcher } from '@earendil-works/pi-durable/env';\nimport type { Answer } from './service.ts';\n\nexport const CONTROL_DIR = '/var/lib/slicc/agent/requests';\nexport const PROTOCOL = 'slicc-agent/1';\nexport const STALE_MS = 10 * 60_000;\nconst COMMAND_NAMES = new Set(['subagent', 'sprinkle', 'memory', 'gelatiere', 'freezer']);\n\nexport interface Request {\n  id: string;\n  as: 'agent' | 'subagent' | 'sprinkle' | 'memory' | 'gelatiere' | 'freezer';\n  caller: string;\n  cwd: string;\n  pid: number | null;\n  argv: string[];\n  stdin: string;\n}\n\nconst HEADER = 6;\n\nexport function parseRequest(id: string, bytes: Uint8Array): Request | undefined {\n  const decoder = new TextDecoder();\n  const fields: string[] = [];\n  let at = 0;\n  while (fields.length < HEADER) {\n    const end = bytes.indexOf(0, at);\n    if (end < 0) return undefined;\n    fields.push(decoder.decode(bytes.subarray(at, end)));\n    at = end + 1;\n  }\n  const [version, as, caller, cwd, pid, count] = fields;\n  const argc = Number(count);\n  if (version !== PROTOCOL || !Number.isInteger(argc) || argc < 0) return undefined;\n  const argv: string[] = [];\n  while (argv.length < argc) {\n    const end = bytes.indexOf(0, at);\n    if (end < 0) return undefined;\n    argv.push(decoder.decode(bytes.subarray(at, end)));\n    at = end + 1;\n  }\n  const process = Number(pid);\n  return {\n    id,\n    as: COMMAND_NAMES.has(as as string) ? (as as Request['as']) : 'agent',\n    caller: caller as string,\n    cwd: cwd || '/',\n    pid: Number.isInteger(process) && process > 0 ? process : null,\n    argv,\n    stdin: decoder.decode(bytes.subarray(at)),\n  };\n}\n\nexport interface Runner {\n  run(request: Request, context: Context): Promise<Answer>;\n  blocking(request: Request): boolean;\n}\n\nexport interface ControlPlane {\n  start(context: Context): Promise<void>;\n  sweep(context: Context): Promise<void>;\n  close(context: Context): Promise<void>;\n}\n\nexport interface PlaneOptions {\n  dir?: string;\n  now?: () => number;\n  sweepEvery?: number;\n  mirror?: (context: Context) => Promise<void>;\n}\n\nexport function controlPlane(\n  env: ExecutionEnv,\n  runner: Runner,\n  options: PlaneOptions = {}\n): ControlPlane {\n  const dir = options.dir ?? CONTROL_DIR;\n  const requests = `${dir}/in`;\n  const responses = `${dir}/out`;\n  const now = options.now ?? Date.now;\n  const handled = new Set<string>();\n  let watcher: FileWatcher | undefined;\n  let timer: ReturnType<typeof setInterval> | undefined;\n  let lock: Promise<unknown> = Promise.resolve();\n  const serial = <T>(operation: () => Promise<T>): Promise<T> => {\n    const next = lock.then(operation, operation);\n    lock = next.catch(() => undefined);\n    return next;\n  };\n\n  async function answer(id: string, result: Answer, context: Context) {\n    await env.writeFile(`${responses}/${id}.out`, result.out, context);\n    await env.writeFile(`${responses}/${id}.code`, String(result.code), context);\n    await env.remove(`${requests}/${id}`, { force: true }, context);\n    await env.remove(`${responses}/${id}.ack`, { force: true }, context);\n    await options.mirror?.(context).catch(() => undefined);\n  }\n\n  async function handle(id: string, context: Context) {\n    if (handled.has(id)) return;\n    handled.add(id);\n    try {\n      const bytes = await env.readBinaryFile(`${requests}/${id}`, context);\n      if (!bytes.ok) return;\n      await env.writeFile(`${responses}/${id}.ack`, '', context);\n      const request = parseRequest(id, bytes.value);\n      if (!request) {\n        await answer(\n          id,\n          { code: 2, out: 'agent: this request is not understood; update the agent command\\n' },\n          context\n        );\n        return;\n      }\n      const result = runner.blocking(request)\n        ? await runner.run(request, context)\n        : await serial(() => runner.run(request, context));\n      await answer(id, result, context);\n    } finally {\n      handled.delete(id);\n    }\n  }\n\n  async function scan(context: Context) {\n    const listed = await env.listDir(requests, context);\n    if (!listed.ok) return;\n    for (const entry of listed.value.sort((a, b) => a.name.localeCompare(b.name)))\n      if (entry.kind === 'file' && !entry.name.startsWith('.'))\n        void handle(entry.name, context).catch(() => undefined);\n  }\n\n  async function sweep(context: Context) {\n    for (const folder of [requests, responses]) {\n      const listed = await env.listDir(folder, context);\n      if (!listed.ok) continue;\n      for (const entry of listed.value) {\n        const stale = now() - entry.mtimeMs > STALE_MS;\n        const removable = folder === responses || entry.name.startsWith('.tmp-');\n        if (stale && removable)\n          await env.remove(`${folder}/${entry.name}`, { force: true }, context);\n      }\n    }\n  }\n\n  return {\n    async start(context) {\n      await env.createDir(requests, { recursive: true }, context);\n      await env.createDir(responses, { recursive: true }, context);\n      const leftovers = await env.listDir(requests, context);\n      if (leftovers.ok)\n        for (const entry of leftovers.value)\n          if (entry.name.startsWith('.tmp-'))\n            await env.remove(`${requests}/${entry.name}`, { force: true }, context);\n      await sweep(context);\n      const watched = await env.watch(\n        [{ path: requests }],\n        () => void scan(context).catch(() => undefined),\n        context\n      );\n      if (watched.ok) watcher = watched.value;\n      await scan(context);\n      timer = setInterval(\n        () => void sweep(context).catch(() => undefined),\n        options.sweepEvery ?? 60_000\n      );\n    },\n    sweep,\n    async close(context) {\n      clearInterval(timer);\n      await watcher?.close(context);\n      await lock;\n    },\n  };\n}\n"],
-  "mappings": "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",
+  "sourcesContent": ["import type { Context } from '@earendil-works/chord';\nimport type { ExecutionEnv, FileWatcher } from '@earendil-works/pi-durable/env';\nimport type { Answer } from './service.ts';\n\nexport const CONTROL_DIR = '/var/lib/slicc/agent/requests';\nexport const PROTOCOL = 'slicc-agent/1';\nexport const STALE_MS = 10 * 60_000;\nconst COMMAND_NAMES = new Set(['subagent', 'sprinkle', 'memory', 'gelatiere', 'freezer', 'models']);\n\nexport interface Request {\n  id: string;\n  as: 'agent' | 'subagent' | 'sprinkle' | 'memory' | 'gelatiere' | 'freezer' | 'models';\n  caller: string;\n  cwd: string;\n  pid: number | null;\n  argv: string[];\n  stdin: string;\n}\n\nconst HEADER = 6;\n\nexport function parseRequest(id: string, bytes: Uint8Array): Request | undefined {\n  const decoder = new TextDecoder();\n  const fields: string[] = [];\n  let at = 0;\n  while (fields.length < HEADER) {\n    const end = bytes.indexOf(0, at);\n    if (end < 0) return undefined;\n    fields.push(decoder.decode(bytes.subarray(at, end)));\n    at = end + 1;\n  }\n  const [version, as, caller, cwd, pid, count] = fields;\n  const argc = Number(count);\n  if (version !== PROTOCOL || !Number.isInteger(argc) || argc < 0) return undefined;\n  const argv: string[] = [];\n  while (argv.length < argc) {\n    const end = bytes.indexOf(0, at);\n    if (end < 0) return undefined;\n    argv.push(decoder.decode(bytes.subarray(at, end)));\n    at = end + 1;\n  }\n  const process = Number(pid);\n  return {\n    id,\n    as: COMMAND_NAMES.has(as as string) ? (as as Request['as']) : 'agent',\n    caller: caller as string,\n    cwd: cwd || '/',\n    pid: Number.isInteger(process) && process > 0 ? process : null,\n    argv,\n    stdin: decoder.decode(bytes.subarray(at)),\n  };\n}\n\nexport interface Runner {\n  run(request: Request, context: Context): Promise<Answer>;\n  blocking(request: Request): boolean;\n}\n\nexport interface ControlPlane {\n  start(context: Context): Promise<void>;\n  sweep(context: Context): Promise<void>;\n  close(context: Context): Promise<void>;\n}\n\nexport interface PlaneOptions {\n  dir?: string;\n  now?: () => number;\n  sweepEvery?: number;\n  mirror?: (context: Context) => Promise<void>;\n}\n\nexport function controlPlane(\n  env: ExecutionEnv,\n  runner: Runner,\n  options: PlaneOptions = {}\n): ControlPlane {\n  const dir = options.dir ?? CONTROL_DIR;\n  const requests = `${dir}/in`;\n  const responses = `${dir}/out`;\n  const now = options.now ?? Date.now;\n  const handled = new Set<string>();\n  let watcher: FileWatcher | undefined;\n  let timer: ReturnType<typeof setInterval> | undefined;\n  let lock: Promise<unknown> = Promise.resolve();\n  const serial = <T>(operation: () => Promise<T>): Promise<T> => {\n    const next = lock.then(operation, operation);\n    lock = next.catch(() => undefined);\n    return next;\n  };\n\n  async function answer(id: string, result: Answer, context: Context) {\n    await env.writeFile(`${responses}/${id}.out`, result.out, context);\n    await env.writeFile(`${responses}/${id}.code`, String(result.code), context);\n    await env.remove(`${requests}/${id}`, { force: true }, context);\n    await env.remove(`${responses}/${id}.ack`, { force: true }, context);\n    await options.mirror?.(context).catch(() => undefined);\n  }\n\n  async function handle(id: string, context: Context) {\n    if (handled.has(id)) return;\n    handled.add(id);\n    try {\n      const bytes = await env.readBinaryFile(`${requests}/${id}`, context);\n      if (!bytes.ok) return;\n      await env.writeFile(`${responses}/${id}.ack`, '', context);\n      const request = parseRequest(id, bytes.value);\n      if (!request) {\n        await answer(\n          id,\n          { code: 2, out: 'agent: this request is not understood; update the agent command\\n' },\n          context\n        );\n        return;\n      }\n      const result = runner.blocking(request)\n        ? await runner.run(request, context)\n        : await serial(() => runner.run(request, context));\n      await answer(id, result, context);\n    } finally {\n      handled.delete(id);\n    }\n  }\n\n  async function scan(context: Context) {\n    const listed = await env.listDir(requests, context);\n    if (!listed.ok) return;\n    for (const entry of listed.value.sort((a, b) => a.name.localeCompare(b.name)))\n      if (entry.kind === 'file' && !entry.name.startsWith('.'))\n        void handle(entry.name, context).catch(() => undefined);\n  }\n\n  async function sweep(context: Context) {\n    for (const folder of [requests, responses]) {\n      const listed = await env.listDir(folder, context);\n      if (!listed.ok) continue;\n      for (const entry of listed.value) {\n        const stale = now() - entry.mtimeMs > STALE_MS;\n        const removable = folder === responses || entry.name.startsWith('.tmp-');\n        if (stale && removable)\n          await env.remove(`${folder}/${entry.name}`, { force: true }, context);\n      }\n    }\n  }\n\n  return {\n    async start(context) {\n      await env.createDir(requests, { recursive: true }, context);\n      await env.createDir(responses, { recursive: true }, context);\n      const leftovers = await env.listDir(requests, context);\n      if (leftovers.ok)\n        for (const entry of leftovers.value)\n          if (entry.name.startsWith('.tmp-'))\n            await env.remove(`${requests}/${entry.name}`, { force: true }, context);\n      await sweep(context);\n      const watched = await env.watch(\n        [{ path: requests }],\n        () => void scan(context).catch(() => undefined),\n        context\n      );\n      if (watched.ok) watcher = watched.value;\n      await scan(context);\n      timer = setInterval(\n        () => void sweep(context).catch(() => undefined),\n        options.sweepEvery ?? 60_000\n      );\n    },\n    sweep,\n    async close(context) {\n      clearInterval(timer);\n      await watcher?.close(context);\n      await lock;\n    },\n  };\n}\n"],
+  "mappings": "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",
   "names": []
 }

package/dist/types/host.d.ts

@@ -3,6 +3,7 @@ import type { Agent } from './agent.ts';
 import type { ChangesRuntime } from './changes/index.ts';
 import { type HostLicks, type HostScoops } from './control.ts';
 import type { FreezerRuntime } from './freezer/index.ts';
+import type { UserClients } from './kernel/users.ts';
 import type { McpRuntime } from './mcp/index.ts';
 import type { MemoryRuntime } from './memory/index.ts';
 import { AgentSettings } from './services.ts';
@@ -12,6 +13,7 @@ import type { PortEndpoint } from './wire.ts';
 export interface AgentHost {
     readonly serverId: string;
     readonly agent: Agent;
+    readonly users?: UserClients;
     connect(endpoint: PortEndpoint, options?: {
         readOnly?: boolean;
     }): void;
@@ -29,4 +31,5 @@ export declare function hostAgent(agent: Agent, options?: {
     freezer?: FreezerRuntime;
     changes?: ChangesRuntime;
     mcp?: Pick<McpRuntime, 'close'>;
+    users?: UserClients;
 }): Promise<AgentHost>;

package/dist/types/index.d.ts

@@ -6,10 +6,11 @@ export { CREDENTIALS_DATABASE, EncryptedCredentialStore } from './credentials.ts
 export { type AgentHost, hostAgent } from './host.ts';
 export type { KernelClient, KernelFs, KernelProcess, KernelStat, SpawnOptions, } from './kernel/client.ts';
 export { HOME, type KernelEnvOptions, kernelEnvironment, SliccKernelEnv } from './kernel/env.ts';
+export { adminOver, type KernelAdmin, type KernelUser, type KernelUsers, serveAdmin, type UserClient, type UserClients, type UserConnect, type UserSpec, userClients, } from './kernel/users.ts';
 export { PortListener } from './listener.ts';
 export { type AgentWorkerOptions, type AgentWorkerScope, type KernelAttach, runAgentWorker, } from './main.ts';
 export { type Transport, type TransportResponse, transportFetch } from './net.ts';
-export { AGENT_LOCK, type AgentOwner, type AgentWorker, type OwnerOptions, startAgent, } from './owner.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';
@@ -17,4 +18,4 @@ export { BEDROCK, createAgentSettings, createSliccModels, DEFAULT_MODEL, DEFAULT
 export { AGENT_DIRECTORY, type OpfsSqliteOptions, openMemorySqliteStorage, openOpfsSqliteStorage, WasmSqliteDatabase, } from './sqlite.ts';
 export { type SystemFacts, systemSection } from './system.ts';
 export { PortChannel, type PortEndpoint, withUnrefTimers } from './wire.ts';
-export { kernelPort, serveConnections, type WorkerScope } from './worker.ts';
+export { type KernelPorts, kernelPort, kernelPorts, serveConnections, type WorkerScope, } from './worker.ts';

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

@@ -0,0 +1,53 @@
+import type { PortEndpoint } from '../wire.ts';
+import type { KernelClient } from './client.ts';
+export interface KernelUser {
+    name: string;
+    uid: number;
+    gid: number;
+    home: string;
+    shell: string;
+    groups: number[];
+    umask?: number;
+}
+export interface UserSpec {
+    name: string;
+    home?: string;
+    groups?: string[];
+    umask?: number;
+    homeGroup?: string;
+}
+export interface KernelUsers {
+    add(spec: UserSpec): Promise<KernelUser>;
+    remove(name: string, options?: {
+        keepHome?: boolean;
+    }): Promise<boolean>;
+    list(): Promise<KernelUser[]>;
+}
+export interface UserConnect {
+    user?: string;
+    agentId?: string;
+}
+export interface KernelSource {
+    connect(options?: UserConnect): Promise<Transferable>;
+    users?: KernelUsers;
+}
+export interface KernelAdmin {
+    connect(options: UserConnect): Promise<MessagePort>;
+    users: KernelUsers;
+    close(): void;
+}
+export declare function serveAdmin(port: PortEndpoint, source: KernelSource): void;
+export declare function adminOver(port: PortEndpoint): KernelAdmin;
+export type UserClient = KernelClient & {
+    close?(options?: {
+        kill?: boolean;
+    }): unknown;
+    closed?: Promise<unknown>;
+};
+export interface UserClients {
+    readonly users: KernelUsers;
+    client(agentId: string, user: string): Promise<UserClient>;
+    drop(agentId: string): Promise<void>;
+    close(): Promise<void>;
+}
+export declare function userClients(admin: KernelAdmin, attach: (port: MessagePort) => Promise<UserClient>): UserClients;

package/dist/types/main.d.ts

@@ -2,6 +2,7 @@ import type { CredentialStore, Provider } from '@earendil-works/pi-ai';
 import { type ModelRef, type Storage } from '@earendil-works/pi-durable';
 import { type AgentHost } from './host.ts';
 import type { KernelClient } from './kernel/client.ts';
+import { type UserClients } from './kernel/users.ts';
 import { type Transport } from './net.ts';
 import { type Assets } from './scoops/index.ts';
 import { type WorkerScope } from './worker.ts';
@@ -24,6 +25,9 @@ export interface AgentWorkerOptions {
     codemodeWasm?: () => Promise<WebAssembly.Module | undefined>;
     codemodeWorker?: string | URL;
     catalog?: string;
+    users?: boolean;
 }
+export declare function usersOf(admin: MessagePort | undefined, wanted: boolean | undefined, attach: KernelAttach): UserClients | undefined;
+export declare const STORE_DIR = "/.slicc";
 export declare function alive(client: KernelClient): (pid: number) => Promise<boolean>;
 export declare function runAgentWorker(scope: AgentWorkerScope, options?: AgentWorkerOptions): Promise<AgentHost>;

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

@@ -0,0 +1,16 @@
+import type { Context } from '@earendil-works/chord';
+import type { Models } from '@earendil-works/pi-ai/models';
+import type { Agents } from '../agents.ts';
+import type { AgentSettings } from '../services.ts';
+export type Answer = {
+    code: number;
+    out: string;
+};
+export declare const USAGE: string;
+export interface ModelsOptions {
+    agents: Agents;
+    settings: Pick<AgentSettings, 'state'>;
+    catalog: Pick<Models, 'getProviders' | 'getModels'>;
+}
+export declare function closest(wanted: string, ids: readonly string[], count?: number): string[];
+export declare function modelsCommand(options: ModelsOptions): (argv: readonly string[], caller: string | null, context: Context) => Promise<Answer>;

package/dist/types/owner.d.ts

@@ -1,4 +1,5 @@
 import { type AgentConnection } from './client.ts';
+import { type KernelSource } from './kernel/users.ts';
 import type { PortEndpoint } from './wire.ts';
 export declare const AGENT_LOCK = "slicc-agent";
 export interface AgentWorker {
@@ -14,9 +15,7 @@ export interface AgentOwner {
     restart(): Promise<void>;
     release(): Promise<void>;
 }
-export interface KernelSource {
-    connect(): Promise<Transferable>;
-}
+export type { KernelSource } from './kernel/users.ts';
 export interface OwnerOptions {
     worker: () => AgentWorker;
     kernel?: KernelSource;

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

@@ -23,6 +23,7 @@ export interface CliOptions {
     memory?: (argv: readonly string[], caller: string | null, context: Context) => Promise<Answer>;
     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>;
 }
 export type Deps = CliOptions & {
     now: () => number;

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

@@ -10,6 +10,7 @@ import { type ControlPlane } from './requests.ts';
 import { type Scoops } from './service.ts';
 export declare const BUILTIN_ROLES: string[];
 export declare const PNPM_HOME = "/home/.local/share/pnpm";
+export declare const BIN_DIR = "/usr/local/bin";
 export type Assets = (path: string) => Promise<string>;
 export declare function packageAssets(base?: URL): Assets;
 export interface AttachOptions {
@@ -19,7 +20,7 @@ export interface AttachOptions {
     env: ExecutionEnv;
     home: string;
     assets?: Assets;
-    pnpmHome?: string;
+    binDir?: string;
     controlDir?: string;
     sweepEvery?: number;
     alive?: (pid: number) => Promise<boolean>;
@@ -28,6 +29,7 @@ export interface AttachOptions {
     memory?: CliOptions['memory'];
     gelatiere?: CliOptions['gelatiere'];
     freezer?: CliOptions['freezer'];
+    models?: CliOptions['models'];
     mcp?: (names: readonly string[]) => ToolRegistration[];
 }
 export interface ScoopsRuntime {
@@ -41,5 +43,7 @@ export interface ScoopsSetup {
 }
 export declare const COMMANDS: string[];
 export declare function pnpmHomeOf(env: ExecutionEnv, context: Context): Promise<string>;
+export declare function installCommands(env: ExecutionEnv, script: string, binDir: string, context: Context): Promise<boolean>;
+export declare function retire(env: ExecutionEnv, binDir: string, context: Context): Promise<void>;
 export declare function setupScoops(registry: Registry, licks: Licks, fileTools?: readonly ToolRegistration[]): ScoopsSetup;
 export type { Rewound, Scoops } from './service.ts';

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

@@ -6,7 +6,7 @@ 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';
+    as: 'agent' | 'subagent' | 'sprinkle' | 'memory' | 'gelatiere' | 'freezer' | 'models';
     caller: string;
     cwd: string;
     pid: number | null;

package/dist/types/worker.d.ts

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

package/dist/worker.js

@@ -9,16 +9,22 @@ function serveConnections(scope, host) {
     );
   });
 }
-function kernelPort(scope) {
+function kernelPorts(scope) {
   return new Promise((resolve) => {
     scope.addEventListener("message", ({ data }) => {
-      const port = data?.kernel;
-      if (port) resolve(port);
+      const message = data;
+      const kernel = message?.kernel;
+      if (!kernel) return;
+      resolve(message.admin ? { kernel, admin: message.admin } : { kernel });
     });
   });
 }
+function kernelPort(scope) {
+  return kernelPorts(scope).then((ports) => ports.kernel);
+}
 export {
   kernelPort,
+  kernelPorts,
   serveConnections
 };
 //# sourceMappingURL=worker.js.map

package/dist/worker.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ai-ecoverse/slicc-agent",
-  "version": "3.33.0",
+  "version": "3.35.0",
   "description": "SLICC's agent core on pi durable: an agent worker, session storage, remoting and pi extensions",
   "type": "module",
   "license": "Apache-2.0",
@@ -63,7 +63,7 @@
   "devDependencies": {
     "@ai-ecoverse/slicc-kernel": "1.47.1",
     "@ai-ecoverse/slicc-shared-web": "1.12.1",
-    "@ai-ecoverse/slicc-spectrum": "1.52.0",
+    "@ai-ecoverse/slicc-spectrum": "1.53.0",
     "@ai-ecoverse/wasm-bash": "5.3.0-17",
     "@ai-ecoverse/wasm-coreutils": "9.12.0-5",
     "@ai-ecoverse/wasm-git": "2.55.0-15",

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

@@ -44,6 +44,8 @@ It returns at once, and one `scoop-wait` lick brings all their answers together.
 
 A scoop starts with your provider, model and thinking level. Use `--model provider/model`, `--thinking` or `--effort` only when you mean to choose differently. Never pass `$PI_PROVIDER`, `$PI_MODEL` or `$PI_REASONING_LEVEL` back explicitly.
 
+`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.
+
 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