typeclaw 0.49.0 → 0.50.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/types/agent/attention-escalation.d.ts +18 -0
- package/dist/types/agent/auth.d.ts +7 -0
- package/dist/types/agent/compaction.d.ts +8 -0
- package/dist/types/agent/git-nudge.d.ts +6 -0
- package/dist/types/agent/guard-types.d.ts +25 -0
- package/dist/types/agent/guards.d.ts +7 -0
- package/dist/types/agent/idle-compaction.d.ts +7 -0
- package/dist/types/agent/index.d.ts +163 -0
- package/dist/types/agent/live-subagents.d.ts +113 -0
- package/dist/types/agent/llm-replay-sanitizer.d.ts +11 -0
- package/dist/types/agent/loop-guard.d.ts +67 -0
- package/dist/types/agent/model-fallback.d.ts +29 -0
- package/dist/types/agent/model-overrides.d.ts +8 -0
- package/dist/types/agent/multimodal/index.d.ts +2 -0
- package/dist/types/agent/multimodal/look-at.d.ts +60 -0
- package/dist/types/agent/multimodal/looker.d.ts +61 -0
- package/dist/types/agent/multimodal/read-redirect.d.ts +6 -0
- package/dist/types/agent/network/response-body.d.ts +1 -0
- package/dist/types/agent/network/safe-http.d.ts +46 -0
- package/dist/types/agent/plugin-tools.d.ts +129 -0
- package/dist/types/agent/proactive-next-step-nudge.d.ts +2 -0
- package/dist/types/agent/prompt-cache-key.d.ts +3 -0
- package/dist/types/agent/provider-error.d.ts +23 -0
- package/dist/types/agent/reload-tool.d.ts +10 -0
- package/dist/types/agent/restart/index.d.ts +31 -0
- package/dist/types/agent/restart-handoff/index.d.ts +32 -0
- package/dist/types/agent/restart-handoff/paths.d.ts +1 -0
- package/dist/types/agent/retry-same-ref.d.ts +41 -0
- package/dist/types/agent/reviewer-activity.d.ts +3 -0
- package/dist/types/agent/reviewer-bash-policy.d.ts +8 -0
- package/dist/types/agent/self.d.ts +1 -0
- package/dist/types/agent/session-meta.d.ts +28 -0
- package/dist/types/agent/session-origin.d.ts +65 -0
- package/dist/types/agent/subagent-cache-keepalive.d.ts +38 -0
- package/dist/types/agent/subagent-completion-reminder.d.ts +29 -0
- package/dist/types/agent/subagent-drain.d.ts +25 -0
- package/dist/types/agent/subagent-session.d.ts +3 -0
- package/dist/types/agent/subagents.d.ts +153 -0
- package/dist/types/agent/system-prompt.d.ts +7 -0
- package/dist/types/agent/throttle-circuit.d.ts +25 -0
- package/dist/types/agent/todo/continuation-policy.d.ts +54 -0
- package/dist/types/agent/todo/continuation-state.d.ts +11 -0
- package/dist/types/agent/todo/continuation-wiring.d.ts +32 -0
- package/dist/types/agent/todo/continuation.d.ts +21 -0
- package/dist/types/agent/todo/scope.d.ts +6 -0
- package/dist/types/agent/todo/store.d.ts +16 -0
- package/dist/types/agent/tool-error-remediation.d.ts +1 -0
- package/dist/types/agent/tool-file-safety.d.ts +78 -0
- package/dist/types/agent/tool-not-found-nudge.d.ts +9 -0
- package/dist/types/agent/tool-result-budget.d.ts +15 -0
- package/dist/types/agent/tools/channel-disengage.d.ts +18 -0
- package/dist/types/agent/tools/channel-edit.d.ts +19 -0
- package/dist/types/agent/tools/channel-fetch-attachment.d.ts +36 -0
- package/dist/types/agent/tools/channel-handoff.d.ts +13 -0
- package/dist/types/agent/tools/channel-history-render.d.ts +3 -0
- package/dist/types/agent/tools/channel-history.d.ts +25 -0
- package/dist/types/agent/tools/channel-log.d.ts +5 -0
- package/dist/types/agent/tools/channel-react.d.ts +23 -0
- package/dist/types/agent/tools/channel-read.d.ts +27 -0
- package/dist/types/agent/tools/channel-reply.d.ts +47 -0
- package/dist/types/agent/tools/channel-send.d.ts +42 -0
- package/dist/types/agent/tools/channel-session-search.d.ts +10 -0
- package/dist/types/agent/tools/curl-impersonate.d.ts +37 -0
- package/dist/types/agent/tools/ddg.d.ts +18 -0
- package/dist/types/agent/tools/grant-role.d.ts +25 -0
- package/dist/types/agent/tools/keyed-semaphore.d.ts +10 -0
- package/dist/types/agent/tools/post-github-review.d.ts +38 -0
- package/dist/types/agent/tools/restart.d.ts +25 -0
- package/dist/types/agent/tools/runtime-notice.d.ts +3 -0
- package/dist/types/agent/tools/search-retry.d.ts +16 -0
- package/dist/types/agent/tools/skip-response.d.ts +17 -0
- package/dist/types/agent/tools/spawn-subagent.d.ts +77 -0
- package/dist/types/agent/tools/stream-snapshot.d.ts +23 -0
- package/dist/types/agent/tools/subagent-access.d.ts +20 -0
- package/dist/types/agent/tools/subagent-cancel.d.ts +23 -0
- package/dist/types/agent/tools/subagent-output.d.ts +50 -0
- package/dist/types/agent/tools/todo/index.d.ts +14 -0
- package/dist/types/agent/tools/webfetch/adaptive-html.d.ts +29 -0
- package/dist/types/agent/tools/webfetch/fetch.d.ts +26 -0
- package/dist/types/agent/tools/webfetch/html-lexical.d.ts +27 -0
- package/dist/types/agent/tools/webfetch/index.d.ts +1 -0
- package/dist/types/agent/tools/webfetch/inline-style-visibility.d.ts +3 -0
- package/dist/types/agent/tools/webfetch/strategies/grep.d.ts +11 -0
- package/dist/types/agent/tools/webfetch/strategies/jq.d.ts +4 -0
- package/dist/types/agent/tools/webfetch/strategies/raw.d.ts +1 -0
- package/dist/types/agent/tools/webfetch/strategies/readability.d.ts +16 -0
- package/dist/types/agent/tools/webfetch/strategies/selector.d.ts +4 -0
- package/dist/types/agent/tools/webfetch/strategies/snapshot.d.ts +1 -0
- package/dist/types/agent/tools/webfetch/tool.d.ts +15 -0
- package/dist/types/agent/tools/webfetch/types.d.ts +32 -0
- package/dist/types/agent/tools/websearch.d.ts +17 -0
- package/dist/types/agent/tools/wikipedia.d.ts +7 -0
- package/dist/types/agent/tools-without-local-file-operands.d.ts +1 -0
- package/dist/types/agent/turn-runner.d.ts +36 -0
- package/dist/types/agent-messenger/config-dir.d.ts +19 -0
- package/dist/types/browser/dockerfile.d.ts +2 -0
- package/dist/types/browser/registry.d.ts +49 -0
- package/dist/types/bundled-plugins/bun-hygiene/policy.d.ts +18 -0
- package/dist/types/bundled-plugins/github-cli-auth/git-askpass.d.ts +5 -0
- package/dist/types/bundled-plugins/guard/keys.d.ts +6 -0
- package/dist/types/bundled-plugins/guard/policies/managed-config.d.ts +7 -0
- package/dist/types/bundled-plugins/guard/policies/memory-topics-delete.d.ts +11 -0
- package/dist/types/bundled-plugins/guard/policies/memory-topics-write.d.ts +7 -0
- package/dist/types/bundled-plugins/guard/policies/non-workspace-write.d.ts +9 -0
- package/dist/types/bundled-plugins/guard/policies/skill-authoring.d.ts +20 -0
- package/dist/types/bundled-plugins/guard/policies/uncommitted-changes.d.ts +12 -0
- package/dist/types/bundled-plugins/guard/policy.d.ts +11 -0
- package/dist/types/bundled-plugins/memory/secret-detector.d.ts +11 -0
- package/dist/types/bundled-plugins/memory/slug.d.ts +4 -0
- package/dist/types/bundled-plugins/security/permissions.d.ts +20 -0
- package/dist/types/bundled-plugins/security/policies/private-surface-read.d.ts +34 -0
- package/dist/types/bundled-plugins/security/policies/ssrf.d.ts +18 -0
- package/dist/types/bundled-plugins/security/policy.d.ts +4 -0
- package/dist/types/channels/adapter-namespace.d.ts +2 -0
- package/dist/types/channels/adapters/mention-hints.d.ts +12 -0
- package/dist/types/channels/adapters/webex-id-ref.d.ts +5 -0
- package/dist/types/channels/background-handoff.d.ts +56 -0
- package/dist/types/channels/background-obligations.d.ts +135 -0
- package/dist/types/channels/catch-up.d.ts +26 -0
- package/dist/types/channels/commands.d.ts +2 -0
- package/dist/types/channels/completion-claim.d.ts +20 -0
- package/dist/types/channels/continuation-willingness.d.ts +1 -0
- package/dist/types/channels/continuity-types.d.ts +75 -0
- package/dist/types/channels/describe-error.d.ts +1 -0
- package/dist/types/channels/engagement.d.ts +34 -0
- package/dist/types/channels/github-false-receipt.d.ts +20 -0
- package/dist/types/channels/github-repo.d.ts +2 -0
- package/dist/types/channels/github-rereview-guard.d.ts +24 -0
- package/dist/types/channels/github-review-check.d.ts +135 -0
- package/dist/types/channels/github-review-claim.d.ts +3 -0
- package/dist/types/channels/github-review-turn-ledger.d.ts +71 -0
- package/dist/types/channels/github-review-verdict-coordinator.d.ts +117 -0
- package/dist/types/channels/github-token-bridge.d.ts +20 -0
- package/dist/types/channels/github-verdict-activity.d.ts +12 -0
- package/dist/types/channels/inbound-journal.d.ts +272 -0
- package/dist/types/channels/last-alive.d.ts +3 -0
- package/dist/types/channels/membership-cache.d.ts +27 -0
- package/dist/types/channels/membership.d.ts +21 -0
- package/dist/types/channels/outbound-flood-filter.d.ts +7 -0
- package/dist/types/channels/participants.d.ts +4 -0
- package/dist/types/channels/persistence.d.ts +32 -0
- package/dist/types/channels/recovery-notice.d.ts +26 -0
- package/dist/types/channels/recovery-outbox.d.ts +58 -0
- package/dist/types/channels/router.d.ts +798 -0
- package/dist/types/channels/schema.d.ts +501 -0
- package/dist/types/channels/session-handoff.d.ts +58 -0
- package/dist/types/channels/session-search.d.ts +29 -0
- package/dist/types/channels/types.d.ts +414 -0
- package/dist/types/channels/waiting-reactions.d.ts +25 -0
- package/dist/types/cli/builtins.d.ts +2 -0
- package/dist/types/cli/command-meta.d.ts +9 -0
- package/dist/types/coding-agent/broker-body.d.ts +7 -0
- package/dist/types/coding-agent/broker.d.ts +22 -0
- package/dist/types/coding-agent/claude.d.ts +22 -0
- package/dist/types/coding-agent/codex.d.ts +19 -0
- package/dist/types/coding-agent/index.d.ts +71 -0
- package/dist/types/coding-agent/omo-state.d.ts +2 -0
- package/dist/types/coding-agent/omo-stream.d.ts +22 -0
- package/dist/types/coding-agent/omo.d.ts +133 -0
- package/dist/types/coding-agent/runner.d.ts +35 -0
- package/dist/types/coding-agent/tool.d.ts +27 -0
- package/dist/types/coding-agent/worktree.d.ts +22 -0
- package/dist/types/commands/index.d.ts +45 -0
- package/dist/types/config/config.d.ts +814 -0
- package/dist/types/config/index.d.ts +3 -0
- package/dist/types/config/model-overrides.d.ts +3 -0
- package/dist/types/config/providers.d.ts +1456 -0
- package/dist/types/config/reloadable.d.ts +9 -0
- package/dist/types/container/agent-operation-lock.d.ts +31 -0
- package/dist/types/container/build-cache.d.ts +39 -0
- package/dist/types/container/compose-project.d.ts +1 -0
- package/dist/types/container/controller.d.ts +25 -0
- package/dist/types/container/docker-app.d.ts +23 -0
- package/dist/types/container/exit-reason.d.ts +10 -0
- package/dist/types/container/index.d.ts +14 -0
- package/dist/types/container/log-archive.d.ts +68 -0
- package/dist/types/container/log-colors.d.ts +3 -0
- package/dist/types/container/log-timestamps.d.ts +9 -0
- package/dist/types/container/logs.d.ts +37 -0
- package/dist/types/container/memory-limit.d.ts +13 -0
- package/dist/types/container/memory-oversubscription.d.ts +20 -0
- package/dist/types/container/oom-events.d.ts +18 -0
- package/dist/types/container/port.d.ts +18 -0
- package/dist/types/container/require-running.d.ts +16 -0
- package/dist/types/container/restart.d.ts +32 -0
- package/dist/types/container/shared.d.ts +93 -0
- package/dist/types/container/shell.d.ts +35 -0
- package/dist/types/container/start.d.ts +144 -0
- package/dist/types/container/stats.d.ts +31 -0
- package/dist/types/container/status.d.ts +25 -0
- package/dist/types/container/stop.d.ts +24 -0
- package/dist/types/container/tool-oom-priority.d.ts +4 -0
- package/dist/types/container/verify-running.d.ts +49 -0
- package/dist/types/cron/consumer.d.ts +42 -0
- package/dist/types/cron/count-state.d.ts +24 -0
- package/dist/types/cron/index.d.ts +21 -0
- package/dist/types/cron/list.d.ts +33 -0
- package/dist/types/cron/reloadable.d.ts +11 -0
- package/dist/types/cron/scheduler.d.ts +51 -0
- package/dist/types/cron/schema.d.ts +108 -0
- package/dist/types/dependencies/bin-resolver.d.ts +28 -0
- package/dist/types/dependencies/bins.d.ts +22 -0
- package/dist/types/dependencies/index.d.ts +2 -0
- package/dist/types/git/bound-gc-config.d.ts +4 -0
- package/dist/types/git/hookless.d.ts +1 -0
- package/dist/types/git/reconcile-ignored.d.ts +13 -0
- package/dist/types/git/resolve-agent-git.d.ts +8 -0
- package/dist/types/git/resolve-identity.d.ts +10 -0
- package/dist/types/git/run.d.ts +24 -0
- package/dist/types/git/system-commit.d.ts +2 -0
- package/dist/types/hostd/client.d.ts +13 -0
- package/dist/types/hostd/models.d.ts +1 -0
- package/dist/types/hostd/paths.d.ts +17 -0
- package/dist/types/hostd/protocol.d.ts +93 -0
- package/dist/types/hostd/spawn.d.ts +17 -0
- package/dist/types/hostd/version.d.ts +18 -0
- package/dist/types/init/auto-upgrade.d.ts +41 -0
- package/dist/types/init/cli-version.d.ts +7 -0
- package/dist/types/init/dockerfile.d.ts +34 -0
- package/dist/types/init/ensure-deps.d.ts +17 -0
- package/dist/types/init/env-file.d.ts +3 -0
- package/dist/types/init/gitignore.d.ts +5 -0
- package/dist/types/init/local-source-stamp.d.ts +3 -0
- package/dist/types/init/packagejson.d.ts +7 -0
- package/dist/types/init/paths.d.ts +3 -0
- package/dist/types/init/reconcile-plugin-deps.d.ts +13 -0
- package/dist/types/init/run-bun-install.d.ts +16 -0
- package/dist/types/init/windows-dev-link.d.ts +8 -0
- package/dist/types/mcp/catalog.d.ts +7 -0
- package/dist/types/mcp/client.d.ts +58 -0
- package/dist/types/mcp/manager.d.ts +56 -0
- package/dist/types/mcp/tools.d.ts +23 -0
- package/dist/types/models/embedding-model.d.ts +20 -0
- package/dist/types/models/transformers-version.d.ts +1 -0
- package/dist/types/network/internal-destinations.d.ts +29 -0
- package/dist/types/operations/classify-tool-outcome.d.ts +35 -0
- package/dist/types/operations/incidents.d.ts +47 -0
- package/dist/types/operations/index.d.ts +3 -0
- package/dist/types/operations/remediations.d.ts +25 -0
- package/dist/types/path-safety/real-intended-path.d.ts +9 -0
- package/dist/types/permissions/builtins.d.ts +25 -0
- package/dist/types/permissions/grant.d.ts +19 -0
- package/dist/types/permissions/index.d.ts +6 -0
- package/dist/types/permissions/match-rule.d.ts +28 -0
- package/dist/types/permissions/permissions.d.ts +42 -0
- package/dist/types/permissions/resolve.d.ts +25 -0
- package/dist/types/permissions/schema.d.ts +14 -0
- package/dist/types/plugin/context.d.ts +20 -0
- package/dist/types/plugin/core-tool-names.d.ts +4 -0
- package/dist/types/plugin/define.d.ts +46 -0
- package/dist/types/plugin/hooks.d.ts +52 -0
- package/dist/types/plugin/index.d.ts +11 -0
- package/dist/types/plugin/load-skill.d.ts +14 -0
- package/dist/types/plugin/loader.d.ts +25 -0
- package/dist/types/plugin/manager.d.ts +42 -0
- package/dist/types/plugin/registry.d.ts +73 -0
- package/dist/types/plugin/skills.d.ts +11 -0
- package/dist/types/plugin/types.d.ts +336 -0
- package/dist/types/plugin/zod-introspect.d.ts +11 -0
- package/dist/types/reload/client.d.ts +11 -0
- package/dist/types/reload/docker-exec-client.d.ts +11 -0
- package/dist/types/reload/format.d.ts +2 -0
- package/dist/types/reload/index.d.ts +6 -0
- package/dist/types/reload/recover.d.ts +22 -0
- package/dist/types/reload/registry.d.ts +10 -0
- package/dist/types/reload/types.d.ts +25 -0
- package/dist/types/role-claim/client.d.ts +20 -0
- package/dist/types/role-claim/code.d.ts +4 -0
- package/dist/types/role-claim/controller.d.ts +59 -0
- package/dist/types/role-claim/index.d.ts +6 -0
- package/dist/types/role-claim/match-rule.d.ts +9 -0
- package/dist/types/role-claim/pending.d.ts +35 -0
- package/dist/types/role-claim/reload-after-claim.d.ts +16 -0
- package/dist/types/run/llm-fetch-observer.d.ts +50 -0
- package/dist/types/sandbox/availability.d.ts +21 -0
- package/dist/types/sandbox/build.d.ts +7 -0
- package/dist/types/sandbox/canonical-secrets.d.ts +8 -0
- package/dist/types/sandbox/coding-agent.d.ts +20 -0
- package/dist/types/sandbox/dependency-bins.d.ts +19 -0
- package/dist/types/sandbox/dev-source.d.ts +4 -0
- package/dist/types/sandbox/env-exposure.d.ts +1 -0
- package/dist/types/sandbox/errors.d.ts +20 -0
- package/dist/types/sandbox/hidden-paths.d.ts +11 -0
- package/dist/types/sandbox/index.d.ts +14 -0
- package/dist/types/sandbox/package-install.d.ts +1 -0
- package/dist/types/sandbox/policy.d.ts +71 -0
- package/dist/types/sandbox/privileged-runtime.d.ts +13 -0
- package/dist/types/sandbox/quote.d.ts +2 -0
- package/dist/types/sandbox/runtime-private.d.ts +1 -0
- package/dist/types/sandbox/session-tmp.d.ts +6 -0
- package/dist/types/sandbox/symlinks.d.ts +6 -0
- package/dist/types/sandbox/writable-zones.d.ts +15 -0
- package/dist/types/secrets/coding-agent-auth.d.ts +25 -0
- package/dist/types/secrets/defaults.d.ts +21 -0
- package/dist/types/secrets/export-github-cli-store.d.ts +22 -0
- package/dist/types/secrets/hydrate.d.ts +7 -0
- package/dist/types/secrets/index.d.ts +7 -0
- package/dist/types/secrets/provision-github-cli-store.d.ts +45 -0
- package/dist/types/secrets/refresh-provider-oauth.d.ts +22 -0
- package/dist/types/secrets/resolve.d.ts +14 -0
- package/dist/types/secrets/schema.d.ts +840 -0
- package/dist/types/secrets/storage.d.ts +56 -0
- package/dist/types/shared/host-locale.d.ts +1 -0
- package/dist/types/shared/index.d.ts +5 -0
- package/dist/types/shared/local-time.d.ts +4 -0
- package/dist/types/shared/platform.d.ts +2 -0
- package/dist/types/shared/protocol.d.ts +424 -0
- package/dist/types/shared/style-text.d.ts +3 -0
- package/dist/types/shared/wsl.d.ts +17 -0
- package/dist/types/stream/broker.d.ts +2 -0
- package/dist/types/stream/index.d.ts +2 -0
- package/dist/types/stream/types.d.ts +71 -0
- package/package.json +9 -2
- 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/guard-types.ts +3 -0
- package/src/agent/guards.ts +4 -0
- package/src/agent/idle-compaction.ts +174 -0
- package/src/agent/index.ts +74 -16
- package/src/agent/live-subagents.ts +19 -0
- package/src/agent/multimodal/look-at.ts +22 -9
- package/src/agent/plugin-tools.ts +13 -1
- package/src/agent/reviewer-bash-policy.ts +41 -1
- package/src/agent/session-origin.ts +26 -10
- package/src/agent/subagent-cache-keepalive.ts +198 -0
- package/src/agent/subagent-session.ts +6 -0
- package/src/agent/subagents.ts +46 -8
- package/src/agent/system-prompt.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 +13 -5
- 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/browser/bsk-shim.mjs +74 -0
- package/src/browser/dockerfile.ts +84 -0
- package/src/browser/egress.ts +104 -0
- package/src/browser/managed-browser.ts +205 -0
- package/src/browser/registry.ts +110 -0
- package/src/browser/relay.ts +231 -0
- package/src/browser/sandbox-entry.ts +167 -0
- package/src/bundled-plugins/agent-browser/index.ts +2 -0
- package/src/bundled-plugins/browser-agent/browser-agent.ts +89 -0
- package/src/bundled-plugins/browser-agent/index.ts +12 -0
- package/src/bundled-plugins/doc-render/index.ts +0 -10
- package/src/bundled-plugins/doc-render/render.ts +83 -111
- package/src/bundled-plugins/doc-render/skills/typeclaw-render-pdf/SKILL.md +152 -257
- package/src/bundled-plugins/github-cli-auth/gh-command.ts +4 -0
- package/src/bundled-plugins/github-cli-auth/git-auth-diagnostic.ts +95 -0
- package/src/bundled-plugins/github-cli-auth/index.ts +75 -59
- package/src/bundled-plugins/managed-browser/index.ts +74 -0
- package/src/bundled-plugins/managed-browser/skills/browser-use/browser-use/SKILL.md +27 -0
- package/src/bundled-plugins/managed-browser/skills/browserskill/browserskill/SKILL.md +28 -0
- package/src/bundled-plugins/managed-browser/skills/omowright/omowright/SKILL.md +40 -0
- package/src/bundled-plugins/operator/operator.ts +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/channels/adapter-namespace.ts +13 -0
- package/src/channels/adapters/discord-bot.ts +97 -5
- 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-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 +427 -136
- 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/types.ts +12 -2
- package/src/cli/channel.ts +2 -3
- 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 +111 -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 +59 -0
- package/src/container/start.ts +95 -4
- package/src/doctor/checks.ts +8 -6
- 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/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/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/hidden-paths.ts +16 -2
- package/src/secrets/storage.ts +13 -0
- package/src/skills/typeclaw-channel-github/SKILL.md +8 -8
- package/src/skills/typeclaw-config/SKILL.md +39 -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 +436 -5
- package/src/bundled-plugins/doc-render/templates/lib.typ +0 -339
- package/src/bundled-plugins/github-cli-auth/gh-store.ts +0 -733
|
@@ -15,6 +15,7 @@ import {
|
|
|
15
15
|
} from '@/channels/router'
|
|
16
16
|
import type { AdapterId } from '@/channels/schema'
|
|
17
17
|
import type { GithubReviewFollowupRound } from '@/channels/types'
|
|
18
|
+
import type { ChannelOutboundOrigin } from '@/plugin'
|
|
18
19
|
|
|
19
20
|
import { type ChannelToolLogger, consoleChannelLogger, formatChannelToolFailure } from './channel-log'
|
|
20
21
|
import { fenceRuntimeNotice, fenceToolResult } from './runtime-notice'
|
|
@@ -30,6 +31,7 @@ export type ChannelReplyOrigin = {
|
|
|
30
31
|
export type CreateChannelReplyToolOptions = {
|
|
31
32
|
router: ChannelRouter
|
|
32
33
|
origin: ChannelReplyOrigin
|
|
34
|
+
getOutboundOrigin?: () => ChannelOutboundOrigin | undefined
|
|
33
35
|
// Scopes the per-turn false-receipt ledger. Defaults to '' when a caller (e.g.
|
|
34
36
|
// a focused test) has no session; the guard then simply finds no recorded
|
|
35
37
|
// action and falls back to its safe default.
|
|
@@ -49,6 +51,7 @@ export type CreateChannelReplyToolOptions = {
|
|
|
49
51
|
export function createChannelReplyTool({
|
|
50
52
|
router,
|
|
51
53
|
origin,
|
|
54
|
+
getOutboundOrigin,
|
|
52
55
|
sessionId = '',
|
|
53
56
|
logger = consoleChannelLogger,
|
|
54
57
|
}: CreateChannelReplyToolOptions) {
|
|
@@ -58,8 +61,8 @@ export function createChannelReplyTool({
|
|
|
58
61
|
description:
|
|
59
62
|
'Reply in the current conversation. This is your default way to respond to a channel session — ' +
|
|
60
63
|
'addressing fields (adapter, workspace, chat, thread) are filled in from the session origin, so ' +
|
|
61
|
-
'you only supply the text.
|
|
62
|
-
'
|
|
64
|
+
'you only supply the text. For work belonging to another conversation, use `channel_session_search` ' +
|
|
65
|
+
'then `channel_handoff` so its owning session answers with current context. ' +
|
|
63
66
|
'On success the result carries adapter-reported posted-message ids (`messageId` and `messageIds` ' +
|
|
64
67
|
'in send order) when available. For follow-ups, reuse `channel_reply` or the existing ' +
|
|
65
68
|
'`channel_send` thread/root coordinates; a returned id starts a thread only where the adapter ' +
|
|
@@ -94,17 +97,17 @@ export function createChannelReplyTool({
|
|
|
94
97
|
},
|
|
95
98
|
),
|
|
96
99
|
),
|
|
97
|
-
|
|
100
|
+
continue_after_reply: Type.Boolean({
|
|
98
101
|
description:
|
|
99
102
|
'REQUIRED on every channel_reply — you must explicitly choose, there is no default. Set `true` when this reply is a mid-turn status update (e.g. "working on it…") and you still have MORE WORK to do THIS turn — fetching data, running a tool, spawning a subagent, then replying again; `true` keeps the turn alive so that follow-up actually runs. ' +
|
|
100
103
|
'Set `false` when this reply is your final message for the turn (the common case). ' +
|
|
101
|
-
'This choice is mandatory precisely because a missing value used to default to ending the turn silently: a successful reply ends the turn unless `
|
|
104
|
+
'This choice is mandatory precisely because a missing value used to default to ending the turn silently: a successful reply ends the turn unless `continue_after_reply` is `true`, so a `false` on an ack you meant to keep working from drops the work you promised. ' +
|
|
102
105
|
'Do not set `true` just to seem responsive; only when genuine multi-step work follows in the same turn.',
|
|
103
106
|
}),
|
|
104
107
|
resolve_review_thread: Type.Optional(
|
|
105
108
|
Type.Boolean({
|
|
106
109
|
description:
|
|
107
|
-
'GitHub PR review threads ONLY. On a TERMINAL (`
|
|
110
|
+
'GitHub PR review threads ONLY. On a TERMINAL (`continue_after_reply:false`) github PR review-thread reply that carries `text`, this is REQUIRED: you must set it to `true` or `false` and omitting it is rejected — you will be told to re-call with an explicit choice. (It stays a normal optional field everywhere else: ignored on Slack/Discord/Telegram/KakaoTalk and any non-github session, on github replies outside a review thread, on attachments-only replies, and on mid-turn `continue_after_reply:true` status updates — leave it unset there.) ' +
|
|
108
111
|
'Set `true` when your `text` acknowledges the concern is fixed/verified/addressed (e.g. "verified at <sha>", "thanks, that resolves it"): the runtime resolves the thread BEFORE posting, so the close-out actually happens in this same turn — a successful reply ends the turn, so a resolve deferred to "later" never runs. ' +
|
|
109
112
|
"Set `false` when the thread should stay open (partial fix, disagreement, mid-discussion). It is safe to set `true` by default: the runtime resolves ONLY if the thread's root comment is yours — it refuses (and blocks the reply) on a human reviewer's thread, so you never close someone else's open question. You need not pre-check authorship; let the runtime enforce ownership.",
|
|
110
113
|
}),
|
|
@@ -114,7 +117,7 @@ export function createChannelReplyTool({
|
|
|
114
117
|
async execute(_toolCallId, params) {
|
|
115
118
|
let text = params.text
|
|
116
119
|
const attachments = params.attachments
|
|
117
|
-
const keepTurnAlive = params.
|
|
120
|
+
const keepTurnAlive = params.continue_after_reply === true
|
|
118
121
|
if ((text === undefined || text === '') && (attachments === undefined || attachments.length === 0)) {
|
|
119
122
|
logger.warn(formatChannelToolFailure('channel_reply', 'missing text and attachments'))
|
|
120
123
|
return {
|
|
@@ -168,7 +171,7 @@ export function createChannelReplyTool({
|
|
|
168
171
|
if (keepTurnAlive && params.resolve_review_thread !== undefined) {
|
|
169
172
|
const error =
|
|
170
173
|
'`resolve_review_thread` is a terminal close-out decision and cannot be combined with ' +
|
|
171
|
-
'`
|
|
174
|
+
'`continue_after_reply: true`. Send a status without the decision, then close out the thread in a terminal reply.'
|
|
172
175
|
logger.warn(formatChannelToolFailure('channel_reply', error))
|
|
173
176
|
return {
|
|
174
177
|
content: [{ type: 'text' as const, text: `channel_reply denied: ${error}` }],
|
|
@@ -186,7 +189,7 @@ export function createChannelReplyTool({
|
|
|
186
189
|
const missingResolveChoice = missingReviewThreadResolveChoiceError({
|
|
187
190
|
origin,
|
|
188
191
|
text,
|
|
189
|
-
|
|
192
|
+
continueAfterReply: keepTurnAlive,
|
|
190
193
|
resolveReviewThread: params.resolve_review_thread,
|
|
191
194
|
})
|
|
192
195
|
if (missingResolveChoice) {
|
|
@@ -207,7 +210,7 @@ export function createChannelReplyTool({
|
|
|
207
210
|
chat: origin.chat,
|
|
208
211
|
thread: origin.thread,
|
|
209
212
|
text,
|
|
210
|
-
|
|
213
|
+
continueAfterReply: keepTurnAlive,
|
|
211
214
|
resolveReviewThread: params.resolve_review_thread === true,
|
|
212
215
|
})
|
|
213
216
|
if (falseReceipt.kind === 'block') {
|
|
@@ -243,7 +246,7 @@ export function createChannelReplyTool({
|
|
|
243
246
|
thread: origin.thread,
|
|
244
247
|
text,
|
|
245
248
|
wantsResolve: params.resolve_review_thread === true,
|
|
246
|
-
|
|
249
|
+
continueAfterReply: keepTurnAlive,
|
|
247
250
|
getReviewState: (req) => router.getReviewState(req),
|
|
248
251
|
...(origin.githubReviewRound !== undefined ? { round: origin.githubReviewRound } : {}),
|
|
249
252
|
})
|
|
@@ -280,7 +283,7 @@ export function createChannelReplyTool({
|
|
|
280
283
|
})
|
|
281
284
|
return {
|
|
282
285
|
content: [{ type: 'text' as const, text: alreadyResolvedHint(origin.thread) }],
|
|
283
|
-
details: { ok: true, ...(keepTurnAlive ? {
|
|
286
|
+
details: { ok: true, ...(keepTurnAlive ? { continue_after_reply: true } : {}) },
|
|
284
287
|
}
|
|
285
288
|
}
|
|
286
289
|
// `no-match` stays non-blocking (the thread may be genuinely gone) but
|
|
@@ -301,15 +304,19 @@ export function createChannelReplyTool({
|
|
|
301
304
|
|
|
302
305
|
const backgroundCoverage = (await router.captureBackgroundResultCoverage?.(sessionId)) ?? []
|
|
303
306
|
const inboundCoverage = (await router.captureInboundResultCoverage?.(sessionId)) ?? []
|
|
304
|
-
const
|
|
305
|
-
|
|
306
|
-
|
|
307
|
-
|
|
308
|
-
|
|
309
|
-
|
|
310
|
-
|
|
311
|
-
|
|
312
|
-
|
|
307
|
+
const outboundOrigin = getOutboundOrigin?.()
|
|
308
|
+
const result = await router.send(
|
|
309
|
+
{
|
|
310
|
+
adapter: origin.adapter,
|
|
311
|
+
workspace: origin.workspace,
|
|
312
|
+
chat: origin.chat,
|
|
313
|
+
thread: origin.thread,
|
|
314
|
+
...(text !== undefined ? { text } : {}),
|
|
315
|
+
...(params.link_previews !== undefined ? { link_previews: params.link_previews } : {}),
|
|
316
|
+
...(attachments !== undefined ? { attachments } : {}),
|
|
317
|
+
},
|
|
318
|
+
outboundOrigin ? { origin: outboundOrigin } : undefined,
|
|
319
|
+
)
|
|
313
320
|
|
|
314
321
|
if (!result.ok) {
|
|
315
322
|
logger.warn(
|
|
@@ -334,13 +341,13 @@ export function createChannelReplyTool({
|
|
|
334
341
|
decision: 'left-open',
|
|
335
342
|
})
|
|
336
343
|
}
|
|
337
|
-
// `
|
|
344
|
+
// `continue_after_reply` is read by the router's terminal hook (installChannelReplyTerminalHook),
|
|
338
345
|
// not by this tool — it suppresses the post-reply abort so a multi-step turn
|
|
339
346
|
// keeps going. Success-only: a denied reply never ran, so there is no turn to keep.
|
|
340
347
|
const details: {
|
|
341
348
|
ok: boolean
|
|
342
349
|
error?: string
|
|
343
|
-
|
|
350
|
+
continue_after_reply?: boolean
|
|
344
351
|
messageId?: string
|
|
345
352
|
messageIds?: readonly string[]
|
|
346
353
|
backgroundCoverage?: BackgroundObligationRef[]
|
|
@@ -350,7 +357,7 @@ export function createChannelReplyTool({
|
|
|
350
357
|
ok: true,
|
|
351
358
|
backgroundCoverage,
|
|
352
359
|
inboundCoverage,
|
|
353
|
-
...(keepTurnAlive ? {
|
|
360
|
+
...(keepTurnAlive ? { continue_after_reply: true } : {}),
|
|
354
361
|
...(result.messageId !== undefined ? { messageId: result.messageId } : {}),
|
|
355
362
|
...(result.messageIds !== undefined ? { messageIds: result.messageIds } : {}),
|
|
356
363
|
}
|
|
@@ -372,7 +379,7 @@ export function createChannelReplyTool({
|
|
|
372
379
|
// answering its own echo and looping (PR #481). Denials carry no echoed
|
|
373
380
|
// prose (just machine error text), so they keep the lighter prefix.
|
|
374
381
|
if (result.ok) {
|
|
375
|
-
const echo = renderOutboundEcho(text, attachments)
|
|
382
|
+
const echo = renderOutboundEcho(result.deliveredText ?? text, attachments)
|
|
376
383
|
const receipt =
|
|
377
384
|
`posted to ${origin.adapter}:${origin.workspace}/${origin.chat}: ${echo}` +
|
|
378
385
|
(result.messageId !== undefined ? `\nmessage_id=${JSON.stringify(result.messageId)}` : '') +
|
|
@@ -419,13 +426,13 @@ function parseGithubPrNumber(chat: string): number {
|
|
|
419
426
|
function missingReviewThreadResolveChoiceError(input: {
|
|
420
427
|
origin: ChannelReplyOrigin
|
|
421
428
|
text: string | undefined
|
|
422
|
-
|
|
429
|
+
continueAfterReply: boolean
|
|
423
430
|
resolveReviewThread: boolean | undefined
|
|
424
431
|
}): string {
|
|
425
432
|
const isGithubPrReviewThread =
|
|
426
433
|
input.origin.adapter === 'github' && /^pr:\d+$/.test(input.origin.chat) && input.origin.thread !== null
|
|
427
434
|
const hasText = input.text !== undefined && input.text.trim() !== ''
|
|
428
|
-
if (!isGithubPrReviewThread || !hasText || input.
|
|
435
|
+
if (!isGithubPrReviewThread || !hasText || input.continueAfterReply || input.resolveReviewThread !== undefined) {
|
|
429
436
|
return ''
|
|
430
437
|
}
|
|
431
438
|
return (
|
|
@@ -15,6 +15,7 @@ import {
|
|
|
15
15
|
} from '@/channels/router'
|
|
16
16
|
import { ADAPTER_IDS, type AdapterId } from '@/channels/schema'
|
|
17
17
|
import type { GithubReviewFollowupRound } from '@/channels/types'
|
|
18
|
+
import type { ChannelOutboundOrigin } from '@/plugin'
|
|
18
19
|
|
|
19
20
|
import { type ChannelToolLogger, consoleChannelLogger, formatChannelToolFailure } from './channel-log'
|
|
20
21
|
import { renderOutboundEcho, TOOL_RESULT_PREFIX } from './channel-reply'
|
|
@@ -36,6 +37,7 @@ export type CreateChannelSendToolOptions = {
|
|
|
36
37
|
// the model can self-correct on its next turn. Absent for sessions whose
|
|
37
38
|
// origin isn't a channel (e.g. cron prompts that send to channels).
|
|
38
39
|
origin?: ChannelSendOrigin
|
|
40
|
+
getOutboundOrigin?: () => ChannelOutboundOrigin | undefined
|
|
39
41
|
// Scopes the per-turn false-receipt ledger for github resolve close-outs.
|
|
40
42
|
// Defaults to '' when absent (cron / non-channel sessions); the guard then
|
|
41
43
|
// finds no recorded action and falls back to its safe default.
|
|
@@ -46,6 +48,7 @@ export type CreateChannelSendToolOptions = {
|
|
|
46
48
|
export function createChannelSendTool({
|
|
47
49
|
router,
|
|
48
50
|
origin,
|
|
51
|
+
getOutboundOrigin,
|
|
49
52
|
sessionId = '',
|
|
50
53
|
logger = consoleChannelLogger,
|
|
51
54
|
}: CreateChannelSendToolOptions) {
|
|
@@ -63,7 +66,8 @@ export function createChannelSendTool({
|
|
|
63
66
|
'or use `channel_reply`. A returned id starts a thread only where the adapter accepts a message ' +
|
|
64
67
|
'id as `thread` (e.g. a new top-level Slack post); other adapters use different thread ids. ' +
|
|
65
68
|
'Some adapters do not report ids. ' +
|
|
66
|
-
'
|
|
69
|
+
'For work belonging to another conversation, use channel_session_search and channel_handoff so the owning ' +
|
|
70
|
+
'session answers with current context. Use this tool for an explicit direct post, not to take over that work.',
|
|
67
71
|
parameters: Type.Object({
|
|
68
72
|
adapter: Type.Union(
|
|
69
73
|
ADAPTER_IDS.map((a) => Type.Literal(a)),
|
|
@@ -220,7 +224,7 @@ export function createChannelSendTool({
|
|
|
220
224
|
chat: params.chat,
|
|
221
225
|
thread: params.thread ?? null,
|
|
222
226
|
text: bodyText,
|
|
223
|
-
|
|
227
|
+
continueAfterReply: false,
|
|
224
228
|
resolveReviewThread: wantsResolve,
|
|
225
229
|
})
|
|
226
230
|
if (falseReceipt.kind === 'block') {
|
|
@@ -242,7 +246,7 @@ export function createChannelSendTool({
|
|
|
242
246
|
thread: params.thread ?? null,
|
|
243
247
|
text: bodyText,
|
|
244
248
|
wantsResolve,
|
|
245
|
-
|
|
249
|
+
continueAfterReply: false,
|
|
246
250
|
getReviewState: (req) => router.getReviewState(req),
|
|
247
251
|
...(origin !== undefined &&
|
|
248
252
|
origin.adapter === adapter &&
|
|
@@ -331,15 +335,19 @@ export function createChannelSendTool({
|
|
|
331
335
|
? ((await router.captureBackgroundResultCoverage?.(sessionId)) ?? [])
|
|
332
336
|
: []
|
|
333
337
|
const inboundCoverage = settlesOrigin ? ((await router.captureInboundResultCoverage?.(sessionId)) ?? []) : []
|
|
334
|
-
const
|
|
335
|
-
|
|
336
|
-
|
|
337
|
-
|
|
338
|
-
|
|
339
|
-
|
|
340
|
-
|
|
341
|
-
|
|
342
|
-
|
|
338
|
+
const outboundOrigin = getOutboundOrigin?.()
|
|
339
|
+
const result = await router.send(
|
|
340
|
+
{
|
|
341
|
+
adapter,
|
|
342
|
+
workspace: params.workspace,
|
|
343
|
+
chat: params.chat,
|
|
344
|
+
...(params.thread !== undefined ? { thread: params.thread } : {}),
|
|
345
|
+
...(bodyText !== undefined ? { text: bodyText } : {}),
|
|
346
|
+
...(params.link_previews !== undefined ? { link_previews: params.link_previews } : {}),
|
|
347
|
+
...(attachments !== undefined ? { attachments } : {}),
|
|
348
|
+
},
|
|
349
|
+
outboundOrigin ? { origin: outboundOrigin } : undefined,
|
|
350
|
+
)
|
|
343
351
|
|
|
344
352
|
if (!result.ok) {
|
|
345
353
|
logger.warn(
|
|
@@ -386,7 +394,7 @@ export function createChannelSendTool({
|
|
|
386
394
|
// denials keep the lighter prefix. See channel-reply.ts for the full
|
|
387
395
|
// rationale (PR #481 self-reply loop).
|
|
388
396
|
if (result.ok) {
|
|
389
|
-
const echo = renderOutboundEcho(bodyText, attachments)
|
|
397
|
+
const echo = renderOutboundEcho(result.deliveredText ?? bodyText, attachments)
|
|
390
398
|
const receipt =
|
|
391
399
|
`posted to ${params.adapter}:${params.workspace}/${params.chat}: ${echo}` +
|
|
392
400
|
(result.messageId !== undefined ? `\nmessage_id=${JSON.stringify(result.messageId)}` : '') +
|
|
@@ -0,0 +1,35 @@
|
|
|
1
|
+
import { Type } from '@earendil-works/pi-ai'
|
|
2
|
+
import { defineTool } from '@earendil-works/pi-coding-agent'
|
|
3
|
+
|
|
4
|
+
import type { ChannelRouter } from '@/channels/router'
|
|
5
|
+
|
|
6
|
+
export function createChannelSessionSearchTool(options: {
|
|
7
|
+
router: Pick<ChannelRouter, 'searchSessions'>
|
|
8
|
+
sessionId: string
|
|
9
|
+
}) {
|
|
10
|
+
return defineTool({
|
|
11
|
+
name: 'channel_session_search',
|
|
12
|
+
label: 'Channel Session Search',
|
|
13
|
+
description:
|
|
14
|
+
'Find the session that owns another conversation across all adapters. Search conversation names, recent ' +
|
|
15
|
+
'messages, or participants in any language. Returns up to 20 authorized, live handoff targets with short ' +
|
|
16
|
+
'activity hints, newest first. For work belonging elsewhere, search here and pass a result target to ' +
|
|
17
|
+
'channel_handoff instead of reading or posting there yourself. Identity comes from your authenticated ' +
|
|
18
|
+
'requester, never from the query. No results means no eligible live session was found.',
|
|
19
|
+
parameters: Type.Object({
|
|
20
|
+
query: Type.String({ description: 'Conversation name, topic, message text, or participant.', minLength: 1 }),
|
|
21
|
+
}),
|
|
22
|
+
async execute(_toolCallId, params) {
|
|
23
|
+
const targets = options.router.searchSessions({ fromSessionId: options.sessionId, query: params.query })
|
|
24
|
+
return {
|
|
25
|
+
content: [
|
|
26
|
+
{
|
|
27
|
+
type: 'text' as const,
|
|
28
|
+
text: targets.length === 0 ? 'No eligible live sessions found.' : JSON.stringify(targets),
|
|
29
|
+
},
|
|
30
|
+
],
|
|
31
|
+
details: { targets },
|
|
32
|
+
}
|
|
33
|
+
},
|
|
34
|
+
})
|
|
35
|
+
}
|
|
@@ -28,18 +28,21 @@ import { withToolOomPriorityArgv } from '@/container/tool-oom-priority'
|
|
|
28
28
|
export const CURL_IMPERSONATE_BINARY = 'curl_chrome136'
|
|
29
29
|
export const DEFAULT_TIMEOUT_SECONDS = 30
|
|
30
30
|
|
|
31
|
-
let
|
|
31
|
+
let binaryOverrideForTest: string | null = null
|
|
32
32
|
|
|
33
33
|
// Test-only seam: lets *.test.ts point the spawn at a fake `curl_chrome136`
|
|
34
34
|
// script in a tmpdir so we exercise the real Bun.spawn path without depending
|
|
35
35
|
// on a curl-impersonate install on the test host. Production code never calls
|
|
36
36
|
// this — the module-level default above is what production sees.
|
|
37
37
|
export function _setCurlBinaryForTest(binary: string | null): void {
|
|
38
|
-
|
|
38
|
+
binaryOverrideForTest = binary
|
|
39
39
|
}
|
|
40
40
|
|
|
41
41
|
export type CurlImpersonateRequest = {
|
|
42
42
|
url: string
|
|
43
|
+
// Wrapper to impersonate (e.g. `curl_firefox147`). Defaults to
|
|
44
|
+
// CURL_IMPERSONATE_BINARY. Only names shipped in the pinned tarball work.
|
|
45
|
+
binary?: string
|
|
43
46
|
method?: 'GET' | 'POST'
|
|
44
47
|
// Form-urlencoded body fields for POST. Each entry is passed as a separate
|
|
45
48
|
// --data-urlencode argument so curl handles the encoding. Required if
|
|
@@ -131,7 +134,7 @@ export async function curlImpersonate(req: CurlImpersonateRequest): Promise<Curl
|
|
|
131
134
|
const writeOutTemplate = `${sentinel}%{http_code}\n%{url_effective}\n%{content_type}\n%{size_download}\n%{header_json}\n`
|
|
132
135
|
|
|
133
136
|
const cmd: string[] = [
|
|
134
|
-
|
|
137
|
+
binaryOverrideForTest ?? req.binary ?? CURL_IMPERSONATE_BINARY,
|
|
135
138
|
// `--disable` (alias -q) MUST be the first argument to suppress reading
|
|
136
139
|
// ~/.curlrc and /etc/curlrc. Without it, a user or attacker-controlled
|
|
137
140
|
// curlrc could inject --proxy, --header, --resolve, --no-location, etc.,
|
|
@@ -334,7 +337,11 @@ let availabilityCache: boolean | undefined
|
|
|
334
337
|
export async function isCurlImpersonateAvailable(): Promise<boolean> {
|
|
335
338
|
if (availabilityCache !== undefined) return availabilityCache
|
|
336
339
|
try {
|
|
337
|
-
const proc = spawn({
|
|
340
|
+
const proc = spawn({
|
|
341
|
+
cmd: [binaryOverrideForTest ?? CURL_IMPERSONATE_BINARY, '--version'],
|
|
342
|
+
stdout: 'ignore',
|
|
343
|
+
stderr: 'ignore',
|
|
344
|
+
})
|
|
338
345
|
const code = await proc.exited
|
|
339
346
|
availabilityCache = code === 0
|
|
340
347
|
} catch {
|
package/src/agent/tools/ddg.ts
CHANGED
|
@@ -20,6 +20,13 @@ export { _setCurlBinaryForTest } from './curl-impersonate'
|
|
|
20
20
|
|
|
21
21
|
const DDG_LITE_URL = 'https://lite.duckduckgo.com/lite/'
|
|
22
22
|
|
|
23
|
+
// As of 2026-10 DDG-lite answers every desktop Chrome fingerprint (124-146,
|
|
24
|
+
// including the curl_chrome136 default) with a 202 challenge page from IPs
|
|
25
|
+
// where Firefox and Safari fingerprints still get a normal SERP. Try them in
|
|
26
|
+
// order and only treat the request as CAPTCHA'd when every profile is
|
|
27
|
+
// challenged. Both wrappers ship in the pinned curl-impersonate tarball.
|
|
28
|
+
export const DDG_PROFILES = ['curl_firefox147', 'curl_safari184'] as const
|
|
29
|
+
|
|
23
30
|
// Empirically derived: a clean source IP serves DDG-lite at concurrency ~4 but
|
|
24
31
|
// trips a sticky multi-minute CAPTCHA at 5-6 (see keyed-semaphore.ts header).
|
|
25
32
|
// The whole agent egresses from one IP and the scout subagent fans out parallel
|
|
@@ -55,11 +62,11 @@ export async function ddgSearch(query: string, limit: number, signal?: AbortSign
|
|
|
55
62
|
() =>
|
|
56
63
|
withSearchRetry(
|
|
57
64
|
async () => {
|
|
58
|
-
const
|
|
59
|
-
|
|
60
|
-
|
|
65
|
+
for (const binary of DDG_PROFILES) {
|
|
66
|
+
const html = await fetchDdgHtml(query, signal, binary)
|
|
67
|
+
if (!isCaptcha(html)) return parseDdgHtml(html).slice(0, limit)
|
|
61
68
|
}
|
|
62
|
-
|
|
69
|
+
throw new DdgCaptchaError()
|
|
63
70
|
},
|
|
64
71
|
{ ...retryOverride, shouldRetry: isTransientSearchError, signal },
|
|
65
72
|
),
|
|
@@ -88,9 +95,10 @@ export class DdgCaptchaError extends Error {
|
|
|
88
95
|
}
|
|
89
96
|
}
|
|
90
97
|
|
|
91
|
-
export async function fetchDdgHtml(query: string, signal?: AbortSignal): Promise<string> {
|
|
98
|
+
export async function fetchDdgHtml(query: string, signal?: AbortSignal, binary?: string): Promise<string> {
|
|
92
99
|
const response = await curlImpersonate({
|
|
93
100
|
url: DDG_LITE_URL,
|
|
101
|
+
binary,
|
|
94
102
|
method: 'POST',
|
|
95
103
|
formFields: [{ name: 'q', value: query }],
|
|
96
104
|
signal,
|
|
@@ -182,17 +182,6 @@ export function createSpawnSubagentTool(options: CreateSpawnSubagentToolOptions)
|
|
|
182
182
|
)
|
|
183
183
|
}
|
|
184
184
|
const subagentName = params.subagent_type
|
|
185
|
-
const { background, overrideNote } = resolveSpawnMode({
|
|
186
|
-
foreground: params.run_in_foreground,
|
|
187
|
-
fromSubagent: origin?.kind === 'subagent',
|
|
188
|
-
// Deep-profile spawns run for minutes; forcing them background from a
|
|
189
|
-
// top-level session keeps a foreground run from freezing the message
|
|
190
|
-
// loop. Per-spawn override wins over the declared profile.
|
|
191
|
-
isDeepProfile: (params.profile ?? subagent.profile) === 'deep',
|
|
192
|
-
canBackgroundFromSubagent: allowBackgroundFromSubagent === true,
|
|
193
|
-
subagentName,
|
|
194
|
-
})
|
|
195
|
-
|
|
196
185
|
const taskId = generateTaskId()
|
|
197
186
|
const payload: Record<string, unknown> = { requestId: taskId, prompt: params.prompt }
|
|
198
187
|
if (params.description !== undefined) payload.description = params.description
|
|
@@ -213,6 +202,17 @@ export function createSpawnSubagentTool(options: CreateSpawnSubagentToolOptions)
|
|
|
213
202
|
params.review_identity === undefined
|
|
214
203
|
? undefined
|
|
215
204
|
: githubReviewerWorkKey(params.review_identity.repo, params.review_identity.pull_request)
|
|
205
|
+
const { background, overrideNote } = resolveSpawnMode({
|
|
206
|
+
foreground: params.run_in_foreground,
|
|
207
|
+
fromSubagent: origin?.kind === 'subagent',
|
|
208
|
+
// Deep-profile spawns run for minutes; forcing them background from a
|
|
209
|
+
// top-level session keeps a foreground run from freezing the message
|
|
210
|
+
// loop. Judged on the profile the session will actually run, so an
|
|
211
|
+
// override the subagent's schema strips cannot unlock foreground.
|
|
212
|
+
isDeepProfile: effectiveSpawnProfile(subagent, payload) === 'deep',
|
|
213
|
+
canBackgroundFromSubagent: allowBackgroundFromSubagent === true,
|
|
214
|
+
subagentName,
|
|
215
|
+
})
|
|
216
216
|
|
|
217
217
|
const coalesceKey = subagentCoalesceKey({
|
|
218
218
|
parentSessionId,
|
|
@@ -659,6 +659,22 @@ export type SpawnModeResolution = {
|
|
|
659
659
|
overrideNote: string | undefined
|
|
660
660
|
}
|
|
661
661
|
|
|
662
|
+
// The profile the spawned session will actually run. A payload schema may strip
|
|
663
|
+
// a per-spawn `profile` (scout/explorer/browser pin their tier), so read it from
|
|
664
|
+
// the validated payload; an invalid payload fails at invocation, so judge it on
|
|
665
|
+
// the raw override until then.
|
|
666
|
+
export function effectiveSpawnProfile(
|
|
667
|
+
subagent: Pick<Subagent<any>, 'profile' | 'payloadSchema'>,
|
|
668
|
+
payload: Record<string, unknown>,
|
|
669
|
+
): string | undefined {
|
|
670
|
+
const raw = typeof payload.profile === 'string' ? payload.profile : undefined
|
|
671
|
+
if (subagent.payloadSchema === undefined) return raw ?? subagent.profile
|
|
672
|
+
const parsed = subagent.payloadSchema.safeParse(payload)
|
|
673
|
+
if (!parsed.success) return raw ?? subagent.profile
|
|
674
|
+
const kept = (parsed.data as { profile?: unknown } | null | undefined)?.profile
|
|
675
|
+
return typeof kept === 'string' && kept !== '' ? kept : subagent.profile
|
|
676
|
+
}
|
|
677
|
+
|
|
662
678
|
// Resolve foreground vs background for a spawn, with the runtime free to
|
|
663
679
|
// override the caller's request and report why. Two axes decide it: whether the
|
|
664
680
|
// caller is a top-level session (its turn services the live message loop) or a
|
|
@@ -108,7 +108,7 @@ function formatResult(
|
|
|
108
108
|
id: e.id,
|
|
109
109
|
ts: e.ts,
|
|
110
110
|
target: e.target,
|
|
111
|
-
payload: e.payload,
|
|
111
|
+
payload: snapshotPayload(e.payload),
|
|
112
112
|
...(e.replyTo !== undefined ? { replyTo: e.replyTo } : {}),
|
|
113
113
|
...(e.meta !== undefined ? { meta: e.meta } : {}),
|
|
114
114
|
})),
|
|
@@ -123,7 +123,7 @@ function formatResult(
|
|
|
123
123
|
|
|
124
124
|
const header = `${events.length} stream event(s) matching ${filterDesc} (oldest → newest):`
|
|
125
125
|
const lines = [header, '']
|
|
126
|
-
for (const event of events) {
|
|
126
|
+
for (const event of details.events) {
|
|
127
127
|
lines.push(formatEventLine(event))
|
|
128
128
|
}
|
|
129
129
|
return {
|
|
@@ -132,6 +132,19 @@ function formatResult(
|
|
|
132
132
|
}
|
|
133
133
|
}
|
|
134
134
|
|
|
135
|
+
// Stream payloads are runtime objects: a handler cron job contains a function.
|
|
136
|
+
// Tool details enter the transcript, which pi structuredClones before the next
|
|
137
|
+
// provider request. Project only this diagnostic view to its persisted JSON
|
|
138
|
+
// shape; never strip callbacks from the broker's live dispatch payload.
|
|
139
|
+
function snapshotPayload(payload: unknown): unknown {
|
|
140
|
+
try {
|
|
141
|
+
const json = JSON.stringify(payload)
|
|
142
|
+
return json === undefined ? '<unserializable>' : JSON.parse(json)
|
|
143
|
+
} catch {
|
|
144
|
+
return '<unserializable>'
|
|
145
|
+
}
|
|
146
|
+
}
|
|
147
|
+
|
|
135
148
|
function describeFilter(params: {
|
|
136
149
|
target_kind?: TargetKind
|
|
137
150
|
target_id?: string
|
|
@@ -16,7 +16,8 @@ export type AuthorizeLiveSubagentAccessArgs = {
|
|
|
16
16
|
// The caller's own session id. When the caller is itself a subagent, access
|
|
17
17
|
// is scoped to subagents IT spawned (live.parentSessionId === callerSessionId)
|
|
18
18
|
// so a nested subagent cannot read or cancel siblings or parent-branch runs.
|
|
19
|
-
//
|
|
19
|
+
// For main-session callers it identifies the spawning session: that session
|
|
20
|
+
// may always access its own runs; other sessions' runs stay role-capped.
|
|
20
21
|
callerSessionId?: string
|
|
21
22
|
}
|
|
22
23
|
|
|
@@ -25,8 +26,9 @@ export type AuthorizeLiveSubagentAccessArgs = {
|
|
|
25
26
|
// modes, both requiring the base permission first:
|
|
26
27
|
// - SUBAGENT caller: scoped to runs it spawned (live.parentSessionId ===
|
|
27
28
|
// callerSessionId). Ownership is the authorization; the role cap is skipped.
|
|
28
|
-
// - MAIN-SESSION caller:
|
|
29
|
-
//
|
|
29
|
+
// - MAIN-SESSION caller: the spawning session may always access its own run;
|
|
30
|
+
// any other session is capped to the requester's role — it must resolve to
|
|
31
|
+
// a role at least as high as the role that spawned the subagent.
|
|
30
32
|
//
|
|
31
33
|
// The ordering closes an existence oracle: the task-independent base-permission
|
|
32
34
|
// check runs BEFORE any registry lookup, and for non-owner callers an absent
|
|
@@ -84,7 +86,12 @@ export function authorizeLiveSubagentAccess(args: AuthorizeLiveSubagentAccessArg
|
|
|
84
86
|
if (live === undefined) {
|
|
85
87
|
return { ok: false, message: accessAll ? `Unknown task_id: ${taskId}.` : opaqueDenial }
|
|
86
88
|
}
|
|
87
|
-
|
|
89
|
+
// The session that spawned the run may always read/cancel it. In a shared
|
|
90
|
+
// channel session the origin follows the latest speaker, so a lower-role
|
|
91
|
+
// message (or the completion wake that follows it) would otherwise lock the
|
|
92
|
+
// agent out of its own subagent's result. The cap still stops a lower-role
|
|
93
|
+
// session from reaching a run spawned by a different session.
|
|
94
|
+
if (accessAll || (callerSessionId !== undefined && live.parentSessionId === callerSessionId)) {
|
|
88
95
|
return { ok: true, live }
|
|
89
96
|
}
|
|
90
97
|
|
|
@@ -0,0 +1,74 @@
|
|
|
1
|
+
// Installed as /usr/local/bin/bsk. The BrowserSkill daemon socket is
|
|
2
|
+
// runtime-private; this gives the real CLI a per-call BSK_HOME whose socket is
|
|
3
|
+
// bridged to TypeClaw's token-gated relay, so only sessions handed the token
|
|
4
|
+
// (roles with browser.shared) can drive the shared browser through bsk.
|
|
5
|
+
import { mkdirSync, mkdtempSync, rmSync, writeFileSync } from 'node:fs'
|
|
6
|
+
import { connect, createServer } from 'node:net'
|
|
7
|
+
import { tmpdir } from 'node:os'
|
|
8
|
+
import { join } from 'node:path'
|
|
9
|
+
|
|
10
|
+
const relay = process.env.TYPECLAW_BSK_RELAY
|
|
11
|
+
const token = process.env.TYPECLAW_BSK_TOKEN
|
|
12
|
+
if (!relay || !token) {
|
|
13
|
+
console.error(
|
|
14
|
+
'bsk: the shared browser is unavailable in this session (it needs the browser.shared permission, or the browser failed to start; the operator log says which).',
|
|
15
|
+
)
|
|
16
|
+
process.exit(2)
|
|
17
|
+
}
|
|
18
|
+
const separator = relay.lastIndexOf(':')
|
|
19
|
+
const host = relay.slice(0, separator)
|
|
20
|
+
const port = Number(relay.slice(separator + 1))
|
|
21
|
+
|
|
22
|
+
const home = mkdtempSync(join(tmpdir(), 'typeclaw-bsk-'))
|
|
23
|
+
mkdirSync(join(home, 'run'), { mode: 0o700 })
|
|
24
|
+
const server = createServer((inbound) => {
|
|
25
|
+
const outbound = connect(port, host, () => {
|
|
26
|
+
outbound.write(token + '\n')
|
|
27
|
+
inbound.pipe(outbound)
|
|
28
|
+
outbound.pipe(inbound)
|
|
29
|
+
})
|
|
30
|
+
const close = () => {
|
|
31
|
+
inbound.destroy()
|
|
32
|
+
outbound.destroy()
|
|
33
|
+
}
|
|
34
|
+
inbound.on('error', close)
|
|
35
|
+
outbound.on('error', close)
|
|
36
|
+
inbound.on('close', close)
|
|
37
|
+
outbound.on('close', close)
|
|
38
|
+
})
|
|
39
|
+
const sockPath = join(home, 'run', 'daemon.sock')
|
|
40
|
+
await new Promise((resolve) => server.listen(sockPath, resolve))
|
|
41
|
+
// The CLI locates its daemon through daemon.json and cross-checks its pid
|
|
42
|
+
// against the daemon, so mirror the real file and point only sock_path here.
|
|
43
|
+
const daemon = await describeDaemon().then(JSON.parse, () => {
|
|
44
|
+
console.error(
|
|
45
|
+
'bsk: the shared browser refused this session or its BrowserSkill daemon is not running; the operator log says which.',
|
|
46
|
+
)
|
|
47
|
+
rmSync(home, { recursive: true, force: true })
|
|
48
|
+
process.exit(2)
|
|
49
|
+
})
|
|
50
|
+
writeFileSync(join(home, 'daemon.json'), JSON.stringify({ ...daemon, sock_path: sockPath }))
|
|
51
|
+
|
|
52
|
+
function describeDaemon() {
|
|
53
|
+
return new Promise((resolve, reject) => {
|
|
54
|
+
const socket = connect(port, host, () => socket.write(token + ' describe\n'))
|
|
55
|
+
let text = ''
|
|
56
|
+
socket.on('data', (chunk) => {
|
|
57
|
+
text += chunk
|
|
58
|
+
})
|
|
59
|
+
socket.on('end', () => (text === '' ? reject(new Error('daemon not available')) : resolve(text)))
|
|
60
|
+
socket.on('error', reject)
|
|
61
|
+
})
|
|
62
|
+
}
|
|
63
|
+
|
|
64
|
+
const child = Bun.spawn(
|
|
65
|
+
[process.env.TYPECLAW_BSK_BIN ?? '/usr/local/lib/typeclaw-browser/bsk/bsk', ...process.argv.slice(2)],
|
|
66
|
+
{
|
|
67
|
+
env: { ...process.env, BSK_HOME: home, BSK_AUTO_START: '0' },
|
|
68
|
+
stdio: ['inherit', 'inherit', 'inherit'],
|
|
69
|
+
},
|
|
70
|
+
)
|
|
71
|
+
const code = await child.exited
|
|
72
|
+
server.close()
|
|
73
|
+
rmSync(home, { recursive: true, force: true })
|
|
74
|
+
process.exit(code)
|