typeclaw 0.48.13 → 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 +13 -6
- package/scripts/build-plugin-types.ts +105 -0
- package/scripts/check-plugin-sdk.ts +111 -0
- package/scripts/dump-system-prompt.ts +52 -110
- 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 +210 -80
- package/src/agent/live-sessions.ts +2 -2
- package/src/agent/live-subagents.ts +20 -0
- package/src/agent/multimodal/look-at.ts +22 -9
- package/src/agent/plugin-tools.ts +66 -12
- package/src/agent/prompt-cache-key.ts +42 -0
- package/src/agent/provider-error.ts +179 -10
- package/src/agent/restart-handoff/index.ts +7 -14
- package/src/agent/reviewer-activity.ts +68 -0
- package/src/agent/reviewer-bash-policy.ts +41 -1
- package/src/agent/session-origin.ts +58 -9
- package/src/agent/subagent-cache-keepalive.ts +198 -0
- package/src/agent/subagent-session.ts +6 -0
- package/src/agent/subagents.ts +59 -9
- package/src/agent/system-prompt.ts +68 -202
- package/src/agent/todo/continuation-policy.ts +12 -4
- package/src/agent/tool-file-safety.ts +119 -15
- package/src/agent/tool-not-found-nudge.ts +1 -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-history-render.ts +2 -1
- package/src/agent/tools/channel-read.ts +57 -10
- package/src/agent/tools/channel-reply.ts +55 -30
- package/src/agent/tools/channel-send.ts +69 -19
- package/src/agent/tools/channel-session-search.ts +35 -0
- package/src/agent/tools/curl-impersonate.ts +22 -6
- package/src/agent/tools/ddg.ts +13 -5
- package/src/agent/tools/post-github-review.ts +77 -15
- package/src/agent/tools/skip-response.ts +2 -2
- package/src/agent/tools/spawn-subagent.ts +190 -23
- package/src/agent/tools/stream-snapshot.ts +15 -2
- package/src/agent/tools/subagent-access.ts +11 -4
- package/src/agent/tools/subagent-output.ts +8 -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/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/backup/README.md +10 -9
- package/src/bundled-plugins/backup/runner.ts +140 -58
- package/src/bundled-plugins/backup/subagents.ts +58 -26
- 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 +38 -2
- package/src/bundled-plugins/github-cli-auth/git-auth-diagnostic.ts +95 -0
- package/src/bundled-plugins/github-cli-auth/granted-push.ts +135 -0
- package/src/bundled-plugins/github-cli-auth/index.ts +158 -70
- package/src/bundled-plugins/github-cli-auth/review-account.ts +23 -0
- package/src/bundled-plugins/github-cli-auth/review-checkout.ts +9 -2
- package/src/bundled-plugins/github-cli-auth/review-recorder.ts +45 -7
- 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 +15 -4
- 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/reviewer/skills/code-review.ts +1 -1
- package/src/bundled-plugins/security/index.ts +103 -36
- package/src/bundled-plugins/security/policies/git-exfil.ts +24 -12
- 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-reactions.ts +18 -0
- package/src/channels/adapters/discord-bot.ts +219 -72
- package/src/channels/adapters/discord-reactions.ts +18 -0
- package/src/channels/adapters/discord.ts +114 -8
- package/src/channels/adapters/github/inbound.ts +103 -8
- package/src/channels/adapters/github/index.ts +267 -19
- package/src/channels/adapters/github/last-alive.ts +15 -0
- package/src/channels/adapters/github/outbound.ts +54 -18
- package/src/channels/adapters/github/pending-review-store.ts +141 -0
- package/src/channels/adapters/github/permission-guidance.ts +1 -0
- package/src/channels/adapters/github/reactions.ts +100 -0
- package/src/channels/adapters/github/reconcile-cooldown-store.ts +197 -67
- package/src/channels/adapters/github/reconcile-open-prs.ts +418 -33
- package/src/channels/adapters/github/recovery.ts +106 -0
- package/src/channels/adapters/github/review-check.ts +510 -0
- package/src/channels/adapters/github/review-submitter.ts +34 -2
- package/src/channels/adapters/instagram.ts +32 -14
- package/src/channels/adapters/kakaotalk.ts +22 -7
- package/src/channels/adapters/line.ts +18 -3
- package/src/channels/adapters/outbound-account.ts +20 -0
- package/src/channels/adapters/own-reactions.ts +66 -0
- package/src/channels/adapters/recovery-correlation.ts +214 -0
- 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 +19 -11
- package/src/channels/adapters/slack-bot-dedupe.ts +111 -28
- package/src/channels/adapters/slack-bot-reactions.ts +18 -0
- package/src/channels/adapters/slack-bot-slash-commands.ts +3 -1
- package/src/channels/adapters/slack-bot.ts +424 -124
- package/src/channels/adapters/slack-classify.ts +26 -4
- package/src/channels/adapters/slack-inbound-revision.ts +96 -0
- package/src/channels/adapters/slack-reactions.ts +18 -0
- package/src/channels/adapters/slack-thread-ts.ts +6 -0
- package/src/channels/adapters/slack.ts +48 -3
- package/src/channels/adapters/teams.ts +14 -4
- package/src/channels/adapters/telegram-bot.ts +56 -10
- package/src/channels/adapters/webex-bot.ts +12 -2
- package/src/channels/adapters/webex.ts +12 -2
- package/src/channels/background-handoff.ts +434 -0
- package/src/channels/background-obligations.ts +893 -0
- package/src/channels/catch-up.ts +137 -0
- package/src/channels/continuation-willingness.ts +2 -2
- package/src/channels/continuity-types.ts +272 -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 +598 -0
- package/src/channels/github-review-turn-ledger.ts +102 -28
- package/src/channels/github-review-verdict-coordinator.ts +72 -12
- package/src/channels/github-token-bridge.ts +35 -5
- package/src/channels/inbound-journal.ts +1738 -0
- package/src/channels/index.ts +6 -1
- package/src/channels/last-alive.ts +34 -0
- package/src/channels/manager.ts +25 -8
- package/src/channels/recovery-dispatcher.ts +264 -0
- package/src/channels/recovery-notice.ts +94 -0
- package/src/channels/recovery-outbox.ts +459 -0
- package/src/channels/router.ts +2951 -736
- package/src/channels/schema.ts +8 -1
- 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 +17 -14
- package/src/channels/types.ts +133 -18
- package/src/channels/waiting-reactions.ts +664 -0
- package/src/cli/channel.ts +2 -3
- package/src/cli/compose.ts +7 -4
- package/src/cli/hostd.ts +49 -3
- package/src/cli/init.ts +2 -3
- package/src/cli/inspect.ts +11 -14
- package/src/cli/model.ts +132 -3
- package/src/coding-agent/broker-body.ts +38 -0
- package/src/coding-agent/broker.ts +290 -0
- package/src/coding-agent/claude.ts +95 -0
- package/src/coding-agent/codex.ts +104 -0
- package/src/coding-agent/index.ts +512 -0
- package/src/coding-agent/omo-state.ts +69 -0
- package/src/coding-agent/omo-stream.ts +138 -0
- package/src/coding-agent/omo.ts +192 -0
- package/src/coding-agent/runner.ts +285 -0
- package/src/coding-agent/tool.ts +62 -0
- package/src/coding-agent/worktree.ts +355 -0
- package/src/compose/restart.ts +10 -3
- package/src/compose/start.ts +20 -3
- package/src/config/config.ts +121 -25
- 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 +71 -9
- package/src/container/exit-reason.ts +44 -0
- package/src/container/index.ts +5 -0
- package/src/container/log-archive.ts +51 -13
- package/src/container/memory-limit.ts +1 -1
- package/src/container/memory-oversubscription.ts +36 -6
- package/src/container/oom-events.ts +86 -0
- package/src/container/restart.ts +2 -0
- package/src/container/shared.ts +8 -1
- package/src/container/start.ts +120 -17
- package/src/container/stop.ts +6 -2
- package/src/container/tool-oom-priority.ts +32 -0
- package/src/cron/consumer.ts +10 -4
- package/src/cron/reloadable.ts +23 -2
- package/src/doctor/checks.ts +22 -8
- package/src/hostd/daemon.ts +33 -11
- package/src/hostd/spawn.ts +106 -5
- package/src/hostd/version.ts +20 -0
- package/src/hostd/watchdog.ts +241 -0
- package/src/init/auto-upgrade.ts +7 -1
- package/src/init/dockerfile.ts +112 -602
- package/src/init/index.ts +6 -6
- 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/mcp/client.ts +3 -1
- package/src/operations/classify-tool-outcome.ts +45 -1
- package/src/operations/incidents.ts +10 -5
- 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 +1 -1
- package/src/plugin/define.ts +1 -0
- package/src/plugin/hooks.ts +137 -0
- package/src/plugin/index.ts +7 -0
- package/src/plugin/manager.ts +4 -0
- package/src/plugin/types.ts +66 -1
- package/src/run/background-handoff-boot.ts +86 -0
- package/src/run/bundled-plugins.ts +6 -0
- package/src/run/index.ts +107 -97
- package/src/run/llm-fetch-observer.ts +12 -15
- package/src/run/resource-sample.ts +19 -0
- package/src/sandbox/build.ts +4 -0
- package/src/sandbox/canonical-secrets.ts +4 -0
- package/src/sandbox/coding-agent.ts +214 -0
- package/src/sandbox/dev-source.ts +26 -0
- package/src/sandbox/hidden-paths.ts +16 -2
- package/src/sandbox/policy.ts +1 -0
- package/src/sandbox/runtime-private.ts +4 -1
- package/src/secrets/coding-agent-auth.ts +97 -0
- package/src/secrets/index.ts +0 -16
- package/src/secrets/storage.ts +13 -0
- package/src/server/command-runner.ts +6 -2
- package/src/server/index.ts +101 -40
- package/src/skills/typeclaw-channel-github/SKILL.md +15 -13
- package/src/skills/typeclaw-claude-code/SKILL.md +25 -260
- package/src/skills/typeclaw-claude-code/references/auth-flow.md +7 -23
- package/src/skills/typeclaw-claude-code/references/headless-sessions.md +11 -0
- package/src/skills/typeclaw-claude-code/references/results-and-worktrees.md +13 -0
- package/src/skills/typeclaw-codex-cli/SKILL.md +35 -270
- package/src/skills/typeclaw-codex-cli/references/auth-flow.md +13 -20
- package/src/skills/typeclaw-codex-cli/references/headless-sessions.md +26 -0
- package/src/skills/typeclaw-codex-cli/references/results-and-worktrees.md +28 -0
- package/src/skills/typeclaw-config/SKILL.md +60 -26
- package/src/skills/typeclaw-config/references/dockerfile.md +14 -13
- package/src/skills/typeclaw-cron/SKILL.md +1 -1
- package/src/skills/typeclaw-github-contributing/SKILL.md +3 -3
- package/src/skills/typeclaw-memory/SKILL.md +3 -3
- package/src/skills/typeclaw-monorepo/SKILL.md +1 -1
- package/src/skills/typeclaw-omo-cli/SKILL.md +52 -0
- package/src/skills/typeclaw-omo-cli/references/auth-flow.md +11 -0
- package/src/skills/typeclaw-omo-cli/references/headless-sessions.md +11 -0
- package/src/skills/typeclaw-omo-cli/references/results-and-worktrees.md +23 -0
- package/src/skills/typeclaw-permissions/SKILL.md +7 -7
- package/src/skills/typeclaw-plugins/SKILL.md +15 -15
- package/src/skills/typeclaw-skills/SKILL.md +19 -2
- package/src/skills/typeclaw-troubleshooting/SKILL.md +26 -2
- package/typeclaw.schema.json +448 -6
- package/src/bundled-plugins/doc-render/templates/lib.typ +0 -339
- package/src/bundled-plugins/github-cli-auth/gh-store.ts +0 -733
- package/src/secrets/claude-credentials-json.ts +0 -129
- package/src/secrets/codex-auth-json.ts +0 -102
- package/src/secrets/export-claude-credentials-file.ts +0 -270
- package/src/secrets/export-codex-auth-file.ts +0 -250
- package/src/skills/typeclaw-claude-code/references/stop-hook.md +0 -101
- package/src/skills/typeclaw-claude-code/references/tmux-driving.md +0 -243
- package/src/skills/typeclaw-codex-cli/references/stop-hook.md +0 -92
- package/src/skills/typeclaw-codex-cli/references/tmux-driving.md +0 -239
package/src/channels/schema.ts
CHANGED
|
@@ -295,12 +295,19 @@ export const DEFAULT_GITHUB_REVIEW_ON: GithubReviewOn = 'review_requested'
|
|
|
295
295
|
// Enforced in the inbound text rather than at the bash layer because the
|
|
296
296
|
// review posts via `gh api --input <file>`, so the `event` value lives in a
|
|
297
297
|
// temp file the command interceptor never sees.
|
|
298
|
+
//
|
|
299
|
+
// `check` shows the agent's own review as a check named after the agent's
|
|
300
|
+
// GitHub login (`slug` for an App's `slug[bot]`) on the
|
|
301
|
+
// reviewed commit (in progress while reviewing, then the verdict). On by
|
|
302
|
+
// default; a token without check/status write permission skips it silently
|
|
303
|
+
// after one operator warning.
|
|
298
304
|
const githubReviewSchema = z
|
|
299
305
|
.object({
|
|
300
306
|
on: z.enum(GITHUB_REVIEW_ON_VALUES).default(DEFAULT_GITHUB_REVIEW_ON),
|
|
301
307
|
approve: z.boolean().default(true),
|
|
308
|
+
check: z.boolean().default(true),
|
|
302
309
|
})
|
|
303
|
-
.default({ on: DEFAULT_GITHUB_REVIEW_ON, approve: true })
|
|
310
|
+
.default({ on: DEFAULT_GITHUB_REVIEW_ON, approve: true, check: true })
|
|
304
311
|
|
|
305
312
|
const githubChannelSchema = adapterSchema.extend({
|
|
306
313
|
// Optional now (PR 2): when omitted and a `tunnels[]` entry with
|
|
@@ -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
|
+
}
|
|
@@ -47,8 +47,8 @@ const consoleLogger: SubagentCompletionBridgeLogger = {
|
|
|
47
47
|
// `LiveSession`, so the lookup is O(N) over live sessions with N small
|
|
48
48
|
// (one per active conversation).
|
|
49
49
|
//
|
|
50
|
-
// On `no-live-session`,
|
|
51
|
-
// channel session, the broadcast
|
|
50
|
+
// On `no-live-session`, live routing stops but the durable response remains owed.
|
|
51
|
+
// For a channel session, the broadcast carries the channel-key coordinate
|
|
52
52
|
// `{ adapter, workspace, chat, thread }`, and the router first tries to
|
|
53
53
|
// reroute to the live successor session for that key — covering the two
|
|
54
54
|
// common drop paths where the exact sessionId is gone but the
|
|
@@ -62,22 +62,25 @@ const consoleLogger: SubagentCompletionBridgeLogger = {
|
|
|
62
62
|
// A reminder still reaching this branch means there is no live session
|
|
63
63
|
// for the key at all (the whole conversation went idle), or the parent
|
|
64
64
|
// was a TUI session (handled by the TUI bridge in src/server/index.ts).
|
|
65
|
-
// Logged at warn
|
|
66
|
-
// diagnosable from logs alone.
|
|
65
|
+
// Logged at warn so absent-parent completion routing remains diagnosable.
|
|
67
66
|
export function createSubagentCompletionBridge(options: SubagentCompletionBridgeOptions): SubagentCompletionBridge {
|
|
68
67
|
const logger = options.logger ?? consoleLogger
|
|
69
|
-
const unsubscribe = options.stream.subscribe({ target: { kind: 'broadcast' } }, (msg) => {
|
|
68
|
+
const unsubscribe = options.stream.subscribe({ target: { kind: 'broadcast' } }, async (msg) => {
|
|
70
69
|
const parsed = parseSubagentCompletedPayload(msg.payload)
|
|
71
70
|
if (parsed === null) return
|
|
72
|
-
|
|
73
|
-
|
|
74
|
-
|
|
75
|
-
|
|
76
|
-
|
|
77
|
-
|
|
78
|
-
|
|
79
|
-
|
|
80
|
-
|
|
71
|
+
try {
|
|
72
|
+
const result = await options.router.injectSubagentCompletionReminder(parsed)
|
|
73
|
+
if (result.kind === 'no-live-session') {
|
|
74
|
+
const keyInfo =
|
|
75
|
+
parsed.channelKey !== undefined
|
|
76
|
+
? ` channelKey=${parsed.channelKey.adapter}:${parsed.channelKey.workspace}:${parsed.channelKey.chat}:${parsed.channelKey.thread ?? ''}`
|
|
77
|
+
: ''
|
|
78
|
+
logger.warn(
|
|
79
|
+
`[channels] subagent-completion reminder not routed: no live session for parentSessionId=${parsed.parentSessionId} task=${parsed.taskId}${keyInfo}`,
|
|
80
|
+
)
|
|
81
|
+
}
|
|
82
|
+
} catch {
|
|
83
|
+
logger.warn(`[channels] subagent-completion admission failed: task=${parsed.taskId}; response remains owed`)
|
|
81
84
|
}
|
|
82
85
|
})
|
|
83
86
|
return { stop: unsubscribe }
|