@ai-ecoverse/slicc-agent 3.48.1 → 3.49.0

package/dist/skills/index.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/skills/index.ts"],
-  "sourcesContent": ["import { type Context, type ReplicatedState, replicatedState } from '@earendil-works/chord';\nimport {\n  defineExtension,\n  type Extension,\n  type Registry,\n  section,\n} from '@earendil-works/pi-durable';\nimport type { ExecutionEnv, FileWatcher } from '@earendil-works/pi-durable/env';\nimport type { Licks } from '../licks/licks.ts';\nimport { manifestDirs } from '../roles/roles.ts';\nimport type { Command } from '../services.ts';\nimport {\n  type Diagnostic,\n  expandSkillCommand,\n  formatSkillsForPrompt,\n  loadSkills,\n  type Skill,\n  type SkillRoot,\n} from './skills.ts';\nimport { expandPromptTemplate, loadTemplates, type PromptTemplate } from './templates.ts';\n\nexport const BUILTIN_SKILLS = [\n  'agent',\n  'browser',\n  'gelatiere',\n  'licks',\n  'memory',\n  'skill-authoring',\n  'sprinkles',\n  'welcome',\n];\nexport const BUILTIN_PROMPTS = ['parallel-review', 'review-loop'];\nexport const SKILLS_DIR = '/var/lib/slicc/agent/skills';\nexport const PROMPTS_DIR = '/var/lib/slicc/agent/prompts';\nexport const GLOBAL_DIR = '/usr/share/skills';\nexport const RELOAD_MS = 300;\n\nexport interface SkillsRuntime {\n  readonly commands: ReplicatedState<Command[]>;\n  skills(): readonly Skill[];\n  dirs(): string[];\n  templates(): readonly PromptTemplate[];\n  expand(text: string, context: Context): Promise<string>;\n  reload(context: Context): Promise<void>;\n  close(context: Context): Promise<void>;\n}\n\nexport interface SkillsAttach {\n  env: ExecutionEnv;\n  home: string;\n  assets?: (path: string) => Promise<string>;\n  reloadMs: number;\n}\n\nexport interface SkillsSetup {\n  extension: Extension;\n  attach(options: SkillsAttach, context: Context): Promise<SkillsRuntime>;\n}\n\ntype Manifest = { pi?: { skills?: unknown; prompts?: unknown } };\n\nexport function piResources(dir: string, text: string, kind: 'skills' | 'prompts'): string[] {\n  let manifest: Manifest;\n  try {\n    manifest = JSON.parse(text) as Manifest;\n  } catch {\n    return [];\n  }\n  const listed = manifest.pi?.[kind];\n  const paths = Array.isArray(listed) ? listed : typeof listed === 'string' ? [listed] : [];\n  return paths\n    .filter((path): path is string => typeof path === 'string')\n    .map((path) => `${dir}/${path.replace(/^\\.\\//, '').replace(/\\/$/, '')}`);\n}\n\nasync function packaged(env: ExecutionEnv, kind: 'skills' | 'prompts', context: Context) {\n  const out: string[] = [];\n  for (const dir of await manifestDirs(env, '/node_modules', context)) {\n    const read = await env.readTextFile(`${dir}/package.json`, context);\n    if (read.ok) out.push(...piResources(dir, read.value, kind));\n  }\n  return out;\n}\n\nasync function installBuiltins(\n  env: ExecutionEnv,\n  assets: (path: string) => Promise<string>,\n  context: Context\n): Promise<void> {\n  await env.remove(SKILLS_DIR, { recursive: true, force: true }, context);\n  await env.remove(PROMPTS_DIR, { recursive: true, force: true }, context);\n  for (const name of BUILTIN_SKILLS) {\n    const text = await assets(`packages/vfs-root/skills/${name}/SKILL.md`).catch(() => undefined);\n    if (text === undefined) continue;\n    await env.createDir(`${SKILLS_DIR}/${name}`, { recursive: true }, context);\n    await env.writeFile(`${SKILLS_DIR}/${name}/SKILL.md`, text, context);\n  }\n  await env.createDir(PROMPTS_DIR, { recursive: true }, context);\n  for (const name of BUILTIN_PROMPTS) {\n    const text = await assets(`packages/vfs-root/prompts/${name}.md`).catch(() => undefined);\n    if (text !== undefined) await env.writeFile(`${PROMPTS_DIR}/${name}.md`, text, context);\n  }\n}\n\nexport function problemLick(problem: Diagnostic, home: string) {\n  const path = problem.path.startsWith(`${home}/`)\n    ? `~${problem.path.slice(home.length)}`\n    : problem.path;\n  return {\n    channel: 'fswatch' as const,\n    source: `skills:${path}`,\n    title: `Skill or prompt template problem: ${path}`,\n    text: problem.message,\n    body: 'The file is used with this problem, or skipped if it has no description.\\nThe rules are in the slicc-agent README.',\n    target: 'cone' as const,\n    severity: 'warn' as const,\n    eventId: `${path}\\n${problem.message}`,\n  };\n}\n\nexport const SECRETS_ACTION: Command = {\n  name: 'secrets',\n  description: 'List the secrets the agent can use, and where each works',\n  kind: 'action',\n};\n\nexport function commandsOf(\n  skills: readonly Skill[],\n  templates: readonly PromptTemplate[]\n): Command[] {\n  return [\n    ...templates.map((template) => ({\n      name: template.name,\n      description: template.description,\n      kind: 'prompt' as const,\n    })),\n    ...skills.map((skill) => ({\n      name: `skill:${skill.name}`,\n      description: skill.description,\n      kind: 'skill' as const,\n    })),\n    SECRETS_ACTION,\n  ];\n}\n\nexport function setupSkills(registry: Registry, licks: Licks): SkillsSetup {\n  let current: Skill[] = [];\n  const extension = defineExtension({\n    name: 'slicc-skills',\n    sections: [section('skills', async () => formatSkillsForPrompt(current) || undefined)],\n  });\n  registry.install(extension);\n  return {\n    extension,\n    async attach(options, context) {\n      const { env, home } = options;\n      if (options.assets)\n        await installBuiltins(env, options.assets, context).catch(() => undefined);\n      await env.exec(`mkdir -p ${GLOBAL_DIR} && chmod 755 ${GLOBAL_DIR}`, undefined, context);\n      let templates: PromptTemplate[] = [];\n      const commands = replicatedState<Command[]>([]);\n      const reported = new Set<string>();\n      const reload = async (using: Context) => {\n        const roots: SkillRoot[] = [\n          { dir: `${home}/.pi/agent/skills`, source: 'user' },\n          { dir: `${home}/.agents/skills`, source: 'user' },\n          { dir: GLOBAL_DIR, source: 'global' },\n          ...(await packaged(env, 'skills', using)).map((dir) => ({\n            dir,\n            source: 'package' as const,\n          })),\n          { dir: SKILLS_DIR, source: 'builtin' },\n        ];\n        const loaded = await loadSkills(env, roots, using);\n        const prompts = await loadTemplates(\n          env,\n          [`${home}/.pi/agent/prompts`, ...(await packaged(env, 'prompts', using)), PROMPTS_DIR],\n          using\n        );\n        current = loaded.skills;\n        templates = prompts.templates;\n        commands.replace(using, commandsOf(current, templates));\n        for (const problem of [...loaded.diagnostics, ...prompts.diagnostics]) {\n          const key = `${problem.path}\\n${problem.message}`;\n          if (reported.has(key)) continue;\n          reported.add(key);\n          await licks.deliver(problemLick(problem, home), using).catch(() => undefined);\n        }\n      };\n      await reload(context);\n      let timer: ReturnType<typeof setTimeout> | undefined;\n      const schedule = () => {\n        clearTimeout(timer);\n        timer = setTimeout(() => void reload(context).catch(() => undefined), options.reloadMs);\n      };\n      const watched = await env.watch(\n        [\n          { path: `${home}/.pi/agent/skills`, recursive: true },\n          { path: `${home}/.pi/agent/prompts` },\n          { path: `${home}/.agents/skills`, recursive: true },\n          { path: GLOBAL_DIR, recursive: true },\n        ],\n        schedule,\n        context\n      );\n      const watcher: FileWatcher | undefined = watched.ok ? watched.value : undefined;\n      return {\n        commands,\n        skills: () => current,\n        dirs: () => current.map((skill) => skill.baseDir),\n        templates: () => templates,\n        async expand(text, using) {\n          const expanded = await expandSkillCommand(text, current, env, using);\n          return expanded === text ? expandPromptTemplate(text, templates) : expanded;\n        },\n        reload,\n        async close(using) {\n          clearTimeout(timer);\n          await watcher?.close(using);\n        },\n      };\n    },\n  };\n}\n"],
-  "mappings": "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",
-  "names": []
+  "sourcesContent": ["import { type Context, type ReplicatedState, replicatedState } from '@earendil-works/chord';\nimport {\n  defineExtension,\n  type Extension,\n  type Registry,\n  section,\n} from '@earendil-works/pi-durable';\nimport type { ExecutionEnv, FileWatcher } from '@earendil-works/pi-durable/env';\nimport type { Licks } from '../licks/licks.ts';\nimport { manifestDirs } from '../roles/roles.ts';\nimport type { Command } from '../services.ts';\nimport {\n  type Diagnostic,\n  expandSkillCommand,\n  formatSkillsForPrompt,\n  loadSkills,\n  type Skill,\n  type SkillRoot,\n} from './skills.ts';\nimport { expandPromptTemplate, loadTemplates, type PromptTemplate } from './templates.ts';\n\nexport const BUILTIN_SKILLS = [\n  'agent',\n  'browser',\n  'gelatiere',\n  'licks',\n  'memory',\n  'skill-authoring',\n  'sprinkles',\n  'welcome',\n];\nexport const BUILTIN_PROMPTS = ['parallel-review', 'review-loop'];\nexport const SKILLS_DIR = '/var/lib/slicc/agent/skills';\nexport const PROMPTS_DIR = '/var/lib/slicc/agent/prompts';\nexport const GLOBAL_DIR = '/usr/share/skills';\nexport const RELOAD_MS = 300;\n\nexport interface SkillsRuntime {\n  readonly commands: ReplicatedState<Command[]>;\n  skills(): readonly Skill[];\n  dirs(): string[];\n  templates(): readonly PromptTemplate[];\n  expand(text: string, context: Context, conversationId?: number): Promise<string>;\n  reload(context: Context): Promise<void>;\n  close(context: Context): Promise<void>;\n}\n\nexport interface SkillsAttach {\n  env: ExecutionEnv;\n  home: string;\n  agentDir?: string;\n  assets?: (path: string) => Promise<string>;\n  reloadMs: number;\n  people?: SkillPeople;\n}\n\nexport interface SkillPeople {\n  homes(): readonly string[];\n  homeOf(conversationId: number | undefined): string | undefined;\n  envOf(home: string): Promise<ExecutionEnv | undefined>;\n}\n\nexport function userRoots(homes: readonly string[]): SkillRoot[] {\n  return homes.flatMap((home) => [\n    { dir: `${home}/.pi/agent/skills`, source: 'user' as const },\n    { dir: `${home}/.agents/skills`, source: 'user' as const },\n  ]);\n}\n\nexport interface SkillsSetup {\n  extension: Extension;\n  attach(options: SkillsAttach, context: Context): Promise<SkillsRuntime>;\n}\n\ntype Manifest = { pi?: { skills?: unknown; prompts?: unknown } };\n\nexport function piResources(dir: string, text: string, kind: 'skills' | 'prompts'): string[] {\n  let manifest: Manifest;\n  try {\n    manifest = JSON.parse(text) as Manifest;\n  } catch {\n    return [];\n  }\n  const listed = manifest.pi?.[kind];\n  const paths = Array.isArray(listed) ? listed : typeof listed === 'string' ? [listed] : [];\n  return paths\n    .filter((path): path is string => typeof path === 'string')\n    .map((path) => `${dir}/${path.replace(/^\\.\\//, '').replace(/\\/$/, '')}`);\n}\n\nasync function packaged(env: ExecutionEnv, kind: 'skills' | 'prompts', context: Context) {\n  const out: string[] = [];\n  for (const dir of await manifestDirs(env, '/node_modules', context)) {\n    const read = await env.readTextFile(`${dir}/package.json`, context);\n    if (read.ok) out.push(...piResources(dir, read.value, kind));\n  }\n  return out;\n}\n\nasync function installBuiltins(\n  env: ExecutionEnv,\n  assets: (path: string) => Promise<string>,\n  context: Context\n): Promise<void> {\n  await env.remove(SKILLS_DIR, { recursive: true, force: true }, context);\n  await env.remove(PROMPTS_DIR, { recursive: true, force: true }, context);\n  for (const name of BUILTIN_SKILLS) {\n    const text = await assets(`packages/vfs-root/skills/${name}/SKILL.md`).catch(() => undefined);\n    if (text === undefined) continue;\n    await env.createDir(`${SKILLS_DIR}/${name}`, { recursive: true }, context);\n    await env.writeFile(`${SKILLS_DIR}/${name}/SKILL.md`, text, context);\n  }\n  await env.createDir(PROMPTS_DIR, { recursive: true }, context);\n  for (const name of BUILTIN_PROMPTS) {\n    const text = await assets(`packages/vfs-root/prompts/${name}.md`).catch(() => undefined);\n    if (text !== undefined) await env.writeFile(`${PROMPTS_DIR}/${name}.md`, text, context);\n  }\n}\n\nexport function problemLick(problem: Diagnostic, home: string) {\n  const path = problem.path.startsWith(`${home}/`)\n    ? `~${problem.path.slice(home.length)}`\n    : problem.path;\n  return {\n    channel: 'fswatch' as const,\n    source: `skills:${path}`,\n    title: `Skill or prompt template problem: ${path}`,\n    text: problem.message,\n    body: 'The file is used with this problem, or skipped if it has no description.\\nThe rules are in the slicc-agent README.',\n    target: 'cone' as const,\n    severity: 'warn' as const,\n    eventId: `${path}\\n${problem.message}`,\n  };\n}\n\nexport const SECRETS_ACTION: Command = {\n  name: 'secrets',\n  description: 'List the secrets the agent can use, and where each works',\n  kind: 'action',\n};\n\nexport function commandsOf(\n  skills: readonly Skill[],\n  templates: readonly PromptTemplate[]\n): Command[] {\n  return [\n    ...templates.map((template) => ({\n      name: template.name,\n      description: template.description,\n      kind: 'prompt' as const,\n    })),\n    ...skills.map((skill) => ({\n      name: `skill:${skill.name}`,\n      description: skill.description,\n      kind: 'skill' as const,\n    })),\n    SECRETS_ACTION,\n  ];\n}\n\nexport function setupSkills(registry: Registry, licks: Licks): SkillsSetup {\n  let current: Skill[] = [];\n  let own = new Map<string, Skill[]>();\n  let people: SkillPeople | undefined;\n  const mine = (conversationId: number | undefined) => {\n    const at = people?.homeOf(conversationId);\n    return (at ? own.get(at) : undefined) ?? current;\n  };\n  const extension = defineExtension({\n    name: 'slicc-skills',\n    sections: [\n      section('skills', async (input) => {\n        return formatSkillsForPrompt(mine(input.conversationId)) || undefined;\n      }),\n    ],\n  });\n  registry.install(extension);\n  return {\n    extension,\n    async attach(options, context) {\n      const { env, home } = options;\n      const dir = options.agentDir ?? `${home}/.pi/agent`;\n      people = options.people;\n      const homes = () => options.people?.homes() ?? [];\n      if (options.assets)\n        await installBuiltins(env, options.assets, context).catch(() => undefined);\n      await env.exec(`mkdir -p ${GLOBAL_DIR} && chmod 755 ${GLOBAL_DIR}`, undefined, context);\n      let templates: PromptTemplate[] = [];\n      const commands = replicatedState<Command[]>([]);\n      const reported = new Set<string>();\n      const reload = async (using: Context) => {\n        const roots: SkillRoot[] = [\n          ...(options.people\n            ? [{ dir: GLOBAL_DIR, source: 'global' as const }]\n            : [\n                { dir: `${dir}/skills`, source: 'user' as const },\n                { dir: `${home}/.agents/skills`, source: 'user' as const },\n                { dir: GLOBAL_DIR, source: 'global' as const },\n              ]),\n          ...(await packaged(env, 'skills', using)).map((dir) => ({\n            dir,\n            source: 'package' as const,\n          })),\n          { dir: SKILLS_DIR, source: 'builtin' },\n        ];\n        const loaded = await loadSkills(env, roots, using);\n        const homesLoaded = new Map<string, Skill[]>();\n        for (const at of homes()) {\n          const files = await options.people?.envOf(at);\n          if (!files) continue;\n          const found = await loadSkills(files, [...userRoots([at]), ...roots], using);\n          homesLoaded.set(at, found.skills);\n          loaded.diagnostics.push(...found.diagnostics);\n        }\n        own = homesLoaded;\n        const prompts = await loadTemplates(\n          env,\n          [`${dir}/prompts`, ...(await packaged(env, 'prompts', using)), PROMPTS_DIR],\n          using\n        );\n        current = loaded.skills;\n        templates = prompts.templates;\n        commands.replace(using, commandsOf(current, templates));\n        for (const problem of [...loaded.diagnostics, ...prompts.diagnostics]) {\n          const key = `${problem.path}\\n${problem.message}`;\n          if (reported.has(key)) continue;\n          reported.add(key);\n          await licks.deliver(problemLick(problem, home), using).catch(() => undefined);\n        }\n      };\n      await reload(context);\n      let timer: ReturnType<typeof setTimeout> | undefined;\n      const schedule = () => {\n        clearTimeout(timer);\n        timer = setTimeout(() => void reload(context).catch(() => undefined), options.reloadMs);\n      };\n      let watcher: FileWatcher | undefined;\n      let seen = '';\n      const watch = async (using: Context) => {\n        const extra = options.people\n          ? userRoots(homes()).map((root) => ({ path: root.dir, recursive: true }))\n          : [\n              { path: `${dir}/skills`, recursive: true },\n              { path: `${home}/.agents/skills`, recursive: true },\n            ];\n        const key = JSON.stringify(extra);\n        if (key === seen) return;\n        seen = key;\n        await watcher?.close(using);\n        const watched = await env.watch(\n          [{ path: GLOBAL_DIR, recursive: true }, { path: `${dir}/prompts` }, ...extra],\n          schedule,\n          using\n        );\n        watcher = watched.ok ? watched.value : undefined;\n      };\n      await watch(context);\n      return {\n        commands,\n        skills: () => current,\n        dirs: () => current.map((skill) => skill.baseDir),\n        templates: () => templates,\n        async expand(text, using, conversationId) {\n          const at = people?.homeOf(conversationId);\n          const files = at ? await people?.envOf(at) : env;\n          if (!files) return text;\n          const expanded = await expandSkillCommand(text, mine(conversationId), files, using);\n          return expanded === text ? expandPromptTemplate(text, templates) : expanded;\n        },\n        async reload(using) {\n          await watch(using);\n          await reload(using);\n        },\n        async close(using) {\n          clearTimeout(timer);\n          await watcher?.close(using);\n        },\n      };\n    },\n  };\n}\n"],
+  "mappings": "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",
+  "names": ["dir"]
 }

package/dist/sprinkles/index.js

@@ -12,37 +12,65 @@ import {
   SUGGESTIONS,
   SUGGESTIONS_DIR,
   SUGGESTIONS_STORE,
+  sharedPaths,
   sprinkleFiles,
   WELCOME,
   WELCOME_PROFILE,
   WELCOMED
 } from "./sprinkles.js";
+const BUILTIN = /* @__PURE__ */ new Set([WELCOME, SUGGESTIONS]);
 function targetOf(agentId) {
   return agentId.startsWith("scoop:") ? agentId : `cone:${agentId}`;
 }
+function liveOwner(agents, owner) {
+  if (!owner) return void 0;
+  const state = agents.state();
+  if (state.cones[owner]) return owner;
+  const scoop = state.scoops[owner];
+  return scoop && live(scoop) ? owner : void 0;
+}
 function ownerOf(agents, owner) {
   const state = agents.state();
   if (owner && state.cones[owner]) return owner;
   const scoop = owner ? state.scoops[owner] : void 0;
   return scoop && live(scoop) ? owner : agents.activeCone();
 }
-function entry(name, html, agentId) {
-  return { id: name, name, ...describe(name, html), agentId, html };
+function entry(name, html, agentId, id = name) {
+  return { id, name, ...describe(name, html), agentId, html };
+}
+function placesOf(options, dir) {
+  return options.places?.() ?? [{ dir, cone: "" }];
+}
+async function filesIn(options, dir, reserved, owned, using, found = {}) {
+  const { env, agents } = options;
+  const out = [];
+  for (const place of placesOf(options, dir))
+    for (const { name, path } of await sprinkleFiles(env, place.dir, using)) {
+      const id = place.cone ? `${place.cone}/${name}` : name;
+      if (reserved.has(name) || out.some((item) => item.id === id)) continue;
+      const read = await env.readTextFile(path, using);
+      if (place.cone && !owned[id]) found[id] = place.cone;
+      const owner = owned[id] ?? (place.cone || void 0);
+      if (read.ok) out.push(entry(name, read.value, ownerOf(agents, owner), id));
+    }
+  return out;
 }
 function reloader(options, dir, builtins, sprinkles, owners) {
   const { env, agents } = options;
   const { welcome, suggestions } = builtins;
   return async (using) => {
     const owned = await owners(using);
-    const stored = suggestions === void 0 ? void 0 : await env.exists(SUGGESTIONS_STORE, using);
+    const store = options.shared ? sharedPaths(options.shared).suggestions : SUGGESTIONS_STORE;
+    const stored = suggestions === void 0 ? void 0 : await env.exists(store, using);
     const offered = stored?.ok === true && stored.value;
     const reserved = /* @__PURE__ */ new Set([WELCOME, ...offered ? [SUGGESTIONS] : []]);
-    const out = [];
-    for (const { name, path } of await sprinkleFiles(env, dir, using)) {
-      if (reserved.has(name)) continue;
-      const read = await env.readTextFile(path, using);
-      if (read.ok) out.push(entry(name, read.value, ownerOf(agents, owned[name])));
-    }
+    const found = {};
+    const out = await filesIn(options, dir, reserved, owned, using, found);
+    if (Object.keys(found).length)
+      await options.harness.commit(async (tx) => {
+        const doc = await tx.doc(SprinklesDoc);
+        for (const [id, cone] of Object.entries(found)) doc.owners[id] ??= cone;
+      }, using);
     if (offered)
       out.push(entry(SUGGESTIONS, suggestions, ownerOf(agents, owned[SUGGESTIONS])));
     if (welcome !== void 0)
@@ -53,6 +81,36 @@ function reloader(options, dir, builtins, sprinkles, owners) {
     sprinkles.replace(using, out);
   };
 }
+const NO_OWNER = "this sprinkle has no owner, so it can only be shown";
+async function ownedRead(files, asked, home, using) {
+  const real = await files.canonicalPath(asked, using);
+  const path = real.ok ? homePath(real.value, home, home) : asked;
+  return {
+    files,
+    path,
+    async check() {
+      const again = await files.canonicalPath(path, using);
+      if (again.ok && again.value !== path)
+        throw new Error(`${asked} changed while it was read; read it again`);
+    }
+  };
+}
+function readerFor(options, owners, inside) {
+  const { env, agents } = options;
+  const none = async () => void 0;
+  return async (id, path, using) => {
+    if (options.shared && BUILTIN.has(id))
+      return { files: env, path: homePath(path, options.shared, options.shared), check: none };
+    if (!options.places) return { files: env, path: await inside(path, using), check: none };
+    const owner = liveOwner(agents, (await owners(using))[id]);
+    if (!owner) throw new Error(NO_OWNER);
+    const agentId = owner.startsWith("scoop:") ? owner : `cone:${owner}`;
+    const home = options.homeOf?.(agentId);
+    const files = await options.envOf?.(agentId, using);
+    if (!home || !files) throw new Error(NO_OWNER);
+    return ownedRead(files, homePath(path, home, home), home, using);
+  };
+}
 function setupSprinkles() {
   return {
     async attach(options, context) {
@@ -69,6 +127,8 @@ function setupSprinkles() {
         const real = await env.canonicalPath(asked, using);
         return real.ok ? homePath(real.value) : asked;
       };
+      const paths = options.shared ? sharedPaths(options.shared) : void 0;
+      const reader = readerFor(options, owners, inside);
       const offCone = agents.onCone(() => reload(context).catch(() => void 0));
       const find = (id) => sprinkles.value.find((item) => item.id === id);
       const post = async (id, agentId, using) => {
@@ -88,15 +148,28 @@ function setupSprinkles() {
         }, context);
       }
       let timer;
-      const watched = await env.watch(
-        [{ path: dir, recursive: true }, { path: SUGGESTIONS_DIR }],
-        () => {
-          clearTimeout(timer);
-          timer = setTimeout(() => void reload(context).catch(() => void 0), options.reloadMs);
-        },
-        context
-      );
-      const watcher = watched.ok ? watched.value : void 0;
+      let watcher;
+      let seen = "";
+      const watch = async (using) => {
+        const dirs = placesOf(options, dir).map((place) => place.dir);
+        const key = dirs.join("\n");
+        if (key === seen) return;
+        seen = key;
+        await watcher?.close(using);
+        const watched = await env.watch(
+          [
+            ...dirs.map((path) => ({ path, recursive: true })),
+            { path: paths?.suggestionsDir ?? SUGGESTIONS_DIR }
+          ],
+          () => {
+            clearTimeout(timer);
+            timer = setTimeout(() => void reload(context).catch(() => void 0), options.reloadMs);
+          },
+          using
+        );
+        watcher = watched.ok ? watched.value : void 0;
+      };
+      await watch(context);
       return {
         sprinkles,
         async send(id, payload, using) {
@@ -104,16 +177,23 @@ function setupSprinkles() {
           if (!sprinkle) return { delivered: false };
           if (await options.intercept?.(id, payload, using)) return { delivered: true };
           if (id === WELCOME && payload.action === "onboarding-complete") {
-            await env.writeFile(WELCOMED, `${(/* @__PURE__ */ new Date()).toISOString()}
-`, using);
+            await env.writeFile(
+              paths?.welcomed ?? WELCOMED,
+              `${(/* @__PURE__ */ new Date()).toISOString()}
+`,
+              using
+            );
             if (payload.data && typeof payload.data === "object" && !Array.isArray(payload.data))
               await env.writeFile(
-                WELCOME_PROFILE,
+                paths?.profile ?? WELCOME_PROFILE,
                 `${JSON.stringify(payload.data, null, 2)}
 `,
                 using
               );
           }
+          const owner = (await owners(using))[id];
+          if (options.places && !BUILTIN.has(id) && !liveOwner(agents, owner))
+            return { delivered: false };
           await licks.deliver(
             {
               channel: "sprinkle",
@@ -121,7 +201,7 @@ function setupSprinkles() {
               title: sprinkle.title,
               text: payload.action || "(no action)",
               ...payload.data === null ? {} : { body: JSON.stringify(payload.data, null, 2) },
-              target: targetOf(ownerOf(agents, (await owners(using))[id]))
+              target: targetOf(ownerOf(agents, owner))
             },
             using
           );
@@ -131,12 +211,15 @@ function setupSprinkles() {
           if (!find(id)) throw new Error(`there is no sprinkle ${id}`);
           const handlers = {
             async readFile() {
-              const read = await env.readTextFile(await inside(args[0], using), using);
+              const { files, path, check } = await reader(id, args[0], using);
+              const read = await files.readTextFile(path, using);
               if (!read.ok) throw new Error(read.error.message);
+              await check();
               return read.value;
             },
             async exists() {
-              const found = await env.exists(await inside(args[0], using), using);
+              const { files, path } = await reader(id, args[0], using);
+              const found = await files.exists(path, using);
               return found.ok && found.value;
             },
             async getState() {
@@ -162,7 +245,10 @@ function setupSprinkles() {
           }, using);
           await reload(using);
         },
-        reload,
+        async reload(using) {
+          await watch(using);
+          await reload(using);
+        },
         async close(using) {
           offCone();
           clearTimeout(timer);
@@ -173,6 +259,9 @@ function setupSprinkles() {
   };
 }
 export {
+  NO_OWNER,
+  liveOwner,
+  ownedRead,
   ownerOf,
   setupSprinkles
 };

package/dist/sprinkles/index.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/sprinkles/index.ts"],
-  "sourcesContent": ["import {\n  type Context,\n  type JsonValue,\n  type ReplicatedState,\n  replicatedState,\n} from '@earendil-works/chord';\nimport type { Harness } from '@earendil-works/pi-durable';\nimport type { ExecutionEnv, FileWatcher } from '@earendil-works/pi-durable/env';\nimport { type Agents, live } from '../agents.ts';\nimport type { LickTarget } from '../licks/lick.ts';\nimport type { Licks } from '../licks/licks.ts';\nimport {\n  describe,\n  homePath,\n  NO_EXEC,\n  SPRINKLE_KIND,\n  SPRINKLES_DIR,\n  type Sprinkle,\n  type SprinkleMethod,\n  SprinklesDoc,\n  SUGGESTIONS,\n  SUGGESTIONS_DIR,\n  SUGGESTIONS_STORE,\n  sprinkleFiles,\n  WELCOME,\n  WELCOME_PROFILE,\n  WELCOMED,\n} from './sprinkles.ts';\n\nexport interface SprinklePayload {\n  action: string;\n  data: JsonValue | null;\n  target: string | null;\n}\n\nexport interface SprinklesRuntime {\n  readonly sprinkles: ReplicatedState<Sprinkle[]>;\n  send(id: string, payload: SprinklePayload, context: Context): Promise<{ delivered: boolean }>;\n  call(id: string, method: string, args: readonly unknown[], context: Context): Promise<JsonValue>;\n  claim(id: string, cone: string, context: Context): Promise<void>;\n  reload(context: Context): Promise<void>;\n  close(context: Context): Promise<void>;\n}\n\nexport interface SprinklesAttach {\n  harness: Harness;\n  agents: Agents;\n  licks: Licks;\n  env: ExecutionEnv;\n  assets?: (path: string) => Promise<string>;\n  reloadMs: number;\n  dir?: string;\n  intercept?: (id: string, payload: SprinklePayload, context: Context) => Promise<boolean>;\n}\n\nfunction targetOf(agentId: string): LickTarget {\n  return agentId.startsWith('scoop:') ? (agentId as LickTarget) : `cone:${agentId}`;\n}\n\nexport function ownerOf(agents: Agents, owner: string | undefined): string {\n  const state = agents.state();\n  if (owner && state.cones[owner]) return owner;\n  const scoop = owner ? state.scoops[owner] : undefined;\n  return scoop && live(scoop) ? (owner as string) : agents.activeCone();\n}\n\nfunction entry(name: string, html: string, agentId: string): Sprinkle {\n  return { id: name, name, ...describe(name, html), agentId, html };\n}\n\nfunction reloader(\n  options: SprinklesAttach,\n  dir: string,\n  builtins: { welcome: string | undefined; suggestions: string | undefined },\n  sprinkles: ReplicatedState<Sprinkle[]> & { replace(context: Context, value: Sprinkle[]): void },\n  owners: (context: Context) => Promise<Record<string, string>>\n) {\n  const { env, agents } = options;\n  const { welcome, suggestions } = builtins;\n  return async (using: Context) => {\n    const owned = await owners(using);\n    const stored =\n      suggestions === undefined ? undefined : await env.exists(SUGGESTIONS_STORE, using);\n    const offered = stored?.ok === true && stored.value;\n    const reserved = new Set([WELCOME, ...(offered ? [SUGGESTIONS] : [])]);\n    const out: Sprinkle[] = [];\n    for (const { name, path } of await sprinkleFiles(env, dir, using)) {\n      if (reserved.has(name)) continue;\n      const read = await env.readTextFile(path, using);\n      if (read.ok) out.push(entry(name, read.value, ownerOf(agents, owned[name])));\n    }\n    if (offered)\n      out.push(entry(SUGGESTIONS, suggestions as string, ownerOf(agents, owned[SUGGESTIONS])));\n    if (welcome !== undefined)\n      out.push({\n        ...entry(WELCOME, welcome, ownerOf(agents, owned[WELCOME] ?? 'cone')),\n        inline: true,\n      });\n    sprinkles.replace(using, out);\n  };\n}\n\nexport function setupSprinkles() {\n  return {\n    async attach(options: SprinklesAttach, context: Context): Promise<SprinklesRuntime> {\n      const { harness, agents, licks, env } = options;\n      const dir = options.dir ?? SPRINKLES_DIR;\n      const sprinkles = replicatedState<Sprinkle[]>([]);\n      const builtin = (name: string) =>\n        options.assets\n          ? options.assets(`packages/vfs-root/sprinkles/${name}.shtml`).catch(() => undefined)\n          : Promise.resolve(undefined);\n      const welcome = await builtin(WELCOME);\n      const suggestions = await builtin(SUGGESTIONS);\n      const owners = async (using: Context) =>\n        (await harness.snapshot(SprinklesDoc, using))?.owners ?? {};\n      const reload = reloader(options, dir, { welcome, suggestions }, sprinkles, owners);\n      const inside = async (path: unknown, using: Context) => {\n        const asked = homePath(path);\n        const real = await env.canonicalPath(asked, using);\n        return real.ok ? homePath(real.value) : asked;\n      };\n      const offCone = agents.onCone(() => reload(context).catch(() => undefined));\n      const find = (id: string) => sprinkles.value.find((item) => item.id === id);\n      const post = async (id: string, agentId: string, using: Context) => {\n        const conversation = await agents.conversation(agentId, using);\n        if (!conversation) throw new Error(`there is no agent ${agentId}`);\n        await conversation.submit(\n          { type: 'write', entry: { kind: SPRINKLE_KIND, data: { sprinkle: id, at: Date.now() } } },\n          using\n        );\n      };\n      await reload(context);\n      const state = await harness.snapshot(SprinklesDoc, context);\n      if (welcome !== undefined && !state?.welcomed) {\n        await post(WELCOME, 'cone', context);\n        await harness.commit(async (tx) => {\n          (await tx.doc(SprinklesDoc)).welcomed = true;\n        }, context);\n      }\n      let timer: ReturnType<typeof setTimeout> | undefined;\n      const watched = await env.watch(\n        [{ path: dir, recursive: true }, { path: SUGGESTIONS_DIR }],\n        () => {\n          clearTimeout(timer);\n          timer = setTimeout(() => void reload(context).catch(() => undefined), options.reloadMs);\n        },\n        context\n      );\n      const watcher: FileWatcher | undefined = watched.ok ? watched.value : undefined;\n      return {\n        sprinkles,\n        async send(id, payload, using) {\n          const sprinkle = find(id);\n          if (!sprinkle) return { delivered: false };\n          if (await options.intercept?.(id, payload, using)) return { delivered: true };\n          if (id === WELCOME && payload.action === 'onboarding-complete') {\n            await env.writeFile(WELCOMED, `${new Date().toISOString()}\\n`, using);\n            if (payload.data && typeof payload.data === 'object' && !Array.isArray(payload.data))\n              await env.writeFile(\n                WELCOME_PROFILE,\n                `${JSON.stringify(payload.data, null, 2)}\\n`,\n                using\n              );\n          }\n          await licks.deliver(\n            {\n              channel: 'sprinkle',\n              source: `sprinkle:${id}`,\n              title: sprinkle.title,\n              text: payload.action || '(no action)',\n              ...(payload.data === null ? {} : { body: JSON.stringify(payload.data, null, 2) }),\n              target: targetOf(ownerOf(agents, (await owners(using))[id])),\n            },\n            using\n          );\n          return { delivered: true };\n        },\n        async call(id, method, args, using) {\n          if (!find(id)) throw new Error(`there is no sprinkle ${id}`);\n          const handlers: Record<SprinkleMethod, () => Promise<JsonValue>> = {\n            async readFile() {\n              const read = await env.readTextFile(await inside(args[0], using), using);\n              if (!read.ok) throw new Error(read.error.message);\n              return read.value;\n            },\n            async exists() {\n              const found = await env.exists(await inside(args[0], using), using);\n              return found.ok && found.value;\n            },\n            async getState() {\n              return (await harness.snapshot(SprinklesDoc, using))?.state[id] ?? null;\n            },\n            async setState() {\n              await harness.commit(async (tx) => {\n                (await tx.doc(SprinklesDoc)).state[id] = (args[0] ?? null) as JsonValue;\n              }, using);\n              return null;\n            },\n          };\n          const handler = handlers[method as SprinkleMethod];\n          if (!handler) throw new Error(NO_EXEC);\n          return handler();\n        },\n        async claim(id, cone, using) {\n          await reload(using);\n          if (id === SUGGESTIONS || !find(id) || (await owners(using))[id]) return;\n          await harness.commit(async (tx) => {\n            const doc = await tx.doc(SprinklesDoc);\n            doc.owners[id] ??= cone;\n          }, using);\n          await reload(using);\n        },\n        reload,\n        async close(using) {\n          offCone();\n          clearTimeout(timer);\n          await watcher?.close(using);\n        },\n      };\n    },\n  };\n}\n"],
-  "mappings": "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",
+  "sourcesContent": ["import {\n  type Context,\n  type JsonValue,\n  type ReplicatedState,\n  replicatedState,\n} from '@earendil-works/chord';\nimport type { Harness } from '@earendil-works/pi-durable';\nimport type { ExecutionEnv, FileWatcher } from '@earendil-works/pi-durable/env';\nimport { type Agents, live } from '../agents.ts';\nimport type { LickTarget } from '../licks/lick.ts';\nimport type { Licks } from '../licks/licks.ts';\nimport {\n  describe,\n  homePath,\n  NO_EXEC,\n  SPRINKLE_KIND,\n  SPRINKLES_DIR,\n  type Sprinkle,\n  type SprinkleMethod,\n  SprinklesDoc,\n  SUGGESTIONS,\n  SUGGESTIONS_DIR,\n  SUGGESTIONS_STORE,\n  sharedPaths,\n  sprinkleFiles,\n  WELCOME,\n  WELCOME_PROFILE,\n  WELCOMED,\n} from './sprinkles.ts';\n\nexport interface SprinklePayload {\n  action: string;\n  data: JsonValue | null;\n  target: string | null;\n}\n\nexport interface SprinklesRuntime {\n  readonly sprinkles: ReplicatedState<Sprinkle[]>;\n  send(id: string, payload: SprinklePayload, context: Context): Promise<{ delivered: boolean }>;\n  call(id: string, method: string, args: readonly unknown[], context: Context): Promise<JsonValue>;\n  claim(id: string, cone: string, context: Context): Promise<void>;\n  reload(context: Context): Promise<void>;\n  close(context: Context): Promise<void>;\n}\n\nexport interface SprinklesAttach {\n  harness: Harness;\n  agents: Agents;\n  licks: Licks;\n  env: ExecutionEnv;\n  assets?: (path: string) => Promise<string>;\n  reloadMs: number;\n  dir?: string;\n  intercept?: (id: string, payload: SprinklePayload, context: Context) => Promise<boolean>;\n  places?: () => readonly SprinklePlace[];\n  envOf?: (agentId: string, context: Context) => Promise<ExecutionEnv | undefined>;\n  homeOf?: (agentId: string) => string | undefined;\n  shared?: string;\n}\n\nconst BUILTIN = new Set([WELCOME, SUGGESTIONS]);\n\nexport interface SprinklePlace {\n  dir: string;\n  cone: string;\n}\n\nfunction targetOf(agentId: string): LickTarget {\n  return agentId.startsWith('scoop:') ? (agentId as LickTarget) : `cone:${agentId}`;\n}\n\nexport function liveOwner(agents: Agents, owner: string | undefined): string | undefined {\n  if (!owner) return undefined;\n  const state = agents.state();\n  if (state.cones[owner]) return owner;\n  const scoop = state.scoops[owner];\n  return scoop && live(scoop) ? owner : undefined;\n}\n\nexport function ownerOf(agents: Agents, owner: string | undefined): string {\n  const state = agents.state();\n  if (owner && state.cones[owner]) return owner;\n  const scoop = owner ? state.scoops[owner] : undefined;\n  return scoop && live(scoop) ? (owner as string) : agents.activeCone();\n}\n\nfunction entry(name: string, html: string, agentId: string, id = name): Sprinkle {\n  return { id, name, ...describe(name, html), agentId, html };\n}\n\nfunction placesOf(options: SprinklesAttach, dir: string): readonly SprinklePlace[] {\n  return options.places?.() ?? [{ dir, cone: '' }];\n}\n\nasync function filesIn(\n  options: SprinklesAttach,\n  dir: string,\n  reserved: ReadonlySet<string>,\n  owned: Record<string, string>,\n  using: Context,\n  found: Record<string, string> = {}\n): Promise<Sprinkle[]> {\n  const { env, agents } = options;\n  const out: Sprinkle[] = [];\n  for (const place of placesOf(options, dir))\n    for (const { name, path } of await sprinkleFiles(env, place.dir, using)) {\n      const id = place.cone ? `${place.cone}/${name}` : name;\n      if (reserved.has(name) || out.some((item) => item.id === id)) continue;\n      const read = await env.readTextFile(path, using);\n      if (place.cone && !owned[id]) found[id] = place.cone;\n      const owner = owned[id] ?? (place.cone || undefined);\n      if (read.ok) out.push(entry(name, read.value, ownerOf(agents, owner), id));\n    }\n  return out;\n}\n\nfunction reloader(\n  options: SprinklesAttach,\n  dir: string,\n  builtins: { welcome: string | undefined; suggestions: string | undefined },\n  sprinkles: ReplicatedState<Sprinkle[]> & { replace(context: Context, value: Sprinkle[]): void },\n  owners: (context: Context) => Promise<Record<string, string>>\n) {\n  const { env, agents } = options;\n  const { welcome, suggestions } = builtins;\n  return async (using: Context) => {\n    const owned = await owners(using);\n    const store = options.shared ? sharedPaths(options.shared).suggestions : SUGGESTIONS_STORE;\n    const stored = suggestions === undefined ? undefined : await env.exists(store, using);\n    const offered = stored?.ok === true && stored.value;\n    const reserved = new Set([WELCOME, ...(offered ? [SUGGESTIONS] : [])]);\n    const found: Record<string, string> = {};\n    const out = await filesIn(options, dir, reserved, owned, using, found);\n    if (Object.keys(found).length)\n      await options.harness.commit(async (tx) => {\n        const doc = await tx.doc(SprinklesDoc);\n        for (const [id, cone] of Object.entries(found)) doc.owners[id] ??= cone;\n      }, using);\n    if (offered)\n      out.push(entry(SUGGESTIONS, suggestions as string, ownerOf(agents, owned[SUGGESTIONS])));\n    if (welcome !== undefined)\n      out.push({\n        ...entry(WELCOME, welcome, ownerOf(agents, owned[WELCOME] ?? 'cone')),\n        inline: true,\n      });\n    sprinkles.replace(using, out);\n  };\n}\n\nexport const NO_OWNER = 'this sprinkle has no owner, so it can only be shown';\n\nexport async function ownedRead(\n  files: ExecutionEnv,\n  asked: string,\n  home: string,\n  using: Context\n): Promise<{ files: ExecutionEnv; path: string; check: () => Promise<void> }> {\n  const real = await files.canonicalPath(asked, using);\n  const path = real.ok ? homePath(real.value, home, home) : asked;\n  return {\n    files,\n    path,\n    async check() {\n      const again = await files.canonicalPath(path, using);\n      if (again.ok && again.value !== path)\n        throw new Error(`${asked} changed while it was read; read it again`);\n    },\n  };\n}\n\nfunction readerFor(\n  options: SprinklesAttach,\n  owners: (context: Context) => Promise<Record<string, string>>,\n  inside: (path: unknown, context: Context) => Promise<string>\n) {\n  const { env, agents } = options;\n  const none = async () => undefined;\n  return async (id: string, path: unknown, using: Context) => {\n    if (options.shared && BUILTIN.has(id))\n      return { files: env, path: homePath(path, options.shared, options.shared), check: none };\n    if (!options.places) return { files: env, path: await inside(path, using), check: none };\n    const owner = liveOwner(agents, (await owners(using))[id]);\n    if (!owner) throw new Error(NO_OWNER);\n    const agentId = owner.startsWith('scoop:') ? owner : `cone:${owner}`;\n    const home = options.homeOf?.(agentId);\n    const files = await options.envOf?.(agentId, using);\n    if (!home || !files) throw new Error(NO_OWNER);\n    return ownedRead(files, homePath(path, home, home), home, using);\n  };\n}\n\nexport function setupSprinkles() {\n  return {\n    async attach(options: SprinklesAttach, context: Context): Promise<SprinklesRuntime> {\n      const { harness, agents, licks, env } = options;\n      const dir = options.dir ?? SPRINKLES_DIR;\n      const sprinkles = replicatedState<Sprinkle[]>([]);\n      const builtin = (name: string) =>\n        options.assets\n          ? options.assets(`packages/vfs-root/sprinkles/${name}.shtml`).catch(() => undefined)\n          : Promise.resolve(undefined);\n      const welcome = await builtin(WELCOME);\n      const suggestions = await builtin(SUGGESTIONS);\n      const owners = async (using: Context) =>\n        (await harness.snapshot(SprinklesDoc, using))?.owners ?? {};\n      const reload = reloader(options, dir, { welcome, suggestions }, sprinkles, owners);\n      const inside = async (path: unknown, using: Context) => {\n        const asked = homePath(path);\n        const real = await env.canonicalPath(asked, using);\n        return real.ok ? homePath(real.value) : asked;\n      };\n      const paths = options.shared ? sharedPaths(options.shared) : undefined;\n      const reader = readerFor(options, owners, inside);\n      const offCone = agents.onCone(() => reload(context).catch(() => undefined));\n      const find = (id: string) => sprinkles.value.find((item) => item.id === id);\n      const post = async (id: string, agentId: string, using: Context) => {\n        const conversation = await agents.conversation(agentId, using);\n        if (!conversation) throw new Error(`there is no agent ${agentId}`);\n        await conversation.submit(\n          { type: 'write', entry: { kind: SPRINKLE_KIND, data: { sprinkle: id, at: Date.now() } } },\n          using\n        );\n      };\n      await reload(context);\n      const state = await harness.snapshot(SprinklesDoc, context);\n      if (welcome !== undefined && !state?.welcomed) {\n        await post(WELCOME, 'cone', context);\n        await harness.commit(async (tx) => {\n          (await tx.doc(SprinklesDoc)).welcomed = true;\n        }, context);\n      }\n      let timer: ReturnType<typeof setTimeout> | undefined;\n      let watcher: FileWatcher | undefined;\n      let seen = '';\n      const watch = async (using: Context) => {\n        const dirs = placesOf(options, dir).map((place) => place.dir);\n        const key = dirs.join('\\n');\n        if (key === seen) return;\n        seen = key;\n        await watcher?.close(using);\n        const watched = await env.watch(\n          [\n            ...dirs.map((path) => ({ path, recursive: true })),\n            { path: paths?.suggestionsDir ?? SUGGESTIONS_DIR },\n          ],\n          () => {\n            clearTimeout(timer);\n            timer = setTimeout(() => void reload(context).catch(() => undefined), options.reloadMs);\n          },\n          using\n        );\n        watcher = watched.ok ? watched.value : undefined;\n      };\n      await watch(context);\n      return {\n        sprinkles,\n        async send(id, payload, using) {\n          const sprinkle = find(id);\n          if (!sprinkle) return { delivered: false };\n          if (await options.intercept?.(id, payload, using)) return { delivered: true };\n          if (id === WELCOME && payload.action === 'onboarding-complete') {\n            await env.writeFile(\n              paths?.welcomed ?? WELCOMED,\n              `${new Date().toISOString()}\\n`,\n              using\n            );\n            if (payload.data && typeof payload.data === 'object' && !Array.isArray(payload.data))\n              await env.writeFile(\n                paths?.profile ?? WELCOME_PROFILE,\n                `${JSON.stringify(payload.data, null, 2)}\\n`,\n                using\n              );\n          }\n          const owner = (await owners(using))[id];\n          if (options.places && !BUILTIN.has(id) && !liveOwner(agents, owner))\n            return { delivered: false };\n          await licks.deliver(\n            {\n              channel: 'sprinkle',\n              source: `sprinkle:${id}`,\n              title: sprinkle.title,\n              text: payload.action || '(no action)',\n              ...(payload.data === null ? {} : { body: JSON.stringify(payload.data, null, 2) }),\n              target: targetOf(ownerOf(agents, owner)),\n            },\n            using\n          );\n          return { delivered: true };\n        },\n        async call(id, method, args, using) {\n          if (!find(id)) throw new Error(`there is no sprinkle ${id}`);\n          const handlers: Record<SprinkleMethod, () => Promise<JsonValue>> = {\n            async readFile() {\n              const { files, path, check } = await reader(id, args[0], using);\n              const read = await files.readTextFile(path, using);\n              if (!read.ok) throw new Error(read.error.message);\n              await check();\n              return read.value;\n            },\n            async exists() {\n              const { files, path } = await reader(id, args[0], using);\n              const found = await files.exists(path, using);\n              return found.ok && found.value;\n            },\n            async getState() {\n              return (await harness.snapshot(SprinklesDoc, using))?.state[id] ?? null;\n            },\n            async setState() {\n              await harness.commit(async (tx) => {\n                (await tx.doc(SprinklesDoc)).state[id] = (args[0] ?? null) as JsonValue;\n              }, using);\n              return null;\n            },\n          };\n          const handler = handlers[method as SprinkleMethod];\n          if (!handler) throw new Error(NO_EXEC);\n          return handler();\n        },\n        async claim(id, cone, using) {\n          await reload(using);\n          if (id === SUGGESTIONS || !find(id) || (await owners(using))[id]) return;\n          await harness.commit(async (tx) => {\n            const doc = await tx.doc(SprinklesDoc);\n            doc.owners[id] ??= cone;\n          }, using);\n          await reload(using);\n        },\n        async reload(using) {\n          await watch(using);\n          await reload(using);\n        },\n        async close(using) {\n          offCone();\n          clearTimeout(timer);\n          await watcher?.close(using);\n        },\n      };\n    },\n  };\n}\n"],
+  "mappings": "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",
   "names": []
 }

package/dist/sprinkles/sprinkles.js

@@ -41,17 +41,25 @@ async function sprinkleFiles(env, dir, context) {
   }
   return [...out].map(([name, path]) => ({ name, path }));
 }
-function homePath(path) {
+function homePath(path, shared = "/home", root = "/home") {
   if (typeof path !== "string" || !path) throw new Error("a sprinkle reads files by absolute path");
-  const mapped = path.startsWith("/shared/") ? `/home/${path.slice("/shared/".length)}` : path;
+  const mapped = path.startsWith("/shared/") ? `${shared}/${path.slice("/shared/".length)}` : path;
   const segments = mapped.split("/");
   if (segments.includes(".") || segments.includes(".."))
     throw new Error(`a sprinkle reads paths without . or .. segments, not ${path}`);
   const resolved = normalize(mapped);
-  if (resolved !== "/home" && !resolved.startsWith("/home/"))
-    throw new Error(`a sprinkle can only read files in /home, not ${path}`);
+  if (resolved !== root && !resolved.startsWith(`${root}/`))
+    throw new Error(`a sprinkle can only read files in ${root}, not ${path}`);
   return resolved;
 }
+function sharedPaths(shared) {
+  return {
+    suggestionsDir: `${shared}/.gelatiere`,
+    suggestions: `${shared}/.gelatiere/suggestions.json`,
+    welcomed: `${shared}/.welcomed`,
+    profile: `${shared}/.welcome.json`
+  };
+}
 const NO_EXEC = "sprinkles can't run commands in SLICC; send the agent a message with slicc.lick() and let it run them";
 export {
   DEFAULT_ICON,
@@ -68,6 +76,7 @@ export {
   WELCOME_PROFILE,
   describe,
   homePath,
+  sharedPaths,
   sprinkleFiles
 };
 //# sourceMappingURL=sprinkles.js.map

package/dist/sprinkles/sprinkles.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/sprinkles/sprinkles.ts"],
-  "sourcesContent": ["import type { Context, JsonValue } from '@earendil-works/chord';\nimport { defineDoc } from '@earendil-works/pi-durable';\nimport type { ExecutionEnv } from '@earendil-works/pi-durable/env';\nimport { normalize } from '../kernel/paths.ts';\n\nexport { SPRINKLE_KIND, type Sprinkle } from './kind.ts';\n\nexport const SPRINKLES_DIR = '/home/sprinkles';\nexport const WELCOME = 'welcome';\nexport const SUGGESTIONS = 'suggestions';\nexport const SUGGESTIONS_DIR = '/home/.gelatiere';\nexport const SUGGESTIONS_STORE = `${SUGGESTIONS_DIR}/suggestions.json`;\nexport const WELCOMED = '/home/.welcomed';\nexport const WELCOME_PROFILE = '/home/.welcome.json';\nexport const DEFAULT_ICON = 'sparkles';\n\nexport type SprinkleMethod = 'readFile' | 'exists' | 'getState' | 'setState';\n\nexport const SprinklesDoc = defineDoc<{\n  owners: Record<string, string>;\n  state: Record<string, JsonValue>;\n  welcomed: boolean;\n}>({\n  kind: 'slicc.sprinkles',\n  version: 1,\n  scope: 'session',\n  initial: () => ({ owners: {}, state: {}, welcomed: false }),\n});\n\nfunction decode(text: string): string {\n  return text\n    .replace(/&lt;/g, '<')\n    .replace(/&gt;/g, '>')\n    .replace(/&quot;/g, '\"')\n    .replace(/&#39;/g, \"'\")\n    .replace(/&amp;/g, '&');\n}\n\nexport function describe(name: string, html: string): { title: string; icon: string } {\n  const title = /<title>([\\s\\S]*?)<\\/title>/i.exec(html)?.[1]?.trim();\n  const icon =\n    /<link\\b[^>]*\\brel=[\"']icon[\"'][^>]*\\bhref=[\"']([^\"']+)[\"']/i.exec(html)?.[1] ??\n    /<link\\b[^>]*\\bhref=[\"']([^\"']+)[\"'][^>]*\\brel=[\"']icon[\"']/i.exec(html)?.[1];\n  return { title: title ? decode(title) : name, icon: icon ?? DEFAULT_ICON };\n}\n\nexport const NAME = /^[a-z0-9][a-z0-9._-]{0,63}$/;\n\nexport async function sprinkleFiles(\n  env: Pick<ExecutionEnv, 'listDir'>,\n  dir: string,\n  context: Context\n): Promise<{ name: string; path: string }[]> {\n  const listed = await env.listDir(dir, context);\n  if (!listed.ok) return [];\n  const out = new Map<string, string>();\n  for (const entry of [...listed.value].sort((a, b) => a.name.localeCompare(b.name))) {\n    if (entry.kind !== 'directory' && entry.name.endsWith('.shtml')) {\n      const name = entry.name.slice(0, -'.shtml'.length);\n      if (NAME.test(name)) out.set(name, `${dir}/${entry.name}`);\n    }\n    if (entry.kind === 'directory' && NAME.test(entry.name) && !out.has(entry.name)) {\n      const inner = await env.listDir(`${dir}/${entry.name}`, context);\n      if (inner.ok && inner.value.some((item) => item.name === `${entry.name}.shtml`))\n        out.set(entry.name, `${dir}/${entry.name}/${entry.name}.shtml`);\n    }\n  }\n  return [...out].map(([name, path]) => ({ name, path }));\n}\n\nexport function homePath(path: unknown): string {\n  if (typeof path !== 'string' || !path) throw new Error('a sprinkle reads files by absolute path');\n  const mapped = path.startsWith('/shared/') ? `/home/${path.slice('/shared/'.length)}` : path;\n  const segments = mapped.split('/');\n  if (segments.includes('.') || segments.includes('..'))\n    throw new Error(`a sprinkle reads paths without . or .. segments, not ${path}`);\n  const resolved = normalize(mapped);\n  if (resolved !== '/home' && !resolved.startsWith('/home/'))\n    throw new Error(`a sprinkle can only read files in /home, not ${path}`);\n  return resolved;\n}\n\nexport const NO_EXEC =\n  \"sprinkles can't run commands in SLICC; send the agent a message with slicc.lick() and let it run them\";\n"],
-  "mappings": "AACA,SAAS,iBAAiB;AAE1B,SAAS,iBAAiB;AAE1B,SAAS,qBAAoC;AAEtC,MAAM,gBAAgB;AACtB,MAAM,UAAU;AAChB,MAAM,cAAc;AACpB,MAAM,kBAAkB;AACxB,MAAM,oBAAoB,GAAG,eAAe;AAC5C,MAAM,WAAW;AACjB,MAAM,kBAAkB;AACxB,MAAM,eAAe;AAIrB,MAAM,eAAe,UAIzB;AAAA,EACD,MAAM;AAAA,EACN,SAAS;AAAA,EACT,OAAO;AAAA,EACP,SAAS,OAAO,EAAE,QAAQ,CAAC,GAAG,OAAO,CAAC,GAAG,UAAU,MAAM;AAC3D,CAAC;AAED,SAAS,OAAO,MAAsB;AACpC,SAAO,KACJ,QAAQ,SAAS,GAAG,EACpB,QAAQ,SAAS,GAAG,EACpB,QAAQ,WAAW,GAAG,EACtB,QAAQ,UAAU,GAAG,EACrB,QAAQ,UAAU,GAAG;AAC1B;AAEO,SAAS,SAAS,MAAc,MAA+C;AACpF,QAAM,QAAQ,8BAA8B,KAAK,IAAI,IAAI,CAAC,GAAG,KAAK;AAClE,QAAM,OACJ,8DAA8D,KAAK,IAAI,IAAI,CAAC,KAC5E,8DAA8D,KAAK,IAAI,IAAI,CAAC;AAC9E,SAAO,EAAE,OAAO,QAAQ,OAAO,KAAK,IAAI,MAAM,MAAM,QAAQ,aAAa;AAC3E;AAEO,MAAM,OAAO;AAEpB,eAAsB,cACpB,KACA,KACA,SAC2C;AAC3C,QAAM,SAAS,MAAM,IAAI,QAAQ,KAAK,OAAO;AAC7C,MAAI,CAAC,OAAO,GAAI,QAAO,CAAC;AACxB,QAAM,MAAM,oBAAI,IAAoB;AACpC,aAAW,SAAS,CAAC,GAAG,OAAO,KAAK,EAAE,KAAK,CAAC,GAAG,MAAM,EAAE,KAAK,cAAc,EAAE,IAAI,CAAC,GAAG;AAClF,QAAI,MAAM,SAAS,eAAe,MAAM,KAAK,SAAS,QAAQ,GAAG;AAC/D,YAAM,OAAO,MAAM,KAAK,MAAM,GAAG,CAAC,SAAS,MAAM;AACjD,UAAI,KAAK,KAAK,IAAI,EAAG,KAAI,IAAI,MAAM,GAAG,GAAG,IAAI,MAAM,IAAI,EAAE;AAAA,IAC3D;AACA,QAAI,MAAM,SAAS,eAAe,KAAK,KAAK,MAAM,IAAI,KAAK,CAAC,IAAI,IAAI,MAAM,IAAI,GAAG;AAC/E,YAAM,QAAQ,MAAM,IAAI,QAAQ,GAAG,GAAG,IAAI,MAAM,IAAI,IAAI,OAAO;AAC/D,UAAI,MAAM,MAAM,MAAM,MAAM,KAAK,CAAC,SAAS,KAAK,SAAS,GAAG,MAAM,IAAI,QAAQ;AAC5E,YAAI,IAAI,MAAM,MAAM,GAAG,GAAG,IAAI,MAAM,IAAI,IAAI,MAAM,IAAI,QAAQ;AAAA,IAClE;AAAA,EACF;AACA,SAAO,CAAC,GAAG,GAAG,EAAE,IAAI,CAAC,CAAC,MAAM,IAAI,OAAO,EAAE,MAAM,KAAK,EAAE;AACxD;AAEO,SAAS,SAAS,MAAuB;AAC9C,MAAI,OAAO,SAAS,YAAY,CAAC,KAAM,OAAM,IAAI,MAAM,yCAAyC;AAChG,QAAM,SAAS,KAAK,WAAW,UAAU,IAAI,SAAS,KAAK,MAAM,WAAW,MAAM,CAAC,KAAK;AACxF,QAAM,WAAW,OAAO,MAAM,GAAG;AACjC,MAAI,SAAS,SAAS,GAAG,KAAK,SAAS,SAAS,IAAI;AAClD,UAAM,IAAI,MAAM,wDAAwD,IAAI,EAAE;AAChF,QAAM,WAAW,UAAU,MAAM;AACjC,MAAI,aAAa,WAAW,CAAC,SAAS,WAAW,QAAQ;AACvD,UAAM,IAAI,MAAM,gDAAgD,IAAI,EAAE;AACxE,SAAO;AACT;AAEO,MAAM,UACX;",
+  "sourcesContent": ["import type { Context, JsonValue } from '@earendil-works/chord';\nimport { defineDoc } from '@earendil-works/pi-durable';\nimport type { ExecutionEnv } from '@earendil-works/pi-durable/env';\nimport { normalize } from '../kernel/paths.ts';\n\nexport { SPRINKLE_KIND, type Sprinkle } from './kind.ts';\n\nexport const SPRINKLES_DIR = '/home/sprinkles';\nexport const WELCOME = 'welcome';\nexport const SUGGESTIONS = 'suggestions';\nexport const SUGGESTIONS_DIR = '/home/.gelatiere';\nexport const SUGGESTIONS_STORE = `${SUGGESTIONS_DIR}/suggestions.json`;\nexport const WELCOMED = '/home/.welcomed';\nexport const WELCOME_PROFILE = '/home/.welcome.json';\nexport const DEFAULT_ICON = 'sparkles';\n\nexport type SprinkleMethod = 'readFile' | 'exists' | 'getState' | 'setState';\n\nexport const SprinklesDoc = defineDoc<{\n  owners: Record<string, string>;\n  state: Record<string, JsonValue>;\n  welcomed: boolean;\n}>({\n  kind: 'slicc.sprinkles',\n  version: 1,\n  scope: 'session',\n  initial: () => ({ owners: {}, state: {}, welcomed: false }),\n});\n\nfunction decode(text: string): string {\n  return text\n    .replace(/&lt;/g, '<')\n    .replace(/&gt;/g, '>')\n    .replace(/&quot;/g, '\"')\n    .replace(/&#39;/g, \"'\")\n    .replace(/&amp;/g, '&');\n}\n\nexport function describe(name: string, html: string): { title: string; icon: string } {\n  const title = /<title>([\\s\\S]*?)<\\/title>/i.exec(html)?.[1]?.trim();\n  const icon =\n    /<link\\b[^>]*\\brel=[\"']icon[\"'][^>]*\\bhref=[\"']([^\"']+)[\"']/i.exec(html)?.[1] ??\n    /<link\\b[^>]*\\bhref=[\"']([^\"']+)[\"'][^>]*\\brel=[\"']icon[\"']/i.exec(html)?.[1];\n  return { title: title ? decode(title) : name, icon: icon ?? DEFAULT_ICON };\n}\n\nexport const NAME = /^[a-z0-9][a-z0-9._-]{0,63}$/;\n\nexport async function sprinkleFiles(\n  env: Pick<ExecutionEnv, 'listDir'>,\n  dir: string,\n  context: Context\n): Promise<{ name: string; path: string }[]> {\n  const listed = await env.listDir(dir, context);\n  if (!listed.ok) return [];\n  const out = new Map<string, string>();\n  for (const entry of [...listed.value].sort((a, b) => a.name.localeCompare(b.name))) {\n    if (entry.kind !== 'directory' && entry.name.endsWith('.shtml')) {\n      const name = entry.name.slice(0, -'.shtml'.length);\n      if (NAME.test(name)) out.set(name, `${dir}/${entry.name}`);\n    }\n    if (entry.kind === 'directory' && NAME.test(entry.name) && !out.has(entry.name)) {\n      const inner = await env.listDir(`${dir}/${entry.name}`, context);\n      if (inner.ok && inner.value.some((item) => item.name === `${entry.name}.shtml`))\n        out.set(entry.name, `${dir}/${entry.name}/${entry.name}.shtml`);\n    }\n  }\n  return [...out].map(([name, path]) => ({ name, path }));\n}\n\nexport function homePath(path: unknown, shared = '/home', root = '/home'): string {\n  if (typeof path !== 'string' || !path) throw new Error('a sprinkle reads files by absolute path');\n  const mapped = path.startsWith('/shared/') ? `${shared}/${path.slice('/shared/'.length)}` : path;\n  const segments = mapped.split('/');\n  if (segments.includes('.') || segments.includes('..'))\n    throw new Error(`a sprinkle reads paths without . or .. segments, not ${path}`);\n  const resolved = normalize(mapped);\n  if (resolved !== root && !resolved.startsWith(`${root}/`))\n    throw new Error(`a sprinkle can only read files in ${root}, not ${path}`);\n  return resolved;\n}\n\nexport function sharedPaths(shared: string) {\n  return {\n    suggestionsDir: `${shared}/.gelatiere`,\n    suggestions: `${shared}/.gelatiere/suggestions.json`,\n    welcomed: `${shared}/.welcomed`,\n    profile: `${shared}/.welcome.json`,\n  };\n}\n\nexport const NO_EXEC =\n  \"sprinkles can't run commands in SLICC; send the agent a message with slicc.lick() and let it run them\";\n"],
+  "mappings": "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",
   "names": []
 }

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

@@ -2,6 +2,7 @@ import { type Context, type ReplicatedState } from '@earendil-works/chord';
 import type { EntryRecord, Harness } from '@earendil-works/pi-durable';
 import type { ExecutionEnv } from '@earendil-works/pi-durable/env';
 import { type Agents, type AgentsState, type FrozenRecord } from '../agents.ts';
+import { type Layout } from '../layout.ts';
 import type { LickTarget } from '../licks/lick.ts';
 export type Answer = {
     code: number;
@@ -32,6 +33,7 @@ export interface FreezerAttach {
     title?: (transcript: string, model: string, context: Context) => Promise<string | undefined>;
     extract?: (conversation: number, tail: number, context: Context, cone: string) => Promise<unknown>;
     now?: () => number;
+    layout?: Layout;
 }
 export interface FreezerRuntime {
     readonly frozen: ReplicatedState<FrozenCone[]>;
@@ -53,6 +55,6 @@ export declare function modelName(model: {
 } | undefined): string;
 export declare function firstLine(entries: readonly EntryRecord[]): string;
 export declare function markdown(record: Pick<FrozenRecord, 'title' | 'name' | 'model' | 'frozenAt'>, entries: readonly EntryRecord[]): string;
-export declare function thawedNote(kind: ConversationKind, name: string, folder: string, kept: boolean): string;
+export declare function thawedNote(kind: ConversationKind, name: string, folder: string, kept: boolean, home?: string): string;
 export declare function frozenTarget(state: Readonly<AgentsState>, target: LickTarget): Frozen | undefined;
 export declare function attachFreezer(options: FreezerAttach): FreezerRuntime;

package/dist/types/freezer/title.d.ts

@@ -2,5 +2,5 @@ import type { Context } from '@earendil-works/chord';
 import type { Models } from '@earendil-works/pi-ai/models';
 import type { ExecutionEnv } from '@earendil-works/pi-durable/env';
 export declare const TITLE_PROMPT = "Give this chat a title of three to six words that says what it was about. Answer with the title only, without quotes.";
-export declare function settingsText(env: Pick<ExecutionEnv, 'readTextFile'>, home: string): (context: Context) => Promise<string | undefined>;
+export declare function settingsText(env: Pick<ExecutionEnv, 'readTextFile'>, home: string, dir?: string): (context: Context) => Promise<string | undefined>;
 export declare function titler(models: Models, settings: (context: Context) => Promise<string | undefined>): (transcript: string, model: string, context: Context) => Promise<string | undefined>;

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

@@ -27,6 +27,14 @@ export interface GelatiereAttach {
     skills?: () => readonly {
         name: string;
     }[];
+    files?: ExecutionEnv;
+    profile?: string;
+    shared?: string;
+    as?: (caller: string | null, context: Context) => Promise<Caller | undefined>;
+}
+export interface Caller {
+    env: ExecutionEnv;
+    home: string;
 }
 export interface GelatiereRuntime {
     command(argv: readonly string[], caller: string | null, context: Context): Promise<Answer>;

package/dist/types/gelatiere/store.d.ts

@@ -33,5 +33,6 @@ export declare function fold(store: readonly Suggestion[], candidates: unknown,
     rejected: string[];
 };
 export declare function open(store: readonly Suggestion[]): Suggestion[];
-export declare function readStore(env: Pick<ExecutionEnv, 'readTextFile'>, context: Context): Promise<Suggestion[] | null>;
-export declare function writeStore(env: Pick<ExecutionEnv, 'writeFile' | 'createDir'>, store: readonly Suggestion[], context: Context): Promise<void>;
+export declare function storeOf(shared: string): string;
+export declare function readStore(env: Pick<ExecutionEnv, 'readTextFile'>, context: Context, file?: string): Promise<Suggestion[] | null>;
+export declare function writeStore(env: Pick<ExecutionEnv, 'writeFile' | 'createDir'>, store: readonly Suggestion[], context: Context, file?: string): Promise<void>;

package/dist/types/index.d.ts

@@ -7,7 +7,7 @@ export { CREDENTIALS_DATABASE, EncryptedCredentialStore } from './credentials.ts
 export { type AgentHost, type ConnectOptions, hostAgent } from './host.ts';
 export type { KernelClient, KernelFs, KernelProcess, KernelStat, SpawnOptions, } from './kernel/client.ts';
 export { HOME, type KernelEnvOptions, kernelEnvironment, SliccKernelEnv } from './kernel/env.ts';
-export { adminOver, type KernelAdmin, type KernelUser, type KernelUsers, serveAdmin, type UserClient, type UserClients, type UserConnect, type UserSpec, userClients, } from './kernel/users.ts';
+export { adminOver, type KernelAdmin, type KernelGroup, type KernelGroups, 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 Loopback, type Transport, type TransportResponse, transportFetch, } from './net.ts';

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

@@ -0,0 +1,29 @@
+import type { Agents, AgentsState } from '../agents.ts';
+import type { KernelClient } from './client.ts';
+import type { KernelGroups, UserClients, UserSpec } from './users.ts';
+export type UsersMode = 'off' | 'report' | 'enforce';
+export declare const SCOOP_UMASK = 23;
+export declare const CONE_UMASK = 63;
+export declare const CONE_HOME_MODE = 456;
+export declare const SCOOP_HOME_MODE = 1512;
+export declare const SUDO_GROUP = "sudo";
+export declare const CONE_PREFIX = "cone:";
+export declare const SCOOP_USER = "scoop-";
+export declare function scoopUser(folder: string): string;
+export declare function homeOf(user: string): string;
+export declare function userOf(state: Readonly<AgentsState>, agentId: string): string | undefined;
+export type Wanted = {
+    agentId: string;
+    cone: string | null;
+    spec: UserSpec;
+};
+export declare function wanted(state: Readonly<AgentsState>): Wanted[];
+export interface Accounts {
+    readonly mode: UsersMode;
+    agentOf(conversation: number | undefined): string | undefined;
+    home(agentId: string): string | undefined;
+    client(agentId: string): Promise<KernelClient>;
+    reconcile(): Promise<void>;
+    boot(): Promise<void>;
+}
+export declare function createAccounts(pool: UserClients, agents: () => Agents | undefined, mode?: UsersMode, groups?: KernelGroups, warn?: (message: string) => void): Accounts;

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

@@ -0,0 +1,37 @@
+import type { Context } from '@earendil-works/chord';
+import type { Agents, AgentsState } from '../agents.ts';
+import type { GelatiereAttach } from '../gelatiere/index.ts';
+import { type Layout } from '../layout.ts';
+import type { LickDir } from '../licks/sources.ts';
+import type { Spools } from '../scoops/index.ts';
+import type { SkillPeople } from '../skills/index.ts';
+import type { SprinklePlace, SprinklesAttach } from '../sprinkles/index.ts';
+import { type Accounts, type UsersMode } from './accounts.ts';
+import type { KernelClient } from './client.ts';
+import { type EnvRoute, type EnvTargetLike, SliccKernelEnv } from './env.ts';
+import type { UserClients } from './users.ts';
+export interface AgentUsers {
+    readonly accounts: Accounts;
+    readonly layout: Layout;
+    readonly spools: Spools;
+    readonly enforced: boolean;
+    readonly people: SkillPeople;
+    follow(runtimes: readonly {
+        reload?(context: Context): Promise<void>;
+        reconcile?(context: Context): Promise<void>;
+    }[]): void;
+    lickDirs(): Promise<LickDir[]>;
+    sprinklePlaces(): SprinklePlace[];
+    sprinkles(): Partial<SprinklesAttach>;
+    envOfAgent(agentId: string): Promise<SliccKernelEnv | undefined>;
+    gelatiere(root: SliccKernelEnv): Promise<Partial<GelatiereAttach>>;
+    route(target: EnvTargetLike): Promise<EnvRoute | undefined>;
+    start(agents: Agents): Promise<void>;
+    close(): void;
+}
+export declare function modeOf(client: KernelClient): UsersMode;
+export declare function missingSupport(pool: UserClients | undefined, client: KernelClient, requested: boolean | undefined): Promise<string[]>;
+export declare function warnSupport(pool: UserClients | undefined, client: KernelClient, requested: boolean | undefined, report?: (message: string) => void): Promise<void>;
+export declare function legacyCwd(state: Readonly<AgentsState>, agentId: string, cwd: string): boolean;
+export declare function spoolScript(user: string, dir: string): string;
+export declare function agentUsers(pool: UserClients, client: KernelClient, root: SliccKernelEnv, agents: () => Agents | undefined): AgentUsers;