@openparachute/agent 0.1.1 → 0.2.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/.parachute/module.json +124 -8
- package/LICENSE +2 -16
- package/README.md +118 -166
- package/package.json +32 -43
- package/scripts/spawn-agent.ts +371 -0
- package/src/_parked/interactive-spawn.test.ts +324 -0
- package/src/_parked/interactive-spawn.ts +701 -0
- package/src/agent-defs.test.ts +1504 -0
- package/src/agent-defs.ts +1702 -0
- package/src/agent-mcp-config.test.ts +115 -0
- package/src/agent-mcp-config.ts +115 -0
- package/src/agents.test.ts +360 -0
- package/src/agents.ts +379 -0
- package/src/auth.test.ts +46 -0
- package/src/auth.ts +140 -0
- package/src/backends/attached-queue.test.ts +376 -0
- package/src/backends/attached-queue.ts +372 -0
- package/src/backends/programmatic.test.ts +1715 -0
- package/src/backends/programmatic.ts +927 -0
- package/src/backends/registry.test.ts +1494 -0
- package/src/backends/registry.ts +1202 -0
- package/src/backends/stream-json.test.ts +570 -0
- package/src/backends/stream-json.ts +392 -0
- package/src/backends/types.ts +223 -0
- package/src/bridge.ts +417 -0
- package/src/channel-backend-wiring.test.ts +237 -0
- package/src/credentials.test.ts +274 -0
- package/src/credentials.ts +380 -0
- package/src/cron.test.ts +342 -0
- package/src/cron.ts +380 -0
- package/src/daemon-agent-def-api.test.ts +166 -0
- package/src/daemon-agent-defs-api.test.ts +953 -0
- package/src/daemon-agent-env-api.test.ts +338 -0
- package/src/daemon-attached-queue-store.test.ts +65 -0
- package/src/daemon-config-api.test.ts +962 -0
- package/src/daemon-jobs-api.test.ts +271 -0
- package/src/daemon-vault-chat.test.ts +250 -0
- package/src/daemon.test.ts +746 -0
- package/src/daemon.ts +3314 -0
- package/src/def-vaults.test.ts +136 -0
- package/src/def-vaults.ts +165 -0
- package/src/delivery-state.test.ts +110 -0
- package/src/delivery-state.ts +154 -0
- package/src/effective-env.test.ts +114 -0
- package/src/effective-env.ts +184 -0
- package/src/env-compat.ts +39 -0
- package/src/grants.test.ts +638 -0
- package/src/grants.ts +675 -0
- package/src/hub-jwt.test.ts +161 -0
- package/src/hub-jwt.ts +182 -0
- package/src/jobs.test.ts +245 -0
- package/src/jobs.ts +266 -0
- package/src/mcp-http.test.ts +265 -0
- package/src/mcp-http.ts +771 -0
- package/src/mint-token.test.ts +152 -0
- package/src/mint-token.ts +139 -0
- package/src/module-manifest.test.ts +158 -0
- package/src/oauth-discovery.ts +134 -0
- package/src/programmatic-wiring.test.ts +838 -0
- package/src/registry.test.ts +227 -0
- package/src/registry.ts +228 -0
- package/src/resolve-port.test.ts +64 -0
- package/src/routing.test.ts +184 -0
- package/src/routing.ts +76 -0
- package/src/runner.test.ts +506 -0
- package/src/runner.ts +255 -0
- package/src/sandbox/config.test.ts +150 -0
- package/src/sandbox/config.ts +102 -0
- package/src/sandbox/egress.test.ts +113 -0
- package/src/sandbox/egress.ts +123 -0
- package/src/sandbox/index.ts +180 -0
- package/src/sandbox/live-seatbelt.test.ts +277 -0
- package/src/sandbox/mounts.test.ts +154 -0
- package/src/sandbox/mounts.ts +133 -0
- package/src/sandbox/sandbox.test.ts +168 -0
- package/src/sandbox/types.ts +382 -0
- package/src/services-manifest.test.ts +106 -0
- package/src/services-manifest.ts +95 -0
- package/src/spa-serve.test.ts +116 -0
- package/src/spa-serve.ts +116 -0
- package/src/spawn-agent-cli.test.ts +172 -0
- package/src/spawn-agent.test.ts +1218 -0
- package/src/spawn-agent.ts +569 -0
- package/src/spawn-deps.test.ts +54 -0
- package/src/spawn-deps.ts +166 -0
- package/src/telegram/api.ts +153 -0
- package/src/terminal-assets.test.ts +50 -0
- package/src/terminal-assets.ts +79 -0
- package/src/terminal-ui.ts +305 -0
- package/src/terminal.test.ts +530 -0
- package/src/terminal.ts +458 -0
- package/src/transport.ts +270 -0
- package/src/transports/http-ui.test.ts +455 -0
- package/src/transports/http-ui.ts +201 -0
- package/src/transports/telegram.test.ts +174 -0
- package/src/transports/telegram.ts +426 -0
- package/src/transports/vault.test.ts +2011 -0
- package/src/transports/vault.ts +1790 -0
- package/src/ui-kit.test.ts +178 -0
- package/src/ui-kit.ts +402 -0
- package/tsconfig.json +8 -14
- package/web/ui/tsconfig.json +2 -1
- package/.claude/scheduled_tasks.lock +0 -1
- package/.claude/settings.json +0 -5
- package/.claude/skills/add-atomic-chat-tool/SKILL.md +0 -243
- package/.claude/skills/add-atomic-chat-tool/atomic-chat-mcp-stdio.ts +0 -229
- package/.claude/skills/add-codex/SKILL.md +0 -161
- package/.claude/skills/add-dashboard/SKILL.md +0 -138
- package/.claude/skills/add-dashboard/resources/dashboard-pusher.ts +0 -495
- package/.claude/skills/add-emacs/SKILL.md +0 -296
- package/.claude/skills/add-gcal-tool/SKILL.md +0 -210
- package/.claude/skills/add-gchat/REMOVE.md +0 -6
- package/.claude/skills/add-gchat/SKILL.md +0 -92
- package/.claude/skills/add-gchat/VERIFY.md +0 -3
- package/.claude/skills/add-github/REMOVE.md +0 -6
- package/.claude/skills/add-github/SKILL.md +0 -148
- package/.claude/skills/add-github/VERIFY.md +0 -3
- package/.claude/skills/add-gmail-tool/SKILL.md +0 -229
- package/.claude/skills/add-imessage/REMOVE.md +0 -6
- package/.claude/skills/add-imessage/SKILL.md +0 -113
- package/.claude/skills/add-imessage/VERIFY.md +0 -3
- package/.claude/skills/add-karpathy-llm-wiki/SKILL.md +0 -110
- package/.claude/skills/add-karpathy-llm-wiki/llm-wiki.md +0 -75
- package/.claude/skills/add-linear/REMOVE.md +0 -6
- package/.claude/skills/add-linear/SKILL.md +0 -168
- package/.claude/skills/add-linear/VERIFY.md +0 -3
- package/.claude/skills/add-macos-statusbar/SKILL.md +0 -133
- package/.claude/skills/add-macos-statusbar/add/src/statusbar.swift +0 -147
- package/.claude/skills/add-matrix/REMOVE.md +0 -6
- package/.claude/skills/add-matrix/SKILL.md +0 -148
- package/.claude/skills/add-matrix/VERIFY.md +0 -3
- package/.claude/skills/add-ollama-provider/SKILL.md +0 -179
- package/.claude/skills/add-ollama-tool/SKILL.md +0 -193
- package/.claude/skills/add-opencode/SKILL.md +0 -229
- package/.claude/skills/add-parallel/SKILL.md +0 -290
- package/.claude/skills/add-resend/REMOVE.md +0 -6
- package/.claude/skills/add-resend/SKILL.md +0 -93
- package/.claude/skills/add-resend/VERIFY.md +0 -3
- package/.claude/skills/add-signal/REMOVE.md +0 -13
- package/.claude/skills/add-signal/SKILL.md +0 -318
- package/.claude/skills/add-signal/VERIFY.md +0 -5
- package/.claude/skills/add-slack/REMOVE.md +0 -6
- package/.claude/skills/add-slack/SKILL.md +0 -112
- package/.claude/skills/add-slack/VERIFY.md +0 -3
- package/.claude/skills/add-teams/REMOVE.md +0 -6
- package/.claude/skills/add-teams/SKILL.md +0 -207
- package/.claude/skills/add-teams/VERIFY.md +0 -3
- package/.claude/skills/add-vercel/SKILL.md +0 -147
- package/.claude/skills/add-vercel/container-skills/vercel-cli/SKILL.md +0 -103
- package/.claude/skills/add-webex/REMOVE.md +0 -6
- package/.claude/skills/add-webex/SKILL.md +0 -88
- package/.claude/skills/add-webex/VERIFY.md +0 -3
- package/.claude/skills/add-wechat/REMOVE.md +0 -49
- package/.claude/skills/add-wechat/SKILL.md +0 -170
- package/.claude/skills/add-wechat/scripts/wire-dm.ts +0 -172
- package/.claude/skills/add-whatsapp/SKILL.md +0 -264
- package/.claude/skills/add-whatsapp-cloud/REMOVE.md +0 -6
- package/.claude/skills/add-whatsapp-cloud/SKILL.md +0 -95
- package/.claude/skills/add-whatsapp-cloud/VERIFY.md +0 -3
- package/.claude/skills/claw/SKILL.md +0 -131
- package/.claude/skills/claw/scripts/claw +0 -374
- package/.claude/skills/convert-to-apple-container/SKILL.md +0 -212
- package/.claude/skills/customize/SKILL.md +0 -110
- package/.claude/skills/debug/SKILL.md +0 -349
- package/.claude/skills/get-qodo-rules/SKILL.md +0 -122
- package/.claude/skills/get-qodo-rules/references/output-format.md +0 -41
- package/.claude/skills/get-qodo-rules/references/pagination.md +0 -33
- package/.claude/skills/get-qodo-rules/references/repository-scope.md +0 -26
- package/.claude/skills/init-first-agent/SKILL.md +0 -120
- package/.claude/skills/init-onecli/SKILL.md +0 -270
- package/.claude/skills/manage-channels/SKILL.md +0 -87
- package/.claude/skills/manage-mounts/SKILL.md +0 -47
- package/.claude/skills/migrate-from-openclaw/MIGRATE_CRONS.md +0 -100
- package/.claude/skills/migrate-from-openclaw/SKILL.md +0 -447
- package/.claude/skills/migrate-from-openclaw/scripts/discover-openclaw.ts +0 -734
- package/.claude/skills/migrate-from-openclaw/scripts/extract-channel-credentials.ts +0 -476
- package/.claude/skills/migrate-nanoclaw/SKILL.md +0 -484
- package/.claude/skills/migrate-nanoclaw/diagnostics.md +0 -51
- package/.claude/skills/qodo-pr-resolver/SKILL.md +0 -326
- package/.claude/skills/qodo-pr-resolver/resources/providers.md +0 -329
- package/.claude/skills/update-nanoclaw/SKILL.md +0 -243
- package/.claude/skills/update-nanoclaw/diagnostics.md +0 -48
- package/.claude/skills/update-skills/SKILL.md +0 -130
- package/.claude/skills/use-native-credential-proxy/SKILL.md +0 -167
- package/.claude/skills/x-integration/SKILL.md +0 -417
- package/.claude/skills/x-integration/agent.ts +0 -243
- package/.claude/skills/x-integration/host.ts +0 -155
- package/.claude/skills/x-integration/lib/browser.ts +0 -148
- package/.claude/skills/x-integration/lib/config.ts +0 -62
- package/.claude/skills/x-integration/scripts/like.ts +0 -56
- package/.claude/skills/x-integration/scripts/post.ts +0 -66
- package/.claude/skills/x-integration/scripts/quote.ts +0 -80
- package/.claude/skills/x-integration/scripts/reply.ts +0 -74
- package/.claude/skills/x-integration/scripts/retweet.ts +0 -62
- package/.claude/skills/x-integration/scripts/setup.ts +0 -87
- package/.github/CODEOWNERS +0 -10
- package/.github/PULL_REQUEST_TEMPLATE.md +0 -18
- package/.github/workflows/bump-version.yml +0 -35
- package/.github/workflows/ci.yml +0 -39
- package/.github/workflows/label-pr.yml +0 -40
- package/.github/workflows/update-tokens.yml +0 -43
- package/.husky/pre-commit +0 -1
- package/.mcp.json +0 -3
- package/.nvmrc +0 -1
- package/.prettierrc +0 -4
- package/CHANGELOG.md +0 -221
- package/CLAUDE.md +0 -307
- package/CODE_OF_CONDUCT.md +0 -128
- package/CONTRIBUTING.md +0 -159
- package/CONTRIBUTORS.md +0 -26
- package/LICENSE-NANOCLAW-MIT +0 -21
- package/README_ja.md +0 -194
- package/README_zh.md +0 -194
- package/assets/nanoclaw-favicon.png +0 -0
- package/assets/nanoclaw-icon.png +0 -0
- package/assets/nanoclaw-logo-dark.png +0 -0
- package/assets/nanoclaw-logo.png +0 -0
- package/assets/nanoclaw-profile.jpeg +0 -0
- package/assets/nanoclaw-sales.png +0 -0
- package/assets/social-preview.jpg +0 -0
- package/config-examples/mount-allowlist.json +0 -25
- package/container/.dockerignore +0 -2
- package/container/CLAUDE.md +0 -21
- package/container/Dockerfile +0 -121
- package/container/agent-runner/bun.lock +0 -243
- package/container/agent-runner/package.json +0 -22
- package/container/agent-runner/scripts/sdk-signal-probe.ts +0 -169
- package/container/agent-runner/src/config.ts +0 -55
- package/container/agent-runner/src/db/connection.ts +0 -267
- package/container/agent-runner/src/db/index.ts +0 -20
- package/container/agent-runner/src/db/messages-in.ts +0 -138
- package/container/agent-runner/src/db/messages-out.ts +0 -143
- package/container/agent-runner/src/db/session-routing.ts +0 -30
- package/container/agent-runner/src/db/session-state.test.ts +0 -100
- package/container/agent-runner/src/db/session-state.ts +0 -79
- package/container/agent-runner/src/destinations.ts +0 -135
- package/container/agent-runner/src/formatter.test.ts +0 -167
- package/container/agent-runner/src/formatter.ts +0 -260
- package/container/agent-runner/src/index.ts +0 -110
- package/container/agent-runner/src/integration.test.ts +0 -121
- package/container/agent-runner/src/mcp-tools/agents.instructions.md +0 -26
- package/container/agent-runner/src/mcp-tools/agents.ts +0 -66
- package/container/agent-runner/src/mcp-tools/core.instructions.md +0 -27
- package/container/agent-runner/src/mcp-tools/core.ts +0 -262
- package/container/agent-runner/src/mcp-tools/index.ts +0 -22
- package/container/agent-runner/src/mcp-tools/interactive.instructions.md +0 -22
- package/container/agent-runner/src/mcp-tools/interactive.ts +0 -169
- package/container/agent-runner/src/mcp-tools/scheduling.instructions.md +0 -40
- package/container/agent-runner/src/mcp-tools/scheduling.ts +0 -299
- package/container/agent-runner/src/mcp-tools/self-mod.instructions.md +0 -25
- package/container/agent-runner/src/mcp-tools/self-mod.ts +0 -120
- package/container/agent-runner/src/mcp-tools/server.ts +0 -54
- package/container/agent-runner/src/mcp-tools/types.ts +0 -6
- package/container/agent-runner/src/poll-loop.test.ts +0 -248
- package/container/agent-runner/src/poll-loop.ts +0 -437
- package/container/agent-runner/src/providers/claude.ts +0 -379
- package/container/agent-runner/src/providers/factory.test.ts +0 -19
- package/container/agent-runner/src/providers/factory.ts +0 -13
- package/container/agent-runner/src/providers/index.ts +0 -6
- package/container/agent-runner/src/providers/mock.ts +0 -77
- package/container/agent-runner/src/providers/provider-registry.ts +0 -33
- package/container/agent-runner/src/providers/types.ts +0 -82
- package/container/agent-runner/src/scheduling/task-script.ts +0 -121
- package/container/agent-runner/src/timezone.test.ts +0 -93
- package/container/agent-runner/src/timezone.ts +0 -107
- package/container/agent-runner/tsconfig.json +0 -14
- package/container/build.sh +0 -48
- package/container/entrypoint.sh +0 -16
- package/container/skills/agent-browser/SKILL.md +0 -159
- package/container/skills/frontend-engineer/SKILL.md +0 -157
- package/container/skills/self-customize/SKILL.md +0 -87
- package/container/skills/slack-formatting/SKILL.md +0 -94
- package/container/skills/vercel-cli/SKILL.md +0 -111
- package/container/skills/welcome/SKILL.md +0 -85
- package/docs/APPLE-CONTAINER-NETWORKING.md +0 -90
- package/docs/BRANCH-FORK-MAINTENANCE.md +0 -81
- package/docs/README.md +0 -25
- package/docs/SDK_DEEP_DIVE.md +0 -643
- package/docs/SECURITY.md +0 -162
- package/docs/agent-runner-details.md +0 -749
- package/docs/api-details.md +0 -365
- package/docs/architecture-diagram.html +0 -422
- package/docs/architecture-diagram.md +0 -215
- package/docs/architecture.md +0 -751
- package/docs/audit/2026-04-30-channel-endpoint-audit.md +0 -36
- package/docs/build-and-runtime.md +0 -80
- package/docs/cross-mount-stress/README.md +0 -112
- package/docs/cross-mount-stress/container-writer-retry.mjs +0 -55
- package/docs/cross-mount-stress/container-writer-slow.mjs +0 -42
- package/docs/cross-mount-stress/container-writer.mjs +0 -47
- package/docs/cross-mount-stress/host-writer-retry.mjs +0 -55
- package/docs/cross-mount-stress/host-writer-slow.mjs +0 -43
- package/docs/cross-mount-stress/host-writer.mjs +0 -47
- package/docs/db-central.md +0 -316
- package/docs/db-session.md +0 -183
- package/docs/db.md +0 -119
- package/docs/design/2026-04-29-vault-management-ui.md +0 -231
- package/docs/design/2026-04-30-channel-wiring-rework.md +0 -234
- package/docs/design/2026-05-01-channel-wiring-approvals-deep-dive.md +0 -272
- package/docs/design/2026-05-02-channel-policy-and-approval-routing.md +0 -250
- package/docs/docker-sandboxes.md +0 -359
- package/docs/isolation-model.md +0 -88
- package/docs/ollama.md +0 -79
- package/docs/parachute-integration.md +0 -109
- package/docs/post-night-rebirth-reflections.md +0 -151
- package/eslint.config.js +0 -32
- package/pnpm-workspace.yaml +0 -8
- package/repo-tokens/README.md +0 -113
- package/repo-tokens/action.yml +0 -186
- package/repo-tokens/badge.svg +0 -23
- package/repo-tokens/examples/green.svg +0 -14
- package/repo-tokens/examples/red.svg +0 -14
- package/repo-tokens/examples/yellow-green.svg +0 -14
- package/repo-tokens/examples/yellow.svg +0 -14
- package/scripts/chat.ts +0 -101
- package/scripts/cleanup-sessions.sh +0 -150
- package/scripts/init-cli-agent.ts +0 -171
- package/scripts/init-first-agent.ts +0 -377
- package/scripts/parachute.ts +0 -158
- package/scripts/run-migrations.ts +0 -105
- package/scripts/sanity-live-poll.ts +0 -95
- package/scripts/seed-discord.ts +0 -79
- package/scripts/test-v2-agent.ts +0 -106
- package/scripts/test-v2-channel-e2e.ts +0 -265
- package/scripts/test-v2-host.ts +0 -184
- package/src/channels/adapter.ts +0 -214
- package/src/channels/ask-question.ts +0 -46
- package/src/channels/channel-registry.test.ts +0 -421
- package/src/channels/channel-registry.ts +0 -313
- package/src/channels/chat-sdk-bridge.test.ts +0 -84
- package/src/channels/chat-sdk-bridge.ts +0 -652
- package/src/channels/cli.ts +0 -276
- package/src/channels/discord.ts +0 -90
- package/src/channels/index.ts +0 -17
- package/src/channels/telegram-markdown-sanitize.test.ts +0 -78
- package/src/channels/telegram-markdown-sanitize.ts +0 -55
- package/src/channels/telegram-pairing.test.ts +0 -254
- package/src/channels/telegram-pairing.ts +0 -339
- package/src/channels/telegram.ts +0 -279
- package/src/channels/trust-hint.test.ts +0 -48
- package/src/channels/trust-hint.ts +0 -75
- package/src/claude-md-compose.migrate.test.ts +0 -64
- package/src/claude-md-compose.ts +0 -205
- package/src/command-gate.ts +0 -63
- package/src/config.test.ts +0 -93
- package/src/config.ts +0 -108
- package/src/container-config.ts +0 -167
- package/src/container-runner.test.ts +0 -32
- package/src/container-runner.ts +0 -576
- package/src/container-runtime.test.ts +0 -169
- package/src/container-runtime.ts +0 -92
- package/src/db/_bun-sqlite-shim.ts +0 -88
- package/src/db/agent-activity.test.ts +0 -155
- package/src/db/agent-activity.ts +0 -121
- package/src/db/agent-groups.ts +0 -77
- package/src/db/connection.migrate.test.ts +0 -143
- package/src/db/connection.ts +0 -224
- package/src/db/db-v2.test.ts +0 -440
- package/src/db/dropped-messages.ts +0 -44
- package/src/db/index.ts +0 -40
- package/src/db/messaging-groups.ts +0 -252
- package/src/db/migrations/001-initial.ts +0 -112
- package/src/db/migrations/002-chat-sdk-state.ts +0 -36
- package/src/db/migrations/008-dropped-messages.ts +0 -27
- package/src/db/migrations/009-drop-pending-credentials.ts +0 -13
- package/src/db/migrations/010-engage-modes.ts +0 -103
- package/src/db/migrations/011-pending-sender-approvals.ts +0 -40
- package/src/db/migrations/012-channel-registration.ts +0 -48
- package/src/db/migrations/013-approval-render-metadata.ts +0 -27
- package/src/db/migrations/014-secrets.ts +0 -44
- package/src/db/migrations/015-secrets-drop-host-pattern.ts +0 -18
- package/src/db/migrations/016-secret-assignments.ts +0 -30
- package/src/db/migrations/017-agent-activity.ts +0 -40
- package/src/db/migrations/018-oauth-app-configs.ts +0 -34
- package/src/db/migrations/019-oauth-app-connections.ts +0 -48
- package/src/db/migrations/020-agent-app-connections.ts +0 -28
- package/src/db/migrations/021-pending-oauth-states.ts +0 -35
- package/src/db/migrations/022-app-connections-provider.ts +0 -25
- package/src/db/migrations/023-agent-group-secret-mode.test.ts +0 -124
- package/src/db/migrations/023-agent-group-secret-mode.ts +0 -65
- package/src/db/migrations/024-collapse-approvals.test.ts +0 -249
- package/src/db/migrations/024-collapse-approvals.ts +0 -182
- package/src/db/migrations/025-secret-mode-check.test.ts +0 -155
- package/src/db/migrations/025-secret-mode-check.ts +0 -49
- package/src/db/migrations/026-user-dms-bot-id.test.ts +0 -116
- package/src/db/migrations/026-user-dms-bot-id.ts +0 -54
- package/src/db/migrations/027-provider-credentials.ts +0 -41
- package/src/db/migrations/_test-helpers.ts +0 -41
- package/src/db/migrations/index.ts +0 -127
- package/src/db/migrations/module-agent-to-agent-destinations.ts +0 -84
- package/src/db/migrations/module-approvals-pending-approvals.ts +0 -42
- package/src/db/migrations/module-approvals-title-options.ts +0 -40
- package/src/db/schema.ts +0 -258
- package/src/db/session-db.test.ts +0 -93
- package/src/db/session-db.ts +0 -325
- package/src/db/sessions.ts +0 -241
- package/src/delivery.test.ts +0 -148
- package/src/delivery.ts +0 -445
- package/src/env.ts +0 -74
- package/src/group-folder.test.ts +0 -35
- package/src/group-folder.ts +0 -44
- package/src/group-init.ts +0 -92
- package/src/host-core.test.ts +0 -456
- package/src/host-sweep.test.ts +0 -146
- package/src/host-sweep.ts +0 -287
- package/src/index.ts +0 -227
- package/src/install-slug.ts +0 -33
- package/src/log.test.ts +0 -81
- package/src/log.ts +0 -117
- package/src/mcp/http.ts +0 -72
- package/src/mcp/server.ts +0 -92
- package/src/mcp/stdio.ts +0 -51
- package/src/mcp/tools/activity.ts +0 -88
- package/src/mcp/tools/agent-groups.ts +0 -183
- package/src/mcp/tools/approvals.ts +0 -122
- package/src/mcp/tools/channels.ts +0 -199
- package/src/mcp/tools/index.ts +0 -27
- package/src/mcp/tools/oauth.ts +0 -48
- package/src/mcp/tools/secrets.ts +0 -169
- package/src/mcp/tools/sessions.ts +0 -135
- package/src/mcp/types.ts +0 -51
- package/src/modules/agent-to-agent/agent-route.test.ts +0 -46
- package/src/modules/agent-to-agent/agent-route.ts +0 -223
- package/src/modules/agent-to-agent/create-agent.ts +0 -127
- package/src/modules/agent-to-agent/db/agent-destinations.ts +0 -135
- package/src/modules/agent-to-agent/index.ts +0 -22
- package/src/modules/agent-to-agent/write-destinations.ts +0 -59
- package/src/modules/approvals/agent.md +0 -45
- package/src/modules/approvals/index.ts +0 -21
- package/src/modules/approvals/picks.test.ts +0 -291
- package/src/modules/approvals/primitive.ts +0 -279
- package/src/modules/approvals/project.md +0 -27
- package/src/modules/approvals/response-handler.ts +0 -87
- package/src/modules/index.ts +0 -24
- package/src/modules/interactive/agent.md +0 -21
- package/src/modules/interactive/index.ts +0 -69
- package/src/modules/interactive/project.md +0 -12
- package/src/modules/mount-security/index.ts +0 -448
- package/src/modules/mount-security/migrate.test.ts +0 -91
- package/src/modules/permissions/access.ts +0 -28
- package/src/modules/permissions/channel-approval.test.ts +0 -389
- package/src/modules/permissions/channel-approval.ts +0 -188
- package/src/modules/permissions/db/agent-group-members.ts +0 -44
- package/src/modules/permissions/db/pending-channel-approvals.test.ts +0 -86
- package/src/modules/permissions/db/pending-channel-approvals.ts +0 -66
- package/src/modules/permissions/db/pending-sender-approvals.ts +0 -60
- package/src/modules/permissions/db/user-dms.ts +0 -58
- package/src/modules/permissions/db/user-roles.ts +0 -85
- package/src/modules/permissions/db/users.ts +0 -38
- package/src/modules/permissions/index.ts +0 -421
- package/src/modules/permissions/permissions.test.ts +0 -358
- package/src/modules/permissions/sender-approval.test.ts +0 -470
- package/src/modules/permissions/sender-approval.ts +0 -165
- package/src/modules/permissions/user-dm.ts +0 -200
- package/src/modules/provider-credentials/db.ts +0 -121
- package/src/modules/provider-credentials/index.ts +0 -12
- package/src/modules/provider-credentials/spawn.test.ts +0 -206
- package/src/modules/provider-credentials/spawn.ts +0 -114
- package/src/modules/scheduling/actions.ts +0 -113
- package/src/modules/scheduling/db.test.ts +0 -282
- package/src/modules/scheduling/db.ts +0 -148
- package/src/modules/scheduling/index.ts +0 -34
- package/src/modules/scheduling/recurrence.test.ts +0 -98
- package/src/modules/scheduling/recurrence.ts +0 -54
- package/src/modules/self-mod/agent.md +0 -30
- package/src/modules/self-mod/apply.ts +0 -85
- package/src/modules/self-mod/index.ts +0 -30
- package/src/modules/self-mod/project.md +0 -39
- package/src/modules/self-mod/request.ts +0 -91
- package/src/modules/typing/index.ts +0 -165
- package/src/oauth/agent-app-connections.ts +0 -103
- package/src/oauth/app-configs.test.ts +0 -64
- package/src/oauth/app-configs.ts +0 -114
- package/src/oauth/app-connections.test.ts +0 -109
- package/src/oauth/app-connections.ts +0 -178
- package/src/oauth/crypto.ts +0 -56
- package/src/oauth/flow.ts +0 -104
- package/src/oauth/providers/google.test.ts +0 -38
- package/src/oauth/providers/google.ts +0 -46
- package/src/oauth/providers/index.ts +0 -48
- package/src/oauth/state-store.test.ts +0 -54
- package/src/oauth/state-store.ts +0 -93
- package/src/parachute/README.md +0 -27
- package/src/parachute/create-agent.test.ts +0 -83
- package/src/parachute/create-agent.ts +0 -122
- package/src/parachute/group-status.test.ts +0 -165
- package/src/parachute/group-status.ts +0 -136
- package/src/parachute/types.ts +0 -41
- package/src/parachute/vault-mcp.test.ts +0 -251
- package/src/parachute/vault-mcp.ts +0 -232
- package/src/platform-id.test.ts +0 -104
- package/src/platform-id.ts +0 -109
- package/src/providers/index.ts +0 -6
- package/src/providers/provider-container-registry.ts +0 -58
- package/src/response-registry.ts +0 -45
- package/src/router.ts +0 -530
- package/src/secrets/crypto.test.ts +0 -45
- package/src/secrets/crypto.ts +0 -55
- package/src/secrets/index.ts +0 -355
- package/src/secrets/master-key.ts +0 -70
- package/src/secrets/secrets.test.ts +0 -354
- package/src/session-manager.migrate.test.ts +0 -59
- package/src/session-manager.ts +0 -433
- package/src/startup-bootstrap.test.ts +0 -226
- package/src/startup-bootstrap.ts +0 -207
- package/src/state-sqlite.ts +0 -182
- package/src/timezone.test.ts +0 -64
- package/src/timezone.ts +0 -37
- package/src/types.ts +0 -230
- package/src/web/auth.test.ts +0 -335
- package/src/web/auth.ts +0 -214
- package/src/web/discord-validate.test.ts +0 -77
- package/src/web/discord-validate.ts +0 -88
- package/src/web/hub-discovery.test.ts +0 -98
- package/src/web/hub-discovery.ts +0 -69
- package/src/web/routes/activity.ts +0 -106
- package/src/web/routes/agent-provider.test.ts +0 -282
- package/src/web/routes/agent-provider.ts +0 -309
- package/src/web/routes/approvals.ts +0 -185
- package/src/web/routes/apps.ts +0 -434
- package/src/web/routes/channels-mg-detail.test.ts +0 -324
- package/src/web/routes/channels-mga-detail.test.ts +0 -425
- package/src/web/routes/channels.ts +0 -489
- package/src/web/routes/oauth-providers.ts +0 -42
- package/src/web/routes/secrets.test.ts +0 -175
- package/src/web/routes/secrets.ts +0 -282
- package/src/web/routes/sessions.ts +0 -123
- package/src/web/routes/settings.test.ts +0 -106
- package/src/web/routes/settings.ts +0 -247
- package/src/web/routes/setup-status.ts +0 -205
- package/src/web/routes/vaults.test.ts +0 -389
- package/src/web/routes/vaults.ts +0 -225
- package/src/web/server-version.test.ts +0 -16
- package/src/web/server.ts +0 -1003
- package/src/web/services-manifest.test.ts +0 -120
- package/src/web/services-manifest.ts +0 -61
- package/src/web/static-serve.test.ts +0 -255
- package/src/web/static-serve.ts +0 -104
- package/src/web/telegram-validate.test.ts +0 -116
- package/src/web/telegram-validate.ts +0 -107
- package/src/web/vault-proxy.test.ts +0 -214
- package/src/web/vault-proxy.ts +0 -120
- package/src/web/wire-channel.ts +0 -181
- package/src/webhook-server.ts +0 -134
- package/vitest.config.ts +0 -18
- package/web/README.md +0 -63
- package/web/ui/index.html +0 -13
- package/web/ui/package.json +0 -35
- package/web/ui/pnpm-lock.yaml +0 -2164
- package/web/ui/scripts/verify-base.mjs +0 -31
- package/web/ui/src/App.tsx +0 -88
- package/web/ui/src/components/ActivityFeed.tsx +0 -444
- package/web/ui/src/components/AgentGroupPicker.tsx +0 -263
- package/web/ui/src/components/AgentProviderCards.tsx +0 -220
- package/web/ui/src/components/CredentialForm.tsx +0 -214
- package/web/ui/src/components/ScopeGrants.tsx +0 -74
- package/web/ui/src/components/StatusDot.tsx +0 -43
- package/web/ui/src/components/VaultPicker.tsx +0 -127
- package/web/ui/src/components/setup/AdapterInstallStep.tsx +0 -178
- package/web/ui/src/components/setup/AgentGroupStep.tsx +0 -43
- package/web/ui/src/components/setup/ChannelPickStep.tsx +0 -74
- package/web/ui/src/components/setup/DoneStep.tsx +0 -49
- package/web/ui/src/components/setup/PrereqStep.tsx +0 -129
- package/web/ui/src/components/setup/TestConnectionStep.tsx +0 -108
- package/web/ui/src/components/setup/TestMessageStep.tsx +0 -104
- package/web/ui/src/components/setup/WireChannelStep.tsx +0 -166
- package/web/ui/src/components/setup/types.ts +0 -105
- package/web/ui/src/lib/api.test.ts +0 -410
- package/web/ui/src/lib/api.ts +0 -1210
- package/web/ui/src/lib/auth.test.ts +0 -139
- package/web/ui/src/lib/auth.ts +0 -348
- package/web/ui/src/lib/channel-adapters.ts +0 -136
- package/web/ui/src/main.tsx +0 -19
- package/web/ui/src/routes/ApprovalsList.tsx +0 -294
- package/web/ui/src/routes/Apps.tsx +0 -613
- package/web/ui/src/routes/ChannelWireDetail.test.tsx +0 -233
- package/web/ui/src/routes/ChannelWireDetail.tsx +0 -403
- package/web/ui/src/routes/ChannelsList.tsx +0 -158
- package/web/ui/src/routes/GroupDetail.tsx +0 -755
- package/web/ui/src/routes/GroupList.tsx +0 -187
- package/web/ui/src/routes/MessagingGroupDetail.test.tsx +0 -233
- package/web/ui/src/routes/MessagingGroupDetail.tsx +0 -306
- package/web/ui/src/routes/NewGroupWizard.tsx +0 -390
- package/web/ui/src/routes/OAuthCallback.tsx +0 -56
- package/web/ui/src/routes/SecretsList.tsx +0 -921
- package/web/ui/src/routes/SessionsList.tsx +0 -220
- package/web/ui/src/routes/SettingsAgentProvider.tsx +0 -109
- package/web/ui/src/routes/SettingsApprovals.tsx +0 -234
- package/web/ui/src/routes/SetupWizard.tsx +0 -219
- package/web/ui/src/routes/VaultDetail.test.tsx +0 -361
- package/web/ui/src/routes/VaultDetail.tsx +0 -960
- package/web/ui/src/routes/VaultsList.tsx +0 -295
- package/web/ui/src/routes/WireChannelPage.tsx +0 -413
- package/web/ui/src/styles.css +0 -608
- package/web/ui/src/test/setup.ts +0 -23
- package/web/ui/src/vite-env.d.ts +0 -10
- package/web/ui/vite.config.ts +0 -34
- package/web/ui/vitest.config.ts +0 -25
|
@@ -1,470 +0,0 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* Integration tests for the unknown-sender request_approval flow
|
|
3
|
-
* (ACTION-ITEMS item 5).
|
|
4
|
-
*
|
|
5
|
-
* Covers:
|
|
6
|
-
* - request_approval policy fires `requestSenderApproval` on first unknown
|
|
7
|
-
* message from a sender
|
|
8
|
-
* - In-flight dedup: second message from the same sender while pending is
|
|
9
|
-
* silently dropped (no second card, no second row)
|
|
10
|
-
* - Approve path: member added, original message replayed via routeInbound,
|
|
11
|
-
* container woken
|
|
12
|
-
* - Deny path: pending row deleted, no member added
|
|
13
|
-
*/
|
|
14
|
-
import fs from 'fs';
|
|
15
|
-
import { beforeEach, afterEach, describe, expect, it, vi } from 'vitest';
|
|
16
|
-
|
|
17
|
-
import { initTestDb, closeDb, runMigrations } from '../../db/index.js';
|
|
18
|
-
import { createAgentGroup } from '../../db/agent-groups.js';
|
|
19
|
-
import { createMessagingGroup, createMessagingGroupAgent } from '../../db/messaging-groups.js';
|
|
20
|
-
import { upsertUser } from './db/users.js';
|
|
21
|
-
import { grantRole } from './db/user-roles.js';
|
|
22
|
-
|
|
23
|
-
// Mock container runner — prevent actual docker spawn.
|
|
24
|
-
vi.mock('../../container-runner.js', () => ({
|
|
25
|
-
wakeContainer: vi.fn().mockResolvedValue(undefined),
|
|
26
|
-
isContainerRunning: vi.fn().mockReturnValue(false),
|
|
27
|
-
getActiveContainerCount: vi.fn().mockReturnValue(0),
|
|
28
|
-
killContainer: vi.fn(),
|
|
29
|
-
}));
|
|
30
|
-
|
|
31
|
-
// Mock delivery adapter — record card deliveries for assertions.
|
|
32
|
-
const deliverMock = vi.fn().mockResolvedValue('plat-msg-id');
|
|
33
|
-
vi.mock('../../delivery.js', () => ({
|
|
34
|
-
getDeliveryAdapter: () => ({
|
|
35
|
-
deliver: deliverMock,
|
|
36
|
-
}),
|
|
37
|
-
}));
|
|
38
|
-
|
|
39
|
-
// Mock ensureUserDm to return the approver's existing messaging group
|
|
40
|
-
// instead of hitting a real openDM RPC.
|
|
41
|
-
vi.mock('./user-dm.js', () => ({
|
|
42
|
-
ensureUserDm: vi.fn(async (userId: string) => {
|
|
43
|
-
const { getDb } = await import('../../db/connection.js');
|
|
44
|
-
const row = getDb()
|
|
45
|
-
.prepare(
|
|
46
|
-
`SELECT mg.* FROM messaging_groups mg
|
|
47
|
-
JOIN user_dms ud ON ud.messaging_group_id = mg.id
|
|
48
|
-
WHERE ud.user_id = ?`,
|
|
49
|
-
)
|
|
50
|
-
.get(userId);
|
|
51
|
-
return row;
|
|
52
|
-
}),
|
|
53
|
-
}));
|
|
54
|
-
|
|
55
|
-
vi.mock('../../config.js', async () => {
|
|
56
|
-
const actual = await vi.importActual('../../config.js');
|
|
57
|
-
return { ...actual, DATA_DIR: '/tmp/paraclaw-test-sender-approval' };
|
|
58
|
-
});
|
|
59
|
-
|
|
60
|
-
const TEST_DIR = '/tmp/paraclaw-test-sender-approval';
|
|
61
|
-
|
|
62
|
-
function now() {
|
|
63
|
-
return new Date().toISOString();
|
|
64
|
-
}
|
|
65
|
-
|
|
66
|
-
beforeEach(async () => {
|
|
67
|
-
if (fs.existsSync(TEST_DIR)) fs.rmSync(TEST_DIR, { recursive: true });
|
|
68
|
-
fs.mkdirSync(TEST_DIR, { recursive: true });
|
|
69
|
-
const db = initTestDb();
|
|
70
|
-
runMigrations(db);
|
|
71
|
-
|
|
72
|
-
// Side-effect imports: register hooks (permissions module) AFTER the
|
|
73
|
-
// mocks are in place so the access gate / response handler pick up the
|
|
74
|
-
// mocked delivery + user-dm helpers.
|
|
75
|
-
await import('./index.js');
|
|
76
|
-
|
|
77
|
-
// Fixtures: agent group, messaging group with request_approval, wiring,
|
|
78
|
-
// owner + DM messaging group for approver delivery.
|
|
79
|
-
createAgentGroup({ id: 'ag-1', name: 'Agent', folder: 'agent', agent_provider: null, created_at: now() });
|
|
80
|
-
|
|
81
|
-
createMessagingGroup({
|
|
82
|
-
id: 'mg-chat',
|
|
83
|
-
channel_type: 'telegram',
|
|
84
|
-
platform_id: 'chat-123',
|
|
85
|
-
name: 'Group Chat',
|
|
86
|
-
is_group: 1,
|
|
87
|
-
unknown_sender_policy: 'request_approval',
|
|
88
|
-
created_at: now(),
|
|
89
|
-
});
|
|
90
|
-
createMessagingGroupAgent({
|
|
91
|
-
id: 'mga-1',
|
|
92
|
-
messaging_group_id: 'mg-chat',
|
|
93
|
-
agent_group_id: 'ag-1',
|
|
94
|
-
engage_mode: 'pattern',
|
|
95
|
-
engage_pattern: '.',
|
|
96
|
-
sender_scope: 'all',
|
|
97
|
-
ignored_message_policy: 'drop',
|
|
98
|
-
session_mode: 'shared',
|
|
99
|
-
priority: 0,
|
|
100
|
-
created_at: now(),
|
|
101
|
-
});
|
|
102
|
-
|
|
103
|
-
// Owner user + their DM messaging group (pickApprover + ensureUserDm target).
|
|
104
|
-
upsertUser({ id: 'telegram:owner', kind: 'telegram', display_name: 'Owner', created_at: now() });
|
|
105
|
-
grantRole({
|
|
106
|
-
user_id: 'telegram:owner',
|
|
107
|
-
role: 'owner',
|
|
108
|
-
agent_group_id: null,
|
|
109
|
-
granted_by: null,
|
|
110
|
-
granted_at: now(),
|
|
111
|
-
});
|
|
112
|
-
createMessagingGroup({
|
|
113
|
-
id: 'mg-dm-owner',
|
|
114
|
-
channel_type: 'telegram',
|
|
115
|
-
platform_id: 'dm-owner',
|
|
116
|
-
name: 'Owner DM',
|
|
117
|
-
is_group: 0,
|
|
118
|
-
unknown_sender_policy: 'public',
|
|
119
|
-
created_at: now(),
|
|
120
|
-
});
|
|
121
|
-
const { getDb } = await import('../../db/connection.js');
|
|
122
|
-
getDb()
|
|
123
|
-
.prepare(
|
|
124
|
-
`INSERT INTO user_dms (user_id, channel_type, messaging_group_id, resolved_at)
|
|
125
|
-
VALUES (?, ?, ?, ?)`,
|
|
126
|
-
)
|
|
127
|
-
.run('telegram:owner', 'telegram', 'mg-dm-owner', now());
|
|
128
|
-
|
|
129
|
-
deliverMock.mockClear();
|
|
130
|
-
});
|
|
131
|
-
|
|
132
|
-
afterEach(() => {
|
|
133
|
-
closeDb();
|
|
134
|
-
if (fs.existsSync(TEST_DIR)) fs.rmSync(TEST_DIR, { recursive: true });
|
|
135
|
-
});
|
|
136
|
-
|
|
137
|
-
function stranger(text: string) {
|
|
138
|
-
return {
|
|
139
|
-
channelType: 'telegram',
|
|
140
|
-
platformId: 'chat-123',
|
|
141
|
-
threadId: null,
|
|
142
|
-
message: {
|
|
143
|
-
id: `stranger-${Math.random().toString(36).slice(2, 8)}`,
|
|
144
|
-
kind: 'chat' as const,
|
|
145
|
-
content: JSON.stringify({
|
|
146
|
-
senderId: 'tg:stranger',
|
|
147
|
-
senderName: 'Stranger',
|
|
148
|
-
text,
|
|
149
|
-
}),
|
|
150
|
-
timestamp: now(),
|
|
151
|
-
},
|
|
152
|
-
};
|
|
153
|
-
}
|
|
154
|
-
|
|
155
|
-
describe('unknown-sender request_approval flow', () => {
|
|
156
|
-
it('delivers an approval card on first unknown message', async () => {
|
|
157
|
-
const { routeInbound } = await import('../../router.js');
|
|
158
|
-
await routeInbound(stranger('hi'));
|
|
159
|
-
|
|
160
|
-
// Wait for the fire-and-forget requestSenderApproval to resolve.
|
|
161
|
-
await new Promise((r) => setTimeout(r, 10));
|
|
162
|
-
|
|
163
|
-
expect(deliverMock).toHaveBeenCalledTimes(1);
|
|
164
|
-
const [channel, platformId, thread, kind, content] = deliverMock.mock.calls[0];
|
|
165
|
-
expect(channel).toBe('telegram');
|
|
166
|
-
expect(platformId).toBe('dm-owner'); // delivered to owner's DM
|
|
167
|
-
expect(thread).toBeNull();
|
|
168
|
-
expect(kind).toBe('chat-sdk');
|
|
169
|
-
const payload = JSON.parse(content as string);
|
|
170
|
-
expect(payload.type).toBe('ask_question');
|
|
171
|
-
expect(payload.questionId).toMatch(/^nsa-/);
|
|
172
|
-
|
|
173
|
-
const { getDb } = await import('../../db/connection.js');
|
|
174
|
-
const rows = getDb().prepare('SELECT * FROM pending_sender_approvals').all();
|
|
175
|
-
expect(rows).toHaveLength(1);
|
|
176
|
-
});
|
|
177
|
-
|
|
178
|
-
it('dedups a second message from the same stranger while pending', async () => {
|
|
179
|
-
const { routeInbound } = await import('../../router.js');
|
|
180
|
-
await routeInbound(stranger('hello'));
|
|
181
|
-
await new Promise((r) => setTimeout(r, 10));
|
|
182
|
-
await routeInbound(stranger('are you there?'));
|
|
183
|
-
await new Promise((r) => setTimeout(r, 10));
|
|
184
|
-
|
|
185
|
-
expect(deliverMock).toHaveBeenCalledTimes(1);
|
|
186
|
-
const { getDb } = await import('../../db/connection.js');
|
|
187
|
-
const count = (getDb().prepare('SELECT COUNT(*) AS c FROM pending_sender_approvals').get() as { c: number }).c;
|
|
188
|
-
expect(count).toBe(1);
|
|
189
|
-
});
|
|
190
|
-
|
|
191
|
-
it('approve → adds member and replays the original message', async () => {
|
|
192
|
-
const { routeInbound } = await import('../../router.js');
|
|
193
|
-
const { getResponseHandlers } = await import('../../response-registry.js');
|
|
194
|
-
const { wakeContainer } = await import('../../container-runner.js');
|
|
195
|
-
(wakeContainer as unknown as ReturnType<typeof vi.fn>).mockClear();
|
|
196
|
-
|
|
197
|
-
await routeInbound(stranger('please let me in'));
|
|
198
|
-
await new Promise((r) => setTimeout(r, 10));
|
|
199
|
-
|
|
200
|
-
const { getDb } = await import('../../db/connection.js');
|
|
201
|
-
const pending = getDb().prepare('SELECT id FROM pending_sender_approvals').get() as { id: string };
|
|
202
|
-
expect(pending).toBeDefined();
|
|
203
|
-
|
|
204
|
-
// Fire the approve click through the response-handler chain.
|
|
205
|
-
for (const handler of getResponseHandlers()) {
|
|
206
|
-
const claimed = await handler({
|
|
207
|
-
questionId: pending.id,
|
|
208
|
-
value: 'approve',
|
|
209
|
-
// Chat SDK's onAction surfaces the raw platform userId (e.g. Telegram
|
|
210
|
-
// chat id). The permissions handler namespaces it with channelType to
|
|
211
|
-
// match users(id).
|
|
212
|
-
userId: 'owner',
|
|
213
|
-
channelType: 'telegram',
|
|
214
|
-
platformId: 'dm-owner',
|
|
215
|
-
threadId: null,
|
|
216
|
-
});
|
|
217
|
-
if (claimed) break;
|
|
218
|
-
}
|
|
219
|
-
|
|
220
|
-
// Member row added for the stranger against the wired agent group.
|
|
221
|
-
const member = getDb()
|
|
222
|
-
.prepare('SELECT 1 AS x FROM agent_group_members WHERE user_id = ? AND agent_group_id = ?')
|
|
223
|
-
.get('tg:stranger', 'ag-1');
|
|
224
|
-
expect(member).toBeDefined();
|
|
225
|
-
|
|
226
|
-
// Pending row cleared.
|
|
227
|
-
const stillPending = getDb().prepare('SELECT COUNT(*) AS c FROM pending_sender_approvals').get() as { c: number };
|
|
228
|
-
expect(stillPending.c).toBe(0);
|
|
229
|
-
|
|
230
|
-
// Message replayed + container woken.
|
|
231
|
-
expect(wakeContainer).toHaveBeenCalled();
|
|
232
|
-
});
|
|
233
|
-
|
|
234
|
-
it('deny → deletes the pending row without adding a member', async () => {
|
|
235
|
-
const { routeInbound } = await import('../../router.js');
|
|
236
|
-
const { getResponseHandlers } = await import('../../response-registry.js');
|
|
237
|
-
|
|
238
|
-
await routeInbound(stranger('hello'));
|
|
239
|
-
await new Promise((r) => setTimeout(r, 10));
|
|
240
|
-
|
|
241
|
-
const { getDb } = await import('../../db/connection.js');
|
|
242
|
-
const pending = getDb().prepare('SELECT id FROM pending_sender_approvals').get() as { id: string };
|
|
243
|
-
expect(pending).toBeDefined();
|
|
244
|
-
|
|
245
|
-
for (const handler of getResponseHandlers()) {
|
|
246
|
-
const claimed = await handler({
|
|
247
|
-
questionId: pending.id,
|
|
248
|
-
value: 'reject',
|
|
249
|
-
userId: 'owner', // raw platform id — handler namespaces with channelType
|
|
250
|
-
channelType: 'telegram',
|
|
251
|
-
platformId: 'dm-owner',
|
|
252
|
-
threadId: null,
|
|
253
|
-
});
|
|
254
|
-
if (claimed) break;
|
|
255
|
-
}
|
|
256
|
-
|
|
257
|
-
const count = (getDb().prepare('SELECT COUNT(*) AS c FROM pending_sender_approvals').get() as { c: number }).c;
|
|
258
|
-
expect(count).toBe(0);
|
|
259
|
-
const member = getDb()
|
|
260
|
-
.prepare('SELECT 1 AS x FROM agent_group_members WHERE user_id = ? AND agent_group_id = ?')
|
|
261
|
-
.get('tg:stranger', 'ag-1');
|
|
262
|
-
expect(member).toBeUndefined();
|
|
263
|
-
});
|
|
264
|
-
|
|
265
|
-
it('approve_and_allow → admits the sender, flips MG policy to public, and emits an audit log', async () => {
|
|
266
|
-
const { routeInbound } = await import('../../router.js');
|
|
267
|
-
const { getResponseHandlers } = await import('../../response-registry.js');
|
|
268
|
-
const { getMessagingGroup } = await import('../../db/messaging-groups.js');
|
|
269
|
-
const { log } = await import('../../log.js');
|
|
270
|
-
|
|
271
|
-
const infoSpy = vi.spyOn(log, 'info');
|
|
272
|
-
|
|
273
|
-
await routeInbound(stranger('let everyone in'));
|
|
274
|
-
await new Promise((r) => setTimeout(r, 10));
|
|
275
|
-
|
|
276
|
-
const { getDb } = await import('../../db/connection.js');
|
|
277
|
-
const pending = getDb().prepare('SELECT id FROM pending_sender_approvals').get() as { id: string };
|
|
278
|
-
expect(pending).toBeDefined();
|
|
279
|
-
|
|
280
|
-
for (const handler of getResponseHandlers()) {
|
|
281
|
-
const claimed = await handler({
|
|
282
|
-
questionId: pending.id,
|
|
283
|
-
value: 'approve_and_allow',
|
|
284
|
-
userId: 'owner',
|
|
285
|
-
channelType: 'telegram',
|
|
286
|
-
platformId: 'dm-owner',
|
|
287
|
-
threadId: null,
|
|
288
|
-
});
|
|
289
|
-
if (claimed) break;
|
|
290
|
-
}
|
|
291
|
-
|
|
292
|
-
// Sender admitted (same as 'approve' branch).
|
|
293
|
-
const member = getDb()
|
|
294
|
-
.prepare('SELECT 1 AS x FROM agent_group_members WHERE user_id = ? AND agent_group_id = ?')
|
|
295
|
-
.get('tg:stranger', 'ag-1');
|
|
296
|
-
expect(member).toBeDefined();
|
|
297
|
-
|
|
298
|
-
// MG flipped to public so future strangers skip the gate.
|
|
299
|
-
const mg = getMessagingGroup('mg-chat');
|
|
300
|
-
expect(mg?.unknown_sender_policy).toBe('public');
|
|
301
|
-
|
|
302
|
-
// Audit log entry includes operator + MG + before-state for traceability.
|
|
303
|
-
const auditCalls = infoSpy.mock.calls.filter(([, data]) => {
|
|
304
|
-
return (
|
|
305
|
-
typeof data === 'object' &&
|
|
306
|
-
data !== null &&
|
|
307
|
-
(data as { audit?: string }).audit === 'sender_approval_policy_flip'
|
|
308
|
-
);
|
|
309
|
-
});
|
|
310
|
-
expect(auditCalls).toHaveLength(1);
|
|
311
|
-
const [, auditFields] = auditCalls[0] as [string, Record<string, unknown>];
|
|
312
|
-
expect(auditFields).toMatchObject({
|
|
313
|
-
messagingGroupId: 'mg-chat',
|
|
314
|
-
agentGroupId: 'ag-1',
|
|
315
|
-
approverId: 'telegram:owner',
|
|
316
|
-
fromPolicy: 'request_approval',
|
|
317
|
-
toPolicy: 'public',
|
|
318
|
-
});
|
|
319
|
-
|
|
320
|
-
// Pending row cleared.
|
|
321
|
-
const stillPending = (getDb().prepare('SELECT COUNT(*) AS c FROM pending_sender_approvals').get() as { c: number })
|
|
322
|
-
.c;
|
|
323
|
-
expect(stillPending).toBe(0);
|
|
324
|
-
|
|
325
|
-
infoSpy.mockRestore();
|
|
326
|
-
});
|
|
327
|
-
|
|
328
|
-
it('approve_and_allow → idempotent on already-public MG, audit still fires with fromPolicy=public', async () => {
|
|
329
|
-
// Pre-flip the MG to public to simulate a second click after a prior
|
|
330
|
-
// always-allow has already happened. The button is shown unconditionally
|
|
331
|
-
// (Aaron's call) so this branch can fire even when policy is already
|
|
332
|
-
// public.
|
|
333
|
-
const { updateMessagingGroup, getMessagingGroup } = await import('../../db/messaging-groups.js');
|
|
334
|
-
updateMessagingGroup('mg-chat', { unknown_sender_policy: 'public' });
|
|
335
|
-
|
|
336
|
-
// With public policy, the access gate skips the unknown-sender flow —
|
|
337
|
-
// so we can't trigger the approval via routeInbound. Seed the pending
|
|
338
|
-
// row directly to exercise just the click handler. Upsert the sender
|
|
339
|
-
// user first so addMember's FK to users(id) holds.
|
|
340
|
-
upsertUser({ id: 'tg:later-stranger', kind: 'telegram', display_name: 'Later', created_at: now() });
|
|
341
|
-
const { createPendingSenderApproval } = await import('./db/pending-sender-approvals.js');
|
|
342
|
-
const approvalId = 'nsa-test-idempotent';
|
|
343
|
-
createPendingSenderApproval({
|
|
344
|
-
id: approvalId,
|
|
345
|
-
messaging_group_id: 'mg-chat',
|
|
346
|
-
agent_group_id: 'ag-1',
|
|
347
|
-
sender_identity: 'tg:later-stranger',
|
|
348
|
-
sender_name: 'Later',
|
|
349
|
-
original_message: JSON.stringify(stranger('hello again')),
|
|
350
|
-
approver_user_id: 'telegram:owner',
|
|
351
|
-
created_at: now(),
|
|
352
|
-
title: 'New sender',
|
|
353
|
-
options_json: '[]',
|
|
354
|
-
});
|
|
355
|
-
|
|
356
|
-
const { log } = await import('../../log.js');
|
|
357
|
-
const infoSpy = vi.spyOn(log, 'info');
|
|
358
|
-
|
|
359
|
-
const { getResponseHandlers } = await import('../../response-registry.js');
|
|
360
|
-
for (const handler of getResponseHandlers()) {
|
|
361
|
-
const claimed = await handler({
|
|
362
|
-
questionId: approvalId,
|
|
363
|
-
value: 'approve_and_allow',
|
|
364
|
-
userId: 'owner',
|
|
365
|
-
channelType: 'telegram',
|
|
366
|
-
platformId: 'dm-owner',
|
|
367
|
-
threadId: null,
|
|
368
|
-
});
|
|
369
|
-
if (claimed) break;
|
|
370
|
-
}
|
|
371
|
-
|
|
372
|
-
// Policy stays public (no regression).
|
|
373
|
-
expect(getMessagingGroup('mg-chat')?.unknown_sender_policy).toBe('public');
|
|
374
|
-
|
|
375
|
-
// Audit log fires with fromPolicy='public' so the click is traceable
|
|
376
|
-
// even when the DB write was a no-op.
|
|
377
|
-
const auditCalls = infoSpy.mock.calls.filter(([, data]) => {
|
|
378
|
-
return (
|
|
379
|
-
typeof data === 'object' &&
|
|
380
|
-
data !== null &&
|
|
381
|
-
(data as { audit?: string }).audit === 'sender_approval_policy_flip'
|
|
382
|
-
);
|
|
383
|
-
});
|
|
384
|
-
expect(auditCalls).toHaveLength(1);
|
|
385
|
-
const [, auditFields] = auditCalls[0] as [string, Record<string, unknown>];
|
|
386
|
-
expect(auditFields).toMatchObject({ fromPolicy: 'public', toPolicy: 'public' });
|
|
387
|
-
|
|
388
|
-
infoSpy.mockRestore();
|
|
389
|
-
});
|
|
390
|
-
|
|
391
|
-
it('rejects clicks from an unauthorized user (prevents self-admit via forwarded card)', async () => {
|
|
392
|
-
// Stranger triggers the approval flow; card goes to the owner.
|
|
393
|
-
const { routeInbound } = await import('../../router.js');
|
|
394
|
-
const { getResponseHandlers } = await import('../../response-registry.js');
|
|
395
|
-
|
|
396
|
-
await routeInbound(stranger('can I play'));
|
|
397
|
-
await new Promise((r) => setTimeout(r, 10));
|
|
398
|
-
|
|
399
|
-
const { getDb } = await import('../../db/connection.js');
|
|
400
|
-
const pending = getDb().prepare('SELECT id FROM pending_sender_approvals').get() as { id: string };
|
|
401
|
-
expect(pending).toBeDefined();
|
|
402
|
-
|
|
403
|
-
// A random user (not the stranger, not the owner, not an admin) tries to
|
|
404
|
-
// click the approval — e.g. they got the card forwarded. Should be
|
|
405
|
-
// rejected without admitting them.
|
|
406
|
-
for (const handler of getResponseHandlers()) {
|
|
407
|
-
const claimed = await handler({
|
|
408
|
-
questionId: pending.id,
|
|
409
|
-
value: 'approve',
|
|
410
|
-
userId: 'random-bystander', // not owner, not admin
|
|
411
|
-
channelType: 'telegram',
|
|
412
|
-
platformId: 'dm-random',
|
|
413
|
-
threadId: null,
|
|
414
|
-
});
|
|
415
|
-
if (claimed) break;
|
|
416
|
-
}
|
|
417
|
-
|
|
418
|
-
// No member added for the stranger.
|
|
419
|
-
const member = getDb()
|
|
420
|
-
.prepare('SELECT 1 AS x FROM agent_group_members WHERE user_id = ? AND agent_group_id = ?')
|
|
421
|
-
.get('tg:stranger', 'ag-1');
|
|
422
|
-
expect(member).toBeUndefined();
|
|
423
|
-
|
|
424
|
-
// Pending row is still there — a legitimate approver can still act on it.
|
|
425
|
-
const stillPending = (getDb().prepare('SELECT COUNT(*) AS c FROM pending_sender_approvals').get() as { c: number })
|
|
426
|
-
.c;
|
|
427
|
-
expect(stillPending).toBe(1);
|
|
428
|
-
});
|
|
429
|
-
|
|
430
|
-
it('accepts a click from a global admin even if they are not the designated approver', async () => {
|
|
431
|
-
// Pre-seed a separate admin user so we can click as them.
|
|
432
|
-
upsertUser({ id: 'telegram:admin-bob', kind: 'telegram', display_name: 'Bob', created_at: now() });
|
|
433
|
-
grantRole({
|
|
434
|
-
user_id: 'telegram:admin-bob',
|
|
435
|
-
role: 'admin',
|
|
436
|
-
agent_group_id: null,
|
|
437
|
-
granted_by: 'telegram:owner',
|
|
438
|
-
granted_at: now(),
|
|
439
|
-
});
|
|
440
|
-
|
|
441
|
-
const { routeInbound } = await import('../../router.js');
|
|
442
|
-
const { getResponseHandlers } = await import('../../response-registry.js');
|
|
443
|
-
|
|
444
|
-
await routeInbound(stranger('knock knock'));
|
|
445
|
-
await new Promise((r) => setTimeout(r, 10));
|
|
446
|
-
|
|
447
|
-
const { getDb } = await import('../../db/connection.js');
|
|
448
|
-
const pending = getDb().prepare('SELECT id FROM pending_sender_approvals').get() as { id: string };
|
|
449
|
-
expect(pending).toBeDefined();
|
|
450
|
-
|
|
451
|
-
// Admin clicks approve (not the designated approver, which was owner).
|
|
452
|
-
for (const handler of getResponseHandlers()) {
|
|
453
|
-
const claimed = await handler({
|
|
454
|
-
questionId: pending.id,
|
|
455
|
-
value: 'approve',
|
|
456
|
-
userId: 'admin-bob',
|
|
457
|
-
channelType: 'telegram',
|
|
458
|
-
platformId: 'dm-bob',
|
|
459
|
-
threadId: null,
|
|
460
|
-
});
|
|
461
|
-
if (claimed) break;
|
|
462
|
-
}
|
|
463
|
-
|
|
464
|
-
// Stranger admitted thanks to the admin's authority.
|
|
465
|
-
const member = getDb()
|
|
466
|
-
.prepare('SELECT 1 AS x FROM agent_group_members WHERE user_id = ? AND agent_group_id = ?')
|
|
467
|
-
.get('tg:stranger', 'ag-1');
|
|
468
|
-
expect(member).toBeDefined();
|
|
469
|
-
});
|
|
470
|
-
});
|
|
@@ -1,165 +0,0 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* Unknown-sender approval flow.
|
|
3
|
-
*
|
|
4
|
-
* When `messaging_groups.unknown_sender_policy = 'request_approval'` and a
|
|
5
|
-
* non-member writes into a wired chat, the access gate drops the routing
|
|
6
|
-
* attempt and calls `requestSenderApproval` to:
|
|
7
|
-
*
|
|
8
|
-
* 1. Pick an eligible approver (owner / admin of the agent group).
|
|
9
|
-
* 2. Open / reuse a DM to that approver on a reachable channel.
|
|
10
|
-
* 3. Deliver an Approve / Deny card.
|
|
11
|
-
* 4. Record a pending_sender_approvals row that holds the original message
|
|
12
|
-
* so it can be re-routed on approve.
|
|
13
|
-
*
|
|
14
|
-
* On approve: the handler in index.ts adds an agent_group_members row for
|
|
15
|
-
* the sender and re-invokes routeInbound with the stored event — the second
|
|
16
|
-
* routing attempt passes the gate because the user is now a member.
|
|
17
|
-
*
|
|
18
|
-
* Failure modes (logged + row NOT created, so the dedup gate lets a future
|
|
19
|
-
* attempt try again):
|
|
20
|
-
* - No eligible approver in user_roles — fresh install, no owner yet.
|
|
21
|
-
* - Approver has no reachable DM (no user_dms row + channel can't
|
|
22
|
-
* openDM) — e.g. owner hasn't registered on any channel we're wired to.
|
|
23
|
-
* - Delivery adapter missing.
|
|
24
|
-
*
|
|
25
|
-
* Dedup: `pending_sender_approvals` has UNIQUE(messaging_group_id,
|
|
26
|
-
* sender_identity). A retry / rapid second message from the same unknown
|
|
27
|
-
* sender is silently dropped (no duplicate card sent).
|
|
28
|
-
*/
|
|
29
|
-
import { normalizeOptions, type RawOption } from '../../channels/ask-question.js';
|
|
30
|
-
import { getMessagingGroup } from '../../db/messaging-groups.js';
|
|
31
|
-
import { getDeliveryAdapter } from '../../delivery.js';
|
|
32
|
-
import { log } from '../../log.js';
|
|
33
|
-
import { decodePlatformIdAs } from '../../platform-id.js';
|
|
34
|
-
import type { InboundEvent } from '../../channels/adapter.js';
|
|
35
|
-
import { appendFallbackNotice, pickApprovalDelivery, pickApprover } from '../approvals/primitive.js';
|
|
36
|
-
import { createPendingSenderApproval, hasInFlightSenderApproval } from './db/pending-sender-approvals.js';
|
|
37
|
-
|
|
38
|
-
// Three-button card per design doc PR #75 phase 4. The "always allow" branch
|
|
39
|
-
// flips the messaging group's unknown_sender_policy to 'public' so future
|
|
40
|
-
// strangers walk through with no gate. Shown unconditionally — even on
|
|
41
|
-
// 'strict' MGs that wouldn't normally render this card — so the operator can
|
|
42
|
-
// recover from a too-restrictive default with one click. The handler short-
|
|
43
|
-
// circuits if the policy is already 'public', so the click is idempotent.
|
|
44
|
-
const APPROVAL_OPTIONS: RawOption[] = [
|
|
45
|
-
{ label: 'Allow', selectedLabel: '✅ Allowed', value: 'approve' },
|
|
46
|
-
{ label: 'Allow & open channel', selectedLabel: '✅ Channel opened', value: 'approve_and_allow' },
|
|
47
|
-
{ label: 'Deny', selectedLabel: '❌ Denied', value: 'reject' },
|
|
48
|
-
];
|
|
49
|
-
|
|
50
|
-
function generateId(): string {
|
|
51
|
-
return `nsa-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`;
|
|
52
|
-
}
|
|
53
|
-
|
|
54
|
-
export interface RequestSenderApprovalInput {
|
|
55
|
-
messagingGroupId: string;
|
|
56
|
-
agentGroupId: string;
|
|
57
|
-
senderIdentity: string; // namespaced user id (channel_type:handle)
|
|
58
|
-
senderName: string | null;
|
|
59
|
-
event: InboundEvent;
|
|
60
|
-
}
|
|
61
|
-
|
|
62
|
-
export async function requestSenderApproval(input: RequestSenderApprovalInput): Promise<void> {
|
|
63
|
-
const { messagingGroupId, agentGroupId, senderIdentity, senderName, event } = input;
|
|
64
|
-
|
|
65
|
-
// In-flight dedup: don't spam the admin if the same unknown sender
|
|
66
|
-
// retries while a card is already pending.
|
|
67
|
-
if (hasInFlightSenderApproval(messagingGroupId, senderIdentity)) {
|
|
68
|
-
log.debug('Unknown-sender approval already in flight — dropping retry', {
|
|
69
|
-
messagingGroupId,
|
|
70
|
-
senderIdentity,
|
|
71
|
-
});
|
|
72
|
-
return;
|
|
73
|
-
}
|
|
74
|
-
|
|
75
|
-
const approvers = pickApprover(agentGroupId);
|
|
76
|
-
if (approvers.length === 0) {
|
|
77
|
-
log.warn('Unknown-sender approval skipped — no owner or admin configured', {
|
|
78
|
-
messagingGroupId,
|
|
79
|
-
agentGroupId,
|
|
80
|
-
senderIdentity,
|
|
81
|
-
});
|
|
82
|
-
return;
|
|
83
|
-
}
|
|
84
|
-
|
|
85
|
-
const originMg = getMessagingGroup(messagingGroupId);
|
|
86
|
-
const originChannelType = originMg?.channel_type ?? '';
|
|
87
|
-
const originBotId = originMg ? decodePlatformIdAs(originMg.platform_id, 'v2').botId : null;
|
|
88
|
-
const target = await pickApprovalDelivery(approvers, originChannelType, originBotId);
|
|
89
|
-
if (!target) {
|
|
90
|
-
log.warn('Unknown-sender approval skipped — no DM channel for any approver', {
|
|
91
|
-
messagingGroupId,
|
|
92
|
-
agentGroupId,
|
|
93
|
-
senderIdentity,
|
|
94
|
-
});
|
|
95
|
-
return;
|
|
96
|
-
}
|
|
97
|
-
|
|
98
|
-
const approvalId = generateId();
|
|
99
|
-
const senderDisplay = senderName && senderName.length > 0 ? senderName : senderIdentity;
|
|
100
|
-
const originName = originMg?.name ?? `a ${originChannelType} channel`;
|
|
101
|
-
|
|
102
|
-
const title = '👤 New sender';
|
|
103
|
-
const question = `${senderDisplay} wants to talk to your agent in ${originName}. Allow?`;
|
|
104
|
-
const options = normalizeOptions(APPROVAL_OPTIONS);
|
|
105
|
-
|
|
106
|
-
createPendingSenderApproval({
|
|
107
|
-
id: approvalId,
|
|
108
|
-
messaging_group_id: messagingGroupId,
|
|
109
|
-
agent_group_id: agentGroupId,
|
|
110
|
-
sender_identity: senderIdentity,
|
|
111
|
-
sender_name: senderName,
|
|
112
|
-
original_message: JSON.stringify(event),
|
|
113
|
-
approver_user_id: target.userId,
|
|
114
|
-
created_at: new Date().toISOString(),
|
|
115
|
-
title,
|
|
116
|
-
options_json: JSON.stringify(options),
|
|
117
|
-
});
|
|
118
|
-
|
|
119
|
-
const adapter = getDeliveryAdapter();
|
|
120
|
-
if (!adapter) {
|
|
121
|
-
// Without a delivery adapter, the card can't be sent. Log + leave the
|
|
122
|
-
// row in place so the admin can see it via DB or manual tooling; the
|
|
123
|
-
// dedup gate will suppress further cards until it's cleared.
|
|
124
|
-
log.error('Unknown-sender approval row created but no delivery adapter is wired', {
|
|
125
|
-
approvalId,
|
|
126
|
-
});
|
|
127
|
-
return;
|
|
128
|
-
}
|
|
129
|
-
|
|
130
|
-
try {
|
|
131
|
-
await adapter.deliver(
|
|
132
|
-
target.messagingGroup.channel_type,
|
|
133
|
-
target.messagingGroup.platform_id,
|
|
134
|
-
null,
|
|
135
|
-
'chat-sdk',
|
|
136
|
-
JSON.stringify({
|
|
137
|
-
type: 'ask_question',
|
|
138
|
-
questionId: approvalId,
|
|
139
|
-
title,
|
|
140
|
-
question: appendFallbackNotice(question, target.viaFallbackBot, originBotId),
|
|
141
|
-
options,
|
|
142
|
-
}),
|
|
143
|
-
);
|
|
144
|
-
log.info('Unknown-sender approval card delivered', {
|
|
145
|
-
approvalId,
|
|
146
|
-
senderIdentity,
|
|
147
|
-
approver: target.userId,
|
|
148
|
-
messagingGroupId,
|
|
149
|
-
agentGroupId,
|
|
150
|
-
});
|
|
151
|
-
} catch (err) {
|
|
152
|
-
log.error('Unknown-sender approval card delivery failed', {
|
|
153
|
-
approvalId,
|
|
154
|
-
err,
|
|
155
|
-
});
|
|
156
|
-
}
|
|
157
|
-
}
|
|
158
|
-
|
|
159
|
-
/**
|
|
160
|
-
* Option value the admin clicked that means "allow" — shared with the
|
|
161
|
-
* response handler so the two sides can't drift.
|
|
162
|
-
*/
|
|
163
|
-
export const APPROVE_VALUE = 'approve';
|
|
164
|
-
export const APPROVE_AND_ALLOW_VALUE = 'approve_and_allow';
|
|
165
|
-
export const REJECT_VALUE = 'reject';
|