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,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 {
|
|
@@ -0,0 +1,89 @@
|
|
|
1
|
+
import { join } from 'node:path'
|
|
2
|
+
|
|
3
|
+
import { z } from 'zod'
|
|
4
|
+
|
|
5
|
+
import type { BrowserEngineId, BrowserExtensionId } from '@/browser/registry'
|
|
6
|
+
import { bashTool, findTool, grepTool, lsTool, readTool, type Subagent, writeTool } from '@/plugin'
|
|
7
|
+
|
|
8
|
+
const BUNDLED_PLUGINS_DIR = join(import.meta.dir, '..')
|
|
9
|
+
|
|
10
|
+
export type BrowserDriverId = BrowserEngineId | BrowserExtensionId
|
|
11
|
+
|
|
12
|
+
export type BrowserDrivers = {
|
|
13
|
+
engines: readonly BrowserEngineId[]
|
|
14
|
+
extensions: readonly BrowserExtensionId[]
|
|
15
|
+
}
|
|
16
|
+
|
|
17
|
+
// Mirrors where agent-browser and managed-browser ship each driver's skill.
|
|
18
|
+
export function driverSkillPath(id: BrowserDriverId): string {
|
|
19
|
+
return id === 'agent-browser'
|
|
20
|
+
? join(BUNDLED_PLUGINS_DIR, 'agent-browser', 'skills', 'agent-browser', 'SKILL.md')
|
|
21
|
+
: join(BUNDLED_PLUGINS_DIR, 'managed-browser', 'skills', id, id, 'SKILL.md')
|
|
22
|
+
}
|
|
23
|
+
|
|
24
|
+
export function buildBrowserSystemPrompt({ engines, extensions }: BrowserDrivers): string {
|
|
25
|
+
const skills = [...engines, ...extensions].map((id) => `- \`${id}\` — ${driverSkillPath(id)}`).join('\n')
|
|
26
|
+
return `You are a web-browsing subagent running inside TypeClaw. Your job: drive a real browser to complete one browsing task for the main agent and report what happened.
|
|
27
|
+
|
|
28
|
+
## Your context
|
|
29
|
+
|
|
30
|
+
- The main agent delegates ALL web browsing to you so the page snapshots and screenshots stay out of its context.
|
|
31
|
+
- You do not talk to the user; the main agent does. Your final message is the whole report.
|
|
32
|
+
- You cannot spawn subagents.
|
|
33
|
+
|
|
34
|
+
## How to browse
|
|
35
|
+
|
|
36
|
+
Before your first browser command, read the skill for the driver you will use. Enabled drivers (prefer the first unless the task says otherwise):
|
|
37
|
+
|
|
38
|
+
${skills}
|
|
39
|
+
|
|
40
|
+
Drive the browser with \`bash\`. Use \`write\` only to save requested artifacts (screenshots, extracted data) under \`workspace/\`. Close every browser session you opened before you finish, except one waiting on a human.
|
|
41
|
+
|
|
42
|
+
If a step needs a human (login, 2FA, CAPTCHA, payment confirmation), follow the skill's human-handoff instructions (e.g. start the dashboard), leave that session open, and stop. Report the session name, the dashboard URL or how the user reaches the page, and exactly what the human must do, so the main agent can hand it over and spawn you again to continue in the same session once they are done.
|
|
43
|
+
|
|
44
|
+
## Final report
|
|
45
|
+
|
|
46
|
+
1. **Outcome** — succeeded / partially succeeded / failed, in one sentence.
|
|
47
|
+
2. **Result** — the information or confirmation the task asked for, with the URLs it came from.
|
|
48
|
+
3. **Artifacts** — absolute paths of anything you saved.
|
|
49
|
+
4. **Blockers** — anything that stopped you and what would unblock it, including any session left open for a human.`
|
|
50
|
+
}
|
|
51
|
+
|
|
52
|
+
// `profile` is dropped, not passed through: the browsing tier is fixed (see
|
|
53
|
+
// createBrowserSubagent), so a parent must not move it via a per-spawn `profile`.
|
|
54
|
+
export const browserPayloadSchema = z
|
|
55
|
+
.object({
|
|
56
|
+
requestId: z.string().optional(),
|
|
57
|
+
prompt: z.string().optional(),
|
|
58
|
+
description: z.string().optional(),
|
|
59
|
+
})
|
|
60
|
+
.passthrough()
|
|
61
|
+
.transform(({ profile: _profile, ...rest }) => rest)
|
|
62
|
+
|
|
63
|
+
export type BrowserPayload = z.infer<typeof browserPayloadSchema>
|
|
64
|
+
|
|
65
|
+
// Browser flows (multi-page navigation, form fills) outlast a scout lookup;
|
|
66
|
+
// bound a wedged run so it never blocks the parent forever.
|
|
67
|
+
export const BROWSER_TIMEOUT_MS = 900_000
|
|
68
|
+
|
|
69
|
+
export function createBrowserSubagent(drivers: BrowserDrivers): Subagent<BrowserPayload> {
|
|
70
|
+
return {
|
|
71
|
+
systemPrompt: buildBrowserSystemPrompt(drivers),
|
|
72
|
+
// The deep model at low effort, like omo's deep-low browser lane: strong
|
|
73
|
+
// agentic UI handling without deliberating before every click. Without a
|
|
74
|
+
// configured `deep` profile this resolves to plain `default` (its own level).
|
|
75
|
+
profile: 'deep',
|
|
76
|
+
thinkingLevel: 'low',
|
|
77
|
+
timeoutMs: BROWSER_TIMEOUT_MS,
|
|
78
|
+
tools: [readTool, grepTool, findTool, lsTool, bashTool, writeTool],
|
|
79
|
+
payloadSchema: browserPayloadSchema,
|
|
80
|
+
visibility: 'public',
|
|
81
|
+
rosterDescription:
|
|
82
|
+
'ALL web browsing — navigate, click, fill forms, log in, screenshot, scrape JS-rendered pages; deep model at low thinking (default profile if no deep); never drive a browser yourself',
|
|
83
|
+
inFlightKey: (payload) => payload?.requestId ?? `anon-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`,
|
|
84
|
+
toolResultBudget: {
|
|
85
|
+
maxTotalBytes: 1_000_000,
|
|
86
|
+
toolNames: ['read', 'grep', 'find', 'ls', 'bash', 'write'],
|
|
87
|
+
},
|
|
88
|
+
}
|
|
89
|
+
}
|
|
@@ -0,0 +1,12 @@
|
|
|
1
|
+
import { getConfig } from '@/config'
|
|
2
|
+
import { definePlugin } from '@/plugin'
|
|
3
|
+
|
|
4
|
+
import { createBrowserSubagent } from './browser-agent'
|
|
5
|
+
|
|
6
|
+
export default definePlugin({
|
|
7
|
+
plugin: async () => ({
|
|
8
|
+
subagents: {
|
|
9
|
+
browser: createBrowserSubagent(getConfig().browser),
|
|
10
|
+
},
|
|
11
|
+
}),
|
|
12
|
+
})
|
|
@@ -9,20 +9,10 @@ import { definePlugin } from '@/plugin'
|
|
|
9
9
|
// path — keep them in lockstep.
|
|
10
10
|
export const RENDER_SCRIPT_AGENT_RELATIVE_PATH = 'node_modules/typeclaw/src/bundled-plugins/doc-render/render.ts'
|
|
11
11
|
|
|
12
|
-
// In-container path of the bundled themed report library, relative to the agent
|
|
13
|
-
// root. The skill tells the agent to copy this next to its markdown and
|
|
14
|
-
// `#import "lib.typ"`, because Typst's workspace sandbox only resolves imports
|
|
15
|
-
// under the render's working directory. Keep in lockstep with the skill.
|
|
16
|
-
export const TEMPLATE_LIB_AGENT_RELATIVE_PATH = 'node_modules/typeclaw/src/bundled-plugins/doc-render/templates/lib.typ'
|
|
17
|
-
|
|
18
12
|
export function renderScriptPath(): string {
|
|
19
13
|
return join(import.meta.dir, 'render.ts')
|
|
20
14
|
}
|
|
21
15
|
|
|
22
|
-
export function templateLibPath(): string {
|
|
23
|
-
return join(import.meta.dir, 'templates', 'lib.typ')
|
|
24
|
-
}
|
|
25
|
-
|
|
26
16
|
export default definePlugin({
|
|
27
17
|
plugin: async () => ({
|
|
28
18
|
skillsDirs: [join(import.meta.dir, 'skills')],
|