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,137 @@
|
|
|
1
|
+
import { describeError } from './describe-error'
|
|
2
|
+
import { readLastAlive, writeLastAlive } from './last-alive'
|
|
3
|
+
import type { AdapterId } from './schema'
|
|
4
|
+
import type { InboundMessage, RouteReceipt } from './types'
|
|
5
|
+
|
|
6
|
+
export const CHAT_CATCH_UP_MAX_AGE_MS = 15 * 60 * 1000
|
|
7
|
+
export const CATCH_UP_HEARTBEAT_MS = 30 * 1000
|
|
8
|
+
export const CATCH_UP_CONVERSATION_LIMIT = 20
|
|
9
|
+
|
|
10
|
+
export type MissedInbound = {
|
|
11
|
+
readonly message: InboundMessage
|
|
12
|
+
// Latest post in the source conversation, including self/system posts that
|
|
13
|
+
// classification drops. Slack's reply-routing anchor is NOT this scope.
|
|
14
|
+
readonly latestTs: number
|
|
15
|
+
}
|
|
16
|
+
export type ListMissedInbound = (since: number) => Promise<readonly MissedInbound[]>
|
|
17
|
+
|
|
18
|
+
export function createInboundCatchUp(options: {
|
|
19
|
+
agentDir: string
|
|
20
|
+
route: (message: InboundMessage) => Promise<RouteReceipt>
|
|
21
|
+
logger: { info: (message: string) => void; warn: (message: string) => void }
|
|
22
|
+
now?: () => number
|
|
23
|
+
}) {
|
|
24
|
+
const now = options.now ?? Date.now
|
|
25
|
+
// Admission dedup is durable in the router journal. Observation has no
|
|
26
|
+
// journal row, so retain those live receipts for the chat replay window.
|
|
27
|
+
const observed = new Map<string, number>()
|
|
28
|
+
const observationKey = (message: InboundMessage) =>
|
|
29
|
+
JSON.stringify([
|
|
30
|
+
message.adapter,
|
|
31
|
+
message.accountIdentity,
|
|
32
|
+
message.workspace,
|
|
33
|
+
message.chat,
|
|
34
|
+
message.externalMessageId,
|
|
35
|
+
message.authorId,
|
|
36
|
+
message.eventKind,
|
|
37
|
+
message.revision,
|
|
38
|
+
])
|
|
39
|
+
const states = new Map<
|
|
40
|
+
AdapterId,
|
|
41
|
+
{
|
|
42
|
+
callback: ListMissedInbound
|
|
43
|
+
connected: boolean
|
|
44
|
+
generation: number
|
|
45
|
+
healthy: boolean
|
|
46
|
+
since: Promise<number | null>
|
|
47
|
+
lane: Promise<void>
|
|
48
|
+
}
|
|
49
|
+
>()
|
|
50
|
+
|
|
51
|
+
const run = (adapter: AdapterId): Promise<void> => {
|
|
52
|
+
const state = states.get(adapter)
|
|
53
|
+
if (!state) return Promise.resolve()
|
|
54
|
+
state.connected = true
|
|
55
|
+
const generation = state.generation
|
|
56
|
+
const active = () => states.get(adapter) === state && state.connected && state.generation === generation
|
|
57
|
+
const task = state.lane.then(async () => {
|
|
58
|
+
if (!active()) return
|
|
59
|
+
const at = now()
|
|
60
|
+
const since = (await state.since) ?? at
|
|
61
|
+
const items = await state.callback(Math.max(since, at - CHAT_CATCH_UP_MAX_AGE_MS))
|
|
62
|
+
for (const { message, latestTs } of items) {
|
|
63
|
+
if (!active()) return
|
|
64
|
+
if (message.adapter !== adapter) throw new Error('Catch-up adapter identity mismatch')
|
|
65
|
+
const stale = message.ts < now() - CHAT_CATCH_UP_MAX_AGE_MS || message.ts <= 0
|
|
66
|
+
const movedOn = latestTs > message.ts
|
|
67
|
+
if (message.ts < since || stale || movedOn) {
|
|
68
|
+
options.logger.info(
|
|
69
|
+
`[channels] catch-up ${adapter} dropped id=${message.externalMessageId} reason=${movedOn ? 'moved-on' : 'stale'}`,
|
|
70
|
+
)
|
|
71
|
+
continue
|
|
72
|
+
}
|
|
73
|
+
if ((observed.get(observationKey(message)) ?? 0) > now()) continue
|
|
74
|
+
// The live router owns durable admission dedup and engagement. Never
|
|
75
|
+
// mark replay as an explicit mention or manufacture a wake-up.
|
|
76
|
+
await options.route(message)
|
|
77
|
+
}
|
|
78
|
+
if (!active()) return
|
|
79
|
+
await writeLastAlive(options.agentDir, adapter, at)
|
|
80
|
+
state.since = Promise.resolve(at)
|
|
81
|
+
state.healthy = true
|
|
82
|
+
})
|
|
83
|
+
state.healthy = false
|
|
84
|
+
state.lane = task.catch((error: unknown) => {
|
|
85
|
+
options.logger.warn(`[channels] catch-up ${adapter} failed: ${describeError(error)}`)
|
|
86
|
+
})
|
|
87
|
+
return state.lane
|
|
88
|
+
}
|
|
89
|
+
|
|
90
|
+
// This timer only persists liveness; it never lists history or replays chat.
|
|
91
|
+
const heartbeat = setInterval(() => {
|
|
92
|
+
for (const [adapter, state] of states) {
|
|
93
|
+
if (!state.connected || !state.healthy) continue
|
|
94
|
+
state.lane = state.lane
|
|
95
|
+
.then(async () => {
|
|
96
|
+
if (states.get(adapter) !== state || !state.connected || !state.healthy) return
|
|
97
|
+
const at = now()
|
|
98
|
+
await writeLastAlive(options.agentDir, adapter, at)
|
|
99
|
+
state.since = Promise.resolve(at)
|
|
100
|
+
})
|
|
101
|
+
.catch((error: unknown) => {
|
|
102
|
+
options.logger.warn(`[channels] catch-up heartbeat ${adapter} failed: ${describeError(error)}`)
|
|
103
|
+
})
|
|
104
|
+
}
|
|
105
|
+
}, CATCH_UP_HEARTBEAT_MS)
|
|
106
|
+
heartbeat.unref?.()
|
|
107
|
+
|
|
108
|
+
return {
|
|
109
|
+
noteObserved(message: InboundMessage): void {
|
|
110
|
+
const at = now()
|
|
111
|
+
for (const [key, expires] of observed) if (expires <= at) observed.delete(key)
|
|
112
|
+
observed.set(observationKey(message), at + CHAT_CATCH_UP_MAX_AGE_MS)
|
|
113
|
+
},
|
|
114
|
+
register(adapter: AdapterId, callback: ListMissedInbound): void {
|
|
115
|
+
const since = readLastAlive(options.agentDir, adapter)
|
|
116
|
+
// Defer a read failure into the run's operator-only error boundary.
|
|
117
|
+
void since.catch(() => undefined)
|
|
118
|
+
states.set(adapter, { callback, connected: false, generation: 0, healthy: false, since, lane: Promise.resolve() })
|
|
119
|
+
},
|
|
120
|
+
unregister(adapter: AdapterId, callback: ListMissedInbound): void {
|
|
121
|
+
if (states.get(adapter)?.callback === callback) states.delete(adapter)
|
|
122
|
+
},
|
|
123
|
+
disconnect(adapter: AdapterId): void {
|
|
124
|
+
const state = states.get(adapter)
|
|
125
|
+
if (!state) return
|
|
126
|
+
state.connected = false
|
|
127
|
+
state.generation++
|
|
128
|
+
},
|
|
129
|
+
run,
|
|
130
|
+
async stop(): Promise<void> {
|
|
131
|
+
clearInterval(heartbeat)
|
|
132
|
+
const pending = [...states.values()].map((state) => state.lane)
|
|
133
|
+
states.clear()
|
|
134
|
+
await Promise.all(pending)
|
|
135
|
+
},
|
|
136
|
+
}
|
|
137
|
+
}
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
// A channel turn ends after a successful `channel_reply` (the terminal-reply
|
|
2
2
|
// abort in router.ts). When the model's reply PROMISES to keep working this
|
|
3
3
|
// turn ("바로 확인해볼게요", "let me check", "I'll continue now") but it forgot
|
|
4
|
-
// to set `channel_reply({
|
|
4
|
+
// to set `channel_reply({ continue_after_reply: true })`, the turn aborts and the promised
|
|
5
5
|
// follow-up never runs. The router uses this detector to inject ONE bounded
|
|
6
6
|
// reminder nudge so the model gets a second chance. See the empty-turn retry
|
|
7
7
|
// (router.ts) for the sibling mechanism this mirrors.
|
|
@@ -73,7 +73,7 @@ const EN_PHRASES: readonly string[] = [
|
|
|
73
73
|
// Action/config verb family. The retrieval verbs above ("check/look/look up")
|
|
74
74
|
// miss the much larger class of "I'll DO X" promises — update/configure/set up/
|
|
75
75
|
// schedule/fix/apply/create — which is exactly the class that silently truncates
|
|
76
|
-
// when the model forgets `
|
|
76
|
+
// when the model forgets `continue_after_reply: true` (the cron-update production miss).
|
|
77
77
|
"i'll update",
|
|
78
78
|
"i'll set up",
|
|
79
79
|
"i'll set it up",
|
|
@@ -0,0 +1,272 @@
|
|
|
1
|
+
import { createHash } from 'node:crypto'
|
|
2
|
+
|
|
3
|
+
import { z } from 'zod'
|
|
4
|
+
|
|
5
|
+
import type { MatchableOrigin } from '../permissions/resolve'
|
|
6
|
+
import { ADAPTER_IDS } from './schema'
|
|
7
|
+
import type { ChannelKey } from './types'
|
|
8
|
+
|
|
9
|
+
export type RecoveryCoverage = {
|
|
10
|
+
store: 'inventory' | 'background' | 'inbound'
|
|
11
|
+
id: string
|
|
12
|
+
generation: number
|
|
13
|
+
parentSessionId?: string
|
|
14
|
+
}
|
|
15
|
+
export type RecoveryLease = { epoch: string; generation: number; attemptId: string; acquiredAt: number }
|
|
16
|
+
export type RecoveryReceipt = { confirmedAt: number; messageId?: string; messageIds?: string[] }
|
|
17
|
+
export type RecoveryFailure = {
|
|
18
|
+
kind: 'transient' | 'rate-limit' | 'unavailable' | 'permission' | 'identity' | 'target' | 'configuration'
|
|
19
|
+
safeReason: string
|
|
20
|
+
/** Milliseconds until another attempt is permitted. */
|
|
21
|
+
retryAfter?: number
|
|
22
|
+
}
|
|
23
|
+
/**
|
|
24
|
+
* Why owed coverage was transferred to a notice. `restart` is the frozen RFC en/v1 boot-recovery
|
|
25
|
+
* notice (schemaVersion 1, no `cause` field). `live-turn-ended` is a same-process turn that ended
|
|
26
|
+
* without a confirmed reply; it is a distinct schemaVersion 2 record and never claims a restart.
|
|
27
|
+
*/
|
|
28
|
+
export type RecoveryNoticeCause = 'restart' | 'live-turn-ended'
|
|
29
|
+
export type RecoveryRecord = {
|
|
30
|
+
schemaVersion: 1 | 2
|
|
31
|
+
deliveryId: string
|
|
32
|
+
purpose: 'interruption-notice'
|
|
33
|
+
/** Present exactly on schemaVersion 2; absent means the frozen v1 restart notice. */
|
|
34
|
+
cause?: Exclude<RecoveryNoticeCause, 'restart'>
|
|
35
|
+
target: ChannelKey
|
|
36
|
+
accountIdentity: string
|
|
37
|
+
accountIdentityConflict?: string[]
|
|
38
|
+
boundAccountIdentity?: string
|
|
39
|
+
principal: MatchableOrigin
|
|
40
|
+
sourceParentSessionId?: string
|
|
41
|
+
covers: RecoveryCoverage[]
|
|
42
|
+
transferId: string
|
|
43
|
+
recoveryGeneration: string
|
|
44
|
+
templateVersion: 1
|
|
45
|
+
locale: 'en'
|
|
46
|
+
text: string
|
|
47
|
+
createdAt: number
|
|
48
|
+
generation: number
|
|
49
|
+
state: 'pending' | 'leased' | 'delivered' | 'blocked' | 'suppressed'
|
|
50
|
+
lease?: RecoveryLease
|
|
51
|
+
attempts: number
|
|
52
|
+
nextAttemptAt?: number
|
|
53
|
+
receipt?: RecoveryReceipt
|
|
54
|
+
failure?: RecoveryFailure
|
|
55
|
+
suppression?: { reason: string; decisionId: string }
|
|
56
|
+
}
|
|
57
|
+
|
|
58
|
+
export const RECOVERY_NOTICE_TEXT =
|
|
59
|
+
"⚠️ I restarted before I could confirm a reply to your earlier request. I didn't rerun it automatically — please ask again if you still need it."
|
|
60
|
+
export const LIVE_TURN_ENDED_NOTICE_TEXT =
|
|
61
|
+
"⚠️ My earlier turn ended before I could confirm a reply to your request. I didn't rerun it automatically — please ask again if you still need it."
|
|
62
|
+
// Both templates are frozen into persisted outbox payloads (fenced by `recoveryPayload`), so their
|
|
63
|
+
// bytes keep the historical ⚠️ prefix. Users see this rendered form: an interrupted turn is not an
|
|
64
|
+
// alarm, and the emoji is reserved for failures someone has to act on.
|
|
65
|
+
export function recoveryNoticeDisplayText(record: Pick<RecoveryRecord, 'text'>): string {
|
|
66
|
+
return record.text.replace(/^⚠️ /, '')
|
|
67
|
+
}
|
|
68
|
+
const nonempty = z.string().min(1)
|
|
69
|
+
const timestamp = z.number().finite().nonnegative()
|
|
70
|
+
const generation = z.number().int().positive().max(Number.MAX_SAFE_INTEGER)
|
|
71
|
+
const target = z
|
|
72
|
+
.object({ adapter: z.enum(ADAPTER_IDS), workspace: z.string(), chat: nonempty, thread: z.string().nullable() })
|
|
73
|
+
.strict()
|
|
74
|
+
const principal = z.discriminatedUnion('kind', [
|
|
75
|
+
z.object({ kind: z.literal('tui'), sessionId: nonempty.optional() }).strict(),
|
|
76
|
+
z.object({ kind: z.literal('cron'), jobId: nonempty.optional() }).strict(),
|
|
77
|
+
z.object({ kind: z.literal('subagent'), subagent: nonempty.optional() }).strict(),
|
|
78
|
+
z
|
|
79
|
+
.object({
|
|
80
|
+
kind: z.literal('channel'),
|
|
81
|
+
adapter: z.enum(ADAPTER_IDS),
|
|
82
|
+
workspace: z.string(),
|
|
83
|
+
chat: nonempty,
|
|
84
|
+
parentChat: nonempty.optional(),
|
|
85
|
+
lastInboundAuthorId: nonempty.optional(),
|
|
86
|
+
lastInboundAuthorAdapter: z.enum(ADAPTER_IDS).optional(),
|
|
87
|
+
})
|
|
88
|
+
.strict(),
|
|
89
|
+
])
|
|
90
|
+
// Frozen v1 field order: persisted outbox bytes follow it, so never reorder or insert here.
|
|
91
|
+
const recordFields = {
|
|
92
|
+
schemaVersion: z.literal(1),
|
|
93
|
+
deliveryId: z.string().regex(/^[a-f0-9]{64}$/),
|
|
94
|
+
purpose: z.literal('interruption-notice'),
|
|
95
|
+
target,
|
|
96
|
+
accountIdentity: nonempty,
|
|
97
|
+
accountIdentityConflict: z.array(nonempty).min(2).optional(),
|
|
98
|
+
boundAccountIdentity: nonempty.optional(),
|
|
99
|
+
principal,
|
|
100
|
+
sourceParentSessionId: nonempty.optional(),
|
|
101
|
+
covers: z
|
|
102
|
+
.array(
|
|
103
|
+
z
|
|
104
|
+
.object({
|
|
105
|
+
store: z.enum(['inventory', 'background', 'inbound']),
|
|
106
|
+
id: nonempty,
|
|
107
|
+
generation,
|
|
108
|
+
parentSessionId: nonempty.optional(),
|
|
109
|
+
})
|
|
110
|
+
.strict(),
|
|
111
|
+
)
|
|
112
|
+
.min(1),
|
|
113
|
+
transferId: nonempty,
|
|
114
|
+
recoveryGeneration: nonempty,
|
|
115
|
+
templateVersion: z.literal(1),
|
|
116
|
+
locale: z.literal('en'),
|
|
117
|
+
text: z.literal(RECOVERY_NOTICE_TEXT),
|
|
118
|
+
createdAt: timestamp,
|
|
119
|
+
generation,
|
|
120
|
+
state: z.enum(['pending', 'leased', 'delivered', 'blocked', 'suppressed']),
|
|
121
|
+
lease: z.object({ epoch: nonempty, generation, attemptId: nonempty, acquiredAt: timestamp }).strict().optional(),
|
|
122
|
+
attempts: z.number().int().nonnegative().max(Number.MAX_SAFE_INTEGER),
|
|
123
|
+
nextAttemptAt: timestamp.optional(),
|
|
124
|
+
receipt: z
|
|
125
|
+
.object({
|
|
126
|
+
confirmedAt: timestamp,
|
|
127
|
+
messageId: nonempty.optional(),
|
|
128
|
+
messageIds: z.array(nonempty).min(1).optional(),
|
|
129
|
+
})
|
|
130
|
+
.strict()
|
|
131
|
+
.optional(),
|
|
132
|
+
failure: z
|
|
133
|
+
.object({
|
|
134
|
+
kind: z.enum(['transient', 'rate-limit', 'unavailable', 'permission', 'identity', 'target', 'configuration']),
|
|
135
|
+
safeReason: nonempty.max(512),
|
|
136
|
+
retryAfter: timestamp.optional(),
|
|
137
|
+
})
|
|
138
|
+
.strict()
|
|
139
|
+
.optional(),
|
|
140
|
+
suppression: z
|
|
141
|
+
.object({ reason: nonempty.max(512), decisionId: nonempty })
|
|
142
|
+
.strict()
|
|
143
|
+
.optional(),
|
|
144
|
+
}
|
|
145
|
+
const schema = z
|
|
146
|
+
.discriminatedUnion('schemaVersion', [
|
|
147
|
+
// en/v1 restart notice: the RFC's frozen boot-recovery template.
|
|
148
|
+
z.object(recordFields).strict(),
|
|
149
|
+
// v2 names its non-restart cause explicitly and pins that cause's own frozen template.
|
|
150
|
+
z
|
|
151
|
+
.object({
|
|
152
|
+
...recordFields,
|
|
153
|
+
schemaVersion: z.literal(2),
|
|
154
|
+
text: z.literal(LIVE_TURN_ENDED_NOTICE_TEXT),
|
|
155
|
+
cause: z.literal('live-turn-ended'),
|
|
156
|
+
})
|
|
157
|
+
.strict(),
|
|
158
|
+
])
|
|
159
|
+
.superRefine((record, context) => {
|
|
160
|
+
const invalid = (message: string) => context.addIssue({ code: 'custom', message })
|
|
161
|
+
if (new Set(record.covers.map((cover) => `${cover.store}:${cover.id}`)).size !== record.covers.length)
|
|
162
|
+
invalid('Duplicate coverage')
|
|
163
|
+
if (record.deliveryId !== recoveryDeliveryId(record)) invalid('Delivery identity mismatch')
|
|
164
|
+
if (
|
|
165
|
+
record.boundAccountIdentity !== undefined &&
|
|
166
|
+
(record.accountIdentity !== 'unbound-legacy' || record.boundAccountIdentity === 'unbound-legacy')
|
|
167
|
+
)
|
|
168
|
+
invalid('Invalid legacy account binding')
|
|
169
|
+
if (
|
|
170
|
+
record.accountIdentityConflict !== undefined &&
|
|
171
|
+
(record.accountIdentity !== 'unbound-legacy' ||
|
|
172
|
+
record.accountIdentityConflict.some(
|
|
173
|
+
(identity, index, identities) =>
|
|
174
|
+
identity === 'unbound-legacy' || (index > 0 && identities[index - 1]! >= identity),
|
|
175
|
+
))
|
|
176
|
+
)
|
|
177
|
+
invalid('Invalid account identity conflict')
|
|
178
|
+
if (record.state === 'leased' && (!record.lease || record.lease.generation !== record.generation))
|
|
179
|
+
invalid('Invalid lease ownership')
|
|
180
|
+
if (record.lease && (record.lease.generation > record.generation || record.attempts === 0))
|
|
181
|
+
invalid('Invalid lease generation')
|
|
182
|
+
if (record.attempts >= record.generation) invalid('Attempts exceed ownership generation')
|
|
183
|
+
if (record.state === 'delivered' && (!record.lease || record.lease.generation !== record.generation))
|
|
184
|
+
invalid('Invalid delivered ownership')
|
|
185
|
+
if ((record.state === 'leased' || record.state === 'delivered') && record.failure)
|
|
186
|
+
invalid('Failure on active or delivered record')
|
|
187
|
+
if (record.failure && record.attempts === 0) invalid('Failure before dispatch attempt')
|
|
188
|
+
if (
|
|
189
|
+
record.state === 'blocked' &&
|
|
190
|
+
record.failure &&
|
|
191
|
+
!['permission', 'identity', 'target', 'configuration'].includes(record.failure.kind)
|
|
192
|
+
)
|
|
193
|
+
invalid('Transient failure cannot block')
|
|
194
|
+
if (record.receipt && !record.lease) invalid('Receipt without dispatch ownership')
|
|
195
|
+
if (record.state === 'delivered' && !record.receipt) invalid('Missing delivery receipt')
|
|
196
|
+
if (record.receipt && record.state !== 'delivered' && record.state !== 'suppressed')
|
|
197
|
+
invalid('Receipt on unresolved record')
|
|
198
|
+
if (record.state === 'blocked' && !record.failure) invalid('Missing blocked failure')
|
|
199
|
+
if ((record.state === 'pending' || record.state === 'blocked') && record.lease) invalid('Lease on unclaimed record')
|
|
200
|
+
if ((record.state === 'suppressed') !== !!record.suppression) invalid('Invalid suppression state')
|
|
201
|
+
if (record.nextAttemptAt !== undefined && record.state !== 'pending' && record.state !== 'blocked')
|
|
202
|
+
invalid('Retry on terminal or leased record')
|
|
203
|
+
})
|
|
204
|
+
|
|
205
|
+
type DeliveryIdentity = Pick<
|
|
206
|
+
RecoveryRecord,
|
|
207
|
+
'purpose' | 'target' | 'accountIdentity' | 'covers' | 'recoveryGeneration' | 'cause'
|
|
208
|
+
>
|
|
209
|
+
export function recoveryDeliveryId(record: DeliveryIdentity): string {
|
|
210
|
+
const covers = record.covers
|
|
211
|
+
.map((cover) => [cover.store, cover.id, cover.generation, cover.parentSessionId ?? null])
|
|
212
|
+
.sort((a, b) => JSON.stringify(a).localeCompare(JSON.stringify(b)))
|
|
213
|
+
// The v1 restart seed is frozen; a non-restart notice gets its own seed so the two can never share an ID.
|
|
214
|
+
const seed = record.cause === undefined ? ['typeclaw:recovery:v1'] : ['typeclaw:recovery:v2', record.cause]
|
|
215
|
+
return createHash('sha256')
|
|
216
|
+
.update(
|
|
217
|
+
JSON.stringify([
|
|
218
|
+
...seed,
|
|
219
|
+
record.purpose,
|
|
220
|
+
[record.target.adapter, record.target.workspace, record.target.chat, record.target.thread],
|
|
221
|
+
record.accountIdentity,
|
|
222
|
+
covers,
|
|
223
|
+
record.recoveryGeneration,
|
|
224
|
+
]),
|
|
225
|
+
)
|
|
226
|
+
.digest('hex')
|
|
227
|
+
}
|
|
228
|
+
export function recoveryNoticeCause(record: Pick<RecoveryRecord, 'cause'>): RecoveryNoticeCause {
|
|
229
|
+
return record.cause ?? 'restart'
|
|
230
|
+
}
|
|
231
|
+
export function validateRecoveryRecord(value: unknown): value is RecoveryRecord {
|
|
232
|
+
return schema.safeParse(value).success
|
|
233
|
+
}
|
|
234
|
+
export function parseRecoveryRecord(value: unknown): RecoveryRecord {
|
|
235
|
+
return schema.parse(value) as RecoveryRecord
|
|
236
|
+
}
|
|
237
|
+
|
|
238
|
+
/** Stable comparison of the frozen transfer payload, excluding dispatch state. */
|
|
239
|
+
export function recoveryPayload(record: RecoveryRecord): string {
|
|
240
|
+
return JSON.stringify([
|
|
241
|
+
record.deliveryId,
|
|
242
|
+
record.purpose,
|
|
243
|
+
record.target.adapter,
|
|
244
|
+
record.target.workspace,
|
|
245
|
+
record.target.chat,
|
|
246
|
+
record.target.thread,
|
|
247
|
+
record.accountIdentity,
|
|
248
|
+
record.accountIdentityConflict ?? null,
|
|
249
|
+
canonical(record.principal),
|
|
250
|
+
record.sourceParentSessionId ?? null,
|
|
251
|
+
record.covers.map(canonical).sort(),
|
|
252
|
+
record.transferId,
|
|
253
|
+
record.recoveryGeneration,
|
|
254
|
+
record.templateVersion,
|
|
255
|
+
record.locale,
|
|
256
|
+
record.text,
|
|
257
|
+
record.createdAt,
|
|
258
|
+
// v1 strings stay byte-identical; later versions also compare their explicit cause.
|
|
259
|
+
...(record.schemaVersion === 1 ? [] : [record.schemaVersion, record.cause ?? null]),
|
|
260
|
+
])
|
|
261
|
+
}
|
|
262
|
+
/** Fixed-size fence for a frozen transfer payload once the full record is no longer retained. */
|
|
263
|
+
export function recoveryPayloadDigest(record: RecoveryRecord): string {
|
|
264
|
+
return createHash('sha256').update(recoveryPayload(record)).digest('hex')
|
|
265
|
+
}
|
|
266
|
+
function canonical(value: object): string {
|
|
267
|
+
return JSON.stringify(
|
|
268
|
+
Object.entries(value)
|
|
269
|
+
.filter(([, field]) => field !== undefined)
|
|
270
|
+
.sort(([a], [b]) => a.localeCompare(b)),
|
|
271
|
+
)
|
|
272
|
+
}
|
|
@@ -96,7 +96,7 @@ export function decideEngagement(input: EngagementInput): EngagementDecision {
|
|
|
96
96
|
|
|
97
97
|
// Peer bots are excluded from the count — a 1-human-N-bot room is still
|
|
98
98
|
// "solo" for the fallback at the bottom.
|
|
99
|
-
const effectiveHumans =
|
|
99
|
+
const effectiveHumans = countEngagementHumans(message, participants, input.membership, now, botInThread)
|
|
100
100
|
|
|
101
101
|
if (config.trigger.includes('dm') && message.isDm) return 'engage'
|
|
102
102
|
if (config.trigger.includes('mention') && message.isBotMention) return 'engage'
|
|
@@ -281,6 +281,22 @@ function targetsSomeoneElse(
|
|
|
281
281
|
return false
|
|
282
282
|
}
|
|
283
283
|
|
|
284
|
+
// Membership is a room property, so a Slack thread inherits its parent
|
|
285
|
+
// channel's count. Once the bot is part of the thread, the thread's own
|
|
286
|
+
// speakers are the better signal: a thread between one human and the bot is a
|
|
287
|
+
// solo conversation even inside a crowded channel, and a second human posting
|
|
288
|
+
// there flips it back to multi-human.
|
|
289
|
+
export function countEngagementHumans(
|
|
290
|
+
message: InboundMessage,
|
|
291
|
+
participants: readonly ChannelParticipant[],
|
|
292
|
+
membership: MembershipCount | null,
|
|
293
|
+
now: number,
|
|
294
|
+
botInThread: boolean,
|
|
295
|
+
): number {
|
|
296
|
+
if (botInThread && isThreadRoom(message)) return participants.filter((p) => p.isBot !== true).length
|
|
297
|
+
return countEffectiveHumans(participants, membership, now)
|
|
298
|
+
}
|
|
299
|
+
|
|
284
300
|
export function countEffectiveHumans(
|
|
285
301
|
participants: readonly ChannelParticipant[],
|
|
286
302
|
membership: MembershipCount | null,
|
|
@@ -19,7 +19,7 @@ export type FalseReceiptInput = {
|
|
|
19
19
|
chat: string
|
|
20
20
|
thread: string | null
|
|
21
21
|
text: string | undefined
|
|
22
|
-
|
|
22
|
+
continueAfterReply: boolean
|
|
23
23
|
resolveReviewThread: boolean
|
|
24
24
|
}
|
|
25
25
|
|
|
@@ -32,9 +32,9 @@ export function checkFalseReceipt(input: FalseReceiptInput): FalseReceiptDecisio
|
|
|
32
32
|
if (claim === 'ignore') return { kind: 'allow' }
|
|
33
33
|
if (claim === 'warn') return { kind: 'warn', notice: SOFT_NOTICE }
|
|
34
34
|
|
|
35
|
-
// A turn the agent explicitly keeps alive (
|
|
35
|
+
// A turn the agent explicitly keeps alive (continue_after_reply:true) is not yet
|
|
36
36
|
// a receipt — the real action may still be coming. Never block; nudge instead.
|
|
37
|
-
if (input.
|
|
37
|
+
if (input.continueAfterReply) return { kind: 'warn', notice: SOFT_NOTICE }
|
|
38
38
|
|
|
39
39
|
if (claim === 'block-resolve') {
|
|
40
40
|
if (input.thread === null) return { kind: 'allow' }
|
|
@@ -19,10 +19,10 @@ export type RereviewGuardInput = {
|
|
|
19
19
|
thread: string | null
|
|
20
20
|
text: string | undefined
|
|
21
21
|
wantsResolve: boolean
|
|
22
|
-
// A mid-turn status reply (
|
|
22
|
+
// A mid-turn status reply (continue_after_reply:true) is not the turn's receipt,
|
|
23
23
|
// so it suppresses the warn-tier escalation below — but never the explicit
|
|
24
24
|
// resolve, which is a real mutation. Mirrors the false-receipt guard's rule.
|
|
25
|
-
|
|
25
|
+
continueAfterReply: boolean
|
|
26
26
|
getReviewState: (req: { adapter: 'github'; workspace: string; chat: string }) => Promise<ReviewStateResult>
|
|
27
27
|
workspace: string
|
|
28
28
|
round?: GithubReviewFollowupRound
|
|
@@ -42,7 +42,11 @@ export async function evaluateRereviewGuard(input: RereviewGuardInput): Promise<
|
|
|
42
42
|
if (!isCloseoutAttempt(input)) return ALLOW
|
|
43
43
|
|
|
44
44
|
const round = matchingRound(input)
|
|
45
|
-
const
|
|
45
|
+
const request = { adapter: 'github', workspace: input.workspace, chat: input.chat } as const
|
|
46
|
+
let state = await input.getReviewState(request)
|
|
47
|
+
// One immediate re-query absorbs a single GitHub API blip, which would
|
|
48
|
+
// otherwise refuse a legitimate close-out the model has to re-author.
|
|
49
|
+
if (!state.ok && state.code === 'transient') state = await input.getReviewState(request)
|
|
46
50
|
|
|
47
51
|
// Fail closed: an unverifiable review state is treated as a live block, so the
|
|
48
52
|
// bot never strands a re-review on a transient API failure.
|
|
@@ -82,14 +86,14 @@ function matchingRound(input: RereviewGuardInput): GithubReviewFollowupRound | n
|
|
|
82
86
|
// live CHANGES_REQUESTED, so casual approval-shaped chatter on an unblocked PR
|
|
83
87
|
// still posts. Only POSITIVE warn phrases escalate — negative ones ("needs
|
|
84
88
|
// changes", "still needs work") re-assert a block rather than strand it, so they
|
|
85
|
-
// stay non-firing. `
|
|
89
|
+
// stay non-firing. `continue_after_reply:true` exempts the warn escalation
|
|
86
90
|
// (mid-turn planning, not the receipt), but never the explicit resolve action.
|
|
87
91
|
// Plain `ignore` text never fires.
|
|
88
92
|
function isCloseoutAttempt(input: RereviewGuardInput): boolean {
|
|
89
93
|
if (input.wantsResolve && input.thread !== null) return true
|
|
90
94
|
const claim = classifyReviewClaim(input.text ?? '')
|
|
91
95
|
if (claim === 'block-resolve' || claim === 'block-approve') return true
|
|
92
|
-
return !input.
|
|
96
|
+
return !input.continueAfterReply && isPositiveWarnCloseout(input.text ?? '')
|
|
93
97
|
}
|
|
94
98
|
|
|
95
99
|
function unverifiableReason(error: string): string {
|