@qwen-code/channel-base 0.14.0-nightly.20260402.a5f17ee39

package/dist/BlockStreamer.js

@@ -0,0 +1,115 @@
+/**
+ * BlockStreamer — progressive multi-message delivery for channels.
+ *
+ * Accumulates text chunks from the agent's streaming response and emits
+ * completed "blocks" (paragraphs / sections) as separate channel messages
+ * while the agent is still working. This gives users a natural conversation
+ * flow instead of waiting 30–120 seconds for a single wall of text.
+ *
+ * Emission triggers:
+ *  1. Buffer ≥ maxChars → force-split at best break point
+ *  2. Buffer ≥ minChars AND a paragraph boundary (\n\n) exists → emit up to boundary
+ *  3. Idle timer fires (no chunk for idleMs) AND buffer ≥ minChars → emit buffer
+ *  4. flush() called (response complete) → emit everything remaining
+ *
+ * All sends are serialized — the next block waits for the previous send to complete.
+ */
+export class BlockStreamer {
+    buffer = '';
+    idleTimer = null;
+    sending = Promise.resolve();
+    opts;
+    /** Number of blocks emitted so far. */
+    blockCount = 0;
+    constructor(opts) {
+        this.opts = opts;
+    }
+    /** Feed a new text chunk from the agent stream. */
+    push(chunk) {
+        this.buffer += chunk;
+        this.clearIdleTimer();
+        this.checkEmit();
+        if (this.buffer.length > 0 && this.opts.idleMs > 0) {
+            this.idleTimer = setTimeout(() => this.onIdle(), this.opts.idleMs);
+        }
+    }
+    /** Flush all remaining buffered text. Awaits all pending sends. */
+    async flush() {
+        this.clearIdleTimer();
+        if (this.buffer.length > 0) {
+            this.emitBlock(this.buffer);
+            this.buffer = '';
+        }
+        await this.sending;
+    }
+    // ---------------------------------------------------------------------------
+    // Internal
+    // ---------------------------------------------------------------------------
+    checkEmit() {
+        // 1. Force-split if buffer exceeds maxChars
+        while (this.buffer.length >= this.opts.maxChars) {
+            const bp = this.findBreakPoint(this.buffer, this.opts.maxChars);
+            this.emitBlock(this.buffer.slice(0, bp));
+            this.buffer = this.buffer.slice(bp);
+        }
+        // 2. Emit at paragraph boundary if we have enough text
+        if (this.buffer.length >= this.opts.minChars) {
+            const bp = this.findBlockBoundary(this.buffer);
+            if (bp > 0) {
+                this.emitBlock(this.buffer.slice(0, bp));
+                this.buffer = this.buffer.slice(bp);
+            }
+        }
+    }
+    onIdle() {
+        this.idleTimer = null;
+        if (this.buffer.length >= this.opts.minChars) {
+            this.emitBlock(this.buffer);
+            this.buffer = '';
+        }
+    }
+    emitBlock(text) {
+        const trimmed = text.trim();
+        if (!trimmed)
+            return;
+        this.blockCount++;
+        this.sending = this.sending
+            .then(() => this.opts.send(trimmed))
+            .catch(() => { });
+    }
+    /**
+     * Find the last paragraph boundary (\n\n) in the buffer.
+     * Returns the position after the boundary, or -1 if no suitable boundary
+     * exists at or after minChars.
+     */
+    findBlockBoundary(text) {
+        const last = text.lastIndexOf('\n\n');
+        if (last < 0 || last < this.opts.minChars)
+            return -1;
+        return last + 2;
+    }
+    /**
+     * Find the best break point at or before maxPos.
+     * Prefers paragraph break > newline > space > maxPos.
+     */
+    findBreakPoint(text, maxPos) {
+        const sub = text.slice(0, maxPos);
+        const para = sub.lastIndexOf('\n\n');
+        if (para > 0)
+            return para + 2;
+        const nl = sub.lastIndexOf('\n');
+        if (nl > 0)
+            return nl + 1;
+        const sp = sub.lastIndexOf(' ');
+        if (sp > 0)
+            return sp + 1;
+        return maxPos;
+    }
+    clearIdleTimer() {
+        if (this.idleTimer !== null) {
+            clearTimeout(this.idleTimer);
+            this.idleTimer = null;
+        }
+    }
+}
+//# sourceMappingURL=BlockStreamer.js.map

package/dist/BlockStreamer.js.map

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

package/dist/ChannelBase.d.ts

@@ -0,0 +1,74 @@
+import type { ChannelConfig, Envelope } from './types.js';
+import { GroupGate } from './GroupGate.js';
+import { SenderGate } from './SenderGate.js';
+import { SessionRouter } from './SessionRouter.js';
+import type { AcpBridge, ToolCallEvent } from './AcpBridge.js';
+export interface ChannelBaseOptions {
+    router?: SessionRouter;
+}
+/** Handler for a slash command. Return true if handled, false to forward to agent. */
+type CommandHandler = (envelope: Envelope, args: string) => Promise<boolean>;
+export declare abstract class ChannelBase {
+    protected config: ChannelConfig;
+    protected bridge: AcpBridge;
+    protected groupGate: GroupGate;
+    protected gate: SenderGate;
+    protected router: SessionRouter;
+    protected name: string;
+    private instructedSessions;
+    private commands;
+    /** Per-session promise chain to serialize prompt + send (followup mode). */
+    private sessionQueues;
+    /** Per-session active prompt tracking for dispatch modes. */
+    private activePrompts;
+    /** Per-session message buffer for collect mode. */
+    private collectBuffers;
+    constructor(name: string, config: ChannelConfig, bridge: AcpBridge, options?: ChannelBaseOptions);
+    abstract connect(): Promise<void>;
+    abstract sendMessage(chatId: string, text: string): Promise<void>;
+    abstract disconnect(): void;
+    /** Replace the bridge instance (used after crash recovery restart). */
+    setBridge(bridge: AcpBridge): void;
+    onToolCall(_chatId: string, _event: ToolCallEvent): void;
+    /**
+     * Called when a prompt actually begins processing (inside the session queue).
+     * Override to show a platform-specific working indicator (e.g., typing, reaction).
+     * Not called for buffered messages (collect mode) or gated/blocked messages.
+     */
+    protected onPromptStart(_chatId: string, _sessionId: string, _messageId?: string): void;
+    /**
+     * Called when a prompt finishes (response sent or cancelled).
+     * Override to hide the working indicator.
+     */
+    protected onPromptEnd(_chatId: string, _sessionId: string, _messageId?: string): void;
+    /**
+     * Called for each text chunk as the agent streams its response.
+     * Override to implement progressive display (e.g., updating an AI card in-place).
+     * Default: no-op (chunks are collected internally and delivered via onResponseComplete).
+     */
+    protected onResponseChunk(_chatId: string, _chunk: string, _sessionId: string): void;
+    /**
+     * Called when the agent's full response is ready.
+     * Override to customize delivery (e.g., finalize an AI card).
+     * Default: calls sendMessage() with the full response text.
+     */
+    protected onResponseComplete(chatId: string, fullText: string, _sessionId: string): Promise<void>;
+    /**
+     * Register a slash command handler. Subclasses can call this to add
+     * platform-specific commands (e.g., /start for Telegram).
+     * Overrides shared commands if the same name is registered.
+     */
+    protected registerCommand(name: string, handler: CommandHandler): void;
+    /** Register shared slash commands. Called from constructor. */
+    private registerSharedCommands;
+    /** Check if a message text matches a registered local command. */
+    protected isLocalCommand(text: string): boolean;
+    /**
+     * Parse a slash command from message text.
+     * Returns { command, args } or null if not a slash command.
+     */
+    private parseCommand;
+    handleInbound(envelope: Envelope): Promise<void>;
+    protected onPairingRequired(chatId: string, code: string | null): Promise<void>;
+}
+export {};

package/dist/ChannelBase.js

@@ -0,0 +1,332 @@
+import { BlockStreamer } from './BlockStreamer.js';
+import { GroupGate } from './GroupGate.js';
+import { SenderGate } from './SenderGate.js';
+import { PairingStore } from './PairingStore.js';
+import { SessionRouter } from './SessionRouter.js';
+export class ChannelBase {
+    config;
+    bridge;
+    groupGate;
+    gate;
+    router;
+    name;
+    instructedSessions = new Set();
+    commands = new Map();
+    /** Per-session promise chain to serialize prompt + send (followup mode). */
+    sessionQueues = new Map();
+    /** Per-session active prompt tracking for dispatch modes. */
+    activePrompts = new Map();
+    /** Per-session message buffer for collect mode. */
+    collectBuffers = new Map();
+    constructor(name, config, bridge, options) {
+        this.name = name;
+        this.config = config;
+        this.bridge = bridge;
+        this.groupGate = new GroupGate(config.groupPolicy, config.groups);
+        const pairingStore = config.senderPolicy === 'pairing' ? new PairingStore(name) : undefined;
+        this.gate = new SenderGate(config.senderPolicy, config.allowedUsers, pairingStore);
+        this.router =
+            options?.router ||
+                new SessionRouter(bridge, config.cwd, config.sessionScope);
+        this.registerSharedCommands();
+        // When running standalone (no gateway), register toolCall listener directly.
+        // In gateway mode, the ChannelManager dispatches events instead.
+        if (!options?.router) {
+            bridge.on('toolCall', (event) => {
+                const target = this.router.getTarget(event.sessionId);
+                if (target) {
+                    this.onToolCall(target.chatId, event);
+                }
+            });
+        }
+    }
+    /** Replace the bridge instance (used after crash recovery restart). */
+    setBridge(bridge) {
+        this.bridge = bridge;
+    }
+    onToolCall(_chatId, _event) { }
+    /**
+     * Called when a prompt actually begins processing (inside the session queue).
+     * Override to show a platform-specific working indicator (e.g., typing, reaction).
+     * Not called for buffered messages (collect mode) or gated/blocked messages.
+     */
+    onPromptStart(_chatId, _sessionId, _messageId) { }
+    /**
+     * Called when a prompt finishes (response sent or cancelled).
+     * Override to hide the working indicator.
+     */
+    onPromptEnd(_chatId, _sessionId, _messageId) { }
+    /**
+     * Called for each text chunk as the agent streams its response.
+     * Override to implement progressive display (e.g., updating an AI card in-place).
+     * Default: no-op (chunks are collected internally and delivered via onResponseComplete).
+     */
+    onResponseChunk(_chatId, _chunk, _sessionId) { }
+    /**
+     * Called when the agent's full response is ready.
+     * Override to customize delivery (e.g., finalize an AI card).
+     * Default: calls sendMessage() with the full response text.
+     */
+    async onResponseComplete(chatId, fullText, _sessionId) {
+        await this.sendMessage(chatId, fullText);
+    }
+    /**
+     * Register a slash command handler. Subclasses can call this to add
+     * platform-specific commands (e.g., /start for Telegram).
+     * Overrides shared commands if the same name is registered.
+     */
+    registerCommand(name, handler) {
+        this.commands.set(name.toLowerCase(), handler);
+    }
+    /** Register shared slash commands. Called from constructor. */
+    registerSharedCommands() {
+        const clearHandler = async (envelope) => {
+            const removedIds = this.router.removeSession(this.name, envelope.senderId, envelope.chatId);
+            if (removedIds.length > 0) {
+                for (const id of removedIds) {
+                    this.instructedSessions.delete(id);
+                }
+                await this.sendMessage(envelope.chatId, 'Session cleared. Your next message will start a fresh conversation.');
+            }
+            else {
+                await this.sendMessage(envelope.chatId, 'No active session to clear.');
+            }
+            return true;
+        };
+        this.registerCommand('clear', clearHandler);
+        this.registerCommand('reset', clearHandler);
+        this.registerCommand('new', clearHandler);
+        this.registerCommand('help', async (envelope) => {
+            const lines = [
+                'Commands:',
+                '/help — Show this help',
+                '/clear — Clear your session (aliases: /reset, /new)',
+                '/status — Show session info',
+            ];
+            // Platform-specific commands (registered by adapters, not shared ones)
+            const sharedCmds = new Set(['help', 'clear', 'reset', 'new', 'status']);
+            const platformCmds = [...this.commands.keys()].filter((c) => !sharedCmds.has(c));
+            if (platformCmds.length > 0) {
+                for (const cmd of platformCmds) {
+                    lines.push(`/${cmd}`);
+                }
+            }
+            const agentCommands = this.bridge.availableCommands;
+            if (agentCommands.length > 0) {
+                lines.push('', 'Agent commands (forwarded to Qwen Code):');
+                for (const cmd of agentCommands) {
+                    lines.push(`/${cmd.name} — ${cmd.description}`);
+                }
+            }
+            lines.push('', 'Send any text to chat with the agent.');
+            await this.sendMessage(envelope.chatId, lines.join('\n'));
+            return true;
+        });
+        this.registerCommand('status', async (envelope) => {
+            const hasSession = this.router.hasSession(this.name, envelope.senderId, envelope.chatId);
+            const policy = this.config.senderPolicy;
+            const lines = [
+                `Session: ${hasSession ? 'active' : 'none'}`,
+                `Access: ${policy}`,
+                `Channel: ${this.name}`,
+            ];
+            await this.sendMessage(envelope.chatId, lines.join('\n'));
+            return true;
+        });
+    }
+    /** Check if a message text matches a registered local command. */
+    isLocalCommand(text) {
+        const parsed = this.parseCommand(text);
+        return parsed !== null && this.commands.has(parsed.command);
+    }
+    /**
+     * Parse a slash command from message text.
+     * Returns { command, args } or null if not a slash command.
+     */
+    parseCommand(text) {
+        if (!text.startsWith('/'))
+            return null;
+        // Handle /command@botname format (Telegram groups)
+        const match = text.match(/^\/([a-zA-Z0-9_]+)(?:@\S+)?\s*(.*)/s);
+        if (!match)
+            return null;
+        return { command: match[1].toLowerCase(), args: match[2].trim() };
+    }
+    async handleInbound(envelope) {
+        // 1. Group gate: policy + allowlist + mention gating
+        const groupResult = this.groupGate.check(envelope);
+        if (!groupResult.allowed) {
+            return; // silently drop — no pairing, no reply
+        }
+        // 2. Sender gate: allowlist / pairing / open
+        const result = this.gate.check(envelope.senderId, envelope.senderName);
+        if (!result.allowed) {
+            if (result.pairingCode !== undefined) {
+                await this.onPairingRequired(envelope.chatId, result.pairingCode);
+            }
+            return;
+        }
+        // 3. Slash command handling — before session/agent routing
+        const parsed = this.parseCommand(envelope.text);
+        if (parsed) {
+            const handler = this.commands.get(parsed.command);
+            if (handler) {
+                const handled = await handler(envelope, parsed.args);
+                if (handled)
+                    return;
+            }
+            // Unrecognized commands fall through to the agent
+        }
+        const sessionId = await this.router.resolve(this.name, envelope.senderId, envelope.chatId, envelope.threadId, this.config.cwd);
+        // Prepend referenced (quoted) message text for reply context
+        let promptText = envelope.text;
+        if (envelope.referencedText) {
+            promptText = `[Replying to: "${envelope.referencedText}"]\n\n${promptText}`;
+        }
+        // Resolve attachments: extract image for bridge, append file paths to text
+        let imageBase64 = envelope.imageBase64;
+        let imageMimeType = envelope.imageMimeType;
+        if (envelope.attachments?.length) {
+            const filePaths = [];
+            for (const att of envelope.attachments) {
+                if (att.type === 'image' && att.data && !imageBase64) {
+                    imageBase64 = att.data;
+                    imageMimeType = att.mimeType;
+                }
+                else if (att.filePath) {
+                    const label = att.type === 'file' ? 'file' : att.type;
+                    const name = att.fileName ? ` "${att.fileName}"` : '';
+                    filePaths.push(`User sent a ${label}${name}. It has been saved to: ${att.filePath}`);
+                }
+            }
+            if (filePaths.length > 0) {
+                promptText = promptText + '\n\n' + filePaths.join('\n');
+            }
+        }
+        // Prepend channel instructions on first message of a session
+        if (this.config.instructions && !this.instructedSessions.has(sessionId)) {
+            promptText = `${this.config.instructions}\n\n${promptText}`;
+            this.instructedSessions.add(sessionId);
+        }
+        // Resolve dispatch mode: per-group override → channel config → default
+        const groupCfg = envelope.isGroup
+            ? this.config.groups[envelope.chatId] || this.config.groups['*']
+            : undefined;
+        const mode = groupCfg?.dispatchMode || this.config.dispatchMode || 'steer';
+        const active = this.activePrompts.get(sessionId);
+        if (active) {
+            // A prompt is already running for this session
+            switch (mode) {
+                case 'collect': {
+                    // Buffer the message; it will be coalesced when the active prompt finishes
+                    let buffer = this.collectBuffers.get(sessionId);
+                    if (!buffer) {
+                        buffer = [];
+                        this.collectBuffers.set(sessionId, buffer);
+                    }
+                    buffer.push({ text: promptText, envelope });
+                    return;
+                }
+                case 'steer': {
+                    // Cancel the running prompt, then fall through to send a new one
+                    active.cancelled = true;
+                    await this.bridge.cancelSession(sessionId).catch(() => { });
+                    // Wait for the active prompt to finish winding down
+                    await active.done;
+                    // Prepend a cancellation note so the agent understands context
+                    promptText = `[The user sent a new message while you were working. Their previous request has been cancelled.]\n\n${promptText}`;
+                    break;
+                }
+                case 'followup': {
+                    // Chain onto the session queue (existing sequential behavior)
+                    break;
+                }
+                default: {
+                    // Exhaustive check — should never happen
+                    const _exhaustive = mode;
+                    throw new Error(`Unknown dispatch mode: ${_exhaustive}`);
+                }
+            }
+        }
+        // Run the prompt (with followup-mode serialization for safety)
+        const prev = this.sessionQueues.get(sessionId) ?? Promise.resolve();
+        const useBlockStreaming = this.config.blockStreaming === 'on';
+        const current = prev.then(async () => {
+            // Register this prompt as active
+            let doneResolve = () => { };
+            const done = new Promise((r) => {
+                doneResolve = r;
+            });
+            const promptState = { cancelled: false, done, resolve: doneResolve };
+            this.activePrompts.set(sessionId, promptState);
+            this.onPromptStart(envelope.chatId, sessionId, envelope.messageId);
+            const streamer = useBlockStreaming
+                ? new BlockStreamer({
+                    minChars: this.config.blockStreamingChunk?.minChars ?? 400,
+                    maxChars: this.config.blockStreamingChunk?.maxChars ?? 1000,
+                    idleMs: this.config.blockStreamingCoalesce?.idleMs ?? 1500,
+                    send: (text) => this.sendMessage(envelope.chatId, text),
+                })
+                : null;
+            const onChunk = (sid, chunk) => {
+                if (sid === sessionId) {
+                    this.onResponseChunk(envelope.chatId, chunk, sessionId);
+                    streamer?.push(chunk);
+                }
+            };
+            this.bridge.on('textChunk', onChunk);
+            try {
+                const response = await this.bridge.prompt(sessionId, promptText, {
+                    imageBase64,
+                    imageMimeType,
+                });
+                // If cancelled (steer mode), skip sending the response
+                if (!promptState.cancelled && response) {
+                    if (streamer) {
+                        await streamer.flush();
+                    }
+                    else {
+                        await this.onResponseComplete(envelope.chatId, response, sessionId);
+                    }
+                }
+            }
+            finally {
+                this.bridge.off('textChunk', onChunk);
+                this.onPromptEnd(envelope.chatId, sessionId, envelope.messageId);
+                this.activePrompts.delete(sessionId);
+                // Signal any steer waiter that we're done
+                promptState.resolve();
+                // Drain collect buffer if any messages accumulated
+                const buffer = this.collectBuffers.get(sessionId);
+                if (buffer && buffer.length > 0) {
+                    this.collectBuffers.delete(sessionId);
+                    const coalesced = buffer.map((b) => b.text).join('\n\n');
+                    const lastEnvelope = buffer[buffer.length - 1].envelope;
+                    // Re-enter handleInbound with the coalesced message
+                    const syntheticEnvelope = {
+                        ...lastEnvelope,
+                        text: coalesced,
+                        // Clear attachments/references — already resolved in original text
+                        referencedText: undefined,
+                        attachments: undefined,
+                        imageBase64: undefined,
+                        imageMimeType: undefined,
+                    };
+                    // Queue the coalesced prompt (don't await to avoid deadlock on the queue)
+                    this.handleInbound(syntheticEnvelope).catch(() => { });
+                }
+            }
+        });
+        this.sessionQueues.set(sessionId, current.catch(() => { }));
+        await current;
+    }
+    async onPairingRequired(chatId, code) {
+        if (code) {
+            await this.sendMessage(chatId, `Your pairing code is: ${code}\n\nAsk the bot operator to approve you with:\n  qwen channel pairing approve ${this.name} ${code}`);
+        }
+        else {
+            await this.sendMessage(chatId, 'Too many pending pairing requests. Please try again later.');
+        }
+    }
+}
+//# sourceMappingURL=ChannelBase.js.map

package/dist/ChannelBase.js.map

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

package/dist/GroupGate.d.ts

@@ -0,0 +1,21 @@
+import type { GroupPolicy, GroupConfig, Envelope } from './types.js';
+export interface GroupCheckResult {
+    allowed: boolean;
+    reason?: 'disabled' | 'not_allowlisted' | 'mention_required';
+}
+export declare class GroupGate {
+    private policy;
+    private groups;
+    constructor(policy?: GroupPolicy, groups?: Record<string, GroupConfig>);
+    /**
+     * Full group check: policy + allowlist + mention gating.
+     * Evaluation order:
+     *   1. groupPolicy (disabled → drop)
+     *   2. group allowlist (allowlist mode, no match → drop)
+     *   3. mention gating (requireMention + not mentioned → drop silently)
+     *
+     * Mention gating runs before sender gate so that unmentioned messages
+     * in groups don't trigger pairing flows.
+     */
+    check(envelope: Envelope): GroupCheckResult;
+}

package/dist/GroupGate.js

@@ -0,0 +1,41 @@
+export class GroupGate {
+    policy;
+    groups;
+    constructor(policy = 'disabled', groups = {}) {
+        this.policy = policy;
+        this.groups = groups;
+    }
+    /**
+     * Full group check: policy + allowlist + mention gating.
+     * Evaluation order:
+     *   1. groupPolicy (disabled → drop)
+     *   2. group allowlist (allowlist mode, no match → drop)
+     *   3. mention gating (requireMention + not mentioned → drop silently)
+     *
+     * Mention gating runs before sender gate so that unmentioned messages
+     * in groups don't trigger pairing flows.
+     */
+    check(envelope) {
+        if (!envelope.isGroup) {
+            return { allowed: true };
+        }
+        if (this.policy === 'disabled') {
+            return { allowed: false, reason: 'disabled' };
+        }
+        if (this.policy === 'allowlist') {
+            // In allowlist mode, "*" is only a default config — not a wildcard allow.
+            // The group must be explicitly listed by ID.
+            if (!this.groups[envelope.chatId]) {
+                return { allowed: false, reason: 'not_allowlisted' };
+            }
+        }
+        // Per-group config, falling back to "*" defaults, then built-in defaults
+        const groupConfig = this.groups[envelope.chatId] || this.groups['*'] || {};
+        const requireMention = groupConfig.requireMention ?? true;
+        if (requireMention && !envelope.isMentioned && !envelope.isReplyToBot) {
+            return { allowed: false, reason: 'mention_required' };
+        }
+        return { allowed: true };
+    }
+}
+//# sourceMappingURL=GroupGate.js.map

package/dist/GroupGate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GroupGate.js","sourceRoot":"","sources":["../src/GroupGate.ts"],"names":[],"mappings":"AAOA,MAAM,OAAO,SAAS;IACZ,MAAM,CAAc;IACpB,MAAM,CAA8B;IAE5C,YACE,SAAsB,UAAU,EAChC,SAAsC,EAAE;QAExC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;IAED;;;;;;;;;OASG;IACH,KAAK,CAAC,QAAkB;QACtB,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC;YACtB,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;QAC3B,CAAC;QAED,IAAI,IAAI,CAAC,MAAM,KAAK,UAAU,EAAE,CAAC;YAC/B,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC;QAChD,CAAC;QAED,IAAI,IAAI,CAAC,MAAM,KAAK,WAAW,EAAE,CAAC;YAChC,0EAA0E;YAC1E,6CAA6C;YAC7C,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;gBAClC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,iBAAiB,EAAE,CAAC;YACvD,CAAC;QACH,CAAC;QAED,yEAAyE;QACzE,MAAM,WAAW,GAAG,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC;QAC3E,MAAM,cAAc,GAAG,WAAW,CAAC,cAAc,IAAI,IAAI,CAAC;QAE1D,IAAI,cAAc,IAAI,CAAC,QAAQ,CAAC,WAAW,IAAI,CAAC,QAAQ,CAAC,YAAY,EAAE,CAAC;YACtE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,kBAAkB,EAAE,CAAC;QACxD,CAAC;QAED,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IAC3B,CAAC;CACF"}

package/dist/PairingStore.d.ts

@@ -0,0 +1,31 @@
+export interface PairingRequest {
+    senderId: string;
+    senderName: string;
+    code: string;
+    createdAt: number;
+}
+export declare class PairingStore {
+    private dir;
+    private pendingPath;
+    private allowlistPath;
+    constructor(channelName: string);
+    isApproved(senderId: string): boolean;
+    /**
+     * Create a pairing request for an unknown sender.
+     * Returns the code if created, or null if the pending cap is reached.
+     * If the sender already has a non-expired pending request, returns that code.
+     */
+    createRequest(senderId: string, senderName: string): string | null;
+    /**
+     * Approve a pairing request by code.
+     * Returns the sender ID if found, or null if not found / expired.
+     */
+    approve(code: string): PairingRequest | null;
+    listPending(): PairingRequest[];
+    getAllowlist(): string[];
+    private ensureDir;
+    private readPending;
+    private writePending;
+    private readAllowlist;
+    private writeAllowlist;
+}