@farmslot/agent-runtime 0.48.1 → 0.48.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 (62) hide show
  1. package/CHANGELOG.md +19 -0
  2. package/dist/task-init/required-skills.js +1 -1
  3. package/dist/task-init/required-skills.js.map +1 -1
  4. package/dist/task-init/task-document.d.ts +13 -0
  5. package/dist/task-init/task-document.d.ts.map +1 -1
  6. package/dist/task-init/task-document.js +20 -2
  7. package/dist/task-init/task-document.js.map +1 -1
  8. package/dist/task-init/write.d.ts.map +1 -1
  9. package/dist/task-init/write.js +12 -2
  10. package/dist/task-init/write.js.map +1 -1
  11. package/dist/tool-usage/adapters/claude.d.ts +3 -0
  12. package/dist/tool-usage/adapters/claude.d.ts.map +1 -0
  13. package/dist/tool-usage/adapters/claude.js +56 -0
  14. package/dist/tool-usage/adapters/claude.js.map +1 -0
  15. package/dist/tool-usage/adapters/codex.d.ts +3 -0
  16. package/dist/tool-usage/adapters/codex.d.ts.map +1 -0
  17. package/dist/tool-usage/adapters/codex.js +81 -0
  18. package/dist/tool-usage/adapters/codex.js.map +1 -0
  19. package/dist/tool-usage/adapters/cursor.d.ts +3 -0
  20. package/dist/tool-usage/adapters/cursor.d.ts.map +1 -0
  21. package/dist/tool-usage/adapters/cursor.js +47 -0
  22. package/dist/tool-usage/adapters/cursor.js.map +1 -0
  23. package/dist/tool-usage/adapters/grok.d.ts +3 -0
  24. package/dist/tool-usage/adapters/grok.d.ts.map +1 -0
  25. package/dist/tool-usage/adapters/grok.js +55 -0
  26. package/dist/tool-usage/adapters/grok.js.map +1 -0
  27. package/dist/tool-usage/adapters/jsonl.d.ts +9 -0
  28. package/dist/tool-usage/adapters/jsonl.d.ts.map +1 -0
  29. package/dist/tool-usage/adapters/jsonl.js +40 -0
  30. package/dist/tool-usage/adapters/jsonl.js.map +1 -0
  31. package/dist/tool-usage/adapters/native.d.ts +3 -0
  32. package/dist/tool-usage/adapters/native.d.ts.map +1 -0
  33. package/dist/tool-usage/adapters/native.js +31 -0
  34. package/dist/tool-usage/adapters/native.js.map +1 -0
  35. package/dist/tool-usage/adapters/pi.d.ts +3 -0
  36. package/dist/tool-usage/adapters/pi.d.ts.map +1 -0
  37. package/dist/tool-usage/adapters/pi.js +46 -0
  38. package/dist/tool-usage/adapters/pi.js.map +1 -0
  39. package/dist/tool-usage/count.d.ts +13 -0
  40. package/dist/tool-usage/count.d.ts.map +1 -0
  41. package/dist/tool-usage/count.js +160 -0
  42. package/dist/tool-usage/count.js.map +1 -0
  43. package/dist/tool-usage/index.d.ts +19 -0
  44. package/dist/tool-usage/index.d.ts.map +1 -0
  45. package/dist/tool-usage/index.js +32 -0
  46. package/dist/tool-usage/index.js.map +1 -0
  47. package/dist/tool-usage/ledger.d.ts +11 -0
  48. package/dist/tool-usage/ledger.d.ts.map +1 -0
  49. package/dist/tool-usage/ledger.js +29 -0
  50. package/dist/tool-usage/ledger.js.map +1 -0
  51. package/dist/tool-usage/stream.d.ts +32 -0
  52. package/dist/tool-usage/stream.d.ts.map +1 -0
  53. package/dist/tool-usage/stream.js +17 -0
  54. package/dist/tool-usage/stream.js.map +1 -0
  55. package/package.json +10 -4
  56. package/scripts/check-task-artifact-contract.mjs +36 -0
  57. package/scripts/checklist-order.cjs +165 -0
  58. package/scripts/checklist-target.cjs +20 -0
  59. package/scripts/mark-checklist-step.cjs +294 -23
  60. package/scripts/proof-artifacts.cjs +258 -0
  61. package/scripts/subtask-unit.cjs +22 -1
  62. package/scripts/worker-terminal-contract.cjs +4 -6
@@ -5,6 +5,7 @@ const { isDeepStrictEqual } = require('node:util');
5
5
  const { ACCEPTANCE_REGISTRATION_INPUT } = require('@farmslot/protocol/scripts/acceptance.mjs');
6
6
  const { literalReplacement } = require('@farmslot/protocol/scripts/literal-replacement.mjs');
7
7
  const { pendingInitialAcceptanceDerivation } = require('./acceptance-ledger.cjs');
8
+ const checklistOrder = require('./checklist-order.cjs');
8
9
 
9
10
  const {
10
11
  checklistNumberingMismatches,
@@ -15,6 +16,7 @@ const {
15
16
  SUBTASK_ID_PATTERN,
16
17
  SUBTASK_INDEX_FILE,
17
18
  SUBTASKS_DIR,
19
+ readFrozenTerminalContract,
18
20
  subtaskPaths,
19
21
  targetForChecklistBasename,
20
22
  } = require('./checklist-target.cjs');
@@ -41,6 +43,7 @@ const {
41
43
  // never changes the run's active task file.
42
44
 
43
45
  const HANDOFF_INPUT = path.join('inputs', 'handoff.json');
46
+
44
47
  const SUBTASK_INDEX_REL = `${SUBTASKS_DIR}/${SUBTASK_INDEX_FILE}`;
45
48
 
46
49
  /** A refused command: the message is worker-facing, the code is the exit code. */
@@ -462,7 +465,6 @@ function subStart(taskDir, rest) {
462
465
  if (!parentRow) {
463
466
  throw new SubtaskRefusal(`checklist step ${stepNumber} not found in ${target.checklist}`);
464
467
  }
465
-
466
468
  const index = readSubtaskIndex(taskDir) ?? { schemaVersion: 1, units: [] };
467
469
  // One child per step for the LIFE of the task directory: a settled child has
468
470
  // already ticked the box, so a second registration would reopen finished work.
@@ -481,6 +483,25 @@ function subStart(taskDir, rest) {
481
483
  );
482
484
  }
483
485
 
486
+ // Registering a child on a step claims the work has reached it, and the child's
487
+ // own completion ticks that box. Order is therefore enforced here rather than at
488
+ // the child's tick (ADR-064 Amendment 7).
489
+ if (!parentRow.checked) {
490
+ const earlier = checklistOrder.firstUnmarkedEarlierStep(parent.items, stepNumber);
491
+ if (earlier) {
492
+ const when = checklistOrder
493
+ .declared(taskDir, target.checklist, readFrozenTerminalContract(taskDir, target.checklist))
494
+ .get(earlier.stepNumber);
495
+ throw new SubtaskRefusal(
496
+ `step ${stepNumber} cannot take a child while step ${earlier.stepNumber} ` +
497
+ `(${earlier.label}) is unchecked. ` +
498
+ (when
499
+ ? `That step is optional (${when}); skip it with ./mark ${earlier.stepNumber} --skip "<reason>"`
500
+ : 'Do that step first.'),
501
+ );
502
+ }
503
+ }
504
+
484
505
  const source = readSubtaskSource(flags.from, taskDir);
485
506
  const body = stripMarkdownFrontmatter(source.text);
486
507
  const label = `Subtask ${id} source ${source.ref ?? '(inline)'}`;
@@ -4,8 +4,8 @@ const { createHash, randomUUID } = require('node:crypto');
4
4
  const { spawnSync } = require('node:child_process');
5
5
  const {
6
6
  enumerateChecklistCheckboxes,
7
- terminalContractInputForChecklist,
8
7
  resolveChecklistTarget,
8
+ readFrozenTerminalContract,
9
9
  } = require('./checklist-target.cjs');
10
10
  const { atomicWrite } = require('./mark-io.cjs');
11
11
 
@@ -518,11 +518,9 @@ function readOptionalJson(file) {
518
518
  }
519
519
 
520
520
  function deterministicContract(taskDir, checklist) {
521
- return (
522
- readOptionalJson(path.join(taskDir, terminalContractInputForChecklist(checklist))) ??
523
- readOptionalJson(path.join(taskDir, 'inputs', 'worker-terminal-contract.json')) ??
524
- {}
525
- );
521
+ // One reader for the frozen contract, shared with the mark engine and the
522
+ // order checks so their idea of "this checklist's contract" cannot drift.
523
+ return readFrozenTerminalContract(taskDir, checklist) ?? {};
526
524
  }
527
525
 
528
526
  function recordedDeterministicSteps(taskDir, checklist) {