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,214 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Prompt ordering for the official AgentSkills plugin.
|
|
3
|
+
*
|
|
4
|
+
* The SDK appends `<available_skills>` on every BeforeInvocationEvent. Darwin's
|
|
5
|
+
* later hook moves that exact text block ahead of current working context and the
|
|
6
|
+
* final cache point. Only explicit Darwin-owned shapes are accepted; an unknown
|
|
7
|
+
* block array is left untouched rather than flattened or guessed at.
|
|
8
|
+
*/
|
|
9
|
+
import { CachePointBlock, TextBlock } from '@strands-agents/sdk';
|
|
10
|
+
const WORKING_CONTEXT_TAG = 'working-context';
|
|
11
|
+
const AVAILABLE_SKILLS_OPEN = '<available_skills>';
|
|
12
|
+
const AVAILABLE_SKILLS_CLOSE = '</available_skills>';
|
|
13
|
+
const LEGACY_SKILLS_TAG = 'available-skills';
|
|
14
|
+
const LEGACY_SKILLS_PROLOGUE = [
|
|
15
|
+
`<${LEGACY_SKILLS_TAG}>`,
|
|
16
|
+
'Skills are instruction sets for specific tasks. When a request matches one,',
|
|
17
|
+
'call the load_skill tool with its name to read the full instructions before',
|
|
18
|
+
'you begin. Only the name and description are shown here.',
|
|
19
|
+
].join('\n');
|
|
20
|
+
const LEGACY_WORKING_PROLOGUE = [
|
|
21
|
+
`<${WORKING_CONTEXT_TAG}>`,
|
|
22
|
+
'Where this session started. The directory listing and the date are a snapshot taken at',
|
|
23
|
+
'startup, not live state: re-check anything that may have changed since, including your own',
|
|
24
|
+
'edits. Paths are absolute unless stated otherwise.',
|
|
25
|
+
].join('\n');
|
|
26
|
+
/** Reorders one official catalogue block for the imminent model request. */
|
|
27
|
+
export function orderOfficialSkillsPrompt(agent) {
|
|
28
|
+
const prompt = agent.systemPrompt;
|
|
29
|
+
if (!Array.isArray(prompt))
|
|
30
|
+
return false;
|
|
31
|
+
const parsed = parseKnownPrompt(prompt);
|
|
32
|
+
if (parsed === undefined || parsed.catalogue === undefined)
|
|
33
|
+
return false;
|
|
34
|
+
agent.systemPrompt = [
|
|
35
|
+
new TextBlock(parsed.base),
|
|
36
|
+
parsed.catalogue,
|
|
37
|
+
...(parsed.workingContext === undefined ? [] : [parsed.workingContext]),
|
|
38
|
+
...(parsed.cachePoint === undefined ? [] : [parsed.cachePoint]),
|
|
39
|
+
];
|
|
40
|
+
return true;
|
|
41
|
+
}
|
|
42
|
+
/**
|
|
43
|
+
* Replaces current working context while preserving a separate official catalogue
|
|
44
|
+
* and removes the prior cache point so the runtime can apply the current plan.
|
|
45
|
+
*/
|
|
46
|
+
export function refreshKnownPrompt(prompt, fragment) {
|
|
47
|
+
if (typeof prompt === 'string') {
|
|
48
|
+
// Pre-migration uncached/OpenAI snapshots stored the whole prompt as one
|
|
49
|
+
// string. Split only standalone trailing blocks: project instructions may
|
|
50
|
+
// legitimately mention either tag as prose and must remain byte-identical.
|
|
51
|
+
const legacy = splitLegacyPrompt(prompt);
|
|
52
|
+
if (legacy !== undefined) {
|
|
53
|
+
return refreshParsedPrompt({ base: legacy.base, workingContext: new TextBlock(legacy.workingContext) }, fragment);
|
|
54
|
+
}
|
|
55
|
+
// A fresh base/project prompt has no historical structural prologue. If one
|
|
56
|
+
// is present but the complete suffix cannot be proven, refuse instead of
|
|
57
|
+
// treating potentially stale blocks as generic base text.
|
|
58
|
+
if (prompt.includes(LEGACY_SKILLS_PROLOGUE) || prompt.includes(LEGACY_WORKING_PROLOGUE)) {
|
|
59
|
+
return undefined;
|
|
60
|
+
}
|
|
61
|
+
const base = prompt.trimEnd();
|
|
62
|
+
return base === '' ? undefined : refreshParsedPrompt({ base }, fragment);
|
|
63
|
+
}
|
|
64
|
+
if (!Array.isArray(prompt))
|
|
65
|
+
return undefined;
|
|
66
|
+
const legacy = parseLegacyCachedPrompt(prompt);
|
|
67
|
+
if (legacy !== undefined)
|
|
68
|
+
return refreshParsedPrompt(legacy, fragment);
|
|
69
|
+
if (isAmbiguousLegacyCachedPrompt(prompt))
|
|
70
|
+
return undefined;
|
|
71
|
+
const parsed = parseKnownPrompt(prompt);
|
|
72
|
+
if (parsed === undefined)
|
|
73
|
+
return undefined;
|
|
74
|
+
return refreshParsedPrompt(parsed, fragment);
|
|
75
|
+
}
|
|
76
|
+
function refreshParsedPrompt(parsed, workingContext) {
|
|
77
|
+
return [
|
|
78
|
+
new TextBlock(parsed.base),
|
|
79
|
+
...(parsed.catalogue === undefined ? [] : [parsed.catalogue]),
|
|
80
|
+
...(workingContext === undefined
|
|
81
|
+
? parsed.workingContext === undefined ? [] : [parsed.workingContext]
|
|
82
|
+
: [new TextBlock(workingContext)]),
|
|
83
|
+
...(parsed.cachePoint === undefined ? [] : [parsed.cachePoint]),
|
|
84
|
+
];
|
|
85
|
+
}
|
|
86
|
+
/** A conservative parser for prompt arrays Darwin itself assembles. */
|
|
87
|
+
function parseKnownPrompt(prompt) {
|
|
88
|
+
if (!Array.isArray(prompt) || prompt.length === 0)
|
|
89
|
+
return undefined;
|
|
90
|
+
let cachePoint;
|
|
91
|
+
const cacheIndexes = prompt.flatMap((block, index) => block instanceof CachePointBlock ? [index] : []);
|
|
92
|
+
if (cacheIndexes.length > 1)
|
|
93
|
+
return undefined;
|
|
94
|
+
const cacheIndex = cacheIndexes[0];
|
|
95
|
+
if (cacheIndex !== undefined) {
|
|
96
|
+
// Normal stored shape: cache last. During BeforeInvocationEvent the official
|
|
97
|
+
// plugin has just appended its catalogue after that cache point, so the one
|
|
98
|
+
// other accepted position is immediately before the final catalogue block.
|
|
99
|
+
const lastIndex = prompt.length - 1;
|
|
100
|
+
const beforeOfficialAppend = cacheIndex === lastIndex - 1 &&
|
|
101
|
+
prompt[lastIndex] instanceof TextBlock &&
|
|
102
|
+
isCatalogue(prompt[lastIndex].text);
|
|
103
|
+
if (cacheIndex !== lastIndex && !beforeOfficialAppend)
|
|
104
|
+
return undefined;
|
|
105
|
+
cachePoint = prompt[cacheIndex];
|
|
106
|
+
}
|
|
107
|
+
const withoutCache = prompt.filter((block) => !(block instanceof CachePointBlock));
|
|
108
|
+
if (withoutCache.some((block) => !(block instanceof TextBlock)))
|
|
109
|
+
return undefined;
|
|
110
|
+
let catalogue;
|
|
111
|
+
let workingContext;
|
|
112
|
+
const baseParts = [];
|
|
113
|
+
for (const block of withoutCache) {
|
|
114
|
+
if (isCatalogue(block.text)) {
|
|
115
|
+
if (catalogue !== undefined)
|
|
116
|
+
return undefined;
|
|
117
|
+
catalogue = block;
|
|
118
|
+
continue;
|
|
119
|
+
}
|
|
120
|
+
// Historical ambient memory blocks are intentionally dropped during prompt refresh.
|
|
121
|
+
if (block.text.trim().startsWith('<learned-memory>') && block.text.trim().endsWith('</learned-memory>'))
|
|
122
|
+
continue;
|
|
123
|
+
if (isWorkingContext(block.text)) {
|
|
124
|
+
if (workingContext !== undefined)
|
|
125
|
+
return undefined;
|
|
126
|
+
workingContext = new TextBlock(extractWorkingContext(block.text) ?? block.text);
|
|
127
|
+
const base = stripWorkingContextText(block.text);
|
|
128
|
+
if (base !== '')
|
|
129
|
+
baseParts.push(base);
|
|
130
|
+
continue;
|
|
131
|
+
}
|
|
132
|
+
baseParts.push(block.text);
|
|
133
|
+
}
|
|
134
|
+
if (baseParts.length !== 1)
|
|
135
|
+
return undefined;
|
|
136
|
+
const base = (baseParts[0] ?? '').trimEnd();
|
|
137
|
+
if (base === '')
|
|
138
|
+
return undefined;
|
|
139
|
+
return { base, catalogue, workingContext, cachePoint };
|
|
140
|
+
}
|
|
141
|
+
/** Migrates snapshots written before official AgentSkills used separate blocks. */
|
|
142
|
+
function parseLegacyCachedPrompt(prompt) {
|
|
143
|
+
if (!Array.isArray(prompt) || prompt.length !== 2)
|
|
144
|
+
return undefined;
|
|
145
|
+
const [text, cachePoint] = prompt;
|
|
146
|
+
if (!(text instanceof TextBlock) || !(cachePoint instanceof CachePointBlock))
|
|
147
|
+
return undefined;
|
|
148
|
+
const legacy = splitLegacyPrompt(text.text);
|
|
149
|
+
if (legacy === undefined)
|
|
150
|
+
return undefined;
|
|
151
|
+
return {
|
|
152
|
+
base: legacy.base,
|
|
153
|
+
// The legacy catalogue used Darwin's old XML shape and has no official
|
|
154
|
+
// lastInjectedXml state. Drop it so official AgentSkills injects exactly one
|
|
155
|
+
// current catalogue on the first resumed invocation.
|
|
156
|
+
catalogue: undefined,
|
|
157
|
+
workingContext: new TextBlock(legacy.workingContext),
|
|
158
|
+
cachePoint,
|
|
159
|
+
};
|
|
160
|
+
}
|
|
161
|
+
function isAmbiguousLegacyCachedPrompt(prompt) {
|
|
162
|
+
if (!Array.isArray(prompt) || prompt.length !== 2)
|
|
163
|
+
return false;
|
|
164
|
+
const [text, cachePoint] = prompt;
|
|
165
|
+
return (text instanceof TextBlock &&
|
|
166
|
+
cachePoint instanceof CachePointBlock &&
|
|
167
|
+
(text.text.includes(LEGACY_SKILLS_PROLOGUE) || text.text.includes(LEGACY_WORKING_PROLOGUE)));
|
|
168
|
+
}
|
|
169
|
+
/**
|
|
170
|
+
* Recognizes exactly the historical Darwin suffix:
|
|
171
|
+
* `<fixed skills prologue>…</available-skills>\n\n<fixed working prologue>…</working-context>`.
|
|
172
|
+
* Fixed prologues establish the outer openings; known adjacency establishes both
|
|
173
|
+
* boundaries. Literal opening-tag text inside project rules or either body is data.
|
|
174
|
+
*/
|
|
175
|
+
function splitLegacyPrompt(text) {
|
|
176
|
+
const trimmed = text.trimEnd();
|
|
177
|
+
const workingClose = `</${WORKING_CONTEXT_TAG}>`;
|
|
178
|
+
if (!trimmed.endsWith(workingClose))
|
|
179
|
+
return undefined;
|
|
180
|
+
const skillsBoundary = `</${LEGACY_SKILLS_TAG}>\n\n${LEGACY_WORKING_PROLOGUE}`;
|
|
181
|
+
const boundary = trimmed.lastIndexOf(skillsBoundary);
|
|
182
|
+
if (boundary === -1)
|
|
183
|
+
return undefined;
|
|
184
|
+
const workingStart = boundary + `</${LEGACY_SKILLS_TAG}>\n\n`.length;
|
|
185
|
+
const workingContext = trimmed.slice(workingStart);
|
|
186
|
+
if (!workingContext.startsWith(LEGACY_WORKING_PROLOGUE))
|
|
187
|
+
return undefined;
|
|
188
|
+
const beforeClose = trimmed.slice(0, boundary);
|
|
189
|
+
const skillsSeparator = `\n\n${LEGACY_SKILLS_PROLOGUE}`;
|
|
190
|
+
const skillsStart = beforeClose.lastIndexOf(skillsSeparator);
|
|
191
|
+
if (skillsStart === -1)
|
|
192
|
+
return undefined;
|
|
193
|
+
const base = beforeClose.slice(0, skillsStart);
|
|
194
|
+
const skillsBody = beforeClose.slice(skillsStart + 2);
|
|
195
|
+
if (base === '' || !skillsBody.startsWith(LEGACY_SKILLS_PROLOGUE))
|
|
196
|
+
return undefined;
|
|
197
|
+
return { base, workingContext };
|
|
198
|
+
}
|
|
199
|
+
function isCatalogue(text) {
|
|
200
|
+
const trimmed = text.trim();
|
|
201
|
+
return trimmed.startsWith(AVAILABLE_SKILLS_OPEN) && trimmed.endsWith(AVAILABLE_SKILLS_CLOSE);
|
|
202
|
+
}
|
|
203
|
+
function isWorkingContext(text) {
|
|
204
|
+
const trimmed = text.trim();
|
|
205
|
+
return trimmed.startsWith(`<${WORKING_CONTEXT_TAG}>`) && trimmed.endsWith(`</${WORKING_CONTEXT_TAG}>`);
|
|
206
|
+
}
|
|
207
|
+
function extractWorkingContext(text) {
|
|
208
|
+
return text.match(new RegExp(`<${WORKING_CONTEXT_TAG}>[\\s\\S]*?</${WORKING_CONTEXT_TAG}>`))?.[0];
|
|
209
|
+
}
|
|
210
|
+
function stripWorkingContextText(text) {
|
|
211
|
+
const block = new RegExp(`\\n*<${WORKING_CONTEXT_TAG}>[\\s\\S]*?</${WORKING_CONTEXT_TAG}>`, 'g');
|
|
212
|
+
return text.replace(block, '').trimEnd();
|
|
213
|
+
}
|
|
214
|
+
//# sourceMappingURL=prompt.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"prompt.js","sourceRoot":"","sources":["../../../src/skills/prompt.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,15 @@
|
|
|
1
|
+
import type { ToolContext } from '@strands-agents/sdk';
|
|
2
|
+
import { Skill } from '@strands-agents/sdk/vended-plugins/skills';
|
|
3
|
+
/** Hard bound on filesystem entries inspected before official activation begins. */
|
|
4
|
+
export declare const MAX_SKILL_RESOURCE_PREFLIGHT_ENTRIES = 200;
|
|
5
|
+
type ResourceSafetyCheckpoint = 'after-preflight';
|
|
6
|
+
/** Deterministic test seam for replacing a path after validation but before SDK traversal. */
|
|
7
|
+
export declare function setResourceSafetyCheckpointForTest(callback: ((checkpoint: ResourceSafetyCheckpoint) => void | Promise<void>) | undefined): void;
|
|
8
|
+
/**
|
|
9
|
+
* Validates the resource tree, then gives official AgentSkills a sandbox whose
|
|
10
|
+
* listFiles re-checks symlinks and realpaths at use time. The guarded Agent proxy
|
|
11
|
+
* is required because LocalAgent exposes sandbox as a getter with no public setter;
|
|
12
|
+
* no identity-preserving public override exists in SDK 1.12.0.
|
|
13
|
+
*/
|
|
14
|
+
export declare function guardSkillActivation(context: ToolContext, skill: Skill): Promise<ToolContext>;
|
|
15
|
+
export {};
|
|
@@ -0,0 +1,149 @@
|
|
|
1
|
+
/** Host-filesystem safety boundary around official AgentSkills resource traversal. */
|
|
2
|
+
import { lstat, opendir, realpath } from 'node:fs/promises';
|
|
3
|
+
import path from 'node:path';
|
|
4
|
+
import { Skill } from '@strands-agents/sdk/vended-plugins/skills';
|
|
5
|
+
const RESOURCE_DIRS = ['scripts', 'references', 'assets'];
|
|
6
|
+
/** Hard bound on filesystem entries inspected before official activation begins. */
|
|
7
|
+
export const MAX_SKILL_RESOURCE_PREFLIGHT_ENTRIES = 200;
|
|
8
|
+
let resourceSafetyCheckpoint;
|
|
9
|
+
/** Deterministic test seam for replacing a path after validation but before SDK traversal. */
|
|
10
|
+
export function setResourceSafetyCheckpointForTest(callback) {
|
|
11
|
+
resourceSafetyCheckpoint = callback;
|
|
12
|
+
}
|
|
13
|
+
/**
|
|
14
|
+
* Validates the resource tree, then gives official AgentSkills a sandbox whose
|
|
15
|
+
* listFiles re-checks symlinks and realpaths at use time. The guarded Agent proxy
|
|
16
|
+
* is required because LocalAgent exposes sandbox as a getter with no public setter;
|
|
17
|
+
* no identity-preserving public override exists in SDK 1.12.0.
|
|
18
|
+
*/
|
|
19
|
+
export async function guardSkillActivation(context, skill) {
|
|
20
|
+
if (skill.path === undefined)
|
|
21
|
+
return context;
|
|
22
|
+
const root = await validateResources(skill.path);
|
|
23
|
+
await resourceSafetyCheckpoint?.('after-preflight');
|
|
24
|
+
const guardedSandbox = resourceSandbox(context.agent.sandbox, root);
|
|
25
|
+
const guardedAgent = new Proxy(context.agent, {
|
|
26
|
+
get(target, property) {
|
|
27
|
+
if (property === 'sandbox')
|
|
28
|
+
return guardedSandbox;
|
|
29
|
+
const value = Reflect.get(target, property, target);
|
|
30
|
+
return typeof value === 'function' ? value.bind(target) : value;
|
|
31
|
+
},
|
|
32
|
+
});
|
|
33
|
+
return { ...context, agent: guardedAgent };
|
|
34
|
+
}
|
|
35
|
+
async function validateResources(skillPath) {
|
|
36
|
+
const lexical = path.resolve(skillPath);
|
|
37
|
+
const skillInfo = await lstat(lexical);
|
|
38
|
+
const real = await realpath(lexical);
|
|
39
|
+
const realInfo = skillInfo.isSymbolicLink() ? await lstat(real) : skillInfo;
|
|
40
|
+
if (!realInfo.isDirectory())
|
|
41
|
+
throw new Error(`Skill root is not a directory: ${lexical}`);
|
|
42
|
+
const allowed = RESOURCE_DIRS.map((name) => path.join(lexical, name));
|
|
43
|
+
const budget = { seen: 0 };
|
|
44
|
+
for (const directory of allowed) {
|
|
45
|
+
await validateTree(directory, real, budget, 0, new Set());
|
|
46
|
+
}
|
|
47
|
+
return { lexical, real, allowed };
|
|
48
|
+
}
|
|
49
|
+
async function validateTree(directory, realRoot, budget, depth, ancestors) {
|
|
50
|
+
let handle;
|
|
51
|
+
try {
|
|
52
|
+
const info = await lstat(directory);
|
|
53
|
+
const resolved = await realpath(directory);
|
|
54
|
+
assertInside(realRoot, resolved, directory);
|
|
55
|
+
const targetInfo = info.isSymbolicLink() ? await lstat(resolved) : info;
|
|
56
|
+
if (!targetInfo.isDirectory())
|
|
57
|
+
return;
|
|
58
|
+
if (ancestors.has(resolved))
|
|
59
|
+
throw new Error(`Skill resource symlink cycle detected: ${directory}`);
|
|
60
|
+
handle = await opendir(directory);
|
|
61
|
+
}
|
|
62
|
+
catch (error) {
|
|
63
|
+
if (isMissing(error))
|
|
64
|
+
return;
|
|
65
|
+
throw error;
|
|
66
|
+
}
|
|
67
|
+
const branch = new Set(ancestors);
|
|
68
|
+
branch.add(await realpath(directory));
|
|
69
|
+
try {
|
|
70
|
+
for await (const entry of handle) {
|
|
71
|
+
const child = path.join(directory, entry.name);
|
|
72
|
+
consumeEntry(budget, child);
|
|
73
|
+
const info = await lstat(child);
|
|
74
|
+
const resolved = await realpath(child);
|
|
75
|
+
assertInside(realRoot, resolved, child);
|
|
76
|
+
const targetInfo = info.isSymbolicLink() ? await lstat(resolved) : info;
|
|
77
|
+
// Official AgentSkills lists resource directories at depths 0, 1 and 2.
|
|
78
|
+
if (targetInfo.isDirectory() && depth < 2)
|
|
79
|
+
await validateTree(child, realRoot, budget, depth + 1, branch);
|
|
80
|
+
}
|
|
81
|
+
}
|
|
82
|
+
finally {
|
|
83
|
+
await handle.close().catch(() => { });
|
|
84
|
+
}
|
|
85
|
+
}
|
|
86
|
+
function resourceSandbox(sandbox, root) {
|
|
87
|
+
const budget = { seen: 0 };
|
|
88
|
+
return new Proxy(sandbox, {
|
|
89
|
+
get(target, property) {
|
|
90
|
+
if (property === 'listFiles') {
|
|
91
|
+
return (directory) => listSafe(directory, root, budget);
|
|
92
|
+
}
|
|
93
|
+
const value = Reflect.get(target, property, target);
|
|
94
|
+
return typeof value === 'function' ? value.bind(target) : value;
|
|
95
|
+
},
|
|
96
|
+
});
|
|
97
|
+
}
|
|
98
|
+
async function listSafe(directory, root, budget) {
|
|
99
|
+
const lexical = path.resolve(directory);
|
|
100
|
+
if (!root.allowed.some((allowed) => isInside(allowed, lexical))) {
|
|
101
|
+
throw new Error(`Skill resource traversal left its resource directories: ${lexical}`);
|
|
102
|
+
}
|
|
103
|
+
const rootRealNow = await realpath(root.lexical);
|
|
104
|
+
if (rootRealNow !== root.real) {
|
|
105
|
+
throw new Error(`Skill root changed after resource preflight: ${root.lexical}`);
|
|
106
|
+
}
|
|
107
|
+
const directoryInfo = await lstat(lexical);
|
|
108
|
+
const directoryReal = await realpath(lexical);
|
|
109
|
+
assertInside(rootRealNow, directoryReal, lexical);
|
|
110
|
+
const directoryTargetInfo = directoryInfo.isSymbolicLink() ? await lstat(directoryReal) : directoryInfo;
|
|
111
|
+
if (!directoryTargetInfo.isDirectory())
|
|
112
|
+
throw new Error(`Skill resource path is not a directory: ${lexical}`);
|
|
113
|
+
const entries = [];
|
|
114
|
+
const handle = await opendir(lexical);
|
|
115
|
+
try {
|
|
116
|
+
for await (const entry of handle) {
|
|
117
|
+
const child = path.join(lexical, entry.name);
|
|
118
|
+
consumeEntry(budget, child);
|
|
119
|
+
const info = await lstat(child);
|
|
120
|
+
const resolved = await realpath(child);
|
|
121
|
+
assertInside(root.real, resolved, child);
|
|
122
|
+
const targetInfo = info.isSymbolicLink() ? await lstat(resolved) : info;
|
|
123
|
+
entries.push({ name: entry.name, isDir: targetInfo.isDirectory(), size: targetInfo.size });
|
|
124
|
+
}
|
|
125
|
+
}
|
|
126
|
+
finally {
|
|
127
|
+
await handle.close().catch(() => { });
|
|
128
|
+
}
|
|
129
|
+
return entries.sort((left, right) => left.name.localeCompare(right.name));
|
|
130
|
+
}
|
|
131
|
+
function consumeEntry(budget, entry) {
|
|
132
|
+
budget.seen += 1;
|
|
133
|
+
if (budget.seen > MAX_SKILL_RESOURCE_PREFLIGHT_ENTRIES) {
|
|
134
|
+
throw new Error(`Skill resources exceed the ${MAX_SKILL_RESOURCE_PREFLIGHT_ENTRIES}-entry safety preflight near ${entry}`);
|
|
135
|
+
}
|
|
136
|
+
}
|
|
137
|
+
function assertInside(root, candidate, source) {
|
|
138
|
+
if (!isInside(root, candidate)) {
|
|
139
|
+
throw new Error(`Skill resource path resolves outside its skill root: ${source}`);
|
|
140
|
+
}
|
|
141
|
+
}
|
|
142
|
+
function isInside(root, candidate) {
|
|
143
|
+
const relative = path.relative(root, candidate);
|
|
144
|
+
return relative === '' || (!relative.startsWith(`..${path.sep}`) && relative !== '..' && !path.isAbsolute(relative));
|
|
145
|
+
}
|
|
146
|
+
function isMissing(error) {
|
|
147
|
+
return typeof error === 'object' && error !== null && 'code' in error && (error.code === 'ENOENT' || error.code === 'ENOTDIR');
|
|
148
|
+
}
|
|
149
|
+
//# sourceMappingURL=resource-safety.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"resource-safety.js","sourceRoot":"","sources":["../../../src/skills/resource-safety.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,95 @@
|
|
|
1
|
+
import { open } from 'node:fs/promises';
|
|
2
|
+
import { type InvokableTool } from '@strands-agents/sdk';
|
|
3
|
+
import type { BashInput, BashOutput } from '@strands-agents/sdk/vended-tools/bash';
|
|
4
|
+
import { z } from 'zod';
|
|
5
|
+
export { OUTPUT_SENSITIVE_WAIT_MAX_MS, TERMINAL_FOCUSED_WAIT_MAX_MS, TERMINAL_WAIT_TIMEOUT_INSTRUCTION, } from './background-wait-contract.js';
|
|
6
|
+
export type BackgroundTaskState = 'running' | 'succeeded' | 'failed' | 'stopped';
|
|
7
|
+
export interface BackgroundTaskStatus {
|
|
8
|
+
readonly taskId: string;
|
|
9
|
+
readonly state: BackgroundTaskState;
|
|
10
|
+
readonly command: string;
|
|
11
|
+
readonly pid: number;
|
|
12
|
+
readonly startedAt: string;
|
|
13
|
+
readonly finishedAt: string | null;
|
|
14
|
+
readonly exitCode: number | null;
|
|
15
|
+
readonly signal: NodeJS.Signals | null;
|
|
16
|
+
readonly outputPath: string;
|
|
17
|
+
readonly outputBytes: number | null;
|
|
18
|
+
}
|
|
19
|
+
/** Receives one immutable snapshot when a task first reaches a terminal state. */
|
|
20
|
+
export type BackgroundTaskListener = (task: Readonly<BackgroundTaskStatus>) => void | Promise<void>;
|
|
21
|
+
export interface BackgroundStartResult {
|
|
22
|
+
taskId: string;
|
|
23
|
+
pid: number;
|
|
24
|
+
outputPath: string;
|
|
25
|
+
}
|
|
26
|
+
export interface BackgroundOutputResult {
|
|
27
|
+
taskId: string;
|
|
28
|
+
output: string;
|
|
29
|
+
startOffset: number;
|
|
30
|
+
endOffset: number;
|
|
31
|
+
hasMore: boolean;
|
|
32
|
+
outputPath: string;
|
|
33
|
+
}
|
|
34
|
+
export interface BackgroundWaitResult {
|
|
35
|
+
reason: 'output' | 'changed' | 'terminal' | 'timeout' | 'cancelled' | 'shutdown';
|
|
36
|
+
status: BackgroundTaskStatus;
|
|
37
|
+
output: BackgroundOutputResult;
|
|
38
|
+
/** Present only when an explicit terminal-focused wait times out while still running. */
|
|
39
|
+
instruction?: string;
|
|
40
|
+
}
|
|
41
|
+
export declare class BackgroundBashManager {
|
|
42
|
+
private readonly projectRoot;
|
|
43
|
+
private readonly openFile;
|
|
44
|
+
private readonly tasks;
|
|
45
|
+
private readonly launches;
|
|
46
|
+
private readonly listeners;
|
|
47
|
+
private readonly outputDirectory;
|
|
48
|
+
private readonly shutdownController;
|
|
49
|
+
private closing;
|
|
50
|
+
constructor(projectRoot: string, sessionId: string, openFile?: typeof open);
|
|
51
|
+
start(command: string): Promise<BackgroundStartResult>;
|
|
52
|
+
status(taskId: string): Promise<BackgroundTaskStatus>;
|
|
53
|
+
/** Snapshots every current-runtime task in deterministic launch order. */
|
|
54
|
+
list(): Promise<BackgroundTaskStatus[]>;
|
|
55
|
+
/** Subscribes to future terminal transitions; completed tasks are not replayed. */
|
|
56
|
+
subscribe(listener: BackgroundTaskListener): () => void;
|
|
57
|
+
output(taskId: string): Promise<BackgroundOutputResult>;
|
|
58
|
+
wait(taskId: string, waitMs: number, signal?: AbortSignal, wakeOnOutput?: boolean): Promise<BackgroundWaitResult>;
|
|
59
|
+
private waitForTerminal;
|
|
60
|
+
private finishTerminalWait;
|
|
61
|
+
private aggregateWaitOutput;
|
|
62
|
+
private hasUnreadOutput;
|
|
63
|
+
stop(taskId: string): Promise<BackgroundTaskStatus>;
|
|
64
|
+
shutdown(): Promise<void>;
|
|
65
|
+
private launch;
|
|
66
|
+
private finish;
|
|
67
|
+
private lookup;
|
|
68
|
+
private serialize;
|
|
69
|
+
private snapshot;
|
|
70
|
+
private taskMetadata;
|
|
71
|
+
private readOutput;
|
|
72
|
+
private openOwnedLog;
|
|
73
|
+
}
|
|
74
|
+
declare const inputSchema: z.ZodObject<{
|
|
75
|
+
mode: z.ZodEnum<{
|
|
76
|
+
execute: "execute";
|
|
77
|
+
list: "list";
|
|
78
|
+
output: "output";
|
|
79
|
+
restart: "restart";
|
|
80
|
+
start: "start";
|
|
81
|
+
status: "status";
|
|
82
|
+
stop: "stop";
|
|
83
|
+
wait: "wait";
|
|
84
|
+
}>;
|
|
85
|
+
command: z.ZodOptional<z.ZodString>;
|
|
86
|
+
timeout: z.ZodOptional<z.ZodNumber>;
|
|
87
|
+
taskId: z.ZodOptional<z.ZodString>;
|
|
88
|
+
waitMs: z.ZodOptional<z.ZodNumber>;
|
|
89
|
+
wakeOnOutput: z.ZodOptional<z.ZodBoolean>;
|
|
90
|
+
}, z.core.$strict>;
|
|
91
|
+
type BackgroundBashInput = z.infer<typeof inputSchema>;
|
|
92
|
+
type BackgroundBashOutput = BashOutput | string | BackgroundStartResult | BackgroundTaskStatus | BackgroundTaskStatus[] | BackgroundOutputResult | BackgroundWaitResult;
|
|
93
|
+
/** Configures the pinned SDK foreground tool from Darwin's verified project root. */
|
|
94
|
+
export declare function createForegroundBashTool(projectRoot: string): InvokableTool<BashInput, BashOutput | string>;
|
|
95
|
+
export declare function createBackgroundBashTool(manager: BackgroundBashManager, foreground?: InvokableTool<BashInput, BashOutput | string>): InvokableTool<BackgroundBashInput, BackgroundBashOutput>;
|