opencode-telegram-bridge 1.0.0

package/dist/opencode.js

@@ -0,0 +1,142 @@
+import { createOpencodeClient } from "@opencode-ai/sdk/v2";
+const buildBasicAuthHeader = (username, password) => {
+    const encoded = Buffer.from(`${username}:${password}`).toString("base64");
+    return `Basic ${encoded}`;
+};
+const extractText = (parts) => {
+    const textParts = parts
+        .filter((part) => part.type === "text")
+        .map((part) => part.text)
+        .filter((text) => text.trim().length > 0);
+    return textParts.join("\n").trim();
+};
+const requireData = (result, label) => {
+    if (result.data == null) {
+        throw new Error(`OpenCode ${label} failed`);
+    }
+    return result.data;
+};
+const buildSessionKey = (chatId, projectDir) => `${chatId}\u0000${projectDir}`;
+export const createSessionStore = () => {
+    const sessions = new Map();
+    const owners = new Map();
+    return {
+        getSessionId: (chatId, projectDir) => sessions.get(buildSessionKey(chatId, projectDir)),
+        setSessionId: (chatId, projectDir, sessionId) => {
+            const sessionKey = buildSessionKey(chatId, projectDir);
+            const existing = sessions.get(sessionKey);
+            if (existing && existing !== sessionId) {
+                owners.delete(existing);
+            }
+            sessions.set(sessionKey, sessionId);
+            owners.set(sessionId, { chatId, projectDir });
+        },
+        clearSession: (chatId, projectDir) => {
+            const sessionKey = buildSessionKey(chatId, projectDir);
+            const existing = sessions.get(sessionKey);
+            if (existing) {
+                owners.delete(existing);
+            }
+            return sessions.delete(sessionKey);
+        },
+        getSessionOwner: (sessionId) => owners.get(sessionId) ?? null,
+    };
+};
+export const createOpencodeBridge = (config, options = {}) => {
+    const headers = {};
+    if (config.serverPassword) {
+        headers.Authorization = buildBasicAuthHeader(config.serverUsername, config.serverPassword);
+    }
+    const client = createOpencodeClient({
+        baseUrl: config.serverUrl,
+        headers,
+    });
+    const sessions = options.sessionStore ?? createSessionStore();
+    const ensureSession = async (chatId, projectDir) => {
+        const existing = sessions.getSessionId(chatId, projectDir);
+        if (existing) {
+            return existing;
+        }
+        const sessionResult = await client.session.create({
+            directory: projectDir,
+            title: `Telegram chat ${chatId}`,
+        });
+        const session = requireData(sessionResult, "session.create");
+        sessions.setSessionId(chatId, projectDir, session.id);
+        return session.id;
+    };
+    return {
+        async promptFromChat(chatId, text, projectDir, options = {}) {
+            const sessionId = await ensureSession(chatId, projectDir);
+            /*
+             * The AbortSignal only cancels the HTTP request. The server may continue
+             * processing, but the client stops waiting and the bot can move on.
+             */
+            const requestOptions = options.signal
+                ? { signal: options.signal }
+                : undefined;
+            const responseResult = await client.session.prompt({
+                sessionID: sessionId,
+                directory: projectDir,
+                parts: [{ type: "text", text }],
+            }, requestOptions);
+            const response = requireData(responseResult, "session.prompt");
+            const reply = extractText(response.parts);
+            if (!reply) {
+                return "OpenCode returned no text output.";
+            }
+            return reply;
+        },
+        resetSession(chatId, projectDir) {
+            return sessions.clearSession(chatId, projectDir);
+        },
+        getSessionOwner(sessionId) {
+            return sessions.getSessionOwner(sessionId);
+        },
+        async replyToPermission(requestId, reply, directory) {
+            const parameters = directory
+                ? { requestID: requestId, reply, directory }
+                : { requestID: requestId, reply };
+            const responseResult = await client.permission.reply(parameters);
+            return requireData(responseResult, "permission.reply");
+        },
+        startPermissionEventStream({ onPermissionAsked, onError }) {
+            const abortController = new AbortController();
+            const run = async () => {
+                while (!abortController.signal.aborted) {
+                    try {
+                        const stream = await client.global.event({
+                            signal: abortController.signal,
+                        });
+                        for await (const event of stream.stream) {
+                            if (abortController.signal.aborted) {
+                                return;
+                            }
+                            const payload = event.payload;
+                            if (payload?.type !== "permission.asked") {
+                                continue;
+                            }
+                            const permissionEvent = payload;
+                            await Promise.resolve(onPermissionAsked({
+                                request: permissionEvent.properties,
+                                directory: event.directory,
+                            }));
+                        }
+                    }
+                    catch (error) {
+                        if (abortController.signal.aborted) {
+                            return;
+                        }
+                        onError?.(error);
+                        await new Promise((resolve) => setTimeout(resolve, 1000));
+                    }
+                }
+            };
+            void run();
+            return {
+                stop: () => abortController.abort(),
+            };
+        },
+    };
+};
+//# sourceMappingURL=opencode.js.map

package/dist/opencode.js.map

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

package/dist/projects.d.ts

@@ -0,0 +1,14 @@
+import { type StoreOptions } from "./storage.js";
+export type ProjectRecord = {
+    alias: string;
+    path: string;
+};
+export type ProjectStore = {
+    listProjects: () => ProjectRecord[];
+    getProject: (alias: string) => ProjectRecord | null;
+    addProject: (alias: string, projectPath: string) => ProjectRecord;
+    removeProject: (alias: string) => void;
+};
+export declare const HOME_PROJECT_ALIAS = "home";
+export declare const createProjectStore: (options?: StoreOptions) => ProjectStore;
+//# sourceMappingURL=projects.d.ts.map

package/dist/projects.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"projects.d.ts","sourceRoot":"","sources":["../src/projects.ts"],"names":[],"mappings":"AAIA,OAAO,EAAkB,KAAK,YAAY,EAAE,MAAM,cAAc,CAAA;AAEhE,MAAM,MAAM,aAAa,GAAG;IAC1B,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,MAAM,CAAA;CACb,CAAA;AAED,MAAM,MAAM,YAAY,GAAG;IACzB,YAAY,EAAE,MAAM,aAAa,EAAE,CAAA;IACnC,UAAU,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,aAAa,GAAG,IAAI,CAAA;IACnD,UAAU,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,KAAK,aAAa,CAAA;IACjE,aAAa,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;CACvC,CAAA;AAED,eAAO,MAAM,kBAAkB,SAAS,CAAA;AAuCxC,eAAO,MAAM,kBAAkB,GAC7B,UAAS,YAAiB,KACzB,YAoDF,CAAA"}

package/dist/projects.js

@@ -0,0 +1,74 @@
+import fs from "node:fs";
+import os from "node:os";
+import path from "node:path";
+import { createDatabase } from "./storage.js";
+export const HOME_PROJECT_ALIAS = "home";
+const normalizeAlias = (alias) => {
+    const trimmed = alias.trim();
+    if (!trimmed) {
+        throw new Error("Project alias is required");
+    }
+    return trimmed;
+};
+const expandHomePath = (rawPath) => {
+    if (rawPath === "~") {
+        return os.homedir();
+    }
+    if (rawPath.startsWith("~/")) {
+        return path.join(os.homedir(), rawPath.slice(2));
+    }
+    return rawPath;
+};
+const resolveProjectPath = (rawPath) => {
+    const trimmed = rawPath.trim();
+    if (!trimmed) {
+        throw new Error("Project path is required");
+    }
+    const expanded = expandHomePath(trimmed);
+    const resolved = path.resolve(expanded);
+    const stats = fs.statSync(resolved);
+    if (!stats.isDirectory()) {
+        throw new Error("Project path must be a directory");
+    }
+    return resolved;
+};
+export const createProjectStore = (options = {}) => {
+    const db = createDatabase(options);
+    db.exec("CREATE TABLE IF NOT EXISTS projects (alias TEXT PRIMARY KEY, path TEXT NOT NULL)");
+    const homePath = os.homedir();
+    db.prepare("INSERT INTO projects (alias, path) VALUES (?, ?) ON CONFLICT(alias) DO UPDATE SET path = excluded.path").run(HOME_PROJECT_ALIAS, homePath);
+    return {
+        listProjects: () => db
+            .prepare("SELECT alias, path FROM projects ORDER BY CASE WHEN alias = ? THEN 0 ELSE 1 END, alias")
+            .all(HOME_PROJECT_ALIAS),
+        getProject: (alias) => {
+            const normalized = normalizeAlias(alias);
+            const row = db
+                .prepare("SELECT alias, path FROM projects WHERE alias = ?")
+                .get(normalized);
+            return row ?? null;
+        },
+        addProject: (alias, projectPath) => {
+            const normalized = normalizeAlias(alias);
+            if (normalized === HOME_PROJECT_ALIAS) {
+                throw new Error("Cannot add project using reserved alias 'home'");
+            }
+            const resolved = resolveProjectPath(projectPath);
+            db.prepare("INSERT INTO projects (alias, path) VALUES (?, ?)").run(normalized, resolved);
+            return { alias: normalized, path: resolved };
+        },
+        removeProject: (alias) => {
+            const normalized = normalizeAlias(alias);
+            if (normalized === HOME_PROJECT_ALIAS) {
+                throw new Error("Cannot remove the home project");
+            }
+            const result = db
+                .prepare("DELETE FROM projects WHERE alias = ?")
+                .run(normalized);
+            if (result.changes === 0) {
+                throw new Error(`Project alias '${normalized}' not found`);
+            }
+        },
+    };
+};
+//# sourceMappingURL=projects.js.map

package/dist/projects.js.map

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

package/dist/prompt-guard.d.ts

@@ -0,0 +1,7 @@
+export type PromptGuard = {
+    tryStart: (chatId: number, onTimeout: () => void) => AbortController | null;
+    finish: (chatId: number) => void;
+    isInFlight: (chatId: number) => boolean;
+};
+export declare const createPromptGuard: (timeoutMs: number) => PromptGuard;
+//# sourceMappingURL=prompt-guard.d.ts.map

package/dist/prompt-guard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-guard.d.ts","sourceRoot":"","sources":["../src/prompt-guard.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,WAAW,GAAG;IACxB,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,IAAI,KAAK,eAAe,GAAG,IAAI,CAAA;IAC3E,MAAM,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAA;IAChC,UAAU,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAA;CACxC,CAAA;AAED,eAAO,MAAM,iBAAiB,GAAI,WAAW,MAAM,KAAG,WAuDrD,CAAA"}

package/dist/prompt-guard.js

@@ -0,0 +1,47 @@
+export const createPromptGuard = (timeoutMs) => {
+    const inFlight = new Map();
+    const tryStart = (chatId, onTimeout) => {
+        /*
+         * This function is synchronous. It schedules a timeout and returns
+         * immediately with an AbortController. The timeout callback will run
+         * later on the event loop if it is not cleared first.
+         */
+        if (inFlight.has(chatId)) {
+            return null;
+        }
+        const abortController = new AbortController();
+        const timeoutId = setTimeout(() => {
+            /*
+             * Only fire the timeout if this prompt is still the active one for
+             * the chat. If it already finished or was replaced, do nothing.
+             */
+            const entry = inFlight.get(chatId);
+            if (!entry || entry.abortController !== abortController) {
+                return;
+            }
+            inFlight.delete(chatId);
+            abortController.abort();
+            onTimeout();
+        }, timeoutMs);
+        inFlight.set(chatId, { abortController, timeoutId });
+        return abortController;
+    };
+    const finish = (chatId) => {
+        /*
+         * Clearing the timeout cancels the scheduled callback so it never runs.
+         * This prevents late timeout handling after a prompt already finished.
+         */
+        const entry = inFlight.get(chatId);
+        if (!entry) {
+            return;
+        }
+        clearTimeout(entry.timeoutId);
+        inFlight.delete(chatId);
+    };
+    return {
+        tryStart,
+        finish,
+        isInFlight: (chatId) => inFlight.has(chatId),
+    };
+};
+//# sourceMappingURL=prompt-guard.js.map

package/dist/prompt-guard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-guard.js","sourceRoot":"","sources":["../src/prompt-guard.ts"],"names":[],"mappings":"AAMA,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,SAAiB,EAAe,EAAE;IAClE,MAAM,QAAQ,GAAG,IAAI,GAAG,EAGrB,CAAA;IAEH,MAAM,QAAQ,GAAG,CAAC,MAAc,EAAE,SAAqB,EAAE,EAAE;QACzD;;;;WAIG;QACH,IAAI,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;YACzB,OAAO,IAAI,CAAA;QACb,CAAC;QAED,MAAM,eAAe,GAAG,IAAI,eAAe,EAAE,CAAA;QAC7C,MAAM,SAAS,GAAG,UAAU,CAAC,GAAG,EAAE;YAChC;;;eAGG;YACH,MAAM,KAAK,GAAG,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,CAAA;YAClC,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,eAAe,KAAK,eAAe,EAAE,CAAC;gBACxD,OAAM;YACR,CAAC;YAED,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC,CAAA;YACvB,eAAe,CAAC,KAAK,EAAE,CAAA;YACvB,SAAS,EAAE,CAAA;QACb,CAAC,EAAE,SAAS,CAAC,CAAA;QAEb,QAAQ,CAAC,GAAG,CAAC,MAAM,EAAE,EAAE,eAAe,EAAE,SAAS,EAAE,CAAC,CAAA;QACpD,OAAO,eAAe,CAAA;IACxB,CAAC,CAAA;IAED,MAAM,MAAM,GAAG,CAAC,MAAc,EAAE,EAAE;QAChC;;;WAGG;QACH,MAAM,KAAK,GAAG,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,CAAA;QAClC,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,OAAM;QACR,CAAC;QAED,YAAY,CAAC,KAAK,CAAC,SAAS,CAAC,CAAA;QAC7B,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC,CAAA;IACzB,CAAC,CAAA;IAED,OAAO;QACL,QAAQ;QACR,MAAM;QACN,UAAU,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC;KAC7C,CAAA;AACH,CAAC,CAAA"}

package/dist/state.d.ts

@@ -0,0 +1,10 @@
+import { type StoreOptions } from "./storage.js";
+import type { SessionStore } from "./opencode.js";
+export type ChatProjectStore = {
+    getActiveAlias: (chatId: number) => string | null;
+    setActiveAlias: (chatId: number, alias: string) => void;
+    clearActiveAlias: (chatId: number) => boolean;
+};
+export declare const createChatProjectStore: (options?: StoreOptions) => ChatProjectStore;
+export declare const createPersistentSessionStore: (options?: StoreOptions) => SessionStore;
+//# sourceMappingURL=state.d.ts.map

package/dist/state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../src/state.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkB,KAAK,YAAY,EAAE,MAAM,cAAc,CAAA;AAChE,OAAO,KAAK,EAAgB,YAAY,EAAE,MAAM,eAAe,CAAA;AAE/D,MAAM,MAAM,gBAAgB,GAAG;IAC7B,cAAc,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,MAAM,GAAG,IAAI,CAAA;IACjD,cAAc,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;IACvD,gBAAgB,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAA;CAC9C,CAAA;AAED,eAAO,MAAM,sBAAsB,GACjC,UAAS,YAAiB,KACzB,gBAyBF,CAAA;AAED,eAAO,MAAM,4BAA4B,GACvC,UAAS,YAAiB,KACzB,YA6CF,CAAA"}

package/dist/state.js

@@ -0,0 +1,56 @@
+import { createDatabase } from "./storage.js";
+export const createChatProjectStore = (options = {}) => {
+    const db = createDatabase(options);
+    db.exec("CREATE TABLE IF NOT EXISTS chat_projects (chat_id INTEGER PRIMARY KEY, alias TEXT NOT NULL)");
+    return {
+        getActiveAlias: (chatId) => {
+            const row = db
+                .prepare("SELECT alias FROM chat_projects WHERE chat_id = ?")
+                .get(chatId);
+            return row?.alias ?? null;
+        },
+        setActiveAlias: (chatId, alias) => {
+            db.prepare("INSERT INTO chat_projects (chat_id, alias) VALUES (?, ?) ON CONFLICT(chat_id) DO UPDATE SET alias = excluded.alias").run(chatId, alias);
+        },
+        clearActiveAlias: (chatId) => {
+            const result = db
+                .prepare("DELETE FROM chat_projects WHERE chat_id = ?")
+                .run(chatId);
+            return result.changes > 0;
+        },
+    };
+};
+export const createPersistentSessionStore = (options = {}) => {
+    const db = createDatabase(options);
+    db.exec("CREATE TABLE IF NOT EXISTS chat_sessions (chat_id INTEGER NOT NULL, project_dir TEXT NOT NULL, session_id TEXT NOT NULL, PRIMARY KEY (chat_id, project_dir))");
+    return {
+        getSessionId: (chatId, projectDir) => {
+            const row = db
+                .prepare("SELECT session_id FROM chat_sessions WHERE chat_id = ? AND project_dir = ?")
+                .get(chatId, projectDir);
+            return row?.session_id;
+        },
+        setSessionId: (chatId, projectDir, sessionId) => {
+            db.prepare("INSERT INTO chat_sessions (chat_id, project_dir, session_id) VALUES (?, ?, ?) ON CONFLICT(chat_id, project_dir) DO UPDATE SET session_id = excluded.session_id").run(chatId, projectDir, sessionId);
+        },
+        clearSession: (chatId, projectDir) => {
+            const result = db
+                .prepare("DELETE FROM chat_sessions WHERE chat_id = ? AND project_dir = ?")
+                .run(chatId, projectDir);
+            return result.changes > 0;
+        },
+        getSessionOwner: (sessionId) => {
+            const row = db
+                .prepare("SELECT chat_id, project_dir FROM chat_sessions WHERE session_id = ? LIMIT 1")
+                .get(sessionId);
+            if (!row) {
+                return null;
+            }
+            return {
+                chatId: row.chat_id,
+                projectDir: row.project_dir,
+            };
+        },
+    };
+};
+//# sourceMappingURL=state.js.map

package/dist/state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.js","sourceRoot":"","sources":["../src/state.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAqB,MAAM,cAAc,CAAA;AAShE,MAAM,CAAC,MAAM,sBAAsB,GAAG,CACpC,UAAwB,EAAE,EACR,EAAE;IACpB,MAAM,EAAE,GAAG,cAAc,CAAC,OAAO,CAAC,CAAA;IAClC,EAAE,CAAC,IAAI,CACL,6FAA6F,CAC9F,CAAA;IAED,OAAO;QACL,cAAc,EAAE,CAAC,MAAM,EAAE,EAAE;YACzB,MAAM,GAAG,GAAG,EAAE;iBACX,OAAO,CAAC,mDAAmD,CAAC;iBAC5D,GAAG,CAAC,MAAM,CAAkC,CAAA;YAC/C,OAAO,GAAG,EAAE,KAAK,IAAI,IAAI,CAAA;QAC3B,CAAC;QACD,cAAc,EAAE,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE;YAChC,EAAE,CAAC,OAAO,CACR,oHAAoH,CACrH,CAAC,GAAG,CAAC,MAAM,EAAE,KAAK,CAAC,CAAA;QACtB,CAAC;QACD,gBAAgB,EAAE,CAAC,MAAM,EAAE,EAAE;YAC3B,MAAM,MAAM,GAAG,EAAE;iBACd,OAAO,CAAC,6CAA6C,CAAC;iBACtD,GAAG,CAAC,MAAM,CAAC,CAAA;YACd,OAAO,MAAM,CAAC,OAAO,GAAG,CAAC,CAAA;QAC3B,CAAC;KACF,CAAA;AACH,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,4BAA4B,GAAG,CAC1C,UAAwB,EAAE,EACZ,EAAE;IAChB,MAAM,EAAE,GAAG,cAAc,CAAC,OAAO,CAAC,CAAA;IAClC,EAAE,CAAC,IAAI,CACL,8JAA8J,CAC/J,CAAA;IAED,OAAO;QACL,YAAY,EAAE,CAAC,MAAM,EAAE,UAAU,EAAE,EAAE;YACnC,MAAM,GAAG,GAAG,EAAE;iBACX,OAAO,CACN,4EAA4E,CAC7E;iBACA,GAAG,CAAC,MAAM,EAAE,UAAU,CAAuC,CAAA;YAChE,OAAO,GAAG,EAAE,UAAU,CAAA;QACxB,CAAC;QACD,YAAY,EAAE,CAAC,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,EAAE;YAC9C,EAAE,CAAC,OAAO,CACR,gKAAgK,CACjK,CAAC,GAAG,CAAC,MAAM,EAAE,UAAU,EAAE,SAAS,CAAC,CAAA;QACtC,CAAC;QACD,YAAY,EAAE,CAAC,MAAM,EAAE,UAAU,EAAE,EAAE;YACnC,MAAM,MAAM,GAAG,EAAE;iBACd,OAAO,CACN,iEAAiE,CAClE;iBACA,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,CAAA;YAC1B,OAAO,MAAM,CAAC,OAAO,GAAG,CAAC,CAAA;QAC3B,CAAC;QACD,eAAe,EAAE,CAAC,SAAS,EAAE,EAAE;YAC7B,MAAM,GAAG,GAAG,EAAE;iBACX,OAAO,CACN,6EAA6E,CAC9E;iBACA,GAAG,CAAC,SAAS,CAAyD,CAAA;YAEzE,IAAI,CAAC,GAAG,EAAE,CAAC;gBACT,OAAO,IAAI,CAAA;YACb,CAAC;YAED,OAAO;gBACL,MAAM,EAAE,GAAG,CAAC,OAAO;gBACnB,UAAU,EAAE,GAAG,CAAC,WAAW;aACL,CAAA;QAC1B,CAAC;KACF,CAAA;AACH,CAAC,CAAA"}

package/dist/storage.d.ts

@@ -0,0 +1,8 @@
+import Database from "better-sqlite3";
+export type StoreOptions = {
+    dbPath?: string;
+};
+type DatabaseInstance = ReturnType<typeof Database>;
+export declare const createDatabase: (options?: StoreOptions) => DatabaseInstance;
+export {};
+//# sourceMappingURL=storage.d.ts.map

package/dist/storage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../src/storage.ts"],"names":[],"mappings":"AAIA,OAAO,QAAQ,MAAM,gBAAgB,CAAA;AAErC,MAAM,MAAM,YAAY,GAAG;IACzB,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB,CAAA;AAaD,KAAK,gBAAgB,GAAG,UAAU,CAAC,OAAO,QAAQ,CAAC,CAAA;AAEnD,eAAO,MAAM,cAAc,GAAI,UAAS,YAAiB,KAAG,gBAI3D,CAAA"}

package/dist/storage.js

@@ -0,0 +1,16 @@
+import fs from "node:fs";
+import os from "node:os";
+import path from "node:path";
+import Database from "better-sqlite3";
+const ensureDatabaseDirectory = (dbPath) => {
+    const directory = path.dirname(dbPath);
+    fs.mkdirSync(directory, { recursive: true });
+};
+const getDefaultDatabasePath = () => path.join(os.homedir(), ".opencode-telegram-bridge", "projects.db");
+const resolveDatabasePath = (options = {}) => options.dbPath ?? getDefaultDatabasePath();
+export const createDatabase = (options = {}) => {
+    const dbPath = resolveDatabasePath(options);
+    ensureDatabaseDirectory(dbPath);
+    return new Database(dbPath);
+};
+//# sourceMappingURL=storage.js.map

package/dist/storage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.js","sourceRoot":"","sources":["../src/storage.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAA;AACxB,OAAO,EAAE,MAAM,SAAS,CAAA;AACxB,OAAO,IAAI,MAAM,WAAW,CAAA;AAE5B,OAAO,QAAQ,MAAM,gBAAgB,CAAA;AAMrC,MAAM,uBAAuB,GAAG,CAAC,MAAc,EAAE,EAAE;IACjD,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAA;IACtC,EAAE,CAAC,SAAS,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;AAC9C,CAAC,CAAA;AAED,MAAM,sBAAsB,GAAG,GAAG,EAAE,CAClC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,2BAA2B,EAAE,aAAa,CAAC,CAAA;AAErE,MAAM,mBAAmB,GAAG,CAAC,UAAwB,EAAE,EAAE,EAAE,CACzD,OAAO,CAAC,MAAM,IAAI,sBAAsB,EAAE,CAAA;AAI5C,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,UAAwB,EAAE,EAAoB,EAAE;IAC7E,MAAM,MAAM,GAAG,mBAAmB,CAAC,OAAO,CAAC,CAAA;IAC3C,uBAAuB,CAAC,MAAM,CAAC,CAAA;IAC/B,OAAO,IAAI,QAAQ,CAAC,MAAM,CAAC,CAAA;AAC7B,CAAC,CAAA"}

package/dist/telegram.d.ts

@@ -0,0 +1,3 @@
+export declare const TELEGRAM_MESSAGE_LIMIT = 4096;
+export declare const splitTelegramMessage: (text: string, limit?: number) => string[];
+//# sourceMappingURL=telegram.d.ts.map

package/dist/telegram.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"telegram.d.ts","sourceRoot":"","sources":["../src/telegram.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,sBAAsB,OAAO,CAAA;AAE1C,eAAO,MAAM,oBAAoB,GAC/B,MAAM,MAAM,EACZ,cAA8B,KAC7B,MAAM,EAWR,CAAA"}

package/dist/telegram.js

@@ -0,0 +1,12 @@
+export const TELEGRAM_MESSAGE_LIMIT = 4096;
+export const splitTelegramMessage = (text, limit = TELEGRAM_MESSAGE_LIMIT) => {
+    if (text.length <= limit) {
+        return [text];
+    }
+    const chunks = [];
+    for (let offset = 0; offset < text.length; offset += limit) {
+        chunks.push(text.slice(offset, offset + limit));
+    }
+    return chunks;
+};
+//# sourceMappingURL=telegram.js.map

package/dist/telegram.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"telegram.js","sourceRoot":"","sources":["../src/telegram.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,sBAAsB,GAAG,IAAI,CAAA;AAE1C,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAClC,IAAY,EACZ,KAAK,GAAG,sBAAsB,EACpB,EAAE;IACZ,IAAI,IAAI,CAAC,MAAM,IAAI,KAAK,EAAE,CAAC;QACzB,OAAO,CAAC,IAAI,CAAC,CAAA;IACf,CAAC;IAED,MAAM,MAAM,GAAa,EAAE,CAAA;IAC3B,KAAK,IAAI,MAAM,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC,MAAM,EAAE,MAAM,IAAI,KAAK,EAAE,CAAC;QAC3D,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,KAAK,CAAC,CAAC,CAAA;IACjD,CAAC;IAED,OAAO,MAAM,CAAA;AACf,CAAC,CAAA"}

package/docs/configuration.md

@@ -0,0 +1,17 @@
+# Configuration
+
+Set these environment variables in `.env` or in your service environment.
+
+## Required
+- `TELEGRAM_BOT_TOKEN` - Telegram bot token.
+- `TELEGRAM_ALLOWED_USER_ID` - Telegram user ID allowed to use the bot.
+- `OPENCODE_SERVER_URL` - OpenCode server URL (default server is `http://127.0.0.1:4096`).
+
+## Optional
+- `OPENCODE_SERVER_USERNAME` - Basic auth username (default: `opencode`).
+- `OPENCODE_SERVER_PASSWORD` - Basic auth password.
+- `OPENCODE_PROMPT_TIMEOUT_MS` - Prompt timeout in milliseconds (default: 600000).
+- `TELEGRAM_HANDLER_TIMEOUT_MS` - Telegraf handler timeout in milliseconds (default: prompt timeout + 30000).
+
+## Data storage
+- Project aliases and chat selections are stored in `~/.opencode-telegram-bridge/projects.db`.

package/docs/index.md

@@ -0,0 +1,8 @@
+# OpenCode Telegram Bridge Docs
+
+Start here:
+- `installation.md`
+- `configuration.md`
+- `usage.md`
+- `systemd.md`
+- `release.md`

package/docs/installation.md

@@ -0,0 +1,42 @@
+# Installation
+
+## Prerequisites
+- Node.js 18+
+- OpenCode CLI installed and available on PATH (see https://opencode.ai/docs/cli/)
+
+## Install dependencies
+```bash
+npm install
+```
+
+## Start OpenCode server
+```bash
+opencode serve
+```
+
+## Configure environment
+Copy the example file and fill in values:
+```bash
+cp .env.example .env
+```
+
+## Run the bot
+```bash
+npm run dev
+```
+
+For production, build and run:
+```bash
+npm run build
+npm start
+```
+
+## Install via npm
+```bash
+npm install -g opencode-telegram-bridge
+```
+
+Run:
+```bash
+opencode-telegram-bridge
+```

package/docs/release.md

@@ -0,0 +1,56 @@
+# Release
+
+This project is published as an npm package.
+
+## Changesets workflow
+1. Add a changeset for your change:
+
+```bash
+npx changeset
+```
+
+2. Version the release:
+
+```bash
+npm run version
+```
+
+3. Publish:
+
+```bash
+npm run release
+```
+
+The `prepublishOnly` script runs the build to ensure `dist/` is included.
+
+## CI enforcement
+CI fails if a relevant code change lands without a `.changeset/*.md` file.
+Docs-only updates (`docs/`, `README.md`, `.github/`) do not require a changeset.
+
+## FAQ
+
+### How is the version bump decided?
+You pick it when you run `npx changeset`. The changeset file records whether the
+change is a `patch`, `minor`, or `major`. When you run `npm run version`, all
+pending changesets are read and the highest required bump wins.
+
+### How is the changelog generated?
+The changelog is generated from the text in the changeset files, not from
+commits. Each changeset contributes a short release note entry.
+
+### Do commits or pushes equal a version?
+No. A version is created only when you run `npm run version` (or when an
+automated release does the same). Multiple commits can be part of one release.
+
+### What happens if I push to main without a changeset?
+CI fails. Add a changeset in a follow-up commit and push again. Do not rewrite
+history on main.
+
+### Do I need one changeset per commit or per push?
+No. You need one changeset per release-worthy change (often one per PR). A
+single changeset can cover multiple commits.
+
+### When are tags created?
+Tags are created when you run the release process (for example, after
+`npm run version` and `npm publish`). If CI fails due to a missing changeset,
+no tag is created yet.

package/docs/systemd.md

@@ -0,0 +1,42 @@
+# systemd Service (Linux)
+
+This project ships a systemd unit template in `systemd/opencode-telegram-bridge.service`.
+
+## Install
+1. Build the project:
+
+```bash
+npm install
+npm run build
+```
+
+2. Copy the service and env files:
+
+```bash
+sudo mkdir -p /etc/opencode-telegram-bridge
+sudo cp systemd/opencode-telegram-bridge.service /etc/systemd/system/opencode-telegram-bridge.service
+sudo cp systemd/opencode-telegram-bridge.env.example /etc/opencode-telegram-bridge.env
+```
+
+3. Edit the env file:
+
+```bash
+sudo nano /etc/opencode-telegram-bridge.env
+```
+
+4. Update the service paths if needed:
+
+- `ExecStart=/usr/bin/opencode-telegram-bridge`
+- If you installed via npm in a non-standard location, set `ExecStart` to the output of `command -v opencode-telegram-bridge`.
+
+5. Enable and start:
+
+```bash
+sudo systemctl daemon-reload
+sudo systemctl enable --now opencode-telegram-bridge
+```
+
+## Logs
+```bash
+sudo journalctl -u opencode-telegram-bridge -f
+```

package/docs/usage.md

@@ -0,0 +1,20 @@
+# Usage
+
+## Bot commands
+- `/start` - confirm the bot is online.
+- `/project list` - list project aliases (active project marked with `*`).
+- `/project current` - show the active project alias and path.
+- `/project add <alias> <path>` - add a project alias.
+- `/project remove <alias>` - remove a project alias.
+- `/project set <alias>` - set the active project alias for this chat.
+- `/reset` - reset the OpenCode session for the active project.
+
+## Notes
+- Only one prompt is processed at a time per chat.
+- Permission requests show inline buttons in Telegram.
+
+## CLI
+If installed via npm, start the bot with:
+```bash
+opencode-telegram-bridge
+```