typeclaw 0.49.0 → 0.51.0
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/dist/types/agent/attention-escalation.d.ts +18 -0
- package/dist/types/agent/auth.d.ts +7 -0
- package/dist/types/agent/bash-sandbox-env.d.ts +15 -0
- package/dist/types/agent/bash-sandbox-proc.d.ts +8 -0
- package/dist/types/agent/bash-sandbox.d.ts +94 -0
- package/dist/types/agent/compaction.d.ts +8 -0
- package/dist/types/agent/git-nudge.d.ts +6 -0
- package/dist/types/agent/guard-types.d.ts +25 -0
- package/dist/types/agent/guards.d.ts +7 -0
- package/dist/types/agent/idle-compaction.d.ts +8 -0
- package/dist/types/agent/index.d.ts +151 -0
- package/dist/types/agent/live-subagents.d.ts +113 -0
- package/dist/types/agent/llm-replay-sanitizer.d.ts +11 -0
- package/dist/types/agent/loop-guard.d.ts +67 -0
- package/dist/types/agent/model-fallback.d.ts +29 -0
- package/dist/types/agent/model-overrides.d.ts +8 -0
- package/dist/types/agent/multimodal/index.d.ts +2 -0
- package/dist/types/agent/multimodal/look-at.d.ts +60 -0
- package/dist/types/agent/multimodal/looker.d.ts +61 -0
- package/dist/types/agent/multimodal/read-redirect.d.ts +6 -0
- package/dist/types/agent/network/response-body.d.ts +1 -0
- package/dist/types/agent/network/safe-http.d.ts +46 -0
- package/dist/types/agent/output-allowance.d.ts +4 -0
- package/dist/types/agent/plugin-tools.d.ts +58 -0
- package/dist/types/agent/proactive-next-step-nudge.d.ts +2 -0
- package/dist/types/agent/prompt-cache-key.d.ts +3 -0
- package/dist/types/agent/provider-error.d.ts +23 -0
- package/dist/types/agent/reload-tool.d.ts +10 -0
- package/dist/types/agent/restart/index.d.ts +31 -0
- package/dist/types/agent/restart-handoff/index.d.ts +32 -0
- package/dist/types/agent/restart-handoff/paths.d.ts +1 -0
- package/dist/types/agent/retry-same-ref.d.ts +41 -0
- package/dist/types/agent/reviewer-activity.d.ts +3 -0
- package/dist/types/agent/reviewer-bash-policy.d.ts +8 -0
- package/dist/types/agent/self.d.ts +1 -0
- package/dist/types/agent/session-meta.d.ts +28 -0
- package/dist/types/agent/session-origin.d.ts +65 -0
- package/dist/types/agent/subagent-cache-keepalive.d.ts +38 -0
- package/dist/types/agent/subagent-completion-reminder.d.ts +29 -0
- package/dist/types/agent/subagent-drain.d.ts +25 -0
- package/dist/types/agent/subagent-session.d.ts +3 -0
- package/dist/types/agent/subagents.d.ts +153 -0
- package/dist/types/agent/system-prompt-composition.d.ts +17 -0
- package/dist/types/agent/system-prompt.d.ts +7 -0
- package/dist/types/agent/throttle-circuit.d.ts +25 -0
- package/dist/types/agent/todo/continuation-policy.d.ts +54 -0
- package/dist/types/agent/todo/continuation-state.d.ts +11 -0
- package/dist/types/agent/todo/continuation-wiring.d.ts +32 -0
- package/dist/types/agent/todo/continuation.d.ts +21 -0
- package/dist/types/agent/todo/scope.d.ts +6 -0
- package/dist/types/agent/todo/store.d.ts +16 -0
- package/dist/types/agent/tool-error-remediation.d.ts +1 -0
- package/dist/types/agent/tool-file-safety.d.ts +78 -0
- package/dist/types/agent/tool-not-found-nudge.d.ts +9 -0
- package/dist/types/agent/tool-result-budget.d.ts +15 -0
- package/dist/types/agent/tools/channel-disengage.d.ts +18 -0
- package/dist/types/agent/tools/channel-edit.d.ts +19 -0
- package/dist/types/agent/tools/channel-fetch-attachment.d.ts +36 -0
- package/dist/types/agent/tools/channel-handoff.d.ts +13 -0
- package/dist/types/agent/tools/channel-history-render.d.ts +3 -0
- package/dist/types/agent/tools/channel-history.d.ts +25 -0
- package/dist/types/agent/tools/channel-log.d.ts +5 -0
- package/dist/types/agent/tools/channel-react.d.ts +23 -0
- package/dist/types/agent/tools/channel-read.d.ts +27 -0
- package/dist/types/agent/tools/channel-reply.d.ts +47 -0
- package/dist/types/agent/tools/channel-send.d.ts +42 -0
- package/dist/types/agent/tools/channel-session-search.d.ts +10 -0
- package/dist/types/agent/tools/curl-impersonate.d.ts +37 -0
- package/dist/types/agent/tools/ddg.d.ts +27 -0
- package/dist/types/agent/tools/grant-role.d.ts +25 -0
- package/dist/types/agent/tools/keyed-semaphore.d.ts +10 -0
- package/dist/types/agent/tools/post-github-review.d.ts +38 -0
- package/dist/types/agent/tools/restart.d.ts +25 -0
- package/dist/types/agent/tools/runtime-notice.d.ts +3 -0
- package/dist/types/agent/tools/search-retry.d.ts +16 -0
- package/dist/types/agent/tools/skip-response.d.ts +17 -0
- package/dist/types/agent/tools/spawn-subagent.d.ts +77 -0
- package/dist/types/agent/tools/stream-snapshot.d.ts +23 -0
- package/dist/types/agent/tools/subagent-access.d.ts +20 -0
- package/dist/types/agent/tools/subagent-cancel.d.ts +23 -0
- package/dist/types/agent/tools/subagent-output.d.ts +50 -0
- package/dist/types/agent/tools/todo/index.d.ts +14 -0
- package/dist/types/agent/tools/webfetch/adaptive-html.d.ts +29 -0
- package/dist/types/agent/tools/webfetch/fetch.d.ts +26 -0
- package/dist/types/agent/tools/webfetch/html-lexical.d.ts +27 -0
- package/dist/types/agent/tools/webfetch/index.d.ts +1 -0
- package/dist/types/agent/tools/webfetch/inline-style-visibility.d.ts +3 -0
- package/dist/types/agent/tools/webfetch/strategies/grep.d.ts +11 -0
- package/dist/types/agent/tools/webfetch/strategies/jq.d.ts +4 -0
- package/dist/types/agent/tools/webfetch/strategies/raw.d.ts +1 -0
- package/dist/types/agent/tools/webfetch/strategies/readability.d.ts +16 -0
- package/dist/types/agent/tools/webfetch/strategies/selector.d.ts +4 -0
- package/dist/types/agent/tools/webfetch/strategies/snapshot.d.ts +1 -0
- package/dist/types/agent/tools/webfetch/tool.d.ts +15 -0
- package/dist/types/agent/tools/webfetch/types.d.ts +32 -0
- package/dist/types/agent/tools/websearch.d.ts +17 -0
- package/dist/types/agent/tools/wikipedia.d.ts +7 -0
- package/dist/types/agent/tools-without-local-file-operands.d.ts +1 -0
- package/dist/types/agent/turn-runner.d.ts +36 -0
- package/dist/types/agent-messenger/config-dir.d.ts +19 -0
- package/dist/types/browser/dockerfile.d.ts +2 -0
- package/dist/types/browser/registry.d.ts +49 -0
- package/dist/types/bundled-plugins/bun-hygiene/policy.d.ts +18 -0
- package/dist/types/bundled-plugins/github-cli-auth/git-askpass.d.ts +5 -0
- package/dist/types/bundled-plugins/guard/keys.d.ts +6 -0
- package/dist/types/bundled-plugins/guard/policies/managed-config.d.ts +7 -0
- package/dist/types/bundled-plugins/guard/policies/memory-topics-delete.d.ts +11 -0
- package/dist/types/bundled-plugins/guard/policies/memory-topics-write.d.ts +7 -0
- package/dist/types/bundled-plugins/guard/policies/non-workspace-write.d.ts +9 -0
- package/dist/types/bundled-plugins/guard/policies/skill-authoring.d.ts +20 -0
- package/dist/types/bundled-plugins/guard/policies/uncommitted-changes.d.ts +12 -0
- package/dist/types/bundled-plugins/guard/policy.d.ts +11 -0
- package/dist/types/bundled-plugins/memory/secret-detector.d.ts +11 -0
- package/dist/types/bundled-plugins/memory/slug.d.ts +4 -0
- package/dist/types/bundled-plugins/security/permissions.d.ts +20 -0
- package/dist/types/bundled-plugins/security/policies/private-surface-read.d.ts +34 -0
- package/dist/types/bundled-plugins/security/policies/ssrf.d.ts +18 -0
- package/dist/types/bundled-plugins/security/policy.d.ts +4 -0
- package/dist/types/channels/adapter-namespace.d.ts +2 -0
- package/dist/types/channels/adapters/mention-hints.d.ts +12 -0
- package/dist/types/channels/adapters/webex-id-ref.d.ts +5 -0
- package/dist/types/channels/background-handoff.d.ts +56 -0
- package/dist/types/channels/background-obligations.d.ts +135 -0
- package/dist/types/channels/catch-up.d.ts +26 -0
- package/dist/types/channels/commands.d.ts +2 -0
- package/dist/types/channels/completion-claim.d.ts +20 -0
- package/dist/types/channels/continuation-willingness.d.ts +1 -0
- package/dist/types/channels/continuity-types.d.ts +75 -0
- package/dist/types/channels/describe-error.d.ts +1 -0
- package/dist/types/channels/engagement.d.ts +34 -0
- package/dist/types/channels/github-false-receipt.d.ts +20 -0
- package/dist/types/channels/github-repo.d.ts +2 -0
- package/dist/types/channels/github-rereview-guard.d.ts +24 -0
- package/dist/types/channels/github-review-check.d.ts +135 -0
- package/dist/types/channels/github-review-claim.d.ts +3 -0
- package/dist/types/channels/github-review-turn-ledger.d.ts +71 -0
- package/dist/types/channels/github-review-verdict-coordinator.d.ts +117 -0
- package/dist/types/channels/github-token-bridge.d.ts +20 -0
- package/dist/types/channels/github-verdict-activity.d.ts +12 -0
- package/dist/types/channels/inbound-journal.d.ts +272 -0
- package/dist/types/channels/last-alive.d.ts +3 -0
- package/dist/types/channels/membership-cache.d.ts +27 -0
- package/dist/types/channels/membership.d.ts +21 -0
- package/dist/types/channels/outbound-flood-filter.d.ts +7 -0
- package/dist/types/channels/participants.d.ts +4 -0
- package/dist/types/channels/persistence.d.ts +32 -0
- package/dist/types/channels/recovery-notice.d.ts +26 -0
- package/dist/types/channels/recovery-outbox.d.ts +58 -0
- package/dist/types/channels/router.d.ts +760 -0
- package/dist/types/channels/schema.d.ts +501 -0
- package/dist/types/channels/session-handoff.d.ts +58 -0
- package/dist/types/channels/session-search.d.ts +29 -0
- package/dist/types/channels/types.d.ts +414 -0
- package/dist/types/channels/waiting-reactions.d.ts +25 -0
- package/dist/types/cli/builtins.d.ts +2 -0
- package/dist/types/cli/command-meta.d.ts +9 -0
- package/dist/types/coding-agent/broker-body.d.ts +7 -0
- package/dist/types/coding-agent/broker.d.ts +22 -0
- package/dist/types/coding-agent/claude.d.ts +22 -0
- package/dist/types/coding-agent/codex.d.ts +19 -0
- package/dist/types/coding-agent/index.d.ts +71 -0
- package/dist/types/coding-agent/omo-state.d.ts +2 -0
- package/dist/types/coding-agent/omo-stream.d.ts +22 -0
- package/dist/types/coding-agent/omo.d.ts +133 -0
- package/dist/types/coding-agent/runner.d.ts +35 -0
- package/dist/types/coding-agent/tool.d.ts +27 -0
- package/dist/types/coding-agent/worktree.d.ts +22 -0
- package/dist/types/commands/index.d.ts +45 -0
- package/dist/types/config/config.d.ts +827 -0
- package/dist/types/config/index.d.ts +3 -0
- package/dist/types/config/model-overrides.d.ts +3 -0
- package/dist/types/config/providers.d.ts +1458 -0
- package/dist/types/config/reloadable.d.ts +9 -0
- package/dist/types/container/agent-operation-lock.d.ts +31 -0
- package/dist/types/container/build-cache.d.ts +39 -0
- package/dist/types/container/compose-project.d.ts +1 -0
- package/dist/types/container/controller.d.ts +25 -0
- package/dist/types/container/docker-app.d.ts +23 -0
- package/dist/types/container/exit-reason.d.ts +10 -0
- package/dist/types/container/index.d.ts +14 -0
- package/dist/types/container/log-archive.d.ts +68 -0
- package/dist/types/container/log-colors.d.ts +3 -0
- package/dist/types/container/log-timestamps.d.ts +9 -0
- package/dist/types/container/logs.d.ts +37 -0
- package/dist/types/container/memory-limit.d.ts +13 -0
- package/dist/types/container/memory-oversubscription.d.ts +20 -0
- package/dist/types/container/oom-events.d.ts +18 -0
- package/dist/types/container/port.d.ts +18 -0
- package/dist/types/container/require-running.d.ts +16 -0
- package/dist/types/container/restart.d.ts +32 -0
- package/dist/types/container/shared.d.ts +93 -0
- package/dist/types/container/shell.d.ts +35 -0
- package/dist/types/container/start.d.ts +145 -0
- package/dist/types/container/stats.d.ts +31 -0
- package/dist/types/container/status.d.ts +25 -0
- package/dist/types/container/stop.d.ts +24 -0
- package/dist/types/container/tool-oom-priority.d.ts +4 -0
- package/dist/types/container/verify-running.d.ts +49 -0
- package/dist/types/cron/consumer.d.ts +42 -0
- package/dist/types/cron/count-state.d.ts +24 -0
- package/dist/types/cron/index.d.ts +21 -0
- package/dist/types/cron/list.d.ts +33 -0
- package/dist/types/cron/reloadable.d.ts +11 -0
- package/dist/types/cron/scheduler.d.ts +51 -0
- package/dist/types/cron/schema.d.ts +108 -0
- package/dist/types/dependencies/bin-resolver.d.ts +28 -0
- package/dist/types/dependencies/bins.d.ts +22 -0
- package/dist/types/dependencies/index.d.ts +2 -0
- package/dist/types/eval/cell.d.ts +26 -0
- package/dist/types/eval/config.d.ts +19 -0
- package/dist/types/eval/dispatch.d.ts +7 -0
- package/dist/types/eval/kernel.d.ts +28 -0
- package/dist/types/eval/process.d.ts +23 -0
- package/dist/types/eval/protocol.d.ts +34 -0
- package/dist/types/eval/sandbox.d.ts +10 -0
- package/dist/types/eval/tool.d.ts +17 -0
- package/dist/types/eval/wire.d.ts +33 -0
- package/dist/types/git/bound-gc-config.d.ts +4 -0
- package/dist/types/git/hookless.d.ts +1 -0
- package/dist/types/git/reconcile-ignored.d.ts +13 -0
- package/dist/types/git/resolve-agent-git.d.ts +8 -0
- package/dist/types/git/resolve-identity.d.ts +10 -0
- package/dist/types/git/run.d.ts +24 -0
- package/dist/types/git/system-commit.d.ts +2 -0
- package/dist/types/hostd/client.d.ts +13 -0
- package/dist/types/hostd/models.d.ts +1 -0
- package/dist/types/hostd/paths.d.ts +17 -0
- package/dist/types/hostd/protocol.d.ts +93 -0
- package/dist/types/hostd/spawn.d.ts +17 -0
- package/dist/types/hostd/version.d.ts +18 -0
- package/dist/types/init/auto-upgrade.d.ts +41 -0
- package/dist/types/init/cli-version.d.ts +7 -0
- package/dist/types/init/dockerfile.d.ts +34 -0
- package/dist/types/init/ensure-deps.d.ts +17 -0
- package/dist/types/init/env-file.d.ts +3 -0
- package/dist/types/init/gitignore.d.ts +5 -0
- package/dist/types/init/local-source-stamp.d.ts +3 -0
- package/dist/types/init/packagejson.d.ts +7 -0
- package/dist/types/init/paths.d.ts +3 -0
- package/dist/types/init/reconcile-plugin-deps.d.ts +13 -0
- package/dist/types/init/run-bun-install.d.ts +16 -0
- package/dist/types/init/windows-dev-link.d.ts +8 -0
- package/dist/types/mcp/catalog.d.ts +7 -0
- package/dist/types/mcp/client.d.ts +58 -0
- package/dist/types/mcp/manager.d.ts +56 -0
- package/dist/types/mcp/tools.d.ts +23 -0
- package/dist/types/models/embedding-model.d.ts +20 -0
- package/dist/types/models/transformers-version.d.ts +1 -0
- package/dist/types/network/internal-destinations.d.ts +29 -0
- package/dist/types/operations/classify-tool-outcome.d.ts +35 -0
- package/dist/types/operations/incidents.d.ts +47 -0
- package/dist/types/operations/index.d.ts +3 -0
- package/dist/types/operations/remediations.d.ts +25 -0
- package/dist/types/path-safety/real-intended-path.d.ts +9 -0
- package/dist/types/permissions/builtins.d.ts +25 -0
- package/dist/types/permissions/grant.d.ts +19 -0
- package/dist/types/permissions/index.d.ts +6 -0
- package/dist/types/permissions/match-rule.d.ts +28 -0
- package/dist/types/permissions/permissions.d.ts +42 -0
- package/dist/types/permissions/resolve.d.ts +25 -0
- package/dist/types/permissions/schema.d.ts +14 -0
- package/dist/types/plugin/context.d.ts +20 -0
- package/dist/types/plugin/core-tool-names.d.ts +4 -0
- package/dist/types/plugin/define.d.ts +46 -0
- package/dist/types/plugin/hooks.d.ts +52 -0
- package/dist/types/plugin/index.d.ts +11 -0
- package/dist/types/plugin/load-skill.d.ts +14 -0
- package/dist/types/plugin/loader.d.ts +25 -0
- package/dist/types/plugin/manager.d.ts +42 -0
- package/dist/types/plugin/registry.d.ts +73 -0
- package/dist/types/plugin/skills.d.ts +11 -0
- package/dist/types/plugin/types.d.ts +336 -0
- package/dist/types/plugin/zod-introspect.d.ts +11 -0
- package/dist/types/reload/client.d.ts +11 -0
- package/dist/types/reload/docker-exec-client.d.ts +11 -0
- package/dist/types/reload/format.d.ts +2 -0
- package/dist/types/reload/index.d.ts +6 -0
- package/dist/types/reload/recover.d.ts +22 -0
- package/dist/types/reload/registry.d.ts +10 -0
- package/dist/types/reload/types.d.ts +25 -0
- package/dist/types/role-claim/client.d.ts +20 -0
- package/dist/types/role-claim/code.d.ts +4 -0
- package/dist/types/role-claim/controller.d.ts +59 -0
- package/dist/types/role-claim/index.d.ts +6 -0
- package/dist/types/role-claim/match-rule.d.ts +9 -0
- package/dist/types/role-claim/pending.d.ts +35 -0
- package/dist/types/role-claim/reload-after-claim.d.ts +16 -0
- package/dist/types/run/llm-fetch-observer.d.ts +50 -0
- package/dist/types/sandbox/availability.d.ts +21 -0
- package/dist/types/sandbox/build.d.ts +7 -0
- package/dist/types/sandbox/canonical-secrets.d.ts +8 -0
- package/dist/types/sandbox/coding-agent.d.ts +20 -0
- package/dist/types/sandbox/dependency-bins.d.ts +19 -0
- package/dist/types/sandbox/dev-source.d.ts +4 -0
- package/dist/types/sandbox/env-exposure.d.ts +3 -0
- package/dist/types/sandbox/errors.d.ts +20 -0
- package/dist/types/sandbox/hidden-paths.d.ts +11 -0
- package/dist/types/sandbox/index.d.ts +14 -0
- package/dist/types/sandbox/package-install.d.ts +1 -0
- package/dist/types/sandbox/policy.d.ts +71 -0
- package/dist/types/sandbox/privileged-runtime.d.ts +13 -0
- package/dist/types/sandbox/quote.d.ts +2 -0
- package/dist/types/sandbox/runtime-private.d.ts +1 -0
- package/dist/types/sandbox/session-tmp.d.ts +6 -0
- package/dist/types/sandbox/symlinks.d.ts +6 -0
- package/dist/types/sandbox/writable-zones.d.ts +15 -0
- package/dist/types/secrets/coding-agent-auth.d.ts +25 -0
- package/dist/types/secrets/defaults.d.ts +21 -0
- package/dist/types/secrets/export-github-cli-store.d.ts +22 -0
- package/dist/types/secrets/hydrate.d.ts +7 -0
- package/dist/types/secrets/index.d.ts +7 -0
- package/dist/types/secrets/provision-github-cli-store.d.ts +45 -0
- package/dist/types/secrets/refresh-provider-oauth.d.ts +22 -0
- package/dist/types/secrets/resolve.d.ts +14 -0
- package/dist/types/secrets/schema.d.ts +840 -0
- package/dist/types/secrets/storage.d.ts +56 -0
- package/dist/types/shared/host-locale.d.ts +1 -0
- package/dist/types/shared/index.d.ts +5 -0
- package/dist/types/shared/local-time.d.ts +4 -0
- package/dist/types/shared/platform.d.ts +2 -0
- package/dist/types/shared/protocol.d.ts +424 -0
- package/dist/types/shared/style-text.d.ts +3 -0
- package/dist/types/shared/wsl.d.ts +17 -0
- package/dist/types/stream/broker.d.ts +2 -0
- package/dist/types/stream/index.d.ts +2 -0
- package/dist/types/stream/types.d.ts +71 -0
- package/package.json +13 -6
- package/scripts/build-plugin-types.ts +105 -0
- package/scripts/check-plugin-sdk.ts +111 -0
- package/scripts/require-parallel.ts +5 -32
- package/src/agent/bash-sandbox-env.ts +104 -0
- package/src/agent/bash-sandbox-proc.ts +70 -0
- package/src/agent/bash-sandbox.ts +225 -0
- package/src/agent/compaction.ts +22 -10
- package/src/agent/guard-types.ts +3 -0
- package/src/agent/guards.ts +4 -0
- package/src/agent/idle-compaction.ts +178 -0
- package/src/agent/index.ts +139 -172
- package/src/agent/live-subagents.ts +19 -0
- package/src/agent/multimodal/look-at.ts +22 -9
- package/src/agent/output-allowance.ts +7 -0
- package/src/agent/plugin-tools.ts +39 -377
- package/src/agent/reviewer-bash-policy.ts +41 -1
- package/src/agent/session-origin.ts +28 -11
- package/src/agent/subagent-cache-keepalive.ts +198 -0
- package/src/agent/subagent-completion-reminder.ts +2 -2
- package/src/agent/subagent-session.ts +6 -0
- package/src/agent/subagents.ts +46 -8
- package/src/agent/system-prompt-composition.ts +141 -0
- package/src/agent/system-prompt.ts +5 -5
- package/src/agent/todo/scope.ts +1 -1
- package/src/agent/tool-file-safety.ts +6 -1
- package/src/agent/tools/channel-edit.ts +20 -10
- package/src/agent/tools/channel-fetch-attachment.ts +12 -5
- package/src/agent/tools/channel-handoff.ts +72 -0
- package/src/agent/tools/channel-read.ts +57 -10
- package/src/agent/tools/channel-reply.ts +33 -26
- package/src/agent/tools/channel-send.ts +21 -13
- package/src/agent/tools/channel-session-search.ts +35 -0
- package/src/agent/tools/curl-impersonate.ts +11 -4
- package/src/agent/tools/ddg.ts +84 -16
- package/src/agent/tools/spawn-subagent.ts +27 -11
- package/src/agent/tools/stream-snapshot.ts +15 -2
- package/src/agent/tools/subagent-access.ts +11 -4
- package/src/agent/tools-without-local-file-operands.ts +4 -0
- package/src/browser/bsk-shim.mjs +74 -0
- package/src/browser/dockerfile.ts +84 -0
- package/src/browser/egress.ts +104 -0
- package/src/browser/fill-secret.ts +307 -0
- package/src/browser/managed-browser.ts +205 -0
- package/src/browser/registry.ts +110 -0
- package/src/browser/relay.ts +231 -0
- package/src/browser/sandbox-entry.ts +167 -0
- package/src/bundled-plugins/agent-browser/index.ts +2 -0
- package/src/bundled-plugins/browser-agent/browser-agent.ts +89 -0
- package/src/bundled-plugins/browser-agent/index.ts +12 -0
- package/src/bundled-plugins/doc-render/index.ts +0 -10
- package/src/bundled-plugins/doc-render/render.ts +83 -111
- package/src/bundled-plugins/doc-render/skills/typeclaw-render-pdf/SKILL.md +152 -257
- package/src/bundled-plugins/explorer/explorer.ts +1 -1
- package/src/bundled-plugins/github-cli-auth/gh-command.ts +4 -0
- package/src/bundled-plugins/github-cli-auth/gh-review-detect.ts +40 -16
- package/src/bundled-plugins/github-cli-auth/git-auth-diagnostic.ts +95 -0
- package/src/bundled-plugins/github-cli-auth/graphql-auth-nudge.ts +12 -7
- package/src/bundled-plugins/github-cli-auth/index.ts +85 -60
- package/src/bundled-plugins/managed-browser/index.ts +179 -0
- package/src/bundled-plugins/managed-browser/skills/browser-use/browser-use/SKILL.md +27 -0
- package/src/bundled-plugins/managed-browser/skills/browserskill/browserskill/SKILL.md +28 -0
- package/src/bundled-plugins/managed-browser/skills/omowright/omowright/SKILL.md +40 -0
- package/src/bundled-plugins/memory/dreaming.ts +4 -1
- package/src/bundled-plugins/memory/load-memory.ts +2 -4
- package/src/bundled-plugins/memory/memory-logger.ts +74 -2
- package/src/bundled-plugins/memory/transcript-preload.ts +103 -0
- package/src/bundled-plugins/memory/vector/hybrid.ts +25 -14
- package/src/bundled-plugins/operator/operator.ts +1 -1
- package/src/bundled-plugins/qa/index.ts +11 -0
- package/src/bundled-plugins/qa/qa.ts +160 -0
- package/src/bundled-plugins/qa/skills/qa-cli.ts +50 -0
- package/src/bundled-plugins/qa/skills/qa-general.ts +30 -0
- package/src/bundled-plugins/qa/skills/qa-http.ts +39 -0
- package/src/bundled-plugins/qa/skills/qa-pr.ts +51 -0
- package/src/bundled-plugins/qa/skills/qa-web.ts +49 -0
- package/src/bundled-plugins/security/index.ts +53 -34
- package/src/bundled-plugins/security/policies/outbound-secret-scan.ts +1 -0
- package/src/bundled-plugins/security/policies/private-surface-read.ts +166 -201
- package/src/channels/adapter-namespace.ts +13 -0
- package/src/channels/adapters/discord-bot-reference.ts +5 -4
- package/src/channels/adapters/discord-bot.ts +98 -5
- package/src/channels/adapters/discord-classify.ts +8 -3
- package/src/channels/adapters/discord.ts +29 -0
- package/src/channels/adapters/github/index.ts +16 -0
- package/src/channels/adapters/github/last-alive.ts +4 -16
- package/src/channels/adapters/slack-attachment-download.ts +14 -3
- package/src/channels/adapters/slack-bot-author-resolver.ts +4 -3
- package/src/channels/adapters/slack-bot-channel-resolver.ts +9 -6
- package/src/channels/adapters/slack-bot-classify.ts +1 -0
- package/src/channels/adapters/slack-bot-slash-commands.ts +3 -1
- package/src/channels/adapters/slack-bot.ts +299 -67
- package/src/channels/adapters/slack-classify.ts +1 -0
- package/src/channels/catch-up.ts +137 -0
- package/src/channels/continuation-willingness.ts +2 -2
- package/src/channels/continuity-types.ts +1 -0
- package/src/channels/engagement.ts +17 -1
- package/src/channels/github-false-receipt.ts +3 -3
- package/src/channels/github-rereview-guard.ts +9 -5
- package/src/channels/github-review-check.ts +5 -1
- package/src/channels/github-review-verdict-coordinator.ts +68 -2
- package/src/channels/github-token-bridge.ts +24 -0
- package/src/channels/last-alive.ts +34 -0
- package/src/channels/manager.ts +8 -1
- package/src/channels/router.ts +515 -243
- package/src/channels/session-handoff.fixture.ts +144 -0
- package/src/channels/session-handoff.ts +175 -0
- package/src/channels/session-search.ts +71 -0
- package/src/channels/subagent-completion-bridge.ts +3 -2
- package/src/channels/types.ts +12 -2
- package/src/cli/channel.ts +2 -3
- package/src/cli/hostd.ts +3 -0
- package/src/cli/init.ts +2 -3
- package/src/cli/model.ts +132 -3
- package/src/coding-agent/index.ts +7 -1
- package/src/coding-agent/omo-stream.ts +40 -0
- package/src/coding-agent/runner.ts +30 -8
- package/src/config/config.ts +126 -22
- package/src/config/model-overrides.ts +59 -0
- package/src/config/models-mutation.ts +185 -2
- package/src/config/providers-mutation.ts +12 -4
- package/src/config/providers.ts +69 -4
- package/src/container/start.ts +132 -5
- package/src/doctor/checks.ts +33 -22
- package/src/doctor/index.ts +48 -12
- package/src/doctor/operational-incidents.ts +16 -1
- package/src/doctor/plugin-bridge.ts +14 -1
- package/src/doctor/stage.ts +14 -0
- package/src/doctor/types.ts +6 -0
- package/src/eval/cell.ts +93 -0
- package/src/eval/config.ts +32 -0
- package/src/eval/dispatch.ts +67 -0
- package/src/eval/entry.ts +261 -0
- package/src/eval/kernel.ts +154 -0
- package/src/eval/process.ts +113 -0
- package/src/eval/protocol.ts +26 -0
- package/src/eval/redeclare.ts +174 -0
- package/src/eval/sandbox.ts +114 -0
- package/src/eval/tool.ts +98 -0
- package/src/eval/wire.ts +93 -0
- package/src/hostd/daemon.ts +13 -1
- package/src/init/auto-upgrade.ts +7 -1
- package/src/init/dockerfile.ts +57 -12
- package/src/init/index.ts +4 -3
- package/src/init/local-source-stamp.ts +68 -0
- package/src/init/models-dev.ts +4 -0
- package/src/init/validate-api-key.ts +3 -0
- package/src/operations/classify-tool-outcome.ts +1 -1
- package/src/permissions/builtins.ts +7 -0
- package/src/permissions/permissions.ts +18 -9
- package/src/permissions/resolve.ts +7 -1
- package/src/plugin/context.ts +2 -0
- package/src/plugin/core-tool-names.ts +6 -1
- package/src/plugin/hooks.ts +137 -0
- package/src/plugin/index.ts +6 -0
- package/src/plugin/manager.ts +4 -0
- package/src/plugin/types.ts +60 -0
- package/src/run/bundled-plugins.ts +6 -0
- package/src/run/index.ts +24 -14
- package/src/run/llm-fetch-observer.ts +12 -15
- package/src/sandbox/canonical-secrets.ts +4 -0
- package/src/sandbox/dev-source.ts +26 -0
- package/src/sandbox/env-exposure.ts +20 -0
- package/src/sandbox/hidden-paths.ts +16 -2
- package/src/secrets/storage.ts +13 -0
- package/src/server/index.ts +46 -11
- package/src/skills/typeclaw-channel-github/SKILL.md +8 -8
- package/src/skills/typeclaw-config/SKILL.md +57 -5
- package/src/skills/typeclaw-config/references/dockerfile.md +2 -2
- package/src/skills/typeclaw-github-contributing/SKILL.md +1 -1
- package/src/skills/typeclaw-monorepo/SKILL.md +1 -1
- package/src/skills/typeclaw-permissions/SKILL.md +7 -7
- package/src/skills/typeclaw-troubleshooting/SKILL.md +12 -1
- package/typeclaw.schema.json +488 -5
- package/src/bundled-plugins/doc-render/templates/lib.typ +0 -339
- package/src/bundled-plugins/github-cli-auth/gh-store.ts +0 -733
|
@@ -0,0 +1,105 @@
|
|
|
1
|
+
#!/usr/bin/env bun
|
|
2
|
+
|
|
3
|
+
import { rm } from 'node:fs/promises'
|
|
4
|
+
import { dirname, join, relative } from 'node:path'
|
|
5
|
+
import { fileURLToPath } from 'node:url'
|
|
6
|
+
|
|
7
|
+
import * as ts from '@typescript/typescript6'
|
|
8
|
+
|
|
9
|
+
const root = join(dirname(fileURLToPath(import.meta.url)), '..')
|
|
10
|
+
const sourceRoot = join(root, 'src')
|
|
11
|
+
const outputRoot = join(root, 'dist', 'types')
|
|
12
|
+
const configPath = join(root, 'tsconfig.json')
|
|
13
|
+
const config = ts.readConfigFile(configPath, ts.sys.readFile)
|
|
14
|
+
if (config.error) throw new Error(ts.flattenDiagnosticMessageText(config.error.messageText, '\n'))
|
|
15
|
+
const parsed = ts.parseJsonConfigFileContent(config.config, ts.sys, root)
|
|
16
|
+
const options: ts.CompilerOptions = {
|
|
17
|
+
...parsed.options,
|
|
18
|
+
noEmit: false,
|
|
19
|
+
noEmitOnError: true,
|
|
20
|
+
declaration: true,
|
|
21
|
+
declarationMap: false,
|
|
22
|
+
emitDeclarationOnly: true,
|
|
23
|
+
rootDir: sourceRoot,
|
|
24
|
+
outDir: outputRoot,
|
|
25
|
+
}
|
|
26
|
+
const program = ts.createProgram([join(sourceRoot, 'plugin', 'index.ts')], options)
|
|
27
|
+
const resolutionCache = ts.createModuleResolutionCache(root, (path) => path, options)
|
|
28
|
+
|
|
29
|
+
// Keep the emitted graph self-contained: consumers must not inherit our @/*
|
|
30
|
+
// aliases. Explicit .js specifiers also work with NodeNext declaration lookup.
|
|
31
|
+
const rewriteImports: ts.TransformerFactory<ts.SourceFile | ts.Bundle> = (context) => {
|
|
32
|
+
return (source) => {
|
|
33
|
+
if (ts.isBundle(source)) return source
|
|
34
|
+
const rewrite = (specifier: ts.StringLiteral): ts.StringLiteral => {
|
|
35
|
+
if (!specifier.text.startsWith('@/') && !specifier.text.startsWith('.')) return specifier
|
|
36
|
+
const resolved = ts.resolveModuleName(
|
|
37
|
+
specifier.text,
|
|
38
|
+
source.fileName,
|
|
39
|
+
options,
|
|
40
|
+
ts.sys,
|
|
41
|
+
resolutionCache,
|
|
42
|
+
).resolvedModule
|
|
43
|
+
if (!resolved) throw new Error(`Cannot resolve SDK declaration import ${specifier.text} in ${source.fileName}`)
|
|
44
|
+
let path = relative(dirname(source.fileName), resolved.resolvedFileName).replaceAll('\\', '/')
|
|
45
|
+
path = path
|
|
46
|
+
.replace(/\.tsx?$/, '.js')
|
|
47
|
+
.replace(/\.mts$/, '.mjs')
|
|
48
|
+
.replace(/\.cts$/, '.cjs')
|
|
49
|
+
return context.factory.createStringLiteral(path.startsWith('.') ? path : `./${path}`)
|
|
50
|
+
}
|
|
51
|
+
const visit: ts.Visitor = (node) => {
|
|
52
|
+
if (ts.isImportDeclaration(node) && ts.isStringLiteral(node.moduleSpecifier))
|
|
53
|
+
return context.factory.updateImportDeclaration(
|
|
54
|
+
node,
|
|
55
|
+
node.modifiers,
|
|
56
|
+
node.importClause,
|
|
57
|
+
rewrite(node.moduleSpecifier),
|
|
58
|
+
node.attributes,
|
|
59
|
+
)
|
|
60
|
+
if (ts.isExportDeclaration(node) && node.moduleSpecifier && ts.isStringLiteral(node.moduleSpecifier))
|
|
61
|
+
return context.factory.updateExportDeclaration(
|
|
62
|
+
node,
|
|
63
|
+
node.modifiers,
|
|
64
|
+
node.isTypeOnly,
|
|
65
|
+
node.exportClause,
|
|
66
|
+
rewrite(node.moduleSpecifier),
|
|
67
|
+
node.attributes,
|
|
68
|
+
)
|
|
69
|
+
if (ts.isImportTypeNode(node) && ts.isLiteralTypeNode(node.argument) && ts.isStringLiteral(node.argument.literal))
|
|
70
|
+
return context.factory.updateImportTypeNode(
|
|
71
|
+
node,
|
|
72
|
+
context.factory.createLiteralTypeNode(rewrite(node.argument.literal)),
|
|
73
|
+
node.attributes,
|
|
74
|
+
node.qualifier,
|
|
75
|
+
node.typeArguments,
|
|
76
|
+
node.isTypeOf,
|
|
77
|
+
)
|
|
78
|
+
return ts.visitEachChild(node, visit, context)
|
|
79
|
+
}
|
|
80
|
+
return ts.visitNode(source, visit) as ts.SourceFile
|
|
81
|
+
}
|
|
82
|
+
}
|
|
83
|
+
|
|
84
|
+
const diagnostics = [...parsed.errors, ...ts.getPreEmitDiagnostics(program)]
|
|
85
|
+
if (diagnostics.some((diagnostic) => diagnostic.category === ts.DiagnosticCategory.Error)) {
|
|
86
|
+
console.error(
|
|
87
|
+
ts.formatDiagnostics(diagnostics, {
|
|
88
|
+
getCanonicalFileName: (path) => path,
|
|
89
|
+
getCurrentDirectory: () => root,
|
|
90
|
+
getNewLine: () => '\n',
|
|
91
|
+
}),
|
|
92
|
+
)
|
|
93
|
+
process.exit(1)
|
|
94
|
+
}
|
|
95
|
+
await rm(outputRoot, { recursive: true, force: true })
|
|
96
|
+
const result = program.emit(undefined, undefined, undefined, true, { afterDeclarations: [rewriteImports] })
|
|
97
|
+
if (result.emitSkipped || result.diagnostics.some((diagnostic) => diagnostic.category === ts.DiagnosticCategory.Error))
|
|
98
|
+
throw new Error(
|
|
99
|
+
ts.formatDiagnostics(result.diagnostics, {
|
|
100
|
+
getCanonicalFileName: (path) => path,
|
|
101
|
+
getCurrentDirectory: () => root,
|
|
102
|
+
getNewLine: () => '\n',
|
|
103
|
+
}),
|
|
104
|
+
)
|
|
105
|
+
console.log('Built public plugin declarations under dist/types')
|
|
@@ -0,0 +1,111 @@
|
|
|
1
|
+
#!/usr/bin/env bun
|
|
2
|
+
|
|
3
|
+
import { mkdir, mkdtemp, rm, writeFile } from 'node:fs/promises'
|
|
4
|
+
import { tmpdir } from 'node:os'
|
|
5
|
+
import { dirname, join } from 'node:path'
|
|
6
|
+
import { fileURLToPath } from 'node:url'
|
|
7
|
+
|
|
8
|
+
const root = join(dirname(fileURLToPath(import.meta.url)), '..')
|
|
9
|
+
const scratch = await mkdtemp(join(tmpdir(), 'typeclaw-plugin-sdk-'))
|
|
10
|
+
const manifest = await Bun.file(join(root, 'package.json')).json()
|
|
11
|
+
const bunTypes = await Bun.file(join(root, 'node_modules', '@types', 'bun', 'package.json')).json()
|
|
12
|
+
|
|
13
|
+
async function run(argv: string[], cwd: string): Promise<string> {
|
|
14
|
+
const child = Bun.spawn(argv, { cwd, stdin: 'ignore', stdout: 'pipe', stderr: 'pipe' })
|
|
15
|
+
const [stdout, stderr, code] = await Promise.all([
|
|
16
|
+
new Response(child.stdout).text(),
|
|
17
|
+
new Response(child.stderr).text(),
|
|
18
|
+
child.exited,
|
|
19
|
+
])
|
|
20
|
+
if (code !== 0) throw new Error(`${argv.join(' ')} failed (${code})\n${stdout}\n${stderr}`)
|
|
21
|
+
return stdout
|
|
22
|
+
}
|
|
23
|
+
|
|
24
|
+
try {
|
|
25
|
+
// Exercise the real prepack lifecycle. Installing with scripts disabled then
|
|
26
|
+
// proves declaration consumers do not need our dev compiler or install hook.
|
|
27
|
+
await run(['npm', 'pack', '--pack-destination', scratch], root)
|
|
28
|
+
const archiveName = `typeclaw-${manifest.version}.tgz`
|
|
29
|
+
const consumer = join(scratch, 'consumer')
|
|
30
|
+
await mkdir(consumer)
|
|
31
|
+
await writeFile(
|
|
32
|
+
join(consumer, 'package.json'),
|
|
33
|
+
JSON.stringify({
|
|
34
|
+
name: 'example-plugin-consumer',
|
|
35
|
+
private: true,
|
|
36
|
+
type: 'module',
|
|
37
|
+
dependencies: { typeclaw: `file:../${archiveName}`, zod: manifest.dependencies.zod },
|
|
38
|
+
devDependencies: { '@types/bun': bunTypes.version },
|
|
39
|
+
}),
|
|
40
|
+
)
|
|
41
|
+
await run([process.execPath, 'install', '--ignore-scripts'], consumer)
|
|
42
|
+
await writeFile(
|
|
43
|
+
join(consumer, 'tsconfig.json'),
|
|
44
|
+
JSON.stringify({
|
|
45
|
+
compilerOptions: {
|
|
46
|
+
target: 'ESNext',
|
|
47
|
+
module: 'Preserve',
|
|
48
|
+
moduleResolution: 'bundler',
|
|
49
|
+
strict: true,
|
|
50
|
+
skipLibCheck: true,
|
|
51
|
+
noEmit: true,
|
|
52
|
+
types: ['bun'],
|
|
53
|
+
},
|
|
54
|
+
include: ['plugin.ts'],
|
|
55
|
+
}),
|
|
56
|
+
)
|
|
57
|
+
await writeFile(
|
|
58
|
+
join(consumer, 'plugin.ts'),
|
|
59
|
+
`
|
|
60
|
+
import { definePlugin, type Hooks } from 'typeclaw/plugin'
|
|
61
|
+
import { z } from 'zod'
|
|
62
|
+
const hooks = {
|
|
63
|
+
'tool.before': (event) => {
|
|
64
|
+
const tool: string = event.tool
|
|
65
|
+
// @ts-expect-error tool identifiers must remain strings, not any
|
|
66
|
+
const invalid: number = event.tool
|
|
67
|
+
return tool ? undefined : { block: true as const, reason: 'empty tool' }
|
|
68
|
+
},
|
|
69
|
+
} satisfies Hooks
|
|
70
|
+
// @ts-expect-error unsupported hook names must not become valid or any
|
|
71
|
+
const unsupported: keyof Hooks = 'session.strat'
|
|
72
|
+
export default definePlugin({
|
|
73
|
+
configSchema: z.object({ enabled: z.boolean() }),
|
|
74
|
+
plugin: async (ctx) => {
|
|
75
|
+
const enabled: boolean = ctx.config.enabled
|
|
76
|
+
// @ts-expect-error schema-inferred config must not become any
|
|
77
|
+
const invalid: string = ctx.config.enabled
|
|
78
|
+
return enabled ? { hooks } : {}
|
|
79
|
+
},
|
|
80
|
+
})
|
|
81
|
+
`,
|
|
82
|
+
)
|
|
83
|
+
for (const [module, resolution] of [
|
|
84
|
+
['Preserve', 'bundler'],
|
|
85
|
+
['NodeNext', 'NodeNext'],
|
|
86
|
+
]) {
|
|
87
|
+
const output = await run(
|
|
88
|
+
[
|
|
89
|
+
process.execPath,
|
|
90
|
+
'run',
|
|
91
|
+
'typecheck',
|
|
92
|
+
'--project',
|
|
93
|
+
join(consumer, 'tsconfig.json'),
|
|
94
|
+
'--module',
|
|
95
|
+
module!,
|
|
96
|
+
'--moduleResolution',
|
|
97
|
+
resolution!,
|
|
98
|
+
'--listFiles',
|
|
99
|
+
],
|
|
100
|
+
root,
|
|
101
|
+
)
|
|
102
|
+
const files = output.split(/\r?\n/).map((file) => file.replaceAll('\\', '/'))
|
|
103
|
+
if (files.some((file) => file.includes('/node_modules/typeclaw/src/')))
|
|
104
|
+
throw new Error('The public SDK pulled TypeClaw implementation sources into the consumer.')
|
|
105
|
+
if (!files.some((file) => file.endsWith('/node_modules/typeclaw/dist/types/plugin/index.d.ts')))
|
|
106
|
+
throw new Error('The packed public SDK declaration entry was not resolved.')
|
|
107
|
+
console.log(`Packed plugin consumer passed ${resolution} resolution without source imports or @/* aliases`)
|
|
108
|
+
}
|
|
109
|
+
} finally {
|
|
110
|
+
await rm(scratch, { recursive: true, force: true })
|
|
111
|
+
}
|
|
@@ -1,6 +1,6 @@
|
|
|
1
|
-
// Preloaded by bunfig.toml `[test] preload
|
|
2
|
-
//
|
|
3
|
-
//
|
|
1
|
+
// Preloaded by bunfig.toml `[test] preload` to deny `bun test` without
|
|
2
|
+
// --parallel. The default timeout belongs in bunfig.toml, not this preload,
|
|
3
|
+
// so an explicit CLI --timeout keeps its normal precedence.
|
|
4
4
|
//
|
|
5
5
|
// Why deny serial runs: Serial runs are ~3.4x slower (44s → 13s, see commit
|
|
6
6
|
// 1c66d5e), and Bun has no bunfig knob for the flag yet (verified against
|
|
@@ -18,39 +18,12 @@
|
|
|
18
18
|
//
|
|
19
19
|
// Bypass with TYPECLAW_ALLOW_SERIAL_TESTS=1 when debugging a flaky test
|
|
20
20
|
// where worker contention obscures the failure.
|
|
21
|
-
//
|
|
22
|
-
// Why raise the default timeout: A growing number of tests in this repo
|
|
23
|
-
// either spawn child processes (`bun run typeclaw …` via Bun.spawn from
|
|
24
|
-
// src/cli/index.test.ts, src/cli/role.test.ts, src/cli/status.test.ts,
|
|
25
|
-
// src/init/dockerfile.test.ts agent-browser wrapper, etc.) or boot the
|
|
26
|
-
// in-process agent (`startAgent({ port: 0, … })` from src/run/plugin.test.ts).
|
|
27
|
-
// Both shapes have a happy-path cost well under 1s but a worst-case cost
|
|
28
|
-
// that races Bun's 5000ms ceiling under `--parallel` contention. The
|
|
29
|
-
// repeating failure mode is "this test timed out after 5000ms" appearing
|
|
30
|
-
// on different tests across runs at a rough ~3-15% rate per full-suite
|
|
31
|
-
// invocation — not a real bug, just resource starvation. Raising the
|
|
32
|
-
// default to 30s eliminates the false positives without masking real
|
|
33
|
-
// hangs (a wedged test still fails, just 6x slower than before). The
|
|
34
|
-
// happy path is unaffected because tests complete in their actual
|
|
35
|
-
// runtime, not the timeout budget.
|
|
36
|
-
//
|
|
37
|
-
// 30s was chosen as ~75x the observed happy-path cold-start (~400ms) for
|
|
38
|
-
// the heaviest subprocess tests, matching the in-house convention used in
|
|
39
|
-
// pi-coding-agent's subprocess fixtures and Bun's own integration-test
|
|
40
|
-
// suites (see oven-sh/bun test/cli/install/*.test.ts which set 5-minute
|
|
41
|
-
// timeouts for full installs). Individual tests that genuinely need more
|
|
42
|
-
// can still pass an explicit 3rd arg to `test()` to override locally.
|
|
43
|
-
|
|
44
|
-
import { setDefaultTimeout } from 'bun:test'
|
|
45
21
|
|
|
46
22
|
const isParallelWorker = typeof process.env.BUN_TEST_WORKER_ID === 'string'
|
|
47
23
|
|
|
48
|
-
if (isParallelWorker) {
|
|
49
|
-
setDefaultTimeout(30_000)
|
|
50
|
-
} else if (process.env.TYPECLAW_ALLOW_SERIAL_TESTS === '1') {
|
|
24
|
+
if (!isParallelWorker && process.env.TYPECLAW_ALLOW_SERIAL_TESTS === '1') {
|
|
51
25
|
console.warn('[require-parallel] Running serially — TYPECLAW_ALLOW_SERIAL_TESTS=1 set.')
|
|
52
|
-
|
|
53
|
-
} else {
|
|
26
|
+
} else if (!isParallelWorker) {
|
|
54
27
|
console.error('')
|
|
55
28
|
console.error(' ✗ `bun test` without --parallel is denied in this repo.')
|
|
56
29
|
console.error('')
|
|
@@ -0,0 +1,104 @@
|
|
|
1
|
+
import { join } from 'node:path'
|
|
2
|
+
|
|
3
|
+
import { readEnvFile } from '@/init/env-file'
|
|
4
|
+
import { resolveExposableEnvNames } from '@/sandbox/env-exposure'
|
|
5
|
+
type BashEnvOverlay = Record<string, string>
|
|
6
|
+
const SECRET_BASH_ENV_NAMES = new Set(['GH_TOKEN', 'GITHUB_TOKEN'])
|
|
7
|
+
// Transport classifier for the TRUSTED hook-injected overlay only (e.g.
|
|
8
|
+
// github-cli-auth's per-repo GH_TOKEN). Token/secret-shaped names use `inherit`
|
|
9
|
+
// so their value never renders into the bwrap argv; plain names (GH_REPO) go
|
|
10
|
+
// via `set`. This is NOT a .env exposure filter — the overlay is populated by
|
|
11
|
+
// trusted runtime hooks, not operator .env.
|
|
12
|
+
const OVERLAY_SECRET_NAME_PATTERN = /(?:^|_)(?:TOKEN|SECRET|PASSWORD|API_KEY|PRIVATE_KEY|AUTH)$/i
|
|
13
|
+
function isOverlaySecretName(name: string): boolean {
|
|
14
|
+
return SECRET_BASH_ENV_NAMES.has(name) || OVERLAY_SECRET_NAME_PATTERN.test(name)
|
|
15
|
+
}
|
|
16
|
+
|
|
17
|
+
export function buildSandboxEnvPolicy(
|
|
18
|
+
overlay: BashEnvOverlay | undefined,
|
|
19
|
+
runtimeEnv: Record<string, string> | undefined,
|
|
20
|
+
exposableEnvNames: readonly string[] = [],
|
|
21
|
+
withhold: readonly string[] = [],
|
|
22
|
+
): { inherit?: string[]; set?: Record<string, string>; withhold?: string[] } {
|
|
23
|
+
const requestedWithhold = new Set(withhold)
|
|
24
|
+
const overlayNames = new Set(Object.keys(overlay ?? {}))
|
|
25
|
+
// The overlay is a deliberate command-scoped replacement, while withholding
|
|
26
|
+
// only removes ambient values; an overlay therefore wins for the same name.
|
|
27
|
+
const effectiveWithhold = [...requestedWithhold].filter((name) => !overlayNames.has(name))
|
|
28
|
+
const effectiveWithholdSet = new Set(effectiveWithhold)
|
|
29
|
+
const set = Object.fromEntries(Object.entries(runtimeEnv ?? {}).filter(([key]) => !requestedWithhold.has(key)))
|
|
30
|
+
const inherit: string[] = []
|
|
31
|
+
const inheritSeen = new Set<string>()
|
|
32
|
+
const pushInherit = (key: string): void => {
|
|
33
|
+
if (effectiveWithholdSet.has(key) || Object.hasOwn(set, key) || inheritSeen.has(key)) return
|
|
34
|
+
inheritSeen.add(key)
|
|
35
|
+
inherit.push(key)
|
|
36
|
+
}
|
|
37
|
+
for (const [key, value] of Object.entries(overlay ?? {})) {
|
|
38
|
+
if (Object.hasOwn(set, key)) continue
|
|
39
|
+
if (isOverlaySecretName(key)) pushInherit(key)
|
|
40
|
+
else set[key] = value
|
|
41
|
+
}
|
|
42
|
+
// Operator-declared .env vars pass through by NAME (inherit), keeping values
|
|
43
|
+
// out of the rendered bwrap argv. Sandbox-integrity names were already dropped
|
|
44
|
+
// in resolveExposableEnvNames — these are the survivors.
|
|
45
|
+
for (const key of exposableEnvNames) pushInherit(key)
|
|
46
|
+
// Pass the entrypoint-exported Xvfb display (start_xvfb: `export DISPLAY=:99`)
|
|
47
|
+
// through --clearenv, else sandboxed `agent-browser --headed` dies with
|
|
48
|
+
// "Missing X server or $DISPLAY". Passing the runtime's OWN value (not a fixed
|
|
49
|
+
// ":99") keeps `docker.file.xvfb=false` advertising no display. Rendered via
|
|
50
|
+
// `set` (a display number is neither a credential nor shell-injectable), and no
|
|
51
|
+
// /tmp/.X11-unix bind is needed: Chrome reaches Xvfb over the netns-scoped
|
|
52
|
+
// abstract X11 socket while bash keeps network:'inherit'.
|
|
53
|
+
const display = process.env['DISPLAY']
|
|
54
|
+
if (
|
|
55
|
+
display !== undefined &&
|
|
56
|
+
display !== '' &&
|
|
57
|
+
!effectiveWithholdSet.has('DISPLAY') &&
|
|
58
|
+
!Object.hasOwn(set, 'DISPLAY') &&
|
|
59
|
+
!inheritSeen.has('DISPLAY')
|
|
60
|
+
) {
|
|
61
|
+
set['DISPLAY'] = display
|
|
62
|
+
}
|
|
63
|
+
return {
|
|
64
|
+
...(inherit.length > 0 ? { inherit } : {}),
|
|
65
|
+
...(Object.keys(set).length > 0 ? { set } : {}),
|
|
66
|
+
...(effectiveWithhold.length > 0 ? { withhold: effectiveWithhold } : {}),
|
|
67
|
+
}
|
|
68
|
+
}
|
|
69
|
+
|
|
70
|
+
export function spreadSandboxEnv(policy: ReturnType<typeof buildSandboxEnvPolicy>): {
|
|
71
|
+
env?: ReturnType<typeof buildSandboxEnvPolicy>
|
|
72
|
+
} {
|
|
73
|
+
return Object.keys(policy).length > 0 ? { env: policy } : {}
|
|
74
|
+
}
|
|
75
|
+
|
|
76
|
+
export function resolveExposableBashEnvNames(agentDir: string): { exposable: string[]; withheld: string[] } {
|
|
77
|
+
const declaredEnv = readEnvFile(agentDir)
|
|
78
|
+
const exposable = resolveExposableEnvNames(declaredEnv, process.env)
|
|
79
|
+
const exposableSet = new Set(exposable)
|
|
80
|
+
const withheld = [...declaredEnv]
|
|
81
|
+
.filter(([name, value]) => value.length > 0 && !exposableSet.has(name))
|
|
82
|
+
.map(([name]) => name)
|
|
83
|
+
return { exposable, withheld }
|
|
84
|
+
}
|
|
85
|
+
|
|
86
|
+
export function buildRoleScopedConfigEnv(
|
|
87
|
+
agentDir: string,
|
|
88
|
+
hiddenDirs: string[],
|
|
89
|
+
envOverlay: BashEnvOverlay | undefined,
|
|
90
|
+
): BashEnvOverlay | undefined {
|
|
91
|
+
// Low-trust roles have workspace/ masked. Do not let container-global config
|
|
92
|
+
// env vars point CLIs back at that private surface: apps that honor XDG should
|
|
93
|
+
// still run, but their config must land in the sandbox's per-session /tmp.
|
|
94
|
+
// Trusted/owner have only the unconditional credential-dir masks, not the
|
|
95
|
+
// workspace root mask, so their command broker decides whether to set GWS.
|
|
96
|
+
const workspaceHidden = hiddenDirs.includes(join(agentDir, 'workspace'))
|
|
97
|
+
if (!workspaceHidden) return envOverlay
|
|
98
|
+
|
|
99
|
+
return {
|
|
100
|
+
...envOverlay,
|
|
101
|
+
XDG_CONFIG_HOME: '/tmp/.config',
|
|
102
|
+
GWS_CONFIG_HOME: '/tmp/.config/gws',
|
|
103
|
+
}
|
|
104
|
+
}
|
|
@@ -0,0 +1,70 @@
|
|
|
1
|
+
import { config } from '@/config/config'
|
|
2
|
+
import { canMountRealProc, getProcBindSafetyVerdict, resolveProcBindSafetyWithRetry } from '@/sandbox'
|
|
3
|
+
// Picks the /proc strategy for a sandboxed bash call. The branch order is:
|
|
4
|
+
// 'real-proc' ONLY when the operator explicitly opted in (sandbox.realProc) AND
|
|
5
|
+
// the kernel permits the mount (canMountRealProc) — it adds PID isolation but
|
|
6
|
+
// needs CAP_SYS_ADMIN (unshare --mount-proc), so it is a deliberate, narrow
|
|
7
|
+
// opt-in; else 'proc-bind' (--ro-bind /proc, NO CAP_SYS_ADMIN) when its userns
|
|
8
|
+
// leak-block is verified safe; else 'tmpfs'. Because sandbox.realProc DEFAULTS
|
|
9
|
+
// FALSE, the first branch is normally skipped and proc-bind is the de-facto
|
|
10
|
+
// default — which is the point: the common path needs no broad outer capability.
|
|
11
|
+
// 'tmpfs' is the last-resort degraded mode where external packages can't run;
|
|
12
|
+
// reached only when proc-bind is DEFINITIVELY unavailable (a real cross-userns
|
|
13
|
+
// environ leak → fail closed) or its safety stays unverifiable after retries.
|
|
14
|
+
//
|
|
15
|
+
// Read from the boot-time `config` snapshot, NOT live getConfig(): sandbox is
|
|
16
|
+
// restart-required, and the strategy MUST track the boot-time CAP_SYS_ADMIN
|
|
17
|
+
// grant. A `typeclaw reload` flipping realProc would otherwise emit `unshare
|
|
18
|
+
// --mount-proc` in a container booted WITHOUT the cap (or vice versa). Both
|
|
19
|
+
// probes are cached process-globally, so this resolves to one spawn per
|
|
20
|
+
// container lifetime regardless of how many bash calls hit it.
|
|
21
|
+
// A tmpfs degrade carries WHY it happened so the caller can pick a permanent vs
|
|
22
|
+
// retryable error. 'definitive': the probe returned a real cross-userns leak
|
|
23
|
+
// ('unsafe') — the ONLY verdict proven permanent, so it fails closed for good.
|
|
24
|
+
// 'unverified': the safety probe never reached a definitive verdict within its
|
|
25
|
+
// retry budget. That covers BOTH a transient load spike AND a durable
|
|
26
|
+
// incapability (no usable namespaces, a bwrap that starts but cannot set up its
|
|
27
|
+
// sandbox): the probe cannot prove a NEGATIVE capability — only a leak is
|
|
28
|
+
// definitive — so a genuinely incapable host also lands here and simply keeps
|
|
29
|
+
// re-degrading on each call. Since 'inconclusive' is never cached, that costs a
|
|
30
|
+
// re-probe but is correct: the only false case is "capable but briefly
|
|
31
|
+
// saturated", which recovers; an incapable host stays degraded either way.
|
|
32
|
+
// Absent when the strategy is not tmpfs.
|
|
33
|
+
export type ProcStrategyResolution =
|
|
34
|
+
| { strategy: 'real-proc' | 'proc-bind'; degradeReason?: undefined }
|
|
35
|
+
| { strategy: 'tmpfs'; degradeReason: 'definitive' | 'unverified' }
|
|
36
|
+
|
|
37
|
+
export async function resolveProcStrategy(): Promise<ProcStrategyResolution> {
|
|
38
|
+
if (config.sandbox.realProc && (await canMountRealProc())) return { strategy: 'real-proc' }
|
|
39
|
+
// Retry an 'inconclusive' proc-bind probe (transient under load) before
|
|
40
|
+
// degrading — a single such hiccup must not break external-package runs on a
|
|
41
|
+
// capable host. 'unsafe' still fails closed with no retry.
|
|
42
|
+
const verdict = await resolveProcBindSafetyWithRetry(
|
|
43
|
+
() => getProcBindSafetyVerdict(),
|
|
44
|
+
(ms) => Bun.sleep(ms),
|
|
45
|
+
)
|
|
46
|
+
if (verdict === 'safe') return { strategy: 'proc-bind' }
|
|
47
|
+
// Degraded last resort: no working /proc strategy. External package runners
|
|
48
|
+
// (bunx/bun run <pkg-bin>) will fail with Bun's opaque "NotDir" because
|
|
49
|
+
// /proc/self/{fd,maps} are absent. Only a proven 'unsafe' (a real cross-userns
|
|
50
|
+
// leak) is DEFINITIVE — warn once (a real operator-facing limit). An
|
|
51
|
+
// 'inconclusive' is reported as retryable upstream and NOT warned (it would cry
|
|
52
|
+
// wolf every boot storm); a durably-incapable host re-degrades quietly here,
|
|
53
|
+
// since the probe cannot distinguish it from transient load.
|
|
54
|
+
if (verdict === 'unsafe') {
|
|
55
|
+
warnTmpfsProcFallbackOnce()
|
|
56
|
+
return { strategy: 'tmpfs', degradeReason: 'definitive' }
|
|
57
|
+
}
|
|
58
|
+
return { strategy: 'tmpfs', degradeReason: 'unverified' }
|
|
59
|
+
}
|
|
60
|
+
|
|
61
|
+
let tmpfsProcFallbackWarned = false
|
|
62
|
+
function warnTmpfsProcFallbackOnce(): void {
|
|
63
|
+
if (tmpfsProcFallbackWarned) return
|
|
64
|
+
tmpfsProcFallbackWarned = true
|
|
65
|
+
console.warn(
|
|
66
|
+
'[sandbox] degraded /proc mode: neither real-proc nor proc-bind is available on this host, ' +
|
|
67
|
+
'so sandboxed external package runners (bunx / bun run <pkg-bin>) will fail. ' +
|
|
68
|
+
'This needs a runtime with working user namespaces.',
|
|
69
|
+
)
|
|
70
|
+
}
|
|
@@ -0,0 +1,225 @@
|
|
|
1
|
+
import { join } from 'node:path'
|
|
2
|
+
|
|
3
|
+
import { config, getSandboxWritablePathSpecs } from '@/config/config'
|
|
4
|
+
import type { PermissionService } from '@/permissions/permissions'
|
|
5
|
+
import {
|
|
6
|
+
buildSandboxedCommand,
|
|
7
|
+
canWriteAgentRootInSandbox,
|
|
8
|
+
cleanupPrivilegedSandboxRuntime,
|
|
9
|
+
commandNeedsRealProc,
|
|
10
|
+
DEFAULT_SANDBOX_ENV,
|
|
11
|
+
DEPENDENCY_BIN_SANDBOX_DIR,
|
|
12
|
+
ensureBwrapAvailable,
|
|
13
|
+
ensureHiddenMaskTargets,
|
|
14
|
+
ensureSessionTmpDir,
|
|
15
|
+
reconcileDependencyBinWrappers,
|
|
16
|
+
resolveHiddenPaths,
|
|
17
|
+
resolvePrivilegedSandboxRuntime,
|
|
18
|
+
resolveProcSelfExe,
|
|
19
|
+
resolveProtectedZones,
|
|
20
|
+
resolveSandboxSymlinks,
|
|
21
|
+
resolveWritableZones,
|
|
22
|
+
SandboxDegradedProcError,
|
|
23
|
+
SandboxProcProbeUnverifiedError,
|
|
24
|
+
subtractMasked,
|
|
25
|
+
verifyHiddenMaskTargets,
|
|
26
|
+
verifyPrivilegedSandboxRuntime,
|
|
27
|
+
type SandboxMount,
|
|
28
|
+
type SandboxNetwork,
|
|
29
|
+
type SandboxPolicy,
|
|
30
|
+
type DependencyBinReconciliation,
|
|
31
|
+
} from '@/sandbox'
|
|
32
|
+
import { resolveDevSourceMount } from '@/sandbox/dev-source'
|
|
33
|
+
|
|
34
|
+
import {
|
|
35
|
+
buildRoleScopedConfigEnv,
|
|
36
|
+
buildSandboxEnvPolicy,
|
|
37
|
+
resolveExposableBashEnvNames,
|
|
38
|
+
spreadSandboxEnv,
|
|
39
|
+
} from './bash-sandbox-env'
|
|
40
|
+
import { resolveProcStrategy, type ProcStrategyResolution } from './bash-sandbox-proc'
|
|
41
|
+
import type { SessionOrigin } from './session-origin'
|
|
42
|
+
export type DeferredBashPreparationResult = {
|
|
43
|
+
command: string
|
|
44
|
+
env?: Record<string, string>
|
|
45
|
+
mount: Extract<SandboxMount, { type: 'ro-bind' }>
|
|
46
|
+
cleanup: () => Promise<void>
|
|
47
|
+
}
|
|
48
|
+
export type DeferredBashPreparation = () => Promise<DeferredBashPreparationResult>
|
|
49
|
+
export type BashSandboxBoundary = {
|
|
50
|
+
ensureAvailable: () => Promise<void>
|
|
51
|
+
buildCommand: typeof buildSandboxedCommand
|
|
52
|
+
resolveProcStrategy?: () => Promise<ProcStrategyResolution>
|
|
53
|
+
resolveRuntime?: typeof resolvePrivilegedSandboxRuntime
|
|
54
|
+
verifyRuntime?: typeof verifyPrivilegedSandboxRuntime
|
|
55
|
+
cleanupRuntime?: typeof cleanupPrivilegedSandboxRuntime
|
|
56
|
+
}
|
|
57
|
+
|
|
58
|
+
const DEFAULT_BASH_SANDBOX_BOUNDARY: BashSandboxBoundary = {
|
|
59
|
+
ensureAvailable: ensureBwrapAvailable,
|
|
60
|
+
buildCommand: buildSandboxedCommand,
|
|
61
|
+
}
|
|
62
|
+
|
|
63
|
+
type BashFilesystemPolicyOptions = {
|
|
64
|
+
agentDir: string
|
|
65
|
+
canWriteAgentRoot: boolean
|
|
66
|
+
masks: { dirs: string[]; files: string[] }
|
|
67
|
+
writable: { dirs: string[]; files: string[] }
|
|
68
|
+
protected: { dirs: string[]; files: string[] }
|
|
69
|
+
}
|
|
70
|
+
|
|
71
|
+
export type PreparedBashSandbox = {
|
|
72
|
+
commandString: string
|
|
73
|
+
policy: SandboxPolicy
|
|
74
|
+
verify: () => Promise<void>
|
|
75
|
+
cleanup: () => Promise<void>
|
|
76
|
+
spawnEnv: Record<string, string>
|
|
77
|
+
dependencyBins?: DependencyBinReconciliation
|
|
78
|
+
withheld: {
|
|
79
|
+
paths: { dirs: string[]; files: string[] }
|
|
80
|
+
envNames: string[]
|
|
81
|
+
}
|
|
82
|
+
}
|
|
83
|
+
|
|
84
|
+
export function buildBashFilesystemPolicy(options: BashFilesystemPolicyOptions) {
|
|
85
|
+
const { agentDir, canWriteAgentRoot, masks, writable, protected: protectedZones } = options
|
|
86
|
+
if (canWriteAgentRoot) {
|
|
87
|
+
return { writableRoot: { dir: agentDir }, masks, protected: protectedZones }
|
|
88
|
+
}
|
|
89
|
+
return { masks, writable, protected: protectedZones }
|
|
90
|
+
}
|
|
91
|
+
|
|
92
|
+
export type BashSandboxRequest = {
|
|
93
|
+
readonly command: string
|
|
94
|
+
readonly permissions: PermissionService
|
|
95
|
+
readonly origin: SessionOrigin | undefined
|
|
96
|
+
readonly agentDir: string
|
|
97
|
+
readonly sessionId: string
|
|
98
|
+
readonly envOverlay?: Record<string, string>
|
|
99
|
+
readonly envWithhold?: string[]
|
|
100
|
+
readonly deferredPreparation?: DeferredBashPreparation
|
|
101
|
+
readonly boundary?: BashSandboxBoundary
|
|
102
|
+
readonly network?: SandboxNetwork
|
|
103
|
+
}
|
|
104
|
+
|
|
105
|
+
// Shared preparation for model bash and eval. The caller owns verification
|
|
106
|
+
// immediately before spawn and cleanup after the process has exited.
|
|
107
|
+
export async function prepareBashSandbox(options: BashSandboxRequest): Promise<PreparedBashSandbox> {
|
|
108
|
+
const {
|
|
109
|
+
command: originalCommand,
|
|
110
|
+
permissions,
|
|
111
|
+
origin,
|
|
112
|
+
agentDir,
|
|
113
|
+
sessionId,
|
|
114
|
+
envOverlay,
|
|
115
|
+
envWithhold,
|
|
116
|
+
deferredPreparation,
|
|
117
|
+
} = options
|
|
118
|
+
const boundary = options.boundary ?? DEFAULT_BASH_SANDBOX_BOUNDARY
|
|
119
|
+
let preparation: DeferredBashPreparationResult | undefined
|
|
120
|
+
let privilegedRuntime: Awaited<ReturnType<typeof resolvePrivilegedSandboxRuntime>> | undefined
|
|
121
|
+
const cleanup = async (): Promise<void> => {
|
|
122
|
+
const tasks: Promise<void>[] = []
|
|
123
|
+
if (privilegedRuntime !== undefined) {
|
|
124
|
+
tasks.push((boundary.cleanupRuntime ?? cleanupPrivilegedSandboxRuntime)(privilegedRuntime))
|
|
125
|
+
}
|
|
126
|
+
if (preparation !== undefined) tasks.push(preparation.cleanup())
|
|
127
|
+
const outcomes = await Promise.allSettled(tasks)
|
|
128
|
+
const failure = outcomes.find((outcome) => outcome.status === 'rejected')
|
|
129
|
+
if (failure?.status === 'rejected') throw failure.reason
|
|
130
|
+
}
|
|
131
|
+
try {
|
|
132
|
+
preparation = await deferredPreparation?.()
|
|
133
|
+
const command = preparation?.command ?? originalCommand
|
|
134
|
+
const preparedEnvOverlay = preparation?.env === undefined ? envOverlay : { ...envOverlay, ...preparation.env }
|
|
135
|
+
const { dirs, files } = resolveHiddenPaths(permissions, origin, agentDir)
|
|
136
|
+
const envNames = resolveExposableBashEnvNames(agentDir)
|
|
137
|
+
const sandboxEnvOverlay = buildRoleScopedConfigEnv(agentDir, dirs, preparedEnvOverlay)
|
|
138
|
+
const effectiveEnvWithhold = (envWithhold ?? []).filter((name) => !Object.hasOwn(sandboxEnvOverlay ?? {}, name))
|
|
139
|
+
const maskTargets = await ensureHiddenMaskTargets({ dirs, files })
|
|
140
|
+
await boundary.ensureAvailable()
|
|
141
|
+
const sessionTmp = await ensureSessionTmpDir(sessionId)
|
|
142
|
+
const dependencyBins = await reconcileDependencyBinWrappers({ agentDir, sessionTmp })
|
|
143
|
+
const writable = subtractMasked(await resolveWritableZones(agentDir, getSandboxWritablePathSpecs(config)), {
|
|
144
|
+
dirs,
|
|
145
|
+
files,
|
|
146
|
+
})
|
|
147
|
+
const writableRoot = canWriteAgentRootInSandbox(permissions, origin)
|
|
148
|
+
const baseProtectedZones =
|
|
149
|
+
writableRoot || writable.dirs.includes(join(agentDir, '.git'))
|
|
150
|
+
? subtractMasked(await resolveProtectedZones(agentDir), { dirs, files })
|
|
151
|
+
: { dirs: [], files: [] }
|
|
152
|
+
const protectedZones = {
|
|
153
|
+
dirs: baseProtectedZones.dirs,
|
|
154
|
+
files: [...new Set([...baseProtectedZones.files, ...dependencyBins.protectedFiles])],
|
|
155
|
+
}
|
|
156
|
+
const writableDirSet = new Set(writable.dirs)
|
|
157
|
+
const sandboxHome = DEFAULT_SANDBOX_ENV.HOME ?? '/tmp'
|
|
158
|
+
const symlinks = resolveSandboxSymlinks(agentDir, config.sandbox.symlinks, sandboxHome).filter((op) =>
|
|
159
|
+
writableDirSet.has(op.target),
|
|
160
|
+
)
|
|
161
|
+
const { strategy: proc, degradeReason } = await (boundary.resolveProcStrategy ?? resolveProcStrategy)()
|
|
162
|
+
if (proc === 'tmpfs' && commandNeedsRealProc(command)) {
|
|
163
|
+
throw degradeReason === 'unverified' ? new SandboxProcProbeUnverifiedError() : new SandboxDegradedProcError()
|
|
164
|
+
}
|
|
165
|
+
privilegedRuntime = await (boundary.resolveRuntime ?? resolvePrivilegedSandboxRuntime)({
|
|
166
|
+
agentDir,
|
|
167
|
+
command,
|
|
168
|
+
env: sandboxEnvOverlay,
|
|
169
|
+
})
|
|
170
|
+
await verifyHiddenMaskTargets(maskTargets)
|
|
171
|
+
const devSourceMount = await resolveDevSourceMount(agentDir)
|
|
172
|
+
const policy: SandboxPolicy = {
|
|
173
|
+
mounts: [
|
|
174
|
+
{ type: 'ro-bind', source: agentDir, dest: agentDir },
|
|
175
|
+
{ type: 'bind', source: sessionTmp, dest: '/tmp' },
|
|
176
|
+
// `/tmp` is writable, but PATH entries must remain runtime-owned for
|
|
177
|
+
// the lifetime of this command. Last-op-wins makes this narrow re-bind
|
|
178
|
+
// read-only without adding any broader filesystem exposure.
|
|
179
|
+
{ type: 'ro-bind', source: dependencyBins.wrapperDir, dest: DEPENDENCY_BIN_SANDBOX_DIR },
|
|
180
|
+
// The running Bun ELF is runtime-owned, not a model-selected path.
|
|
181
|
+
// Dev/CI installations may place it outside /usr; expose only the
|
|
182
|
+
// executable, never its parent directory, under every proc strategy.
|
|
183
|
+
{ type: 'ro-bind', source: process.execPath, dest: process.execPath },
|
|
184
|
+
...(devSourceMount === undefined ? [] : [devSourceMount]),
|
|
185
|
+
...(privilegedRuntime?.mounts ?? []),
|
|
186
|
+
...(preparation === undefined ? [] : [preparation.mount]),
|
|
187
|
+
],
|
|
188
|
+
...buildBashFilesystemPolicy({
|
|
189
|
+
agentDir,
|
|
190
|
+
canWriteAgentRoot: writableRoot,
|
|
191
|
+
masks: maskTargets,
|
|
192
|
+
writable,
|
|
193
|
+
protected: protectedZones,
|
|
194
|
+
}),
|
|
195
|
+
symlinks,
|
|
196
|
+
network: options.network ?? 'inherit',
|
|
197
|
+
cwd: agentDir,
|
|
198
|
+
proc,
|
|
199
|
+
procSelfExe: resolveProcSelfExe(),
|
|
200
|
+
...spreadSandboxEnv(
|
|
201
|
+
buildSandboxEnvPolicy(sandboxEnvOverlay, privilegedRuntime?.env, envNames.exposable, envWithhold),
|
|
202
|
+
),
|
|
203
|
+
}
|
|
204
|
+
const { commandString, spawnEnv } = boundary.buildCommand(command, policy)
|
|
205
|
+
// The overlay carries command-scoped secret VALUES (e.g. a per-repo GH_TOKEN)
|
|
206
|
+
// that live in neither process.env nor argv; resolveSpawnEnv snapshots
|
|
207
|
+
// inherited names from process.env only, so merge the overlay values in here
|
|
208
|
+
// to complete the exact bwrap-parent env.
|
|
209
|
+
const mergedSpawnEnv =
|
|
210
|
+
spawnEnv !== undefined && sandboxEnvOverlay !== undefined ? { ...spawnEnv, ...sandboxEnvOverlay } : spawnEnv
|
|
211
|
+
const runtimeForResult = privilegedRuntime
|
|
212
|
+
return {
|
|
213
|
+
commandString,
|
|
214
|
+
policy,
|
|
215
|
+
verify: async () => (boundary.verifyRuntime ?? verifyPrivilegedSandboxRuntime)(runtimeForResult),
|
|
216
|
+
cleanup,
|
|
217
|
+
spawnEnv: mergedSpawnEnv,
|
|
218
|
+
dependencyBins,
|
|
219
|
+
withheld: { paths: maskTargets, envNames: [...new Set([...envNames.withheld, ...effectiveEnvWithhold])] },
|
|
220
|
+
}
|
|
221
|
+
} catch (error) {
|
|
222
|
+
await cleanup()
|
|
223
|
+
throw error
|
|
224
|
+
}
|
|
225
|
+
}
|