strands-darwin 0.0.36 → 0.0.39

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 (102) hide show
  1. package/README.md +19 -4
  2. package/README.zh-CN.md +14 -4
  3. package/dist/patches/{@strands-agents+sdk+1.16.0.patch → @strands-agents+sdk+1.18.0.patch} +320 -9
  4. package/dist/src/agent/compact.js +1 -1
  5. package/dist/src/agent/permission-rules.js +1 -1
  6. package/dist/src/agent/permission-rules.js.map +1 -1
  7. package/dist/src/agent/permission.d.ts +4 -1
  8. package/dist/src/agent/permission.js +21 -4
  9. package/dist/src/agent/permission.js.map +1 -1
  10. package/dist/src/agent/runtime.d.ts +23 -12
  11. package/dist/src/agent/runtime.js +72 -16
  12. package/dist/src/agent/runtime.js.map +1 -1
  13. package/dist/src/agent/session-lease.d.ts +31 -0
  14. package/dist/src/agent/session-lease.js +42 -0
  15. package/dist/src/agent/session-lease.js.map +1 -0
  16. package/dist/src/agent/session.d.ts +2 -47
  17. package/dist/src/agent/session.js +3 -50
  18. package/dist/src/agent/session.js.map +1 -1
  19. package/dist/src/agent/system-prompt.d.ts +1 -1
  20. package/dist/src/agent/system-prompt.js +12 -0
  21. package/dist/src/agent/system-prompt.js.map +1 -1
  22. package/dist/src/agent/task-terminal-delivery.d.ts +25 -2
  23. package/dist/src/agent/task-terminal-delivery.js +80 -7
  24. package/dist/src/agent/task-terminal-delivery.js.map +1 -1
  25. package/dist/src/cli-list-agents.d.ts +1 -0
  26. package/dist/src/cli-list-agents.js +12 -0
  27. package/dist/src/cli-list-agents.js.map +1 -0
  28. package/dist/src/cli-usage.d.ts +1 -1
  29. package/dist/src/cli-usage.js +5 -0
  30. package/dist/src/cli-usage.js.map +1 -1
  31. package/dist/src/cli.js +9 -1
  32. package/dist/src/cli.js.map +1 -1
  33. package/dist/src/collaboration/command.d.ts +5 -0
  34. package/dist/src/collaboration/command.js +72 -0
  35. package/dist/src/collaboration/command.js.map +1 -0
  36. package/dist/src/collaboration/grammar.d.ts +3 -0
  37. package/dist/src/collaboration/grammar.js +8 -0
  38. package/dist/src/collaboration/grammar.js.map +1 -0
  39. package/dist/src/collaboration/local.d.ts +61 -0
  40. package/dist/src/collaboration/local.js +407 -0
  41. package/dist/src/collaboration/local.js.map +1 -0
  42. package/dist/src/collaboration/protocol.d.ts +66 -0
  43. package/dist/src/collaboration/protocol.js +28 -0
  44. package/dist/src/collaboration/protocol.js.map +1 -0
  45. package/dist/src/collaboration/storage.d.ts +36 -0
  46. package/dist/src/collaboration/storage.js +241 -0
  47. package/dist/src/collaboration/storage.js.map +1 -0
  48. package/dist/src/collaboration/tools.d.ts +5 -0
  49. package/dist/src/collaboration/tools.js +11 -0
  50. package/dist/src/collaboration/tools.js.map +1 -0
  51. package/dist/src/commands/custom-commands.d.ts +1 -1
  52. package/dist/src/commands/custom-commands.js +3 -1
  53. package/dist/src/commands/custom-commands.js.map +1 -1
  54. package/dist/src/commands/review-command.d.ts +8 -3
  55. package/dist/src/commands/review-command.js +17 -3
  56. package/dist/src/commands/review-command.js.map +1 -1
  57. package/dist/src/dev-repl.js +8 -1
  58. package/dist/src/dev-repl.js.map +1 -1
  59. package/dist/src/headless-protocol.d.ts +6 -2
  60. package/dist/src/headless-protocol.js +32 -8
  61. package/dist/src/headless-protocol.js.map +1 -1
  62. package/dist/src/headless-runner.js +45 -1
  63. package/dist/src/headless-runner.js.map +1 -1
  64. package/dist/src/headless.d.ts +2 -1
  65. package/dist/src/headless.js +5 -5
  66. package/dist/src/headless.js.map +1 -1
  67. package/dist/src/list-agents.d.ts +21 -0
  68. package/dist/src/list-agents.js +219 -0
  69. package/dist/src/list-agents.js.map +1 -0
  70. package/dist/src/npm-package/patch-package-format.d.ts +5 -5
  71. package/dist/src/npm-package/patch-package-format.js +4 -4
  72. package/dist/src/paths.d.ts +5 -0
  73. package/dist/src/paths.js +14 -2
  74. package/dist/src/paths.js.map +1 -1
  75. package/dist/src/sdk-patch-preflight.js +1 -1
  76. package/dist/src/skills/builtin/developer/SKILL.md +2 -0
  77. package/dist/src/skills/builtin/self-reflection/references/reflection-template.md +2 -1
  78. package/dist/src/tools/background-bash.d.ts +7 -1
  79. package/dist/src/tools/background-bash.js +10 -8
  80. package/dist/src/tools/background-bash.js.map +1 -1
  81. package/dist/src/trajectory/record.d.ts +56 -3
  82. package/dist/src/trajectory/record.js +35 -0
  83. package/dist/src/trajectory/record.js.map +1 -1
  84. package/dist/src/trajectory/replay.d.ts +12 -1
  85. package/dist/src/trajectory/replay.js +44 -2
  86. package/dist/src/trajectory/replay.js.map +1 -1
  87. package/dist/src/trajectory/rewind-history.js +1 -1
  88. package/dist/src/trajectory/rewind-history.js.map +1 -1
  89. package/dist/src/trajectory/writer.d.ts +17 -3
  90. package/dist/src/trajectory/writer.js +42 -0
  91. package/dist/src/trajectory/writer.js.map +1 -1
  92. package/dist/src/tui/App.js +83 -1
  93. package/dist/src/tui/App.js.map +1 -1
  94. package/dist/src/tui/InputBox.d.ts +1 -1
  95. package/dist/src/tui/InputBox.js +3 -2
  96. package/dist/src/tui/InputBox.js.map +1 -1
  97. package/dist/src/tui/help-format.d.ts +2 -2
  98. package/dist/src/tui/help-format.js +4 -3
  99. package/dist/src/tui/help-format.js.map +1 -1
  100. package/dist/src/tui/prompt-editor.js +19 -9
  101. package/dist/src/tui/prompt-editor.js.map +1 -1
  102. package/package.json +3 -3
@@ -56,9 +56,21 @@ you could read yourself.
56
56
  whole-document tool-call payload can exceed what the provider stream completes.
57
57
  4. Verify your work by running something: the project's typecheck, its tests, or a command that
58
58
  exercises the change. If verification is impossible, say so instead of implying success.
59
+ When a reply reports material numbers, compute sums and other summaries with an available
60
+ local tool rather than mentally, and reconcile the components against the authoritative total,
61
+ units and time window. Keep requested apart from executed quantities and observed apart from
62
+ estimated or counterfactual values; state missing evidence or an unexplained residual instead
63
+ of claiming the figures reconcile.
59
64
  5. After a tool fails twice with the same cause, state a materially new evidence-backed hypothesis
60
65
  before retrying. Three equivalent failures are the limit: stop, report the blocker and collected
61
66
  artifacts, and ask the user before continuing in a new turn.
67
+ Code you write to run unattended with side effects needs the same bounds: after a bounded
68
+ number of identical deterministic rejections, pause that action with its reason stated until
69
+ inputs or observed state change; retry transient limits a bounded number of times with backoff,
70
+ honouring any server-directed delay; when a state-changing request's outcome is ambiguous (a
71
+ timeout, say), reconcile the actual state or use an idempotency key before replaying it. When
72
+ feasible, check such a script against representative offline response sequences before an
73
+ unattended launch.
62
74
  6. Do not add dependencies, delete data, or rewrite git history unless asked.
63
75
  7. Batch independent reads: when several tool calls have no dependency between them — searches,
64
76
  file views, status checks — issue them together in one assistant message instead of one call
@@ -1 +1 @@
1
- {"version":3,"file":"system-prompt.js","sourceRoot":"","sources":["../../../src/agent/system-prompt.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAExC,gDAAgD;AAChD,MAAM,CAAC,MAAM,sBAAsB,GAAG,kBAAkB,CAAC;AAEzD;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;8EA+DyC,CAAC;AAE/E;;;;;GAKG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG;;;;;;;;;2BASd,CAAC;AAkB5B;;;;;;;;;;GAUG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,WAAmB,EACnB,gBAAyB;IAEzB,IAAI,gBAAgB,KAAK,SAAS,EAAE,CAAC;QACnC,OAAO,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC;IAC7F,CAAC;IAED,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC,EAAE,sBAAsB,CAAC,CAAC;IAE3E,IAAI,IAAY,CAAC;IACjB,IAAI,CAAC;QACH,IAAI,GAAG,MAAM,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IAC1C,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO;YACL,MAAM,EAAE,qBAAqB;YAC7B,MAAM,EAAE,SAAS;YACjB,IAAI,EAAE,SAAS;YACf,6EAA6E;YAC7E,OAAO,EAAE,aAAa,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC;SAC5D,CAAC;IACJ,CAAC;IAED,4EAA4E;IAC5E,2EAA2E;IAC3E,IAAI,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;QACvB,OAAO;YACL,MAAM,EAAE,qBAAqB;YAC7B,MAAM,EAAE,SAAS;YACjB,IAAI,EAAE,SAAS;YACf,OAAO,EAAE,GAAG,QAAQ,sCAAsC;SAC3D,CAAC;IACJ,CAAC;IAED,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,OAAO,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC;AACxF,CAAC;AAED,wFAAwF;AACxF,SAAS,aAAa,CAAC,KAAc;IACnC,MAAM,IAAI,GACR,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,CAAC,CAAC,CAAE,KAA2B,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC;IAC9F,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,SAAS,CAAC;AACjD,CAAC;AAED,SAAS,QAAQ,CAAC,KAAc;IAC9B,OAAO,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAChE,CAAC"}
1
+ {"version":3,"file":"system-prompt.js","sourceRoot":"","sources":["../../../src/agent/system-prompt.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAExC,gDAAgD;AAChD,MAAM,CAAC,MAAM,sBAAsB,GAAG,kBAAkB,CAAC;AAEzD;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;8EA2EyC,CAAC;AAE/E;;;;;GAKG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG;;;;;;;;;2BASd,CAAC;AAkB5B;;;;;;;;;;GAUG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,WAAmB,EACnB,gBAAyB;IAEzB,IAAI,gBAAgB,KAAK,SAAS,EAAE,CAAC;QACnC,OAAO,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC;IAC7F,CAAC;IAED,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC,EAAE,sBAAsB,CAAC,CAAC;IAE3E,IAAI,IAAY,CAAC;IACjB,IAAI,CAAC;QACH,IAAI,GAAG,MAAM,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IAC1C,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO;YACL,MAAM,EAAE,qBAAqB;YAC7B,MAAM,EAAE,SAAS;YACjB,IAAI,EAAE,SAAS;YACf,6EAA6E;YAC7E,OAAO,EAAE,aAAa,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC;SAC5D,CAAC;IACJ,CAAC;IAED,4EAA4E;IAC5E,2EAA2E;IAC3E,IAAI,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;QACvB,OAAO;YACL,MAAM,EAAE,qBAAqB;YAC7B,MAAM,EAAE,SAAS;YACjB,IAAI,EAAE,SAAS;YACf,OAAO,EAAE,GAAG,QAAQ,sCAAsC;SAC3D,CAAC;IACJ,CAAC;IAED,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,OAAO,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC;AACxF,CAAC;AAED,wFAAwF;AACxF,SAAS,aAAa,CAAC,KAAc;IACnC,MAAM,IAAI,GACR,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,CAAC,CAAC,CAAE,KAA2B,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC;IAC9F,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,SAAS,CAAC;AACjD,CAAC;AAED,SAAS,QAAQ,CAAC,KAAc;IAC9B,OAAO,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAChE,CAAC"}
@@ -15,12 +15,25 @@
15
15
  * (`endTurn`) commits them, because a cancelled turn's tool result may never have
16
16
  * been reasoned about. `observe` cannot throw — observer discipline: a ledger
17
17
  * failure costs a possible duplicate wake, never a turn.
18
+ *
19
+ * SRF-036: the SDK `ContextOffloader` replaces an oversized result at default hook
20
+ * order with an `[Offloaded: …]` text preview, so the stream carries only the
21
+ * preview. {@link TerminalDeliveryLedger.install} therefore registers one
22
+ * `HookOrder.SDK_FIRST` `AfterToolCallEvent` hook that reads the *original* result
23
+ * and keeps its terminal ids as candidates keyed by `toolUseId`; `observe` resolves
24
+ * them against the result the stream actually carries. Unchanged, it counts exactly
25
+ * as before. Replaced, a candidate id counts only when the model-visible
26
+ * replacement text contains that exact id, so snapshots cut off by the preview stay
27
+ * undelivered. The preview is only searched for the literal id, never parsed for
28
+ * state: the state comes from the original.
18
29
  */
19
- import type { AgentStreamEvent } from '@strands-agents/sdk';
30
+ import { AfterToolCallEvent } from '@strands-agents/sdk';
31
+ import type { Agent, AgentStreamEvent } from '@strands-agents/sdk';
20
32
  /**
21
33
  * Task ids whose terminal state a successful `bash` result carried to the model.
22
34
  * Recognizes the manager's own shapes only — `wait` (`status.state`), `status`/`stop`
23
- * (a snapshot) and `list` (snapshots) — by the result, never by the input, because
35
+ * (a snapshot) and `list` (snapshots: a bare array, or the SDK's `{ $value: [...] }`
36
+ * envelope the real tool path produces) — by the result, never by the input, because
24
37
  * some SDK after-events omit the original input. Foreground `execute` results and
25
38
  * `output` results carry no state and contribute nothing.
26
39
  */
@@ -31,6 +44,16 @@ export declare function terminalTaskIdsInToolResult(toolName: string, result: {
31
44
  export declare class TerminalDeliveryLedger {
32
45
  private readonly delivered;
33
46
  private pending;
47
+ /** Pre-replacement terminal ids per `toolUseId`, resolved by `observe`, dropped by `closeTurn`. */
48
+ private candidates;
49
+ /**
50
+ * Registers the pre-offload hook on the parent Agent: `SDK_FIRST`, so it runs
51
+ * before the `ContextOffloader`'s default-order hook can replace the result.
52
+ * It only reads; it never changes the event.
53
+ */
54
+ install(agent: Pick<Agent, 'addHook'>): void;
55
+ /** Records the original result's terminal ids for `observe`. Synchronous, non-throwing. */
56
+ candidate(event: AfterToolCallEvent): void;
34
57
  /** Observes one stream event of the current turn. Synchronous, non-throwing. */
35
58
  observe(event: AgentStreamEvent): void;
36
59
  /**
@@ -15,7 +15,19 @@
15
15
  * (`endTurn`) commits them, because a cancelled turn's tool result may never have
16
16
  * been reasoned about. `observe` cannot throw — observer discipline: a ledger
17
17
  * failure costs a possible duplicate wake, never a turn.
18
+ *
19
+ * SRF-036: the SDK `ContextOffloader` replaces an oversized result at default hook
20
+ * order with an `[Offloaded: …]` text preview, so the stream carries only the
21
+ * preview. {@link TerminalDeliveryLedger.install} therefore registers one
22
+ * `HookOrder.SDK_FIRST` `AfterToolCallEvent` hook that reads the *original* result
23
+ * and keeps its terminal ids as candidates keyed by `toolUseId`; `observe` resolves
24
+ * them against the result the stream actually carries. Unchanged, it counts exactly
25
+ * as before. Replaced, a candidate id counts only when the model-visible
26
+ * replacement text contains that exact id, so snapshots cut off by the preview stay
27
+ * undelivered. The preview is only searched for the literal id, never parsed for
28
+ * state: the state comes from the original.
18
29
  */
30
+ import { AfterToolCallEvent, HookOrder } from '@strands-agents/sdk';
19
31
  const TERMINAL_STATES = new Set(['succeeded', 'failed', 'stopped']);
20
32
  const TASK_ID = /^bg-[0-9a-f-]{36}$/;
21
33
  function isRecord(value) {
@@ -47,10 +59,29 @@ function resultPayload(content) {
47
59
  }
48
60
  return undefined;
49
61
  }
62
+ /**
63
+ * The array inside the SDK's ordinary-array envelope, or undefined. The SDK's
64
+ * `FunctionTool` cannot hand a plain array to Bedrock as JSON content, so it returns
65
+ * one as `new JsonBlock({ json: { $value: array } })` — which is how `list`'s
66
+ * `manager.list()` reaches the model (SRF-033). Exactly that shape is unwrapped, one
67
+ * level: an object whose only own key is `$value`, holding an array. Extra keys, a
68
+ * non-array `$value` and envelopes nested inside the array are not the SDK's shape
69
+ * and are not unwrapped.
70
+ */
71
+ function sdkArrayEnvelope(payload) {
72
+ if (!isRecord(payload))
73
+ return undefined;
74
+ const keys = Object.keys(payload);
75
+ if (keys.length !== 1 || keys[0] !== '$value')
76
+ return undefined;
77
+ const value = payload.$value;
78
+ return Array.isArray(value) ? value : undefined;
79
+ }
50
80
  /**
51
81
  * Task ids whose terminal state a successful `bash` result carried to the model.
52
82
  * Recognizes the manager's own shapes only — `wait` (`status.state`), `status`/`stop`
53
- * (a snapshot) and `list` (snapshots) — by the result, never by the input, because
83
+ * (a snapshot) and `list` (snapshots: a bare array, or the SDK's `{ $value: [...] }`
84
+ * envelope the real tool path produces) — by the result, never by the input, because
54
85
  * some SDK after-events omit the original input. Foreground `execute` results and
55
86
  * `output` results carry no state and contribute nothing.
56
87
  */
@@ -58,8 +89,9 @@ export function terminalTaskIdsInToolResult(toolName, result) {
58
89
  if (toolName !== 'bash' || result.status !== 'success')
59
90
  return [];
60
91
  const payload = resultPayload(result.content);
61
- if (Array.isArray(payload)) {
62
- return payload.map(terminalSnapshotId).filter((id) => id !== undefined);
92
+ const listed = Array.isArray(payload) ? payload : sdkArrayEnvelope(payload);
93
+ if (listed !== undefined) {
94
+ return listed.map(terminalSnapshotId).filter((id) => id !== undefined);
63
95
  }
64
96
  if (!isRecord(payload))
65
97
  return [];
@@ -75,23 +107,63 @@ export function terminalTaskIdsInToolResult(toolName, result) {
75
107
  }
76
108
  return [];
77
109
  }
110
+ /** Whether any text block of a model-visible result contains `id` verbatim. */
111
+ function textContains(content, id) {
112
+ return content.some((block) => isRecord(block) && block.type === 'textBlock' && typeof block.text === 'string' && block.text.includes(id));
113
+ }
78
114
  export class TerminalDeliveryLedger {
79
115
  delivered = new Set();
80
116
  pending = new Set();
117
+ /** Pre-replacement terminal ids per `toolUseId`, resolved by `observe`, dropped by `closeTurn`. */
118
+ candidates = new Map();
119
+ /**
120
+ * Registers the pre-offload hook on the parent Agent: `SDK_FIRST`, so it runs
121
+ * before the `ContextOffloader`'s default-order hook can replace the result.
122
+ * It only reads; it never changes the event.
123
+ */
124
+ install(agent) {
125
+ agent.addHook(AfterToolCallEvent, (event) => this.candidate(event), { order: HookOrder.SDK_FIRST });
126
+ }
127
+ /** Records the original result's terminal ids for `observe`. Synchronous, non-throwing. */
128
+ candidate(event) {
129
+ try {
130
+ const { toolUse, result } = event;
131
+ if (typeof toolUse?.name !== 'string' || typeof toolUse.toolUseId !== 'string')
132
+ return;
133
+ if (!isRecord(result) || !Array.isArray(result.content))
134
+ return;
135
+ const ids = terminalTaskIdsInToolResult(toolUse.name, { status: String(result.status), content: result.content });
136
+ if (ids.length > 0)
137
+ this.candidates.set(toolUse.toolUseId, { result, ids });
138
+ else
139
+ this.candidates.delete(toolUse.toolUseId);
140
+ }
141
+ catch {
142
+ // Observer discipline: a lost candidate costs a possible duplicate wake, never a turn.
143
+ }
144
+ }
81
145
  /** Observes one stream event of the current turn. Synchronous, non-throwing. */
82
146
  observe(event) {
83
147
  try {
84
148
  if (event.type !== 'afterToolCallEvent')
85
149
  return;
86
150
  const { toolUse, result } = event;
151
+ const candidate = typeof toolUse?.toolUseId === 'string' ? this.candidates.get(toolUse.toolUseId) : undefined;
152
+ if (candidate !== undefined)
153
+ this.candidates.delete(toolUse?.toolUseId);
87
154
  if (typeof toolUse?.name !== 'string' || !isRecord(result) || !Array.isArray(result.content))
88
155
  return;
89
- for (const id of terminalTaskIdsInToolResult(toolUse.name, {
90
- status: String(result.status),
91
- content: result.content,
92
- })) {
156
+ const status = String(result.status);
157
+ for (const id of terminalTaskIdsInToolResult(toolUse.name, { status, content: result.content })) {
93
158
  this.pending.add(id);
94
159
  }
160
+ // A replaced result (the offloader's preview): the original's ids count only
161
+ // where the model-visible text still names them exactly.
162
+ if (candidate !== undefined && candidate.result !== result && status === 'success') {
163
+ for (const id of candidate.ids)
164
+ if (textContains(result.content, id))
165
+ this.pending.add(id);
166
+ }
95
167
  }
96
168
  catch {
97
169
  // Observer discipline: never a second reason a turn dies.
@@ -106,6 +178,7 @@ export class TerminalDeliveryLedger {
106
178
  for (const id of this.pending)
107
179
  this.delivered.add(id);
108
180
  this.pending = new Set();
181
+ this.candidates = new Map();
109
182
  }
110
183
  /** True once a completed turn carried this task's terminal state to the model. */
111
184
  has(taskId) {
@@ -1 +1 @@
1
- {"version":3,"file":"task-terminal-delivery.js","sourceRoot":"","sources":["../../../src/agent/task-terminal-delivery.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"task-terminal-delivery.js","sourceRoot":"","sources":["../../../src/agent/task-terminal-delivery.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1 @@
1
+ export declare function runListAgentsCli(projectRoot: string, args: readonly string[]): Promise<void>;
@@ -0,0 +1,12 @@
1
+ /** Local observer route: no runtime, config, provider or SDK imports. */
2
+ import { formatLocalAgents, readLocalAgents } from './list-agents.js';
3
+ import { usageErrorText } from './cli-usage.js';
4
+ export async function runListAgentsCli(projectRoot, args) {
5
+ if (args.length > 0) {
6
+ process.stderr.write(usageErrorText('list-agents takes no arguments. Usage: darwin list-agents'));
7
+ process.exitCode = 2;
8
+ return;
9
+ }
10
+ process.stdout.write(`${formatLocalAgents(await readLocalAgents(projectRoot))}\n`);
11
+ }
12
+ //# sourceMappingURL=cli-list-agents.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"cli-list-agents.js","sourceRoot":"","sources":["../../src/cli-list-agents.ts"],"names":[],"mappings":"AAAA,yEAAyE;AACzE,OAAO,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACtE,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAEhD,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,WAAmB,EAAE,IAAuB;IACjF,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACpB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,cAAc,CAAC,2DAA2D,CAAC,CAAC,CAAC;QAClG,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;QACrB,OAAO;IACT,CAAC;IACD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,iBAAiB,CAAC,MAAM,eAAe,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,CAAC;AACrF,CAAC"}
@@ -1,7 +1,7 @@
1
1
  export declare const HELP_FLAGS: readonly ['--help', '-h'];
2
2
  export declare const VERSION_FLAGS: readonly ['--version', '-V'];
3
3
  /** The complete grammar, exactly as `darwin --help` prints it (trailing newline included). */
4
- export declare const CLI_USAGE = "Usage: darwin [--resume [<id>]|--session <id>] [--permission-mode <default|auto|plan|yolo>] [--yolo]\n darwin -p <message> [--output-format text|json|stream-json]\n [--continue|--resume [<id>]|--session <id>] [permission flags]\n [--max-model-calls <n>] [--context-offload] [--compact-before]\n darwin sessions\n darwin permissions test <rule>\n darwin import --from claude-code [--apply]\n darwin doctor\n darwin cloud-memory [status|preferences|list|inspect|pending|preview] \u2026\n darwin trajectory <list|search|replay|fork> \u2026\n darwin --help | -h\n darwin --version | -V\n\n--context-offload force-enables the default-on offloader for this process; it never persists.\nPrint-only flags: --output-format, --max-model-calls, --context-offload, --compact-before, --continue.\nWith -p, piped (non-TTY) stdin is read to EOF and appended to <message> as one delimited block (256 KiB cap).\n";
4
+ export declare const CLI_USAGE = "Usage: darwin [--resume [<id>]|--session <id>] [--permission-mode <default|auto|plan|yolo>] [--yolo]\n darwin -p <message> [--output-format text|json|stream-json]\n [--continue|--resume [<id>]|--session <id>] [permission flags]\n [--max-model-calls <n>] [--context-offload] [--compact-before]\n darwin sessions\n darwin list-agents\n darwin collaborate [status|list|pending|relations|on|off]\n darwin collaborate send <endpoint-uuid> <literal text>\n darwin collaborate confirm <pending-id> --persist\n darwin collaborate revoke <pair-id>\n darwin permissions test <rule>\n darwin import --from claude-code [--apply]\n darwin doctor\n darwin cloud-memory [status|preferences|list|inspect|pending|preview] \u2026\n darwin trajectory <list|search|replay|fork> \u2026\n darwin --help | -h\n darwin --version | -V\n\n--context-offload force-enables the default-on offloader for this process; it never persists.\nPrint-only flags: --output-format, --max-model-calls, --context-offload, --compact-before, --continue.\nWith -p, piped (non-TTY) stdin is read to EOF and appended to <message> as one delimited block (256 KiB cap).\n";
5
5
  /** The one hint every usage error appends after its `error:` line. */
6
6
  export declare const CLI_HELP_HINT = "Run `darwin --help` for usage.";
7
7
  /**
@@ -19,6 +19,11 @@ export const CLI_USAGE = `Usage: darwin [--resume [<id>]|--session <id>] [--perm
19
19
  [--continue|--resume [<id>]|--session <id>] [permission flags]
20
20
  [--max-model-calls <n>] [--context-offload] [--compact-before]
21
21
  darwin sessions
22
+ darwin list-agents
23
+ darwin collaborate [status|list|pending|relations|on|off]
24
+ darwin collaborate send <endpoint-uuid> <literal text>
25
+ darwin collaborate confirm <pending-id> --persist
26
+ darwin collaborate revoke <pair-id>
22
27
  darwin permissions test <rule>
23
28
  darwin import --from claude-code [--apply]
24
29
  darwin doctor
@@ -1 +1 @@
1
- {"version":3,"file":"cli-usage.js","sourceRoot":"","sources":["../../src/cli-usage.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAE9C,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,QAAQ,EAAE,IAAI,CAAU,CAAC;AACpD,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,WAAW,EAAE,IAAI,CAAU,CAAC;AAE1D,8FAA8F;AAC9F,MAAM,CAAC,MAAM,SAAS,GAAG;;;;;;;;;;;;;;;;CAgBxB,CAAC;AAEF,sEAAsE;AACtE,MAAM,CAAC,MAAM,aAAa,GAAG,gCAAgC,CAAC;AAE9D;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,OAAe;IAC5C,OAAO,UAAU,OAAO,KAAK,aAAa,IAAI,CAAC;AACjD,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,cAAc,CAAC,SAAiB;IAC9C,OAAO,WAAW,SAAS,8BAA8B,SAAS,IAAI,CAAC;AACzE,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAAC,IAAuB;IACpD,IAAI,UAAU,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QAAE,OAAO,SAAS,CAAC;IACrE,IAAI,aAAa,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QAAE,OAAO,UAAU,cAAc,IAAI,CAAC;IAC3F,OAAO,SAAS,CAAC;AACnB,CAAC"}
1
+ {"version":3,"file":"cli-usage.js","sourceRoot":"","sources":["../../src/cli-usage.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAE9C,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,QAAQ,EAAE,IAAI,CAAU,CAAC;AACpD,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,WAAW,EAAE,IAAI,CAAU,CAAC;AAE1D,8FAA8F;AAC9F,MAAM,CAAC,MAAM,SAAS,GAAG;;;;;;;;;;;;;;;;;;;;;CAqBxB,CAAC;AAEF,sEAAsE;AACtE,MAAM,CAAC,MAAM,aAAa,GAAG,gCAAgC,CAAC;AAE9D;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,OAAe;IAC5C,OAAO,UAAU,OAAO,KAAK,aAAa,IAAI,CAAC;AACjD,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,cAAc,CAAC,SAAiB;IAC9C,OAAO,WAAW,SAAS,8BAA8B,SAAS,IAAI,CAAC;AACzE,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAAC,IAAuB;IACpD,IAAI,UAAU,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QAAE,OAAO,SAAS,CAAC;IACrE,IAAI,aAAa,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QAAE,OAAO,UAAU,cAAc,IAAI,CAAC;IAC3F,OAAO,SAAS,CAAC;AACnB,CAAC"}
package/dist/src/cli.js CHANGED
@@ -26,7 +26,15 @@ else {
26
26
  const args = process.argv.slice(2);
27
27
  if (args[0] === '--')
28
28
  args.shift();
29
- if (args[0] === 'import') {
29
+ if (args[0] === 'collaborate') {
30
+ const { runCollaborationCli } = await import('./collaboration/command.js');
31
+ await runCollaborationCli(process.cwd(), args.slice(1));
32
+ }
33
+ else if (args[0] === 'list-agents') {
34
+ const { runListAgentsCli } = await import('./cli-list-agents.js');
35
+ await runListAgentsCli(process.cwd(), args.slice(1));
36
+ }
37
+ else if (args[0] === 'import') {
30
38
  const { runImportCli } = await import('./cli-import.js');
31
39
  await runImportCli(process.cwd(), args.slice(1));
32
40
  }
@@ -1 +1 @@
1
- {"version":3,"file":"cli.js","sourceRoot":"","sources":["../../src/cli.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;;;GAeG;AACH,OAAO,OAAO,MAAM,cAAc,CAAC;AAEnC,OAAO,EAAE,6BAA6B,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAE5F,MAAM,OAAO,GAAG,iBAAiB,EAAE,CAAC;AACpC,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;IAC1B,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAC9B,OAAO,CAAC,QAAQ,GAAG,6BAA6B,CAAC;AACnD,CAAC;KAAM,CAAC;IACN,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACnC,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,IAAI;QAAE,IAAI,CAAC,KAAK,EAAE,CAAC;IACnC,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,QAAQ,EAAE,CAAC;QACzB,MAAM,EAAE,YAAY,EAAE,GAAG,MAAM,MAAM,CAAC,iBAAiB,CAAC,CAAC;QACzD,MAAM,YAAY,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IACnD,CAAC;SAAM,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,aAAa,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC;QAC7G,MAAM,EAAE,iBAAiB,EAAE,GAAG,MAAM,MAAM,CAAC,sBAAsB,CAAC,CAAC;QACnE,MAAM,iBAAiB,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IACxD,CAAC;SAAM,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,cAAc,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC;QAC9G,MAAM,EAAE,iBAAiB,EAAE,GAAG,MAAM,MAAM,CAAC,oBAAoB,CAAC,CAAC;QACjE,MAAM,iBAAiB,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IACxD,CAAC;SAAM,CAAC;QACN,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,MAAM,CAAC,eAAe,CAAC,CAAC;QAC/C,MAAM,IAAI,EAAE,CAAC;IACf,CAAC;AACH,CAAC"}
1
+ {"version":3,"file":"cli.js","sourceRoot":"","sources":["../../src/cli.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;;;GAeG;AACH,OAAO,OAAO,MAAM,cAAc,CAAC;AAEnC,OAAO,EAAE,6BAA6B,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAE5F,MAAM,OAAO,GAAG,iBAAiB,EAAE,CAAC;AACpC,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;IAC1B,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAC9B,OAAO,CAAC,QAAQ,GAAG,6BAA6B,CAAC;AACnD,CAAC;KAAM,CAAC;IACN,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACnC,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,IAAI;QAAE,IAAI,CAAC,KAAK,EAAE,CAAC;IACnC,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,aAAa,EAAE,CAAC;QAC9B,MAAM,EAAE,mBAAmB,EAAE,GAAG,MAAM,MAAM,CAAC,4BAA4B,CAAC,CAAC;QAC3E,MAAM,mBAAmB,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IAC1D,CAAC;SAAM,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,aAAa,EAAE,CAAC;QACrC,MAAM,EAAE,gBAAgB,EAAE,GAAG,MAAM,MAAM,CAAC,sBAAsB,CAAC,CAAC;QAClE,MAAM,gBAAgB,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IACvD,CAAC;SAAM,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,QAAQ,EAAE,CAAC;QAChC,MAAM,EAAE,YAAY,EAAE,GAAG,MAAM,MAAM,CAAC,iBAAiB,CAAC,CAAC;QACzD,MAAM,YAAY,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IACnD,CAAC;SAAM,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,aAAa,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC;QAC7G,MAAM,EAAE,iBAAiB,EAAE,GAAG,MAAM,MAAM,CAAC,sBAAsB,CAAC,CAAC;QACnE,MAAM,iBAAiB,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IACxD,CAAC;SAAM,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,cAAc,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC;QAC9G,MAAM,EAAE,iBAAiB,EAAE,GAAG,MAAM,MAAM,CAAC,oBAAoB,CAAC,CAAC;QACjE,MAAM,iBAAiB,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IACxD,CAAC;SAAM,CAAC;QACN,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,MAAM,CAAC,eAAe,CAAC,CAAC;QAC/C,MAAM,IAAI,EAAE,CAAC;IACf,CAAC;AACH,CAAC"}
@@ -0,0 +1,5 @@
1
+ import { LocalCollaboration } from './local.js';
2
+ export { COLLABORATE_USAGE } from './grammar.js';
3
+ /** Literal user-only command. No invocation, expansion or model-granted trust. */
4
+ export declare function collaborationCommand(local: LocalCollaboration, text: string): Promise<string>;
5
+ export declare function runCollaborationCli(root: string, args: readonly string[]): Promise<void>;
@@ -0,0 +1,72 @@
1
+ import { randomUUID } from 'node:crypto';
2
+ import { discoverPeers, LocalCollaboration } from './local.js';
3
+ import { idSchema, policyCommand } from './storage.js';
4
+ import { COLLABORATE_USAGE } from './grammar.js';
5
+ export { COLLABORATE_USAGE } from './grammar.js';
6
+ /** Pure preflight shared by CLI and TUI: no policy, registration or probe on bad grammar. */
7
+ function validateCommand(args) {
8
+ const [verb, id, flag] = args;
9
+ if (args.length === 1 && ['status', 'list', 'pending', 'relations', 'on', 'off'].includes(verb))
10
+ return;
11
+ if (verb === 'confirm' && args.length === 3 && flag === '--persist' && idSchema.safeParse(id).success)
12
+ return;
13
+ if (verb === 'revoke' && args.length === 2 && /^[a-f0-9]{64}$/.test(id ?? ''))
14
+ return;
15
+ if (verb === 'send' && args.length >= 3 && idSchema.safeParse(id).success) {
16
+ const bytes = Buffer.byteLength(args.slice(2).join(' '));
17
+ if (bytes > 0 && bytes <= 4096)
18
+ return;
19
+ }
20
+ throw new Error(COLLABORATE_USAGE);
21
+ }
22
+ /** Literal user-only command. No invocation, expansion or model-granted trust. */
23
+ export async function collaborationCommand(local, text) {
24
+ const command = text.trim();
25
+ const send = /^send\s+(\S+)\s+([\s\S]+)$/.exec(text.trimStart());
26
+ validateCommand(send ? ['send', send[1], send[2]] : (command || 'status').split(/\s+/));
27
+ if (send) {
28
+ local.beginHumanTurn();
29
+ return local.send(send[1], send[2]);
30
+ }
31
+ if (command === 'list')
32
+ return JSON.stringify(await discoverPeers(), null, 2);
33
+ const result = await policyCommand((command || 'status').split(/\s+/));
34
+ if (command === 'off')
35
+ local.close('collaboration off');
36
+ if (command === 'on') {
37
+ local.close('new endpoint requested');
38
+ await local.start();
39
+ }
40
+ return `${result}\nThis endpoint: ${JSON.stringify(local.address ?? null)}; queued: ${local.pending}\n${COLLABORATE_USAGE}`;
41
+ }
42
+ export async function runCollaborationCli(root, args) {
43
+ try {
44
+ // CLI registration exists only for an explicit send. Read projections do not
45
+ // create policy; first startup/on initializes it with no cross-project grants.
46
+ validateCommand(args.length ? args : ['status']);
47
+ if (args[0] === 'list') {
48
+ console.log(JSON.stringify(await discoverPeers(), null, 2));
49
+ return;
50
+ }
51
+ if (args[0] !== 'send') {
52
+ console.log(await policyCommand(args.length ? args : ['status']));
53
+ return;
54
+ }
55
+ const local = new LocalCollaboration(root, `cli-${randomUUID()}`);
56
+ await local.start();
57
+ // argv already separates the target from literal text; do not reparse it as
58
+ // TUI command whitespace and lose leading spaces/newlines in a quoted body.
59
+ try {
60
+ local.beginHumanTurn();
61
+ console.log(await local.send(args[1], args.slice(2).join(' ')));
62
+ }
63
+ finally {
64
+ local.close('CLI send finished');
65
+ }
66
+ }
67
+ catch (error) {
68
+ console.error(`collaborate: ${error instanceof Error ? error.message : 'local operation failed'}`);
69
+ process.exitCode = 1;
70
+ }
71
+ }
72
+ //# sourceMappingURL=command.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"command.js","sourceRoot":"","sources":["../../../src/collaboration/command.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,3 @@
1
+ /** Pure canonical user grammar; safe to import from bounded local help. */
2
+ export declare const COLLABORATION_GRAMMAR: readonly ['/collaborate [status|list|pending|relations|on|off]', '/collaborate send <endpoint-uuid> <literal text>', '/collaborate confirm <pending-id> --persist; /collaborate revoke <pair-id>'];
3
+ export declare const COLLABORATE_USAGE: string;
@@ -0,0 +1,8 @@
1
+ /** Pure canonical user grammar; safe to import from bounded local help. */
2
+ export const COLLABORATION_GRAMMAR = [
3
+ '/collaborate [status|list|pending|relations|on|off]',
4
+ '/collaborate send <endpoint-uuid> <literal text>',
5
+ '/collaborate confirm <pending-id> --persist; /collaborate revoke <pair-id>',
6
+ ];
7
+ export const COLLABORATE_USAGE = COLLABORATION_GRAMMAR.join('; ');
8
+ //# sourceMappingURL=grammar.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"grammar.js","sourceRoot":"","sources":["../../../src/collaboration/grammar.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAC3E,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACnC,qDAAqD;IACrD,kDAAkD;IAClD,4EAA4E;CACpE,CAAC;AACX,MAAM,CAAC,MAAM,iBAAiB,GAAG,qBAAqB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC"}
@@ -0,0 +1,61 @@
1
+ import { type PeerAddress, type PeerInput, type PeerTransport } from './protocol.js';
2
+ export declare function socketPath(id: string): string;
3
+ /** Bounded metadata-only endpoint projection, separate from immutable lease discovery. */
4
+ export declare function discoverPeers(): Promise<{
5
+ endpoints: PeerAddress[];
6
+ omitted: number;
7
+ uninspected: number;
8
+ scanLimited: boolean;
9
+ scope: string;
10
+ }>;
11
+ /** One parent session, never a daemon or SDK loop. Only drivers drain the inbox. */
12
+ export declare class LocalCollaboration implements PeerTransport {
13
+ private readonly projectRoot;
14
+ readonly session: string;
15
+ private readonly readOnly;
16
+ private server;
17
+ private registration;
18
+ private sockets;
19
+ private inbox;
20
+ private listeners;
21
+ private notices;
22
+ private seen;
23
+ private chainCounts;
24
+ private cause?;
25
+ private outgoing;
26
+ private peerTurn;
27
+ private lastPeerId?;
28
+ private denied;
29
+ private admitted;
30
+ private window;
31
+ private accepting;
32
+ private stopped;
33
+ private generation;
34
+ private canonicalRoot;
35
+ constructor(projectRoot: string, session: string, readOnly?: () => boolean);
36
+ get project(): string;
37
+ get address(): PeerAddress | undefined;
38
+ get pending(): number;
39
+ get active(): boolean;
40
+ subscribe(listener: () => void): () => void;
41
+ takeNotices(): string[];
42
+ private changed;
43
+ private notice;
44
+ start(): Promise<void>;
45
+ /** Headless closes admission before draining a finite snapshot; not an idle daemon. */
46
+ stopAdmission(): void;
47
+ close(reason: string): void;
48
+ private receive;
49
+ private respond;
50
+ private fresh;
51
+ private admit;
52
+ /** Only a driver at idle takes input. Runtime rechecks it immediately before invocation. */
53
+ take(): PeerInput | undefined;
54
+ validateDelivery(input: PeerInput): void;
55
+ beginHumanTurn(): void;
56
+ beginPeerTurn(input: PeerInput): void;
57
+ permissionDenied(): void;
58
+ get fromPeer(): boolean;
59
+ get peerReadOnly(): boolean;
60
+ send(target: string, text: string): Promise<string>;
61
+ }