@draht/coding-agent 2026.7.30 → 2026.10.4-2
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/CHANGELOG.md +606 -0
- package/README.md +46 -2
- package/agents/debugger.md +12 -1
- package/agents/git-committer.md +1 -0
- package/agents/implementer.md +20 -0
- package/agents/investigator.md +75 -0
- package/agents/reviewer.md +7 -0
- package/agents/spec-reviewer.md +66 -0
- package/agents/verifier.md +4 -3
- package/bin/draht-tools.cjs +472 -41
- package/dist/agents/debugger.md +12 -1
- package/dist/agents/git-committer.md +1 -0
- package/dist/agents/implementer.md +20 -0
- package/dist/agents/investigator.md +75 -0
- package/dist/agents/reviewer.md +7 -0
- package/dist/agents/spec-reviewer.md +66 -0
- package/dist/agents/verifier.md +4 -3
- package/dist/bun/cli.d.ts +1 -1
- package/dist/bun/cli.d.ts.map +1 -1
- package/dist/bun/cli.js +6 -3
- package/dist/bun/cli.js.map +1 -1
- package/dist/bun/sandbox-env-setup.d.ts +2 -0
- package/dist/bun/sandbox-env-setup.d.ts.map +1 -0
- package/dist/bun/sandbox-env-setup.js +4 -0
- package/dist/bun/sandbox-env-setup.js.map +1 -0
- package/dist/bundle/chunks/anthropic-messages-GAKYXF65.js +6 -0
- package/dist/bundle/chunks/anthropic.js +75 -0
- package/dist/bundle/chunks/azure-openai-responses-ZIXMK6JO.js +2 -0
- package/dist/bundle/chunks/bedrock-converse-stream.js +79 -0
- package/dist/bundle/chunks/chunk-2E5VODES.js +2 -0
- package/dist/bundle/chunks/chunk-2FBJKY7F.js +2 -0
- package/dist/bundle/chunks/chunk-2N4I6WXC.js +2 -0
- package/dist/bundle/chunks/chunk-5VZWYVZB.js +82 -0
- package/dist/bundle/chunks/chunk-63BK6WK2.js +2 -0
- package/dist/bundle/chunks/chunk-6MSE6LZ3.js +6 -0
- package/dist/bundle/chunks/chunk-6ZJKIMU7.js +2 -0
- package/dist/bundle/chunks/chunk-736QBNUZ.js +12 -0
- package/dist/bundle/chunks/chunk-BXSHCX3G.js +11 -0
- package/dist/bundle/chunks/chunk-CEJJ5XF2.js +170 -0
- package/dist/bundle/chunks/chunk-COF5JT7R.js +4 -0
- package/dist/bundle/chunks/chunk-D6TMD5Q2.js +44 -0
- package/dist/bundle/chunks/chunk-DPE4ALPU.js +146 -0
- package/dist/bundle/chunks/chunk-EBVYI75P.js +2 -0
- package/dist/bundle/chunks/chunk-GVXA72ZA.js +2 -0
- package/dist/bundle/chunks/chunk-H6FT43VC.js +137 -0
- package/dist/bundle/chunks/chunk-HJ72RANT.js +2 -0
- package/dist/bundle/chunks/chunk-HTJ3L72O.js +2 -0
- package/dist/bundle/chunks/chunk-HZ2UHMBT.js +2 -0
- package/dist/bundle/chunks/chunk-I5OKY6RH.js +11 -0
- package/dist/bundle/chunks/chunk-IWTUBX6V.js +4 -0
- package/dist/bundle/chunks/chunk-KPO5375S.js +2 -0
- package/dist/bundle/chunks/chunk-KVH4HR57.js +31 -0
- package/dist/bundle/chunks/chunk-LDAOC5RB.js +18 -0
- package/dist/bundle/chunks/chunk-ON6XU6AG.js +2 -0
- package/dist/bundle/chunks/chunk-QMN7OD6G.js +2 -0
- package/dist/bundle/chunks/chunk-RZKPFWMH.js +42 -0
- package/dist/bundle/chunks/chunk-SDRCE6OP.js +2 -0
- package/dist/bundle/chunks/chunk-SVNWI7EV.js +8 -0
- package/dist/bundle/chunks/chunk-TIA2T6EO.js +3 -0
- package/dist/bundle/chunks/chunk-VOFPZOUQ.js +1472 -0
- package/dist/bundle/chunks/chunk-XBUEMKIY.js +2 -0
- package/dist/bundle/chunks/chunk-XOGEYN4Q.js +2 -0
- package/dist/bundle/chunks/chunk-ZZD35WKM.js +2 -0
- package/dist/bundle/chunks/cli-SR5QBZH4.js +51 -0
- package/dist/bundle/chunks/cloudflare-workers-ai-system-one-MJKOAE5S.js +2 -0
- package/dist/bundle/chunks/codemode-worker.js +315 -0
- package/dist/bundle/chunks/execute-VCYDHEYA.js +328 -0
- package/dist/bundle/chunks/github-copilot.js +2 -0
- package/dist/bundle/chunks/google-antigravity.js +75 -0
- package/dist/bundle/chunks/google-gemini-cli.js +75 -0
- package/dist/bundle/chunks/google-generative-ai-RPUPQ6PM.js +2 -0
- package/dist/bundle/chunks/google-vertex-EZES5QVQ.js +2 -0
- package/dist/bundle/chunks/https-proxy-agent-O2PVUIOI.js +13 -0
- package/dist/bundle/chunks/image-resize-worker.js +2 -0
- package/dist/bundle/chunks/jiti-loader-RKXLMQV2.js +2 -0
- package/dist/bundle/chunks/kimi-coding.js +2 -0
- package/dist/bundle/chunks/lib-XOG5PI3Y.js +9 -0
- package/dist/bundle/chunks/llama-cpp-classify-EJ5XMSQL.js +22 -0
- package/dist/bundle/chunks/meta.js +2 -0
- package/dist/bundle/chunks/mistral-conversations-AOYGU43Y.js +5 -0
- package/dist/bundle/chunks/multipart-parser-AZP5BX2W.js +3 -0
- package/dist/bundle/chunks/node-C2JGH2OB.js +2 -0
- package/dist/bundle/chunks/node-LQ52KV6B.js +16 -0
- package/dist/bundle/chunks/openai-chatgpt.js +75 -0
- package/dist/bundle/chunks/openai-codex-responses-M2Y77JEQ.js +10 -0
- package/dist/bundle/chunks/openai-codex.js +75 -0
- package/dist/bundle/chunks/openai-completions-A4OKYOYV.js +7 -0
- package/dist/bundle/chunks/openai-responses-6IXV53T3.js +3 -0
- package/dist/bundle/chunks/opencode-go.js +2 -0
- package/dist/bundle/chunks/openrouter-images-LYV4NKFM.js +2 -0
- package/dist/bundle/chunks/openrouter.js +75 -0
- package/dist/bundle/chunks/pi-messages-KKMEUT3Z.js +8 -0
- package/dist/bundle/chunks/radius.js +75 -0
- package/dist/bundle/chunks/runtime-6YJPGSP7.js +2 -0
- package/dist/bundle/chunks/settings-manager-D2EG7WDO.js +2 -0
- package/dist/bundle/chunks/src-TIBHS42X.js +4 -0
- package/dist/bundle/chunks/typesafe-system-one-YBEEY5XU.js +2 -0
- package/dist/bundle/chunks/virtual-modules-CBOAFAFT.js +2 -0
- package/dist/bundle/chunks/xai.js +75 -0
- package/dist/bundle/cli-runtime.js +3 -0
- package/dist/bundle/cli.js +5 -0
- package/dist/bundle/index.js +2 -0
- package/dist/bundle/rpc-entry.js +3 -0
- package/dist/cli/args.d.ts +14 -0
- package/dist/cli/args.d.ts.map +1 -1
- package/dist/cli/args.js +140 -22
- package/dist/cli/args.js.map +1 -1
- package/dist/cli/attach-mode.d.ts +61 -0
- package/dist/cli/attach-mode.d.ts.map +1 -1
- package/dist/cli/attach-mode.js +243 -5
- package/dist/cli/attach-mode.js.map +1 -1
- package/dist/cli/auth-check.d.ts +19 -0
- package/dist/cli/auth-check.d.ts.map +1 -0
- package/dist/cli/auth-check.js +50 -0
- package/dist/cli/auth-check.js.map +1 -0
- package/dist/cli/auth-command.d.ts +24 -0
- package/dist/cli/auth-command.d.ts.map +1 -0
- package/dist/cli/auth-command.js +103 -0
- package/dist/cli/auth-command.js.map +1 -0
- package/dist/cli/config-selector.d.ts.map +1 -1
- package/dist/cli/config-selector.js +3 -2
- package/dist/cli/config-selector.js.map +1 -1
- package/dist/cli/credential-print.d.ts +6 -4
- package/dist/cli/credential-print.d.ts.map +1 -1
- package/dist/cli/credential-print.js +47 -34
- package/dist/cli/credential-print.js.map +1 -1
- package/dist/cli/file-processor.d.ts +1 -1
- package/dist/cli/file-processor.d.ts.map +1 -1
- package/dist/cli/file-processor.js +2 -1
- package/dist/cli/file-processor.js.map +1 -1
- package/dist/cli/list-models.d.ts +1 -1
- package/dist/cli/list-models.d.ts.map +1 -1
- package/dist/cli/list-models.js +2 -2
- package/dist/cli/list-models.js.map +1 -1
- package/dist/cli/session-picker.d.ts +1 -1
- package/dist/cli/session-picker.d.ts.map +1 -1
- package/dist/cli/session-picker.js.map +1 -1
- package/dist/cli/setup.d.ts +2 -0
- package/dist/cli/setup.d.ts.map +1 -0
- package/dist/cli/setup.js +12 -0
- package/dist/cli/setup.js.map +1 -0
- package/dist/cli/startup-ui.d.ts +2 -2
- package/dist/cli/startup-ui.d.ts.map +1 -1
- package/dist/cli/startup-ui.js +42 -33
- package/dist/cli/startup-ui.js.map +1 -1
- package/dist/cli.js +3 -12
- package/dist/cli.js.map +1 -1
- package/dist/config.d.ts +29 -4
- package/dist/config.d.ts.map +1 -1
- package/dist/config.js +73 -10
- package/dist/config.js.map +1 -1
- package/dist/core/agent-session-runtime.d.ts +17 -1
- package/dist/core/agent-session-runtime.d.ts.map +1 -1
- package/dist/core/agent-session-runtime.js +98 -32
- package/dist/core/agent-session-runtime.js.map +1 -1
- package/dist/core/agent-session-services.d.ts +2 -1
- package/dist/core/agent-session-services.d.ts.map +1 -1
- package/dist/core/agent-session-services.js +15 -0
- package/dist/core/agent-session-services.js.map +1 -1
- package/dist/core/agent-session.d.ts +266 -49
- package/dist/core/agent-session.d.ts.map +1 -1
- package/dist/core/agent-session.js +1503 -597
- package/dist/core/agent-session.js.map +1 -1
- package/dist/core/auth-storage.d.ts +25 -9
- package/dist/core/auth-storage.d.ts.map +1 -1
- package/dist/core/auth-storage.js +245 -45
- package/dist/core/auth-storage.js.map +1 -1
- package/dist/core/bug-report-upload.d.ts +11 -0
- package/dist/core/bug-report-upload.d.ts.map +1 -0
- package/dist/core/bug-report-upload.js +20 -0
- package/dist/core/bug-report-upload.js.map +1 -0
- package/dist/core/bug-report.d.ts +176 -0
- package/dist/core/bug-report.d.ts.map +1 -0
- package/dist/core/bug-report.js +292 -0
- package/dist/core/bug-report.js.map +1 -0
- package/dist/core/builtins/checkpoints.d.ts +20 -0
- package/dist/core/builtins/checkpoints.d.ts.map +1 -0
- package/dist/core/builtins/checkpoints.js +161 -0
- package/dist/core/builtins/checkpoints.js.map +1 -0
- package/dist/core/builtins/duet.d.ts +26 -0
- package/dist/core/builtins/duet.d.ts.map +1 -0
- package/dist/core/builtins/duet.js +660 -0
- package/dist/core/builtins/duet.js.map +1 -0
- package/dist/core/builtins/index.d.ts.map +1 -1
- package/dist/core/builtins/index.js +7 -1
- package/dist/core/builtins/index.js.map +1 -1
- package/dist/core/builtins/subagent.d.ts +24 -4
- package/dist/core/builtins/subagent.d.ts.map +1 -1
- package/dist/core/builtins/subagent.js +278 -35
- package/dist/core/builtins/subagent.js.map +1 -1
- package/dist/core/cache-stats.d.ts.map +1 -1
- package/dist/core/cache-stats.js +12 -1
- package/dist/core/cache-stats.js.map +1 -1
- package/dist/core/cache-warmer.d.ts +103 -0
- package/dist/core/cache-warmer.d.ts.map +1 -0
- package/dist/core/cache-warmer.js +356 -0
- package/dist/core/cache-warmer.js.map +1 -0
- package/dist/core/checkpoints/checkpoint-cli.d.ts +17 -0
- package/dist/core/checkpoints/checkpoint-cli.d.ts.map +1 -0
- package/dist/core/checkpoints/checkpoint-cli.js +78 -0
- package/dist/core/checkpoints/checkpoint-cli.js.map +1 -0
- package/dist/core/checkpoints/checkpoint-manager.d.ts +298 -0
- package/dist/core/checkpoints/checkpoint-manager.d.ts.map +1 -0
- package/dist/core/checkpoints/checkpoint-manager.js +901 -0
- package/dist/core/checkpoints/checkpoint-manager.js.map +1 -0
- package/dist/core/checkpoints/rewind.d.ts +143 -0
- package/dist/core/checkpoints/rewind.d.ts.map +1 -0
- package/dist/core/checkpoints/rewind.js +247 -0
- package/dist/core/checkpoints/rewind.js.map +1 -0
- package/dist/core/compaction/branch-summarization.d.ts +1 -1
- package/dist/core/compaction/branch-summarization.d.ts.map +1 -1
- package/dist/core/compaction/branch-summarization.js +11 -6
- package/dist/core/compaction/branch-summarization.js.map +1 -1
- package/dist/core/compaction/compaction.d.ts +14 -6
- package/dist/core/compaction/compaction.d.ts.map +1 -1
- package/dist/core/compaction/compaction.js +221 -122
- package/dist/core/compaction/compaction.js.map +1 -1
- package/dist/core/compaction/utils.d.ts +2 -1
- package/dist/core/compaction/utils.d.ts.map +1 -1
- package/dist/core/compaction/utils.js +25 -18
- package/dist/core/compaction/utils.js.map +1 -1
- package/dist/core/crash-log.d.ts +27 -0
- package/dist/core/crash-log.d.ts.map +1 -0
- package/dist/core/crash-log.js +140 -0
- package/dist/core/crash-log.js.map +1 -0
- package/dist/core/defaults.d.ts +1 -0
- package/dist/core/defaults.d.ts.map +1 -1
- package/dist/core/defaults.js +9 -0
- package/dist/core/defaults.js.map +1 -1
- package/dist/core/experimental.js +1 -1
- package/dist/core/experimental.js.map +1 -1
- package/dist/core/export-html/template.css +10 -0
- package/dist/core/export-html/template.js +72 -18
- package/dist/core/extensions/index.d.ts +2 -2
- package/dist/core/extensions/index.d.ts.map +1 -1
- package/dist/core/extensions/index.js +1 -1
- package/dist/core/extensions/index.js.map +1 -1
- package/dist/core/extensions/jiti-loader.d.ts +2 -0
- package/dist/core/extensions/jiti-loader.d.ts.map +1 -0
- package/dist/core/extensions/jiti-loader.js +5 -0
- package/dist/core/extensions/jiti-loader.js.map +1 -0
- package/dist/core/extensions/loader.d.ts.map +1 -1
- package/dist/core/extensions/loader.js +298 -96
- package/dist/core/extensions/loader.js.map +1 -1
- package/dist/core/extensions/runner.d.ts +59 -9
- package/dist/core/extensions/runner.d.ts.map +1 -1
- package/dist/core/extensions/runner.js +410 -103
- package/dist/core/extensions/runner.js.map +1 -1
- package/dist/core/extensions/types.d.ts +701 -85
- package/dist/core/extensions/types.d.ts.map +1 -1
- package/dist/core/extensions/types.js +3 -0
- package/dist/core/extensions/types.js.map +1 -1
- package/dist/core/extensions/virtual-modules.d.ts +3 -0
- package/dist/core/extensions/virtual-modules.d.ts.map +1 -0
- package/dist/core/extensions/virtual-modules.js +37 -0
- package/dist/core/extensions/virtual-modules.js.map +1 -0
- package/dist/core/extensions/wrapper.d.ts +2 -2
- package/dist/core/extensions/wrapper.d.ts.map +1 -1
- package/dist/core/extensions/wrapper.js +3 -22
- package/dist/core/extensions/wrapper.js.map +1 -1
- package/dist/core/footer-data-provider.d.ts +1 -1
- package/dist/core/footer-data-provider.js +19 -18
- package/dist/core/footer-data-provider.js.map +1 -1
- package/dist/core/http-dispatcher.d.ts.map +1 -1
- package/dist/core/http-dispatcher.js +7 -0
- package/dist/core/http-dispatcher.js.map +1 -1
- package/dist/core/index.d.ts +2 -1
- package/dist/core/index.d.ts.map +1 -1
- package/dist/core/index.js.map +1 -1
- package/dist/core/keybindings.d.ts +88 -13
- package/dist/core/keybindings.d.ts.map +1 -1
- package/dist/core/keybindings.js +34 -7
- package/dist/core/keybindings.js.map +1 -1
- package/dist/core/mcp-servers.d.ts +119 -0
- package/dist/core/mcp-servers.d.ts.map +1 -0
- package/dist/core/mcp-servers.js +191 -0
- package/dist/core/mcp-servers.js.map +1 -0
- package/dist/core/messages.d.ts +1 -1
- package/dist/core/messages.d.ts.map +1 -1
- package/dist/core/messages.js +1 -0
- package/dist/core/messages.js.map +1 -1
- package/dist/core/model-config.d.ts +202 -20
- package/dist/core/model-config.d.ts.map +1 -1
- package/dist/core/model-config.js +53 -18
- package/dist/core/model-config.js.map +1 -1
- package/dist/core/model-registry.d.ts +21 -3
- package/dist/core/model-registry.d.ts.map +1 -1
- package/dist/core/model-registry.js +47 -10
- package/dist/core/model-registry.js.map +1 -1
- package/dist/core/model-resolver.d.ts +7 -5
- package/dist/core/model-resolver.d.ts.map +1 -1
- package/dist/core/model-resolver.js +62 -23
- package/dist/core/model-resolver.js.map +1 -1
- package/dist/core/model-runtime.d.ts +80 -15
- package/dist/core/model-runtime.d.ts.map +1 -1
- package/dist/core/model-runtime.js +466 -120
- package/dist/core/model-runtime.js.map +1 -1
- package/dist/core/models-store.d.ts +12 -7
- package/dist/core/models-store.d.ts.map +1 -1
- package/dist/core/models-store.js +87 -18
- package/dist/core/models-store.js.map +1 -1
- package/dist/core/multi-agent/fsm.js +8 -3
- package/dist/core/multi-agent/fsm.js.map +1 -1
- package/dist/core/multi-agent/mailbox.js +1 -3
- package/dist/core/multi-agent/mailbox.js.map +1 -1
- package/dist/core/multi-agent/permission-gate.d.ts +5 -2
- package/dist/core/multi-agent/permission-gate.d.ts.map +1 -1
- package/dist/core/multi-agent/permission-gate.js +601 -37
- package/dist/core/multi-agent/permission-gate.js.map +1 -1
- package/dist/core/multi-agent/task-board.js +2 -4
- package/dist/core/multi-agent/task-board.js.map +1 -1
- package/dist/core/multi-agent/worktree.d.ts +2 -0
- package/dist/core/multi-agent/worktree.d.ts.map +1 -1
- package/dist/core/multi-agent/worktree.js +3 -5
- package/dist/core/multi-agent/worktree.js.map +1 -1
- package/dist/core/nested-tool-calls.d.ts +102 -0
- package/dist/core/nested-tool-calls.d.ts.map +1 -0
- package/dist/core/nested-tool-calls.js +178 -0
- package/dist/core/nested-tool-calls.js.map +1 -0
- package/dist/core/package-manager.d.ts +16 -0
- package/dist/core/package-manager.d.ts.map +1 -1
- package/dist/core/package-manager.js +162 -69
- package/dist/core/package-manager.js.map +1 -1
- package/dist/core/permission-relay/index.d.ts +19 -0
- package/dist/core/permission-relay/index.d.ts.map +1 -0
- package/dist/core/permission-relay/index.js +49 -0
- package/dist/core/permission-relay/index.js.map +1 -0
- package/dist/core/permission-relay/relay-ui-context.d.ts +39 -0
- package/dist/core/permission-relay/relay-ui-context.d.ts.map +1 -0
- package/dist/core/permission-relay/relay-ui-context.js +788 -0
- package/dist/core/permission-relay/relay-ui-context.js.map +1 -0
- package/dist/core/permission-relay/types.d.ts +222 -0
- package/dist/core/permission-relay/types.d.ts.map +1 -0
- package/dist/core/permission-relay/types.js +15 -0
- package/dist/core/permission-relay/types.js.map +1 -0
- package/dist/core/pi-manifest.d.ts +14 -0
- package/dist/core/pi-manifest.d.ts.map +1 -0
- package/dist/core/pi-manifest.js +36 -0
- package/dist/core/pi-manifest.js.map +1 -0
- package/dist/core/project-trust.js +2 -2
- package/dist/core/project-trust.js.map +1 -1
- package/dist/core/prompt-templates.d.ts +6 -1
- package/dist/core/prompt-templates.d.ts.map +1 -1
- package/dist/core/prompt-templates.js +63 -37
- package/dist/core/prompt-templates.js.map +1 -1
- package/dist/core/provider-attribution.js +5 -5
- package/dist/core/provider-attribution.js.map +1 -1
- package/dist/core/provider-composer.d.ts +44 -20
- package/dist/core/provider-composer.d.ts.map +1 -1
- package/dist/core/provider-composer.js +151 -51
- package/dist/core/provider-composer.js.map +1 -1
- package/dist/core/radius.d.ts +13 -0
- package/dist/core/radius.d.ts.map +1 -1
- package/dist/core/radius.js +19 -0
- package/dist/core/radius.js.map +1 -1
- package/dist/core/remote-catalog-provider.d.ts +10 -3
- package/dist/core/remote-catalog-provider.d.ts.map +1 -1
- package/dist/core/remote-catalog-provider.js +105 -81
- package/dist/core/remote-catalog-provider.js.map +1 -1
- package/dist/core/resource-loader.d.ts +28 -1
- package/dist/core/resource-loader.d.ts.map +1 -1
- package/dist/core/resource-loader.js +319 -65
- package/dist/core/resource-loader.js.map +1 -1
- package/dist/core/runtime-credentials.d.ts +5 -5
- package/dist/core/runtime-credentials.d.ts.map +1 -1
- package/dist/core/runtime-credentials.js +13 -9
- package/dist/core/runtime-credentials.js.map +1 -1
- package/dist/core/sandbox/bash-operations.d.ts +149 -0
- package/dist/core/sandbox/bash-operations.d.ts.map +1 -0
- package/dist/core/sandbox/bash-operations.js +163 -0
- package/dist/core/sandbox/bash-operations.js.map +1 -0
- package/dist/core/sandbox/env.d.ts +83 -0
- package/dist/core/sandbox/env.d.ts.map +1 -0
- package/dist/core/sandbox/env.js +123 -0
- package/dist/core/sandbox/env.js.map +1 -0
- package/dist/core/sandbox/executor.d.ts +104 -0
- package/dist/core/sandbox/executor.d.ts.map +1 -0
- package/dist/core/sandbox/executor.js +93 -0
- package/dist/core/sandbox/executor.js.map +1 -0
- package/dist/core/sandbox/index.d.ts +36 -0
- package/dist/core/sandbox/index.d.ts.map +1 -0
- package/dist/core/sandbox/index.js +36 -0
- package/dist/core/sandbox/index.js.map +1 -0
- package/dist/core/sandbox/linux.d.ts +121 -0
- package/dist/core/sandbox/linux.d.ts.map +1 -0
- package/dist/core/sandbox/linux.js +260 -0
- package/dist/core/sandbox/linux.js.map +1 -0
- package/dist/core/sandbox/policy.d.ts +142 -0
- package/dist/core/sandbox/policy.d.ts.map +1 -0
- package/dist/core/sandbox/policy.js +297 -0
- package/dist/core/sandbox/policy.js.map +1 -0
- package/dist/core/sandbox/real-path.d.ts +112 -0
- package/dist/core/sandbox/real-path.d.ts.map +1 -0
- package/dist/core/sandbox/real-path.js +158 -0
- package/dist/core/sandbox/real-path.js.map +1 -0
- package/dist/core/sandbox/seatbelt-profile.d.ts +95 -0
- package/dist/core/sandbox/seatbelt-profile.d.ts.map +1 -0
- package/dist/core/sandbox/seatbelt-profile.js +239 -0
- package/dist/core/sandbox/seatbelt-profile.js.map +1 -0
- package/dist/core/sandbox/seatbelt.d.ts +95 -0
- package/dist/core/sandbox/seatbelt.d.ts.map +1 -0
- package/dist/core/sandbox/seatbelt.js +154 -0
- package/dist/core/sandbox/seatbelt.js.map +1 -0
- package/dist/core/sandbox/self-test.d.ts +109 -0
- package/dist/core/sandbox/self-test.d.ts.map +1 -0
- package/dist/core/sandbox/self-test.js +369 -0
- package/dist/core/sandbox/self-test.js.map +1 -0
- package/dist/core/sandbox/spawn.d.ts +33 -0
- package/dist/core/sandbox/spawn.d.ts.map +1 -0
- package/dist/core/sandbox/spawn.js +87 -0
- package/dist/core/sandbox/spawn.js.map +1 -0
- package/dist/core/sdk.d.ts +7 -5
- package/dist/core/sdk.d.ts.map +1 -1
- package/dist/core/sdk.js +103 -53
- package/dist/core/sdk.js.map +1 -1
- package/dist/core/session-cwd.js +1 -0
- package/dist/core/session-cwd.js.map +1 -1
- package/dist/core/session-export.d.ts +8 -0
- package/dist/core/session-export.d.ts.map +1 -0
- package/dist/core/session-export.js +33 -0
- package/dist/core/session-export.js.map +1 -0
- package/dist/core/session-manager.d.ts +134 -15
- package/dist/core/session-manager.d.ts.map +1 -1
- package/dist/core/session-manager.js +366 -149
- package/dist/core/session-manager.js.map +1 -1
- package/dist/core/settings-diagnostics.d.ts +9 -0
- package/dist/core/settings-diagnostics.d.ts.map +1 -0
- package/dist/core/settings-diagnostics.js +21 -0
- package/dist/core/settings-diagnostics.js.map +1 -0
- package/dist/core/settings-manager.d.ts +105 -4
- package/dist/core/settings-manager.d.ts.map +1 -1
- package/dist/core/settings-manager.js +274 -40
- package/dist/core/settings-manager.js.map +1 -1
- package/dist/core/skills.d.ts +3 -1
- package/dist/core/skills.d.ts.map +1 -1
- package/dist/core/skills.js +70 -39
- package/dist/core/skills.js.map +1 -1
- package/dist/core/slash-commands.d.ts.map +1 -1
- package/dist/core/slash-commands.js +4 -1
- package/dist/core/slash-commands.js.map +1 -1
- package/dist/core/soak/soak-log.d.ts +298 -0
- package/dist/core/soak/soak-log.d.ts.map +1 -0
- package/dist/core/soak/soak-log.js +666 -0
- package/dist/core/soak/soak-log.js.map +1 -0
- package/dist/core/soak/soak-reader.d.ts +60 -0
- package/dist/core/soak/soak-reader.d.ts.map +1 -0
- package/dist/core/soak/soak-reader.js +106 -0
- package/dist/core/soak/soak-reader.js.map +1 -0
- package/dist/core/socket-server/discovery.d.ts +78 -1
- package/dist/core/socket-server/discovery.d.ts.map +1 -1
- package/dist/core/socket-server/discovery.js +356 -37
- package/dist/core/socket-server/discovery.js.map +1 -1
- package/dist/core/socket-server/index.d.ts +10 -4
- package/dist/core/socket-server/index.d.ts.map +1 -1
- package/dist/core/socket-server/index.js +6 -3
- package/dist/core/socket-server/index.js.map +1 -1
- package/dist/core/socket-server/permission-delivery.d.ts +125 -0
- package/dist/core/socket-server/permission-delivery.d.ts.map +1 -0
- package/dist/core/socket-server/permission-delivery.js +152 -0
- package/dist/core/socket-server/permission-delivery.js.map +1 -0
- package/dist/core/socket-server/permission-registry.d.ts +301 -0
- package/dist/core/socket-server/permission-registry.d.ts.map +1 -0
- package/dist/core/socket-server/permission-registry.js +410 -0
- package/dist/core/socket-server/permission-registry.js.map +1 -0
- package/dist/core/socket-server/permission-relay.d.ts +81 -0
- package/dist/core/socket-server/permission-relay.d.ts.map +1 -0
- package/dist/core/socket-server/permission-relay.js +528 -0
- package/dist/core/socket-server/permission-relay.js.map +1 -0
- package/dist/core/socket-server/safe-text.d.ts +83 -0
- package/dist/core/socket-server/safe-text.d.ts.map +1 -0
- package/dist/core/socket-server/safe-text.js +277 -0
- package/dist/core/socket-server/safe-text.js.map +1 -0
- package/dist/core/socket-server/session-integration.d.ts +65 -2
- package/dist/core/socket-server/session-integration.d.ts.map +1 -1
- package/dist/core/socket-server/session-integration.js +434 -32
- package/dist/core/socket-server/session-integration.js.map +1 -1
- package/dist/core/socket-server/socket-client.d.ts +21 -2
- package/dist/core/socket-server/socket-client.d.ts.map +1 -1
- package/dist/core/socket-server/socket-client.js +52 -1
- package/dist/core/socket-server/socket-client.js.map +1 -1
- package/dist/core/socket-server/socket-server.d.ts +152 -1
- package/dist/core/socket-server/socket-server.d.ts.map +1 -1
- package/dist/core/socket-server/socket-server.js +786 -26
- package/dist/core/socket-server/socket-server.js.map +1 -1
- package/dist/core/socket-server/types.d.ts +108 -3
- package/dist/core/socket-server/types.d.ts.map +1 -1
- package/dist/core/socket-server/types.js +13 -1
- package/dist/core/socket-server/types.js.map +1 -1
- package/dist/core/source-info.d.ts +8 -0
- package/dist/core/source-info.d.ts.map +1 -1
- package/dist/core/source-info.js +16 -0
- package/dist/core/source-info.js.map +1 -1
- package/dist/core/system-prompt.d.ts +49 -6
- package/dist/core/system-prompt.d.ts.map +1 -1
- package/dist/core/system-prompt.js +126 -90
- package/dist/core/system-prompt.js.map +1 -1
- package/dist/core/tools/bash.d.ts +32 -2
- package/dist/core/tools/bash.d.ts.map +1 -1
- package/dist/core/tools/bash.js +83 -141
- package/dist/core/tools/bash.js.map +1 -1
- package/dist/core/tools/edit-diff.d.ts +0 -5
- package/dist/core/tools/edit-diff.d.ts.map +1 -1
- package/dist/core/tools/edit-diff.js +2 -5
- package/dist/core/tools/edit-diff.js.map +1 -1
- package/dist/core/tools/edit.d.ts +5 -12
- package/dist/core/tools/edit.d.ts.map +1 -1
- package/dist/core/tools/edit.js +36 -173
- package/dist/core/tools/edit.js.map +1 -1
- package/dist/core/tools/find.d.ts +7 -0
- package/dist/core/tools/find.d.ts.map +1 -1
- package/dist/core/tools/find.js +22 -76
- package/dist/core/tools/find.js.map +1 -1
- package/dist/core/tools/grep.d.ts +4 -0
- package/dist/core/tools/grep.d.ts.map +1 -1
- package/dist/core/tools/grep.js +10 -62
- package/dist/core/tools/grep.js.map +1 -1
- package/dist/core/tools/index.d.ts +4 -1
- package/dist/core/tools/index.d.ts.map +1 -1
- package/dist/core/tools/index.js +18 -1
- package/dist/core/tools/index.js.map +1 -1
- package/dist/core/tools/ls.d.ts +4 -0
- package/dist/core/tools/ls.d.ts.map +1 -1
- package/dist/core/tools/ls.js +9 -50
- package/dist/core/tools/ls.js.map +1 -1
- package/dist/core/tools/output-accumulator.d.ts +11 -0
- package/dist/core/tools/output-accumulator.d.ts.map +1 -1
- package/dist/core/tools/output-accumulator.js +54 -12
- package/dist/core/tools/output-accumulator.js.map +1 -1
- package/dist/core/tools/powershell.d.ts +16 -0
- package/dist/core/tools/powershell.d.ts.map +1 -0
- package/dist/core/tools/powershell.js +39 -0
- package/dist/core/tools/powershell.js.map +1 -0
- package/dist/core/tools/read.d.ts +8 -1
- package/dist/core/tools/read.d.ts.map +1 -1
- package/dist/core/tools/read.js +16 -123
- package/dist/core/tools/read.js.map +1 -1
- package/dist/core/tools/render-utils.d.ts +6 -0
- package/dist/core/tools/render-utils.d.ts.map +1 -1
- package/dist/core/tools/render-utils.js +26 -0
- package/dist/core/tools/render-utils.js.map +1 -1
- package/dist/core/tools/renderers/bash.d.ts +12 -0
- package/dist/core/tools/renderers/bash.d.ts.map +1 -0
- package/dist/core/tools/renderers/bash.js +117 -0
- package/dist/core/tools/renderers/bash.js.map +1 -0
- package/dist/core/tools/renderers/edit.d.ts +23 -0
- package/dist/core/tools/renderers/edit.d.ts.map +1 -0
- package/dist/core/tools/renderers/edit.js +167 -0
- package/dist/core/tools/renderers/edit.js.map +1 -0
- package/dist/core/tools/renderers/find.d.ts +10 -0
- package/dist/core/tools/renderers/find.d.ts.map +1 -0
- package/dist/core/tools/renderers/find.js +64 -0
- package/dist/core/tools/renderers/find.js.map +1 -0
- package/dist/core/tools/renderers/grep.d.ts +10 -0
- package/dist/core/tools/renderers/grep.d.ts.map +1 -0
- package/dist/core/tools/renderers/grep.js +69 -0
- package/dist/core/tools/renderers/grep.js.map +1 -0
- package/dist/core/tools/renderers/index.d.ts +28 -0
- package/dist/core/tools/renderers/index.d.ts.map +1 -0
- package/dist/core/tools/renderers/index.js +47 -0
- package/dist/core/tools/renderers/index.js.map +1 -0
- package/dist/core/tools/renderers/ls.d.ts +10 -0
- package/dist/core/tools/renderers/ls.d.ts.map +1 -0
- package/dist/core/tools/renderers/ls.js +58 -0
- package/dist/core/tools/renderers/ls.js.map +1 -0
- package/dist/core/tools/renderers/read.d.ts +11 -0
- package/dist/core/tools/renderers/read.d.ts.map +1 -0
- package/dist/core/tools/renderers/read.js +130 -0
- package/dist/core/tools/renderers/read.js.map +1 -0
- package/dist/core/tools/renderers/write.d.ts +10 -0
- package/dist/core/tools/renderers/write.d.ts.map +1 -0
- package/dist/core/tools/renderers/write.js +153 -0
- package/dist/core/tools/renderers/write.js.map +1 -0
- package/dist/core/tools/tool-definition-wrapper.d.ts +5 -3
- package/dist/core/tools/tool-definition-wrapper.d.ts.map +1 -1
- package/dist/core/tools/tool-definition-wrapper.js +3 -1
- package/dist/core/tools/tool-definition-wrapper.js.map +1 -1
- package/dist/core/tools/truncate.d.ts +14 -0
- package/dist/core/tools/truncate.d.ts.map +1 -1
- package/dist/core/tools/truncate.js +29 -0
- package/dist/core/tools/truncate.js.map +1 -1
- package/dist/core/tools/write.d.ts +4 -0
- package/dist/core/tools/write.d.ts.map +1 -1
- package/dist/core/tools/write.js +12 -147
- package/dist/core/tools/write.js.map +1 -1
- package/dist/core/trust-manager.d.ts +6 -4
- package/dist/core/trust-manager.d.ts.map +1 -1
- package/dist/core/trust-manager.js +59 -22
- package/dist/core/trust-manager.js.map +1 -1
- package/dist/core/usage-totals.d.ts +3 -1
- package/dist/core/usage-totals.d.ts.map +1 -1
- package/dist/core/usage-totals.js +28 -1
- package/dist/core/usage-totals.js.map +1 -1
- package/dist/core/virtual-models.d.ts +117 -0
- package/dist/core/virtual-models.d.ts.map +1 -0
- package/dist/core/virtual-models.js +124 -0
- package/dist/core/virtual-models.js.map +1 -0
- package/dist/experimental/micro/api.d.ts +81 -0
- package/dist/experimental/micro/api.d.ts.map +1 -0
- package/dist/experimental/micro/api.js +2 -0
- package/dist/experimental/micro/api.js.map +1 -0
- package/dist/experimental/micro/main.d.ts +3 -0
- package/dist/experimental/micro/main.d.ts.map +1 -0
- package/dist/experimental/micro/main.js +21 -0
- package/dist/experimental/micro/main.js.map +1 -0
- package/dist/experimental/micro/models.d.ts +11 -0
- package/dist/experimental/micro/models.d.ts.map +1 -0
- package/dist/experimental/micro/models.js +95 -0
- package/dist/experimental/micro/models.js.map +1 -0
- package/dist/experimental/micro/runtime.d.ts +12 -0
- package/dist/experimental/micro/runtime.d.ts.map +1 -0
- package/dist/experimental/micro/runtime.js +465 -0
- package/dist/experimental/micro/runtime.js.map +1 -0
- package/dist/experimental/micro/sessions.d.ts +10 -0
- package/dist/experimental/micro/sessions.d.ts.map +1 -0
- package/dist/experimental/micro/sessions.js +41 -0
- package/dist/experimental/micro/sessions.js.map +1 -0
- package/dist/experimental/micro/tools.d.ts +10 -0
- package/dist/experimental/micro/tools.d.ts.map +1 -0
- package/dist/experimental/micro/tools.js +96 -0
- package/dist/experimental/micro/tools.js.map +1 -0
- package/dist/experimental/micro/tui.d.ts +3 -0
- package/dist/experimental/micro/tui.d.ts.map +1 -0
- package/dist/experimental/micro/tui.js +510 -0
- package/dist/experimental/micro/tui.js.map +1 -0
- package/dist/experimental/mini/main.d.ts +7 -0
- package/dist/experimental/mini/main.d.ts.map +1 -0
- package/dist/experimental/mini/main.js +21 -0
- package/dist/experimental/mini/main.js.map +1 -0
- package/dist/experimental/mini/server/entry.d.ts +3 -0
- package/dist/experimental/mini/server/entry.d.ts.map +1 -0
- package/dist/experimental/mini/server/entry.js +11 -0
- package/dist/experimental/mini/server/entry.js.map +1 -0
- package/dist/experimental/mini/server/run.d.ts +13 -0
- package/dist/experimental/mini/server/run.d.ts.map +1 -0
- package/dist/experimental/mini/server/run.js +150 -0
- package/dist/experimental/mini/server/run.js.map +1 -0
- package/dist/experimental/mini/shared/protocol.d.ts +127 -0
- package/dist/experimental/mini/shared/protocol.d.ts.map +1 -0
- package/dist/experimental/mini/shared/protocol.js +13 -0
- package/dist/experimental/mini/shared/protocol.js.map +1 -0
- package/dist/experimental/mini/shared/rpc.d.ts +49 -0
- package/dist/experimental/mini/shared/rpc.d.ts.map +1 -0
- package/dist/experimental/mini/shared/rpc.js +171 -0
- package/dist/experimental/mini/shared/rpc.js.map +1 -0
- package/dist/experimental/mini/shared/transport.d.ts +35 -0
- package/dist/experimental/mini/shared/transport.d.ts.map +1 -0
- package/dist/experimental/mini/shared/transport.js +94 -0
- package/dist/experimental/mini/shared/transport.js.map +1 -0
- package/dist/experimental/mini/tui/run.d.ts +9 -0
- package/dist/experimental/mini/tui/run.d.ts.map +1 -0
- package/dist/experimental/mini/tui/run.js +62 -0
- package/dist/experimental/mini/tui/run.js.map +1 -0
- package/dist/experimental/mini/tui/session.d.ts +26 -0
- package/dist/experimental/mini/tui/session.d.ts.map +1 -0
- package/dist/experimental/mini/tui/session.js +94 -0
- package/dist/experimental/mini/tui/session.js.map +1 -0
- package/dist/experimental/mini/tui/view.d.ts +10 -0
- package/dist/experimental/mini/tui/view.d.ts.map +1 -0
- package/dist/experimental/mini/tui/view.js +461 -0
- package/dist/experimental/mini/tui/view.js.map +1 -0
- package/dist/experimental/mini/worker/entry.d.ts +3 -0
- package/dist/experimental/mini/worker/entry.d.ts.map +1 -0
- package/dist/experimental/mini/worker/entry.js +10 -0
- package/dist/experimental/mini/worker/entry.js.map +1 -0
- package/dist/experimental/mini/worker/lane-service.d.ts +44 -0
- package/dist/experimental/mini/worker/lane-service.d.ts.map +1 -0
- package/dist/experimental/mini/worker/lane-service.js +97 -0
- package/dist/experimental/mini/worker/lane-service.js.map +1 -0
- package/dist/experimental/mini/worker/models-service.d.ts +19 -0
- package/dist/experimental/mini/worker/models-service.d.ts.map +1 -0
- package/dist/experimental/mini/worker/models-service.js +136 -0
- package/dist/experimental/mini/worker/models-service.js.map +1 -0
- package/dist/experimental/mini/worker/run.d.ts +14 -0
- package/dist/experimental/mini/worker/run.d.ts.map +1 -0
- package/dist/experimental/mini/worker/run.js +88 -0
- package/dist/experimental/mini/worker/run.js.map +1 -0
- package/dist/extensions/codemode/execute.d.ts +16 -0
- package/dist/extensions/codemode/execute.d.ts.map +1 -0
- package/dist/extensions/codemode/execute.js +429 -0
- package/dist/extensions/codemode/execute.js.map +1 -0
- package/dist/extensions/codemode/execute.lazy.d.ts +3 -0
- package/dist/extensions/codemode/execute.lazy.d.ts.map +1 -0
- package/dist/extensions/codemode/execute.lazy.js +3 -0
- package/dist/extensions/codemode/execute.lazy.js.map +1 -0
- package/dist/extensions/codemode/index.d.ts +21 -0
- package/dist/extensions/codemode/index.d.ts.map +1 -0
- package/dist/extensions/codemode/index.js +31 -0
- package/dist/extensions/codemode/index.js.map +1 -0
- package/dist/extensions/codemode/renderer.d.ts +12 -0
- package/dist/extensions/codemode/renderer.d.ts.map +1 -0
- package/dist/extensions/codemode/renderer.js +137 -0
- package/dist/extensions/codemode/renderer.js.map +1 -0
- package/dist/extensions/codemode/tool.d.ts +123 -0
- package/dist/extensions/codemode/tool.d.ts.map +1 -0
- package/dist/extensions/codemode/tool.js +315 -0
- package/dist/extensions/codemode/tool.js.map +1 -0
- package/dist/extensions/codemode/worker.d.ts +7 -0
- package/dist/extensions/codemode/worker.d.ts.map +1 -0
- package/dist/extensions/codemode/worker.js +7 -0
- package/dist/extensions/codemode/worker.js.map +1 -0
- package/dist/extensions/index.d.ts.map +1 -1
- package/dist/extensions/index.js +13 -1
- package/dist/extensions/index.js.map +1 -1
- package/dist/extensions/llama/client.d.ts +8 -0
- package/dist/extensions/llama/client.d.ts.map +1 -1
- package/dist/extensions/llama/client.js +13 -0
- package/dist/extensions/llama/client.js.map +1 -1
- package/dist/extensions/llama/huggingface.js +2 -0
- package/dist/extensions/llama/huggingface.js.map +1 -1
- package/dist/extensions/llama/index.d.ts.map +1 -1
- package/dist/extensions/llama/index.js +13 -2
- package/dist/extensions/llama/index.js.map +1 -1
- package/dist/extensions/llama/provider.d.ts +4 -2
- package/dist/extensions/llama/provider.d.ts.map +1 -1
- package/dist/extensions/llama/provider.js +121 -15
- package/dist/extensions/llama/provider.js.map +1 -1
- package/dist/extensions/llama/ui.js +28 -12
- package/dist/extensions/llama/ui.js.map +1 -1
- package/dist/extensions/mcp/cli.d.ts +21 -0
- package/dist/extensions/mcp/cli.d.ts.map +1 -0
- package/dist/extensions/mcp/cli.js +500 -0
- package/dist/extensions/mcp/cli.js.map +1 -0
- package/dist/extensions/mcp/cli.lazy.d.ts +3 -0
- package/dist/extensions/mcp/cli.lazy.d.ts.map +1 -0
- package/dist/extensions/mcp/cli.lazy.js +3 -0
- package/dist/extensions/mcp/cli.lazy.js.map +1 -0
- package/dist/extensions/mcp/config.d.ts +72 -0
- package/dist/extensions/mcp/config.d.ts.map +1 -0
- package/dist/extensions/mcp/config.js +158 -0
- package/dist/extensions/mcp/config.js.map +1 -0
- package/dist/extensions/mcp/index.d.ts +76 -0
- package/dist/extensions/mcp/index.d.ts.map +1 -0
- package/dist/extensions/mcp/index.js +1055 -0
- package/dist/extensions/mcp/index.js.map +1 -0
- package/dist/extensions/mcp/log.d.ts +16 -0
- package/dist/extensions/mcp/log.d.ts.map +1 -0
- package/dist/extensions/mcp/log.js +66 -0
- package/dist/extensions/mcp/log.js.map +1 -0
- package/dist/extensions/mcp/oauth.d.ts +96 -0
- package/dist/extensions/mcp/oauth.d.ts.map +1 -0
- package/dist/extensions/mcp/oauth.js +333 -0
- package/dist/extensions/mcp/oauth.js.map +1 -0
- package/dist/extensions/mcp/resources.d.ts +43 -0
- package/dist/extensions/mcp/resources.d.ts.map +1 -0
- package/dist/extensions/mcp/resources.js +262 -0
- package/dist/extensions/mcp/resources.js.map +1 -0
- package/dist/extensions/mcp/runtime.d.ts +98 -0
- package/dist/extensions/mcp/runtime.d.ts.map +1 -0
- package/dist/extensions/mcp/runtime.js +394 -0
- package/dist/extensions/mcp/runtime.js.map +1 -0
- package/dist/extensions/mcp/runtime.lazy.d.ts +3 -0
- package/dist/extensions/mcp/runtime.lazy.d.ts.map +1 -0
- package/dist/extensions/mcp/runtime.lazy.js +3 -0
- package/dist/extensions/mcp/runtime.lazy.js.map +1 -0
- package/dist/extensions/mcp/tools.d.ts +84 -0
- package/dist/extensions/mcp/tools.d.ts.map +1 -0
- package/dist/extensions/mcp/tools.js +251 -0
- package/dist/extensions/mcp/tools.js.map +1 -0
- package/dist/extensions/mcp/ui.d.ts +60 -0
- package/dist/extensions/mcp/ui.d.ts.map +1 -0
- package/dist/extensions/mcp/ui.js +174 -0
- package/dist/extensions/mcp/ui.js.map +1 -0
- package/dist/extensions/stub-provider/index.d.ts +9 -0
- package/dist/extensions/stub-provider/index.d.ts.map +1 -0
- package/dist/extensions/stub-provider/index.js +13 -0
- package/dist/extensions/stub-provider/index.js.map +1 -0
- package/dist/extensions/stub-provider/provider.d.ts +77 -0
- package/dist/extensions/stub-provider/provider.d.ts.map +1 -0
- package/dist/extensions/stub-provider/provider.js +194 -0
- package/dist/extensions/stub-provider/provider.js.map +1 -0
- package/dist/extensions/tool-search/index.d.ts +12 -0
- package/dist/extensions/tool-search/index.d.ts.map +1 -0
- package/dist/extensions/tool-search/index.js +15 -0
- package/dist/extensions/tool-search/index.js.map +1 -0
- package/dist/extensions/tool-search/tool.d.ts +73 -0
- package/dist/extensions/tool-search/tool.d.ts.map +1 -0
- package/dist/extensions/tool-search/tool.js +189 -0
- package/dist/extensions/tool-search/tool.js.map +1 -0
- package/dist/hooks/gsd/draht-quality-gate.js +3 -3
- package/dist/index.d.ts +20 -11
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +12 -6
- package/dist/index.js.map +1 -1
- package/dist/main.d.ts +4 -0
- package/dist/main.d.ts.map +1 -1
- package/dist/main.js +365 -96
- package/dist/main.js.map +1 -1
- package/dist/migrations.d.ts +1 -1
- package/dist/migrations.js +7 -6
- package/dist/migrations.js.map +1 -1
- package/dist/modes/index.d.ts +1 -0
- package/dist/modes/index.d.ts.map +1 -1
- package/dist/modes/index.js.map +1 -1
- package/dist/modes/interactive/bug-report.d.ts +19 -0
- package/dist/modes/interactive/bug-report.d.ts.map +1 -0
- package/dist/modes/interactive/bug-report.js +211 -0
- package/dist/modes/interactive/bug-report.js.map +1 -0
- package/dist/modes/interactive/chat-viewport.d.ts +20 -0
- package/dist/modes/interactive/chat-viewport.d.ts.map +1 -0
- package/dist/modes/interactive/chat-viewport.js +28 -0
- package/dist/modes/interactive/chat-viewport.js.map +1 -0
- package/dist/modes/interactive/components/armin.js +10 -6
- package/dist/modes/interactive/components/armin.js.map +1 -1
- package/dist/modes/interactive/components/assistant-message.d.ts +6 -2
- package/dist/modes/interactive/components/assistant-message.d.ts.map +1 -1
- package/dist/modes/interactive/components/assistant-message.js +38 -15
- package/dist/modes/interactive/components/assistant-message.js.map +1 -1
- package/dist/modes/interactive/components/bash-execution.js +9 -4
- package/dist/modes/interactive/components/bash-execution.js.map +1 -1
- package/dist/modes/interactive/components/bordered-loader.js +3 -0
- package/dist/modes/interactive/components/bordered-loader.js.map +1 -1
- package/dist/modes/interactive/components/branch-summary-message.d.ts +1 -1
- package/dist/modes/interactive/components/branch-summary-message.d.ts.map +1 -1
- package/dist/modes/interactive/components/branch-summary-message.js +15 -6
- package/dist/modes/interactive/components/branch-summary-message.js.map +1 -1
- package/dist/modes/interactive/components/compaction-summary-message.d.ts +1 -1
- package/dist/modes/interactive/components/compaction-summary-message.d.ts.map +1 -1
- package/dist/modes/interactive/components/compaction-summary-message.js +15 -6
- package/dist/modes/interactive/components/compaction-summary-message.js.map +1 -1
- package/dist/modes/interactive/components/config-selector.d.ts.map +1 -1
- package/dist/modes/interactive/components/config-selector.js +38 -10
- package/dist/modes/interactive/components/config-selector.js.map +1 -1
- package/dist/modes/interactive/components/countdown-timer.js +5 -0
- package/dist/modes/interactive/components/countdown-timer.js.map +1 -1
- package/dist/modes/interactive/components/custom-editor.d.ts +10 -1
- package/dist/modes/interactive/components/custom-editor.d.ts.map +1 -1
- package/dist/modes/interactive/components/custom-editor.js +54 -2
- package/dist/modes/interactive/components/custom-editor.js.map +1 -1
- package/dist/modes/interactive/components/custom-entry.js +4 -1
- package/dist/modes/interactive/components/custom-entry.js.map +1 -1
- package/dist/modes/interactive/components/custom-message.js +7 -1
- package/dist/modes/interactive/components/custom-message.js.map +1 -1
- package/dist/modes/interactive/components/daxnuts.js +8 -6
- package/dist/modes/interactive/components/daxnuts.js.map +1 -1
- package/dist/modes/interactive/components/dynamic-border.js +1 -0
- package/dist/modes/interactive/components/dynamic-border.js.map +1 -1
- package/dist/modes/interactive/components/extension-editor.d.ts +4 -1
- package/dist/modes/interactive/components/extension-editor.d.ts.map +1 -1
- package/dist/modes/interactive/components/extension-editor.js +14 -3
- package/dist/modes/interactive/components/extension-editor.js.map +1 -1
- package/dist/modes/interactive/components/extension-input.d.ts +2 -0
- package/dist/modes/interactive/components/extension-input.d.ts.map +1 -1
- package/dist/modes/interactive/components/extension-input.js +14 -2
- package/dist/modes/interactive/components/extension-input.js.map +1 -1
- package/dist/modes/interactive/components/extension-selector.d.ts +50 -0
- package/dist/modes/interactive/components/extension-selector.d.ts.map +1 -1
- package/dist/modes/interactive/components/extension-selector.js +218 -6
- package/dist/modes/interactive/components/extension-selector.js.map +1 -1
- package/dist/modes/interactive/components/first-time-setup.d.ts +4 -4
- package/dist/modes/interactive/components/first-time-setup.d.ts.map +1 -1
- package/dist/modes/interactive/components/first-time-setup.js +12 -4
- package/dist/modes/interactive/components/first-time-setup.js.map +1 -1
- package/dist/modes/interactive/components/footer.d.ts +7 -0
- package/dist/modes/interactive/components/footer.d.ts.map +1 -1
- package/dist/modes/interactive/components/footer.js +51 -6
- package/dist/modes/interactive/components/footer.js.map +1 -1
- package/dist/modes/interactive/components/index.d.ts +1 -1
- package/dist/modes/interactive/components/index.d.ts.map +1 -1
- package/dist/modes/interactive/components/index.js.map +1 -1
- package/dist/modes/interactive/components/login-dialog.js +9 -3
- package/dist/modes/interactive/components/login-dialog.js.map +1 -1
- package/dist/modes/interactive/components/markdown-transform.d.ts +3 -0
- package/dist/modes/interactive/components/markdown-transform.d.ts.map +1 -0
- package/dist/modes/interactive/components/markdown-transform.js +19 -0
- package/dist/modes/interactive/components/markdown-transform.js.map +1 -0
- package/dist/modes/interactive/components/mermaid.d.ts +11 -0
- package/dist/modes/interactive/components/mermaid.d.ts.map +1 -0
- package/dist/modes/interactive/components/mermaid.js +75 -0
- package/dist/modes/interactive/components/mermaid.js.map +1 -0
- package/dist/modes/interactive/components/model-selector.d.ts +10 -4
- package/dist/modes/interactive/components/model-selector.d.ts.map +1 -1
- package/dist/modes/interactive/components/model-selector.js +101 -40
- package/dist/modes/interactive/components/model-selector.js.map +1 -1
- package/dist/modes/interactive/components/oauth-selector.js +11 -3
- package/dist/modes/interactive/components/oauth-selector.js.map +1 -1
- package/dist/modes/interactive/components/scoped-models-selector.d.ts +4 -0
- package/dist/modes/interactive/components/scoped-models-selector.d.ts.map +1 -1
- package/dist/modes/interactive/components/scoped-models-selector.js +60 -32
- package/dist/modes/interactive/components/scoped-models-selector.js.map +1 -1
- package/dist/modes/interactive/components/session-selector.d.ts +5 -5
- package/dist/modes/interactive/components/session-selector.d.ts.map +1 -1
- package/dist/modes/interactive/components/session-selector.js +138 -80
- package/dist/modes/interactive/components/session-selector.js.map +1 -1
- package/dist/modes/interactive/components/settings-selector.d.ts +25 -4
- package/dist/modes/interactive/components/settings-selector.d.ts.map +1 -1
- package/dist/modes/interactive/components/settings-selector.js +240 -67
- package/dist/modes/interactive/components/settings-selector.js.map +1 -1
- package/dist/modes/interactive/components/settings-submenu.d.ts +72 -0
- package/dist/modes/interactive/components/settings-submenu.d.ts.map +1 -0
- package/dist/modes/interactive/components/settings-submenu.js +165 -0
- package/dist/modes/interactive/components/settings-submenu.js.map +1 -0
- package/dist/modes/interactive/components/show-images-selector.js +1 -0
- package/dist/modes/interactive/components/show-images-selector.js.map +1 -1
- package/dist/modes/interactive/components/skill-invocation-message.d.ts.map +1 -1
- package/dist/modes/interactive/components/skill-invocation-message.js +14 -5
- package/dist/modes/interactive/components/skill-invocation-message.js.map +1 -1
- package/dist/modes/interactive/components/status-indicator.d.ts +3 -1
- package/dist/modes/interactive/components/status-indicator.d.ts.map +1 -1
- package/dist/modes/interactive/components/status-indicator.js +12 -3
- package/dist/modes/interactive/components/status-indicator.js.map +1 -1
- package/dist/modes/interactive/components/theme-selector.js +2 -0
- package/dist/modes/interactive/components/theme-selector.js.map +1 -1
- package/dist/modes/interactive/components/themed-text.d.ts +17 -0
- package/dist/modes/interactive/components/themed-text.d.ts.map +1 -0
- package/dist/modes/interactive/components/themed-text.js +29 -0
- package/dist/modes/interactive/components/themed-text.js.map +1 -0
- package/dist/modes/interactive/components/thinking-selector.d.ts +15 -3
- package/dist/modes/interactive/components/thinking-selector.d.ts.map +1 -1
- package/dist/modes/interactive/components/thinking-selector.js +76 -18
- package/dist/modes/interactive/components/thinking-selector.js.map +1 -1
- package/dist/modes/interactive/components/tool-execution.d.ts +21 -4
- package/dist/modes/interactive/components/tool-execution.d.ts.map +1 -1
- package/dist/modes/interactive/components/tool-execution.js +88 -53
- package/dist/modes/interactive/components/tool-execution.js.map +1 -1
- package/dist/modes/interactive/components/tree-selector.d.ts +20 -2
- package/dist/modes/interactive/components/tree-selector.d.ts.map +1 -1
- package/dist/modes/interactive/components/tree-selector.js +65 -23
- package/dist/modes/interactive/components/tree-selector.js.map +1 -1
- package/dist/modes/interactive/components/trust-selector.js +8 -2
- package/dist/modes/interactive/components/trust-selector.js.map +1 -1
- package/dist/modes/interactive/components/user-message-selector.js +6 -3
- package/dist/modes/interactive/components/user-message-selector.js.map +1 -1
- package/dist/modes/interactive/components/user-message.d.ts +3 -1
- package/dist/modes/interactive/components/user-message.d.ts.map +1 -1
- package/dist/modes/interactive/components/user-message.js +12 -2
- package/dist/modes/interactive/components/user-message.js.map +1 -1
- package/dist/modes/interactive/components/visual-truncate.d.ts +27 -3
- package/dist/modes/interactive/components/visual-truncate.d.ts.map +1 -1
- package/dist/modes/interactive/components/visual-truncate.js +39 -6
- package/dist/modes/interactive/components/visual-truncate.js.map +1 -1
- package/dist/modes/interactive/external-editor.d.ts.map +1 -1
- package/dist/modes/interactive/external-editor.js +2 -1
- package/dist/modes/interactive/external-editor.js.map +1 -1
- package/dist/modes/interactive/interactive-mode.d.ts +166 -8
- package/dist/modes/interactive/interactive-mode.d.ts.map +1 -1
- package/dist/modes/interactive/interactive-mode.js +1690 -599
- package/dist/modes/interactive/interactive-mode.js.map +1 -1
- package/dist/modes/interactive/model-catalog-refresh.d.ts +7 -0
- package/dist/modes/interactive/model-catalog-refresh.d.ts.map +1 -0
- package/dist/modes/interactive/model-catalog-refresh.js +34 -0
- package/dist/modes/interactive/model-catalog-refresh.js.map +1 -0
- package/dist/modes/interactive/session-share.d.ts +23 -0
- package/dist/modes/interactive/session-share.d.ts.map +1 -0
- package/dist/modes/interactive/session-share.js +130 -0
- package/dist/modes/interactive/session-share.js.map +1 -0
- package/dist/modes/interactive/theme/dark.json +54 -63
- package/dist/modes/interactive/theme/light.json +52 -60
- package/dist/modes/interactive/theme/system-theme.d.ts +54 -0
- package/dist/modes/interactive/theme/system-theme.d.ts.map +1 -0
- package/dist/modes/interactive/theme/system-theme.js +535 -0
- package/dist/modes/interactive/theme/system-theme.js.map +1 -0
- package/dist/modes/interactive/theme/theme-controller.d.ts +59 -7
- package/dist/modes/interactive/theme/theme-controller.d.ts.map +1 -1
- package/dist/modes/interactive/theme/theme-controller.js +164 -51
- package/dist/modes/interactive/theme/theme-controller.js.map +1 -1
- package/dist/modes/interactive/theme/theme-json.d.ts +85 -0
- package/dist/modes/interactive/theme/theme-json.d.ts.map +1 -0
- package/dist/modes/interactive/theme/theme-json.js +132 -0
- package/dist/modes/interactive/theme/theme-json.js.map +1 -0
- package/dist/modes/interactive/theme/theme-schema.json +24 -3
- package/dist/modes/interactive/theme/theme.d.ts +80 -42
- package/dist/modes/interactive/theme/theme.d.ts.map +1 -1
- package/dist/modes/interactive/theme/theme.js +274 -417
- package/dist/modes/interactive/theme/theme.js.map +1 -1
- package/dist/modes/interactive/tui-renderer.d.ts +22 -0
- package/dist/modes/interactive/tui-renderer.d.ts.map +1 -0
- package/dist/modes/interactive/tui-renderer.js +67 -0
- package/dist/modes/interactive/tui-renderer.js.map +1 -0
- package/dist/modes/json-event.d.ts +34 -0
- package/dist/modes/json-event.d.ts.map +1 -0
- package/dist/modes/json-event.js +29 -0
- package/dist/modes/json-event.js.map +1 -0
- package/dist/modes/print-mode.d.ts +1 -1
- package/dist/modes/print-mode.d.ts.map +1 -1
- package/dist/modes/print-mode.js +12 -2
- package/dist/modes/print-mode.js.map +1 -1
- package/dist/modes/rpc/rpc-client.d.ts +17 -9
- package/dist/modes/rpc/rpc-client.d.ts.map +1 -1
- package/dist/modes/rpc/rpc-client.js +27 -15
- package/dist/modes/rpc/rpc-client.js.map +1 -1
- package/dist/modes/rpc/rpc-mode.d.ts.map +1 -1
- package/dist/modes/rpc/rpc-mode.js +179 -19
- package/dist/modes/rpc/rpc-mode.js.map +1 -1
- package/dist/modes/rpc/rpc-types.d.ts +90 -2
- package/dist/modes/rpc/rpc-types.d.ts.map +1 -1
- package/dist/modes/rpc/rpc-types.js.map +1 -1
- package/dist/package-manager-cli.d.ts +1 -0
- package/dist/package-manager-cli.d.ts.map +1 -1
- package/dist/package-manager-cli.js +217 -63
- package/dist/package-manager-cli.js.map +1 -1
- package/dist/prompts/commands/atomic-commit.md +1 -12
- package/dist/prompts/commands/brainstorm.md +12 -15
- package/dist/prompts/commands/create-verification-skill.md +108 -0
- package/dist/prompts/commands/discuss-phase.md +3 -14
- package/dist/prompts/commands/execute-phase.md +3 -11
- package/dist/prompts/commands/fix.md +41 -18
- package/dist/prompts/commands/grill.md +66 -0
- package/dist/prompts/commands/init-project.md +5 -15
- package/dist/prompts/commands/map-codebase.md +1 -13
- package/dist/prompts/commands/new-project.md +5 -15
- package/dist/prompts/commands/next-milestone.md +1 -13
- package/dist/prompts/commands/orchestrate.md +1 -1
- package/dist/prompts/commands/pause-work.md +1 -13
- package/dist/prompts/commands/plan-phase.md +3 -11
- package/dist/prompts/commands/progress.md +0 -13
- package/dist/prompts/commands/quick.md +3 -11
- package/dist/prompts/commands/resolve-conflicts.md +71 -0
- package/dist/prompts/commands/resume-work.md +0 -13
- package/dist/prompts/commands/review.md +6 -13
- package/dist/prompts/commands/triage.md +159 -0
- package/dist/prompts/commands/verify-work.md +5 -14
- package/dist/prompts/commands/why.md +139 -0
- package/dist/rpc-entry.js +1 -0
- package/dist/rpc-entry.js.map +1 -1
- package/dist/skills/atomic-reasoning/SKILL.md +115 -0
- package/dist/skills/blast-radius/SKILL.md +56 -0
- package/dist/skills/epistemics/SKILL.md +99 -0
- package/dist/skills/explainers/SKILL.md +65 -0
- package/dist/skills/hexagon-animation/SKILL.md +49 -0
- package/dist/skills/hexagon-animation/generate.mjs +81 -0
- package/dist/skills/hexagon-animation/template.html +361 -0
- package/dist/skills/typescript-discipline/SKILL.md +50 -0
- package/dist/skills/typescript-discipline/references/patterns.md +294 -0
- package/dist/skills/unslop/SKILL.md +119 -0
- package/dist/utils/abort.d.ts +5 -0
- package/dist/utils/abort.d.ts.map +1 -0
- package/dist/utils/abort.js +48 -0
- package/dist/utils/abort.js.map +1 -0
- package/dist/utils/canonical-path.d.ts +28 -0
- package/dist/utils/canonical-path.d.ts.map +1 -0
- package/dist/utils/canonical-path.js +90 -0
- package/dist/utils/canonical-path.js.map +1 -0
- package/dist/utils/changelog.js +1 -1
- package/dist/utils/changelog.js.map +1 -1
- package/dist/utils/child-process.d.ts +13 -2
- package/dist/utils/child-process.d.ts.map +1 -1
- package/dist/utils/child-process.js +26 -9
- package/dist/utils/child-process.js.map +1 -1
- package/dist/utils/clipboard-command.d.ts +7 -0
- package/dist/utils/clipboard-command.d.ts.map +1 -0
- package/dist/utils/clipboard-command.js +45 -0
- package/dist/utils/clipboard-command.js.map +1 -0
- package/dist/utils/clipboard-image.d.ts.map +1 -1
- package/dist/utils/clipboard-image.js +60 -91
- package/dist/utils/clipboard-image.js.map +1 -1
- package/dist/utils/clipboard.d.ts +3 -1
- package/dist/utils/clipboard.d.ts.map +1 -1
- package/dist/utils/clipboard.js +123 -108
- package/dist/utils/clipboard.js.map +1 -1
- package/dist/utils/draht-user-agent.d.ts +2 -0
- package/dist/utils/draht-user-agent.d.ts.map +1 -0
- package/dist/utils/draht-user-agent.js +5 -0
- package/dist/utils/draht-user-agent.js.map +1 -0
- package/dist/utils/exif-orientation.d.ts +2 -1
- package/dist/utils/exif-orientation.d.ts.map +1 -1
- package/dist/utils/exif-orientation.js +2 -3
- package/dist/utils/exif-orientation.js.map +1 -1
- package/dist/utils/frontmatter.d.ts.map +1 -1
- package/dist/utils/frontmatter.js +2 -1
- package/dist/utils/frontmatter.js.map +1 -1
- package/dist/utils/management-http.d.ts +25 -0
- package/dist/utils/management-http.d.ts.map +1 -0
- package/dist/utils/management-http.js +54 -0
- package/dist/utils/management-http.js.map +1 -0
- package/dist/utils/mime.js +1 -1
- package/dist/utils/mime.js.map +1 -1
- package/dist/utils/paths.d.ts +6 -10
- package/dist/utils/paths.d.ts.map +1 -1
- package/dist/utils/paths.js +23 -14
- package/dist/utils/paths.js.map +1 -1
- package/dist/utils/photon.d.ts +2 -1
- package/dist/utils/photon.d.ts.map +1 -1
- package/dist/utils/photon.js.map +1 -1
- package/dist/utils/shell.d.ts +4 -3
- package/dist/utils/shell.d.ts.map +1 -1
- package/dist/utils/shell.js +26 -39
- package/dist/utils/shell.js.map +1 -1
- package/dist/utils/syntax-highlight.d.ts +1 -0
- package/dist/utils/syntax-highlight.d.ts.map +1 -1
- package/dist/utils/syntax-highlight.js +62 -1
- package/dist/utils/syntax-highlight.js.map +1 -1
- package/dist/utils/text.d.ts +8 -0
- package/dist/utils/text.d.ts.map +1 -0
- package/dist/utils/text.js +9 -0
- package/dist/utils/text.js.map +1 -0
- package/dist/utils/tool-result-images.d.ts +21 -0
- package/dist/utils/tool-result-images.d.ts.map +1 -0
- package/dist/utils/tool-result-images.js +48 -0
- package/dist/utils/tool-result-images.js.map +1 -0
- package/dist/utils/tools-manager.d.ts +11 -1
- package/dist/utils/tools-manager.d.ts.map +1 -1
- package/dist/utils/tools-manager.js +56 -41
- package/dist/utils/tools-manager.js.map +1 -1
- package/dist/utils/version-check.d.ts +4 -1
- package/dist/utils/version-check.d.ts.map +1 -1
- package/dist/utils/version-check.js +30 -9
- package/dist/utils/version-check.js.map +1 -1
- package/dist/utils/wsl.d.ts +3 -0
- package/dist/utils/wsl.d.ts.map +1 -0
- package/dist/utils/wsl.js +15 -0
- package/dist/utils/wsl.js.map +1 -0
- package/dist/utils/zip.d.ts +7 -0
- package/dist/utils/zip.d.ts.map +1 -0
- package/dist/utils/zip.js +60 -0
- package/dist/utils/zip.js.map +1 -0
- package/docs/attachable-sessions.md +79 -0
- package/docs/cli-integration.md +106 -0
- package/docs/cli.md +374 -0
- package/docs/compaction.md +107 -45
- package/docs/configuration.md +47 -0
- package/docs/containerization.md +100 -66
- package/docs/custom-provider.md +109 -707
- package/docs/docs.json +155 -95
- package/docs/duet.md +42 -0
- package/docs/environment-variables.md +30 -17
- package/docs/extensions.md +169 -2811
- package/docs/how-pi-works.md +53 -0
- package/docs/images/interactive-mode.png +0 -0
- package/docs/index.md +25 -69
- package/docs/json.md +198 -57
- package/docs/keybindings.md +89 -92
- package/docs/llama-cpp.md +23 -8
- package/docs/mcp.md +231 -0
- package/docs/message-types.md +261 -0
- package/docs/models.md +94 -478
- package/docs/packages.md +68 -164
- package/docs/prompt-templates.md +31 -68
- package/docs/providers.md +118 -215
- package/docs/quickstart.md +56 -109
- package/docs/rpc-commands.md +860 -0
- package/docs/rpc-extension-ui.md +200 -0
- package/docs/rpc.md +186 -1494
- package/docs/sdk.md +79 -1127
- package/docs/security.md +77 -33
- package/docs/session-format.md +98 -222
- package/docs/sessions.md +36 -113
- package/docs/settings.md +125 -251
- package/docs/shell-aliases.md +85 -5
- package/docs/skills.md +52 -188
- package/docs/slash-commands.md +61 -0
- package/docs/terminal-setup.md +132 -61
- package/docs/termux.md +74 -84
- package/docs/themes.md +91 -252
- package/docs/tmux.md +31 -39
- package/docs/tui.md +74 -891
- package/docs/usage.md +54 -255
- package/docs/virtual-models.md +114 -0
- package/docs/windows.md +57 -7
- package/examples/extensions/antigravity-image-gen.ts +9 -9
- package/examples/extensions/bash-spawn-hook.ts +1 -1
- package/examples/extensions/border-status-editor.ts +1 -1
- package/examples/extensions/built-in-tool-renderer.ts +16 -40
- package/examples/extensions/custom-compaction.ts +1 -16
- package/examples/extensions/custom-provider-anthropic/index.ts +20 -13
- package/examples/extensions/custom-provider-gitlab-duo/index.ts +4 -3
- package/examples/extensions/custom-provider-gitlab-duo/test.ts +5 -5
- package/examples/extensions/debug-provider.ts +90 -0
- package/examples/extensions/doom-overlay/wad-finder.ts +7 -3
- package/examples/extensions/dynamic-resources/dynamic.json +3 -1
- package/examples/extensions/git-checkpoint.ts +2 -2
- package/examples/extensions/handoff.ts +2 -11
- package/examples/extensions/jev-router.ts +113 -0
- package/examples/extensions/minimal-mode.ts +24 -96
- package/examples/extensions/notify.ts +3 -1
- package/examples/extensions/overlay-qa-tests.ts +3 -3
- package/examples/extensions/prompt-customizer.ts +19 -67
- package/examples/extensions/qna.ts +3 -7
- package/examples/extensions/subagent/agents.ts +40 -9
- package/examples/extensions/subagent/index.ts +27 -4
- package/examples/extensions/summarize.ts +7 -18
- package/examples/extensions/titlebar-spinner.ts +1 -1
- package/examples/rpc-client.ts +35 -0
- package/examples/rpc-extension-ui.ts +38 -9
- package/examples/sdk/02-custom-model.ts +1 -2
- package/examples/sdk/06-extensions.ts +1 -1
- package/examples/sdk/09-api-keys-and-oauth.ts +1 -1
- package/examples/sdk/12-full-control.ts +1 -1
- package/examples/sdk/14-codemode-mcp.ts +61 -0
- package/hooks/gsd/draht-quality-gate.js +3 -3
- package/package.json +28 -32
- package/prompts/commands/atomic-commit.md +1 -12
- package/prompts/commands/brainstorm.md +12 -15
- package/prompts/commands/create-verification-skill.md +108 -0
- package/prompts/commands/discuss-phase.md +3 -14
- package/prompts/commands/execute-phase.md +3 -11
- package/prompts/commands/fix.md +41 -18
- package/prompts/commands/grill.md +66 -0
- package/prompts/commands/init-project.md +5 -15
- package/prompts/commands/map-codebase.md +1 -13
- package/prompts/commands/new-project.md +5 -15
- package/prompts/commands/next-milestone.md +1 -13
- package/prompts/commands/orchestrate.md +1 -1
- package/prompts/commands/pause-work.md +1 -13
- package/prompts/commands/plan-phase.md +3 -11
- package/prompts/commands/progress.md +0 -13
- package/prompts/commands/quick.md +3 -11
- package/prompts/commands/resolve-conflicts.md +71 -0
- package/prompts/commands/resume-work.md +0 -13
- package/prompts/commands/review.md +6 -13
- package/prompts/commands/triage.md +159 -0
- package/prompts/commands/verify-work.md +5 -14
- package/prompts/commands/why.md +139 -0
- package/skills/atomic-reasoning/SKILL.md +115 -0
- package/skills/blast-radius/SKILL.md +56 -0
- package/skills/epistemics/SKILL.md +99 -0
- package/skills/explainers/SKILL.md +65 -0
- package/skills/hexagon-animation/SKILL.md +49 -0
- package/skills/hexagon-animation/generate.mjs +81 -0
- package/skills/hexagon-animation/template.html +361 -0
- package/skills/typescript-discipline/SKILL.md +50 -0
- package/skills/typescript-discipline/references/patterns.md +294 -0
- package/skills/unslop/SKILL.md +119 -0
- package/dist/prompts/agents/build.md +0 -86
- package/dist/prompts/agents/plan.md +0 -79
- package/dist/prompts/agents/verify.md +0 -69
- package/dist/utils/clipboard-native.d.ts +0 -11
- package/dist/utils/clipboard-native.d.ts.map +0 -1
- package/dist/utils/clipboard-native.js +0 -20
- package/dist/utils/clipboard-native.js.map +0 -1
- package/dist/utils/pi-user-agent.d.ts +0 -2
- package/dist/utils/pi-user-agent.d.ts.map +0 -1
- package/dist/utils/pi-user-agent.js +0 -5
- package/dist/utils/pi-user-agent.js.map +0 -1
- package/docs/development.md +0 -71
- package/docs/tree.md +0 -231
- package/examples/extensions/kimi-deferred-tools.ts +0 -61
- package/prompts/agents/build.md +0 -86
- package/prompts/agents/plan.md +0 -79
- package/prompts/agents/verify.md +0 -69
|
@@ -0,0 +1,104 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* The `SandboxExecutor` seam (R44-SBX.1).
|
|
3
|
+
*
|
|
4
|
+
* One interface, one status question, one execute path. Platform backends
|
|
5
|
+
* (macOS Seatbelt, Linux Landlock/namespaces) implement it; unsupported
|
|
6
|
+
* platforms get `createUnavailableSandboxExecutor`.
|
|
7
|
+
*
|
|
8
|
+
* ## The status contract
|
|
9
|
+
*
|
|
10
|
+
* `status()` answers `available` **only** with evidence -- for a real backend
|
|
11
|
+
* that means a passing startup self-test (R44-SBX.4). It never throws: a status
|
|
12
|
+
* call that blew up would be indistinguishable at the call site from "we do not
|
|
13
|
+
* know", and "we do not know" must read as `unavailable`.
|
|
14
|
+
*
|
|
15
|
+
* A sandbox that reports `available` while not confining is worse than no
|
|
16
|
+
* sandbox: it converts a known risk into a false guarantee, and every downstream
|
|
17
|
+
* permission decision inherits the lie. So `unavailable` is the only degraded
|
|
18
|
+
* state there is. There is no "available but partially confining", and no path
|
|
19
|
+
* anywhere in this module that runs a command unconfined.
|
|
20
|
+
*
|
|
21
|
+
* ## Why `exec` rejects instead of falling back
|
|
22
|
+
*
|
|
23
|
+
* `exec` on an unavailable executor rejects with `SandboxUnavailableError`. It
|
|
24
|
+
* cannot run the command -- running it would run it unconfined, which is the one
|
|
25
|
+
* thing this module must never do. Callers check `status()` first and, when it
|
|
26
|
+
* is `unavailable`, take the *documented* fallback (Phase 45: the permission
|
|
27
|
+
* gate exactly as it works today, with a one-time notice). That fallback is a
|
|
28
|
+
* decision made in the open by the caller, not a silent slide inside the
|
|
29
|
+
* sandbox.
|
|
30
|
+
*/
|
|
31
|
+
import type { SandboxPolicy } from "./policy.ts";
|
|
32
|
+
export type SandboxStatus = {
|
|
33
|
+
readonly available: true;
|
|
34
|
+
} | {
|
|
35
|
+
readonly available: false;
|
|
36
|
+
readonly reason: string;
|
|
37
|
+
};
|
|
38
|
+
export interface SandboxExecOptions {
|
|
39
|
+
/** Streamed stdout+stderr, matching `BashOperations.exec` (R44-SBX.6). */
|
|
40
|
+
readonly onData: (data: Buffer) => void;
|
|
41
|
+
readonly signal?: AbortSignal;
|
|
42
|
+
/** Seconds, matching the bash tool's units. */
|
|
43
|
+
readonly timeout?: number;
|
|
44
|
+
/**
|
|
45
|
+
* Environment for the sandboxed child. Backends apply env hygiene
|
|
46
|
+
* (R44-SBX.5) on top: the child never receives the full parent environment.
|
|
47
|
+
*/
|
|
48
|
+
readonly env?: NodeJS.ProcessEnv;
|
|
49
|
+
}
|
|
50
|
+
export interface SandboxExecResult {
|
|
51
|
+
/** `null` when the process was killed. */
|
|
52
|
+
readonly exitCode: number | null;
|
|
53
|
+
}
|
|
54
|
+
export interface SandboxExecutor {
|
|
55
|
+
/** Backend identity for diagnostics, e.g. `"seatbelt"`, `"landlock"`, `"unavailable"`. */
|
|
56
|
+
readonly name: string;
|
|
57
|
+
/** Never throws. Backends cache their self-test result behind this. */
|
|
58
|
+
status(): Promise<SandboxStatus>;
|
|
59
|
+
/**
|
|
60
|
+
* Runs `command` confined by `policy`. Rejects with `SandboxUnavailableError`
|
|
61
|
+
* when the backend cannot confine -- never runs the command unconfined.
|
|
62
|
+
*/
|
|
63
|
+
exec(command: string, cwd: string, policy: SandboxPolicy, options: SandboxExecOptions): Promise<SandboxExecResult>;
|
|
64
|
+
}
|
|
65
|
+
/** Thrown by `exec` when confinement cannot be established. Carries the same reason `status()` reports. */
|
|
66
|
+
export declare class SandboxUnavailableError extends Error {
|
|
67
|
+
readonly reason: string;
|
|
68
|
+
constructor(reason: string);
|
|
69
|
+
}
|
|
70
|
+
/** Platforms a backend can exist for. Everything else is `unavailable` by construction. */
|
|
71
|
+
export declare const SUPPORTED_SANDBOX_PLATFORMS: readonly NodeJS.Platform[];
|
|
72
|
+
export interface SandboxBackendFactory {
|
|
73
|
+
readonly platform: NodeJS.Platform;
|
|
74
|
+
create(): SandboxExecutor;
|
|
75
|
+
}
|
|
76
|
+
/**
|
|
77
|
+
* Backends registered for the current build.
|
|
78
|
+
*
|
|
79
|
+
* Registration says a backend *exists* for the platform, nothing more. Both
|
|
80
|
+
* entries construct an executor whose `status()` still has to pass the
|
|
81
|
+
* R44-SBX.4 self-test before it will run anything, so appearing in this list is
|
|
82
|
+
* never itself a claim of confinement -- which is what makes it safe to register
|
|
83
|
+
* the Linux backend from a machine that cannot run it.
|
|
84
|
+
*
|
|
85
|
+
* `create()` is a thunk, so the platform module is only instantiated for the
|
|
86
|
+
* platform actually in use and a factory that throws is caught below.
|
|
87
|
+
*/
|
|
88
|
+
export declare const BUILTIN_SANDBOX_BACKENDS: readonly SandboxBackendFactory[];
|
|
89
|
+
/** An executor that is permanently unavailable for a stated reason. */
|
|
90
|
+
export declare function createUnavailableSandboxExecutor(reason: string, name?: string): SandboxExecutor;
|
|
91
|
+
export interface CreateSandboxExecutorOptions {
|
|
92
|
+
/** Defaults to `process.platform`. */
|
|
93
|
+
platform?: NodeJS.Platform;
|
|
94
|
+
/** Defaults to `BUILTIN_SANDBOX_BACKENDS`. */
|
|
95
|
+
backends?: readonly SandboxBackendFactory[];
|
|
96
|
+
}
|
|
97
|
+
/**
|
|
98
|
+
* Picks the backend for `platform`, or an unavailable executor with a reason.
|
|
99
|
+
*
|
|
100
|
+
* Never throws -- a backend factory that throws while constructing is itself a
|
|
101
|
+
* reason to report `unavailable`.
|
|
102
|
+
*/
|
|
103
|
+
export declare function createSandboxExecutor(options?: CreateSandboxExecutorOptions): SandboxExecutor;
|
|
104
|
+
//# sourceMappingURL=executor.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"executor.d.ts","sourceRoot":"","sources":["../../../src/core/sandbox/executor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAGH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAGjD,MAAM,MAAM,aAAa,GAAG;IAAE,QAAQ,CAAC,SAAS,EAAE,IAAI,CAAA;CAAE,GAAG;IAAE,QAAQ,CAAC,SAAS,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAElH,MAAM,WAAW,kBAAkB;IAClC,0EAA0E;IAC1E,QAAQ,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACxC,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;IAC9B,+CAA+C;IAC/C,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B;;;OAGG;IACH,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;CACjC;AAED,MAAM,WAAW,iBAAiB;IACjC,0CAA0C;IAC1C,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;CACjC;AAED,MAAM,WAAW,eAAe;IAC/B,0FAA0F;IAC1F,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,uEAAuE;IACvE,MAAM,IAAI,OAAO,CAAC,aAAa,CAAC,CAAC;IACjC;;;OAGG;IACH,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,EAAE,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;CACnH;AAED,2GAA2G;AAC3G,qBAAa,uBAAwB,SAAQ,KAAK;IACjD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,YAAY,MAAM,EAAE,MAAM,EAIzB;CACD;AAED,2FAA2F;AAC3F,eAAO,MAAM,2BAA2B,EAAE,SAAS,MAAM,CAAC,QAAQ,EAAwB,CAAC;AAE3F,MAAM,WAAW,qBAAqB;IACrC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,QAAQ,CAAC;IACnC,MAAM,IAAI,eAAe,CAAC;CAC1B;AAED;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,wBAAwB,EAAE,SAAS,qBAAqB,EAGpE,CAAC;AAEF,uEAAuE;AACvE,wBAAgB,gCAAgC,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,SAAgB,GAAG,eAAe,CAQtG;AAED,MAAM,WAAW,4BAA4B;IAC5C,sCAAsC;IACtC,QAAQ,CAAC,EAAE,MAAM,CAAC,QAAQ,CAAC;IAC3B,8CAA8C;IAC9C,QAAQ,CAAC,EAAE,SAAS,qBAAqB,EAAE,CAAC;CAC5C;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,GAAE,4BAAiC,GAAG,eAAe,CA0BjG"}
|
|
@@ -0,0 +1,93 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* The `SandboxExecutor` seam (R44-SBX.1).
|
|
3
|
+
*
|
|
4
|
+
* One interface, one status question, one execute path. Platform backends
|
|
5
|
+
* (macOS Seatbelt, Linux Landlock/namespaces) implement it; unsupported
|
|
6
|
+
* platforms get `createUnavailableSandboxExecutor`.
|
|
7
|
+
*
|
|
8
|
+
* ## The status contract
|
|
9
|
+
*
|
|
10
|
+
* `status()` answers `available` **only** with evidence -- for a real backend
|
|
11
|
+
* that means a passing startup self-test (R44-SBX.4). It never throws: a status
|
|
12
|
+
* call that blew up would be indistinguishable at the call site from "we do not
|
|
13
|
+
* know", and "we do not know" must read as `unavailable`.
|
|
14
|
+
*
|
|
15
|
+
* A sandbox that reports `available` while not confining is worse than no
|
|
16
|
+
* sandbox: it converts a known risk into a false guarantee, and every downstream
|
|
17
|
+
* permission decision inherits the lie. So `unavailable` is the only degraded
|
|
18
|
+
* state there is. There is no "available but partially confining", and no path
|
|
19
|
+
* anywhere in this module that runs a command unconfined.
|
|
20
|
+
*
|
|
21
|
+
* ## Why `exec` rejects instead of falling back
|
|
22
|
+
*
|
|
23
|
+
* `exec` on an unavailable executor rejects with `SandboxUnavailableError`. It
|
|
24
|
+
* cannot run the command -- running it would run it unconfined, which is the one
|
|
25
|
+
* thing this module must never do. Callers check `status()` first and, when it
|
|
26
|
+
* is `unavailable`, take the *documented* fallback (Phase 45: the permission
|
|
27
|
+
* gate exactly as it works today, with a one-time notice). That fallback is a
|
|
28
|
+
* decision made in the open by the caller, not a silent slide inside the
|
|
29
|
+
* sandbox.
|
|
30
|
+
*/
|
|
31
|
+
import { createLinuxSandboxExecutor } from "./linux.js";
|
|
32
|
+
import { createSeatbeltSandboxExecutor } from "./seatbelt.js";
|
|
33
|
+
/** Thrown by `exec` when confinement cannot be established. Carries the same reason `status()` reports. */
|
|
34
|
+
export class SandboxUnavailableError extends Error {
|
|
35
|
+
reason;
|
|
36
|
+
constructor(reason) {
|
|
37
|
+
super(`sandbox unavailable: ${reason}`);
|
|
38
|
+
this.name = "SandboxUnavailableError";
|
|
39
|
+
this.reason = reason;
|
|
40
|
+
}
|
|
41
|
+
}
|
|
42
|
+
/** Platforms a backend can exist for. Everything else is `unavailable` by construction. */
|
|
43
|
+
export const SUPPORTED_SANDBOX_PLATFORMS = ["darwin", "linux"];
|
|
44
|
+
/**
|
|
45
|
+
* Backends registered for the current build.
|
|
46
|
+
*
|
|
47
|
+
* Registration says a backend *exists* for the platform, nothing more. Both
|
|
48
|
+
* entries construct an executor whose `status()` still has to pass the
|
|
49
|
+
* R44-SBX.4 self-test before it will run anything, so appearing in this list is
|
|
50
|
+
* never itself a claim of confinement -- which is what makes it safe to register
|
|
51
|
+
* the Linux backend from a machine that cannot run it.
|
|
52
|
+
*
|
|
53
|
+
* `create()` is a thunk, so the platform module is only instantiated for the
|
|
54
|
+
* platform actually in use and a factory that throws is caught below.
|
|
55
|
+
*/
|
|
56
|
+
export const BUILTIN_SANDBOX_BACKENDS = [
|
|
57
|
+
{ platform: "darwin", create: () => createSeatbeltSandboxExecutor() },
|
|
58
|
+
{ platform: "linux", create: () => createLinuxSandboxExecutor() },
|
|
59
|
+
];
|
|
60
|
+
/** An executor that is permanently unavailable for a stated reason. */
|
|
61
|
+
export function createUnavailableSandboxExecutor(reason, name = "unavailable") {
|
|
62
|
+
return {
|
|
63
|
+
name,
|
|
64
|
+
status: async () => ({ available: false, reason }),
|
|
65
|
+
exec: async () => {
|
|
66
|
+
throw new SandboxUnavailableError(reason);
|
|
67
|
+
},
|
|
68
|
+
};
|
|
69
|
+
}
|
|
70
|
+
/**
|
|
71
|
+
* Picks the backend for `platform`, or an unavailable executor with a reason.
|
|
72
|
+
*
|
|
73
|
+
* Never throws -- a backend factory that throws while constructing is itself a
|
|
74
|
+
* reason to report `unavailable`.
|
|
75
|
+
*/
|
|
76
|
+
export function createSandboxExecutor(options = {}) {
|
|
77
|
+
const platform = options.platform ?? process.platform;
|
|
78
|
+
const backends = options.backends ?? BUILTIN_SANDBOX_BACKENDS;
|
|
79
|
+
if (!SUPPORTED_SANDBOX_PLATFORMS.includes(platform)) {
|
|
80
|
+
return createUnavailableSandboxExecutor(`no sandbox backend exists for platform ${JSON.stringify(platform)} (supported: ${SUPPORTED_SANDBOX_PLATFORMS.join(", ")})`);
|
|
81
|
+
}
|
|
82
|
+
const factory = backends.find((backend) => backend.platform === platform);
|
|
83
|
+
if (!factory) {
|
|
84
|
+
return createUnavailableSandboxExecutor(`no sandbox backend is registered for platform ${JSON.stringify(platform)} in this build`);
|
|
85
|
+
}
|
|
86
|
+
try {
|
|
87
|
+
return factory.create();
|
|
88
|
+
}
|
|
89
|
+
catch (err) {
|
|
90
|
+
return createUnavailableSandboxExecutor(`sandbox backend for platform ${JSON.stringify(platform)} failed to initialize: ${err instanceof Error ? err.message : String(err)}`);
|
|
91
|
+
}
|
|
92
|
+
}
|
|
93
|
+
//# sourceMappingURL=executor.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"executor.js","sourceRoot":"","sources":["../../../src/core/sandbox/executor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAEH,OAAO,EAAE,0BAA0B,EAAE,MAAM,YAAY,CAAC;AAExD,OAAO,EAAE,6BAA6B,EAAE,MAAM,eAAe,CAAC;AAkC9D,2GAA2G;AAC3G,MAAM,OAAO,uBAAwB,SAAQ,KAAK;IACxC,MAAM,CAAS;IACxB,YAAY,MAAc;QACzB,KAAK,CAAC,wBAAwB,MAAM,EAAE,CAAC,CAAC;QACxC,IAAI,CAAC,IAAI,GAAG,yBAAyB,CAAC;QACtC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACtB,CAAC;CACD;AAED,2FAA2F;AAC3F,MAAM,CAAC,MAAM,2BAA2B,GAA+B,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;AAO3F;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAqC;IACzE,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,6BAA6B,EAAE,EAAE;IACrE,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,0BAA0B,EAAE,EAAE;CACjE,CAAC;AAEF,uEAAuE;AACvE,MAAM,UAAU,gCAAgC,CAAC,MAAc,EAAE,IAAI,GAAG,aAAa;IACpF,OAAO;QACN,IAAI;QACJ,MAAM,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;QAClD,IAAI,EAAE,KAAK,IAAI,EAAE;YAChB,MAAM,IAAI,uBAAuB,CAAC,MAAM,CAAC,CAAC;QAC3C,CAAC;KACD,CAAC;AACH,CAAC;AASD;;;;;GAKG;AACH,MAAM,UAAU,qBAAqB,CAAC,OAAO,GAAiC,EAAE;IAC/E,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,OAAO,CAAC,QAAQ,CAAC;IACtD,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,wBAAwB,CAAC;IAE9D,IAAI,CAAC,2BAA2B,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;QACrD,OAAO,gCAAgC,CACtC,0CAA0C,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,gBAAgB,2BAA2B,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAC3H,CAAC;IACH,CAAC;IAED,MAAM,OAAO,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC;IAC1E,IAAI,CAAC,OAAO,EAAE,CAAC;QACd,OAAO,gCAAgC,CACtC,iDAAiD,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,gBAAgB,CACzF,CAAC;IACH,CAAC;IAED,IAAI,CAAC;QACJ,OAAO,OAAO,CAAC,MAAM,EAAE,CAAC;IACzB,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACd,OAAO,gCAAgC,CACtC,gCAAgC,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,0BACvD,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAChD,EAAE,CACF,CAAC;IACH,CAAC;AACF,CAAC","sourcesContent":["/**\n * The `SandboxExecutor` seam (R44-SBX.1).\n *\n * One interface, one status question, one execute path. Platform backends\n * (macOS Seatbelt, Linux Landlock/namespaces) implement it; unsupported\n * platforms get `createUnavailableSandboxExecutor`.\n *\n * ## The status contract\n *\n * `status()` answers `available` **only** with evidence -- for a real backend\n * that means a passing startup self-test (R44-SBX.4). It never throws: a status\n * call that blew up would be indistinguishable at the call site from \"we do not\n * know\", and \"we do not know\" must read as `unavailable`.\n *\n * A sandbox that reports `available` while not confining is worse than no\n * sandbox: it converts a known risk into a false guarantee, and every downstream\n * permission decision inherits the lie. So `unavailable` is the only degraded\n * state there is. There is no \"available but partially confining\", and no path\n * anywhere in this module that runs a command unconfined.\n *\n * ## Why `exec` rejects instead of falling back\n *\n * `exec` on an unavailable executor rejects with `SandboxUnavailableError`. It\n * cannot run the command -- running it would run it unconfined, which is the one\n * thing this module must never do. Callers check `status()` first and, when it\n * is `unavailable`, take the *documented* fallback (Phase 45: the permission\n * gate exactly as it works today, with a one-time notice). That fallback is a\n * decision made in the open by the caller, not a silent slide inside the\n * sandbox.\n */\n\nimport { createLinuxSandboxExecutor } from \"./linux.ts\";\nimport type { SandboxPolicy } from \"./policy.ts\";\nimport { createSeatbeltSandboxExecutor } from \"./seatbelt.ts\";\n\nexport type SandboxStatus = { readonly available: true } | { readonly available: false; readonly reason: string };\n\nexport interface SandboxExecOptions {\n\t/** Streamed stdout+stderr, matching `BashOperations.exec` (R44-SBX.6). */\n\treadonly onData: (data: Buffer) => void;\n\treadonly signal?: AbortSignal;\n\t/** Seconds, matching the bash tool's units. */\n\treadonly timeout?: number;\n\t/**\n\t * Environment for the sandboxed child. Backends apply env hygiene\n\t * (R44-SBX.5) on top: the child never receives the full parent environment.\n\t */\n\treadonly env?: NodeJS.ProcessEnv;\n}\n\nexport interface SandboxExecResult {\n\t/** `null` when the process was killed. */\n\treadonly exitCode: number | null;\n}\n\nexport interface SandboxExecutor {\n\t/** Backend identity for diagnostics, e.g. `\"seatbelt\"`, `\"landlock\"`, `\"unavailable\"`. */\n\treadonly name: string;\n\t/** Never throws. Backends cache their self-test result behind this. */\n\tstatus(): Promise<SandboxStatus>;\n\t/**\n\t * Runs `command` confined by `policy`. Rejects with `SandboxUnavailableError`\n\t * when the backend cannot confine -- never runs the command unconfined.\n\t */\n\texec(command: string, cwd: string, policy: SandboxPolicy, options: SandboxExecOptions): Promise<SandboxExecResult>;\n}\n\n/** Thrown by `exec` when confinement cannot be established. Carries the same reason `status()` reports. */\nexport class SandboxUnavailableError extends Error {\n\treadonly reason: string;\n\tconstructor(reason: string) {\n\t\tsuper(`sandbox unavailable: ${reason}`);\n\t\tthis.name = \"SandboxUnavailableError\";\n\t\tthis.reason = reason;\n\t}\n}\n\n/** Platforms a backend can exist for. Everything else is `unavailable` by construction. */\nexport const SUPPORTED_SANDBOX_PLATFORMS: readonly NodeJS.Platform[] = [\"darwin\", \"linux\"];\n\nexport interface SandboxBackendFactory {\n\treadonly platform: NodeJS.Platform;\n\tcreate(): SandboxExecutor;\n}\n\n/**\n * Backends registered for the current build.\n *\n * Registration says a backend *exists* for the platform, nothing more. Both\n * entries construct an executor whose `status()` still has to pass the\n * R44-SBX.4 self-test before it will run anything, so appearing in this list is\n * never itself a claim of confinement -- which is what makes it safe to register\n * the Linux backend from a machine that cannot run it.\n *\n * `create()` is a thunk, so the platform module is only instantiated for the\n * platform actually in use and a factory that throws is caught below.\n */\nexport const BUILTIN_SANDBOX_BACKENDS: readonly SandboxBackendFactory[] = [\n\t{ platform: \"darwin\", create: () => createSeatbeltSandboxExecutor() },\n\t{ platform: \"linux\", create: () => createLinuxSandboxExecutor() },\n];\n\n/** An executor that is permanently unavailable for a stated reason. */\nexport function createUnavailableSandboxExecutor(reason: string, name = \"unavailable\"): SandboxExecutor {\n\treturn {\n\t\tname,\n\t\tstatus: async () => ({ available: false, reason }),\n\t\texec: async () => {\n\t\t\tthrow new SandboxUnavailableError(reason);\n\t\t},\n\t};\n}\n\nexport interface CreateSandboxExecutorOptions {\n\t/** Defaults to `process.platform`. */\n\tplatform?: NodeJS.Platform;\n\t/** Defaults to `BUILTIN_SANDBOX_BACKENDS`. */\n\tbackends?: readonly SandboxBackendFactory[];\n}\n\n/**\n * Picks the backend for `platform`, or an unavailable executor with a reason.\n *\n * Never throws -- a backend factory that throws while constructing is itself a\n * reason to report `unavailable`.\n */\nexport function createSandboxExecutor(options: CreateSandboxExecutorOptions = {}): SandboxExecutor {\n\tconst platform = options.platform ?? process.platform;\n\tconst backends = options.backends ?? BUILTIN_SANDBOX_BACKENDS;\n\n\tif (!SUPPORTED_SANDBOX_PLATFORMS.includes(platform)) {\n\t\treturn createUnavailableSandboxExecutor(\n\t\t\t`no sandbox backend exists for platform ${JSON.stringify(platform)} (supported: ${SUPPORTED_SANDBOX_PLATFORMS.join(\", \")})`,\n\t\t);\n\t}\n\n\tconst factory = backends.find((backend) => backend.platform === platform);\n\tif (!factory) {\n\t\treturn createUnavailableSandboxExecutor(\n\t\t\t`no sandbox backend is registered for platform ${JSON.stringify(platform)} in this build`,\n\t\t);\n\t}\n\n\ttry {\n\t\treturn factory.create();\n\t} catch (err) {\n\t\treturn createUnavailableSandboxExecutor(\n\t\t\t`sandbox backend for platform ${JSON.stringify(platform)} failed to initialize: ${\n\t\t\t\terr instanceof Error ? err.message : String(err)\n\t\t\t}`,\n\t\t);\n\t}\n}\n"]}
|
|
@@ -0,0 +1,36 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* OS-level sandbox for the bash tool (Phase 44, R44-SBX.1 .. R44-SBX.3).
|
|
3
|
+
*
|
|
4
|
+
* - `policy.ts` -- `SandboxPolicy` v1: the declarative write allowlist, read
|
|
5
|
+
* mode, network toggle and privilege-escalation invariant.
|
|
6
|
+
* - `real-path.ts` -- real-path resolution applied to every policy path before
|
|
7
|
+
* any profile is generated, so no symlink or `..` hop can widen the allowlist.
|
|
8
|
+
* - `executor.ts` -- the `SandboxExecutor` seam, backend registry and the
|
|
9
|
+
* `unavailable` posture.
|
|
10
|
+
* - `seatbelt-profile.ts` / `seatbelt.ts` -- the macOS backend. The profile is
|
|
11
|
+
* an allow-list (`(deny default)` plus enumerated capabilities) handed to
|
|
12
|
+
* `sandbox-exec` inline, so it never exists as a file the sandbox could edit.
|
|
13
|
+
* Exercised for real against `/usr/bin/sandbox-exec` by
|
|
14
|
+
* `test/sandbox-backend.test.ts`, including the escape vectors it closes.
|
|
15
|
+
* - `linux.ts` -- the Linux backend (Landlock helper / bwrap / unshare).
|
|
16
|
+
* **Source-only evidence: never executed.** See its module doc.
|
|
17
|
+
* - `self-test.ts` -- R44-SBX.4. The only thing that may report `available`.
|
|
18
|
+
* - `env.ts` -- R44-SBX.5. The child's environment is constructed, not inherited.
|
|
19
|
+
* - `spawn.ts` -- the shared wrapped-child process plumbing.
|
|
20
|
+
*
|
|
21
|
+
* The `BashOperations` wrapper (R44-SBX.6) lives in `bash-operations.ts` and is
|
|
22
|
+
* deliberately **not** re-exported here: it is the one file in this directory
|
|
23
|
+
* that imports from `../tools/`, and keeping it out of the barrel lets anything
|
|
24
|
+
* that only wants the policy model import this without dragging the tool layer
|
|
25
|
+
* along -- and keeps a future `tools/bash.ts` -> sandbox import cycle-free.
|
|
26
|
+
* Import it directly: `from "../sandbox/bash-operations.ts"`.
|
|
27
|
+
*/
|
|
28
|
+
export { type BuildSandboxEnvOptions, buildSandboxEnv, SANDBOX_ENV_ALLOWLIST, SANDBOX_ENV_MARKER, } from "./env.ts";
|
|
29
|
+
export { BUILTIN_SANDBOX_BACKENDS, type CreateSandboxExecutorOptions, createSandboxExecutor, createUnavailableSandboxExecutor, type SandboxBackendFactory, type SandboxExecOptions, type SandboxExecResult, type SandboxExecutor, type SandboxStatus, SandboxUnavailableError, SUPPORTED_SANDBOX_PLATFORMS, } from "./executor.ts";
|
|
30
|
+
export { buildLinuxSandboxCommand, createLinuxSandboxExecutor, detectLinuxSandboxMechanism, type LinuxSandboxMechanism, type LinuxSandboxOptions, MIN_LANDLOCK_KERNEL, supportsLandlock, } from "./linux.ts";
|
|
31
|
+
export { excludedWriteRootReason, isPathWritable, type RejectedWritePath, resolveSandboxPolicy, SANDBOX_POLICY_VERSION, type SandboxNetworkMode, type SandboxPolicy, SandboxPolicyError, type SandboxPolicyInput, type SandboxPolicyResolution, } from "./policy.ts";
|
|
32
|
+
export { isContainedIn, type RealPathResolution, type ResolveRealPathOptions, resolveRealPath } from "./real-path.ts";
|
|
33
|
+
export { buildSandboxExecArgs, createSeatbeltSandboxExecutor, DEFAULT_SANDBOX_EXEC_BIN, MAX_INLINE_PROFILE_BYTES, type SeatbeltSandboxOptions, } from "./seatbelt.ts";
|
|
34
|
+
export { buildSeatbeltProfile, quoteSbplString, SandboxProfileError } from "./seatbelt-profile.ts";
|
|
35
|
+
export { runSandboxSelfTest, type SandboxSelfTestOptions, type SandboxSelfTestRunner } from "./self-test.ts";
|
|
36
|
+
//# sourceMappingURL=index.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/sandbox/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,OAAO,EACN,KAAK,sBAAsB,EAC3B,eAAe,EACf,qBAAqB,EACrB,kBAAkB,GAClB,MAAM,UAAU,CAAC;AAClB,OAAO,EACN,wBAAwB,EACxB,KAAK,4BAA4B,EACjC,qBAAqB,EACrB,gCAAgC,EAChC,KAAK,qBAAqB,EAC1B,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,EACtB,KAAK,eAAe,EACpB,KAAK,aAAa,EAClB,uBAAuB,EACvB,2BAA2B,GAC3B,MAAM,eAAe,CAAC;AACvB,OAAO,EACN,wBAAwB,EACxB,0BAA0B,EAC1B,2BAA2B,EAC3B,KAAK,qBAAqB,EAC1B,KAAK,mBAAmB,EACxB,mBAAmB,EACnB,gBAAgB,GAChB,MAAM,YAAY,CAAC;AACpB,OAAO,EACN,uBAAuB,EACvB,cAAc,EACd,KAAK,iBAAiB,EACtB,oBAAoB,EACpB,sBAAsB,EACtB,KAAK,kBAAkB,EACvB,KAAK,aAAa,EAClB,kBAAkB,EAClB,KAAK,kBAAkB,EACvB,KAAK,uBAAuB,GAC5B,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,aAAa,EAAE,KAAK,kBAAkB,EAAE,KAAK,sBAAsB,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACtH,OAAO,EACN,oBAAoB,EACpB,6BAA6B,EAC7B,wBAAwB,EACxB,wBAAwB,EACxB,KAAK,sBAAsB,GAC3B,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,oBAAoB,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AACnG,OAAO,EAAE,kBAAkB,EAAE,KAAK,sBAAsB,EAAE,KAAK,qBAAqB,EAAE,MAAM,gBAAgB,CAAC"}
|
|
@@ -0,0 +1,36 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* OS-level sandbox for the bash tool (Phase 44, R44-SBX.1 .. R44-SBX.3).
|
|
3
|
+
*
|
|
4
|
+
* - `policy.ts` -- `SandboxPolicy` v1: the declarative write allowlist, read
|
|
5
|
+
* mode, network toggle and privilege-escalation invariant.
|
|
6
|
+
* - `real-path.ts` -- real-path resolution applied to every policy path before
|
|
7
|
+
* any profile is generated, so no symlink or `..` hop can widen the allowlist.
|
|
8
|
+
* - `executor.ts` -- the `SandboxExecutor` seam, backend registry and the
|
|
9
|
+
* `unavailable` posture.
|
|
10
|
+
* - `seatbelt-profile.ts` / `seatbelt.ts` -- the macOS backend. The profile is
|
|
11
|
+
* an allow-list (`(deny default)` plus enumerated capabilities) handed to
|
|
12
|
+
* `sandbox-exec` inline, so it never exists as a file the sandbox could edit.
|
|
13
|
+
* Exercised for real against `/usr/bin/sandbox-exec` by
|
|
14
|
+
* `test/sandbox-backend.test.ts`, including the escape vectors it closes.
|
|
15
|
+
* - `linux.ts` -- the Linux backend (Landlock helper / bwrap / unshare).
|
|
16
|
+
* **Source-only evidence: never executed.** See its module doc.
|
|
17
|
+
* - `self-test.ts` -- R44-SBX.4. The only thing that may report `available`.
|
|
18
|
+
* - `env.ts` -- R44-SBX.5. The child's environment is constructed, not inherited.
|
|
19
|
+
* - `spawn.ts` -- the shared wrapped-child process plumbing.
|
|
20
|
+
*
|
|
21
|
+
* The `BashOperations` wrapper (R44-SBX.6) lives in `bash-operations.ts` and is
|
|
22
|
+
* deliberately **not** re-exported here: it is the one file in this directory
|
|
23
|
+
* that imports from `../tools/`, and keeping it out of the barrel lets anything
|
|
24
|
+
* that only wants the policy model import this without dragging the tool layer
|
|
25
|
+
* along -- and keeps a future `tools/bash.ts` -> sandbox import cycle-free.
|
|
26
|
+
* Import it directly: `from "../sandbox/bash-operations.ts"`.
|
|
27
|
+
*/
|
|
28
|
+
export { buildSandboxEnv, SANDBOX_ENV_ALLOWLIST, SANDBOX_ENV_MARKER, } from "./env.js";
|
|
29
|
+
export { BUILTIN_SANDBOX_BACKENDS, createSandboxExecutor, createUnavailableSandboxExecutor, SandboxUnavailableError, SUPPORTED_SANDBOX_PLATFORMS, } from "./executor.js";
|
|
30
|
+
export { buildLinuxSandboxCommand, createLinuxSandboxExecutor, detectLinuxSandboxMechanism, MIN_LANDLOCK_KERNEL, supportsLandlock, } from "./linux.js";
|
|
31
|
+
export { excludedWriteRootReason, isPathWritable, resolveSandboxPolicy, SANDBOX_POLICY_VERSION, SandboxPolicyError, } from "./policy.js";
|
|
32
|
+
export { isContainedIn, resolveRealPath } from "./real-path.js";
|
|
33
|
+
export { buildSandboxExecArgs, createSeatbeltSandboxExecutor, DEFAULT_SANDBOX_EXEC_BIN, MAX_INLINE_PROFILE_BYTES, } from "./seatbelt.js";
|
|
34
|
+
export { buildSeatbeltProfile, quoteSbplString, SandboxProfileError } from "./seatbelt-profile.js";
|
|
35
|
+
export { runSandboxSelfTest } from "./self-test.js";
|
|
36
|
+
//# sourceMappingURL=index.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/sandbox/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,OAAO,EAEN,eAAe,EACf,qBAAqB,EACrB,kBAAkB,GAClB,MAAM,UAAU,CAAC;AAClB,OAAO,EACN,wBAAwB,EAExB,qBAAqB,EACrB,gCAAgC,EAMhC,uBAAuB,EACvB,2BAA2B,GAC3B,MAAM,eAAe,CAAC;AACvB,OAAO,EACN,wBAAwB,EACxB,0BAA0B,EAC1B,2BAA2B,EAG3B,mBAAmB,EACnB,gBAAgB,GAChB,MAAM,YAAY,CAAC;AACpB,OAAO,EACN,uBAAuB,EACvB,cAAc,EAEd,oBAAoB,EACpB,sBAAsB,EAGtB,kBAAkB,GAGlB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,aAAa,EAAwD,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACtH,OAAO,EACN,oBAAoB,EACpB,6BAA6B,EAC7B,wBAAwB,EACxB,wBAAwB,GAExB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,oBAAoB,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AACnG,OAAO,EAAE,kBAAkB,EAA2D,MAAM,gBAAgB,CAAC","sourcesContent":["/**\n * OS-level sandbox for the bash tool (Phase 44, R44-SBX.1 .. R44-SBX.3).\n *\n * - `policy.ts` -- `SandboxPolicy` v1: the declarative write allowlist, read\n * mode, network toggle and privilege-escalation invariant.\n * - `real-path.ts` -- real-path resolution applied to every policy path before\n * any profile is generated, so no symlink or `..` hop can widen the allowlist.\n * - `executor.ts` -- the `SandboxExecutor` seam, backend registry and the\n * `unavailable` posture.\n * - `seatbelt-profile.ts` / `seatbelt.ts` -- the macOS backend. The profile is\n * an allow-list (`(deny default)` plus enumerated capabilities) handed to\n * `sandbox-exec` inline, so it never exists as a file the sandbox could edit.\n * Exercised for real against `/usr/bin/sandbox-exec` by\n * `test/sandbox-backend.test.ts`, including the escape vectors it closes.\n * - `linux.ts` -- the Linux backend (Landlock helper / bwrap / unshare).\n * **Source-only evidence: never executed.** See its module doc.\n * - `self-test.ts` -- R44-SBX.4. The only thing that may report `available`.\n * - `env.ts` -- R44-SBX.5. The child's environment is constructed, not inherited.\n * - `spawn.ts` -- the shared wrapped-child process plumbing.\n *\n * The `BashOperations` wrapper (R44-SBX.6) lives in `bash-operations.ts` and is\n * deliberately **not** re-exported here: it is the one file in this directory\n * that imports from `../tools/`, and keeping it out of the barrel lets anything\n * that only wants the policy model import this without dragging the tool layer\n * along -- and keeps a future `tools/bash.ts` -> sandbox import cycle-free.\n * Import it directly: `from \"../sandbox/bash-operations.ts\"`.\n */\n\nexport {\n\ttype BuildSandboxEnvOptions,\n\tbuildSandboxEnv,\n\tSANDBOX_ENV_ALLOWLIST,\n\tSANDBOX_ENV_MARKER,\n} from \"./env.ts\";\nexport {\n\tBUILTIN_SANDBOX_BACKENDS,\n\ttype CreateSandboxExecutorOptions,\n\tcreateSandboxExecutor,\n\tcreateUnavailableSandboxExecutor,\n\ttype SandboxBackendFactory,\n\ttype SandboxExecOptions,\n\ttype SandboxExecResult,\n\ttype SandboxExecutor,\n\ttype SandboxStatus,\n\tSandboxUnavailableError,\n\tSUPPORTED_SANDBOX_PLATFORMS,\n} from \"./executor.ts\";\nexport {\n\tbuildLinuxSandboxCommand,\n\tcreateLinuxSandboxExecutor,\n\tdetectLinuxSandboxMechanism,\n\ttype LinuxSandboxMechanism,\n\ttype LinuxSandboxOptions,\n\tMIN_LANDLOCK_KERNEL,\n\tsupportsLandlock,\n} from \"./linux.ts\";\nexport {\n\texcludedWriteRootReason,\n\tisPathWritable,\n\ttype RejectedWritePath,\n\tresolveSandboxPolicy,\n\tSANDBOX_POLICY_VERSION,\n\ttype SandboxNetworkMode,\n\ttype SandboxPolicy,\n\tSandboxPolicyError,\n\ttype SandboxPolicyInput,\n\ttype SandboxPolicyResolution,\n} from \"./policy.ts\";\nexport { isContainedIn, type RealPathResolution, type ResolveRealPathOptions, resolveRealPath } from \"./real-path.ts\";\nexport {\n\tbuildSandboxExecArgs,\n\tcreateSeatbeltSandboxExecutor,\n\tDEFAULT_SANDBOX_EXEC_BIN,\n\tMAX_INLINE_PROFILE_BYTES,\n\ttype SeatbeltSandboxOptions,\n} from \"./seatbelt.ts\";\nexport { buildSeatbeltProfile, quoteSbplString, SandboxProfileError } from \"./seatbelt-profile.ts\";\nexport { runSandboxSelfTest, type SandboxSelfTestOptions, type SandboxSelfTestRunner } from \"./self-test.ts\";\n"]}
|
|
@@ -0,0 +1,121 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Linux backend (R44-SBX.1) -- Landlock helper, bubblewrap, or `unshare`.
|
|
3
|
+
*
|
|
4
|
+
* ## Evidence class: SOURCE-ONLY. Nothing here has been executed.
|
|
5
|
+
*
|
|
6
|
+
* This module was written and reviewed on macOS (darwin). No line of it has ever
|
|
7
|
+
* run on Linux, and the tests that accompany it assert on *constructed argument
|
|
8
|
+
* vectors*, never on confinement -- constructing the right argv is not evidence
|
|
9
|
+
* that the argv confines anything. Treat every claim below as a design intent
|
|
10
|
+
* awaiting the Linux CI matrix that R46-SBH.2 owns, which exists precisely
|
|
11
|
+
* because Phase 28 shipped an unverified Linux path from this same machine.
|
|
12
|
+
*
|
|
13
|
+
* The reason that posture is *safe* rather than merely honest: this backend is
|
|
14
|
+
* gated by the same R44-SBX.4 self-test as the macOS one, and the self-test
|
|
15
|
+
* confirms confinement from outside the sandbox. If any mechanism below fails to
|
|
16
|
+
* confine on a real kernel, `status()` answers `unavailable` and no command runs
|
|
17
|
+
* through it. Unverified code cannot promote itself to `available`; only a
|
|
18
|
+
* passing probe on the actual host can.
|
|
19
|
+
*
|
|
20
|
+
* ## Landlock, and why it is a seam rather than an implementation
|
|
21
|
+
*
|
|
22
|
+
* R44-SBX.1 names Landlock (kernel >= 5.13) as the preferred mechanism, and it
|
|
23
|
+
* is the right one: per-process filesystem restriction, no root, no setuid
|
|
24
|
+
* helper, no namespaces. But applying it means calling `landlock_create_ruleset(2)`,
|
|
25
|
+
* `landlock_add_rule(2)` and `prctl(PR_SET_NO_NEW_PRIVS)` *between* fork and exec,
|
|
26
|
+
* and Node exposes none of those. Codex solves this with a native Rust helper it
|
|
27
|
+
* ships; Phase 44 builds no native artefact, and adding one is not something
|
|
28
|
+
* that can be validated from here.
|
|
29
|
+
*
|
|
30
|
+
* So Landlock is wired as an explicit, opt-in helper contract rather than
|
|
31
|
+
* guessed at against a third-party CLI whose flags cannot be checked from this
|
|
32
|
+
* machine:
|
|
33
|
+
*
|
|
34
|
+
* <helper> --ro <path> --rw <path> [--rw <path> ...] [--no-network] -- <argv...>
|
|
35
|
+
*
|
|
36
|
+
* configured via `landlockHelperBin` or `DRAHT_SANDBOX_LANDLOCK_HELPER`. If no
|
|
37
|
+
* helper is configured the mechanism is simply not selected. If one is
|
|
38
|
+
* configured but does not honour the contract, the self-test fails and the
|
|
39
|
+
* backend reports `unavailable` -- which is why shipping an unproven contract
|
|
40
|
+
* here is not a security risk.
|
|
41
|
+
*
|
|
42
|
+
* ## Namespace mechanisms (the fallback R44-SBX.1 asks for)
|
|
43
|
+
*
|
|
44
|
+
* - **bubblewrap** (`bwrap`), preferred: `--ro-bind / /` gives read allow-all,
|
|
45
|
+
* then one `--bind` per policy write path makes exactly those subtrees
|
|
46
|
+
* writable. That is the R44-SBX.2 policy shape expressed directly. bwrap sets
|
|
47
|
+
* `PR_SET_NO_NEW_PRIVS` by default, which is what makes `sudo` and every other
|
|
48
|
+
* setuid binary inert -- the privilege-escalation invariant. `--unshare-net`
|
|
49
|
+
* when the policy says network off.
|
|
50
|
+
* - **`unshare`**, fallback: `--user --map-root-user --mount` and then a mount
|
|
51
|
+
* preamble that makes `/` read-only and re-binds the write paths read-write.
|
|
52
|
+
* Coarser and more fragile than bwrap (it is a shell preamble, not a
|
|
53
|
+
* supervisor), and the one piece here most likely to need revision once it has
|
|
54
|
+
* actually run. `--net` for network off, as in Phase 28.
|
|
55
|
+
*
|
|
56
|
+
* Note the consequence of the R44-SBX.4 privilege-escalation probe: `unshare`
|
|
57
|
+
* sets neither `PR_SET_NO_NEW_PRIVS` nor anything that refuses `exec` of a
|
|
58
|
+
* setuid binary, so it can demonstrate neither half of the
|
|
59
|
+
* `allowPrivilegeEscalation: false` invariant and the self-test will report
|
|
60
|
+
* `unavailable` for it. That is the fail-closed reading and it is the intended
|
|
61
|
+
* one: this backend's entire safety argument is the self-test, so a mechanism
|
|
62
|
+
* that cannot show the invariant holds does not get to claim it.
|
|
63
|
+
*
|
|
64
|
+
* Ordering is Landlock helper, then bwrap, then unshare: most precise mechanism
|
|
65
|
+
* first, and the kernel-version check keeps the Landlock path from being chosen
|
|
66
|
+
* on a kernel that cannot support it even when a helper is configured.
|
|
67
|
+
*/
|
|
68
|
+
import { type ShellConfig } from "../../utils/shell.ts";
|
|
69
|
+
import { type SandboxExecutor } from "./executor.ts";
|
|
70
|
+
import type { SandboxPolicy } from "./policy.ts";
|
|
71
|
+
/** Landlock filesystem restriction landed in Linux 5.13. Below that the helper cannot work. */
|
|
72
|
+
export declare const MIN_LANDLOCK_KERNEL: {
|
|
73
|
+
readonly major: 5;
|
|
74
|
+
readonly minor: 13;
|
|
75
|
+
};
|
|
76
|
+
export type LinuxSandboxMechanism = {
|
|
77
|
+
kind: "landlock";
|
|
78
|
+
bin: string;
|
|
79
|
+
} | {
|
|
80
|
+
kind: "bwrap";
|
|
81
|
+
bin: string;
|
|
82
|
+
} | {
|
|
83
|
+
kind: "unshare";
|
|
84
|
+
bin: string;
|
|
85
|
+
};
|
|
86
|
+
export interface LinuxSandboxOptions {
|
|
87
|
+
/** Path to a Landlock helper implementing the contract in the module doc. */
|
|
88
|
+
landlockHelperBin?: string;
|
|
89
|
+
/** Resolves a bare binary name; defaults to a `PATH` scan. Injection point for tests. */
|
|
90
|
+
lookupBin?: (name: string) => string | null;
|
|
91
|
+
/**
|
|
92
|
+
* Defaults to `os.release()`. Injection point for tests.
|
|
93
|
+
*
|
|
94
|
+
* The default is applied inside `detectLinuxSandboxMechanism` rather than only
|
|
95
|
+
* at the one call site in `createLinuxSandboxExecutor`, because it used to
|
|
96
|
+
* default to `""` there: every *exported* call therefore failed
|
|
97
|
+
* `supportsLandlock("")` and silently fell through to bwrap, even on a kernel
|
|
98
|
+
* that supports Landlock and with a helper configured.
|
|
99
|
+
*/
|
|
100
|
+
kernelRelease?: string;
|
|
101
|
+
shellPath?: string;
|
|
102
|
+
extraAllowedEnvVars?: readonly string[];
|
|
103
|
+
selfTestTimeoutSeconds?: number;
|
|
104
|
+
}
|
|
105
|
+
/** True when `release` (an `os.release()` string) is at least 5.13. Unparseable releases answer `false`. */
|
|
106
|
+
export declare function supportsLandlock(release: string): boolean;
|
|
107
|
+
/** Picks the mechanism to use, most precise first. `null` means this host has none. */
|
|
108
|
+
export declare function detectLinuxSandboxMechanism(options?: LinuxSandboxOptions): LinuxSandboxMechanism | null;
|
|
109
|
+
/**
|
|
110
|
+
* Builds the wrapper invocation for `mechanism`.
|
|
111
|
+
*
|
|
112
|
+
* Exported so the argument vectors are reviewable and testable without a Linux
|
|
113
|
+
* host -- with the standing caveat that a correct-looking argv is not evidence
|
|
114
|
+
* of confinement.
|
|
115
|
+
*/
|
|
116
|
+
export declare function buildLinuxSandboxCommand(mechanism: LinuxSandboxMechanism, policy: SandboxPolicy, command: string, shell: ShellConfig, cwd: string): {
|
|
117
|
+
command: string;
|
|
118
|
+
args: string[];
|
|
119
|
+
};
|
|
120
|
+
export declare function createLinuxSandboxExecutor(options?: LinuxSandboxOptions): SandboxExecutor;
|
|
121
|
+
//# sourceMappingURL=linux.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"linux.d.ts","sourceRoot":"","sources":["../../../src/core/sandbox/linux.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkEG;AAKH,OAAO,EAAkB,KAAK,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAExE,OAAO,EAGN,KAAK,eAAe,EAGpB,MAAM,eAAe,CAAC;AACvB,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAKjD,+FAA+F;AAC/F,eAAO,MAAM,mBAAmB;aAAK,KAAK,EAAE,CAAC;aAAE,KAAK,EAAE,EAAE;CAAW,CAAC;AAEpE,MAAM,MAAM,qBAAqB,GAC9B;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GACjC;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GAC9B;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAAC;AAEpC,MAAM,WAAW,mBAAmB;IACnC,6EAA6E;IAC7E,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,yFAAyF;IACzF,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,GAAG,IAAI,CAAC;IAC5C;;;;;;;;OAQG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,mBAAmB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACxC,sBAAsB,CAAC,EAAE,MAAM,CAAC;CAChC;AAWD,4GAA4G;AAC5G,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAOzD;AAED,uFAAuF;AACvF,wBAAgB,2BAA2B,CAAC,OAAO,GAAE,mBAAwB,GAAG,qBAAqB,GAAG,IAAI,CAc3G;AA+BD;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CACvC,SAAS,EAAE,qBAAqB,EAChC,MAAM,EAAE,aAAa,EACrB,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,WAAW,EAClB,GAAG,EAAE,MAAM,GACT;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,EAAE,CAAA;CAAE,CAiDrC;AAED,wBAAgB,0BAA0B,CAAC,OAAO,GAAE,mBAAwB,GAAG,eAAe,CAyE7F"}
|