@ashx-j/lunr 0.1.0

package/dist/core/user-models.d.ts

@@ -0,0 +1,50 @@
+import type { Api, Model } from "@earendil-works/pi-ai";
+export declare const USER_MODELS_FILENAME = "user-models.json";
+export interface UserModelEntry {
+    id: string;
+    name: string;
+    api: Api;
+    provider: string;
+    baseUrl: string;
+    reasoning: boolean;
+    input: ("text" | "image")[];
+    cost: Model<Api>["cost"];
+    contextWindow: number;
+    maxTokens: number;
+    compat?: Model<Api>["compat"];
+    thinkingLevelMap?: Model<Api>["thinkingLevelMap"];
+    source: "user";
+}
+export interface UserModelsFile {
+    version: number;
+    models: UserModelEntry[];
+}
+export declare function userModelsPath(agentDir?: string): string;
+export declare function emptyUserModels(): UserModelsFile;
+/** Read user-models.json. Missing or unreadable files yield an empty document (never throws). */
+export declare function readUserModels(path: string): UserModelsFile;
+export declare function writeUserModels(file: UserModelsFile, path: string): void;
+export declare function evictUserModelsOnOfficial(user: UserModelsFile, officialKeys: Iterable<string>): {
+    next: UserModelsFile;
+    evicted: UserModelEntry[];
+};
+export declare function evictUserModelsByProvider(user: UserModelsFile, providerId: string): {
+    next: UserModelsFile;
+    evicted: UserModelEntry[];
+};
+export declare function upsertUserModels(existing: UserModelsFile, rows: readonly UserModelEntry[]): UserModelsFile;
+export declare function userEntryToModel(entry: UserModelEntry): Model<Api>;
+export declare function modelToUserEntry(model: Model<Api>): UserModelEntry;
+export declare class UserModelsStore {
+    private readonly path;
+    private file;
+    constructor(path: string | undefined);
+    list(): UserModelEntry[];
+    keys(): Set<string>;
+    modelsFor(providerId: string): Model<Api>[];
+    evictOfficial(officialKeys: Iterable<string>): UserModelEntry[];
+    evictProvider(providerId: string): UserModelEntry[];
+    upsert(rows: readonly UserModelEntry[]): void;
+    private persist;
+}
+//# sourceMappingURL=user-models.d.ts.map

package/dist/core/user-models.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"user-models.d.ts","sourceRoot":"","sources":["../../src/core/user-models.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,uBAAuB,CAAC;AAIxD,eAAO,MAAM,oBAAoB,qBAAqB,CAAC;AAEvD,MAAM,WAAW,cAAc;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,GAAG,CAAC;IACT,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,EAAE,CAAC,MAAM,GAAG,OAAO,CAAC,EAAE,CAAC;IAC5B,IAAI,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC;IACzB,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC;IAC9B,gBAAgB,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,kBAAkB,CAAC,CAAC;IAClD,MAAM,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,cAAc;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,cAAc,EAAE,CAAC;CACzB;AAED,wBAAgB,cAAc,CAAC,QAAQ,GAAE,MAAsB,GAAG,MAAM,CAEvE;AA+CD,wBAAgB,eAAe,IAAI,cAAc,CAEhD;AAED,iGAAiG;AACjG,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,CAc3D;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAGxE;AAED,wBAAgB,yBAAyB,CACxC,IAAI,EAAE,cAAc,EACpB,YAAY,EAAE,QAAQ,CAAC,MAAM,CAAC,GAC5B;IAAE,IAAI,EAAE,cAAc,CAAC;IAAC,OAAO,EAAE,cAAc,EAAE,CAAA;CAAE,CASrD;AAED,wBAAgB,yBAAyB,CACxC,IAAI,EAAE,cAAc,EACpB,UAAU,EAAE,MAAM,GAChB;IAAE,IAAI,EAAE,cAAc,CAAC;IAAC,OAAO,EAAE,cAAc,EAAE,CAAA;CAAE,CAQrD;AAED,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,cAAc,EAAE,IAAI,EAAE,SAAS,cAAc,EAAE,GAAG,cAAc,CAI1G;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,cAAc,GAAG,KAAK,CAAC,GAAG,CAAC,CAelE;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,GAAG,cAAc,CAgBlE;AAED,qBAAa,eAAe;IAC3B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAqB;IAC1C,OAAO,CAAC,IAAI,CAAiB;IAE7B,YAAY,IAAI,EAAE,MAAM,GAAG,SAAS,EAGnC;IAED,IAAI,IAAI,cAAc,EAAE,CAEvB;IAED,IAAI,IAAI,GAAG,CAAC,MAAM,CAAC,CAElB;IAED,SAAS,CAAC,UAAU,EAAE,MAAM,GAAG,KAAK,CAAC,GAAG,CAAC,EAAE,CAE1C;IAED,aAAa,CAAC,YAAY,EAAE,QAAQ,CAAC,MAAM,CAAC,GAAG,cAAc,EAAE,CAO9D;IAED,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,cAAc,EAAE,CAOlD;IAED,MAAM,CAAC,IAAI,EAAE,SAAS,cAAc,EAAE,GAAG,IAAI,CAI5C;IAED,OAAO,CAAC,OAAO;CAQf","sourcesContent":["import { existsSync, mkdirSync, readFileSync, writeFileSync } from \"node:fs\";\nimport { dirname, join } from \"node:path\";\nimport type { Api, Model } from \"@earendil-works/pi-ai\";\nimport { getAgentDir } from \"../config.ts\";\nimport { modelKey } from \"./official-catalog.ts\";\n\nexport const USER_MODELS_FILENAME = \"user-models.json\";\n\nexport interface UserModelEntry {\n\tid: string;\n\tname: string;\n\tapi: Api;\n\tprovider: string;\n\tbaseUrl: string;\n\treasoning: boolean;\n\tinput: (\"text\" | \"image\")[];\n\tcost: Model<Api>[\"cost\"];\n\tcontextWindow: number;\n\tmaxTokens: number;\n\tcompat?: Model<Api>[\"compat\"];\n\tthinkingLevelMap?: Model<Api>[\"thinkingLevelMap\"];\n\tsource: \"user\";\n}\n\nexport interface UserModelsFile {\n\tversion: number;\n\tmodels: UserModelEntry[];\n}\n\nexport function userModelsPath(agentDir: string = getAgentDir()): string {\n\treturn join(agentDir, USER_MODELS_FILENAME);\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n\treturn typeof value === \"object\" && value !== null && !Array.isArray(value);\n}\n\nfunction asFiniteNumber(value: unknown): number | undefined {\n\tif (typeof value === \"number\" && Number.isFinite(value)) return value;\n\treturn undefined;\n}\n\nfunction parseUserEntry(value: unknown): UserModelEntry | undefined {\n\tif (!isRecord(value)) return undefined;\n\tconst id = typeof value.id === \"string\" ? value.id.trim() : \"\";\n\tconst provider = typeof value.provider === \"string\" ? value.provider.trim() : \"\";\n\tif (!id || !provider) return undefined;\n\tconst parsedInput: (\"text\" | \"image\")[] = Array.isArray(value.input)\n\t\t? value.input.filter((entry): entry is \"text\" | \"image\" => entry === \"text\" || entry === \"image\")\n\t\t: [\"text\"];\n\tconst input: (\"text\" | \"image\")[] = parsedInput.length > 0 ? parsedInput : [\"text\"];\n\tconst cost = isRecord(value.cost)\n\t\t? {\n\t\t\t\tinput: asFiniteNumber(value.cost.input) ?? 0,\n\t\t\t\toutput: asFiniteNumber(value.cost.output) ?? 0,\n\t\t\t\tcacheRead: asFiniteNumber(value.cost.cacheRead) ?? 0,\n\t\t\t\tcacheWrite: asFiniteNumber(value.cost.cacheWrite) ?? 0,\n\t\t\t}\n\t\t: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 };\n\treturn {\n\t\tid,\n\t\tname: typeof value.name === \"string\" && value.name.trim() ? value.name : id,\n\t\tapi: typeof value.api === \"string\" && value.api.trim() ? value.api : \"openai-completions\",\n\t\tprovider,\n\t\tbaseUrl: typeof value.baseUrl === \"string\" ? value.baseUrl : \"\",\n\t\treasoning: value.reasoning === true,\n\t\tinput,\n\t\tcost,\n\t\tcontextWindow: asFiniteNumber(value.contextWindow) ?? 128000,\n\t\tmaxTokens: asFiniteNumber(value.maxTokens) ?? 8192,\n\t\tcompat: isRecord(value.compat) ? (value.compat as Model<Api>[\"compat\"]) : undefined,\n\t\tthinkingLevelMap: isRecord(value.thinkingLevelMap)\n\t\t\t? (value.thinkingLevelMap as Model<Api>[\"thinkingLevelMap\"])\n\t\t\t: undefined,\n\t\tsource: \"user\",\n\t};\n}\n\nexport function emptyUserModels(): UserModelsFile {\n\treturn { version: 1, models: [] };\n}\n\n/** Read user-models.json. Missing or unreadable files yield an empty document (never throws). */\nexport function readUserModels(path: string): UserModelsFile {\n\ttry {\n\t\tif (!existsSync(path)) return emptyUserModels();\n\t\tconst parsed: unknown = JSON.parse(readFileSync(path, \"utf-8\"));\n\t\tif (!isRecord(parsed) || !Array.isArray(parsed.models)) return emptyUserModels();\n\t\tconst models: UserModelEntry[] = [];\n\t\tfor (const entry of parsed.models) {\n\t\t\tconst model = parseUserEntry(entry);\n\t\t\tif (model) models.push(model);\n\t\t}\n\t\treturn { version: asFiniteNumber(parsed.version) ?? 1, models };\n\t} catch {\n\t\treturn emptyUserModels();\n\t}\n}\n\nexport function writeUserModels(file: UserModelsFile, path: string): void {\n\tmkdirSync(dirname(path), { recursive: true, mode: 0o700 });\n\twriteFileSync(path, `${JSON.stringify({ version: file.version ?? 1, models: file.models }, null, 2)}\\n`, \"utf-8\");\n}\n\nexport function evictUserModelsOnOfficial(\n\tuser: UserModelsFile,\n\tofficialKeys: Iterable<string>,\n): { next: UserModelsFile; evicted: UserModelEntry[] } {\n\tconst hits = new Set(officialKeys);\n\tconst kept: UserModelEntry[] = [];\n\tconst evicted: UserModelEntry[] = [];\n\tfor (const model of user.models) {\n\t\tif (hits.has(modelKey(model.provider, model.id))) evicted.push(model);\n\t\telse kept.push(model);\n\t}\n\treturn { next: { version: user.version, models: kept }, evicted };\n}\n\nexport function evictUserModelsByProvider(\n\tuser: UserModelsFile,\n\tproviderId: string,\n): { next: UserModelsFile; evicted: UserModelEntry[] } {\n\tconst kept: UserModelEntry[] = [];\n\tconst evicted: UserModelEntry[] = [];\n\tfor (const model of user.models) {\n\t\tif (model.provider === providerId) evicted.push(model);\n\t\telse kept.push(model);\n\t}\n\treturn { next: { version: user.version, models: kept }, evicted };\n}\n\nexport function upsertUserModels(existing: UserModelsFile, rows: readonly UserModelEntry[]): UserModelsFile {\n\tconst byKey = new Map(existing.models.map((model) => [modelKey(model.provider, model.id), model]));\n\tfor (const row of rows) byKey.set(modelKey(row.provider, row.id), { ...row, source: \"user\" });\n\treturn { version: existing.version ?? 1, models: [...byKey.values()] };\n}\n\nexport function userEntryToModel(entry: UserModelEntry): Model<Api> {\n\treturn {\n\t\tid: entry.id,\n\t\tname: entry.name,\n\t\tapi: entry.api,\n\t\tprovider: entry.provider,\n\t\tbaseUrl: entry.baseUrl,\n\t\treasoning: entry.reasoning,\n\t\tinput: entry.input,\n\t\tcost: entry.cost,\n\t\tcontextWindow: entry.contextWindow,\n\t\tmaxTokens: entry.maxTokens,\n\t\tcompat: entry.compat,\n\t\tthinkingLevelMap: entry.thinkingLevelMap,\n\t};\n}\n\nexport function modelToUserEntry(model: Model<Api>): UserModelEntry {\n\treturn {\n\t\tid: model.id,\n\t\tname: model.name,\n\t\tapi: model.api,\n\t\tprovider: model.provider,\n\t\tbaseUrl: model.baseUrl,\n\t\treasoning: model.reasoning,\n\t\tinput: model.input,\n\t\tcost: model.cost,\n\t\tcontextWindow: model.contextWindow,\n\t\tmaxTokens: model.maxTokens,\n\t\tcompat: model.compat,\n\t\tthinkingLevelMap: model.thinkingLevelMap,\n\t\tsource: \"user\",\n\t};\n}\n\nexport class UserModelsStore {\n\tprivate readonly path: string | undefined;\n\tprivate file: UserModelsFile;\n\n\tconstructor(path: string | undefined) {\n\t\tthis.path = path;\n\t\tthis.file = path ? readUserModels(path) : emptyUserModels();\n\t}\n\n\tlist(): UserModelEntry[] {\n\t\treturn this.file.models;\n\t}\n\n\tkeys(): Set<string> {\n\t\treturn new Set(this.file.models.map((model) => modelKey(model.provider, model.id)));\n\t}\n\n\tmodelsFor(providerId: string): Model<Api>[] {\n\t\treturn this.file.models.filter((model) => model.provider === providerId).map(userEntryToModel);\n\t}\n\n\tevictOfficial(officialKeys: Iterable<string>): UserModelEntry[] {\n\t\tconst { next, evicted } = evictUserModelsOnOfficial(this.file, officialKeys);\n\t\tif (evicted.length > 0) {\n\t\t\tthis.file = next;\n\t\t\tthis.persist();\n\t\t}\n\t\treturn evicted;\n\t}\n\n\tevictProvider(providerId: string): UserModelEntry[] {\n\t\tconst { next, evicted } = evictUserModelsByProvider(this.file, providerId);\n\t\tif (evicted.length > 0) {\n\t\t\tthis.file = next;\n\t\t\tthis.persist();\n\t\t}\n\t\treturn evicted;\n\t}\n\n\tupsert(rows: readonly UserModelEntry[]): void {\n\t\tif (rows.length === 0) return;\n\t\tthis.file = upsertUserModels(this.file, rows);\n\t\tthis.persist();\n\t}\n\n\tprivate persist(): void {\n\t\tif (!this.path) return;\n\t\ttry {\n\t\t\twriteUserModels(this.file, this.path);\n\t\t} catch {\n\t\t\t// Persist is best-effort in test / in-memory runtimes.\n\t\t}\n\t}\n}\n"]}

package/dist/core/user-models.js

@@ -0,0 +1,192 @@
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { getAgentDir } from "../config.js";
+import { modelKey } from "./official-catalog.js";
+export const USER_MODELS_FILENAME = "user-models.json";
+export function userModelsPath(agentDir = getAgentDir()) {
+    return join(agentDir, USER_MODELS_FILENAME);
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function asFiniteNumber(value) {
+    if (typeof value === "number" && Number.isFinite(value))
+        return value;
+    return undefined;
+}
+function parseUserEntry(value) {
+    if (!isRecord(value))
+        return undefined;
+    const id = typeof value.id === "string" ? value.id.trim() : "";
+    const provider = typeof value.provider === "string" ? value.provider.trim() : "";
+    if (!id || !provider)
+        return undefined;
+    const parsedInput = Array.isArray(value.input)
+        ? value.input.filter((entry) => entry === "text" || entry === "image")
+        : ["text"];
+    const input = parsedInput.length > 0 ? parsedInput : ["text"];
+    const cost = isRecord(value.cost)
+        ? {
+            input: asFiniteNumber(value.cost.input) ?? 0,
+            output: asFiniteNumber(value.cost.output) ?? 0,
+            cacheRead: asFiniteNumber(value.cost.cacheRead) ?? 0,
+            cacheWrite: asFiniteNumber(value.cost.cacheWrite) ?? 0,
+        }
+        : { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 };
+    return {
+        id,
+        name: typeof value.name === "string" && value.name.trim() ? value.name : id,
+        api: typeof value.api === "string" && value.api.trim() ? value.api : "openai-completions",
+        provider,
+        baseUrl: typeof value.baseUrl === "string" ? value.baseUrl : "",
+        reasoning: value.reasoning === true,
+        input,
+        cost,
+        contextWindow: asFiniteNumber(value.contextWindow) ?? 128000,
+        maxTokens: asFiniteNumber(value.maxTokens) ?? 8192,
+        compat: isRecord(value.compat) ? value.compat : undefined,
+        thinkingLevelMap: isRecord(value.thinkingLevelMap)
+            ? value.thinkingLevelMap
+            : undefined,
+        source: "user",
+    };
+}
+export function emptyUserModels() {
+    return { version: 1, models: [] };
+}
+/** Read user-models.json. Missing or unreadable files yield an empty document (never throws). */
+export function readUserModels(path) {
+    try {
+        if (!existsSync(path))
+            return emptyUserModels();
+        const parsed = JSON.parse(readFileSync(path, "utf-8"));
+        if (!isRecord(parsed) || !Array.isArray(parsed.models))
+            return emptyUserModels();
+        const models = [];
+        for (const entry of parsed.models) {
+            const model = parseUserEntry(entry);
+            if (model)
+                models.push(model);
+        }
+        return { version: asFiniteNumber(parsed.version) ?? 1, models };
+    }
+    catch {
+        return emptyUserModels();
+    }
+}
+export function writeUserModels(file, path) {
+    mkdirSync(dirname(path), { recursive: true, mode: 0o700 });
+    writeFileSync(path, `${JSON.stringify({ version: file.version ?? 1, models: file.models }, null, 2)}\n`, "utf-8");
+}
+export function evictUserModelsOnOfficial(user, officialKeys) {
+    const hits = new Set(officialKeys);
+    const kept = [];
+    const evicted = [];
+    for (const model of user.models) {
+        if (hits.has(modelKey(model.provider, model.id)))
+            evicted.push(model);
+        else
+            kept.push(model);
+    }
+    return { next: { version: user.version, models: kept }, evicted };
+}
+export function evictUserModelsByProvider(user, providerId) {
+    const kept = [];
+    const evicted = [];
+    for (const model of user.models) {
+        if (model.provider === providerId)
+            evicted.push(model);
+        else
+            kept.push(model);
+    }
+    return { next: { version: user.version, models: kept }, evicted };
+}
+export function upsertUserModels(existing, rows) {
+    const byKey = new Map(existing.models.map((model) => [modelKey(model.provider, model.id), model]));
+    for (const row of rows)
+        byKey.set(modelKey(row.provider, row.id), { ...row, source: "user" });
+    return { version: existing.version ?? 1, models: [...byKey.values()] };
+}
+export function userEntryToModel(entry) {
+    return {
+        id: entry.id,
+        name: entry.name,
+        api: entry.api,
+        provider: entry.provider,
+        baseUrl: entry.baseUrl,
+        reasoning: entry.reasoning,
+        input: entry.input,
+        cost: entry.cost,
+        contextWindow: entry.contextWindow,
+        maxTokens: entry.maxTokens,
+        compat: entry.compat,
+        thinkingLevelMap: entry.thinkingLevelMap,
+    };
+}
+export function modelToUserEntry(model) {
+    return {
+        id: model.id,
+        name: model.name,
+        api: model.api,
+        provider: model.provider,
+        baseUrl: model.baseUrl,
+        reasoning: model.reasoning,
+        input: model.input,
+        cost: model.cost,
+        contextWindow: model.contextWindow,
+        maxTokens: model.maxTokens,
+        compat: model.compat,
+        thinkingLevelMap: model.thinkingLevelMap,
+        source: "user",
+    };
+}
+export class UserModelsStore {
+    path;
+    file;
+    constructor(path) {
+        this.path = path;
+        this.file = path ? readUserModels(path) : emptyUserModels();
+    }
+    list() {
+        return this.file.models;
+    }
+    keys() {
+        return new Set(this.file.models.map((model) => modelKey(model.provider, model.id)));
+    }
+    modelsFor(providerId) {
+        return this.file.models.filter((model) => model.provider === providerId).map(userEntryToModel);
+    }
+    evictOfficial(officialKeys) {
+        const { next, evicted } = evictUserModelsOnOfficial(this.file, officialKeys);
+        if (evicted.length > 0) {
+            this.file = next;
+            this.persist();
+        }
+        return evicted;
+    }
+    evictProvider(providerId) {
+        const { next, evicted } = evictUserModelsByProvider(this.file, providerId);
+        if (evicted.length > 0) {
+            this.file = next;
+            this.persist();
+        }
+        return evicted;
+    }
+    upsert(rows) {
+        if (rows.length === 0)
+            return;
+        this.file = upsertUserModels(this.file, rows);
+        this.persist();
+    }
+    persist() {
+        if (!this.path)
+            return;
+        try {
+            writeUserModels(this.file, this.path);
+        }
+        catch {
+            // Persist is best-effort in test / in-memory runtimes.
+        }
+    }
+}
+//# sourceMappingURL=user-models.js.map

package/dist/core/user-models.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"user-models.js","sourceRoot":"","sources":["../../src/core/user-models.ts"],"names":[],"mappings":"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","sourcesContent":["import { existsSync, mkdirSync, readFileSync, writeFileSync } from \"node:fs\";\nimport { dirname, join } from \"node:path\";\nimport type { Api, Model } from \"@earendil-works/pi-ai\";\nimport { getAgentDir } from \"../config.ts\";\nimport { modelKey } from \"./official-catalog.ts\";\n\nexport const USER_MODELS_FILENAME = \"user-models.json\";\n\nexport interface UserModelEntry {\n\tid: string;\n\tname: string;\n\tapi: Api;\n\tprovider: string;\n\tbaseUrl: string;\n\treasoning: boolean;\n\tinput: (\"text\" | \"image\")[];\n\tcost: Model<Api>[\"cost\"];\n\tcontextWindow: number;\n\tmaxTokens: number;\n\tcompat?: Model<Api>[\"compat\"];\n\tthinkingLevelMap?: Model<Api>[\"thinkingLevelMap\"];\n\tsource: \"user\";\n}\n\nexport interface UserModelsFile {\n\tversion: number;\n\tmodels: UserModelEntry[];\n}\n\nexport function userModelsPath(agentDir: string = getAgentDir()): string {\n\treturn join(agentDir, USER_MODELS_FILENAME);\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n\treturn typeof value === \"object\" && value !== null && !Array.isArray(value);\n}\n\nfunction asFiniteNumber(value: unknown): number | undefined {\n\tif (typeof value === \"number\" && Number.isFinite(value)) return value;\n\treturn undefined;\n}\n\nfunction parseUserEntry(value: unknown): UserModelEntry | undefined {\n\tif (!isRecord(value)) return undefined;\n\tconst id = typeof value.id === \"string\" ? value.id.trim() : \"\";\n\tconst provider = typeof value.provider === \"string\" ? value.provider.trim() : \"\";\n\tif (!id || !provider) return undefined;\n\tconst parsedInput: (\"text\" | \"image\")[] = Array.isArray(value.input)\n\t\t? value.input.filter((entry): entry is \"text\" | \"image\" => entry === \"text\" || entry === \"image\")\n\t\t: [\"text\"];\n\tconst input: (\"text\" | \"image\")[] = parsedInput.length > 0 ? parsedInput : [\"text\"];\n\tconst cost = isRecord(value.cost)\n\t\t? {\n\t\t\t\tinput: asFiniteNumber(value.cost.input) ?? 0,\n\t\t\t\toutput: asFiniteNumber(value.cost.output) ?? 0,\n\t\t\t\tcacheRead: asFiniteNumber(value.cost.cacheRead) ?? 0,\n\t\t\t\tcacheWrite: asFiniteNumber(value.cost.cacheWrite) ?? 0,\n\t\t\t}\n\t\t: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 };\n\treturn {\n\t\tid,\n\t\tname: typeof value.name === \"string\" && value.name.trim() ? value.name : id,\n\t\tapi: typeof value.api === \"string\" && value.api.trim() ? value.api : \"openai-completions\",\n\t\tprovider,\n\t\tbaseUrl: typeof value.baseUrl === \"string\" ? value.baseUrl : \"\",\n\t\treasoning: value.reasoning === true,\n\t\tinput,\n\t\tcost,\n\t\tcontextWindow: asFiniteNumber(value.contextWindow) ?? 128000,\n\t\tmaxTokens: asFiniteNumber(value.maxTokens) ?? 8192,\n\t\tcompat: isRecord(value.compat) ? (value.compat as Model<Api>[\"compat\"]) : undefined,\n\t\tthinkingLevelMap: isRecord(value.thinkingLevelMap)\n\t\t\t? (value.thinkingLevelMap as Model<Api>[\"thinkingLevelMap\"])\n\t\t\t: undefined,\n\t\tsource: \"user\",\n\t};\n}\n\nexport function emptyUserModels(): UserModelsFile {\n\treturn { version: 1, models: [] };\n}\n\n/** Read user-models.json. Missing or unreadable files yield an empty document (never throws). */\nexport function readUserModels(path: string): UserModelsFile {\n\ttry {\n\t\tif (!existsSync(path)) return emptyUserModels();\n\t\tconst parsed: unknown = JSON.parse(readFileSync(path, \"utf-8\"));\n\t\tif (!isRecord(parsed) || !Array.isArray(parsed.models)) return emptyUserModels();\n\t\tconst models: UserModelEntry[] = [];\n\t\tfor (const entry of parsed.models) {\n\t\t\tconst model = parseUserEntry(entry);\n\t\t\tif (model) models.push(model);\n\t\t}\n\t\treturn { version: asFiniteNumber(parsed.version) ?? 1, models };\n\t} catch {\n\t\treturn emptyUserModels();\n\t}\n}\n\nexport function writeUserModels(file: UserModelsFile, path: string): void {\n\tmkdirSync(dirname(path), { recursive: true, mode: 0o700 });\n\twriteFileSync(path, `${JSON.stringify({ version: file.version ?? 1, models: file.models }, null, 2)}\\n`, \"utf-8\");\n}\n\nexport function evictUserModelsOnOfficial(\n\tuser: UserModelsFile,\n\tofficialKeys: Iterable<string>,\n): { next: UserModelsFile; evicted: UserModelEntry[] } {\n\tconst hits = new Set(officialKeys);\n\tconst kept: UserModelEntry[] = [];\n\tconst evicted: UserModelEntry[] = [];\n\tfor (const model of user.models) {\n\t\tif (hits.has(modelKey(model.provider, model.id))) evicted.push(model);\n\t\telse kept.push(model);\n\t}\n\treturn { next: { version: user.version, models: kept }, evicted };\n}\n\nexport function evictUserModelsByProvider(\n\tuser: UserModelsFile,\n\tproviderId: string,\n): { next: UserModelsFile; evicted: UserModelEntry[] } {\n\tconst kept: UserModelEntry[] = [];\n\tconst evicted: UserModelEntry[] = [];\n\tfor (const model of user.models) {\n\t\tif (model.provider === providerId) evicted.push(model);\n\t\telse kept.push(model);\n\t}\n\treturn { next: { version: user.version, models: kept }, evicted };\n}\n\nexport function upsertUserModels(existing: UserModelsFile, rows: readonly UserModelEntry[]): UserModelsFile {\n\tconst byKey = new Map(existing.models.map((model) => [modelKey(model.provider, model.id), model]));\n\tfor (const row of rows) byKey.set(modelKey(row.provider, row.id), { ...row, source: \"user\" });\n\treturn { version: existing.version ?? 1, models: [...byKey.values()] };\n}\n\nexport function userEntryToModel(entry: UserModelEntry): Model<Api> {\n\treturn {\n\t\tid: entry.id,\n\t\tname: entry.name,\n\t\tapi: entry.api,\n\t\tprovider: entry.provider,\n\t\tbaseUrl: entry.baseUrl,\n\t\treasoning: entry.reasoning,\n\t\tinput: entry.input,\n\t\tcost: entry.cost,\n\t\tcontextWindow: entry.contextWindow,\n\t\tmaxTokens: entry.maxTokens,\n\t\tcompat: entry.compat,\n\t\tthinkingLevelMap: entry.thinkingLevelMap,\n\t};\n}\n\nexport function modelToUserEntry(model: Model<Api>): UserModelEntry {\n\treturn {\n\t\tid: model.id,\n\t\tname: model.name,\n\t\tapi: model.api,\n\t\tprovider: model.provider,\n\t\tbaseUrl: model.baseUrl,\n\t\treasoning: model.reasoning,\n\t\tinput: model.input,\n\t\tcost: model.cost,\n\t\tcontextWindow: model.contextWindow,\n\t\tmaxTokens: model.maxTokens,\n\t\tcompat: model.compat,\n\t\tthinkingLevelMap: model.thinkingLevelMap,\n\t\tsource: \"user\",\n\t};\n}\n\nexport class UserModelsStore {\n\tprivate readonly path: string | undefined;\n\tprivate file: UserModelsFile;\n\n\tconstructor(path: string | undefined) {\n\t\tthis.path = path;\n\t\tthis.file = path ? readUserModels(path) : emptyUserModels();\n\t}\n\n\tlist(): UserModelEntry[] {\n\t\treturn this.file.models;\n\t}\n\n\tkeys(): Set<string> {\n\t\treturn new Set(this.file.models.map((model) => modelKey(model.provider, model.id)));\n\t}\n\n\tmodelsFor(providerId: string): Model<Api>[] {\n\t\treturn this.file.models.filter((model) => model.provider === providerId).map(userEntryToModel);\n\t}\n\n\tevictOfficial(officialKeys: Iterable<string>): UserModelEntry[] {\n\t\tconst { next, evicted } = evictUserModelsOnOfficial(this.file, officialKeys);\n\t\tif (evicted.length > 0) {\n\t\t\tthis.file = next;\n\t\t\tthis.persist();\n\t\t}\n\t\treturn evicted;\n\t}\n\n\tevictProvider(providerId: string): UserModelEntry[] {\n\t\tconst { next, evicted } = evictUserModelsByProvider(this.file, providerId);\n\t\tif (evicted.length > 0) {\n\t\t\tthis.file = next;\n\t\t\tthis.persist();\n\t\t}\n\t\treturn evicted;\n\t}\n\n\tupsert(rows: readonly UserModelEntry[]): void {\n\t\tif (rows.length === 0) return;\n\t\tthis.file = upsertUserModels(this.file, rows);\n\t\tthis.persist();\n\t}\n\n\tprivate persist(): void {\n\t\tif (!this.path) return;\n\t\ttry {\n\t\t\twriteUserModels(this.file, this.path);\n\t\t} catch {\n\t\t\t// Persist is best-effort in test / in-memory runtimes.\n\t\t}\n\t}\n}\n"]}

package/dist/gateway/adapters/discord.d.ts

@@ -0,0 +1,251 @@
+/**
+ * lunR: gateway Discord adapter (Phase 3).
+ *
+ * Built on discord.js v14 (gateway websocket; the library owns reconnects and
+ * REST rate-limit queuing internally, so neither is handled here). No voice,
+ * no native slash-command registration — commands arrive as plain message
+ * text, same as Telegram.
+ *
+ * Intents: Guilds, GuildMessages, DirectMessages, MessageContent. GuildMembers
+ * is deliberately NOT requested: it is a privileged intent, and asking for it
+ * without the dev-portal opt-in makes Discord refuse the identify — the bot
+ * connects and immediately goes offline. v1 has no role-based config
+ * (SessionSource.roleAuthorized stays undefined), so there is nothing to gain.
+ *
+ * Inbound: messageToEvent() is the pure message → MessageEvent mapping
+ * (dm/group/thread chat types, <@id>/<@!id> mention detection with the mention
+ * stripped, thread-participation counts as a mention, own + all-bot + system +
+ * attachment-only messages dropped, other-mention-without-us dropped outside
+ * DMs — hermes DISCORD_IGNORE_NO_MENTION). A module-level seen-id Set
+ * (cap 500, FIFO evict) drops gateway-resume replays. cfg.ignoredChannels is
+ * enforced adapter-side (channel id or parent id; blacklist wins over
+ * mentions). Consecutive texts from the same chat/thread/user are debounced
+ * 600ms and merged ("\n"-joined, latest messageId kept); texts starting with
+ * "/" flush immediately so commands never merge.
+ * Button interactions are routed via interactionCreate → buttonInteractionToEvent().
+ *
+ * chatId/threadId mapping (pairs with session-keys.ts buildSessionKey):
+ *   dm     → chatId = channel.id                        → agent:main:discord:dm:<channelId>
+ *   thread → chatId = PARENT channel id, threadId =     → agent:main:discord:thread:<parentId>:<threadId>
+ *            thread channel id (shared session, no userId)
+ *   guild text/announcement → chatId = channel.id       → agent:main:discord:group:<channelId>[:<userId>]
+ *            (chatType "group"; userId appended when groupSessionsPerUser is on)
+ *
+ * autoThread (cfg.discord.autoThread, default true): a bot-mentioning message
+ * in a guild TEXT channel gets a thread spun off it (startThread, 60min
+ * archive); the event is re-targeted to the thread (chatType "thread", chatId
+ * parent id, threadId thread id). On failure the event stays in-channel.
+ *
+ * Thread participation: an in-memory Set of thread ids the bot has sent to
+ * (recorded on every successful send() into a thread and on autoThread
+ * creation); messages in those threads count as mentionedBot so follow-ups
+ * don't need a re-mention. NOT persisted in v1 (hermes persists it).
+ *
+ * Outbound: channel.send({ content, reply: { messageReference } }) with a
+ * one-shot plain-send fallback when the reply reference fails. DiscordAPIError
+ * 50035 (invalid form body, e.g. overlong content) is reported non-retryable;
+ * 429s are queued internally by discord.js; everything else is retryable.
+ * editMessage resolves the channel via a messageId → channel map recorded at
+ * send() time (router passes only chatId, but thread messages live in their
+ * own channel); Unknown Message (10008) is a terminal { success: false }.
+ * Message splitting is NOT done here — the router owns that (text.ts).
+ *
+ * Buttons: ActionRowBuilder rows of ButtonBuilder components (max 5×5).
+ * answerCallback acknowledges the interaction; a text argument produces an
+ * ephemeral reply (used for unauthorized/expired taps), otherwise deferUpdate().
+ *
+ * Typing: sendTyping() is a self-contained refresher — Discord typing bubbles
+ * last ~10s, so the action is re-sent on an unref'd 8s interval per target.
+ * The interval stops when send() completes for that target or after 2 minutes
+ * without a refresh (safety net). All errors swallowed.
+ *
+ * Testability: the discord.js Client goes through an injectable clientFactory
+ * (tests inject a minimal fake), timers through an injectable Scheduler, and
+ * messageToEvent() operates on the structural DiscordMessageLike — plain mock
+ * objects, no real Client construction.
+ */
+import type { DiscordConfig } from "../config.ts";
+import type { ButtonSpec, CallbackEvent, MessageEvent, PlatformAdapter, SendOptions, SendResult } from "../types.ts";
+import type { Scheduler } from "./telegram.ts";
+export interface DiscordSentMessageLike {
+    id: string;
+}
+export interface DiscordFetchedMessageLike {
+    content?: string;
+    edit?(options: string | {
+        content: string;
+        components?: unknown[];
+    }): Promise<unknown>;
+}
+export interface DiscordChannelLike {
+    id: string;
+    type: number;
+    parentId?: string | null;
+    send?(payload: {
+        content: string;
+        reply?: {
+            messageReference: string;
+        };
+        components?: unknown[];
+    }): Promise<DiscordSentMessageLike>;
+    sendTyping?(): Promise<unknown>;
+    messages?: {
+        cache?: {
+            get(id: string): {
+                content?: string;
+            } | undefined;
+        };
+        fetch(id: string): Promise<DiscordFetchedMessageLike | null>;
+    };
+}
+export interface DiscordButtonInteractionLike {
+    id: string;
+    customId: string;
+    user: {
+        id: string;
+        username?: string;
+    };
+    message: {
+        id: string;
+        channel: DiscordChannelLike;
+    };
+    isButton(): boolean;
+    deferUpdate(): Promise<unknown>;
+    reply?(options: {
+        content: string;
+        ephemeral: boolean;
+    }): Promise<unknown>;
+    update?(options: {
+        content: string;
+        components?: unknown[];
+    }): Promise<unknown>;
+}
+export interface DiscordAttachmentLike {
+    id: string;
+    /** Direct CDN URL for the attachment content. */
+    url: string;
+    contentType?: string;
+    name?: string;
+    size?: number;
+}
+export interface DiscordMessageLike {
+    id: string;
+    content?: string;
+    system?: boolean;
+    author: {
+        id: string;
+        bot?: boolean;
+        username?: string;
+    };
+    channel: DiscordChannelLike;
+    reference?: {
+        messageId?: string | null;
+    } | null;
+    mentions?: {
+        has(user: {
+            id: string;
+        }): boolean;
+        repliedUser?: {
+            id: string;
+        } | null;
+    };
+    startThread?(opts: {
+        name: string;
+        autoArchiveDuration: number;
+    }): Promise<DiscordChannelLike>;
+    attachments?: DiscordAttachmentLike[];
+}
+/** Minimal Client surface; the real discord.js Client satisfies this. */
+export interface DiscordClientLike {
+    user: {
+        id: string;
+    } | null;
+    login(token: string): Promise<unknown>;
+    on(event: string, listener: (arg: unknown) => void): unknown;
+    once(event: string, listener: () => void): unknown;
+    destroy(): void;
+    channels: {
+        fetch(id: string): Promise<DiscordChannelLike | null>;
+    };
+}
+export type DiscordClientFactory = () => DiscordClientLike;
+export interface MessageToEventOptions {
+    /** Channel ids (or parent ids for threads) to drop outright — blacklist wins over mentions. */
+    ignoredChannels?: readonly string[];
+    /** Threads the bot has spoken in; messages there count as mentionedBot. */
+    participatingThreads?: ReadonlySet<string>;
+}
+/** lunr: collect inbound image attachments (contentType image/*) from a Discord message. */
+export declare function collectDiscordImageAttachments(message: DiscordMessageLike): DiscordAttachmentLike[];
+/**
+ * Map a Discord message to a MessageEvent; null = drop (own message, any bot,
+ * system message, ignored channel, unsupported channel type, or a non-DM
+ * message mentioning others but not us). Messages with no text but image
+ * attachments are kept (v1: images inbound).
+ */
+export declare function messageToEvent(message: DiscordMessageLike, botUser: {
+    id: string;
+}, options?: MessageToEventOptions): MessageEvent | null;
+export declare function buttonInteractionToEvent(interaction: DiscordButtonInteractionLike): CallbackEvent | null;
+/** Test hook: reset RESUME dedup state between tests. */
+export declare function resetSeenMessageIds(): void;
+export interface DiscordAdapterOptions {
+    /** Injected Client factory (tests). When omitted, a real discord.js Client is created. */
+    clientFactory?: DiscordClientFactory;
+    /** lunr: injected image downloader for inbound attachments (tests). Defaults to fetch(url). */
+    downloadAttachment?: (url: string) => Promise<Uint8Array>;
+    /** lunr: skip inbound media larger than this many bytes. Defaults to 10MB. */
+    maxMediaBytes?: number;
+    scheduler?: Scheduler;
+    debounceMs?: number;
+    now?: () => number;
+}
+export declare class DiscordAdapter implements PlatformAdapter {
+    readonly platform = "discord";
+    readonly maxMessageLength = 2000;
+    private readonly cfg;
+    private readonly clientFactory;
+    private readonly downloadAttachment;
+    private readonly maxMediaBytes;
+    private readonly scheduler;
+    private readonly debounceMs;
+    private readonly now;
+    private client?;
+    private botUserId?;
+    private handler?;
+    private callbackHandler?;
+    private readonly pending;
+    private readonly typing;
+    private readonly channelCache;
+    /** Threads the bot has spoken in (session memory only; hermes persists this). */
+    private readonly participatingThreads;
+    /** messageId → channel it was sent to, so editMessage finds thread messages. */
+    private readonly sentMessageChannels;
+    /** callbackId → interaction, so answerCallback can acknowledge the click. */
+    private readonly callbackInteractions;
+    constructor(cfg: DiscordConfig, options?: DiscordAdapterOptions);
+    onMessage(handler: (event: MessageEvent) => void): void;
+    onCallback(handler: (event: CallbackEvent) => void): void;
+    connect(): Promise<boolean>;
+    disconnect(): Promise<void>;
+    private handleMessage;
+    private downloadAttachments;
+    private handleInteraction;
+    private resolveReplyToText;
+    private maybeAutoThread;
+    private debounceKey;
+    private dispatchEvent;
+    private flushPending;
+    private cancelPending;
+    private fetchChannel;
+    private recordSent;
+    private trySend;
+    send(chatId: string, text: string, opts?: SendOptions): Promise<SendResult>;
+    sendButtons(chatId: string, text: string, buttons: ButtonSpec[][], opts?: SendOptions): Promise<SendResult>;
+    answerCallback(id: string, text?: string): Promise<void>;
+    editMessage(chatId: string, messageId: string, text: string, buttons?: ButtonSpec[][]): Promise<SendResult>;
+    sendTyping(chatId: string, threadId?: string): Promise<void>;
+    private doTyping;
+    private stopTyping;
+}
+//# sourceMappingURL=discord.d.ts.map

package/dist/gateway/adapters/discord.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"discord.d.ts","sourceRoot":"","sources":["../../../src/gateway/adapters/discord.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiEG;AAWH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,KAAK,EACX,UAAU,EACV,aAAa,EAGb,YAAY,EACZ,eAAe,EACf,WAAW,EACX,UAAU,EACV,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAyB/C,MAAM,WAAW,sBAAsB;IACtC,EAAE,EAAE,MAAM,CAAC;CACX;AAED,MAAM,WAAW,yBAAyB;IACzC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,CAAC,OAAO,EAAE,MAAM,GAAG;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,OAAO,EAAE,CAAA;KAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACvF;AAED,MAAM,WAAW,kBAAkB;IAClC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,IAAI,CAAC,CAAC,OAAO,EAAE;QACd,OAAO,EAAE,MAAM,CAAC;QAChB,KAAK,CAAC,EAAE;YAAE,gBAAgB,EAAE,MAAM,CAAA;SAAE,CAAC;QACrC,UAAU,CAAC,EAAE,OAAO,EAAE,CAAC;KACvB,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAAC;IACpC,UAAU,CAAC,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IAChC,QAAQ,CAAC,EAAE;QACV,KAAK,CAAC,EAAE;YAAE,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG;gBAAE,OAAO,CAAC,EAAE,MAAM,CAAA;aAAE,GAAG,SAAS,CAAA;SAAE,CAAC;QAC9D,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,yBAAyB,GAAG,IAAI,CAAC,CAAC;KAC7D,CAAC;CACF;AAED,MAAM,WAAW,4BAA4B;IAC5C,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACxC,OAAO,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,kBAAkB,CAAA;KAAE,CAAC;IACrD,QAAQ,IAAI,OAAO,CAAC;IACpB,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IAChC,KAAK,CAAC,CAAC,OAAO,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC3E,MAAM,CAAC,CAAC,OAAO,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,OAAO,EAAE,CAAA;KAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CAChF;AAED,MAAM,WAAW,qBAAqB;IACrC,EAAE,EAAE,MAAM,CAAC;IACX,iDAAiD;IACjD,GAAG,EAAE,MAAM,CAAC;IACZ,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,kBAAkB;IAClC,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,OAAO,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACzD,OAAO,EAAE,kBAAkB,CAAC;IAC5B,SAAS,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,GAAG,IAAI,CAAC;IACjD,QAAQ,CAAC,EAAE;QACV,GAAG,CAAC,IAAI,EAAE;YAAE,EAAE,EAAE,MAAM,CAAA;SAAE,GAAG,OAAO,CAAC;QACnC,WAAW,CAAC,EAAE;YAAE,EAAE,EAAE,MAAM,CAAA;SAAE,GAAG,IAAI,CAAC;KACpC,CAAC;IACF,WAAW,CAAC,CAAC,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,mBAAmB,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAC;IAC/F,WAAW,CAAC,EAAE,qBAAqB,EAAE,CAAC;CACtC;AAED,yEAAyE;AACzE,MAAM,WAAW,iBAAiB;IACjC,IAAI,EAAE;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IAC5B,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACvC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,IAAI,GAAG,OAAO,CAAC;IAC7D,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC;IACnD,OAAO,IAAI,IAAI,CAAC;IAChB,QAAQ,EAAE;QAAE,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC,CAAA;KAAE,CAAC;CACpE;AAED,MAAM,MAAM,oBAAoB,GAAG,MAAM,iBAAiB,CAAC;AAuB3D,MAAM,WAAW,qBAAqB;IACrC,iGAA+F;IAC/F,eAAe,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,2EAA2E;IAC3E,oBAAoB,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;CAC3C;AAMD,4FAA4F;AAC5F,wBAAgB,8BAA8B,CAAC,OAAO,EAAE,kBAAkB,GAAG,qBAAqB,EAAE,CAEnG;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAC7B,OAAO,EAAE,kBAAkB,EAC3B,OAAO,EAAE;IAAE,EAAE,EAAE,MAAM,CAAA;CAAE,EACvB,OAAO,GAAE,qBAA0B,GACjC,YAAY,GAAG,IAAI,CAmErB;AAiBD,wBAAgB,wBAAwB,CAAC,WAAW,EAAE,4BAA4B,GAAG,aAAa,GAAG,IAAI,CAaxG;AAkCD,yDAAyD;AACzD,wBAAgB,mBAAmB,IAAI,IAAI,CAE1C;AAkCD,MAAM,WAAW,qBAAqB;IACrC,0FAA0F;IAC1F,aAAa,CAAC,EAAE,oBAAoB,CAAC;IACrC,+FAA+F;IAC/F,kBAAkB,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,UAAU,CAAC,CAAC;IAC1D,8EAA8E;IAC9E,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;CACnB;AAgBD,qBAAa,cAAe,YAAW,eAAe;IACrD,QAAQ,CAAC,QAAQ,aAAa;IAC9B,QAAQ,CAAC,gBAAgB,QAAQ;IAEjC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAgB;IACpC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAuB;IACrD,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAuC;IAC1E,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;IACvC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAY;IACtC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAe;IACnC,OAAO,CAAC,MAAM,CAAC,CAAoB;IACnC,OAAO,CAAC,SAAS,CAAC,CAAS;IAC3B,OAAO,CAAC,OAAO,CAAC,CAAgC;IAChD,OAAO,CAAC,eAAe,CAAC,CAAiC;IACzD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAmC;IAC3D,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAkC;IACzD,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAgD;IAC7E,iFAAiF;IACjF,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAAqB;IAC1D,kFAAgF;IAChF,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAA6B;IACjE,+EAA6E;IAC7E,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAAmD;IAExF,YAAY,GAAG,EAAE,aAAa,EAAE,OAAO,GAAE,qBAA0B,EAelE;IAED,SAAS,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,IAAI,GAAG,IAAI,CAEtD;IAED,UAAU,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,IAAI,GAAG,IAAI,CAExD;IAEK,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC,CA8BhC;IAEK,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAOhC;YAMa,aAAa;YAqBb,mBAAmB;YAqBnB,iBAAiB;YAcjB,kBAAkB;YAelB,eAAe;IAuB7B,OAAO,CAAC,WAAW;IAInB,OAAO,CAAC,aAAa;IAyBrB,OAAO,CAAC,YAAY;IAQpB,OAAO,CAAC,aAAa;YAWP,YAAY;IAqB1B,OAAO,CAAC,UAAU;YAaJ,OAAO;IAiBf,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC,CAchF;IAEK,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,UAAU,EAAE,EAAE,EAAE,IAAI,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC,CAahH;IAEK,cAAc,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAa7D;IAEK,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,EAAE,EAAE,GAAG,OAAO,CAAC,UAAU,CAAC,CAqBhH;IAEK,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAsBjE;YAEa,QAAQ;IAStB,OAAO,CAAC,UAAU;CAMlB","sourcesContent":["/**\n * lunR: gateway Discord adapter (Phase 3).\n *\n * Built on discord.js v14 (gateway websocket; the library owns reconnects and\n * REST rate-limit queuing internally, so neither is handled here). No voice,\n * no native slash-command registration — commands arrive as plain message\n * text, same as Telegram.\n *\n * Intents: Guilds, GuildMessages, DirectMessages, MessageContent. GuildMembers\n * is deliberately NOT requested: it is a privileged intent, and asking for it\n * without the dev-portal opt-in makes Discord refuse the identify — the bot\n * connects and immediately goes offline. v1 has no role-based config\n * (SessionSource.roleAuthorized stays undefined), so there is nothing to gain.\n *\n * Inbound: messageToEvent() is the pure message → MessageEvent mapping\n * (dm/group/thread chat types, <@id>/<@!id> mention detection with the mention\n * stripped, thread-participation counts as a mention, own + all-bot + system +\n * attachment-only messages dropped, other-mention-without-us dropped outside\n * DMs — hermes DISCORD_IGNORE_NO_MENTION). A module-level seen-id Set\n * (cap 500, FIFO evict) drops gateway-resume replays. cfg.ignoredChannels is\n * enforced adapter-side (channel id or parent id; blacklist wins over\n * mentions). Consecutive texts from the same chat/thread/user are debounced\n * 600ms and merged (\"\\n\"-joined, latest messageId kept); texts starting with\n * \"/\" flush immediately so commands never merge.\n * Button interactions are routed via interactionCreate → buttonInteractionToEvent().\n *\n * chatId/threadId mapping (pairs with session-keys.ts buildSessionKey):\n *   dm     → chatId = channel.id                        → agent:main:discord:dm:<channelId>\n *   thread → chatId = PARENT channel id, threadId =     → agent:main:discord:thread:<parentId>:<threadId>\n *            thread channel id (shared session, no userId)\n *   guild text/announcement → chatId = channel.id       → agent:main:discord:group:<channelId>[:<userId>]\n *            (chatType \"group\"; userId appended when groupSessionsPerUser is on)\n *\n * autoThread (cfg.discord.autoThread, default true): a bot-mentioning message\n * in a guild TEXT channel gets a thread spun off it (startThread, 60min\n * archive); the event is re-targeted to the thread (chatType \"thread\", chatId\n * parent id, threadId thread id). On failure the event stays in-channel.\n *\n * Thread participation: an in-memory Set of thread ids the bot has sent to\n * (recorded on every successful send() into a thread and on autoThread\n * creation); messages in those threads count as mentionedBot so follow-ups\n * don't need a re-mention. NOT persisted in v1 (hermes persists it).\n *\n * Outbound: channel.send({ content, reply: { messageReference } }) with a\n * one-shot plain-send fallback when the reply reference fails. DiscordAPIError\n * 50035 (invalid form body, e.g. overlong content) is reported non-retryable;\n * 429s are queued internally by discord.js; everything else is retryable.\n * editMessage resolves the channel via a messageId → channel map recorded at\n * send() time (router passes only chatId, but thread messages live in their\n * own channel); Unknown Message (10008) is a terminal { success: false }.\n * Message splitting is NOT done here — the router owns that (text.ts).\n *\n * Buttons: ActionRowBuilder rows of ButtonBuilder components (max 5×5).\n * answerCallback acknowledges the interaction; a text argument produces an\n * ephemeral reply (used for unauthorized/expired taps), otherwise deferUpdate().\n *\n * Typing: sendTyping() is a self-contained refresher — Discord typing bubbles\n * last ~10s, so the action is re-sent on an unref'd 8s interval per target.\n * The interval stops when send() completes for that target or after 2 minutes\n * without a refresh (safety net). All errors swallowed.\n *\n * Testability: the discord.js Client goes through an injectable clientFactory\n * (tests inject a minimal fake), timers through an injectable Scheduler, and\n * messageToEvent() operates on the structural DiscordMessageLike — plain mock\n * objects, no real Client construction.\n */\n\nimport {\n\tActionRowBuilder,\n\tButtonBuilder,\n\tButtonStyle,\n\tChannelType,\n\tClient,\n\tEvents,\n\tGatewayIntentBits,\n} from \"discord.js\";\nimport type { DiscordConfig } from \"../config.ts\";\nimport type {\n\tButtonSpec,\n\tCallbackEvent,\n\tChatType,\n\tInboundAttachment,\n\tMessageEvent,\n\tPlatformAdapter,\n\tSendOptions,\n\tSendResult,\n} from \"../types.ts\";\nimport type { Scheduler } from \"./telegram.ts\";\n\nconst DEFAULT_DEBOUNCE_MS = 600;\nconst TYPING_INTERVAL_MS = 8000; // Discord typing lasts ~10s\nconst TYPING_SAFETY_MS = 120_000; // auto-stop after 2min without a refresh\nconst REPLY_TO_TEXT_MAX = 500;\nconst THREAD_NAME_MAX = 40;\nconst SEEN_CAP = 500;\nconst SENT_CHANNEL_CAP = 500;\nconst CALLBACK_INTERACTION_CAP = 500;\nconst CHANNEL_CACHE_CAP = 500;\nconst PARTICIPATING_THREAD_CAP = 500;\nconst ERR_INVALID_FORM_BODY = 50035; // e.g. content over 2000 chars — non-retryable\nconst ERR_UNKNOWN_MESSAGE = 10008; // deleted/unknown message — terminal\n\nconst THREAD_TYPES: readonly number[] = [\n\tChannelType.PublicThread,\n\tChannelType.PrivateThread,\n\tChannelType.AnnouncementThread,\n];\n\n// ---------------------------------------------------------------------------\n// Structural discord.js shapes (only the fields the adapter reads)\n// ---------------------------------------------------------------------------\n\nexport interface DiscordSentMessageLike {\n\tid: string;\n}\n\nexport interface DiscordFetchedMessageLike {\n\tcontent?: string;\n\tedit?(options: string | { content: string; components?: unknown[] }): Promise<unknown>;\n}\n\nexport interface DiscordChannelLike {\n\tid: string;\n\ttype: number;\n\tparentId?: string | null;\n\tsend?(payload: {\n\t\tcontent: string;\n\t\treply?: { messageReference: string };\n\t\tcomponents?: unknown[];\n\t}): Promise<DiscordSentMessageLike>;\n\tsendTyping?(): Promise<unknown>;\n\tmessages?: {\n\t\tcache?: { get(id: string): { content?: string } | undefined };\n\t\tfetch(id: string): Promise<DiscordFetchedMessageLike | null>;\n\t};\n}\n\nexport interface DiscordButtonInteractionLike {\n\tid: string;\n\tcustomId: string;\n\tuser: { id: string; username?: string };\n\tmessage: { id: string; channel: DiscordChannelLike };\n\tisButton(): boolean;\n\tdeferUpdate(): Promise<unknown>;\n\treply?(options: { content: string; ephemeral: boolean }): Promise<unknown>;\n\tupdate?(options: { content: string; components?: unknown[] }): Promise<unknown>;\n}\n\nexport interface DiscordAttachmentLike {\n\tid: string;\n\t/** Direct CDN URL for the attachment content. */\n\turl: string;\n\tcontentType?: string;\n\tname?: string;\n\tsize?: number;\n}\n\nexport interface DiscordMessageLike {\n\tid: string;\n\tcontent?: string;\n\tsystem?: boolean;\n\tauthor: { id: string; bot?: boolean; username?: string };\n\tchannel: DiscordChannelLike;\n\treference?: { messageId?: string | null } | null;\n\tmentions?: {\n\t\thas(user: { id: string }): boolean;\n\t\trepliedUser?: { id: string } | null;\n\t};\n\tstartThread?(opts: { name: string; autoArchiveDuration: number }): Promise<DiscordChannelLike>;\n\tattachments?: DiscordAttachmentLike[];\n}\n\n/** Minimal Client surface; the real discord.js Client satisfies this. */\nexport interface DiscordClientLike {\n\tuser: { id: string } | null;\n\tlogin(token: string): Promise<unknown>;\n\ton(event: string, listener: (arg: unknown) => void): unknown;\n\tonce(event: string, listener: () => void): unknown;\n\tdestroy(): void;\n\tchannels: { fetch(id: string): Promise<DiscordChannelLike | null> };\n}\n\nexport type DiscordClientFactory = () => DiscordClientLike;\n\n// ---------------------------------------------------------------------------\n// Pure mapping + small helpers\n// ---------------------------------------------------------------------------\n\nfunction errMessage(err: unknown): string {\n\treturn err instanceof Error ? err.message : String(err);\n}\n\n/** lunr: download an inbound Discord attachment from its CDN URL. */\nasync function defaultDownloadAttachment(url: string): Promise<Uint8Array> {\n\tconst res = await fetch(url);\n\tif (!res.ok) throw new Error(`attachment download HTTP ${res.status}`);\n\treturn new Uint8Array(await res.arrayBuffer());\n}\n\n/** Discord REST error code (DiscordAPIError.code) when present. */\nfunction discordErrorCode(err: unknown): number | undefined {\n\tconst code = (err as { code?: unknown } | null)?.code;\n\treturn typeof code === \"number\" ? code : undefined;\n}\n\nexport interface MessageToEventOptions {\n\t/** Channel ids (or parent ids for threads) to drop outright — blacklist wins over mentions. */\n\tignoredChannels?: readonly string[];\n\t/** Threads the bot has spoken in; messages there count as mentionedBot. */\n\tparticipatingThreads?: ReadonlySet<string>;\n}\n\nfunction isImageContentType(contentType: string | undefined): boolean {\n\treturn typeof contentType === \"string\" && contentType.split(\";\")[0]?.trim().toLowerCase().startsWith(\"image/\");\n}\n\n/** lunr: collect inbound image attachments (contentType image/*) from a Discord message. */\nexport function collectDiscordImageAttachments(message: DiscordMessageLike): DiscordAttachmentLike[] {\n\treturn (message.attachments ?? []).filter((attachment) => isImageContentType(attachment.contentType));\n}\n\n/**\n * Map a Discord message to a MessageEvent; null = drop (own message, any bot,\n * system message, ignored channel, unsupported channel type, or a non-DM\n * message mentioning others but not us). Messages with no text but image\n * attachments are kept (v1: images inbound).\n */\nexport function messageToEvent(\n\tmessage: DiscordMessageLike,\n\tbotUser: { id: string },\n\toptions: MessageToEventOptions = {},\n): MessageEvent | null {\n\tconst author = message.author;\n\tif (!author) return null;\n\tif (author.id === botUser.id) return null; // own messages\n\tif (author.bot) return null; // all bots (same simplification as telegram)\n\tif (message.system) return null;\n\tconst content = (message.content ?? \"\").trim();\n\tconst imageAttachments = collectDiscordImageAttachments(message);\n\tif (content === \"\" && imageAttachments.length === 0) return null; // no text and no image attachments\n\n\tconst channel = message.channel;\n\tconst ignored = options.ignoredChannels ?? [];\n\tif (ignored.includes(channel.id) || (channel.parentId != null && ignored.includes(channel.parentId))) {\n\t\treturn null; // blacklist wins over mentions\n\t}\n\n\t// chatId/threadId mapping — see the file header for the session-key pairing.\n\tlet chatType: ChatType;\n\tlet chatId: string;\n\tlet threadId: string | undefined;\n\tif (channel.type === ChannelType.DM) {\n\t\tchatType = \"dm\";\n\t\tchatId = channel.id;\n\t} else if (THREAD_TYPES.includes(channel.type)) {\n\t\tchatType = \"thread\";\n\t\tchatId = channel.parentId ?? channel.id;\n\t\tthreadId = channel.id;\n\t} else if (channel.type === ChannelType.GuildText || channel.type === ChannelType.GuildAnnouncement) {\n\t\tchatType = \"group\";\n\t\tchatId = channel.id;\n\t} else {\n\t\treturn null; // voice/category/forum containers etc. — unsupported in v1\n\t}\n\n\tconst explicitMention = message.mentions?.has(botUser) === true;\n\tconst participating = threadId !== undefined && options.participatingThreads?.has(threadId) === true;\n\tconst mentionedBot = explicitMention || participating;\n\n\t// Multi-agent filter (hermes DISCORD_IGNORE_NO_MENTION): outside DMs, a\n\t// message that mentions other users/bots but not us is not for us.\n\tif (!mentionedBot && chatType !== \"dm\") {\n\t\tconst mentionedIds = [...content.matchAll(/<@!?(\\d+)>/g)].map((m) => m[1]);\n\t\tif (mentionedIds.some((id) => id !== botUser.id)) return null;\n\t}\n\n\tlet text = content;\n\tif (explicitMention) {\n\t\ttext = text.replace(new RegExp(`<@!?${botUser.id}>`, \"g\"), \"\").trim();\n\t}\n\n\tconst refId = message.reference?.messageId;\n\tconst cachedReply = refId != null ? channel.messages?.cache?.get(refId)?.content : undefined;\n\n\treturn {\n\t\ttext,\n\t\tmessageId: message.id,\n\t\treplyToText: cachedReply !== undefined ? cachedReply.slice(0, REPLY_TO_TEXT_MAX) : undefined,\n\t\tsource: {\n\t\t\tplatform: \"discord\",\n\t\t\tchatId,\n\t\t\tchatType,\n\t\t\tuserId: author.id,\n\t\t\tuserName: author.username,\n\t\t\tthreadId,\n\t\t},\n\t\tmetadata: mentionedBot ? { mentionedBot: true } : undefined,\n\t};\n}\n\nfunction mapDiscordChannel(\n\tchannel: DiscordChannelLike,\n): { chatType: ChatType; chatId: string; threadId?: string } | null {\n\tif (channel.type === ChannelType.DM) {\n\t\treturn { chatType: \"dm\", chatId: channel.id };\n\t}\n\tif (THREAD_TYPES.includes(channel.type)) {\n\t\treturn { chatType: \"thread\", chatId: channel.parentId ?? channel.id, threadId: channel.id };\n\t}\n\tif (channel.type === ChannelType.GuildText || channel.type === ChannelType.GuildAnnouncement) {\n\t\treturn { chatType: \"group\", chatId: channel.id };\n\t}\n\treturn null;\n}\n\nexport function buttonInteractionToEvent(interaction: DiscordButtonInteractionLike): CallbackEvent | null {\n\tconst channel = interaction.message.channel;\n\tconst mapped = mapDiscordChannel(channel);\n\tif (!mapped) return null;\n\treturn {\n\t\tid: interaction.id,\n\t\tchatId: mapped.chatId,\n\t\tmessageId: interaction.message.id,\n\t\tuserId: interaction.user.id,\n\t\tuserName: interaction.user.username,\n\t\tdata: interaction.customId,\n\t\tthreadId: mapped.threadId,\n\t};\n}\n\nfunction buildDiscordComponents(buttons: ButtonSpec[][]): unknown[] {\n\tconst rows: ActionRowBuilder<ButtonBuilder>[] = [];\n\tfor (const row of buttons) {\n\t\tconst actionRow = new ActionRowBuilder<ButtonBuilder>();\n\t\tfor (const button of row) {\n\t\t\tconst style = button.data === \"\" ? ButtonStyle.Secondary : ButtonStyle.Secondary;\n\t\t\tconst builder = new ButtonBuilder().setCustomId(button.data).setLabel(button.label).setStyle(style);\n\t\t\tif (button.data === \"\") builder.setDisabled(true);\n\t\t\tactionRow.addComponents(builder);\n\t\t}\n\t\trows.push(actionRow);\n\t}\n\treturn rows;\n}\n\n// ---------------------------------------------------------------------------\n// Gateway-resume replay dedup (module-level: one process = one bot connection)\n// ---------------------------------------------------------------------------\n\nconst seenMessageIds = new Set<string>();\n\n/** Returns true when this id was already seen (drop the replay). */\nfunction markMessageSeen(id: string): boolean {\n\tif (seenMessageIds.has(id)) return true;\n\tseenMessageIds.add(id);\n\tif (seenMessageIds.size > SEEN_CAP) {\n\t\tconst oldest = seenMessageIds.values().next().value; // Sets iterate in insertion order\n\t\tif (oldest !== undefined) seenMessageIds.delete(oldest);\n\t}\n\treturn false;\n}\n\n/** Test hook: reset RESUME dedup state between tests. */\nexport function resetSeenMessageIds(): void {\n\tseenMessageIds.clear();\n}\n\n// ---------------------------------------------------------------------------\n// Adapter\n// ---------------------------------------------------------------------------\n\nconst defaultScheduler: Scheduler = {\n\tsetTimeout: (fn, ms) => {\n\t\tconst handle = setTimeout(fn, ms);\n\t\thandle.unref?.();\n\t\treturn handle;\n\t},\n\tclearTimeout: (handle) => clearTimeout(handle),\n\tsetInterval: (fn, ms) => {\n\t\tconst handle = setInterval(fn, ms);\n\t\thandle.unref?.();\n\t\treturn handle;\n\t},\n\tclearInterval: (handle) => clearInterval(handle),\n};\n\nfunction defaultClientFactory(): DiscordClientLike {\n\t// No GatewayIntentBits.GuildMembers — see the file header for the\n\t// privileged-intent trap (bot stays offline without the portal opt-in).\n\treturn new Client({\n\t\tintents: [\n\t\t\tGatewayIntentBits.Guilds,\n\t\t\tGatewayIntentBits.GuildMessages,\n\t\t\tGatewayIntentBits.DirectMessages,\n\t\t\tGatewayIntentBits.MessageContent,\n\t\t],\n\t}) as unknown as DiscordClientLike;\n}\n\nexport interface DiscordAdapterOptions {\n\t/** Injected Client factory (tests). When omitted, a real discord.js Client is created. */\n\tclientFactory?: DiscordClientFactory;\n\t/** lunr: injected image downloader for inbound attachments (tests). Defaults to fetch(url). */\n\tdownloadAttachment?: (url: string) => Promise<Uint8Array>;\n\t/** lunr: skip inbound media larger than this many bytes. Defaults to 10MB. */\n\tmaxMediaBytes?: number;\n\tscheduler?: Scheduler;\n\tdebounceMs?: number;\n\tnow?: () => number;\n}\n\ninterface PendingEntry {\n\tevent: MessageEvent;\n\ttimer: ReturnType<typeof setTimeout>;\n}\n\ninterface TypingEntry {\n\tinterval: ReturnType<typeof setInterval>;\n\tlastRefresh: number;\n}\n\nfunction typingKey(chatId: string, threadId?: string): string {\n\treturn `${chatId}:${threadId ?? \"\"}`;\n}\n\nexport class DiscordAdapter implements PlatformAdapter {\n\treadonly platform = \"discord\";\n\treadonly maxMessageLength = 2000;\n\n\tprivate readonly cfg: DiscordConfig;\n\tprivate readonly clientFactory: DiscordClientFactory;\n\tprivate readonly downloadAttachment: (url: string) => Promise<Uint8Array>;\n\tprivate readonly maxMediaBytes: number;\n\tprivate readonly scheduler: Scheduler;\n\tprivate readonly debounceMs: number;\n\tprivate readonly now: () => number;\n\tprivate client?: DiscordClientLike;\n\tprivate botUserId?: string;\n\tprivate handler?: (event: MessageEvent) => void;\n\tprivate callbackHandler?: (event: CallbackEvent) => void;\n\tprivate readonly pending = new Map<string, PendingEntry>();\n\tprivate readonly typing = new Map<string, TypingEntry>();\n\tprivate readonly channelCache = new Map<string, DiscordChannelLike | null>();\n\t/** Threads the bot has spoken in (session memory only; hermes persists this). */\n\tprivate readonly participatingThreads = new Set<string>();\n\t/** messageId → channel it was sent to, so editMessage finds thread messages. */\n\tprivate readonly sentMessageChannels = new Map<string, string>();\n\t/** callbackId → interaction, so answerCallback can acknowledge the click. */\n\tprivate readonly callbackInteractions = new Map<string, DiscordButtonInteractionLike>();\n\n\tconstructor(cfg: DiscordConfig, options: DiscordAdapterOptions = {}) {\n\t\tthis.cfg = cfg;\n\t\tthis.scheduler = options.scheduler ?? defaultScheduler;\n\t\tthis.debounceMs = options.debounceMs ?? DEFAULT_DEBOUNCE_MS;\n\t\tthis.now = options.now ?? Date.now;\n\t\tif (options.clientFactory) {\n\t\t\tthis.clientFactory = options.clientFactory;\n\t\t} else {\n\t\t\tif (!cfg.token) {\n\t\t\t\tthrow new Error(\"DiscordAdapter: no bot token (set discord.token or LUNR_DISCORD_BOT_TOKEN)\");\n\t\t\t}\n\t\t\tthis.clientFactory = defaultClientFactory;\n\t\t}\n\t\tthis.downloadAttachment = options.downloadAttachment ?? defaultDownloadAttachment;\n\t\tthis.maxMediaBytes = options.maxMediaBytes ?? 10 * 1024 * 1024;\n\t}\n\n\tonMessage(handler: (event: MessageEvent) => void): void {\n\t\tthis.handler = handler;\n\t}\n\n\tonCallback(handler: (event: CallbackEvent) => void): void {\n\t\tthis.callbackHandler = handler;\n\t}\n\n\tasync connect(): Promise<boolean> {\n\t\tif (!this.cfg.token) {\n\t\t\tthrow new Error(\"DiscordAdapter: no bot token (set discord.token or LUNR_DISCORD_BOT_TOKEN)\");\n\t\t}\n\t\tconst client = this.clientFactory();\n\t\tthis.client = client;\n\t\tclient.on(Events.MessageCreate, (message) => {\n\t\t\tvoid this.handleMessage(message as DiscordMessageLike).catch((err) => {\n\t\t\t\tconsole.error(`[gateway] discord message handling error: ${errMessage(err)}`);\n\t\t\t});\n\t\t});\n\t\tclient.on(Events.InteractionCreate, (interaction) => {\n\t\t\tvoid this.handleInteraction(interaction as DiscordButtonInteractionLike).catch((err) => {\n\t\t\t\tconsole.error(`[gateway] discord interaction handling error: ${errMessage(err)}`);\n\t\t\t});\n\t\t});\n\t\tconst ready = new Promise<void>((resolve) => client.once(Events.ClientReady, () => resolve()));\n\t\ttry {\n\t\t\tawait client.login(this.cfg.token);\n\t\t} catch (err) {\n\t\t\tconsole.error(`[gateway] discord login failed: ${errMessage(err)}`);\n\t\t\treturn false;\n\t\t}\n\t\tawait ready;\n\t\tthis.botUserId = client.user?.id;\n\t\tif (this.botUserId === undefined) {\n\t\t\tconsole.error(\"[gateway] discord: client ready without a user — cannot map messages\");\n\t\t\treturn false;\n\t\t}\n\t\treturn true;\n\t}\n\n\tasync disconnect(): Promise<void> {\n\t\tfor (const key of [...this.pending.keys()]) this.cancelPending(key);\n\t\tfor (const key of [...this.typing.keys()]) this.stopTyping(key);\n\t\tthis.channelCache.clear();\n\t\tthis.callbackInteractions.clear();\n\t\tthis.client?.destroy();\n\t\tthis.client = undefined;\n\t}\n\n\t// -----------------------------------------------------------------------\n\t// Inbound dispatch + debounce\n\t// -----------------------------------------------------------------------\n\n\tprivate async handleMessage(message: DiscordMessageLike): Promise<void> {\n\t\tif (!this.botUserId || !this.handler) return;\n\t\tif (markMessageSeen(message.id)) return; // gateway-resume replay\n\t\tconst event = messageToEvent(\n\t\t\tmessage,\n\t\t\t{ id: this.botUserId },\n\t\t\t{\n\t\t\t\tignoredChannels: this.cfg.ignoredChannels,\n\t\t\t\tparticipatingThreads: this.participatingThreads,\n\t\t\t},\n\t\t);\n\t\tif (!event) return;\n\t\tawait this.resolveReplyToText(message, event);\n\t\tawait this.maybeAutoThread(message, event);\n\t\t// lunr: download inbound image attachments before dispatch so the bridge\n\t\t// can attach images to the turn. Failures drop the media but keep the turn.\n\t\tawait this.downloadAttachments(message, event);\n\t\tthis.dispatchEvent(event);\n\t}\n\n\t/** lunr: download + base64-encode inbound image attachments for one Discord message. */\n\tprivate async downloadAttachments(message: DiscordMessageLike, event: MessageEvent): Promise<void> {\n\t\tconst imageAttachments = collectDiscordImageAttachments(message);\n\t\tif (imageAttachments.length === 0) return;\n\t\tconst attachments: InboundAttachment[] = [];\n\t\tfor (const attachment of imageAttachments) {\n\t\t\tif (attachment.size !== undefined && attachment.size > this.maxMediaBytes) continue;\n\t\t\ttry {\n\t\t\t\tconst bytes = await this.downloadAttachment(attachment.url);\n\t\t\t\tif (bytes.byteLength > this.maxMediaBytes) continue;\n\t\t\t\tattachments.push({\n\t\t\t\t\tdata: Buffer.from(bytes).toString(\"base64\"),\n\t\t\t\t\tmimeType: attachment.contentType ?? \"image/png\",\n\t\t\t\t\t...(attachment.name ? { filename: attachment.name } : {}),\n\t\t\t\t});\n\t\t\t} catch {\n\t\t\t\t// Media download failed — drop this attachment, keep the text turn.\n\t\t\t}\n\t\t}\n\t\tif (attachments.length > 0) event.attachments = attachments;\n\t}\n\n\tprivate async handleInteraction(interaction: DiscordButtonInteractionLike): Promise<void> {\n\t\tif (!this.callbackHandler) return;\n\t\tif (!interaction.isButton()) return;\n\t\tconst event = buttonInteractionToEvent(interaction);\n\t\tif (!event) return;\n\t\tthis.callbackInteractions.set(interaction.id, interaction);\n\t\tif (this.callbackInteractions.size > CALLBACK_INTERACTION_CAP) {\n\t\t\tconst oldest = this.callbackInteractions.keys().next().value;\n\t\t\tif (oldest !== undefined) this.callbackInteractions.delete(oldest);\n\t\t}\n\t\tthis.callbackHandler(event);\n\t}\n\n\t/** Best-effort: fill replyToText from the referenced message when it wasn't cached. */\n\tprivate async resolveReplyToText(message: DiscordMessageLike, event: MessageEvent): Promise<void> {\n\t\tif (event.replyToText !== undefined) return;\n\t\tconst refId = message.reference?.messageId;\n\t\tif (refId == null) return;\n\t\tconst messages = message.channel.messages;\n\t\tif (!messages) return;\n\t\ttry {\n\t\t\tconst referenced = await messages.fetch(refId);\n\t\t\tif (referenced?.content) event.replyToText = referenced.content.slice(0, REPLY_TO_TEXT_MAX);\n\t\t} catch {\n\t\t\t// unknown/deleted reference — no reply context\n\t\t}\n\t}\n\n\t/** autoThread: spin a thread off a bot-mentioning guild-text message and re-target the event. */\n\tprivate async maybeAutoThread(message: DiscordMessageLike, event: MessageEvent): Promise<void> {\n\t\tif (!this.cfg.autoThread) return;\n\t\tif (event.metadata?.mentionedBot !== true) return;\n\t\t// Only guild TEXT channels: DMs can't thread and messages already inside\n\t\t// a thread don't need another one.\n\t\tif (message.channel.type !== ChannelType.GuildText) return;\n\t\tif (typeof message.startThread !== \"function\") return;\n\t\ttry {\n\t\t\tconst thread = await message.startThread({\n\t\t\t\tname: (event.text || \"conversation\").slice(0, THREAD_NAME_MAX),\n\t\t\t\tautoArchiveDuration: 60,\n\t\t\t});\n\t\t\tthis.participatingThreads.add(thread.id);\n\t\t\tif (this.participatingThreads.size > PARTICIPATING_THREAD_CAP) {\n\t\t\t\tconst oldest = this.participatingThreads.values().next().value;\n\t\t\t\tif (oldest !== undefined) this.participatingThreads.delete(oldest);\n\t\t\t}\n\t\t\tevent.source = { ...event.source, chatType: \"thread\", chatId: message.channel.id, threadId: thread.id };\n\t\t} catch {\n\t\t\t// e.g. missing CREATE_THREADS permission — respond in-channel instead.\n\t\t}\n\t}\n\n\tprivate debounceKey(event: MessageEvent): string {\n\t\treturn `${event.source.chatId}:${event.source.threadId ?? \"\"}:${event.source.userId}`;\n\t}\n\n\tprivate dispatchEvent(event: MessageEvent): void {\n\t\tconst key = this.debounceKey(event);\n\t\tif (event.text.trimStart().startsWith(\"/\")) {\n\t\t\t// Commands must not merge: flush any pending text, emit immediately.\n\t\t\tthis.flushPending(key);\n\t\t\tthis.handler?.(event);\n\t\t\treturn;\n\t\t}\n\t\tconst existing = this.pending.get(key);\n\t\tif (existing) {\n\t\t\tthis.scheduler.clearTimeout(existing.timer);\n\t\t\t// Merge: earlier text first, latest messageId (and other fields) win.\n\t\t\tconst mergedAttachments = [...(existing.event.attachments ?? []), ...(event.attachments ?? [])];\n\t\t\texisting.event = {\n\t\t\t\t...event,\n\t\t\t\ttext: `${existing.event.text}\\n${event.text}`,\n\t\t\t\t...(mergedAttachments.length > 0 ? { attachments: mergedAttachments } : {}),\n\t\t\t};\n\t\t\texisting.timer = this.scheduler.setTimeout(() => this.flushPending(key), this.debounceMs);\n\t\t} else {\n\t\t\tconst timer = this.scheduler.setTimeout(() => this.flushPending(key), this.debounceMs);\n\t\t\tthis.pending.set(key, { event, timer });\n\t\t}\n\t}\n\n\tprivate flushPending(key: string): void {\n\t\tconst entry = this.pending.get(key);\n\t\tif (!entry) return;\n\t\tthis.scheduler.clearTimeout(entry.timer);\n\t\tthis.pending.delete(key);\n\t\tthis.handler?.(entry.event);\n\t}\n\n\tprivate cancelPending(key: string): void {\n\t\tconst entry = this.pending.get(key);\n\t\tif (!entry) return;\n\t\tthis.scheduler.clearTimeout(entry.timer);\n\t\tthis.pending.delete(key);\n\t}\n\n\t// -----------------------------------------------------------------------\n\t// Outbound\n\t// -----------------------------------------------------------------------\n\n\tprivate async fetchChannel(id: string): Promise<DiscordChannelLike | null> {\n\t\tif (this.channelCache.has(id)) return this.channelCache.get(id) ?? null;\n\t\tif (!this.client) return null;\n\t\ttry {\n\t\t\tconst channel = await this.client.channels.fetch(id);\n\t\t\tthis.channelCache.set(id, channel);\n\t\t\tif (this.channelCache.size > CHANNEL_CACHE_CAP) {\n\t\t\t\tconst oldest = this.channelCache.keys().next().value;\n\t\t\t\tif (oldest !== undefined) this.channelCache.delete(oldest);\n\t\t\t}\n\t\t\treturn channel;\n\t\t} catch {\n\t\t\tthis.channelCache.set(id, null);\n\t\t\tif (this.channelCache.size > CHANNEL_CACHE_CAP) {\n\t\t\t\tconst oldest = this.channelCache.keys().next().value;\n\t\t\t\tif (oldest !== undefined) this.channelCache.delete(oldest);\n\t\t\t}\n\t\t\treturn null;\n\t\t}\n\t}\n\n\tprivate recordSent(messageId: string, channel: DiscordChannelLike): void {\n\t\tif (THREAD_TYPES.includes(channel.type)) this.participatingThreads.add(channel.id);\n\t\tif (this.participatingThreads.size > PARTICIPATING_THREAD_CAP) {\n\t\t\tconst oldest = this.participatingThreads.values().next().value;\n\t\t\tif (oldest !== undefined) this.participatingThreads.delete(oldest);\n\t\t}\n\t\tthis.sentMessageChannels.set(messageId, channel.id);\n\t\tif (this.sentMessageChannels.size > SENT_CHANNEL_CAP) {\n\t\t\tconst oldest = this.sentMessageChannels.keys().next().value;\n\t\t\tif (oldest !== undefined) this.sentMessageChannels.delete(oldest);\n\t\t}\n\t}\n\n\tprivate async trySend(\n\t\tchannel: DiscordChannelLike,\n\t\tpayload: { content: string; reply?: { messageReference: string }; components?: unknown[] },\n\t): Promise<SendResult> {\n\t\tif (typeof channel.send !== \"function\") {\n\t\t\treturn { success: false, error: `channel ${channel.id} is not sendable` };\n\t\t}\n\t\ttry {\n\t\t\tconst sent = await channel.send(payload);\n\t\t\tthis.recordSent(sent.id, channel);\n\t\t\treturn { success: true, messageId: sent.id };\n\t\t} catch (err) {\n\t\t\t// 429s are queued internally by discord.js and don't surface here.\n\t\t\treturn { success: false, error: errMessage(err), retryable: discordErrorCode(err) !== ERR_INVALID_FORM_BODY };\n\t\t}\n\t}\n\n\tasync send(chatId: string, text: string, opts?: SendOptions): Promise<SendResult> {\n\t\t// A completed send ends the typing bubble — stop the refresher (see sendTyping).\n\t\tthis.stopTyping(typingKey(chatId, opts?.threadId));\n\t\tconst channel = await this.fetchChannel(opts?.threadId ?? chatId);\n\t\tif (!channel) return { success: false, error: `channel ${opts?.threadId ?? chatId} not found` };\n\t\tconst result = await this.trySend(channel, {\n\t\t\tcontent: text,\n\t\t\treply: opts?.replyTo !== undefined ? { messageReference: opts.replyTo } : undefined,\n\t\t});\n\t\tif (!result.success && opts?.replyTo !== undefined) {\n\t\t\t// The reply target may be deleted/unknown — fall back to a plain send.\n\t\t\treturn this.trySend(channel, { content: text });\n\t\t}\n\t\treturn result;\n\t}\n\n\tasync sendButtons(chatId: string, text: string, buttons: ButtonSpec[][], opts?: SendOptions): Promise<SendResult> {\n\t\tthis.stopTyping(typingKey(chatId, opts?.threadId));\n\t\tconst channel = await this.fetchChannel(opts?.threadId ?? chatId);\n\t\tif (!channel) return { success: false, error: `channel ${opts?.threadId ?? chatId} not found` };\n\t\tconst result = await this.trySend(channel, {\n\t\t\tcontent: text,\n\t\t\treply: opts?.replyTo !== undefined ? { messageReference: opts.replyTo } : undefined,\n\t\t\tcomponents: buildDiscordComponents(buttons),\n\t\t});\n\t\tif (!result.success && opts?.replyTo !== undefined) {\n\t\t\treturn this.trySend(channel, { content: text, components: buildDiscordComponents(buttons) });\n\t\t}\n\t\treturn result;\n\t}\n\n\tasync answerCallback(id: string, text?: string): Promise<void> {\n\t\tconst interaction = this.callbackInteractions.get(id);\n\t\tif (!interaction) return;\n\t\tthis.callbackInteractions.delete(id);\n\t\ttry {\n\t\t\tif (text !== undefined && interaction.reply) {\n\t\t\t\tawait interaction.reply({ content: text, ephemeral: true });\n\t\t\t} else {\n\t\t\t\tawait interaction.deferUpdate();\n\t\t\t}\n\t\t} catch {\n\t\t\t// best-effort acknowledgment\n\t\t}\n\t}\n\n\tasync editMessage(chatId: string, messageId: string, text: string, buttons?: ButtonSpec[][]): Promise<SendResult> {\n\t\t// The router passes only chatId; thread messages live in their own\n\t\t// channel, so prefer the channel recorded at send() time.\n\t\tconst channel = await this.fetchChannel(this.sentMessageChannels.get(messageId) ?? chatId);\n\t\tif (!channel?.messages) {\n\t\t\treturn { success: false, error: `channel ${this.sentMessageChannels.get(messageId) ?? chatId} not found` };\n\t\t}\n\t\ttry {\n\t\t\tconst message = await channel.messages.fetch(messageId);\n\t\t\tif (!message || typeof message.edit !== \"function\") {\n\t\t\t\treturn { success: false, error: `message ${messageId} not found` };\n\t\t\t}\n\t\t\tconst editOptions: { content: string; components?: unknown[] } = { content: text };\n\t\t\tif (buttons !== undefined) editOptions.components = buildDiscordComponents(buttons);\n\t\t\tawait message.edit(editOptions);\n\t\t\treturn { success: true, messageId };\n\t\t} catch (err) {\n\t\t\tconst code = discordErrorCode(err);\n\t\t\tif (code === ERR_UNKNOWN_MESSAGE) return { success: false, error: errMessage(err) }; // terminal\n\t\t\treturn { success: false, error: errMessage(err), retryable: true };\n\t\t}\n\t}\n\n\tasync sendTyping(chatId: string, threadId?: string): Promise<void> {\n\t\t// Self-contained typing refresher (see file header): re-send the action\n\t\t// every 8s until send() completes for this target or the 2min safety net\n\t\t// fires — all errors swallowed.\n\t\tconst key = typingKey(chatId, threadId);\n\t\tconst targetId = threadId ?? chatId;\n\t\tawait this.doTyping(targetId);\n\t\tconst existing = this.typing.get(key);\n\t\tif (existing) {\n\t\t\texisting.lastRefresh = this.now();\n\t\t\treturn;\n\t\t}\n\t\tconst interval = this.scheduler.setInterval(() => {\n\t\t\tconst entry = this.typing.get(key);\n\t\t\tif (!entry) return;\n\t\t\tif (this.now() - entry.lastRefresh > TYPING_SAFETY_MS) {\n\t\t\t\tthis.stopTyping(key);\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tvoid this.doTyping(targetId);\n\t\t}, TYPING_INTERVAL_MS);\n\t\tthis.typing.set(key, { interval, lastRefresh: this.now() });\n\t}\n\n\tprivate async doTyping(channelId: string): Promise<void> {\n\t\ttry {\n\t\t\tconst channel = await this.fetchChannel(channelId);\n\t\t\tawait channel?.sendTyping?.();\n\t\t} catch {\n\t\t\t// typing is cosmetic — never surface\n\t\t}\n\t}\n\n\tprivate stopTyping(key: string): void {\n\t\tconst entry = this.typing.get(key);\n\t\tif (!entry) return;\n\t\tthis.scheduler.clearInterval(entry.interval);\n\t\tthis.typing.delete(key);\n\t}\n}\n"]}