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
|
@@ -0,0 +1,459 @@
|
|
|
1
|
+
import { randomUUID } from 'node:crypto'
|
|
2
|
+
import { link, mkdir, open, readFile, readdir, rename, unlink } from 'node:fs/promises'
|
|
3
|
+
import { basename, dirname, join, resolve } from 'node:path'
|
|
4
|
+
|
|
5
|
+
import { z } from 'zod'
|
|
6
|
+
|
|
7
|
+
import { parseRecoveryRecord, recoveryPayload, recoveryPayloadDigest } from './continuity-types'
|
|
8
|
+
import type { RecoveryFailure, RecoveryLease, RecoveryReceipt, RecoveryRecord } from './continuity-types'
|
|
9
|
+
|
|
10
|
+
const operations = new Map<string, Promise<void>>()
|
|
11
|
+
const idPattern = /^[a-f0-9]{64}$/
|
|
12
|
+
export type RecoveryOutboxOptions = {
|
|
13
|
+
epoch?: string
|
|
14
|
+
now?: () => number
|
|
15
|
+
onError?: (error: unknown) => void
|
|
16
|
+
/** Fault-injection boundary; production callers leave this unset. */
|
|
17
|
+
onDurability?: (
|
|
18
|
+
phase: 'temp-synced' | 'replaced' | 'directory-synced' | 'retirement-synced' | 'retired',
|
|
19
|
+
record: RecoveryRecord,
|
|
20
|
+
) => void | Promise<void>
|
|
21
|
+
}
|
|
22
|
+
/**
|
|
23
|
+
* Immutable fence left when a terminal record leaves the active outbox. It keeps only the frozen
|
|
24
|
+
* payload digest and terminal dispatch state, so a later import of the same frozen transfer
|
|
25
|
+
* resolves to the finished delivery instead of creating a new send, without retaining the payload.
|
|
26
|
+
*/
|
|
27
|
+
export type RecoveryRetirement = {
|
|
28
|
+
schemaVersion: 1
|
|
29
|
+
deliveryId: string
|
|
30
|
+
payloadDigest: string
|
|
31
|
+
retiredAt: number
|
|
32
|
+
dispatch: Pick<
|
|
33
|
+
RecoveryRecord,
|
|
34
|
+
'generation' | 'attempts' | 'lease' | 'receipt' | 'failure' | 'suppression' | 'boundAccountIdentity'
|
|
35
|
+
> & { state: 'delivered' | 'suppressed' }
|
|
36
|
+
}
|
|
37
|
+
const retirementSchema = z
|
|
38
|
+
.object({
|
|
39
|
+
schemaVersion: z.literal(1),
|
|
40
|
+
deliveryId: z.string().regex(idPattern),
|
|
41
|
+
payloadDigest: z.string().regex(idPattern),
|
|
42
|
+
retiredAt: z.number().finite().nonnegative(),
|
|
43
|
+
// Nested dispatch fields are validated in full when a fence is joined back to its payload.
|
|
44
|
+
dispatch: z
|
|
45
|
+
.object({
|
|
46
|
+
state: z.enum(['delivered', 'suppressed']),
|
|
47
|
+
generation: z.number().int().positive().max(Number.MAX_SAFE_INTEGER),
|
|
48
|
+
attempts: z.number().int().nonnegative().max(Number.MAX_SAFE_INTEGER),
|
|
49
|
+
lease: z.unknown().optional(),
|
|
50
|
+
receipt: z.unknown().optional(),
|
|
51
|
+
failure: z.unknown().optional(),
|
|
52
|
+
suppression: z.unknown().optional(),
|
|
53
|
+
boundAccountIdentity: z.string().min(1).optional(),
|
|
54
|
+
})
|
|
55
|
+
.strict(),
|
|
56
|
+
})
|
|
57
|
+
.strict()
|
|
58
|
+
|
|
59
|
+
async function syncDirectory(path: string): Promise<void> {
|
|
60
|
+
// POSIX process-death durability. Windows lacks directory-sync power-loss guarantees.
|
|
61
|
+
if (process.platform === 'win32') return
|
|
62
|
+
const handle = await open(path, 'r')
|
|
63
|
+
try {
|
|
64
|
+
await handle.sync()
|
|
65
|
+
} finally {
|
|
66
|
+
await handle.close()
|
|
67
|
+
}
|
|
68
|
+
}
|
|
69
|
+
|
|
70
|
+
export class RecoveryOutbox {
|
|
71
|
+
readonly epoch: string
|
|
72
|
+
private readonly directory: string
|
|
73
|
+
private readonly retiredDirectory: string
|
|
74
|
+
private readonly now: () => number
|
|
75
|
+
private readonly options: RecoveryOutboxOptions
|
|
76
|
+
private readonly pending = new Set<Promise<unknown>>()
|
|
77
|
+
private readonly importListeners = new Set<(record: RecoveryRecord) => void>()
|
|
78
|
+
|
|
79
|
+
constructor(agentDir: string, options: RecoveryOutboxOptions = {}) {
|
|
80
|
+
this.directory = resolve(agentDir, 'channels', 'recovery-outbox')
|
|
81
|
+
this.retiredDirectory = join(this.directory, 'retired')
|
|
82
|
+
this.epoch = options.epoch ?? randomUUID()
|
|
83
|
+
this.now = options.now ?? Date.now
|
|
84
|
+
this.options = options
|
|
85
|
+
}
|
|
86
|
+
|
|
87
|
+
private path(id: string): string {
|
|
88
|
+
if (!idPattern.test(id)) throw new Error('Invalid recovery delivery ID')
|
|
89
|
+
return join(this.directory, `${id}.json`)
|
|
90
|
+
}
|
|
91
|
+
|
|
92
|
+
private async read(id: string): Promise<RecoveryRecord | undefined> {
|
|
93
|
+
let bytes: string
|
|
94
|
+
try {
|
|
95
|
+
bytes = await readFile(this.path(id), 'utf8')
|
|
96
|
+
} catch (error) {
|
|
97
|
+
if ((error as NodeJS.ErrnoException).code === 'ENOENT') return undefined
|
|
98
|
+
throw error
|
|
99
|
+
}
|
|
100
|
+
const record = parseRecoveryRecord(JSON.parse(bytes))
|
|
101
|
+
if (record.deliveryId !== id) throw new Error(`Recovery filename identity mismatch: ${id}`)
|
|
102
|
+
return record
|
|
103
|
+
}
|
|
104
|
+
|
|
105
|
+
private async readRetirement(id: string): Promise<RecoveryRetirement | undefined> {
|
|
106
|
+
let bytes: string
|
|
107
|
+
try {
|
|
108
|
+
bytes = await readFile(join(this.retiredDirectory, basename(this.path(id))), 'utf8')
|
|
109
|
+
} catch (error) {
|
|
110
|
+
if ((error as NodeJS.ErrnoException).code === 'ENOENT') return undefined
|
|
111
|
+
throw error
|
|
112
|
+
}
|
|
113
|
+
const fence = retirementSchema.parse(JSON.parse(bytes)) as RecoveryRetirement
|
|
114
|
+
if (fence.deliveryId !== id) throw new Error(`Recovery retirement identity mismatch: ${id}`)
|
|
115
|
+
return fence
|
|
116
|
+
}
|
|
117
|
+
|
|
118
|
+
private async publish(record: RecoveryRecord, exclusive = false): Promise<boolean> {
|
|
119
|
+
parseRecoveryRecord(record)
|
|
120
|
+
await mkdir(this.directory, { recursive: true })
|
|
121
|
+
// Persist newly created directory entries all the way through channels to agentDir.
|
|
122
|
+
await syncDirectory(dirname(dirname(this.directory)))
|
|
123
|
+
await syncDirectory(dirname(this.directory))
|
|
124
|
+
const path = this.path(record.deliveryId)
|
|
125
|
+
const temp = `${path}.${randomUUID()}.tmp`
|
|
126
|
+
try {
|
|
127
|
+
const handle = await open(temp, 'wx', 0o600)
|
|
128
|
+
try {
|
|
129
|
+
await handle.writeFile(`${JSON.stringify(record)}\n`, 'utf8')
|
|
130
|
+
await handle.sync()
|
|
131
|
+
} finally {
|
|
132
|
+
await handle.close()
|
|
133
|
+
}
|
|
134
|
+
await this.options.onDurability?.('temp-synced', record)
|
|
135
|
+
if (exclusive) {
|
|
136
|
+
try {
|
|
137
|
+
await link(temp, path)
|
|
138
|
+
} catch (error) {
|
|
139
|
+
if ((error as NodeJS.ErrnoException).code === 'EEXIST') return false
|
|
140
|
+
throw error
|
|
141
|
+
}
|
|
142
|
+
} else await rename(temp, path)
|
|
143
|
+
await this.options.onDurability?.('replaced', record)
|
|
144
|
+
await syncDirectory(this.directory)
|
|
145
|
+
await this.options.onDurability?.('directory-synced', record)
|
|
146
|
+
return true
|
|
147
|
+
} finally {
|
|
148
|
+
await unlink(temp).catch((error: NodeJS.ErrnoException) => {
|
|
149
|
+
if (error.code !== 'ENOENT') throw error
|
|
150
|
+
})
|
|
151
|
+
}
|
|
152
|
+
}
|
|
153
|
+
|
|
154
|
+
private serialized<T>(id: string, action: () => Promise<T>): Promise<T> {
|
|
155
|
+
const path = this.path(id)
|
|
156
|
+
const result = (operations.get(path) ?? Promise.resolve()).then(action)
|
|
157
|
+
const settled = result.then(
|
|
158
|
+
() => {},
|
|
159
|
+
() => {},
|
|
160
|
+
)
|
|
161
|
+
operations.set(path, settled)
|
|
162
|
+
this.pending.add(result)
|
|
163
|
+
void settled.then(() => {
|
|
164
|
+
this.pending.delete(result)
|
|
165
|
+
if (operations.get(path) === settled) operations.delete(path)
|
|
166
|
+
})
|
|
167
|
+
return result
|
|
168
|
+
}
|
|
169
|
+
|
|
170
|
+
import(input: RecoveryRecord): Promise<RecoveryRecord> {
|
|
171
|
+
const record = parseRecoveryRecord(input)
|
|
172
|
+
return this.serialized(record.deliveryId, async () => {
|
|
173
|
+
const existing = await this.read(record.deliveryId)
|
|
174
|
+
if (existing) {
|
|
175
|
+
if (recoveryPayload(existing) !== recoveryPayload(record))
|
|
176
|
+
throw new Error(`Conflicting recovery import: ${record.deliveryId}`)
|
|
177
|
+
// An import acknowledges durability even after a previous directory-sync failure.
|
|
178
|
+
await syncDirectory(this.directory)
|
|
179
|
+
return existing
|
|
180
|
+
}
|
|
181
|
+
const retired = await this.readRetirement(record.deliveryId)
|
|
182
|
+
if (retired) {
|
|
183
|
+
// A finished delivery stays finished: re-importing its frozen transfer never queues another send.
|
|
184
|
+
if (retired.payloadDigest !== recoveryPayloadDigest(record))
|
|
185
|
+
throw new Error(`Conflicting recovery import: ${record.deliveryId}`)
|
|
186
|
+
const {
|
|
187
|
+
state: _state,
|
|
188
|
+
generation: _generation,
|
|
189
|
+
attempts: _attempts,
|
|
190
|
+
lease: _lease,
|
|
191
|
+
receipt: _receipt,
|
|
192
|
+
failure: _failure,
|
|
193
|
+
suppression: _suppression,
|
|
194
|
+
nextAttemptAt: _next,
|
|
195
|
+
boundAccountIdentity: _bound,
|
|
196
|
+
...payload
|
|
197
|
+
} = record
|
|
198
|
+
return parseRecoveryRecord({ ...payload, ...retired.dispatch })
|
|
199
|
+
}
|
|
200
|
+
if (
|
|
201
|
+
record.state !== 'pending' ||
|
|
202
|
+
record.generation !== 1 ||
|
|
203
|
+
record.attempts !== 0 ||
|
|
204
|
+
record.failure ||
|
|
205
|
+
record.nextAttemptAt !== undefined ||
|
|
206
|
+
record.boundAccountIdentity !== undefined
|
|
207
|
+
)
|
|
208
|
+
throw new Error('Recovery import must be an initial pending transfer')
|
|
209
|
+
if (!(await this.publish(record, true))) {
|
|
210
|
+
const winner = await this.read(record.deliveryId)
|
|
211
|
+
if (!winner || recoveryPayload(winner) !== recoveryPayload(record))
|
|
212
|
+
throw new Error(`Conflicting recovery import: ${record.deliveryId}`)
|
|
213
|
+
await syncDirectory(this.directory)
|
|
214
|
+
return winner
|
|
215
|
+
}
|
|
216
|
+
for (const listener of this.importListeners) listener(record)
|
|
217
|
+
return record
|
|
218
|
+
})
|
|
219
|
+
}
|
|
220
|
+
|
|
221
|
+
/** Called after each new record becomes durable; listeners must not throw. */
|
|
222
|
+
subscribe(listener: (record: RecoveryRecord) => void): () => void {
|
|
223
|
+
this.importListeners.add(listener)
|
|
224
|
+
return () => this.importListeners.delete(listener)
|
|
225
|
+
}
|
|
226
|
+
|
|
227
|
+
/**
|
|
228
|
+
* Moves a terminal record out of the active outbox once its source has acknowledged it and
|
|
229
|
+
* validates as resolved. The fence is durable before the active file is removed, so every crash
|
|
230
|
+
* point leaves the record, the fence, or both (the next retirement converges them).
|
|
231
|
+
*/
|
|
232
|
+
retire(id: string, expectedGeneration: number): Promise<boolean> {
|
|
233
|
+
return this.serialized(id, async () => {
|
|
234
|
+
const record = await this.read(id)
|
|
235
|
+
if (!record) return (await this.readRetirement(id)) !== undefined
|
|
236
|
+
if (record.generation !== expectedGeneration || (record.state !== 'delivered' && record.state !== 'suppressed'))
|
|
237
|
+
return false
|
|
238
|
+
const payloadDigest = recoveryPayloadDigest(record)
|
|
239
|
+
const prior = await this.readRetirement(id)
|
|
240
|
+
if (prior && prior.payloadDigest !== payloadDigest) throw new Error(`Conflicting recovery retirement: ${id}`)
|
|
241
|
+
if (!prior) {
|
|
242
|
+
const fence: RecoveryRetirement = {
|
|
243
|
+
schemaVersion: 1,
|
|
244
|
+
deliveryId: id,
|
|
245
|
+
payloadDigest,
|
|
246
|
+
retiredAt: this.now(),
|
|
247
|
+
dispatch: {
|
|
248
|
+
state: record.state === 'delivered' ? 'delivered' : 'suppressed',
|
|
249
|
+
generation: record.generation,
|
|
250
|
+
attempts: record.attempts,
|
|
251
|
+
...(record.lease ? { lease: record.lease } : {}),
|
|
252
|
+
...(record.receipt ? { receipt: record.receipt } : {}),
|
|
253
|
+
...(record.failure ? { failure: record.failure } : {}),
|
|
254
|
+
...(record.suppression ? { suppression: record.suppression } : {}),
|
|
255
|
+
...(record.boundAccountIdentity !== undefined ? { boundAccountIdentity: record.boundAccountIdentity } : {}),
|
|
256
|
+
},
|
|
257
|
+
}
|
|
258
|
+
await mkdir(this.retiredDirectory, { recursive: true })
|
|
259
|
+
await syncDirectory(this.directory)
|
|
260
|
+
const path = join(this.retiredDirectory, `${id}.json`)
|
|
261
|
+
const temp = `${path}.${randomUUID()}.tmp`
|
|
262
|
+
try {
|
|
263
|
+
const handle = await open(temp, 'wx', 0o600)
|
|
264
|
+
try {
|
|
265
|
+
await handle.writeFile(`${JSON.stringify(fence)}\n`, 'utf8')
|
|
266
|
+
await handle.sync()
|
|
267
|
+
} finally {
|
|
268
|
+
await handle.close()
|
|
269
|
+
}
|
|
270
|
+
await rename(temp, path)
|
|
271
|
+
await syncDirectory(this.retiredDirectory)
|
|
272
|
+
} finally {
|
|
273
|
+
await unlink(temp).catch((error: NodeJS.ErrnoException) => {
|
|
274
|
+
if (error.code !== 'ENOENT') throw error
|
|
275
|
+
})
|
|
276
|
+
}
|
|
277
|
+
}
|
|
278
|
+
await this.options.onDurability?.('retirement-synced', record)
|
|
279
|
+
await unlink(this.path(id))
|
|
280
|
+
await syncDirectory(this.directory)
|
|
281
|
+
await this.options.onDurability?.('retired', record)
|
|
282
|
+
return true
|
|
283
|
+
})
|
|
284
|
+
}
|
|
285
|
+
|
|
286
|
+
retired(id: string): Promise<RecoveryRetirement | undefined> {
|
|
287
|
+
return this.serialized(id, () => this.readRetirement(id))
|
|
288
|
+
}
|
|
289
|
+
|
|
290
|
+
async listRetired(): Promise<RecoveryRetirement[]> {
|
|
291
|
+
let names: string[]
|
|
292
|
+
try {
|
|
293
|
+
names = await readdir(this.retiredDirectory)
|
|
294
|
+
} catch (error) {
|
|
295
|
+
if ((error as NodeJS.ErrnoException).code === 'ENOENT') return []
|
|
296
|
+
throw error
|
|
297
|
+
}
|
|
298
|
+
const fences: RecoveryRetirement[] = []
|
|
299
|
+
for (const name of names.sort()) {
|
|
300
|
+
if (!/^[a-f0-9]{64}\.json$/.test(name)) continue
|
|
301
|
+
try {
|
|
302
|
+
const fence = await this.retired(name.slice(0, -5))
|
|
303
|
+
if (fence) fences.push(fence)
|
|
304
|
+
} catch (error) {
|
|
305
|
+
if (this.options.onError) this.options.onError(error)
|
|
306
|
+
else console.error('Recovery retirement fence unavailable:', name, error)
|
|
307
|
+
}
|
|
308
|
+
}
|
|
309
|
+
return fences
|
|
310
|
+
}
|
|
311
|
+
|
|
312
|
+
get(id: string): Promise<RecoveryRecord | undefined> {
|
|
313
|
+
return this.serialized(id, () => this.read(id))
|
|
314
|
+
}
|
|
315
|
+
|
|
316
|
+
async list(): Promise<RecoveryRecord[]> {
|
|
317
|
+
let names: string[]
|
|
318
|
+
try {
|
|
319
|
+
names = await readdir(this.directory)
|
|
320
|
+
} catch (error) {
|
|
321
|
+
if ((error as NodeJS.ErrnoException).code === 'ENOENT') return []
|
|
322
|
+
throw error
|
|
323
|
+
}
|
|
324
|
+
const records: RecoveryRecord[] = []
|
|
325
|
+
for (const name of names.sort()) {
|
|
326
|
+
if (!/^[a-f0-9]{64}\.json$/.test(name)) continue
|
|
327
|
+
try {
|
|
328
|
+
const record = await this.get(name.slice(0, -5))
|
|
329
|
+
if (record) records.push(record)
|
|
330
|
+
} catch (error) {
|
|
331
|
+
if (this.options.onError) this.options.onError(error)
|
|
332
|
+
else console.error('Recovery outbox record unavailable:', name, error)
|
|
333
|
+
}
|
|
334
|
+
}
|
|
335
|
+
return records
|
|
336
|
+
}
|
|
337
|
+
|
|
338
|
+
lease(id: string, expectedGeneration: number): Promise<RecoveryLease | undefined> {
|
|
339
|
+
return this.serialized(id, async () => {
|
|
340
|
+
const record = await this.read(id)
|
|
341
|
+
if (
|
|
342
|
+
!record ||
|
|
343
|
+
record.generation !== expectedGeneration ||
|
|
344
|
+
record.state === 'delivered' ||
|
|
345
|
+
record.state === 'suppressed'
|
|
346
|
+
)
|
|
347
|
+
return undefined
|
|
348
|
+
if (record.state === 'leased' && record.lease?.epoch === this.epoch) return undefined
|
|
349
|
+
if (record.nextAttemptAt !== undefined && record.nextAttemptAt > this.now()) return undefined
|
|
350
|
+
const lease = {
|
|
351
|
+
epoch: this.epoch,
|
|
352
|
+
generation: record.generation + 1,
|
|
353
|
+
attemptId: randomUUID(),
|
|
354
|
+
acquiredAt: this.now(),
|
|
355
|
+
}
|
|
356
|
+
const { failure: _failure, nextAttemptAt: _next, ...rest } = record
|
|
357
|
+
await this.publish({
|
|
358
|
+
...rest,
|
|
359
|
+
state: 'leased',
|
|
360
|
+
generation: lease.generation,
|
|
361
|
+
lease,
|
|
362
|
+
attempts: record.attempts + 1,
|
|
363
|
+
})
|
|
364
|
+
return lease
|
|
365
|
+
})
|
|
366
|
+
}
|
|
367
|
+
|
|
368
|
+
repairLease(id: string, lease: RecoveryLease): Promise<boolean> {
|
|
369
|
+
return this.serialized(id, async () => {
|
|
370
|
+
const record = await this.read(id)
|
|
371
|
+
if (!record || record.state !== 'leased' || !this.owns(record, lease)) return false
|
|
372
|
+
// Visible bytes may follow a failed directory sync; republish before reuse.
|
|
373
|
+
await this.publish(record)
|
|
374
|
+
return true
|
|
375
|
+
})
|
|
376
|
+
}
|
|
377
|
+
|
|
378
|
+
delivered(id: string, lease: RecoveryLease, receipt: RecoveryReceipt): Promise<boolean> {
|
|
379
|
+
return this.serialized(id, async () => {
|
|
380
|
+
const record = await this.read(id)
|
|
381
|
+
if (!record || !this.owns(record, lease)) return false
|
|
382
|
+
if (record.receipt)
|
|
383
|
+
return (
|
|
384
|
+
record.receipt.confirmedAt === receipt.confirmedAt &&
|
|
385
|
+
record.receipt.messageId === receipt.messageId &&
|
|
386
|
+
JSON.stringify(record.receipt.messageIds) === JSON.stringify(receipt.messageIds)
|
|
387
|
+
)
|
|
388
|
+
if (record.state !== 'leased' && record.state !== 'suppressed') return false
|
|
389
|
+
await this.publish({ ...record, state: record.state === 'suppressed' ? 'suppressed' : 'delivered', receipt })
|
|
390
|
+
return true
|
|
391
|
+
})
|
|
392
|
+
}
|
|
393
|
+
|
|
394
|
+
bindAccount(id: string, lease: RecoveryLease, identity: string): Promise<boolean> {
|
|
395
|
+
return this.serialized(id, async () => {
|
|
396
|
+
const record = await this.read(id)
|
|
397
|
+
if (!record || record.state !== 'leased' || !this.owns(record, lease)) return false
|
|
398
|
+
if (record.accountIdentity !== 'unbound-legacy') return record.accountIdentity === identity
|
|
399
|
+
if (record.boundAccountIdentity !== undefined) return record.boundAccountIdentity === identity
|
|
400
|
+
await this.publish({ ...record, boundAccountIdentity: identity })
|
|
401
|
+
return true
|
|
402
|
+
})
|
|
403
|
+
}
|
|
404
|
+
|
|
405
|
+
fail(id: string, lease: RecoveryLease, failure: RecoveryFailure): Promise<boolean> {
|
|
406
|
+
return this.serialized(id, async () => {
|
|
407
|
+
const record = await this.read(id)
|
|
408
|
+
if (!record || record.state !== 'leased' || !this.owns(record, lease)) return false
|
|
409
|
+
const blocked =
|
|
410
|
+
failure.kind === 'permission' ||
|
|
411
|
+
failure.kind === 'identity' ||
|
|
412
|
+
failure.kind === 'target' ||
|
|
413
|
+
failure.kind === 'configuration'
|
|
414
|
+
const { lease: _lease, ...rest } = record
|
|
415
|
+
const delay = Math.max(
|
|
416
|
+
failure.retryAfter ?? 0,
|
|
417
|
+
Math.min(60_000, 1000 * 2 ** Math.min(record.attempts - 1, 6)) * (0.8 + Math.random() * 0.4),
|
|
418
|
+
)
|
|
419
|
+
await this.publish({
|
|
420
|
+
...rest,
|
|
421
|
+
state: blocked ? 'blocked' : 'pending',
|
|
422
|
+
failure,
|
|
423
|
+
...(!blocked ? { nextAttemptAt: this.now() + delay } : {}),
|
|
424
|
+
})
|
|
425
|
+
return true
|
|
426
|
+
})
|
|
427
|
+
}
|
|
428
|
+
|
|
429
|
+
suppress(id: string, reason: string, decisionId: string): Promise<boolean> {
|
|
430
|
+
return this.serialized(id, async () => {
|
|
431
|
+
const record = await this.read(id)
|
|
432
|
+
if (!record || record.state === 'delivered') return false
|
|
433
|
+
if (record.state === 'suppressed')
|
|
434
|
+
return record.suppression?.reason === reason && record.suppression.decisionId === decisionId
|
|
435
|
+
const { nextAttemptAt: _next, ...rest } = record
|
|
436
|
+
await this.publish({
|
|
437
|
+
...rest,
|
|
438
|
+
generation: record.generation + 1,
|
|
439
|
+
state: 'suppressed',
|
|
440
|
+
suppression: { reason, decisionId },
|
|
441
|
+
})
|
|
442
|
+
return true
|
|
443
|
+
})
|
|
444
|
+
}
|
|
445
|
+
|
|
446
|
+
private owns(record: RecoveryRecord, lease: RecoveryLease): boolean {
|
|
447
|
+
return (
|
|
448
|
+
lease.epoch === this.epoch &&
|
|
449
|
+
record.lease?.epoch === lease.epoch &&
|
|
450
|
+
record.lease.generation === lease.generation &&
|
|
451
|
+
record.lease.attemptId === lease.attemptId &&
|
|
452
|
+
record.lease.acquiredAt === lease.acquiredAt
|
|
453
|
+
)
|
|
454
|
+
}
|
|
455
|
+
|
|
456
|
+
async flush(): Promise<void> {
|
|
457
|
+
await Promise.all(this.pending)
|
|
458
|
+
}
|
|
459
|
+
}
|