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,180 @@
|
|
|
1
|
+
import { Agent, tool } from '@strands-agents/sdk';
|
|
2
|
+
import { z } from 'zod';
|
|
3
|
+
import { backgroundDelegationDescriptionClause } from '../agent/background-delegation.js';
|
|
4
|
+
import { withRetainedMaxTokensText } from '../agent/max-tokens-recovery.js';
|
|
5
|
+
import { CHILD_REFUSAL_ERROR, isRefusalStop } from '../agent/refusal.js';
|
|
6
|
+
import { injectCodexContext } from '../hooks/codex-hook-runner.js';
|
|
7
|
+
import { buildRecipeChild, stopBashSession } from './child-recipe.js';
|
|
8
|
+
import { concurrencyCap, concurrencyDescriptionClause, concurrencyLimitMessage } from './concurrency-limit.js';
|
|
9
|
+
import { withFailedChildText } from './failed-child-text.js';
|
|
10
|
+
import { DEFAULT_AGENT_NAME } from './loader.js';
|
|
11
|
+
import { projectChildReport } from './report-projection.js';
|
|
12
|
+
export const SUBAGENT_TOOL_NAME = 'subagent';
|
|
13
|
+
/**
|
|
14
|
+
* Owns the main agent's delegation tool and every transient child it creates.
|
|
15
|
+
*
|
|
16
|
+
* This deliberately does not use SDK `Agent.asTool()`: that adapter forwards the
|
|
17
|
+
* child's stream events through the parent tool stream. Consuming `invoke()` here
|
|
18
|
+
* keeps the child's reasoning, messages, and tool transcript private and returns
|
|
19
|
+
* only its final report to the main conversation.
|
|
20
|
+
*
|
|
21
|
+
* Dispatch is re-entrant, and the SDK's default `ConcurrentToolExecutor` races the
|
|
22
|
+
* per-tool generators, so two `subagent` blocks in one assistant message really do
|
|
23
|
+
* run at the same time (measured in `spike/verify-subagents.ts`). That parallelism
|
|
24
|
+
* is scoped to **read-heavy** delegation on purpose: concurrent children share one
|
|
25
|
+
* working tree with no isolation or conflict detection, so nothing here makes
|
|
26
|
+
* concurrent write delegation safe. Keep mutation on one agent at a time.
|
|
27
|
+
*/
|
|
28
|
+
export class SubagentTool {
|
|
29
|
+
options;
|
|
30
|
+
tool;
|
|
31
|
+
config;
|
|
32
|
+
activeAgents = new Set();
|
|
33
|
+
activeExecutions = new Set();
|
|
34
|
+
constructor(options) {
|
|
35
|
+
this.options = options;
|
|
36
|
+
this.config = options.config;
|
|
37
|
+
const catalogue = options.registry.definitions
|
|
38
|
+
.map((definition) => `${definition.name}: ${definition.description}`)
|
|
39
|
+
.join('; ');
|
|
40
|
+
this.tool = tool({
|
|
41
|
+
name: SUBAGENT_TOOL_NAME,
|
|
42
|
+
description: 'Delegate a self-contained task to a fresh child agent with an independent context. ' +
|
|
43
|
+
`Only the final report is returned. ${concurrencyDescriptionClause(concurrencyCap(options.config))} ` +
|
|
44
|
+
`${backgroundDelegationDescriptionClause()} ` +
|
|
45
|
+
`Available agents: ${catalogue}`,
|
|
46
|
+
inputSchema: z.object({
|
|
47
|
+
task: z.string().min(1).describe('A complete, self-contained task for the child agent'),
|
|
48
|
+
agent: z.string().optional().describe(`Agent name; defaults to ${DEFAULT_AGENT_NAME}`),
|
|
49
|
+
}),
|
|
50
|
+
callback: ({ task, agent }, context) => this.track(task, agent, context),
|
|
51
|
+
});
|
|
52
|
+
}
|
|
53
|
+
/** Future dispatches use this config; active children keep their existing model. */
|
|
54
|
+
updateConfig(config) {
|
|
55
|
+
this.config = config;
|
|
56
|
+
}
|
|
57
|
+
/** Cooperatively stops every child currently running. */
|
|
58
|
+
cancelActive() {
|
|
59
|
+
for (const agent of this.activeAgents)
|
|
60
|
+
agent.cancel();
|
|
61
|
+
}
|
|
62
|
+
/** Cancels active children and waits for their per-dispatch cleanup to finish. */
|
|
63
|
+
async shutdown() {
|
|
64
|
+
this.cancelActive();
|
|
65
|
+
await Promise.allSettled([...this.activeExecutions]);
|
|
66
|
+
}
|
|
67
|
+
track(task, requestedName, context) {
|
|
68
|
+
const execution = this.dispatch(task, requestedName, context);
|
|
69
|
+
this.activeExecutions.add(execution);
|
|
70
|
+
void execution.then(() => this.activeExecutions.delete(execution), () => this.activeExecutions.delete(execution));
|
|
71
|
+
return execution;
|
|
72
|
+
}
|
|
73
|
+
async dispatch(task, requestedName, context) {
|
|
74
|
+
const definition = this.find(requestedName ?? DEFAULT_AGENT_NAME);
|
|
75
|
+
if (definition === undefined) {
|
|
76
|
+
const available = this.options.registry.definitions.map((candidate) => candidate.name).join(', ');
|
|
77
|
+
return `No subagent named ${JSON.stringify(requestedName)}. Available agents: ${available}.`;
|
|
78
|
+
}
|
|
79
|
+
// The ceiling is checked before anything is constructed: a refused call
|
|
80
|
+
// builds no model, begins no dispatch and creates no child. Settlement on the
|
|
81
|
+
// registry's terminal transition is the only thing that frees a slot, so the
|
|
82
|
+
// error tells the model to wait for a result rather than retry. Live config
|
|
83
|
+
// on purpose (not a constructor snapshot): `/model` hands the tool a new one.
|
|
84
|
+
if (this.options.dispatches !== undefined) {
|
|
85
|
+
const cap = concurrencyCap(this.config);
|
|
86
|
+
const running = this.options.dispatches.runningCount();
|
|
87
|
+
if (running >= cap)
|
|
88
|
+
throw new Error(concurrencyLimitMessage(cap, running));
|
|
89
|
+
}
|
|
90
|
+
// Recorded only once the request names a real agent: an unknown name never
|
|
91
|
+
// dispatched anything, so it must not show up as a run that failed.
|
|
92
|
+
const dispatch = this.options.dispatches?.begin({
|
|
93
|
+
agentName: definition.name,
|
|
94
|
+
task,
|
|
95
|
+
toolUseId: context?.toolUse.toolUseId,
|
|
96
|
+
});
|
|
97
|
+
try {
|
|
98
|
+
return await this.run(definition, task, dispatch, context);
|
|
99
|
+
}
|
|
100
|
+
catch (error) {
|
|
101
|
+
dispatch?.finish('failed');
|
|
102
|
+
throw error;
|
|
103
|
+
}
|
|
104
|
+
}
|
|
105
|
+
async run(definition, task, dispatch, context) {
|
|
106
|
+
// Snapshot the live config before the async model construction. A concurrent
|
|
107
|
+
// /model switch affects the next dispatch, never a child already being built.
|
|
108
|
+
const config = this.config;
|
|
109
|
+
const model = await this.options.createModel(config);
|
|
110
|
+
// Cancellation can land while a provider module/model is being constructed,
|
|
111
|
+
// before there is a child Agent to cancel. Targeted cancellation uses the same
|
|
112
|
+
// latch, without cancelling the parent or a sibling dispatch.
|
|
113
|
+
if (context?.agent.cancelSignal.aborted === true || dispatch?.cancellationRequested() === true) {
|
|
114
|
+
dispatch?.finish('cancelled');
|
|
115
|
+
return 'Subagent task cancelled.';
|
|
116
|
+
}
|
|
117
|
+
// A child owns its portable lifecycle commands so targeted cancellation and
|
|
118
|
+
// settlement cannot cancel or wait on a sibling or parent hook process.
|
|
119
|
+
const childCodexHooks = this.options.codexHooks?.fork();
|
|
120
|
+
const child = buildRecipeChild({
|
|
121
|
+
definition,
|
|
122
|
+
config,
|
|
123
|
+
model,
|
|
124
|
+
tools: this.options.tools,
|
|
125
|
+
intervention: this.options.intervention,
|
|
126
|
+
projectInstructions: this.options.projectInstructions,
|
|
127
|
+
idPrefix: 'subagent',
|
|
128
|
+
dispatch,
|
|
129
|
+
});
|
|
130
|
+
this.activeAgents.add(child);
|
|
131
|
+
const cancelChild = () => child.cancel();
|
|
132
|
+
context?.agent.cancelSignal.addEventListener('abort', cancelChild, { once: true });
|
|
133
|
+
const invocationState = {};
|
|
134
|
+
try {
|
|
135
|
+
await child.initialize();
|
|
136
|
+
this.options.onChildInitialized?.(child);
|
|
137
|
+
const hookContext = await childCodexHooks?.subagentStart({
|
|
138
|
+
id: child.id,
|
|
139
|
+
name: definition.name,
|
|
140
|
+
});
|
|
141
|
+
const result = await child.invoke(injectCodexContext(task, hookContext), { invocationState });
|
|
142
|
+
// A refused child is a failed delegation, not a report: the SDK ends the turn
|
|
143
|
+
// normally, so the outcome has to be named here before it reads as success.
|
|
144
|
+
if (isRefusalStop(result.stopReason))
|
|
145
|
+
throw new Error(CHILD_REFUSAL_ERROR);
|
|
146
|
+
const outcome = result.stopReason === 'cancelled' ? 'cancelled' : 'succeeded';
|
|
147
|
+
dispatch?.finish(outcome);
|
|
148
|
+
// The one seam where child text becomes the parent's tool result: escape
|
|
149
|
+
// imitation of darwin's own framing and mark it, never remove or reword.
|
|
150
|
+
const report = projectChildReport(withRetainedMaxTokensText(result.toString(), invocationState));
|
|
151
|
+
// Child assistant text is private until the ordinary bounded tool result is
|
|
152
|
+
// returned. Do not duplicate it into a lifecycle command payload.
|
|
153
|
+
void childCodexHooks?.subagentStop({
|
|
154
|
+
id: child.id,
|
|
155
|
+
name: definition.name,
|
|
156
|
+
outcome,
|
|
157
|
+
});
|
|
158
|
+
return report;
|
|
159
|
+
}
|
|
160
|
+
catch (error) {
|
|
161
|
+
// Still an error (dispatch settles `failed` in the caller): only the message
|
|
162
|
+
// grows, by the child's bounded last assistant text through the same projection.
|
|
163
|
+
throw withFailedChildText(error, child, invocationState);
|
|
164
|
+
}
|
|
165
|
+
finally {
|
|
166
|
+
context?.agent.cancelSignal.removeEventListener('abort', cancelChild);
|
|
167
|
+
this.activeAgents.delete(child);
|
|
168
|
+
childCodexHooks?.cancel();
|
|
169
|
+
await Promise.allSettled([
|
|
170
|
+
stopBashSession(child),
|
|
171
|
+
childCodexHooks?.close() ?? Promise.resolve(),
|
|
172
|
+
]);
|
|
173
|
+
}
|
|
174
|
+
}
|
|
175
|
+
find(name) {
|
|
176
|
+
const normalized = name.trim().toLowerCase();
|
|
177
|
+
return this.options.registry.definitions.find((definition) => definition.name.toLowerCase() === normalized);
|
|
178
|
+
}
|
|
179
|
+
}
|
|
180
|
+
//# sourceMappingURL=subagent-tool.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"subagent-tool.js","sourceRoot":"","sources":["../../../src/agents/subagent-tool.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,85 @@
|
|
|
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 WORKFLOW_TOOL_NAME = "workflow";
|
|
9
|
+
export declare const MAX_WORKFLOW_NODES = 8;
|
|
10
|
+
/** The largest simple DAG on {@link MAX_WORKFLOW_NODES} nodes: n·(n−1)/2. */
|
|
11
|
+
export declare const MAX_WORKFLOW_EDGES = 28;
|
|
12
|
+
/** Declared write-scope prefixes per node (SER-065). */
|
|
13
|
+
export declare const MAX_WRITE_SCOPES = 8;
|
|
14
|
+
export interface WorkflowToolOptions {
|
|
15
|
+
registry: AgentDefinitionRegistry;
|
|
16
|
+
tools: readonly Tool[];
|
|
17
|
+
intervention: InterventionHandler;
|
|
18
|
+
projectInstructions: ProjectInstructions | undefined;
|
|
19
|
+
config: AppConfig;
|
|
20
|
+
createModel: (config: AppConfig) => Promise<Model>;
|
|
21
|
+
/** Same registry as `subagent`: nodes surface on the existing dispatch rows. */
|
|
22
|
+
dispatches?: SubagentDispatchRegistry;
|
|
23
|
+
/** Shared portable hook policy; each node gets its own fork. */
|
|
24
|
+
codexHooks?: CodexHookRunner;
|
|
25
|
+
/** Test/diagnostic observer; receives each real child after initialization. */
|
|
26
|
+
onChildInitialized?: (agent: Agent) => void;
|
|
27
|
+
}
|
|
28
|
+
/**
|
|
29
|
+
* Owns the parent's workflow tool and every transient child a DAG run creates.
|
|
30
|
+
*
|
|
31
|
+
* Like `SubagentTool`, this never uses SDK `Agent.asTool()` or forwards child
|
|
32
|
+
* stream events to the parent: the graph consumes each child privately and only
|
|
33
|
+
* terminus content returns. Parallel branches share one working tree with no
|
|
34
|
+
* isolation, so the description pins the rule: reads may run in parallel,
|
|
35
|
+
* writes must be serialized by edges. SER-065 makes that rule checkable: a node
|
|
36
|
+
* may declare `writeScopes`, unordered overlapping declarations are refused in
|
|
37
|
+
* `validate()`, and the scopes ride the dispatch record so the shared permission
|
|
38
|
+
* gate — never a new gate here — denies a scoped child's out-of-scope
|
|
39
|
+
* `fileEditor` write.
|
|
40
|
+
*/
|
|
41
|
+
export declare class WorkflowTool {
|
|
42
|
+
private readonly options;
|
|
43
|
+
readonly tool: Tool;
|
|
44
|
+
private config;
|
|
45
|
+
private readonly activeAgents;
|
|
46
|
+
private readonly activeControllers;
|
|
47
|
+
private readonly activeExecutions;
|
|
48
|
+
constructor(options: WorkflowToolOptions);
|
|
49
|
+
/** Future workflow runs use this config; active children keep their models. */
|
|
50
|
+
updateConfig(config: AppConfig): void;
|
|
51
|
+
/** Cooperatively stops every active graph run and its children. */
|
|
52
|
+
cancelActive(): void;
|
|
53
|
+
/** Cancels active runs and waits for their per-node cleanup to finish. */
|
|
54
|
+
shutdown(): Promise<void>;
|
|
55
|
+
private track;
|
|
56
|
+
private run;
|
|
57
|
+
/**
|
|
58
|
+
* The thin `InvokableAgent` seam between the SDK graph and one recipe child:
|
|
59
|
+
* its id is the user's node id (so edges and `[node: <id>]` dependency labels
|
|
60
|
+
* read as declared) while the inner Agent keeps a globally unique id for the
|
|
61
|
+
* dispatch registry. `stream()` prepends this node's own task to whatever
|
|
62
|
+
* dependency-merged input the SDK hands it — the merge itself stays the SDK's.
|
|
63
|
+
*/
|
|
64
|
+
private adapterFor;
|
|
65
|
+
private streamNode;
|
|
66
|
+
/** Bounded refusals, in input order; throws before any construction work. */
|
|
67
|
+
private validate;
|
|
68
|
+
private find;
|
|
69
|
+
}
|
|
70
|
+
/**
|
|
71
|
+
* One declared write scope, normalized (SER-065): `path.posix.normalize`, then
|
|
72
|
+
* the leading `./` and any trailing `/` stripped, so `./src/tui/` and `src/tui`
|
|
73
|
+
* are the same scope. Refused with a bounded error naming the node and the
|
|
74
|
+
* entry: absolute paths, empty or `.` (the whole project is not a scope — leave
|
|
75
|
+
* `writeScopes` off instead), anything that still starts with `..` after
|
|
76
|
+
* normalization (escapes the project root), and NUL bytes. Backslashes are
|
|
77
|
+
* ordinary characters here; scopes are posix-relative by contract.
|
|
78
|
+
*/
|
|
79
|
+
export declare function normalizeWriteScope(nodeId: string, entry: string): string;
|
|
80
|
+
/**
|
|
81
|
+
* Whether two normalized scopes denote the same subtree or one contains the
|
|
82
|
+
* other — by path segment, so `src/tu` and `src/tui` are disjoint while
|
|
83
|
+
* `src/tui` and `src/tui/App.tsx` overlap.
|
|
84
|
+
*/
|
|
85
|
+
export declare function scopesOverlap(a: string, b: string): boolean;
|