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,798 @@
|
|
|
1
|
+
import { type AgentSession } from "../agent/index.js";
|
|
2
|
+
import { type QuestionSignal } from "../agent/attention-escalation.js";
|
|
3
|
+
import { resolveFallbackChain } from "../agent/model-fallback.js";
|
|
4
|
+
import type { RestartHandoff } from "../agent/restart-handoff/index.js";
|
|
5
|
+
import type { ChannelParticipant, SessionOrigin } from "../agent/session-origin.js";
|
|
6
|
+
import { recordTurnOutcome, runIdleContinuation } from "../agent/todo/continuation-wiring.js";
|
|
7
|
+
import { type PermissionService } from "../permissions/index.js";
|
|
8
|
+
import type { ChannelOutboundBeforeEvent, ChannelOutboundOrigin, HookBus } from "../plugin/index.js";
|
|
9
|
+
import type { Stream } from "../stream/index.js";
|
|
10
|
+
import { BackgroundObligationStore, type BackgroundObligationRef } from "./background-obligations.js";
|
|
11
|
+
import { type ListMissedInbound } from "./catch-up.js";
|
|
12
|
+
import type { RecoveryFailure, RecoveryRecord } from "./continuity-types.js";
|
|
13
|
+
import { type ReviewOutputState, type ReviewRoundOutcome } from "./github-review-turn-ledger.js";
|
|
14
|
+
import { InboundJournal, type InboundRef } from "./inbound-journal.js";
|
|
15
|
+
import { type MembershipCount, type MembershipResolver } from "./membership.js";
|
|
16
|
+
import { channelsSessionsPath, type ChannelSessionRecord } from "./persistence.js";
|
|
17
|
+
import { RecoveryOutbox } from "./recovery-outbox.js";
|
|
18
|
+
import { type AdapterId, type ChannelAdapterConfig } from "./schema.js";
|
|
19
|
+
import { type ChannelHandoffResult } from "./session-handoff.js";
|
|
20
|
+
import { type SessionActivity, type SessionSearchArgs, type SessionSearchTarget } from "./session-search.js";
|
|
21
|
+
import type { ChannelHistoryMessage, ChannelKey, ChannelNameResolver, ChannelSelfIdentityResolver, EditMessageCallback, EditMessageRequest, EditMessageResult, FetchAttachmentArgs, FetchAttachmentCallback, FetchAttachmentResult, FetchHistoryArgs, FetchHistoryResult, GetMessageArgs, GetMessageResult, HistoryCallback, InboundAttachment, GithubReviewFollowupRound, GithubReviewThreadCloseout, InboundMessage, RouteReceipt, InboundReferenceContext, ListCallback, ListChannelsArgs, ListChannelsResult, MessageGetCallback, RemoveReactionCallback, RemoveReactionRequest, PrepareOwnReactionCallback, RemoveOwnReactionCallback, RemoveOwnReactionRequest, RemoveOwnReactionResult, OutboundCallback, OutboundMessage, QuoteAnchorSource, ReactionCallback, ReactionRef, ReactionRequest, ReactionResult, ResolvedChannelNames, ReviewSubmitter, ReviewStateRequest, ReviewStateResolver, ReviewStateResult, ReviewThreadResolveRequest, ReviewThreadResolveResult, ReviewThreadResolver, SendResult, SubmitReviewRequest, SubmitReviewResult, TypingCallback } from "./types.js";
|
|
22
|
+
import type { RecoveryAdapterCallbacks, RecoveryReconcileResult, RecoveryRedelivery, SendOptions as TransportSendOptions } from "./types.js";
|
|
23
|
+
import { type WaitingReactionHandle } from "./waiting-reactions.js";
|
|
24
|
+
export declare const INITIAL_DEBOUNCE_MS = 600;
|
|
25
|
+
export declare const HOT_DEBOUNCE_MS = 1500;
|
|
26
|
+
export declare const MAX_DEBOUNCE_MS = 4000;
|
|
27
|
+
export declare const HOT_THRESHOLD_MS = 3000;
|
|
28
|
+
export declare const MAX_CONSECUTIVE_ABORTS = 3;
|
|
29
|
+
export declare const CONTEXT_BUFFER_SIZE = 20;
|
|
30
|
+
export declare const OBSERVED_MESSAGE_MAX_CHARS = 800;
|
|
31
|
+
export declare const WAKE_REQUEST_LOOKBACK_MS = 60000;
|
|
32
|
+
export declare const TYPING_HEARTBEAT_MS = 8000;
|
|
33
|
+
export declare const MAX_TYPING_HEARTBEAT_MS: number;
|
|
34
|
+
export declare const SESSION_IDLE_MS: number;
|
|
35
|
+
export declare const SESSION_GC_INTERVAL_MS: number;
|
|
36
|
+
export declare const MAX_CHANNEL_SENDS_PER_TURN = 10;
|
|
37
|
+
export declare const ENGAGE_REACTION_EMOJI = "eyes";
|
|
38
|
+
export declare const CONTINUATION_REACTION_EMOJI = "hourglass_flowing_sand";
|
|
39
|
+
export declare const QUEUED_REACTION_EMOJI = "hourglass_flowing_sand";
|
|
40
|
+
export declare const TURN_FAILED_REACTION_EMOJI = "warning";
|
|
41
|
+
export declare const DISENGAGE_REACTION_EMOJI = "zipper_mouth_face";
|
|
42
|
+
export declare function disengageReactionEmojiFor(adapter: AdapterId): string;
|
|
43
|
+
type PendingProviderError = {
|
|
44
|
+
turnSeq: number;
|
|
45
|
+
safeMessage: string;
|
|
46
|
+
retryAndSee: boolean;
|
|
47
|
+
};
|
|
48
|
+
type SilentAckReason = 'github_review_output' | 'awaiting_background_child';
|
|
49
|
+
export declare const RESTART_RESUME_WAKE_REMINDER: string;
|
|
50
|
+
export declare const MAX_POLICY_DENIED_CHANNEL_SENDS_PER_TURN = 3;
|
|
51
|
+
export declare const CHANNEL_MAX_OUTPUT_TOKENS = 16384;
|
|
52
|
+
export declare const CHANNEL_EMPTY_TURN_RETRY_MAX_OUTPUT_TOKENS = 32768;
|
|
53
|
+
export declare const MAX_EMPTY_TURN_RETRIES = 2;
|
|
54
|
+
export declare const MAX_TOOL_LEAK_RETRIES = 1;
|
|
55
|
+
export declare const TOOL_CALL_LEAK_NUDGE: string;
|
|
56
|
+
export declare const EMPTY_TURN_RETRY_NUDGE: string;
|
|
57
|
+
export declare const STRANDED_TOOLUSE_CONTINUATION_NUDGE: string;
|
|
58
|
+
export declare const EMPTY_TURN_FALLBACK_TEXT = "I got stuck putting together a reply and couldn't finish. Could you rephrase or try again?";
|
|
59
|
+
export declare const GITHUB_REVIEW_THREAD_CLOSEOUT_FALLBACK_TEXT = "I wasn't able to complete this follow-up. Leaving this thread open for manual review.";
|
|
60
|
+
export declare const COLD_START_REPLY_NUDGE: string;
|
|
61
|
+
export declare const EMPTY_STOP_AFTER_TOOL_WORK_NUDGE: string;
|
|
62
|
+
export declare const MAX_WILLINGNESS_NUDGES = 1;
|
|
63
|
+
export declare const WILLINGNESS_NUDGE: string;
|
|
64
|
+
export declare const SEND_WILLINGNESS_NUDGE: string;
|
|
65
|
+
export declare const SEND_RATE_WINDOW_MS = 5000;
|
|
66
|
+
export declare const SEND_RATE_WARN_THRESHOLD = 3;
|
|
67
|
+
export declare const OUTBOUND_FLOOD_ERROR = "outbound message denied: content looks like a repeated-character flood";
|
|
68
|
+
/**
|
|
69
|
+
* Soft freshness boundary: the age of the last engaged inbound past which the
|
|
70
|
+
* provider's server-side KV prompt-cache for this session's prefix is assumed
|
|
71
|
+
* cold. Set to the LLM provider's KV-cache TTL (5 min) so a session reused
|
|
72
|
+
* WITHIN this window is guaranteed a cache hit on the provider side.
|
|
73
|
+
*
|
|
74
|
+
* Reaching this boundary no longer forces an immediate rollover. Between the
|
|
75
|
+
* soft boundary and SESSION_GRACE_HARD_TTL_MS, the live path defers to a
|
|
76
|
+
* cost-aware grace decision (see `isGraceWorthReusing`): a session whose fixed
|
|
77
|
+
* base context (rendered system prompt + injected memory + prefetched channel
|
|
78
|
+
* context) still costs more to rebuild than its accumulated transcript is
|
|
79
|
+
* reused for one more turn rather than torn down. This targets the common
|
|
80
|
+
* channel shape — a human replying a few minutes past the cache TTL — where a
|
|
81
|
+
* full cold-start rebuild of a large memory/index-mode base context dominates
|
|
82
|
+
* the cost of carrying a modest transcript forward.
|
|
83
|
+
*
|
|
84
|
+
* Unlike SESSION_IDLE_MS (which evicts the in-memory entry without rollover), a
|
|
85
|
+
* rollover triggers a full tearDownLive + recreate on the next engaged inbound.
|
|
86
|
+
* The old session's transcript is preserved on disk; only the in-memory live
|
|
87
|
+
* entry and sessions.json pointer are replaced.
|
|
88
|
+
*/
|
|
89
|
+
export declare const SESSION_FRESHNESS_TTL_MS: number;
|
|
90
|
+
/**
|
|
91
|
+
* Hard ceiling on the cost-aware grace window. Past this age the live session is
|
|
92
|
+
* rolled over unconditionally regardless of base-vs-transcript cost: the grace
|
|
93
|
+
* decision only defers rollover, it never makes the session immortal. Bounding
|
|
94
|
+
* grace at 2x the soft TTL keeps a never-quite-idle session from accumulating an
|
|
95
|
+
* ever-growing, fully-uncached prefix (every turn past the soft boundary re-sends
|
|
96
|
+
* the whole prefix at no provider-cache discount) and prevents grace from
|
|
97
|
+
* silently becoming an unbounded TTL increase.
|
|
98
|
+
*/
|
|
99
|
+
export declare const SESSION_GRACE_HARD_TTL_MS: number;
|
|
100
|
+
/**
|
|
101
|
+
* Leak guard — NOT a freshness cap. A running background subagent pins its parent
|
|
102
|
+
* channel session against idle GC and stale-rollover for as long as the child is
|
|
103
|
+
* actually running, because the next inbound would otherwise start a fresh session
|
|
104
|
+
* that has lost track of the in-flight task and spawns a DUPLICATE child, and — the
|
|
105
|
+
* bug this backstop is sized around — a completion arriving after teardown has no
|
|
106
|
+
* live session to deliver its system-reminder to and is silently dropped.
|
|
107
|
+
*
|
|
108
|
+
* The pin is bounded only so a genuinely stuck/wedged child cannot make the session
|
|
109
|
+
* immortal. Subagent `timeoutMs` is optional (operator declares none), so a hung
|
|
110
|
+
* child stays `status: 'running'` forever; without this ceiling its parent session
|
|
111
|
+
* would leak indefinitely. Past this age the child is treated as stuck: GC/rollover
|
|
112
|
+
* proceeds and the session falls back to completion-reroute.
|
|
113
|
+
*
|
|
114
|
+
* Sized as an ANOMALY threshold, deliberately far above any legitimate run (deep
|
|
115
|
+
* operator work is minutes-to-an-hour, not hours), so it never fires for real work.
|
|
116
|
+
* The prior 45m value was close enough to plausible deep work to turn a legitimate
|
|
117
|
+
* long run into a routine drop — the reported 65m completion loss. 6h is clearly
|
|
118
|
+
* "this child is wedged," not "this child is busy".
|
|
119
|
+
*/
|
|
120
|
+
export declare const SESSION_CHILD_STUCK_BACKSTOP_MS: number;
|
|
121
|
+
/**
|
|
122
|
+
* Cost-aware grace decision for the soft→hard TTL band. Returns true when reusing
|
|
123
|
+
* the (now cache-cold) live session is cheaper than a fresh cold-start.
|
|
124
|
+
*
|
|
125
|
+
* After the soft TTL the provider prefix is cold either way, so the choice is:
|
|
126
|
+
* - rollover: pay to rebuild the fixed base context (system prompt + memory +
|
|
127
|
+
* prefetched context) plus a fresh first model call, OR
|
|
128
|
+
* - reuse: re-send the cold base context PLUS the accumulated transcript.
|
|
129
|
+
*
|
|
130
|
+
* Rollover only wins once the transcript a reused session would carry forward
|
|
131
|
+
* exceeds the base context a rollover would rebuild. We approximate both with the
|
|
132
|
+
* session transcript file: `baseContextBytes` is its size captured right after
|
|
133
|
+
* cold-start (the rendered prompt before any user turn), and the live delta is
|
|
134
|
+
* the growth since. While `baseContextBytes > transcriptDeltaBytes`, the fixed
|
|
135
|
+
* rebuild is the larger cost and grace is worth it. A `baseContextBytes` of 0
|
|
136
|
+
* (no transcript path available) disables grace — fail closed to the prior
|
|
137
|
+
* roll-over-at-soft-TTL behavior.
|
|
138
|
+
*/
|
|
139
|
+
export declare function isGraceWorthReusing(baseContextBytes: number, transcriptDeltaBytes: number): boolean;
|
|
140
|
+
export declare const ENSURE_LIVE_TIMEOUT_MS = 30000;
|
|
141
|
+
export declare class StaleLiveSessionError extends Error {
|
|
142
|
+
constructor(keyId: string);
|
|
143
|
+
}
|
|
144
|
+
export declare const RESOLVE_CHANNEL_NAMES_TIMEOUT_MS = 5000;
|
|
145
|
+
export declare const FETCH_HISTORY_TIMEOUT_MS = 5000;
|
|
146
|
+
export declare const HISTORY_ATTACHMENT_LIMIT = 50;
|
|
147
|
+
export declare const SESSION_IDLE_TIMEOUT_MS = 30000;
|
|
148
|
+
export declare const PEER_BOT_TURNS_WINDOW_MS = 60000;
|
|
149
|
+
export declare const MAX_PEER_BOT_TURNS_IN_WINDOW = 5;
|
|
150
|
+
export declare const MAX_CONSECUTIVE_PEER_BOT_TURNS_SINCE_HUMAN = 5;
|
|
151
|
+
export type RouterLogger = {
|
|
152
|
+
info: (msg: string) => void;
|
|
153
|
+
warn: (msg: string) => void;
|
|
154
|
+
error: (msg: string) => void;
|
|
155
|
+
};
|
|
156
|
+
export type CreateSessionForChannel = (params: {
|
|
157
|
+
key: ChannelKey;
|
|
158
|
+
existingSessionId?: string;
|
|
159
|
+
existingSessionFile?: string;
|
|
160
|
+
participants: readonly ChannelParticipant[];
|
|
161
|
+
origin: SessionOrigin;
|
|
162
|
+
originRef: {
|
|
163
|
+
current: SessionOrigin | undefined;
|
|
164
|
+
};
|
|
165
|
+
}) => Promise<{
|
|
166
|
+
session: ChannelAgentSession;
|
|
167
|
+
sessionId: string;
|
|
168
|
+
dispose: () => Promise<void>;
|
|
169
|
+
hooks?: HookBus;
|
|
170
|
+
getTranscriptPath?: () => string | undefined;
|
|
171
|
+
}>;
|
|
172
|
+
export type ConfigForAdapter = (adapter: ChannelKey['adapter']) => ChannelAdapterConfig | undefined;
|
|
173
|
+
export type { ChannelHandoffResult } from "./session-handoff.js";
|
|
174
|
+
type QueuedInbound = {
|
|
175
|
+
inputId: string;
|
|
176
|
+
text: string;
|
|
177
|
+
referenceContext?: InboundReferenceContext;
|
|
178
|
+
attachments?: readonly InboundAttachment[];
|
|
179
|
+
authorId: string;
|
|
180
|
+
authorAdapter?: AdapterId;
|
|
181
|
+
authorName: string;
|
|
182
|
+
authorIsBot: boolean;
|
|
183
|
+
externalMessageId: string;
|
|
184
|
+
reactionRef?: ReactionRef;
|
|
185
|
+
engageReaction?: WaitingReactionHandle;
|
|
186
|
+
isBotMention: boolean;
|
|
187
|
+
isBotMentionOnly?: boolean;
|
|
188
|
+
replyToBotMessageId: string | null;
|
|
189
|
+
isDm: boolean;
|
|
190
|
+
typingThread?: string;
|
|
191
|
+
receivedAt: number;
|
|
192
|
+
ts: number;
|
|
193
|
+
githubReviewRound?: GithubReviewFollowupRound;
|
|
194
|
+
githubReviewThreadCloseout?: GithubReviewThreadCloseout;
|
|
195
|
+
routingNote?: string;
|
|
196
|
+
handoff?: true;
|
|
197
|
+
};
|
|
198
|
+
type ObservedInbound = {
|
|
199
|
+
text: string;
|
|
200
|
+
referenceContext?: InboundReferenceContext;
|
|
201
|
+
attachments?: readonly InboundAttachment[];
|
|
202
|
+
authorId: string;
|
|
203
|
+
authorName: string;
|
|
204
|
+
authorIsBot: boolean;
|
|
205
|
+
receivedAt: number;
|
|
206
|
+
ts: number;
|
|
207
|
+
source: 'prefetch' | 'observed';
|
|
208
|
+
};
|
|
209
|
+
type TimedAttachment = {
|
|
210
|
+
ts: number;
|
|
211
|
+
attachment: InboundAttachment;
|
|
212
|
+
current?: boolean;
|
|
213
|
+
};
|
|
214
|
+
type ChannelAgentSession = AgentSession & {
|
|
215
|
+
getAbortReason?: () => string | undefined;
|
|
216
|
+
};
|
|
217
|
+
type PendingSystemReminder = {
|
|
218
|
+
text: string;
|
|
219
|
+
kind: 'retry' | 'wakeup';
|
|
220
|
+
githubReviewRoundKey?: string;
|
|
221
|
+
backgroundObligationId?: string;
|
|
222
|
+
backgroundWake?: boolean;
|
|
223
|
+
inboundRetry?: {
|
|
224
|
+
inputIds: string[];
|
|
225
|
+
turnId: string;
|
|
226
|
+
};
|
|
227
|
+
backgroundRetry?: {
|
|
228
|
+
turnId: string;
|
|
229
|
+
obligationIds: string[];
|
|
230
|
+
emptyTurnRetries: number;
|
|
231
|
+
toolLeakRetries: number;
|
|
232
|
+
willingnessNudges: number;
|
|
233
|
+
nextPromptMaxTokens: number | undefined;
|
|
234
|
+
};
|
|
235
|
+
};
|
|
236
|
+
type LiveSession = {
|
|
237
|
+
key: ChannelKey;
|
|
238
|
+
keyId: string;
|
|
239
|
+
room: InboundMessage['room'];
|
|
240
|
+
session: ChannelAgentSession;
|
|
241
|
+
activeModelRef: ReturnType<typeof resolveFallbackChain>[number];
|
|
242
|
+
turnThinkingDefault: AgentSession['thinkingLevel'];
|
|
243
|
+
lastQuestionSignal: QuestionSignal | null;
|
|
244
|
+
pendingUserTurnSignal: {
|
|
245
|
+
signal: QuestionSignal;
|
|
246
|
+
} | null;
|
|
247
|
+
sessionId: string;
|
|
248
|
+
dispose: () => Promise<void>;
|
|
249
|
+
hooks: HookBus | undefined;
|
|
250
|
+
getTranscriptPath: (() => string | undefined) | undefined;
|
|
251
|
+
participants: ChannelParticipant[];
|
|
252
|
+
resolvedNames: ResolvedChannelNames;
|
|
253
|
+
originRef: {
|
|
254
|
+
current: SessionOrigin | undefined;
|
|
255
|
+
};
|
|
256
|
+
githubReviewRound: GithubReviewFollowupRound | null;
|
|
257
|
+
githubReviewThreadCloseout: (GithubReviewThreadCloseout & {
|
|
258
|
+
startedAt: number;
|
|
259
|
+
correctionAttempts: number;
|
|
260
|
+
deferred: boolean;
|
|
261
|
+
}) | null;
|
|
262
|
+
githubReviewThreadCloseoutDecisionTurn: number | null;
|
|
263
|
+
pendingGithubReviewRoundCloseout: string | null;
|
|
264
|
+
promptQueue: QueuedInbound[];
|
|
265
|
+
contextBuffer: ObservedInbound[];
|
|
266
|
+
currentTurnAttachments: readonly TimedAttachment[];
|
|
267
|
+
historyTimedAttachments: readonly TimedAttachment[];
|
|
268
|
+
draining: boolean;
|
|
269
|
+
activeDrains: Set<Promise<void>>;
|
|
270
|
+
debounceTimer: ReturnType<typeof setTimeout> | null;
|
|
271
|
+
typingTimer: ReturnType<typeof setInterval> | null;
|
|
272
|
+
typingStartedAt: number;
|
|
273
|
+
typingTimedOut: boolean;
|
|
274
|
+
typingStopPromise: Promise<void> | null;
|
|
275
|
+
typingEpoch: number;
|
|
276
|
+
promptInFlight: boolean;
|
|
277
|
+
lastInboundAt: number;
|
|
278
|
+
recentMessages: SessionActivity[];
|
|
279
|
+
baseContextBytes: number;
|
|
280
|
+
firstUnprocessedAt: number;
|
|
281
|
+
currentTurnAuthorId: string | null;
|
|
282
|
+
currentTurnAuthorAdapter: AdapterId;
|
|
283
|
+
currentTurnAuthorIds: Set<string>;
|
|
284
|
+
currentTurnReactionRef: ReactionRef | null;
|
|
285
|
+
currentTurnExplicitlyAddressed: boolean;
|
|
286
|
+
currentTurnHandoff: boolean;
|
|
287
|
+
lastInboundIsDm: boolean;
|
|
288
|
+
originHintedKeys: Set<string>;
|
|
289
|
+
currentTurnTypingThread: string | null;
|
|
290
|
+
dirtyTypingThreads: Set<string>;
|
|
291
|
+
currentTurnEngageReactions: WaitingReactionHandle[];
|
|
292
|
+
pendingTurnReactions: ReactionRequest[];
|
|
293
|
+
silentAckTurn: {
|
|
294
|
+
turnSeq: number;
|
|
295
|
+
reason: SilentAckReason;
|
|
296
|
+
} | null;
|
|
297
|
+
activeContinuationReactions: WaitingReactionHandle[];
|
|
298
|
+
lastTurnAuthorIds: Set<string>;
|
|
299
|
+
lastTurnAuthorId: string | null;
|
|
300
|
+
lastTurnAuthorAdapter: AdapterId;
|
|
301
|
+
lastTurnHandoff: boolean;
|
|
302
|
+
consecutiveAborts: number;
|
|
303
|
+
pendingSystemReminders: PendingSystemReminder[];
|
|
304
|
+
backgroundCoverage: string[];
|
|
305
|
+
inboundCoverage: string[];
|
|
306
|
+
turnAccountIdentity?: string;
|
|
307
|
+
backgroundTurnId: string;
|
|
308
|
+
backgroundTurnOwnerSessionId: string;
|
|
309
|
+
backgroundStopVersion: number;
|
|
310
|
+
willingnessReminderIteration: boolean;
|
|
311
|
+
consecutiveSends: Map<string, number>;
|
|
312
|
+
lastSentText: Map<string, string>;
|
|
313
|
+
lastSendLeafId: string | null;
|
|
314
|
+
sendTimestamps: Map<string, number[]>;
|
|
315
|
+
successfulChannelSends: number;
|
|
316
|
+
turnSeq: number;
|
|
317
|
+
logicalTurnStartedAt: number;
|
|
318
|
+
coverageDeferredSince: number | null;
|
|
319
|
+
coverageDeferredParentSessionId: string | null;
|
|
320
|
+
successfulSendsAtTurnStart: number;
|
|
321
|
+
inFlightToolSends: Map<string, number>;
|
|
322
|
+
policyDeniedToolSendsThisTurn: Map<string, number>;
|
|
323
|
+
emptyTurnRetries: number;
|
|
324
|
+
toolLeakRetries: number;
|
|
325
|
+
emptyStopAfterToolWorkArmed: boolean;
|
|
326
|
+
willingnessNudges: number;
|
|
327
|
+
lastTerminalReplyCompletion: {
|
|
328
|
+
turnSeq: number;
|
|
329
|
+
text?: string;
|
|
330
|
+
tokens: number;
|
|
331
|
+
} | null;
|
|
332
|
+
pendingTerminalReplyStop: {
|
|
333
|
+
turnSeq: number;
|
|
334
|
+
tokens: number;
|
|
335
|
+
} | null;
|
|
336
|
+
continueReplyTurn: {
|
|
337
|
+
turnSeq: number;
|
|
338
|
+
sendCount: number;
|
|
339
|
+
} | null;
|
|
340
|
+
abortReasonThisTurn: {
|
|
341
|
+
turnSeq: number;
|
|
342
|
+
reason: string;
|
|
343
|
+
} | null;
|
|
344
|
+
userStoppedTurnSeq: number | null;
|
|
345
|
+
nextPromptMaxTokens: number | undefined;
|
|
346
|
+
skippedTurn: {
|
|
347
|
+
turnSeq: number;
|
|
348
|
+
reason: string;
|
|
349
|
+
} | null;
|
|
350
|
+
skipLockedSendTurn: number | null;
|
|
351
|
+
disengagedTurn: number | null;
|
|
352
|
+
emptyTurnFallbackTurn: number | null;
|
|
353
|
+
stagedFallbackCause: {
|
|
354
|
+
cause: string;
|
|
355
|
+
sendCountAtStage: number;
|
|
356
|
+
} | null;
|
|
357
|
+
githubReviewOutputTurn: number | null;
|
|
358
|
+
toolExecutionThisLogicalTurn: boolean;
|
|
359
|
+
backgroundWakeLogicalTurn: boolean;
|
|
360
|
+
providerErrorSilencedThisLogicalTurn: boolean;
|
|
361
|
+
qualifyingWorkThisLogicalTurn: boolean;
|
|
362
|
+
promisedWorkOutstandingThisLogicalTurn: boolean;
|
|
363
|
+
statusOutputOutstandingThisLogicalTurn: boolean;
|
|
364
|
+
nextInboundContinuationTurnId: string | null;
|
|
365
|
+
pendingQuoteCandidate: QuoteAnchorCandidate | null;
|
|
366
|
+
recentEngagedPeerBotTurns: {
|
|
367
|
+
authorId: string;
|
|
368
|
+
ts: number;
|
|
369
|
+
}[];
|
|
370
|
+
consecutiveEngagedPeerBotTurns: number;
|
|
371
|
+
loopGuardActive: boolean;
|
|
372
|
+
multiHumanGroup: boolean;
|
|
373
|
+
createdFromColdStart: boolean;
|
|
374
|
+
coldStartSoloFallbackTurnActive: boolean;
|
|
375
|
+
membershipFetch: Promise<MembershipCount | null> | null;
|
|
376
|
+
pendingProviderError: PendingProviderError | null;
|
|
377
|
+
destroyed: boolean;
|
|
378
|
+
pendingTeardown: boolean;
|
|
379
|
+
unsubProviderErrors: (() => void) | null;
|
|
380
|
+
unsubTypingActivity: (() => void) | null;
|
|
381
|
+
unsubTodoOutcome: (() => void) | null;
|
|
382
|
+
todoOutcomeWrite: Promise<boolean>;
|
|
383
|
+
};
|
|
384
|
+
export type ExecuteCommandResult = {
|
|
385
|
+
kind: 'handled';
|
|
386
|
+
name: string;
|
|
387
|
+
reply?: string;
|
|
388
|
+
} | {
|
|
389
|
+
kind: 'unknown-command';
|
|
390
|
+
name: string;
|
|
391
|
+
} | {
|
|
392
|
+
kind: 'no-live-session';
|
|
393
|
+
} | {
|
|
394
|
+
kind: 'permission-denied';
|
|
395
|
+
} | {
|
|
396
|
+
kind: 'ambiguous';
|
|
397
|
+
matchCount: number;
|
|
398
|
+
};
|
|
399
|
+
export type ExecuteCommandOptions = {
|
|
400
|
+
invokerId: string;
|
|
401
|
+
parentChat?: string;
|
|
402
|
+
};
|
|
403
|
+
export type SendSource = 'tool' | 'system';
|
|
404
|
+
export type SendOptions = TransportSendOptions & {
|
|
405
|
+
source?: SendSource;
|
|
406
|
+
accountingTarget?: ChannelKey;
|
|
407
|
+
outputKind?: 'substantive' | 'status' | 'meta';
|
|
408
|
+
origin?: ChannelOutboundOrigin;
|
|
409
|
+
};
|
|
410
|
+
export type EditMessageOptions = {
|
|
411
|
+
origin?: ChannelOutboundOrigin;
|
|
412
|
+
};
|
|
413
|
+
export type ChannelOutboundReviewer = (event: ChannelOutboundBeforeEvent) => Promise<{
|
|
414
|
+
text: string;
|
|
415
|
+
}>;
|
|
416
|
+
export declare const DUPLICATE_SEND_ERROR: string;
|
|
417
|
+
export declare const TURN_CAP_ERROR: string;
|
|
418
|
+
export declare const SKIP_RESPONSE_LOCK_ERROR: string;
|
|
419
|
+
export type ChannelRouter = {
|
|
420
|
+
registerMissedInbound: (adapter: AdapterId, callback: ListMissedInbound) => void;
|
|
421
|
+
unregisterMissedInbound: (adapter: AdapterId, callback: ListMissedInbound) => void;
|
|
422
|
+
catchUp: (adapter: AdapterId) => Promise<void>;
|
|
423
|
+
disconnectCatchUp: (adapter: AdapterId) => void;
|
|
424
|
+
catchUpTargets: (adapter: AdapterId) => Promise<readonly ChannelKey[]>;
|
|
425
|
+
route: (event: InboundMessage, onAdmitted?: () => Promise<void>) => Promise<RouteReceipt>;
|
|
426
|
+
send: (msg: OutboundMessage, opts?: SendOptions) => Promise<SendResult>;
|
|
427
|
+
acceptBackgroundResponse: (args: {
|
|
428
|
+
parentSessionId: string;
|
|
429
|
+
parentSessionFile?: string;
|
|
430
|
+
key: ChannelKey;
|
|
431
|
+
taskId: string;
|
|
432
|
+
subagentName: string;
|
|
433
|
+
startedAt: number;
|
|
434
|
+
accountIdentity: string;
|
|
435
|
+
triggeringAuthorId?: string;
|
|
436
|
+
parentChat?: string;
|
|
437
|
+
}) => Promise<BackgroundObligationRef>;
|
|
438
|
+
suppressUnstartedBackgroundResponse: (ref: BackgroundObligationRef, reason: string) => Promise<void>;
|
|
439
|
+
attachBackgroundResultCoverage: (args: {
|
|
440
|
+
parentSessionId: string;
|
|
441
|
+
taskId: string;
|
|
442
|
+
}) => Promise<void>;
|
|
443
|
+
captureBackgroundResultCoverage?: (parentSessionId: string) => Promise<BackgroundObligationRef[]>;
|
|
444
|
+
captureInboundResultCoverage?: (parentSessionId: string) => Promise<InboundRef[]>;
|
|
445
|
+
captureTurnAccountIdentity?: (parentSessionId: string, adapter: ChannelKey['adapter']) => Promise<string | undefined>;
|
|
446
|
+
getConsecutiveSendCount: (target: {
|
|
447
|
+
adapter: ChannelKey['adapter'];
|
|
448
|
+
workspace: string;
|
|
449
|
+
chat: string;
|
|
450
|
+
thread?: string | null;
|
|
451
|
+
}) => number;
|
|
452
|
+
hasQualifyingWorkThisLogicalTurn?: (target: ChannelKey) => boolean;
|
|
453
|
+
getSendRate: (target: {
|
|
454
|
+
adapter: ChannelKey['adapter'];
|
|
455
|
+
workspace: string;
|
|
456
|
+
chat: string;
|
|
457
|
+
thread?: string | null;
|
|
458
|
+
}) => {
|
|
459
|
+
count: number;
|
|
460
|
+
windowMs: number;
|
|
461
|
+
};
|
|
462
|
+
registerOutbound: (adapter: ChannelKey['adapter'], cb: OutboundCallback) => void;
|
|
463
|
+
unregisterOutbound: (adapter: ChannelKey['adapter'], cb: OutboundCallback) => void;
|
|
464
|
+
registerRecoveryAdapter: (adapter: ChannelKey['adapter'], callbacks: RecoveryAdapterCallbacks) => void;
|
|
465
|
+
unregisterRecoveryAdapter: (adapter: ChannelKey['adapter'], callbacks: RecoveryAdapterCallbacks) => void;
|
|
466
|
+
getRecoveryAccountIdentity: (adapter: ChannelKey['adapter'], workspace?: string) => Promise<string | undefined>;
|
|
467
|
+
validateRecovery: (record: RecoveryRecord) => Promise<RecoveryFailure | undefined>;
|
|
468
|
+
reconcileRecovery: (record: RecoveryRecord) => Promise<RecoveryReconcileResult>;
|
|
469
|
+
recoveryRedelivery?: (record: RecoveryRecord, eventKinds: readonly string[]) => RecoveryRedelivery;
|
|
470
|
+
setRecoveryStopHandler: (handler: (target: ChannelKey, parentSessionId: string) => Promise<void>) => void;
|
|
471
|
+
registerReaction: (adapter: ChannelKey['adapter'], cb: ReactionCallback) => void;
|
|
472
|
+
unregisterReaction: (adapter: ChannelKey['adapter'], cb: ReactionCallback) => void;
|
|
473
|
+
react: (req: ReactionRequest) => Promise<ReactionResult>;
|
|
474
|
+
queueReactionAfterReply: (req: ReactionRequest) => Promise<ReactionResult>;
|
|
475
|
+
registerRemoveReaction: (adapter: ChannelKey['adapter'], cb: RemoveReactionCallback) => void;
|
|
476
|
+
unregisterRemoveReaction: (adapter: ChannelKey['adapter'], cb: RemoveReactionCallback) => void;
|
|
477
|
+
removeReaction: (req: RemoveReactionRequest) => Promise<ReactionResult>;
|
|
478
|
+
registerPrepareOwnReaction: (adapter: ChannelKey['adapter'], cb: PrepareOwnReactionCallback) => void;
|
|
479
|
+
unregisterPrepareOwnReaction: (adapter: ChannelKey['adapter'], cb: PrepareOwnReactionCallback) => void;
|
|
480
|
+
registerRemoveOwnReaction: (adapter: ChannelKey['adapter'], cb: RemoveOwnReactionCallback) => void;
|
|
481
|
+
unregisterRemoveOwnReaction: (adapter: ChannelKey['adapter'], cb: RemoveOwnReactionCallback) => void;
|
|
482
|
+
removeOwnReaction: (req: RemoveOwnReactionRequest) => Promise<RemoveOwnReactionResult>;
|
|
483
|
+
recoverWaitingReactions: (adapter?: ChannelKey['adapter']) => Promise<void>;
|
|
484
|
+
registerTyping: (adapter: ChannelKey['adapter'], cb: TypingCallback) => void;
|
|
485
|
+
unregisterTyping: (adapter: ChannelKey['adapter'], cb: TypingCallback) => void;
|
|
486
|
+
setTypingCapability: (adapter: ChannelKey['adapter'], supported: boolean) => void;
|
|
487
|
+
setTypingHeartbeatInterval: (adapter: ChannelKey['adapter'], intervalMs: number) => void;
|
|
488
|
+
setAdapterConfigured: (adapter: ChannelKey['adapter'], configured: boolean) => void;
|
|
489
|
+
registerChannelNameResolver: (adapter: ChannelKey['adapter'], resolver: ChannelNameResolver) => void;
|
|
490
|
+
unregisterChannelNameResolver: (adapter: ChannelKey['adapter'], resolver: ChannelNameResolver) => void;
|
|
491
|
+
registerSelfIdentity: (adapter: ChannelKey['adapter'], resolver: ChannelSelfIdentityResolver) => void;
|
|
492
|
+
unregisterSelfIdentity: (adapter: ChannelKey['adapter'], resolver: ChannelSelfIdentityResolver) => void;
|
|
493
|
+
registerMembership: (adapter: ChannelKey['adapter'], resolver: MembershipResolver) => void;
|
|
494
|
+
unregisterMembership: (adapter: ChannelKey['adapter'], resolver: MembershipResolver) => void;
|
|
495
|
+
registerHistory: (adapter: ChannelKey['adapter'], cb: HistoryCallback) => void;
|
|
496
|
+
unregisterHistory: (adapter: ChannelKey['adapter'], cb: HistoryCallback) => void;
|
|
497
|
+
fetchHistory: (adapter: ChannelKey['adapter'], args: FetchHistoryArgs) => Promise<FetchHistoryResult>;
|
|
498
|
+
registerMessageGet: (adapter: ChannelKey['adapter'], cb: MessageGetCallback) => void;
|
|
499
|
+
unregisterMessageGet: (adapter: ChannelKey['adapter'], cb: MessageGetCallback) => void;
|
|
500
|
+
getMessage: (adapter: ChannelKey['adapter'], args: GetMessageArgs) => Promise<GetMessageResult>;
|
|
501
|
+
registerList: (adapter: ChannelKey['adapter'], cb: ListCallback) => void;
|
|
502
|
+
unregisterList: (adapter: ChannelKey['adapter'], cb: ListCallback) => void;
|
|
503
|
+
listChannels: (adapter: ChannelKey['adapter'], args: ListChannelsArgs) => Promise<ListChannelsResult>;
|
|
504
|
+
registerEditMessage: (adapter: ChannelKey['adapter'], cb: EditMessageCallback) => void;
|
|
505
|
+
unregisterEditMessage: (adapter: ChannelKey['adapter'], cb: EditMessageCallback) => void;
|
|
506
|
+
editMessage: (req: EditMessageRequest, opts?: EditMessageOptions) => Promise<EditMessageResult>;
|
|
507
|
+
reviewOutbound: (event: ChannelOutboundBeforeEvent) => Promise<string>;
|
|
508
|
+
hasOutboundReviewer: () => boolean;
|
|
509
|
+
registerFetchAttachment: (adapter: ChannelKey['adapter'], cb: FetchAttachmentCallback) => void;
|
|
510
|
+
unregisterFetchAttachment: (adapter: ChannelKey['adapter'], cb: FetchAttachmentCallback) => void;
|
|
511
|
+
fetchAttachment: (adapter: ChannelKey['adapter'], args: FetchAttachmentArgs) => Promise<FetchAttachmentResult>;
|
|
512
|
+
registerReviewThreadResolver: (adapter: ChannelKey['adapter'], resolver: ReviewThreadResolver) => void;
|
|
513
|
+
unregisterReviewThreadResolver: (adapter: ChannelKey['adapter'], resolver: ReviewThreadResolver) => void;
|
|
514
|
+
resolveReviewThread: (req: ReviewThreadResolveRequest) => Promise<ReviewThreadResolveResult>;
|
|
515
|
+
registerReviewStateResolver: (adapter: ChannelKey['adapter'], resolver: ReviewStateResolver) => void;
|
|
516
|
+
unregisterReviewStateResolver: (adapter: ChannelKey['adapter'], resolver: ReviewStateResolver) => void;
|
|
517
|
+
getReviewState: (req: ReviewStateRequest) => Promise<ReviewStateResult>;
|
|
518
|
+
registerReviewSubmitter: (adapter: ChannelKey['adapter'], submitter: ReviewSubmitter) => void;
|
|
519
|
+
unregisterReviewSubmitter: (adapter: ChannelKey['adapter'], submitter: ReviewSubmitter) => void;
|
|
520
|
+
submitReview: (req: SubmitReviewRequest) => Promise<SubmitReviewResult>;
|
|
521
|
+
lookupInboundAttachment: (args: ChannelKey & {
|
|
522
|
+
id: number;
|
|
523
|
+
ref?: string;
|
|
524
|
+
}) => InboundAttachment | null;
|
|
525
|
+
listInboundAttachmentIds: (args: ChannelKey) => readonly number[];
|
|
526
|
+
registerHistoryAttachments: (key: ChannelKey, messages: readonly ChannelHistoryMessage[]) => void;
|
|
527
|
+
executeCommand: (key: ChannelKey, name: string, options: ExecuteCommandOptions) => Promise<ExecuteCommandResult>;
|
|
528
|
+
getSelfAliases: () => readonly string[];
|
|
529
|
+
handoff: (args: {
|
|
530
|
+
fromSessionId: string;
|
|
531
|
+
target: ChannelKey;
|
|
532
|
+
text: string;
|
|
533
|
+
}) => Promise<ChannelHandoffResult>;
|
|
534
|
+
searchSessions: (args: SessionSearchArgs) => SessionSearchTarget[];
|
|
535
|
+
injectSubagentCompletionReminder: (args: {
|
|
536
|
+
parentSessionId: string;
|
|
537
|
+
subagent: string;
|
|
538
|
+
taskId: string;
|
|
539
|
+
ok: boolean;
|
|
540
|
+
durationMs: number;
|
|
541
|
+
error?: string;
|
|
542
|
+
channelKey?: {
|
|
543
|
+
adapter: string;
|
|
544
|
+
workspace: string;
|
|
545
|
+
chat: string;
|
|
546
|
+
thread: string | null;
|
|
547
|
+
};
|
|
548
|
+
}) => Promise<{
|
|
549
|
+
kind: 'delivered';
|
|
550
|
+
keyId: string;
|
|
551
|
+
} | {
|
|
552
|
+
kind: 'no-live-session';
|
|
553
|
+
}>;
|
|
554
|
+
injectPrVerdictActivity: (args: {
|
|
555
|
+
workspace: string;
|
|
556
|
+
prNumber: number;
|
|
557
|
+
verdict: ReviewRoundOutcome;
|
|
558
|
+
sessionId: string;
|
|
559
|
+
}) => {
|
|
560
|
+
kind: 'delivered';
|
|
561
|
+
count: number;
|
|
562
|
+
};
|
|
563
|
+
abortGithubPrTurn?: (workspace: string, prNumber: number, reason: string) => Promise<{
|
|
564
|
+
kind: 'aborted';
|
|
565
|
+
matchedSessions: number;
|
|
566
|
+
matchedReviewers: number;
|
|
567
|
+
abortFailures: number;
|
|
568
|
+
} | {
|
|
569
|
+
kind: 'no-live-session';
|
|
570
|
+
}>;
|
|
571
|
+
completeGithubReviewRound?: (args: {
|
|
572
|
+
workspace: string;
|
|
573
|
+
prNumber: number;
|
|
574
|
+
verdict: ReviewRoundOutcome;
|
|
575
|
+
sessionId: string;
|
|
576
|
+
commitSha?: string;
|
|
577
|
+
}) => Promise<{
|
|
578
|
+
kind: 'completed' | 'no-round';
|
|
579
|
+
}>;
|
|
580
|
+
finishGithubReviewThreadCloseout?: (args: {
|
|
581
|
+
sessionId: string;
|
|
582
|
+
workspace: string;
|
|
583
|
+
prNumber: number;
|
|
584
|
+
thread: string | null;
|
|
585
|
+
decision: 'resolved' | 'left-open';
|
|
586
|
+
}) => void;
|
|
587
|
+
noteGithubReviewOutput: (args: {
|
|
588
|
+
sessionId: string;
|
|
589
|
+
workspace: string;
|
|
590
|
+
prNumber: number;
|
|
591
|
+
state: ReviewOutputState;
|
|
592
|
+
inboundCoverage?: InboundRef[];
|
|
593
|
+
backgroundCoverage?: BackgroundObligationRef[];
|
|
594
|
+
}) => Promise<{
|
|
595
|
+
kind: 'stamped' | 'no-live-session';
|
|
596
|
+
}>;
|
|
597
|
+
hasOutstandingGithubReviewThreadCloseout?: (sessionId: string) => boolean;
|
|
598
|
+
markTurnSkipped: (args: {
|
|
599
|
+
parentSessionId: string;
|
|
600
|
+
reason: string;
|
|
601
|
+
}) => Promise<{
|
|
602
|
+
kind: 'recorded';
|
|
603
|
+
keyId: string;
|
|
604
|
+
} | {
|
|
605
|
+
kind: 'recorded-after-send';
|
|
606
|
+
keyId: string;
|
|
607
|
+
} | {
|
|
608
|
+
kind: 'no-live-session';
|
|
609
|
+
}>;
|
|
610
|
+
clearSticky: (key: ChannelKey) => {
|
|
611
|
+
keyId: string;
|
|
612
|
+
cleared: number;
|
|
613
|
+
};
|
|
614
|
+
reserveRestartHandoff: (handoff: RestartHandoff) => RestartReservation | null;
|
|
615
|
+
resumeRestartHandoff: (handoff: RestartHandoff) => Promise<void>;
|
|
616
|
+
stop: () => Promise<void>;
|
|
617
|
+
tearDownAllLive: () => Promise<void>;
|
|
618
|
+
markRestartAbortForAllLive: () => Promise<void>;
|
|
619
|
+
liveCount: () => number;
|
|
620
|
+
__testing?: {
|
|
621
|
+
getRecoveryAccountingSnapshot: (key: ChannelKey) => Record<string, unknown> | undefined;
|
|
622
|
+
flushDebounce: (key: ChannelKey) => Promise<void>;
|
|
623
|
+
fireTypingHeartbeat: (key: ChannelKey, phase?: 'tick' | 'stop') => Promise<void>;
|
|
624
|
+
fireTypingInterval: (key: ChannelKey) => Promise<void>;
|
|
625
|
+
fireTypingTick: (key: ChannelKey, epoch: number) => Promise<void>;
|
|
626
|
+
typingEpoch: (key: ChannelKey) => number | undefined;
|
|
627
|
+
isTypingActive: (key: ChannelKey) => boolean;
|
|
628
|
+
stopTyping: (key: ChannelKey) => Promise<void>;
|
|
629
|
+
typingHeartbeatIntervalFor: (adapter: ChannelKey['adapter']) => number;
|
|
630
|
+
githubReviewRoundFor: (key: ChannelKey) => GithubReviewFollowupRound | null | undefined;
|
|
631
|
+
pendingReminderCount: (key: ChannelKey) => number | undefined;
|
|
632
|
+
creationTokenCount: () => number;
|
|
633
|
+
runIdleGc: () => Promise<void>;
|
|
634
|
+
getLiveAuthorState: (key: ChannelKey) => {
|
|
635
|
+
currentTurnAuthorId: string | null;
|
|
636
|
+
currentTurnAuthorIds: readonly string[];
|
|
637
|
+
lastTurnAuthorId: string | null;
|
|
638
|
+
lastTurnAuthorIds: readonly string[];
|
|
639
|
+
} | undefined;
|
|
640
|
+
injectContinuationReminder: (key: ChannelKey, text: string) => void;
|
|
641
|
+
getLiveOriginSnapshot: (key: ChannelKey) => SessionOrigin | undefined;
|
|
642
|
+
};
|
|
643
|
+
};
|
|
644
|
+
export type AliasesProvider = () => readonly string[];
|
|
645
|
+
export type CreateChannelRouterOptions = {
|
|
646
|
+
agentDir: string;
|
|
647
|
+
bootEpoch?: string;
|
|
648
|
+
backgroundObligations?: BackgroundObligationStore;
|
|
649
|
+
inboundJournal?: InboundJournal;
|
|
650
|
+
recoveryOutbox?: RecoveryOutbox;
|
|
651
|
+
configForAdapter: ConfigForAdapter;
|
|
652
|
+
configuredAliases?: AliasesProvider;
|
|
653
|
+
createSessionForChannel?: CreateSessionForChannel;
|
|
654
|
+
sessionDir?: string;
|
|
655
|
+
logger?: RouterLogger;
|
|
656
|
+
now?: () => number;
|
|
657
|
+
retryRandom?: () => number;
|
|
658
|
+
onRetryBackoffStart?: () => void;
|
|
659
|
+
measureTranscriptBytes?: (path: string) => number;
|
|
660
|
+
runIdleContinuation?: typeof runIdleContinuation;
|
|
661
|
+
recordTurnOutcome?: typeof recordTurnOutcome;
|
|
662
|
+
ensureLiveTimeoutMs?: number;
|
|
663
|
+
handoffRetryRetentionMs?: number;
|
|
664
|
+
handoffRetryItemLimit?: number;
|
|
665
|
+
handoffRetryByteLimit?: number;
|
|
666
|
+
resolveChannelNamesTimeoutMs?: number;
|
|
667
|
+
fetchHistoryTimeoutMs?: number;
|
|
668
|
+
sessionIdleTimeoutMs?: number;
|
|
669
|
+
permissions?: PermissionService;
|
|
670
|
+
claimHandler?: ClaimHandler;
|
|
671
|
+
stream?: Stream;
|
|
672
|
+
onReload?: () => Promise<string>;
|
|
673
|
+
onRestart?: (ctx?: RestartCommandContext) => Promise<string>;
|
|
674
|
+
saveChannelSessions?: (agentDir: string, sessions: readonly ChannelSessionRecord[]) => Promise<void>;
|
|
675
|
+
newestRunningChildSubagentStartedAt?: (sessionId: string) => number | null;
|
|
676
|
+
cancelRunningSubagentsByWorkKey?: (workKey: string, reason: string) => Promise<{
|
|
677
|
+
matched: number;
|
|
678
|
+
cancelled: number;
|
|
679
|
+
failures: number;
|
|
680
|
+
}>;
|
|
681
|
+
reviewOutbound?: ChannelOutboundReviewer;
|
|
682
|
+
outboundReviewerActive?: () => boolean;
|
|
683
|
+
};
|
|
684
|
+
export type RestartCommandContext = {
|
|
685
|
+
originatingSessionId: string;
|
|
686
|
+
originatingSessionFile?: string;
|
|
687
|
+
handoffOrigin: {
|
|
688
|
+
kind: 'channel';
|
|
689
|
+
key: ChannelKey;
|
|
690
|
+
};
|
|
691
|
+
triggeringAuthorId?: string;
|
|
692
|
+
};
|
|
693
|
+
export type ClaimHandlerInput = {
|
|
694
|
+
adapter: ChannelKey['adapter'];
|
|
695
|
+
workspace: string;
|
|
696
|
+
chat: string;
|
|
697
|
+
isDm: boolean;
|
|
698
|
+
authorId: string;
|
|
699
|
+
text: string;
|
|
700
|
+
};
|
|
701
|
+
export type ClaimHandlerOutcome = {
|
|
702
|
+
kind: 'consumed';
|
|
703
|
+
reply: string;
|
|
704
|
+
} | {
|
|
705
|
+
kind: 'fail';
|
|
706
|
+
reply: string;
|
|
707
|
+
} | {
|
|
708
|
+
kind: 'fallthrough';
|
|
709
|
+
};
|
|
710
|
+
export type RestartReservation = {
|
|
711
|
+
keyId: string;
|
|
712
|
+
sawInbound: boolean;
|
|
713
|
+
resume: () => Promise<void>;
|
|
714
|
+
release: () => void;
|
|
715
|
+
};
|
|
716
|
+
export type ClaimHandler = (input: ClaimHandlerInput) => Promise<ClaimHandlerOutcome>;
|
|
717
|
+
export declare function createChannelRouter(options: CreateChannelRouterOptions): ChannelRouter;
|
|
718
|
+
export declare function composeTurnPrompt(observed: readonly ObservedInbound[], batch: readonly QueuedInbound[], state?: {
|
|
719
|
+
adapter?: AdapterId;
|
|
720
|
+
loopGuardActive: boolean;
|
|
721
|
+
groupChatNudge?: boolean;
|
|
722
|
+
systemReminders?: readonly string[];
|
|
723
|
+
now?: Date;
|
|
724
|
+
role?: string;
|
|
725
|
+
}): string;
|
|
726
|
+
export type { QuoteAnchorSource } from "./types.js";
|
|
727
|
+
export declare function formatAuthorAttribution(adapter: AdapterId, authorId: string, authorName: string): string;
|
|
728
|
+
export declare function renderQuoteAnchor(source: QuoteAnchorSource): string;
|
|
729
|
+
export declare function prependQuoteAnchor(replyText: string, source: QuoteAnchorSource): string;
|
|
730
|
+
type QuoteAnchorBatchEntry = {
|
|
731
|
+
text: string;
|
|
732
|
+
authorId: string;
|
|
733
|
+
authorName: string;
|
|
734
|
+
authorIsBot: boolean;
|
|
735
|
+
receivedAt: number;
|
|
736
|
+
externalMessageId: string;
|
|
737
|
+
};
|
|
738
|
+
type QuoteAnchorObservedEntry = {
|
|
739
|
+
receivedAt: number;
|
|
740
|
+
source: 'prefetch' | 'observed';
|
|
741
|
+
};
|
|
742
|
+
export type QuoteAnchorCandidate = {
|
|
743
|
+
source: QuoteAnchorSource;
|
|
744
|
+
externalMessageId: string;
|
|
745
|
+
primaryReceivedAt: number;
|
|
746
|
+
hadInterveningObserved: boolean;
|
|
747
|
+
};
|
|
748
|
+
export type QuoteAnchorTarget = {
|
|
749
|
+
source: QuoteAnchorSource;
|
|
750
|
+
externalMessageId: string;
|
|
751
|
+
};
|
|
752
|
+
export declare function stripChannelMediaPlaceholders(text: string): string;
|
|
753
|
+
export declare function captureQuoteCandidate(adapter: AdapterId, batch: readonly QuoteAnchorBatchEntry[], observed: readonly QuoteAnchorObservedEntry[]): QuoteAnchorCandidate | null;
|
|
754
|
+
export declare function decideQuoteAnchor(candidate: QuoteAnchorCandidate | null, _nowMs: number, adapterConfig: ChannelAdapterConfig | undefined): QuoteAnchorTarget | null;
|
|
755
|
+
export type ReplyRenderMode = 'native' | 'quote';
|
|
756
|
+
export declare function resolveReplyRenderMode(msg: OutboundMessage): ReplyRenderMode;
|
|
757
|
+
type Sliced = {
|
|
758
|
+
kind: 'message';
|
|
759
|
+
message: ChannelHistoryMessage;
|
|
760
|
+
} | {
|
|
761
|
+
kind: 'elision';
|
|
762
|
+
elidedCount: number;
|
|
763
|
+
};
|
|
764
|
+
export declare function sliceHeadTail(messages: readonly ChannelHistoryMessage[], head: number, tail: number): Sliced[];
|
|
765
|
+
export type ResolveLiveSessionResult = {
|
|
766
|
+
kind: 'found';
|
|
767
|
+
session: LiveSession;
|
|
768
|
+
} | {
|
|
769
|
+
kind: 'none';
|
|
770
|
+
} | {
|
|
771
|
+
kind: 'ambiguous';
|
|
772
|
+
count: number;
|
|
773
|
+
};
|
|
774
|
+
export declare function resolveLiveSessionForCommand(liveSessions: ReadonlyMap<string, LiveSession>, key: ChannelKey): ResolveLiveSessionResult;
|
|
775
|
+
export declare function stripThinkBlocks(text: string): string;
|
|
776
|
+
export declare function isNoReplySignal(text: string): boolean;
|
|
777
|
+
export declare function endsWithNoReplySignal(text: string): boolean;
|
|
778
|
+
export declare function isUpstreamEmptyResponseSentinel(text: string): boolean;
|
|
779
|
+
export declare function containsKimiToolDelimiter(text: string): boolean;
|
|
780
|
+
export declare function isLikelyKimiChannelToolLeak(text: string): boolean;
|
|
781
|
+
export type PlainTextChannelToolCallKind = 'reply' | 'send' | 'suppress-silent' | 'suppress-warn';
|
|
782
|
+
export declare function getPlainTextChannelToolCallKind(text: string): PlainTextChannelToolCallKind | null;
|
|
783
|
+
export declare function isLikelyPlainTextChannelToolCall(text: string): boolean;
|
|
784
|
+
export declare function isWholeMessageToolCall(text: string): string | null;
|
|
785
|
+
export type JsonToolCallLeak = {
|
|
786
|
+
toolName: string;
|
|
787
|
+
params: Record<string, unknown>;
|
|
788
|
+
};
|
|
789
|
+
export declare function parseWholeMessageJsonToolCall(text: string): JsonToolCallLeak | null;
|
|
790
|
+
export type TrailingToolCallLeak = {
|
|
791
|
+
text: string;
|
|
792
|
+
toolName: string;
|
|
793
|
+
leakedCall: string;
|
|
794
|
+
};
|
|
795
|
+
export declare function stripTrailingLeakedToolCall(text: string): TrailingToolCallLeak | null;
|
|
796
|
+
export declare function extractPlainTextChannelToolCallText(text: string): string | null;
|
|
797
|
+
export type { ChannelSessionRecord };
|
|
798
|
+
export { channelsSessionsPath };
|