typeclaw 0.48.13 → 0.50.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/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 +7 -0
- package/dist/types/agent/index.d.ts +163 -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/plugin-tools.d.ts +129 -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.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 +18 -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 +798 -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 +814 -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 +1456 -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 +144 -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/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 +1 -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/dump-system-prompt.ts +52 -110
- package/scripts/require-parallel.ts +5 -32
- package/src/agent/guard-types.ts +3 -0
- package/src/agent/guards.ts +4 -0
- package/src/agent/idle-compaction.ts +174 -0
- package/src/agent/index.ts +210 -80
- package/src/agent/live-sessions.ts +2 -2
- package/src/agent/live-subagents.ts +20 -0
- package/src/agent/multimodal/look-at.ts +22 -9
- package/src/agent/plugin-tools.ts +66 -12
- package/src/agent/prompt-cache-key.ts +42 -0
- package/src/agent/provider-error.ts +179 -10
- package/src/agent/restart-handoff/index.ts +7 -14
- package/src/agent/reviewer-activity.ts +68 -0
- package/src/agent/reviewer-bash-policy.ts +41 -1
- package/src/agent/session-origin.ts +58 -9
- package/src/agent/subagent-cache-keepalive.ts +198 -0
- package/src/agent/subagent-session.ts +6 -0
- package/src/agent/subagents.ts +59 -9
- package/src/agent/system-prompt.ts +68 -202
- package/src/agent/todo/continuation-policy.ts +12 -4
- package/src/agent/tool-file-safety.ts +119 -15
- package/src/agent/tool-not-found-nudge.ts +1 -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-history-render.ts +2 -1
- package/src/agent/tools/channel-read.ts +57 -10
- package/src/agent/tools/channel-reply.ts +55 -30
- package/src/agent/tools/channel-send.ts +69 -19
- package/src/agent/tools/channel-session-search.ts +35 -0
- package/src/agent/tools/curl-impersonate.ts +22 -6
- package/src/agent/tools/ddg.ts +13 -5
- package/src/agent/tools/post-github-review.ts +77 -15
- package/src/agent/tools/skip-response.ts +2 -2
- package/src/agent/tools/spawn-subagent.ts +190 -23
- package/src/agent/tools/stream-snapshot.ts +15 -2
- package/src/agent/tools/subagent-access.ts +11 -4
- package/src/agent/tools/subagent-output.ts +8 -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/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/backup/README.md +10 -9
- package/src/bundled-plugins/backup/runner.ts +140 -58
- package/src/bundled-plugins/backup/subagents.ts +58 -26
- 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/github-cli-auth/gh-command.ts +38 -2
- package/src/bundled-plugins/github-cli-auth/git-auth-diagnostic.ts +95 -0
- package/src/bundled-plugins/github-cli-auth/granted-push.ts +135 -0
- package/src/bundled-plugins/github-cli-auth/index.ts +158 -70
- package/src/bundled-plugins/github-cli-auth/review-account.ts +23 -0
- package/src/bundled-plugins/github-cli-auth/review-checkout.ts +9 -2
- package/src/bundled-plugins/github-cli-auth/review-recorder.ts +45 -7
- package/src/bundled-plugins/managed-browser/index.ts +74 -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/operator/operator.ts +15 -4
- 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/reviewer/skills/code-review.ts +1 -1
- package/src/bundled-plugins/security/index.ts +103 -36
- package/src/bundled-plugins/security/policies/git-exfil.ts +24 -12
- package/src/bundled-plugins/security/policies/outbound-secret-scan.ts +1 -0
- package/src/channels/adapter-namespace.ts +13 -0
- package/src/channels/adapters/discord-bot-reactions.ts +18 -0
- package/src/channels/adapters/discord-bot.ts +219 -72
- package/src/channels/adapters/discord-reactions.ts +18 -0
- package/src/channels/adapters/discord.ts +114 -8
- package/src/channels/adapters/github/inbound.ts +103 -8
- package/src/channels/adapters/github/index.ts +267 -19
- package/src/channels/adapters/github/last-alive.ts +15 -0
- package/src/channels/adapters/github/outbound.ts +54 -18
- package/src/channels/adapters/github/pending-review-store.ts +141 -0
- package/src/channels/adapters/github/permission-guidance.ts +1 -0
- package/src/channels/adapters/github/reactions.ts +100 -0
- package/src/channels/adapters/github/reconcile-cooldown-store.ts +197 -67
- package/src/channels/adapters/github/reconcile-open-prs.ts +418 -33
- package/src/channels/adapters/github/recovery.ts +106 -0
- package/src/channels/adapters/github/review-check.ts +510 -0
- package/src/channels/adapters/github/review-submitter.ts +34 -2
- package/src/channels/adapters/instagram.ts +32 -14
- package/src/channels/adapters/kakaotalk.ts +22 -7
- package/src/channels/adapters/line.ts +18 -3
- package/src/channels/adapters/outbound-account.ts +20 -0
- package/src/channels/adapters/own-reactions.ts +66 -0
- package/src/channels/adapters/recovery-correlation.ts +214 -0
- 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 +19 -11
- package/src/channels/adapters/slack-bot-dedupe.ts +111 -28
- package/src/channels/adapters/slack-bot-reactions.ts +18 -0
- package/src/channels/adapters/slack-bot-slash-commands.ts +3 -1
- package/src/channels/adapters/slack-bot.ts +424 -124
- package/src/channels/adapters/slack-classify.ts +26 -4
- package/src/channels/adapters/slack-inbound-revision.ts +96 -0
- package/src/channels/adapters/slack-reactions.ts +18 -0
- package/src/channels/adapters/slack-thread-ts.ts +6 -0
- package/src/channels/adapters/slack.ts +48 -3
- package/src/channels/adapters/teams.ts +14 -4
- package/src/channels/adapters/telegram-bot.ts +56 -10
- package/src/channels/adapters/webex-bot.ts +12 -2
- package/src/channels/adapters/webex.ts +12 -2
- package/src/channels/background-handoff.ts +434 -0
- package/src/channels/background-obligations.ts +893 -0
- package/src/channels/catch-up.ts +137 -0
- package/src/channels/continuation-willingness.ts +2 -2
- package/src/channels/continuity-types.ts +272 -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 +598 -0
- package/src/channels/github-review-turn-ledger.ts +102 -28
- package/src/channels/github-review-verdict-coordinator.ts +72 -12
- package/src/channels/github-token-bridge.ts +35 -5
- package/src/channels/inbound-journal.ts +1738 -0
- package/src/channels/index.ts +6 -1
- package/src/channels/last-alive.ts +34 -0
- package/src/channels/manager.ts +25 -8
- package/src/channels/recovery-dispatcher.ts +264 -0
- package/src/channels/recovery-notice.ts +94 -0
- package/src/channels/recovery-outbox.ts +459 -0
- package/src/channels/router.ts +2951 -736
- package/src/channels/schema.ts +8 -1
- 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 +17 -14
- package/src/channels/types.ts +133 -18
- package/src/channels/waiting-reactions.ts +664 -0
- package/src/cli/channel.ts +2 -3
- package/src/cli/compose.ts +7 -4
- package/src/cli/hostd.ts +49 -3
- package/src/cli/init.ts +2 -3
- package/src/cli/inspect.ts +11 -14
- package/src/cli/model.ts +132 -3
- package/src/coding-agent/broker-body.ts +38 -0
- package/src/coding-agent/broker.ts +290 -0
- package/src/coding-agent/claude.ts +95 -0
- package/src/coding-agent/codex.ts +104 -0
- package/src/coding-agent/index.ts +512 -0
- package/src/coding-agent/omo-state.ts +69 -0
- package/src/coding-agent/omo-stream.ts +138 -0
- package/src/coding-agent/omo.ts +192 -0
- package/src/coding-agent/runner.ts +285 -0
- package/src/coding-agent/tool.ts +62 -0
- package/src/coding-agent/worktree.ts +355 -0
- package/src/compose/restart.ts +10 -3
- package/src/compose/start.ts +20 -3
- package/src/config/config.ts +121 -25
- 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 +71 -9
- package/src/container/exit-reason.ts +44 -0
- package/src/container/index.ts +5 -0
- package/src/container/log-archive.ts +51 -13
- package/src/container/memory-limit.ts +1 -1
- package/src/container/memory-oversubscription.ts +36 -6
- package/src/container/oom-events.ts +86 -0
- package/src/container/restart.ts +2 -0
- package/src/container/shared.ts +8 -1
- package/src/container/start.ts +120 -17
- package/src/container/stop.ts +6 -2
- package/src/container/tool-oom-priority.ts +32 -0
- package/src/cron/consumer.ts +10 -4
- package/src/cron/reloadable.ts +23 -2
- package/src/doctor/checks.ts +22 -8
- package/src/hostd/daemon.ts +33 -11
- package/src/hostd/spawn.ts +106 -5
- package/src/hostd/version.ts +20 -0
- package/src/hostd/watchdog.ts +241 -0
- package/src/init/auto-upgrade.ts +7 -1
- package/src/init/dockerfile.ts +112 -602
- package/src/init/index.ts +6 -6
- 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/mcp/client.ts +3 -1
- package/src/operations/classify-tool-outcome.ts +45 -1
- package/src/operations/incidents.ts +10 -5
- 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 +1 -1
- package/src/plugin/define.ts +1 -0
- package/src/plugin/hooks.ts +137 -0
- package/src/plugin/index.ts +7 -0
- package/src/plugin/manager.ts +4 -0
- package/src/plugin/types.ts +66 -1
- package/src/run/background-handoff-boot.ts +86 -0
- package/src/run/bundled-plugins.ts +6 -0
- package/src/run/index.ts +107 -97
- package/src/run/llm-fetch-observer.ts +12 -15
- package/src/run/resource-sample.ts +19 -0
- package/src/sandbox/build.ts +4 -0
- package/src/sandbox/canonical-secrets.ts +4 -0
- package/src/sandbox/coding-agent.ts +214 -0
- package/src/sandbox/dev-source.ts +26 -0
- package/src/sandbox/hidden-paths.ts +16 -2
- package/src/sandbox/policy.ts +1 -0
- package/src/sandbox/runtime-private.ts +4 -1
- package/src/secrets/coding-agent-auth.ts +97 -0
- package/src/secrets/index.ts +0 -16
- package/src/secrets/storage.ts +13 -0
- package/src/server/command-runner.ts +6 -2
- package/src/server/index.ts +101 -40
- package/src/skills/typeclaw-channel-github/SKILL.md +15 -13
- package/src/skills/typeclaw-claude-code/SKILL.md +25 -260
- package/src/skills/typeclaw-claude-code/references/auth-flow.md +7 -23
- package/src/skills/typeclaw-claude-code/references/headless-sessions.md +11 -0
- package/src/skills/typeclaw-claude-code/references/results-and-worktrees.md +13 -0
- package/src/skills/typeclaw-codex-cli/SKILL.md +35 -270
- package/src/skills/typeclaw-codex-cli/references/auth-flow.md +13 -20
- package/src/skills/typeclaw-codex-cli/references/headless-sessions.md +26 -0
- package/src/skills/typeclaw-codex-cli/references/results-and-worktrees.md +28 -0
- package/src/skills/typeclaw-config/SKILL.md +60 -26
- package/src/skills/typeclaw-config/references/dockerfile.md +14 -13
- package/src/skills/typeclaw-cron/SKILL.md +1 -1
- package/src/skills/typeclaw-github-contributing/SKILL.md +3 -3
- package/src/skills/typeclaw-memory/SKILL.md +3 -3
- package/src/skills/typeclaw-monorepo/SKILL.md +1 -1
- package/src/skills/typeclaw-omo-cli/SKILL.md +52 -0
- package/src/skills/typeclaw-omo-cli/references/auth-flow.md +11 -0
- package/src/skills/typeclaw-omo-cli/references/headless-sessions.md +11 -0
- package/src/skills/typeclaw-omo-cli/references/results-and-worktrees.md +23 -0
- package/src/skills/typeclaw-permissions/SKILL.md +7 -7
- package/src/skills/typeclaw-plugins/SKILL.md +15 -15
- package/src/skills/typeclaw-skills/SKILL.md +19 -2
- package/src/skills/typeclaw-troubleshooting/SKILL.md +26 -2
- package/typeclaw.schema.json +448 -6
- package/src/bundled-plugins/doc-render/templates/lib.typ +0 -339
- package/src/bundled-plugins/github-cli-auth/gh-store.ts +0 -733
- package/src/secrets/claude-credentials-json.ts +0 -129
- package/src/secrets/codex-auth-json.ts +0 -102
- package/src/secrets/export-claude-credentials-file.ts +0 -270
- package/src/secrets/export-codex-auth-file.ts +0 -250
- package/src/skills/typeclaw-claude-code/references/stop-hook.md +0 -101
- package/src/skills/typeclaw-claude-code/references/tmux-driving.md +0 -243
- package/src/skills/typeclaw-codex-cli/references/stop-hook.md +0 -92
- package/src/skills/typeclaw-codex-cli/references/tmux-driving.md +0 -239
package/src/config/providers.ts
CHANGED
|
@@ -312,9 +312,8 @@ export const KNOWN_PROVIDERS = {
|
|
|
312
312
|
// subscriber's `claude setup-token` credential authorizes. The OAuth dance
|
|
313
313
|
// itself is authorization-code + PKCE against `claude.ai/oauth/authorize`
|
|
314
314
|
// with a localhost callback server (not device-code); the existing
|
|
315
|
-
//
|
|
316
|
-
// a
|
|
317
|
-
// callback can't reach the user's machine.
|
|
315
|
+
// host provider setup owns login. coding_agent delegates inference through
|
|
316
|
+
// a fixed-upstream broker; it never exports a provider token to the CLI.
|
|
318
317
|
//
|
|
319
318
|
// anthropic is the FIRST provider in the registry where both auth modes
|
|
320
319
|
// coexist on one entry. The runtime in src/agent/auth.ts has a load-bearing
|
|
@@ -393,6 +392,13 @@ export const KNOWN_PROVIDERS = {
|
|
|
393
392
|
// these catalog fields Sonnet 4.6 and Opus 4.7 fall back to budget
|
|
394
393
|
// thinking, which Anthropic deprecates on 4.6 and rejects with a 400 on
|
|
395
394
|
// 4.7+ (platform.claude.com/docs/en/build-with-claude/extended-thinking).
|
|
395
|
+
//
|
|
396
|
+
// No Anthropic record sets `compat.supportsStrictTools`. With it, pi sends
|
|
397
|
+
// its strict-preferring built-ins (read/write/edit/bash) as strict tools,
|
|
398
|
+
// turning each optional param into a nullable union. Together with our
|
|
399
|
+
// own enum-union tool params that exceeds Anthropic's 16-union-param
|
|
400
|
+
// request cap, and every channel turn 400s. Guarded by
|
|
401
|
+
// anthropic-payload.test.ts.
|
|
396
402
|
'claude-sonnet-4-6': {
|
|
397
403
|
id: 'claude-sonnet-4-6',
|
|
398
404
|
name: 'Claude Sonnet 4.6',
|
|
@@ -405,7 +411,7 @@ export const KNOWN_PROVIDERS = {
|
|
|
405
411
|
contextWindow: 1000000,
|
|
406
412
|
maxTokens: 64000,
|
|
407
413
|
thinkingLevelMap: { max: 'max' },
|
|
408
|
-
compat: { forceAdaptiveThinking: true
|
|
414
|
+
compat: { forceAdaptiveThinking: true },
|
|
409
415
|
},
|
|
410
416
|
// Sonnet 5 (Jul 1 2026) is the drop-in successor to Sonnet 4.6 with a
|
|
411
417
|
// caveat set that affects consumers of this record:
|
|
@@ -431,7 +437,7 @@ export const KNOWN_PROVIDERS = {
|
|
|
431
437
|
contextWindow: 1000000,
|
|
432
438
|
maxTokens: 128000,
|
|
433
439
|
thinkingLevelMap: { xhigh: 'xhigh', max: 'max' },
|
|
434
|
-
compat: { forceAdaptiveThinking: true
|
|
440
|
+
compat: { forceAdaptiveThinking: true },
|
|
435
441
|
},
|
|
436
442
|
'claude-opus-4-7': {
|
|
437
443
|
id: 'claude-opus-4-7',
|
|
@@ -445,7 +451,7 @@ export const KNOWN_PROVIDERS = {
|
|
|
445
451
|
contextWindow: 1000000,
|
|
446
452
|
maxTokens: 128000,
|
|
447
453
|
thinkingLevelMap: { xhigh: 'xhigh', max: 'max' },
|
|
448
|
-
compat: { forceAdaptiveThinking: true, supportsTemperature: false
|
|
454
|
+
compat: { forceAdaptiveThinking: true, supportsTemperature: false },
|
|
449
455
|
},
|
|
450
456
|
// Opus 4.8 was never in pi 0.73's adaptive id list, so it already got
|
|
451
457
|
// budget thinking (a 400 on 4.7+) before this migration. The catalog
|
|
@@ -467,7 +473,6 @@ export const KNOWN_PROVIDERS = {
|
|
|
467
473
|
supportsMidConvoToolChanges: true,
|
|
468
474
|
forceAdaptiveThinking: true,
|
|
469
475
|
supportsTemperature: false,
|
|
470
|
-
supportsStrictTools: true,
|
|
471
476
|
},
|
|
472
477
|
},
|
|
473
478
|
// Opus 5.5 (Sep 22 2026) keeps adaptive thinking permanently on: both
|
|
@@ -504,7 +509,6 @@ export const KNOWN_PROVIDERS = {
|
|
|
504
509
|
supportsMidConvoToolChanges: true,
|
|
505
510
|
forceAdaptiveThinking: true,
|
|
506
511
|
supportsTemperature: false,
|
|
507
|
-
supportsStrictTools: true,
|
|
508
512
|
},
|
|
509
513
|
},
|
|
510
514
|
// Fable 5 (Jun 2026) is a NEW TIER above Opus — Anthropic's most
|
|
@@ -533,7 +537,6 @@ export const KNOWN_PROVIDERS = {
|
|
|
533
537
|
supportsMidConvoSystemMessages: true,
|
|
534
538
|
supportsMidConvoToolChanges: true,
|
|
535
539
|
forceAdaptiveThinking: true,
|
|
536
|
-
supportsStrictTools: true,
|
|
537
540
|
},
|
|
538
541
|
},
|
|
539
542
|
},
|
|
@@ -1402,6 +1405,60 @@ export const KNOWN_PROVIDERS = {
|
|
|
1402
1405
|
},
|
|
1403
1406
|
},
|
|
1404
1407
|
},
|
|
1408
|
+
// Inception (Mercury diffusion LLMs) official API. OpenAI-compatible
|
|
1409
|
+
// /v1/chat/completions with Bearer auth, so it goes through pi-ai's
|
|
1410
|
+
// `openai-completions` adapter with a custom baseUrl. api-key only.
|
|
1411
|
+
//
|
|
1412
|
+
// Only Mercury 3 is listed: Mercury 2 / 2.5 are closed to new users as of
|
|
1413
|
+
// 2026-10-19 and shut down for existing ones on 2026-11-15. Mercury Voice is
|
|
1414
|
+
// enterprise-gated, Mercury Decide and Mercury Edit 2 don't serve chat.
|
|
1415
|
+
//
|
|
1416
|
+
// Cost is the standard rate from docs.inceptionlabs.ai/get-started/models
|
|
1417
|
+
// as of 2026-10-20, not the 50%-off launch price, so the record doesn't go
|
|
1418
|
+
// stale when the promotion ends. No cache-write surcharge is published.
|
|
1419
|
+
//
|
|
1420
|
+
// reasoning_effort accepts instant/low/medium/high and defaults to `low`
|
|
1421
|
+
// when omitted. `off` maps to `instant` so a non-reasoning turn really drops
|
|
1422
|
+
// to the fastest mode instead of silently reasoning at the default.
|
|
1423
|
+
//
|
|
1424
|
+
// The OpenAPI spec (api.inceptionlabs.ai/openapi.json) documents neither
|
|
1425
|
+
// `store` nor the `developer` role, and pi-ai doesn't auto-detect compat
|
|
1426
|
+
// for this baseUrl, so both are turned off.
|
|
1427
|
+
inception: {
|
|
1428
|
+
id: 'inception',
|
|
1429
|
+
name: 'Inception (Mercury)',
|
|
1430
|
+
baseUrl: 'https://api.inceptionlabs.ai/v1',
|
|
1431
|
+
auth: ['api-key'],
|
|
1432
|
+
apiKeyEnv: 'INCEPTION_API_KEY',
|
|
1433
|
+
oauthProviderId: null,
|
|
1434
|
+
models: {
|
|
1435
|
+
'mercury-3': {
|
|
1436
|
+
id: 'mercury-3',
|
|
1437
|
+
name: 'Mercury 3',
|
|
1438
|
+
api: 'openai-completions',
|
|
1439
|
+
provider: 'inception',
|
|
1440
|
+
baseUrl: 'https://api.inceptionlabs.ai/v1',
|
|
1441
|
+
reasoning: true,
|
|
1442
|
+
thinkingLevelMap: {
|
|
1443
|
+
off: 'instant',
|
|
1444
|
+
minimal: 'low',
|
|
1445
|
+
low: 'low',
|
|
1446
|
+
medium: 'medium',
|
|
1447
|
+
high: 'high',
|
|
1448
|
+
xhigh: 'high',
|
|
1449
|
+
},
|
|
1450
|
+
input: ['text'],
|
|
1451
|
+
cost: { input: 0.2, output: 0.7, cacheRead: 0.02, cacheWrite: 0 },
|
|
1452
|
+
contextWindow: 1000000,
|
|
1453
|
+
maxTokens: 131072,
|
|
1454
|
+
compat: {
|
|
1455
|
+
supportsStore: false,
|
|
1456
|
+
supportsDeveloperRole: false,
|
|
1457
|
+
supportsReasoningEffort: true,
|
|
1458
|
+
},
|
|
1459
|
+
},
|
|
1460
|
+
},
|
|
1461
|
+
},
|
|
1405
1462
|
} as const satisfies Record<string, KnownProvider>
|
|
1406
1463
|
|
|
1407
1464
|
export type KnownProviderId = keyof typeof KNOWN_PROVIDERS
|
|
@@ -1489,6 +1546,11 @@ export const KNOWN_PROVIDER_VENDORS = {
|
|
|
1489
1546
|
'moonshot-coding': { label: 'Coding Plan', hint: 'Kimi Code subscription' },
|
|
1490
1547
|
},
|
|
1491
1548
|
},
|
|
1549
|
+
inception: {
|
|
1550
|
+
id: 'inception',
|
|
1551
|
+
name: 'Inception (Mercury)',
|
|
1552
|
+
providers: ['inception'],
|
|
1553
|
+
},
|
|
1492
1554
|
// Listed last because it is a reseller, not a lab: a user who knows they want
|
|
1493
1555
|
// Anthropic should land on the Anthropic row, not the gateway that proxies it.
|
|
1494
1556
|
opengateway: {
|
|
@@ -0,0 +1,44 @@
|
|
|
1
|
+
import type { DockerExec } from './shared'
|
|
2
|
+
|
|
3
|
+
// OOMKilled is container-wide: a killed subprocess can set it even when the runtime survives.
|
|
4
|
+
// `finishedAt` identifies one stop of a container: Docker keeps the container ID across
|
|
5
|
+
// restarts, so ID alone cannot tell a repeated observation of the same exit from a new one.
|
|
6
|
+
export async function inspectContainerExit(
|
|
7
|
+
exec: DockerExec,
|
|
8
|
+
name: string,
|
|
9
|
+
): Promise<
|
|
10
|
+
| { kind: 'running'; containerId: string }
|
|
11
|
+
| { kind: 'stopped'; containerId: string; finishedAt: string; reason: string | null }
|
|
12
|
+
| null
|
|
13
|
+
> {
|
|
14
|
+
try {
|
|
15
|
+
const result = await exec([
|
|
16
|
+
'inspect',
|
|
17
|
+
'--format',
|
|
18
|
+
'{{.Id}}|{{.State.Running}}|{{.State.OOMKilled}}|{{.State.ExitCode}}|{{.HostConfig.Memory}}|{{.State.FinishedAt}}',
|
|
19
|
+
name,
|
|
20
|
+
])
|
|
21
|
+
if (result.exitCode !== 0) return null
|
|
22
|
+
const match = /^([0-9a-f]{64})\|(true|false)\|(true|false)\|(\d+)\|(\d+)\|(\S+)$/.exec(result.stdout.trim())
|
|
23
|
+
if (!match) return null
|
|
24
|
+
const containerId = match[1]!
|
|
25
|
+
if (match[2] === 'true') return { kind: 'running', containerId }
|
|
26
|
+
const limitBytes = Number(match[5])
|
|
27
|
+
const limit =
|
|
28
|
+
Number.isSafeInteger(limitBytes) && limitBytes > 0
|
|
29
|
+
? ` (likely container memory limit ${Math.ceil(limitBytes / (1024 * 1024))} MiB)`
|
|
30
|
+
: ''
|
|
31
|
+
const exitCode = Number(match[4])
|
|
32
|
+
const reason =
|
|
33
|
+
match[3] === 'true'
|
|
34
|
+
? exitCode === 137
|
|
35
|
+
? `agent runtime was SIGKILLed (137) and the container recorded an OOM kill during this run${limit}. Restart the agent and reduce memory-heavy parallel work.`
|
|
36
|
+
: `agent runtime exited with code ${exitCode}; an OOM kill occurred in the container earlier in this run${limit}; a subprocess may have been killed. Restart the agent and reduce memory-heavy parallel work.`
|
|
37
|
+
: exitCode === 137
|
|
38
|
+
? 'agent runtime exited with SIGKILL (137); Docker did not report an OOM kill.'
|
|
39
|
+
: null
|
|
40
|
+
return { kind: 'stopped', containerId, finishedAt: match[6]!, reason }
|
|
41
|
+
} catch {
|
|
42
|
+
return null
|
|
43
|
+
}
|
|
44
|
+
}
|
package/src/container/index.ts
CHANGED
|
@@ -4,7 +4,7 @@ import { join } from 'node:path'
|
|
|
4
4
|
|
|
5
5
|
import { DEFAULT_LOG_RETENTION_DAYS, MAX_LOG_RETENTION_DAYS } from '@/config'
|
|
6
6
|
|
|
7
|
-
import { resolveDockerBinary, sanitizeDockerStderr } from './shared'
|
|
7
|
+
import { defaultDockerExec, resolveDockerBinary, sanitizeDockerStderr, type DockerExecResult } from './shared'
|
|
8
8
|
|
|
9
9
|
export type DockerLogArchiveResult =
|
|
10
10
|
| { ok: true; status: 'archived'; path: string }
|
|
@@ -49,6 +49,7 @@ export type StreamCaptureResult = {
|
|
|
49
49
|
|
|
50
50
|
export type DockerLogArchiveRuntime = {
|
|
51
51
|
capture?: (input: StreamCaptureInput) => Promise<StreamCaptureResult>
|
|
52
|
+
inspectLogConfig?: (args: string[], options: { cwd: string; signal: AbortSignal }) => Promise<DockerExecResult>
|
|
52
53
|
nonce?: () => string
|
|
53
54
|
now?: () => Date
|
|
54
55
|
resolveDockerBinary?: () => string | null
|
|
@@ -74,6 +75,43 @@ const CONTAINER_ID_PATTERN = /^[a-f0-9]{64}$/
|
|
|
74
75
|
const NONCE_PATTERN = /^[a-f0-9]{32}$/
|
|
75
76
|
const ARCHIVE_FILENAME_PATTERN = /^[a-f0-9]{64}-(\d{4}-\d{2}-\d{2})T(\d{2})-(\d{2})-(\d{2})-(\d{3})Z-[a-f0-9]{32}\.log$/
|
|
76
77
|
const PARTIAL_FILENAME_PATTERN = /^\.[a-f0-9]{64}-\d{4}-\d{2}-\d{2}T\d{2}-\d{2}-\d{2}-\d{3}Z-[a-f0-9]{32}\.partial$/
|
|
78
|
+
const DOCKER_LOG_INSPECT_TIMEOUT_MS = 10_000
|
|
79
|
+
|
|
80
|
+
async function archiveByteLimit(
|
|
81
|
+
agentDir: string,
|
|
82
|
+
containerId: string,
|
|
83
|
+
inspect: NonNullable<DockerLogArchiveRuntime['inspectLogConfig']>,
|
|
84
|
+
): Promise<number> {
|
|
85
|
+
try {
|
|
86
|
+
const result = await inspect(['inspect', '--format', '{{json .HostConfig.LogConfig}}', containerId], {
|
|
87
|
+
cwd: agentDir,
|
|
88
|
+
signal: AbortSignal.timeout(DOCKER_LOG_INSPECT_TIMEOUT_MS),
|
|
89
|
+
})
|
|
90
|
+
if (result.exitCode !== 0) return MAX_DOCKER_LOG_ARCHIVE_BYTES
|
|
91
|
+
const config: unknown = JSON.parse(result.stdout)
|
|
92
|
+
if (typeof config !== 'object' || config === null || !('Type' in config) || config.Type !== 'json-file')
|
|
93
|
+
return MAX_DOCKER_LOG_ARCHIVE_BYTES
|
|
94
|
+
if (!('Config' in config) || typeof config.Config !== 'object' || config.Config === null)
|
|
95
|
+
return MAX_DOCKER_LOG_ARCHIVE_BYTES
|
|
96
|
+
const opts = config.Config
|
|
97
|
+
if (!('max-size' in opts) || typeof opts['max-size'] !== 'string') return MAX_DOCKER_LOG_ARCHIVE_BYTES
|
|
98
|
+
const maxFiles = 'max-file' in opts ? opts['max-file'] : '1'
|
|
99
|
+
// Docker parses max-file with strconv.Atoi, so "05" is 5; only positive counts are bounded.
|
|
100
|
+
if (typeof maxFiles !== 'string' || !/^\+?\d+$/.test(maxFiles) || Number(maxFiles) < 1)
|
|
101
|
+
return MAX_DOCKER_LOG_ARCHIVE_BYTES
|
|
102
|
+
// Docker json-file uses go-units FromHumanSize: decimal powers even for "MiB".
|
|
103
|
+
const sizeMatch = /^(\+?(?:\d+(?:\.\d*)?|\.\d+)(?:e[+-]?\d+)?)(?: ?(b|[kmgtp](?:i?b)?))?$/i.exec(opts['max-size'])
|
|
104
|
+
if (!sizeMatch) return MAX_DOCKER_LOG_ARCHIVE_BYTES
|
|
105
|
+
const prefix = sizeMatch[2]?.toLowerCase()[0]
|
|
106
|
+
const multiplier = prefix && prefix !== 'b' ? 1000 ** ('kmgtp'.indexOf(prefix) + 1) : 1
|
|
107
|
+
const size = Math.trunc(Number(sizeMatch[1]) * multiplier)
|
|
108
|
+
const capacity = size * Number(maxFiles)
|
|
109
|
+
if (size <= 0 || !Number.isSafeInteger(capacity)) return MAX_DOCKER_LOG_ARCHIVE_BYTES
|
|
110
|
+
return Math.min(MAX_DOCKER_LOG_ARCHIVE_TOTAL_BYTES, Math.max(MAX_DOCKER_LOG_ARCHIVE_BYTES, capacity))
|
|
111
|
+
} catch {
|
|
112
|
+
return MAX_DOCKER_LOG_ARCHIVE_BYTES
|
|
113
|
+
}
|
|
114
|
+
}
|
|
77
115
|
|
|
78
116
|
export async function archiveContainerLogs(
|
|
79
117
|
{ agentDir, containerId, retentionDays = DEFAULT_LOG_RETENTION_DAYS }: Parameters<DockerLogArchiver>[0],
|
|
@@ -106,18 +144,21 @@ export async function archiveContainerLogs(
|
|
|
106
144
|
if (binary === null) throw new Error('Docker binary could not be resolved for log archival')
|
|
107
145
|
|
|
108
146
|
const capture = runtime.capture ?? streamProcessOutput
|
|
147
|
+
const maxBytes = await archiveByteLimit(agentDir, containerId, runtime.inspectLogConfig ?? defaultDockerExec)
|
|
109
148
|
const captured = await capture({
|
|
110
149
|
args: ['logs', '--timestamps', containerId],
|
|
111
150
|
binary,
|
|
112
151
|
cwd: agentDir,
|
|
113
|
-
maxBytes
|
|
152
|
+
maxBytes,
|
|
114
153
|
output,
|
|
115
154
|
timeoutMs: DOCKER_LOG_ARCHIVE_TIMEOUT_MS,
|
|
116
155
|
})
|
|
117
156
|
if (captured.terminationBoundExceeded) throw new Error('docker logs did not settle after SIGKILL')
|
|
118
157
|
if (captured.timedOut) throw new Error(`docker logs timed out after ${DOCKER_LOG_ARCHIVE_TIMEOUT_MS}ms`)
|
|
119
158
|
if (captured.overflowed) {
|
|
120
|
-
throw new Error(
|
|
159
|
+
throw new Error(
|
|
160
|
+
`docker logs exceeded the ${maxBytes}-byte archive limit. Container ${containerId} was preserved; export both log streams with docker logs --timestamps ${containerId} > private-log-file 2>&1 (choose a private destination); confirm the export succeeded before removing it with docker rm ${containerId} and retrying.`,
|
|
161
|
+
)
|
|
121
162
|
}
|
|
122
163
|
if (captured.exitCode !== 0) {
|
|
123
164
|
const detail = sanitizeDockerStderr(captured.stderrExcerpt)
|
|
@@ -128,13 +169,16 @@ export async function archiveContainerLogs(
|
|
|
128
169
|
|
|
129
170
|
await output.chmod(0o600)
|
|
130
171
|
const incomingSize = (await output.stat()).size
|
|
131
|
-
|
|
172
|
+
if (incomingSize > MAX_DOCKER_LOG_ARCHIVE_TOTAL_BYTES) {
|
|
173
|
+
throw new Error('Docker log archive exceeds total archive capacity')
|
|
174
|
+
}
|
|
132
175
|
await output.close()
|
|
133
176
|
output = null
|
|
134
177
|
|
|
135
178
|
await rename(temporaryPath, allocation.finalPath)
|
|
136
179
|
temporaryPath = null
|
|
137
180
|
await chmod(allocation.finalPath, 0o600)
|
|
181
|
+
await pruneToCapacity(logsDir, allocation.finalPath)
|
|
138
182
|
return { ok: true, status: 'archived', path: allocation.finalPath }
|
|
139
183
|
} catch (error) {
|
|
140
184
|
const cleanupErrors = await cleanupTemp(output, temporaryPath)
|
|
@@ -334,10 +378,7 @@ async function pruneByAgeAndRemoveStalePartials(logsDir: string, ageCutoff: numb
|
|
|
334
378
|
}
|
|
335
379
|
}
|
|
336
380
|
|
|
337
|
-
async function pruneToCapacity(logsDir: string,
|
|
338
|
-
if (incomingSize > MAX_DOCKER_LOG_ARCHIVE_TOTAL_BYTES) {
|
|
339
|
-
throw new Error('Docker log archive exceeds total archive capacity')
|
|
340
|
-
}
|
|
381
|
+
async function pruneToCapacity(logsDir: string, publishedPath: string): Promise<void> {
|
|
341
382
|
const snapshots: Array<{ name: string; path: string; size: number; timestamp: number }> = []
|
|
342
383
|
for (const entry of await collectDirectoryEntries(logsDir)) {
|
|
343
384
|
if (!entry.isFile()) continue
|
|
@@ -351,11 +392,8 @@ async function pruneToCapacity(logsDir: string, incomingSize: number): Promise<v
|
|
|
351
392
|
let totalBytes = snapshots.reduce((total, snapshot) => total + snapshot.size, 0)
|
|
352
393
|
let count = snapshots.length
|
|
353
394
|
for (const snapshot of snapshots) {
|
|
354
|
-
if (
|
|
355
|
-
|
|
356
|
-
totalBytes + incomingSize <= MAX_DOCKER_LOG_ARCHIVE_TOTAL_BYTES
|
|
357
|
-
)
|
|
358
|
-
break
|
|
395
|
+
if (count <= MAX_DOCKER_LOG_ARCHIVE_SNAPSHOTS && totalBytes <= MAX_DOCKER_LOG_ARCHIVE_TOTAL_BYTES) break
|
|
396
|
+
if (snapshot.path === publishedPath) continue
|
|
359
397
|
await removeRaceSafe(snapshot.path)
|
|
360
398
|
count -= 1
|
|
361
399
|
totalBytes -= snapshot.size
|
|
@@ -14,7 +14,7 @@ export const DEFAULT_CONTAINER_MEMORY_BYTES = 6 * BYTES_PER_GIB
|
|
|
14
14
|
// Memory left to the Docker VM itself (dockerd, containerd, the guest kernel,
|
|
15
15
|
// page cache) when the default does not fit. Without it a single agent sized to
|
|
16
16
|
// the whole machine reproduces the exhaustion this limit exists to prevent.
|
|
17
|
-
const HOST_HEADROOM_BYTES = 2 * BYTES_PER_GIB
|
|
17
|
+
export const HOST_HEADROOM_BYTES = 2 * BYTES_PER_GIB
|
|
18
18
|
|
|
19
19
|
// Below this a container cannot boot the agent at all, so clamping further down
|
|
20
20
|
// would trade a slow host for an agent that never starts.
|
|
@@ -1,4 +1,5 @@
|
|
|
1
1
|
import { COMPOSE_PROJECT } from './compose-project'
|
|
2
|
+
import { HOST_HEADROOM_BYTES, readDockerTotalMemory } from './memory-limit'
|
|
2
3
|
import type { DockerExec } from './shared'
|
|
3
4
|
|
|
4
5
|
// `bytes: null` means the container runs with NO memory limit. That is a
|
|
@@ -33,7 +34,8 @@ export type OversubscriptionWarning = {
|
|
|
33
34
|
// crowded host. The operator gets the arithmetic and decides.
|
|
34
35
|
export function decideMemoryOversubscription(options: {
|
|
35
36
|
running: AgentMemoryClaim[]
|
|
36
|
-
|
|
37
|
+
// Omitted for a fleet-wide check run after every agent is already up.
|
|
38
|
+
incoming?: AgentMemoryClaim
|
|
37
39
|
totalMemoryBytes: number | undefined
|
|
38
40
|
}): OversubscriptionWarning | null {
|
|
39
41
|
const { running, incoming, totalMemoryBytes } = options
|
|
@@ -41,8 +43,10 @@ export function decideMemoryOversubscription(options: {
|
|
|
41
43
|
// A restart re-runs start for a container that is already listed, so drop any
|
|
42
44
|
// running claim under the incoming name before summing. Counting it twice
|
|
43
45
|
// would fire the warning on a plain `typeclaw restart` of a single agent.
|
|
44
|
-
const
|
|
45
|
-
|
|
46
|
+
const claims =
|
|
47
|
+
incoming === undefined
|
|
48
|
+
? running
|
|
49
|
+
: [...running.filter((claim) => claim.containerName !== incoming.containerName), incoming]
|
|
46
50
|
const unbounded = claims.filter((claim) => claim.bytes === null)
|
|
47
51
|
const claimedBytes = claims.reduce((sum, claim) => sum + (claim.bytes ?? 0), 0)
|
|
48
52
|
|
|
@@ -63,9 +67,10 @@ export function decideMemoryOversubscription(options: {
|
|
|
63
67
|
|
|
64
68
|
export function formatOversubscriptionWarning(warning: OversubscriptionWarning): string[] {
|
|
65
69
|
const gib = (bytes: number): string => `${(bytes / (1024 * 1024 * 1024)).toFixed(1)}GiB`
|
|
70
|
+
const width = warning.claims.reduce((w, claim) => Math.max(w, claim.containerName.length), 0)
|
|
66
71
|
const roster = warning.claims
|
|
67
|
-
.
|
|
68
|
-
.
|
|
72
|
+
.toSorted((a, b) => a.containerName.localeCompare(b.containerName))
|
|
73
|
+
.map((claim) => ` ${claim.containerName.padEnd(width)} ${claim.bytes === null ? 'unlimited' : gib(claim.bytes)}`)
|
|
69
74
|
|
|
70
75
|
const capacity = warning.totalMemoryBytes === null ? null : gib(warning.totalMemoryBytes)
|
|
71
76
|
const names = warning.unbounded.map((claim) => claim.containerName).join(', ')
|
|
@@ -78,11 +83,36 @@ export function formatOversubscriptionWarning(warning: OversubscriptionWarning):
|
|
|
78
83
|
const remedy =
|
|
79
84
|
warning.unbounded.length > 0
|
|
80
85
|
? ['An unbounded agent can exhaust the host on its own. Restart it to apply', 'the current limit.']
|
|
81
|
-
:
|
|
86
|
+
: oversubscriptionRemedy(warning.claimedBytes)
|
|
82
87
|
|
|
83
88
|
return [headline, ...roster, ...remedy]
|
|
84
89
|
}
|
|
85
90
|
|
|
91
|
+
function oversubscriptionRemedy(claimedBytes: number): string[] {
|
|
92
|
+
const targetGib = Math.ceil((claimedBytes + HOST_HEADROOM_BYTES) / (1024 * 1024 * 1024))
|
|
93
|
+
return [
|
|
94
|
+
'If they peak together the host can still exhaust. Either:',
|
|
95
|
+
' • Stop an agent: run `typeclaw stop` in its folder.',
|
|
96
|
+
` • Give Docker at least ${targetGib}GiB of memory, then restart the runtime:`,
|
|
97
|
+
' Docker Desktop: Settings → Resources → Memory limit → Apply & restart',
|
|
98
|
+
` OrbStack: orb config set memory_mib ${targetGib * 1024}`,
|
|
99
|
+
` Colima: colima stop && colima start --memory ${targetGib}`,
|
|
100
|
+
' Linux Engine: Docker uses host RAM directly; stop an agent instead.',
|
|
101
|
+
]
|
|
102
|
+
}
|
|
103
|
+
|
|
104
|
+
// Fleet-wide variant for `typeclaw compose`: agents start concurrently, so a
|
|
105
|
+
// per-agent check sees whichever siblings happened to be up and repeats the same
|
|
106
|
+
// advice once per agent. Checking once after the whole fleet settled reports the
|
|
107
|
+
// real total exactly once.
|
|
108
|
+
export async function readFleetMemoryOversubscription(exec: DockerExec): Promise<OversubscriptionWarning | null> {
|
|
109
|
+
const [running, totalMemoryBytes] = await Promise.all([
|
|
110
|
+
readRunningAgentMemoryClaims(exec),
|
|
111
|
+
readDockerTotalMemory(exec),
|
|
112
|
+
])
|
|
113
|
+
return decideMemoryOversubscription({ running, totalMemoryBytes })
|
|
114
|
+
}
|
|
115
|
+
|
|
86
116
|
// Reads the memory cap Docker actually applied to every running agent. Docker
|
|
87
117
|
// reports 0 for a container created with no limit, which is UNLIMITED, not
|
|
88
118
|
// missing — an agent started before this field existed is precisely the case
|
|
@@ -0,0 +1,86 @@
|
|
|
1
|
+
import { readFileSync } from 'node:fs'
|
|
2
|
+
|
|
3
|
+
export type OomEventCounts = { oom: number; oomKill: number }
|
|
4
|
+
export type OomEventsReader = () => OomEventCounts | null
|
|
5
|
+
|
|
6
|
+
// Docker's private cgroup namespace exposes its own v2 root here. Cgroup v1,
|
|
7
|
+
// dev hosts and unreadable/malformed files provide no reliable pair: fail open.
|
|
8
|
+
export function readOomEvents(path = '/sys/fs/cgroup/memory.events'): OomEventCounts | null {
|
|
9
|
+
try {
|
|
10
|
+
const events = readFileSync(path, 'utf8')
|
|
11
|
+
const oom = /^oom (\d+)$/m.exec(events)
|
|
12
|
+
const oomKill = /^oom_kill (\d+)$/m.exec(events)
|
|
13
|
+
if (oom === null || oomKill === null) return null
|
|
14
|
+
const counts = { oom: Number(oom[1]), oomKill: Number(oomKill[1]) }
|
|
15
|
+
return Number.isSafeInteger(counts.oom) && Number.isSafeInteger(counts.oomKill) ? counts : null
|
|
16
|
+
} catch {
|
|
17
|
+
return null
|
|
18
|
+
}
|
|
19
|
+
}
|
|
20
|
+
|
|
21
|
+
export function readMemoryLimitMiB(path = '/sys/fs/cgroup/memory.max'): number | null {
|
|
22
|
+
try {
|
|
23
|
+
const bytes = readFileSync(path, 'utf8').trim()
|
|
24
|
+
if (!/^\d+$/.test(bytes)) return null
|
|
25
|
+
const value = Number(bytes)
|
|
26
|
+
return Number.isSafeInteger(value) ? Math.round(value / 1048576) : null
|
|
27
|
+
} catch {
|
|
28
|
+
return null
|
|
29
|
+
}
|
|
30
|
+
}
|
|
31
|
+
|
|
32
|
+
const claimedCounts = new Map<number, string>()
|
|
33
|
+
const reportedCounts = new Set<number>()
|
|
34
|
+
|
|
35
|
+
// memory.events is CONTAINER-wide: a concurrent unrelated OOM may increase
|
|
36
|
+
// either counter during this command. A limit event plus kill is evidence of
|
|
37
|
+
// container pressure, not proof that the observed child was the victim.
|
|
38
|
+
export function toolOomNote(
|
|
39
|
+
before: OomEventCounts | null,
|
|
40
|
+
exitCode: number,
|
|
41
|
+
tool: string,
|
|
42
|
+
options: { read?: OomEventsReader; limitMiB?: () => number | null; log?: (line: string) => void } = {},
|
|
43
|
+
): string | null {
|
|
44
|
+
if (exitCode !== 137 || before === null) return null
|
|
45
|
+
const after = (options.read ?? readOomEvents)()
|
|
46
|
+
if (after === null || after.oomKill <= before.oomKill) return null
|
|
47
|
+
// Only a single new event can be claimed unambiguously. A sampler may
|
|
48
|
+
// already have logged it before this command's stdout finished draining.
|
|
49
|
+
if (after.oomKill === before.oomKill + 1) claimedCounts.set(after.oomKill, tool)
|
|
50
|
+
const limit = (options.limitMiB ?? readMemoryLimitMiB)()
|
|
51
|
+
const reachedLimit = after.oom > before.oom
|
|
52
|
+
const detail = reachedLimit
|
|
53
|
+
? `the container reached its memory limit${limit === null ? '' : ` (${limit} MiB)`}`
|
|
54
|
+
: `without a container memory-limit event${limit === null ? '' : ` (configured limit ${limit} MiB)`}`
|
|
55
|
+
if (!reportedCounts.has(after.oomKill)) {
|
|
56
|
+
options.log?.(`[tool] ${tool} subprocess SIGKILL; OOM kill observed while command ran; ${detail}`)
|
|
57
|
+
}
|
|
58
|
+
return `An OOM kill was observed while this command ran (exit 137); ${detail}. Reduce parallelism or memory use before retrying.`
|
|
59
|
+
}
|
|
60
|
+
|
|
61
|
+
export function unclaimedOomEvents(
|
|
62
|
+
previous: OomEventCounts,
|
|
63
|
+
current: OomEventCounts,
|
|
64
|
+
): { from: number; to: number; claimed: string[]; reachedLimit: boolean } | null {
|
|
65
|
+
if (current.oomKill <= previous.oomKill) return null
|
|
66
|
+
const claimed: string[] = []
|
|
67
|
+
let unclaimed = false
|
|
68
|
+
for (let count = previous.oomKill + 1; count <= current.oomKill; count++) {
|
|
69
|
+
const tool = claimedCounts.get(count)
|
|
70
|
+
if (tool === undefined) {
|
|
71
|
+
unclaimed = true
|
|
72
|
+
reportedCounts.add(count)
|
|
73
|
+
} else {
|
|
74
|
+
claimed.push(tool)
|
|
75
|
+
}
|
|
76
|
+
claimedCounts.delete(count)
|
|
77
|
+
}
|
|
78
|
+
// Retain a bounded window for a late tool completion after the sampler's
|
|
79
|
+
// tick. Its model note still arrives, but the operator need not see two lines.
|
|
80
|
+
for (const count of reportedCounts) {
|
|
81
|
+
if (count < current.oomKill - 64) reportedCounts.delete(count)
|
|
82
|
+
}
|
|
83
|
+
return unclaimed
|
|
84
|
+
? { from: previous.oomKill, to: current.oomKill, claimed, reachedLimit: current.oom > previous.oom }
|
|
85
|
+
: null
|
|
86
|
+
}
|
package/src/container/restart.ts
CHANGED
|
@@ -8,6 +8,7 @@ export type RestartOptions = {
|
|
|
8
8
|
forceBuild?: boolean
|
|
9
9
|
streamOutput?: boolean
|
|
10
10
|
onWarning?: (warning: string) => void
|
|
11
|
+
skipMemoryOversubscriptionCheck?: boolean
|
|
11
12
|
cliEntry?: string
|
|
12
13
|
reuseCurrentHostDaemon?: boolean
|
|
13
14
|
currentHostDaemon?: CurrentHostDaemon
|
|
@@ -53,6 +54,7 @@ async function restartWithLease(
|
|
|
53
54
|
forceBuild: options.forceBuild,
|
|
54
55
|
streamOutput: options.streamOutput,
|
|
55
56
|
onWarning: options.onWarning,
|
|
57
|
+
skipMemoryOversubscriptionCheck: options.skipMemoryOversubscriptionCheck,
|
|
56
58
|
cliEntry: options.cliEntry,
|
|
57
59
|
reuseCurrentHostDaemon: options.reuseCurrentHostDaemon,
|
|
58
60
|
currentHostDaemon: options.currentHostDaemon,
|
package/src/container/shared.ts
CHANGED
|
@@ -536,12 +536,19 @@ export async function cleanupRunCorpse(
|
|
|
536
536
|
// `docker run --name <same>` to succeed — Docker's name-reservation table
|
|
537
537
|
// drains independently. waitForRemoval is the fast path; the retry on
|
|
538
538
|
// `docker run` (see isContainerNameConflict) is the safety net.
|
|
539
|
+
//
|
|
540
|
+
// The budget is generous because a draining removal is normal, not stuck:
|
|
541
|
+
// OrbStack has been observed taking ~40s to destroy agents with large
|
|
542
|
+
// writable layers. Timing out early makes `compose restart` report a healthy
|
|
543
|
+
// drain as stuck and tell the operator to restart Docker for nothing.
|
|
544
|
+
export const CONTAINER_REMOVAL_TIMEOUT_MS = 120_000
|
|
545
|
+
|
|
539
546
|
export async function waitForRemoval(
|
|
540
547
|
exec: DockerExec,
|
|
541
548
|
name: string,
|
|
542
549
|
options: { timeoutMs?: number; intervalMs?: number } = {},
|
|
543
550
|
): Promise<boolean> {
|
|
544
|
-
const timeoutMs = options.timeoutMs ??
|
|
551
|
+
const timeoutMs = options.timeoutMs ?? CONTAINER_REMOVAL_TIMEOUT_MS
|
|
545
552
|
const intervalMs = options.intervalMs ?? 100
|
|
546
553
|
const deadline = Date.now() + timeoutMs
|
|
547
554
|
while (Date.now() < deadline) {
|