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
|
@@ -61,14 +61,17 @@ export function createChannelFetchAttachmentTool({
|
|
|
61
61
|
'messages with attachments show `[<Platform> attachment #N: <kind> <metadata>]` in the text. Pass `N` as ' +
|
|
62
62
|
'`attachment_id`; do not invent ids that are not present in the message. The router resolves the private ' +
|
|
63
63
|
'platform ref itself. Attachments on the CURRENT inbound message resolve directly; for one from an EARLIER ' +
|
|
64
|
-
'message, call channel_history first
|
|
65
|
-
'
|
|
64
|
+
'message, call channel_history first. On Slack, pass the exact file_id when the request names one or ' +
|
|
65
|
+
'several messages reuse #1. Returns the selected file identity, saved path, mimetype and size.',
|
|
66
66
|
parameters: Type.Object({
|
|
67
67
|
attachment_id: Type.Integer({
|
|
68
68
|
description:
|
|
69
69
|
'The number N from the inbound `[<Platform> attachment #N: ...]` placeholder. Must be present in this turn.',
|
|
70
70
|
minimum: 1,
|
|
71
71
|
}),
|
|
72
|
+
file_id: Type.Optional(
|
|
73
|
+
Type.String({ pattern: '^F[A-Z0-9]+$', description: 'Exact Slack file ID from the request or history.' }),
|
|
74
|
+
),
|
|
72
75
|
filename: Type.Optional(
|
|
73
76
|
Type.String({
|
|
74
77
|
description:
|
|
@@ -79,12 +82,15 @@ export function createChannelFetchAttachmentTool({
|
|
|
79
82
|
}),
|
|
80
83
|
|
|
81
84
|
async execute(_toolCallId, params) {
|
|
85
|
+
if (params.file_id !== undefined && adapter !== 'slack' && adapter !== 'slack-bot')
|
|
86
|
+
return errorResult('file_id is only supported for Slack attachments')
|
|
82
87
|
const found = router.lookupInboundAttachment({
|
|
83
88
|
adapter,
|
|
84
89
|
workspace: origin.workspace,
|
|
85
90
|
chat: origin.chat,
|
|
86
91
|
thread: origin.thread,
|
|
87
92
|
id: params.attachment_id,
|
|
93
|
+
...(params.file_id !== undefined ? { ref: params.file_id } : {}),
|
|
88
94
|
})
|
|
89
95
|
if (found === null) {
|
|
90
96
|
const validIds = router.listInboundAttachmentIds({
|
|
@@ -107,6 +113,7 @@ export function createChannelFetchAttachmentTool({
|
|
|
107
113
|
)
|
|
108
114
|
}
|
|
109
115
|
const ref = found.ref
|
|
116
|
+
const identityPart = adapter === 'slack' || adapter === 'slack-bot' ? ` file_id=${ref}` : ''
|
|
110
117
|
const filename = params.filename ?? found.filename
|
|
111
118
|
const result = await router.fetchAttachment(adapter, {
|
|
112
119
|
ref,
|
|
@@ -115,7 +122,7 @@ export function createChannelFetchAttachmentTool({
|
|
|
115
122
|
})
|
|
116
123
|
if (!result.ok) {
|
|
117
124
|
logger.warn(formatChannelToolFailure('channel_fetch_attachment', `${adapter}: ${result.error}`))
|
|
118
|
-
const text = `channel_fetch_attachment error
|
|
125
|
+
const text = `channel_fetch_attachment error:${identityPart} ${result.error}`
|
|
119
126
|
const details: FetchAttachmentDetails = { ok: false, error: result.error }
|
|
120
127
|
return { content: [{ type: 'text' as const, text }], details }
|
|
121
128
|
}
|
|
@@ -135,13 +142,13 @@ export function createChannelFetchAttachmentTool({
|
|
|
135
142
|
} catch (err) {
|
|
136
143
|
const message = err instanceof Error ? err.message : String(err)
|
|
137
144
|
logger.warn(formatChannelToolFailure('channel_fetch_attachment', `${adapter}: write failed: ${message}`))
|
|
138
|
-
const text = `channel_fetch_attachment error
|
|
145
|
+
const text = `channel_fetch_attachment error:${identityPart} write failed: ${message}`
|
|
139
146
|
const details: FetchAttachmentDetails = { ok: false, error: `write failed: ${message}` }
|
|
140
147
|
return { content: [{ type: 'text' as const, text }], details }
|
|
141
148
|
}
|
|
142
149
|
|
|
143
150
|
const mimetypePart = result.mimetype !== undefined ? ` (${result.mimetype})` : ''
|
|
144
|
-
const text = `saved ${result.size} bytes to ${targetPath}${mimetypePart}`
|
|
151
|
+
const text = `saved ${result.size} bytes to ${targetPath}${mimetypePart}${identityPart}`
|
|
145
152
|
const details: FetchAttachmentDetails = {
|
|
146
153
|
ok: true,
|
|
147
154
|
path: targetPath,
|
|
@@ -0,0 +1,72 @@
|
|
|
1
|
+
import { Type } from '@earendil-works/pi-ai'
|
|
2
|
+
import { defineTool } from '@earendil-works/pi-coding-agent'
|
|
3
|
+
|
|
4
|
+
import type { ChannelHandoffResult, ChannelRouter } from '@/channels/router'
|
|
5
|
+
import { ADAPTER_IDS } from '@/channels/schema'
|
|
6
|
+
|
|
7
|
+
export type CreateChannelHandoffToolOptions = {
|
|
8
|
+
router: Pick<ChannelRouter, 'handoff'>
|
|
9
|
+
sessionId: string
|
|
10
|
+
}
|
|
11
|
+
|
|
12
|
+
// `channel_handoff` hands work to the session that owns another conversation
|
|
13
|
+
// instead of posting there with channel_send. A channel_send from here is
|
|
14
|
+
// written from THIS session's view of that conversation, which goes stale the
|
|
15
|
+
// moment people keep talking there; the owning session sees its latest
|
|
16
|
+
// messages and decides what (if anything) to post.
|
|
17
|
+
export function createChannelHandoffTool({ router, sessionId }: CreateChannelHandoffToolOptions) {
|
|
18
|
+
return defineTool({
|
|
19
|
+
name: 'channel_handoff',
|
|
20
|
+
label: 'Channel Handoff',
|
|
21
|
+
description:
|
|
22
|
+
'Hand a result or request to the session that owns ANOTHER conversation, on any adapter. First use ' +
|
|
23
|
+
'`channel_session_search` to find its target by conversation name, topic, or participant. When the work ' +
|
|
24
|
+
'belongs there, hand it off instead of reading or posting there directly from this session. ' +
|
|
25
|
+
'The session that owns that conversation receives your `text` as a private note from ' +
|
|
26
|
+
'the user, reads its own latest messages, and then decides what to post, so newer requests there are not ' +
|
|
27
|
+
'answered with a stale result. Your `text` is not posted verbatim: write what was done and what is left, ' +
|
|
28
|
+
'not a finished channel message. It acts on behalf of the user who asked you this turn, with their permissions ' +
|
|
29
|
+
'in the target conversation, without gaining authority over their source role. No recent participation is required. ' +
|
|
30
|
+
'After a successful handoff, briefly tell the user here that it was passed on. ' +
|
|
31
|
+
'Not available in a turn that was itself started by a handoff (reply with `channel_reply` there).',
|
|
32
|
+
parameters: Type.Object({
|
|
33
|
+
adapter: Type.Union(
|
|
34
|
+
ADAPTER_IDS.map((a) => Type.Literal(a)),
|
|
35
|
+
{ description: 'Target adapter id from channel_session_search; it can differ from this session.' },
|
|
36
|
+
),
|
|
37
|
+
workspace: Type.String({
|
|
38
|
+
description: 'Discord guild id or Slack team id; "@dm" for direct-message channels.',
|
|
39
|
+
minLength: 1,
|
|
40
|
+
}),
|
|
41
|
+
chat: Type.String({ description: 'Target channel id.', minLength: 1 }),
|
|
42
|
+
thread: Type.Optional(
|
|
43
|
+
Type.String({
|
|
44
|
+
description: 'Optional thread id (Discord thread channel id, Slack parent thread_ts).',
|
|
45
|
+
minLength: 1,
|
|
46
|
+
}),
|
|
47
|
+
),
|
|
48
|
+
text: Type.String({
|
|
49
|
+
description:
|
|
50
|
+
'What the owning session needs to know: the request, what you already did, and the result. Plain context, not a ready-to-post message.',
|
|
51
|
+
minLength: 1,
|
|
52
|
+
}),
|
|
53
|
+
}),
|
|
54
|
+
|
|
55
|
+
async execute(_toolCallId, params) {
|
|
56
|
+
const result: ChannelHandoffResult = await router.handoff({
|
|
57
|
+
fromSessionId: sessionId,
|
|
58
|
+
target: {
|
|
59
|
+
adapter: params.adapter,
|
|
60
|
+
workspace: params.workspace,
|
|
61
|
+
chat: params.chat,
|
|
62
|
+
thread: params.thread ?? null,
|
|
63
|
+
},
|
|
64
|
+
text: params.text,
|
|
65
|
+
})
|
|
66
|
+
const text = result.ok
|
|
67
|
+
? `Handed off to ${result.target}. That conversation's session will answer there with its current context; do not also post it yourself.`
|
|
68
|
+
: `channel_handoff denied (${result.code}): ${result.error}`
|
|
69
|
+
return { content: [{ type: 'text' as const, text }], details: result }
|
|
70
|
+
},
|
|
71
|
+
})
|
|
72
|
+
}
|
|
@@ -3,7 +3,7 @@ import { defineTool } from '@earendil-works/pi-coding-agent'
|
|
|
3
3
|
|
|
4
4
|
import type { ChannelRouter } from '@/channels/router'
|
|
5
5
|
import { ADAPTER_IDS, type AdapterId } from '@/channels/schema'
|
|
6
|
-
import type { ChannelListEntry } from '@/channels/types'
|
|
6
|
+
import type { ChannelKey, ChannelListEntry } from '@/channels/types'
|
|
7
7
|
|
|
8
8
|
import { renderHistoryMessage, renderHistoryMessages } from './channel-history-render'
|
|
9
9
|
import { type ChannelToolLogger, consoleChannelLogger, formatChannelToolFailure } from './channel-log'
|
|
@@ -11,6 +11,7 @@ import { type ChannelToolLogger, consoleChannelLogger, formatChannelToolFailure
|
|
|
11
11
|
export type CreateChannelReadToolOptions = {
|
|
12
12
|
router: ChannelRouter
|
|
13
13
|
logger?: ChannelToolLogger
|
|
14
|
+
sessionId?: string
|
|
14
15
|
}
|
|
15
16
|
|
|
16
17
|
const DEFAULT_LIMIT = 20
|
|
@@ -22,7 +23,11 @@ const DEFAULT_LIMIT = 20
|
|
|
22
23
|
// modes share one tool to keep the per-turn tool-schema budget small, mirroring
|
|
23
24
|
// web_fetch's strategy union; mode-specific required params are validated at
|
|
24
25
|
// runtime since JSON-Schema can't express "required-if".
|
|
25
|
-
export function createChannelReadTool({
|
|
26
|
+
export function createChannelReadTool({
|
|
27
|
+
router,
|
|
28
|
+
logger = consoleChannelLogger,
|
|
29
|
+
sessionId,
|
|
30
|
+
}: CreateChannelReadToolOptions) {
|
|
26
31
|
return defineTool({
|
|
27
32
|
name: 'channel_read',
|
|
28
33
|
label: 'Channel Read',
|
|
@@ -34,7 +39,8 @@ export function createChannelReadTool({ router, logger = consoleChannelLogger }:
|
|
|
34
39
|
'- "list": discover channels/chats in `workspace` (no `chat` needed). Use when you do not yet know a chat id.\n' +
|
|
35
40
|
'For Discord guild channels, `workspace` is the guild id; for Slack team channels, `workspace` is the team id (e.g. "T0ACME"); for DMs, "@dm". ' +
|
|
36
41
|
'On failure returns { ok: false, error }. Not every adapter supports every mode — an unsupported mode returns a not-supported error rather than throwing. ' +
|
|
37
|
-
'This is read-only
|
|
42
|
+
'This is read-only. When work belongs to another conversation, use channel_session_search and channel_handoff ' +
|
|
43
|
+
'instead of reading or posting there directly. An access error may include an authorized handoff target.',
|
|
38
44
|
parameters: Type.Object({
|
|
39
45
|
mode: Type.Union([Type.Literal('history'), Type.Literal('message'), Type.Literal('list')], {
|
|
40
46
|
description:
|
|
@@ -79,21 +85,62 @@ export function createChannelReadTool({ router, logger = consoleChannelLogger }:
|
|
|
79
85
|
}),
|
|
80
86
|
|
|
81
87
|
async execute(_toolCallId, params) {
|
|
82
|
-
const adapter = params.adapter
|
|
88
|
+
const adapter = params.adapter
|
|
83
89
|
const limit = params.limit ?? DEFAULT_LIMIT
|
|
84
90
|
|
|
85
|
-
|
|
86
|
-
|
|
91
|
+
let result: { content: { type: 'text'; text: string }[]; details: Details }
|
|
92
|
+
switch (params.mode) {
|
|
93
|
+
case 'history':
|
|
94
|
+
result = await readHistory({ router, logger, adapter, params, limit })
|
|
95
|
+
break
|
|
96
|
+
case 'message':
|
|
97
|
+
result = await readMessage({ router, logger, adapter, params })
|
|
98
|
+
break
|
|
99
|
+
case 'list':
|
|
100
|
+
result = await readList({ router, logger, adapter, params, limit })
|
|
101
|
+
break
|
|
87
102
|
}
|
|
88
|
-
|
|
89
|
-
|
|
103
|
+
// These are platform protocol errors, not natural-language intent matching.
|
|
104
|
+
const error = result.details.error?.toLocaleLowerCase() ?? ''
|
|
105
|
+
const accessDenied = [
|
|
106
|
+
'missing access',
|
|
107
|
+
'missing permissions',
|
|
108
|
+
'access denied',
|
|
109
|
+
'access_denied',
|
|
110
|
+
'permission-denied',
|
|
111
|
+
'forbidden',
|
|
112
|
+
'http_403',
|
|
113
|
+
'missing_scope',
|
|
114
|
+
'not_in_channel',
|
|
115
|
+
].some((code) => error.includes(code))
|
|
116
|
+
if (!result.details.ok && accessDenied && sessionId !== undefined && params.chat !== undefined) {
|
|
117
|
+
const handoffTargets = router
|
|
118
|
+
.searchSessions({
|
|
119
|
+
fromSessionId: sessionId,
|
|
120
|
+
query: '',
|
|
121
|
+
conversation: { adapter, workspace: params.workspace, chat: params.chat, thread: params.thread ?? null },
|
|
122
|
+
})
|
|
123
|
+
.map((entry) => entry.target)
|
|
124
|
+
if (handoffTargets.length > 0) {
|
|
125
|
+
const hint = `Another adapter has an authorized live session for this conversation. Use channel_handoff with a target below instead of asking the user to repair this account's access:\n${JSON.stringify(handoffTargets)}`
|
|
126
|
+
return {
|
|
127
|
+
content: result.content.map((part) => ({ ...part, text: `${part.text}\n\n${hint}` })),
|
|
128
|
+
details: { ...result.details, handoffTargets },
|
|
129
|
+
}
|
|
130
|
+
}
|
|
90
131
|
}
|
|
91
|
-
return
|
|
132
|
+
return result
|
|
92
133
|
},
|
|
93
134
|
})
|
|
94
135
|
}
|
|
95
136
|
|
|
96
|
-
type Details = {
|
|
137
|
+
type Details = {
|
|
138
|
+
ok: boolean
|
|
139
|
+
error?: string
|
|
140
|
+
count?: number
|
|
141
|
+
nextCursor?: string
|
|
142
|
+
handoffTargets?: readonly ChannelKey[]
|
|
143
|
+
}
|
|
97
144
|
|
|
98
145
|
function fail(error: string): { content: [{ type: 'text'; text: string }]; details: Details } {
|
|
99
146
|
return { content: [{ type: 'text' as const, text: `channel_read error: ${error}` }], details: { ok: false, error } }
|
|
@@ -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 {
|