agents-handoff 2.0.2 → 2.0.3

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 (38) hide show
  1. package/CHANGELOG.md +48 -6
  2. package/README.md +53 -13
  3. package/SKILL.md +12 -12
  4. package/capability-registry.json +1 -1
  5. package/docs/ARCHITECTURE.md +28 -5
  6. package/docs/CHANGELOG.md +62 -17
  7. package/docs/CLI.md +115 -12
  8. package/docs/CONTRIBUTING.md +2 -2
  9. package/docs/FORMAT.md +28 -0
  10. package/docs/INSTALL.md +239 -24
  11. package/docs/INTEGRATION.md +4 -4
  12. package/docs/LEVEL4.md +10 -10
  13. package/docs/LEVEL5.md +1 -1
  14. package/docs/PERMISSIONS.md +2 -2
  15. package/docs/PROVENANCE.md +27 -0
  16. package/docs/SECURITY.md +1 -1
  17. package/docs/SESSIONS.md +31 -0
  18. package/docs/UNINSTALL.md +47 -21
  19. package/docs/UPGRADE.md +59 -21
  20. package/docs/_config.yml +3 -1
  21. package/docs/index.md +15 -6
  22. package/docs/sessions.json +34 -0
  23. package/install/CHANGELOG.md +1 -1
  24. package/install/README.md +7 -7
  25. package/install/install.mjs +746 -147
  26. package/install/package.json +2 -2
  27. package/package.json +2 -2
  28. package/permission-policy.json +1 -1
  29. package/refs/protocol.md +1 -1
  30. package/schemas/handoff.schema.json +1 -1
  31. package/skill.json +11 -11
  32. package/tests/acceptance/acceptance.yaml +2 -2
  33. package/tools/agent-handoff.mjs +16 -404
  34. package/tools/agents-handoff.mjs +410 -0
  35. package/tools/capability-registry.mjs +2 -2
  36. package/tools/handoff.test.mjs +203 -0
  37. package/tools/lib/handoff-root.mjs +1 -1
  38. package/tools/runtime-engine.mjs +2 -2
package/tools/runtime-engine.mjs CHANGED
@@ -21,7 +21,7 @@
21
21
  // 137 simulated abrupt kill (job --fail-at); otherwise the child's captured exit
22
22
  // code (bounded execution).
23
23
  // Checkpoints (Task 6): after EACH bounded step of a job a durable checkpoint is
24
- // written to .agent-handoff/checkpoints/<session>.json with a sha256 integrity
24
+ // written to .agents-handoff/checkpoints/<session>.json with a sha256 integrity
25
25
  // seal. Resume reconstructs state from disk ONLY — zero shared memory. A missing
26
26
  // checkpoint fails honestly (exit 4, never guessed); a tampered checkpoint fails
27
27
  // the integrity seal (exit 5). Abrupt termination is simulated by process.exit(137)
@@ -37,7 +37,7 @@ const DEFAULT_POLICY = path.join(REPO, 'permission-policy.json');
37
37
  // nothing. Env: AGENT_HANDOFF_STATE_DIR=<dir>
38
38
  const STATE_DIR = process.env.AGENT_HANDOFF_STATE_DIR
39
39
  ? path.resolve(process.env.AGENT_HANDOFF_STATE_DIR)
40
- : path.join(REPO, '.agent-handoff');
40
+ : path.join(REPO, '.agents-handoff');
41
41
  const EXEC_DIR = path.join(STATE_DIR, 'executions');
42
42
  const CKPT_DIR = path.join(STATE_DIR, 'checkpoints');
43
43
  const JOBS_DIR = path.join(STATE_DIR, 'jobs');