@agentpro/scroll 0.0.0-stage → 2.5.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (61) hide show
  1. package/AGENTS.md +55 -0
  2. package/LICENSE +21 -0
  3. package/README.md +293 -2
  4. package/SPEC.md +1079 -0
  5. package/bin/scroll.js +8 -0
  6. package/docs/prompt-caching.md +128 -0
  7. package/index.js +33 -0
  8. package/lib/audit.js +358 -0
  9. package/lib/auth.js +849 -0
  10. package/lib/chat-sdk/admin-controller.js +289 -0
  11. package/lib/chat-sdk/debouncer.js +94 -0
  12. package/lib/chat-sdk/group-grants.js +150 -0
  13. package/lib/chat-sdk/index.js +222 -0
  14. package/lib/chat-sdk/long-task-runner.js +413 -0
  15. package/lib/chat-session.js +1788 -0
  16. package/lib/chat-telemetry.js +557 -0
  17. package/lib/codex-app-server.js +851 -0
  18. package/lib/digest.js +112 -0
  19. package/lib/effects.js +157 -0
  20. package/lib/eval.js +408 -0
  21. package/lib/grounding.js +356 -0
  22. package/lib/installers.js +176 -0
  23. package/lib/knowledge.js +335 -0
  24. package/lib/ledger.js +38 -0
  25. package/lib/loop.js +197 -0
  26. package/lib/mcp-client.js +926 -0
  27. package/lib/memory-cli.js +66 -0
  28. package/lib/memory-tracker.js +1472 -0
  29. package/lib/memory.js +1279 -0
  30. package/lib/people-cli.js +81 -0
  31. package/lib/people.js +534 -0
  32. package/lib/permissions.js +272 -0
  33. package/lib/providers.js +1572 -0
  34. package/lib/runtime.js +928 -0
  35. package/lib/sandbox.js +744 -0
  36. package/lib/scheduler.js +402 -0
  37. package/lib/scroll.js +1225 -0
  38. package/lib/skill-cli.js +120 -0
  39. package/lib/skill-eval.js +156 -0
  40. package/lib/skills.js +860 -0
  41. package/lib/style.js +126 -0
  42. package/lib/tool-retriever.js +489 -0
  43. package/lib/tools.js +1833 -0
  44. package/lib/user.js +711 -0
  45. package/lib/vault.js +151 -0
  46. package/package.json +88 -4
  47. package/templates/agent/IDENTITY.md +56 -0
  48. package/templates/agent/SOUL.md +23 -0
  49. package/templates/agent/TOOLS.md +25 -0
  50. package/templates/agent/evals/case-02-citation-discipline.md +29 -0
  51. package/templates/agent/evals/case-03-boundary.md +27 -0
  52. package/templates/agent/evals/case-example.md +43 -0
  53. package/templates/agent/hard-rules.md +11 -0
  54. package/templates/agent/memory/lessons.md +5 -0
  55. package/templates/agent/memory/log/.gitkeep +0 -0
  56. package/templates/external-safety-contract.md +5 -0
  57. package/templates/long-task-planner.md +17 -0
  58. package/templates/work/LOOP.md +37 -0
  59. package/templates/work/WORK.md +50 -0
  60. package/types/chat.d.ts +61 -0
  61. package/types/index.d.ts +112 -0
@@ -0,0 +1,66 @@
1
+ // SCROLL — `scroll memory …`: operate a subject-memory store from the shell (spec v1.7 §31-§33).
2
+ // Every command goes through lib/memory.js — the CLI never touches store files directly, so the
3
+ // gate, the locks, the read-back, and the access trace apply to humans exactly as to agents.
4
+ import { openStore } from './memory.js';
5
+
6
+ const USAGE = `usage: scroll memory <command> --store <dir> [--region r] [--policy file.json|POLICY.md] [--json]
7
+ new [--kind person|group|agent|project] [--label text] create a subject → prints its sid
8
+ link <alias> <sid> · unlink <alias> · resolve <alias> channel identities (telegram:…, email, phone, device:…)
9
+ show <sid|alias> index + active facts (sensitive values masked)
10
+ snapshot <sid|alias> [--caps a,b] [--topics ns,ns] [--persona p] the frozen load contract
11
+ search <sid|alias> "<query>" [--scope facts|sessions|cards|days|all] [--limit n] [--reader who]
12
+ forget <sid|alias> <factId…> tombstone + cascade + redaction
13
+ review <sid|alias> [--accept id | --reject id] machine writes waiting for a human
14
+ member <group> <person> [--read ns,ns] [--write ns,ns] [--remove]
15
+ consolidate <sid|alias> · fsck <sid|alias> [--repair] · replay <sid|alias>
16
+ erase <sid|alias> --approve destructive: subject + every alias`;
17
+
18
+ const list = (v) => (typeof v === 'string' ? v.split(',').map((x) => x.trim()).filter(Boolean) : []);
19
+
20
+ export function memoryCli(a, env = {}) {
21
+ const [cmd, ...args] = a._;
22
+ if (!cmd || cmd === 'help') return USAGE;
23
+ const root = typeof a.store === 'string' ? a.store : env.SCROLL_MEMORY_STORE;
24
+ if (!root) throw new Error('memory store required: --store <dir> or SCROLL_MEMORY_STORE');
25
+ const m = openStore({ root, region: typeof a.region === 'string' ? a.region : (env.SCROLL_MEMORY_REGION || 'local'),
26
+ policy: typeof a.policy === 'string' ? a.policy : (env.SCROLL_MEMORY_POLICY || undefined) });
27
+ const sidOf = (x) => {
28
+ if (!x) throw new Error(USAGE);
29
+ const sid = /^s_[a-z0-9]+_[0-9a-f]{16}$/.test(x) ? x : m.resolve(x);
30
+ if (!sid || !m.exists(sid)) throw new Error(`unknown subject: ${x}`);
31
+ return sid;
32
+ };
33
+ switch (cmd) {
34
+ case 'new': return { ok: true, sid: m.createSubject({ kind: typeof a.kind === 'string' ? a.kind : 'person', label: typeof a.label === 'string' ? a.label : null }) };
35
+ case 'link': return m.link(args[0], sidOf(args[1]));
36
+ case 'unlink': return m.unlink(args[0]);
37
+ case 'resolve': { const sid = m.resolve(args[0]); return sid ? { ok: true, sid } : { ok: false, reason: 'not_found' }; }
38
+ case 'show': {
39
+ const sid = sidOf(args[0]); const st = m.state(sid);
40
+ const facts = st.facts.map((f) => `- ${f.id} ${f.key}${f.about !== 'self' ? ` [${f.about}]` : ''}: ${f.sensitivity === 'sensitive' ? '(sensitive)' : f.value} (${f.provenance}${f.pinned ? ', pinned' : ''})`);
41
+ return a.json ? { ok: true, meta: m.meta(sid), facts: st.facts.map((f) => ({ ...f, value: f.sensitivity === 'sensitive' ? undefined : f.value })), memberships: st.memberships, review: m.listReview(sid).length }
42
+ : [`subject ${m.hmac(sid)} (${m.meta(sid).kind})`, ...facts, `${st.history.length} superseded/expired · ${m.listSessions(sid).length} sessions · ${m.listReview(sid).length} awaiting review`].join('\n');
43
+ }
44
+ case 'snapshot': { const s = m.snapshot(sidOf(args[0]), { capabilities: list(a.caps), topics: a.topics ? list(a.topics) : null, persona: typeof a.persona === 'string' ? a.persona : null }); return a.json ? s : (s.denied ? `denied: ${s.denied}` : s.text); }
45
+ case 'search': {
46
+ const r = m.search(sidOf(args[0]), { query: args.slice(1).join(' '), scope: typeof a.scope === 'string' ? a.scope : 'all', limit: a.limit ? Number(a.limit) : 8, reader: typeof a.reader === 'string' ? a.reader : 'cli' });
47
+ return a.json ? r : (r.hits.map((h) => `${h.ref} ${h.ts.slice(0, 16)} ${h.status ? `[${h.status}] ` : ''}${h.sensitive ? '[sensitive] ' : ''}${h.text.replace(/\s+/g, ' ')}`).join('\n') || 'no hits');
48
+ }
49
+ case 'forget': return m.forget(sidOf(args[0]), args.slice(1), { by: 'cli' });
50
+ case 'review': {
51
+ const sid = sidOf(args[0]);
52
+ if (typeof a.accept === 'string') return m.resolveReview(sid, a.accept, 'accept', { by: 'cli' });
53
+ if (typeof a.reject === 'string') return m.resolveReview(sid, a.reject, 'reject', { by: 'cli' });
54
+ return { ok: true, items: m.listReview(sid) };
55
+ }
56
+ case 'member': {
57
+ const g = sidOf(args[0]), p = sidOf(args[1]);
58
+ return a.remove ? m.removeMember(g, p) : m.addMember(g, p, { read: a.read ? list(a.read) : ['*'], write: list(a.write) });
59
+ }
60
+ case 'consolidate': return { ok: true, ...m.consolidate(sidOf(args[0])) };
61
+ case 'fsck': return m.fsck(sidOf(args[0]), { repair: !!a.repair });
62
+ case 'replay': { const sid = sidOf(args[0]); const h1 = m.replayHash(sid); const h2 = m.replayHash(sid); return { ok: h1 === h2, hash: h1 }; }
63
+ case 'erase': return m.erase(sidOf(args[0]), [], { approved: !!a.approve });
64
+ default: throw new Error(`unknown memory command "${cmd}"\n${USAGE}`);
65
+ }
66
+ }