@ai-ecoverse/slicc-agent 3.13.0 → 3.14.0

package/dist/memory/runtime.js

@@ -0,0 +1,194 @@
+import {
+  replicatedState
+} from "@earendil-works/chord";
+import { workspace } from "../scoops/service.js";
+import { MEMORY_FILE } from "./format.js";
+import { MEMORY_WRITE } from "./prompt.js";
+import {
+  GLOBAL,
+  MemoryFiles,
+  memoryRoot,
+  placeOf,
+  ROLE_PREFIX,
+  rolePlace,
+  roleRoot
+} from "./store.js";
+const USAGE = `usage:
+  memory show [<scope>]   print a memory file (yours by default)
+  memory scopes           every memory scope, its entries and its file
+
+Scopes: global (everyone), a cone's id, or role:<path> for a role's memory.
+Agents write memory with the ${MEMORY_WRITE} tool; the files are plain markdown you can edit.
+`;
+async function roleDirs(env, dir, prefix, context, depth = 0) {
+  const listed = await env.listDir(dir, context);
+  if (!listed.ok || depth > 4) return [];
+  const out = [];
+  for (const info of listed.value) {
+    if (info.kind !== "directory") continue;
+    const path = prefix ? `${prefix}/${info.name}` : info.name;
+    const found = await env.exists(`${dir}/${info.name}/${MEMORY_FILE}`, context);
+    if (found.ok && found.value) out.push(path);
+    out.push(...await roleDirs(env, `${dir}/${info.name}`, path, context, depth + 1));
+  }
+  return out;
+}
+async function listPlaces(options, context) {
+  const { agents, env, home } = options;
+  const state = agents.state();
+  const out = [{ ...placeOf(home, GLOBAL), name: "Everyone" }];
+  const cones = new Set(Object.keys(state.cones));
+  const stored = await env.listDir(memoryRoot(home), context);
+  if (stored.ok) {
+    for (const info of stored.value) if (info.kind === "directory") cones.add(info.name);
+  }
+  for (const id of cones) {
+    const place = placeOf(home, id);
+    if (place) out.push({ ...place, group: "cones", name: state.cones[id]?.name ?? id });
+  }
+  const roles = new Set(await roleDirs(env, roleRoot(home), "", context));
+  const known = await options.roles?.(context).catch(() => void 0);
+  for (const role of known?.roles ?? [])
+    if (role.memory?.scope === "user") roles.add(role.memory.path);
+  for (const path of [...roles].sort()) {
+    const place = placeOf(home, `${ROLE_PREFIX}${path}`);
+    if (place) out.push({ ...place, group: "roles", name: path.split("/").at(-1) ?? path });
+  }
+  return out;
+}
+async function callerPlace(options, caller, context) {
+  const { agents, env, home } = options;
+  const record = caller ? agents.state().scoops[caller] : void 0;
+  if (record?.memory)
+    return rolePlace(env, home, record.memory, record.origin ?? workspace(record.folder), context);
+  const cone = caller?.startsWith("cone:") ? caller.slice("cone:".length) : agents.activeCone();
+  return placeOf(home, cone) ?? { problem: `there is no memory scope ${cone}` };
+}
+function placeFor(home, scope) {
+  const place = placeOf(home, scope);
+  if (!place) throw new Error(`there is no memory scope ${scope}`);
+  return place;
+}
+async function save(parts, draft, context) {
+  const { files, memories, options } = parts;
+  const place = placeFor(options.home, draft.scope);
+  const previous = draft.id ? memories.value.find((item) => item.id === draft.id) : void 0;
+  const moved = previous && previous.scope !== draft.scope;
+  try {
+    const written = await files.change(
+      place,
+      {
+        kind: "save",
+        ...previous && !moved ? { id: previous.id } : {},
+        section: draft.section,
+        title: draft.title,
+        body: draft.body,
+        tag: draft.tag
+      },
+      context
+    );
+    if (previous && moved)
+      await files.change(
+        placeFor(options.home, previous.scope),
+        { kind: "remove", id: previous.id },
+        context
+      );
+    return written.entry;
+  } finally {
+    await parts.reload(context).catch(() => void 0);
+  }
+}
+async function command(parts, argv, caller, context) {
+  const { files, memories, scopes, options } = parts;
+  const verb = argv[0] ?? "help";
+  if (verb === "scopes") {
+    await parts.reload(context);
+    const rows = scopes.value.map((scope) => {
+      const count = memories.value.filter((item) => item.scope === scope.id).length;
+      const file = placeFor(options.home, scope.id).file;
+      return `${scope.id}	${scope.label}	${count} entr${count === 1 ? "y" : "ies"}	${file}`;
+    });
+    return { code: 0, out: `${rows.join("\n")}
+` };
+  }
+  if (verb !== "show") return { code: verb === "help" || verb === "--help" ? 0 : 2, out: USAGE };
+  const place = argv[1] ? placeOf(options.home, argv[1]) ?? { problem: `there is no memory scope ${argv[1]}` } : await callerPlace(options, caller, context);
+  if ("problem" in place) return { code: 1, out: `memory: ${place.problem}
+` };
+  const read = await files.read(place.file, context);
+  return {
+    code: 0,
+    out: read?.text.trim() ? `# ${place.file}
+
+${read.text.trimEnd()}
+` : `${place.file} is empty
+`
+  };
+}
+async function attachMemory(options, connect, context) {
+  const { agents, env, home } = options;
+  const files = new MemoryFiles(env);
+  const memories = replicatedState([]);
+  const scopes = replicatedState([]);
+  const reload = async (using) => {
+    const found = await listPlaces(options, using);
+    const entries = [];
+    for (const place of found) entries.push(...await files.entries(place, using));
+    scopes.replace(
+      using,
+      found.map((place) => ({
+        id: place.scope,
+        label: place.name,
+        ...place.group ? { group: place.group } : {}
+      }))
+    );
+    memories.replace(using, entries);
+  };
+  const parts = { options, files, memories, scopes, reload };
+  connect({ agents, env, home, files, changed: reload });
+  await reload(context).catch(() => void 0);
+  let timer;
+  const schedule = () => {
+    clearTimeout(timer);
+    timer = setTimeout(() => void reload(context).catch(() => void 0), options.reloadMs);
+  };
+  const offCone = agents.onCone(schedule);
+  const watched = await env.watch(
+    [
+      { path: memoryRoot(home), recursive: true },
+      { path: roleRoot(home), recursive: true }
+    ],
+    schedule,
+    context
+  );
+  const watcher = watched.ok ? watched.value : void 0;
+  return {
+    memories,
+    scopes,
+    save: (draft, using) => save(parts, draft, using),
+    async remove(id, using) {
+      const entry = memories.value.find((item) => item.id === id);
+      if (!entry) return false;
+      const written = await files.change(
+        placeFor(home, entry.scope),
+        { kind: "remove", id },
+        using
+      );
+      await reload(using);
+      return written.found;
+    },
+    command: (argv, caller, using) => command(parts, argv, caller, using),
+    reload,
+    async close(using) {
+      offCone();
+      clearTimeout(timer);
+      await watcher?.close(using);
+    }
+  };
+}
+export {
+  USAGE,
+  attachMemory,
+  listPlaces
+};
+//# sourceMappingURL=runtime.js.map

package/dist/memory/runtime.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/memory/runtime.ts"],
+  "sourcesContent": ["import {\n  type Context,\n  type MutableReplicatedState,\n  type ReplicatedState,\n  replicatedState,\n} from '@earendil-works/chord';\nimport type { ExecutionEnv, FileWatcher } from '@earendil-works/pi-durable/env';\nimport type { Agents } from '../agents.ts';\nimport type { Role } from '../roles/roles.ts';\nimport { workspace } from '../scoops/service.ts';\nimport { MEMORY_FILE, type MemoryEntry, type MemoryScope, type MemoryTag } from './format.ts';\nimport type { Host } from './prompt.ts';\nimport { MEMORY_WRITE } from './prompt.ts';\nimport {\n  GLOBAL,\n  MemoryFiles,\n  memoryRoot,\n  type Place,\n  placeOf,\n  ROLE_PREFIX,\n  rolePlace,\n  roleRoot,\n} from './store.ts';\n\nexport type Answer = { code: number; out: string };\n\nexport interface MemoryDraft {\n  id?: string;\n  scope: string;\n  section: string;\n  title: string;\n  body: string;\n  tag: MemoryTag | null;\n}\n\nexport interface MemoryRuntime {\n  readonly memories: ReplicatedState<MemoryEntry[]>;\n  readonly scopes: ReplicatedState<MemoryScope[]>;\n  save(draft: MemoryDraft, context: Context): Promise<MemoryEntry>;\n  remove(id: string, context: Context): Promise<boolean>;\n  command(argv: readonly string[], caller: string | null, context: Context): Promise<Answer>;\n  reload(context: Context): Promise<void>;\n  close(context: Context): Promise<void>;\n}\n\nexport interface MemoryAttach {\n  agents: Agents;\n  env: ExecutionEnv;\n  home: string;\n  reloadMs: number;\n  roles?: (context: Context) => Promise<{ roles: readonly Role[] } | undefined>;\n}\n\nexport const USAGE = `usage:\n  memory show [<scope>]   print a memory file (yours by default)\n  memory scopes           every memory scope, its entries and its file\n\nScopes: global (everyone), a cone's id, or role:<path> for a role's memory.\nAgents write memory with the ${MEMORY_WRITE} tool; the files are plain markdown you can edit.\n`;\n\ntype Listed = Place & { group?: 'cones' | 'roles'; name: string };\n\nasync function roleDirs(\n  env: ExecutionEnv,\n  dir: string,\n  prefix: string,\n  context: Context,\n  depth = 0\n): Promise<string[]> {\n  const listed = await env.listDir(dir, context);\n  if (!listed.ok || depth > 4) return [];\n  const out: string[] = [];\n  for (const info of listed.value) {\n    if (info.kind !== 'directory') continue;\n    const path = prefix ? `${prefix}/${info.name}` : info.name;\n    const found = await env.exists(`${dir}/${info.name}/${MEMORY_FILE}`, context);\n    if (found.ok && found.value) out.push(path);\n    out.push(...(await roleDirs(env, `${dir}/${info.name}`, path, context, depth + 1)));\n  }\n  return out;\n}\n\nexport async function listPlaces(options: MemoryAttach, context: Context): Promise<Listed[]> {\n  const { agents, env, home } = options;\n  const state = agents.state();\n  const out: Listed[] = [{ ...(placeOf(home, GLOBAL) as Place), name: 'Everyone' }];\n  const cones = new Set(Object.keys(state.cones));\n  const stored = await env.listDir(memoryRoot(home), context);\n  if (stored.ok)\n    for (const info of stored.value) if (info.kind === 'directory') cones.add(info.name);\n  for (const id of cones) {\n    const place = placeOf(home, id);\n    if (place) out.push({ ...place, group: 'cones', name: state.cones[id]?.name ?? id });\n  }\n  const roles = new Set(await roleDirs(env, roleRoot(home), '', context));\n  const known = await options.roles?.(context).catch(() => undefined);\n  for (const role of known?.roles ?? [])\n    if (role.memory?.scope === 'user') roles.add(role.memory.path);\n  for (const path of [...roles].sort()) {\n    const place = placeOf(home, `${ROLE_PREFIX}${path}`);\n    if (place) out.push({ ...place, group: 'roles', name: path.split('/').at(-1) ?? path });\n  }\n  return out;\n}\n\nasync function callerPlace(\n  options: MemoryAttach,\n  caller: string | null,\n  context: Context\n): Promise<Place | { problem: string }> {\n  const { agents, env, home } = options;\n  const record = caller ? agents.state().scoops[caller] : undefined;\n  if (record?.memory)\n    return rolePlace(env, home, record.memory, record.origin ?? workspace(record.folder), context);\n  const cone = caller?.startsWith('cone:') ? caller.slice('cone:'.length) : agents.activeCone();\n  return placeOf(home, cone) ?? { problem: `there is no memory scope ${cone}` };\n}\n\ntype Parts = {\n  options: MemoryAttach;\n  files: MemoryFiles;\n  memories: MutableReplicatedState<MemoryEntry[]>;\n  scopes: MutableReplicatedState<MemoryScope[]>;\n  reload: (context: Context) => Promise<void>;\n};\n\nfunction placeFor(home: string, scope: string): Place {\n  const place = placeOf(home, scope);\n  if (!place) throw new Error(`there is no memory scope ${scope}`);\n  return place;\n}\n\nasync function save(parts: Parts, draft: MemoryDraft, context: Context): Promise<MemoryEntry> {\n  const { files, memories, options } = parts;\n  const place = placeFor(options.home, draft.scope);\n  const previous = draft.id ? memories.value.find((item) => item.id === draft.id) : undefined;\n  const moved = previous && previous.scope !== draft.scope;\n  try {\n    const written = await files.change(\n      place,\n      {\n        kind: 'save',\n        ...(previous && !moved ? { id: previous.id } : {}),\n        section: draft.section,\n        title: draft.title,\n        body: draft.body,\n        tag: draft.tag,\n      },\n      context\n    );\n    if (previous && moved)\n      await files.change(\n        placeFor(options.home, previous.scope),\n        { kind: 'remove', id: previous.id },\n        context\n      );\n    return written.entry as MemoryEntry;\n  } finally {\n    await parts.reload(context).catch(() => undefined);\n  }\n}\n\nasync function command(\n  parts: Parts,\n  argv: readonly string[],\n  caller: string | null,\n  context: Context\n): Promise<Answer> {\n  const { files, memories, scopes, options } = parts;\n  const verb = argv[0] ?? 'help';\n  if (verb === 'scopes') {\n    await parts.reload(context);\n    const rows = scopes.value.map((scope) => {\n      const count = memories.value.filter((item) => item.scope === scope.id).length;\n      const file = placeFor(options.home, scope.id).file;\n      return `${scope.id}\\t${scope.label}\\t${count} entr${count === 1 ? 'y' : 'ies'}\\t${file}`;\n    });\n    return { code: 0, out: `${rows.join('\\n')}\\n` };\n  }\n  if (verb !== 'show') return { code: verb === 'help' || verb === '--help' ? 0 : 2, out: USAGE };\n  const place = argv[1]\n    ? (placeOf(options.home, argv[1]) ?? { problem: `there is no memory scope ${argv[1]}` })\n    : await callerPlace(options, caller, context);\n  if ('problem' in place) return { code: 1, out: `memory: ${place.problem}\\n` };\n  const read = await files.read(place.file, context);\n  return {\n    code: 0,\n    out: read?.text.trim()\n      ? `# ${place.file}\\n\\n${read.text.trimEnd()}\\n`\n      : `${place.file} is empty\\n`,\n  };\n}\n\nexport async function attachMemory(\n  options: MemoryAttach,\n  connect: (host: Host) => void,\n  context: Context\n): Promise<MemoryRuntime> {\n  const { agents, env, home } = options;\n  const files = new MemoryFiles(env);\n  const memories = replicatedState<MemoryEntry[]>([]);\n  const scopes = replicatedState<MemoryScope[]>([]);\n  const reload = async (using: Context) => {\n    const found = await listPlaces(options, using);\n    const entries: MemoryEntry[] = [];\n    for (const place of found) entries.push(...(await files.entries(place, using)));\n    scopes.replace(\n      using,\n      found.map((place) => ({\n        id: place.scope,\n        label: place.name,\n        ...(place.group ? { group: place.group } : {}),\n      }))\n    );\n    memories.replace(using, entries);\n  };\n  const parts: Parts = { options, files, memories, scopes, reload };\n  connect({ agents, env, home, files, changed: reload });\n  await reload(context).catch(() => undefined);\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 offCone = agents.onCone(schedule);\n  const watched = await env.watch(\n    [\n      { path: memoryRoot(home), recursive: true },\n      { path: roleRoot(home), recursive: true },\n    ],\n    schedule,\n    context\n  );\n  const watcher: FileWatcher | undefined = watched.ok ? watched.value : undefined;\n  return {\n    memories,\n    scopes,\n    save: (draft, using) => save(parts, draft, using),\n    async remove(id, using) {\n      const entry = memories.value.find((item) => item.id === id);\n      if (!entry) return false;\n      const written = await files.change(\n        placeFor(home, entry.scope),\n        { kind: 'remove', id },\n        using\n      );\n      await reload(using);\n      return written.found;\n    },\n    command: (argv, caller, using) => command(parts, argv, caller, using),\n    reload,\n    async close(using) {\n      offCone();\n      clearTimeout(timer);\n      await watcher?.close(using);\n    },\n  };\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/memory/store.js

@@ -0,0 +1,153 @@
+import { trusted } from "./context.js";
+import {
+  applyChange,
+  byteLength,
+  MAX_BYTES,
+  MEMORY_FILE,
+  memoryEntries,
+  oneLine,
+  parseMemory,
+  redactSecrets,
+  serializeMemory
+} from "./format.js";
+const GLOBAL = "global";
+const ROLE_PREFIX = "role:";
+function memoryRoot(home) {
+  return `${home}/.pi/agent/memory`;
+}
+function roleRoot(home) {
+  return `${home}/.pi/agent/agent-memory`;
+}
+function safePath(path) {
+  const parts = path.split("/");
+  if (!parts.length || parts.some((part) => !/^[A-Za-z0-9][A-Za-z0-9._-]*$/.test(part)))
+    return null;
+  return parts.join("/");
+}
+function placeOf(home, scope) {
+  if (scope === GLOBAL)
+    return { scope, file: `${memoryRoot(home)}/${MEMORY_FILE}`, label: "everyone" };
+  if (scope.startsWith(ROLE_PREFIX) && scope.includes("@")) {
+    const [named, root] = scope.slice(ROLE_PREFIX.length).split("@");
+    const path = safePath(named);
+    const inside = root.startsWith("/") && safePath(root.slice(1)) !== null && trusted(root);
+    return path && inside ? {
+      scope,
+      file: `${root}/.pi/agent-memory/${path}/${MEMORY_FILE}`,
+      label: `role ${path} in ${root}`
+    } : null;
+  }
+  if (scope.startsWith(ROLE_PREFIX)) {
+    const path = safePath(scope.slice(ROLE_PREFIX.length));
+    return path ? { scope, file: `${roleRoot(home)}/${path}/${MEMORY_FILE}`, label: `role ${path}` } : null;
+  }
+  const cone = safePath(scope);
+  return cone && !cone.includes("/") ? { scope, file: `${memoryRoot(home)}/${cone}/${MEMORY_FILE}`, label: `cone ${cone}` } : null;
+}
+async function projectRoot(env, cwd, context) {
+  let dir = cwd.replace(/\/+$/, "") || "/";
+  for (; ; ) {
+    for (const marker of [".pi", ".git"]) {
+      const found = await env.exists(`${dir === "/" ? "" : dir}/${marker}`, context);
+      if (found.ok && found.value) return dir;
+    }
+    if (dir === "/") return null;
+    const cut = dir.lastIndexOf("/");
+    dir = cut <= 0 ? "/" : dir.slice(0, cut);
+  }
+}
+async function rolePlace(env, home, memory, cwd, context) {
+  const path = safePath(memory.path);
+  if (!path) return { problem: `memory path "${memory.path}" is not a safe relative path` };
+  if (memory.scope === "user") return placeOf(home, `${ROLE_PREFIX}${path}`);
+  const root = await projectRoot(env, cwd, context);
+  if (!root) return { problem: `no project root (.pi or .git) above ${cwd}` };
+  if (!trusted(root))
+    return {
+      problem: `the project root ${root} is outside /home; it gets memory once SLICC can trust a folder`
+    };
+  return placeOf(home, `${ROLE_PREFIX}${path}@${root}`);
+}
+function dirOf(file) {
+  return file.slice(0, file.lastIndexOf("/")) || "/";
+}
+class MemoryFiles {
+  #env;
+  #chains = /* @__PURE__ */ new Map();
+  constructor(env) {
+    this.#env = env;
+  }
+  async #safe(file, context) {
+    for (let path = file; ; path = dirOf(path)) {
+      const real = await this.#env.canonicalPath(path, context);
+      if (real.ok) return real.value === path;
+      if (path === "/") return true;
+    }
+  }
+  async read(file, context) {
+    if (!await this.#safe(file, context)) return null;
+    const read = await this.#env.readTextFile(file, context);
+    if (!read.ok) return null;
+    const info = await this.#env.fileInfo(file, context);
+    return { text: read.value, updatedAt: info.ok ? info.value.mtimeMs : 0 };
+  }
+  async entries(place, context) {
+    const read = await this.read(place.file, context);
+    return read ? memoryEntries(parseMemory(read.text), place.scope, read.updatedAt) : [];
+  }
+  change(place, change, context) {
+    const previous = this.#chains.get(place.file) ?? Promise.resolve();
+    const next = previous.catch(() => void 0).then(() => this.#apply(place, change, context));
+    this.#chains.set(place.file, next);
+    void next.finally(() => {
+      if (this.#chains.get(place.file) === next) this.#chains.delete(place.file);
+    }).catch(() => void 0);
+    return next;
+  }
+  async #apply(place, change, context) {
+    if (!await this.#safe(place.file, context))
+      throw new Error(`${place.file} is a symbolic link or under one; memory is not written there`);
+    const read = await this.#env.readTextFile(place.file, context);
+    const before = read.ok ? read.value : "";
+    let redacted = 0;
+    const clean = (text) => {
+      const result = redactSecrets(text);
+      redacted += result.count;
+      return result.text;
+    };
+    const safe = change.kind === "save" ? {
+      ...change,
+      section: oneLine(clean(change.section)) || "Notes",
+      title: oneLine(clean(change.title)) || "Untitled",
+      body: clean(change.body)
+    } : change;
+    const { doc, found } = applyChange(parseMemory(before), place.scope, safe);
+    const after = serializeMemory(doc);
+    const bytes = byteLength(after);
+    if (bytes > MAX_BYTES && bytes >= byteLength(before))
+      throw new Error(
+        `${place.file} would be ${bytes} bytes; memory files hold ${MAX_BYTES}. Remove or shorten entries first (a write over the limit must make the file smaller).`
+      );
+    if (change.kind === "remove" && !found)
+      return { entry: null, found, bytes: byteLength(before), redacted, file: place.file };
+    await this.#env.createDir(dirOf(place.file), { recursive: true }, context);
+    const written = await this.#env.writeFile(place.file, after, context);
+    if (!written.ok) throw new Error(written.error.message);
+    const entry = safe.kind === "save" ? memoryEntries(doc, place.scope, Date.now()).find(
+      (item) => item.source === "entry" && item.section.toLowerCase() === safe.section.toLowerCase() && item.title.toLowerCase() === safe.title.toLowerCase()
+    ) : null;
+    return { entry, found, bytes, redacted, file: place.file };
+  }
+}
+export {
+  GLOBAL,
+  MemoryFiles,
+  ROLE_PREFIX,
+  memoryRoot,
+  placeOf,
+  projectRoot,
+  rolePlace,
+  roleRoot,
+  safePath
+};
+//# sourceMappingURL=store.js.map

package/dist/memory/store.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/memory/store.ts"],
+  "sourcesContent": ["import type { Context } from '@earendil-works/chord';\nimport type { ExecutionEnv } from '@earendil-works/pi-durable/env';\nimport { trusted } from './context.ts';\nimport {\n  applyChange,\n  byteLength,\n  type Change,\n  MAX_BYTES,\n  MEMORY_FILE,\n  type MemoryEntry,\n  memoryEntries,\n  oneLine,\n  parseMemory,\n  redactSecrets,\n  serializeMemory,\n} from './format.ts';\n\nexport const GLOBAL = 'global';\nexport const ROLE_PREFIX = 'role:';\n\nexport type RoleMemory = { scope: 'user' | 'project'; path: string };\n\nexport type Place = { scope: string; file: string; label: string };\n\nexport type Written = {\n  entry: MemoryEntry | null;\n  found: boolean;\n  bytes: number;\n  redacted: number;\n  file: string;\n};\n\nexport function memoryRoot(home: string): string {\n  return `${home}/.pi/agent/memory`;\n}\n\nexport function roleRoot(home: string): string {\n  return `${home}/.pi/agent/agent-memory`;\n}\n\nexport function safePath(path: string): string | null {\n  const parts = path.split('/');\n  if (!parts.length || parts.some((part) => !/^[A-Za-z0-9][A-Za-z0-9._-]*$/.test(part)))\n    return null;\n  return parts.join('/');\n}\n\nexport function placeOf(home: string, scope: string): Place | null {\n  if (scope === GLOBAL)\n    return { scope, file: `${memoryRoot(home)}/${MEMORY_FILE}`, label: 'everyone' };\n  if (scope.startsWith(ROLE_PREFIX) && scope.includes('@')) {\n    const [named, root] = scope.slice(ROLE_PREFIX.length).split('@') as [string, string];\n    const path = safePath(named);\n    const inside = root.startsWith('/') && safePath(root.slice(1)) !== null && trusted(root);\n    return path && inside\n      ? {\n          scope,\n          file: `${root}/.pi/agent-memory/${path}/${MEMORY_FILE}`,\n          label: `role ${path} in ${root}`,\n        }\n      : null;\n  }\n  if (scope.startsWith(ROLE_PREFIX)) {\n    const path = safePath(scope.slice(ROLE_PREFIX.length));\n    return path\n      ? { scope, file: `${roleRoot(home)}/${path}/${MEMORY_FILE}`, label: `role ${path}` }\n      : null;\n  }\n  const cone = safePath(scope);\n  return cone && !cone.includes('/')\n    ? { scope, file: `${memoryRoot(home)}/${cone}/${MEMORY_FILE}`, label: `cone ${cone}` }\n    : null;\n}\n\nexport async function projectRoot(\n  env: Pick<ExecutionEnv, 'exists'>,\n  cwd: string,\n  context: Context\n): Promise<string | null> {\n  let dir = cwd.replace(/\\/+$/, '') || '/';\n  for (;;) {\n    for (const marker of ['.pi', '.git']) {\n      const found = await env.exists(`${dir === '/' ? '' : dir}/${marker}`, context);\n      if (found.ok && found.value) return dir;\n    }\n    if (dir === '/') return null;\n    const cut = dir.lastIndexOf('/');\n    dir = cut <= 0 ? '/' : dir.slice(0, cut);\n  }\n}\n\nexport async function rolePlace(\n  env: Pick<ExecutionEnv, 'exists'>,\n  home: string,\n  memory: RoleMemory,\n  cwd: string,\n  context: Context\n): Promise<Place | { problem: string }> {\n  const path = safePath(memory.path);\n  if (!path) return { problem: `memory path \"${memory.path}\" is not a safe relative path` };\n  if (memory.scope === 'user') return placeOf(home, `${ROLE_PREFIX}${path}`) as Place;\n  const root = await projectRoot(env, cwd, context);\n  if (!root) return { problem: `no project root (.pi or .git) above ${cwd}` };\n  if (!trusted(root))\n    return {\n      problem: `the project root ${root} is outside /home; it gets memory once SLICC can trust a folder`,\n    };\n  return placeOf(home, `${ROLE_PREFIX}${path}@${root}`) as Place;\n}\n\ntype Files = Pick<\n  ExecutionEnv,\n  'readTextFile' | 'writeFile' | 'createDir' | 'canonicalPath' | 'fileInfo'\n>;\n\nfunction dirOf(file: string): string {\n  return file.slice(0, file.lastIndexOf('/')) || '/';\n}\n\nexport class MemoryFiles {\n  readonly #env: Files;\n  readonly #chains = new Map<string, Promise<unknown>>();\n\n  constructor(env: Files) {\n    this.#env = env;\n  }\n\n  async #safe(file: string, context: Context): Promise<boolean> {\n    for (let path = file; ; path = dirOf(path)) {\n      const real = await this.#env.canonicalPath(path, context);\n      if (real.ok) return real.value === path;\n      if (path === '/') return true;\n    }\n  }\n\n  async read(file: string, context: Context): Promise<{ text: string; updatedAt: number } | null> {\n    if (!(await this.#safe(file, context))) return null;\n    const read = await this.#env.readTextFile(file, context);\n    if (!read.ok) return null;\n    const info = await this.#env.fileInfo(file, context);\n    return { text: read.value, updatedAt: info.ok ? info.value.mtimeMs : 0 };\n  }\n\n  async entries(place: Place, context: Context): Promise<MemoryEntry[]> {\n    const read = await this.read(place.file, context);\n    return read ? memoryEntries(parseMemory(read.text), place.scope, read.updatedAt) : [];\n  }\n\n  change(place: Place, change: Change, context: Context): Promise<Written> {\n    const previous = this.#chains.get(place.file) ?? Promise.resolve();\n    const next = previous.catch(() => undefined).then(() => this.#apply(place, change, context));\n    this.#chains.set(place.file, next);\n    void next\n      .finally(() => {\n        if (this.#chains.get(place.file) === next) this.#chains.delete(place.file);\n      })\n      .catch(() => undefined);\n    return next;\n  }\n\n  async #apply(place: Place, change: Change, context: Context): Promise<Written> {\n    if (!(await this.#safe(place.file, context)))\n      throw new Error(`${place.file} is a symbolic link or under one; memory is not written there`);\n    const read = await this.#env.readTextFile(place.file, context);\n    const before = read.ok ? read.value : '';\n    let redacted = 0;\n    const clean = (text: string) => {\n      const result = redactSecrets(text);\n      redacted += result.count;\n      return result.text;\n    };\n    const safe: Change =\n      change.kind === 'save'\n        ? {\n            ...change,\n            section: oneLine(clean(change.section)) || 'Notes',\n            title: oneLine(clean(change.title)) || 'Untitled',\n            body: clean(change.body),\n          }\n        : change;\n    const { doc, found } = applyChange(parseMemory(before), place.scope, safe);\n    const after = serializeMemory(doc);\n    const bytes = byteLength(after);\n    if (bytes > MAX_BYTES && bytes >= byteLength(before))\n      throw new Error(\n        `${place.file} would be ${bytes} bytes; memory files hold ${MAX_BYTES}. Remove or shorten entries first (a write over the limit must make the file smaller).`\n      );\n    if (change.kind === 'remove' && !found)\n      return { entry: null, found, bytes: byteLength(before), redacted, file: place.file };\n    await this.#env.createDir(dirOf(place.file), { recursive: true }, context);\n    const written = await this.#env.writeFile(place.file, after, context);\n    if (!written.ok) throw new Error(written.error.message);\n    const entry =\n      safe.kind === 'save'\n        ? (memoryEntries(doc, place.scope, Date.now()).find(\n            (item) =>\n              item.source === 'entry' &&\n              item.section.toLowerCase() === safe.section.toLowerCase() &&\n              item.title.toLowerCase() === safe.title.toLowerCase()\n          ) as MemoryEntry)\n        : null;\n    return { entry, found, bytes, redacted, file: place.file };\n  }\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/roles/frontmatter.js

@@ -52,10 +52,11 @@ function line(state, text) {
   if (!text.trim() || text.trimStart().startsWith("#")) return;
   const item = /^\s+-\s+(.*)$/.exec(text);
   if (item && list) state.fields[list].push(unquote(item[1].trim()));
-  else if (/^\s/.test(text) && list) state.nested.add(list);
+  else if (/^\s/.test(text) && list)
+    state.nested.set(list, [...state.nested.get(list) ?? [], text.trim()]);
   else pair(state, text);
 }
-function parseFrontmatter(text) {
+function parseFrontmatter(text, mappings = []) {
   const normalized = text.replace(/\r\n/g, "\n");
   const match = /^---\n([\s\S]*?)\n---(?:\n|$)/.exec(normalized);
   if (!match)
@@ -63,13 +64,17 @@ function parseFrontmatter(text) {
   const state = {
     fields: {},
     problems: [],
-    nested: /* @__PURE__ */ new Set(),
+    nested: /* @__PURE__ */ new Map(),
     list: void 0,
     block: void 0
   };
   for (const text2 of match[1].split("\n")) line(state, text2);
   if (state.block) state.fields[state.block.key] = blockValue(state.block);
-  for (const key of state.nested) {
+  for (const [key, lines] of state.nested) {
+    if (mappings.includes(key)) {
+      state.fields[key] = `{ ${lines.join(", ")} }`;
+      continue;
+    }
     delete state.fields[key];
     state.problems.push(`"${key}" has nested values, which SLICC doesn't read`);
   }

package/dist/roles/frontmatter.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/roles/frontmatter.ts"],
-  "sourcesContent": ["export type FrontmatterValue = string | number | boolean | string[];\n\nexport interface Frontmatter {\n  fields: Record<string, FrontmatterValue>;\n  body: string;\n  problems: string[];\n}\n\nfunction unquote(value: string): string {\n  const quoted = /^([\"'])(.*)\\1$/s.exec(value);\n  if (!quoted) return value;\n  return quoted[1] === '\"'\n    ? (quoted[2] as string).replace(/\\\\([\"\\\\])/g, '$1')\n    : (quoted[2] as string).replace(/''/g, \"'\");\n}\n\nfunction scalar(raw: string): FrontmatterValue {\n  const value = raw.trim();\n  if (/^\\[.*\\]$/s.test(value))\n    return value\n      .slice(1, -1)\n      .split(',')\n      .map((item) => unquote(item.trim()))\n      .filter(Boolean);\n  if (value === 'true' || value === 'false') return value === 'true';\n  if (/^-?\\d+(\\.\\d+)?$/.test(value)) return Number(value);\n  return unquote(value);\n}\n\ntype Block = { key: string; folded: boolean; strip: boolean; lines: string[] };\n\nconst BLOCK = /^([|>])([+-]?)$/;\n\nfunction blockValue(block: Block): string {\n  const indents = block.lines\n    .filter((line) => line.trim())\n    .map((line) => (/^\\s*/.exec(line) as RegExpExecArray)[0].length);\n  const indent = indents.length ? Math.min(...indents) : 0;\n  const lines = block.lines.map((line) => line.slice(indent));\n  while (lines.length && !lines.at(-1)?.trim()) lines.pop();\n  const text = block.folded\n    ? lines.reduce(\n        (out, line) =>\n          !line.trim()\n            ? `${out}\\n`\n            : out && !out.endsWith('\\n')\n              ? `${out} ${line}`\n              : `${out}${line}`,\n        ''\n      )\n    : lines.join('\\n');\n  return block.strip || !text ? text : `${text}\\n`;\n}\n\ntype State = {\n  fields: Record<string, FrontmatterValue>;\n  problems: string[];\n  nested: Set<string>;\n  list: string | undefined;\n  block: Block | undefined;\n};\n\nfunction pair(state: State, line: string): void {\n  const found = /^([A-Za-z][\\w-]*):(?:\\s+(.*))?$/.exec(line);\n  state.list = undefined;\n  if (!found) {\n    state.problems.push(`can't read the line \"${line.trim()}\"`);\n    return;\n  }\n  const key = found[1] as string;\n  const value = found[2]?.trim() ?? '';\n  const style = BLOCK.exec(value);\n  if (style) state.block = { key, folded: style[1] === '>', strip: style[2] === '-', lines: [] };\n  else if (value === '') {\n    state.fields[key] = [];\n    state.list = key;\n  } else state.fields[key] = scalar(value);\n}\n\nfunction line(state: State, text: string): void {\n  const { block, list } = state;\n  if (block && (!text.trim() || /^\\s/.test(text))) {\n    block.lines.push(text);\n    return;\n  }\n  if (block) state.fields[block.key] = blockValue(block);\n  state.block = undefined;\n  if (!text.trim() || text.trimStart().startsWith('#')) return;\n  const item = /^\\s+-\\s+(.*)$/.exec(text);\n  if (item && list) (state.fields[list] as string[]).push(unquote((item[1] as string).trim()));\n  else if (/^\\s/.test(text) && list) state.nested.add(list);\n  else pair(state, text);\n}\n\nexport function parseFrontmatter(text: string): Frontmatter {\n  const normalized = text.replace(/\\r\\n/g, '\\n');\n  const match = /^---\\n([\\s\\S]*?)\\n---(?:\\n|$)/.exec(normalized);\n  if (!match)\n    return { fields: {}, body: normalized.trim(), problems: ['no frontmatter between --- lines'] };\n  const state: State = {\n    fields: {},\n    problems: [],\n    nested: new Set(),\n    list: undefined,\n    block: undefined,\n  };\n  for (const text of (match[1] as string).split('\\n')) line(state, text);\n  if (state.block) state.fields[state.block.key] = blockValue(state.block);\n  for (const key of state.nested) {\n    delete state.fields[key];\n    state.problems.push(`\"${key}\" has nested values, which SLICC doesn't read`);\n  }\n  return {\n    fields: state.fields,\n    body: normalized.slice(match[0].length).trim(),\n    problems: state.problems,\n  };\n}\n"],
-  "mappings": "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",
+  "sourcesContent": ["export type FrontmatterValue = string | number | boolean | string[];\n\nexport interface Frontmatter {\n  fields: Record<string, FrontmatterValue>;\n  body: string;\n  problems: string[];\n}\n\nfunction unquote(value: string): string {\n  const quoted = /^([\"'])(.*)\\1$/s.exec(value);\n  if (!quoted) return value;\n  return quoted[1] === '\"'\n    ? (quoted[2] as string).replace(/\\\\([\"\\\\])/g, '$1')\n    : (quoted[2] as string).replace(/''/g, \"'\");\n}\n\nfunction scalar(raw: string): FrontmatterValue {\n  const value = raw.trim();\n  if (/^\\[.*\\]$/s.test(value))\n    return value\n      .slice(1, -1)\n      .split(',')\n      .map((item) => unquote(item.trim()))\n      .filter(Boolean);\n  if (value === 'true' || value === 'false') return value === 'true';\n  if (/^-?\\d+(\\.\\d+)?$/.test(value)) return Number(value);\n  return unquote(value);\n}\n\ntype Block = { key: string; folded: boolean; strip: boolean; lines: string[] };\n\nconst BLOCK = /^([|>])([+-]?)$/;\n\nfunction blockValue(block: Block): string {\n  const indents = block.lines\n    .filter((line) => line.trim())\n    .map((line) => (/^\\s*/.exec(line) as RegExpExecArray)[0].length);\n  const indent = indents.length ? Math.min(...indents) : 0;\n  const lines = block.lines.map((line) => line.slice(indent));\n  while (lines.length && !lines.at(-1)?.trim()) lines.pop();\n  const text = block.folded\n    ? lines.reduce(\n        (out, line) =>\n          !line.trim()\n            ? `${out}\\n`\n            : out && !out.endsWith('\\n')\n              ? `${out} ${line}`\n              : `${out}${line}`,\n        ''\n      )\n    : lines.join('\\n');\n  return block.strip || !text ? text : `${text}\\n`;\n}\n\ntype State = {\n  fields: Record<string, FrontmatterValue>;\n  problems: string[];\n  nested: Map<string, string[]>;\n  list: string | undefined;\n  block: Block | undefined;\n};\n\nfunction pair(state: State, line: string): void {\n  const found = /^([A-Za-z][\\w-]*):(?:\\s+(.*))?$/.exec(line);\n  state.list = undefined;\n  if (!found) {\n    state.problems.push(`can't read the line \"${line.trim()}\"`);\n    return;\n  }\n  const key = found[1] as string;\n  const value = found[2]?.trim() ?? '';\n  const style = BLOCK.exec(value);\n  if (style) state.block = { key, folded: style[1] === '>', strip: style[2] === '-', lines: [] };\n  else if (value === '') {\n    state.fields[key] = [];\n    state.list = key;\n  } else state.fields[key] = scalar(value);\n}\n\nfunction line(state: State, text: string): void {\n  const { block, list } = state;\n  if (block && (!text.trim() || /^\\s/.test(text))) {\n    block.lines.push(text);\n    return;\n  }\n  if (block) state.fields[block.key] = blockValue(block);\n  state.block = undefined;\n  if (!text.trim() || text.trimStart().startsWith('#')) return;\n  const item = /^\\s+-\\s+(.*)$/.exec(text);\n  if (item && list) (state.fields[list] as string[]).push(unquote((item[1] as string).trim()));\n  else if (/^\\s/.test(text) && list)\n    state.nested.set(list, [...(state.nested.get(list) ?? []), text.trim()]);\n  else pair(state, text);\n}\n\nexport function parseFrontmatter(text: string, mappings: readonly string[] = []): Frontmatter {\n  const normalized = text.replace(/\\r\\n/g, '\\n');\n  const match = /^---\\n([\\s\\S]*?)\\n---(?:\\n|$)/.exec(normalized);\n  if (!match)\n    return { fields: {}, body: normalized.trim(), problems: ['no frontmatter between --- lines'] };\n  const state: State = {\n    fields: {},\n    problems: [],\n    nested: new Map(),\n    list: undefined,\n    block: undefined,\n  };\n  for (const text of (match[1] as string).split('\\n')) line(state, text);\n  if (state.block) state.fields[state.block.key] = blockValue(state.block);\n  for (const [key, lines] of state.nested) {\n    if (mappings.includes(key)) {\n      state.fields[key] = `{ ${lines.join(', ')} }`;\n      continue;\n    }\n    delete state.fields[key];\n    state.problems.push(`\"${key}\" has nested values, which SLICC doesn't read`);\n  }\n  return {\n    fields: state.fields,\n    body: normalized.slice(match[0].length).trim(),\n    problems: state.problems,\n  };\n}\n"],
+  "mappings": "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",
   "names": ["line", "text"]
 }

package/dist/roles/roles.js

@@ -7,8 +7,10 @@ const TOOLS = {
   bash: "bash",
   grep: "bash",
   find: "bash",
-  ls: "bash"
+  ls: "bash",
+  memory_write: "memory_write"
 };
+const WRITERS = /* @__PURE__ */ new Set(["write", "edit", "bash"]);
 const THINKING = /* @__PURE__ */ new Set(["off", "minimal", "low", "medium", "high", "xhigh"]);
 const APPLIED = /* @__PURE__ */ new Set([
   "name",
@@ -22,13 +24,12 @@ const APPLIED = /* @__PURE__ */ new Set([
   "package",
   "advertise",
   "inheritProjectContext",
+  "inheritGlobalContext",
   "inheritSkills",
+  "memory",
   "skills",
   "defaultReads"
 ]);
-const LATER = {
-  memory: "per-agent memory comes with SLICC\u2019s memory panel"
-};
 function list(value) {
   if (Array.isArray(value)) return value;
   if (typeof value === "string")
@@ -45,8 +46,46 @@ function tools(names, where, warnings) {
   }
   return mapped;
 }
+function roleMemory(value) {
+  if (typeof value !== "string") return void 0;
+  const inline = /^\{(.*)\}$/s.exec(value.trim());
+  const pairs = /* @__PURE__ */ new Map();
+  for (const part of (inline ? inline[1] : value).split(/[,\n]/)) {
+    const found = /^\s*([\w-]+)\s*:\s*(.*?)\s*$/.exec(part);
+    if (found) pairs.set(found[1], found[2].replace(/^(["'])(.*)\1$/, "$2"));
+  }
+  const scope = pairs.get("scope");
+  const path = pairs.get("path");
+  if (scope !== "user" && scope !== "project" || !path) return void 0;
+  return { scope, path };
+}
+function withMemoryWrite(listed, memory) {
+  if (memory && listed?.some((tool) => WRITERS.has(tool)) && !listed.includes("memory_write"))
+    return [...listed, "memory_write"];
+  return listed;
+}
+function memoryFields(fields, path, warnings) {
+  const memory = fields.memory === void 0 ? void 0 : roleMemory(fields.memory);
+  if (fields.memory !== void 0 && !memory)
+    warnings.push(`${path}: memory needs a scope (user or project) and a path; ignored`);
+  const listed = withMemoryWrite(
+    fields.tools !== void 0 ? tools(list(fields.tools), path, warnings) : void 0,
+    memory
+  );
+  const inherits = fields.inheritProjectContext !== void 0 || fields.inheritGlobalContext !== void 0;
+  return {
+    ...memory ? { memory } : {},
+    listed,
+    ...inherits ? {
+      context: {
+        project: fields.inheritProjectContext !== false,
+        global: fields.inheritGlobalContext === true
+      }
+    } : {}
+  };
+}
 function parseRole(text, source, path, warnings) {
-  const { fields, body, problems } = parseFrontmatter(text);
+  const { fields, body, problems } = parseFrontmatter(text, ["memory"]);
   for (const problem of problems) warnings.push(`${path}: ${problem}`);
   const name = fields.name;
   const description = fields.description;
@@ -56,23 +95,24 @@ function parseRole(text, source, path, warnings) {
   }
   for (const key of Object.keys(fields))
     if (!APPLIED.has(key))
-      warnings.push(
-        `${path}: "${key}" ${LATER[key] ? `is not read yet (${LATER[key]})` : "isn't supported in SLICC; it's ignored"}`
-      );
+      warnings.push(`${path}: "${key}" isn't supported in SLICC; it's ignored`);
   const thinking = typeof fields.thinking === "string" && THINKING.has(fields.thinking) ? fields.thinking : void 0;
   if (fields.thinking !== void 0 && !thinking)
     warnings.push(`${path}: thinking "${String(fields.thinking)}" is unknown; ignored`);
+  const { memory, listed, context } = memoryFields(fields, path, warnings);
   const pkg = typeof fields.package === "string" && fields.package ? `${fields.package}.` : "";
   return {
     name: `${pkg}${name}`,
     description,
     prompt: body,
     mode: fields.systemPromptMode === "append" ? "append" : "replace",
-    ...fields.tools !== void 0 ? { tools: tools(list(fields.tools), path, warnings) } : {},
+    ...listed ? { tools: listed } : {},
     ...typeof fields.model === "string" ? { model: fields.model } : {},
     ...thinking ? { thinking } : {},
     aliases: list(fields.aliases),
     ...typeof fields.output === "string" ? { output: fields.output } : {},
+    ...memory ? { memory } : {},
+    ...context ? { context } : {},
     source,
     path
   };
@@ -122,7 +162,10 @@ function apply(role, override, warnings) {
   if (typeof override.description === "string") next.description = override.description;
   if (typeof override.systemPrompt === "string") next.prompt = override.systemPrompt;
   if (Array.isArray(override.tools))
-    next.tools = tools(override.tools.map(String), `override for ${role.name}`, warnings);
+    next.tools = withMemoryWrite(
+      tools(override.tools.map(String), `override for ${role.name}`, warnings),
+      role.memory
+    );
   return next;
 }
 const ORDER = ["builtin", "package", "user", "project"];
@@ -200,6 +243,7 @@ export {
   loadRoles,
   manifestDirs,
   packageDirs,
-  parseRole
+  parseRole,
+  roleMemory
 };
 //# sourceMappingURL=roles.js.map