strands-darwin 0.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.
- package/README.md +140 -0
- package/README.zh-CN.md +140 -0
- package/dist/patches/@strands-agents+sdk+1.16.0.patch +1443 -0
- package/dist/src/agent/background-delegation.d.ts +67 -0
- package/dist/src/agent/background-delegation.js +159 -0
- package/dist/src/agent/background-delegation.js.map +1 -0
- package/dist/src/agent/call-stats.d.ts +118 -0
- package/dist/src/agent/call-stats.js +128 -0
- package/dist/src/agent/call-stats.js.map +1 -0
- package/dist/src/agent/compact.d.ts +108 -0
- package/dist/src/agent/compact.js +192 -0
- package/dist/src/agent/compact.js.map +1 -0
- package/dist/src/agent/context-anchor.d.ts +64 -0
- package/dist/src/agent/context-anchor.js +43 -0
- package/dist/src/agent/context-anchor.js.map +1 -0
- package/dist/src/agent/cost.d.ts +56 -0
- package/dist/src/agent/cost.js +44 -0
- package/dist/src/agent/cost.js.map +1 -0
- package/dist/src/agent/diagnostics.d.ts +212 -0
- package/dist/src/agent/diagnostics.js +374 -0
- package/dist/src/agent/diagnostics.js.map +1 -0
- package/dist/src/agent/instructions.d.ts +54 -0
- package/dist/src/agent/instructions.js +118 -0
- package/dist/src/agent/instructions.js.map +1 -0
- package/dist/src/agent/max-tokens-recovery.d.ts +17 -0
- package/dist/src/agent/max-tokens-recovery.js +65 -0
- package/dist/src/agent/max-tokens-recovery.js.map +1 -0
- package/dist/src/agent/model-call-budget.d.ts +8 -0
- package/dist/src/agent/model-call-budget.js +24 -0
- package/dist/src/agent/model-call-budget.js.map +1 -0
- package/dist/src/agent/model-retry.d.ts +134 -0
- package/dist/src/agent/model-retry.js +256 -0
- package/dist/src/agent/model-retry.js.map +1 -0
- package/dist/src/agent/permission-rules.d.ts +47 -0
- package/dist/src/agent/permission-rules.js +260 -0
- package/dist/src/agent/permission-rules.js.map +1 -0
- package/dist/src/agent/permission.d.ts +361 -0
- package/dist/src/agent/permission.js +797 -0
- package/dist/src/agent/permission.js.map +1 -0
- package/dist/src/agent/prompt-cache.d.ts +66 -0
- package/dist/src/agent/prompt-cache.js +194 -0
- package/dist/src/agent/prompt-cache.js.map +1 -0
- package/dist/src/agent/refusal.d.ts +20 -0
- package/dist/src/agent/refusal.js +23 -0
- package/dist/src/agent/refusal.js.map +1 -0
- package/dist/src/agent/retry-guard.d.ts +26 -0
- package/dist/src/agent/retry-guard.js +193 -0
- package/dist/src/agent/retry-guard.js.map +1 -0
- package/dist/src/agent/rewind.d.ts +29 -0
- package/dist/src/agent/rewind.js +118 -0
- package/dist/src/agent/rewind.js.map +1 -0
- package/dist/src/agent/runtime.d.ts +814 -0
- package/dist/src/agent/runtime.js +1596 -0
- package/dist/src/agent/runtime.js.map +1 -0
- package/dist/src/agent/safety-classifier.d.ts +11 -0
- package/dist/src/agent/safety-classifier.js +0 -0
- package/dist/src/agent/safety-classifier.js.map +1 -0
- package/dist/src/agent/sdk-logging.d.ts +49 -0
- package/dist/src/agent/sdk-logging.js +110 -0
- package/dist/src/agent/sdk-logging.js.map +1 -0
- package/dist/src/agent/session.d.ts +102 -0
- package/dist/src/agent/session.js +244 -0
- package/dist/src/agent/session.js.map +1 -0
- package/dist/src/agent/stream-resumption.d.ts +16 -0
- package/dist/src/agent/stream-resumption.js +33 -0
- package/dist/src/agent/stream-resumption.js.map +1 -0
- package/dist/src/agent/system-prompt.d.ts +50 -0
- package/dist/src/agent/system-prompt.js +161 -0
- package/dist/src/agent/system-prompt.js.map +1 -0
- package/dist/src/agent/thinking.d.ts +99 -0
- package/dist/src/agent/thinking.js +145 -0
- package/dist/src/agent/thinking.js.map +1 -0
- package/dist/src/agent/usage.d.ts +132 -0
- package/dist/src/agent/usage.js +233 -0
- package/dist/src/agent/usage.js.map +1 -0
- package/dist/src/agent/working-context.d.ts +51 -0
- package/dist/src/agent/working-context.js +160 -0
- package/dist/src/agent/working-context.js.map +1 -0
- package/dist/src/agents/child-recipe.d.ts +33 -0
- package/dist/src/agents/child-recipe.js +98 -0
- package/dist/src/agents/child-recipe.js.map +1 -0
- package/dist/src/agents/concurrency-limit.d.ts +25 -0
- package/dist/src/agents/concurrency-limit.js +43 -0
- package/dist/src/agents/concurrency-limit.js.map +1 -0
- package/dist/src/agents/dispatch-registry.d.ts +180 -0
- package/dist/src/agents/dispatch-registry.js +289 -0
- package/dist/src/agents/dispatch-registry.js.map +1 -0
- package/dist/src/agents/failed-child-text.d.ts +44 -0
- package/dist/src/agents/failed-child-text.js +69 -0
- package/dist/src/agents/failed-child-text.js.map +1 -0
- package/dist/src/agents/loader.d.ts +26 -0
- package/dist/src/agents/loader.js +134 -0
- package/dist/src/agents/loader.js.map +1 -0
- package/dist/src/agents/report-projection.d.ts +31 -0
- package/dist/src/agents/report-projection.js +125 -0
- package/dist/src/agents/report-projection.js.map +1 -0
- package/dist/src/agents/subagent-tool.d.ts +61 -0
- package/dist/src/agents/subagent-tool.js +180 -0
- package/dist/src/agents/subagent-tool.js.map +1 -0
- package/dist/src/agents/workflow-tool.d.ts +85 -0
- package/dist/src/agents/workflow-tool.js +530 -0
- package/dist/src/agents/workflow-tool.js.map +1 -0
- package/dist/src/cli-args.d.ts +39 -0
- package/dist/src/cli-args.js +198 -0
- package/dist/src/cli-args.js.map +1 -0
- package/dist/src/cli-doctor.d.ts +26 -0
- package/dist/src/cli-doctor.js +398 -0
- package/dist/src/cli-doctor.js.map +1 -0
- package/dist/src/cli-main.d.ts +1 -0
- package/dist/src/cli-main.js +279 -0
- package/dist/src/cli-main.js.map +1 -0
- package/dist/src/cli-sessions.d.ts +17 -0
- package/dist/src/cli-sessions.js +136 -0
- package/dist/src/cli-sessions.js.map +1 -0
- package/dist/src/cli-trajectory.d.ts +37 -0
- package/dist/src/cli-trajectory.js +303 -0
- package/dist/src/cli-trajectory.js.map +1 -0
- package/dist/src/cli-usage.d.ts +18 -0
- package/dist/src/cli-usage.js +53 -0
- package/dist/src/cli-usage.js.map +1 -0
- package/dist/src/cli.d.ts +2 -0
- package/dist/src/cli.js +29 -0
- package/dist/src/cli.js.map +1 -0
- package/dist/src/commands/custom-commands.d.ts +43 -0
- package/dist/src/commands/custom-commands.js +155 -0
- package/dist/src/commands/custom-commands.js.map +1 -0
- package/dist/src/commands/workflow-command.d.ts +26 -0
- package/dist/src/commands/workflow-command.js +56 -0
- package/dist/src/commands/workflow-command.js.map +1 -0
- package/dist/src/config.d.ts +463 -0
- package/dist/src/config.js +1457 -0
- package/dist/src/config.js.map +1 -0
- package/dist/src/context-overflow-error.d.ts +7 -0
- package/dist/src/context-overflow-error.js +26 -0
- package/dist/src/context-overflow-error.js.map +1 -0
- package/dist/src/dev-repl.d.ts +1 -0
- package/dist/src/dev-repl.js +365 -0
- package/dist/src/dev-repl.js.map +1 -0
- package/dist/src/headless-protocol.d.ts +147 -0
- package/dist/src/headless-protocol.js +359 -0
- package/dist/src/headless-protocol.js.map +1 -0
- package/dist/src/headless-runner.d.ts +30 -0
- package/dist/src/headless-runner.js +405 -0
- package/dist/src/headless-runner.js.map +1 -0
- package/dist/src/headless-stdin.d.ts +28 -0
- package/dist/src/headless-stdin.js +78 -0
- package/dist/src/headless-stdin.js.map +1 -0
- package/dist/src/headless.d.ts +106 -0
- package/dist/src/headless.js +229 -0
- package/dist/src/headless.js.map +1 -0
- package/dist/src/hooks/codex-hook-runner.d.ts +92 -0
- package/dist/src/hooks/codex-hook-runner.js +446 -0
- package/dist/src/hooks/codex-hook-runner.js.map +1 -0
- package/dist/src/hooks/codex-hooks.d.ts +23 -0
- package/dist/src/hooks/codex-hooks.js +152 -0
- package/dist/src/hooks/codex-hooks.js.map +1 -0
- package/dist/src/hooks/hook-process.d.ts +23 -0
- package/dist/src/hooks/hook-process.js +241 -0
- package/dist/src/hooks/hook-process.js.map +1 -0
- package/dist/src/hooks/lifecycle-hooks.d.ts +37 -0
- package/dist/src/hooks/lifecycle-hooks.js +153 -0
- package/dist/src/hooks/lifecycle-hooks.js.map +1 -0
- package/dist/src/hooks/tool-hooks.d.ts +63 -0
- package/dist/src/hooks/tool-hooks.js +350 -0
- package/dist/src/hooks/tool-hooks.js.map +1 -0
- package/dist/src/mcp/codegraph-preflight.d.ts +29 -0
- package/dist/src/mcp/codegraph-preflight.js +232 -0
- package/dist/src/mcp/codegraph-preflight.js.map +1 -0
- package/dist/src/mcp/registry.d.ts +133 -0
- package/dist/src/mcp/registry.js +209 -0
- package/dist/src/mcp/registry.js.map +1 -0
- package/dist/src/mcp/web-search-empty-results.d.ts +14 -0
- package/dist/src/mcp/web-search-empty-results.js +94 -0
- package/dist/src/mcp/web-search-empty-results.js.map +1 -0
- package/dist/src/memory/command.d.ts +11 -0
- package/dist/src/memory/command.js +253 -0
- package/dist/src/memory/command.js.map +1 -0
- package/dist/src/memory/controller.d.ts +51 -0
- package/dist/src/memory/controller.js +316 -0
- package/dist/src/memory/controller.js.map +1 -0
- package/dist/src/memory/prompt.d.ts +4 -0
- package/dist/src/memory/prompt.js +22 -0
- package/dist/src/memory/prompt.js.map +1 -0
- package/dist/src/memory/scheduler.d.ts +33 -0
- package/dist/src/memory/scheduler.js +134 -0
- package/dist/src/memory/scheduler.js.map +1 -0
- package/dist/src/memory/state.d.ts +112 -0
- package/dist/src/memory/state.js +355 -0
- package/dist/src/memory/state.js.map +1 -0
- package/dist/src/memory/store.d.ts +19 -0
- package/dist/src/memory/store.js +130 -0
- package/dist/src/memory/store.js.map +1 -0
- package/dist/src/memory/tools.d.ts +29 -0
- package/dist/src/memory/tools.js +22 -0
- package/dist/src/memory/tools.js.map +1 -0
- package/dist/src/memory/validation.d.ts +33 -0
- package/dist/src/memory/validation.js +159 -0
- package/dist/src/memory/validation.js.map +1 -0
- package/dist/src/npm-package/generate-patch.d.ts +23 -0
- package/dist/src/npm-package/generate-patch.js +88 -0
- package/dist/src/npm-package/generate-patch.js.map +1 -0
- package/dist/src/npm-package/patch-package-format.d.ts +43 -0
- package/dist/src/npm-package/patch-package-format.js +66 -0
- package/dist/src/npm-package/patch-package-format.js.map +1 -0
- package/dist/src/paths.d.ts +39 -0
- package/dist/src/paths.js +105 -0
- package/dist/src/paths.js.map +1 -0
- package/dist/src/pricing/cost.d.ts +182 -0
- package/dist/src/pricing/cost.js +215 -0
- package/dist/src/pricing/cost.js.map +1 -0
- package/dist/src/pricing/model-prices.d.ts +112 -0
- package/dist/src/pricing/model-prices.js +320 -0
- package/dist/src/pricing/model-prices.js.map +1 -0
- package/dist/src/sdk-patch-preflight.d.ts +23 -0
- package/dist/src/sdk-patch-preflight.js +71 -0
- package/dist/src/sdk-patch-preflight.js.map +1 -0
- package/dist/src/skills/builtin/commit-message/SKILL.md +45 -0
- package/dist/src/skills/builtin/commit-message/references/types.md +8 -0
- package/dist/src/skills/builtin/developer/SKILL.md +107 -0
- package/dist/src/skills/builtin/self-evolution-research/SKILL.md +150 -0
- package/dist/src/skills/builtin/self-evolution-research/scripts/roll-research-path.mjs +208 -0
- package/dist/src/skills/builtin/self-reflection/SKILL.md +172 -0
- package/dist/src/skills/builtin/self-reflection/references/reflection-template.md +90 -0
- package/dist/src/skills/builtin/self-reflection/scripts/locate-trajectory.mjs +175 -0
- package/dist/src/skills/loader.d.ts +26 -0
- package/dist/src/skills/loader.js +186 -0
- package/dist/src/skills/loader.js.map +1 -0
- package/dist/src/skills/plugin.d.ts +34 -0
- package/dist/src/skills/plugin.js +137 -0
- package/dist/src/skills/plugin.js.map +1 -0
- package/dist/src/skills/prompt.d.ts +8 -0
- package/dist/src/skills/prompt.js +214 -0
- package/dist/src/skills/prompt.js.map +1 -0
- package/dist/src/skills/resource-safety.d.ts +15 -0
- package/dist/src/skills/resource-safety.js +149 -0
- package/dist/src/skills/resource-safety.js.map +1 -0
- package/dist/src/tools/background-bash.d.ts +95 -0
- package/dist/src/tools/background-bash.js +639 -0
- package/dist/src/tools/background-bash.js.map +1 -0
- package/dist/src/tools/background-tail.d.ts +28 -0
- package/dist/src/tools/background-tail.js +75 -0
- package/dist/src/tools/background-tail.js.map +1 -0
- package/dist/src/tools/background-wait-contract.d.ts +4 -0
- package/dist/src/tools/background-wait-contract.js +7 -0
- package/dist/src/tools/background-wait-contract.js.map +1 -0
- package/dist/src/tools/file-editor-serial.d.ts +24 -0
- package/dist/src/tools/file-editor-serial.js +99 -0
- package/dist/src/tools/file-editor-serial.js.map +1 -0
- package/dist/src/tools/image-viewer.d.ts +43 -0
- package/dist/src/tools/image-viewer.js +256 -0
- package/dist/src/tools/image-viewer.js.map +1 -0
- package/dist/src/tools/update-plan.d.ts +30 -0
- package/dist/src/tools/update-plan.js +65 -0
- package/dist/src/tools/update-plan.js.map +1 -0
- package/dist/src/tools/web-fetch.d.ts +70 -0
- package/dist/src/tools/web-fetch.js +667 -0
- package/dist/src/tools/web-fetch.js.map +1 -0
- package/dist/src/trajectory/export.d.ts +31 -0
- package/dist/src/trajectory/export.js +116 -0
- package/dist/src/trajectory/export.js.map +1 -0
- package/dist/src/trajectory/fork.d.ts +19 -0
- package/dist/src/trajectory/fork.js +110 -0
- package/dist/src/trajectory/fork.js.map +1 -0
- package/dist/src/trajectory/memory-tool.d.ts +20 -0
- package/dist/src/trajectory/memory-tool.js +98 -0
- package/dist/src/trajectory/memory-tool.js.map +1 -0
- package/dist/src/trajectory/prompt-history.d.ts +62 -0
- package/dist/src/trajectory/prompt-history.js +256 -0
- package/dist/src/trajectory/prompt-history.js.map +1 -0
- package/dist/src/trajectory/reader.d.ts +21 -0
- package/dist/src/trajectory/reader.js +62 -0
- package/dist/src/trajectory/reader.js.map +1 -0
- package/dist/src/trajectory/record.d.ts +417 -0
- package/dist/src/trajectory/record.js +394 -0
- package/dist/src/trajectory/record.js.map +1 -0
- package/dist/src/trajectory/replay.d.ts +74 -0
- package/dist/src/trajectory/replay.js +285 -0
- package/dist/src/trajectory/replay.js.map +1 -0
- package/dist/src/trajectory/resume-recap.d.ts +43 -0
- package/dist/src/trajectory/resume-recap.js +68 -0
- package/dist/src/trajectory/resume-recap.js.map +1 -0
- package/dist/src/trajectory/search.d.ts +40 -0
- package/dist/src/trajectory/search.js +127 -0
- package/dist/src/trajectory/search.js.map +1 -0
- package/dist/src/trajectory/spend.d.ts +157 -0
- package/dist/src/trajectory/spend.js +264 -0
- package/dist/src/trajectory/spend.js.map +1 -0
- package/dist/src/trajectory/stream.d.ts +30 -0
- package/dist/src/trajectory/stream.js +30 -0
- package/dist/src/trajectory/stream.js.map +1 -0
- package/dist/src/trajectory/writer.d.ts +310 -0
- package/dist/src/trajectory/writer.js +636 -0
- package/dist/src/trajectory/writer.js.map +1 -0
- package/dist/src/tui/App.d.ts +109 -0
- package/dist/src/tui/App.js +2660 -0
- package/dist/src/tui/App.js.map +1 -0
- package/dist/src/tui/InputBox.d.ts +90 -0
- package/dist/src/tui/InputBox.js +129 -0
- package/dist/src/tui/InputBox.js.map +1 -0
- package/dist/src/tui/MarkdownText.d.ts +16 -0
- package/dist/src/tui/MarkdownText.js +117 -0
- package/dist/src/tui/MarkdownText.js.map +1 -0
- package/dist/src/tui/MessageList.d.ts +27 -0
- package/dist/src/tui/MessageList.js +61 -0
- package/dist/src/tui/MessageList.js.map +1 -0
- package/dist/src/tui/PermissionPrompt.d.ts +18 -0
- package/dist/src/tui/PermissionPrompt.js +114 -0
- package/dist/src/tui/PermissionPrompt.js.map +1 -0
- package/dist/src/tui/PlanChecklist.d.ts +7 -0
- package/dist/src/tui/PlanChecklist.js +12 -0
- package/dist/src/tui/PlanChecklist.js.map +1 -0
- package/dist/src/tui/QueuedMessages.d.ts +8 -0
- package/dist/src/tui/QueuedMessages.js +24 -0
- package/dist/src/tui/QueuedMessages.js.map +1 -0
- package/dist/src/tui/StartupScreen.d.ts +25 -0
- package/dist/src/tui/StartupScreen.js +51 -0
- package/dist/src/tui/StartupScreen.js.map +1 -0
- package/dist/src/tui/ToolCallPanel.d.ts +33 -0
- package/dist/src/tui/ToolCallPanel.js +112 -0
- package/dist/src/tui/ToolCallPanel.js.map +1 -0
- package/dist/src/tui/WelcomeHeader.d.ts +30 -0
- package/dist/src/tui/WelcomeHeader.js +69 -0
- package/dist/src/tui/WelcomeHeader.js.map +1 -0
- package/dist/src/tui/background-tool-presentation.d.ts +22 -0
- package/dist/src/tui/background-tool-presentation.js +209 -0
- package/dist/src/tui/background-tool-presentation.js.map +1 -0
- package/dist/src/tui/busy-suffix.d.ts +37 -0
- package/dist/src/tui/busy-suffix.js +39 -0
- package/dist/src/tui/busy-suffix.js.map +1 -0
- package/dist/src/tui/clipboard-image.d.ts +18 -0
- package/dist/src/tui/clipboard-image.js +109 -0
- package/dist/src/tui/clipboard-image.js.map +1 -0
- package/dist/src/tui/context-format.d.ts +43 -0
- package/dist/src/tui/context-format.js +71 -0
- package/dist/src/tui/context-format.js.map +1 -0
- package/dist/src/tui/copy-command.d.ts +68 -0
- package/dist/src/tui/copy-command.js +182 -0
- package/dist/src/tui/copy-command.js.map +1 -0
- package/dist/src/tui/edit-diff.d.ts +135 -0
- package/dist/src/tui/edit-diff.js +356 -0
- package/dist/src/tui/edit-diff.js.map +1 -0
- package/dist/src/tui/frame-budget.d.ts +351 -0
- package/dist/src/tui/frame-budget.js +446 -0
- package/dist/src/tui/frame-budget.js.map +1 -0
- package/dist/src/tui/help-format.d.ts +17 -0
- package/dist/src/tui/help-format.js +38 -0
- package/dist/src/tui/help-format.js.map +1 -0
- package/dist/src/tui/live-text.d.ts +51 -0
- package/dist/src/tui/live-text.js +154 -0
- package/dist/src/tui/live-text.js.map +1 -0
- package/dist/src/tui/markdown.d.ts +62 -0
- package/dist/src/tui/markdown.js +244 -0
- package/dist/src/tui/markdown.js.map +1 -0
- package/dist/src/tui/mcp-format.d.ts +28 -0
- package/dist/src/tui/mcp-format.js +67 -0
- package/dist/src/tui/mcp-format.js.map +1 -0
- package/dist/src/tui/path-completion.d.ts +119 -0
- package/dist/src/tui/path-completion.js +305 -0
- package/dist/src/tui/path-completion.js.map +1 -0
- package/dist/src/tui/permission-queue.d.ts +61 -0
- package/dist/src/tui/permission-queue.js +129 -0
- package/dist/src/tui/permission-queue.js.map +1 -0
- package/dist/src/tui/plan-format.d.ts +9 -0
- package/dist/src/tui/plan-format.js +30 -0
- package/dist/src/tui/plan-format.js.map +1 -0
- package/dist/src/tui/prompt-completion.d.ts +22 -0
- package/dist/src/tui/prompt-completion.js +46 -0
- package/dist/src/tui/prompt-completion.js.map +1 -0
- package/dist/src/tui/prompt-editor.d.ts +102 -0
- package/dist/src/tui/prompt-editor.js +379 -0
- package/dist/src/tui/prompt-editor.js.map +1 -0
- package/dist/src/tui/prompt-history-search.d.ts +53 -0
- package/dist/src/tui/prompt-history-search.js +123 -0
- package/dist/src/tui/prompt-history-search.js.map +1 -0
- package/dist/src/tui/prompt-queue.d.ts +58 -0
- package/dist/src/tui/prompt-queue.js +74 -0
- package/dist/src/tui/prompt-queue.js.map +1 -0
- package/dist/src/tui/prompt-recall.d.ts +74 -0
- package/dist/src/tui/prompt-recall.js +90 -0
- package/dist/src/tui/prompt-recall.js.map +1 -0
- package/dist/src/tui/react-environment.d.ts +11 -0
- package/dist/src/tui/react-environment.js +24 -0
- package/dist/src/tui/react-environment.js.map +1 -0
- package/dist/src/tui/rewind-search.d.ts +34 -0
- package/dist/src/tui/rewind-search.js +68 -0
- package/dist/src/tui/rewind-search.js.map +1 -0
- package/dist/src/tui/shell-command.d.ts +114 -0
- package/dist/src/tui/shell-command.js +310 -0
- package/dist/src/tui/shell-command.js.map +1 -0
- package/dist/src/tui/spend-advisory.d.ts +52 -0
- package/dist/src/tui/spend-advisory.js +64 -0
- package/dist/src/tui/spend-advisory.js.map +1 -0
- package/dist/src/tui/status-format.d.ts +120 -0
- package/dist/src/tui/status-format.js +192 -0
- package/dist/src/tui/status-format.js.map +1 -0
- package/dist/src/tui/subagent-format.d.ts +49 -0
- package/dist/src/tui/subagent-format.js +146 -0
- package/dist/src/tui/subagent-format.js.map +1 -0
- package/dist/src/tui/task-format.d.ts +29 -0
- package/dist/src/tui/task-format.js +87 -0
- package/dist/src/tui/task-format.js.map +1 -0
- package/dist/src/tui/terminal-bell.d.ts +20 -0
- package/dist/src/tui/terminal-bell.js +33 -0
- package/dist/src/tui/terminal-bell.js.map +1 -0
- package/dist/src/tui/tool-detail-presentation.d.ts +60 -0
- package/dist/src/tui/tool-detail-presentation.js +206 -0
- package/dist/src/tui/tool-detail-presentation.js.map +1 -0
- package/dist/src/tui/turn-state.d.ts +195 -0
- package/dist/src/tui/turn-state.js +548 -0
- package/dist/src/tui/turn-state.js.map +1 -0
- package/dist/src/tui/visual-language.d.ts +45 -0
- package/dist/src/tui/visual-language.js +57 -0
- package/dist/src/tui/visual-language.js.map +1 -0
- package/dist/src/version.d.ts +7 -0
- package/dist/src/version.js +38 -0
- package/dist/src/version.js.map +1 -0
- package/package.json +60 -0
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"dispatch-registry.js","sourceRoot":"","sources":["../../../src/agents/dispatch-registry.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,44 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* SER-063: keep a failed child's evidence.
|
|
3
|
+
*
|
|
4
|
+
* When a child agent's invocation throws, the SDK turns that error into the
|
|
5
|
+
* parent's error tool result and everything the child had already said is
|
|
6
|
+
* lost. This module builds the error to rethrow instead: the original message,
|
|
7
|
+
* one fixed note, and the child's *last assistant text* — bounded to a stated
|
|
8
|
+
* cap and passed through the same SER-062 projection a success report gets.
|
|
9
|
+
*
|
|
10
|
+
* Only that one message is read. Reasoning blocks, tool-use/tool-result blocks,
|
|
11
|
+
* earlier turns and the system prompt never cross, so the "records never carry
|
|
12
|
+
* child transcript" invariant holds; the SDK never stores a message whose own
|
|
13
|
+
* stream failed, so what surfaces is either the retained max-tokens partial or
|
|
14
|
+
* the last assistant message completed before the failing model call.
|
|
15
|
+
*
|
|
16
|
+
* The result is still an *error*: `dispatch.finish('failed')`, the retry guard's
|
|
17
|
+
* failure count (its class comes from `name`, which is preserved) and
|
|
18
|
+
* `turnEnded.failure` are unchanged in shape — only the message is longer. A
|
|
19
|
+
* child with no assistant text yields the original error object (`===`), and a
|
|
20
|
+
* cancelled child is never wrapped: cancellation is not a failure.
|
|
21
|
+
*/
|
|
22
|
+
import type { InvocationState, Message } from '@strands-agents/sdk';
|
|
23
|
+
/** Maximum code points of the child's last assistant text carried in the error. */
|
|
24
|
+
export declare const FAILED_CHILD_TEXT_CAP = 4000;
|
|
25
|
+
/** The fixed line separating the original message from the retained text. */
|
|
26
|
+
export declare const FAILED_CHILD_NOTE = "subagent was cut off before finishing; its last output follows:";
|
|
27
|
+
/** The slice of a child this module reads — structural, so tests need no Agent. */
|
|
28
|
+
export interface FailedChild {
|
|
29
|
+
readonly messages: readonly Message[];
|
|
30
|
+
readonly cancelSignal: AbortSignal;
|
|
31
|
+
}
|
|
32
|
+
/**
|
|
33
|
+
* Returns the error `SubagentTool`/`WorkflowTool` should rethrow for a child whose
|
|
34
|
+
* invocation threw `error`. Same object when there is nothing to add.
|
|
35
|
+
*/
|
|
36
|
+
export declare function withFailedChildText(error: unknown, child: FailedChild, invocationState: InvocationState): unknown;
|
|
37
|
+
/**
|
|
38
|
+
* Splits a message produced by {@link withFailedChildText} into the original
|
|
39
|
+
* message and the note-plus-text tail; `tail` is `undefined` for any other message.
|
|
40
|
+
*/
|
|
41
|
+
export declare function splitFailedChildMessage(message: string): {
|
|
42
|
+
head: string;
|
|
43
|
+
tail: string | undefined;
|
|
44
|
+
};
|
|
@@ -0,0 +1,69 @@
|
|
|
1
|
+
import { retainedMaxTokensPartials } from '../agent/max-tokens-recovery.js';
|
|
2
|
+
import { projectChildReport } from './report-projection.js';
|
|
3
|
+
/** Maximum code points of the child's last assistant text carried in the error. */
|
|
4
|
+
export const FAILED_CHILD_TEXT_CAP = 4000;
|
|
5
|
+
/** The fixed line separating the original message from the retained text. */
|
|
6
|
+
export const FAILED_CHILD_NOTE = 'subagent was cut off before finishing; its last output follows:';
|
|
7
|
+
/**
|
|
8
|
+
* Returns the error `SubagentTool`/`WorkflowTool` should rethrow for a child whose
|
|
9
|
+
* invocation threw `error`. Same object when there is nothing to add.
|
|
10
|
+
*/
|
|
11
|
+
export function withFailedChildText(error, child, invocationState) {
|
|
12
|
+
if (!(error instanceof Error))
|
|
13
|
+
return error;
|
|
14
|
+
if (child.cancelSignal.aborted)
|
|
15
|
+
return error;
|
|
16
|
+
const text = lastAssistantText(child, invocationState);
|
|
17
|
+
if (text.trim() === '')
|
|
18
|
+
return error;
|
|
19
|
+
const bounded = projectChildReport(truncateCodePoints(text, FAILED_CHILD_TEXT_CAP));
|
|
20
|
+
const wrapped = new Error(`${error.message}\n${FAILED_CHILD_NOTE}\n${bounded}`, { cause: error });
|
|
21
|
+
wrapped.name = error.name;
|
|
22
|
+
return wrapped;
|
|
23
|
+
}
|
|
24
|
+
/**
|
|
25
|
+
* Splits a message produced by {@link withFailedChildText} into the original
|
|
26
|
+
* message and the note-plus-text tail; `tail` is `undefined` for any other message.
|
|
27
|
+
*/
|
|
28
|
+
export function splitFailedChildMessage(message) {
|
|
29
|
+
const marker = `\n${FAILED_CHILD_NOTE}\n`;
|
|
30
|
+
const at = message.indexOf(marker);
|
|
31
|
+
if (at === -1)
|
|
32
|
+
return { head: message, tail: undefined };
|
|
33
|
+
return { head: message.slice(0, at), tail: message.slice(at + 1) };
|
|
34
|
+
}
|
|
35
|
+
/**
|
|
36
|
+
* Max-tokens partials the recovery hook retained, then the last assistant
|
|
37
|
+
* message unless it *is* one of those partials (the hook pushes them into
|
|
38
|
+
* `messages` too, so it would otherwise be counted twice).
|
|
39
|
+
*/
|
|
40
|
+
function lastAssistantText(child, invocationState) {
|
|
41
|
+
const partials = retainedMaxTokensPartials(invocationState);
|
|
42
|
+
const pieces = partials.map(textOf);
|
|
43
|
+
for (let index = child.messages.length - 1; index >= 0; index -= 1) {
|
|
44
|
+
const message = child.messages[index];
|
|
45
|
+
if (message === undefined || message.role !== 'assistant')
|
|
46
|
+
continue;
|
|
47
|
+
if (!partials.includes(message))
|
|
48
|
+
pieces.push(textOf(message));
|
|
49
|
+
break;
|
|
50
|
+
}
|
|
51
|
+
return pieces.join('');
|
|
52
|
+
}
|
|
53
|
+
function textOf(message) {
|
|
54
|
+
return message.content.map((block) => (block.type === 'textBlock' ? block.text : '')).join('');
|
|
55
|
+
}
|
|
56
|
+
/** Keeps the first `cap` code points; the suffix states exactly how many were dropped. */
|
|
57
|
+
function truncateCodePoints(text, cap) {
|
|
58
|
+
let kept = '';
|
|
59
|
+
let seen = 0;
|
|
60
|
+
for (const codePoint of text) {
|
|
61
|
+
seen += 1;
|
|
62
|
+
if (seen <= cap)
|
|
63
|
+
kept += codePoint;
|
|
64
|
+
}
|
|
65
|
+
if (seen <= cap)
|
|
66
|
+
return text;
|
|
67
|
+
return `${kept}… [truncated ${seen - cap} code points]`;
|
|
68
|
+
}
|
|
69
|
+
//# sourceMappingURL=failed-child-text.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"failed-child-text.js","sourceRoot":"","sources":["../../../src/agents/failed-child-text.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,26 @@
|
|
|
1
|
+
export declare const AGENTS_DIRNAME = "agents";
|
|
2
|
+
export declare const DEFAULT_AGENT_NAME = "general";
|
|
3
|
+
export interface AgentDefinition {
|
|
4
|
+
name: string;
|
|
5
|
+
description: string;
|
|
6
|
+
systemPrompt: string;
|
|
7
|
+
/** Undefined means every child-eligible tool; an empty array means no tools. */
|
|
8
|
+
tools: readonly string[] | undefined;
|
|
9
|
+
/** Absolute Markdown source, or undefined for the built-in definition. */
|
|
10
|
+
file: string | undefined;
|
|
11
|
+
}
|
|
12
|
+
export interface AgentDefinitionProblem {
|
|
13
|
+
file: string;
|
|
14
|
+
reason: string;
|
|
15
|
+
}
|
|
16
|
+
export interface AgentDefinitionRegistry {
|
|
17
|
+
definitions: AgentDefinition[];
|
|
18
|
+
problems: AgentDefinitionProblem[];
|
|
19
|
+
}
|
|
20
|
+
/**
|
|
21
|
+
* Loads direct Markdown children of `<root>/.darwin/agents/`.
|
|
22
|
+
*
|
|
23
|
+
* Definitions are isolated configuration: one bad file is reported and skipped,
|
|
24
|
+
* while the built-in general agent and every other valid definition remain usable.
|
|
25
|
+
*/
|
|
26
|
+
export declare function loadAgentDefinitions(root: string, availableToolNames: readonly string[]): Promise<AgentDefinitionRegistry>;
|
|
@@ -0,0 +1,134 @@
|
|
|
1
|
+
import { lstat, readFile, readdir, realpath } from 'node:fs/promises';
|
|
2
|
+
import path from 'node:path';
|
|
3
|
+
import matter from 'gray-matter';
|
|
4
|
+
import { extensionRoots } from '../paths.js';
|
|
5
|
+
export const AGENTS_DIRNAME = 'agents';
|
|
6
|
+
export const DEFAULT_AGENT_NAME = 'general';
|
|
7
|
+
const DEFAULT_AGENT = {
|
|
8
|
+
name: DEFAULT_AGENT_NAME,
|
|
9
|
+
description: 'General-purpose agent for independent repository research, coding, and verification tasks.',
|
|
10
|
+
systemPrompt: [
|
|
11
|
+
'You are a general-purpose coding subagent working independently inside a repository.',
|
|
12
|
+
'Complete the delegated task using the available tools when evidence or changes are needed.',
|
|
13
|
+
'Follow all project instructions included below. Do not ask the end user questions: report blockers',
|
|
14
|
+
'to the parent agent instead. Finish with a concise, evidence-based report covering findings,',
|
|
15
|
+
'changes, verification, and any unresolved risks that apply.',
|
|
16
|
+
].join(' '),
|
|
17
|
+
tools: undefined,
|
|
18
|
+
file: undefined,
|
|
19
|
+
};
|
|
20
|
+
/**
|
|
21
|
+
* Loads direct Markdown children of `<root>/.darwin/agents/`.
|
|
22
|
+
*
|
|
23
|
+
* Definitions are isolated configuration: one bad file is reported and skipped,
|
|
24
|
+
* while the built-in general agent and every other valid definition remain usable.
|
|
25
|
+
*/
|
|
26
|
+
export async function loadAgentDefinitions(root, availableToolNames) {
|
|
27
|
+
const agentDirs = extensionRoots(root).map(({ root: extensionRoot }) => path.join(extensionRoot, AGENTS_DIRNAME));
|
|
28
|
+
const definitions = [DEFAULT_AGENT];
|
|
29
|
+
const problems = [];
|
|
30
|
+
const claimed = new Map([[DEFAULT_AGENT_NAME, 'the built-in general agent']]);
|
|
31
|
+
const knownTools = new Set(availableToolNames);
|
|
32
|
+
for (const agentsDir of [...new Set(agentDirs)]) {
|
|
33
|
+
let entries;
|
|
34
|
+
try {
|
|
35
|
+
entries = await readdir(agentsDir, { withFileTypes: true });
|
|
36
|
+
}
|
|
37
|
+
catch {
|
|
38
|
+
continue;
|
|
39
|
+
}
|
|
40
|
+
entries.sort((a, b) => a.name.localeCompare(b.name));
|
|
41
|
+
for (const entry of entries) {
|
|
42
|
+
if ((!entry.isFile() && !entry.isSymbolicLink()) || path.extname(entry.name).toLowerCase() !== '.md')
|
|
43
|
+
continue;
|
|
44
|
+
const file = path.join(agentsDir, entry.name);
|
|
45
|
+
let raw;
|
|
46
|
+
try {
|
|
47
|
+
if (entry.isSymbolicLink()) {
|
|
48
|
+
const target = await realpath(file);
|
|
49
|
+
if (!(await lstat(target)).isFile())
|
|
50
|
+
throw new Error(`symlink target is not a regular file: ${target}`);
|
|
51
|
+
}
|
|
52
|
+
// Read through the direct configured path after validating its current
|
|
53
|
+
// target. The accepted definition keeps that source identity too.
|
|
54
|
+
raw = await readFile(file, 'utf8');
|
|
55
|
+
}
|
|
56
|
+
catch (error) {
|
|
57
|
+
problems.push({ file, reason: `could not read file: ${describe(error)}` });
|
|
58
|
+
continue;
|
|
59
|
+
}
|
|
60
|
+
const parsed = parseDefinition(raw, file, knownTools);
|
|
61
|
+
if ('reason' in parsed) {
|
|
62
|
+
problems.push({ file, reason: parsed.reason });
|
|
63
|
+
continue;
|
|
64
|
+
}
|
|
65
|
+
const normalized = parsed.name.toLowerCase();
|
|
66
|
+
const owner = claimed.get(normalized);
|
|
67
|
+
if (owner !== undefined) {
|
|
68
|
+
problems.push({ file, reason: `agent name ${JSON.stringify(parsed.name)} conflicts with ${owner}` });
|
|
69
|
+
continue;
|
|
70
|
+
}
|
|
71
|
+
claimed.set(normalized, file);
|
|
72
|
+
definitions.push(parsed);
|
|
73
|
+
}
|
|
74
|
+
}
|
|
75
|
+
const custom = definitions.slice(1).sort((a, b) => a.name.localeCompare(b.name));
|
|
76
|
+
return { definitions: [DEFAULT_AGENT, ...custom], problems };
|
|
77
|
+
}
|
|
78
|
+
function parseDefinition(raw, file, knownTools) {
|
|
79
|
+
let data;
|
|
80
|
+
let content;
|
|
81
|
+
try {
|
|
82
|
+
({ data, content } = matter(raw));
|
|
83
|
+
}
|
|
84
|
+
catch (error) {
|
|
85
|
+
return { reason: `invalid YAML frontmatter: ${describe(error)}` };
|
|
86
|
+
}
|
|
87
|
+
const name = readString(data['name']);
|
|
88
|
+
if (name === undefined)
|
|
89
|
+
return { reason: 'frontmatter is missing a non-empty "name" field' };
|
|
90
|
+
if (!/^[a-zA-Z0-9_-]{1,64}$/.test(name)) {
|
|
91
|
+
return { reason: `agent name ${JSON.stringify(name)} must match [a-zA-Z0-9_-]{1,64}` };
|
|
92
|
+
}
|
|
93
|
+
const description = readString(data['description']);
|
|
94
|
+
if (description === undefined) {
|
|
95
|
+
return { reason: 'frontmatter is missing a non-empty "description" field' };
|
|
96
|
+
}
|
|
97
|
+
const systemPrompt = content.trim();
|
|
98
|
+
if (systemPrompt === '')
|
|
99
|
+
return { reason: 'agent system prompt is empty' };
|
|
100
|
+
const parsedTools = parseTools(data['tools'], knownTools);
|
|
101
|
+
if ('reason' in parsedTools)
|
|
102
|
+
return parsedTools;
|
|
103
|
+
return { name, description, systemPrompt, tools: parsedTools.tools, file };
|
|
104
|
+
}
|
|
105
|
+
function parseTools(value, knownTools) {
|
|
106
|
+
if (value === undefined)
|
|
107
|
+
return { tools: undefined };
|
|
108
|
+
if (!Array.isArray(value))
|
|
109
|
+
return { reason: 'frontmatter "tools" must be an array of tool names' };
|
|
110
|
+
const tools = [];
|
|
111
|
+
const seen = new Set();
|
|
112
|
+
for (const item of value) {
|
|
113
|
+
const name = readString(item);
|
|
114
|
+
if (name === undefined)
|
|
115
|
+
return { reason: 'frontmatter "tools" entries must be non-empty strings' };
|
|
116
|
+
if (seen.has(name))
|
|
117
|
+
return { reason: `frontmatter "tools" contains duplicate ${JSON.stringify(name)}` };
|
|
118
|
+
if (!knownTools.has(name))
|
|
119
|
+
return { reason: `frontmatter "tools" names unknown tool ${JSON.stringify(name)}` };
|
|
120
|
+
seen.add(name);
|
|
121
|
+
tools.push(name);
|
|
122
|
+
}
|
|
123
|
+
return { tools };
|
|
124
|
+
}
|
|
125
|
+
function readString(value) {
|
|
126
|
+
if (typeof value !== 'string')
|
|
127
|
+
return undefined;
|
|
128
|
+
const trimmed = value.trim();
|
|
129
|
+
return trimmed === '' ? undefined : trimmed;
|
|
130
|
+
}
|
|
131
|
+
function describe(error) {
|
|
132
|
+
return error instanceof Error ? error.message : String(error);
|
|
133
|
+
}
|
|
134
|
+
//# sourceMappingURL=loader.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"loader.js","sourceRoot":"","sources":["../../../src/agents/loader.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,31 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* One pure projection over a child's final report at the two seams where child
|
|
3
|
+
* text becomes a parent tool result (`SubagentTool.run`, the `workflow` terminus).
|
|
4
|
+
*
|
|
5
|
+
* A child's report is model output the parent reads as a tool result. When that
|
|
6
|
+
* text imitates darwin's own prompt framing (`<project-instructions>`,
|
|
7
|
+
* `<available_skills>`, `<working-context>`, `<system-reminder>`) or a transcript
|
|
8
|
+
* role line (`Human:` / `Assistant:`), the parent could mistake it for the
|
|
9
|
+
* harness speaking. This module makes the imitation read as literal text — one
|
|
10
|
+
* backslash inserted at the start of each such line — and prepends one bounded
|
|
11
|
+
* marker line naming what matched. Permission-bypass vocabulary only earns the
|
|
12
|
+
* marker; the text itself stays as written. Nothing is ever removed, reordered
|
|
13
|
+
* or reworded, and a clean report is returned byte-identical, so the projected
|
|
14
|
+
* string *is* the ordinary tool result: trajectory, replay, the retry guard and
|
|
15
|
+
* dispatch records all see one value and no new record, notice or row exists.
|
|
16
|
+
*
|
|
17
|
+
* This is a report-level projection, **not a security boundary**: a tool call
|
|
18
|
+
* the report leads the parent to make still goes through the permission gate,
|
|
19
|
+
* and the parent model is free to read the escaped text. Idempotent
|
|
20
|
+
* (`projectChildReport(projectChildReport(x)) === projectChildReport(x)`) and
|
|
21
|
+
* O(n) over lines with anchored prefix checks only — no I/O, no backtracking
|
|
22
|
+
* patterns. Peer evidence: Claude Code "Subagent output scanning" (v2.1.210).
|
|
23
|
+
*/
|
|
24
|
+
export type ReportPatternCategory = 'framing-tag' | 'transcript-role' | 'permission-vocabulary';
|
|
25
|
+
export declare const REPORT_MARKER_PREFIX = "[darwin: subagent report matched instruction-shaped pattern(s): ";
|
|
26
|
+
/**
|
|
27
|
+
* Projects one child report. Returns the same string object when nothing matched.
|
|
28
|
+
* Lines are split on `\n`; a trailing `\r` stays on its line, so CRLF input keeps
|
|
29
|
+
* its line endings and the marker line borrows the report's own ending.
|
|
30
|
+
*/
|
|
31
|
+
export declare function projectChildReport(text: string): string;
|
|
@@ -0,0 +1,125 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* One pure projection over a child's final report at the two seams where child
|
|
3
|
+
* text becomes a parent tool result (`SubagentTool.run`, the `workflow` terminus).
|
|
4
|
+
*
|
|
5
|
+
* A child's report is model output the parent reads as a tool result. When that
|
|
6
|
+
* text imitates darwin's own prompt framing (`<project-instructions>`,
|
|
7
|
+
* `<available_skills>`, `<working-context>`, `<system-reminder>`) or a transcript
|
|
8
|
+
* role line (`Human:` / `Assistant:`), the parent could mistake it for the
|
|
9
|
+
* harness speaking. This module makes the imitation read as literal text — one
|
|
10
|
+
* backslash inserted at the start of each such line — and prepends one bounded
|
|
11
|
+
* marker line naming what matched. Permission-bypass vocabulary only earns the
|
|
12
|
+
* marker; the text itself stays as written. Nothing is ever removed, reordered
|
|
13
|
+
* or reworded, and a clean report is returned byte-identical, so the projected
|
|
14
|
+
* string *is* the ordinary tool result: trajectory, replay, the retry guard and
|
|
15
|
+
* dispatch records all see one value and no new record, notice or row exists.
|
|
16
|
+
*
|
|
17
|
+
* This is a report-level projection, **not a security boundary**: a tool call
|
|
18
|
+
* the report leads the parent to make still goes through the permission gate,
|
|
19
|
+
* and the parent model is free to read the escaped text. Idempotent
|
|
20
|
+
* (`projectChildReport(projectChildReport(x)) === projectChildReport(x)`) and
|
|
21
|
+
* O(n) over lines with anchored prefix checks only — no I/O, no backtracking
|
|
22
|
+
* patterns. Peer evidence: Claude Code "Subagent output scanning" (v2.1.210).
|
|
23
|
+
*/
|
|
24
|
+
/** Fixed vocabulary, fixed order — the marker line is deterministic. */
|
|
25
|
+
const CATEGORY_ORDER = ['framing-tag', 'transcript-role', 'permission-vocabulary'];
|
|
26
|
+
/** darwin's own framing tags (lower case; matched case-insensitively). */
|
|
27
|
+
const FRAMING_TAGS = ['project-instructions', 'available_skills', 'working-context', 'system-reminder'];
|
|
28
|
+
/** Transcript role prefixes, exact case. */
|
|
29
|
+
const TRANSCRIPT_ROLES = ['Human:', 'Assistant:'];
|
|
30
|
+
/** Permission-bypass vocabulary (lower case; matched case-insensitively anywhere). */
|
|
31
|
+
const PERMISSION_VOCABULARY = [
|
|
32
|
+
'alwaysallow',
|
|
33
|
+
'permissionmode',
|
|
34
|
+
'--dangerously',
|
|
35
|
+
'bypasspermissions',
|
|
36
|
+
'skip-permissions',
|
|
37
|
+
'--yolo',
|
|
38
|
+
];
|
|
39
|
+
export const REPORT_MARKER_PREFIX = '[darwin: subagent report matched instruction-shaped pattern(s): ';
|
|
40
|
+
const REPORT_MARKER_SUFFIX = ']';
|
|
41
|
+
/**
|
|
42
|
+
* Projects one child report. Returns the same string object when nothing matched.
|
|
43
|
+
* Lines are split on `\n`; a trailing `\r` stays on its line, so CRLF input keeps
|
|
44
|
+
* its line endings and the marker line borrows the report's own ending.
|
|
45
|
+
*/
|
|
46
|
+
export function projectChildReport(text) {
|
|
47
|
+
const lines = text.split('\n');
|
|
48
|
+
const categories = new Set();
|
|
49
|
+
// A leading marker line from an earlier projection is recognized (exact
|
|
50
|
+
// prefix, known categories only) and folded into this pass, so projecting
|
|
51
|
+
// twice adds nothing and a marker never stacks. Anything else is report text.
|
|
52
|
+
const existing = parseMarker(lines[0] ?? '');
|
|
53
|
+
const bodyStart = existing === undefined ? 0 : 1;
|
|
54
|
+
for (const category of existing ?? [])
|
|
55
|
+
categories.add(category);
|
|
56
|
+
let escaped = false;
|
|
57
|
+
for (let index = bodyStart; index < lines.length; index += 1) {
|
|
58
|
+
const line = lines[index] ?? '';
|
|
59
|
+
const category = lineCategory(line);
|
|
60
|
+
if (category === undefined)
|
|
61
|
+
continue;
|
|
62
|
+
categories.add(category);
|
|
63
|
+
const cut = leadingWhitespaceLength(line);
|
|
64
|
+
lines[index] = `${line.slice(0, cut)}\\${line.slice(cut)}`;
|
|
65
|
+
escaped = true;
|
|
66
|
+
}
|
|
67
|
+
if (mentionsPermissionVocabulary(text, bodyStart === 1 ? (lines[0]?.length ?? 0) + 1 : 0)) {
|
|
68
|
+
categories.add('permission-vocabulary');
|
|
69
|
+
}
|
|
70
|
+
if (categories.size === 0)
|
|
71
|
+
return text;
|
|
72
|
+
if (!escaped && existing !== undefined && categories.size === existing.length)
|
|
73
|
+
return text;
|
|
74
|
+
const marker = `${REPORT_MARKER_PREFIX}${CATEGORY_ORDER.filter((c) => categories.has(c)).join(', ')}${REPORT_MARKER_SUFFIX}`;
|
|
75
|
+
const eol = (lines[bodyStart] ?? '').endsWith('\r') ? '\r\n' : '\n';
|
|
76
|
+
const projected = `${marker}${eol}${lines.slice(bodyStart).join('\n')}`;
|
|
77
|
+
// A second pass over an already-projected report rebuilds the same bytes.
|
|
78
|
+
return projected === text ? text : projected;
|
|
79
|
+
}
|
|
80
|
+
/** The category one line matches at its start, or `undefined` when it is plain text. */
|
|
81
|
+
function lineCategory(line) {
|
|
82
|
+
const rest = line.slice(leadingWhitespaceLength(line));
|
|
83
|
+
if (rest.startsWith('<'))
|
|
84
|
+
return isFramingTag(rest) ? 'framing-tag' : undefined;
|
|
85
|
+
for (const role of TRANSCRIPT_ROLES)
|
|
86
|
+
if (rest.startsWith(role))
|
|
87
|
+
return 'transcript-role';
|
|
88
|
+
return undefined;
|
|
89
|
+
}
|
|
90
|
+
/** `<tag` or `</tag` followed by `>`, whitespace, `/` or end of line — case-insensitive. */
|
|
91
|
+
function isFramingTag(rest) {
|
|
92
|
+
const lower = rest.toLowerCase();
|
|
93
|
+
const nameStart = lower.startsWith('</') ? 2 : 1;
|
|
94
|
+
for (const tag of FRAMING_TAGS) {
|
|
95
|
+
if (!lower.startsWith(tag, nameStart))
|
|
96
|
+
continue;
|
|
97
|
+
const next = lower.charAt(nameStart + tag.length);
|
|
98
|
+
if (next === '' || next === '>' || next === '/' || next === ' ' || next === '\t' || next === '\r')
|
|
99
|
+
return true;
|
|
100
|
+
}
|
|
101
|
+
return false;
|
|
102
|
+
}
|
|
103
|
+
function leadingWhitespaceLength(line) {
|
|
104
|
+
let index = 0;
|
|
105
|
+
while (index < line.length && (line[index] === ' ' || line[index] === '\t'))
|
|
106
|
+
index += 1;
|
|
107
|
+
return index;
|
|
108
|
+
}
|
|
109
|
+
function mentionsPermissionVocabulary(text, from) {
|
|
110
|
+
const lower = text.slice(from).toLowerCase();
|
|
111
|
+
return PERMISSION_VOCABULARY.some((word) => lower.includes(word));
|
|
112
|
+
}
|
|
113
|
+
/** Parses a line produced by this module; an unknown or non-canonical list means it is not ours. */
|
|
114
|
+
function parseMarker(line) {
|
|
115
|
+
const trimmed = line.endsWith('\r') ? line.slice(0, -1) : line;
|
|
116
|
+
if (!trimmed.startsWith(REPORT_MARKER_PREFIX) || !trimmed.endsWith(REPORT_MARKER_SUFFIX))
|
|
117
|
+
return undefined;
|
|
118
|
+
const inner = trimmed.slice(REPORT_MARKER_PREFIX.length, -REPORT_MARKER_SUFFIX.length);
|
|
119
|
+
const listed = new Set(inner.split(', '));
|
|
120
|
+
const canonical = CATEGORY_ORDER.filter((category) => listed.has(category));
|
|
121
|
+
if (canonical.length === 0 || canonical.join(', ') !== inner)
|
|
122
|
+
return undefined;
|
|
123
|
+
return canonical;
|
|
124
|
+
}
|
|
125
|
+
//# sourceMappingURL=report-projection.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"report-projection.js","sourceRoot":"","sources":["../../../src/agents/report-projection.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,61 @@
|
|
|
1
|
+
import { Agent } from '@strands-agents/sdk';
|
|
2
|
+
import type { InterventionHandler, Model, Tool } from '@strands-agents/sdk';
|
|
3
|
+
import type { ProjectInstructions } from '../agent/instructions.js';
|
|
4
|
+
import type { AppConfig } from '../config.js';
|
|
5
|
+
import { type CodexHookRunner } from '../hooks/codex-hook-runner.js';
|
|
6
|
+
import type { SubagentDispatchRegistry } from './dispatch-registry.js';
|
|
7
|
+
import type { AgentDefinitionRegistry } from './loader.js';
|
|
8
|
+
export declare const SUBAGENT_TOOL_NAME = "subagent";
|
|
9
|
+
type ChildAgentObserver = (agent: Agent) => void;
|
|
10
|
+
export interface SubagentToolOptions {
|
|
11
|
+
registry: AgentDefinitionRegistry;
|
|
12
|
+
tools: readonly Tool[];
|
|
13
|
+
intervention: InterventionHandler;
|
|
14
|
+
projectInstructions: ProjectInstructions | undefined;
|
|
15
|
+
config: AppConfig;
|
|
16
|
+
createModel: (config: AppConfig) => Promise<Model>;
|
|
17
|
+
/**
|
|
18
|
+
* Records per-dispatch state and gives the permission gate its provenance.
|
|
19
|
+
* Omitted only by narrow tests that exercise isolation alone: without it a
|
|
20
|
+
* dispatch is unobservable and its child's approvals cannot be labelled.
|
|
21
|
+
*/
|
|
22
|
+
dispatches?: SubagentDispatchRegistry;
|
|
23
|
+
/** Shared portable hook policy; child context remains invocation-local. */
|
|
24
|
+
codexHooks?: CodexHookRunner;
|
|
25
|
+
/** Test/diagnostic observer; receives the real child after initialization. */
|
|
26
|
+
onChildInitialized?: ChildAgentObserver;
|
|
27
|
+
}
|
|
28
|
+
/**
|
|
29
|
+
* Owns the main agent's delegation tool and every transient child it creates.
|
|
30
|
+
*
|
|
31
|
+
* This deliberately does not use SDK `Agent.asTool()`: that adapter forwards the
|
|
32
|
+
* child's stream events through the parent tool stream. Consuming `invoke()` here
|
|
33
|
+
* keeps the child's reasoning, messages, and tool transcript private and returns
|
|
34
|
+
* only its final report to the main conversation.
|
|
35
|
+
*
|
|
36
|
+
* Dispatch is re-entrant, and the SDK's default `ConcurrentToolExecutor` races the
|
|
37
|
+
* per-tool generators, so two `subagent` blocks in one assistant message really do
|
|
38
|
+
* run at the same time (measured in `spike/verify-subagents.ts`). That parallelism
|
|
39
|
+
* is scoped to **read-heavy** delegation on purpose: concurrent children share one
|
|
40
|
+
* working tree with no isolation or conflict detection, so nothing here makes
|
|
41
|
+
* concurrent write delegation safe. Keep mutation on one agent at a time.
|
|
42
|
+
*/
|
|
43
|
+
export declare class SubagentTool {
|
|
44
|
+
private readonly options;
|
|
45
|
+
readonly tool: Tool;
|
|
46
|
+
private config;
|
|
47
|
+
private readonly activeAgents;
|
|
48
|
+
private readonly activeExecutions;
|
|
49
|
+
constructor(options: SubagentToolOptions);
|
|
50
|
+
/** Future dispatches use this config; active children keep their existing model. */
|
|
51
|
+
updateConfig(config: AppConfig): void;
|
|
52
|
+
/** Cooperatively stops every child currently running. */
|
|
53
|
+
cancelActive(): void;
|
|
54
|
+
/** Cancels active children and waits for their per-dispatch cleanup to finish. */
|
|
55
|
+
shutdown(): Promise<void>;
|
|
56
|
+
private track;
|
|
57
|
+
private dispatch;
|
|
58
|
+
private run;
|
|
59
|
+
private find;
|
|
60
|
+
}
|
|
61
|
+
export {};
|