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,95 @@
|
|
|
1
|
+
import { createHash } from 'node:crypto'
|
|
2
|
+
|
|
3
|
+
import { GITHUB_API_BASE, githubJsonHeaders } from '@/channels/adapters/github/auth-pat'
|
|
4
|
+
import type { ToolResult } from '@/plugin'
|
|
5
|
+
|
|
6
|
+
export type GitAuthCredential = { source: string; token: string }
|
|
7
|
+
export type GitAuthLoginResolver = (token: string) => Promise<string | null>
|
|
8
|
+
|
|
9
|
+
let loginResolverForTests: GitAuthLoginResolver | undefined
|
|
10
|
+
|
|
11
|
+
export function setGitAuthLoginResolverForTests(resolver: GitAuthLoginResolver | undefined): void {
|
|
12
|
+
loginResolverForTests = resolver
|
|
13
|
+
}
|
|
14
|
+
|
|
15
|
+
export function createGitAuthLoginResolver(
|
|
16
|
+
lookup: GitAuthLoginResolver = async (token) => {
|
|
17
|
+
if (loginResolverForTests !== undefined) return await loginResolverForTests(token)
|
|
18
|
+
const response = await fetch(`${GITHUB_API_BASE}/user`, {
|
|
19
|
+
headers: githubJsonHeaders(token),
|
|
20
|
+
signal: AbortSignal.timeout(2_000),
|
|
21
|
+
redirect: 'error',
|
|
22
|
+
})
|
|
23
|
+
if (!response.ok) return null
|
|
24
|
+
const user: unknown = await response.json()
|
|
25
|
+
return user !== null && typeof user === 'object' && 'login' in user && typeof user.login === 'string'
|
|
26
|
+
? user.login
|
|
27
|
+
: null
|
|
28
|
+
},
|
|
29
|
+
): GitAuthLoginResolver {
|
|
30
|
+
const cache = new Map<string, Promise<string | null>>()
|
|
31
|
+
return (token) => {
|
|
32
|
+
const key = createHash('sha256').update(token).digest('hex')
|
|
33
|
+
let login = cache.get(key)
|
|
34
|
+
if (login === undefined) {
|
|
35
|
+
// Lookup is advisory: neither network errors nor response bodies may replace
|
|
36
|
+
// the git failure or expose a credential through an exception.
|
|
37
|
+
login = Promise.resolve()
|
|
38
|
+
.then(() => lookup(token))
|
|
39
|
+
.catch(() => null)
|
|
40
|
+
cache.set(key, login)
|
|
41
|
+
}
|
|
42
|
+
return login
|
|
43
|
+
}
|
|
44
|
+
}
|
|
45
|
+
|
|
46
|
+
export async function appendGitAuthDiagnostic(options: {
|
|
47
|
+
result: ToolResult
|
|
48
|
+
credentials: readonly GitAuthCredential[]
|
|
49
|
+
ghCredential?: GitAuthCredential
|
|
50
|
+
push: boolean
|
|
51
|
+
resolveLogin: GitAuthLoginResolver
|
|
52
|
+
}): Promise<void> {
|
|
53
|
+
const { result } = options
|
|
54
|
+
const text = result.content
|
|
55
|
+
.filter((part) => part.type === 'text')
|
|
56
|
+
.map((part) => part.text)
|
|
57
|
+
.join('\n')
|
|
58
|
+
const details = result.details
|
|
59
|
+
const failed =
|
|
60
|
+
(details !== null &&
|
|
61
|
+
typeof details === 'object' &&
|
|
62
|
+
(('error' in details && typeof details.error === 'string') ||
|
|
63
|
+
('exitCode' in details && typeof details.exitCode === 'number' && details.exitCode !== 0))) ||
|
|
64
|
+
/Command (?:failed|exited) with (?:exit )?code [1-9]\d*/i.test(text)
|
|
65
|
+
if (!failed) return
|
|
66
|
+
// These are git/GitHub protocol errors, not natural-language intent matching.
|
|
67
|
+
if (
|
|
68
|
+
!/\b(?:401|403)\b|Permission to .+ denied to |Authentication failed|Invalid username or password|Resource not accessible/i.test(
|
|
69
|
+
text,
|
|
70
|
+
) &&
|
|
71
|
+
!(options.push && /Repository not found/i.test(text))
|
|
72
|
+
)
|
|
73
|
+
return
|
|
74
|
+
|
|
75
|
+
const used = await Promise.all(
|
|
76
|
+
options.credentials.map(async (credential) => ({
|
|
77
|
+
source: credential.source,
|
|
78
|
+
login: (await options.resolveLogin(credential.token)) ?? 'unknown',
|
|
79
|
+
})),
|
|
80
|
+
)
|
|
81
|
+
let advice = `[github-cli-auth:gitCredential] Git used ${used.map(({ source, login }) => `${source} (login: ${login})`).join('; ')}.`
|
|
82
|
+
if (options.ghCredential !== undefined) {
|
|
83
|
+
const ghLogin = (await options.resolveLogin(options.ghCredential.token)) ?? 'unknown'
|
|
84
|
+
if (used.some(({ login }) => login !== ghLogin)) {
|
|
85
|
+
advice += ` gh for this repo would use ${options.ghCredential.source} (login: ${ghLogin}).`
|
|
86
|
+
}
|
|
87
|
+
}
|
|
88
|
+
advice +=
|
|
89
|
+
' Operator: fix or remove the mismatched credential (github in secrets.json for the repo token, GH_TOKEN in the agent .env for the declared PAT), then run typeclaw restart. The host gh login never funds git push.'
|
|
90
|
+
// Do not trust lookup output to be secret-free, even when provided by /user.
|
|
91
|
+
for (const credential of [...options.credentials, ...(options.ghCredential ? [options.ghCredential] : [])]) {
|
|
92
|
+
advice = advice.replaceAll(credential.token, '[redacted]')
|
|
93
|
+
}
|
|
94
|
+
result.content.push({ type: 'text', text: advice })
|
|
95
|
+
}
|
|
@@ -13,10 +13,11 @@ const NUDGE_TEXT =
|
|
|
13
13
|
'`gh api` does not accept `-R/--repo`; TypeClaw consumes it as the mint hint and ' +
|
|
14
14
|
'strips it before running the command with the right token injected.'
|
|
15
15
|
|
|
16
|
-
//
|
|
17
|
-
//
|
|
18
|
-
//
|
|
19
|
-
// end of line so we can inspect the SAME
|
|
16
|
+
// Matched against the command the agent ran, not the tool output: a bash result
|
|
17
|
+
// carries only the process output, so gh's "gh auth login" stderr never names the
|
|
18
|
+
// graphql call that produced it. The nudge is advisory, so a loose substring match
|
|
19
|
+
// is acceptable. Captured through to end of line so we can inspect the SAME
|
|
20
|
+
// invocation's flags (see REPO_FLAG).
|
|
20
21
|
const GRAPHQL_INVOCATION = /\bgh\b[^\n]*\bapi\b[^\n]*\bgraphql\b[^\n]*/
|
|
21
22
|
|
|
22
23
|
// `-R foo`, `-R=foo`, `--repo foo`, `--repo=foo`. Word-boundary anchored so a
|
|
@@ -37,8 +38,12 @@ const AUTH_FAILURE_SIGNATURES = [
|
|
|
37
38
|
'gh auth login',
|
|
38
39
|
]
|
|
39
40
|
|
|
40
|
-
export function checkGraphqlAuthNudge(options: {
|
|
41
|
-
|
|
41
|
+
export function checkGraphqlAuthNudge(options: {
|
|
42
|
+
tool: string
|
|
43
|
+
command: string | undefined
|
|
44
|
+
result: ToolResult
|
|
45
|
+
}): void {
|
|
46
|
+
if (options.tool !== 'bash' || options.command === undefined) return
|
|
42
47
|
|
|
43
48
|
// Only meaningful when no usable process token exists. An operator token or a
|
|
44
49
|
// runtime-seeded PAT means graphql already authenticates, so the advice would
|
|
@@ -47,7 +52,7 @@ export function checkGraphqlAuthNudge(options: { tool: string; result: ToolResul
|
|
|
47
52
|
if (tokenClass !== 'none') return
|
|
48
53
|
|
|
49
54
|
const text = collectText(options.result.content)
|
|
50
|
-
const invocation = GRAPHQL_INVOCATION.exec(
|
|
55
|
+
const invocation = GRAPHQL_INVOCATION.exec(options.command)
|
|
51
56
|
if (invocation === null) return
|
|
52
57
|
if (!AUTH_FAILURE_SIGNATURES.some((sig) => text.includes(sig))) return
|
|
53
58
|
if (text.includes(GRAPHQL_AUTH_NUDGE_TAG)) return
|
|
@@ -22,17 +22,12 @@ import {
|
|
|
22
22
|
canInjectPatIntoPassThroughGh,
|
|
23
23
|
effectiveGhTokensForAuthenticatedUserEndpoint,
|
|
24
24
|
effectiveGhTokensForCommand,
|
|
25
|
+
hasGhInvocation,
|
|
25
26
|
usesGhApiGraphqlEndpoint,
|
|
26
27
|
} from './gh-command'
|
|
27
28
|
import { detectReviewDismissal } from './gh-review-detect'
|
|
28
|
-
import {
|
|
29
|
-
cleanupPreparedGithubStorePush,
|
|
30
|
-
GH_STORE_AMBIENT_AUTH_KEYS,
|
|
31
|
-
planGithubStorePush,
|
|
32
|
-
prepareGithubStorePush,
|
|
33
|
-
resolveGithubCliStoreToken,
|
|
34
|
-
} from './gh-store'
|
|
35
29
|
import { ensureGitAskPassHelper, resolveSandboxGitAskPassPath } from './git-askpass'
|
|
30
|
+
import { appendGitAuthDiagnostic, createGitAuthLoginResolver, type GitAuthCredential } from './git-auth-diagnostic'
|
|
36
31
|
import {
|
|
37
32
|
analyzeGitCommand,
|
|
38
33
|
createSessionTmpGitResolvers,
|
|
@@ -88,6 +83,18 @@ export default definePlugin({
|
|
|
88
83
|
const hasAppTokenResolver = ctx.github.hasAppTokenResolver
|
|
89
84
|
const trustedGitTransportEnv: NodeJS.ProcessEnv = { ...process.env }
|
|
90
85
|
const reviewCredentials = new Map<string, GithubTokenCredential>()
|
|
86
|
+
// tool.after only sees the bash output, so the graphql nudge needs the command
|
|
87
|
+
// that ran; keyed by callId like gitAuthDiagnostics.
|
|
88
|
+
const passThroughGraphqlCommands = new Map<string, string>()
|
|
89
|
+
const resolveGitAuthLogin = createGitAuthLoginResolver()
|
|
90
|
+
const gitAuthDiagnostics = new Map<
|
|
91
|
+
string,
|
|
92
|
+
{
|
|
93
|
+
credentials: GitAuthCredential[]
|
|
94
|
+
ghCredential?: GitAuthCredential
|
|
95
|
+
push: boolean
|
|
96
|
+
}
|
|
97
|
+
>()
|
|
91
98
|
|
|
92
99
|
// Every model-driven bash masks the canonical credential files. A role may
|
|
93
100
|
// still USE a PAT through this runtime-owned overlay, which injects one
|
|
@@ -193,18 +200,14 @@ export default definePlugin({
|
|
|
193
200
|
const missingAppAuthForPushReason =
|
|
194
201
|
'Pushing to github.com needs an eligible credential and validated destination, and TypeClaw has nothing it can give this git command. ' +
|
|
195
202
|
'Operator remedy: declare `GH_TOKEN` in the agent `.env` and restart, configure GitHub App auth under ' +
|
|
196
|
-
'`channels.github` for per-repo short-lived tokens, or
|
|
197
|
-
'`
|
|
198
|
-
'
|
|
203
|
+
'`channels.github` for per-repo short-lived tokens, or (PAT channel auth) list the repo in ' +
|
|
204
|
+
'`channels.github.repos[]` so its PAT can fund the push. ' +
|
|
205
|
+
'The host `gh` login never funds a push, even when ' +
|
|
206
|
+
'`githubCli.importHostAuth` is enabled. ' +
|
|
199
207
|
'If App auth is already configured, the adapter failed to start — check ' +
|
|
200
208
|
'`typeclaw logs`. Do not retry with ' +
|
|
201
209
|
'`gh auth setup-git`, a credential helper, or a tokenized remote URL: those are blocked and the ' +
|
|
202
210
|
'credential files are masked in this sandbox.'
|
|
203
|
-
const multiPushStoreReason =
|
|
204
|
-
'The trusted GitHub CLI credential store can fund exactly one configured push repository. ' +
|
|
205
|
-
'This remote has multiple GitHub push destinations; use an authoritative declared PAT or GitHub App auth, ' +
|
|
206
|
-
'or configure exactly one push URL.'
|
|
207
|
-
|
|
208
211
|
let warnedSandboxedPatWithheld = false
|
|
209
212
|
const warnSandboxedPatWithheldOnce = (): void => {
|
|
210
213
|
if (warnedSandboxedPatWithheld) return
|
|
@@ -382,6 +385,9 @@ export default definePlugin({
|
|
|
382
385
|
workspace: review.detected.workspace,
|
|
383
386
|
prNumber: review.detected.prNumber,
|
|
384
387
|
verdict: review.detected.verdict,
|
|
388
|
+
...(review.detected.reviewedHeadSha !== undefined
|
|
389
|
+
? { reviewedHeadSha: review.detected.reviewedHeadSha }
|
|
390
|
+
: {}),
|
|
385
391
|
...(event.origin?.kind === 'channel' && event.origin.githubReviewRound !== undefined
|
|
386
392
|
? { round: event.origin.githubReviewRound, thread: event.origin.thread }
|
|
387
393
|
: {}),
|
|
@@ -416,7 +422,10 @@ export default definePlugin({
|
|
|
416
422
|
}
|
|
417
423
|
|
|
418
424
|
if (decision.kind === 'pass-through') {
|
|
419
|
-
|
|
425
|
+
// The caller routes on a raw `gh` substring, so `git commit -m "...wright..."`
|
|
426
|
+
// lands here. With no real `gh` invocation there is nothing to broker the
|
|
427
|
+
// PAT to: fall through without the overlay instead of blocking.
|
|
428
|
+
const patOverlay = canUsePat(event.origin) && hasGhInvocation(command) ? processPatOverlay() : undefined
|
|
420
429
|
if (patOverlay !== undefined) {
|
|
421
430
|
if (!canInjectPatIntoPassThroughGh(command)) {
|
|
422
431
|
return blockAfterLease({
|
|
@@ -430,6 +439,7 @@ export default definePlugin({
|
|
|
430
439
|
const overlay = existing !== null && typeof existing === 'object' ? (existing as Record<string, string>) : {}
|
|
431
440
|
event.args[TYPECLAW_INTERNAL_BASH_ENV] = { ...overlay, ...patOverlay }
|
|
432
441
|
}
|
|
442
|
+
if (usesGhApiGraphqlEndpoint(command)) passThroughGraphqlCommands.set(event.callId, command)
|
|
433
443
|
return 'fall-through'
|
|
434
444
|
}
|
|
435
445
|
|
|
@@ -551,6 +561,20 @@ export default definePlugin({
|
|
|
551
561
|
decision.pushProvenance?.kind === 'configured-remote'
|
|
552
562
|
? decision.pushProvenance.repoSlugs
|
|
553
563
|
: [decision.repoSlug.toLocaleLowerCase()]
|
|
564
|
+
const noteGitCredential = (credentials: GitAuthCredential[]): void => {
|
|
565
|
+
// Match handleGhCommand's no-minter precedence. With a minter, gh uses
|
|
566
|
+
// the same per-repo credential as git, so no comparison is needed.
|
|
567
|
+
const ghToken = !hasAppTokenResolver()
|
|
568
|
+
? (sandboxInheritedGhToken() ?? (canUsePat(event.origin) ? effectiveProcessToken() : undefined))
|
|
569
|
+
: undefined
|
|
570
|
+
gitAuthDiagnostics.set(event.callId, {
|
|
571
|
+
credentials,
|
|
572
|
+
...(ghToken !== undefined
|
|
573
|
+
? { ghCredential: { source: `github repo token via ${ghToken.envName}`, token: ghToken.value } }
|
|
574
|
+
: {}),
|
|
575
|
+
push: decision.access === 'write',
|
|
576
|
+
})
|
|
577
|
+
}
|
|
554
578
|
|
|
555
579
|
if (!hasAppTokenResolver()) {
|
|
556
580
|
const declared = declaredGitCredentialState()
|
|
@@ -574,54 +598,42 @@ export default definePlugin({
|
|
|
574
598
|
// Withhold wins only when the same ambient names are absent from the overlay.
|
|
575
599
|
event.args[TYPECLAW_INTERNAL_BASH_WITHHOLD_ENV] = ['GH_TOKEN', 'GITHUB_TOKEN']
|
|
576
600
|
if (decision.rewrittenCommand !== undefined) event.args.command = decision.rewrittenCommand
|
|
601
|
+
noteGitCredential([{ source: `declared .env ${declared.envName}`, token: declared.value }])
|
|
577
602
|
return
|
|
578
603
|
}
|
|
579
604
|
if (decision.access !== 'write') return
|
|
580
|
-
|
|
581
|
-
|
|
582
|
-
|
|
583
|
-
|
|
584
|
-
|
|
585
|
-
|
|
586
|
-
|
|
587
|
-
|
|
588
|
-
|
|
589
|
-
|
|
590
|
-
|
|
591
|
-
{ expectedRemote: plan.remote, trustedEnv: {} },
|
|
592
|
-
)
|
|
593
|
-
event.args[TYPECLAW_INTERNAL_BASH_ENV] = credentialEnv
|
|
594
|
-
const inheritedNames = [
|
|
595
|
-
...Object.keys(process.env),
|
|
596
|
-
...Object.keys(credentialEnv),
|
|
597
|
-
'SSH_ASKPASS',
|
|
598
|
-
'SSH_AUTH_SOCK',
|
|
599
|
-
'HTTP_PROXY',
|
|
600
|
-
'HTTPS_PROXY',
|
|
601
|
-
'ALL_PROXY',
|
|
602
|
-
'http_proxy',
|
|
603
|
-
'https_proxy',
|
|
604
|
-
'all_proxy',
|
|
605
|
-
]
|
|
606
|
-
event.args[TYPECLAW_INTERNAL_BASH_WITHHOLD_ENV] = [
|
|
607
|
-
...new Set([
|
|
608
|
-
...GH_STORE_AMBIENT_AUTH_KEYS,
|
|
609
|
-
...inheritedNames.filter(
|
|
610
|
-
(name) => name.startsWith('GIT_') || name.startsWith('SSH_') || /proxy/i.test(name),
|
|
611
|
-
),
|
|
612
|
-
]),
|
|
613
|
-
]
|
|
614
|
-
event.args[TYPECLAW_INTERNAL_BASH_PREPARE] = async () => {
|
|
615
|
-
const prepared = await prepareGithubStorePush(plan)
|
|
616
|
-
if (prepared === null) throw new Error(missingAppAuthForPushReason)
|
|
617
|
-
return {
|
|
618
|
-
command: prepared.command,
|
|
619
|
-
env: prepared.env,
|
|
620
|
-
mount: prepared.mount,
|
|
621
|
-
cleanup: async () => await cleanupPreparedGithubStorePush(prepared.backingGitDir),
|
|
605
|
+
// PAT-mode channel auth lends its PAT for configured repos (the adapter enforces
|
|
606
|
+
// repos[]). Only an absent `.env` declaration falls through here: an invalid one
|
|
607
|
+
// stays blocked rather than being silently replaced by a different credential.
|
|
608
|
+
if (declared.kind === 'absent' && canUsePat(event.origin) && ctx.github.resolvePatForRepo !== undefined) {
|
|
609
|
+
const credentials: GitRepoCredential[] = []
|
|
610
|
+
for (const repoSlug of destinationRepos) {
|
|
611
|
+
const result = await ctx.github.resolvePatForRepo(repoSlug)
|
|
612
|
+
if (result.kind === 'unavailable') {
|
|
613
|
+
return { block: true, reason: `${missingAppAuthForPushReason} Channel PAT: ${result.reason}` }
|
|
614
|
+
}
|
|
615
|
+
credentials.push({ repoSlug, token: result.token })
|
|
622
616
|
}
|
|
617
|
+
event.args[TYPECLAW_INTERNAL_BASH_ENV] = await buildGitCredentialOverlay(
|
|
618
|
+
credentials,
|
|
619
|
+
event.args[TYPECLAW_INTERNAL_BASH_ENV],
|
|
620
|
+
{
|
|
621
|
+
expectedRemote:
|
|
622
|
+
decision.pushProvenance?.kind === 'configured-remote' ? decision.pushProvenance.remote : undefined,
|
|
623
|
+
pushUrls:
|
|
624
|
+
decision.pushProvenance?.kind === 'configured-remote' ? decision.pushProvenance.pushUrls : undefined,
|
|
625
|
+
trustedEnv: trustedGitTransportEnv,
|
|
626
|
+
},
|
|
627
|
+
)
|
|
628
|
+
event.args[TYPECLAW_INTERNAL_BASH_WITHHOLD_ENV] = ['GH_TOKEN', 'GITHUB_TOKEN']
|
|
629
|
+
if (decision.rewrittenCommand !== undefined) event.args.command = decision.rewrittenCommand
|
|
630
|
+
noteGitCredential(credentials.map(({ token }) => ({ source: 'GitHub channel PAT', token })))
|
|
631
|
+
return
|
|
623
632
|
}
|
|
624
|
-
|
|
633
|
+
// The host `gh` login is the operator's identity, not the agent's, so it never funds
|
|
634
|
+
// a push: anything it signed would land on GitHub as the operator. App auth and an
|
|
635
|
+
// authoritative declared PAT stay the authorized push credentials.
|
|
636
|
+
return { block: true, reason: missingAppAuthForPushReason }
|
|
625
637
|
}
|
|
626
638
|
const credentials: GitRepoCredential[] = []
|
|
627
639
|
for (const repoSlug of destinationRepos) {
|
|
@@ -652,6 +664,12 @@ export default definePlugin({
|
|
|
652
664
|
)
|
|
653
665
|
if (grantedPush !== undefined) event.args.command = grantedPush.command
|
|
654
666
|
else if (decision.rewrittenCommand !== undefined) event.args.command = decision.rewrittenCommand
|
|
667
|
+
noteGitCredential(
|
|
668
|
+
credentials.map(({ repoSlug, token }) => ({
|
|
669
|
+
source: `per-repo GitHub App token for ${repoSlug}`,
|
|
670
|
+
token,
|
|
671
|
+
})),
|
|
672
|
+
)
|
|
655
673
|
return
|
|
656
674
|
}
|
|
657
675
|
|
|
@@ -705,7 +723,14 @@ export default definePlugin({
|
|
|
705
723
|
return
|
|
706
724
|
},
|
|
707
725
|
'tool.after': async (event) => {
|
|
708
|
-
|
|
726
|
+
const gitAuth = gitAuthDiagnostics.get(event.callId)
|
|
727
|
+
gitAuthDiagnostics.delete(event.callId)
|
|
728
|
+
if (event.tool === 'bash' && gitAuth !== undefined) {
|
|
729
|
+
await appendGitAuthDiagnostic({ result: event.result, ...gitAuth, resolveLogin: resolveGitAuthLogin })
|
|
730
|
+
}
|
|
731
|
+
const graphqlCommand = passThroughGraphqlCommands.get(event.callId)
|
|
732
|
+
passThroughGraphqlCommands.delete(event.callId)
|
|
733
|
+
checkGraphqlAuthNudge({ tool: event.tool, command: graphqlCommand, result: event.result })
|
|
709
734
|
const dismissal = pendingDismissals.get(event.callId)
|
|
710
735
|
pendingDismissals.delete(event.callId)
|
|
711
736
|
if (dismissal !== undefined) {
|
|
@@ -0,0 +1,179 @@
|
|
|
1
|
+
import { join } from 'node:path'
|
|
2
|
+
|
|
3
|
+
import { z } from 'zod'
|
|
4
|
+
|
|
5
|
+
import { TYPECLAW_INTERNAL_BASH_ENV } from '@/agent/plugin-tools'
|
|
6
|
+
import { fillSecretIntoFocusedField, type FillSecretOutcome } from '@/browser/fill-secret'
|
|
7
|
+
import { type ManagedBrowser, startManagedBrowser } from '@/browser/managed-browser'
|
|
8
|
+
import { BROWSER_ENGINES, type BrowserConfig, needsManagedBrowser } from '@/browser/registry'
|
|
9
|
+
import { getConfig } from '@/config'
|
|
10
|
+
import { readEnvFile } from '@/init/env-file'
|
|
11
|
+
import type { PermissionService } from '@/permissions'
|
|
12
|
+
import { CORE_PERMISSIONS } from '@/permissions/builtins'
|
|
13
|
+
import { definePlugin, defineTool, type Hooks } from '@/plugin'
|
|
14
|
+
import { resolveFillableEnvNames, SECRET_ENV_PREFIX } from '@/sandbox/env-exposure'
|
|
15
|
+
|
|
16
|
+
const SKILLS_ROOT = join(import.meta.dir, 'skills')
|
|
17
|
+
|
|
18
|
+
export default definePlugin({
|
|
19
|
+
plugin: async (ctx) => {
|
|
20
|
+
// Boot snapshot: `browser` is restart-required, matching the image layers
|
|
21
|
+
// and the browser process started below.
|
|
22
|
+
const browser = getConfig().browser
|
|
23
|
+
const skillsDirs = browserSkillDirs(browser)
|
|
24
|
+
if (!needsManagedBrowser(browser)) return { skillsDirs }
|
|
25
|
+
|
|
26
|
+
let managed: ManagedBrowser
|
|
27
|
+
try {
|
|
28
|
+
managed = await startManagedBrowser({ agentDir: ctx.agentDir, browser, logger: ctx.logger })
|
|
29
|
+
} catch (error) {
|
|
30
|
+
ctx.logger.error(`managed browser failed to start; browser engines are unavailable: ${String(error)}`)
|
|
31
|
+
return { skillsDirs }
|
|
32
|
+
}
|
|
33
|
+
const overlay = browserEnvOverlay(browser, managed)
|
|
34
|
+
const bashHook = sharedBrowserBashHook(ctx.permissions, overlay)
|
|
35
|
+
const fillGuard = fillSecretGuardHook(ctx.permissions)
|
|
36
|
+
|
|
37
|
+
return {
|
|
38
|
+
skillsDirs,
|
|
39
|
+
tools: { [FILL_SECRET_TOOL]: createFillSecretTool(managed.cdpUrl) },
|
|
40
|
+
hooks: {
|
|
41
|
+
'tool.before': async (event, hookCtx) => {
|
|
42
|
+
await bashHook(event, hookCtx)
|
|
43
|
+
return fillGuard(event, hookCtx)
|
|
44
|
+
},
|
|
45
|
+
},
|
|
46
|
+
onDispose: () => managed.stop(),
|
|
47
|
+
}
|
|
48
|
+
},
|
|
49
|
+
})
|
|
50
|
+
|
|
51
|
+
export function sharedBrowserBashHook(
|
|
52
|
+
permissions: PermissionService,
|
|
53
|
+
overlay: Record<string, string>,
|
|
54
|
+
): NonNullable<Hooks['tool.before']> {
|
|
55
|
+
return (event) => {
|
|
56
|
+
if (event.tool !== 'bash') return
|
|
57
|
+
if (!permissions.has(event.origin, CORE_PERMISSIONS.browserShared)) return
|
|
58
|
+
const existing = event.args[TYPECLAW_INTERNAL_BASH_ENV]
|
|
59
|
+
const current = existing !== null && typeof existing === 'object' ? (existing as Record<string, string>) : {}
|
|
60
|
+
event.args[TYPECLAW_INTERNAL_BASH_ENV] = { ...current, ...overlay }
|
|
61
|
+
}
|
|
62
|
+
}
|
|
63
|
+
|
|
64
|
+
export const FILL_SECRET_TOOL = 'browser_fill_secret'
|
|
65
|
+
|
|
66
|
+
// The tool drives the shared browser, so it needs `browser.shared` like bash's
|
|
67
|
+
// CDP URL does. Typing the withheld TYPECLAW_SECRET_* tier is runtime-owned
|
|
68
|
+
// credential use, which `fs.see.secrets` authorizes; ordinary .env vars are
|
|
69
|
+
// already in that role's bash, so typing them needs nothing more. This gates
|
|
70
|
+
// who may USE a secret, not who may observe it: every `browser.shared` holder
|
|
71
|
+
// drives the same pages over CDP and can watch what is typed there.
|
|
72
|
+
export function fillSecretGuardHook(permissions: PermissionService): NonNullable<Hooks['tool.before']> {
|
|
73
|
+
return (event) => {
|
|
74
|
+
if (event.tool !== FILL_SECRET_TOOL) return
|
|
75
|
+
if (!permissions.has(event.origin, CORE_PERMISSIONS.browserShared)) {
|
|
76
|
+
return { block: true, reason: `${FILL_SECRET_TOOL} needs the ${CORE_PERMISSIONS.browserShared} permission` }
|
|
77
|
+
}
|
|
78
|
+
const name = event.args['name']
|
|
79
|
+
if (
|
|
80
|
+
typeof name === 'string' &&
|
|
81
|
+
name.startsWith(SECRET_ENV_PREFIX) &&
|
|
82
|
+
!permissions.has(event.origin, CORE_PERMISSIONS.fsSeeSecrets)
|
|
83
|
+
) {
|
|
84
|
+
return {
|
|
85
|
+
block: true,
|
|
86
|
+
reason: `${SECRET_ENV_PREFIX}* values need the ${CORE_PERMISSIONS.fsSeeSecrets} permission`,
|
|
87
|
+
}
|
|
88
|
+
}
|
|
89
|
+
}
|
|
90
|
+
}
|
|
91
|
+
|
|
92
|
+
export function createFillSecretTool(
|
|
93
|
+
cdpUrl: string,
|
|
94
|
+
fill: typeof fillSecretIntoFocusedField = fillSecretIntoFocusedField,
|
|
95
|
+
) {
|
|
96
|
+
return defineTool({
|
|
97
|
+
description: [
|
|
98
|
+
'Type the value of a .env variable into the focused field of a shared-browser tab without the value ever entering your context.',
|
|
99
|
+
'Focus the field first with your browser engine (click it), then call this. Pass `url` (exact or prefix) when several tabs are open.',
|
|
100
|
+
`Accepts any ordinary .env variable and the ${SECRET_ENV_PREFIX}* tier, which is hidden from bash and reachable only through this tool.`,
|
|
101
|
+
'With `submit: true` it submits the field (form submit, else Enter) and waits for the page to navigate; if it does not, the field is cleared so the value is not left on the page.',
|
|
102
|
+
'The result names the tab and field, never the value. Never read the field back, screenshot a non-password field after filling, or echo the variable.',
|
|
103
|
+
].join(' '),
|
|
104
|
+
parameters: z.object({
|
|
105
|
+
name: z.string().describe('The .env variable name, e.g. TYPECLAW_SECRET_GITHUB_PASSWORD'),
|
|
106
|
+
url: z.string().optional().describe('Exact URL or prefix of the target tab'),
|
|
107
|
+
submit: z.boolean().default(false),
|
|
108
|
+
}),
|
|
109
|
+
fileOperands: { nonFile: ['name', 'url'] },
|
|
110
|
+
execute: async (args, ctx) => {
|
|
111
|
+
const fillable = new Set(resolveFillableEnvNames(readEnvFile(ctx.agentDir), process.env))
|
|
112
|
+
if (!fillable.has(args.name)) {
|
|
113
|
+
return text(
|
|
114
|
+
`${args.name} is not a fillable variable: declare it with a non-empty value in .env (runtime controls are never fillable).`,
|
|
115
|
+
)
|
|
116
|
+
}
|
|
117
|
+
const value = process.env[args.name]
|
|
118
|
+
if (value === undefined || value.length === 0) {
|
|
119
|
+
return text(
|
|
120
|
+
`${args.name} is in .env but not loaded yet; the operator must restart the agent after editing .env.`,
|
|
121
|
+
)
|
|
122
|
+
}
|
|
123
|
+
const outcome = await fill({
|
|
124
|
+
cdpUrl,
|
|
125
|
+
value,
|
|
126
|
+
submit: args.submit,
|
|
127
|
+
...(args.url === undefined ? {} : { url: args.url }),
|
|
128
|
+
})
|
|
129
|
+
return text(describeOutcome(args.name, outcome))
|
|
130
|
+
},
|
|
131
|
+
})
|
|
132
|
+
}
|
|
133
|
+
|
|
134
|
+
function describeOutcome(name: string, outcome: FillSecretOutcome): string {
|
|
135
|
+
switch (outcome.status) {
|
|
136
|
+
case 'refused':
|
|
137
|
+
return `Not filled: ${outcome.reason}.`
|
|
138
|
+
case 'filled':
|
|
139
|
+
return `Filled ${name} into ${outcome.field} on ${outcome.url}.`
|
|
140
|
+
case 'submitted':
|
|
141
|
+
return `Filled ${name} into ${outcome.field} on ${outcome.url} and submitted; the page navigated.`
|
|
142
|
+
case 'not-navigated':
|
|
143
|
+
return (
|
|
144
|
+
`Filled ${name} into ${outcome.field} on ${outcome.url} and submitted, but the page did not navigate. ` +
|
|
145
|
+
(outcome.cleared
|
|
146
|
+
? 'The field was cleared; check the page for an error.'
|
|
147
|
+
: 'The field could not be cleared (cross-origin frame); check the page for an error.')
|
|
148
|
+
)
|
|
149
|
+
}
|
|
150
|
+
}
|
|
151
|
+
|
|
152
|
+
function text(value: string) {
|
|
153
|
+
return { content: [{ type: 'text' as const, text: value }] }
|
|
154
|
+
}
|
|
155
|
+
|
|
156
|
+
export function browserSkillDirs(browser: BrowserConfig): string[] {
|
|
157
|
+
const ids = [...browser.engines.filter((id) => id !== 'agent-browser'), ...browser.extensions]
|
|
158
|
+
// One root per id (skills/<id>/<skill>/SKILL.md) so disabled engines stay out of the catalog.
|
|
159
|
+
return ids.map((id) => join(SKILLS_ROOT, id))
|
|
160
|
+
}
|
|
161
|
+
|
|
162
|
+
export function browserEnvOverlay(
|
|
163
|
+
browser: BrowserConfig,
|
|
164
|
+
managed: Pick<ManagedBrowser, 'cdpUrl' | 'filesDir' | 'bskRelay' | 'token'>,
|
|
165
|
+
) {
|
|
166
|
+
const env: Record<string, string> = {
|
|
167
|
+
TYPECLAW_BROWSER_CDP_URL: managed.cdpUrl,
|
|
168
|
+
TYPECLAW_BROWSER_FILES: managed.filesDir,
|
|
169
|
+
}
|
|
170
|
+
// agent-browser is in every image and bundled skills (qa, PDF) call it
|
|
171
|
+
// directly, so it always joins the shared browser while one is running.
|
|
172
|
+
for (const id of new Set(['agent-browser' as const, ...browser.engines])) {
|
|
173
|
+
Object.assign(env, BROWSER_ENGINES[id].env(managed.cdpUrl))
|
|
174
|
+
}
|
|
175
|
+
if (managed.bskRelay !== undefined) {
|
|
176
|
+
Object.assign(env, { TYPECLAW_BSK_RELAY: managed.bskRelay, TYPECLAW_BSK_TOKEN: managed.token })
|
|
177
|
+
}
|
|
178
|
+
return env
|
|
179
|
+
}
|
|
@@ -0,0 +1,27 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: browser-use
|
|
3
|
+
description: Browser Use CLI for driving the shared TypeClaw browser from Python snippets over CDP. Use for browsing, clicking, scraping and screenshots when you prefer Python helpers.
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# browser-use
|
|
7
|
+
|
|
8
|
+
The `browser-use` CLI runs a Python snippet with browser helpers pre-imported. `$BU_CDP_WS` points it at the shared browser. If the variable is unset, this session's role cannot use the shared browser (it needs the `browser.shared` permission) or the browser failed to start; the operator log (`typeclaw logs`) names which. Do not try to start Chrome yourself.
|
|
9
|
+
|
|
10
|
+
```bash
|
|
11
|
+
browser-use <<'PY'
|
|
12
|
+
new_tab("https://example.com")
|
|
13
|
+
wait_for_load()
|
|
14
|
+
print(page_info())
|
|
15
|
+
PY
|
|
16
|
+
```
|
|
17
|
+
|
|
18
|
+
Run `browser-use skill` once to read the full helper reference (`ensure_real_tab`, `click_at_xy`, `cdp(...)`, screenshots). Its tabs are marked with a horse emoji in the title; keep to those.
|
|
19
|
+
|
|
20
|
+
Never run `browser-use --update`, `browser-use auth login`, or remote/cloud daemons (`start_remote_daemon`): the version is pinned by TypeClaw and cloud browsers are not part of this setup.
|
|
21
|
+
|
|
22
|
+
## Shared browser rules
|
|
23
|
+
|
|
24
|
+
- One TypeClaw-managed Chrome serves every engine and every session that has `browser.shared`. Logins and tabs persist across bash calls and sessions.
|
|
25
|
+
- Work only in tabs you opened. Never navigate or close a tab another engine or session is using.
|
|
26
|
+
- Files: downloads land in `$TYPECLAW_BROWSER_FILES`; to upload a file, copy it there first and pass that path. Chrome cannot see other paths.
|
|
27
|
+
- The browser runs in its own sandbox with no view of the agent folder, so `file://` URLs outside `$TYPECLAW_BROWSER_FILES` fail by design.
|
|
@@ -0,0 +1,28 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: browserskill
|
|
3
|
+
description: BrowserSkill (bsk) CLI driving the shared TypeClaw browser through its extension. Use for semantic page observation, table/list extraction, recording traces, and website debugging evidence.
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# browserskill
|
|
7
|
+
|
|
8
|
+
The `bsk` CLI talks to a daemon TypeClaw runs next to the shared browser; the BrowserSkill extension is preloaded and connected. `bsk` reaches that daemon through `$TYPECLAW_BSK_RELAY`; do not set `BSK_HOME` yourself. If the variable is unset, this session's role cannot use the shared browser (it needs the `browser.shared` permission) or the browser failed to start; the operator log (`typeclaw logs`) names which. Do not try to start Chrome yourself.
|
|
9
|
+
|
|
10
|
+
```bash
|
|
11
|
+
bsk status --json # a connected browser must be listed
|
|
12
|
+
SID=$(bsk session start --json | jq -r .session_id)
|
|
13
|
+
bsk navigate https://example.com --session "$SID"
|
|
14
|
+
bsk snapshot --session "$SID" # @eN refs
|
|
15
|
+
bsk click @e3 --session "$SID"
|
|
16
|
+
bsk session stop "$SID" # always stop, success or failure
|
|
17
|
+
```
|
|
18
|
+
|
|
19
|
+
- Sessions open their own Agent Window. Never borrow an existing tab: borrowing asks a human to confirm, and nobody can click it here.
|
|
20
|
+
- `bsk --help` and `bsk <command> --help` list everything (`extract`, `observe`, `record`, `debug`).
|
|
21
|
+
- Never run `bsk update`, `bsk daemon stop`, or `bsk daemon restart`; TypeClaw owns the daemon and its version.
|
|
22
|
+
|
|
23
|
+
## Shared browser rules
|
|
24
|
+
|
|
25
|
+
- One TypeClaw-managed Chrome serves every engine and every session that has `browser.shared`. Logins and tabs persist across bash calls and sessions.
|
|
26
|
+
- Work only in tabs you opened. Never navigate or close a tab another engine or session is using.
|
|
27
|
+
- Files: downloads land in `$TYPECLAW_BROWSER_FILES`; to upload a file, copy it there first and pass that path. Chrome cannot see other paths.
|
|
28
|
+
- The browser runs in its own sandbox with no view of the agent folder, so `file://` URLs outside `$TYPECLAW_BROWSER_FILES` fail by design.
|
|
@@ -0,0 +1,40 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: omowright
|
|
3
|
+
description: Playwright-shaped browser automation library (OmOWright) for the shared TypeClaw browser. Use for browsing, clicking, form filling, accessibility snapshots, scrolling feeds and collecting JSON from network responses while scrolling.
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# omowright
|
|
7
|
+
|
|
8
|
+
OmOWright is a JavaScript library with the Playwright API shape (`page.goto`, `page.locator(ref).click()`, `page.mouse.wheel`, `page.keyboard.type`, `page.screenshot`). Write a short Bun script and run it with `bun`. Each script connects to the shared browser, so state survives between scripts.
|
|
9
|
+
|
|
10
|
+
`$OMOWRIGHT_CDP_URL` holds the connection URL. If the variable is unset, this session's role cannot use the shared browser (it needs the `browser.shared` permission) or the browser failed to start; the operator log (`typeclaw logs`) names which. Do not try to start Chrome yourself.
|
|
11
|
+
|
|
12
|
+
```js
|
|
13
|
+
// save as /tmp/browse.mjs, run: bun /tmp/browse.mjs
|
|
14
|
+
import { compactSnapshot, connect, createAgentTabs } from '/usr/local/lib/typeclaw-browser/omowright/index.js'
|
|
15
|
+
|
|
16
|
+
const url = process.env.OMOWRIGHT_CDP_URL
|
|
17
|
+
// The relay requires the token on every request; omowright drops the URL query
|
|
18
|
+
// for HTTP discovery (listTargets), so pass it as an Authorization header too.
|
|
19
|
+
const token = new URL(url).searchParams.get('token')
|
|
20
|
+
const browser = await connect(url, {
|
|
21
|
+
client: { authorizer: { resolveAuthorization: async () => `Bearer ${token}` } },
|
|
22
|
+
})
|
|
23
|
+
const tabs = createAgentTabs(browser) // background tabs that never steal focus
|
|
24
|
+
const page = await tabs.open('https://example.com')
|
|
25
|
+
console.log(compactSnapshot(await page.snapshot())) // refs like [ref=e1]
|
|
26
|
+
await page.locator('e1').click()
|
|
27
|
+
process.exit(0) // leaves the tab and browser running
|
|
28
|
+
```
|
|
29
|
+
|
|
30
|
+
- Prefer `compactSnapshot(await page.snapshot())` over screenshots; re-snapshots come back as a diff.
|
|
31
|
+
- Long lists: `createNetworkSnoop` + `collectWhileScrolling` read the page's JSON instead of scraping rows.
|
|
32
|
+
- Canvas or custom widgets: `createCua(page)` gives coordinate-level clicks and scrolls.
|
|
33
|
+
- `connectPipe()` and `connectBrowserSkill()` launch or find other browsers; do not use them here.
|
|
34
|
+
|
|
35
|
+
## Shared browser rules
|
|
36
|
+
|
|
37
|
+
- One TypeClaw-managed Chrome serves every engine and every session that has `browser.shared`. Logins and tabs persist across bash calls and sessions.
|
|
38
|
+
- Work only in tabs you opened. Never navigate or close a tab another engine or session is using.
|
|
39
|
+
- Files: downloads land in `$TYPECLAW_BROWSER_FILES`; to upload a file, copy it there first and pass that path. Chrome cannot see other paths.
|
|
40
|
+
- The browser runs in its own sandbox with no view of the agent folder, so `file://` URLs outside `$TYPECLAW_BROWSER_FILES` fail by design.
|
|
@@ -622,7 +622,10 @@ async function recomputeShardFrontmatter(agentDir: string, slug: string, logger:
|
|
|
622
622
|
heading: parsed.frontmatter.heading || synthesizeHeadingFromBody(parsed.body) || slug,
|
|
623
623
|
cites,
|
|
624
624
|
days: dates.length,
|
|
625
|
-
|
|
625
|
+
// No dated citation (e.g. only pre-cutover line-range citations, which
|
|
626
|
+
// parseCitations drops) is no evidence of reinforcement, so keep the prior
|
|
627
|
+
// date instead of stamping today and making a stale shard look fresh.
|
|
628
|
+
lastReinforced: dates.at(-1) ?? parsed.frontmatter.lastReinforced,
|
|
626
629
|
...(tags !== undefined ? { tags } : {}),
|
|
627
630
|
}
|
|
628
631
|
const nextRaw = renderShard(nextFrontmatter, parsed.body)
|