discord-agent-bridge 0.1.0

package/dist/discord/renderers/diffView.test.js

@@ -0,0 +1,54 @@
+import { describe, it, expect } from 'vitest';
+import { DiffViewHandler } from './diffView.js';
+function fakeChannel() {
+    const sent = [];
+    const channel = {
+        async send(message) {
+            sent.push(message);
+            const em = { id: 'm1', async edit() { } };
+            return em;
+        },
+        async startThread() {
+            throw new Error('not used');
+        },
+    };
+    return { channel, sent };
+}
+const use = (e) => e;
+const result = (e) => e;
+describe('DiffViewHandler', () => {
+    it('renders an old→new diff for a successful Edit', async () => {
+        const { channel, sent } = fakeChannel();
+        const h = new DiffViewHandler({ channel });
+        h.noteToolUse(use({ kind: 'tool_use', id: 't1', name: 'Edit', input: { file_path: '/ws/a.ts', old_string: 'a', new_string: 'b' } }));
+        await h.handleResult(result({ kind: 'tool_result', id: 't1', ok: true, content: 'ok' }));
+        expect(sent).toHaveLength(1);
+        const body = sent[0].content ?? '';
+        expect(body).toContain('```diff');
+        expect(body).toContain('- a');
+        expect(body).toContain('+ b');
+    });
+    it('renders additions-only for a Write with content', async () => {
+        const { channel, sent } = fakeChannel();
+        const h = new DiffViewHandler({ channel });
+        h.noteToolUse(use({ kind: 'tool_use', id: 't2', name: 'Write', input: { file_path: '/ws/n.ts', content: 'line1\nline2' } }));
+        await h.handleResult(result({ kind: 'tool_result', id: 't2', ok: true, content: 'ok' }));
+        expect(sent[0].content).toContain('+ line1');
+        expect(sent[0].content).toContain('+ line2');
+    });
+    it('renders nothing for a non-edit tool', async () => {
+        const { channel, sent } = fakeChannel();
+        const h = new DiffViewHandler({ channel });
+        h.noteToolUse(use({ kind: 'tool_use', id: 't3', name: 'Bash', input: { command: 'ls' } }));
+        await h.handleResult(result({ kind: 'tool_result', id: 't3', ok: true, content: 'files' }));
+        expect(sent).toHaveLength(0);
+    });
+    it('renders nothing for a failed edit result', async () => {
+        const { channel, sent } = fakeChannel();
+        const h = new DiffViewHandler({ channel });
+        h.noteToolUse(use({ kind: 'tool_use', id: 't4', name: 'Edit', input: { file_path: '/ws/a.ts', old_string: 'a', new_string: 'b' } }));
+        await h.handleResult(result({ kind: 'tool_result', id: 't4', ok: false, content: 'error' }));
+        expect(sent).toHaveLength(0);
+    });
+});
+//# sourceMappingURL=diffView.test.js.map

package/dist/discord/renderers/diffView.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"diffView.test.js","sourceRoot":"","sources":["../../../src/discord/renderers/diffView.test.ts"],"names":[],"mappings":"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"}

package/dist/discord/renderers/index.js

@@ -0,0 +1,143 @@
+import { StreamEmbedHandler } from './streamEmbed.js';
+import { ToolThreadHandler } from './toolThread.js';
+import { PermissionButtonsHandler } from './permissionButtons.js';
+import { DiffViewHandler } from './diffView.js';
+import { TranscriptFeedHandler } from './transcriptFeed.js';
+import { MentionOnCompleteHandler } from './mentionOnComplete.js';
+import { buildResultLine } from './resultLine.js';
+import { buildUsageEmbed } from './usageEmbed.js';
+export class RendererDispatcher {
+    renderers;
+    capabilities;
+    constructor(renderers, capabilities) {
+        this.renderers = renderers;
+        this.capabilities = capabilities;
+    }
+    // Subscribe this dispatcher to a channel's event stream. Returns the unsubscribe.
+    subscribe(bus, guildId, channelId) {
+        return bus.on(guildId, channelId, (ev) => this.dispatch(ev));
+    }
+    // Capability-gated dispatch. This is the ONE place capabilities decide which
+    // renderer fires. A backend that lacks a capability simply has that path skipped;
+    // for text specifically, a non-streaming backend routes the final text to a plain
+    // message and progress to the transcript feed (Codex degraded UX, §5c).
+    dispatch(ev) {
+        const caps = this.capabilities;
+        switch (ev.kind) {
+            case 'text':
+                if (caps.streaming)
+                    this.renderers.stream(ev);
+                else
+                    this.renderers.plainText(ev);
+                break;
+            case 'thinking':
+                if (caps.thinking)
+                    this.renderers.stream(ev);
+                break;
+            case 'tool_use':
+            case 'tool_result':
+                if (caps.toolThreads)
+                    this.renderers.toolThread(ev);
+                if (caps.fileDiff)
+                    this.renderers.diff(ev);
+                break;
+            case 'permission_request':
+                if (caps.permissionPrompts)
+                    this.renderers.permission(ev);
+                break;
+            case 'progress':
+                if (caps.progress || caps.transcript)
+                    this.renderers.transcript(ev);
+                break;
+            case 'result':
+                // Non-streaming/transcript backends post their final text via the feed.
+                if (!caps.streaming && (caps.transcript || caps.progress))
+                    this.renderers.transcript(ev);
+                this.renderers.result(ev);
+                this.renderers.mention(ev);
+                break;
+            case 'context_usage':
+                if (caps.usagePanel)
+                    this.renderers.usage(ev);
+                break;
+            case 'error':
+                this.renderers.error(ev);
+                break;
+        }
+    }
+}
+// Wire the concrete handlers over one channel. Async handler work is fire-and-forget
+// with a swallowed rejection so a rendering hiccup never breaks the event stream —
+// the orchestrator's error events remain the user-visible failure signal.
+export function createDefaultRendererSet(options) {
+    const { channel, ownerId } = options;
+    const textStream = new StreamEmbedHandler({ channel, kind: 'text' });
+    const thinkingStream = new StreamEmbedHandler({ channel, kind: 'thinking' });
+    const toolThread = new ToolThreadHandler({ channel });
+    const permission = new PermissionButtonsHandler({ channel });
+    const diff = new DiffViewHandler({ channel });
+    const transcript = new TranscriptFeedHandler({ channel });
+    const mention = new MentionOnCompleteHandler({ channel, ownerId });
+    let lastCtxUsage = null;
+    const swallow = (p) => {
+        void p.catch(() => { });
+    };
+    return {
+        stream(ev) {
+            if (ev.kind === 'thinking')
+                thinkingStream.push(ev);
+            else
+                textStream.push(ev);
+        },
+        plainText(ev) {
+            swallow(channel.send({ content: ev.text }));
+        },
+        toolThread(ev) {
+            swallow(toolThread.handle(ev));
+        },
+        diff(ev) {
+            if (ev.kind === 'tool_use')
+                diff.noteToolUse(ev);
+            else
+                swallow(diff.handleResult(ev));
+        },
+        permission(ev) {
+            // The dispatcher path posts the buttons; the returned promise is resolved by
+            // the orchestrator's requestPermission hookup (7b). Here we just surface them.
+            swallow(permission.request(ev));
+        },
+        transcript(ev) {
+            swallow(transcript.handle(ev));
+        },
+        result(ev) {
+            // Finalize any open text stream before the done-line, so the answer lands first.
+            swallow(textStream.finalize().then(() => thinkingStream.finalize()));
+            const line = buildResultLine(ev);
+            if (line)
+                swallow(channel.send({ content: line }));
+        },
+        usage(ev) {
+            lastCtxUsage = ev;
+            const usage = options.getUsage?.() ?? null;
+            const embed = buildUsageEmbed(usage, lastCtxUsage);
+            if (embed)
+                swallow(channel.send({ embeds: [embed] }));
+        },
+        mention(ev) {
+            swallow(mention.handle(ev));
+        },
+        error(ev) {
+            swallow(channel.send({ content: `⚠️ ${ev.message}` }));
+        },
+        dispose() {
+            // Cancel the streaming/thinking debounce timers so a detach mid-stream cannot
+            // fire a late edit/send against a channel that is being torn down.
+            textStream.cancel();
+            thinkingStream.cancel();
+        },
+    };
+}
+// Re-export the permission handler for 7b to wire orchestrator.requestPermission
+// and button-interaction resolution (the request/resolve round-trip lives there).
+export { PermissionButtonsHandler } from './permissionButtons.js';
+//# sourceMappingURL=index.js.map

package/dist/discord/renderers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/discord/renderers/index.ts"],"names":[],"mappings":"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"}

package/dist/discord/renderers/index.test.js

@@ -0,0 +1,124 @@
+import { describe, it, expect, vi } from 'vitest';
+import { RendererDispatcher } from './index.js';
+// A spy renderer set: every action is a vi.fn() so a test asserts exactly which
+// renderer fired for a given event × capability combination.
+function spySet() {
+    return {
+        stream: vi.fn(),
+        plainText: vi.fn(),
+        toolThread: vi.fn(),
+        diff: vi.fn(),
+        permission: vi.fn(),
+        transcript: vi.fn(),
+        result: vi.fn(),
+        usage: vi.fn(),
+        mention: vi.fn(),
+        error: vi.fn(),
+    };
+}
+const claudeCaps = {
+    streaming: true,
+    thinking: true,
+    toolThreads: true,
+    permissionPrompts: true,
+    progress: false,
+    transcript: false,
+    sessionResume: true,
+    fileAttach: true,
+    fileDiff: true,
+    usagePanel: true,
+    permissionModes: ['default', 'acceptEdits', 'bypassPermissions', 'plan'],
+};
+const codexCaps = {
+    streaming: false,
+    thinking: false,
+    toolThreads: false,
+    permissionPrompts: false,
+    progress: true,
+    transcript: true,
+    sessionResume: true,
+    fileAttach: false,
+    fileDiff: false,
+    usagePanel: false,
+    permissionModes: ['default', 'acceptEdits', 'bypassPermissions', 'plan'],
+};
+const toolUse = { kind: 'tool_use', id: 't1', name: 'Edit', input: { file_path: '/ws/a' } };
+const permReq = { kind: 'permission_request', id: 'p1', toolName: 'Bash', input: {} };
+const textEv = { kind: 'text', text: 'hello', delta: true };
+const progressEv = { kind: 'progress', label: 'editing' };
+const ctxUsage = { kind: 'context_usage', totalTokens: 10, maxTokens: 100, percentage: 10 };
+describe('RendererDispatcher capability dispatch', () => {
+    it('fires toolThread for tool_use only when toolThreads is set', () => {
+        const set = spySet();
+        new RendererDispatcher(set, claudeCaps).dispatch(toolUse);
+        expect(set.toolThread).toHaveBeenCalledWith(toolUse);
+        const set2 = spySet();
+        new RendererDispatcher(set2, codexCaps).dispatch(toolUse);
+        expect(set2.toolThread).not.toHaveBeenCalled();
+    });
+    it('fires the diff renderer for tool_use only when fileDiff is set', () => {
+        const set = spySet();
+        new RendererDispatcher(set, claudeCaps).dispatch(toolUse);
+        expect(set.diff).toHaveBeenCalledWith(toolUse);
+        const set2 = spySet();
+        new RendererDispatcher(set2, codexCaps).dispatch(toolUse);
+        expect(set2.diff).not.toHaveBeenCalled();
+    });
+    it('fires permission buttons for permission_request only when permissionPrompts is set', () => {
+        const set = spySet();
+        new RendererDispatcher(set, claudeCaps).dispatch(permReq);
+        expect(set.permission).toHaveBeenCalledWith(permReq);
+        const set2 = spySet();
+        new RendererDispatcher(set2, codexCaps).dispatch(permReq);
+        expect(set2.permission).not.toHaveBeenCalled();
+    });
+    it('routes text to the stream embed when streaming is set', () => {
+        const set = spySet();
+        new RendererDispatcher(set, claudeCaps).dispatch(textEv);
+        expect(set.stream).toHaveBeenCalledWith(textEv);
+        expect(set.plainText).not.toHaveBeenCalled();
+    });
+    it('routes text to a plain message when streaming is NOT set (Codex-like)', () => {
+        const set = spySet();
+        new RendererDispatcher(set, codexCaps).dispatch(textEv);
+        expect(set.plainText).toHaveBeenCalledWith(textEv);
+        expect(set.stream).not.toHaveBeenCalled();
+    });
+    it('routes progress to the transcript feed for a transcript/progress backend', () => {
+        const set = spySet();
+        new RendererDispatcher(set, codexCaps).dispatch(progressEv);
+        expect(set.transcript).toHaveBeenCalledWith(progressEv);
+        // Claude (no progress/transcript) skips it.
+        const set2 = spySet();
+        new RendererDispatcher(set2, claudeCaps).dispatch(progressEv);
+        expect(set2.transcript).not.toHaveBeenCalled();
+    });
+    it('fires the usage panel for context_usage only when usagePanel is set', () => {
+        const set = spySet();
+        new RendererDispatcher(set, claudeCaps).dispatch(ctxUsage);
+        expect(set.usage).toHaveBeenCalledWith(ctxUsage);
+        const set2 = spySet();
+        new RendererDispatcher(set2, codexCaps).dispatch(ctxUsage);
+        expect(set2.usage).not.toHaveBeenCalled();
+    });
+    it('always fires result + mention on result; Codex additionally feeds final text to transcript', () => {
+        const resultEv = { kind: 'result', text: 'final', costUsd: 0.01 };
+        const claude = spySet();
+        new RendererDispatcher(claude, claudeCaps).dispatch(resultEv);
+        expect(claude.result).toHaveBeenCalledWith(resultEv);
+        expect(claude.mention).toHaveBeenCalledWith(resultEv);
+        expect(claude.transcript).not.toHaveBeenCalled();
+        const codex = spySet();
+        new RendererDispatcher(codex, codexCaps).dispatch(resultEv);
+        expect(codex.result).toHaveBeenCalledWith(resultEv);
+        expect(codex.mention).toHaveBeenCalledWith(resultEv);
+        expect(codex.transcript).toHaveBeenCalledWith(resultEv);
+    });
+    it('always surfaces errors regardless of capabilities', () => {
+        const errEv = { kind: 'error', message: 'boom', retryable: false };
+        const set = spySet();
+        new RendererDispatcher(set, codexCaps).dispatch(errEv);
+        expect(set.error).toHaveBeenCalledWith(errEv);
+    });
+});
+//# sourceMappingURL=index.test.js.map

package/dist/discord/renderers/index.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.test.js","sourceRoot":"","sources":["../../../src/discord/renderers/index.test.ts"],"names":[],"mappings":"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"}

package/dist/discord/renderers/mentionOnComplete.js

@@ -0,0 +1,19 @@
+export class MentionOnCompleteHandler {
+    channel;
+    ownerId;
+    constructor(deps) {
+        this.channel = deps.channel;
+        this.ownerId = deps.ownerId;
+    }
+    async handle(_ev) {
+        // No owner bound (e.g. a resumed binding missing its ownerId) → skip the mention
+        // rather than post a broken `<@>` that pings no one.
+        if (!this.ownerId)
+            return;
+        await this.channel.send({
+            content: `<@${this.ownerId}>`,
+            mentionUserIds: [this.ownerId],
+        });
+    }
+}
+//# sourceMappingURL=mentionOnComplete.js.map

package/dist/discord/renderers/mentionOnComplete.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mentionOnComplete.js","sourceRoot":"","sources":["../../../src/discord/renderers/mentionOnComplete.ts"],"names":[],"mappings":"AAYA,MAAM,OAAO,wBAAwB;IAClB,OAAO,CAAiB;IACxB,OAAO,CAAS;IAEjC,YAAY,IAA2B;QACrC,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC;QAC5B,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC;IAC9B,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,GAA4C;QACvD,iFAAiF;QACjF,qDAAqD;QACrD,IAAI,CAAC,IAAI,CAAC,OAAO;YAAE,OAAO;QAC1B,MAAM,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC;YACtB,OAAO,EAAE,KAAK,IAAI,CAAC,OAAO,GAAG;YAC7B,cAAc,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC;SAC/B,CAAC,CAAC;IACL,CAAC;CACF"}

package/dist/discord/renderers/mentionOnComplete.test.js

@@ -0,0 +1,35 @@
+import { describe, it, expect } from 'vitest';
+import { MentionOnCompleteHandler } from './mentionOnComplete.js';
+// A fake channel recording every sent message.
+function fakeChannel() {
+    const sent = [];
+    const channel = {
+        async send(message) {
+            sent.push(message);
+            const em = { id: `m${sent.length}`, async edit() { } };
+            return em;
+        },
+        async startThread() {
+            throw new Error('not used');
+        },
+    };
+    return { channel, sent };
+}
+const resultEv = { kind: 'result', text: 'done' };
+describe('MentionOnCompleteHandler', () => {
+    it('mentions the owner on completion when an ownerId is bound', async () => {
+        const { channel, sent } = fakeChannel();
+        const handler = new MentionOnCompleteHandler({ channel, ownerId: 'owner-9' });
+        await handler.handle(resultEv);
+        expect(sent).toHaveLength(1);
+        expect(sent[0].content).toBe('<@owner-9>');
+        expect(sent[0].mentionUserIds).toEqual(['owner-9']);
+    });
+    it('posts NO message when the ownerId is empty (no broken <@> ping)', async () => {
+        const { channel, sent } = fakeChannel();
+        const handler = new MentionOnCompleteHandler({ channel, ownerId: '' });
+        await handler.handle(resultEv);
+        expect(sent).toHaveLength(0);
+    });
+});
+//# sourceMappingURL=mentionOnComplete.test.js.map

package/dist/discord/renderers/mentionOnComplete.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mentionOnComplete.test.js","sourceRoot":"","sources":["../../../src/discord/renderers/mentionOnComplete.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,wBAAwB,EAAE,MAAM,wBAAwB,CAAC;AAIlE,+CAA+C;AAC/C,SAAS,WAAW;IAClB,MAAM,IAAI,GAAsB,EAAE,CAAC;IACnC,MAAM,OAAO,GAAmB;QAC9B,KAAK,CAAC,IAAI,CAAC,OAAO;YAChB,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YACnB,MAAM,EAAE,GAAoB,EAAE,EAAE,EAAE,IAAI,IAAI,CAAC,MAAM,EAAE,EAAE,KAAK,CAAC,IAAI,KAAI,CAAC,EAAE,CAAC;YACvE,OAAO,EAAE,CAAC;QACZ,CAAC;QACD,KAAK,CAAC,WAAW;YACf,MAAM,IAAI,KAAK,CAAC,UAAU,CAAC,CAAC;QAC9B,CAAC;KACF,CAAC;IACF,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;AAC3B,CAAC;AAED,MAAM,QAAQ,GAA4C,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;AAE3F,QAAQ,CAAC,0BAA0B,EAAE,GAAG,EAAE;IACxC,EAAE,CAAC,2DAA2D,EAAE,KAAK,IAAI,EAAE;QACzE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,WAAW,EAAE,CAAC;QACxC,MAAM,OAAO,GAAG,IAAI,wBAAwB,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC,CAAC;QAC9E,MAAM,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QAC/B,MAAM,CAAC,IAAI,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QAC7B,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QAC3C,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,OAAO,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC;IACtD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,iEAAiE,EAAE,KAAK,IAAI,EAAE;QAC/E,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,WAAW,EAAE,CAAC;QACxC,MAAM,OAAO,GAAG,IAAI,wBAAwB,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,CAAC;QACvE,MAAM,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QAC/B,MAAM,CAAC,IAAI,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;IAC/B,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/discord/renderers/permissionButtons.js

@@ -0,0 +1,150 @@
+import { COLORS, truncate } from '../format.js';
+import { t } from '../i18n.js';
+// Permission buttons (§6, §5a): a permission_request posts Allow / Always-Allow /
+// Deny buttons; the button interaction resolves the pending PermissionDecision.
+// custom_id scheme: `perm:<reqId>:<action>` where action ∈ allow|always|deny.
+//
+// This handler owns the pending map keyed by reqId. 7b wires two directions:
+//   - orchestrator.requestPermission → request(reqId, toolName, input) posts the
+//     buttons and returns a Promise<PermissionDecision> that resolves when the user
+//     clicks; the awaiting orchestrator turn is unblocked by that resolution.
+//   - a button interaction → resolve(customId) settles the matching pending promise.
+// No discord.js here: the sink is the MessageChannel port; interactions are parsed
+// by 7b and handed to resolve() as the raw custom_id string.
+const CUSTOM_ID_PREFIX = 'perm';
+export function buildCustomId(reqId, action) {
+    return `${CUSTOM_ID_PREFIX}:${reqId}:${action}`;
+}
+// Parse a `perm:<reqId>:<action>` custom_id. Returns null for a non-permission id
+// or an unknown action, so a foreign interaction is safely ignored by the caller.
+export function parseCustomId(customId) {
+    const parts = customId.split(':');
+    if (parts.length !== 3 || parts[0] !== CUSTOM_ID_PREFIX)
+        return null;
+    const [, reqId, action] = parts;
+    if (action !== 'allow' && action !== 'always' && action !== 'deny')
+        return null;
+    if (!reqId)
+        return null;
+    return { reqId, action };
+}
+export class PermissionButtonsHandler {
+    channel;
+    pending = new Map();
+    constructor(deps) {
+        this.channel = deps.channel;
+    }
+    // The tool name of a still-pending request, or null once it has resolved/expired.
+    // Lets the wiring layer read the tool for an always-allow persistence decision
+    // before resolve() removes the pending entry.
+    peekToolName(reqId) {
+        return this.pending.get(reqId)?.toolName ?? null;
+    }
+    // The approver bound to a still-pending request, or null when unbound/unknown.
+    peekApproverId(reqId) {
+        return this.pending.get(reqId)?.approverId ?? null;
+    }
+    // Post the buttons for a permission_request and return a promise that settles when
+    // the user decides. The pending resolver is registered SYNCHRONOUSLY (before the
+    // send completes) so a decision that races the post still resolves; the message
+    // handle used to disable the buttons is filled in once send resolves. `ev.id` is
+    // the AgentEvent id (stable across the round-trip). `approverId` binds the prompt
+    // to the one actor allowed to resolve it (the session owner/driver); when omitted
+    // the prompt is unbound (resolve() enforces no actor).
+    request(ev, approverId) {
+        const entry = {
+            resolve: () => { },
+            message: null,
+            toolName: ev.toolName,
+            approverId: approverId ?? null,
+        };
+        const decision = new Promise((resolve) => {
+            entry.resolve = resolve;
+        });
+        this.pending.set(ev.id, entry);
+        const embed = {
+            title: t('perm.request.title'),
+            description: t('perm.request.body', {
+                tool: ev.toolName,
+                input: truncate(formatInput(ev.input), 3000),
+            }),
+            color: COLORS.permission,
+        };
+        const buttons = [
+            { type: 'button', customId: buildCustomId(ev.id, 'allow'), label: t('perm.button.allow'), style: 'success' },
+            { type: 'button', customId: buildCustomId(ev.id, 'always'), label: t('perm.button.always'), style: 'primary' },
+            { type: 'button', customId: buildCustomId(ev.id, 'deny'), label: t('perm.button.deny'), style: 'danger' },
+        ];
+        void this.channel
+            .send({ embeds: [embed], components: [{ components: buttons }] })
+            .then((message) => {
+            // If the user already decided (entry removed), leave the message as-is.
+            if (this.pending.get(ev.id) === entry)
+                entry.message = message;
+        })
+            .catch(() => { });
+        return decision;
+    }
+    // Settle a pending request from a button custom_id. Returns the decision applied,
+    // or null if the id is unknown/foreign/already-resolved (idempotent, safe to call
+    // on any interaction). When the prompt is bound to an approver and `actorId` is
+    // supplied, an actor other than the approver is IGNORED (returns null, prompt stays
+    // pending) — a bystander cannot resolve another driver's prompt (§7.1/§7.5).
+    // Disables the buttons and marks the outcome on resolve.
+    async resolve(customId, actorId) {
+        const parsed = parseCustomId(customId);
+        if (!parsed)
+            return null;
+        const entry = this.pending.get(parsed.reqId);
+        if (!entry)
+            return null;
+        // Enforce the approver binding: if the prompt is bound and the caller passed an
+        // actor id, only that actor may resolve it. Leave the entry pending otherwise.
+        if (entry.approverId !== null && actorId !== undefined && actorId !== entry.approverId) {
+            return null;
+        }
+        this.pending.delete(parsed.reqId);
+        const decision = parsed.action === 'deny'
+            ? { behavior: 'deny', message: 'User denied via Discord' }
+            : { behavior: 'allow' };
+        const decidedKey = parsed.action === 'deny'
+            ? 'perm.decided.deny'
+            : parsed.action === 'always'
+                ? 'perm.decided.always'
+                : 'perm.decided.allow';
+        // Collapse the prompt: disable buttons and note the outcome so the record is
+        // clear and the buttons cannot be re-clicked. If the buttons message has not
+        // finished posting yet (a decision that raced the send), skip the edit — the
+        // decision still resolves below.
+        if (entry.message) {
+            await entry.message.edit({
+                embeds: [
+                    {
+                        title: `${t('perm.request.title')} — ${t(decidedKey)}`,
+                        description: t('perm.request.body', {
+                            tool: entry.toolName,
+                            input: t(decidedKey),
+                        }),
+                        color: parsed.action === 'deny' ? COLORS.stopped : COLORS.idle,
+                    },
+                ],
+                components: [],
+            });
+        }
+        entry.resolve(decision);
+        // `always` is surfaced as allow here; 7b/8 persists the always-allow set into
+        // the resolved tool allowlist (config-driven auto-allow, §7A) — not this layer's job.
+        return decision;
+    }
+}
+function formatInput(input) {
+    if (typeof input === 'string')
+        return input;
+    try {
+        return '```json\n' + JSON.stringify(input, null, 2) + '\n```';
+    }
+    catch {
+        return String(input);
+    }
+}
+//# sourceMappingURL=permissionButtons.js.map

package/dist/discord/renderers/permissionButtons.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"permissionButtons.js","sourceRoot":"","sources":["../../../src/discord/renderers/permissionButtons.ts"],"names":[],"mappings":"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"}