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
|
@@ -0,0 +1,231 @@
|
|
|
1
|
+
import { timingSafeEqual } from 'node:crypto'
|
|
2
|
+
import { connect, createServer, type Server, type Socket } from 'node:net'
|
|
3
|
+
|
|
4
|
+
// The managed Chrome runs in a network-isolated sandbox, so its DevTools port
|
|
5
|
+
// is unreachable from model bash. This relay is the only path in: a loopback
|
|
6
|
+
// TCP listener that admits a connection only when its first HTTP request
|
|
7
|
+
// carries the session token, then forwards it to Chrome's DevTools socket.
|
|
8
|
+
// The token reaches bash only for roles holding `browser.shared`, so a
|
|
9
|
+
// lower-privilege session cannot drive pages another role is logged into.
|
|
10
|
+
|
|
11
|
+
const MAX_HEAD_BYTES = 64 * 1024
|
|
12
|
+
const BROWSER_PATH = /^\/devtools\/browser\/[^/?#]*/
|
|
13
|
+
|
|
14
|
+
export type CdpRelayOptions = {
|
|
15
|
+
token: string
|
|
16
|
+
// Unix socket bridged to Chrome's private DevTools port.
|
|
17
|
+
upstreamSocket: string
|
|
18
|
+
host?: string
|
|
19
|
+
port?: number
|
|
20
|
+
}
|
|
21
|
+
|
|
22
|
+
export type CdpRelay = {
|
|
23
|
+
port: number
|
|
24
|
+
close: () => Promise<void>
|
|
25
|
+
}
|
|
26
|
+
|
|
27
|
+
export async function startCdpRelay(options: CdpRelayOptions): Promise<CdpRelay> {
|
|
28
|
+
const host = options.host ?? '127.0.0.1'
|
|
29
|
+
const server = createServer((client) => handleClient(client, options, host, server))
|
|
30
|
+
await new Promise<void>((resolve, reject) => {
|
|
31
|
+
server.once('error', reject)
|
|
32
|
+
server.listen(options.port ?? 0, host, () => resolve())
|
|
33
|
+
})
|
|
34
|
+
const address = server.address()
|
|
35
|
+
if (address === null || typeof address === 'string') throw new Error('CDP relay did not bind a TCP port')
|
|
36
|
+
return { port: address.port, close: () => closeServer(server) }
|
|
37
|
+
}
|
|
38
|
+
|
|
39
|
+
export function cdpWebSocketUrl(port: number, token: string): string {
|
|
40
|
+
return `ws://127.0.0.1:${port}/devtools/browser/typeclaw?token=${encodeURIComponent(token)}`
|
|
41
|
+
}
|
|
42
|
+
|
|
43
|
+
function handleClient(client: Socket, options: CdpRelayOptions, host: string, server: Server): void {
|
|
44
|
+
let buffered = Buffer.alloc(0)
|
|
45
|
+
const onData = (chunk: Buffer): void => {
|
|
46
|
+
buffered = Buffer.concat([buffered, chunk])
|
|
47
|
+
const headEnd = buffered.indexOf('\r\n\r\n')
|
|
48
|
+
if (headEnd === -1) {
|
|
49
|
+
if (buffered.length > MAX_HEAD_BYTES) client.destroy()
|
|
50
|
+
return
|
|
51
|
+
}
|
|
52
|
+
client.off('data', onData)
|
|
53
|
+
client.pause()
|
|
54
|
+
const head = buffered.subarray(0, headEnd).toString('latin1')
|
|
55
|
+
const rest = buffered.subarray(headEnd + 4)
|
|
56
|
+
const request = parseHead(head)
|
|
57
|
+
if (request === null || !tokenMatches(request.token, options.token)) {
|
|
58
|
+
client.end('HTTP/1.1 401 Unauthorized\r\nContent-Length: 0\r\nConnection: close\r\n\r\n')
|
|
59
|
+
return
|
|
60
|
+
}
|
|
61
|
+
const relayPort = (server.address() as { port: number }).port
|
|
62
|
+
if (request.isUpgrade) {
|
|
63
|
+
pipeUpgrade(client, options.upstreamSocket, request, rest)
|
|
64
|
+
} else {
|
|
65
|
+
void answerDiscovery(client, options, request.path, `${host}:${relayPort}`)
|
|
66
|
+
}
|
|
67
|
+
}
|
|
68
|
+
client.on('data', onData)
|
|
69
|
+
client.on('error', () => client.destroy())
|
|
70
|
+
}
|
|
71
|
+
|
|
72
|
+
type ParsedHead = {
|
|
73
|
+
method: string
|
|
74
|
+
path: string
|
|
75
|
+
token: string | undefined
|
|
76
|
+
isUpgrade: boolean
|
|
77
|
+
headerLines: string[]
|
|
78
|
+
}
|
|
79
|
+
|
|
80
|
+
function parseHead(head: string): ParsedHead | null {
|
|
81
|
+
const [requestLine, ...headerLines] = head.split('\r\n')
|
|
82
|
+
const match = /^([A-Z]+) (\S+) HTTP\/1\.[01]$/.exec(requestLine ?? '')
|
|
83
|
+
if (match === null) return null
|
|
84
|
+
let url: URL
|
|
85
|
+
try {
|
|
86
|
+
url = new URL(match[2]!, 'http://relay.invalid')
|
|
87
|
+
} catch {
|
|
88
|
+
return null
|
|
89
|
+
}
|
|
90
|
+
const queryToken = url.searchParams.get('token') ?? undefined
|
|
91
|
+
url.searchParams.delete('token')
|
|
92
|
+
const authorization = headerLines
|
|
93
|
+
.find((line) => line.toLowerCase().startsWith('authorization:'))
|
|
94
|
+
?.slice('authorization:'.length)
|
|
95
|
+
.trim()
|
|
96
|
+
const headerToken = authorization?.toLowerCase().startsWith('bearer ') ? authorization.slice(7).trim() : undefined
|
|
97
|
+
const isUpgrade = headerLines.some((line) => /^upgrade:\s*websocket\s*$/i.test(line))
|
|
98
|
+
return {
|
|
99
|
+
method: match[1]!,
|
|
100
|
+
path: `${url.pathname}${url.search}`,
|
|
101
|
+
token: queryToken ?? headerToken,
|
|
102
|
+
isUpgrade,
|
|
103
|
+
headerLines: headerLines.filter((line) => !line.toLowerCase().startsWith('authorization:')),
|
|
104
|
+
}
|
|
105
|
+
}
|
|
106
|
+
|
|
107
|
+
function tokenMatches(candidate: string | undefined, expected: string): boolean {
|
|
108
|
+
if (candidate === undefined) return false
|
|
109
|
+
const a = Buffer.from(candidate)
|
|
110
|
+
const b = Buffer.from(expected)
|
|
111
|
+
return a.length === b.length && timingSafeEqual(a, b)
|
|
112
|
+
}
|
|
113
|
+
|
|
114
|
+
// Chrome's browser target id changes on every launch, so clients connect to a
|
|
115
|
+
// stable `/devtools/browser/<anything>` path and the relay substitutes the
|
|
116
|
+
// live id discovered from Chrome itself.
|
|
117
|
+
function pipeUpgrade(client: Socket, upstreamSocket: string, request: ParsedHead, rest: Buffer): void {
|
|
118
|
+
void resolveBrowserPath(upstreamSocket, request.path).then(
|
|
119
|
+
(path) => {
|
|
120
|
+
const upstream = connect(upstreamSocket)
|
|
121
|
+
upstream.on('connect', () => {
|
|
122
|
+
upstream.write(`${request.method} ${path} HTTP/1.1\r\n${request.headerLines.join('\r\n')}\r\n\r\n`)
|
|
123
|
+
if (rest.length > 0) upstream.write(rest)
|
|
124
|
+
client.pipe(upstream)
|
|
125
|
+
upstream.pipe(client)
|
|
126
|
+
client.resume()
|
|
127
|
+
})
|
|
128
|
+
upstream.on('error', () => client.destroy())
|
|
129
|
+
upstream.on('close', () => client.destroy())
|
|
130
|
+
client.on('close', () => upstream.destroy())
|
|
131
|
+
},
|
|
132
|
+
() => client.end('HTTP/1.1 502 Bad Gateway\r\nContent-Length: 0\r\nConnection: close\r\n\r\n'),
|
|
133
|
+
)
|
|
134
|
+
}
|
|
135
|
+
|
|
136
|
+
async function resolveBrowserPath(upstreamSocket: string, path: string): Promise<string> {
|
|
137
|
+
if (!BROWSER_PATH.test(path)) return path
|
|
138
|
+
const version = (await fetchUpstreamJson(upstreamSocket, '/json/version')) as { webSocketDebuggerUrl?: string }
|
|
139
|
+
const live = version.webSocketDebuggerUrl === undefined ? undefined : new URL(version.webSocketDebuggerUrl).pathname
|
|
140
|
+
if (live === undefined) throw new Error('Chrome did not report a browser target')
|
|
141
|
+
return path.replace(BROWSER_PATH, live)
|
|
142
|
+
}
|
|
143
|
+
|
|
144
|
+
// `/json/*` answers embed Chrome's private `127.0.0.1:9222`; rewrite them to
|
|
145
|
+
// the relay (with the token) so a client that discovers over HTTP reconnects
|
|
146
|
+
// through the relay instead of to an address it cannot reach.
|
|
147
|
+
async function answerDiscovery(client: Socket, options: CdpRelayOptions, path: string, relayHost: string) {
|
|
148
|
+
try {
|
|
149
|
+
const body = await fetchUpstreamText(options.upstreamSocket, path)
|
|
150
|
+
const rewritten = body.replace(
|
|
151
|
+
/ws:\/\/[^/"]+(\/devtools\/[^"]+)/g,
|
|
152
|
+
(_all, devtoolsPath: string) => `ws://${relayHost}${devtoolsPath}?token=${encodeURIComponent(options.token)}`,
|
|
153
|
+
)
|
|
154
|
+
const bytes = Buffer.from(rewritten)
|
|
155
|
+
client.write(
|
|
156
|
+
`HTTP/1.1 200 OK\r\nContent-Type: application/json; charset=UTF-8\r\nContent-Length: ${bytes.length}\r\nConnection: close\r\n\r\n`,
|
|
157
|
+
)
|
|
158
|
+
client.end(bytes)
|
|
159
|
+
} catch {
|
|
160
|
+
client.end('HTTP/1.1 502 Bad Gateway\r\nContent-Length: 0\r\nConnection: close\r\n\r\n')
|
|
161
|
+
}
|
|
162
|
+
}
|
|
163
|
+
|
|
164
|
+
async function fetchUpstreamJson(upstreamSocket: string, path: string): Promise<unknown> {
|
|
165
|
+
return JSON.parse(await fetchUpstreamText(upstreamSocket, path)) as unknown
|
|
166
|
+
}
|
|
167
|
+
|
|
168
|
+
async function fetchUpstreamText(upstreamSocket: string, path: string): Promise<string> {
|
|
169
|
+
const response = await fetch(`http://127.0.0.1${path}`, { unix: upstreamSocket } as RequestInit)
|
|
170
|
+
if (!response.ok) throw new Error(`DevTools answered ${response.status} for ${path}`)
|
|
171
|
+
return response.text()
|
|
172
|
+
}
|
|
173
|
+
|
|
174
|
+
// Token-gated raw byte relay for the BrowserSkill daemon socket: the client
|
|
175
|
+
// sends the token and a newline, then speaks the daemon's own protocol. A
|
|
176
|
+
// `<token> describe` line instead returns `describe()` (the daemon's
|
|
177
|
+
// daemon.json, which the CLI cross-checks against the IPC daemon's pid).
|
|
178
|
+
export async function startTokenStreamRelay(options: {
|
|
179
|
+
token: string
|
|
180
|
+
upstreamSocket: string
|
|
181
|
+
describe?: () => Promise<string>
|
|
182
|
+
}): Promise<CdpRelay> {
|
|
183
|
+
const server = createServer((client) => {
|
|
184
|
+
let buffered = Buffer.alloc(0)
|
|
185
|
+
const onData = (chunk: Buffer): void => {
|
|
186
|
+
buffered = Buffer.concat([buffered, chunk])
|
|
187
|
+
const newline = buffered.indexOf('\n')
|
|
188
|
+
if (newline === -1) {
|
|
189
|
+
if (buffered.length > 1024) client.destroy()
|
|
190
|
+
return
|
|
191
|
+
}
|
|
192
|
+
client.off('data', onData)
|
|
193
|
+
client.pause()
|
|
194
|
+
const [candidate, verb] = buffered.subarray(0, newline).toString('latin1').split(' ')
|
|
195
|
+
if (!tokenMatches(candidate, options.token)) {
|
|
196
|
+
client.destroy()
|
|
197
|
+
return
|
|
198
|
+
}
|
|
199
|
+
if (verb === 'describe' && options.describe !== undefined) {
|
|
200
|
+
options.describe().then(
|
|
201
|
+
(text) => client.end(text),
|
|
202
|
+
() => client.destroy(),
|
|
203
|
+
)
|
|
204
|
+
return
|
|
205
|
+
}
|
|
206
|
+
const upstream = connect(options.upstreamSocket)
|
|
207
|
+
upstream.on('connect', () => {
|
|
208
|
+
const rest = buffered.subarray(newline + 1)
|
|
209
|
+
if (rest.length > 0) upstream.write(rest)
|
|
210
|
+
client.pipe(upstream)
|
|
211
|
+
upstream.pipe(client)
|
|
212
|
+
client.resume()
|
|
213
|
+
})
|
|
214
|
+
upstream.on('error', () => client.destroy())
|
|
215
|
+
upstream.on('close', () => client.destroy())
|
|
216
|
+
client.on('close', () => upstream.destroy())
|
|
217
|
+
}
|
|
218
|
+
client.on('data', onData)
|
|
219
|
+
client.on('error', () => client.destroy())
|
|
220
|
+
})
|
|
221
|
+
await new Promise<void>((resolve, reject) => {
|
|
222
|
+
server.once('error', reject)
|
|
223
|
+
server.listen(0, '127.0.0.1', () => resolve())
|
|
224
|
+
})
|
|
225
|
+
const address = server.address() as { port: number }
|
|
226
|
+
return { port: address.port, close: () => closeServer(server) }
|
|
227
|
+
}
|
|
228
|
+
|
|
229
|
+
function closeServer(server: Server): Promise<void> {
|
|
230
|
+
return new Promise((resolve) => server.close(() => resolve()))
|
|
231
|
+
}
|
|
@@ -0,0 +1,167 @@
|
|
|
1
|
+
import { mkdir, readFile, rename, rm, writeFile } from 'node:fs/promises'
|
|
2
|
+
import { connect, createServer, type Socket } from 'node:net'
|
|
3
|
+
import { join } from 'node:path'
|
|
4
|
+
|
|
5
|
+
import { BSK_BIN, BSK_DAEMON_PORT } from './registry'
|
|
6
|
+
|
|
7
|
+
// Runs INSIDE the browser's bwrap sandbox, which has no network namespace of
|
|
8
|
+
// its own beyond loopback and no view of /agent outside the browser files
|
|
9
|
+
// directory. It bridges two filesystem sockets (which cross network
|
|
10
|
+
// namespaces) to the private loopback: egress for Chrome's SOCKS proxy, and the
|
|
11
|
+
// DevTools socket the runtime's token relay dials. Exits when Chrome exits so
|
|
12
|
+
// the runtime supervisor restarts the whole set.
|
|
13
|
+
|
|
14
|
+
export type SandboxEntryConfig = {
|
|
15
|
+
chrome: string
|
|
16
|
+
runDir: string
|
|
17
|
+
profileDir: string
|
|
18
|
+
downloadsDir: string
|
|
19
|
+
extensionDirs: string[]
|
|
20
|
+
// Without an X display (docker.file.xvfb off) Chrome must run headless or it exits at startup.
|
|
21
|
+
headless: boolean
|
|
22
|
+
bsk?: { home: string }
|
|
23
|
+
}
|
|
24
|
+
|
|
25
|
+
const SOCKS_PORT = 1080
|
|
26
|
+
const DEVTOOLS_PORT = 9222
|
|
27
|
+
|
|
28
|
+
export function egressSocket(runDir: string): string {
|
|
29
|
+
return join(runDir, 'egress.sock')
|
|
30
|
+
}
|
|
31
|
+
|
|
32
|
+
export function devtoolsSocket(runDir: string): string {
|
|
33
|
+
return join(runDir, 'devtools.sock')
|
|
34
|
+
}
|
|
35
|
+
|
|
36
|
+
export function chromeArgs(config: SandboxEntryConfig): string[] {
|
|
37
|
+
const args = [
|
|
38
|
+
`--remote-debugging-port=${DEVTOOLS_PORT}`,
|
|
39
|
+
'--remote-debugging-address=127.0.0.1',
|
|
40
|
+
`--user-data-dir=${config.profileDir}`,
|
|
41
|
+
`--proxy-server=socks5://127.0.0.1:${SOCKS_PORT}`,
|
|
42
|
+
// Chromium sends loopback direct by default, which here is the sandbox's own
|
|
43
|
+
// empty loopback; route it through the bridge so container dev servers load.
|
|
44
|
+
// The BrowserSkill daemon is the one service that lives on sandbox loopback.
|
|
45
|
+
`--proxy-bypass-list=<-loopback>;127.0.0.1:${BSK_DAEMON_PORT}`,
|
|
46
|
+
'--no-first-run',
|
|
47
|
+
'--no-default-browser-check',
|
|
48
|
+
'--disable-dev-shm-usage',
|
|
49
|
+
'--window-size=1920,1080',
|
|
50
|
+
]
|
|
51
|
+
if (config.headless) args.push('--headless=new')
|
|
52
|
+
if (config.extensionDirs.length > 0) {
|
|
53
|
+
const list = config.extensionDirs.join(',')
|
|
54
|
+
args.push(`--load-extension=${list}`, `--disable-extensions-except=${list}`)
|
|
55
|
+
}
|
|
56
|
+
args.push('about:blank')
|
|
57
|
+
return args
|
|
58
|
+
}
|
|
59
|
+
|
|
60
|
+
async function main(config: SandboxEntryConfig): Promise<void> {
|
|
61
|
+
await clearSingletonLocks(config.profileDir)
|
|
62
|
+
await writeDownloadPreference(config)
|
|
63
|
+
await rm(devtoolsSocket(config.runDir), { force: true })
|
|
64
|
+
const servers = [
|
|
65
|
+
bridge(`127.0.0.1:${SOCKS_PORT}`, () => connect(egressSocket(config.runDir)), { port: SOCKS_PORT }),
|
|
66
|
+
bridge(devtoolsSocket(config.runDir), () => connect({ host: '127.0.0.1', port: DEVTOOLS_PORT }), {
|
|
67
|
+
path: devtoolsSocket(config.runDir),
|
|
68
|
+
}),
|
|
69
|
+
]
|
|
70
|
+
await Promise.all(servers.map((s) => s.listening))
|
|
71
|
+
|
|
72
|
+
const chrome = Bun.spawn([config.chrome, ...chromeArgs(config)], { stdout: 'ignore', stderr: 'ignore' })
|
|
73
|
+
const bsk =
|
|
74
|
+
config.bsk === undefined
|
|
75
|
+
? undefined
|
|
76
|
+
: Bun.spawn([BSK_BIN, 'daemon', 'start', '--foreground'], {
|
|
77
|
+
env: { ...process.env, BSK_HOME: config.bsk.home, BSK_AUTO_START: '0' },
|
|
78
|
+
stdout: 'ignore',
|
|
79
|
+
stderr: 'ignore',
|
|
80
|
+
})
|
|
81
|
+
const code = await chrome.exited
|
|
82
|
+
bsk?.kill()
|
|
83
|
+
process.exit(code)
|
|
84
|
+
}
|
|
85
|
+
|
|
86
|
+
function bridge(
|
|
87
|
+
label: string,
|
|
88
|
+
dial: () => Socket,
|
|
89
|
+
listen: { port: number } | { path: string },
|
|
90
|
+
): { listening: Promise<void> } {
|
|
91
|
+
const server = createServer((inbound) => {
|
|
92
|
+
const outbound = dial()
|
|
93
|
+
inbound.pipe(outbound)
|
|
94
|
+
outbound.pipe(inbound)
|
|
95
|
+
const close = (): void => {
|
|
96
|
+
inbound.destroy()
|
|
97
|
+
outbound.destroy()
|
|
98
|
+
}
|
|
99
|
+
inbound.on('error', close)
|
|
100
|
+
outbound.on('error', close)
|
|
101
|
+
inbound.on('close', close)
|
|
102
|
+
outbound.on('close', close)
|
|
103
|
+
})
|
|
104
|
+
const listening = new Promise<void>((resolve, reject) => {
|
|
105
|
+
server.once('error', (error) => reject(new Error(`${label}: ${String(error)}`)))
|
|
106
|
+
if ('port' in listen) server.listen(listen.port, '127.0.0.1', () => resolve())
|
|
107
|
+
else server.listen(listen.path, () => resolve())
|
|
108
|
+
})
|
|
109
|
+
return { listening }
|
|
110
|
+
}
|
|
111
|
+
|
|
112
|
+
// Downloads land in the browser files directory, which privileged bash sees at
|
|
113
|
+
// the same path; Chrome's default ~/Downloads would be lost on the sandbox tmpfs.
|
|
114
|
+
// Merged into the persisted Preferences so the rest of the profile's settings survive.
|
|
115
|
+
export async function writeDownloadPreference(config: SandboxEntryConfig): Promise<void> {
|
|
116
|
+
const defaultProfile = join(config.profileDir, 'Default')
|
|
117
|
+
await mkdir(defaultProfile, { recursive: true })
|
|
118
|
+
await mkdir(config.downloadsDir, { recursive: true })
|
|
119
|
+
const file = join(defaultProfile, 'Preferences')
|
|
120
|
+
const existing = await readPreferences(file)
|
|
121
|
+
const preferences = {
|
|
122
|
+
...existing,
|
|
123
|
+
download: { ...asRecord(existing['download']), default_directory: config.downloadsDir, prompt_for_download: false },
|
|
124
|
+
savefile: { ...asRecord(existing['savefile']), default_directory: config.downloadsDir },
|
|
125
|
+
}
|
|
126
|
+
// Same-directory temp + rename: an interrupted boot never leaves a truncated file.
|
|
127
|
+
const temp = `${file}.typeclaw-tmp`
|
|
128
|
+
await writeFile(temp, JSON.stringify(preferences))
|
|
129
|
+
await rename(temp, file)
|
|
130
|
+
}
|
|
131
|
+
|
|
132
|
+
// A malformed file must not keep Chrome down on every boot: set it aside for
|
|
133
|
+
// diagnosis and start from empty preferences.
|
|
134
|
+
async function readPreferences(file: string): Promise<Record<string, unknown>> {
|
|
135
|
+
let text: string
|
|
136
|
+
try {
|
|
137
|
+
text = await readFile(file, 'utf8')
|
|
138
|
+
} catch {
|
|
139
|
+
return {}
|
|
140
|
+
}
|
|
141
|
+
try {
|
|
142
|
+
const parsed: unknown = JSON.parse(text)
|
|
143
|
+
if (parsed !== null && typeof parsed === 'object' && !Array.isArray(parsed))
|
|
144
|
+
return parsed as Record<string, unknown>
|
|
145
|
+
} catch {
|
|
146
|
+
// fall through to quarantine
|
|
147
|
+
}
|
|
148
|
+
await rename(file, `${file}.corrupt-${Date.now()}`).catch(() => {})
|
|
149
|
+
return {}
|
|
150
|
+
}
|
|
151
|
+
|
|
152
|
+
// The profile outlives the container, and Chrome refuses a profile whose lock
|
|
153
|
+
// names another host (every container has a new hostname). Whatever Chrome held
|
|
154
|
+
// it before has exited, since this entry only runs after the previous one did.
|
|
155
|
+
export async function clearSingletonLocks(profileDir: string): Promise<void> {
|
|
156
|
+
await Promise.all(
|
|
157
|
+
['SingletonLock', 'SingletonSocket', 'SingletonCookie'].map((name) => rm(join(profileDir, name), { force: true })),
|
|
158
|
+
)
|
|
159
|
+
}
|
|
160
|
+
|
|
161
|
+
function asRecord(value: unknown): Record<string, unknown> {
|
|
162
|
+
return value !== null && typeof value === 'object' ? (value as Record<string, unknown>) : {}
|
|
163
|
+
}
|
|
164
|
+
|
|
165
|
+
if (import.meta.main) {
|
|
166
|
+
await main(JSON.parse(process.argv[2] ?? '{}') as SandboxEntryConfig)
|
|
167
|
+
}
|
|
@@ -1,5 +1,6 @@
|
|
|
1
1
|
import { join } from 'node:path'
|
|
2
2
|
|
|
3
|
+
import { getConfig } from '@/config'
|
|
3
4
|
import { definePlugin } from '@/plugin'
|
|
4
5
|
import { publishForwardRequest, subscribeForwardResult } from '@/portbroker'
|
|
5
6
|
|
|
@@ -23,6 +24,7 @@ let unsubscribeForwardResult: (() => void) | null = null
|
|
|
23
24
|
|
|
24
25
|
export default definePlugin({
|
|
25
26
|
plugin: async (ctx) => {
|
|
27
|
+
if (!getConfig().browser.engines.includes('agent-browser')) return {}
|
|
26
28
|
requestDashboardForward(ctx.logger)
|
|
27
29
|
|
|
28
30
|
return {
|
|
@@ -38,13 +38,14 @@ If a new prompt arrives while the runner is in flight, the runner finishes its c
|
|
|
38
38
|
|
|
39
39
|
## What it commits
|
|
40
40
|
|
|
41
|
-
The runner
|
|
41
|
+
The runner builds an explicit snapshot from NUL-delimited porcelain status:
|
|
42
42
|
|
|
43
|
-
- **Tracked changes**, including deletions and both rename/copy endpoints,
|
|
43
|
+
- **Tracked changes**, including deletions and both rename/copy endpoints, remain selected even when an endpoint is no longer present on disk. A selected index entry absent from both HEAD and the worktree (including a removed intent-to-add) is cleared from the index instead of committed; excluded `memory/` paths are never touched.
|
|
44
44
|
- **Ordinary untracked paths** are staged only while still present. If one disappears between snapshot and `git add`, the runner re-reads status and retries that same snapshot once without the vanished path; paths discovered during that re-read are never added.
|
|
45
|
-
-
|
|
45
|
+
- **Untracked nested Git repositories** — an untracked non-bare repository outside `sessions/` and `todo/`, i.e. a directory with its own `.git` file or directory such as a linked worktree or a nested clone — are skipped. Staging one would record a `160000` gitlink instead of its contents.
|
|
46
|
+
- **`memory/`** remains excluded. Present **`sessions/` and `todo/`** paths reported by porcelain remain force-added; tracked deletions under those prefixes stay in the ordinary snapshot. The post-message pass selects only porcelain-visible late `sessions/` paths.
|
|
46
47
|
|
|
47
|
-
|
|
48
|
+
The runner stages the selected paths in a temporary private Git index for its diffstat, without exposing backup entries in the shared index while `backup-message` selects a message. Git then commits **only** selected paths against its current HEAD; unrelated staged files and intervening commits stay intact. A post-message status drops deletion paths already committed by another writer, and an already-clean selection returns clean rather than a false failure. Discovery of force-added paths is unchanged: gitignored untracked files omitted by porcelain status are not discovered here, while explicitly staged ignored files remain eligible. The `backup-message` subagent sees a truncated status and private-index diffstat and returns a conventional-ish subject as its final response. Trusted backup code writes that response to an ephemeral tmp file for the runner to consume; the model has no file tools. On any failure the runner falls back to `chore: backup`.
|
|
48
49
|
|
|
49
50
|
## What it pushes
|
|
50
51
|
|
|
@@ -58,7 +59,7 @@ On non-fast-forward rejection (either push shape), the runner runs `git fetch` t
|
|
|
58
59
|
|
|
59
60
|
**Credentials.** The runner spawns `git` directly (not via the `bash` tool), so the `github-cli-auth` plugin's `tool.before` credential injection does **not** fire for it. For **GitHub App auth** the backup plugin mints a per-repo installation token for `origin`'s github.com slug and injects it into the runner's git env via the same `GIT_ASKPASS` helper the bash path uses (token in `TYPECLAW_GIT_TOKEN`, never in argv/config; ssh remotes rewritten to https via `insteadOf`). Classic/fine-grained PATs, SSH-key, and credential-helper setups are left untouched — the runner uses its inherited process env. Non-github origins are never minted for.
|
|
60
61
|
|
|
61
|
-
If any network step fails (rebase conflict, auth failure, network timeout), the runner aborts cleanly and spawns the `backup-diagnose` subagent. That subagent has `bash
|
|
62
|
+
If any network step fails (rebase conflict, auth failure, network timeout), the runner aborts cleanly and spawns the `backup-diagnose` subagent. That subagent has `bash` and `read` tools, returns a short human-readable diagnosis, and trusted backup code appends it to `<agentDir>/sessions/backup-diagnostics.log`. The diagnose subagent is explicitly forbidden from force-pushing or resolving merge conflicts itself.
|
|
62
63
|
|
|
63
64
|
## What it maintains
|
|
64
65
|
|
|
@@ -76,16 +77,16 @@ Because the backup force-commits `sessions/` every idle window, each cycle lands
|
|
|
76
77
|
| Kind | Name | Notes |
|
|
77
78
|
| -------- | ----------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
78
79
|
| Subagent | `backup` | Runner orchestrator. No LLM call — `handler` directly invokes the deterministic `runBackup`. Coalesced per `agentDir`. |
|
|
79
|
-
| Subagent | `backup-message` | Picks commit message from the diff. Has
|
|
80
|
-
| Subagent | `backup-diagnose` | Diagnoses push/rebase failures. Has `bash
|
|
80
|
+
| Subagent | `backup-message` | Picks commit message from the diff. Has no tools; trusted code stores its final response. Coalesced per `agentDir`. |
|
|
81
|
+
| Subagent | `backup-diagnose` | Diagnoses push/rebase failures. Has `bash` and `read`; trusted code appends its final response to the diagnostics log. Coalesced per `agentDir`. |
|
|
81
82
|
| Hook | `session.turn.start` / `.end` | Maintains the active-turn counter. Excludes self-induced turns (the three subagents above) so the backup never gates against itself. |
|
|
82
83
|
| Hook | `session.idle` | Debouncer (idleMs). Resets the timer on every event. On fire, checks the active-turn counter and spawns `backup` if zero. |
|
|
83
84
|
| Hook | `session.end` | Removes the session from the active-turn set on session close. Defensive: if a session ends mid-turn (network drop), `session.turn.end` may not have fired. |
|
|
84
85
|
|
|
85
86
|
## Files on disk
|
|
86
87
|
|
|
87
|
-
- **`<agentDir>/.typeclaw/backup-message.tmp`** — ephemeral. Written by
|
|
88
|
-
- **`<agentDir>/sessions/backup-diagnostics.log`** — append-only log written by `backup-diagnose` when push/rebase fails. Lives under `sessions/` so it gets force-added by the next successful backup. Read this file when investigating why the backup plugin stopped working.
|
|
88
|
+
- **`<agentDir>/.typeclaw/backup-message.tmp`** — ephemeral. Written by trusted backup code, read and then deleted by the runner. The directory is created on demand. Not gitignored because it always cleans itself up before commit.
|
|
89
|
+
- **`<agentDir>/sessions/backup-diagnostics.log`** — append-only log written by trusted backup code from `backup-diagnose`'s final response when push/rebase fails. Lives under `sessions/` so it gets force-added by the next successful backup. Read this file when investigating why the backup plugin stopped working.
|
|
89
90
|
|
|
90
91
|
## Why this design
|
|
91
92
|
|