@ai-ecoverse/slicc-agent 3.13.1 → 3.14.0

package/dist/scoops/sync.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/scoops/sync.ts"],
-  "sourcesContent": ["import type { Context } from '@earendil-works/chord';\nimport type { ConversationId, EntryRecord, TaskId } from '@earendil-works/pi-durable';\nimport { answerText } from '../agent.ts';\nimport type { ScoopRecord } from '../agents.ts';\nimport { resolve } from '../kernel/paths.ts';\nimport {\n  type Caller,\n  choices,\n  type Deps,\n  fail,\n  flags,\n  isAnswer,\n  last,\n  MAX_DEPTH,\n  prompts,\n  readText,\n  role,\n  unsupported,\n} from './cli.ts';\nimport type { ReportResult } from './extension.ts';\nimport type { Request } from './requests.ts';\nimport { type Answer, SCOOPS_ROOT } from './service.ts';\n\nexport const SESSIONS = { tmp: '/tmp/agent-sessions', durable: '/home/sessions' };\n\ntype Ending = 'cancel' | 'detach';\n\ninterface Pending {\n  end: (ending: Ending) => void;\n}\n\nexport interface SyncState {\n  pending: Map<string, Pending>;\n}\n\nconst SYNC_VALUES = [\n  '--name',\n  '--agent',\n  '--provider',\n  '--model',\n  '--thinking',\n  '--effort',\n  '--tools',\n  '--prompt',\n  '--file',\n  '--read-only',\n  '--system-prompt',\n  '--system-prompt-file',\n  '--background-after',\n];\nconst SYNC_SWITCHES = new Set([\n  '--persist-session',\n  '--no-persist-session',\n  '--no-extensions',\n  '--no-skills',\n  '--no-context-files',\n]);\n\ntype Persist = 'tmp' | 'durable' | 'none';\n\nfunction persistOf(switches: Set<string>): Persist {\n  if (switches.has('--no-persist-session')) return 'none';\n  return switches.has('--persist-session') ? 'durable' : 'tmp';\n}\n\nfunction block(text: unknown): string {\n  return typeof text === 'string' ? text : JSON.stringify(text, null, 2);\n}\n\nfunction entryMarkdown(entry: EntryRecord): string | undefined {\n  const message = entry.model?.[0] as { content?: unknown; toolCallId?: string } | undefined;\n  if (entry.kind === 'pi.user') return `## Request\\n\\n${answerText(message?.content)}`;\n  if (entry.kind === 'pi.tool-result')\n    return `### Result\\n\\n\\`\\`\\`\\n${answerText(message?.content)}\\n\\`\\`\\``;\n  if (entry.kind !== 'pi.assistant') return undefined;\n  const parts = Array.isArray(message?.content)\n    ? (message.content as { type: string; name?: string; arguments?: unknown }[])\n    : [];\n  const calls = parts\n    .filter((part) => part.type === 'toolCall')\n    .map((part) => `\\`${part.name}\\` ${block(part.arguments)}`);\n  return [`## Answer\\n\\n${answerText(message?.content)}`, ...calls].join('\\n\\n');\n}\n\nexport function transcript(record: ScoopRecord, entries: readonly EntryRecord[]): string {\n  const body = entries.map(entryMarkdown).filter(Boolean);\n  return `# ${record.name}${record.role ? ` (${record.role})` : ''}\\n\\n${body.join('\\n\\n')}\\n`;\n}\n\nasync function archive(\n  deps: Deps,\n  record: ScoopRecord,\n  persist: Persist,\n  context: Context\n): Promise<string | null> {\n  if (persist === 'none') return null;\n  const conversation = await deps.harness.conversation(\n    record.conversation as ConversationId,\n    context\n  );\n  if (!conversation) return null;\n  const { entries } = await conversation.context(context);\n  const path = `${SESSIONS[persist]}/${record.folder}.md`;\n  await deps.env.writeFile(path, transcript(record, entries), context);\n  return path;\n}\n\nasync function finish(deps: Deps, id: string, persist: Persist, context: Context): Promise<void> {\n  const record = deps.agents.state().scoops[id];\n  if (!record) return;\n  await archive(deps, record, persist, context).catch(() => null);\n  await deps.scoops.stop(id, false, context);\n  await deps.env.remove(\n    `${SCOOPS_ROOT}/${record.folder}`,\n    { recursive: true, force: true },\n    context\n  );\n}\n\nasync function callerRunning(deps: Deps, who: Caller, context: Context): Promise<boolean> {\n  if (!who.fromAgent) return false;\n  const state = deps.agents.state();\n  const conversation = who.scoop\n    ? state.scoops[who.scoop]?.conversation\n    : state.cones[who.cone]?.conversation;\n  return conversation !== undefined && deps.scoops.busy(conversation, context);\n}\n\nasync function keep(\n  deps: Deps,\n  id: string,\n  tasks: readonly number[],\n  target: string | null,\n  context: Context\n) {\n  if (target) await deps.scoops.detach(tasks, target, context);\n  await deps.agents.update((_tx, state) => {\n    const record = state.scoops[id];\n    if (record) record.kind = 'async';\n  }, context);\n}\n\nfunction watchPid(deps: Deps, pid: number | null, end: (ending: Ending) => void): () => void {\n  const alive = deps.alive;\n  if (pid === null || !alive) return () => undefined;\n  const timer = setInterval(() => {\n    void alive(pid).then(\n      (yes) => yes || end('cancel'),\n      () => undefined\n    );\n  }, 1000);\n  return () => clearInterval(timer);\n}\n\ninterface Plan {\n  given: string[];\n  workdir?: string;\n  instructions: string;\n  readOnly: string[];\n  persist: Persist;\n}\n\nasync function plan(\n  deps: Deps,\n  request: Request,\n  parsed: ReturnType<typeof flags>,\n  context: Context\n) {\n  const given = await prompts(deps, request.argv, request, context);\n  let workdir: string | undefined;\n  const notes: string[] = [];\n  if (!given.length && parsed.rest.length === 3) {\n    const [cwd, allowed, prompt] = parsed.rest as [string, string, string];\n    workdir = resolve(request.cwd, cwd);\n    if (allowed && allowed !== '*')\n      notes.push(\n        `Use only these commands in bash: ${allowed}. This is not enforced; keep to it anyway.`\n      );\n    given.push(prompt);\n  } else if (parsed.rest.length) return fail(`unexpected argument ${parsed.rest[0]}`, 2);\n  if (!given.length)\n    return fail('agent needs --prompt, --file, - or <cwd> <allowed-commands> <prompt>', 2);\n  const systemFile = last(parsed, '--system-prompt-file');\n  const system =\n    last(parsed, '--system-prompt') ??\n    (systemFile ? await readText(deps, systemFile, request, context) : undefined);\n  if (system) notes.push(system);\n  if (workdir) notes.push(`Your working folder is ${workdir}; you may change files there.`);\n  const readOnly = (last(parsed, '--read-only') ?? '')\n    .split(',')\n    .map((path) => path.trim())\n    .filter(Boolean)\n    .map((path) => resolve(request.cwd, path));\n  const result: Plan = {\n    given,\n    instructions: notes.join('\\n\\n'),\n    readOnly,\n    persist: persistOf(parsed.switches),\n  };\n  if (workdir) result.workdir = workdir;\n  return result;\n}\n\nasync function outcome(\n  deps: Deps,\n  tasks: readonly number[],\n  context: Context\n): Promise<ReportResult> {\n  let result: ReportResult = { text: '', failed: 'no request', path: null };\n  for (const task of tasks) {\n    const settled = await deps.harness.waitForTask(task as TaskId<ReportResult>, context);\n    const outcome = settled.state.outcome;\n    result =\n      outcome.status === 'completed'\n        ? outcome.result\n        : { text: '', failed: outcome.status, path: null };\n  }\n  return result;\n}\n\nfunction answerOf(result: ReportResult): Answer {\n  if (result.failed) return fail(`the scoop's request ended without an answer: ${result.failed}`);\n  return { code: 0, out: result.text.endsWith('\\n') ? result.text : `${result.text}\\n` };\n}\n\nasync function settle(\n  deps: Deps,\n  who: Caller,\n  id: string,\n  tasks: readonly number[],\n  ending: Ending,\n  context: Context\n): Promise<Answer> {\n  const handle = id.slice('scoop:'.length);\n  if (ending === 'detach') {\n    await keep(deps, id, tasks, who.id, context);\n    const how = who.id ? 'its answer arrives as a lick' : `follow it with agent wait ${handle}`;\n    return { code: 0, out: `${handle} continues in the background; ${how}\\n` };\n  }\n  if (await callerRunning(deps, who, context)) {\n    await keep(deps, id, tasks, who.id, context);\n    return {\n      code: 143,\n      out: `agent: the call was interrupted; ${handle} continues and its answer arrives as a lick\\n`,\n    };\n  }\n  return { code: 130, out: 'agent: stopped\\n' };\n}\n\nexport async function runSync(\n  deps: Deps,\n  request: Request,\n  who: Caller,\n  context: Context\n): Promise<Answer> {\n  const refused = unsupported(request.argv);\n  if (refused) return refused;\n  if (who.depth >= MAX_DEPTH) return fail(`agents nest at most ${MAX_DEPTH} deep`);\n  const parsed = flags(request.argv, SYNC_VALUES);\n  const unknown = [...parsed.switches].find((flag) => !SYNC_SWITCHES.has(flag));\n  if (unknown) return fail(`unknown option ${unknown}`, 2);\n  const planned = await plan(deps, request, parsed, context);\n  if (isAnswer(planned)) return planned;\n  const chosen = choices(parsed);\n  if (isAnswer(chosen)) return chosen;\n  const found = await role(deps, parsed);\n  if (found.error) return found.error;\n  const spawned = await deps.scoops.spawn(\n    {\n      cone: who.cone,\n      kind: 'sync',\n      parent: who.scoop ?? who.cone,\n      depth: who.depth + 1,\n      roots: { write: planned.workdir ? [planned.workdir] : [], read: planned.readOnly },\n      ...(planned.workdir ? { cwd: planned.workdir } : {}),\n      ...(planned.instructions ? { instructions: planned.instructions } : {}),\n      target: null,\n      asker: who.id,\n      name: last(parsed, '--name') ?? found.role?.name ?? 'agent',\n      ...(found.role ? { role: found.role } : {}),\n      ...(chosen.model ? { model: chosen.model } : {}),\n      ...(chosen.thinking ? { thinking: chosen.thinking as never } : {}),\n      ...(chosen.tools ? { tools: chosen.tools } : {}),\n      prompts: planned.given,\n      fromAgent: who.fromAgent,\n      request: request.id,\n      limits: found.roles.limits,\n    },\n    context\n  );\n  if (spawned.code !== 0) return spawned;\n  const id = `scoop:${spawned.out.trim()}`;\n  const tasks = spawned.tasks ?? [];\n  let end: (ending: Ending) => void = () => undefined;\n  const ended = new Promise<Ending>((done) => {\n    end = done;\n  });\n  deps.sync.pending.set(request.id, { end });\n  const unwatch = watchPid(deps, request.pid, end);\n  try {\n    const raced = await Promise.race([outcome(deps, tasks, context), ended]);\n    if (typeof raced === 'string') {\n      const answer = await settle(deps, who, id, tasks, raced, context);\n      if (answer.code === 130) await finish(deps, id, planned.persist, context);\n      return answer;\n    }\n    await finish(deps, id, planned.persist, context);\n    return answerOf(raced);\n  } finally {\n    unwatch();\n    deps.sync.pending.delete(request.id);\n  }\n}\n\nexport async function cancelSync(\n  deps: Deps,\n  requestId: string,\n  _context: Context\n): Promise<Answer> {\n  deps.sync.pending.get(requestId)?.end('cancel');\n  return { code: 0, out: '' };\n}\n\nexport async function detachSync(\n  deps: Deps,\n  requestId: string,\n  _context: Context\n): Promise<Answer> {\n  deps.sync.pending.get(requestId)?.end('detach');\n  return { code: 0, out: '' };\n}\n"],
-  "mappings": "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",
+  "sourcesContent": ["import type { Context } from '@earendil-works/chord';\nimport type { ConversationId, EntryRecord, TaskId } from '@earendil-works/pi-durable';\nimport { answerText } from '../agent.ts';\nimport type { ScoopRecord } from '../agents.ts';\nimport { resolve } from '../kernel/paths.ts';\nimport {\n  type Caller,\n  choices,\n  type Deps,\n  fail,\n  flags,\n  isAnswer,\n  last,\n  MAX_DEPTH,\n  prompts,\n  readText,\n  role,\n  unsupported,\n} from './cli.ts';\nimport type { ReportResult } from './extension.ts';\nimport type { Request } from './requests.ts';\nimport { type Answer, SCOOPS_ROOT } from './service.ts';\n\nexport const SESSIONS = { tmp: '/tmp/agent-sessions', durable: '/home/sessions' };\n\ntype Ending = 'cancel' | 'detach';\n\ninterface Pending {\n  end: (ending: Ending) => void;\n}\n\nexport interface SyncState {\n  pending: Map<string, Pending>;\n}\n\nconst SYNC_VALUES = [\n  '--name',\n  '--agent',\n  '--provider',\n  '--model',\n  '--thinking',\n  '--effort',\n  '--tools',\n  '--prompt',\n  '--file',\n  '--read-only',\n  '--system-prompt',\n  '--system-prompt-file',\n  '--background-after',\n];\nconst SYNC_SWITCHES = new Set([\n  '--persist-session',\n  '--no-persist-session',\n  '--no-extensions',\n  '--no-skills',\n  '--no-context-files',\n]);\n\ntype Persist = 'tmp' | 'durable' | 'none';\n\nfunction persistOf(switches: Set<string>): Persist {\n  if (switches.has('--no-persist-session')) return 'none';\n  return switches.has('--persist-session') ? 'durable' : 'tmp';\n}\n\nfunction block(text: unknown): string {\n  return typeof text === 'string' ? text : JSON.stringify(text, null, 2);\n}\n\nfunction entryMarkdown(entry: EntryRecord): string | undefined {\n  const message = entry.model?.[0] as { content?: unknown; toolCallId?: string } | undefined;\n  if (entry.kind === 'pi.user') return `## Request\\n\\n${answerText(message?.content)}`;\n  if (entry.kind === 'pi.tool-result')\n    return `### Result\\n\\n\\`\\`\\`\\n${answerText(message?.content)}\\n\\`\\`\\``;\n  if (entry.kind !== 'pi.assistant') return undefined;\n  const parts = Array.isArray(message?.content)\n    ? (message.content as { type: string; name?: string; arguments?: unknown }[])\n    : [];\n  const calls = parts\n    .filter((part) => part.type === 'toolCall')\n    .map((part) => `\\`${part.name}\\` ${block(part.arguments)}`);\n  return [`## Answer\\n\\n${answerText(message?.content)}`, ...calls].join('\\n\\n');\n}\n\nexport function transcript(record: ScoopRecord, entries: readonly EntryRecord[]): string {\n  const body = entries.map(entryMarkdown).filter(Boolean);\n  return `# ${record.name}${record.role ? ` (${record.role})` : ''}\\n\\n${body.join('\\n\\n')}\\n`;\n}\n\nasync function archive(\n  deps: Deps,\n  record: ScoopRecord,\n  persist: Persist,\n  context: Context\n): Promise<string | null> {\n  if (persist === 'none') return null;\n  const conversation = await deps.harness.conversation(\n    record.conversation as ConversationId,\n    context\n  );\n  if (!conversation) return null;\n  const { entries } = await conversation.context(context);\n  const path = `${SESSIONS[persist]}/${record.folder}.md`;\n  await deps.env.writeFile(path, transcript(record, entries), context);\n  return path;\n}\n\nasync function finish(deps: Deps, id: string, persist: Persist, context: Context): Promise<void> {\n  const record = deps.agents.state().scoops[id];\n  if (!record) return;\n  await archive(deps, record, persist, context).catch(() => null);\n  await deps.scoops.stop(id, false, context);\n  await deps.env.remove(\n    `${SCOOPS_ROOT}/${record.folder}`,\n    { recursive: true, force: true },\n    context\n  );\n}\n\nasync function callerRunning(deps: Deps, who: Caller, context: Context): Promise<boolean> {\n  if (!who.fromAgent) return false;\n  const state = deps.agents.state();\n  const conversation = who.scoop\n    ? state.scoops[who.scoop]?.conversation\n    : state.cones[who.cone]?.conversation;\n  return conversation !== undefined && deps.scoops.busy(conversation, context);\n}\n\nasync function keep(\n  deps: Deps,\n  id: string,\n  tasks: readonly number[],\n  target: string | null,\n  context: Context\n) {\n  if (target) await deps.scoops.detach(tasks, target, context);\n  await deps.agents.update((_tx, state) => {\n    const record = state.scoops[id];\n    if (record) record.kind = 'async';\n  }, context);\n}\n\nfunction watchPid(deps: Deps, pid: number | null, end: (ending: Ending) => void): () => void {\n  const alive = deps.alive;\n  if (pid === null || !alive) return () => undefined;\n  const timer = setInterval(() => {\n    void alive(pid).then(\n      (yes) => yes || end('cancel'),\n      () => undefined\n    );\n  }, 1000);\n  return () => clearInterval(timer);\n}\n\ninterface Plan {\n  given: string[];\n  workdir?: string;\n  instructions: string;\n  readOnly: string[];\n  persist: Persist;\n}\n\nasync function plan(\n  deps: Deps,\n  request: Request,\n  parsed: ReturnType<typeof flags>,\n  context: Context\n) {\n  const given = await prompts(deps, request.argv, request, context);\n  let workdir: string | undefined;\n  const notes: string[] = [];\n  if (!given.length && parsed.rest.length === 3) {\n    const [cwd, allowed, prompt] = parsed.rest as [string, string, string];\n    workdir = resolve(request.cwd, cwd);\n    if (allowed && allowed !== '*')\n      notes.push(\n        `Use only these commands in bash: ${allowed}. This is not enforced; keep to it anyway.`\n      );\n    given.push(prompt);\n  } else if (parsed.rest.length) return fail(`unexpected argument ${parsed.rest[0]}`, 2);\n  if (!given.length)\n    return fail('agent needs --prompt, --file, - or <cwd> <allowed-commands> <prompt>', 2);\n  const systemFile = last(parsed, '--system-prompt-file');\n  const system =\n    last(parsed, '--system-prompt') ??\n    (systemFile ? await readText(deps, systemFile, request, context) : undefined);\n  if (system) notes.push(system);\n  if (workdir) notes.push(`Your working folder is ${workdir}; you may change files there.`);\n  const readOnly = (last(parsed, '--read-only') ?? '')\n    .split(',')\n    .map((path) => path.trim())\n    .filter(Boolean)\n    .map((path) => resolve(request.cwd, path));\n  const result: Plan = {\n    given,\n    instructions: notes.join('\\n\\n'),\n    readOnly,\n    persist: persistOf(parsed.switches),\n  };\n  if (workdir) result.workdir = workdir;\n  return result;\n}\n\nasync function outcome(\n  deps: Deps,\n  tasks: readonly number[],\n  context: Context\n): Promise<ReportResult> {\n  let result: ReportResult = { text: '', failed: 'no request', path: null };\n  for (const task of tasks) {\n    const settled = await deps.harness.waitForTask(task as TaskId<ReportResult>, context);\n    const outcome = settled.state.outcome;\n    result =\n      outcome.status === 'completed'\n        ? outcome.result\n        : { text: '', failed: outcome.status, path: null };\n  }\n  return result;\n}\n\nfunction answerOf(result: ReportResult): Answer {\n  if (result.failed) return fail(`the scoop's request ended without an answer: ${result.failed}`);\n  return { code: 0, out: result.text.endsWith('\\n') ? result.text : `${result.text}\\n` };\n}\n\nasync function settle(\n  deps: Deps,\n  who: Caller,\n  id: string,\n  tasks: readonly number[],\n  ending: Ending,\n  context: Context\n): Promise<Answer> {\n  const handle = id.slice('scoop:'.length);\n  if (ending === 'detach') {\n    await keep(deps, id, tasks, who.id, context);\n    const how = who.id ? 'its answer arrives as a lick' : `follow it with agent wait ${handle}`;\n    return { code: 0, out: `${handle} continues in the background; ${how}\\n` };\n  }\n  if (await callerRunning(deps, who, context)) {\n    await keep(deps, id, tasks, who.id, context);\n    return {\n      code: 143,\n      out: `agent: the call was interrupted; ${handle} continues and its answer arrives as a lick\\n`,\n    };\n  }\n  return { code: 130, out: 'agent: stopped\\n' };\n}\n\nexport async function runSync(\n  deps: Deps,\n  request: Request,\n  who: Caller,\n  context: Context\n): Promise<Answer> {\n  const refused = unsupported(request.argv);\n  if (refused) return refused;\n  if (who.depth >= MAX_DEPTH) return fail(`agents nest at most ${MAX_DEPTH} deep`);\n  const parsed = flags(request.argv, SYNC_VALUES);\n  const unknown = [...parsed.switches].find((flag) => !SYNC_SWITCHES.has(flag));\n  if (unknown) return fail(`unknown option ${unknown}`, 2);\n  const planned = await plan(deps, request, parsed, context);\n  if (isAnswer(planned)) return planned;\n  const chosen = choices(parsed);\n  if (isAnswer(chosen)) return chosen;\n  const found = await role(deps, parsed);\n  if (found.error) return found.error;\n  const spawned = await deps.scoops.spawn(\n    {\n      cone: who.cone,\n      kind: 'sync',\n      parent: who.scoop ?? who.cone,\n      depth: who.depth + 1,\n      roots: { write: planned.workdir ? [planned.workdir] : [], read: planned.readOnly },\n      ...(planned.workdir ? { cwd: planned.workdir } : {}),\n      ...(planned.instructions ? { instructions: planned.instructions } : {}),\n      target: null,\n      asker: who.id,\n      name: last(parsed, '--name') ?? found.role?.name ?? 'agent',\n      ...(found.role ? { role: found.role } : {}),\n      ...(chosen.model ? { model: chosen.model } : {}),\n      ...(chosen.thinking ? { thinking: chosen.thinking as never } : {}),\n      ...(chosen.tools ? { tools: chosen.tools } : {}),\n      prompts: planned.given,\n      origin: request.cwd,\n      fromAgent: who.fromAgent,\n      request: request.id,\n      limits: found.roles.limits,\n    },\n    context\n  );\n  if (spawned.code !== 0) return spawned;\n  const id = `scoop:${spawned.out.trim()}`;\n  const tasks = spawned.tasks ?? [];\n  let end: (ending: Ending) => void = () => undefined;\n  const ended = new Promise<Ending>((done) => {\n    end = done;\n  });\n  deps.sync.pending.set(request.id, { end });\n  const unwatch = watchPid(deps, request.pid, end);\n  try {\n    const raced = await Promise.race([outcome(deps, tasks, context), ended]);\n    if (typeof raced === 'string') {\n      const answer = await settle(deps, who, id, tasks, raced, context);\n      if (answer.code === 130) await finish(deps, id, planned.persist, context);\n      return answer;\n    }\n    await finish(deps, id, planned.persist, context);\n    return answerOf(raced);\n  } finally {\n    unwatch();\n    deps.sync.pending.delete(request.id);\n  }\n}\n\nexport async function cancelSync(\n  deps: Deps,\n  requestId: string,\n  _context: Context\n): Promise<Answer> {\n  deps.sync.pending.get(requestId)?.end('cancel');\n  return { code: 0, out: '' };\n}\n\nexport async function detachSync(\n  deps: Deps,\n  requestId: string,\n  _context: Context\n): Promise<Answer> {\n  deps.sync.pending.get(requestId)?.end('detach');\n  return { code: 0, out: '' };\n}\n"],
+  "mappings": "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",
   "names": ["outcome"]
 }

package/dist/services.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../src/services.ts"],
-  "sourcesContent": ["import {\n  type Context,\n  defineService,\n  type JsonValue,\n  type ReplicatedState,\n} from '@earendil-works/chord';\nimport type { ConversationView } from '@earendil-works/pi-durable';\nimport type { Sprinkle } from './sprinkles/kind.ts';\n\nexport type SendMode = 'steer' | 'followUp' | 'reject';\n\nexport interface SendRequest {\n  text: string;\n  whenBusy: SendMode;\n  requestId: string | null;\n  agentId?: string | null;\n}\n\nexport interface OperationError {\n  code: string;\n  message: string;\n}\n\nexport type SendResponse =\n  | { accepted: true; submissionId: string; error: null }\n  | { accepted: false; submissionId: null; error: OperationError };\n\nexport type PromptResult =\n  | { status: 'done'; text: string; reason: null }\n  | { status: 'unanswered'; text: null; reason: string };\n\nexport interface AgentControl {\n  send(request: SendRequest, context: Context): Promise<SendResponse>;\n  wait(submissionId: string, context: Context): Promise<PromptResult>;\n  withdraw(\n    submissionId: string,\n    context: Context\n  ): Promise<{ outcome: 'withdrawn' | 'already_placed' | 'not_found' }>;\n  abort(context: Context): Promise<void>;\n  compact(instructions: string | null, context: Context): Promise<SendResponse>;\n  reset(handoff: string | null, context: Context): Promise<void>;\n  configure(change: AgentSettingsChange, context: Context): Promise<void>;\n  rewind(messageId: string | null, context: Context): Promise<Rewound>;\n  resolveLick(\n    lickId: string,\n    state: 'confirmed' | 'dismissed',\n    context: Context\n  ): Promise<LickResolved>;\n  webhook(\n    name: string,\n    delivery: WebhookRequest,\n    context: Context\n  ): Promise<{ delivered: boolean }>;\n  stopAgent(agentId: string, context: Context): Promise<void>;\n  selectCone(agentId: string, context: Context): Promise<void>;\n  createCone(name: string, context: Context): Promise<Created>;\n  createScoop(parentId: string, name: string, context: Context): Promise<Created>;\n  drop(agentId: string, context: Context): Promise<Created>;\n  unqueue(\n    agentId: string | null,\n    submissionId: string,\n    context: Context\n  ): Promise<{ outcome: 'withdrawn' | 'already_placed' | 'not_found' }>;\n  sprinkleSend(\n    sprinkleId: string,\n    payload: { action: string; data: JsonValue | null; target: string | null },\n    context: Context\n  ): Promise<{ delivered: boolean }>;\n  sprinkleCall(\n    sprinkleId: string,\n    method: string,\n    args: JsonValue[],\n    context: Context\n  ): Promise<JsonValue>;\n}\n\nexport type Created = { id: string; error: null } | { id: null; error: string };\n\nexport interface AgentSummary {\n  id: string;\n  name: string;\n  kind: 'cone' | 'scoop';\n  parentId: string | null;\n  role: string | null;\n}\n\nexport interface AgentsSummary {\n  active: string;\n  agents: AgentSummary[];\n}\n\nexport type LickResolved =\n  | { done: true; text: string; error: null }\n  | { done: false; text: null; error: string };\n\nexport interface WebhookRequest {\n  id: string | null;\n  headers: Record<string, string>;\n  body: string;\n}\n\nexport type Rewound =\n  | { done: true; text: string; reason: null }\n  | { done: false; text: null; reason: 'busy' | 'no-turn' };\n\nexport interface AgentSettingsChange {\n  model: { provider: string; modelId: string } | null;\n  thinkingLevel: 'off' | 'minimal' | 'low' | 'medium' | 'high' | 'xhigh' | 'max' | null;\n  agentId?: string | null;\n}\n\nexport const AgentControl = defineService<AgentControl>('slicc.agent.control');\n\nexport type Delivered = 'run' | 'steer' | 'follow-up';\n\nexport interface AgentTranscript {\n  readonly state: ReplicatedState<ConversationView>;\n  readonly deliveries: ReplicatedState<Record<string, Delivered>>;\n  readonly agents: ReplicatedState<AgentsSummary>;\n  readonly views: ReplicatedState<Record<string, ConversationView>>;\n  readonly commands: ReplicatedState<Command[]>;\n  readonly sprinkles: ReplicatedState<Sprinkle[]>;\n}\n\nexport interface Command {\n  name: string;\n  description: string;\n  kind: 'prompt' | 'skill';\n}\n\nexport const AgentTranscript = defineService<AgentTranscript>('slicc.agent.transcript');\n\nexport interface AgentSessions {\n  attach(sessionId: string, context: Context): Promise<void>;\n  detach(context: Context): Promise<void>;\n}\n\nexport const AgentSessions = defineService<AgentSessions>('slicc.agent.sessions');\n\nexport const AGENT_SESSION = 'agent';\n\nexport interface ModelChoice {\n  id: string;\n  label: string;\n  provider: string;\n  kind: 'chat' | 'classifier';\n  reasoning: boolean;\n  contextWindow: number;\n}\n\nexport interface AccountState {\n  id: string;\n  provider: string;\n  identity: string;\n  status: 'connected' | 'disconnected';\n  auth: 'api-key' | 'oauth';\n  needs: 'cors-free-transport' | null;\n}\n\nexport interface BudgetState {\n  provider: string;\n  percent: number;\n  window: 'weekly';\n  resets: string;\n}\n\nexport interface SignIn {\n  clientId: string;\n  scopes: string;\n  imsEnvironment: string;\n}\n\nexport interface SettingsState {\n  models: ModelChoice[];\n  accounts: AccountState[];\n  budget?: BudgetState | null;\n}\n\nexport interface AgentSettings {\n  readonly state: ReplicatedState<SettingsState>;\n  connect(\n    providerId: string,\n    secret: string,\n    region: string | null,\n    context: Context\n  ): Promise<void>;\n  disconnect(providerId: string, context: Context): Promise<void>;\n  signIn(providerId: string, context: Context): Promise<SignIn | null>;\n}\n\nexport const AgentSettings = defineService<AgentSettings>('slicc.agent.settings');\n"],
-  "mappings": "AAAA;AAAA,EAEE;AAAA,OAGK;AA0GA,MAAM,eAAe,cAA4B,qBAAqB;AAmBtE,MAAM,kBAAkB,cAA+B,wBAAwB;AAO/E,MAAM,gBAAgB,cAA6B,sBAAsB;AAEzE,MAAM,gBAAgB;AAmDtB,MAAM,gBAAgB,cAA6B,sBAAsB;",
+  "sourcesContent": ["import {\n  type Context,\n  defineService,\n  type JsonValue,\n  type ReplicatedState,\n} from '@earendil-works/chord';\nimport type { ConversationView } from '@earendil-works/pi-durable';\nimport type { MemoryEntry, MemoryScope, MemoryTag } from './memory/format.ts';\nimport type { Sprinkle } from './sprinkles/kind.ts';\n\nexport type SendMode = 'steer' | 'followUp' | 'reject';\n\nexport interface SendRequest {\n  text: string;\n  whenBusy: SendMode;\n  requestId: string | null;\n  agentId?: string | null;\n}\n\nexport interface OperationError {\n  code: string;\n  message: string;\n}\n\nexport type SendResponse =\n  | { accepted: true; submissionId: string; error: null }\n  | { accepted: false; submissionId: null; error: OperationError };\n\nexport type PromptResult =\n  | { status: 'done'; text: string; reason: null }\n  | { status: 'unanswered'; text: null; reason: string };\n\nexport interface AgentControl {\n  send(request: SendRequest, context: Context): Promise<SendResponse>;\n  wait(submissionId: string, context: Context): Promise<PromptResult>;\n  withdraw(\n    submissionId: string,\n    context: Context\n  ): Promise<{ outcome: 'withdrawn' | 'already_placed' | 'not_found' }>;\n  abort(context: Context): Promise<void>;\n  compact(instructions: string | null, context: Context): Promise<SendResponse>;\n  reset(handoff: string | null, context: Context): Promise<void>;\n  configure(change: AgentSettingsChange, context: Context): Promise<void>;\n  rewind(messageId: string | null, context: Context): Promise<Rewound>;\n  resolveLick(\n    lickId: string,\n    state: 'confirmed' | 'dismissed',\n    context: Context\n  ): Promise<LickResolved>;\n  webhook(\n    name: string,\n    delivery: WebhookRequest,\n    context: Context\n  ): Promise<{ delivered: boolean }>;\n  stopAgent(agentId: string, context: Context): Promise<void>;\n  selectCone(agentId: string, context: Context): Promise<void>;\n  createCone(name: string, context: Context): Promise<Created>;\n  createScoop(parentId: string, name: string, context: Context): Promise<Created>;\n  drop(agentId: string, context: Context): Promise<Created>;\n  unqueue(\n    agentId: string | null,\n    submissionId: string,\n    context: Context\n  ): Promise<{ outcome: 'withdrawn' | 'already_placed' | 'not_found' }>;\n  sprinkleSend(\n    sprinkleId: string,\n    payload: { action: string; data: JsonValue | null; target: string | null },\n    context: Context\n  ): Promise<{ delivered: boolean }>;\n  sprinkleCall(\n    sprinkleId: string,\n    method: string,\n    args: JsonValue[],\n    context: Context\n  ): Promise<JsonValue>;\n  memorySave(draft: MemoryDraft, context: Context): Promise<MemoryEntry>;\n  memoryRemove(id: string, context: Context): Promise<{ removed: boolean }>;\n}\n\nexport interface MemoryDraft {\n  id: string | null;\n  scope: string;\n  section: string;\n  title: string;\n  body: string;\n  tag: MemoryTag | null;\n}\n\nexport type Created = { id: string; error: null } | { id: null; error: string };\n\nexport interface AgentSummary {\n  id: string;\n  name: string;\n  kind: 'cone' | 'scoop';\n  parentId: string | null;\n  role: string | null;\n}\n\nexport interface AgentsSummary {\n  active: string;\n  agents: AgentSummary[];\n}\n\nexport type LickResolved =\n  | { done: true; text: string; error: null }\n  | { done: false; text: null; error: string };\n\nexport interface WebhookRequest {\n  id: string | null;\n  headers: Record<string, string>;\n  body: string;\n}\n\nexport type Rewound =\n  | { done: true; text: string; reason: null }\n  | { done: false; text: null; reason: 'busy' | 'no-turn' };\n\nexport interface AgentSettingsChange {\n  model: { provider: string; modelId: string } | null;\n  thinkingLevel: 'off' | 'minimal' | 'low' | 'medium' | 'high' | 'xhigh' | 'max' | null;\n  agentId?: string | null;\n}\n\nexport const AgentControl = defineService<AgentControl>('slicc.agent.control');\n\nexport type Delivered = 'run' | 'steer' | 'follow-up';\n\nexport interface AgentTranscript {\n  readonly state: ReplicatedState<ConversationView>;\n  readonly deliveries: ReplicatedState<Record<string, Delivered>>;\n  readonly agents: ReplicatedState<AgentsSummary>;\n  readonly views: ReplicatedState<Record<string, ConversationView>>;\n  readonly commands: ReplicatedState<Command[]>;\n  readonly sprinkles: ReplicatedState<Sprinkle[]>;\n  readonly memories: ReplicatedState<MemoryEntry[]>;\n  readonly memoryScopes: ReplicatedState<MemoryScope[]>;\n}\n\nexport interface Command {\n  name: string;\n  description: string;\n  kind: 'prompt' | 'skill';\n}\n\nexport const AgentTranscript = defineService<AgentTranscript>('slicc.agent.transcript');\n\nexport interface AgentSessions {\n  attach(sessionId: string, context: Context): Promise<void>;\n  detach(context: Context): Promise<void>;\n}\n\nexport const AgentSessions = defineService<AgentSessions>('slicc.agent.sessions');\n\nexport const AGENT_SESSION = 'agent';\n\nexport interface ModelChoice {\n  id: string;\n  label: string;\n  provider: string;\n  kind: 'chat' | 'classifier';\n  reasoning: boolean;\n  contextWindow: number;\n}\n\nexport interface AccountState {\n  id: string;\n  provider: string;\n  identity: string;\n  status: 'connected' | 'disconnected';\n  auth: 'api-key' | 'oauth';\n  needs: 'cors-free-transport' | null;\n}\n\nexport interface BudgetState {\n  provider: string;\n  percent: number;\n  window: 'weekly';\n  resets: string;\n}\n\nexport interface SignIn {\n  clientId: string;\n  scopes: string;\n  imsEnvironment: string;\n}\n\nexport interface SettingsState {\n  models: ModelChoice[];\n  accounts: AccountState[];\n  budget?: BudgetState | null;\n}\n\nexport interface AgentSettings {\n  readonly state: ReplicatedState<SettingsState>;\n  connect(\n    providerId: string,\n    secret: string,\n    region: string | null,\n    context: Context\n  ): Promise<void>;\n  disconnect(providerId: string, context: Context): Promise<void>;\n  signIn(providerId: string, context: Context): Promise<SignIn | null>;\n}\n\nexport const AgentSettings = defineService<AgentSettings>('slicc.agent.settings');\n"],
+  "mappings": "AAAA;AAAA,EAEE;AAAA,OAGK;AAsHA,MAAM,eAAe,cAA4B,qBAAqB;AAqBtE,MAAM,kBAAkB,cAA+B,wBAAwB;AAO/E,MAAM,gBAAgB,cAA6B,sBAAsB;AAEzE,MAAM,gBAAgB;AAmDtB,MAAM,gBAAgB,cAA6B,sBAAsB;",
   "names": []
 }

package/dist/skills/index.js

@@ -10,7 +10,14 @@ import {
   loadSkills
 } from "./skills.js";
 import { expandPromptTemplate, loadTemplates } from "./templates.js";
-const BUILTIN_SKILLS = ["agent", "licks", "skill-authoring", "sprinkles", "welcome"];
+const BUILTIN_SKILLS = [
+  "agent",
+  "licks",
+  "memory",
+  "skill-authoring",
+  "sprinkles",
+  "welcome"
+];
 const BUILTIN_PROMPTS = ["parallel-review", "review-loop"];
 const SKILLS_DIR = "/var/lib/slicc/agent/skills";
 const PROMPTS_DIR = "/var/lib/slicc/agent/prompts";

package/dist/skills/index.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/skills/index.ts"],
-  "sourcesContent": ["import { type Context, type ReplicatedState, replicatedState } from '@earendil-works/chord';\nimport {\n  defineExtension,\n  type Extension,\n  type Registry,\n  section,\n} from '@earendil-works/pi-durable';\nimport type { ExecutionEnv, FileWatcher } from '@earendil-works/pi-durable/env';\nimport type { Licks } from '../licks/licks.ts';\nimport { manifestDirs } from '../roles/roles.ts';\nimport type { Command } from '../services.ts';\nimport {\n  type Diagnostic,\n  expandSkillCommand,\n  formatSkillsForPrompt,\n  loadSkills,\n  type Skill,\n  type SkillRoot,\n} from './skills.ts';\nimport { expandPromptTemplate, loadTemplates, type PromptTemplate } from './templates.ts';\n\nexport const BUILTIN_SKILLS = ['agent', 'licks', 'skill-authoring', 'sprinkles', 'welcome'];\nexport const BUILTIN_PROMPTS = ['parallel-review', 'review-loop'];\nexport const SKILLS_DIR = '/var/lib/slicc/agent/skills';\nexport const PROMPTS_DIR = '/var/lib/slicc/agent/prompts';\nexport const COMPAT_DIR = '/workspace/skills';\nexport const RELOAD_MS = 300;\n\nexport interface SkillsRuntime {\n  readonly commands: ReplicatedState<Command[]>;\n  skills(): readonly Skill[];\n  dirs(): string[];\n  templates(): readonly PromptTemplate[];\n  expand(text: string, context: Context): Promise<string>;\n  reload(context: Context): Promise<void>;\n  close(context: Context): Promise<void>;\n}\n\nexport interface SkillsAttach {\n  env: ExecutionEnv;\n  home: string;\n  assets?: (path: string) => Promise<string>;\n  reloadMs: number;\n}\n\nexport interface SkillsSetup {\n  extension: Extension;\n  attach(options: SkillsAttach, context: Context): Promise<SkillsRuntime>;\n}\n\ntype Manifest = { pi?: { skills?: unknown; prompts?: unknown } };\n\nexport function piResources(dir: string, text: string, kind: 'skills' | 'prompts'): string[] {\n  let manifest: Manifest;\n  try {\n    manifest = JSON.parse(text) as Manifest;\n  } catch {\n    return [];\n  }\n  const listed = manifest.pi?.[kind];\n  const paths = Array.isArray(listed) ? listed : typeof listed === 'string' ? [listed] : [];\n  return paths\n    .filter((path): path is string => typeof path === 'string')\n    .map((path) => `${dir}/${path.replace(/^\\.\\//, '').replace(/\\/$/, '')}`);\n}\n\nasync function packaged(env: ExecutionEnv, kind: 'skills' | 'prompts', context: Context) {\n  const out: string[] = [];\n  for (const dir of await manifestDirs(env, '/node_modules', context)) {\n    const read = await env.readTextFile(`${dir}/package.json`, context);\n    if (read.ok) out.push(...piResources(dir, read.value, kind));\n  }\n  return out;\n}\n\nasync function installBuiltins(\n  env: ExecutionEnv,\n  assets: (path: string) => Promise<string>,\n  context: Context\n): Promise<void> {\n  await env.remove(SKILLS_DIR, { recursive: true, force: true }, context);\n  await env.remove(PROMPTS_DIR, { recursive: true, force: true }, context);\n  for (const name of BUILTIN_SKILLS) {\n    const text = await assets(`packages/vfs-root/skills/${name}/SKILL.md`).catch(() => undefined);\n    if (text === undefined) continue;\n    await env.createDir(`${SKILLS_DIR}/${name}`, { recursive: true }, context);\n    await env.writeFile(`${SKILLS_DIR}/${name}/SKILL.md`, text, context);\n  }\n  await env.createDir(PROMPTS_DIR, { recursive: true }, context);\n  for (const name of BUILTIN_PROMPTS) {\n    const text = await assets(`packages/vfs-root/prompts/${name}.md`).catch(() => undefined);\n    if (text !== undefined) await env.writeFile(`${PROMPTS_DIR}/${name}.md`, text, context);\n  }\n}\n\nexport function problemLick(problem: Diagnostic, home: string) {\n  const path = problem.path.startsWith(`${home}/`)\n    ? `~${problem.path.slice(home.length)}`\n    : problem.path;\n  return {\n    channel: 'fswatch' as const,\n    source: `skills:${path}`,\n    title: `Skill or prompt template problem: ${path}`,\n    text: problem.message,\n    body: 'The file is used with this problem, or skipped if it has no description.\\nThe rules are in the slicc-agent README.',\n    target: 'cone' as const,\n    severity: 'warn' as const,\n    eventId: `${path}\\n${problem.message}`,\n  };\n}\n\nexport function commandsOf(\n  skills: readonly Skill[],\n  templates: readonly PromptTemplate[]\n): Command[] {\n  return [\n    ...templates.map((template) => ({\n      name: template.name,\n      description: template.description,\n      kind: 'prompt' as const,\n    })),\n    ...skills.map((skill) => ({\n      name: `skill:${skill.name}`,\n      description: skill.description,\n      kind: 'skill' as const,\n    })),\n  ];\n}\n\nexport function setupSkills(registry: Registry, licks: Licks): SkillsSetup {\n  let current: Skill[] = [];\n  const extension = defineExtension({\n    name: 'slicc-skills',\n    sections: [section('skills', async () => formatSkillsForPrompt(current) || undefined)],\n  });\n  registry.install(extension);\n  return {\n    extension,\n    async attach(options, context) {\n      const { env, home } = options;\n      if (options.assets)\n        await installBuiltins(env, options.assets, context).catch(() => undefined);\n      let templates: PromptTemplate[] = [];\n      const commands = replicatedState<Command[]>([]);\n      const reported = new Set<string>();\n      const reload = async (using: Context) => {\n        const roots: SkillRoot[] = [\n          { dir: `${home}/.pi/agent/skills`, source: 'user' },\n          { dir: `${home}/.agents/skills`, source: 'user' },\n          { dir: COMPAT_DIR, source: 'compat' },\n          ...(await packaged(env, 'skills', using)).map((dir) => ({\n            dir,\n            source: 'package' as const,\n          })),\n          { dir: SKILLS_DIR, source: 'builtin' },\n        ];\n        const loaded = await loadSkills(env, roots, using);\n        const prompts = await loadTemplates(\n          env,\n          [`${home}/.pi/agent/prompts`, ...(await packaged(env, 'prompts', using)), PROMPTS_DIR],\n          using\n        );\n        current = loaded.skills;\n        templates = prompts.templates;\n        commands.replace(using, commandsOf(current, templates));\n        for (const problem of [...loaded.diagnostics, ...prompts.diagnostics]) {\n          const key = `${problem.path}\\n${problem.message}`;\n          if (reported.has(key)) continue;\n          reported.add(key);\n          await licks.deliver(problemLick(problem, home), using).catch(() => undefined);\n        }\n      };\n      await reload(context);\n      let timer: ReturnType<typeof setTimeout> | undefined;\n      const schedule = () => {\n        clearTimeout(timer);\n        timer = setTimeout(() => void reload(context).catch(() => undefined), options.reloadMs);\n      };\n      const watched = await env.watch(\n        [\n          { path: `${home}/.pi/agent/skills`, recursive: true },\n          { path: `${home}/.pi/agent/prompts` },\n          { path: `${home}/.agents/skills`, recursive: true },\n          { path: COMPAT_DIR, recursive: true },\n        ],\n        schedule,\n        context\n      );\n      const watcher: FileWatcher | undefined = watched.ok ? watched.value : undefined;\n      return {\n        commands,\n        skills: () => current,\n        dirs: () => current.map((skill) => skill.baseDir),\n        templates: () => templates,\n        async expand(text, using) {\n          const expanded = await expandSkillCommand(text, current, env, using);\n          return expanded === text ? expandPromptTemplate(text, templates) : expanded;\n        },\n        reload,\n        async close(using) {\n          clearTimeout(timer);\n          await watcher?.close(using);\n        },\n      };\n    },\n  };\n}\n"],
-  "mappings": "AAAA,SAA6C,uBAAuB;AACpE;AAAA,EACE;AAAA,EAGA;AAAA,OACK;AAGP,SAAS,oBAAoB;AAE7B;AAAA,EAEE;AAAA,EACA;AAAA,EACA;AAAA,OAGK;AACP,SAAS,sBAAsB,qBAA0C;AAElE,MAAM,iBAAiB,CAAC,SAAS,SAAS,mBAAmB,aAAa,SAAS;AACnF,MAAM,kBAAkB,CAAC,mBAAmB,aAAa;AACzD,MAAM,aAAa;AACnB,MAAM,cAAc;AACpB,MAAM,aAAa;AACnB,MAAM,YAAY;AA0BlB,SAAS,YAAY,KAAa,MAAc,MAAsC;AAC3F,MAAI;AACJ,MAAI;AACF,eAAW,KAAK,MAAM,IAAI;AAAA,EAC5B,QAAQ;AACN,WAAO,CAAC;AAAA,EACV;AACA,QAAM,SAAS,SAAS,KAAK,IAAI;AACjC,QAAM,QAAQ,MAAM,QAAQ,MAAM,IAAI,SAAS,OAAO,WAAW,WAAW,CAAC,MAAM,IAAI,CAAC;AACxF,SAAO,MACJ,OAAO,CAAC,SAAyB,OAAO,SAAS,QAAQ,EACzD,IAAI,CAAC,SAAS,GAAG,GAAG,IAAI,KAAK,QAAQ,SAAS,EAAE,EAAE,QAAQ,OAAO,EAAE,CAAC,EAAE;AAC3E;AAEA,eAAe,SAAS,KAAmB,MAA4B,SAAkB;AACvF,QAAM,MAAgB,CAAC;AACvB,aAAW,OAAO,MAAM,aAAa,KAAK,iBAAiB,OAAO,GAAG;AACnE,UAAM,OAAO,MAAM,IAAI,aAAa,GAAG,GAAG,iBAAiB,OAAO;AAClE,QAAI,KAAK,GAAI,KAAI,KAAK,GAAG,YAAY,KAAK,KAAK,OAAO,IAAI,CAAC;AAAA,EAC7D;AACA,SAAO;AACT;AAEA,eAAe,gBACb,KACA,QACA,SACe;AACf,QAAM,IAAI,OAAO,YAAY,EAAE,WAAW,MAAM,OAAO,KAAK,GAAG,OAAO;AACtE,QAAM,IAAI,OAAO,aAAa,EAAE,WAAW,MAAM,OAAO,KAAK,GAAG,OAAO;AACvE,aAAW,QAAQ,gBAAgB;AACjC,UAAM,OAAO,MAAM,OAAO,4BAA4B,IAAI,WAAW,EAAE,MAAM,MAAM,MAAS;AAC5F,QAAI,SAAS,OAAW;AACxB,UAAM,IAAI,UAAU,GAAG,UAAU,IAAI,IAAI,IAAI,EAAE,WAAW,KAAK,GAAG,OAAO;AACzE,UAAM,IAAI,UAAU,GAAG,UAAU,IAAI,IAAI,aAAa,MAAM,OAAO;AAAA,EACrE;AACA,QAAM,IAAI,UAAU,aAAa,EAAE,WAAW,KAAK,GAAG,OAAO;AAC7D,aAAW,QAAQ,iBAAiB;AAClC,UAAM,OAAO,MAAM,OAAO,6BAA6B,IAAI,KAAK,EAAE,MAAM,MAAM,MAAS;AACvF,QAAI,SAAS,OAAW,OAAM,IAAI,UAAU,GAAG,WAAW,IAAI,IAAI,OAAO,MAAM,OAAO;AAAA,EACxF;AACF;AAEO,SAAS,YAAY,SAAqB,MAAc;AAC7D,QAAM,OAAO,QAAQ,KAAK,WAAW,GAAG,IAAI,GAAG,IAC3C,IAAI,QAAQ,KAAK,MAAM,KAAK,MAAM,CAAC,KACnC,QAAQ;AACZ,SAAO;AAAA,IACL,SAAS;AAAA,IACT,QAAQ,UAAU,IAAI;AAAA,IACtB,OAAO,qCAAqC,IAAI;AAAA,IAChD,MAAM,QAAQ;AAAA,IACd,MAAM;AAAA,IACN,QAAQ;AAAA,IACR,UAAU;AAAA,IACV,SAAS,GAAG,IAAI;AAAA,EAAK,QAAQ,OAAO;AAAA,EACtC;AACF;AAEO,SAAS,WACd,QACA,WACW;AACX,SAAO;AAAA,IACL,GAAG,UAAU,IAAI,CAAC,cAAc;AAAA,MAC9B,MAAM,SAAS;AAAA,MACf,aAAa,SAAS;AAAA,MACtB,MAAM;AAAA,IACR,EAAE;AAAA,IACF,GAAG,OAAO,IAAI,CAAC,WAAW;AAAA,MACxB,MAAM,SAAS,MAAM,IAAI;AAAA,MACzB,aAAa,MAAM;AAAA,MACnB,MAAM;AAAA,IACR,EAAE;AAAA,EACJ;AACF;AAEO,SAAS,YAAY,UAAoB,OAA2B;AACzE,MAAI,UAAmB,CAAC;AACxB,QAAM,YAAY,gBAAgB;AAAA,IAChC,MAAM;AAAA,IACN,UAAU,CAAC,QAAQ,UAAU,YAAY,sBAAsB,OAAO,KAAK,MAAS,CAAC;AAAA,EACvF,CAAC;AACD,WAAS,QAAQ,SAAS;AAC1B,SAAO;AAAA,IACL;AAAA,IACA,MAAM,OAAO,SAAS,SAAS;AAC7B,YAAM,EAAE,KAAK,KAAK,IAAI;AACtB,UAAI,QAAQ;AACV,cAAM,gBAAgB,KAAK,QAAQ,QAAQ,OAAO,EAAE,MAAM,MAAM,MAAS;AAC3E,UAAI,YAA8B,CAAC;AACnC,YAAM,WAAW,gBAA2B,CAAC,CAAC;AAC9C,YAAM,WAAW,oBAAI,IAAY;AACjC,YAAM,SAAS,OAAO,UAAmB;AACvC,cAAM,QAAqB;AAAA,UACzB,EAAE,KAAK,GAAG,IAAI,qBAAqB,QAAQ,OAAO;AAAA,UAClD,EAAE,KAAK,GAAG,IAAI,mBAAmB,QAAQ,OAAO;AAAA,UAChD,EAAE,KAAK,YAAY,QAAQ,SAAS;AAAA,UACpC,IAAI,MAAM,SAAS,KAAK,UAAU,KAAK,GAAG,IAAI,CAAC,SAAS;AAAA,YACtD;AAAA,YACA,QAAQ;AAAA,UACV,EAAE;AAAA,UACF,EAAE,KAAK,YAAY,QAAQ,UAAU;AAAA,QACvC;AACA,cAAM,SAAS,MAAM,WAAW,KAAK,OAAO,KAAK;AACjD,cAAM,UAAU,MAAM;AAAA,UACpB;AAAA,UACA,CAAC,GAAG,IAAI,sBAAsB,GAAI,MAAM,SAAS,KAAK,WAAW,KAAK,GAAI,WAAW;AAAA,UACrF;AAAA,QACF;AACA,kBAAU,OAAO;AACjB,oBAAY,QAAQ;AACpB,iBAAS,QAAQ,OAAO,WAAW,SAAS,SAAS,CAAC;AACtD,mBAAW,WAAW,CAAC,GAAG,OAAO,aAAa,GAAG,QAAQ,WAAW,GAAG;AACrE,gBAAM,MAAM,GAAG,QAAQ,IAAI;AAAA,EAAK,QAAQ,OAAO;AAC/C,cAAI,SAAS,IAAI,GAAG,EAAG;AACvB,mBAAS,IAAI,GAAG;AAChB,gBAAM,MAAM,QAAQ,YAAY,SAAS,IAAI,GAAG,KAAK,EAAE,MAAM,MAAM,MAAS;AAAA,QAC9E;AAAA,MACF;AACA,YAAM,OAAO,OAAO;AACpB,UAAI;AACJ,YAAM,WAAW,MAAM;AACrB,qBAAa,KAAK;AAClB,gBAAQ,WAAW,MAAM,KAAK,OAAO,OAAO,EAAE,MAAM,MAAM,MAAS,GAAG,QAAQ,QAAQ;AAAA,MACxF;AACA,YAAM,UAAU,MAAM,IAAI;AAAA,QACxB;AAAA,UACE,EAAE,MAAM,GAAG,IAAI,qBAAqB,WAAW,KAAK;AAAA,UACpD,EAAE,MAAM,GAAG,IAAI,qBAAqB;AAAA,UACpC,EAAE,MAAM,GAAG,IAAI,mBAAmB,WAAW,KAAK;AAAA,UAClD,EAAE,MAAM,YAAY,WAAW,KAAK;AAAA,QACtC;AAAA,QACA;AAAA,QACA;AAAA,MACF;AACA,YAAM,UAAmC,QAAQ,KAAK,QAAQ,QAAQ;AACtE,aAAO;AAAA,QACL;AAAA,QACA,QAAQ,MAAM;AAAA,QACd,MAAM,MAAM,QAAQ,IAAI,CAAC,UAAU,MAAM,OAAO;AAAA,QAChD,WAAW,MAAM;AAAA,QACjB,MAAM,OAAO,MAAM,OAAO;AACxB,gBAAM,WAAW,MAAM,mBAAmB,MAAM,SAAS,KAAK,KAAK;AACnE,iBAAO,aAAa,OAAO,qBAAqB,MAAM,SAAS,IAAI;AAAA,QACrE;AAAA,QACA;AAAA,QACA,MAAM,MAAM,OAAO;AACjB,uBAAa,KAAK;AAClB,gBAAM,SAAS,MAAM,KAAK;AAAA,QAC5B;AAAA,MACF;AAAA,IACF;AAAA,EACF;AACF;",
+  "sourcesContent": ["import { type Context, type ReplicatedState, replicatedState } from '@earendil-works/chord';\nimport {\n  defineExtension,\n  type Extension,\n  type Registry,\n  section,\n} from '@earendil-works/pi-durable';\nimport type { ExecutionEnv, FileWatcher } from '@earendil-works/pi-durable/env';\nimport type { Licks } from '../licks/licks.ts';\nimport { manifestDirs } from '../roles/roles.ts';\nimport type { Command } from '../services.ts';\nimport {\n  type Diagnostic,\n  expandSkillCommand,\n  formatSkillsForPrompt,\n  loadSkills,\n  type Skill,\n  type SkillRoot,\n} from './skills.ts';\nimport { expandPromptTemplate, loadTemplates, type PromptTemplate } from './templates.ts';\n\nexport const BUILTIN_SKILLS = [\n  'agent',\n  'licks',\n  'memory',\n  'skill-authoring',\n  'sprinkles',\n  'welcome',\n];\nexport const BUILTIN_PROMPTS = ['parallel-review', 'review-loop'];\nexport const SKILLS_DIR = '/var/lib/slicc/agent/skills';\nexport const PROMPTS_DIR = '/var/lib/slicc/agent/prompts';\nexport const COMPAT_DIR = '/workspace/skills';\nexport const RELOAD_MS = 300;\n\nexport interface SkillsRuntime {\n  readonly commands: ReplicatedState<Command[]>;\n  skills(): readonly Skill[];\n  dirs(): string[];\n  templates(): readonly PromptTemplate[];\n  expand(text: string, context: Context): Promise<string>;\n  reload(context: Context): Promise<void>;\n  close(context: Context): Promise<void>;\n}\n\nexport interface SkillsAttach {\n  env: ExecutionEnv;\n  home: string;\n  assets?: (path: string) => Promise<string>;\n  reloadMs: number;\n}\n\nexport interface SkillsSetup {\n  extension: Extension;\n  attach(options: SkillsAttach, context: Context): Promise<SkillsRuntime>;\n}\n\ntype Manifest = { pi?: { skills?: unknown; prompts?: unknown } };\n\nexport function piResources(dir: string, text: string, kind: 'skills' | 'prompts'): string[] {\n  let manifest: Manifest;\n  try {\n    manifest = JSON.parse(text) as Manifest;\n  } catch {\n    return [];\n  }\n  const listed = manifest.pi?.[kind];\n  const paths = Array.isArray(listed) ? listed : typeof listed === 'string' ? [listed] : [];\n  return paths\n    .filter((path): path is string => typeof path === 'string')\n    .map((path) => `${dir}/${path.replace(/^\\.\\//, '').replace(/\\/$/, '')}`);\n}\n\nasync function packaged(env: ExecutionEnv, kind: 'skills' | 'prompts', context: Context) {\n  const out: string[] = [];\n  for (const dir of await manifestDirs(env, '/node_modules', context)) {\n    const read = await env.readTextFile(`${dir}/package.json`, context);\n    if (read.ok) out.push(...piResources(dir, read.value, kind));\n  }\n  return out;\n}\n\nasync function installBuiltins(\n  env: ExecutionEnv,\n  assets: (path: string) => Promise<string>,\n  context: Context\n): Promise<void> {\n  await env.remove(SKILLS_DIR, { recursive: true, force: true }, context);\n  await env.remove(PROMPTS_DIR, { recursive: true, force: true }, context);\n  for (const name of BUILTIN_SKILLS) {\n    const text = await assets(`packages/vfs-root/skills/${name}/SKILL.md`).catch(() => undefined);\n    if (text === undefined) continue;\n    await env.createDir(`${SKILLS_DIR}/${name}`, { recursive: true }, context);\n    await env.writeFile(`${SKILLS_DIR}/${name}/SKILL.md`, text, context);\n  }\n  await env.createDir(PROMPTS_DIR, { recursive: true }, context);\n  for (const name of BUILTIN_PROMPTS) {\n    const text = await assets(`packages/vfs-root/prompts/${name}.md`).catch(() => undefined);\n    if (text !== undefined) await env.writeFile(`${PROMPTS_DIR}/${name}.md`, text, context);\n  }\n}\n\nexport function problemLick(problem: Diagnostic, home: string) {\n  const path = problem.path.startsWith(`${home}/`)\n    ? `~${problem.path.slice(home.length)}`\n    : problem.path;\n  return {\n    channel: 'fswatch' as const,\n    source: `skills:${path}`,\n    title: `Skill or prompt template problem: ${path}`,\n    text: problem.message,\n    body: 'The file is used with this problem, or skipped if it has no description.\\nThe rules are in the slicc-agent README.',\n    target: 'cone' as const,\n    severity: 'warn' as const,\n    eventId: `${path}\\n${problem.message}`,\n  };\n}\n\nexport function commandsOf(\n  skills: readonly Skill[],\n  templates: readonly PromptTemplate[]\n): Command[] {\n  return [\n    ...templates.map((template) => ({\n      name: template.name,\n      description: template.description,\n      kind: 'prompt' as const,\n    })),\n    ...skills.map((skill) => ({\n      name: `skill:${skill.name}`,\n      description: skill.description,\n      kind: 'skill' as const,\n    })),\n  ];\n}\n\nexport function setupSkills(registry: Registry, licks: Licks): SkillsSetup {\n  let current: Skill[] = [];\n  const extension = defineExtension({\n    name: 'slicc-skills',\n    sections: [section('skills', async () => formatSkillsForPrompt(current) || undefined)],\n  });\n  registry.install(extension);\n  return {\n    extension,\n    async attach(options, context) {\n      const { env, home } = options;\n      if (options.assets)\n        await installBuiltins(env, options.assets, context).catch(() => undefined);\n      let templates: PromptTemplate[] = [];\n      const commands = replicatedState<Command[]>([]);\n      const reported = new Set<string>();\n      const reload = async (using: Context) => {\n        const roots: SkillRoot[] = [\n          { dir: `${home}/.pi/agent/skills`, source: 'user' },\n          { dir: `${home}/.agents/skills`, source: 'user' },\n          { dir: COMPAT_DIR, source: 'compat' },\n          ...(await packaged(env, 'skills', using)).map((dir) => ({\n            dir,\n            source: 'package' as const,\n          })),\n          { dir: SKILLS_DIR, source: 'builtin' },\n        ];\n        const loaded = await loadSkills(env, roots, using);\n        const prompts = await loadTemplates(\n          env,\n          [`${home}/.pi/agent/prompts`, ...(await packaged(env, 'prompts', using)), PROMPTS_DIR],\n          using\n        );\n        current = loaded.skills;\n        templates = prompts.templates;\n        commands.replace(using, commandsOf(current, templates));\n        for (const problem of [...loaded.diagnostics, ...prompts.diagnostics]) {\n          const key = `${problem.path}\\n${problem.message}`;\n          if (reported.has(key)) continue;\n          reported.add(key);\n          await licks.deliver(problemLick(problem, home), using).catch(() => undefined);\n        }\n      };\n      await reload(context);\n      let timer: ReturnType<typeof setTimeout> | undefined;\n      const schedule = () => {\n        clearTimeout(timer);\n        timer = setTimeout(() => void reload(context).catch(() => undefined), options.reloadMs);\n      };\n      const watched = await env.watch(\n        [\n          { path: `${home}/.pi/agent/skills`, recursive: true },\n          { path: `${home}/.pi/agent/prompts` },\n          { path: `${home}/.agents/skills`, recursive: true },\n          { path: COMPAT_DIR, recursive: true },\n        ],\n        schedule,\n        context\n      );\n      const watcher: FileWatcher | undefined = watched.ok ? watched.value : undefined;\n      return {\n        commands,\n        skills: () => current,\n        dirs: () => current.map((skill) => skill.baseDir),\n        templates: () => templates,\n        async expand(text, using) {\n          const expanded = await expandSkillCommand(text, current, env, using);\n          return expanded === text ? expandPromptTemplate(text, templates) : expanded;\n        },\n        reload,\n        async close(using) {\n          clearTimeout(timer);\n          await watcher?.close(using);\n        },\n      };\n    },\n  };\n}\n"],
+  "mappings": "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",
   "names": []
 }

package/dist/spectrum/index.js

@@ -1,8 +1,10 @@
 import { AgentAdapter } from "./agent-port.js";
+import { MemoryAdapter } from "./memory-port.js";
 import { SettingsAdapter } from "./settings-port.js";
 import { SprinkleAdapter } from "./sprinkle-port.js";
 import { TrayAdapter } from "./tray-port.js";
 import { AgentAdapter as AgentAdapter2, CONE } from "./agent-port.js";
+import { MemoryAdapter as MemoryAdapter2 } from "./memory-port.js";
 import {
   assistant,
   errorAction,
@@ -26,12 +28,14 @@ function createAgentModel(connection, options = {}) {
       options.login ?? null
     ),
     tray: new TrayAdapter(connection.settings),
-    sprinkles: new SprinkleAdapter(connection)
+    sprinkles: new SprinkleAdapter(connection),
+    memory: new MemoryAdapter(connection)
   };
 }
 export {
   AgentAdapter2 as AgentAdapter,
   CONE,
+  MemoryAdapter2 as MemoryAdapter,
   SETTINGS_KEY,
   SettingsAdapter2 as SettingsAdapter,
   SprinkleAdapter2 as SprinkleAdapter,

package/dist/spectrum/index.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/spectrum/index.ts"],
-  "sourcesContent": ["import type { AgentConnection } from '../client.ts';\nimport { AgentAdapter } from './agent-port.ts';\nimport { type Login, SettingsAdapter } from './settings-port.ts';\nimport { SprinkleAdapter } from './sprinkle-port.ts';\nimport { TrayAdapter } from './tray-port.ts';\n\nexport { AgentAdapter, CONE } from './agent-port.ts';\nexport {\n  assistant,\n  errorAction,\n  errorPart,\n  isBusy,\n  queued,\n  textOf,\n  toMessages,\n} from './messages.ts';\nexport { type Login, SETTINGS_KEY, SettingsAdapter } from './settings-port.ts';\nexport { SprinkleAdapter } from './sprinkle-port.ts';\nexport { TrayAdapter } from './tray-port.ts';\n\nexport function createAgentModel(\n  connection: AgentConnection,\n  options: { storage?: Pick<Storage, 'getItem' | 'setItem'> | null; login?: Login } = {}\n): {\n  agent: AgentAdapter;\n  settings: SettingsAdapter;\n  tray: TrayAdapter;\n  sprinkles: SprinkleAdapter;\n} {\n  const agent = new AgentAdapter(connection);\n  return {\n    agent,\n    settings: new SettingsAdapter(\n      connection.settings,\n      agent,\n      options.storage ?? null,\n      options.login ?? null\n    ),\n    tray: new TrayAdapter(connection.settings),\n    sprinkles: new SprinkleAdapter(connection),\n  };\n}\n"],
-  "mappings": "AACA,SAAS,oBAAoB;AAC7B,SAAqB,uBAAuB;AAC5C,SAAS,uBAAuB;AAChC,SAAS,mBAAmB;AAE5B,SAAS,gBAAAA,eAAc,YAAY;AACnC;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AACP,SAAqB,cAAc,mBAAAC,wBAAuB;AAC1D,SAAS,mBAAAC,wBAAuB;AAChC,SAAS,eAAAC,oBAAmB;AAErB,SAAS,iBACd,YACA,UAAoF,CAAC,GAMrF;AACA,QAAM,QAAQ,IAAI,aAAa,UAAU;AACzC,SAAO;AAAA,IACL;AAAA,IACA,UAAU,IAAI;AAAA,MACZ,WAAW;AAAA,MACX;AAAA,MACA,QAAQ,WAAW;AAAA,MACnB,QAAQ,SAAS;AAAA,IACnB;AAAA,IACA,MAAM,IAAI,YAAY,WAAW,QAAQ;AAAA,IACzC,WAAW,IAAI,gBAAgB,UAAU;AAAA,EAC3C;AACF;",
-  "names": ["AgentAdapter", "SettingsAdapter", "SprinkleAdapter", "TrayAdapter"]
+  "sourcesContent": ["import type { AgentConnection } from '../client.ts';\nimport { AgentAdapter } from './agent-port.ts';\nimport { MemoryAdapter } from './memory-port.ts';\nimport { type Login, SettingsAdapter } from './settings-port.ts';\nimport { SprinkleAdapter } from './sprinkle-port.ts';\nimport { TrayAdapter } from './tray-port.ts';\n\nexport { AgentAdapter, CONE } from './agent-port.ts';\nexport { MemoryAdapter } from './memory-port.ts';\nexport {\n  assistant,\n  errorAction,\n  errorPart,\n  isBusy,\n  queued,\n  textOf,\n  toMessages,\n} from './messages.ts';\nexport { type Login, SETTINGS_KEY, SettingsAdapter } from './settings-port.ts';\nexport { SprinkleAdapter } from './sprinkle-port.ts';\nexport { TrayAdapter } from './tray-port.ts';\n\nexport function createAgentModel(\n  connection: AgentConnection,\n  options: { storage?: Pick<Storage, 'getItem' | 'setItem'> | null; login?: Login } = {}\n): {\n  agent: AgentAdapter;\n  settings: SettingsAdapter;\n  tray: TrayAdapter;\n  sprinkles: SprinkleAdapter;\n  memory: MemoryAdapter;\n} {\n  const agent = new AgentAdapter(connection);\n  return {\n    agent,\n    settings: new SettingsAdapter(\n      connection.settings,\n      agent,\n      options.storage ?? null,\n      options.login ?? null\n    ),\n    tray: new TrayAdapter(connection.settings),\n    sprinkles: new SprinkleAdapter(connection),\n    memory: new MemoryAdapter(connection),\n  };\n}\n"],
+  "mappings": "AACA,SAAS,oBAAoB;AAC7B,SAAS,qBAAqB;AAC9B,SAAqB,uBAAuB;AAC5C,SAAS,uBAAuB;AAChC,SAAS,mBAAmB;AAE5B,SAAS,gBAAAA,eAAc,YAAY;AACnC,SAAS,iBAAAC,sBAAqB;AAC9B;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AACP,SAAqB,cAAc,mBAAAC,wBAAuB;AAC1D,SAAS,mBAAAC,wBAAuB;AAChC,SAAS,eAAAC,oBAAmB;AAErB,SAAS,iBACd,YACA,UAAoF,CAAC,GAOrF;AACA,QAAM,QAAQ,IAAI,aAAa,UAAU;AACzC,SAAO;AAAA,IACL;AAAA,IACA,UAAU,IAAI;AAAA,MACZ,WAAW;AAAA,MACX;AAAA,MACA,QAAQ,WAAW;AAAA,MACnB,QAAQ,SAAS;AAAA,IACnB;AAAA,IACA,MAAM,IAAI,YAAY,WAAW,QAAQ;AAAA,IACzC,WAAW,IAAI,gBAAgB,UAAU;AAAA,IACzC,QAAQ,IAAI,cAAc,UAAU;AAAA,EACtC;AACF;",
+  "names": ["AgentAdapter", "MemoryAdapter", "SettingsAdapter", "SprinkleAdapter", "TrayAdapter"]
 }

package/dist/spectrum/memory-port.js

@@ -0,0 +1,64 @@
+import { BACKGROUND_CONTEXT } from "@earendil-works/chord/context";
+import { slugOf as slug } from "../memory/format.js";
+import { Emitter } from "./emitter.js";
+class MemoryAdapter extends Emitter {
+  #connection;
+  #pending = /* @__PURE__ */ new Map();
+  constructor(connection) {
+    super();
+    this.#connection = connection;
+    connection.memories?.subscribe(() => {
+      this.#pending.clear();
+      this.emit("memories", this.list());
+    });
+    connection.memoryScopes?.subscribe(() => this.emit("memories", this.list()));
+  }
+  list() {
+    const stored = this.#connection.memories?.value ?? [];
+    if (!this.#pending.size) return stored;
+    const out = stored.filter((item) => !this.#pending.has(item.id));
+    for (const item of this.#pending.values()) if (item) out.push(item);
+    return out;
+  }
+  scopes() {
+    return this.#connection.memoryScopes?.value ?? [];
+  }
+  save(draft) {
+    const memory = {
+      ...draft,
+      id: `${draft.scope}/${slug(draft.section)}/${slug(draft.title)}`,
+      updatedAt: Date.now(),
+      source: "entry"
+    };
+    if (draft.id && draft.id !== memory.id) this.#pending.set(draft.id, null);
+    this.#pending.set(memory.id, memory);
+    this.emit("memories", this.list());
+    void this.#connection.control.memorySave(
+      {
+        id: draft.id ?? null,
+        scope: draft.scope,
+        section: draft.section,
+        title: draft.title,
+        body: draft.body,
+        tag: draft.tag
+      },
+      BACKGROUND_CONTEXT
+    ).catch(() => {
+      this.#pending.clear();
+      this.emit("memories", this.list());
+    });
+    return memory;
+  }
+  remove(id) {
+    this.#pending.set(id, null);
+    this.emit("memories", this.list());
+    void this.#connection.control.memoryRemove(id, BACKGROUND_CONTEXT).catch(() => {
+      this.#pending.delete(id);
+      this.emit("memories", this.list());
+    });
+  }
+}
+export {
+  MemoryAdapter
+};
+//# sourceMappingURL=memory-port.js.map

package/dist/spectrum/memory-port.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/spectrum/memory-port.ts"],
+  "sourcesContent": ["import type { Memory, MemoryDraft, MemoryEvents, MemoryPort } from '@ai-ecoverse/slicc-spectrum/ui';\nimport { BACKGROUND_CONTEXT } from '@earendil-works/chord/context';\nimport type { AgentConnection } from '../client.ts';\nimport { type MemoryScope, slugOf as slug } from '../memory/format.ts';\nimport { Emitter } from './emitter.ts';\n\ntype Local = Memory & { source?: 'entry' | 'notes' };\n\nexport class MemoryAdapter extends Emitter<MemoryEvents> implements MemoryPort {\n  readonly #connection: AgentConnection;\n  #pending = new Map<string, Local | null>();\n\n  constructor(connection: AgentConnection) {\n    super();\n    this.#connection = connection;\n    connection.memories?.subscribe(() => {\n      this.#pending.clear();\n      this.emit('memories', this.list());\n    });\n    connection.memoryScopes?.subscribe(() => this.emit('memories', this.list()));\n  }\n\n  list(): readonly Memory[] {\n    const stored = (this.#connection.memories?.value ?? []) as Local[];\n    if (!this.#pending.size) return stored;\n    const out = stored.filter((item) => !this.#pending.has(item.id));\n    for (const item of this.#pending.values()) if (item) out.push(item);\n    return out;\n  }\n\n  scopes(): readonly MemoryScope[] {\n    return this.#connection.memoryScopes?.value ?? [];\n  }\n\n  save(draft: MemoryDraft): Memory {\n    const memory: Local = {\n      ...draft,\n      id: `${draft.scope}/${slug(draft.section)}/${slug(draft.title)}`,\n      updatedAt: Date.now(),\n      source: 'entry',\n    };\n    if (draft.id && draft.id !== memory.id) this.#pending.set(draft.id, null);\n    this.#pending.set(memory.id, memory);\n    this.emit('memories', this.list());\n    void this.#connection.control\n      .memorySave(\n        {\n          id: draft.id ?? null,\n          scope: draft.scope,\n          section: draft.section,\n          title: draft.title,\n          body: draft.body,\n          tag: draft.tag,\n        },\n        BACKGROUND_CONTEXT\n      )\n      .catch(() => {\n        this.#pending.clear();\n        this.emit('memories', this.list());\n      });\n    return memory;\n  }\n\n  remove(id: string): void {\n    this.#pending.set(id, null);\n    this.emit('memories', this.list());\n    void this.#connection.control.memoryRemove(id, BACKGROUND_CONTEXT).catch(() => {\n      this.#pending.delete(id);\n      this.emit('memories', this.list());\n    });\n  }\n}\n"],
+  "mappings": "AACA,SAAS,0BAA0B;AAEnC,SAA2B,UAAU,YAAY;AACjD,SAAS,eAAe;AAIjB,MAAM,sBAAsB,QAA4C;AAAA,EACpE;AAAA,EACT,WAAW,oBAAI,IAA0B;AAAA,EAEzC,YAAY,YAA6B;AACvC,UAAM;AACN,SAAK,cAAc;AACnB,eAAW,UAAU,UAAU,MAAM;AACnC,WAAK,SAAS,MAAM;AACpB,WAAK,KAAK,YAAY,KAAK,KAAK,CAAC;AAAA,IACnC,CAAC;AACD,eAAW,cAAc,UAAU,MAAM,KAAK,KAAK,YAAY,KAAK,KAAK,CAAC,CAAC;AAAA,EAC7E;AAAA,EAEA,OAA0B;AACxB,UAAM,SAAU,KAAK,YAAY,UAAU,SAAS,CAAC;AACrD,QAAI,CAAC,KAAK,SAAS,KAAM,QAAO;AAChC,UAAM,MAAM,OAAO,OAAO,CAAC,SAAS,CAAC,KAAK,SAAS,IAAI,KAAK,EAAE,CAAC;AAC/D,eAAW,QAAQ,KAAK,SAAS,OAAO,EAAG,KAAI,KAAM,KAAI,KAAK,IAAI;AAClE,WAAO;AAAA,EACT;AAAA,EAEA,SAAiC;AAC/B,WAAO,KAAK,YAAY,cAAc,SAAS,CAAC;AAAA,EAClD;AAAA,EAEA,KAAK,OAA4B;AAC/B,UAAM,SAAgB;AAAA,MACpB,GAAG;AAAA,MACH,IAAI,GAAG,MAAM,KAAK,IAAI,KAAK,MAAM,OAAO,CAAC,IAAI,KAAK,MAAM,KAAK,CAAC;AAAA,MAC9D,WAAW,KAAK,IAAI;AAAA,MACpB,QAAQ;AAAA,IACV;AACA,QAAI,MAAM,MAAM,MAAM,OAAO,OAAO,GAAI,MAAK,SAAS,IAAI,MAAM,IAAI,IAAI;AACxE,SAAK,SAAS,IAAI,OAAO,IAAI,MAAM;AACnC,SAAK,KAAK,YAAY,KAAK,KAAK,CAAC;AACjC,SAAK,KAAK,YAAY,QACnB;AAAA,MACC;AAAA,QACE,IAAI,MAAM,MAAM;AAAA,QAChB,OAAO,MAAM;AAAA,QACb,SAAS,MAAM;AAAA,QACf,OAAO,MAAM;AAAA,QACb,MAAM,MAAM;AAAA,QACZ,KAAK,MAAM;AAAA,MACb;AAAA,MACA;AAAA,IACF,EACC,MAAM,MAAM;AACX,WAAK,SAAS,MAAM;AACpB,WAAK,KAAK,YAAY,KAAK,KAAK,CAAC;AAAA,IACnC,CAAC;AACH,WAAO;AAAA,EACT;AAAA,EAEA,OAAO,IAAkB;AACvB,SAAK,SAAS,IAAI,IAAI,IAAI;AAC1B,SAAK,KAAK,YAAY,KAAK,KAAK,CAAC;AACjC,SAAK,KAAK,YAAY,QAAQ,aAAa,IAAI,kBAAkB,EAAE,MAAM,MAAM;AAC7E,WAAK,SAAS,OAAO,EAAE;AACvB,WAAK,KAAK,YAAY,KAAK,KAAK,CAAC;AAAA,IACnC,CAAC;AAAA,EACH;AACF;",
+  "names": []
+}

package/dist/types/agents.d.ts

@@ -1,5 +1,6 @@
 import type { Context } from '@earendil-works/chord';
 import { type Conversation, type Harness, type Tx } from '@earendil-works/pi-durable';
+import type { RoleMemory } from './memory/store.ts';
 export declare const FIRST_CONE = "cone";
 export type ConeRecord = {
     name: string;
@@ -16,6 +17,12 @@ export type ScoopRecord = {
     conversation: number;
     anchor: number;
     role: string | null;
+    memory?: RoleMemory;
+    origin?: string;
+    context?: {
+        project: boolean;
+        global: boolean;
+    };
     kind: 'async' | 'sync';
     parent: string;
     depth: number;

package/dist/types/client.d.ts

@@ -1,5 +1,6 @@
 import { type Context, type ReplicatedState } from '@earendil-works/chord';
 import type { ConversationView } from '@earendil-works/pi-durable';
+import type { MemoryEntry, MemoryScope } from './memory/format.ts';
 import { AgentControl, AgentSettings, type AgentsSummary, type Command, type Delivered, type SendMode } from './services.ts';
 import type { Sprinkle } from './sprinkles/kind.ts';
 import { type PortEndpoint } from './wire.ts';
@@ -12,6 +13,8 @@ export interface AgentConnection {
     readonly views?: ReplicatedState<Record<string, ConversationView>>;
     readonly commands?: ReplicatedState<Command[]>;
     readonly sprinkles?: ReplicatedState<Sprinkle[]>;
+    readonly memories?: ReplicatedState<MemoryEntry[]>;
+    readonly memoryScopes?: ReplicatedState<MemoryScope[]>;
     readonly settings: AgentSettings;
     prompt(text: string, whenBusy?: SendMode): Promise<string>;
     close(): Promise<void>;

package/dist/types/control.d.ts

@@ -2,6 +2,7 @@ import { type Conversation, type Harness, type SubmissionId } from '@earendil-wo
 import type { Cones } from './cone.ts';
 import type { Deliveries } from './deliveries.ts';
 import type { LickSources, Licks } from './licks/index.ts';
+import type { MemoryRuntime } from './memory/index.ts';
 import type { Scoops, ScoopsRuntime } from './scoops/index.ts';
 import type { AgentControl } from './services.ts';
 import type { SkillsRuntime } from './skills/index.ts';
@@ -16,4 +17,4 @@ export interface HostScoops {
 }
 export declare function readable(out: string): string;
 export declare function submissionId(value: string): SubmissionId | undefined;
-export declare function createAgentControl(harness: Harness, target: Conversation | Cones, deliveries?: Deliveries, licks?: HostLicks, scoops?: HostScoops, skills?: Pick<SkillsRuntime, 'expand'>, sprinkles?: Pick<SprinklesRuntime, 'send' | 'call'>): AgentControl;
+export declare function createAgentControl(harness: Harness, target: Conversation | Cones, deliveries?: Deliveries, licks?: HostLicks, scoops?: HostScoops, skills?: Pick<SkillsRuntime, 'expand'>, sprinkles?: Pick<SprinklesRuntime, 'send' | 'call'>, memory?: Pick<MemoryRuntime, 'save' | 'remove'>): AgentControl;

package/dist/types/host.d.ts

@@ -1,6 +1,7 @@
 import { type Context } from '@earendil-works/chord';
 import type { Agent } from './agent.ts';
 import { type HostLicks, type HostScoops } from './control.ts';
+import type { MemoryRuntime } from './memory/index.ts';
 import { AgentSettings } from './services.ts';
 import type { SkillsRuntime } from './skills/index.ts';
 import type { SprinklesRuntime } from './sprinkles/index.ts';
@@ -19,4 +20,5 @@ export declare function hostAgent(agent: Agent, options?: {
     scoops?: HostScoops;
     skills?: SkillsRuntime;
     sprinkles?: SprinklesRuntime;
+    memory?: MemoryRuntime;
 }): Promise<AgentHost>;

package/dist/types/memory/context.d.ts

@@ -0,0 +1,27 @@
+import type { Context } from '@earendil-works/chord';
+import type { ExecutionEnv } from '@earendil-works/pi-durable/env';
+export declare const CANDIDATES: string[];
+export declare const TRUSTED_ROOTS: string[];
+export declare const UNTRUSTED = "outside /home: mounted folders and other roots load once SLICC can trust a folder";
+export type ContextFile = {
+    path: string;
+    content: string;
+};
+export type Skipped = {
+    path: string;
+    reason: string;
+};
+export type ContextFiles = {
+    files: ContextFile[];
+    skipped: Skipped[];
+};
+type Files = Pick<ExecutionEnv, 'readTextFile' | 'canonicalPath'>;
+export declare function trusted(path: string): boolean;
+export declare function loadContextFiles(env: Files, options: {
+    cwd: string;
+    agentDir: string;
+    global?: boolean;
+    project?: boolean;
+}, context: Context): Promise<ContextFiles>;
+export declare function renderContextFiles({ files, skipped }: ContextFiles): string | undefined;
+export {};

package/dist/types/memory/format.d.ts

@@ -0,0 +1,67 @@
+export type MemoryTag = 'user' | 'feedback' | 'project';
+export interface MemoryEntry {
+    id: string;
+    scope: string;
+    section: string;
+    title: string;
+    body: string;
+    tag: MemoryTag | null;
+    updatedAt: number;
+    source: 'entry' | 'notes';
+}
+export interface MemoryScope {
+    id: string;
+    label: string;
+    group?: 'cones' | 'roles';
+}
+export type Entry = {
+    title: string;
+    tag: MemoryTag | null;
+    body: string;
+};
+export type Section = {
+    name: string;
+    intro: string;
+    entries: Entry[];
+};
+export type MemoryDoc = {
+    head: string;
+    sections: Section[];
+};
+export declare const MEMORY_FILE = "MEMORY.md";
+export declare const NOTES = "Notes";
+export declare const MAX_LINES = 200;
+export declare const MAX_BYTES: number;
+export declare function slugOf(text: string): string;
+export declare function parseMemory(text: string): MemoryDoc;
+export declare function serializeMemory(doc: MemoryDoc): string;
+export declare function memoryEntries(doc: MemoryDoc, scope: string, updatedAt: number): MemoryEntry[];
+export type Change = {
+    kind: 'save';
+    id?: string;
+    section: string;
+    title: string;
+    body: string;
+    tag: MemoryTag | null;
+} | {
+    kind: 'remove';
+    id?: string;
+    section?: string;
+    title?: string;
+};
+export declare function oneLine(text: string): string;
+export declare function demote(body: string): string;
+export declare function applyChange(doc: MemoryDoc, scope: string, change: Change): {
+    doc: MemoryDoc;
+    found: boolean;
+};
+export declare function excerpt(text: string): {
+    text: string;
+    capped: boolean;
+};
+export declare function byteLength(text: string): number;
+export declare const REDACTED = "[redacted]";
+export declare function redactSecrets(text: string): {
+    text: string;
+    count: number;
+};

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

@@ -0,0 +1,12 @@
+import type { Context } from '@earendil-works/chord';
+import { type Extension, type Registry, type ToolRegistration } from '@earendil-works/pi-durable';
+import { type MemoryAttach, type MemoryRuntime } from './runtime.ts';
+export { MEMORY_WRITE, whoIs } from './prompt.ts';
+export type { MemoryAttach, MemoryDraft, MemoryRuntime } from './runtime.ts';
+export { USAGE } from './runtime.ts';
+export interface MemorySetup {
+    extension: Extension;
+    tools: readonly ToolRegistration[];
+    attach(options: MemoryAttach, context: Context): Promise<MemoryRuntime>;
+}
+export declare function setupMemory(registry: Registry): MemorySetup;

package/dist/types/memory/prompt.d.ts

@@ -0,0 +1,48 @@
+import type { Context } from '@earendil-works/chord';
+import { Type } from '@earendil-works/pi-ai';
+import type { ExecutionEnv } from '@earendil-works/pi-durable/env';
+import type { Agents, AgentsState, ScoopRecord } from '../agents.ts';
+import { type MemoryFiles, type Place, type Written } from './store.ts';
+export declare const MEMORY_WRITE = "memory_write";
+export type Host = {
+    agents: Agents;
+    env: ExecutionEnv;
+    home: string;
+    files: MemoryFiles;
+    changed: (context: Context) => Promise<void>;
+};
+export type Who = {
+    kind: 'cone';
+    id: string;
+} | {
+    kind: 'scoop';
+    id: string;
+    record: ScoopRecord;
+} | {
+    kind: 'other';
+};
+type Problem = {
+    problem: string;
+};
+export declare function whoIs(state: Readonly<AgentsState>, conversation: number): Who;
+export declare function ownPlace(host: Host, who: Who, cwd: string, context: Context): Promise<Place | Problem>;
+export declare function contextSection(ready: Promise<Host>): import("@earendil-works/pi-durable").PromptSection<import("@earendil-works/pi-durable").ToolRegistration>;
+export declare function memorySection(ready: Promise<Host>): import("@earendil-works/pi-durable").PromptSection<import("@earendil-works/pi-durable").ToolRegistration>;
+type Args = {
+    section: string;
+    title: string;
+    body?: string;
+    tag?: 'user' | 'feedback' | 'project';
+    remove?: boolean;
+    scope?: 'own' | 'global';
+};
+export declare function writeAnswer(args: Args, place: Place, written: Written): string;
+export declare function memoryWriteTool(ready: Promise<Host>): import("@earendil-works/pi-durable").ToolRegistration<Type.TObject<{
+    section: Type.TString;
+    title: Type.TString;
+    body: Type.TOptional<Type.TString>;
+    tag: Type.TOptional<Type.TUnion<[Type.TLiteral<"user">, Type.TLiteral<"feedback">, Type.TLiteral<"project">]>>;
+    remove: Type.TOptional<Type.TBoolean>;
+    scope: Type.TOptional<Type.TUnion<[Type.TLiteral<"own">, Type.TLiteral<"global">]>>;
+}>, import("@earendil-works/chord").JsonValue>;
+export {};

package/dist/types/memory/runtime.d.ts

@@ -0,0 +1,45 @@
+import { type Context, type ReplicatedState } from '@earendil-works/chord';
+import type { ExecutionEnv } from '@earendil-works/pi-durable/env';
+import type { Agents } from '../agents.ts';
+import type { Role } from '../roles/roles.ts';
+import { type MemoryEntry, type MemoryScope, type MemoryTag } from './format.ts';
+import type { Host } from './prompt.ts';
+import { type Place } from './store.ts';
+export type Answer = {
+    code: number;
+    out: string;
+};
+export interface MemoryDraft {
+    id?: string;
+    scope: string;
+    section: string;
+    title: string;
+    body: string;
+    tag: MemoryTag | null;
+}
+export interface MemoryRuntime {
+    readonly memories: ReplicatedState<MemoryEntry[]>;
+    readonly scopes: ReplicatedState<MemoryScope[]>;
+    save(draft: MemoryDraft, context: Context): Promise<MemoryEntry>;
+    remove(id: string, context: Context): Promise<boolean>;
+    command(argv: readonly string[], caller: string | null, context: Context): Promise<Answer>;
+    reload(context: Context): Promise<void>;
+    close(context: Context): Promise<void>;
+}
+export interface MemoryAttach {
+    agents: Agents;
+    env: ExecutionEnv;
+    home: string;
+    reloadMs: number;
+    roles?: (context: Context) => Promise<{
+        roles: readonly Role[];
+    } | undefined>;
+}
+export declare 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";
+type Listed = Place & {
+    group?: 'cones' | 'roles';
+    name: string;
+};
+export declare function listPlaces(options: MemoryAttach, context: Context): Promise<Listed[]>;
+export declare function attachMemory(options: MemoryAttach, connect: (host: Host) => void, context: Context): Promise<MemoryRuntime>;
+export {};