@ai-ecoverse/slicc-agent 3.29.0 → 3.29.1

package/README.md

@@ -160,7 +160,7 @@ A **cone** is a top-level agent the user talks to; a **scoop** is a helper agent
 
 Each scoop is owned by a background durable task, its **anchor**, so Stop in its cone doesn't end it; `agent stop` and Drop do. They keep its transcript in durable storage and its reports in `/scoops/<handle>/reports/`, which report licks point at, and remove its working folder `/scoops/<handle>/workspace`. Each request handed to a scoop gets a **reporter** task that waits for the run, writes the answer to `/scoops/<handle>/reports/<task id>.md` and reports it to whoever asked. Requests from a cone's or a scoop's bash report into that agent's `pi.inbox` as a lick, through the licks outbox, so they steer and coalesce like any lick; requests from a terminal report nowhere, and a user typing in a scoop's chat gets the answer there. In a scoop's chat, a request someone else sent shows who sent it (`UserMessage.from`): the asking cone's or scoop's name, with `origin: 'agent'` so spectrum (≥ 1.26.0) shows it as that agent's request with an "Agent" badge, or `terminal` without an origin. Once the request is placed, the reporter appends a `slicc.from` entry (`{ from, entry }`) without model messages, and the adapter sets `from` on that entry's message. A request withdrawn before it was placed leaves no entry. The report lick's text is `[scoop <name> (<role>) <status>]`, and its body has the report's path and line count and a 1,000-character preview. A scoop's prompt has a `scoop` section with its name, its cone, its folders and its limits. The `agent` command is taught by the built-in `agent` skill (below), whose description says that roles exist and that `agent list --agents` lists them.
 
-**The `agent` command.** One bash script is installed as `agent` and `subagent` in `$PNPM_HOME/bin`, so the user, a cone or a scoop runs it in any bash. It writes a request (NUL-separated fields: `slicc-agent/1`, the name it was called by, `$SLICC_AGENT`, the working directory, its pid, argc, the arguments and stdin) to `/var/lib/slicc/agent/requests/in/` and polls `out/` for the answer and exit code; the worker writes `<id>.ack` when it picks a request up, and the script gives up after 20 s without one ("the SLICC agent isn't running", exit 1). The kernel environment exports `SLICC_AGENT`, `PI_PROVIDER`, `PI_MODEL` and `PI_REASONING_LEVEL` into every agent command, so the worker knows the caller. `/var/lib/slicc/agent/scoops/<handle>/metadata.json` mirrors each scoop's state for scripts.
+**The `agent` command.** One bash script is installed as `agent` and `subagent` in the kernel's `$PNPM_HOME/bin` (the worker asks the kernel for `PNPM_HOME`: `/home/.local/share/pnpm` before kernel users, root's `/usr/local/share/pnpm`, whose commands every user finds, from kernel 1.47.1), so the user, a cone or a scoop runs it in any bash. It writes a request (NUL-separated fields: `slicc-agent/1`, the name it was called by, `$SLICC_AGENT`, the working directory, its pid, argc, the arguments and stdin) to `/var/lib/slicc/agent/requests/in/` and polls `out/` for the answer and exit code; the worker writes `<id>.ack` when it picks a request up, and the script gives up after 20 s without one ("the SLICC agent isn't running", exit 1). The kernel environment exports `SLICC_AGENT`, `PI_PROVIDER`, `PI_MODEL` and `PI_REASONING_LEVEL` into every agent command, so the worker knows the caller. `/var/lib/slicc/agent/scoops/<handle>/metadata.json` mirrors each scoop's state for scripts.
 - `agent [options] --prompt <text>` (or `--file <path>`, or `-` for stdin, or v6's `agent <cwd> <allowed-commands> <prompt>`) is **synchronous**: an ephemeral scoop runs, and the command prints its final answer and exits 0, or prints the reason on stderr and exits 1. Afterwards the scoop is stopped, its folder removed, its conversation marked dropped and its transcript archived as Markdown in `/tmp/agent-sessions/<handle>.md` (`/home/sessions/` with `--persist-session`, nowhere with `--no-persist-session`). The script traps TERM, INT and HUP and cancels the scoop, and the worker checks the script's pid in the kernel's process table every second for a SIGKILL. If the caller's run is still going when the bash call dies (a bash timeout), the scoop continues and its answer arrives as a `bash` lick; `--background-after <seconds>` does the same on purpose. Sync calls nest up to three deep. Allowed commands in v6's form are told to the scoop, not enforced.
 - `agent --async …` (= `subagent spawn …`) starts a persistent scoop and prints its handle; only cones start them. `list [--agents]`, `status`, `rename`, `send [--follow-up]`, `wait [--timeout <s>] [--notify]` (30 s by default; `--notify` returns at once and brings the answers together in one `scoop-wait` lick) and `stop` manage them. From a scoop, `agent send parent "<note>"` posts a progress note to its cone as a lick, coalesced per scoop.
 - Options: `--name`, `--agent <role>`, `--model <provider/model>`, `--thinking <level>` or `--effort low|medium|high|max`, `--tools <a,b>` (or `auto`/`full`), `--read-only <paths>`, `--system-prompt[-file]`. `--schema-b64`, `--tools output`, `--session`, `--resume`, `--image`, `--no-escalate`, `--minimal` and `--usage` answer "not supported in SLICC yet".
@@ -416,7 +416,7 @@ The built-in `sprinkles` skill teaches the files, the bridge and the command.
 
 ## The kernel
 
-`@ai-ecoverse/slicc-kernel` is a peer dependency (`>=1.26.3 <2`; older kernels have an IPv6-to-loopback security bug): the agent only calls `attachKernel`, the client end of the page kernel's port, so it must match the kernel the page runs. Seven chooses that version: slicc-bios pins the certified kernel next to the agent in `src/packages/agent/package.json`, and pnpm fills the peer from that pin. The devDependency is the lowest certified kernel the range allows (1.26.3), and the unit and integration tests run on it. A second CI job reruns the integration tests on the newest certified kernel (`NEWEST_CERTIFIED_KERNEL` in `.github/workflows/ci.yml`). Today the floor is 1.26.3 and the newest certified kernel 1.41.3; the second job moves by hand to each newer certified kernel, so both ends of the range are tested. If the port protocol ever breaks within 1.x, a patch release narrows the upper bound. Renovate opens PRs for the kernel, `wasi-pnpm`, the `wasm-*` packages and `slicc-cdp` but never merges them, because they move only after the homescoop coordinator certifies them.
+`@ai-ecoverse/slicc-kernel` is a peer dependency (`>=1.26.3 <2`; older kernels have an IPv6-to-loopback security bug): the agent only calls `attachKernel`, the client end of the page kernel's port, so it must match the kernel the page runs. Seven chooses that version: slicc-bios pins the certified kernel next to the agent in `src/packages/agent/package.json`, and pnpm fills the peer from that pin. The devDependency is the lowest certified kernel the range allows (1.26.3), and the unit and integration tests run on it. A second CI job reruns the integration tests on the newest certified kernel (`NEWEST_CERTIFIED_KERNEL` in `.github/workflows/ci.yml`), with the wasm commands certified for it (`NEWEST_CERTIFIED_WASM`; wasm-git 2.55.0-14 and later need kernel ≥ 1.47.1, so the devDependencies stay on builds the floor runs). Today the floor is 1.26.3 and the newest certified kernel 1.47.1; the second job moves by hand to each newer certified kernel, so both ends of the range are tested. If the port protocol ever breaks within 1.x, a patch release narrows the upper bound. Renovate opens PRs for the kernel, `wasi-pnpm`, the `wasm-*` packages and `slicc-cdp` but never merges them, because they move only after the homescoop coordinator certifies them.
 
 ## Patched dependencies
 

package/dist/scoops/index.js

@@ -14,6 +14,19 @@ function packageAssets(base = new URL("../../", import.meta.url)) {
   };
 }
 const COMMANDS = ["agent", "subagent", "sprinkle", "memory", "gelatiere", "freezer"];
+async function pnpmHomeOf(env, context) {
+  let out = "";
+  const ran = await env.exec(
+    'printf %s "$PNPM_HOME"',
+    {
+      onOutput: (text) => {
+        out += text;
+      }
+    },
+    context
+  ).catch(() => void 0);
+  return ran?.ok && ran.value.exitCode === 0 && /^\/\S*$/.test(out) ? out : PNPM_HOME;
+}
 async function install(env, script, pnpmHome, context) {
   await env.createDir(`${pnpmHome}/bin`, { recursive: true }, context);
   for (const name of COMMANDS) {
@@ -97,8 +110,10 @@ function setupScoops(registry, licks, fileTools = []) {
       };
       await roles(context).catch(() => cached);
       const script = await assets("bin/agent").catch(() => void 0);
-      if (script)
-        await install(env, script, options.pnpmHome ?? PNPM_HOME, context).catch(() => void 0);
+      if (script) {
+        const pnpmHome = options.pnpmHome ?? await pnpmHomeOf(env, context);
+        await install(env, script, pnpmHome, context).catch(() => void 0);
+      }
       const cli = createCli({
         env,
         harness,
@@ -126,6 +141,7 @@ export {
   COMMANDS,
   PNPM_HOME,
   packageAssets,
+  pnpmHomeOf,
   setupScoops
 };
 //# sourceMappingURL=index.js.map

package/dist/scoops/index.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/scoops/index.ts"],
-  "sourcesContent": ["import type { Context } from '@earendil-works/chord';\nimport type { Harness, Registry, ToolRegistration } from '@earendil-works/pi-durable';\nimport type { ExecutionEnv } from '@earendil-works/pi-durable/env';\nimport { type Agents, live } from '../agents.ts';\nimport type { ProcessGroups } from '../kernel/groups.ts';\nimport type { Licks } from '../licks/licks.ts';\nimport { DEFAULT_LIMITS, loadRoles, packageDirs, type Roles } from '../roles/roles.ts';\nimport { type CliOptions, createCli, RUN_DIR } from './cli.ts';\nimport { guardExtension, scoopsExtension, scoopTasks } from './extension.ts';\nimport { type ControlPlane, controlPlane } from './requests.ts';\nimport { createScoops, type Scoops, type ScoopsHost } from './service.ts';\n\nexport const BUILTIN_ROLES = ['scout', 'worker', 'reviewer', 'oracle', 'delegate', 'gelatiere'];\nexport const PNPM_HOME = '/home/.local/share/pnpm';\n\nexport type Assets = (path: string) => Promise<string>;\n\nexport function packageAssets(base: URL = new URL('../../', import.meta.url)): Assets {\n  return async (path) => {\n    const response = await fetch(new URL(path, base));\n    if (!response.ok) throw new Error(`${path}: ${response.status}`);\n    return response.text();\n  };\n}\n\nexport interface AttachOptions {\n  harness: Harness;\n  agents: Agents;\n  groups: ProcessGroups;\n  env: ExecutionEnv;\n  home: string;\n  assets?: Assets;\n  pnpmHome?: string;\n  controlDir?: string;\n  sweepEvery?: number;\n  alive?: (pid: number) => Promise<boolean>;\n  reads: () => readonly string[];\n  sprinkle?: CliOptions['sprinkle'];\n  memory?: CliOptions['memory'];\n  gelatiere?: CliOptions['gelatiere'];\n  freezer?: CliOptions['freezer'];\n  mcp?: (names: readonly string[]) => ToolRegistration[];\n}\n\nexport interface ScoopsRuntime {\n  roles(context: Context): Promise<Roles>;\n  plane: ControlPlane;\n  close(context: Context): Promise<void>;\n}\n\nexport interface ScoopsSetup {\n  scoops: Scoops;\n  attach(options: AttachOptions, context: Context): Promise<ScoopsRuntime>;\n}\n\nexport const COMMANDS = ['agent', 'subagent', 'sprinkle', 'memory', 'gelatiere', 'freezer'];\n\nasync function install(env: ExecutionEnv, script: string, pnpmHome: string, context: Context) {\n  await env.createDir(`${pnpmHome}/bin`, { recursive: true }, context);\n  for (const name of COMMANDS) {\n    const path = `${pnpmHome}/bin/${name}`;\n    await env.writeFile(path, script, context);\n    await env.exec(['chmod', '+x', path], undefined, context);\n  }\n}\n\nfunction mirror(agents: Agents, env: ExecutionEnv) {\n  return async (context: Context) => {\n    for (const [id, record] of Object.entries(agents.state().scoops)) {\n      const state = record.gone ? 'gone' : live(record) ? 'live' : 'stopped';\n      const metadata = {\n        handle: record.folder,\n        id,\n        name: record.name,\n        role: record.role,\n        cone: record.cone,\n        state,\n      };\n      await env.writeFile(\n        `${RUN_DIR}/${record.folder}/metadata.json`,\n        `${JSON.stringify(metadata, null, 2)}\\n`,\n        context\n      );\n    }\n  };\n}\n\nexport function setupScoops(\n  registry: Registry,\n  licks: Licks,\n  fileTools: readonly ToolRegistration[] = []\n): ScoopsSetup {\n  let bind: (host: ScoopsHost) => void = () => undefined;\n  const host = new Promise<ScoopsHost>((resolve) => {\n    bind = resolve;\n  });\n  const lookup = () => host;\n  const tasks = scoopTasks(lookup);\n  const scoops = createScoops(host, () => tasks);\n  let cached: Roles = { roles: [], warnings: [], limits: { ...DEFAULT_LIMITS } };\n  registry.install(scoopsExtension(tasks));\n  registry.install(guardExtension(lookup, fileTools));\n  return {\n    scoops,\n    async attach(options, context) {\n      const { harness, agents, groups, env, home } = options;\n      const assets = options.assets ?? packageAssets();\n      bind({\n        harness,\n        agents,\n        licks,\n        tools: fileTools,\n        groups,\n        reads: options.reads,\n        files: env,\n        ...(options.mcp ? { mcp: options.mcp } : {}),\n      });\n      const builtin = async () => {\n        const out: { path: string; text: string }[] = [];\n        for (const name of BUILTIN_ROLES) {\n          const path = `packages/vfs-root/agents/${name}.md`;\n          out.push({ path: `builtin:${name}`, text: await assets(path) });\n        }\n        return out;\n      };\n      const roles = async (using: Context) => {\n        cached = await loadRoles(\n          {\n            files: env,\n            builtin,\n            dirs: [\n              ...(await packageDirs(env, '/node_modules', using)).map((dir) => ({\n                source: 'package' as const,\n                dir,\n              })),\n              { source: 'user', dir: `${home}/.pi/agent/agents` },\n            ],\n            settingsPath: `${home}/.pi/agent/settings.json`,\n          },\n          using\n        );\n        return cached;\n      };\n      await roles(context).catch(() => cached);\n      const script = await assets('bin/agent').catch(() => undefined);\n      if (script)\n        await install(env, script, options.pnpmHome ?? PNPM_HOME, context).catch(() => undefined);\n      const cli = createCli({\n        env,\n        harness,\n        agents,\n        scoops,\n        roles: () => roles(context),\n        ...(options.alive ? { alive: options.alive } : {}),\n        ...(options.sprinkle ? { sprinkle: options.sprinkle } : {}),\n        ...(options.memory ? { memory: options.memory } : {}),\n        ...(options.gelatiere ? { gelatiere: options.gelatiere } : {}),\n        ...(options.freezer ? { freezer: options.freezer } : {}),\n      });\n      const plane = controlPlane(env, cli, {\n        ...(options.controlDir ? { dir: options.controlDir } : {}),\n        ...(options.sweepEvery ? { sweepEvery: options.sweepEvery } : {}),\n        mirror: mirror(agents, env),\n      });\n      await plane.start(context);\n      return { roles, plane, close: (using) => plane.close(using) };\n    },\n  };\n}\n\nexport type { Rewound, Scoops } from './service.ts';\n"],
-  "mappings": "AAGA,SAAsB,YAAY;AAGlC,SAAS,gBAAgB,WAAW,mBAA+B;AACnE,SAA0B,WAAW,eAAe;AACpD,SAAS,gBAAgB,iBAAiB,kBAAkB;AAC5D,SAA4B,oBAAoB;AAChD,SAAS,oBAAkD;AAEpD,MAAM,gBAAgB,CAAC,SAAS,UAAU,YAAY,UAAU,YAAY,WAAW;AACvF,MAAM,YAAY;AAIlB,SAAS,cAAc,OAAY,IAAI,IAAI,UAAU,YAAY,GAAG,GAAW;AACpF,SAAO,OAAO,SAAS;AACrB,UAAM,WAAW,MAAM,MAAM,IAAI,IAAI,MAAM,IAAI,CAAC;AAChD,QAAI,CAAC,SAAS,GAAI,OAAM,IAAI,MAAM,GAAG,IAAI,KAAK,SAAS,MAAM,EAAE;AAC/D,WAAO,SAAS,KAAK;AAAA,EACvB;AACF;AAgCO,MAAM,WAAW,CAAC,SAAS,YAAY,YAAY,UAAU,aAAa,SAAS;AAE1F,eAAe,QAAQ,KAAmB,QAAgB,UAAkB,SAAkB;AAC5F,QAAM,IAAI,UAAU,GAAG,QAAQ,QAAQ,EAAE,WAAW,KAAK,GAAG,OAAO;AACnE,aAAW,QAAQ,UAAU;AAC3B,UAAM,OAAO,GAAG,QAAQ,QAAQ,IAAI;AACpC,UAAM,IAAI,UAAU,MAAM,QAAQ,OAAO;AACzC,UAAM,IAAI,KAAK,CAAC,SAAS,MAAM,IAAI,GAAG,QAAW,OAAO;AAAA,EAC1D;AACF;AAEA,SAAS,OAAO,QAAgB,KAAmB;AACjD,SAAO,OAAO,YAAqB;AACjC,eAAW,CAAC,IAAI,MAAM,KAAK,OAAO,QAAQ,OAAO,MAAM,EAAE,MAAM,GAAG;AAChE,YAAM,QAAQ,OAAO,OAAO,SAAS,KAAK,MAAM,IAAI,SAAS;AAC7D,YAAM,WAAW;AAAA,QACf,QAAQ,OAAO;AAAA,QACf;AAAA,QACA,MAAM,OAAO;AAAA,QACb,MAAM,OAAO;AAAA,QACb,MAAM,OAAO;AAAA,QACb;AAAA,MACF;AACA,YAAM,IAAI;AAAA,QACR,GAAG,OAAO,IAAI,OAAO,MAAM;AAAA,QAC3B,GAAG,KAAK,UAAU,UAAU,MAAM,CAAC,CAAC;AAAA;AAAA,QACpC;AAAA,MACF;AAAA,IACF;AAAA,EACF;AACF;AAEO,SAAS,YACd,UACA,OACA,YAAyC,CAAC,GAC7B;AACb,MAAI,OAAmC,MAAM;AAC7C,QAAM,OAAO,IAAI,QAAoB,CAAC,YAAY;AAChD,WAAO;AAAA,EACT,CAAC;AACD,QAAM,SAAS,MAAM;AACrB,QAAM,QAAQ,WAAW,MAAM;AAC/B,QAAM,SAAS,aAAa,MAAM,MAAM,KAAK;AAC7C,MAAI,SAAgB,EAAE,OAAO,CAAC,GAAG,UAAU,CAAC,GAAG,QAAQ,EAAE,GAAG,eAAe,EAAE;AAC7E,WAAS,QAAQ,gBAAgB,KAAK,CAAC;AACvC,WAAS,QAAQ,eAAe,QAAQ,SAAS,CAAC;AAClD,SAAO;AAAA,IACL;AAAA,IACA,MAAM,OAAO,SAAS,SAAS;AAC7B,YAAM,EAAE,SAAS,QAAQ,QAAQ,KAAK,KAAK,IAAI;AAC/C,YAAM,SAAS,QAAQ,UAAU,cAAc;AAC/C,WAAK;AAAA,QACH;AAAA,QACA;AAAA,QACA;AAAA,QACA,OAAO;AAAA,QACP;AAAA,QACA,OAAO,QAAQ;AAAA,QACf,OAAO;AAAA,QACP,GAAI,QAAQ,MAAM,EAAE,KAAK,QAAQ,IAAI,IAAI,CAAC;AAAA,MAC5C,CAAC;AACD,YAAM,UAAU,YAAY;AAC1B,cAAM,MAAwC,CAAC;AAC/C,mBAAW,QAAQ,eAAe;AAChC,gBAAM,OAAO,4BAA4B,IAAI;AAC7C,cAAI,KAAK,EAAE,MAAM,WAAW,IAAI,IAAI,MAAM,MAAM,OAAO,IAAI,EAAE,CAAC;AAAA,QAChE;AACA,eAAO;AAAA,MACT;AACA,YAAM,QAAQ,OAAO,UAAmB;AACtC,iBAAS,MAAM;AAAA,UACb;AAAA,YACE,OAAO;AAAA,YACP;AAAA,YACA,MAAM;AAAA,cACJ,IAAI,MAAM,YAAY,KAAK,iBAAiB,KAAK,GAAG,IAAI,CAAC,SAAS;AAAA,gBAChE,QAAQ;AAAA,gBACR;AAAA,cACF,EAAE;AAAA,cACF,EAAE,QAAQ,QAAQ,KAAK,GAAG,IAAI,oBAAoB;AAAA,YACpD;AAAA,YACA,cAAc,GAAG,IAAI;AAAA,UACvB;AAAA,UACA;AAAA,QACF;AACA,eAAO;AAAA,MACT;AACA,YAAM,MAAM,OAAO,EAAE,MAAM,MAAM,MAAM;AACvC,YAAM,SAAS,MAAM,OAAO,WAAW,EAAE,MAAM,MAAM,MAAS;AAC9D,UAAI;AACF,cAAM,QAAQ,KAAK,QAAQ,QAAQ,YAAY,WAAW,OAAO,EAAE,MAAM,MAAM,MAAS;AAC1F,YAAM,MAAM,UAAU;AAAA,QACpB;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA,OAAO,MAAM,MAAM,OAAO;AAAA,QAC1B,GAAI,QAAQ,QAAQ,EAAE,OAAO,QAAQ,MAAM,IAAI,CAAC;AAAA,QAChD,GAAI,QAAQ,WAAW,EAAE,UAAU,QAAQ,SAAS,IAAI,CAAC;AAAA,QACzD,GAAI,QAAQ,SAAS,EAAE,QAAQ,QAAQ,OAAO,IAAI,CAAC;AAAA,QACnD,GAAI,QAAQ,YAAY,EAAE,WAAW,QAAQ,UAAU,IAAI,CAAC;AAAA,QAC5D,GAAI,QAAQ,UAAU,EAAE,SAAS,QAAQ,QAAQ,IAAI,CAAC;AAAA,MACxD,CAAC;AACD,YAAM,QAAQ,aAAa,KAAK,KAAK;AAAA,QACnC,GAAI,QAAQ,aAAa,EAAE,KAAK,QAAQ,WAAW,IAAI,CAAC;AAAA,QACxD,GAAI,QAAQ,aAAa,EAAE,YAAY,QAAQ,WAAW,IAAI,CAAC;AAAA,QAC/D,QAAQ,OAAO,QAAQ,GAAG;AAAA,MAC5B,CAAC;AACD,YAAM,MAAM,MAAM,OAAO;AACzB,aAAO,EAAE,OAAO,OAAO,OAAO,CAAC,UAAU,MAAM,MAAM,KAAK,EAAE;AAAA,IAC9D;AAAA,EACF;AACF;",
+  "sourcesContent": ["import type { Context } from '@earendil-works/chord';\nimport type { Harness, Registry, ToolRegistration } from '@earendil-works/pi-durable';\nimport type { ExecutionEnv } from '@earendil-works/pi-durable/env';\nimport { type Agents, live } from '../agents.ts';\nimport type { ProcessGroups } from '../kernel/groups.ts';\nimport type { Licks } from '../licks/licks.ts';\nimport { DEFAULT_LIMITS, loadRoles, packageDirs, type Roles } from '../roles/roles.ts';\nimport { type CliOptions, createCli, RUN_DIR } from './cli.ts';\nimport { guardExtension, scoopsExtension, scoopTasks } from './extension.ts';\nimport { type ControlPlane, controlPlane } from './requests.ts';\nimport { createScoops, type Scoops, type ScoopsHost } from './service.ts';\n\nexport const BUILTIN_ROLES = ['scout', 'worker', 'reviewer', 'oracle', 'delegate', 'gelatiere'];\nexport const PNPM_HOME = '/home/.local/share/pnpm';\n\nexport type Assets = (path: string) => Promise<string>;\n\nexport function packageAssets(base: URL = new URL('../../', import.meta.url)): Assets {\n  return async (path) => {\n    const response = await fetch(new URL(path, base));\n    if (!response.ok) throw new Error(`${path}: ${response.status}`);\n    return response.text();\n  };\n}\n\nexport interface AttachOptions {\n  harness: Harness;\n  agents: Agents;\n  groups: ProcessGroups;\n  env: ExecutionEnv;\n  home: string;\n  assets?: Assets;\n  pnpmHome?: string;\n  controlDir?: string;\n  sweepEvery?: number;\n  alive?: (pid: number) => Promise<boolean>;\n  reads: () => readonly string[];\n  sprinkle?: CliOptions['sprinkle'];\n  memory?: CliOptions['memory'];\n  gelatiere?: CliOptions['gelatiere'];\n  freezer?: CliOptions['freezer'];\n  mcp?: (names: readonly string[]) => ToolRegistration[];\n}\n\nexport interface ScoopsRuntime {\n  roles(context: Context): Promise<Roles>;\n  plane: ControlPlane;\n  close(context: Context): Promise<void>;\n}\n\nexport interface ScoopsSetup {\n  scoops: Scoops;\n  attach(options: AttachOptions, context: Context): Promise<ScoopsRuntime>;\n}\n\nexport const COMMANDS = ['agent', 'subagent', 'sprinkle', 'memory', 'gelatiere', 'freezer'];\n\nexport async function pnpmHomeOf(env: ExecutionEnv, context: Context): Promise<string> {\n  let out = '';\n  const ran = await env\n    .exec(\n      'printf %s \"$PNPM_HOME\"',\n      {\n        onOutput: (text) => {\n          out += text;\n        },\n      },\n      context\n    )\n    .catch(() => undefined);\n  return ran?.ok && ran.value.exitCode === 0 && /^\\/\\S*$/.test(out) ? out : PNPM_HOME;\n}\n\nasync function install(env: ExecutionEnv, script: string, pnpmHome: string, context: Context) {\n  await env.createDir(`${pnpmHome}/bin`, { recursive: true }, context);\n  for (const name of COMMANDS) {\n    const path = `${pnpmHome}/bin/${name}`;\n    await env.writeFile(path, script, context);\n    await env.exec(['chmod', '+x', path], undefined, context);\n  }\n}\n\nfunction mirror(agents: Agents, env: ExecutionEnv) {\n  return async (context: Context) => {\n    for (const [id, record] of Object.entries(agents.state().scoops)) {\n      const state = record.gone ? 'gone' : live(record) ? 'live' : 'stopped';\n      const metadata = {\n        handle: record.folder,\n        id,\n        name: record.name,\n        role: record.role,\n        cone: record.cone,\n        state,\n      };\n      await env.writeFile(\n        `${RUN_DIR}/${record.folder}/metadata.json`,\n        `${JSON.stringify(metadata, null, 2)}\\n`,\n        context\n      );\n    }\n  };\n}\n\nexport function setupScoops(\n  registry: Registry,\n  licks: Licks,\n  fileTools: readonly ToolRegistration[] = []\n): ScoopsSetup {\n  let bind: (host: ScoopsHost) => void = () => undefined;\n  const host = new Promise<ScoopsHost>((resolve) => {\n    bind = resolve;\n  });\n  const lookup = () => host;\n  const tasks = scoopTasks(lookup);\n  const scoops = createScoops(host, () => tasks);\n  let cached: Roles = { roles: [], warnings: [], limits: { ...DEFAULT_LIMITS } };\n  registry.install(scoopsExtension(tasks));\n  registry.install(guardExtension(lookup, fileTools));\n  return {\n    scoops,\n    async attach(options, context) {\n      const { harness, agents, groups, env, home } = options;\n      const assets = options.assets ?? packageAssets();\n      bind({\n        harness,\n        agents,\n        licks,\n        tools: fileTools,\n        groups,\n        reads: options.reads,\n        files: env,\n        ...(options.mcp ? { mcp: options.mcp } : {}),\n      });\n      const builtin = async () => {\n        const out: { path: string; text: string }[] = [];\n        for (const name of BUILTIN_ROLES) {\n          const path = `packages/vfs-root/agents/${name}.md`;\n          out.push({ path: `builtin:${name}`, text: await assets(path) });\n        }\n        return out;\n      };\n      const roles = async (using: Context) => {\n        cached = await loadRoles(\n          {\n            files: env,\n            builtin,\n            dirs: [\n              ...(await packageDirs(env, '/node_modules', using)).map((dir) => ({\n                source: 'package' as const,\n                dir,\n              })),\n              { source: 'user', dir: `${home}/.pi/agent/agents` },\n            ],\n            settingsPath: `${home}/.pi/agent/settings.json`,\n          },\n          using\n        );\n        return cached;\n      };\n      await roles(context).catch(() => cached);\n      const script = await assets('bin/agent').catch(() => undefined);\n      if (script) {\n        const pnpmHome = options.pnpmHome ?? (await pnpmHomeOf(env, context));\n        await install(env, script, pnpmHome, context).catch(() => undefined);\n      }\n      const cli = createCli({\n        env,\n        harness,\n        agents,\n        scoops,\n        roles: () => roles(context),\n        ...(options.alive ? { alive: options.alive } : {}),\n        ...(options.sprinkle ? { sprinkle: options.sprinkle } : {}),\n        ...(options.memory ? { memory: options.memory } : {}),\n        ...(options.gelatiere ? { gelatiere: options.gelatiere } : {}),\n        ...(options.freezer ? { freezer: options.freezer } : {}),\n      });\n      const plane = controlPlane(env, cli, {\n        ...(options.controlDir ? { dir: options.controlDir } : {}),\n        ...(options.sweepEvery ? { sweepEvery: options.sweepEvery } : {}),\n        mirror: mirror(agents, env),\n      });\n      await plane.start(context);\n      return { roles, plane, close: (using) => plane.close(using) };\n    },\n  };\n}\n\nexport type { Rewound, Scoops } from './service.ts';\n"],
+  "mappings": "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",
   "names": []
 }

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

@@ -40,5 +40,6 @@ export interface ScoopsSetup {
     attach(options: AttachOptions, context: Context): Promise<ScoopsRuntime>;
 }
 export declare const COMMANDS: string[];
+export declare function pnpmHomeOf(env: ExecutionEnv, context: Context): Promise<string>;
 export declare function setupScoops(registry: Registry, licks: Licks, fileTools?: readonly ToolRegistration[]): ScoopsSetup;
 export type { Rewound, Scoops } from './service.ts';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ai-ecoverse/slicc-agent",
-  "version": "3.29.0",
+  "version": "3.29.1",
   "description": "SLICC's agent core on pi durable: an agent worker, session storage, remoting and pi extensions",
   "type": "module",
   "license": "Apache-2.0",
@@ -62,11 +62,11 @@
   },
   "devDependencies": {
     "@ai-ecoverse/slicc-kernel": "1.26.3",
-    "@ai-ecoverse/slicc-shared-web": "1.12.0",
-    "@ai-ecoverse/slicc-spectrum": "1.46.0",
-    "@ai-ecoverse/wasm-bash": "5.3.0-11",
+    "@ai-ecoverse/slicc-shared-web": "1.12.1",
+    "@ai-ecoverse/slicc-spectrum": "1.47.3",
+    "@ai-ecoverse/wasm-bash": "5.3.0-12",
     "@ai-ecoverse/wasm-coreutils": "9.7.0-3",
-    "@ai-ecoverse/wasm-git": "2.55.0-12",
+    "@ai-ecoverse/wasm-git": "2.55.0-13",
     "@biomejs/biome": "2.5.15",
     "@types/node": "24.19.1",
     "esbuild": "0.28.2",