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/index.ts
CHANGED
|
@@ -20,7 +20,12 @@ export {
|
|
|
20
20
|
type PrVerdictActivityBridge,
|
|
21
21
|
type PrVerdictActivityBridgeOptions,
|
|
22
22
|
} from './pr-verdict-activity-bridge'
|
|
23
|
-
export {
|
|
23
|
+
export {
|
|
24
|
+
setReviewObserver,
|
|
25
|
+
setReviewOutputObserver,
|
|
26
|
+
setReviewCoverageCapture,
|
|
27
|
+
type ReviewOutputState,
|
|
28
|
+
} from './github-review-turn-ledger'
|
|
24
29
|
export {
|
|
25
30
|
createSubagentCompletionBridge,
|
|
26
31
|
type SubagentCompletionBridge,
|
|
@@ -0,0 +1,34 @@
|
|
|
1
|
+
import { randomUUID } from 'node:crypto'
|
|
2
|
+
import { mkdir, readFile, rename, writeFile } from 'node:fs/promises'
|
|
3
|
+
import { join } from 'node:path'
|
|
4
|
+
|
|
5
|
+
import { z } from 'zod'
|
|
6
|
+
|
|
7
|
+
import type { AdapterId } from './schema'
|
|
8
|
+
|
|
9
|
+
const markerSchema = z.object({ at: z.number().finite() })
|
|
10
|
+
|
|
11
|
+
export async function readLastAlive(agentDir: string, adapter: AdapterId): Promise<number | null> {
|
|
12
|
+
const dir = join(agentDir, 'channels')
|
|
13
|
+
const paths = [join(dir, `${adapter}-catch-up-last-alive.json`)]
|
|
14
|
+
if (adapter === 'github') paths.push(join(dir, 'github-last-alive.json'))
|
|
15
|
+
for (const path of paths) {
|
|
16
|
+
try {
|
|
17
|
+
const marker = markerSchema.safeParse(JSON.parse(await readFile(path, 'utf8')))
|
|
18
|
+
if (marker.success) return marker.data.at
|
|
19
|
+
} catch (error) {
|
|
20
|
+
if (!(error instanceof SyntaxError) && !(error instanceof Error && 'code' in error && error.code === 'ENOENT'))
|
|
21
|
+
throw error
|
|
22
|
+
}
|
|
23
|
+
}
|
|
24
|
+
return null
|
|
25
|
+
}
|
|
26
|
+
|
|
27
|
+
export async function writeLastAlive(agentDir: string, adapter: AdapterId, at: number): Promise<void> {
|
|
28
|
+
const dir = join(agentDir, 'channels')
|
|
29
|
+
await mkdir(dir, { recursive: true })
|
|
30
|
+
const path = join(dir, `${adapter}-catch-up-last-alive.json`)
|
|
31
|
+
const tmp = `${path}.${randomUUID()}.tmp`
|
|
32
|
+
await writeFile(tmp, JSON.stringify({ at }))
|
|
33
|
+
await rename(tmp, path)
|
|
34
|
+
}
|
package/src/channels/manager.ts
CHANGED
|
@@ -21,18 +21,22 @@ import { createInstagramAdapter, type InstagramAdapter } from './adapters/instag
|
|
|
21
21
|
import { createKakaotalkAdapter, type KakaotalkAdapter } from './adapters/kakaotalk'
|
|
22
22
|
import { createLineAdapter, type LineAdapter } from './adapters/line'
|
|
23
23
|
import { createSlackAdapter, type SlackAdapter } from './adapters/slack'
|
|
24
|
-
import { createSlackBotAdapter, type SlackBotAdapter } from './adapters/slack-bot'
|
|
24
|
+
import { createSlackBotAdapter, type SlackBotAdapter, type SlackMessageObserver } from './adapters/slack-bot'
|
|
25
25
|
import { createTeamsAdapter, type TeamsAdapter } from './adapters/teams'
|
|
26
26
|
import { createTelegramBotAdapter, type TelegramBotAdapter } from './adapters/telegram-bot'
|
|
27
27
|
import { createWebexAdapter, type WebexAdapter } from './adapters/webex'
|
|
28
28
|
import { createWebexBotAdapter, type WebexBotAdapter } from './adapters/webex-bot'
|
|
29
|
+
import type { BackgroundObligationStore } from './background-obligations'
|
|
29
30
|
import { describeError } from './describe-error'
|
|
30
31
|
import type { GithubTokenBridge } from './github-token-bridge'
|
|
32
|
+
import type { InboundJournal } from './inbound-journal'
|
|
33
|
+
import type { RecoveryOutbox } from './recovery-outbox'
|
|
31
34
|
import {
|
|
32
35
|
createChannelRouter,
|
|
33
36
|
type ChannelRouter,
|
|
34
37
|
type ClaimHandler,
|
|
35
38
|
type CreateSessionForChannel,
|
|
39
|
+
type ChannelOutboundReviewer,
|
|
36
40
|
type RestartCommandContext,
|
|
37
41
|
} from './router'
|
|
38
42
|
import {
|
|
@@ -58,6 +62,7 @@ const consoleLogger: ChannelManagerLogger = {
|
|
|
58
62
|
export type ChannelManagerOptions = {
|
|
59
63
|
agentDir: string
|
|
60
64
|
channelsConfigRef: () => ChannelsConfig
|
|
65
|
+
onRecoveryReady?: () => void
|
|
61
66
|
// Plain-text names the agent answers to in channel engagement (the
|
|
62
67
|
// `alias` field in `typeclaw.json`), forwarded to the router as
|
|
63
68
|
// `configuredAliases`. Read live on every inbound so an `applied`-class
|
|
@@ -84,6 +89,9 @@ export type ChannelManagerOptions = {
|
|
|
84
89
|
// cannot reply, which is fine for tests but a bug in production. See
|
|
85
90
|
// src/run/index.ts where this is wired.
|
|
86
91
|
createSessionForChannel?: CreateSessionForChannel
|
|
92
|
+
slackBotMessageObserver?: SlackMessageObserver
|
|
93
|
+
outboundReviewer?: ChannelOutboundReviewer
|
|
94
|
+
outboundReviewerActive?: () => boolean
|
|
87
95
|
// Test seams: let fake adapters replace the real adapter wiring per id.
|
|
88
96
|
createDiscordAdapter?: typeof createDiscordBotAdapter
|
|
89
97
|
createDiscordUserAdapter?: typeof createDiscordAdapter
|
|
@@ -97,6 +105,9 @@ export type ChannelManagerOptions = {
|
|
|
97
105
|
createTelegramAdapter?: typeof createTelegramBotAdapter
|
|
98
106
|
createWebexAdapter?: typeof createWebexAdapter
|
|
99
107
|
createWebexBotAdapter?: typeof createWebexBotAdapter
|
|
108
|
+
backgroundObligations?: BackgroundObligationStore
|
|
109
|
+
inboundJournal?: InboundJournal
|
|
110
|
+
recoveryOutbox?: RecoveryOutbox
|
|
100
111
|
// Wake-up gate: forwarded to the router, which calls
|
|
101
112
|
// `permissions.has(origin, 'channel.respond')` BEFORE creating a
|
|
102
113
|
// session for any inbound. Optional here to keep direct manager-level
|
|
@@ -135,10 +146,6 @@ export type ChannelManagerOptions = {
|
|
|
135
146
|
// otherwise spawn a duplicate child). Production wiring (src/run/index.ts)
|
|
136
147
|
// supplies it from the LiveSubagentRegistry; tests omit it.
|
|
137
148
|
newestRunningChildSubagentStartedAt?: (sessionId: string) => number | null
|
|
138
|
-
// Forwarded to the router so the graceful-restart handoff can name the
|
|
139
|
-
// background subagents a session was still awaiting. Same wiring shape as
|
|
140
|
-
// newestRunningChildSubagentStartedAt; tests omit it.
|
|
141
|
-
listRunningBackgroundSubagentNames?: (sessionId: string) => string[]
|
|
142
149
|
// Forwarded to the router so an adapter-triggered work invalidation can stop
|
|
143
150
|
// independent background sessions that a parent AgentSession abort cannot reach.
|
|
144
151
|
cancelRunningSubagentsByWorkKey?: (
|
|
@@ -249,6 +256,9 @@ export function createChannelManager(options: ChannelManagerOptions): ChannelMan
|
|
|
249
256
|
const env = options.env ?? process.env
|
|
250
257
|
const router = createChannelRouter({
|
|
251
258
|
agentDir: options.agentDir,
|
|
259
|
+
...(options.backgroundObligations ? { backgroundObligations: options.backgroundObligations } : {}),
|
|
260
|
+
...(options.inboundJournal ? { inboundJournal: options.inboundJournal } : {}),
|
|
261
|
+
...(options.recoveryOutbox ? { recoveryOutbox: options.recoveryOutbox } : {}),
|
|
252
262
|
configForAdapter: (adapter) => options.channelsConfigRef()[adapter],
|
|
253
263
|
logger,
|
|
254
264
|
...(options.aliasesRef ? { configuredAliases: options.aliasesRef } : {}),
|
|
@@ -261,12 +271,11 @@ export function createChannelManager(options: ChannelManagerOptions): ChannelMan
|
|
|
261
271
|
...(options.newestRunningChildSubagentStartedAt
|
|
262
272
|
? { newestRunningChildSubagentStartedAt: options.newestRunningChildSubagentStartedAt }
|
|
263
273
|
: {}),
|
|
264
|
-
...(options.listRunningBackgroundSubagentNames
|
|
265
|
-
? { listRunningBackgroundSubagentNames: options.listRunningBackgroundSubagentNames }
|
|
266
|
-
: {}),
|
|
267
274
|
...(options.cancelRunningSubagentsByWorkKey
|
|
268
275
|
? { cancelRunningSubagentsByWorkKey: options.cancelRunningSubagentsByWorkKey }
|
|
269
276
|
: {}),
|
|
277
|
+
...(options.outboundReviewer ? { reviewOutbound: options.outboundReviewer } : {}),
|
|
278
|
+
...(options.outboundReviewerActive ? { outboundReviewerActive: options.outboundReviewerActive } : {}),
|
|
270
279
|
})
|
|
271
280
|
const createDiscordBot = options.createDiscordAdapter ?? createDiscordBotAdapter
|
|
272
281
|
const createDiscordUser = options.createDiscordUserAdapter ?? createDiscordAdapter
|
|
@@ -351,6 +360,7 @@ export function createChannelManager(options: ChannelManagerOptions): ChannelMan
|
|
|
351
360
|
appToken,
|
|
352
361
|
logger,
|
|
353
362
|
selfAliasesRef: () => router.getSelfAliases(),
|
|
363
|
+
...(options.slackBotMessageObserver ? { messageObserver: options.slackBotMessageObserver } : {}),
|
|
354
364
|
})
|
|
355
365
|
}
|
|
356
366
|
if (name === 'line') {
|
|
@@ -528,6 +538,7 @@ export function createChannelManager(options: ChannelManagerOptions): ChannelMan
|
|
|
528
538
|
recoveryRestartAttempts: 0,
|
|
529
539
|
recoveryRestartQueued: false,
|
|
530
540
|
})
|
|
541
|
+
options.onRecoveryReady?.()
|
|
531
542
|
return { status: 'started' }
|
|
532
543
|
} catch (err) {
|
|
533
544
|
await cleanupPartialStart(adapter)
|
|
@@ -735,6 +746,11 @@ export function createChannelManager(options: ChannelManagerOptions): ChannelMan
|
|
|
735
746
|
const now = recoveryNow()
|
|
736
747
|
for (const [name, entry] of live) {
|
|
737
748
|
if (entry.adapter.isConnected()) {
|
|
749
|
+
void router
|
|
750
|
+
.recoverWaitingReactions(name)
|
|
751
|
+
.catch((err) =>
|
|
752
|
+
logger.warn(`[channels] waiting reaction cleanup failed adapter="${name}": ${describeError(err)}`),
|
|
753
|
+
)
|
|
738
754
|
entry.disconnectedSinceMs = null
|
|
739
755
|
entry.nextRecoveryRestartAtMs = null
|
|
740
756
|
entry.recoveryRestartAttempts = 0
|
|
@@ -1028,6 +1044,7 @@ export function createChannelManager(options: ChannelManagerOptions): ChannelMan
|
|
|
1028
1044
|
}
|
|
1029
1045
|
}
|
|
1030
1046
|
|
|
1047
|
+
options.onRecoveryReady?.()
|
|
1031
1048
|
return { started, stopped, restarted, restartRequired, ...(credentialApply ? { credentialApply } : {}) }
|
|
1032
1049
|
},
|
|
1033
1050
|
}
|
|
@@ -0,0 +1,264 @@
|
|
|
1
|
+
import type { BackgroundObligationStore } from './background-obligations'
|
|
2
|
+
import type { RecoveryRecord } from './continuity-types'
|
|
3
|
+
import type { InboundJournal } from './inbound-journal'
|
|
4
|
+
import type { RecoveryOutbox } from './recovery-outbox'
|
|
5
|
+
import type { ChannelRouter } from './router'
|
|
6
|
+
import { channelKeyId, type ChannelKey, type RecoveryRedelivery } from './types'
|
|
7
|
+
|
|
8
|
+
// Bounds how long a restart notice waits for an adapter still deciding whether it re-admitted the
|
|
9
|
+
// interrupted work (GitHub's boot reconcile pass), so a stuck pass delays the notice, never loses it.
|
|
10
|
+
const REDELIVERY_WAIT_MS = 5 * 60_000
|
|
11
|
+
|
|
12
|
+
/** Transport-only recovery; each destination progresses independently. */
|
|
13
|
+
export class RecoveryDispatcher {
|
|
14
|
+
private readonly lanes = new Map<string, Promise<void>>()
|
|
15
|
+
private timer: NodeJS.Timeout | undefined
|
|
16
|
+
private stopped = false
|
|
17
|
+
/** Set by the first (boot) wake; imports never dispatch before adapters are ready. */
|
|
18
|
+
private woken = false
|
|
19
|
+
private readonly unsubscribe: () => void
|
|
20
|
+
/** Destinations whose due work was skipped while an earlier pass still held their lane. */
|
|
21
|
+
private readonly deferred = new Set<string>()
|
|
22
|
+
|
|
23
|
+
constructor(
|
|
24
|
+
private readonly outbox: RecoveryOutbox,
|
|
25
|
+
private readonly router: ChannelRouter,
|
|
26
|
+
private readonly options: {
|
|
27
|
+
now?: () => number
|
|
28
|
+
consistencyDelayMs?: number
|
|
29
|
+
onError?: (error: unknown) => void
|
|
30
|
+
backgroundObligations?: BackgroundObligationStore
|
|
31
|
+
inboundJournal?: InboundJournal
|
|
32
|
+
} = {},
|
|
33
|
+
) {
|
|
34
|
+
router.setRecoveryStopHandler((target, parent) => this.suppressParent(target, parent))
|
|
35
|
+
// A transfer made durable after boot (a live turn that ended unanswered) dispatches now
|
|
36
|
+
// instead of at the next poll; multiple imports in one tick coalesce into one wake.
|
|
37
|
+
this.unsubscribe = outbox.subscribe(() => {
|
|
38
|
+
if (!this.woken || this.stopped) return
|
|
39
|
+
clearTimeout(this.timer)
|
|
40
|
+
this.timer = undefined
|
|
41
|
+
this.schedule(0)
|
|
42
|
+
})
|
|
43
|
+
}
|
|
44
|
+
|
|
45
|
+
private async validateCoverageInLane(record: RecoveryRecord): Promise<'open' | 'resolved'> {
|
|
46
|
+
if (record.covers.some((cover) => cover.store === 'inbound')) {
|
|
47
|
+
if (!this.options.inboundJournal) throw new Error('Inbound recovery requires journal authority')
|
|
48
|
+
return this.options.inboundJournal.validateNotice(record)
|
|
49
|
+
}
|
|
50
|
+
if (record.covers.some((cover) => cover.store === 'background')) {
|
|
51
|
+
this.options.inboundJournal?.assertAvailable()
|
|
52
|
+
if (!this.options.backgroundObligations) throw new Error('Background recovery requires source authority')
|
|
53
|
+
this.options.backgroundObligations.assertAvailable()
|
|
54
|
+
}
|
|
55
|
+
return this.options.backgroundObligations?.validateNotice(record) ?? 'open'
|
|
56
|
+
}
|
|
57
|
+
|
|
58
|
+
private async acknowledge(record: RecoveryRecord): Promise<void> {
|
|
59
|
+
if (record.covers.some((cover) => cover.store === 'inbound')) {
|
|
60
|
+
const journal = this.options.inboundJournal
|
|
61
|
+
if (!journal) throw new Error('Inbound recovery requires journal authority')
|
|
62
|
+
if (this.options.backgroundObligations)
|
|
63
|
+
await this.options.backgroundObligations.withTargetLane(record.target, () => journal.acknowledgeNotice(record))
|
|
64
|
+
else await journal.acknowledgeNotice(record)
|
|
65
|
+
return
|
|
66
|
+
}
|
|
67
|
+
const source = this.options.backgroundObligations
|
|
68
|
+
if (!source) return
|
|
69
|
+
if (record.covers.some((cover) => cover.store === 'background')) {
|
|
70
|
+
await source.withTargetLane(record.target, () => source.acknowledgeNotice(record))
|
|
71
|
+
} else {
|
|
72
|
+
// Legacy upgrade receipts have immutable inventory-only provenance.
|
|
73
|
+
await source.acknowledgeNotice(record)
|
|
74
|
+
}
|
|
75
|
+
}
|
|
76
|
+
|
|
77
|
+
/**
|
|
78
|
+
* Source acknowledgment, then retirement of the terminal outbox record. Retirement requires the
|
|
79
|
+
* source to validate the delivery as resolved in its lane, so no open or re-importable coverage
|
|
80
|
+
* can still point at it; the outbox keeps an immutable fence for any later identical import.
|
|
81
|
+
*/
|
|
82
|
+
private async finish(record: RecoveryRecord, retire: boolean): Promise<void> {
|
|
83
|
+
await this.acknowledge(record)
|
|
84
|
+
if (!retire) return
|
|
85
|
+
const source = this.options.backgroundObligations
|
|
86
|
+
const coverage =
|
|
87
|
+
source && record.covers.some((cover) => cover.store !== 'inventory')
|
|
88
|
+
? await source.withTargetLane(record.target, () => this.validateCoverageInLane(record))
|
|
89
|
+
: await this.validateCoverageInLane(record)
|
|
90
|
+
if (coverage === 'resolved') await this.outbox.retire(record.deliveryId, record.generation)
|
|
91
|
+
}
|
|
92
|
+
|
|
93
|
+
async wake(): Promise<void> {
|
|
94
|
+
if (this.stopped) return
|
|
95
|
+
this.woken = true
|
|
96
|
+
clearTimeout(this.timer)
|
|
97
|
+
this.timer = undefined
|
|
98
|
+
const now = this.options.now?.() ?? Date.now()
|
|
99
|
+
let next = now + 30_000
|
|
100
|
+
const started = new Set<string>()
|
|
101
|
+
for (const record of await this.outbox.list()) {
|
|
102
|
+
const key = channelKeyId(record.target)
|
|
103
|
+
if (record.state === 'delivered' || record.state === 'suppressed') {
|
|
104
|
+
// A lane from an earlier pass may still hold this record's in-flight send (a /stop raced
|
|
105
|
+
// it), so it is retired on a later pass. A lane started by this pass skips terminal records.
|
|
106
|
+
await this.finish(record, !this.lanes.has(key) || started.has(key)).catch((error) =>
|
|
107
|
+
this.options.onError?.(error),
|
|
108
|
+
)
|
|
109
|
+
continue
|
|
110
|
+
}
|
|
111
|
+
const due = record.nextAttemptAt ?? 0
|
|
112
|
+
if (due > now) {
|
|
113
|
+
next = Math.min(next, due)
|
|
114
|
+
continue
|
|
115
|
+
}
|
|
116
|
+
if (this.lanes.has(key)) {
|
|
117
|
+
// That lane listed the outbox before this record was due or existed; run again after it.
|
|
118
|
+
if (!started.has(key)) this.deferred.add(key)
|
|
119
|
+
continue
|
|
120
|
+
}
|
|
121
|
+
started.add(key)
|
|
122
|
+
const lane = this.dispatchTarget(key)
|
|
123
|
+
.catch((error) => this.options.onError?.(error))
|
|
124
|
+
.finally(() => {
|
|
125
|
+
this.lanes.delete(key)
|
|
126
|
+
if (this.deferred.delete(key)) {
|
|
127
|
+
clearTimeout(this.timer)
|
|
128
|
+
this.timer = undefined
|
|
129
|
+
this.schedule(0)
|
|
130
|
+
} else this.schedule(30_000)
|
|
131
|
+
})
|
|
132
|
+
this.lanes.set(key, lane)
|
|
133
|
+
}
|
|
134
|
+
this.schedule(Math.max(10, next - now))
|
|
135
|
+
}
|
|
136
|
+
|
|
137
|
+
private schedule(delay: number): void {
|
|
138
|
+
if (this.stopped || this.timer) return
|
|
139
|
+
this.timer = setTimeout(() => {
|
|
140
|
+
this.timer = undefined
|
|
141
|
+
void this.wake().catch((error) => this.options.onError?.(error))
|
|
142
|
+
}, delay)
|
|
143
|
+
this.timer.unref?.()
|
|
144
|
+
}
|
|
145
|
+
private async acquire(record: RecoveryRecord) {
|
|
146
|
+
const claim = async () => {
|
|
147
|
+
if ((await this.validateCoverageInLane(record)) === 'resolved') return undefined
|
|
148
|
+
if (record.lease?.epoch === this.outbox.epoch) {
|
|
149
|
+
return (await this.outbox.repairLease(record.deliveryId, record.lease)) ? record.lease : undefined
|
|
150
|
+
}
|
|
151
|
+
return this.outbox.lease(record.deliveryId, record.generation)
|
|
152
|
+
}
|
|
153
|
+
try {
|
|
154
|
+
const source = this.options.backgroundObligations
|
|
155
|
+
return source && record.covers.some((cover) => cover.store !== 'inventory')
|
|
156
|
+
? await source.withTargetLane(record.target, claim)
|
|
157
|
+
: await claim()
|
|
158
|
+
} catch (error) {
|
|
159
|
+
this.options.onError?.(error)
|
|
160
|
+
return undefined
|
|
161
|
+
}
|
|
162
|
+
}
|
|
163
|
+
|
|
164
|
+
private async dispatchTarget(key: string): Promise<void> {
|
|
165
|
+
// One pass per wake avoids a blocked destination starving another record.
|
|
166
|
+
for (const snapshot of await this.outbox.list()) {
|
|
167
|
+
if (channelKeyId(snapshot.target) !== key || this.stopped) continue
|
|
168
|
+
const record = await this.outbox.get(snapshot.deliveryId)
|
|
169
|
+
const now = this.options.now?.() ?? Date.now()
|
|
170
|
+
if (!record || record.state === 'delivered' || record.state === 'suppressed' || (record.nextAttemptAt ?? 0) > now)
|
|
171
|
+
continue
|
|
172
|
+
try {
|
|
173
|
+
const source = this.options.backgroundObligations
|
|
174
|
+
const coverage =
|
|
175
|
+
source && record.covers.some((cover) => cover.store !== 'inventory')
|
|
176
|
+
? await source.withTargetLane(record.target, () => this.validateCoverageInLane(record!))
|
|
177
|
+
: await this.validateCoverageInLane(record)
|
|
178
|
+
if (coverage === 'resolved') {
|
|
179
|
+
await this.outbox.suppress(record.deliveryId, 'coverage-resolved', crypto.randomUUID())
|
|
180
|
+
continue
|
|
181
|
+
}
|
|
182
|
+
const redelivery = this.redelivery(record, now)
|
|
183
|
+
if (redelivery === 'pending') continue
|
|
184
|
+
if (redelivery === 'redelivered' && this.options.inboundJournal) {
|
|
185
|
+
await this.suppressRedelivered(record, this.options.inboundJournal)
|
|
186
|
+
continue
|
|
187
|
+
}
|
|
188
|
+
// Runtime state (restarts, ended turns) is never posted to channel users; the operator log
|
|
189
|
+
// carries it instead. Closing the coverage keeps boot recovery from re-importing it.
|
|
190
|
+
await this.suppressRecord(record, 'operator-log-only', crypto.randomUUID())
|
|
191
|
+
console.log(
|
|
192
|
+
`[channels] interrupted request in ${key} not re-answered (${record.cause ?? 'restart'}); no notice posted to the channel`,
|
|
193
|
+
)
|
|
194
|
+
} catch (error) {
|
|
195
|
+
this.options.onError?.(error)
|
|
196
|
+
continue
|
|
197
|
+
}
|
|
198
|
+
}
|
|
199
|
+
}
|
|
200
|
+
|
|
201
|
+
/** Only a never-attempted restart notice over inbound rows can be superseded by adapter redelivery. */
|
|
202
|
+
private redelivery(record: RecoveryRecord, now: number): RecoveryRedelivery {
|
|
203
|
+
const journal = this.options.inboundJournal
|
|
204
|
+
if (!journal || record.cause !== undefined || record.attempts > 0 || !this.router.recoveryRedelivery)
|
|
205
|
+
return 'not-redelivered'
|
|
206
|
+
const eventKinds = journal.noticeEventKinds(record)
|
|
207
|
+
if (!eventKinds) return 'not-redelivered'
|
|
208
|
+
const answer = this.router.recoveryRedelivery(record, eventKinds)
|
|
209
|
+
return answer === 'pending' && now - record.createdAt >= REDELIVERY_WAIT_MS ? 'not-redelivered' : answer
|
|
210
|
+
}
|
|
211
|
+
|
|
212
|
+
private async suppressRedelivered(record: RecoveryRecord, journal: InboundJournal): Promise<void> {
|
|
213
|
+
const decisionId = crypto.randomUUID()
|
|
214
|
+
const suppress = () => journal.suppressNoticeCoverage(record, { decisionId, reason: 'adapter-redelivered' })
|
|
215
|
+
const source = this.options.backgroundObligations
|
|
216
|
+
if (source) await source.withTargetLane(record.target, suppress)
|
|
217
|
+
else await suppress()
|
|
218
|
+
await this.outbox.suppress(record.deliveryId, 'adapter-redelivered', decisionId)
|
|
219
|
+
}
|
|
220
|
+
|
|
221
|
+
async suppressParent(target: ChannelKey, parentSessionId: string): Promise<void> {
|
|
222
|
+
const parentDecisionId = crypto.randomUUID()
|
|
223
|
+
for (const record of await this.outbox.list()) {
|
|
224
|
+
if (channelKeyId(record.target) !== channelKeyId(target)) continue
|
|
225
|
+
if (
|
|
226
|
+
record.sourceParentSessionId === parentSessionId ||
|
|
227
|
+
(record.covers.length > 0 && record.covers.every((coverage) => coverage.parentSessionId === parentSessionId))
|
|
228
|
+
) {
|
|
229
|
+
await this.suppressRecord(record, 'user-stop', `${parentDecisionId}:${record.deliveryId}`, 'user_stop')
|
|
230
|
+
}
|
|
231
|
+
}
|
|
232
|
+
}
|
|
233
|
+
|
|
234
|
+
private async suppressRecord(
|
|
235
|
+
record: RecoveryRecord,
|
|
236
|
+
reason: string,
|
|
237
|
+
decisionId: string,
|
|
238
|
+
outboxReason = reason,
|
|
239
|
+
): Promise<void> {
|
|
240
|
+
const source = this.options.backgroundObligations
|
|
241
|
+
const suppress = async () => {
|
|
242
|
+
if (record.covers.some((cover) => cover.store === 'inbound')) {
|
|
243
|
+
if (!this.options.inboundJournal) throw new Error('Inbound recovery requires journal authority')
|
|
244
|
+
await this.options.inboundJournal.suppressNoticeCoverage(record, { decisionId, reason })
|
|
245
|
+
} else if (source) {
|
|
246
|
+
if (record.covers.some((cover) => cover.store === 'background')) this.options.inboundJournal?.assertAvailable()
|
|
247
|
+
await source.suppressNoticeCoverage(record, { decisionId, reason })
|
|
248
|
+
}
|
|
249
|
+
}
|
|
250
|
+
if (source && record.covers.some((cover) => cover.store !== 'inventory'))
|
|
251
|
+
await source.withTargetLane(record.target, suppress)
|
|
252
|
+
else await suppress()
|
|
253
|
+
await this.outbox.suppress(record.deliveryId, outboxReason, decisionId)
|
|
254
|
+
}
|
|
255
|
+
|
|
256
|
+
async stop(): Promise<void> {
|
|
257
|
+
this.stopped = true
|
|
258
|
+
this.unsubscribe()
|
|
259
|
+
clearTimeout(this.timer)
|
|
260
|
+
this.timer = undefined
|
|
261
|
+
await Promise.all(this.lanes.values())
|
|
262
|
+
await this.outbox.flush()
|
|
263
|
+
}
|
|
264
|
+
}
|
|
@@ -0,0 +1,94 @@
|
|
|
1
|
+
import type { MatchableOrigin } from '../permissions/resolve'
|
|
2
|
+
import {
|
|
3
|
+
LIVE_TURN_ENDED_NOTICE_TEXT,
|
|
4
|
+
parseRecoveryRecord,
|
|
5
|
+
RECOVERY_NOTICE_TEXT,
|
|
6
|
+
recoveryDeliveryId,
|
|
7
|
+
} from './continuity-types'
|
|
8
|
+
import type { RecoveryNoticeCause, RecoveryRecord } from './continuity-types'
|
|
9
|
+
import { channelKeyId } from './types'
|
|
10
|
+
import type { ChannelKey } from './types'
|
|
11
|
+
|
|
12
|
+
const canonicalPrincipal = (principal: MatchableOrigin) =>
|
|
13
|
+
Object.entries(principal)
|
|
14
|
+
.filter(([, value]) => value !== undefined)
|
|
15
|
+
.sort(([left], [right]) => left.localeCompare(right))
|
|
16
|
+
|
|
17
|
+
/** Frozen principals compare by content; persisted key order is a serialization detail. */
|
|
18
|
+
export function sameRecoveryPrincipal(left: MatchableOrigin, right: MatchableOrigin): boolean {
|
|
19
|
+
return JSON.stringify(canonicalPrincipal(left)) === JSON.stringify(canonicalPrincipal(right))
|
|
20
|
+
}
|
|
21
|
+
|
|
22
|
+
/**
|
|
23
|
+
* One interruption notice may cover only sources sharing destination, authenticated account,
|
|
24
|
+
* frozen principal and captured effective parent (the `/stop` authority). Chat, text, turn
|
|
25
|
+
* timing, the current mapping and the current adapter account are never grouping evidence.
|
|
26
|
+
*/
|
|
27
|
+
export function recoveryNoticePartitionKey(input: {
|
|
28
|
+
target: ChannelKey
|
|
29
|
+
accountIdentity: string
|
|
30
|
+
principal: MatchableOrigin
|
|
31
|
+
parentSessionId?: string
|
|
32
|
+
}): string {
|
|
33
|
+
return JSON.stringify([
|
|
34
|
+
channelKeyId(input.target),
|
|
35
|
+
input.accountIdentity,
|
|
36
|
+
canonicalPrincipal(input.principal),
|
|
37
|
+
input.parentSessionId ?? null,
|
|
38
|
+
])
|
|
39
|
+
}
|
|
40
|
+
|
|
41
|
+
/**
|
|
42
|
+
* Freezes a transfer at preparation. `restart` (the default) is the RFC en/v1 boot-recovery
|
|
43
|
+
* notice, byte- and ID-identical to every record written before causes existed. Same-process
|
|
44
|
+
* abandonment passes `live-turn-ended`, which never asserts a restart.
|
|
45
|
+
*/
|
|
46
|
+
export function createRecoveryNotice(
|
|
47
|
+
input: Pick<
|
|
48
|
+
RecoveryRecord,
|
|
49
|
+
| 'target'
|
|
50
|
+
| 'accountIdentity'
|
|
51
|
+
| 'accountIdentityConflict'
|
|
52
|
+
| 'principal'
|
|
53
|
+
| 'covers'
|
|
54
|
+
| 'recoveryGeneration'
|
|
55
|
+
| 'transferId'
|
|
56
|
+
> & { createdAt?: number; sourceParentSessionId?: string; cause?: RecoveryNoticeCause },
|
|
57
|
+
): RecoveryRecord {
|
|
58
|
+
const source = {
|
|
59
|
+
target: input.target,
|
|
60
|
+
accountIdentity: input.accountIdentity,
|
|
61
|
+
...(input.accountIdentityConflict !== undefined ? { accountIdentityConflict: input.accountIdentityConflict } : {}),
|
|
62
|
+
principal: input.principal,
|
|
63
|
+
covers: input.covers,
|
|
64
|
+
recoveryGeneration: input.recoveryGeneration,
|
|
65
|
+
transferId: input.transferId,
|
|
66
|
+
...(input.sourceParentSessionId !== undefined ? { sourceParentSessionId: input.sourceParentSessionId } : {}),
|
|
67
|
+
}
|
|
68
|
+
const template =
|
|
69
|
+
input.cause === 'live-turn-ended'
|
|
70
|
+
? {
|
|
71
|
+
schemaVersion: 2 as const,
|
|
72
|
+
purpose: 'interruption-notice' as const,
|
|
73
|
+
cause: 'live-turn-ended' as const,
|
|
74
|
+
templateVersion: 1 as const,
|
|
75
|
+
locale: 'en' as const,
|
|
76
|
+
text: LIVE_TURN_ENDED_NOTICE_TEXT,
|
|
77
|
+
}
|
|
78
|
+
: {
|
|
79
|
+
schemaVersion: 1 as const,
|
|
80
|
+
purpose: 'interruption-notice' as const,
|
|
81
|
+
templateVersion: 1 as const,
|
|
82
|
+
locale: 'en' as const,
|
|
83
|
+
text: RECOVERY_NOTICE_TEXT,
|
|
84
|
+
}
|
|
85
|
+
const record = {
|
|
86
|
+
...source,
|
|
87
|
+
...template,
|
|
88
|
+
createdAt: input.createdAt ?? Date.now(),
|
|
89
|
+
generation: 1,
|
|
90
|
+
state: 'pending' as const,
|
|
91
|
+
attempts: 0,
|
|
92
|
+
}
|
|
93
|
+
return parseRecoveryRecord({ ...record, deliveryId: recoveryDeliveryId(record) })
|
|
94
|
+
}
|