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,9 @@
|
|
|
1
|
+
import type { PermissionService } from "../permissions/index.js";
|
|
2
|
+
import type { Reloadable } from "../reload/index.js";
|
|
3
|
+
export type CreateConfigReloadableOptions = {
|
|
4
|
+
cwd: string;
|
|
5
|
+
permissions?: PermissionService;
|
|
6
|
+
onRolesChanged?: () => void | Promise<void>;
|
|
7
|
+
skipMountValidation?: boolean;
|
|
8
|
+
};
|
|
9
|
+
export declare function createConfigReloadable({ cwd, permissions, onRolesChanged, skipMountValidation, }: CreateConfigReloadableOptions): Reloadable;
|
|
@@ -0,0 +1,31 @@
|
|
|
1
|
+
export type AgentOperation = 'start' | 'stop' | 'restart' | 'line-auth' | 'instagram-auth';
|
|
2
|
+
export type AgentOperationLease = {
|
|
3
|
+
readonly containerName: string;
|
|
4
|
+
readonly agentDir: string;
|
|
5
|
+
};
|
|
6
|
+
export type AgentOperationReservation = {
|
|
7
|
+
ok: true;
|
|
8
|
+
lease: AgentOperationLease;
|
|
9
|
+
release: () => Promise<void>;
|
|
10
|
+
} | {
|
|
11
|
+
ok: false;
|
|
12
|
+
reason: string;
|
|
13
|
+
};
|
|
14
|
+
export type ReserveAgentOperationLock = (input: {
|
|
15
|
+
agentDir: string;
|
|
16
|
+
operation: AgentOperation;
|
|
17
|
+
}) => Promise<AgentOperationReservation>;
|
|
18
|
+
export type AgentOperationLockResult<T> = {
|
|
19
|
+
ok: true;
|
|
20
|
+
value: T;
|
|
21
|
+
} | {
|
|
22
|
+
ok: false;
|
|
23
|
+
reason: string;
|
|
24
|
+
};
|
|
25
|
+
export type WithAgentOperationLock = <T>(input: {
|
|
26
|
+
agentDir: string;
|
|
27
|
+
operation: AgentOperation;
|
|
28
|
+
lease?: AgentOperationLease;
|
|
29
|
+
}, run: (lease: AgentOperationLease) => Promise<T>) => Promise<AgentOperationLockResult<T>>;
|
|
30
|
+
export declare const withAgentOperationLock: WithAgentOperationLock;
|
|
31
|
+
export declare const reserveAgentOperationLock: ReserveAgentOperationLock;
|
|
@@ -0,0 +1,39 @@
|
|
|
1
|
+
import { type DockerExec } from "./shared.js";
|
|
2
|
+
export type ManagedBuildxBuilder = {
|
|
3
|
+
builderName: string;
|
|
4
|
+
daemonId: string;
|
|
5
|
+
statePath: string;
|
|
6
|
+
env: {
|
|
7
|
+
BUILDX_CONFIG: string;
|
|
8
|
+
};
|
|
9
|
+
};
|
|
10
|
+
export type ManagedBuildCacheLease = {
|
|
11
|
+
builder: ManagedBuildxBuilder;
|
|
12
|
+
cacheRoot: string;
|
|
13
|
+
stagingPath: string;
|
|
14
|
+
cacheArgs: string[];
|
|
15
|
+
finish: (success: boolean) => Promise<{
|
|
16
|
+
warnings: string[];
|
|
17
|
+
}>;
|
|
18
|
+
};
|
|
19
|
+
export type ManagedBuildCacheResult = {
|
|
20
|
+
ok: true;
|
|
21
|
+
lease: ManagedBuildCacheLease;
|
|
22
|
+
warnings: string[];
|
|
23
|
+
} | {
|
|
24
|
+
ok: false;
|
|
25
|
+
reason: string;
|
|
26
|
+
};
|
|
27
|
+
export declare function acquireManagedBuildCache(options: {
|
|
28
|
+
exec: DockerExec;
|
|
29
|
+
cacheScope: string;
|
|
30
|
+
stateDir?: string;
|
|
31
|
+
randomBuilderName?: () => string;
|
|
32
|
+
randomGenerationId?: () => string;
|
|
33
|
+
faultInjection?: {
|
|
34
|
+
removeGeneration?: (path: string) => Promise<void>;
|
|
35
|
+
beforeActivePersist?: () => void | Promise<void>;
|
|
36
|
+
beforeReadyPersist?: () => void | Promise<void>;
|
|
37
|
+
releaseLock?: (release: () => Promise<void>) => Promise<void>;
|
|
38
|
+
};
|
|
39
|
+
}): Promise<ManagedBuildCacheResult>;
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
export declare const COMPOSE_PROJECT = "typeclaw";
|
|
@@ -0,0 +1,25 @@
|
|
|
1
|
+
import { type LogsOptions, type LogsResult } from "./logs.js";
|
|
2
|
+
import { type RestartOptions, type RestartResult } from "./restart.js";
|
|
3
|
+
import { type ShellResult } from "./shell.js";
|
|
4
|
+
import { type StartOptions, type StartResult } from "./start.js";
|
|
5
|
+
import { type ContainerStats, type StatsOptions } from "./stats.js";
|
|
6
|
+
import { type ContainerStatus, type StatusOptions } from "./status.js";
|
|
7
|
+
import { type StopOptions, type StopResult } from "./stop.js";
|
|
8
|
+
export interface Controller {
|
|
9
|
+
start(options: StartOptions): Promise<StartResult>;
|
|
10
|
+
stop(options: StopOptions): Promise<StopResult>;
|
|
11
|
+
restart(options: RestartOptions): Promise<RestartResult>;
|
|
12
|
+
status(options: StatusOptions): Promise<ContainerStatus>;
|
|
13
|
+
stats(options: StatsOptions): Promise<ContainerStats>;
|
|
14
|
+
logs(options: LogsOptions): Promise<LogsResult>;
|
|
15
|
+
shell(options: {
|
|
16
|
+
cwd: string;
|
|
17
|
+
shell?: string;
|
|
18
|
+
}): Promise<ShellResult>;
|
|
19
|
+
}
|
|
20
|
+
export declare function createLocalDockerController(): Controller;
|
|
21
|
+
export declare const CONTROLLER_UNSUPPORTED_REASON = "container lifecycle is managed by the platform; typeclaw has no controller in this profile";
|
|
22
|
+
export declare function createNoopController(): Controller;
|
|
23
|
+
export type DeploymentProfile = 'host' | 'managed';
|
|
24
|
+
export declare function resolveDeploymentProfile(): DeploymentProfile;
|
|
25
|
+
export declare function resolveController(profile?: DeploymentProfile): Controller;
|
|
@@ -0,0 +1,23 @@
|
|
|
1
|
+
import type { DockerAvailability } from "./shared.js";
|
|
2
|
+
export type DockerApp = 'docker-desktop' | 'orbstack' | 'colima' | 'podman';
|
|
3
|
+
export type DockerAppProbes = {
|
|
4
|
+
platform?: NodeJS.Platform;
|
|
5
|
+
exists?: (path: string) => boolean;
|
|
6
|
+
which?: (command: string) => string | null;
|
|
7
|
+
env?: NodeJS.ProcessEnv;
|
|
8
|
+
};
|
|
9
|
+
export declare function dockerAppLabel(app: DockerApp): string;
|
|
10
|
+
export declare function classifyConfiguredRuntime(env: NodeJS.ProcessEnv, detail: string | undefined): DockerApp | null;
|
|
11
|
+
export declare function detectInstalledDockerApps(probes?: DockerAppProbes): DockerApp[];
|
|
12
|
+
export declare function pickRuntimeToNudge(env: NodeJS.ProcessEnv, detail: string | undefined, installed: DockerApp[]): DockerApp | null;
|
|
13
|
+
export declare function renderDockerUnavailableGuidance(availability: Extract<DockerAvailability, {
|
|
14
|
+
ok: false;
|
|
15
|
+
}>, options: {
|
|
16
|
+
platform: NodeJS.Platform;
|
|
17
|
+
nudge: DockerApp | null;
|
|
18
|
+
installed: DockerApp[];
|
|
19
|
+
retryHint?: string;
|
|
20
|
+
}): {
|
|
21
|
+
summary: string;
|
|
22
|
+
lines: string[];
|
|
23
|
+
};
|
|
@@ -0,0 +1,10 @@
|
|
|
1
|
+
import type { DockerExec } from "./shared.js";
|
|
2
|
+
export declare function inspectContainerExit(exec: DockerExec, name: string): Promise<{
|
|
3
|
+
kind: 'running';
|
|
4
|
+
containerId: string;
|
|
5
|
+
} | {
|
|
6
|
+
kind: 'stopped';
|
|
7
|
+
containerId: string;
|
|
8
|
+
finishedAt: string;
|
|
9
|
+
reason: string | null;
|
|
10
|
+
} | null>;
|
|
@@ -0,0 +1,14 @@
|
|
|
1
|
+
export { CONTROLLER_UNSUPPORTED_REASON, type Controller, createLocalDockerController, createNoopController, type DeploymentProfile, resolveController, resolveDeploymentProfile, } from "./controller.js";
|
|
2
|
+
export { classifyConfiguredRuntime, detectInstalledDockerApps, dockerAppLabel, pickRuntimeToNudge, renderDockerUnavailableGuidance, type DockerApp, type DockerAppProbes, } from "./docker-app.js";
|
|
3
|
+
export { buildDockerLogsCmd, logs, parseTailValue, planLogs, type LogsPlan, type LogsResult } from "./logs.js";
|
|
4
|
+
export { CONTAINER_PORT, TUI_TOKEN_LABEL, findFreePort, resolveHostPort, resolveTuiToken } from "./port.js";
|
|
5
|
+
export { requireContainerRunning, type RequireContainerRunningOptions, type RequireContainerRunningResult, } from "./require-running.js";
|
|
6
|
+
export { planShell, shell, type ShellPlan, type ShellResult } from "./shell.js";
|
|
7
|
+
export { parseStatsLine, stats, type ContainerStats, type StatsOptions, type StatsSnapshot } from "./stats.js";
|
|
8
|
+
export { status, type ContainerStatus, type StatusOptions } from "./status.js";
|
|
9
|
+
export { checkDockerAvailable, containerExists, containerNameFromCwd, defaultDockerExec, DOCKER_NOT_FOUND_STDERR, imageTagFromCwd, inspectContainer, sanitizeDockerStderr, type ContainerState, type DockerAvailability, type DockerExec, type DockerExecResult, } from "./shared.js";
|
|
10
|
+
export { planStart, refreshDockerfile, refreshGitignore, start, type CurrentHostDaemon, type HostDaemonRegisterPayload, type HostDaemonStatus, type PlanStartOptions, type StartOptions, type StartPlan, type StartResult, } from "./start.js";
|
|
11
|
+
export { planStop, stop, type StopOptions, type StopPlan, type StopResult } from "./stop.js";
|
|
12
|
+
export { restart, type RestartOptions, type RestartResult } from "./restart.js";
|
|
13
|
+
export { type AgentOperation, type AgentOperationLease, type AgentOperationLockResult, type WithAgentOperationLock, withAgentOperationLock, } from "./agent-operation-lock.js";
|
|
14
|
+
export { formatOversubscriptionWarning, readFleetMemoryOversubscription, type OversubscriptionWarning, } from "./memory-oversubscription.js";
|
|
@@ -0,0 +1,68 @@
|
|
|
1
|
+
import { type FileHandle } from 'node:fs/promises';
|
|
2
|
+
import { type DockerExecResult } from "./shared.js";
|
|
3
|
+
export type DockerLogArchiveResult = {
|
|
4
|
+
ok: true;
|
|
5
|
+
status: 'archived';
|
|
6
|
+
path: string;
|
|
7
|
+
} | {
|
|
8
|
+
ok: false;
|
|
9
|
+
kind: 'unavailable';
|
|
10
|
+
reason: string;
|
|
11
|
+
} | {
|
|
12
|
+
ok: false;
|
|
13
|
+
kind: 'failed';
|
|
14
|
+
reason: string;
|
|
15
|
+
};
|
|
16
|
+
export type DockerLogArchiver = (input: {
|
|
17
|
+
agentDir: string;
|
|
18
|
+
containerId: string;
|
|
19
|
+
retentionDays?: number;
|
|
20
|
+
}) => Promise<DockerLogArchiveResult>;
|
|
21
|
+
export type StreamCaptureInput = {
|
|
22
|
+
args: string[];
|
|
23
|
+
binary: string;
|
|
24
|
+
cwd: string;
|
|
25
|
+
finalSettlementMs?: number;
|
|
26
|
+
killFallbackMs?: number;
|
|
27
|
+
maxBytes: number;
|
|
28
|
+
output: FileHandle;
|
|
29
|
+
spawn?: (input: {
|
|
30
|
+
args: string[];
|
|
31
|
+
binary: string;
|
|
32
|
+
cwd: string;
|
|
33
|
+
}) => StreamingProcess;
|
|
34
|
+
timeoutMs: number;
|
|
35
|
+
writeChunk?: (output: FileHandle, chunk: Uint8Array, offset: number) => Promise<number>;
|
|
36
|
+
writeSettlementMs?: number;
|
|
37
|
+
};
|
|
38
|
+
export type StreamingProcess = {
|
|
39
|
+
exited: Promise<number>;
|
|
40
|
+
kill(signal: NodeJS.Signals): void;
|
|
41
|
+
stderr: ReadableStream<Uint8Array>;
|
|
42
|
+
stdout: ReadableStream<Uint8Array>;
|
|
43
|
+
unref(): void;
|
|
44
|
+
};
|
|
45
|
+
export type StreamCaptureResult = {
|
|
46
|
+
exitCode: number;
|
|
47
|
+
overflowed: boolean;
|
|
48
|
+
stderrExcerpt: string;
|
|
49
|
+
terminationBoundExceeded?: boolean;
|
|
50
|
+
timedOut: boolean;
|
|
51
|
+
};
|
|
52
|
+
export type DockerLogArchiveRuntime = {
|
|
53
|
+
capture?: (input: StreamCaptureInput) => Promise<StreamCaptureResult>;
|
|
54
|
+
inspectLogConfig?: (args: string[], options: {
|
|
55
|
+
cwd: string;
|
|
56
|
+
signal: AbortSignal;
|
|
57
|
+
}) => Promise<DockerExecResult>;
|
|
58
|
+
nonce?: () => string;
|
|
59
|
+
now?: () => Date;
|
|
60
|
+
resolveDockerBinary?: () => string | null;
|
|
61
|
+
};
|
|
62
|
+
export declare const DOCKER_LOG_ARCHIVE_TIMEOUT_MS = 60000;
|
|
63
|
+
export declare const MAX_DOCKER_LOG_ARCHIVE_BYTES: number;
|
|
64
|
+
export declare const MAX_DOCKER_LOG_ARCHIVE_SNAPSHOTS = 512;
|
|
65
|
+
export declare const MAX_DOCKER_LOG_ARCHIVE_TOTAL_BYTES: number;
|
|
66
|
+
export declare function archiveContainerLogs({ agentDir, containerId, retentionDays }: Parameters<DockerLogArchiver>[0], runtime?: DockerLogArchiveRuntime): Promise<DockerLogArchiveResult>;
|
|
67
|
+
export declare function dockerLogsUnavailableWarning(containerId: string): string;
|
|
68
|
+
export declare function streamProcessOutput(input: StreamCaptureInput): Promise<StreamCaptureResult>;
|
|
@@ -0,0 +1,9 @@
|
|
|
1
|
+
export type TimestampReformatter = {
|
|
2
|
+
write: (chunk: string) => string;
|
|
3
|
+
flush: () => string;
|
|
4
|
+
};
|
|
5
|
+
export type ReformatterOptions = {
|
|
6
|
+
color?: boolean;
|
|
7
|
+
};
|
|
8
|
+
export declare function makeLogTimestampReformatter(now?: () => Date, options?: ReformatterOptions): TimestampReformatter;
|
|
9
|
+
export declare function reformatLine(line: string, now?: () => Date): string;
|
|
@@ -0,0 +1,37 @@
|
|
|
1
|
+
import { type TimestampReformatter } from "./log-timestamps.js";
|
|
2
|
+
export type LogsPlan = {
|
|
3
|
+
containerName: string;
|
|
4
|
+
follow: boolean;
|
|
5
|
+
tail?: string;
|
|
6
|
+
};
|
|
7
|
+
export type LogsResult = {
|
|
8
|
+
ok: true;
|
|
9
|
+
containerName: string;
|
|
10
|
+
exitCode: number;
|
|
11
|
+
} | {
|
|
12
|
+
ok: false;
|
|
13
|
+
reason: string;
|
|
14
|
+
};
|
|
15
|
+
export type LogsOptions = {
|
|
16
|
+
cwd: string;
|
|
17
|
+
follow: boolean;
|
|
18
|
+
tail?: string;
|
|
19
|
+
out?: NodeJS.WritableStream;
|
|
20
|
+
err?: NodeJS.WritableStream;
|
|
21
|
+
signal?: AbortSignal;
|
|
22
|
+
useColor?: boolean;
|
|
23
|
+
};
|
|
24
|
+
export declare function logs({ cwd, follow, tail, out, err, signal, useColor, }: LogsOptions): Promise<LogsResult>;
|
|
25
|
+
export declare function planLogs(cwd: string, { follow, tail }: {
|
|
26
|
+
follow: boolean;
|
|
27
|
+
tail?: string;
|
|
28
|
+
}): LogsPlan;
|
|
29
|
+
export declare function parseTailValue(raw: string): {
|
|
30
|
+
ok: true;
|
|
31
|
+
value: string;
|
|
32
|
+
} | {
|
|
33
|
+
ok: false;
|
|
34
|
+
reason: string;
|
|
35
|
+
};
|
|
36
|
+
export declare function buildDockerLogsCmd(plan: LogsPlan, dockerBinary: string): string[];
|
|
37
|
+
export declare function pumpWithTimestamps(stream: ReadableStream<Uint8Array>, sink: NodeJS.WritableStream, reformatter?: TimestampReformatter, signal?: AbortSignal): Promise<void>;
|
|
@@ -0,0 +1,13 @@
|
|
|
1
|
+
import type { DockerExec } from "./shared.js";
|
|
2
|
+
export declare const DEFAULT_CONTAINER_MEMORY_BYTES: number;
|
|
3
|
+
export declare const HOST_HEADROOM_BYTES: number;
|
|
4
|
+
export declare function formatMemorySize(bytes: number): string;
|
|
5
|
+
export type MemoryLimitSource = 'default' | 'clamped';
|
|
6
|
+
export type ResolvedMemoryLimit = {
|
|
7
|
+
bytes: number;
|
|
8
|
+
source: MemoryLimitSource;
|
|
9
|
+
};
|
|
10
|
+
export declare function resolveMemoryLimit(options: {
|
|
11
|
+
totalMemoryBytes?: number | undefined;
|
|
12
|
+
}): ResolvedMemoryLimit;
|
|
13
|
+
export declare function readDockerTotalMemory(exec: DockerExec): Promise<number | undefined>;
|
|
@@ -0,0 +1,20 @@
|
|
|
1
|
+
import type { DockerExec } from "./shared.js";
|
|
2
|
+
export type AgentMemoryClaim = {
|
|
3
|
+
containerName: string;
|
|
4
|
+
bytes: number | null;
|
|
5
|
+
};
|
|
6
|
+
export type OversubscriptionWarning = {
|
|
7
|
+
claims: AgentMemoryClaim[];
|
|
8
|
+
claimedBytes: number;
|
|
9
|
+
totalMemoryBytes: number | null;
|
|
10
|
+
unbounded: AgentMemoryClaim[];
|
|
11
|
+
};
|
|
12
|
+
export declare function decideMemoryOversubscription(options: {
|
|
13
|
+
running: AgentMemoryClaim[];
|
|
14
|
+
incoming?: AgentMemoryClaim;
|
|
15
|
+
totalMemoryBytes: number | undefined;
|
|
16
|
+
}): OversubscriptionWarning | null;
|
|
17
|
+
export declare function formatOversubscriptionWarning(warning: OversubscriptionWarning): string[];
|
|
18
|
+
export declare function readFleetMemoryOversubscription(exec: DockerExec): Promise<OversubscriptionWarning | null>;
|
|
19
|
+
export declare function readRunningAgentMemoryClaims(exec: DockerExec): Promise<AgentMemoryClaim[]>;
|
|
20
|
+
export declare function parseAgentMemoryClaims(output: string): AgentMemoryClaim[];
|
|
@@ -0,0 +1,18 @@
|
|
|
1
|
+
export type OomEventCounts = {
|
|
2
|
+
oom: number;
|
|
3
|
+
oomKill: number;
|
|
4
|
+
};
|
|
5
|
+
export type OomEventsReader = () => OomEventCounts | null;
|
|
6
|
+
export declare function readOomEvents(path?: string): OomEventCounts | null;
|
|
7
|
+
export declare function readMemoryLimitMiB(path?: string): number | null;
|
|
8
|
+
export declare function toolOomNote(before: OomEventCounts | null, exitCode: number, tool: string, options?: {
|
|
9
|
+
read?: OomEventsReader;
|
|
10
|
+
limitMiB?: () => number | null;
|
|
11
|
+
log?: (line: string) => void;
|
|
12
|
+
}): string | null;
|
|
13
|
+
export declare function unclaimedOomEvents(previous: OomEventCounts, current: OomEventCounts): {
|
|
14
|
+
from: number;
|
|
15
|
+
to: number;
|
|
16
|
+
claimed: string[];
|
|
17
|
+
reachedLimit: boolean;
|
|
18
|
+
} | null;
|
|
@@ -0,0 +1,18 @@
|
|
|
1
|
+
import { type DockerExec } from "./shared.js";
|
|
2
|
+
export declare const CONTAINER_PORT = 8973;
|
|
3
|
+
export declare const TUI_TOKEN_LABEL = "dev.typeclaw.tui-token";
|
|
4
|
+
export declare function findFreePort(preferred?: number): Promise<number>;
|
|
5
|
+
export declare function isPortAllocatedError(stderr: string): boolean;
|
|
6
|
+
export type ResolveHostPortOptions = {
|
|
7
|
+
cwd: string;
|
|
8
|
+
exec?: DockerExec;
|
|
9
|
+
retryMs?: number;
|
|
10
|
+
intervalMs?: number;
|
|
11
|
+
fallbackPort?: number;
|
|
12
|
+
};
|
|
13
|
+
export declare function resolveHostPort(options: ResolveHostPortOptions): Promise<number>;
|
|
14
|
+
export declare function resolveTuiToken(options: {
|
|
15
|
+
cwd: string;
|
|
16
|
+
exec?: DockerExec;
|
|
17
|
+
}): Promise<string | null>;
|
|
18
|
+
export declare function parseDockerPortOutput(stdout: string): number | null;
|
|
@@ -0,0 +1,16 @@
|
|
|
1
|
+
import { type ContainerState } from "./shared.js";
|
|
2
|
+
export type RequireContainerRunningResult = {
|
|
3
|
+
ok: true;
|
|
4
|
+
containerName: string;
|
|
5
|
+
} | {
|
|
6
|
+
ok: false;
|
|
7
|
+
reason: string;
|
|
8
|
+
};
|
|
9
|
+
export type RequireContainerRunningOptions = {
|
|
10
|
+
cwd: string;
|
|
11
|
+
};
|
|
12
|
+
type RequireContainerRunningDeps = {
|
|
13
|
+
inspect?: (name: string) => Promise<ContainerState>;
|
|
14
|
+
};
|
|
15
|
+
export declare function requireContainerRunning({ cwd }: RequireContainerRunningOptions, deps?: RequireContainerRunningDeps): Promise<RequireContainerRunningResult>;
|
|
16
|
+
export {};
|
|
@@ -0,0 +1,32 @@
|
|
|
1
|
+
import { type AgentOperationLease, type WithAgentOperationLock } from "./agent-operation-lock.js";
|
|
2
|
+
import { type CurrentHostDaemon, type StartResult } from "./start.js";
|
|
3
|
+
import { type StopResult } from "./stop.js";
|
|
4
|
+
export type RestartOptions = {
|
|
5
|
+
cwd: string;
|
|
6
|
+
preferredHostPort: number;
|
|
7
|
+
forceBuild?: boolean;
|
|
8
|
+
streamOutput?: boolean;
|
|
9
|
+
onWarning?: (warning: string) => void;
|
|
10
|
+
skipMemoryOversubscriptionCheck?: boolean;
|
|
11
|
+
cliEntry?: string;
|
|
12
|
+
reuseCurrentHostDaemon?: boolean;
|
|
13
|
+
currentHostDaemon?: CurrentHostDaemon;
|
|
14
|
+
onStopped?: (result: Extract<StopResult, {
|
|
15
|
+
ok: true;
|
|
16
|
+
}>) => void;
|
|
17
|
+
operationLock?: WithAgentOperationLock;
|
|
18
|
+
operationLease?: AgentOperationLease;
|
|
19
|
+
};
|
|
20
|
+
export type RestartResult = {
|
|
21
|
+
ok: true;
|
|
22
|
+
stop: Extract<StopResult, {
|
|
23
|
+
ok: true;
|
|
24
|
+
}>;
|
|
25
|
+
start: Extract<StartResult, {
|
|
26
|
+
ok: true;
|
|
27
|
+
}>;
|
|
28
|
+
} | {
|
|
29
|
+
ok: false;
|
|
30
|
+
reason: string;
|
|
31
|
+
};
|
|
32
|
+
export declare function restart(options: RestartOptions): Promise<RestartResult>;
|
|
@@ -0,0 +1,93 @@
|
|
|
1
|
+
export type DockerExecResult = {
|
|
2
|
+
exitCode: number;
|
|
3
|
+
stdout: string;
|
|
4
|
+
stderr: string;
|
|
5
|
+
};
|
|
6
|
+
export type DockerExecOptions = {
|
|
7
|
+
cwd?: string;
|
|
8
|
+
inheritStdio?: boolean;
|
|
9
|
+
signal?: AbortSignal;
|
|
10
|
+
env?: Record<string, string | undefined>;
|
|
11
|
+
captureStderr?: boolean;
|
|
12
|
+
captureStdout?: boolean;
|
|
13
|
+
maxCapturedStderrBytes?: number;
|
|
14
|
+
};
|
|
15
|
+
export type DockerExec = (args: string[], options?: DockerExecOptions) => Promise<DockerExecResult>;
|
|
16
|
+
export type ParsedContainerInspect = {
|
|
17
|
+
ok: true;
|
|
18
|
+
containerId: string;
|
|
19
|
+
running: boolean;
|
|
20
|
+
} | {
|
|
21
|
+
ok: false;
|
|
22
|
+
reason: string;
|
|
23
|
+
};
|
|
24
|
+
export declare function parseContainerInspectOutput(output: string): ParsedContainerInspect;
|
|
25
|
+
export declare const defaultDockerExec: DockerExec;
|
|
26
|
+
export declare function readCapturedStream(stream: ReadableStream<Uint8Array>, maxBytes?: number): Promise<string>;
|
|
27
|
+
export declare function spawnInheritTeeStderr(bun: NonNullable<ReturnType<typeof getBun>>, cmd: string[], cwd: string | undefined, signal: AbortSignal | undefined, env: NodeJS.ProcessEnv | undefined): Promise<DockerExecResult>;
|
|
28
|
+
export declare const DOCKER_NOT_FOUND_STDERR = "docker: command not found in $PATH";
|
|
29
|
+
export type DockerBinaryProbes = {
|
|
30
|
+
which?: (command: string) => string | null;
|
|
31
|
+
platform?: NodeJS.Platform;
|
|
32
|
+
env?: NodeJS.ProcessEnv;
|
|
33
|
+
exists?: (path: string) => boolean;
|
|
34
|
+
};
|
|
35
|
+
export declare function resolveDockerBinary(probes?: DockerBinaryProbes): string | null;
|
|
36
|
+
export declare function dockerCmd(args: string[], resolveBinary?: () => string | null): string[] | null;
|
|
37
|
+
export declare function sanitizeDockerStderr(stderr: string): string;
|
|
38
|
+
export type DockerAvailability = {
|
|
39
|
+
ok: true;
|
|
40
|
+
} | {
|
|
41
|
+
ok: false;
|
|
42
|
+
reason: 'binary-missing' | 'daemon-down' | 'unresponsive';
|
|
43
|
+
detail: string;
|
|
44
|
+
};
|
|
45
|
+
export declare const DOCKER_AVAILABILITY_TIMEOUT_MS = 5000;
|
|
46
|
+
export declare function checkDockerAvailable(exec?: DockerExec, timeoutMs?: number): Promise<DockerAvailability>;
|
|
47
|
+
export declare function buildxAvailable(exec?: DockerExec): Promise<boolean>;
|
|
48
|
+
export declare function isMissingDockerCredentialHelper(stderr: string): boolean;
|
|
49
|
+
export declare function dockerConfigDir(env?: NodeJS.ProcessEnv, home?: string): string;
|
|
50
|
+
export declare function sanitizeDockerConfigJson(raw: string | null): string | null;
|
|
51
|
+
export type BindMountSpec = {
|
|
52
|
+
src: string;
|
|
53
|
+
dst: string;
|
|
54
|
+
readonly?: boolean;
|
|
55
|
+
};
|
|
56
|
+
export declare function dockerBindMount({ src, dst, readonly }: BindMountSpec): [string, string];
|
|
57
|
+
export declare function containerNameFromCwd(cwd: string): string;
|
|
58
|
+
export type BenignRmKind = 'gone' | 'in-progress' | null;
|
|
59
|
+
export declare function classifyRmStderr(stderr: string): BenignRmKind;
|
|
60
|
+
export declare function isGenuineMissingContainer(stderr: string): boolean;
|
|
61
|
+
export declare function isContainerNameConflict(stderr: string): boolean;
|
|
62
|
+
export type BeforeContainerRemove = (containerId: string) => Promise<{
|
|
63
|
+
ok: true;
|
|
64
|
+
} | {
|
|
65
|
+
ok: false;
|
|
66
|
+
reason: string;
|
|
67
|
+
}>;
|
|
68
|
+
export type CorpseCleanupOutcome = 'gone' | 'removed' | 'running' | 'stuck' | {
|
|
69
|
+
archiveFailed: string;
|
|
70
|
+
};
|
|
71
|
+
export declare function cleanupRunCorpse(exec: DockerExec, name: string, beforeRemove: BeforeContainerRemove): Promise<CorpseCleanupOutcome>;
|
|
72
|
+
export declare const CONTAINER_REMOVAL_TIMEOUT_MS = 120000;
|
|
73
|
+
export declare function waitForRemoval(exec: DockerExec, name: string, options?: {
|
|
74
|
+
timeoutMs?: number;
|
|
75
|
+
intervalMs?: number;
|
|
76
|
+
}): Promise<boolean>;
|
|
77
|
+
export declare function imageTagFromCwd(cwd: string): string;
|
|
78
|
+
export declare function imageExists(tag: string): Promise<boolean>;
|
|
79
|
+
export declare function containerExists(name: string): Promise<boolean>;
|
|
80
|
+
export type ContainerState = {
|
|
81
|
+
exists: false;
|
|
82
|
+
} | {
|
|
83
|
+
exists: true;
|
|
84
|
+
running: boolean;
|
|
85
|
+
};
|
|
86
|
+
export declare function inspectContainer(name: string, options?: {
|
|
87
|
+
signal?: AbortSignal;
|
|
88
|
+
exec?: DockerExec;
|
|
89
|
+
}): Promise<ContainerState>;
|
|
90
|
+
export declare function getBun(): {
|
|
91
|
+
spawn: typeof Bun.spawn;
|
|
92
|
+
which: typeof Bun.which;
|
|
93
|
+
} | undefined;
|
|
@@ -0,0 +1,35 @@
|
|
|
1
|
+
import { type ContainerState } from "./shared.js";
|
|
2
|
+
export type ShellPlan = {
|
|
3
|
+
containerName: string;
|
|
4
|
+
shell: string;
|
|
5
|
+
};
|
|
6
|
+
export type ShellResult = {
|
|
7
|
+
ok: true;
|
|
8
|
+
containerName: string;
|
|
9
|
+
exitCode: number;
|
|
10
|
+
} | {
|
|
11
|
+
ok: false;
|
|
12
|
+
reason: string;
|
|
13
|
+
};
|
|
14
|
+
type ShellDeps = {
|
|
15
|
+
inspect?: (name: string) => Promise<ContainerState>;
|
|
16
|
+
spawn?: InteractiveSpawn;
|
|
17
|
+
resolveDocker?: () => string | null;
|
|
18
|
+
};
|
|
19
|
+
type InteractiveSpawn = (options: {
|
|
20
|
+
cmd: string[];
|
|
21
|
+
cwd: string;
|
|
22
|
+
stdin: 'inherit';
|
|
23
|
+
stdout: 'inherit';
|
|
24
|
+
stderr: 'inherit';
|
|
25
|
+
}) => {
|
|
26
|
+
exited: Promise<number>;
|
|
27
|
+
};
|
|
28
|
+
export declare function shell({ cwd, shell: shellPath }: {
|
|
29
|
+
cwd: string;
|
|
30
|
+
shell?: string;
|
|
31
|
+
}, deps?: ShellDeps): Promise<ShellResult>;
|
|
32
|
+
export declare function planShell(cwd: string, { shell: shellPath }?: {
|
|
33
|
+
shell?: string;
|
|
34
|
+
}): ShellPlan;
|
|
35
|
+
export {};
|