typeclaw 0.49.0 → 0.50.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/types/agent/attention-escalation.d.ts +18 -0
- package/dist/types/agent/auth.d.ts +7 -0
- package/dist/types/agent/compaction.d.ts +8 -0
- package/dist/types/agent/git-nudge.d.ts +6 -0
- package/dist/types/agent/guard-types.d.ts +25 -0
- package/dist/types/agent/guards.d.ts +7 -0
- package/dist/types/agent/idle-compaction.d.ts +7 -0
- package/dist/types/agent/index.d.ts +163 -0
- package/dist/types/agent/live-subagents.d.ts +113 -0
- package/dist/types/agent/llm-replay-sanitizer.d.ts +11 -0
- package/dist/types/agent/loop-guard.d.ts +67 -0
- package/dist/types/agent/model-fallback.d.ts +29 -0
- package/dist/types/agent/model-overrides.d.ts +8 -0
- package/dist/types/agent/multimodal/index.d.ts +2 -0
- package/dist/types/agent/multimodal/look-at.d.ts +60 -0
- package/dist/types/agent/multimodal/looker.d.ts +61 -0
- package/dist/types/agent/multimodal/read-redirect.d.ts +6 -0
- package/dist/types/agent/network/response-body.d.ts +1 -0
- package/dist/types/agent/network/safe-http.d.ts +46 -0
- package/dist/types/agent/plugin-tools.d.ts +129 -0
- package/dist/types/agent/proactive-next-step-nudge.d.ts +2 -0
- package/dist/types/agent/prompt-cache-key.d.ts +3 -0
- package/dist/types/agent/provider-error.d.ts +23 -0
- package/dist/types/agent/reload-tool.d.ts +10 -0
- package/dist/types/agent/restart/index.d.ts +31 -0
- package/dist/types/agent/restart-handoff/index.d.ts +32 -0
- package/dist/types/agent/restart-handoff/paths.d.ts +1 -0
- package/dist/types/agent/retry-same-ref.d.ts +41 -0
- package/dist/types/agent/reviewer-activity.d.ts +3 -0
- package/dist/types/agent/reviewer-bash-policy.d.ts +8 -0
- package/dist/types/agent/self.d.ts +1 -0
- package/dist/types/agent/session-meta.d.ts +28 -0
- package/dist/types/agent/session-origin.d.ts +65 -0
- package/dist/types/agent/subagent-cache-keepalive.d.ts +38 -0
- package/dist/types/agent/subagent-completion-reminder.d.ts +29 -0
- package/dist/types/agent/subagent-drain.d.ts +25 -0
- package/dist/types/agent/subagent-session.d.ts +3 -0
- package/dist/types/agent/subagents.d.ts +153 -0
- package/dist/types/agent/system-prompt.d.ts +7 -0
- package/dist/types/agent/throttle-circuit.d.ts +25 -0
- package/dist/types/agent/todo/continuation-policy.d.ts +54 -0
- package/dist/types/agent/todo/continuation-state.d.ts +11 -0
- package/dist/types/agent/todo/continuation-wiring.d.ts +32 -0
- package/dist/types/agent/todo/continuation.d.ts +21 -0
- package/dist/types/agent/todo/scope.d.ts +6 -0
- package/dist/types/agent/todo/store.d.ts +16 -0
- package/dist/types/agent/tool-error-remediation.d.ts +1 -0
- package/dist/types/agent/tool-file-safety.d.ts +78 -0
- package/dist/types/agent/tool-not-found-nudge.d.ts +9 -0
- package/dist/types/agent/tool-result-budget.d.ts +15 -0
- package/dist/types/agent/tools/channel-disengage.d.ts +18 -0
- package/dist/types/agent/tools/channel-edit.d.ts +19 -0
- package/dist/types/agent/tools/channel-fetch-attachment.d.ts +36 -0
- package/dist/types/agent/tools/channel-handoff.d.ts +13 -0
- package/dist/types/agent/tools/channel-history-render.d.ts +3 -0
- package/dist/types/agent/tools/channel-history.d.ts +25 -0
- package/dist/types/agent/tools/channel-log.d.ts +5 -0
- package/dist/types/agent/tools/channel-react.d.ts +23 -0
- package/dist/types/agent/tools/channel-read.d.ts +27 -0
- package/dist/types/agent/tools/channel-reply.d.ts +47 -0
- package/dist/types/agent/tools/channel-send.d.ts +42 -0
- package/dist/types/agent/tools/channel-session-search.d.ts +10 -0
- package/dist/types/agent/tools/curl-impersonate.d.ts +37 -0
- package/dist/types/agent/tools/ddg.d.ts +18 -0
- package/dist/types/agent/tools/grant-role.d.ts +25 -0
- package/dist/types/agent/tools/keyed-semaphore.d.ts +10 -0
- package/dist/types/agent/tools/post-github-review.d.ts +38 -0
- package/dist/types/agent/tools/restart.d.ts +25 -0
- package/dist/types/agent/tools/runtime-notice.d.ts +3 -0
- package/dist/types/agent/tools/search-retry.d.ts +16 -0
- package/dist/types/agent/tools/skip-response.d.ts +17 -0
- package/dist/types/agent/tools/spawn-subagent.d.ts +77 -0
- package/dist/types/agent/tools/stream-snapshot.d.ts +23 -0
- package/dist/types/agent/tools/subagent-access.d.ts +20 -0
- package/dist/types/agent/tools/subagent-cancel.d.ts +23 -0
- package/dist/types/agent/tools/subagent-output.d.ts +50 -0
- package/dist/types/agent/tools/todo/index.d.ts +14 -0
- package/dist/types/agent/tools/webfetch/adaptive-html.d.ts +29 -0
- package/dist/types/agent/tools/webfetch/fetch.d.ts +26 -0
- package/dist/types/agent/tools/webfetch/html-lexical.d.ts +27 -0
- package/dist/types/agent/tools/webfetch/index.d.ts +1 -0
- package/dist/types/agent/tools/webfetch/inline-style-visibility.d.ts +3 -0
- package/dist/types/agent/tools/webfetch/strategies/grep.d.ts +11 -0
- package/dist/types/agent/tools/webfetch/strategies/jq.d.ts +4 -0
- package/dist/types/agent/tools/webfetch/strategies/raw.d.ts +1 -0
- package/dist/types/agent/tools/webfetch/strategies/readability.d.ts +16 -0
- package/dist/types/agent/tools/webfetch/strategies/selector.d.ts +4 -0
- package/dist/types/agent/tools/webfetch/strategies/snapshot.d.ts +1 -0
- package/dist/types/agent/tools/webfetch/tool.d.ts +15 -0
- package/dist/types/agent/tools/webfetch/types.d.ts +32 -0
- package/dist/types/agent/tools/websearch.d.ts +17 -0
- package/dist/types/agent/tools/wikipedia.d.ts +7 -0
- package/dist/types/agent/tools-without-local-file-operands.d.ts +1 -0
- package/dist/types/agent/turn-runner.d.ts +36 -0
- package/dist/types/agent-messenger/config-dir.d.ts +19 -0
- package/dist/types/browser/dockerfile.d.ts +2 -0
- package/dist/types/browser/registry.d.ts +49 -0
- package/dist/types/bundled-plugins/bun-hygiene/policy.d.ts +18 -0
- package/dist/types/bundled-plugins/github-cli-auth/git-askpass.d.ts +5 -0
- package/dist/types/bundled-plugins/guard/keys.d.ts +6 -0
- package/dist/types/bundled-plugins/guard/policies/managed-config.d.ts +7 -0
- package/dist/types/bundled-plugins/guard/policies/memory-topics-delete.d.ts +11 -0
- package/dist/types/bundled-plugins/guard/policies/memory-topics-write.d.ts +7 -0
- package/dist/types/bundled-plugins/guard/policies/non-workspace-write.d.ts +9 -0
- package/dist/types/bundled-plugins/guard/policies/skill-authoring.d.ts +20 -0
- package/dist/types/bundled-plugins/guard/policies/uncommitted-changes.d.ts +12 -0
- package/dist/types/bundled-plugins/guard/policy.d.ts +11 -0
- package/dist/types/bundled-plugins/memory/secret-detector.d.ts +11 -0
- package/dist/types/bundled-plugins/memory/slug.d.ts +4 -0
- package/dist/types/bundled-plugins/security/permissions.d.ts +20 -0
- package/dist/types/bundled-plugins/security/policies/private-surface-read.d.ts +34 -0
- package/dist/types/bundled-plugins/security/policies/ssrf.d.ts +18 -0
- package/dist/types/bundled-plugins/security/policy.d.ts +4 -0
- package/dist/types/channels/adapter-namespace.d.ts +2 -0
- package/dist/types/channels/adapters/mention-hints.d.ts +12 -0
- package/dist/types/channels/adapters/webex-id-ref.d.ts +5 -0
- package/dist/types/channels/background-handoff.d.ts +56 -0
- package/dist/types/channels/background-obligations.d.ts +135 -0
- package/dist/types/channels/catch-up.d.ts +26 -0
- package/dist/types/channels/commands.d.ts +2 -0
- package/dist/types/channels/completion-claim.d.ts +20 -0
- package/dist/types/channels/continuation-willingness.d.ts +1 -0
- package/dist/types/channels/continuity-types.d.ts +75 -0
- package/dist/types/channels/describe-error.d.ts +1 -0
- package/dist/types/channels/engagement.d.ts +34 -0
- package/dist/types/channels/github-false-receipt.d.ts +20 -0
- package/dist/types/channels/github-repo.d.ts +2 -0
- package/dist/types/channels/github-rereview-guard.d.ts +24 -0
- package/dist/types/channels/github-review-check.d.ts +135 -0
- package/dist/types/channels/github-review-claim.d.ts +3 -0
- package/dist/types/channels/github-review-turn-ledger.d.ts +71 -0
- package/dist/types/channels/github-review-verdict-coordinator.d.ts +117 -0
- package/dist/types/channels/github-token-bridge.d.ts +20 -0
- package/dist/types/channels/github-verdict-activity.d.ts +12 -0
- package/dist/types/channels/inbound-journal.d.ts +272 -0
- package/dist/types/channels/last-alive.d.ts +3 -0
- package/dist/types/channels/membership-cache.d.ts +27 -0
- package/dist/types/channels/membership.d.ts +21 -0
- package/dist/types/channels/outbound-flood-filter.d.ts +7 -0
- package/dist/types/channels/participants.d.ts +4 -0
- package/dist/types/channels/persistence.d.ts +32 -0
- package/dist/types/channels/recovery-notice.d.ts +26 -0
- package/dist/types/channels/recovery-outbox.d.ts +58 -0
- package/dist/types/channels/router.d.ts +798 -0
- package/dist/types/channels/schema.d.ts +501 -0
- package/dist/types/channels/session-handoff.d.ts +58 -0
- package/dist/types/channels/session-search.d.ts +29 -0
- package/dist/types/channels/types.d.ts +414 -0
- package/dist/types/channels/waiting-reactions.d.ts +25 -0
- package/dist/types/cli/builtins.d.ts +2 -0
- package/dist/types/cli/command-meta.d.ts +9 -0
- package/dist/types/coding-agent/broker-body.d.ts +7 -0
- package/dist/types/coding-agent/broker.d.ts +22 -0
- package/dist/types/coding-agent/claude.d.ts +22 -0
- package/dist/types/coding-agent/codex.d.ts +19 -0
- package/dist/types/coding-agent/index.d.ts +71 -0
- package/dist/types/coding-agent/omo-state.d.ts +2 -0
- package/dist/types/coding-agent/omo-stream.d.ts +22 -0
- package/dist/types/coding-agent/omo.d.ts +133 -0
- package/dist/types/coding-agent/runner.d.ts +35 -0
- package/dist/types/coding-agent/tool.d.ts +27 -0
- package/dist/types/coding-agent/worktree.d.ts +22 -0
- package/dist/types/commands/index.d.ts +45 -0
- package/dist/types/config/config.d.ts +814 -0
- package/dist/types/config/index.d.ts +3 -0
- package/dist/types/config/model-overrides.d.ts +3 -0
- package/dist/types/config/providers.d.ts +1456 -0
- package/dist/types/config/reloadable.d.ts +9 -0
- package/dist/types/container/agent-operation-lock.d.ts +31 -0
- package/dist/types/container/build-cache.d.ts +39 -0
- package/dist/types/container/compose-project.d.ts +1 -0
- package/dist/types/container/controller.d.ts +25 -0
- package/dist/types/container/docker-app.d.ts +23 -0
- package/dist/types/container/exit-reason.d.ts +10 -0
- package/dist/types/container/index.d.ts +14 -0
- package/dist/types/container/log-archive.d.ts +68 -0
- package/dist/types/container/log-colors.d.ts +3 -0
- package/dist/types/container/log-timestamps.d.ts +9 -0
- package/dist/types/container/logs.d.ts +37 -0
- package/dist/types/container/memory-limit.d.ts +13 -0
- package/dist/types/container/memory-oversubscription.d.ts +20 -0
- package/dist/types/container/oom-events.d.ts +18 -0
- package/dist/types/container/port.d.ts +18 -0
- package/dist/types/container/require-running.d.ts +16 -0
- package/dist/types/container/restart.d.ts +32 -0
- package/dist/types/container/shared.d.ts +93 -0
- package/dist/types/container/shell.d.ts +35 -0
- package/dist/types/container/start.d.ts +144 -0
- package/dist/types/container/stats.d.ts +31 -0
- package/dist/types/container/status.d.ts +25 -0
- package/dist/types/container/stop.d.ts +24 -0
- package/dist/types/container/tool-oom-priority.d.ts +4 -0
- package/dist/types/container/verify-running.d.ts +49 -0
- package/dist/types/cron/consumer.d.ts +42 -0
- package/dist/types/cron/count-state.d.ts +24 -0
- package/dist/types/cron/index.d.ts +21 -0
- package/dist/types/cron/list.d.ts +33 -0
- package/dist/types/cron/reloadable.d.ts +11 -0
- package/dist/types/cron/scheduler.d.ts +51 -0
- package/dist/types/cron/schema.d.ts +108 -0
- package/dist/types/dependencies/bin-resolver.d.ts +28 -0
- package/dist/types/dependencies/bins.d.ts +22 -0
- package/dist/types/dependencies/index.d.ts +2 -0
- package/dist/types/git/bound-gc-config.d.ts +4 -0
- package/dist/types/git/hookless.d.ts +1 -0
- package/dist/types/git/reconcile-ignored.d.ts +13 -0
- package/dist/types/git/resolve-agent-git.d.ts +8 -0
- package/dist/types/git/resolve-identity.d.ts +10 -0
- package/dist/types/git/run.d.ts +24 -0
- package/dist/types/git/system-commit.d.ts +2 -0
- package/dist/types/hostd/client.d.ts +13 -0
- package/dist/types/hostd/models.d.ts +1 -0
- package/dist/types/hostd/paths.d.ts +17 -0
- package/dist/types/hostd/protocol.d.ts +93 -0
- package/dist/types/hostd/spawn.d.ts +17 -0
- package/dist/types/hostd/version.d.ts +18 -0
- package/dist/types/init/auto-upgrade.d.ts +41 -0
- package/dist/types/init/cli-version.d.ts +7 -0
- package/dist/types/init/dockerfile.d.ts +34 -0
- package/dist/types/init/ensure-deps.d.ts +17 -0
- package/dist/types/init/env-file.d.ts +3 -0
- package/dist/types/init/gitignore.d.ts +5 -0
- package/dist/types/init/local-source-stamp.d.ts +3 -0
- package/dist/types/init/packagejson.d.ts +7 -0
- package/dist/types/init/paths.d.ts +3 -0
- package/dist/types/init/reconcile-plugin-deps.d.ts +13 -0
- package/dist/types/init/run-bun-install.d.ts +16 -0
- package/dist/types/init/windows-dev-link.d.ts +8 -0
- package/dist/types/mcp/catalog.d.ts +7 -0
- package/dist/types/mcp/client.d.ts +58 -0
- package/dist/types/mcp/manager.d.ts +56 -0
- package/dist/types/mcp/tools.d.ts +23 -0
- package/dist/types/models/embedding-model.d.ts +20 -0
- package/dist/types/models/transformers-version.d.ts +1 -0
- package/dist/types/network/internal-destinations.d.ts +29 -0
- package/dist/types/operations/classify-tool-outcome.d.ts +35 -0
- package/dist/types/operations/incidents.d.ts +47 -0
- package/dist/types/operations/index.d.ts +3 -0
- package/dist/types/operations/remediations.d.ts +25 -0
- package/dist/types/path-safety/real-intended-path.d.ts +9 -0
- package/dist/types/permissions/builtins.d.ts +25 -0
- package/dist/types/permissions/grant.d.ts +19 -0
- package/dist/types/permissions/index.d.ts +6 -0
- package/dist/types/permissions/match-rule.d.ts +28 -0
- package/dist/types/permissions/permissions.d.ts +42 -0
- package/dist/types/permissions/resolve.d.ts +25 -0
- package/dist/types/permissions/schema.d.ts +14 -0
- package/dist/types/plugin/context.d.ts +20 -0
- package/dist/types/plugin/core-tool-names.d.ts +4 -0
- package/dist/types/plugin/define.d.ts +46 -0
- package/dist/types/plugin/hooks.d.ts +52 -0
- package/dist/types/plugin/index.d.ts +11 -0
- package/dist/types/plugin/load-skill.d.ts +14 -0
- package/dist/types/plugin/loader.d.ts +25 -0
- package/dist/types/plugin/manager.d.ts +42 -0
- package/dist/types/plugin/registry.d.ts +73 -0
- package/dist/types/plugin/skills.d.ts +11 -0
- package/dist/types/plugin/types.d.ts +336 -0
- package/dist/types/plugin/zod-introspect.d.ts +11 -0
- package/dist/types/reload/client.d.ts +11 -0
- package/dist/types/reload/docker-exec-client.d.ts +11 -0
- package/dist/types/reload/format.d.ts +2 -0
- package/dist/types/reload/index.d.ts +6 -0
- package/dist/types/reload/recover.d.ts +22 -0
- package/dist/types/reload/registry.d.ts +10 -0
- package/dist/types/reload/types.d.ts +25 -0
- package/dist/types/role-claim/client.d.ts +20 -0
- package/dist/types/role-claim/code.d.ts +4 -0
- package/dist/types/role-claim/controller.d.ts +59 -0
- package/dist/types/role-claim/index.d.ts +6 -0
- package/dist/types/role-claim/match-rule.d.ts +9 -0
- package/dist/types/role-claim/pending.d.ts +35 -0
- package/dist/types/role-claim/reload-after-claim.d.ts +16 -0
- package/dist/types/run/llm-fetch-observer.d.ts +50 -0
- package/dist/types/sandbox/availability.d.ts +21 -0
- package/dist/types/sandbox/build.d.ts +7 -0
- package/dist/types/sandbox/canonical-secrets.d.ts +8 -0
- package/dist/types/sandbox/coding-agent.d.ts +20 -0
- package/dist/types/sandbox/dependency-bins.d.ts +19 -0
- package/dist/types/sandbox/dev-source.d.ts +4 -0
- package/dist/types/sandbox/env-exposure.d.ts +1 -0
- package/dist/types/sandbox/errors.d.ts +20 -0
- package/dist/types/sandbox/hidden-paths.d.ts +11 -0
- package/dist/types/sandbox/index.d.ts +14 -0
- package/dist/types/sandbox/package-install.d.ts +1 -0
- package/dist/types/sandbox/policy.d.ts +71 -0
- package/dist/types/sandbox/privileged-runtime.d.ts +13 -0
- package/dist/types/sandbox/quote.d.ts +2 -0
- package/dist/types/sandbox/runtime-private.d.ts +1 -0
- package/dist/types/sandbox/session-tmp.d.ts +6 -0
- package/dist/types/sandbox/symlinks.d.ts +6 -0
- package/dist/types/sandbox/writable-zones.d.ts +15 -0
- package/dist/types/secrets/coding-agent-auth.d.ts +25 -0
- package/dist/types/secrets/defaults.d.ts +21 -0
- package/dist/types/secrets/export-github-cli-store.d.ts +22 -0
- package/dist/types/secrets/hydrate.d.ts +7 -0
- package/dist/types/secrets/index.d.ts +7 -0
- package/dist/types/secrets/provision-github-cli-store.d.ts +45 -0
- package/dist/types/secrets/refresh-provider-oauth.d.ts +22 -0
- package/dist/types/secrets/resolve.d.ts +14 -0
- package/dist/types/secrets/schema.d.ts +840 -0
- package/dist/types/secrets/storage.d.ts +56 -0
- package/dist/types/shared/host-locale.d.ts +1 -0
- package/dist/types/shared/index.d.ts +5 -0
- package/dist/types/shared/local-time.d.ts +4 -0
- package/dist/types/shared/platform.d.ts +2 -0
- package/dist/types/shared/protocol.d.ts +424 -0
- package/dist/types/shared/style-text.d.ts +3 -0
- package/dist/types/shared/wsl.d.ts +17 -0
- package/dist/types/stream/broker.d.ts +2 -0
- package/dist/types/stream/index.d.ts +2 -0
- package/dist/types/stream/types.d.ts +71 -0
- package/package.json +9 -2
- package/scripts/build-plugin-types.ts +105 -0
- package/scripts/check-plugin-sdk.ts +111 -0
- package/scripts/require-parallel.ts +5 -32
- package/src/agent/guard-types.ts +3 -0
- package/src/agent/guards.ts +4 -0
- package/src/agent/idle-compaction.ts +174 -0
- package/src/agent/index.ts +74 -16
- package/src/agent/live-subagents.ts +19 -0
- package/src/agent/multimodal/look-at.ts +22 -9
- package/src/agent/plugin-tools.ts +13 -1
- package/src/agent/reviewer-bash-policy.ts +41 -1
- package/src/agent/session-origin.ts +26 -10
- package/src/agent/subagent-cache-keepalive.ts +198 -0
- package/src/agent/subagent-session.ts +6 -0
- package/src/agent/subagents.ts +46 -8
- package/src/agent/system-prompt.ts +1 -1
- package/src/agent/tool-file-safety.ts +6 -1
- package/src/agent/tools/channel-edit.ts +20 -10
- package/src/agent/tools/channel-fetch-attachment.ts +12 -5
- package/src/agent/tools/channel-handoff.ts +72 -0
- package/src/agent/tools/channel-read.ts +57 -10
- package/src/agent/tools/channel-reply.ts +33 -26
- package/src/agent/tools/channel-send.ts +21 -13
- package/src/agent/tools/channel-session-search.ts +35 -0
- package/src/agent/tools/curl-impersonate.ts +11 -4
- package/src/agent/tools/ddg.ts +13 -5
- package/src/agent/tools/spawn-subagent.ts +27 -11
- package/src/agent/tools/stream-snapshot.ts +15 -2
- package/src/agent/tools/subagent-access.ts +11 -4
- package/src/browser/bsk-shim.mjs +74 -0
- package/src/browser/dockerfile.ts +84 -0
- package/src/browser/egress.ts +104 -0
- package/src/browser/managed-browser.ts +205 -0
- package/src/browser/registry.ts +110 -0
- package/src/browser/relay.ts +231 -0
- package/src/browser/sandbox-entry.ts +167 -0
- package/src/bundled-plugins/agent-browser/index.ts +2 -0
- package/src/bundled-plugins/browser-agent/browser-agent.ts +89 -0
- package/src/bundled-plugins/browser-agent/index.ts +12 -0
- package/src/bundled-plugins/doc-render/index.ts +0 -10
- package/src/bundled-plugins/doc-render/render.ts +83 -111
- package/src/bundled-plugins/doc-render/skills/typeclaw-render-pdf/SKILL.md +152 -257
- package/src/bundled-plugins/github-cli-auth/gh-command.ts +4 -0
- package/src/bundled-plugins/github-cli-auth/git-auth-diagnostic.ts +95 -0
- package/src/bundled-plugins/github-cli-auth/index.ts +75 -59
- package/src/bundled-plugins/managed-browser/index.ts +74 -0
- package/src/bundled-plugins/managed-browser/skills/browser-use/browser-use/SKILL.md +27 -0
- package/src/bundled-plugins/managed-browser/skills/browserskill/browserskill/SKILL.md +28 -0
- package/src/bundled-plugins/managed-browser/skills/omowright/omowright/SKILL.md +40 -0
- package/src/bundled-plugins/operator/operator.ts +1 -1
- package/src/bundled-plugins/qa/index.ts +11 -0
- package/src/bundled-plugins/qa/qa.ts +160 -0
- package/src/bundled-plugins/qa/skills/qa-cli.ts +50 -0
- package/src/bundled-plugins/qa/skills/qa-general.ts +30 -0
- package/src/bundled-plugins/qa/skills/qa-http.ts +39 -0
- package/src/bundled-plugins/qa/skills/qa-pr.ts +51 -0
- package/src/bundled-plugins/qa/skills/qa-web.ts +49 -0
- package/src/bundled-plugins/security/index.ts +53 -34
- package/src/bundled-plugins/security/policies/outbound-secret-scan.ts +1 -0
- package/src/channels/adapter-namespace.ts +13 -0
- package/src/channels/adapters/discord-bot.ts +97 -5
- package/src/channels/adapters/github/index.ts +16 -0
- package/src/channels/adapters/github/last-alive.ts +4 -16
- package/src/channels/adapters/slack-attachment-download.ts +14 -3
- package/src/channels/adapters/slack-bot-author-resolver.ts +4 -3
- package/src/channels/adapters/slack-bot-channel-resolver.ts +9 -6
- package/src/channels/adapters/slack-bot-classify.ts +1 -0
- package/src/channels/adapters/slack-bot-slash-commands.ts +3 -1
- package/src/channels/adapters/slack-bot.ts +299 -67
- package/src/channels/adapters/slack-classify.ts +1 -0
- package/src/channels/catch-up.ts +137 -0
- package/src/channels/continuation-willingness.ts +2 -2
- package/src/channels/continuity-types.ts +1 -0
- package/src/channels/engagement.ts +17 -1
- package/src/channels/github-false-receipt.ts +3 -3
- package/src/channels/github-rereview-guard.ts +9 -5
- package/src/channels/github-token-bridge.ts +24 -0
- package/src/channels/last-alive.ts +34 -0
- package/src/channels/manager.ts +8 -1
- package/src/channels/router.ts +427 -136
- package/src/channels/session-handoff.fixture.ts +144 -0
- package/src/channels/session-handoff.ts +175 -0
- package/src/channels/session-search.ts +71 -0
- package/src/channels/types.ts +12 -2
- package/src/cli/channel.ts +2 -3
- package/src/cli/init.ts +2 -3
- package/src/cli/model.ts +132 -3
- package/src/coding-agent/index.ts +7 -1
- package/src/coding-agent/omo-stream.ts +40 -0
- package/src/coding-agent/runner.ts +30 -8
- package/src/config/config.ts +111 -22
- package/src/config/model-overrides.ts +59 -0
- package/src/config/models-mutation.ts +185 -2
- package/src/config/providers-mutation.ts +12 -4
- package/src/config/providers.ts +59 -0
- package/src/container/start.ts +95 -4
- package/src/doctor/checks.ts +8 -6
- package/src/hostd/daemon.ts +13 -1
- package/src/init/auto-upgrade.ts +7 -1
- package/src/init/dockerfile.ts +57 -12
- package/src/init/index.ts +4 -3
- package/src/init/local-source-stamp.ts +68 -0
- package/src/init/models-dev.ts +4 -0
- package/src/init/validate-api-key.ts +3 -0
- package/src/permissions/builtins.ts +7 -0
- package/src/permissions/permissions.ts +18 -9
- package/src/permissions/resolve.ts +7 -1
- package/src/plugin/context.ts +2 -0
- package/src/plugin/hooks.ts +137 -0
- package/src/plugin/index.ts +6 -0
- package/src/plugin/manager.ts +4 -0
- package/src/plugin/types.ts +60 -0
- package/src/run/bundled-plugins.ts +6 -0
- package/src/run/index.ts +24 -14
- package/src/run/llm-fetch-observer.ts +12 -15
- package/src/sandbox/canonical-secrets.ts +4 -0
- package/src/sandbox/dev-source.ts +26 -0
- package/src/sandbox/hidden-paths.ts +16 -2
- package/src/secrets/storage.ts +13 -0
- package/src/skills/typeclaw-channel-github/SKILL.md +8 -8
- package/src/skills/typeclaw-config/SKILL.md +39 -5
- package/src/skills/typeclaw-config/references/dockerfile.md +2 -2
- package/src/skills/typeclaw-github-contributing/SKILL.md +1 -1
- package/src/skills/typeclaw-monorepo/SKILL.md +1 -1
- package/src/skills/typeclaw-permissions/SKILL.md +7 -7
- package/src/skills/typeclaw-troubleshooting/SKILL.md +12 -1
- package/typeclaw.schema.json +436 -5
- package/src/bundled-plugins/doc-render/templates/lib.typ +0 -339
- package/src/bundled-plugins/github-cli-auth/gh-store.ts +0 -733
|
@@ -0,0 +1,39 @@
|
|
|
1
|
+
import type { LoadableSkill } from '@/plugin'
|
|
2
|
+
|
|
3
|
+
export const HTTP_QA_SKILL: LoadableSkill = {
|
|
4
|
+
name: 'qa-http',
|
|
5
|
+
description:
|
|
6
|
+
'QA an HTTP or JSON API: exercise endpoints with curl, capture status, headers, and bodies, chain requests through realistic workflows, and cover validation errors, auth failures, and idempotency.',
|
|
7
|
+
content: `# qa-http
|
|
8
|
+
|
|
9
|
+
You are QAing an HTTP API. Apply this on top of the QA loop and the \`<qa>\` output contract.
|
|
10
|
+
|
|
11
|
+
## Reach the API
|
|
12
|
+
|
|
13
|
+
- **A deployed endpoint** — use it as given. Never send destructive requests (DELETE, bulk updates) to production unless the caller explicitly asked and named a test resource.
|
|
14
|
+
- **A repo or PR** — write one script that starts the server from the documented command, waits for its health endpoint or port with a bounded retry loop, runs your requests, and stops the server; run it in a single \`bash\` call (a server backgrounded in one call does not survive to the next). Record the start command.
|
|
15
|
+
- Credentials come from the caller or from env vars the operator already exposed. Never print a token into evidence; redact it as \`<redacted>\`.
|
|
16
|
+
|
|
17
|
+
## Capture
|
|
18
|
+
|
|
19
|
+
Use \`curl -sS -i\` so the status line and headers are kept with the body. Save each response to \`/tmp/qa/<run-id>/<scenario>.http\`. If \`hurl\` is installed, a \`.hurl\` file with assertions is a fine way to make a flow repeatable; keep its report.
|
|
20
|
+
|
|
21
|
+
## What to cover
|
|
22
|
+
|
|
23
|
+
1. **Happy path** for each endpoint the request names: correct status, response shape, and the field values the contract promises.
|
|
24
|
+
2. **Workflow chain**: create → read back → update → read back → delete → confirm gone. Capture ids from earlier responses rather than hardcoding them.
|
|
25
|
+
3. **Validation**: missing field, wrong type, out-of-range value. Expect a 4xx with a message that names the field, never a 500.
|
|
26
|
+
4. **Auth**: no credentials and wrong credentials return 401/403, never data.
|
|
27
|
+
5. **Not found and method errors**: an unknown id returns 404; a wrong method returns 405 or the documented behavior.
|
|
28
|
+
6. **Idempotency and retries** where the API promises them: the same PUT twice leaves the same state; a retried create with an idempotency key does not duplicate.
|
|
29
|
+
7. **Non-ASCII payloads**: Korean or Japanese strings round-trip unchanged.
|
|
30
|
+
|
|
31
|
+
## Severity
|
|
32
|
+
|
|
33
|
+
- **blocker** — wrong data, a 5xx on valid input, auth bypass, a broken contract field.
|
|
34
|
+
- **concern** — a 5xx on invalid input, a vague error, an undocumented status code.
|
|
35
|
+
- **nit** — header or formatting inconsistencies.
|
|
36
|
+
|
|
37
|
+
Return everything inside the \`<qa>\` block.
|
|
38
|
+
`,
|
|
39
|
+
}
|
|
@@ -0,0 +1,51 @@
|
|
|
1
|
+
import type { LoadableSkill } from '@/plugin'
|
|
2
|
+
|
|
3
|
+
export const PR_QA_SKILL: LoadableSkill = {
|
|
4
|
+
name: 'qa-pr',
|
|
5
|
+
description:
|
|
6
|
+
'QA a pull request, branch, commit, or whole repository: acquire it at an exact SHA, install and build from a clean scratch clone, run the project’s own checks, then exercise the changed behavior through its real interface and compare against the base when attribution matters.',
|
|
7
|
+
content: `# qa-pr
|
|
8
|
+
|
|
9
|
+
You are QAing code that lives in a repository: a pull request, a branch, a commit, or an open-source project as a whole. Apply this on top of the QA loop and the \`<qa>\` output contract.
|
|
10
|
+
|
|
11
|
+
## Acquire the target at an exact revision
|
|
12
|
+
|
|
13
|
+
- **GitHub PR** — \`gh pr view <n> --repo <owner>/<repo> --json title,body,headRefOid,baseRefOid,files\` gives intent, the head SHA, and the changed files. \`gh pr diff <n> --repo <owner>/<repo>\` gives the diff. Keep each \`gh\` call a single bare invocation (no pipes, \`&&\`, or redirects): the runtime injects a token into its environment.
|
|
14
|
+
- **Public repo** — \`git clone <url> /tmp/qa/<run-id>/head\`. A clone does not include pull-request refs, so for a PR (especially from a fork) also run \`git -C /tmp/qa/<run-id>/head fetch origin pull/<n>/head\`. Then \`git -C /tmp/qa/<run-id>/head checkout <headSha>\` and confirm \`git -C /tmp/qa/<run-id>/head rev-parse HEAD\` equals the head SHA.
|
|
15
|
+
- **Private GitHub repo** — call \`github_prepare_review_checkout\` with the repo slug, head SHA, and merge-base SHA. Its receipt is a read-only acquisition cache: make your writable tree with \`git clone <receipt-path> /tmp/qa/<run-id>/head\` and work only in the clone.
|
|
16
|
+
- **Base comparison** — when you must show the change caused (or fixed) a behavior, make a second clone at the merge base in \`/tmp/qa/<run-id>/base\` and run the same scenario on both.
|
|
17
|
+
|
|
18
|
+
Record the head SHA (and base SHA if used) in \`<target>\`.
|
|
19
|
+
|
|
20
|
+
## Derive the acceptance criteria
|
|
21
|
+
|
|
22
|
+
1. Read the PR title/body and linked issues: what does the author claim the change does? Each claim becomes a scenario.
|
|
23
|
+
2. Read the diff to find the user-facing surface it touches: a CLI flag, an endpoint, a page, a library export, a config key.
|
|
24
|
+
3. Read \`README\`, \`CONTRIBUTING\`, \`AGENTS.md\`, \`package.json\`/\`Makefile\`/\`pyproject.toml\`/\`Cargo.toml\` for the canonical install, build, test, and run commands. Use the project's commands, not ones you invent.
|
|
25
|
+
4. Add one regression scenario on adjacent behavior the diff could break, and one edge case on the changed path.
|
|
26
|
+
|
|
27
|
+
## Build and run the project's own checks
|
|
28
|
+
|
|
29
|
+
- Install with the lockfile the repo ships (\`bun install --frozen-lockfile\`, \`npm ci\`, \`pnpm install --frozen-lockfile\`, \`pip install -e .\`, \`cargo build\`, \`go build ./...\`).
|
|
30
|
+
- Run the documented typecheck, lint, and test commands. Record pass/fail counts and exit codes as scenarios.
|
|
31
|
+
- A check that also fails on the base revision is a **pre-existing failure**: report it in \`<coverage_gaps>\` or as a \`concern\`, never as a defect of this change. Only run the base when a failure needs attribution.
|
|
32
|
+
- If install or build cannot work in this environment (needs a GPU, a paid service, a platform you are not on), the run is \`inconclusive\` for those scenarios; say what is missing.
|
|
33
|
+
|
|
34
|
+
## Exercise the changed behavior for real
|
|
35
|
+
|
|
36
|
+
Green tests are not the finish line: tests can be too narrow, and the author wrote them. Drive the changed behavior through its real interface:
|
|
37
|
+
|
|
38
|
+
- CLI change → run the built binary with the new flag/subcommand (load \`qa-cli\`).
|
|
39
|
+
- Web change → start the dev server and drive the page (load \`qa-web\`).
|
|
40
|
+
- API change → start the server and hit the endpoint (load \`qa-http\`).
|
|
41
|
+
- Library change → write a small script in your scratch dir that imports the public API and exercises the new behavior; keep its transcript.
|
|
42
|
+
|
|
43
|
+
## Severity
|
|
44
|
+
|
|
45
|
+
- **blocker** — a stated claim of the PR does not hold, the build or the project's own tests break because of this change, or a regression on adjacent behavior.
|
|
46
|
+
- **concern** — an edge case on the changed path misbehaves, a missing error message, a docs claim that does not match behavior.
|
|
47
|
+
- **nit** — cosmetic output issues that do not affect correctness.
|
|
48
|
+
|
|
49
|
+
Return everything inside the \`<qa>\` block.
|
|
50
|
+
`,
|
|
51
|
+
}
|
|
@@ -0,0 +1,49 @@
|
|
|
1
|
+
import type { LoadableSkill } from '@/plugin'
|
|
2
|
+
|
|
3
|
+
export const WEB_QA_SKILL: LoadableSkill = {
|
|
4
|
+
name: 'qa-web',
|
|
5
|
+
description:
|
|
6
|
+
'QA a web app or URL in a real browser: drive user flows with a browser engine (agent-browser by default), capture screenshots and console/network errors per step, and cover happy path, a negative path, and mobile plus desktop widths.',
|
|
7
|
+
content: `# qa-web
|
|
8
|
+
|
|
9
|
+
You are QAing something that renders in a browser. Apply this on top of the QA loop and the \`<qa>\` output contract.
|
|
10
|
+
|
|
11
|
+
## Get a page to test
|
|
12
|
+
|
|
13
|
+
- **A deployed URL** — use it directly. Do not log in to accounts, submit payments, or send messages on a production site unless the caller explicitly asked you to and provided a test account.
|
|
14
|
+
- **A repo or PR** — install, then write one script that starts the dev or preview server from the project's documented command, waits until the port answers (\`curl -sf http://localhost:<port>\` in a bounded retry loop), runs your browser steps, and stops the server. Run it in a single \`bash\` call: a server backgrounded in one call does not survive to the next. Record the start command.
|
|
15
|
+
|
|
16
|
+
## Drive the browser
|
|
17
|
+
|
|
18
|
+
The \`agent-browser\` CLI is always installed and is used below. If the operator enabled another engine (\`omowright\`, \`browser-use\`, \`browserskill\`), its skill is loaded and you may use it instead with the same loop. When TypeClaw's shared browser is running, agent-browser attaches to it automatically. The loop is observe → act → observe:
|
|
19
|
+
|
|
20
|
+
- \`agent-browser open <url>\` to load the page.
|
|
21
|
+
- \`agent-browser snapshot -i\` to get the interactive elements with \`@e\` refs; act on refs, not guessed selectors.
|
|
22
|
+
- \`agent-browser click @e3\`, \`agent-browser fill @e5 "text"\`, \`agent-browser press Enter\` to interact.
|
|
23
|
+
- \`agent-browser screenshot /tmp/qa/<run-id>/<scenario>-<step>.png\` after each meaningful step.
|
|
24
|
+
- Read console errors and failed requests after each flow; an uncaught exception or a 4xx/5xx on a load-bearing request is a finding even when the page looks fine.
|
|
25
|
+
- \`agent-browser close\` when done.
|
|
26
|
+
|
|
27
|
+
If the project already ships Playwright tests, running them is a check scenario, not a replacement for driving the flow yourself.
|
|
28
|
+
|
|
29
|
+
## What to cover
|
|
30
|
+
|
|
31
|
+
1. **Happy path** of every flow the request names, end to end, with the resulting state verified (the item appears in the list, the URL changes, the success message shows).
|
|
32
|
+
2. **A negative path**: empty or invalid form input, a missing resource, an unauthorized action. The UI must say what went wrong.
|
|
33
|
+
3. **Widths**: at least one desktop (about 1440 wide) and one phone-sized (about 390 wide) pass of the main screen. Clipped text, overlapping elements, or horizontal scroll of primary content are findings.
|
|
34
|
+
4. **Reload and back**: state that should persist survives a reload; the back button does not break the flow.
|
|
35
|
+
5. **Non-English text** when the product is used internationally: Korean or Japanese input renders and wraps without clipping.
|
|
36
|
+
|
|
37
|
+
## Evidence
|
|
38
|
+
|
|
39
|
+
Every scenario cites its screenshots and the console/network excerpt. Describe what each screenshot shows in \`<observed>\`; the parent may not be able to open images.
|
|
40
|
+
|
|
41
|
+
## Severity
|
|
42
|
+
|
|
43
|
+
- **blocker** — a named flow cannot complete, data is lost or wrong, an uncaught error breaks the page.
|
|
44
|
+
- **concern** — a negative path gives no feedback, layout breaks at one width, a console error that does not yet break the flow.
|
|
45
|
+
- **nit** — visual polish.
|
|
46
|
+
|
|
47
|
+
Return everything inside the \`<qa>\` block.
|
|
48
|
+
`,
|
|
49
|
+
}
|
|
@@ -141,6 +141,26 @@ function reportInternalGuardError(logger: PluginLogger, guard: string, error: un
|
|
|
141
141
|
logger.error(`internal security guard error guard=${guard}${code}: ${detail}`)
|
|
142
142
|
}
|
|
143
143
|
|
|
144
|
+
// The medium-tier heuristic guards (secretExfilBash/Read, ssrf,
|
|
145
|
+
// sessionSearchSecrets) cover non-canonical surfaces: canonical credential
|
|
146
|
+
// stores stay masked by the bash sandbox and privateSurfaceRead regardless.
|
|
147
|
+
// A bug in one of them must not deny every tool call it inspects, so its
|
|
148
|
+
// internal error is logged for the operator and only that check is skipped.
|
|
149
|
+
// Promotion, taint, private-surface, and high-tier checks keep failing closed
|
|
150
|
+
// through the hook-level catch.
|
|
151
|
+
function runHeuristicGuard(
|
|
152
|
+
logger: PluginLogger,
|
|
153
|
+
guard: string,
|
|
154
|
+
run: () => SecurityBlock | undefined,
|
|
155
|
+
): SecurityBlock | undefined {
|
|
156
|
+
try {
|
|
157
|
+
return run()
|
|
158
|
+
} catch (error) {
|
|
159
|
+
reportInternalGuardError(logger, guard, error)
|
|
160
|
+
return undefined
|
|
161
|
+
}
|
|
162
|
+
}
|
|
163
|
+
|
|
144
164
|
export default definePlugin({
|
|
145
165
|
permissions: Object.values(SECURITY_PERMISSIONS),
|
|
146
166
|
// No wildcard exclusions: owner bypasses every security tier by default
|
|
@@ -239,16 +259,15 @@ export default definePlugin({
|
|
|
239
259
|
)
|
|
240
260
|
if (gitRemoteTaintedResult) return gitRemoteTaintedResult
|
|
241
261
|
|
|
242
|
-
const secretExfilBashResult =
|
|
243
|
-
GUARD_SECRET_EXFIL_BASH_SEVERITY,
|
|
244
|
-
|
|
262
|
+
const secretExfilBashResult = runHeuristicGuard(ctx.logger, 'secretExfilBash', () =>
|
|
263
|
+
canBypass(GUARD_SECRET_EXFIL_BASH_SEVERITY, SECURITY_PERMISSIONS.bypassSecretExfilBash)
|
|
264
|
+
? undefined
|
|
265
|
+
: withPermissionHint(
|
|
266
|
+
checkSecretExfilBashGuard({ tool: event.tool, args: event.args }),
|
|
267
|
+
SECURITY_PERMISSIONS.bypassSecretExfilBash,
|
|
268
|
+
GUARD_SECRET_EXFIL_BASH_SEVERITY,
|
|
269
|
+
),
|
|
245
270
|
)
|
|
246
|
-
? undefined
|
|
247
|
-
: withPermissionHint(
|
|
248
|
-
checkSecretExfilBashGuard({ tool: event.tool, args: event.args }),
|
|
249
|
-
SECURITY_PERMISSIONS.bypassSecretExfilBash,
|
|
250
|
-
GUARD_SECRET_EXFIL_BASH_SEVERITY,
|
|
251
|
-
)
|
|
252
271
|
if (secretExfilBashResult) return secretExfilBashResult
|
|
253
272
|
|
|
254
273
|
const gitExfilResult = canBypass(GUARD_GIT_EXFIL_SEVERITY, SECURITY_PERMISSIONS.bypassGitExfil)
|
|
@@ -263,16 +282,15 @@ export default definePlugin({
|
|
|
263
282
|
if (pushGrant.kind !== 'allow') return withPushGrantHint(gitExfilResult, pushGrant)
|
|
264
283
|
}
|
|
265
284
|
|
|
266
|
-
const secretExfilReadResult =
|
|
267
|
-
GUARD_SECRET_EXFIL_READ_SEVERITY,
|
|
268
|
-
|
|
285
|
+
const secretExfilReadResult = runHeuristicGuard(ctx.logger, 'secretExfilRead', () =>
|
|
286
|
+
canBypass(GUARD_SECRET_EXFIL_READ_SEVERITY, SECURITY_PERMISSIONS.bypassSecretExfilRead)
|
|
287
|
+
? undefined
|
|
288
|
+
: withPermissionHint(
|
|
289
|
+
checkSecretExfilReadGuard({ tool: event.tool, args: event.args }),
|
|
290
|
+
SECURITY_PERMISSIONS.bypassSecretExfilRead,
|
|
291
|
+
GUARD_SECRET_EXFIL_READ_SEVERITY,
|
|
292
|
+
),
|
|
269
293
|
)
|
|
270
|
-
? undefined
|
|
271
|
-
: withPermissionHint(
|
|
272
|
-
checkSecretExfilReadGuard({ tool: event.tool, args: event.args }),
|
|
273
|
-
SECURITY_PERMISSIONS.bypassSecretExfilRead,
|
|
274
|
-
GUARD_SECRET_EXFIL_READ_SEVERITY,
|
|
275
|
-
)
|
|
276
294
|
if (secretExfilReadResult) return secretExfilReadResult
|
|
277
295
|
|
|
278
296
|
// Not severity-bypassed: private directories remain role-derived,
|
|
@@ -293,25 +311,26 @@ export default definePlugin({
|
|
|
293
311
|
)
|
|
294
312
|
if (privateSurfaceReadResult) return privateSurfaceReadResult
|
|
295
313
|
|
|
296
|
-
const ssrfResult =
|
|
297
|
-
|
|
298
|
-
|
|
299
|
-
|
|
300
|
-
|
|
301
|
-
|
|
302
|
-
|
|
314
|
+
const ssrfResult = runHeuristicGuard(ctx.logger, 'ssrf', () =>
|
|
315
|
+
canBypass(GUARD_SSRF_SEVERITY, SECURITY_PERMISSIONS.bypassSsrf)
|
|
316
|
+
? undefined
|
|
317
|
+
: withPermissionHint(
|
|
318
|
+
checkSsrfGuard({ tool: event.tool, args: event.args }),
|
|
319
|
+
SECURITY_PERMISSIONS.bypassSsrf,
|
|
320
|
+
GUARD_SSRF_SEVERITY,
|
|
321
|
+
),
|
|
322
|
+
)
|
|
303
323
|
if (ssrfResult) return ssrfResult
|
|
304
324
|
|
|
305
|
-
const sessionSearchSecretsResult =
|
|
306
|
-
GUARD_SESSION_SEARCH_SECRETS_SEVERITY,
|
|
307
|
-
|
|
325
|
+
const sessionSearchSecretsResult = runHeuristicGuard(ctx.logger, 'sessionSearchSecrets', () =>
|
|
326
|
+
canBypass(GUARD_SESSION_SEARCH_SECRETS_SEVERITY, SECURITY_PERMISSIONS.bypassSessionSearchSecrets)
|
|
327
|
+
? undefined
|
|
328
|
+
: withPermissionHint(
|
|
329
|
+
checkSessionSearchSecretsGuard({ tool: event.tool, args: event.args }),
|
|
330
|
+
SECURITY_PERMISSIONS.bypassSessionSearchSecrets,
|
|
331
|
+
GUARD_SESSION_SEARCH_SECRETS_SEVERITY,
|
|
332
|
+
),
|
|
308
333
|
)
|
|
309
|
-
? undefined
|
|
310
|
-
: withPermissionHint(
|
|
311
|
-
checkSessionSearchSecretsGuard({ tool: event.tool, args: event.args }),
|
|
312
|
-
SECURITY_PERMISSIONS.bypassSessionSearchSecrets,
|
|
313
|
-
GUARD_SESSION_SEARCH_SECRETS_SEVERITY,
|
|
314
|
-
)
|
|
315
334
|
if (sessionSearchSecretsResult) return sessionSearchSecretsResult
|
|
316
335
|
|
|
317
336
|
const systemPromptLeakResult = canBypass(
|
|
@@ -0,0 +1,13 @@
|
|
|
1
|
+
import type { AdapterId } from './schema'
|
|
2
|
+
|
|
3
|
+
// Only these account modes share platform user IDs. New/unlisted adapters
|
|
4
|
+
// retain their own namespace rather than accidentally linking identities.
|
|
5
|
+
const SHARED_NAMESPACES: Partial<Record<AdapterId, AdapterId>> = {
|
|
6
|
+
'discord-bot': 'discord',
|
|
7
|
+
'slack-bot': 'slack',
|
|
8
|
+
'webex-bot': 'webex',
|
|
9
|
+
}
|
|
10
|
+
|
|
11
|
+
export function adapterNamespace(adapter: AdapterId): AdapterId {
|
|
12
|
+
return SHARED_NAMESPACES[adapter] ?? adapter
|
|
13
|
+
}
|
|
@@ -15,6 +15,7 @@ import {
|
|
|
15
15
|
enrichHistoricalProvenance,
|
|
16
16
|
type HistoricalProvenanceResolver,
|
|
17
17
|
} from '@/bundled-plugins/memory/provenance-index'
|
|
18
|
+
import { CATCH_UP_CONVERSATION_LIMIT, type ListMissedInbound, type MissedInbound } from '@/channels/catch-up'
|
|
18
19
|
import {
|
|
19
20
|
DEFAULT_ATTACHMENT_MAX_BYTES,
|
|
20
21
|
readAttachmentErrorSnippet,
|
|
@@ -31,6 +32,7 @@ import type { ChannelRouter } from '@/channels/router'
|
|
|
31
32
|
import type { ChannelAdapterConfig } from '@/channels/schema'
|
|
32
33
|
import type {
|
|
33
34
|
ChannelHistoryMessage,
|
|
35
|
+
ChannelKey,
|
|
34
36
|
ChannelListEntry,
|
|
35
37
|
ChannelSelfIdentityResolver,
|
|
36
38
|
FetchAttachmentCallback,
|
|
@@ -548,6 +550,8 @@ type DiscordRawHistoryMessage = {
|
|
|
548
550
|
content: string
|
|
549
551
|
timestamp: string
|
|
550
552
|
mentions?: DiscordMentionUser[]
|
|
553
|
+
mention_everyone?: boolean
|
|
554
|
+
mention_roles?: string[]
|
|
551
555
|
message_reference?: { message_id?: string; channel_id?: string }
|
|
552
556
|
attachments?: DiscordFile[]
|
|
553
557
|
embeds?: DiscordGatewayEmbed[]
|
|
@@ -582,10 +586,7 @@ export function createDiscordHistoryCallback(deps: {
|
|
|
582
586
|
let raw: DiscordRawHistoryMessage[]
|
|
583
587
|
let response: Response
|
|
584
588
|
try {
|
|
585
|
-
response = await fetchFn
|
|
586
|
-
method: 'GET',
|
|
587
|
-
headers: { Authorization: `Bot ${token}` },
|
|
588
|
-
})
|
|
589
|
+
response = await fetchDiscordHistoryPage(token, fetchFn, channelId, params)
|
|
589
590
|
} catch (err) {
|
|
590
591
|
const message = describeError(err)
|
|
591
592
|
logger.warn(`[discord-bot] history fetch failed: ${message}`)
|
|
@@ -617,6 +618,79 @@ export function createDiscordHistoryCallback(deps: {
|
|
|
617
618
|
}
|
|
618
619
|
}
|
|
619
620
|
|
|
621
|
+
function fetchDiscordHistoryPage(token: string, fetchFn: typeof fetch, channelId: string, params: URLSearchParams) {
|
|
622
|
+
return fetchFn(`${DISCORD_API_BASE}/channels/${channelId}/messages?${params.toString()}`, {
|
|
623
|
+
method: 'GET',
|
|
624
|
+
headers: { Authorization: `Bot ${token}` },
|
|
625
|
+
})
|
|
626
|
+
}
|
|
627
|
+
|
|
628
|
+
export function createDiscordMissedInboundCallback(deps: {
|
|
629
|
+
token: string
|
|
630
|
+
logger: DiscordBotAdapterLogger
|
|
631
|
+
configRef: () => ChannelAdapterConfig
|
|
632
|
+
botUserIdRef: () => string | null
|
|
633
|
+
targets: () => Promise<readonly ChannelKey[]>
|
|
634
|
+
room: (chat: string) => Promise<import('@/channels/types').InboundMessage['room']>
|
|
635
|
+
fetchImpl?: typeof fetch
|
|
636
|
+
}): ListMissedInbound {
|
|
637
|
+
const fetchFn = deps.fetchImpl ?? fetch
|
|
638
|
+
return async (since) => {
|
|
639
|
+
const botUserId = deps.botUserIdRef()
|
|
640
|
+
if (botUserId === null) return []
|
|
641
|
+
const result: MissedInbound[] = []
|
|
642
|
+
const targets = new Map((await deps.targets()).map((key) => [key.chat, key]))
|
|
643
|
+
// Only previously watched conversations: never enumerate every guild
|
|
644
|
+
// channel the token happens to be able to read. Threads are channels too.
|
|
645
|
+
for (const key of [...targets.values()].slice(0, CATCH_UP_CONVERSATION_LIMIT)) {
|
|
646
|
+
const response = await fetchDiscordHistoryPage(
|
|
647
|
+
deps.token,
|
|
648
|
+
fetchFn,
|
|
649
|
+
key.chat,
|
|
650
|
+
new URLSearchParams({ limit: '100' }),
|
|
651
|
+
)
|
|
652
|
+
if (!response.ok) {
|
|
653
|
+
deps.logger.warn(`[discord-bot] catch-up history ${key.chat} failed: http ${response.status}`)
|
|
654
|
+
if (response.status === 403 || response.status === 404) continue
|
|
655
|
+
throw new Error(`Discord catch-up history http ${response.status}`)
|
|
656
|
+
}
|
|
657
|
+
const rows = (await response.json()) as DiscordRawHistoryMessage[]
|
|
658
|
+
const latestTs = Math.max(0, ...rows.map((row) => Date.parse(row.timestamp)).filter(Number.isFinite))
|
|
659
|
+
const room = key.workspace === '@dm' ? undefined : await deps.room(key.chat)
|
|
660
|
+
for (const row of rows) {
|
|
661
|
+
if (Date.parse(row.timestamp) < since) continue
|
|
662
|
+
const verdict = classifyInbound(
|
|
663
|
+
{
|
|
664
|
+
...row,
|
|
665
|
+
type: 'MESSAGE_CREATE',
|
|
666
|
+
...(key.workspace === '@dm' ? {} : { guild_id: key.workspace }),
|
|
667
|
+
author: { ...row.author, username: row.author.username ?? row.author.id },
|
|
668
|
+
mentions: row.mentions?.map((user) => ({
|
|
669
|
+
id: user.id,
|
|
670
|
+
username: user.username ?? user.id,
|
|
671
|
+
global_name: user.global_name ?? undefined,
|
|
672
|
+
})),
|
|
673
|
+
},
|
|
674
|
+
deps.configRef(),
|
|
675
|
+
botUserId,
|
|
676
|
+
)
|
|
677
|
+
if (verdict.kind !== 'route') continue
|
|
678
|
+
result.push({
|
|
679
|
+
message: {
|
|
680
|
+
...verdict.payload,
|
|
681
|
+
room,
|
|
682
|
+
accountIdentity: `discord-bot:${botUserId}`,
|
|
683
|
+
eventKind: 'message',
|
|
684
|
+
revision: 'original',
|
|
685
|
+
},
|
|
686
|
+
latestTs,
|
|
687
|
+
})
|
|
688
|
+
}
|
|
689
|
+
}
|
|
690
|
+
return result.sort((a, b) => a.message.ts - b.message.ts)
|
|
691
|
+
}
|
|
692
|
+
}
|
|
693
|
+
|
|
620
694
|
// Fetch one message via GET /channels/{id}/messages/{message_id}. Reuses
|
|
621
695
|
// mapDiscordMessage so a single message renders identically to a history entry.
|
|
622
696
|
// A 404 from Discord (deleted/unknown id) maps to a soft not-found.
|
|
@@ -1123,6 +1197,15 @@ export function createDiscordBotAdapter(options: DiscordBotAdapterOptions): Disc
|
|
|
1123
1197
|
})
|
|
1124
1198
|
|
|
1125
1199
|
const listCallback = createDiscordListCallback({ token: options.token, logger })
|
|
1200
|
+
const missedInbound = createDiscordMissedInboundCallback({
|
|
1201
|
+
token: options.token,
|
|
1202
|
+
logger,
|
|
1203
|
+
configRef: options.configRef,
|
|
1204
|
+
fetchImpl,
|
|
1205
|
+
botUserIdRef: () => botUserId,
|
|
1206
|
+
targets: () => options.router.catchUpTargets('discord-bot'),
|
|
1207
|
+
room: threadRoomResolver,
|
|
1208
|
+
})
|
|
1126
1209
|
|
|
1127
1210
|
const membershipResolver = createDiscordMembershipResolver({
|
|
1128
1211
|
token: options.token,
|
|
@@ -1264,6 +1347,7 @@ export function createDiscordBotAdapter(options: DiscordBotAdapterOptions): Disc
|
|
|
1264
1347
|
listener.on('connected', (info) => {
|
|
1265
1348
|
connected = true
|
|
1266
1349
|
botUserId = info.user.id
|
|
1350
|
+
if (started) void options.router.catchUp('discord-bot')
|
|
1267
1351
|
logger.info(`[discord-bot] connected as ${info.user.username} (${info.user.id})`)
|
|
1268
1352
|
// For bots, the gateway's user.id IS the application id — the same
|
|
1269
1353
|
// value is required for both /me lookups and /applications/{id}/
|
|
@@ -1295,6 +1379,7 @@ export function createDiscordBotAdapter(options: DiscordBotAdapterOptions): Disc
|
|
|
1295
1379
|
})
|
|
1296
1380
|
listener.on('disconnected', () => {
|
|
1297
1381
|
connected = false
|
|
1382
|
+
options.router.disconnectCatchUp('discord-bot')
|
|
1298
1383
|
logger.warn('[discord-bot] disconnected; SDK will reconnect with backoff')
|
|
1299
1384
|
})
|
|
1300
1385
|
listener.on('error', (err) => {
|
|
@@ -1302,7 +1387,10 @@ export function createDiscordBotAdapter(options: DiscordBotAdapterOptions): Disc
|
|
|
1302
1387
|
// when a terminal Gateway close stops the listener. Match that
|
|
1303
1388
|
// distinct SDK error contract without treating transient transport
|
|
1304
1389
|
// errors as disconnects.
|
|
1305
|
-
if (isTerminalGatewayClose(err))
|
|
1390
|
+
if (isTerminalGatewayClose(err)) {
|
|
1391
|
+
connected = false
|
|
1392
|
+
options.router.disconnectCatchUp('discord-bot')
|
|
1393
|
+
}
|
|
1306
1394
|
logger.error(`[discord-bot] gateway error: ${describeError(err)}`)
|
|
1307
1395
|
})
|
|
1308
1396
|
listener.on('message_create', (event) => {
|
|
@@ -1323,6 +1411,7 @@ export function createDiscordBotAdapter(options: DiscordBotAdapterOptions): Disc
|
|
|
1323
1411
|
options.router.registerChannelNameResolver('discord-bot', channelResolver)
|
|
1324
1412
|
options.router.registerSelfIdentity('discord-bot', selfIdentityResolver)
|
|
1325
1413
|
options.router.registerHistory('discord-bot', historyCallback)
|
|
1414
|
+
options.router.registerMissedInbound('discord-bot', missedInbound)
|
|
1326
1415
|
options.router.registerMessageGet('discord-bot', messageGetCallback)
|
|
1327
1416
|
options.router.registerList('discord-bot', listCallback)
|
|
1328
1417
|
options.router.registerEditMessage('discord-bot', editMessageCallback)
|
|
@@ -1347,6 +1436,7 @@ export function createDiscordBotAdapter(options: DiscordBotAdapterOptions): Disc
|
|
|
1347
1436
|
options.router.unregisterChannelNameResolver('discord-bot', channelResolver)
|
|
1348
1437
|
options.router.unregisterSelfIdentity('discord-bot', selfIdentityResolver)
|
|
1349
1438
|
options.router.unregisterHistory('discord-bot', historyCallback)
|
|
1439
|
+
options.router.unregisterMissedInbound('discord-bot', missedInbound)
|
|
1350
1440
|
options.router.unregisterMessageGet('discord-bot', messageGetCallback)
|
|
1351
1441
|
options.router.unregisterList('discord-bot', listCallback)
|
|
1352
1442
|
options.router.unregisterEditMessage('discord-bot', editMessageCallback)
|
|
@@ -1405,6 +1495,7 @@ export function createDiscordBotAdapter(options: DiscordBotAdapterOptions): Disc
|
|
|
1405
1495
|
async stop(): Promise<void> {
|
|
1406
1496
|
if (!started) return
|
|
1407
1497
|
started = false
|
|
1498
|
+
options.router.disconnectCatchUp('discord-bot')
|
|
1408
1499
|
options.router.unregisterOutbound('discord-bot', outboundCallback)
|
|
1409
1500
|
options.router.unregisterReaction('discord-bot', reactionCallback)
|
|
1410
1501
|
options.router.unregisterRemoveReaction('discord-bot', removeReactionCallback)
|
|
@@ -1415,6 +1506,7 @@ export function createDiscordBotAdapter(options: DiscordBotAdapterOptions): Disc
|
|
|
1415
1506
|
options.router.unregisterChannelNameResolver('discord-bot', channelResolver)
|
|
1416
1507
|
options.router.unregisterSelfIdentity('discord-bot', selfIdentityResolver)
|
|
1417
1508
|
options.router.unregisterHistory('discord-bot', historyCallback)
|
|
1509
|
+
options.router.unregisterMissedInbound('discord-bot', missedInbound)
|
|
1418
1510
|
options.router.unregisterRecoveryAdapter('discord-bot', recoveryCallbacks)
|
|
1419
1511
|
options.router.unregisterMessageGet('discord-bot', messageGetCallback)
|
|
1420
1512
|
options.router.unregisterList('discord-bot', listCallback)
|
|
@@ -427,6 +427,22 @@ export function createGithubAdapter(options: GithubAdapterOptions): GithubAdapte
|
|
|
427
427
|
}
|
|
428
428
|
tokenRefreshTimer = setIntervalFn(refresh, tokenRefreshIntervalMs)
|
|
429
429
|
}
|
|
430
|
+
// The channel PAT is the agent's own GitHub identity, so lend it to a git push
|
|
431
|
+
// for a configured repo instead of making the operator duplicate it in `.env`.
|
|
432
|
+
// repos[] is enforced here because this adapter owns it; the broker adds the
|
|
433
|
+
// role gate, so sandboxed roles still never receive the long-lived PAT.
|
|
434
|
+
if (options.githubTokenBridge !== undefined) {
|
|
435
|
+
unregisterTokenBridge = options.githubTokenBridge.registerPatResolver(async (repoSlug) => {
|
|
436
|
+
const allowed = new Set((options.configRef().repos ?? []).map(canonicalGithubRepo))
|
|
437
|
+
if (!allowed.has(canonicalGithubRepo(repoSlug))) {
|
|
438
|
+
throw new Error(
|
|
439
|
+
`repo \`${repoSlug}\` is not in this agent's configured \`channels.github.repos[]\`; ` +
|
|
440
|
+
'refusing to lend the GitHub channel PAT for it. Add it to `repos[]` if the agent is meant to push there.',
|
|
441
|
+
)
|
|
442
|
+
}
|
|
443
|
+
return { token: await auth.token() }
|
|
444
|
+
})
|
|
445
|
+
}
|
|
430
446
|
}
|
|
431
447
|
if (options.secrets.auth.type === 'app' && options.githubTokenBridge !== undefined) {
|
|
432
448
|
// Gate ad-hoc `gh` minting on the configured repos[]. The slug arrives
|
|
@@ -1,27 +1,15 @@
|
|
|
1
|
-
import {
|
|
2
|
-
import { join } from 'node:path'
|
|
1
|
+
import { readLastAlive, writeLastAlive } from '../../last-alive'
|
|
3
2
|
|
|
4
3
|
// When the GitHub adapter was last known alive. Reconcile replays only PRs
|
|
5
4
|
// opened since then: those are the deliveries a downtime or tunnel change could
|
|
6
5
|
// have dropped, while anything older was either seen live or predates the repo
|
|
7
6
|
// being watched.
|
|
8
7
|
|
|
9
|
-
const FILE = 'github-last-alive.json'
|
|
10
|
-
|
|
11
8
|
export async function readGithubLastAlive(agentDir: string): Promise<number | null> {
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
return typeof parsed.at === 'number' && Number.isFinite(parsed.at) ? parsed.at : null
|
|
15
|
-
} catch {
|
|
16
|
-
return null
|
|
17
|
-
}
|
|
9
|
+
// Preserve GitHub's best-effort boot behavior on an unreadable marker.
|
|
10
|
+
return readLastAlive(agentDir, 'github').catch(() => null)
|
|
18
11
|
}
|
|
19
12
|
|
|
20
13
|
export async function writeGithubLastAlive(agentDir: string, at: number): Promise<void> {
|
|
21
|
-
|
|
22
|
-
await mkdir(dir, { recursive: true })
|
|
23
|
-
const path = join(dir, FILE)
|
|
24
|
-
const tmp = `${path}.${process.pid}.tmp`
|
|
25
|
-
await writeFile(tmp, JSON.stringify({ at }))
|
|
26
|
-
await rename(tmp, path)
|
|
14
|
+
return writeLastAlive(agentDir, 'github', at)
|
|
27
15
|
}
|
|
@@ -51,11 +51,22 @@ export async function downloadSlackAttachment(options: {
|
|
|
51
51
|
throw new Error(`Slack attachment download failed (${response.status})${snippet === '' ? '' : `: ${snippet}`}`)
|
|
52
52
|
}
|
|
53
53
|
const contentType = response.headers.get('content-type')?.toLocaleLowerCase() ?? ''
|
|
54
|
-
|
|
54
|
+
const htmlResponse = contentType.includes('text/html') || contentType.includes('application/xhtml+xml')
|
|
55
|
+
const expectedHtml =
|
|
56
|
+
options.metadata.mimetype === 'text/html' || options.metadata.mimetype === 'application/xhtml+xml'
|
|
57
|
+
if (htmlResponse && !expectedHtml) {
|
|
55
58
|
await discardAttachmentResponse(response)
|
|
56
|
-
throw new Error('Slack attachment download returned
|
|
59
|
+
throw new Error('Slack attachment download returned HTML instead of the declared file type')
|
|
57
60
|
}
|
|
58
|
-
|
|
61
|
+
const buffer = await readAttachmentResponse(response, options.maxBytes)
|
|
62
|
+
// HTML is a legitimate email/file type. Detect the authentication protocol,
|
|
63
|
+
// not human-language words (an email may itself discuss signing in).
|
|
64
|
+
if (
|
|
65
|
+
expectedHtml &&
|
|
66
|
+
/<form\b[^>]*\baction\s*=\s*["'][^"']*\/(?:signin|login)(?:[/?#"'])/i.test(buffer.toString('utf8'))
|
|
67
|
+
)
|
|
68
|
+
throw new Error('Slack attachment download returned an HTML login response')
|
|
69
|
+
return { buffer, url }
|
|
59
70
|
}
|
|
60
71
|
}
|
|
61
72
|
|
|
@@ -3,6 +3,7 @@ const DEFAULT_TTL_MS = 60 * 60 * 1000
|
|
|
3
3
|
|
|
4
4
|
export type SlackAuthorResolverOptions = {
|
|
5
5
|
token: string
|
|
6
|
+
fetchImpl?: typeof fetch
|
|
6
7
|
now?: () => number
|
|
7
8
|
ttlMs?: number
|
|
8
9
|
}
|
|
@@ -39,7 +40,7 @@ export function createSlackAuthorResolver(options: SlackAuthorResolverOptions):
|
|
|
39
40
|
const existing = inflight.get(userId)
|
|
40
41
|
if (existing) return existing
|
|
41
42
|
|
|
42
|
-
const promise = fetchUserName(userId, options.token)
|
|
43
|
+
const promise = fetchUserName(userId, options.token, options.fetchImpl ?? fetch)
|
|
43
44
|
.then((name) => {
|
|
44
45
|
if (name !== userId) {
|
|
45
46
|
cache.set(userId, { name, expiresAt: now() + ttlMs })
|
|
@@ -57,9 +58,9 @@ export function createSlackAuthorResolver(options: SlackAuthorResolverOptions):
|
|
|
57
58
|
return { resolve }
|
|
58
59
|
}
|
|
59
60
|
|
|
60
|
-
async function fetchUserName(userId: string, token: string): Promise<string> {
|
|
61
|
+
async function fetchUserName(userId: string, token: string, fetchImpl: typeof fetch): Promise<string> {
|
|
61
62
|
try {
|
|
62
|
-
const response = await
|
|
63
|
+
const response = await fetchImpl(`${SLACK_API_BASE}/users.info?user=${encodeURIComponent(userId)}`, {
|
|
63
64
|
headers: { Authorization: `Bearer ${token}` },
|
|
64
65
|
})
|
|
65
66
|
if (!response.ok) return userId
|
|
@@ -5,6 +5,7 @@ const DEFAULT_TTL_MS = 24 * 60 * 60 * 1000
|
|
|
5
5
|
|
|
6
6
|
export type SlackChannelResolverOptions = {
|
|
7
7
|
token: string
|
|
8
|
+
fetchImpl?: typeof fetch
|
|
8
9
|
now?: () => number
|
|
9
10
|
ttlMs?: number
|
|
10
11
|
}
|
|
@@ -44,8 +45,10 @@ export function createSlackChannelResolver(options: SlackChannelResolverOptions)
|
|
|
44
45
|
if (key.workspace === '@dm') return {}
|
|
45
46
|
|
|
46
47
|
const [chatName, workspaceName] = await Promise.all([
|
|
47
|
-
fetchCached(chatCache, key.chat, () => fetchChannelName(key.chat, options.token)),
|
|
48
|
-
fetchCached(teamCache, key.workspace, () =>
|
|
48
|
+
fetchCached(chatCache, key.chat, () => fetchChannelName(key.chat, options.token, options.fetchImpl ?? fetch)),
|
|
49
|
+
fetchCached(teamCache, key.workspace, () =>
|
|
50
|
+
fetchTeamName(key.workspace, options.token, options.fetchImpl ?? fetch),
|
|
51
|
+
),
|
|
49
52
|
])
|
|
50
53
|
|
|
51
54
|
const result: ResolvedChannelNames = {}
|
|
@@ -55,9 +58,9 @@ export function createSlackChannelResolver(options: SlackChannelResolverOptions)
|
|
|
55
58
|
}
|
|
56
59
|
}
|
|
57
60
|
|
|
58
|
-
async function fetchChannelName(channelId: string, token: string): Promise<string | null> {
|
|
61
|
+
async function fetchChannelName(channelId: string, token: string, fetchImpl: typeof fetch): Promise<string | null> {
|
|
59
62
|
try {
|
|
60
|
-
const response = await
|
|
63
|
+
const response = await fetchImpl(`${SLACK_API_BASE}/conversations.info?channel=${encodeURIComponent(channelId)}`, {
|
|
61
64
|
headers: { Authorization: `Bearer ${token}` },
|
|
62
65
|
})
|
|
63
66
|
if (!response.ok) return null
|
|
@@ -69,9 +72,9 @@ async function fetchChannelName(channelId: string, token: string): Promise<strin
|
|
|
69
72
|
}
|
|
70
73
|
}
|
|
71
74
|
|
|
72
|
-
async function fetchTeamName(teamId: string, token: string): Promise<string | null> {
|
|
75
|
+
async function fetchTeamName(teamId: string, token: string, fetchImpl: typeof fetch): Promise<string | null> {
|
|
73
76
|
try {
|
|
74
|
-
const response = await
|
|
77
|
+
const response = await fetchImpl(`${SLACK_API_BASE}/team.info?team=${encodeURIComponent(teamId)}`, {
|
|
75
78
|
headers: { Authorization: `Bearer ${token}` },
|
|
76
79
|
})
|
|
77
80
|
if (!response.ok) return null
|
|
@@ -221,6 +221,7 @@ export function describeSlackFile(file: SlackFile, id: number): InboundAttachmen
|
|
|
221
221
|
|
|
222
222
|
export function renderPlaceholder(attachment: InboundAttachment): string {
|
|
223
223
|
const parts: string[] = [`Slack attachment #${attachment.id}: ${attachment.kind}`]
|
|
224
|
+
parts.push(`file_id=${attachment.ref}`)
|
|
224
225
|
if (attachment.mimetype !== undefined) parts.push(attachment.mimetype)
|
|
225
226
|
if (attachment.filename !== undefined) parts.push(`name=${attachment.filename}`)
|
|
226
227
|
return `[${parts.join(' ')}]`
|
|
@@ -154,6 +154,8 @@ export function commandResultReply(result: ExecuteCommandResult): string {
|
|
|
154
154
|
// visible only to the invoker (vs. 'in_channel' which posts to everyone).
|
|
155
155
|
// Control gestures should stay ephemeral — same rationale as Discord's
|
|
156
156
|
// EPHEMERAL flag on interaction callbacks.
|
|
157
|
-
export
|
|
157
|
+
export type SlashAckPayload = { response_type: 'ephemeral'; text: string }
|
|
158
|
+
|
|
159
|
+
export function buildSlashAckPayload(text: string): SlashAckPayload {
|
|
158
160
|
return { response_type: 'ephemeral', text }
|
|
159
161
|
}
|