@open-everywhere/provider-discord 0.1.0

package/dist/agent/surface-parity.js

@@ -0,0 +1,90 @@
+// DISCORD's surface-parity declaration (OPE-1499). See the core module's header
+// (packages/core/agent/identity/surface-parity.ts) for what the three cell shapes mean.
+//
+// Discord is complete on the chat plane. Its one structural difference from Slack is the
+// engagement seam's second step: it enrols conversations and honours the durable `stopped` flag,
+// but gates delivery with its own gateway rule instead of core's `shouldDeliverReply`.
+export const DISCORD_SURFACE_PARITY = {
+    // registration seams (§7.1)
+    "identity-mapper": "supported",
+    "capability-manifest": "supported",
+    "post-arm": "supported",
+    "wake-origin-codec": "supported",
+    // The arm renders a Discord action row (`discord-post-arm.ts`), the front routes the tap back
+    // (`discord-front.ts` classifies the `oe_input:` custom_id, `discord-approval-card.ts` settles it),
+    // and the settle DELIVERS through core's `approvalCardRespondVia` — all three halves, as the row
+    // requires. The third is not a formality: this front bound its own `args.from(bareToken)` until
+    // OPE-1863, and that address is channel-local, so every tap threw and the approval stayed parked.
+    "unified-action-plane": "supported",
+    // `messageId` is the `message_reference` anchor and sits outside `threadRef`, which keys on the
+    // channel id alone — Slack's shape exactly. Both members are implemented; `autoThreadName` stays
+    // OUT of the axis because opening a thread MOVES a post rather than placing one.
+    "origin-placement-carry": "supported",
+    "read-adapter": "supported",
+    "reaction-feedback-ingest": "supported",
+    "ancillary-ops": "supported",
+    // Enrols (`markThreadEngaged`) and reads the `stopped` flag, but runs its own delivery gate in
+    // discord-gateway.ts rather than calling core's `shouldDeliverReply` — the seam is wired, and
+    // the trio is not called whole (§7.1's prose).
+    "ambient-engagement-seam": { supported: "enrols and honours `stopped`; gates delivery in its own gateway rule" },
+    // 🔴 A SECOND HONEST SPELLING, NOT A MISSING MAPPING. Under standing seats a Discord auto-thread
+    // is a seated channel in its own right, so a plain follow-up in it diverts as THAT channel's own
+    // wake and `discord-gateway.ts` reports the classifier's word. `J-ENGAGED-discord` reads the pair
+    // `channel-watch` + `singleWindow: true` IN the follow-up's own room instead
+    // (`reportedSeatedChannelWatch`, packages/core/scripts/e2e/engaged-rows.ts). Promoting the value
+    // here would need the seated path to resolve the engagement registry it does not read.
+    "engaged-row-promotion": {
+        unsupported: "the seated path reports the classifier's word — an auto-thread's follow-up diverts as that channel's own wake, and the journey reads `channel-watch` on a `singleWindow: true` row in that room instead",
+    },
+    // A Discord thread is its OWN channel id, so the stored origin could not tell a thread from a
+    // plain channel and the router had to read every Discord wake as top-level. The gateway now
+    // stamps `thread: true` at mint from the relay payload's channel type (OPE-1719), which is the
+    // positive signal the guard needs. The DM leg keeps the raw divert: a DM has no threads.
+    "owned-thread-ingress": { supported: "the guild leg only — a Discord DM carries no threads, so its divert never consults ownership" },
+    // wake legs and conversation shapes
+    "addressed-leg": "supported",
+    "ambient-leg": "supported",
+    // `discord-backscroll.ts discordSeatCatchUpFetch` pages `GET /channels/:id/messages` back to the
+    // seat's own `lastWakeAt` and hands the normalized window to core's shared catch-up path. A thread
+    // IS its own channel id on Discord, so one endpoint serves both the container and the conversation.
+    "seat-catch-up": "supported",
+    // BOTH hydration roads pour through one wrapper (`admitDiscordSeatLines`, discord-gateway.ts),
+    // which calls the core seam — never a per-bundle copy of the policy.
+    "seat-context-admission": "supported",
+    // The one registered `CardPoster` (approvals/discord-flow.ts, wired in register.ts): this bundle
+    // owns its own render AND the component route that brings the tap back.
+    "approval-card": "supported",
+    // The one registered `JudgeLiftNoticePoster` too (approvals/discord-flow.ts): the notice renders
+    // as this surface's own card with the overrule button, and the tap comes back the same route the
+    // Approve/Reject taps take.
+    "judge-lift-notice": "supported",
+    "name-drop-mention": "supported",
+    // 🔴 THE EVENT NEVER LEAVES THE RELAY. `deploy/discord-relay/index.js` subscribes to
+    // `Events.MessageCreate` (plus the two reaction events) and nothing else, so an edit — Discord's
+    // `MessageUpdate` — is never forwarded and the ingestion channel has no edit to gate. The gap is
+    // in the relay's subscription set, not in `discord-gateway.ts`.
+    "message-edit-wake": { unsupported: "the gateway relay subscribes to MessageCreate only — an edit raises MessageUpdate, which nothing forwards" },
+    // A Discord thread IS a channel, so `read_thread` reads that thread channel (§4.6.1).
+    threads: { supported: "a thread is itself a channel" },
+    rooms: "supported",
+    dm: "supported",
+    mpim: "supported",
+    // core verbs (§7.2)
+    reply: "supported",
+    edit_reply: "supported",
+    // Message-level granularity since OPE-987 (discord-post-arm.ts `resolveReactTarget`/`react`).
+    react: "supported",
+    no_reply: "supported",
+    read_channel: "supported",
+    read_thread: "supported",
+    search: { unsupported: "no work-search adapter — Discord is a chat surface, not a work corpus (§4.7)" },
+    post_message: "supported",
+    dm_person: "supported",
+    set_dm_delivery: "supported",
+    stop: { supported: "✋ reaction, plus the `/oe stop` command" },
+    ack_stop_glyph: "supported",
+    ack_cancel_note: "supported",
+    stand_down: { supported: "marks the engagement row; refuses out loud when the registry holds none" },
+    post_file: "supported",
+};
+//# sourceMappingURL=surface-parity.js.map

package/dist/agent/surface-parity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"surface-parity.js","sourceRoot":"","sources":["../../agent/surface-parity.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,wFAAwF;AACxF,EAAE;AACF,yFAAyF;AACzF,iGAAiG;AACjG,uFAAuF;AAIvF,MAAM,CAAC,MAAM,sBAAsB,GAA6B;IAC9D,4BAA4B;IAC5B,iBAAiB,EAAE,WAAW;IAC9B,qBAAqB,EAAE,WAAW;IAClC,UAAU,EAAE,WAAW;IACvB,mBAAmB,EAAE,WAAW;IAChC,8FAA8F;IAC9F,oGAAoG;IACpG,iGAAiG;IACjG,gGAAgG;IAChG,kGAAkG;IAClG,sBAAsB,EAAE,WAAW;IACnC,gGAAgG;IAChG,iGAAiG;IACjG,iFAAiF;IACjF,wBAAwB,EAAE,WAAW;IACrC,cAAc,EAAE,WAAW;IAC3B,0BAA0B,EAAE,WAAW;IACvC,eAAe,EAAE,WAAW;IAC5B,+FAA+F;IAC/F,8FAA8F;IAC9F,+CAA+C;IAC/C,yBAAyB,EAAE,EAAE,SAAS,EAAE,sEAAsE,EAAE;IAChH,iGAAiG;IACjG,iGAAiG;IACjG,kGAAkG;IAClG,6EAA6E;IAC7E,iGAAiG;IACjG,uFAAuF;IACvF,uBAAuB,EAAE;QACvB,WAAW,EACT,yMAAyM;KAC5M;IACD,8FAA8F;IAC9F,4FAA4F;IAC5F,+FAA+F;IAC/F,yFAAyF;IACzF,sBAAsB,EAAE,EAAE,SAAS,EAAE,8FAA8F,EAAE;IAErI,oCAAoC;IACpC,eAAe,EAAE,WAAW;IAC5B,aAAa,EAAE,WAAW;IAC1B,iGAAiG;IACjG,mGAAmG;IACnG,oGAAoG;IACpG,eAAe,EAAE,WAAW;IAC5B,+FAA+F;IAC/F,qEAAqE;IACrE,wBAAwB,EAAE,WAAW;IACrC,iGAAiG;IACjG,wEAAwE;IACxE,eAAe,EAAE,WAAW;IAC5B,iGAAiG;IACjG,iGAAiG;IACjG,4BAA4B;IAC5B,mBAAmB,EAAE,WAAW;IAChC,mBAAmB,EAAE,WAAW;IAChC,qFAAqF;IACrF,iGAAiG;IACjG,iGAAiG;IACjG,gEAAgE;IAChE,mBAAmB,EAAE,EAAE,WAAW,EAAE,2GAA2G,EAAE;IACjJ,sFAAsF;IACtF,OAAO,EAAE,EAAE,SAAS,EAAE,8BAA8B,EAAE;IACtD,KAAK,EAAE,WAAW;IAClB,EAAE,EAAE,WAAW;IACf,IAAI,EAAE,WAAW;IAEjB,oBAAoB;IACpB,KAAK,EAAE,WAAW;IAClB,UAAU,EAAE,WAAW;IACvB,8FAA8F;IAC9F,KAAK,EAAE,WAAW;IAClB,QAAQ,EAAE,WAAW;IACrB,YAAY,EAAE,WAAW;IACzB,WAAW,EAAE,WAAW;IACxB,MAAM,EAAE,EAAE,WAAW,EAAE,8EAA8E,EAAE;IACvG,YAAY,EAAE,WAAW;IACzB,SAAS,EAAE,WAAW;IACtB,eAAe,EAAE,WAAW;IAC5B,IAAI,EAAE,EAAE,SAAS,EAAE,yCAAyC,EAAE;IAC9D,cAAc,EAAE,WAAW;IAC3B,eAAe,EAAE,WAAW;IAC5B,UAAU,EAAE,EAAE,SAAS,EAAE,yEAAyE,EAAE;IACpG,SAAS,EAAE,WAAW;CACvB,CAAC"}

package/package.json

@@ -0,0 +1,185 @@
+{
+  "name": "@open-everywhere/provider-discord",
+  "version": "0.1.0",
+  "description": "Open Everywhere Discord provider — Discord channel and DM surfaces, gateway wiring, identity mapping and approval cards.",
+  "keywords": [
+    "agent",
+    "discord",
+    "discord-bot",
+    "chatops",
+    "eve"
+  ],
+  "license": "Apache-2.0",
+  "type": "module",
+  "homepage": "https://github.com/open-everywhere/open-everywhere/tree/main/packages/providers/discord",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/open-everywhere/open-everywhere.git",
+    "directory": "packages/providers/discord"
+  },
+  "bugs": {
+    "url": "https://github.com/open-everywhere/open-everywhere/issues"
+  },
+  "engines": {
+    "node": ">=24"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "agent",
+    "dist",
+    "tsconfig.json",
+    "tsconfig.build.json",
+    "LICENSE",
+    "NOTICE"
+  ],
+  "exports": {
+    "./package.json": "./package.json",
+    "./agent/access/discord-grant-click.js": {
+      "types": "./dist/agent/access/discord-grant-click.d.ts",
+      "default": "./dist/agent/access/discord-grant-click.js"
+    },
+    "./agent/approvals/discord-admin.js": {
+      "types": "./dist/agent/approvals/discord-admin.d.ts",
+      "default": "./dist/agent/approvals/discord-admin.js"
+    },
+    "./agent/approvals/discord-card.js": {
+      "types": "./dist/agent/approvals/discord-card.d.ts",
+      "default": "./dist/agent/approvals/discord-card.js"
+    },
+    "./agent/approvals/discord-flow.js": {
+      "types": "./dist/agent/approvals/discord-flow.d.ts",
+      "default": "./dist/agent/approvals/discord-flow.js"
+    },
+    "./agent/approvals/discord-scope-label.js": {
+      "types": "./dist/agent/approvals/discord-scope-label.d.ts",
+      "default": "./dist/agent/approvals/discord-scope-label.js"
+    },
+    "./agent/channels/discord-approval-card.js": {
+      "types": "./dist/agent/channels/discord-approval-card.d.ts",
+      "default": "./dist/agent/channels/discord-approval-card.js"
+    },
+    "./agent/channels/discord-backscroll.js": {
+      "types": "./dist/agent/channels/discord-backscroll.d.ts",
+      "default": "./dist/agent/channels/discord-backscroll.js"
+    },
+    "./agent/channels/discord-bot-name.js": {
+      "types": "./dist/agent/channels/discord-bot-name.d.ts",
+      "default": "./dist/agent/channels/discord-bot-name.js"
+    },
+    "./agent/channels/discord-channel-info.js": {
+      "types": "./dist/agent/channels/discord-channel-info.d.ts",
+      "default": "./dist/agent/channels/discord-channel-info.js"
+    },
+    "./agent/channels/discord-directory.js": {
+      "types": "./dist/agent/channels/discord-directory.d.ts",
+      "default": "./dist/agent/channels/discord-directory.js"
+    },
+    "./agent/channels/discord-dispatch-target.js": {
+      "types": "./dist/agent/channels/discord-dispatch-target.d.ts",
+      "default": "./dist/agent/channels/discord-dispatch-target.js"
+    },
+    "./agent/channels/discord-events.js": {
+      "types": "./dist/agent/channels/discord-events.d.ts",
+      "default": "./dist/agent/channels/discord-events.js"
+    },
+    "./agent/channels/discord-front.js": {
+      "types": "./dist/agent/channels/discord-front.d.ts",
+      "default": "./dist/agent/channels/discord-front.js"
+    },
+    "./agent/channels/discord-gateway.js": {
+      "types": "./dist/agent/channels/discord-gateway.d.ts",
+      "default": "./dist/agent/channels/discord-gateway.js"
+    },
+    "./agent/channels/discord-identity.js": {
+      "types": "./dist/agent/channels/discord-identity.d.ts",
+      "default": "./dist/agent/channels/discord-identity.js"
+    },
+    "./agent/channels/discord-interaction-defer.js": {
+      "types": "./dist/agent/channels/discord-interaction-defer.d.ts",
+      "default": "./dist/agent/channels/discord-interaction-defer.js"
+    },
+    "./agent/channels/discord-message-ops.js": {
+      "types": "./dist/agent/channels/discord-message-ops.d.ts",
+      "default": "./dist/agent/channels/discord-message-ops.js"
+    },
+    "./agent/channels/discord-origin-codec.js": {
+      "types": "./dist/agent/channels/discord-origin-codec.d.ts",
+      "default": "./dist/agent/channels/discord-origin-codec.js"
+    },
+    "./agent/channels/discord-post-arm.js": {
+      "types": "./dist/agent/channels/discord-post-arm.d.ts",
+      "default": "./dist/agent/channels/discord-post-arm.js"
+    },
+    "./agent/channels/discord-post.js": {
+      "types": "./dist/agent/channels/discord-post.d.ts",
+      "default": "./dist/agent/channels/discord-post.js"
+    },
+    "./agent/channels/discord-read.js": {
+      "types": "./dist/agent/channels/discord-read.d.ts",
+      "default": "./dist/agent/channels/discord-read.js"
+    },
+    "./agent/channels/discord-rest.js": {
+      "types": "./dist/agent/channels/discord-rest.d.ts",
+      "default": "./dist/agent/channels/discord-rest.js"
+    },
+    "./agent/channels/discord.js": {
+      "types": "./dist/agent/channels/discord.d.ts",
+      "default": "./dist/agent/channels/discord.js"
+    },
+    "./agent/commands/discord-command-sync.js": {
+      "types": "./dist/agent/commands/discord-command-sync.d.ts",
+      "default": "./dist/agent/commands/discord-command-sync.js"
+    },
+    "./agent/commands/discord-commands.js": {
+      "types": "./dist/agent/commands/discord-commands.d.ts",
+      "default": "./dist/agent/commands/discord-commands.js"
+    },
+    "./agent/contributions.js": {
+      "types": "./dist/agent/contributions.d.ts",
+      "default": "./dist/agent/contributions.js"
+    },
+    "./agent/docs-generated.js": {
+      "types": "./dist/agent/docs-generated.d.ts",
+      "default": "./dist/agent/docs-generated.js"
+    },
+    "./agent/identity/discord-link-consent.js": {
+      "types": "./dist/agent/identity/discord-link-consent.d.ts",
+      "default": "./dist/agent/identity/discord-link-consent.js"
+    },
+    "./agent/ops.js": {
+      "types": "./dist/agent/ops.d.ts",
+      "default": "./dist/agent/ops.js"
+    },
+    "./agent/provider-events.js": {
+      "types": "./dist/agent/provider-events.d.ts",
+      "default": "./dist/agent/provider-events.js"
+    },
+    "./agent/register.js": {
+      "types": "./dist/agent/register.d.ts",
+      "default": "./dist/agent/register.js"
+    },
+    "./agent/surface-parity.js": {
+      "types": "./dist/agent/surface-parity.d.ts",
+      "default": "./dist/agent/surface-parity.js"
+    }
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "typecheck": "tsc --noEmit -p tsconfig.json",
+    "test": "echo 'provider-discord: its test suite runs at the APP TIER (root scripts/) because the discord surface composes deeply with core internals (a custom gateway, admin approval cards, guild-admin bypass, routine dispatch) — see the root test chain (test:discord*, test:scenarios*, test:oe-commands, and the read/dispatch/audit/wake integration tests). This keeps the core adapter-api barrel a small port surface rather than exporting test-only internals.'"
+  },
+  "dependencies": {
+    "@open-everywhere/core": "0.1.0",
+    "zod": "4.5.4"
+  },
+  "peerDependencies": {
+    "eve": "0.54.3"
+  },
+  "devDependencies": {
+    "@types/node": "latest",
+    "tsx": "latest",
+    "typescript": "latest"
+  }
+}

package/tsconfig.build.json

@@ -0,0 +1,22 @@
+{
+  // PUBLISH BUILD (OPE-406). See packages/core/tsconfig.build.json for the full rationale: the
+  // sibling tsconfig.json stays noEmit (it is the typecheck gate and covers scripts/** too); this
+  // config emits ONLY the published surface (agent/**) into dist/, because a registry install
+  // cannot execute raw TypeScript and "eve build" evaluates the authored agent modules.
+  "extends": "./tsconfig.json",
+  "compilerOptions": {
+    "noEmit": false,
+    // Incremental: these run from every pre-hook (pretypecheck/pretest/prebuild), so a no-op
+    // rebuild has to be near-free or the gate chain pays a full tsc on every invocation.
+    "incremental": true,
+    // OUTSIDE outDir on purpose: a tsbuildinfo left in dist/ gets swept up by the files
+    // allowlist and PUBLISHED (caught by the tarball listing, 2026-08-12).
+    "tsBuildInfoFile": "./.tsbuildinfo",
+    "declaration": true,
+    "declarationMap": true,
+    "sourceMap": true,
+    "outDir": "dist",
+    "rootDir": "."
+  },
+  "include": ["agent/**/*.ts"]
+}

package/tsconfig.json

@@ -0,0 +1,15 @@
+{
+  "compilerOptions": {
+    "target": "ES2023",
+    "module": "NodeNext",
+    "moduleResolution": "NodeNext",
+    "lib": ["ES2023"],
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "noEmit": true,
+    "resolveJsonModule": true,
+    "types": ["node"]
+  },
+  "include": ["agent/**/*.ts", "scripts/**/*.ts"]
+}