@ashx-j/lunr 0.1.0

package/dist/gateway/router.js

@@ -0,0 +1,215 @@
+/**
+ * lunR: gateway router.
+ *
+ * Every inbound MessageEvent flows through handleEvent:
+ *   1. group gating (allowedChats / freeResponseChats / requireMention,
+ *      with adapter-supplied metadata.mentionedBot)
+ *   2. authorization (authz.ts); denied DMs get a pairing code when the
+ *      behavior is "pair" and the user isn't rate-limited
+ *   3. command registry (/new, /undo, /redo, /model, /sessions, /title,
+ *      /context, /swarm, /compact, /thinking, /stop, /status, /help, /whoami)
+ *   4. normal path: bridge.runTurn with a StreamConsumer when streaming is
+ *      enabled and the adapter supports edit; the final text is
+ *      silence-filtered and folded INTO the streaming preview (edit, plus
+ *      continuation chunks when the preview was truncated) — no preview +
+ *      final double-send. Without streaming it is split (text.ts) and sent
+ *      sequentially, the first chunk replying to the triggering message.
+ * Errors surface as a compact "⚠ <one-line>" — never a stack trace.
+ */
+import { existsSync } from "node:fs";
+import { QUEUED } from "./agent-bridge.js";
+import { registerGatewayApprovalHandler, runWithApprovalContext } from "./approval.js";
+import { isAuthorized } from "./authz.js";
+import { CHAT_COMMANDS, runChatCommand, sendCommandReply } from "./commands.js";
+import { gatewayConfigPath, loadGatewayConfig, platformConfigFor } from "./config.js";
+import { buildSessionKey } from "./session-keys.js";
+import { applySilenceFilter, StreamConsumer } from "./stream.js";
+import { splitMessage } from "./text.js";
+function oneLine(text) {
+    return text.replace(/\s+/g, " ").trim().slice(0, 200);
+}
+function formatPairingCode(code) {
+    return code.length === 8 ? `${code.slice(0, 4)}-${code.slice(4)}` : code;
+}
+function mentionedBot(event) {
+    return event.metadata?.mentionedBot === true;
+}
+export function createRouter(deps) {
+    const { adapters, cfg: initialCfg, pairing, bridge, reloadConfig } = deps;
+    // lunr: headless gateway sessions must prompt for mutating tools in manual mode.
+    registerGatewayApprovalHandler();
+    /** Reload gateway.json on every inbound event so CLI edits (e.g. pair approve) take effect immediately. */
+    function freshCfg() {
+        if (!reloadConfig)
+            return initialCfg;
+        try {
+            if (existsSync(gatewayConfigPath())) {
+                return loadGatewayConfig();
+            }
+        }
+        catch {
+            // fall through to initial config
+        }
+        return initialCfg;
+    }
+    async function sendError(adapter, event, message) {
+        await adapter.send(event.source.chatId, `⚠ ${oneLine(message)}`, {
+            replyTo: event.messageId,
+            threadId: event.source.threadId,
+        });
+    }
+    /** Step 1: group-chat early gating. Returns true when the event must be dropped. */
+    function isGroupGated(event, cfg) {
+        const { source } = event;
+        if (source.chatType === "dm")
+            return false;
+        const platformCfg = platformConfigFor(cfg, source.platform);
+        if (!platformCfg)
+            return true;
+        const freeResponse = platformCfg.freeResponseChats.includes(source.chatId);
+        if (platformCfg.allowedChats.length > 0 &&
+            !platformCfg.allowedChats.includes(source.chatId) &&
+            !freeResponse &&
+            !mentionedBot(event)) {
+            return true;
+        }
+        if (platformCfg.requireMention && !freeResponse && !mentionedBot(event)) {
+            return true;
+        }
+        return false;
+    }
+    /** Step 2: authorization; handles the denied-DM pairing flow. Returns true when denied. */
+    async function isDenied(adapter, event, cfg) {
+        if (isAuthorized(event.source, cfg, pairing))
+            return false;
+        const { source } = event;
+        if (source.chatType !== "dm")
+            return true; // denied group: silent
+        if (cfg.unauthorizedDmBehavior !== "pair")
+            return true;
+        const code = pairing.issueCode(source.platform, source.userId);
+        if (code === null)
+            return true; // rate-limited or pending list full: stay silent
+        await adapter.send(source.chatId, `Your lunR pairing code: ${formatPairingCode(code)} — ask the owner to run: lunr gateway pair approve ${source.platform} ${formatPairingCode(code)}`, { replyTo: event.messageId, threadId: source.threadId });
+        return true;
+    }
+    /** Step 3: command registry. Returns true when the event was consumed. */
+    async function handleSlash(adapter, event, key) {
+        const text = event.text.trim();
+        if (!text.startsWith("/"))
+            return false;
+        const firstToken = text.split(/\s+/, 1)[0].toLowerCase();
+        const commandWord = firstToken.split("@")[0].slice(1);
+        const args = text.slice(firstToken.length).trim();
+        const cmd = CHAT_COMMANDS.find((c) => c.name === commandWord || c.aliases?.includes(commandWord));
+        if (!cmd) {
+            // Unknown slash command: DM → normal text, group → ignore.
+            return event.source.chatType !== "dm";
+        }
+        const ctx = {
+            event,
+            key,
+            adapter,
+            bridge,
+            args,
+            reply: (message) => sendCommandReply(adapter, event, message),
+        };
+        return runChatCommand(cmd, ctx);
+    }
+    /** Step 4 delivery: silence filter → split → sequential send.
+     *
+     * When a streaming preview message exists (editMessageId), the final text
+     * is folded INTO it instead of sent as a duplicate: non-truncated previews
+     * get a final edit (covers silence-marker stripping), truncated previews
+     * are edited to chunk 1 and the remaining chunks are sent as follow-ups. */
+    async function deliver(adapter, event, text, opts) {
+        const filtered = applySilenceFilter(text);
+        if (filtered === null)
+            return;
+        const chunks = splitMessage(filtered, adapter.maxMessageLength);
+        let startIndex = 0;
+        if (opts.editMessageId) {
+            if (!opts.previewTruncated) {
+                // Preview already holds the whole text: one final edit, no new message.
+                await adapter.editMessage(event.source.chatId, opts.editMessageId, filtered);
+                return;
+            }
+            // Preview was truncated: upgrade it to the first full chunk.
+            await adapter.editMessage(event.source.chatId, opts.editMessageId, chunks[0]);
+            startIndex = 1;
+        }
+        for (let index = startIndex; index < chunks.length; index++) {
+            const result = await adapter.send(event.source.chatId, chunks[index], {
+                replyTo: opts.reply && index === 0 ? event.messageId : undefined,
+                threadId: event.source.threadId,
+            });
+            if (!result.success) {
+                console.error(`[gateway] send failed on ${adapter.platform}: ${result.error ?? "unknown error"}`);
+                return;
+            }
+        }
+    }
+    async function runTurn(adapter, event, key, cfg) {
+        const streaming = cfg.streaming.enabled && typeof adapter.editMessage === "function";
+        let consumer;
+        if (streaming) {
+            consumer = new StreamConsumer({
+                sendInitial: async (text) => {
+                    const result = await adapter.send(event.source.chatId, text, {
+                        replyTo: event.messageId,
+                        threadId: event.source.threadId,
+                    });
+                    return result.success ? (result.messageId ?? null) : null;
+                },
+                edit: async (messageId, text) => {
+                    await adapter.editMessage(event.source.chatId, messageId, text);
+                },
+                intervalMs: cfg.streaming.editIntervalMs,
+                threshold: cfg.streaming.bufferThreshold,
+                maxPreview: adapter.maxMessageLength,
+            });
+        }
+        const callbacks = {
+            onDelta: consumer ? (delta) => consumer.push(delta) : undefined,
+            onFollowUpResult: (text) => {
+                void deliver(adapter, event, text, { reply: false });
+            },
+            onError: (message) => {
+                void sendError(adapter, event, message);
+            },
+        };
+        const result = await runWithApprovalContext({ key, adapter, source: event.source }, () => bridge.runTurn(key, event, callbacks));
+        if (result === QUEUED)
+            return; // queued behind a running turn: no reply
+        if (consumer)
+            await consumer.finalize();
+        await deliver(adapter, event, result, {
+            reply: !consumer,
+            editMessageId: consumer?.sentMessageId ?? undefined,
+            previewTruncated: consumer?.truncated ?? false,
+        });
+    }
+    return {
+        async handleEvent(event) {
+            const adapter = adapters.get(event.source.platform);
+            if (!adapter)
+                return;
+            const cfg = freshCfg();
+            try {
+                if (isGroupGated(event, cfg))
+                    return;
+                if (await isDenied(adapter, event, cfg))
+                    return;
+                const key = buildSessionKey(event.source, { groupSessionsPerUser: cfg.groupSessionsPerUser });
+                if (await handleSlash(adapter, event, key))
+                    return;
+                await adapter.sendTyping(event.source.chatId, event.source.threadId).catch(() => { });
+                await runTurn(adapter, event, key, cfg);
+            }
+            catch (err) {
+                await sendError(adapter, event, err instanceof Error ? err.message : String(err)).catch(() => { });
+            }
+        },
+    };
+}
+//# sourceMappingURL=router.js.map

package/dist/gateway/router.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"router.js","sourceRoot":"","sources":["../../src/gateway/router.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * lunR: gateway router.\n *\n * Every inbound MessageEvent flows through handleEvent:\n *   1. group gating (allowedChats / freeResponseChats / requireMention,\n *      with adapter-supplied metadata.mentionedBot)\n *   2. authorization (authz.ts); denied DMs get a pairing code when the\n *      behavior is \"pair\" and the user isn't rate-limited\n *   3. command registry (/new, /undo, /redo, /model, /sessions, /title,\n *      /context, /swarm, /compact, /thinking, /stop, /status, /help, /whoami)\n *   4. normal path: bridge.runTurn with a StreamConsumer when streaming is\n *      enabled and the adapter supports edit; the final text is\n *      silence-filtered and folded INTO the streaming preview (edit, plus\n *      continuation chunks when the preview was truncated) — no preview +\n *      final double-send. Without streaming it is split (text.ts) and sent\n *      sequentially, the first chunk replying to the triggering message.\n * Errors surface as a compact \"⚠ <one-line>\" — never a stack trace.\n */\n\nimport { existsSync } from \"node:fs\";\n\nimport { type BridgeSession, type BridgeSessionStatus, QUEUED, type TurnCallbacks } from \"./agent-bridge.ts\";\nimport { registerGatewayApprovalHandler, runWithApprovalContext } from \"./approval.ts\";\nimport { isAuthorized } from \"./authz.ts\";\nimport { CHAT_COMMANDS, runChatCommand, sendCommandReply } from \"./commands.ts\";\nimport { type GatewayConfig, gatewayConfigPath, loadGatewayConfig, platformConfigFor } from \"./config.ts\";\nimport type { PairingStore } from \"./pairing.ts\";\nimport { buildSessionKey } from \"./session-keys.ts\";\nimport { applySilenceFilter, StreamConsumer } from \"./stream.ts\";\nimport { splitMessage } from \"./text.ts\";\nimport type { MessageEvent, PlatformAdapter } from \"./types.ts\";\n\n/** Structural bridge shape (AgentBridge satisfies it; tests fake it). */\nexport interface BridgeLike {\n\trunTurn(key: string, event: MessageEvent, callbacks: TurnCallbacks): Promise<string>;\n\tabort(key: string): Promise<void> | void;\n\treset(key: string): void;\n\tgetStatus(key: string): BridgeSessionStatus;\n\tgetSession(key: string): Promise<BridgeSession | null>;\n\tswitchSession(key: string, sessionFile: string): Promise<void>;\n\tundo(key: string): Promise<{ userText: string }>;\n\tredo(key: string): Promise<void>;\n}\n\nexport interface RouterDeps {\n\tadapters: Map<string, PlatformAdapter>;\n\tcfg: GatewayConfig;\n\tpairing: PairingStore;\n\tbridge: BridgeLike;\n\t/** Reload gateway.json on every inbound event so CLI config edits (e.g. pair approve) are picked up by the running daemon. */\n\treloadConfig?: boolean;\n}\n\nexport interface Router {\n\thandleEvent(event: MessageEvent): Promise<void>;\n}\n\nfunction oneLine(text: string): string {\n\treturn text.replace(/\\s+/g, \" \").trim().slice(0, 200);\n}\n\nfunction formatPairingCode(code: string): string {\n\treturn code.length === 8 ? `${code.slice(0, 4)}-${code.slice(4)}` : code;\n}\n\nfunction mentionedBot(event: MessageEvent): boolean {\n\treturn event.metadata?.mentionedBot === true;\n}\n\nexport function createRouter(deps: RouterDeps): Router {\n\tconst { adapters, cfg: initialCfg, pairing, bridge, reloadConfig } = deps;\n\n\t// lunr: headless gateway sessions must prompt for mutating tools in manual mode.\n\tregisterGatewayApprovalHandler();\n\n\t/** Reload gateway.json on every inbound event so CLI edits (e.g. pair approve) take effect immediately. */\n\tfunction freshCfg(): GatewayConfig {\n\t\tif (!reloadConfig) return initialCfg;\n\t\ttry {\n\t\t\tif (existsSync(gatewayConfigPath())) {\n\t\t\t\treturn loadGatewayConfig();\n\t\t\t}\n\t\t} catch {\n\t\t\t// fall through to initial config\n\t\t}\n\t\treturn initialCfg;\n\t}\n\n\tasync function sendError(adapter: PlatformAdapter, event: MessageEvent, message: string): Promise<void> {\n\t\tawait adapter.send(event.source.chatId, `⚠ ${oneLine(message)}`, {\n\t\t\treplyTo: event.messageId,\n\t\t\tthreadId: event.source.threadId,\n\t\t});\n\t}\n\n\t/** Step 1: group-chat early gating. Returns true when the event must be dropped. */\n\tfunction isGroupGated(event: MessageEvent, cfg: GatewayConfig): boolean {\n\t\tconst { source } = event;\n\t\tif (source.chatType === \"dm\") return false;\n\t\tconst platformCfg = platformConfigFor(cfg, source.platform);\n\t\tif (!platformCfg) return true;\n\t\tconst freeResponse = platformCfg.freeResponseChats.includes(source.chatId);\n\t\tif (\n\t\t\tplatformCfg.allowedChats.length > 0 &&\n\t\t\t!platformCfg.allowedChats.includes(source.chatId) &&\n\t\t\t!freeResponse &&\n\t\t\t!mentionedBot(event)\n\t\t) {\n\t\t\treturn true;\n\t\t}\n\t\tif (platformCfg.requireMention && !freeResponse && !mentionedBot(event)) {\n\t\t\treturn true;\n\t\t}\n\t\treturn false;\n\t}\n\n\t/** Step 2: authorization; handles the denied-DM pairing flow. Returns true when denied. */\n\tasync function isDenied(adapter: PlatformAdapter, event: MessageEvent, cfg: GatewayConfig): Promise<boolean> {\n\t\tif (isAuthorized(event.source, cfg, pairing)) return false;\n\t\tconst { source } = event;\n\t\tif (source.chatType !== \"dm\") return true; // denied group: silent\n\t\tif (cfg.unauthorizedDmBehavior !== \"pair\") return true;\n\t\tconst code = pairing.issueCode(source.platform, source.userId);\n\t\tif (code === null) return true; // rate-limited or pending list full: stay silent\n\t\tawait adapter.send(\n\t\t\tsource.chatId,\n\t\t\t`Your lunR pairing code: ${formatPairingCode(code)} — ask the owner to run: lunr gateway pair approve ${source.platform} ${formatPairingCode(code)}`,\n\t\t\t{ replyTo: event.messageId, threadId: source.threadId },\n\t\t);\n\t\treturn true;\n\t}\n\n\t/** Step 3: command registry. Returns true when the event was consumed. */\n\tasync function handleSlash(adapter: PlatformAdapter, event: MessageEvent, key: string): Promise<boolean> {\n\t\tconst text = event.text.trim();\n\t\tif (!text.startsWith(\"/\")) return false;\n\t\tconst firstToken = text.split(/\\s+/, 1)[0].toLowerCase();\n\t\tconst commandWord = firstToken.split(\"@\")[0].slice(1);\n\t\tconst args = text.slice(firstToken.length).trim();\n\t\tconst cmd = CHAT_COMMANDS.find((c) => c.name === commandWord || c.aliases?.includes(commandWord));\n\t\tif (!cmd) {\n\t\t\t// Unknown slash command: DM → normal text, group → ignore.\n\t\t\treturn event.source.chatType !== \"dm\";\n\t\t}\n\t\tconst ctx = {\n\t\t\tevent,\n\t\t\tkey,\n\t\t\tadapter,\n\t\t\tbridge,\n\t\t\targs,\n\t\t\treply: (message: string) => sendCommandReply(adapter, event, message),\n\t\t};\n\t\treturn runChatCommand(cmd, ctx);\n\t}\n\n\t/** Step 4 delivery: silence filter → split → sequential send.\n\t *\n\t * When a streaming preview message exists (editMessageId), the final text\n\t * is folded INTO it instead of sent as a duplicate: non-truncated previews\n\t * get a final edit (covers silence-marker stripping), truncated previews\n\t * are edited to chunk 1 and the remaining chunks are sent as follow-ups. */\n\tasync function deliver(\n\t\tadapter: PlatformAdapter,\n\t\tevent: MessageEvent,\n\t\ttext: string,\n\t\topts: { reply: boolean; editMessageId?: string; previewTruncated?: boolean },\n\t): Promise<void> {\n\t\tconst filtered = applySilenceFilter(text);\n\t\tif (filtered === null) return;\n\t\tconst chunks = splitMessage(filtered, adapter.maxMessageLength);\n\t\tlet startIndex = 0;\n\t\tif (opts.editMessageId) {\n\t\t\tif (!opts.previewTruncated) {\n\t\t\t\t// Preview already holds the whole text: one final edit, no new message.\n\t\t\t\tawait adapter.editMessage(event.source.chatId, opts.editMessageId, filtered);\n\t\t\t\treturn;\n\t\t\t}\n\t\t\t// Preview was truncated: upgrade it to the first full chunk.\n\t\t\tawait adapter.editMessage(event.source.chatId, opts.editMessageId, chunks[0]);\n\t\t\tstartIndex = 1;\n\t\t}\n\t\tfor (let index = startIndex; index < chunks.length; index++) {\n\t\t\tconst result = await adapter.send(event.source.chatId, chunks[index], {\n\t\t\t\treplyTo: opts.reply && index === 0 ? event.messageId : undefined,\n\t\t\t\tthreadId: event.source.threadId,\n\t\t\t});\n\t\t\tif (!result.success) {\n\t\t\t\tconsole.error(`[gateway] send failed on ${adapter.platform}: ${result.error ?? \"unknown error\"}`);\n\t\t\t\treturn;\n\t\t\t}\n\t\t}\n\t}\n\n\tasync function runTurn(\n\t\tadapter: PlatformAdapter,\n\t\tevent: MessageEvent,\n\t\tkey: string,\n\t\tcfg: GatewayConfig,\n\t): Promise<void> {\n\t\tconst streaming = cfg.streaming.enabled && typeof adapter.editMessage === \"function\";\n\t\tlet consumer: StreamConsumer | undefined;\n\t\tif (streaming) {\n\t\t\tconsumer = new StreamConsumer({\n\t\t\t\tsendInitial: async (text) => {\n\t\t\t\t\tconst result = await adapter.send(event.source.chatId, text, {\n\t\t\t\t\t\treplyTo: event.messageId,\n\t\t\t\t\t\tthreadId: event.source.threadId,\n\t\t\t\t\t});\n\t\t\t\t\treturn result.success ? (result.messageId ?? null) : null;\n\t\t\t\t},\n\t\t\t\tedit: async (messageId, text) => {\n\t\t\t\t\tawait adapter.editMessage(event.source.chatId, messageId, text);\n\t\t\t\t},\n\t\t\t\tintervalMs: cfg.streaming.editIntervalMs,\n\t\t\t\tthreshold: cfg.streaming.bufferThreshold,\n\t\t\t\tmaxPreview: adapter.maxMessageLength,\n\t\t\t});\n\t\t}\n\n\t\tconst callbacks: TurnCallbacks = {\n\t\t\tonDelta: consumer ? (delta) => consumer.push(delta) : undefined,\n\t\t\tonFollowUpResult: (text) => {\n\t\t\t\tvoid deliver(adapter, event, text, { reply: false });\n\t\t\t},\n\t\t\tonError: (message) => {\n\t\t\t\tvoid sendError(adapter, event, message);\n\t\t\t},\n\t\t};\n\n\t\tconst result = await runWithApprovalContext({ key, adapter, source: event.source }, () =>\n\t\t\tbridge.runTurn(key, event, callbacks),\n\t\t);\n\t\tif (result === QUEUED) return; // queued behind a running turn: no reply\n\t\tif (consumer) await consumer.finalize();\n\t\tawait deliver(adapter, event, result, {\n\t\t\treply: !consumer,\n\t\t\teditMessageId: consumer?.sentMessageId ?? undefined,\n\t\t\tpreviewTruncated: consumer?.truncated ?? false,\n\t\t});\n\t}\n\n\treturn {\n\t\tasync handleEvent(event: MessageEvent): Promise<void> {\n\t\t\tconst adapter = adapters.get(event.source.platform);\n\t\t\tif (!adapter) return;\n\t\t\tconst cfg = freshCfg();\n\t\t\ttry {\n\t\t\t\tif (isGroupGated(event, cfg)) return;\n\t\t\t\tif (await isDenied(adapter, event, cfg)) return;\n\t\t\t\tconst key = buildSessionKey(event.source, { groupSessionsPerUser: cfg.groupSessionsPerUser });\n\t\t\t\tif (await handleSlash(adapter, event, key)) return;\n\t\t\t\tawait adapter.sendTyping(event.source.chatId, event.source.threadId).catch(() => {});\n\t\t\t\tawait runTurn(adapter, event, key, cfg);\n\t\t\t} catch (err) {\n\t\t\t\tawait sendError(adapter, event, err instanceof Error ? err.message : String(err)).catch(() => {});\n\t\t\t}\n\t\t},\n\t};\n}\n"]}

package/dist/gateway/session-keys.d.ts

@@ -0,0 +1,18 @@
+/**
+ * lunR: gateway session keys.
+ *
+ * One agent session per (platform, chat[, thread][, user]) conversation:
+ *   agent:main:<platform>:<chatType>:<chatId>[:<threadId>][:<userId>]
+ * Thread sessions are shared (no userId — a thread is already a narrow
+ * context). Group/channel sessions append the userId when
+ * groupSessionsPerUser is on, so each member talks to their own session.
+ * Every component is sanitized (`:` and whitespace → `_`) so keys stay
+ * single-line and unambiguous.
+ */
+import type { SessionSource } from "./types.ts";
+export declare const SESSION_KEY_PREFIX = "agent:main";
+export interface SessionKeyOptions {
+    groupSessionsPerUser: boolean;
+}
+export declare function buildSessionKey(source: SessionSource, options: SessionKeyOptions): string;
+//# sourceMappingURL=session-keys.d.ts.map

package/dist/gateway/session-keys.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-keys.d.ts","sourceRoot":"","sources":["../../src/gateway/session-keys.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD,eAAO,MAAM,kBAAkB,eAAe,CAAC;AAE/C,MAAM,WAAW,iBAAiB;IACjC,oBAAoB,EAAE,OAAO,CAAC;CAC9B;AAMD,wBAAgB,eAAe,CAAC,MAAM,EAAE,aAAa,EAAE,OAAO,EAAE,iBAAiB,GAAG,MAAM,CAQzF","sourcesContent":["/**\n * lunR: gateway session keys.\n *\n * One agent session per (platform, chat[, thread][, user]) conversation:\n *   agent:main:<platform>:<chatType>:<chatId>[:<threadId>][:<userId>]\n * Thread sessions are shared (no userId — a thread is already a narrow\n * context). Group/channel sessions append the userId when\n * groupSessionsPerUser is on, so each member talks to their own session.\n * Every component is sanitized (`:` and whitespace → `_`) so keys stay\n * single-line and unambiguous.\n */\n\nimport type { SessionSource } from \"./types.ts\";\n\nexport const SESSION_KEY_PREFIX = \"agent:main\";\n\nexport interface SessionKeyOptions {\n\tgroupSessionsPerUser: boolean;\n}\n\nfunction sanitize(component: string): string {\n\treturn component.replace(/[\\s:]+/g, \"_\");\n}\n\nexport function buildSessionKey(source: SessionSource, options: SessionKeyOptions): string {\n\tconst parts = [source.platform, source.chatType, source.chatId].map(sanitize);\n\tif (source.threadId) {\n\t\tparts.push(sanitize(source.threadId));\n\t} else if ((source.chatType === \"group\" || source.chatType === \"channel\") && options.groupSessionsPerUser) {\n\t\tparts.push(sanitize(source.userId));\n\t}\n\treturn [SESSION_KEY_PREFIX, ...parts].join(\":\");\n}\n"]}

package/dist/gateway/session-keys.js

@@ -0,0 +1,26 @@
+/**
+ * lunR: gateway session keys.
+ *
+ * One agent session per (platform, chat[, thread][, user]) conversation:
+ *   agent:main:<platform>:<chatType>:<chatId>[:<threadId>][:<userId>]
+ * Thread sessions are shared (no userId — a thread is already a narrow
+ * context). Group/channel sessions append the userId when
+ * groupSessionsPerUser is on, so each member talks to their own session.
+ * Every component is sanitized (`:` and whitespace → `_`) so keys stay
+ * single-line and unambiguous.
+ */
+export const SESSION_KEY_PREFIX = "agent:main";
+function sanitize(component) {
+    return component.replace(/[\s:]+/g, "_");
+}
+export function buildSessionKey(source, options) {
+    const parts = [source.platform, source.chatType, source.chatId].map(sanitize);
+    if (source.threadId) {
+        parts.push(sanitize(source.threadId));
+    }
+    else if ((source.chatType === "group" || source.chatType === "channel") && options.groupSessionsPerUser) {
+        parts.push(sanitize(source.userId));
+    }
+    return [SESSION_KEY_PREFIX, ...parts].join(":");
+}
+//# sourceMappingURL=session-keys.js.map

package/dist/gateway/session-keys.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-keys.js","sourceRoot":"","sources":["../../src/gateway/session-keys.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH,MAAM,CAAC,MAAM,kBAAkB,GAAG,YAAY,CAAC;AAM/C,SAAS,QAAQ,CAAC,SAAiB,EAAU;IAC5C,OAAO,SAAS,CAAC,OAAO,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC;AAAA,CACzC;AAED,MAAM,UAAU,eAAe,CAAC,MAAqB,EAAE,OAA0B,EAAU;IAC1F,MAAM,KAAK,GAAG,CAAC,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IAC9E,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;QACrB,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC;IACvC,CAAC;SAAM,IAAI,CAAC,MAAM,CAAC,QAAQ,KAAK,OAAO,IAAI,MAAM,CAAC,QAAQ,KAAK,SAAS,CAAC,IAAI,OAAO,CAAC,oBAAoB,EAAE,CAAC;QAC3G,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC;IACrC,CAAC;IACD,OAAO,CAAC,kBAAkB,EAAE,GAAG,KAAK,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAAA,CAChD","sourcesContent":["/**\n * lunR: gateway session keys.\n *\n * One agent session per (platform, chat[, thread][, user]) conversation:\n *   agent:main:<platform>:<chatType>:<chatId>[:<threadId>][:<userId>]\n * Thread sessions are shared (no userId — a thread is already a narrow\n * context). Group/channel sessions append the userId when\n * groupSessionsPerUser is on, so each member talks to their own session.\n * Every component is sanitized (`:` and whitespace → `_`) so keys stay\n * single-line and unambiguous.\n */\n\nimport type { SessionSource } from \"./types.ts\";\n\nexport const SESSION_KEY_PREFIX = \"agent:main\";\n\nexport interface SessionKeyOptions {\n\tgroupSessionsPerUser: boolean;\n}\n\nfunction sanitize(component: string): string {\n\treturn component.replace(/[\\s:]+/g, \"_\");\n}\n\nexport function buildSessionKey(source: SessionSource, options: SessionKeyOptions): string {\n\tconst parts = [source.platform, source.chatType, source.chatId].map(sanitize);\n\tif (source.threadId) {\n\t\tparts.push(sanitize(source.threadId));\n\t} else if ((source.chatType === \"group\" || source.chatType === \"channel\") && options.groupSessionsPerUser) {\n\t\tparts.push(sanitize(source.userId));\n\t}\n\treturn [SESSION_KEY_PREFIX, ...parts].join(\":\");\n}\n"]}

package/dist/gateway/store.d.ts

@@ -0,0 +1,28 @@
+/**
+ * lunR: gateway session store (<agentDir>/gateway-sessions.json).
+ *
+ * Maps session keys (see session-keys.ts) to the agent session backing each
+ * chat conversation, so the agent-bridge can reopen a conversation after a
+ * daemon restart. Atomic writes; a missing or corrupt file starts empty.
+ * Tests override the file location via setGatewayStorePath().
+ */
+export interface StoredSession {
+    sessionId: string;
+    sessionFile: string;
+    createdAt: string;
+    lastActiveAt: string;
+}
+type StoreData = Record<string, StoredSession>;
+/** Test hook: pin the store file location (pass undefined to reset). */
+export declare function setGatewayStorePath(path: string | undefined): void;
+export declare function getSession(key: string): StoredSession | undefined;
+export declare function putSession(key: string, entry: {
+    sessionId: string;
+    sessionFile: string;
+}): StoredSession;
+/** Bump lastActiveAt without replacing the entry. */
+export declare function touchSession(key: string): void;
+export declare function removeSession(key: string): boolean;
+export declare function listSessions(): StoreData;
+export {};
+//# sourceMappingURL=store.d.ts.map

package/dist/gateway/store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../src/gateway/store.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAMH,MAAM,WAAW,aAAa;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;CACrB;AAED,KAAK,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;AAI/C,wEAAwE;AACxE,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAElE;AAuCD,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS,CAEjE;AAED,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,GAAG,aAAa,CAYxG;AAED,qDAAqD;AACrD,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAM9C;AAED,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAMlD;AAED,wBAAgB,YAAY,IAAI,SAAS,CAExC","sourcesContent":["/**\n * lunR: gateway session store (<agentDir>/gateway-sessions.json).\n *\n * Maps session keys (see session-keys.ts) to the agent session backing each\n * chat conversation, so the agent-bridge can reopen a conversation after a\n * daemon restart. Atomic writes; a missing or corrupt file starts empty.\n * Tests override the file location via setGatewayStorePath().\n */\n\nimport { existsSync, mkdirSync, readFileSync, renameSync, writeFileSync } from \"node:fs\";\nimport { dirname, join } from \"node:path\";\nimport { getAgentDir } from \"../config.ts\";\n\nexport interface StoredSession {\n\tsessionId: string;\n\tsessionFile: string;\n\tcreatedAt: string;\n\tlastActiveAt: string;\n}\n\ntype StoreData = Record<string, StoredSession>;\n\nlet storePathOverride: string | undefined;\n\n/** Test hook: pin the store file location (pass undefined to reset). */\nexport function setGatewayStorePath(path: string | undefined): void {\n\tstorePathOverride = path;\n}\n\nfunction storePath(): string {\n\treturn storePathOverride ?? join(getAgentDir(), \"gateway-sessions.json\");\n}\n\nfunction readStore(): StoreData {\n\tconst path = storePath();\n\tif (!existsSync(path)) return {};\n\ttry {\n\t\tconst parsed: unknown = JSON.parse(readFileSync(path, \"utf-8\"));\n\t\tif (parsed == null || typeof parsed !== \"object\" || Array.isArray(parsed)) return {};\n\t\tconst out: StoreData = {};\n\t\tfor (const [key, value] of Object.entries(parsed as Record<string, unknown>)) {\n\t\t\tif (value == null || typeof value !== \"object\") continue;\n\t\t\tconst v = value as Record<string, unknown>;\n\t\t\tif (typeof v.sessionId !== \"string\" || typeof v.sessionFile !== \"string\") continue;\n\t\t\tout[key] = {\n\t\t\t\tsessionId: v.sessionId,\n\t\t\t\tsessionFile: v.sessionFile,\n\t\t\t\tcreatedAt: typeof v.createdAt === \"string\" ? v.createdAt : new Date(0).toISOString(),\n\t\t\t\tlastActiveAt: typeof v.lastActiveAt === \"string\" ? v.lastActiveAt : new Date(0).toISOString(),\n\t\t\t};\n\t\t}\n\t\treturn out;\n\t} catch {\n\t\treturn {}; // corrupt file: start empty\n\t}\n}\n\nfunction writeStore(data: StoreData): void {\n\tconst path = storePath();\n\tconst dir = dirname(path);\n\tif (!existsSync(dir)) mkdirSync(dir, { recursive: true });\n\tconst tmp = `${path}.tmp-${process.pid}`;\n\twriteFileSync(tmp, `${JSON.stringify(data, null, 2)}\\n`, \"utf-8\");\n\trenameSync(tmp, path);\n}\n\nexport function getSession(key: string): StoredSession | undefined {\n\treturn readStore()[key];\n}\n\nexport function putSession(key: string, entry: { sessionId: string; sessionFile: string }): StoredSession {\n\tconst data = readStore();\n\tconst existing = data[key];\n\tconst stored: StoredSession = {\n\t\tsessionId: entry.sessionId,\n\t\tsessionFile: entry.sessionFile,\n\t\tcreatedAt: existing?.createdAt ?? new Date().toISOString(),\n\t\tlastActiveAt: new Date().toISOString(),\n\t};\n\tdata[key] = stored;\n\twriteStore(data);\n\treturn stored;\n}\n\n/** Bump lastActiveAt without replacing the entry. */\nexport function touchSession(key: string): void {\n\tconst data = readStore();\n\tconst existing = data[key];\n\tif (!existing) return;\n\texisting.lastActiveAt = new Date().toISOString();\n\twriteStore(data);\n}\n\nexport function removeSession(key: string): boolean {\n\tconst data = readStore();\n\tif (!(key in data)) return false;\n\tdelete data[key];\n\twriteStore(data);\n\treturn true;\n}\n\nexport function listSessions(): StoreData {\n\treturn readStore();\n}\n"]}

package/dist/gateway/store.js

@@ -0,0 +1,93 @@
+/**
+ * lunR: gateway session store (<agentDir>/gateway-sessions.json).
+ *
+ * Maps session keys (see session-keys.ts) to the agent session backing each
+ * chat conversation, so the agent-bridge can reopen a conversation after a
+ * daemon restart. Atomic writes; a missing or corrupt file starts empty.
+ * Tests override the file location via setGatewayStorePath().
+ */
+import { existsSync, mkdirSync, readFileSync, renameSync, writeFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { getAgentDir } from "../config.js";
+let storePathOverride;
+/** Test hook: pin the store file location (pass undefined to reset). */
+export function setGatewayStorePath(path) {
+    storePathOverride = path;
+}
+function storePath() {
+    return storePathOverride ?? join(getAgentDir(), "gateway-sessions.json");
+}
+function readStore() {
+    const path = storePath();
+    if (!existsSync(path))
+        return {};
+    try {
+        const parsed = JSON.parse(readFileSync(path, "utf-8"));
+        if (parsed == null || typeof parsed !== "object" || Array.isArray(parsed))
+            return {};
+        const out = {};
+        for (const [key, value] of Object.entries(parsed)) {
+            if (value == null || typeof value !== "object")
+                continue;
+            const v = value;
+            if (typeof v.sessionId !== "string" || typeof v.sessionFile !== "string")
+                continue;
+            out[key] = {
+                sessionId: v.sessionId,
+                sessionFile: v.sessionFile,
+                createdAt: typeof v.createdAt === "string" ? v.createdAt : new Date(0).toISOString(),
+                lastActiveAt: typeof v.lastActiveAt === "string" ? v.lastActiveAt : new Date(0).toISOString(),
+            };
+        }
+        return out;
+    }
+    catch {
+        return {}; // corrupt file: start empty
+    }
+}
+function writeStore(data) {
+    const path = storePath();
+    const dir = dirname(path);
+    if (!existsSync(dir))
+        mkdirSync(dir, { recursive: true });
+    const tmp = `${path}.tmp-${process.pid}`;
+    writeFileSync(tmp, `${JSON.stringify(data, null, 2)}\n`, "utf-8");
+    renameSync(tmp, path);
+}
+export function getSession(key) {
+    return readStore()[key];
+}
+export function putSession(key, entry) {
+    const data = readStore();
+    const existing = data[key];
+    const stored = {
+        sessionId: entry.sessionId,
+        sessionFile: entry.sessionFile,
+        createdAt: existing?.createdAt ?? new Date().toISOString(),
+        lastActiveAt: new Date().toISOString(),
+    };
+    data[key] = stored;
+    writeStore(data);
+    return stored;
+}
+/** Bump lastActiveAt without replacing the entry. */
+export function touchSession(key) {
+    const data = readStore();
+    const existing = data[key];
+    if (!existing)
+        return;
+    existing.lastActiveAt = new Date().toISOString();
+    writeStore(data);
+}
+export function removeSession(key) {
+    const data = readStore();
+    if (!(key in data))
+        return false;
+    delete data[key];
+    writeStore(data);
+    return true;
+}
+export function listSessions() {
+    return readStore();
+}
+//# sourceMappingURL=store.js.map

package/dist/gateway/store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.js","sourceRoot":"","sources":["../../src/gateway/store.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * lunR: gateway session store (<agentDir>/gateway-sessions.json).\n *\n * Maps session keys (see session-keys.ts) to the agent session backing each\n * chat conversation, so the agent-bridge can reopen a conversation after a\n * daemon restart. Atomic writes; a missing or corrupt file starts empty.\n * Tests override the file location via setGatewayStorePath().\n */\n\nimport { existsSync, mkdirSync, readFileSync, renameSync, writeFileSync } from \"node:fs\";\nimport { dirname, join } from \"node:path\";\nimport { getAgentDir } from \"../config.ts\";\n\nexport interface StoredSession {\n\tsessionId: string;\n\tsessionFile: string;\n\tcreatedAt: string;\n\tlastActiveAt: string;\n}\n\ntype StoreData = Record<string, StoredSession>;\n\nlet storePathOverride: string | undefined;\n\n/** Test hook: pin the store file location (pass undefined to reset). */\nexport function setGatewayStorePath(path: string | undefined): void {\n\tstorePathOverride = path;\n}\n\nfunction storePath(): string {\n\treturn storePathOverride ?? join(getAgentDir(), \"gateway-sessions.json\");\n}\n\nfunction readStore(): StoreData {\n\tconst path = storePath();\n\tif (!existsSync(path)) return {};\n\ttry {\n\t\tconst parsed: unknown = JSON.parse(readFileSync(path, \"utf-8\"));\n\t\tif (parsed == null || typeof parsed !== \"object\" || Array.isArray(parsed)) return {};\n\t\tconst out: StoreData = {};\n\t\tfor (const [key, value] of Object.entries(parsed as Record<string, unknown>)) {\n\t\t\tif (value == null || typeof value !== \"object\") continue;\n\t\t\tconst v = value as Record<string, unknown>;\n\t\t\tif (typeof v.sessionId !== \"string\" || typeof v.sessionFile !== \"string\") continue;\n\t\t\tout[key] = {\n\t\t\t\tsessionId: v.sessionId,\n\t\t\t\tsessionFile: v.sessionFile,\n\t\t\t\tcreatedAt: typeof v.createdAt === \"string\" ? v.createdAt : new Date(0).toISOString(),\n\t\t\t\tlastActiveAt: typeof v.lastActiveAt === \"string\" ? v.lastActiveAt : new Date(0).toISOString(),\n\t\t\t};\n\t\t}\n\t\treturn out;\n\t} catch {\n\t\treturn {}; // corrupt file: start empty\n\t}\n}\n\nfunction writeStore(data: StoreData): void {\n\tconst path = storePath();\n\tconst dir = dirname(path);\n\tif (!existsSync(dir)) mkdirSync(dir, { recursive: true });\n\tconst tmp = `${path}.tmp-${process.pid}`;\n\twriteFileSync(tmp, `${JSON.stringify(data, null, 2)}\\n`, \"utf-8\");\n\trenameSync(tmp, path);\n}\n\nexport function getSession(key: string): StoredSession | undefined {\n\treturn readStore()[key];\n}\n\nexport function putSession(key: string, entry: { sessionId: string; sessionFile: string }): StoredSession {\n\tconst data = readStore();\n\tconst existing = data[key];\n\tconst stored: StoredSession = {\n\t\tsessionId: entry.sessionId,\n\t\tsessionFile: entry.sessionFile,\n\t\tcreatedAt: existing?.createdAt ?? new Date().toISOString(),\n\t\tlastActiveAt: new Date().toISOString(),\n\t};\n\tdata[key] = stored;\n\twriteStore(data);\n\treturn stored;\n}\n\n/** Bump lastActiveAt without replacing the entry. */\nexport function touchSession(key: string): void {\n\tconst data = readStore();\n\tconst existing = data[key];\n\tif (!existing) return;\n\texisting.lastActiveAt = new Date().toISOString();\n\twriteStore(data);\n}\n\nexport function removeSession(key: string): boolean {\n\tconst data = readStore();\n\tif (!(key in data)) return false;\n\tdelete data[key];\n\twriteStore(data);\n\treturn true;\n}\n\nexport function listSessions(): StoreData {\n\treturn readStore();\n}\n"]}

package/dist/gateway/stream.d.ts

@@ -0,0 +1,55 @@
+/**
+ * lunR: gateway streaming — throttled progressive replies.
+ *
+ * StreamConsumer accumulates assistant text deltas and mirrors them into a
+ * single chat message: the first flush sends a new message, later flushes
+ * edit it. Flushes happen at most every intervalMs and only once at least
+ * `threshold` new chars have accumulated. finalize() forces a last flush and
+ * returns the full text — the caller splits THAT via text.ts for final
+ * delivery; the streaming preview itself is truncated to maxPreview-3 + "…".
+ *
+ * applySilenceFilter() recognizes the [SILENT] / NO_REPLY markers (whole
+ * response, or first/last line) and returns null when nothing deliverable
+ * remains.
+ */
+export interface StreamConsumerOptions {
+    /** Send the initial message; resolves with the platform message id (null = send failed). */
+    sendInitial: (text: string) => Promise<string | null>;
+    edit: (messageId: string, text: string) => Promise<void>;
+    intervalMs: number;
+    threshold: number;
+    /** Platform max message length; the streaming preview is truncated to fit. Default 4096. */
+    maxPreview?: number;
+    /** Clock injection for tests. */
+    now?: () => number;
+}
+/**
+ * Null when the text is just a silence marker (whole, first-line, or
+ * last-line); otherwise the text with a leading/trailing marker line
+ * stripped (null when nothing else remains).
+ */
+export declare function applySilenceFilter(text: string): string | null;
+export declare class StreamConsumer {
+    private readonly options;
+    private buffer;
+    private flushedLen;
+    private messageId;
+    private lastFlushAt;
+    private chain;
+    private readonly maxPreview;
+    private readonly now;
+    constructor(options: StreamConsumerOptions);
+    /** Accumulate a delta; schedule a flush when both gates (chars, interval) pass. */
+    push(delta: string): void;
+    /** Force a final flush; resolves with the FULL text (caller splits for delivery). */
+    finalize(): Promise<string>;
+    /** The platform message id of the preview, when one was successfully sent. */
+    get sentMessageId(): string | null;
+    /** True when the preview had to truncate the full text (buffer > maxPreview). */
+    get truncated(): boolean;
+    /** The streaming preview: full text truncated to maxPreview-3 + "…". */
+    private preview;
+    private schedule;
+    private flush;
+}
+//# sourceMappingURL=stream.d.ts.map

package/dist/gateway/stream.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stream.d.ts","sourceRoot":"","sources":["../../src/gateway/stream.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,MAAM,WAAW,qBAAqB;IACrC,4FAA4F;IAC5F,WAAW,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IACtD,IAAI,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACzD,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,4FAA4F;IAC5F,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,iCAAiC;IACjC,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;CACnB;AAQD;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAS9D;AAED,qBAAa,cAAc;IAC1B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAwB;IAChD,OAAO,CAAC,MAAM,CAAM;IACpB,OAAO,CAAC,UAAU,CAAK;IACvB,OAAO,CAAC,SAAS,CAAuB;IACxC,OAAO,CAAC,WAAW,CAAK;IACxB,OAAO,CAAC,KAAK,CAAoC;IACjD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAe;IAEnC,YAAY,OAAO,EAAE,qBAAqB,EAIzC;IAED,mFAAmF;IACnF,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAQxB;IAED,qFAAqF;IAC/E,QAAQ,IAAI,OAAO,CAAC,MAAM,CAAC,CAIhC;IAED,8EAA8E;IAC9E,IAAI,aAAa,IAAI,MAAM,GAAG,IAAI,CAEjC;IAED,iFAAiF;IACjF,IAAI,SAAS,IAAI,OAAO,CAEvB;IAED,0EAAwE;IACxE,OAAO,CAAC,OAAO;IASf,OAAO,CAAC,QAAQ;YAIF,KAAK;CAcnB","sourcesContent":["/**\n * lunR: gateway streaming — throttled progressive replies.\n *\n * StreamConsumer accumulates assistant text deltas and mirrors them into a\n * single chat message: the first flush sends a new message, later flushes\n * edit it. Flushes happen at most every intervalMs and only once at least\n * `threshold` new chars have accumulated. finalize() forces a last flush and\n * returns the full text — the caller splits THAT via text.ts for final\n * delivery; the streaming preview itself is truncated to maxPreview-3 + \"…\".\n *\n * applySilenceFilter() recognizes the [SILENT] / NO_REPLY markers (whole\n * response, or first/last line) and returns null when nothing deliverable\n * remains.\n */\n\nexport interface StreamConsumerOptions {\n\t/** Send the initial message; resolves with the platform message id (null = send failed). */\n\tsendInitial: (text: string) => Promise<string | null>;\n\tedit: (messageId: string, text: string) => Promise<void>;\n\tintervalMs: number;\n\tthreshold: number;\n\t/** Platform max message length; the streaming preview is truncated to fit. Default 4096. */\n\tmaxPreview?: number;\n\t/** Clock injection for tests. */\n\tnow?: () => number;\n}\n\nconst SILENCE_MARKERS = new Set([\"[SILENT]\", \"NO_REPLY\"]);\n\nfunction isMarkerLine(line: string): boolean {\n\treturn SILENCE_MARKERS.has(line.trim());\n}\n\n/**\n * Null when the text is just a silence marker (whole, first-line, or\n * last-line); otherwise the text with a leading/trailing marker line\n * stripped (null when nothing else remains).\n */\nexport function applySilenceFilter(text: string): string | null {\n\tconst trimmed = text.trim();\n\tif (trimmed.length === 0) return null;\n\tif (isMarkerLine(trimmed)) return null;\n\tconst lines = trimmed.split(\"\\n\");\n\tif (lines.length > 0 && isMarkerLine(lines[0])) lines.shift();\n\tif (lines.length > 0 && isMarkerLine(lines[lines.length - 1])) lines.pop();\n\tconst result = lines.join(\"\\n\").trim();\n\treturn result.length > 0 ? result : null;\n}\n\nexport class StreamConsumer {\n\tprivate readonly options: StreamConsumerOptions;\n\tprivate buffer = \"\";\n\tprivate flushedLen = 0;\n\tprivate messageId: string | null = null;\n\tprivate lastFlushAt = 0;\n\tprivate chain: Promise<void> = Promise.resolve();\n\tprivate readonly maxPreview: number;\n\tprivate readonly now: () => number;\n\n\tconstructor(options: StreamConsumerOptions) {\n\t\tthis.options = options;\n\t\tthis.maxPreview = options.maxPreview ?? 4096;\n\t\tthis.now = options.now ?? (() => Date.now());\n\t}\n\n\t/** Accumulate a delta; schedule a flush when both gates (chars, interval) pass. */\n\tpush(delta: string): void {\n\t\tthis.buffer += delta;\n\t\tif (\n\t\t\tthis.buffer.length - this.flushedLen >= this.options.threshold &&\n\t\t\tthis.now() - this.lastFlushAt >= this.options.intervalMs\n\t\t) {\n\t\t\tthis.schedule();\n\t\t}\n\t}\n\n\t/** Force a final flush; resolves with the FULL text (caller splits for delivery). */\n\tasync finalize(): Promise<string> {\n\t\tthis.schedule(true);\n\t\tawait this.chain;\n\t\treturn this.buffer;\n\t}\n\n\t/** The platform message id of the preview, when one was successfully sent. */\n\tget sentMessageId(): string | null {\n\t\treturn this.messageId;\n\t}\n\n\t/** True when the preview had to truncate the full text (buffer > maxPreview). */\n\tget truncated(): boolean {\n\t\treturn this.buffer.length > this.maxPreview;\n\t}\n\n\t/** The streaming preview: full text truncated to maxPreview-3 + \"…\". */\n\tprivate preview(): string {\n\t\tif (this.buffer.length <= this.maxPreview) return this.buffer;\n\t\tlet cut = this.maxPreview - 3;\n\t\t// Don't truncate between surrogate halves.\n\t\tconst code = this.buffer.charCodeAt(cut - 1);\n\t\tif (code >= 0xd800 && code <= 0xdbff) cut -= 1;\n\t\treturn `${this.buffer.slice(0, cut)}…`;\n\t}\n\n\tprivate schedule(force = false): void {\n\t\tthis.chain = this.chain.then(() => this.flush(force)).catch(() => {});\n\t}\n\n\tprivate async flush(force: boolean): Promise<void> {\n\t\tconst hasNew = this.buffer.length > this.flushedLen;\n\t\tif (!hasNew) return;\n\t\tif (!force && this.messageId !== null && this.now() - this.lastFlushAt < this.options.intervalMs) return;\n\t\tconst text = this.preview();\n\t\tif (this.messageId === null) {\n\t\t\tthis.messageId = await this.options.sendInitial(text);\n\t\t\tif (this.messageId === null) return; // send failed; retry on the next flush\n\t\t} else {\n\t\t\tawait this.options.edit(this.messageId, text);\n\t\t}\n\t\tthis.flushedLen = this.buffer.length;\n\t\tthis.lastFlushAt = this.now();\n\t}\n}\n"]}

package/dist/gateway/stream.js

@@ -0,0 +1,107 @@
+/**
+ * lunR: gateway streaming — throttled progressive replies.
+ *
+ * StreamConsumer accumulates assistant text deltas and mirrors them into a
+ * single chat message: the first flush sends a new message, later flushes
+ * edit it. Flushes happen at most every intervalMs and only once at least
+ * `threshold` new chars have accumulated. finalize() forces a last flush and
+ * returns the full text — the caller splits THAT via text.ts for final
+ * delivery; the streaming preview itself is truncated to maxPreview-3 + "…".
+ *
+ * applySilenceFilter() recognizes the [SILENT] / NO_REPLY markers (whole
+ * response, or first/last line) and returns null when nothing deliverable
+ * remains.
+ */
+const SILENCE_MARKERS = new Set(["[SILENT]", "NO_REPLY"]);
+function isMarkerLine(line) {
+    return SILENCE_MARKERS.has(line.trim());
+}
+/**
+ * Null when the text is just a silence marker (whole, first-line, or
+ * last-line); otherwise the text with a leading/trailing marker line
+ * stripped (null when nothing else remains).
+ */
+export function applySilenceFilter(text) {
+    const trimmed = text.trim();
+    if (trimmed.length === 0)
+        return null;
+    if (isMarkerLine(trimmed))
+        return null;
+    const lines = trimmed.split("\n");
+    if (lines.length > 0 && isMarkerLine(lines[0]))
+        lines.shift();
+    if (lines.length > 0 && isMarkerLine(lines[lines.length - 1]))
+        lines.pop();
+    const result = lines.join("\n").trim();
+    return result.length > 0 ? result : null;
+}
+export class StreamConsumer {
+    options;
+    buffer = "";
+    flushedLen = 0;
+    messageId = null;
+    lastFlushAt = 0;
+    chain = Promise.resolve();
+    maxPreview;
+    now;
+    constructor(options) {
+        this.options = options;
+        this.maxPreview = options.maxPreview ?? 4096;
+        this.now = options.now ?? (() => Date.now());
+    }
+    /** Accumulate a delta; schedule a flush when both gates (chars, interval) pass. */
+    push(delta) {
+        this.buffer += delta;
+        if (this.buffer.length - this.flushedLen >= this.options.threshold &&
+            this.now() - this.lastFlushAt >= this.options.intervalMs) {
+            this.schedule();
+        }
+    }
+    /** Force a final flush; resolves with the FULL text (caller splits for delivery). */
+    async finalize() {
+        this.schedule(true);
+        await this.chain;
+        return this.buffer;
+    }
+    /** The platform message id of the preview, when one was successfully sent. */
+    get sentMessageId() {
+        return this.messageId;
+    }
+    /** True when the preview had to truncate the full text (buffer > maxPreview). */
+    get truncated() {
+        return this.buffer.length > this.maxPreview;
+    }
+    /** The streaming preview: full text truncated to maxPreview-3 + "…". */
+    preview() {
+        if (this.buffer.length <= this.maxPreview)
+            return this.buffer;
+        let cut = this.maxPreview - 3;
+        // Don't truncate between surrogate halves.
+        const code = this.buffer.charCodeAt(cut - 1);
+        if (code >= 0xd800 && code <= 0xdbff)
+            cut -= 1;
+        return `${this.buffer.slice(0, cut)}…`;
+    }
+    schedule(force = false) {
+        this.chain = this.chain.then(() => this.flush(force)).catch(() => { });
+    }
+    async flush(force) {
+        const hasNew = this.buffer.length > this.flushedLen;
+        if (!hasNew)
+            return;
+        if (!force && this.messageId !== null && this.now() - this.lastFlushAt < this.options.intervalMs)
+            return;
+        const text = this.preview();
+        if (this.messageId === null) {
+            this.messageId = await this.options.sendInitial(text);
+            if (this.messageId === null)
+                return; // send failed; retry on the next flush
+        }
+        else {
+            await this.options.edit(this.messageId, text);
+        }
+        this.flushedLen = this.buffer.length;
+        this.lastFlushAt = this.now();
+    }
+}
+//# sourceMappingURL=stream.js.map