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
|
@@ -6,6 +6,32 @@
|
|
|
6
6
|
// is a false receipt (see channel-reply.ts). State is per-session and reset at
|
|
7
7
|
// turn start, so a claim must be backed by an action in the SAME turn.
|
|
8
8
|
|
|
9
|
+
import type { BackgroundObligationRef } from './background-obligations'
|
|
10
|
+
import type { InboundRef } from './inbound-journal'
|
|
11
|
+
|
|
12
|
+
export type ReviewResultCoverage = {
|
|
13
|
+
inboundCoverage?: InboundRef[]
|
|
14
|
+
backgroundCoverage?: BackgroundObligationRef[]
|
|
15
|
+
expectedAccountIdentity?: string
|
|
16
|
+
}
|
|
17
|
+
|
|
18
|
+
let reviewCoverageCapture: ((sessionId: string) => Promise<ReviewResultCoverage>) | null = null
|
|
19
|
+
|
|
20
|
+
export function setReviewCoverageCapture(capture: typeof reviewCoverageCapture): void {
|
|
21
|
+
reviewCoverageCapture = capture
|
|
22
|
+
}
|
|
23
|
+
|
|
24
|
+
export async function captureReviewResultCoverage(sessionId: string): Promise<ReviewResultCoverage> {
|
|
25
|
+
const coverage = await reviewCoverageCapture?.(sessionId)
|
|
26
|
+
return {
|
|
27
|
+
inboundCoverage: coverage?.inboundCoverage?.map((ref) => ({ ...ref })) ?? [],
|
|
28
|
+
backgroundCoverage: coverage?.backgroundCoverage?.map((ref) => ({ ...ref })) ?? [],
|
|
29
|
+
...(coverage?.expectedAccountIdentity !== undefined
|
|
30
|
+
? { expectedAccountIdentity: coverage.expectedAccountIdentity }
|
|
31
|
+
: {}),
|
|
32
|
+
}
|
|
33
|
+
}
|
|
34
|
+
|
|
9
35
|
export type ReviewVerdict = 'APPROVE' | 'REQUEST_CHANGES'
|
|
10
36
|
export type ReviewRoundOutcome = ReviewVerdict | 'DISMISSED'
|
|
11
37
|
|
|
@@ -14,6 +40,8 @@ export type ReviewObserver = (args: {
|
|
|
14
40
|
workspace: string
|
|
15
41
|
prNumber: number
|
|
16
42
|
verdict: ReviewRoundOutcome
|
|
43
|
+
// The commit the landed review is attached to, when the publisher knows it.
|
|
44
|
+
commitSha?: string
|
|
17
45
|
}) => void
|
|
18
46
|
|
|
19
47
|
// A formal review LANDED this turn, of ANY state — the two decisive verdicts PLUS
|
|
@@ -24,12 +52,14 @@ export type ReviewObserver = (args: {
|
|
|
24
52
|
// verdict-claim risk and must never satisfy `hasReview()`.
|
|
25
53
|
export type ReviewOutputState = ReviewVerdict | 'COMMENT'
|
|
26
54
|
|
|
27
|
-
export type ReviewOutputObserver = (
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
|
|
55
|
+
export type ReviewOutputObserver = (
|
|
56
|
+
args: {
|
|
57
|
+
sessionId: string
|
|
58
|
+
workspace: string
|
|
59
|
+
prNumber: number
|
|
60
|
+
state: ReviewOutputState
|
|
61
|
+
} & ReviewResultCoverage,
|
|
62
|
+
) => void | Promise<void>
|
|
33
63
|
|
|
34
64
|
type PrKey = string
|
|
35
65
|
type ThreadKey = string
|
|
@@ -45,6 +75,21 @@ const resolvedThreads = new Set<ThreadKey>()
|
|
|
45
75
|
// plugin/channels boundary, which is why it owns this hook.
|
|
46
76
|
let reviewObserver: ReviewObserver | null = null
|
|
47
77
|
let reviewOutputObserver: ReviewOutputObserver | null = null
|
|
78
|
+
export type VerifiedDismissal = {
|
|
79
|
+
sessionId: string
|
|
80
|
+
workspace: string
|
|
81
|
+
prNumber: number
|
|
82
|
+
commitSha?: string
|
|
83
|
+
startedAt?: number
|
|
84
|
+
}
|
|
85
|
+
const dismissalObservers = new Set<(dismissal: VerifiedDismissal) => Promise<void>>()
|
|
86
|
+
|
|
87
|
+
export function observeVerifiedDismissals(observer: (dismissal: VerifiedDismissal) => Promise<void>): () => void {
|
|
88
|
+
dismissalObservers.add(observer)
|
|
89
|
+
return () => {
|
|
90
|
+
dismissalObservers.delete(observer)
|
|
91
|
+
}
|
|
92
|
+
}
|
|
48
93
|
|
|
49
94
|
export function setReviewObserver(observer: ReviewObserver | null): void {
|
|
50
95
|
reviewObserver = observer
|
|
@@ -57,6 +102,8 @@ export function setReviewOutputObserver(observer: ReviewOutputObserver | null):
|
|
|
57
102
|
export function __resetReviewObserverForTest(): void {
|
|
58
103
|
reviewObserver = null
|
|
59
104
|
reviewOutputObserver = null
|
|
105
|
+
reviewCoverageCapture = null
|
|
106
|
+
dismissalObservers.clear()
|
|
60
107
|
}
|
|
61
108
|
|
|
62
109
|
function prKey(sessionId: string, workspace: string, prNumber: number): PrKey {
|
|
@@ -76,12 +123,15 @@ export function resetReviewTurn(sessionId: string): void {
|
|
|
76
123
|
}
|
|
77
124
|
}
|
|
78
125
|
|
|
79
|
-
export function recordReview(
|
|
80
|
-
|
|
81
|
-
|
|
82
|
-
|
|
83
|
-
|
|
84
|
-
|
|
126
|
+
export async function recordReview(
|
|
127
|
+
args: {
|
|
128
|
+
sessionId: string
|
|
129
|
+
workspace: string
|
|
130
|
+
prNumber: number
|
|
131
|
+
verdict: ReviewVerdict
|
|
132
|
+
commitSha?: string
|
|
133
|
+
} & ReviewResultCoverage,
|
|
134
|
+
): Promise<void> {
|
|
85
135
|
const key = prKey(args.sessionId, args.workspace, args.prNumber)
|
|
86
136
|
const set = reviewsByPr.get(key) ?? new Set<ReviewVerdict>()
|
|
87
137
|
set.add(args.verdict)
|
|
@@ -90,41 +140,65 @@ export function recordReview(args: {
|
|
|
90
140
|
// ledger write — the false-receipt guard depends on this record being durable.
|
|
91
141
|
if (reviewObserver !== null) {
|
|
92
142
|
try {
|
|
93
|
-
reviewObserver(
|
|
143
|
+
reviewObserver({
|
|
144
|
+
sessionId: args.sessionId,
|
|
145
|
+
workspace: args.workspace,
|
|
146
|
+
prNumber: args.prNumber,
|
|
147
|
+
verdict: args.verdict,
|
|
148
|
+
...(args.commitSha !== undefined ? { commitSha: args.commitSha } : {}),
|
|
149
|
+
})
|
|
94
150
|
} catch {
|
|
95
151
|
// swallow: a broken broadcast must not break verdict bookkeeping
|
|
96
152
|
}
|
|
97
153
|
}
|
|
98
154
|
// A decisive verdict IS review output too — fan it to the output observer so the
|
|
99
155
|
// router's empty-turn guard sees it without a second detection path.
|
|
100
|
-
recordReviewOutput({
|
|
156
|
+
await recordReviewOutput({
|
|
101
157
|
sessionId: args.sessionId,
|
|
102
158
|
workspace: args.workspace,
|
|
103
159
|
prNumber: args.prNumber,
|
|
104
160
|
state: args.verdict,
|
|
161
|
+
...(args.inboundCoverage !== undefined ? { inboundCoverage: args.inboundCoverage } : {}),
|
|
162
|
+
...(args.backgroundCoverage !== undefined ? { backgroundCoverage: args.backgroundCoverage } : {}),
|
|
105
163
|
})
|
|
106
164
|
}
|
|
107
165
|
|
|
108
|
-
export function recordVerifiedDismissal(args:
|
|
109
|
-
if (reviewObserver
|
|
110
|
-
|
|
111
|
-
|
|
112
|
-
|
|
113
|
-
|
|
166
|
+
export async function recordVerifiedDismissal(args: VerifiedDismissal): Promise<void> {
|
|
167
|
+
if (reviewObserver !== null) {
|
|
168
|
+
try {
|
|
169
|
+
reviewObserver({
|
|
170
|
+
sessionId: args.sessionId,
|
|
171
|
+
workspace: args.workspace,
|
|
172
|
+
prNumber: args.prNumber,
|
|
173
|
+
verdict: 'DISMISSED',
|
|
174
|
+
})
|
|
175
|
+
} catch {
|
|
176
|
+
// A broken round wakeup must not turn a verified GitHub mutation into a tool failure.
|
|
177
|
+
}
|
|
178
|
+
}
|
|
179
|
+
for (const observer of dismissalObservers) {
|
|
180
|
+
try {
|
|
181
|
+
await observer(args)
|
|
182
|
+
} catch (error) {
|
|
183
|
+
// Publication already succeeded; retain pending work for boot verification.
|
|
184
|
+
console.warn('[github] verified dismissal pending-review cleanup failed:', error)
|
|
185
|
+
}
|
|
114
186
|
}
|
|
115
187
|
}
|
|
116
188
|
|
|
117
|
-
export function recordReviewOutput(
|
|
118
|
-
|
|
119
|
-
|
|
120
|
-
|
|
121
|
-
|
|
122
|
-
|
|
189
|
+
export async function recordReviewOutput(
|
|
190
|
+
args: {
|
|
191
|
+
sessionId: string
|
|
192
|
+
workspace: string
|
|
193
|
+
prNumber: number
|
|
194
|
+
state: ReviewOutputState
|
|
195
|
+
} & ReviewResultCoverage,
|
|
196
|
+
): Promise<void> {
|
|
123
197
|
if (reviewOutputObserver === null) return
|
|
124
198
|
try {
|
|
125
|
-
reviewOutputObserver(args)
|
|
199
|
+
await reviewOutputObserver(args)
|
|
126
200
|
} catch {
|
|
127
|
-
//
|
|
201
|
+
// The review already landed remotely. Settlement failure must not authorize a mutation retry.
|
|
128
202
|
}
|
|
129
203
|
}
|
|
130
204
|
|
|
@@ -51,6 +51,7 @@ export type ReviewVerdictGuard = {
|
|
|
51
51
|
verdict: ReviewVerdict
|
|
52
52
|
round?: GithubReviewFollowupRound
|
|
53
53
|
thread?: string | null
|
|
54
|
+
reviewedHeadSha?: string
|
|
54
55
|
retainDuplicateLease?: boolean
|
|
55
56
|
}) => Promise<ApproveBlock | null>
|
|
56
57
|
release: (args: { callId: string; outcome: ReviewOutputOutcome }) => Promise<void>
|
|
@@ -117,7 +118,8 @@ const PENDING_PUBLICATION_REASON =
|
|
|
117
118
|
|
|
118
119
|
const ROUND_INELIGIBLE_REASON =
|
|
119
120
|
'This review follow-up round assigned the formal verdict to another sibling thread session. ' +
|
|
120
|
-
'Do not submit a formal verdict from this session
|
|
121
|
+
'Do not submit a formal verdict from this session and do not reply now: call `skip_response`. Once the designated sibling verdict lands, ' +
|
|
122
|
+
'close out only this thread with the technical outcome; never mention sessions, carriers, or review rounds on the PR.'
|
|
121
123
|
|
|
122
124
|
const ROUND_HEAD_UNVERIFIED_REASON =
|
|
123
125
|
"Could not verify this pull request's current head commit on GitHub, so the review round's verdict was not submitted. " +
|
|
@@ -129,6 +131,18 @@ const ROUND_HEAD_MOVED_REASON =
|
|
|
129
131
|
'The pull request head moved past the commit this review round covers, so a verdict from this round would describe stale code. ' +
|
|
130
132
|
'Do not submit it; the new push starts its own review round.'
|
|
131
133
|
|
|
134
|
+
function reviewedHeadRequiredReason(currentHead: string): string {
|
|
135
|
+
return (
|
|
136
|
+
`The pull request head moved to ${currentHead} after this review round opened. ` +
|
|
137
|
+
'Submit the verdict with `post_github_review` and set `head_sha` to the full commit SHA your review covered. ' +
|
|
138
|
+
`If you did not review ${currentHead}, re-review that commit first.`
|
|
139
|
+
)
|
|
140
|
+
}
|
|
141
|
+
|
|
142
|
+
function sameSha(a: string | undefined, b: string): boolean {
|
|
143
|
+
return a !== undefined && a.toLocaleLowerCase() === b.toLocaleLowerCase()
|
|
144
|
+
}
|
|
145
|
+
|
|
132
146
|
// The standing verdict a fresh attempt would duplicate. APPROVE duplicates a
|
|
133
147
|
// standing APPROVED; REQUEST_CHANGES duplicates a standing CHANGES_REQUESTED.
|
|
134
148
|
function duplicatesStanding(verdict: ReviewVerdict, effective: EffectiveVerdict): boolean {
|
|
@@ -410,15 +424,53 @@ export function canPromoteGithubReviewRoundTo(
|
|
|
410
424
|
return current !== undefined && current.status !== 'completed' && !current.attemptedCarriers.has(thread)
|
|
411
425
|
}
|
|
412
426
|
|
|
427
|
+
// `landedCommitSha` distinguishes the two callers. A restore (undefined) only
|
|
428
|
+
// asks whether the round still owns the PR. A completion passes the commit the
|
|
429
|
+
// landed verdict is attached to (null when the publisher cannot tell), because
|
|
430
|
+
// completing releases the carrier's thread close-outs: after an unobserved push
|
|
431
|
+
// the verdict must still describe the current head.
|
|
413
432
|
export async function validateGithubReviewRound(
|
|
414
433
|
round: GithubReviewFollowupRound,
|
|
415
434
|
createdAt?: number,
|
|
416
435
|
now: () => number = Date.now,
|
|
436
|
+
landedCommitSha?: string | null,
|
|
417
437
|
): Promise<boolean> {
|
|
418
438
|
if (createdAt !== undefined && now() - createdAt >= reviewRoundTtlMs(round)) return false
|
|
419
439
|
if (expiredReviewRoundKeys.has(githubReviewRoundKey(round))) return false
|
|
440
|
+
if (isGithubReviewRoundSuperseded(round, now)) return false
|
|
420
441
|
const currentHead = await processHeadShaResolver({ workspace: round.workspace, prNumber: round.prNumber })
|
|
421
|
-
|
|
442
|
+
if (currentHead === null || isGithubReviewRoundSuperseded(round, now)) return false
|
|
443
|
+
if (currentHead === round.headSha) return true
|
|
444
|
+
if (round.kind !== 'reply') return false
|
|
445
|
+
return landedCommitSha === undefined || sameSha(landedCommitSha ?? undefined, currentHead)
|
|
446
|
+
}
|
|
447
|
+
|
|
448
|
+
// Registering a round evicts every other round for the same PR, so a round that
|
|
449
|
+
// is no longer registered while a sibling round is has been replaced by a newer
|
|
450
|
+
// one (a later push, or a later reply generation). Re-registering it would evict
|
|
451
|
+
// that newer round in turn, so callers must check this BEFORE re-registration.
|
|
452
|
+
export function isGithubReviewRoundSuperseded(round: GithubReviewFollowupRound, now: () => number = Date.now): boolean {
|
|
453
|
+
const key = githubReviewRoundKey(round)
|
|
454
|
+
if (activeReviewRoundState(key, now) !== undefined) return false
|
|
455
|
+
expireReviewRounds(now)
|
|
456
|
+
return Array.from(reviewRounds.entries()).some(
|
|
457
|
+
([candidateKey, state]) =>
|
|
458
|
+
candidateKey !== key && state.round.workspace === round.workspace && state.round.prNumber === round.prNumber,
|
|
459
|
+
)
|
|
460
|
+
}
|
|
461
|
+
|
|
462
|
+
function pendingPushRoundForPr(
|
|
463
|
+
target: { workspace: string; prNumber: number },
|
|
464
|
+
now: () => number = Date.now,
|
|
465
|
+
): ReviewRoundState | undefined {
|
|
466
|
+
expireReviewRounds(now)
|
|
467
|
+
return Array.from(reviewRounds.values()).find(
|
|
468
|
+
(state) =>
|
|
469
|
+
state.status === 'pending' &&
|
|
470
|
+
state.round.kind === 'push' &&
|
|
471
|
+
state.round.workspace === target.workspace &&
|
|
472
|
+
state.round.prNumber === target.prNumber,
|
|
473
|
+
)
|
|
422
474
|
}
|
|
423
475
|
|
|
424
476
|
export async function guardGithubReviewRoundDismissal(args: {
|
|
@@ -773,19 +825,13 @@ async function evaluateRoundEligibility(
|
|
|
773
825
|
prNumber: number
|
|
774
826
|
round?: GithubReviewFollowupRound
|
|
775
827
|
thread?: string | null
|
|
828
|
+
reviewedHeadSha?: string
|
|
776
829
|
},
|
|
777
830
|
resolveHeadSha: HeadShaResolver,
|
|
778
831
|
now: () => number = Date.now,
|
|
779
832
|
logger: ReviewVerdictCoordinatorLogger = processLogger,
|
|
780
833
|
): Promise<ApproveBlock | null> {
|
|
781
|
-
|
|
782
|
-
const pendingRoundForPr = Array.from(reviewRounds.values()).find(
|
|
783
|
-
(state) =>
|
|
784
|
-
state.status === 'pending' &&
|
|
785
|
-
state.round.kind === 'push' &&
|
|
786
|
-
state.round.workspace === args.workspace &&
|
|
787
|
-
state.round.prNumber === args.prNumber,
|
|
788
|
-
)
|
|
834
|
+
const pendingRoundForPr = pendingPushRoundForPr(args, now)
|
|
789
835
|
// Pushes invalidate the whole PR's prior verdict, so their round legitimately
|
|
790
836
|
// owns every verdict attempt until one sibling carries it. Reply rounds only
|
|
791
837
|
// coordinate the stamped siblings answering one blocking review: their
|
|
@@ -820,12 +866,26 @@ async function evaluateRoundEligibility(
|
|
|
820
866
|
)
|
|
821
867
|
return { block: true, kind: 'round-ineligible', reason: ROUND_HEAD_UNVERIFIED_REASON }
|
|
822
868
|
}
|
|
823
|
-
|
|
869
|
+
// Re-read ownership after the await: a round registered meanwhile evicted this
|
|
870
|
+
// one, and the registration below would evict it right back.
|
|
871
|
+
const superseded = isGithubReviewRoundSuperseded(activeRound, now)
|
|
872
|
+
if (superseded || (currentRoundHead !== activeRound.headSha && activeRound.kind === 'push')) {
|
|
824
873
|
logger.warn(
|
|
825
|
-
`[github] review round head moved pr=${activeRound.workspace}#${activeRound.prNumber} round=${activeRound.roundId} round_head=${activeRound.headSha} current_head=${currentRoundHead}`,
|
|
874
|
+
`[github] review round head moved pr=${activeRound.workspace}#${activeRound.prNumber} round=${activeRound.roundId} round_head=${activeRound.headSha} current_head=${currentRoundHead}${superseded ? ' superseded=true' : ''}`,
|
|
826
875
|
)
|
|
827
876
|
return { block: true, kind: 'round-ineligible', reason: ROUND_HEAD_MOVED_REASON }
|
|
828
877
|
}
|
|
878
|
+
// A reply round's head is only the webhook snapshot at reply time, and no push
|
|
879
|
+
// round replaces it unless the adapter receives the push (never when
|
|
880
|
+
// `pull_request.synchronize` is off the event allowlist). So a moved reply round
|
|
881
|
+
// follows the head, but only for a verdict bound to the commit it describes:
|
|
882
|
+
// the carrier must name the head it reviewed, and it must still be current.
|
|
883
|
+
if (currentRoundHead !== activeRound.headSha && !sameSha(args.reviewedHeadSha, currentRoundHead)) {
|
|
884
|
+
logger.warn(
|
|
885
|
+
`[github] review round head moved without a matching reviewed head pr=${activeRound.workspace}#${activeRound.prNumber} round=${activeRound.roundId} current_head=${currentRoundHead} reviewed_head=${args.reviewedHeadSha ?? 'none'}`,
|
|
886
|
+
)
|
|
887
|
+
return { block: true, kind: 'round-ineligible', reason: reviewedHeadRequiredReason(currentRoundHead) }
|
|
888
|
+
}
|
|
829
889
|
registerGithubReviewRound(activeRound, now())
|
|
830
890
|
return null
|
|
831
891
|
}
|
|
@@ -4,7 +4,10 @@ import { describeError } from './describe-error'
|
|
|
4
4
|
// singleton would leak resolver state across tests. One instance is created in
|
|
5
5
|
// run/index.ts and threaded to both the plugin loader and the channel manager.
|
|
6
6
|
|
|
7
|
-
export type
|
|
7
|
+
export type GithubTokenCredential = { token: string; accountIdentity?: string }
|
|
8
|
+
export type GithubTokenResolveResult =
|
|
9
|
+
| ({ kind: 'token' } & GithubTokenCredential)
|
|
10
|
+
| { kind: 'unavailable'; reason: string }
|
|
8
11
|
|
|
9
12
|
export type ResolveGithubTokenForRepo = (repoSlug: string) => Promise<GithubTokenResolveResult>
|
|
10
13
|
|
|
@@ -16,24 +19,51 @@ export type GithubTokenBridge = {
|
|
|
16
19
|
// process-wide GH_TOKEN, so brokered gh paths cannot rely on its prefix.
|
|
17
20
|
hasAppTokenResolver: () => boolean
|
|
18
21
|
getAppSelfLogin: () => string | null
|
|
19
|
-
|
|
22
|
+
// PAT-mode channel auth: the adapter lends its stored PAT for git push to a
|
|
23
|
+
// configured repo. Kept apart from the App minter so PAT presence never flips
|
|
24
|
+
// hasAppTokenResolver() and the App-only paths (sandboxed minting, push grants).
|
|
25
|
+
resolvePatForRepo: ResolveGithubTokenForRepo
|
|
26
|
+
registerPatResolver: (resolver: (repoSlug: string) => Promise<GithubTokenCredential>) => () => void
|
|
27
|
+
registerResolver: (
|
|
28
|
+
resolver: (repoSlug: string) => Promise<GithubTokenCredential>,
|
|
29
|
+
selfLogin?: () => string | null,
|
|
30
|
+
) => () => void
|
|
20
31
|
}
|
|
21
32
|
|
|
22
33
|
const NO_RESOLVER_REASON =
|
|
23
34
|
'GitHub App token unavailable; the GitHub channel adapter is not running or failed to start. ' +
|
|
24
35
|
'Check `typeclaw logs` and `secrets.json#channels.github`.'
|
|
25
36
|
|
|
37
|
+
const NO_PAT_RESOLVER_REASON =
|
|
38
|
+
'No GitHub channel PAT is available; the GitHub channel is not configured with PAT auth, or its adapter is not running.'
|
|
39
|
+
|
|
26
40
|
export function createGithubTokenBridge(): GithubTokenBridge {
|
|
27
|
-
let current: ((repoSlug: string) => Promise<
|
|
41
|
+
let current: ((repoSlug: string) => Promise<GithubTokenCredential>) | null = null
|
|
28
42
|
let currentSelfLogin: (() => string | null) | null = null
|
|
43
|
+
let currentPat: ((repoSlug: string) => Promise<GithubTokenCredential>) | null = null
|
|
29
44
|
|
|
30
45
|
return {
|
|
46
|
+
resolvePatForRepo: async (repoSlug) => {
|
|
47
|
+
const resolver = currentPat
|
|
48
|
+
if (resolver === null) return { kind: 'unavailable', reason: NO_PAT_RESOLVER_REASON }
|
|
49
|
+
try {
|
|
50
|
+
return { kind: 'token', ...(await resolver(repoSlug)) }
|
|
51
|
+
} catch (err) {
|
|
52
|
+
return { kind: 'unavailable', reason: describeError(err) }
|
|
53
|
+
}
|
|
54
|
+
},
|
|
55
|
+
registerPatResolver: (resolver) => {
|
|
56
|
+
currentPat = resolver
|
|
57
|
+
return () => {
|
|
58
|
+
if (currentPat === resolver) currentPat = null
|
|
59
|
+
}
|
|
60
|
+
},
|
|
31
61
|
resolveTokenForRepo: async (repoSlug) => {
|
|
32
62
|
const resolver = current
|
|
33
63
|
if (resolver === null) return { kind: 'unavailable', reason: NO_RESOLVER_REASON }
|
|
34
64
|
try {
|
|
35
|
-
const
|
|
36
|
-
return { kind: 'token',
|
|
65
|
+
const credential = await resolver(repoSlug)
|
|
66
|
+
return { kind: 'token', ...credential }
|
|
37
67
|
} catch (err) {
|
|
38
68
|
return { kind: 'unavailable', reason: describeError(err) }
|
|
39
69
|
}
|