@ai-ecoverse/slicc-agent 3.14.0 → 3.16.0

package/README.md

@@ -156,20 +156,20 @@ gone /home/notes/old.md
 
 ### Cones and scoops
 
-A **cone** is a top-level agent the user talks to; a **scoop** is a helper agent with its own conversation and its own folder, `/scoops/<handle>/`. The session document `slicc.agents` is the registry. The first cone's id is `cone`, later ones `cone-<n>`, counting up only. A scoop's id is `scoop:<handle>`, where the handle is its name made safe for a folder; a handle that is or was ever taken gets `-2`, `-3` and so on, so ids and folders are never reused. `AgentControl` adds `selectCone`, `createCone`, `createScoop`, `stopAgent`, `drop` (stop a scoop and keep its folder) and `unqueue(agentId, submissionId)`; `send` and `configure` take an `agentId`. Its errors are sentences the UI can show as they are, such as "A cone named harbor already exists." The transcript service adds `agents`, a summary of every cone and scoop, and `views`, one durable view per live agent, which the spectrum adapter shows in the agents rail (the header picker lists cones only). With spectrum ≥ 1.23.0 the rail drops scoops and the picker creates cones. A scoop created from the rail has a provisional id until the worker answers; the adapter then moves the selection, and sends, to the id the worker gave it.
+A **cone** is a top-level agent the user talks to; a **scoop** is a helper agent with its own conversation and its own folder, `/scoops/<handle>/`. The session document `slicc.agents` is the registry. The first cone's id is `cone`, later ones `cone-<n>`, counting up only. A scoop's id is `scoop:<handle>`, where the handle is its name made safe for a folder; a handle that is or was ever taken gets `-2`, `-3` and so on, so ids and folders are never reused. `AgentControl` adds `selectCone`, `createCone`, `createScoop`, `stopAgent`, `drop` (stop a scoop, as `agent stop` does) and `unqueue(agentId, submissionId)`; `send` and `configure` take an `agentId`. Its errors are sentences the UI can show as they are, such as "A cone named harbor already exists." The transcript service adds `agents`, a summary of every cone and scoop, and `views`, one durable view per live agent, which the spectrum adapter shows in the agents rail (the header picker lists cones only). With spectrum ≥ 1.23.0 the rail drops scoops and the picker creates cones; the adapter needs spectrum ≥ 1.28.0, whose Drop confirmation says the working folder is deleted. A scoop created from the rail has a provisional id until the worker answers; the adapter then moves the selection, and sends, to the id the worker gave it.
 
-Each scoop is owned by a background durable task, its **anchor**, so Stop in its cone doesn't end it; `agent stop` does, and keeps its transcript and folder. 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.
+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.
 - `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".
 
-**Roles** are pi agent files: Markdown with a frontmatter subset (`name`, `description`, `tools`, `model`, `thinking`, `memory`, `inheritProjectContext`, `inheritGlobalContext`, …) and the role's prompt as the body, added to the scoop's instructions. The built-ins are `scout`, `worker`, `reviewer`, `oracle` and `delegate`. Later sources replace earlier ones by name: built-ins, then packages in the kernel's `node_modules` that name a folder in `pi-subagents.agents` or `pi.subagents.agents`, then `~/.pi/agent/agents/`. A project's `.pi/agents/` will count only in trusted folders, and folders can't be trusted yet. `~/.pi/agent/settings.json` can override roles (`subagents.agentOverrides`) and set the limits `subagents.maxLiveScoops` (16 live scoops per cone) and `subagents.maxPerTurn` (64 scoops started per cone turn), which the worker counts for both kinds.
+**Roles** are pi agent files: Markdown with a frontmatter subset (`name`, `description`, `tools`, `model`, `thinking`, `memory`, `inheritProjectContext`, `inheritGlobalContext`, …) and the role's prompt as the body, added to the scoop's instructions. The built-ins are `scout`, `worker`, `reviewer`, `oracle`, `delegate` and `gelatiere` (below). Later sources replace earlier ones by name: built-ins, then packages in the kernel's `node_modules` that name a folder in `pi-subagents.agents` or `pi.subagents.agents`, then `~/.pi/agent/agents/`. A project's `.pi/agents/` will count only in trusted folders, and folders can't be trusted yet. `~/.pi/agent/settings.json` can override roles (`subagents.agentOverrides`) and set the limits `subagents.maxLiveScoops` (16 live scoops per cone) and `subagents.maxPerTurn` (64 scoops started per cone turn), which the worker counts for both kinds.
 
 **Isolation, for now.** The file tools of a scoop write only under its folder and `/tmp`, plus the cwd of a v6-form call, and read those, their cone's working folder (`/home` by default) and `--read-only` paths; paths are normalized, `..` included, before the check. bash isn't confined, and the scoop is told so: the guard is a guardrail, not a boundary. A scoop's commands share one process group (see Bash and files on slicc-kernel), and stopping the scoop signals it, together with any group recorded for the scoop on an older kernel.
 
-**Rewind.** Dropping a turn never waits for scoops. Scoops the dropped turn created are stopped and marked gone; requests it handed to older scoops are aborted and their reports withdrawn; scoops it stopped come back idle. The `slicc.rewound` entry lists them, and its notice says "Stopped scoop X. Restored scoop Y."
+**Rewind.** Dropping a turn never waits for scoops. Scoops the dropped turn created are stopped and marked gone; requests it handed to older scoops are aborted and their reports withdrawn; scoops it stopped come back idle, with a fresh, empty working folder. The `slicc.rewound` entry lists them, and its notice says "Stopped scoop X. Restored scoop Y."
 
 ### Skills and prompt templates
 
@@ -209,7 +209,7 @@ The worker watches the roots and reloads on change. A `skills` prompt section, g
 
 **v6 skills.** None of the 29 skills SLICC v6 ships runs here unchanged. They name v6 paths (`/shared`, `/workspace`) or commands this kernel doesn't have. By what they wait for:
 - **Rewritten here:** `delegation` (now the `agent` skill), `automation` (now `licks`), `skill-authoring`, `sprinkles` and `welcome`.
-- **Memory:** `memory` is rewritten here (below); its `status`, `log`, `curate` and `dream` and the curation ledger are not ported. `gelatiere` comes in PR 14c; `wiki` needs its `wiki` CLI.
+- **Memory:** `memory` is rewritten here (below); its `status`, `log`, `curate` and `dream` and the curation ledger are not ported. `gelatiere` is rewritten here (below), without `use-cases` and the www.sliccy.com catalog; `wiki` needs its `wiki` CLI.
 - **The freezer (PR 15):** `transcript-export`.
 - **The tray hub, upskill or the Install/Update panel:** `upgrade` (`upgrade apply`, bios#70), `handoff`, `slicc`, `ssh`, `cherry`.
 - **A browser and CDP:** `playwright-cli`, `computer`, `v86`.
@@ -252,6 +252,22 @@ The `memory` section, read before every request, holds the first 200 lines (at m
 
 **`memory_write`** saves, replaces (same section and title) or removes one entry in the caller's own file, or in `global` for cones. Writes to a file are serialized and re-read the file, so edits by hand survive. A file holds 16 KB; a write over that must make it smaller. Anything that looks like a secret (API keys, tokens, `Authorization` values, private keys, `password=`, launch URLs with a `#key`) is redacted before it's written. A role with `memory` and write tools gets `memory_write` in its tool list.
 
+**Extraction.** Durable compacts a long conversation into a summary; before it does, a `beforeCompact` hook (which never declines or replaces the summary) schedules a `slicc.memory-extract` task for the cone. A cone that has been idle for `memory.idleMinutes` (30 by default, `0` turns the idle trigger off) gets the same task. The task runs only when there is something new since the last extraction (a cursor per conversation in the session document `slicc.memory-extract`), makes one model call, with the cone's model unless `memory.extractModel` names a cheaper one (`provider/model`), and writes the proposed entries through `memory_write`'s writer into the cone's memory file, within its 16 KB. The transcript it sends is redacted first, its prompt forbids secrets, and the writer redacts again. `"memory": { "extract": false }` in `~/.pi/agent/settings.json` turns extraction off. v6's curator scoop, three-way merge, curation ledger and dreamer aren't ported.
+
+**The gelatiere.** SLICC's resident advisor, as in v6, is a scoop with the built-in `gelatiere` role. That role has its own memory (`memory: { scope: user, path: gelatiere }`), so it keeps its notes there.
+- `gelatiere init` starts the scoop in the first cone, writes `~/.pi/agent/GELATIERE.md` (its procedure, which the user can edit) unless it exists, and puts one crontab line `0 3 * * * gelatiere scoop:<handle> …` in `~/.slicc/crontab`, replacing an older one.
+- On each pass it reads memory, the installed skills, the roles and the lick files, and writes at most three suggestions as JSON. `gelatiere suggest <file>` validates them and folds them into `/home/.gelatiere/suggestions.json` by id:
+  - kinds `skill`, `use-case`, `tip`, `skill-idea` and `issue`;
+  - a `skill` with its name and its `source`, the https URL of a single-file `SKILL.md`;
+  - https URLs only;
+  - secrets redacted;
+  - at most 50 open;
+  - dismissed and taken ids are never reopened.
+- `gelatiere deliver` sends each cone named in a suggestion's `cones` (or the first cone) one `sprinkle` lick with the action `gelatiere-suggestions`. The built-in `gelatiere` skill answers it with `sprinkle show suggestions`, and looks ids up in the store before installing or trying anything.
+- `gelatiere install <id>` is what a card's Install leads to. It fetches the suggestion's `source` with curl (seven has no `upskill` and no `git`), checks that the file is a valid `SKILL.md` for that name, writes `~/.pi/agent/skills/<name>/SKILL.md`, which the skills loader picks up, and marks the suggestion taken. It refuses a skill that already exists and any source that isn't https. Before anyone clicks, the card shows where the skill comes from: "Installs github from raw.githubusercontent.com/…".
+- `gelatiere run`, `list [--all] [--json]`, `dismiss <id>` and `status` complete the command.
+- The gelatiere doesn't read the www.sliccy.com skill catalog or use-case pages, and doesn't consolidate other agents' memory, which only cones and the user write.
+
 **The panel.** The transcript service adds `memories` and `memoryScopes`, and `AgentControl` `memorySave` and `memoryRemove`; `createAgentModel()` returns a `MemoryAdapter` for spectrum's `MemoryPort`, with `scopes()` (global, cones, roles) for its picker. `memory show [<scope>]` and `memory scopes` in bash print the same files, and the built-in `memory` skill teaches all of it.
 
 ### Sprinkles
@@ -278,7 +294,7 @@ v6's `open`, `reload`, `close`, `send` and `chat` answer with what to do instead
 
 **Shipped sprinkles.** Only `welcome` and `suggestions`, with slicc-spectrum's reviewed copy.
 - **Welcome.** The worker posts it inline in the first cone's chat once per session. Its `onboarding-complete` send writes `/home/.welcomed`, which the card checks, and the built-in `welcome` skill answers the lick.
-- **Suggestions.** It needs the gelatiere, which comes with memory, so it ships but isn't listed yet.
+- **Suggestions.** It's listed once the gelatiere's store `/home/.gelatiere/suggestions.json` exists, and owned by the active cone. Its `gelatiere-dismiss` send marks the suggestion in the store and never reaches an agent; `gelatiere-install` and `gelatiere-try` mark it taken and go to the owner as licks. Its `exec` for use cases is refused, so it shows its static empty state.
 
 The built-in `sprinkles` skill teaches the files, the bridge and the command.
 

package/bin/agent

@@ -1,7 +1,7 @@
 #!/bin/bash
 dir=/var/lib/slicc/agent/requests
 as=$(basename "$0")
-case "$as" in subagent|sprinkle|memory) ;; *) as=agent ;; esac
+case "$as" in subagent|sprinkle|memory|gelatiere) ;; *) as=agent ;; esac
 mkdir -p "$dir/in" "$dir/out" 2>/dev/null
 
 submit() {

package/dist/gelatiere/index.js

@@ -0,0 +1,307 @@
+import { live } from "../agents.js";
+import { skillFromText } from "../skills/skills.js";
+import { fold, open, readStore, STORE, validate, writeStore } from "./store.js";
+const ROLE = "gelatiere";
+const SPRINKLE = "suggestions";
+const PROCEDURE = "packages/vfs-root/gelatiere/GELATIERE.md";
+const SCHEDULE = "0 3 * * *";
+const USAGE = `usage:
+  gelatiere init            start the gelatiere scoop and its nightly crontab line
+  gelatiere run             ask the gelatiere for a pass now
+  gelatiere suggest <file>  fold a JSON array of suggestions into the store
+  gelatiere deliver         lick each cone with the suggestions that are new for it
+  gelatiere install <id>    install a suggested skill from its source into ~/.pi/agent/skills
+  gelatiere list [--all] [--json]
+  gelatiere dismiss <id>    mark a suggestion as not wanted
+  gelatiere status
+
+The store is ${STORE}; the suggestions sprinkle shows it.
+`;
+function line(handle) {
+  return `${SCHEDULE} ${ROLE} scoop:${handle} Nightly pass: read ~/.pi/agent/GELATIERE.md and follow it.`;
+}
+const JOB = new RegExp(`^((?:\\S+\\s+){4}\\S+|@\\w+)\\s+${ROLE}(?:\\s|$)`);
+function scheduleOf(entry) {
+  return JOB.exec(entry.trim())?.[1]?.replace(/\s+/g, " ");
+}
+function handleOf(agents) {
+  const found = Object.entries(agents.state().scoops).find(
+    ([, record]) => record.role === ROLE && live(record)
+  );
+  return found?.[1].folder;
+}
+function row(item) {
+  const state = item.takenAt ? "taken" : item.dismissedAt ? "dismissed" : "open";
+  return `${item.id}	${item.kind}	${state}	${item.title}`;
+}
+const fail = (out) => ({ code: 1, out: `gelatiere: ${out}
+` });
+async function schedule(g, handle, context) {
+  const { env, home } = g.options;
+  const read = await env.readTextFile(g.crontab, context);
+  const kept = (read.ok ? read.value : "").split("\n").filter((entry) => entry.trim() && !scheduleOf(entry));
+  await env.createDir(`${home}/.slicc`, { recursive: true }, context);
+  await env.writeFile(g.crontab, `${[...kept, line(handle)].join("\n")}
+`, context);
+}
+async function seed(g, context) {
+  const { env, assets } = g.options;
+  const existing = await env.exists(g.procedure, context);
+  if (existing.ok && existing.value || !assets) return;
+  const text = await assets(PROCEDURE).catch(() => void 0);
+  if (text !== void 0) await env.writeFile(g.procedure, text, context);
+}
+async function init(g, context) {
+  const { options } = g;
+  await seed(g, context);
+  let handle = handleOf(options.agents);
+  if (!handle) {
+    const roles = await options.roles(context);
+    const role = roles.roles.find((entry) => entry.name === ROLE);
+    if (!role) return fail("the gelatiere role is missing");
+    const spawned = await options.scoops.spawn(
+      {
+        cone: "cone",
+        kind: "async",
+        name: ROLE,
+        role,
+        prompts: [],
+        target: null,
+        fromAgent: false,
+        request: `gelatiere-init-${g.now()}`,
+        limits: roles.limits
+      },
+      context
+    );
+    if (spawned.code !== 0) return { code: 1, out: `gelatiere: ${spawned.out}` };
+    handle = spawned.out.trim();
+  }
+  await schedule(g, handle, context);
+  return {
+    code: 0,
+    out: `the gelatiere is scoop ${handle}; it runs at ${SCHEDULE} (crontab) and with gelatiere run, following ${g.procedure}
+`
+  };
+}
+async function run(g, context) {
+  const handle = handleOf(g.options.agents);
+  if (!handle) return fail("there is no gelatiere yet; run gelatiere init");
+  await g.options.licks.deliver(
+    {
+      channel: "sprinkle",
+      source: "sprinkle:gelatiere",
+      title: "Gelatiere",
+      text: "run",
+      body: `Run a pass now: read ${g.procedure} and follow it.`,
+      target: `scoop:${handle}`
+    },
+    context
+  );
+  return { code: 0, out: `asked scoop ${handle} for a pass
+` };
+}
+async function suggest(g, path, context) {
+  if (!path) return { code: 2, out: USAGE };
+  const read = await g.options.env.readTextFile(path, context);
+  if (!read.ok) return fail(`can't read ${path}`);
+  let parsed;
+  try {
+    parsed = JSON.parse(read.value);
+  } catch (error) {
+    return fail(`${path} is not JSON (${error.message})`);
+  }
+  const folded = fold(await g.load(context), parsed, g.now());
+  await writeStore(g.options.env, folded.store, context);
+  const rejected = folded.rejected.map((reason) => `rejected ${reason}
+`).join("");
+  return {
+    code: 0,
+    out: `added ${folded.added}, updated ${folded.updated}, rejected ${folded.rejected.length}
+${rejected}`
+  };
+}
+async function deliver(g, context) {
+  const store = await g.load(context);
+  const fresh = open(store).filter((item) => !item.deliveredAt);
+  const cones = Object.keys(g.options.agents.state().cones);
+  const byCone = /* @__PURE__ */ new Map();
+  for (const item of fresh) {
+    const named = item.cones.filter((cone) => cones.includes(cone));
+    for (const cone of named.length ? named : ["cone"])
+      byCone.set(cone, [...byCone.get(cone) ?? [], item]);
+  }
+  for (const [cone, items] of byCone) {
+    const body = {
+      added: items.length,
+      open: open(store).length,
+      suggestions: items.map(({ id, kind, title, body: text }) => ({
+        id,
+        kind,
+        title,
+        body: text
+      })),
+      path: STORE
+    };
+    await g.options.licks.deliver(
+      {
+        channel: "sprinkle",
+        source: `sprinkle:${SPRINKLE}`,
+        title: "Suggestions",
+        text: "gelatiere-suggestions",
+        body: JSON.stringify(body, null, 2),
+        target: `cone:${cone}`
+      },
+      context
+    );
+  }
+  for (const item of fresh) item.deliveredAt = g.now();
+  if (fresh.length) await writeStore(g.options.env, store, context);
+  return {
+    code: 0,
+    out: `delivered ${fresh.length} to ${[...byCone.keys()].join(", ") || "nobody"}
+`
+  };
+}
+async function fetchText(env, url, temp, context) {
+  const fetched = await env.exec(
+    ["curl", "-fsSL", "--max-time", "30", "-o", temp, url],
+    void 0,
+    context
+  );
+  const read = await env.readTextFile(temp, context);
+  await env.remove(temp, { force: true }, context);
+  return fetched.ok && fetched.value.exitCode === 0 && read.ok ? read.value : void 0;
+}
+async function install(g, id, context) {
+  const { env, home } = g.options;
+  const item = (await g.load(context)).find((entry) => entry.id === id && entry.kind === "skill");
+  const checked = item ? validate(item) : `there is no skill suggestion ${id}`;
+  if (typeof checked === "string") return fail(checked);
+  const { skill, source } = checked;
+  const dir = `${home}/.pi/agent/skills/${skill}`;
+  const present = await env.exists(`${dir}/SKILL.md`, context);
+  if (present.ok && present.value) return fail(`${skill} is already installed in ${dir}`);
+  const text = await fetchText(env, source, `${home}/.gelatiere-${id}.md`, context);
+  if (text === void 0) return fail(`couldn't fetch ${source}`);
+  const parsed = skillFromText(text, `${dir}/SKILL.md`, "user");
+  if (parsed.skills[0]?.name !== skill) {
+    const why = parsed.diagnostics[0] ? ` (${parsed.diagnostics[0].message})` : "";
+    return fail(`${source} is not a SKILL.md for ${skill}${why}`);
+  }
+  await env.createDir(dir, { recursive: true }, context);
+  await env.writeFile(`${dir}/SKILL.md`, text, context);
+  await g.mark(id, "takenAt", context);
+  return {
+    code: 0,
+    out: `installed ${skill} in ${dir}; it is /skill:${skill} once the skills reload
+`
+  };
+}
+async function list(g, argv, context) {
+  const store = await g.load(context);
+  const shown = argv.includes("--all") ? store : open(store);
+  if (argv.includes("--json")) return { code: 0, out: `${JSON.stringify(shown, null, 2)}
+` };
+  return { code: 0, out: shown.length ? `${shown.map(row).join("\n")}
+` : "no suggestions\n" };
+}
+async function status(g, context) {
+  const { env, agents } = g.options;
+  const store = await readStore(env, context);
+  const handle = handleOf(agents);
+  const read = await env.readTextFile(g.crontab, context);
+  const scheduled = (read.ok ? read.value : "").split("\n").map(scheduleOf).find(Boolean);
+  const counts = store ? `${open(store).length} open, ${store.filter((item) => item.takenAt).length} taken, ${store.filter((item) => item.dismissedAt).length} dismissed` : "none yet";
+  const lines = [
+    `scoop: ${handle ?? "none (gelatiere init)"}`,
+    `schedule: ${scheduled ?? "none"}`,
+    `store: ${counts}`
+  ];
+  return { code: 0, out: `${lines.join("\n")}
+` };
+}
+async function dismiss(g, id, context) {
+  return await g.mark(id, "dismissedAt", context) ? { code: 0, out: `dismissed ${id}
+` } : fail(`there is no suggestion ${id}`);
+}
+const VERBS = {
+  init: (g, _argv, context) => init(g, context),
+  run: (g, _argv, context) => run(g, context),
+  suggest: (g, argv, context) => g.serial(() => suggest(g, argv[1], context)),
+  deliver: (g, _argv, context) => g.serial(() => deliver(g, context)),
+  install: (g, argv, context) => install(g, argv[1] ?? "", context),
+  list: (g, argv, context) => list(g, argv, context),
+  status: (g, _argv, context) => status(g, context),
+  dismiss: (g, argv, context) => dismiss(g, argv[1] ?? "", context)
+};
+function attachGelatiere(options) {
+  const { env, home } = options;
+  const now = options.now ?? Date.now;
+  const load = async (context) => await readStore(env, context) ?? [];
+  let chain = Promise.resolve();
+  const serial = (work) => {
+    const next = chain.catch(() => void 0).then(work);
+    chain = next;
+    return next;
+  };
+  const g = {
+    serial,
+    options,
+    now,
+    crontab: `${home}/.slicc/crontab`,
+    procedure: `${home}/.pi/agent/GELATIERE.md`,
+    load,
+    mark: (id, field, context) => serial(async () => {
+      const store = await load(context);
+      const item = store.find((entry) => entry.id === id);
+      if (!item) return false;
+      item[field] ??= now();
+      await writeStore(env, store, context);
+      return true;
+    })
+  };
+  return {
+    command(argv, _caller, context) {
+      const verb = argv[0] ?? "help";
+      const handler = VERBS[verb];
+      if (handler) return handler(g, argv, context);
+      return Promise.resolve({ code: verb === "help" || verb === "--help" ? 0 : 2, out: USAGE });
+    },
+    async intercept(action, data, context) {
+      const id = String(data?.id ?? "");
+      if (action === "gelatiere-dismiss") {
+        await g.mark(id, "dismissedAt", context);
+        return true;
+      }
+      if (action === "gelatiere-install" || action === "gelatiere-try")
+        await g.mark(id, "takenAt", context);
+      return false;
+    }
+  };
+}
+function lateGelatiere() {
+  let runtime;
+  return {
+    async intercept(id, payload, context) {
+      return id === SPRINKLE && runtime !== void 0 ? runtime.intercept(payload.action, payload.data, context) : false;
+    },
+    command(argv, caller, context) {
+      return runtime ? runtime.command(argv, caller, context) : Promise.resolve({ code: 1, out: "gelatiere: not ready yet\n" });
+    },
+    attach(options) {
+      runtime = attachGelatiere(options);
+      return runtime;
+    }
+  };
+}
+export {
+  PROCEDURE,
+  ROLE,
+  SCHEDULE,
+  SPRINKLE,
+  USAGE,
+  attachGelatiere,
+  lateGelatiere,
+  scheduleOf
+};
+//# sourceMappingURL=index.js.map

package/dist/gelatiere/index.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/gelatiere/index.ts"],
+  "sourcesContent": ["import type { Context } from '@earendil-works/chord';\nimport type { ExecutionEnv } from '@earendil-works/pi-durable/env';\nimport { type Agents, live } from '../agents.ts';\nimport type { Licks } from '../licks/licks.ts';\nimport type { Roles } from '../roles/roles.ts';\nimport type { Scoops } from '../scoops/service.ts';\nimport { skillFromText } from '../skills/skills.ts';\nimport { fold, open, readStore, STORE, type Suggestion, validate, writeStore } from './store.ts';\n\nexport type Answer = { code: number; out: string };\n\nexport const ROLE = 'gelatiere';\nexport const SPRINKLE = 'suggestions';\nexport const PROCEDURE = 'packages/vfs-root/gelatiere/GELATIERE.md';\nexport const SCHEDULE = '0 3 * * *';\n\nexport interface GelatiereAttach {\n  agents: Agents;\n  licks: Licks;\n  env: ExecutionEnv;\n  home: string;\n  scoops: Scoops;\n  roles: (context: Context) => Promise<Roles>;\n  assets?: (path: string) => Promise<string>;\n  now?: () => number;\n}\n\nexport interface GelatiereRuntime {\n  command(argv: readonly string[], caller: string | null, context: Context): Promise<Answer>;\n  intercept(action: string, data: unknown, context: Context): Promise<boolean>;\n}\n\nexport const USAGE = `usage:\n  gelatiere init            start the gelatiere scoop and its nightly crontab line\n  gelatiere run             ask the gelatiere for a pass now\n  gelatiere suggest <file>  fold a JSON array of suggestions into the store\n  gelatiere deliver         lick each cone with the suggestions that are new for it\n  gelatiere install <id>    install a suggested skill from its source into ~/.pi/agent/skills\n  gelatiere list [--all] [--json]\n  gelatiere dismiss <id>    mark a suggestion as not wanted\n  gelatiere status\n\nThe store is ${STORE}; the suggestions sprinkle shows it.\n`;\n\nfunction line(handle: string): string {\n  return `${SCHEDULE} ${ROLE} scoop:${handle} Nightly pass: read ~/.pi/agent/GELATIERE.md and follow it.`;\n}\n\nconst JOB = new RegExp(`^((?:\\\\S+\\\\s+){4}\\\\S+|@\\\\w+)\\\\s+${ROLE}(?:\\\\s|$)`);\n\nexport function scheduleOf(entry: string): string | undefined {\n  return JOB.exec(entry.trim())?.[1]?.replace(/\\s+/g, ' ');\n}\n\nfunction handleOf(agents: Agents): string | undefined {\n  const found = Object.entries(agents.state().scoops).find(\n    ([, record]) => record.role === ROLE && live(record)\n  );\n  return found?.[1].folder;\n}\n\nfunction row(item: Suggestion): string {\n  const state = item.takenAt ? 'taken' : item.dismissedAt ? 'dismissed' : 'open';\n  return `${item.id}\\t${item.kind}\\t${state}\\t${item.title}`;\n}\n\ntype G = {\n  serial: <T>(work: () => Promise<T>) => Promise<T>;\n  options: GelatiereAttach;\n  now: () => number;\n  crontab: string;\n  procedure: string;\n  load: (context: Context) => Promise<Suggestion[]>;\n  mark: (id: string, field: 'dismissedAt' | 'takenAt', context: Context) => Promise<boolean>;\n};\n\nconst fail = (out: string): Answer => ({ code: 1, out: `gelatiere: ${out}\\n` });\n\nasync function schedule(g: G, handle: string, context: Context): Promise<void> {\n  const { env, home } = g.options;\n  const read = await env.readTextFile(g.crontab, context);\n  const kept = (read.ok ? read.value : '')\n    .split('\\n')\n    .filter((entry) => entry.trim() && !scheduleOf(entry));\n  await env.createDir(`${home}/.slicc`, { recursive: true }, context);\n  await env.writeFile(g.crontab, `${[...kept, line(handle)].join('\\n')}\\n`, context);\n}\n\nasync function seed(g: G, context: Context): Promise<void> {\n  const { env, assets } = g.options;\n  const existing = await env.exists(g.procedure, context);\n  if ((existing.ok && existing.value) || !assets) return;\n  const text = await assets(PROCEDURE).catch(() => undefined);\n  if (text !== undefined) await env.writeFile(g.procedure, text, context);\n}\n\nasync function init(g: G, context: Context): Promise<Answer> {\n  const { options } = g;\n  await seed(g, context);\n  let handle = handleOf(options.agents);\n  if (!handle) {\n    const roles = await options.roles(context);\n    const role = roles.roles.find((entry) => entry.name === ROLE);\n    if (!role) return fail('the gelatiere role is missing');\n    const spawned = await options.scoops.spawn(\n      {\n        cone: 'cone',\n        kind: 'async',\n        name: ROLE,\n        role,\n        prompts: [],\n        target: null,\n        fromAgent: false,\n        request: `gelatiere-init-${g.now()}`,\n        limits: roles.limits,\n      },\n      context\n    );\n    if (spawned.code !== 0) return { code: 1, out: `gelatiere: ${spawned.out}` };\n    handle = spawned.out.trim();\n  }\n  await schedule(g, handle, context);\n  return {\n    code: 0,\n    out: `the gelatiere is scoop ${handle}; it runs at ${SCHEDULE} (crontab) and with gelatiere run, following ${g.procedure}\\n`,\n  };\n}\n\nasync function run(g: G, context: Context): Promise<Answer> {\n  const handle = handleOf(g.options.agents);\n  if (!handle) return fail('there is no gelatiere yet; run gelatiere init');\n  await g.options.licks.deliver(\n    {\n      channel: 'sprinkle',\n      source: 'sprinkle:gelatiere',\n      title: 'Gelatiere',\n      text: 'run',\n      body: `Run a pass now: read ${g.procedure} and follow it.`,\n      target: `scoop:${handle}`,\n    },\n    context\n  );\n  return { code: 0, out: `asked scoop ${handle} for a pass\\n` };\n}\n\nasync function suggest(g: G, path: string | undefined, context: Context): Promise<Answer> {\n  if (!path) return { code: 2, out: USAGE };\n  const read = await g.options.env.readTextFile(path, context);\n  if (!read.ok) return fail(`can't read ${path}`);\n  let parsed: unknown;\n  try {\n    parsed = JSON.parse(read.value);\n  } catch (error) {\n    return fail(`${path} is not JSON (${(error as Error).message})`);\n  }\n  const folded = fold(await g.load(context), parsed, g.now());\n  await writeStore(g.options.env, folded.store, context);\n  const rejected = folded.rejected.map((reason) => `rejected ${reason}\\n`).join('');\n  return {\n    code: 0,\n    out: `added ${folded.added}, updated ${folded.updated}, rejected ${folded.rejected.length}\\n${rejected}`,\n  };\n}\n\nasync function deliver(g: G, context: Context): Promise<Answer> {\n  const store = await g.load(context);\n  const fresh = open(store).filter((item) => !item.deliveredAt);\n  const cones = Object.keys(g.options.agents.state().cones);\n  const byCone = new Map<string, Suggestion[]>();\n  for (const item of fresh) {\n    const named = item.cones.filter((cone) => cones.includes(cone));\n    for (const cone of named.length ? named : ['cone'])\n      byCone.set(cone, [...(byCone.get(cone) ?? []), item]);\n  }\n  for (const [cone, items] of byCone) {\n    const body = {\n      added: items.length,\n      open: open(store).length,\n      suggestions: items.map(({ id, kind, title, body: text }) => ({\n        id,\n        kind,\n        title,\n        body: text,\n      })),\n      path: STORE,\n    };\n    await g.options.licks.deliver(\n      {\n        channel: 'sprinkle',\n        source: `sprinkle:${SPRINKLE}`,\n        title: 'Suggestions',\n        text: 'gelatiere-suggestions',\n        body: JSON.stringify(body, null, 2),\n        target: `cone:${cone}`,\n      },\n      context\n    );\n  }\n  for (const item of fresh) item.deliveredAt = g.now();\n  if (fresh.length) await writeStore(g.options.env, store, context);\n  return {\n    code: 0,\n    out: `delivered ${fresh.length} to ${[...byCone.keys()].join(', ') || 'nobody'}\\n`,\n  };\n}\n\nasync function fetchText(env: ExecutionEnv, url: string, temp: string, context: Context) {\n  const fetched = await env.exec(\n    ['curl', '-fsSL', '--max-time', '30', '-o', temp, url],\n    undefined,\n    context\n  );\n  const read = await env.readTextFile(temp, context);\n  await env.remove(temp, { force: true }, context);\n  return fetched.ok && fetched.value.exitCode === 0 && read.ok ? read.value : undefined;\n}\n\nasync function install(g: G, id: string, context: Context): Promise<Answer> {\n  const { env, home } = g.options;\n  const item = (await g.load(context)).find((entry) => entry.id === id && entry.kind === 'skill');\n  const checked = item ? validate(item) : `there is no skill suggestion ${id}`;\n  if (typeof checked === 'string') return fail(checked);\n  const { skill, source } = checked as Required<Pick<Suggestion, 'skill' | 'source'>>;\n  const dir = `${home}/.pi/agent/skills/${skill}`;\n  const present = await env.exists(`${dir}/SKILL.md`, context);\n  if (present.ok && present.value) return fail(`${skill} is already installed in ${dir}`);\n  const text = await fetchText(env, source, `${home}/.gelatiere-${id}.md`, context);\n  if (text === undefined) return fail(`couldn't fetch ${source}`);\n  const parsed = skillFromText(text, `${dir}/SKILL.md`, 'user');\n  if (parsed.skills[0]?.name !== skill) {\n    const why = parsed.diagnostics[0] ? ` (${parsed.diagnostics[0].message})` : '';\n    return fail(`${source} is not a SKILL.md for ${skill}${why}`);\n  }\n  await env.createDir(dir, { recursive: true }, context);\n  await env.writeFile(`${dir}/SKILL.md`, text, context);\n  await g.mark(id, 'takenAt', context);\n  return {\n    code: 0,\n    out: `installed ${skill} in ${dir}; it is /skill:${skill} once the skills reload\\n`,\n  };\n}\n\nasync function list(g: G, argv: readonly string[], context: Context): Promise<Answer> {\n  const store = await g.load(context);\n  const shown = argv.includes('--all') ? store : open(store);\n  if (argv.includes('--json')) return { code: 0, out: `${JSON.stringify(shown, null, 2)}\\n` };\n  return { code: 0, out: shown.length ? `${shown.map(row).join('\\n')}\\n` : 'no suggestions\\n' };\n}\n\nasync function status(g: G, context: Context): Promise<Answer> {\n  const { env, agents } = g.options;\n  const store = await readStore(env, context);\n  const handle = handleOf(agents);\n  const read = await env.readTextFile(g.crontab, context);\n  const scheduled = (read.ok ? read.value : '').split('\\n').map(scheduleOf).find(Boolean);\n  const counts = store\n    ? `${open(store).length} open, ${store.filter((item) => item.takenAt).length} taken, ${store.filter((item) => item.dismissedAt).length} dismissed`\n    : 'none yet';\n  const lines = [\n    `scoop: ${handle ?? 'none (gelatiere init)'}`,\n    `schedule: ${scheduled ?? 'none'}`,\n    `store: ${counts}`,\n  ];\n  return { code: 0, out: `${lines.join('\\n')}\\n` };\n}\n\nasync function dismiss(g: G, id: string, context: Context): Promise<Answer> {\n  return (await g.mark(id, 'dismissedAt', context))\n    ? { code: 0, out: `dismissed ${id}\\n` }\n    : fail(`there is no suggestion ${id}`);\n}\n\nconst VERBS: Record<string, (g: G, argv: readonly string[], context: Context) => Promise<Answer>> =\n  {\n    init: (g, _argv, context) => init(g, context),\n    run: (g, _argv, context) => run(g, context),\n    suggest: (g, argv, context) => g.serial(() => suggest(g, argv[1], context)),\n    deliver: (g, _argv, context) => g.serial(() => deliver(g, context)),\n    install: (g, argv, context) => install(g, argv[1] ?? '', context),\n    list: (g, argv, context) => list(g, argv, context),\n    status: (g, _argv, context) => status(g, context),\n    dismiss: (g, argv, context) => dismiss(g, argv[1] ?? '', context),\n  };\n\nexport function attachGelatiere(options: GelatiereAttach): GelatiereRuntime {\n  const { env, home } = options;\n  const now = options.now ?? Date.now;\n  const load = async (context: Context) => (await readStore(env, context)) ?? [];\n  let chain: Promise<unknown> = Promise.resolve();\n  const serial = <T>(work: () => Promise<T>): Promise<T> => {\n    const next = chain.catch(() => undefined).then(work);\n    chain = next;\n    return next;\n  };\n  const g: G = {\n    serial,\n    options,\n    now,\n    crontab: `${home}/.slicc/crontab`,\n    procedure: `${home}/.pi/agent/GELATIERE.md`,\n    load,\n    mark: (id, field, context) =>\n      serial(async () => {\n        const store = await load(context);\n        const item = store.find((entry) => entry.id === id);\n        if (!item) return false;\n        item[field] ??= now();\n        await writeStore(env, store, context);\n        return true;\n      }),\n  };\n  return {\n    command(argv, _caller, context) {\n      const verb = argv[0] ?? 'help';\n      const handler = VERBS[verb];\n      if (handler) return handler(g, argv, context);\n      return Promise.resolve({ code: verb === 'help' || verb === '--help' ? 0 : 2, out: USAGE });\n    },\n    async intercept(action, data, context) {\n      const id = String((data as { id?: unknown } | null)?.id ?? '');\n      if (action === 'gelatiere-dismiss') {\n        await g.mark(id, 'dismissedAt', context);\n        return true;\n      }\n      if (action === 'gelatiere-install' || action === 'gelatiere-try')\n        await g.mark(id, 'takenAt', context);\n      return false;\n    },\n  };\n}\n\nexport function lateGelatiere() {\n  let runtime: GelatiereRuntime | undefined;\n  return {\n    async intercept(\n      id: string,\n      payload: { action: string; data: unknown },\n      context: Context\n    ): Promise<boolean> {\n      return id === SPRINKLE && runtime !== undefined\n        ? runtime.intercept(payload.action, payload.data, context)\n        : false;\n    },\n    command(argv: readonly string[], caller: string | null, context: Context): Promise<Answer> {\n      return runtime\n        ? runtime.command(argv, caller, context)\n        : Promise.resolve({ code: 1, out: 'gelatiere: not ready yet\\n' });\n    },\n    attach(options: GelatiereAttach): GelatiereRuntime {\n      runtime = attachGelatiere(options);\n      return runtime;\n    },\n  };\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/gelatiere/store.js

@@ -0,0 +1,122 @@
+import { redactSecrets } from "../memory/format.js";
+import { SUGGESTIONS_DIR, SUGGESTIONS_STORE } from "../sprinkles/sprinkles.js";
+const STORE_DIR = SUGGESTIONS_DIR;
+const STORE = SUGGESTIONS_STORE;
+const KINDS = ["skill", "use-case", "tip", "skill-idea", "issue"];
+const MAX_OPEN = 50;
+const PROMPTED = /* @__PURE__ */ new Set(["use-case", "skill-idea", "issue"]);
+const ID = /^[a-z0-9][a-z0-9-]{0,63}$/;
+const CONE = /^[a-z0-9][a-z0-9._-]{0,63}$/;
+const SOURCE = /^https:\/\/[^\s"'<>]+\/SKILL\.md$/;
+function text(value, limit) {
+  if (typeof value !== "string") return void 0;
+  const clean = redactSecrets(value.trim()).text;
+  return clean ? clean.slice(0, limit) : void 0;
+}
+function origin(skill, source) {
+  const url = new URL(source);
+  return `${skill} from ${url.host}${url.pathname}`;
+}
+function kindProblem(kind, skill, source, prompt) {
+  if (kind === "skill" && (!skill || !ID.test(skill)))
+    return "a skill needs its name (a-z, 0-9, -)";
+  if (kind === "skill" && (!source || !SOURCE.test(source)))
+    return "a skill needs its source, an https URL of its SKILL.md";
+  if (PROMPTED.has(kind) && !prompt) return `a ${kind} needs its prompt`;
+  return void 0;
+}
+function shapeProblem(url, cones) {
+  if (url !== void 0 && !/^https:\/\/[^\s"'<>]+$/.test(url)) return "url must be https";
+  if (cones.some((cone) => !CONE.test(cone))) return "cones must be cone ids";
+  return void 0;
+}
+function validate(candidate) {
+  if (!candidate || typeof candidate !== "object") return "not an object";
+  const item = candidate;
+  const id = typeof item.id === "string" ? item.id : "";
+  if (!ID.test(id)) return `id "${String(item.id)}" must be 1\u201364 of a-z, 0-9 and -`;
+  if (!KINDS.includes(item.kind)) return `${id}: kind must be one of ${KINDS.join(", ")}`;
+  const title = text(item.title, 120);
+  const body = text(item.body, 600);
+  if (!title || !body) return `${id}: needs a title and a body`;
+  const skill = typeof item.skill === "string" ? item.skill.trim() : void 0;
+  const source = typeof item.source === "string" ? item.source.trim() : void 0;
+  const url = typeof item.url === "string" ? item.url.trim() : void 0;
+  const cones = Array.isArray(item.cones) ? item.cones.filter((cone) => typeof cone === "string") : [];
+  const evidence = text(item.evidence, 300);
+  const prompt = text(item.prompt, 1e3);
+  const problem = kindProblem(item.kind, skill, source, prompt) ?? shapeProblem(url, cones);
+  if (problem) return `${id}: ${problem}`;
+  const installs = item.kind === "skill" ? { skill, source, install: origin(skill, source) } : {};
+  return {
+    id,
+    kind: item.kind,
+    title,
+    body,
+    ...evidence ? { evidence } : {},
+    ...installs,
+    ...prompt ? { prompt } : {},
+    ...url ? { url } : {},
+    cones,
+    createdAt: 0
+  };
+}
+function fold(store, candidates, now) {
+  const next = store.map((item) => ({ ...item }));
+  const rejected = [];
+  let added = 0;
+  let updated = 0;
+  if (!Array.isArray(candidates))
+    return { store: next, added, updated, rejected: ["not a JSON array"] };
+  for (const candidate of candidates) {
+    const checked = validate(candidate);
+    if (typeof checked === "string") {
+      rejected.push(checked);
+      continue;
+    }
+    const at = next.findIndex((item) => item.id === checked.id);
+    const old = next[at];
+    if (old) {
+      if (old.dismissedAt || old.takenAt) continue;
+      next[at] = { ...checked, createdAt: old.createdAt };
+      updated++;
+    } else if (open(next).length >= MAX_OPEN)
+      rejected.push(`${checked.id}: ${MAX_OPEN} suggestions are already open`);
+    else {
+      next.push({ ...checked, createdAt: now });
+      added++;
+    }
+  }
+  return { store: next, added, updated, rejected };
+}
+function open(store) {
+  return store.filter((item) => !item.dismissedAt && !item.takenAt);
+}
+async function readStore(env, context) {
+  const read = await env.readTextFile(STORE, context);
+  if (!read.ok) return null;
+  try {
+    const parsed = JSON.parse(read.value);
+    return Array.isArray(parsed) ? parsed.filter((item) => typeof validate(item) !== "string") : [];
+  } catch {
+    return [];
+  }
+}
+async function writeStore(env, store, context) {
+  await env.createDir(STORE_DIR, { recursive: true }, context);
+  const written = await env.writeFile(STORE, `${JSON.stringify(store, null, 2)}
+`, context);
+  if (!written.ok) throw new Error(written.error.message);
+}
+export {
+  KINDS,
+  MAX_OPEN,
+  STORE,
+  STORE_DIR,
+  fold,
+  open,
+  readStore,
+  validate,
+  writeStore
+};
+//# sourceMappingURL=store.js.map

package/dist/gelatiere/store.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/gelatiere/store.ts"],
+  "sourcesContent": ["import type { Context } from '@earendil-works/chord';\nimport type { ExecutionEnv } from '@earendil-works/pi-durable/env';\nimport { redactSecrets } from '../memory/format.ts';\nimport { SUGGESTIONS_DIR, SUGGESTIONS_STORE } from '../sprinkles/sprinkles.ts';\n\nexport const STORE_DIR = SUGGESTIONS_DIR;\nexport const STORE = SUGGESTIONS_STORE;\nexport const KINDS = ['skill', 'use-case', 'tip', 'skill-idea', 'issue'] as const;\nexport const MAX_OPEN = 50;\nconst PROMPTED = new Set<Kind>(['use-case', 'skill-idea', 'issue']);\n\nexport type Kind = (typeof KINDS)[number];\n\nexport interface Suggestion {\n  id: string;\n  kind: Kind;\n  title: string;\n  body: string;\n  evidence?: string;\n  skill?: string;\n  source?: string;\n  install?: string;\n  prompt?: string;\n  url?: string;\n  cones: string[];\n  createdAt: number;\n  deliveredAt?: number;\n  dismissedAt?: number;\n  takenAt?: number;\n}\n\nconst ID = /^[a-z0-9][a-z0-9-]{0,63}$/;\nconst CONE = /^[a-z0-9][a-z0-9._-]{0,63}$/;\nconst SOURCE = /^https:\\/\\/[^\\s\"'<>]+\\/SKILL\\.md$/;\n\nfunction text(value: unknown, limit: number): string | undefined {\n  if (typeof value !== 'string') return undefined;\n  const clean = redactSecrets(value.trim()).text;\n  return clean ? clean.slice(0, limit) : undefined;\n}\n\nfunction origin(skill: string | undefined, source: string | undefined): string {\n  const url = new URL(source as string);\n  return `${skill} from ${url.host}${url.pathname}`;\n}\n\nfunction kindProblem(\n  kind: Kind,\n  skill: string | undefined,\n  source: string | undefined,\n  prompt: string | undefined\n): string | undefined {\n  if (kind === 'skill' && (!skill || !ID.test(skill)))\n    return 'a skill needs its name (a-z, 0-9, -)';\n  if (kind === 'skill' && (!source || !SOURCE.test(source)))\n    return 'a skill needs its source, an https URL of its SKILL.md';\n  if (PROMPTED.has(kind) && !prompt) return `a ${kind} needs its prompt`;\n  return undefined;\n}\n\nfunction shapeProblem(url: string | undefined, cones: string[]): string | undefined {\n  if (url !== undefined && !/^https:\\/\\/[^\\s\"'<>]+$/.test(url)) return 'url must be https';\n  if (cones.some((cone) => !CONE.test(cone))) return 'cones must be cone ids';\n  return undefined;\n}\n\nexport function validate(candidate: unknown): Suggestion | string {\n  if (!candidate || typeof candidate !== 'object') return 'not an object';\n  const item = candidate as Record<string, unknown>;\n  const id = typeof item.id === 'string' ? item.id : '';\n  if (!ID.test(id)) return `id \"${String(item.id)}\" must be 1\u201364 of a-z, 0-9 and -`;\n  if (!KINDS.includes(item.kind as Kind)) return `${id}: kind must be one of ${KINDS.join(', ')}`;\n  const title = text(item.title, 120);\n  const body = text(item.body, 600);\n  if (!title || !body) return `${id}: needs a title and a body`;\n  const skill = typeof item.skill === 'string' ? item.skill.trim() : undefined;\n  const source = typeof item.source === 'string' ? item.source.trim() : undefined;\n  const url = typeof item.url === 'string' ? item.url.trim() : undefined;\n  const cones = Array.isArray(item.cones)\n    ? item.cones.filter((cone): cone is string => typeof cone === 'string')\n    : [];\n  const evidence = text(item.evidence, 300);\n  const prompt = text(item.prompt, 1000);\n  const problem = kindProblem(item.kind as Kind, skill, source, prompt) ?? shapeProblem(url, cones);\n  if (problem) return `${id}: ${problem}`;\n  const installs = item.kind === 'skill' ? { skill, source, install: origin(skill, source) } : {};\n  return {\n    id,\n    kind: item.kind as Kind,\n    title,\n    body,\n    ...(evidence ? { evidence } : {}),\n    ...installs,\n    ...(prompt ? { prompt } : {}),\n    ...(url ? { url } : {}),\n    cones,\n    createdAt: 0,\n  };\n}\n\nexport function fold(\n  store: readonly Suggestion[],\n  candidates: unknown,\n  now: number\n): { store: Suggestion[]; added: number; updated: number; rejected: string[] } {\n  const next = store.map((item) => ({ ...item }));\n  const rejected: string[] = [];\n  let added = 0;\n  let updated = 0;\n  if (!Array.isArray(candidates))\n    return { store: next, added, updated, rejected: ['not a JSON array'] };\n  for (const candidate of candidates) {\n    const checked = validate(candidate);\n    if (typeof checked === 'string') {\n      rejected.push(checked);\n      continue;\n    }\n    const at = next.findIndex((item) => item.id === checked.id);\n    const old = next[at];\n    if (old) {\n      if (old.dismissedAt || old.takenAt) continue;\n      next[at] = { ...checked, createdAt: old.createdAt };\n      updated++;\n    } else if (open(next).length >= MAX_OPEN)\n      rejected.push(`${checked.id}: ${MAX_OPEN} suggestions are already open`);\n    else {\n      next.push({ ...checked, createdAt: now });\n      added++;\n    }\n  }\n  return { store: next, added, updated, rejected };\n}\n\nexport function open(store: readonly Suggestion[]): Suggestion[] {\n  return store.filter((item) => !item.dismissedAt && !item.takenAt);\n}\n\nexport async function readStore(\n  env: Pick<ExecutionEnv, 'readTextFile'>,\n  context: Context\n): Promise<Suggestion[] | null> {\n  const read = await env.readTextFile(STORE, context);\n  if (!read.ok) return null;\n  try {\n    const parsed = JSON.parse(read.value) as unknown;\n    return Array.isArray(parsed)\n      ? parsed.filter((item): item is Suggestion => typeof validate(item) !== 'string')\n      : [];\n  } catch {\n    return [];\n  }\n}\n\nexport async function writeStore(\n  env: Pick<ExecutionEnv, 'writeFile' | 'createDir'>,\n  store: readonly Suggestion[],\n  context: Context\n): Promise<void> {\n  await env.createDir(STORE_DIR, { recursive: true }, context);\n  const written = await env.writeFile(STORE, `${JSON.stringify(store, null, 2)}\\n`, context);\n  if (!written.ok) throw new Error(written.error.message);\n}\n"],
+  "mappings": "AAEA,SAAS,qBAAqB;AAC9B,SAAS,iBAAiB,yBAAyB;AAE5C,MAAM,YAAY;AAClB,MAAM,QAAQ;AACd,MAAM,QAAQ,CAAC,SAAS,YAAY,OAAO,cAAc,OAAO;AAChE,MAAM,WAAW;AACxB,MAAM,WAAW,oBAAI,IAAU,CAAC,YAAY,cAAc,OAAO,CAAC;AAsBlE,MAAM,KAAK;AACX,MAAM,OAAO;AACb,MAAM,SAAS;AAEf,SAAS,KAAK,OAAgB,OAAmC;AAC/D,MAAI,OAAO,UAAU,SAAU,QAAO;AACtC,QAAM,QAAQ,cAAc,MAAM,KAAK,CAAC,EAAE;AAC1C,SAAO,QAAQ,MAAM,MAAM,GAAG,KAAK,IAAI;AACzC;AAEA,SAAS,OAAO,OAA2B,QAAoC;AAC7E,QAAM,MAAM,IAAI,IAAI,MAAgB;AACpC,SAAO,GAAG,KAAK,SAAS,IAAI,IAAI,GAAG,IAAI,QAAQ;AACjD;AAEA,SAAS,YACP,MACA,OACA,QACA,QACoB;AACpB,MAAI,SAAS,YAAY,CAAC,SAAS,CAAC,GAAG,KAAK,KAAK;AAC/C,WAAO;AACT,MAAI,SAAS,YAAY,CAAC,UAAU,CAAC,OAAO,KAAK,MAAM;AACrD,WAAO;AACT,MAAI,SAAS,IAAI,IAAI,KAAK,CAAC,OAAQ,QAAO,KAAK,IAAI;AACnD,SAAO;AACT;AAEA,SAAS,aAAa,KAAyB,OAAqC;AAClF,MAAI,QAAQ,UAAa,CAAC,yBAAyB,KAAK,GAAG,EAAG,QAAO;AACrE,MAAI,MAAM,KAAK,CAAC,SAAS,CAAC,KAAK,KAAK,IAAI,CAAC,EAAG,QAAO;AACnD,SAAO;AACT;AAEO,SAAS,SAAS,WAAyC;AAChE,MAAI,CAAC,aAAa,OAAO,cAAc,SAAU,QAAO;AACxD,QAAM,OAAO;AACb,QAAM,KAAK,OAAO,KAAK,OAAO,WAAW,KAAK,KAAK;AACnD,MAAI,CAAC,GAAG,KAAK,EAAE,EAAG,QAAO,OAAO,OAAO,KAAK,EAAE,CAAC;AAC/C,MAAI,CAAC,MAAM,SAAS,KAAK,IAAY,EAAG,QAAO,GAAG,EAAE,yBAAyB,MAAM,KAAK,IAAI,CAAC;AAC7F,QAAM,QAAQ,KAAK,KAAK,OAAO,GAAG;AAClC,QAAM,OAAO,KAAK,KAAK,MAAM,GAAG;AAChC,MAAI,CAAC,SAAS,CAAC,KAAM,QAAO,GAAG,EAAE;AACjC,QAAM,QAAQ,OAAO,KAAK,UAAU,WAAW,KAAK,MAAM,KAAK,IAAI;AACnE,QAAM,SAAS,OAAO,KAAK,WAAW,WAAW,KAAK,OAAO,KAAK,IAAI;AACtE,QAAM,MAAM,OAAO,KAAK,QAAQ,WAAW,KAAK,IAAI,KAAK,IAAI;AAC7D,QAAM,QAAQ,MAAM,QAAQ,KAAK,KAAK,IAClC,KAAK,MAAM,OAAO,CAAC,SAAyB,OAAO,SAAS,QAAQ,IACpE,CAAC;AACL,QAAM,WAAW,KAAK,KAAK,UAAU,GAAG;AACxC,QAAM,SAAS,KAAK,KAAK,QAAQ,GAAI;AACrC,QAAM,UAAU,YAAY,KAAK,MAAc,OAAO,QAAQ,MAAM,KAAK,aAAa,KAAK,KAAK;AAChG,MAAI,QAAS,QAAO,GAAG,EAAE,KAAK,OAAO;AACrC,QAAM,WAAW,KAAK,SAAS,UAAU,EAAE,OAAO,QAAQ,SAAS,OAAO,OAAO,MAAM,EAAE,IAAI,CAAC;AAC9F,SAAO;AAAA,IACL;AAAA,IACA,MAAM,KAAK;AAAA,IACX;AAAA,IACA;AAAA,IACA,GAAI,WAAW,EAAE,SAAS,IAAI,CAAC;AAAA,IAC/B,GAAG;AAAA,IACH,GAAI,SAAS,EAAE,OAAO,IAAI,CAAC;AAAA,IAC3B,GAAI,MAAM,EAAE,IAAI,IAAI,CAAC;AAAA,IACrB;AAAA,IACA,WAAW;AAAA,EACb;AACF;AAEO,SAAS,KACd,OACA,YACA,KAC6E;AAC7E,QAAM,OAAO,MAAM,IAAI,CAAC,UAAU,EAAE,GAAG,KAAK,EAAE;AAC9C,QAAM,WAAqB,CAAC;AAC5B,MAAI,QAAQ;AACZ,MAAI,UAAU;AACd,MAAI,CAAC,MAAM,QAAQ,UAAU;AAC3B,WAAO,EAAE,OAAO,MAAM,OAAO,SAAS,UAAU,CAAC,kBAAkB,EAAE;AACvE,aAAW,aAAa,YAAY;AAClC,UAAM,UAAU,SAAS,SAAS;AAClC,QAAI,OAAO,YAAY,UAAU;AAC/B,eAAS,KAAK,OAAO;AACrB;AAAA,IACF;AACA,UAAM,KAAK,KAAK,UAAU,CAAC,SAAS,KAAK,OAAO,QAAQ,EAAE;AAC1D,UAAM,MAAM,KAAK,EAAE;AACnB,QAAI,KAAK;AACP,UAAI,IAAI,eAAe,IAAI,QAAS;AACpC,WAAK,EAAE,IAAI,EAAE,GAAG,SAAS,WAAW,IAAI,UAAU;AAClD;AAAA,IACF,WAAW,KAAK,IAAI,EAAE,UAAU;AAC9B,eAAS,KAAK,GAAG,QAAQ,EAAE,KAAK,QAAQ,+BAA+B;AAAA,SACpE;AACH,WAAK,KAAK,EAAE,GAAG,SAAS,WAAW,IAAI,CAAC;AACxC;AAAA,IACF;AAAA,EACF;AACA,SAAO,EAAE,OAAO,MAAM,OAAO,SAAS,SAAS;AACjD;AAEO,SAAS,KAAK,OAA4C;AAC/D,SAAO,MAAM,OAAO,CAAC,SAAS,CAAC,KAAK,eAAe,CAAC,KAAK,OAAO;AAClE;AAEA,eAAsB,UACpB,KACA,SAC8B;AAC9B,QAAM,OAAO,MAAM,IAAI,aAAa,OAAO,OAAO;AAClD,MAAI,CAAC,KAAK,GAAI,QAAO;AACrB,MAAI;AACF,UAAM,SAAS,KAAK,MAAM,KAAK,KAAK;AACpC,WAAO,MAAM,QAAQ,MAAM,IACvB,OAAO,OAAO,CAAC,SAA6B,OAAO,SAAS,IAAI,MAAM,QAAQ,IAC9E,CAAC;AAAA,EACP,QAAQ;AACN,WAAO,CAAC;AAAA,EACV;AACF;AAEA,eAAsB,WACpB,KACA,OACA,SACe;AACf,QAAM,IAAI,UAAU,WAAW,EAAE,WAAW,KAAK,GAAG,OAAO;AAC3D,QAAM,UAAU,MAAM,IAAI,UAAU,OAAO,GAAG,KAAK,UAAU,OAAO,MAAM,CAAC,CAAC;AAAA,GAAM,OAAO;AACzF,MAAI,CAAC,QAAQ,GAAI,OAAM,IAAI,MAAM,QAAQ,MAAM,OAAO;AACxD;",
+  "names": []
+}