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
|
@@ -0,0 +1,144 @@
|
|
|
1
|
+
import { mkdtemp, rm } from 'node:fs/promises'
|
|
2
|
+
import { tmpdir } from 'node:os'
|
|
3
|
+
import { join } from 'node:path'
|
|
4
|
+
|
|
5
|
+
import type { AssistantMessage } from '@earendil-works/pi-ai'
|
|
6
|
+
import { SessionManager, type ExtensionToolContext } from '@earendil-works/pi-coding-agent'
|
|
7
|
+
|
|
8
|
+
import { createSessionWithDispose } from '@/agent'
|
|
9
|
+
import type { SessionOrigin } from '@/agent/session-origin'
|
|
10
|
+
import { createPermissionService, rolesConfigSchema, type RolesConfig } from '@/permissions'
|
|
11
|
+
|
|
12
|
+
import { createChannelRouter, type CreateChannelRouterOptions } from './router'
|
|
13
|
+
import { defaultHistoryConfig } from './schema'
|
|
14
|
+
import { channelKeyId, type ChannelKey, type InboundMessage, type OutboundMessage } from './types'
|
|
15
|
+
|
|
16
|
+
export const sourceKey: ChannelKey = { adapter: 'discord', workspace: 'guild', chat: 'source', thread: null }
|
|
17
|
+
export const targetKey: ChannelKey = { adapter: 'discord-bot', workspace: 'guild', chat: 'target', thread: null }
|
|
18
|
+
|
|
19
|
+
export function inbound(key: ChannelKey, overrides: Partial<InboundMessage> = {}): InboundMessage {
|
|
20
|
+
return {
|
|
21
|
+
...key,
|
|
22
|
+
accountIdentity: `${key.adapter}-account`,
|
|
23
|
+
externalMessageId: crypto.randomUUID(),
|
|
24
|
+
text: 'Please help.',
|
|
25
|
+
authorId: 'alice',
|
|
26
|
+
authorName: 'Alice',
|
|
27
|
+
authorIsBot: false,
|
|
28
|
+
isBotMention: true,
|
|
29
|
+
isDm: false,
|
|
30
|
+
mentionsOthers: false,
|
|
31
|
+
replyToBotMessageId: null,
|
|
32
|
+
replyToOtherMessageId: null,
|
|
33
|
+
ts: 1000,
|
|
34
|
+
...overrides,
|
|
35
|
+
}
|
|
36
|
+
}
|
|
37
|
+
|
|
38
|
+
type SessionState = {
|
|
39
|
+
readonly id: string
|
|
40
|
+
readonly origin: { current: SessionOrigin | undefined }
|
|
41
|
+
readonly prompts: string[]
|
|
42
|
+
readonly context: ExtensionToolContext
|
|
43
|
+
onPrompt?: () => Promise<void>
|
|
44
|
+
}
|
|
45
|
+
|
|
46
|
+
export async function handoffFixture(
|
|
47
|
+
options: {
|
|
48
|
+
roles?: RolesConfig
|
|
49
|
+
claimHandler?: CreateChannelRouterOptions['claimHandler']
|
|
50
|
+
} = {},
|
|
51
|
+
) {
|
|
52
|
+
const dir = await mkdtemp(join(tmpdir(), 'typeclaw-session-handoff-'))
|
|
53
|
+
const permissions = createPermissionService({
|
|
54
|
+
roles: options.roles ?? rolesConfigSchema.parse({ member: { match: ['discord:*'] } }),
|
|
55
|
+
})
|
|
56
|
+
const sessions = new Map<string, SessionState>()
|
|
57
|
+
const sent: OutboundMessage[] = []
|
|
58
|
+
const logs: string[] = []
|
|
59
|
+
const clock = { now: 1000 }
|
|
60
|
+
const router = createChannelRouter({
|
|
61
|
+
agentDir: dir,
|
|
62
|
+
permissions,
|
|
63
|
+
now: () => clock.now,
|
|
64
|
+
claimHandler: options.claimHandler,
|
|
65
|
+
logger: { info: (line) => logs.push(line), warn: (line) => logs.push(line), error: (line) => logs.push(line) },
|
|
66
|
+
configForAdapter: () => ({
|
|
67
|
+
enabled: true,
|
|
68
|
+
engagement: { trigger: ['mention', 'reply', 'dm'], stickiness: 'off' },
|
|
69
|
+
history: defaultHistoryConfig(),
|
|
70
|
+
}),
|
|
71
|
+
createSessionForChannel: async ({ key, origin, originRef }) => {
|
|
72
|
+
const result = await createSessionWithDispose({
|
|
73
|
+
sessionManager: SessionManager.create(dir, join(dir, 'sessions')),
|
|
74
|
+
systemPromptOverride: 'Use channel tools.',
|
|
75
|
+
tools: [],
|
|
76
|
+
customTools: [],
|
|
77
|
+
origin,
|
|
78
|
+
originRef,
|
|
79
|
+
})
|
|
80
|
+
const state: SessionState = {
|
|
81
|
+
id: result.session.sessionId,
|
|
82
|
+
origin: originRef,
|
|
83
|
+
prompts: [],
|
|
84
|
+
context: result.session.extensionRunner.createToolContext('handoff-test', undefined),
|
|
85
|
+
}
|
|
86
|
+
sessions.set(channelKeyId(key), state)
|
|
87
|
+
result.session.prompt = async (text) => {
|
|
88
|
+
if (typeof text === 'string') state.prompts.push(text)
|
|
89
|
+
await state.onPrompt?.()
|
|
90
|
+
const response: AssistantMessage = {
|
|
91
|
+
role: 'assistant',
|
|
92
|
+
content: [{ type: 'text', text: 'NO_REPLY' }],
|
|
93
|
+
api: 'anthropic-messages',
|
|
94
|
+
provider: 'anthropic',
|
|
95
|
+
model: 'test-model',
|
|
96
|
+
usage: {
|
|
97
|
+
input: 0,
|
|
98
|
+
output: 0,
|
|
99
|
+
cacheRead: 0,
|
|
100
|
+
cacheWrite: 0,
|
|
101
|
+
totalTokens: 0,
|
|
102
|
+
cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0, total: 0 },
|
|
103
|
+
},
|
|
104
|
+
stopReason: 'stop',
|
|
105
|
+
timestamp: clock.now,
|
|
106
|
+
}
|
|
107
|
+
result.session.sessionManager.appendMessage(response)
|
|
108
|
+
}
|
|
109
|
+
return { session: result.session, sessionId: state.id, dispose: result.dispose }
|
|
110
|
+
},
|
|
111
|
+
})
|
|
112
|
+
for (const adapter of ['discord', 'discord-bot', 'slack-bot'] as const) {
|
|
113
|
+
router.registerOutbound(adapter, async (message) => {
|
|
114
|
+
sent.push(message)
|
|
115
|
+
return { ok: true, messageId: 'posted-message' }
|
|
116
|
+
})
|
|
117
|
+
}
|
|
118
|
+
const testing = router.__testing
|
|
119
|
+
if (testing === undefined) throw new Error('router test controls are unavailable')
|
|
120
|
+
const session = (key: ChannelKey): SessionState => {
|
|
121
|
+
const state = sessions.get(channelKeyId(key))
|
|
122
|
+
if (state === undefined) throw new Error(`missing test session ${channelKeyId(key)}`)
|
|
123
|
+
return state
|
|
124
|
+
}
|
|
125
|
+
return {
|
|
126
|
+
agentDir: dir,
|
|
127
|
+
router,
|
|
128
|
+
permissions,
|
|
129
|
+
sessions,
|
|
130
|
+
session,
|
|
131
|
+
sent,
|
|
132
|
+
logs,
|
|
133
|
+
clock,
|
|
134
|
+
flush: testing.flushDebounce,
|
|
135
|
+
async receive(event: InboundMessage) {
|
|
136
|
+
await router.route(event)
|
|
137
|
+
await testing.flushDebounce(event)
|
|
138
|
+
},
|
|
139
|
+
async [Symbol.asyncDispose]() {
|
|
140
|
+
await router.stop()
|
|
141
|
+
await rm(dir, { recursive: true, force: true })
|
|
142
|
+
},
|
|
143
|
+
}
|
|
144
|
+
}
|
|
@@ -0,0 +1,175 @@
|
|
|
1
|
+
import { randomUUID } from 'node:crypto'
|
|
2
|
+
|
|
3
|
+
import type { ChannelParticipant, SessionOrigin } from '@/agent/session-origin'
|
|
4
|
+
import { CORE_PERMISSIONS, type PermissionService } from '@/permissions'
|
|
5
|
+
|
|
6
|
+
import type { AdapterId } from './schema'
|
|
7
|
+
import { channelKeyId, type ChannelKey, type InboundMessage, type RouteReceipt } from './types'
|
|
8
|
+
|
|
9
|
+
export type HandoffSession = {
|
|
10
|
+
readonly sessionId: string
|
|
11
|
+
readonly key: ChannelKey
|
|
12
|
+
readonly keyId: string
|
|
13
|
+
readonly destroyed: boolean
|
|
14
|
+
readonly currentTurnHandoff: boolean
|
|
15
|
+
readonly lastTurnHandoff: boolean
|
|
16
|
+
readonly draining: boolean
|
|
17
|
+
readonly currentTurnAuthorId: string | null
|
|
18
|
+
readonly lastTurnAuthorId: string | null
|
|
19
|
+
readonly currentTurnAuthorAdapter: AdapterId
|
|
20
|
+
readonly lastTurnAuthorAdapter: AdapterId
|
|
21
|
+
readonly participants: readonly ChannelParticipant[]
|
|
22
|
+
readonly room?: InboundMessage['room']
|
|
23
|
+
readonly lastInboundIsDm: boolean
|
|
24
|
+
}
|
|
25
|
+
|
|
26
|
+
export type ChannelHandoffResult =
|
|
27
|
+
| { ok: true; target: string }
|
|
28
|
+
| {
|
|
29
|
+
ok: false
|
|
30
|
+
code:
|
|
31
|
+
| 'no-source-session'
|
|
32
|
+
| 'loop'
|
|
33
|
+
| 'same-conversation'
|
|
34
|
+
| 'no-requester'
|
|
35
|
+
| 'target-not-live'
|
|
36
|
+
| 'requester-unknown-in-target'
|
|
37
|
+
| 'would-elevate'
|
|
38
|
+
| 'denied'
|
|
39
|
+
| 'not-engaged'
|
|
40
|
+
error: string
|
|
41
|
+
}
|
|
42
|
+
|
|
43
|
+
type HandoffAccess =
|
|
44
|
+
| {
|
|
45
|
+
ok: true
|
|
46
|
+
source: HandoffSession
|
|
47
|
+
target: HandoffSession
|
|
48
|
+
authorId: string
|
|
49
|
+
authorAdapter: AdapterId
|
|
50
|
+
authorName: string
|
|
51
|
+
}
|
|
52
|
+
| Extract<ChannelHandoffResult, { ok: false }>
|
|
53
|
+
|
|
54
|
+
export function findHandoffSource(sessions: ReadonlyMap<string, HandoffSession>, sessionId: string) {
|
|
55
|
+
return [...sessions.values()].find((session) => session.sessionId === sessionId && !session.destroyed)
|
|
56
|
+
}
|
|
57
|
+
|
|
58
|
+
export function checkHandoffAccess(args: {
|
|
59
|
+
source: HandoffSession | undefined
|
|
60
|
+
target: HandoffSession | undefined
|
|
61
|
+
permissions: PermissionService
|
|
62
|
+
}): HandoffAccess {
|
|
63
|
+
const { source, target, permissions } = args
|
|
64
|
+
if (source === undefined)
|
|
65
|
+
return { ok: false, code: 'no-source-session', error: 'handoff requires a live source channel session' }
|
|
66
|
+
if (source.currentTurnHandoff || (!source.draining && source.lastTurnHandoff))
|
|
67
|
+
return { ok: false, code: 'loop', error: 'this turn was started by a handoff; answer with channel_reply' }
|
|
68
|
+
if (target === undefined || target.destroyed)
|
|
69
|
+
return { ok: false, code: 'target-not-live', error: 'no live session owns that conversation' }
|
|
70
|
+
if (target.keyId === source.keyId)
|
|
71
|
+
return { ok: false, code: 'same-conversation', error: 'target is this conversation; use channel_reply' }
|
|
72
|
+
const authorId = source.currentTurnAuthorId ?? source.lastTurnAuthorId
|
|
73
|
+
if (authorId === null)
|
|
74
|
+
return { ok: false, code: 'no-requester', error: 'no authenticated requester to act on behalf of' }
|
|
75
|
+
const authorAdapter =
|
|
76
|
+
source.currentTurnAuthorId !== null ? source.currentTurnAuthorAdapter : source.lastTurnAuthorAdapter
|
|
77
|
+
const origin = (session: HandoffSession): SessionOrigin => ({
|
|
78
|
+
kind: 'channel',
|
|
79
|
+
...session.key,
|
|
80
|
+
...(session.room?.parentChat !== undefined ? { parentChat: session.room.parentChat } : {}),
|
|
81
|
+
lastInboundAuthorId: authorId,
|
|
82
|
+
lastInboundAuthorAdapter: authorAdapter,
|
|
83
|
+
})
|
|
84
|
+
const targetOrigin = origin(target)
|
|
85
|
+
const targetRole = permissions.resolveRole(targetOrigin, { requireMatch: true })
|
|
86
|
+
const targetPermissions = targetRole === undefined ? undefined : permissions.permissionsForRole(targetRole)
|
|
87
|
+
if (targetPermissions === undefined)
|
|
88
|
+
return {
|
|
89
|
+
ok: false,
|
|
90
|
+
code: 'requester-unknown-in-target',
|
|
91
|
+
error: 'the authenticated requester has no matching known role in the target conversation',
|
|
92
|
+
}
|
|
93
|
+
const sourceRole = permissions.resolveRole(origin(source))
|
|
94
|
+
const sourcePermissions = permissions.permissionsForRole(sourceRole)
|
|
95
|
+
if (
|
|
96
|
+
sourcePermissions === undefined ||
|
|
97
|
+
targetPermissions.some((permission) => !sourcePermissions.includes(permission))
|
|
98
|
+
)
|
|
99
|
+
return {
|
|
100
|
+
ok: false,
|
|
101
|
+
code: 'would-elevate',
|
|
102
|
+
error: 'the target grants authority the requester does not hold in the source; request there directly',
|
|
103
|
+
}
|
|
104
|
+
if (!permissions.has(targetOrigin, CORE_PERMISSIONS.channelRespond))
|
|
105
|
+
return { ok: false, code: 'denied', error: 'the requester cannot engage the agent in the target conversation' }
|
|
106
|
+
// Capability dominance already bounds every accepted handoff, including
|
|
107
|
+
// owners. Recent participation adds no authority proof and blocks legitimate
|
|
108
|
+
// work across accounts or after an idle period.
|
|
109
|
+
return {
|
|
110
|
+
ok: true,
|
|
111
|
+
source,
|
|
112
|
+
target,
|
|
113
|
+
authorId,
|
|
114
|
+
authorAdapter,
|
|
115
|
+
authorName: source.participants.find((participant) => participant.authorId === authorId)?.authorName ?? authorId,
|
|
116
|
+
}
|
|
117
|
+
}
|
|
118
|
+
|
|
119
|
+
export function createSessionHandoff(options: {
|
|
120
|
+
sessions: ReadonlyMap<string, HandoffSession>
|
|
121
|
+
permissions: PermissionService
|
|
122
|
+
route: (event: InboundMessage) => Promise<RouteReceipt>
|
|
123
|
+
logger: { info: (message: string) => void }
|
|
124
|
+
now: () => number
|
|
125
|
+
}) {
|
|
126
|
+
return async (args: { fromSessionId: string; target: ChannelKey; text: string }): Promise<ChannelHandoffResult> => {
|
|
127
|
+
const targetId = channelKeyId(args.target)
|
|
128
|
+
const access = checkHandoffAccess({
|
|
129
|
+
source: findHandoffSource(options.sessions, args.fromSessionId),
|
|
130
|
+
target: options.sessions.get(targetId),
|
|
131
|
+
permissions: options.permissions,
|
|
132
|
+
})
|
|
133
|
+
if (!access.ok) {
|
|
134
|
+
options.logger.info(`[channels] handoff ${args.fromSessionId} -> ${targetId}: refused ${access.code}`)
|
|
135
|
+
return access
|
|
136
|
+
}
|
|
137
|
+
const { source, target } = access
|
|
138
|
+
const fromWhere = source.lastInboundIsDm ? 'a private DM' : `another conversation (${source.keyId})`
|
|
139
|
+
const receipt = await options.route({
|
|
140
|
+
...target.key,
|
|
141
|
+
...(target.room !== undefined ? { room: target.room } : {}),
|
|
142
|
+
routingNote:
|
|
143
|
+
`[handoff: ${access.authorName} asked you for this in ${fromWhere}. It was NOT posted in this conversation and nobody ` +
|
|
144
|
+
"here has seen it. Read this conversation's latest messages first: if someone has since asked for something newer " +
|
|
145
|
+
'or the result below is outdated, act on the current state instead of repeating it, or stay silent if nothing is ' +
|
|
146
|
+
'needed. Share only what this conversation needs, not private details.]',
|
|
147
|
+
handoff: true,
|
|
148
|
+
text: args.text,
|
|
149
|
+
externalMessageId: `handoff:${randomUUID()}`,
|
|
150
|
+
eventKind: 'handoff',
|
|
151
|
+
authorId: access.authorId,
|
|
152
|
+
authorAdapter: access.authorAdapter,
|
|
153
|
+
authorName: access.authorName,
|
|
154
|
+
authorIsBot: false,
|
|
155
|
+
isBotMention: true,
|
|
156
|
+
suppressSticky: true,
|
|
157
|
+
replyToBotMessageId: null,
|
|
158
|
+
mentionsOthers: false,
|
|
159
|
+
replyToOtherMessageId: null,
|
|
160
|
+
isDm: target.lastInboundIsDm,
|
|
161
|
+
ts: options.now(),
|
|
162
|
+
})
|
|
163
|
+
options.logger.info(`[channels] handoff ${source.keyId} -> ${targetId}: ${receipt.kind}`)
|
|
164
|
+
switch (receipt.kind) {
|
|
165
|
+
case 'accepted':
|
|
166
|
+
case 'duplicate':
|
|
167
|
+
return { ok: true, target: targetId }
|
|
168
|
+
case 'denied':
|
|
169
|
+
return { ok: false, code: 'denied', error: 'target authorization changed or its adapter is unavailable' }
|
|
170
|
+
case 'observed':
|
|
171
|
+
case 'control':
|
|
172
|
+
return { ok: false, code: 'not-engaged', error: 'the target did not accept the handoff' }
|
|
173
|
+
}
|
|
174
|
+
}
|
|
175
|
+
}
|
|
@@ -0,0 +1,71 @@
|
|
|
1
|
+
import type { PermissionService } from '@/permissions'
|
|
2
|
+
|
|
3
|
+
import { adapterNamespace } from './adapter-namespace'
|
|
4
|
+
import type { ConfigForAdapter } from './router'
|
|
5
|
+
import { checkHandoffAccess, findHandoffSource, type HandoffSession } from './session-handoff'
|
|
6
|
+
import type { ChannelKey, ResolvedChannelNames } from './types'
|
|
7
|
+
|
|
8
|
+
export type SessionActivity = { readonly text: string; readonly at: number }
|
|
9
|
+
export type SearchableSession = HandoffSession & {
|
|
10
|
+
readonly resolvedNames: ResolvedChannelNames
|
|
11
|
+
readonly recentMessages: readonly SessionActivity[]
|
|
12
|
+
readonly lastInboundAt: number
|
|
13
|
+
}
|
|
14
|
+
|
|
15
|
+
export type SessionSearchTarget = {
|
|
16
|
+
readonly target: ChannelKey
|
|
17
|
+
readonly name: string
|
|
18
|
+
readonly activity: string
|
|
19
|
+
readonly lastActiveAt: number
|
|
20
|
+
}
|
|
21
|
+
|
|
22
|
+
export type SessionSearchArgs = {
|
|
23
|
+
readonly fromSessionId: string
|
|
24
|
+
readonly query: string
|
|
25
|
+
// Used by channel_read to disambiguate platform-local conversation IDs.
|
|
26
|
+
readonly conversation?: ChannelKey
|
|
27
|
+
}
|
|
28
|
+
|
|
29
|
+
export function createSessionSearch(options: {
|
|
30
|
+
sessions: ReadonlyMap<string, SearchableSession>
|
|
31
|
+
permissions: PermissionService
|
|
32
|
+
configForAdapter: ConfigForAdapter
|
|
33
|
+
}) {
|
|
34
|
+
return (args: SessionSearchArgs): SessionSearchTarget[] => {
|
|
35
|
+
const source = findHandoffSource(options.sessions, args.fromSessionId)
|
|
36
|
+
const query = args.query.trim().toLocaleLowerCase()
|
|
37
|
+
const results: SessionSearchTarget[] = []
|
|
38
|
+
for (const session of options.sessions.values()) {
|
|
39
|
+
if (!options.configForAdapter(session.key.adapter)?.enabled) continue
|
|
40
|
+
const conversation = args.conversation
|
|
41
|
+
if (
|
|
42
|
+
conversation !== undefined &&
|
|
43
|
+
(session.key.adapter === conversation.adapter ||
|
|
44
|
+
adapterNamespace(session.key.adapter) !== adapterNamespace(conversation.adapter) ||
|
|
45
|
+
session.key.workspace !== conversation.workspace ||
|
|
46
|
+
session.key.chat !== conversation.chat ||
|
|
47
|
+
session.key.thread !== conversation.thread)
|
|
48
|
+
)
|
|
49
|
+
continue
|
|
50
|
+
if (!checkHandoffAccess({ source, target: session, permissions: options.permissions }).ok) continue
|
|
51
|
+
const name = session.resolvedNames.chatName ?? session.key.chat
|
|
52
|
+
const values = [
|
|
53
|
+
name,
|
|
54
|
+
session.resolvedNames.workspaceName ?? session.key.workspace,
|
|
55
|
+
session.room?.parentChatName ?? '',
|
|
56
|
+
session.keyId,
|
|
57
|
+
...session.participants.flatMap((participant) => [participant.authorId, participant.authorName]),
|
|
58
|
+
...session.recentMessages.map((message) => message.text),
|
|
59
|
+
]
|
|
60
|
+
if (!values.some((value) => value.toLocaleLowerCase().includes(query))) continue
|
|
61
|
+
const latest = session.recentMessages.at(-1)
|
|
62
|
+
results.push({
|
|
63
|
+
target: { ...session.key },
|
|
64
|
+
name,
|
|
65
|
+
activity: latest?.text.replace(/\s+/gu, ' ').slice(0, 160) ?? '',
|
|
66
|
+
lastActiveAt: latest?.at ?? session.lastInboundAt,
|
|
67
|
+
})
|
|
68
|
+
}
|
|
69
|
+
return results.sort((a, b) => b.lastActiveAt - a.lastActiveAt).slice(0, 20)
|
|
70
|
+
}
|
|
71
|
+
}
|
package/src/channels/types.ts
CHANGED
|
@@ -102,6 +102,16 @@ export type InboundMessage = {
|
|
|
102
102
|
// the thread. Absent ⇒ not a thread room (or the adapter cannot tell).
|
|
103
103
|
room?: { kind: 'thread'; parentChat?: string; parentChatName?: string }
|
|
104
104
|
text: string
|
|
105
|
+
// Prompt-only runtime note rendered above this message's author line (never
|
|
106
|
+
// part of `text`, so engagement and quote anchors ignore it). Set by the
|
|
107
|
+
// router for cross-session handoffs and conversation origin hints.
|
|
108
|
+
routingNote?: string
|
|
109
|
+
// Set only on a synthetic inbound created by `router.handoff`: the requester's
|
|
110
|
+
// own session in another chat delegated this work here. The turn it starts
|
|
111
|
+
// cannot hand off again (loop guard) and is never a reply-anchor target.
|
|
112
|
+
handoff?: true
|
|
113
|
+
// Runtime-only provenance for a handoff; platform adapters omit this.
|
|
114
|
+
authorAdapter?: AdapterId
|
|
105
115
|
// Prompt-only context for replied-to / quoted / linked messages. Kept out
|
|
106
116
|
// of `text` so the engagement gate sees only the human-authored body.
|
|
107
117
|
referenceContext?: InboundReferenceContext
|
|
@@ -391,7 +401,7 @@ export type SendErrorCode =
|
|
|
391
401
|
// a later ReactionRequest reacts to. It is explicitly NOT the per-reaction
|
|
392
402
|
// removal-instance ref returned by `ReactionResult.reactionRef` after an add.
|
|
393
403
|
export type SendResult =
|
|
394
|
-
| { ok: true; messageId?: string; messageIds?: readonly string[]; reactionRef?: ReactionRef }
|
|
404
|
+
| { ok: true; messageId?: string; messageIds?: readonly string[]; reactionRef?: ReactionRef; deliveredText?: string }
|
|
395
405
|
| { ok: false; error: string; code?: SendErrorCode; recoveryFailure?: RecoveryFailure }
|
|
396
406
|
|
|
397
407
|
export type OutboundCallback = (msg: OutboundMessage) => Promise<SendResult>
|
|
@@ -423,7 +433,7 @@ export type EditMessageRequest = {
|
|
|
423
433
|
// `permission-denied` is a hard refusal from the platform (e.g. editing a
|
|
424
434
|
// message the bot does not own).
|
|
425
435
|
export type EditMessageResult =
|
|
426
|
-
| { ok: true }
|
|
436
|
+
| { ok: true; deliveredText?: string }
|
|
427
437
|
| {
|
|
428
438
|
ok: false
|
|
429
439
|
error: string
|
package/src/cli/channel.ts
CHANGED
|
@@ -1220,8 +1220,7 @@ async function promptGithubCredentials(cwd: string): Promise<{
|
|
|
1220
1220
|
// length checks below to avoid a TypeError on the "leave blank" path.
|
|
1221
1221
|
const enteredSecret = typeof secret === 'string' ? secret : ''
|
|
1222
1222
|
const reposRaw = await text({
|
|
1223
|
-
message: 'Repositories to allow (comma-separated owner/repo)',
|
|
1224
|
-
validate: (value) => (parseRepos(value ?? '').length > 0 ? undefined : 'At least one owner/repo is required'),
|
|
1223
|
+
message: 'Repositories to allow (comma-separated owner/repo, leave blank to skip)',
|
|
1225
1224
|
})
|
|
1226
1225
|
if (isCancel(reposRaw)) {
|
|
1227
1226
|
cancel('Aborted.')
|
|
@@ -1234,7 +1233,7 @@ async function promptGithubCredentials(cwd: string): Promise<{
|
|
|
1234
1233
|
...(webhookUrl !== undefined ? { webhookUrl } : {}),
|
|
1235
1234
|
webhookPort: Number(port),
|
|
1236
1235
|
...(namedCreds !== undefined ? namedCreds : {}),
|
|
1237
|
-
repos: parseRepos(reposRaw),
|
|
1236
|
+
repos: parseRepos(reposRaw ?? ''),
|
|
1238
1237
|
auth,
|
|
1239
1238
|
}
|
|
1240
1239
|
}
|
package/src/cli/init.ts
CHANGED
|
@@ -1796,8 +1796,7 @@ async function runGithubFlow(cwd: string): Promise<StepResult<CollectedInputs['c
|
|
|
1796
1796
|
// length checks below to avoid a TypeError on the "leave blank" path.
|
|
1797
1797
|
const enteredSecret = typeof secret === 'string' ? secret : ''
|
|
1798
1798
|
const reposRaw = await text({
|
|
1799
|
-
message: 'Repositories to allow (comma-separated owner/repo)',
|
|
1800
|
-
validate: (v) => (parseGithubRepos(v ?? '').length > 0 ? undefined : 'At least one owner/repo is required'),
|
|
1799
|
+
message: 'Repositories to allow (comma-separated owner/repo, leave blank to skip)',
|
|
1801
1800
|
})
|
|
1802
1801
|
if (isCancel(reposRaw)) return back()
|
|
1803
1802
|
const resolvedSecret = enteredSecret.length > 0 ? enteredSecret : randomBytes(32).toString('hex')
|
|
@@ -1808,7 +1807,7 @@ async function runGithubFlow(cwd: string): Promise<StepResult<CollectedInputs['c
|
|
|
1808
1807
|
...(webhookUrl !== undefined ? { webhookUrl } : {}),
|
|
1809
1808
|
webhookPort: Number(port),
|
|
1810
1809
|
...(namedCreds !== undefined ? namedCreds : {}),
|
|
1811
|
-
repos: parseGithubRepos(reposRaw),
|
|
1810
|
+
repos: parseGithubRepos(reposRaw ?? ''),
|
|
1812
1811
|
auth,
|
|
1813
1812
|
},
|
|
1814
1813
|
})
|
package/src/cli/model.ts
CHANGED
|
@@ -6,10 +6,16 @@ import { defineCommand } from 'citty'
|
|
|
6
6
|
|
|
7
7
|
import { type CustomModelMeta, type ThinkingLevel, thinkingLevelSchema } from '@/config'
|
|
8
8
|
import {
|
|
9
|
+
addOverrideMatch,
|
|
9
10
|
addProfile,
|
|
11
|
+
listModelOverrides,
|
|
10
12
|
listModelProfiles,
|
|
11
13
|
listRegisteredModelRefs,
|
|
14
|
+
removeOverride,
|
|
15
|
+
removeOverrideMatch,
|
|
16
|
+
removeOverrideProfile,
|
|
12
17
|
removeProfile,
|
|
18
|
+
setOverrideProfile,
|
|
13
19
|
setProfile,
|
|
14
20
|
setProfileThinkingLevel,
|
|
15
21
|
} from '@/config/models-mutation'
|
|
@@ -62,15 +68,33 @@ const setSub = defineCommand({
|
|
|
62
68
|
"reasoning effort for THIS profile (off|minimal|low|medium|high|xhigh|max|default); the `default` profile's level is the de-facto global default",
|
|
63
69
|
required: false,
|
|
64
70
|
},
|
|
71
|
+
override: {
|
|
72
|
+
type: 'string',
|
|
73
|
+
description: 'set the profile inside this `modelOverrides` entry instead of the global `models`',
|
|
74
|
+
required: false,
|
|
75
|
+
},
|
|
76
|
+
match: {
|
|
77
|
+
type: 'string',
|
|
78
|
+
description: "with --override: add this match rule (e.g. 'slack:*'); required when creating the override",
|
|
79
|
+
required: false,
|
|
80
|
+
},
|
|
65
81
|
},
|
|
66
82
|
async run({ args }) {
|
|
67
83
|
const cwd = ensureAgentDir()
|
|
84
|
+
if (args.match !== undefined && args.override === undefined) {
|
|
85
|
+
console.error(errorLine('--match requires --override <name>.'))
|
|
86
|
+
process.exit(1)
|
|
87
|
+
}
|
|
68
88
|
// `model set <ref>` shorthand targets the `default` profile; a shorthand ref
|
|
69
89
|
// is resolved as an explicit ref (so its errors surface via resolvePickedRef's
|
|
70
90
|
// exit-1 path), and a bare/named-profile invocation falls back to the picker.
|
|
71
91
|
const shorthandRef = resolveShorthandRef(args.profile, args.ref)
|
|
72
92
|
const profile = shorthandRef !== undefined ? 'default' : (args.profile ?? (await pickProfileName()))
|
|
73
93
|
const picked = await resolvePickedRef(shorthandRef ?? args.ref, cwd)
|
|
94
|
+
if (args.override !== undefined) {
|
|
95
|
+
runSetOverrideProfile(cwd, args.override, profile, picked, args)
|
|
96
|
+
return
|
|
97
|
+
}
|
|
74
98
|
|
|
75
99
|
intro(`Setting model profile: ${profile} → ${picked.ref}`)
|
|
76
100
|
|
|
@@ -207,17 +231,26 @@ const removeSub = defineCommand({
|
|
|
207
231
|
description: 'profile name to remove',
|
|
208
232
|
required: true,
|
|
209
233
|
},
|
|
234
|
+
override: {
|
|
235
|
+
type: 'string',
|
|
236
|
+
description: 'remove the profile from this `modelOverrides` entry instead of the global `models`',
|
|
237
|
+
required: false,
|
|
238
|
+
},
|
|
210
239
|
},
|
|
211
240
|
async run({ args }) {
|
|
212
241
|
const cwd = ensureAgentDir()
|
|
213
|
-
|
|
214
|
-
|
|
242
|
+
const scope = args.override !== undefined ? ` from override ${args.override}` : ''
|
|
243
|
+
intro(`Removing model profile: ${args.profile}${scope}`)
|
|
244
|
+
const result =
|
|
245
|
+
args.override !== undefined
|
|
246
|
+
? removeOverrideProfile(cwd, args.override, args.profile)
|
|
247
|
+
: removeProfile(cwd, args.profile)
|
|
215
248
|
if (!result.ok) {
|
|
216
249
|
console.error(errorLine(result.reason))
|
|
217
250
|
process.exit(1)
|
|
218
251
|
}
|
|
219
252
|
done({
|
|
220
|
-
title: c.green(`Profile "${args.profile}" removed.`),
|
|
253
|
+
title: c.green(`Profile "${args.profile}" removed${scope}.`),
|
|
221
254
|
hints: [{ label: 'If the agent is running:', command: 'typeclaw reload' }],
|
|
222
255
|
})
|
|
223
256
|
},
|
|
@@ -274,7 +307,60 @@ const listSub = defineCommand({
|
|
|
274
307
|
}
|
|
275
308
|
}
|
|
276
309
|
}
|
|
310
|
+
|
|
311
|
+
for (const override of listModelOverrides(cwd)) {
|
|
312
|
+
console.log('')
|
|
313
|
+
console.log(`${c.bold(`override ${override.name}`)} ${c.dim(override.match.join(', '))}`)
|
|
314
|
+
for (const p of override.profiles) {
|
|
315
|
+
const thinking = p.thinkingLevel !== undefined ? ` ${c.dim(p.thinkingLevel)}` : ''
|
|
316
|
+
console.log(` ${p.profile.padEnd(profileWidth + 2)}${p.refs.join(' → ')}${thinking}`)
|
|
317
|
+
}
|
|
318
|
+
}
|
|
319
|
+
},
|
|
320
|
+
})
|
|
321
|
+
|
|
322
|
+
const overrideMatchSub = defineCommand({
|
|
323
|
+
meta: { name: 'match', description: 'add a match rule to a `modelOverrides` entry' },
|
|
324
|
+
args: {
|
|
325
|
+
name: { type: 'positional', description: 'override name', required: true },
|
|
326
|
+
rule: { type: 'positional', description: "match rule, e.g. 'slack:T0123/C0123'", required: true },
|
|
327
|
+
},
|
|
328
|
+
run({ args }) {
|
|
329
|
+
finishOverrideEdit(
|
|
330
|
+
addOverrideMatch(ensureAgentDir(), args.name, args.rule),
|
|
331
|
+
`Override "${args.name}" now matches ${args.rule}.`,
|
|
332
|
+
)
|
|
333
|
+
},
|
|
334
|
+
})
|
|
335
|
+
|
|
336
|
+
const overrideUnmatchSub = defineCommand({
|
|
337
|
+
meta: { name: 'unmatch', description: 'remove a match rule from a `modelOverrides` entry' },
|
|
338
|
+
args: {
|
|
339
|
+
name: { type: 'positional', description: 'override name', required: true },
|
|
340
|
+
rule: { type: 'positional', description: 'match rule to remove', required: true },
|
|
341
|
+
},
|
|
342
|
+
run({ args }) {
|
|
343
|
+
finishOverrideEdit(
|
|
344
|
+
removeOverrideMatch(ensureAgentDir(), args.name, args.rule),
|
|
345
|
+
`Override "${args.name}" no longer matches ${args.rule}.`,
|
|
346
|
+
)
|
|
347
|
+
},
|
|
348
|
+
})
|
|
349
|
+
|
|
350
|
+
const overrideRemoveSub = defineCommand({
|
|
351
|
+
meta: { name: 'remove', description: 'delete a `modelOverrides` entry' },
|
|
352
|
+
args: { name: { type: 'positional', description: 'override name', required: true } },
|
|
353
|
+
run({ args }) {
|
|
354
|
+
finishOverrideEdit(removeOverride(ensureAgentDir(), args.name), `Override "${args.name}" removed.`)
|
|
355
|
+
},
|
|
356
|
+
})
|
|
357
|
+
|
|
358
|
+
const overrideSub = defineCommand({
|
|
359
|
+
meta: {
|
|
360
|
+
name: 'override',
|
|
361
|
+
description: 'edit `modelOverrides` match rules (set profiles with `model set --override`)',
|
|
277
362
|
},
|
|
363
|
+
subCommands: { match: overrideMatchSub, unmatch: overrideUnmatchSub, remove: overrideRemoveSub },
|
|
278
364
|
})
|
|
279
365
|
|
|
280
366
|
export const modelCommand = defineCommand({
|
|
@@ -288,9 +374,52 @@ export const modelCommand = defineCommand({
|
|
|
288
374
|
remove: removeSub,
|
|
289
375
|
list: listSub,
|
|
290
376
|
thinking: thinkingSub,
|
|
377
|
+
override: overrideSub,
|
|
291
378
|
},
|
|
292
379
|
})
|
|
293
380
|
|
|
381
|
+
function runSetOverrideProfile(
|
|
382
|
+
cwd: string,
|
|
383
|
+
name: string,
|
|
384
|
+
profile: string,
|
|
385
|
+
picked: PickedModelRef,
|
|
386
|
+
args: { force?: boolean; thinking?: string; match?: string },
|
|
387
|
+
): void {
|
|
388
|
+
let thinking: { level: ThinkingLevel | undefined } | undefined
|
|
389
|
+
if (args.thinking !== undefined) {
|
|
390
|
+
const parsed = parseThinkingArg(args.thinking)
|
|
391
|
+
if (!parsed.ok) {
|
|
392
|
+
console.error(errorLine(parsed.reason))
|
|
393
|
+
process.exit(1)
|
|
394
|
+
}
|
|
395
|
+
thinking = { level: parsed.level }
|
|
396
|
+
}
|
|
397
|
+
intro(`Setting model profile: ${profile} → ${picked.ref} in override ${name}`)
|
|
398
|
+
const result = setOverrideProfile(cwd, name, profile, picked.ref, {
|
|
399
|
+
force: args.force === true,
|
|
400
|
+
...(args.match !== undefined ? { match: args.match } : {}),
|
|
401
|
+
...(picked.meta !== undefined ? { meta: picked.meta } : {}),
|
|
402
|
+
...(thinking !== undefined ? { thinkingLevel: thinking.level } : {}),
|
|
403
|
+
})
|
|
404
|
+
finishOverrideEdit(result, `Profile "${profile}" set in override "${name}".`, `${profile} → ${picked.ref}`)
|
|
405
|
+
}
|
|
406
|
+
|
|
407
|
+
function finishOverrideEdit(
|
|
408
|
+
result: { ok: true } | { ok: false; reason: string },
|
|
409
|
+
title: string,
|
|
410
|
+
details?: string,
|
|
411
|
+
): void {
|
|
412
|
+
if (!result.ok) {
|
|
413
|
+
console.error(errorLine(result.reason))
|
|
414
|
+
process.exit(1)
|
|
415
|
+
}
|
|
416
|
+
done({
|
|
417
|
+
title: c.green(title),
|
|
418
|
+
...(details !== undefined ? { details } : {}),
|
|
419
|
+
hints: [{ label: 'If the agent is running:', command: 'typeclaw reload' }],
|
|
420
|
+
})
|
|
421
|
+
}
|
|
422
|
+
|
|
294
423
|
function ensureAgentDir(): string {
|
|
295
424
|
const cwd = findAgentDir(process.cwd()) ?? process.cwd()
|
|
296
425
|
if (!isInitialized(cwd)) {
|
|
@@ -5,6 +5,7 @@ import { join } from 'node:path'
|
|
|
5
5
|
import { z } from 'zod'
|
|
6
6
|
|
|
7
7
|
import type { SessionOrigin } from '@/agent/session-origin'
|
|
8
|
+
import { adapterNamespace } from '@/channels/adapter-namespace'
|
|
8
9
|
import { getConfig, resolveModel } from '@/config'
|
|
9
10
|
import { KNOWN_PROVIDERS } from '@/config/providers'
|
|
10
11
|
import type { PermissionService } from '@/permissions'
|
|
@@ -474,7 +475,12 @@ function principal(origin: SessionOrigin | undefined): string {
|
|
|
474
475
|
for (let depth = 0; root?.kind === 'subagent' && depth < 8; depth++) root = root.spawnedByOrigin
|
|
475
476
|
if (root?.kind === 'tui') return JSON.stringify(['tui', root.sessionId])
|
|
476
477
|
if (root?.kind === 'channel' && root.lastInboundAuthorId) {
|
|
477
|
-
|
|
478
|
+
const fields = [root.adapter, root.workspace, root.chat, root.thread, root.lastInboundAuthorId]
|
|
479
|
+
const authorNamespace = adapterNamespace(root.lastInboundAuthorAdapter ?? root.adapter)
|
|
480
|
+
// Legacy keys implicitly belong to the target platform. Preserve native
|
|
481
|
+
// and shared-account owners, but never let a foreign ID match those keys.
|
|
482
|
+
if (authorNamespace !== adapterNamespace(root.adapter)) fields.push(authorNamespace)
|
|
483
|
+
return JSON.stringify(fields)
|
|
478
484
|
}
|
|
479
485
|
throw new Error('Coding delegation requires an attributable interactive caller.')
|
|
480
486
|
}
|