opencode-plugin-teleprompt 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Berkecan Ozgur
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,180 @@
+# opencode-plugin-teleprompt
+
+TUI-scoped OpenCode plugin that binds a Telegram channel to one active OpenCode session.
+
+## What It Does
+
+- Polls a strict Telegram channel for `/tp` commands
+- Injects `/tp <prompt>` into the currently bound OpenCode session
+- Sends summary-only response messages back to the same channel
+- Relays OpenCode permission prompts and accepts Telegram `approve`, `approve-always`, `deny`
+- Keeps single-owner bridge semantics across multiple OpenCode consoles
+
+## V1 Limits
+
+- Single strict channel
+- Single active bound session
+- Summary-only output (no full transcript)
+- No auto-bind on startup
+
+## Requirements
+
+- Telegram bot token
+- Bot must be an admin in the target channel
+- Telegram credentials can be provided either:
+  - via env vars (`OPENCODE_TELEGRAM_BOT_TOKEN`, `OPENCODE_TELEGRAM_CHANNEL_ID`)
+  - or at runtime with `/tp:start <bot_token> <channel_id>` or `/tp:credentials <bot_token> <channel_id>`
+
+Optional:
+
+- `OPENCODE_TELEGRAM_POLL_TIMEOUT_SEC` (default: `30`)
+- `OPENCODE_TELEGRAM_HEARTBEAT_MS` (default: `10000`)
+- `OPENCODE_TELEGRAM_LEASE_TTL_MS` (default: `30000`)
+- `OPENCODE_TELEGRAM_SUMMARY_MAX_CHARS` (default: `1200`)
+- `OPENCODE_TELEGRAM_ONLINE_NOTICE` (`true`/`false`, default: `true`)
+- `OPENCODE_TELEGRAM_OFFLINE_NOTICE` (`true`/`false`, default: `true`)
+
+## Install And Build
+
+```bash
+npm install
+npm run build
+```
+
+## Install In OpenCode (npm package)
+
+Add this plugin package name into your OpenCode config:
+
+`opencode.json`
+
+```json
+{
+  "$schema": "https://opencode.ai/config.json",
+  "plugin": ["opencode-plugin-teleprompt"]
+}
+```
+
+OpenCode installs npm plugins automatically at startup.
+
+## Activation And Use
+
+1. Publish this package to npm.
+2. Add package name to `opencode.json` as shown above.
+3. Open a session in OpenCode TUI.
+4. Run `/tp:start` in OpenCode to activate teleprompt for the current session.
+   - If env vars are missing, run `/tp:start <bot_token> <channel_id>` once (or `/tp:credentials <bot_token> <channel_id>` then `/tp:start`).
+   - Runtime credentials are session-only and are cleared on plugin/session shutdown.
+5. While teleprompt is active, local prompt input is locked for that session.
+6. Disconnect options:
+   - Press `Esc` twice in a row in OpenCode
+   - Send `/tp:dc` in Telegram channel
+   - Run `/tp:stop` in OpenCode
+7. Use Telegram channel commands:
+   - `/tp <prompt>`
+   - `/tp:interrupt`
+   - `/tp:queue`
+   - `/tp:cancel <job_id|last>`
+   - `/tp:retry`
+   - `/tp:context`
+   - `/tp:compact`
+   - `/tp:newsession`
+   - `/tp:reset-context`
+   - `/tp:who`
+   - `/tp:health`
+   - `/tp:reclaim`
+   - `/tp:history`
+   - `/tp:last-error`
+   - `/tp:model`
+   - `/tp:model fast`
+   - `/tp:model smart`
+   - `/tp:model max`
+   - `/tp:model <provider>/<model>`
+   - `/tp approve <request_id>`
+   - `/tp approve-always <request_id>`
+   - `/tp deny <request_id>`
+   - `/tp status`
+   - `/tp:dc`
+
+During remote runs, teleprompt posts lifecycle updates (`accepted`, `queued`, `running`, `waiting-permission`, `completed`, `failed`) and result summaries are sent as replies to the originating Telegram message for clear correlation.
+
+## Publish And Install Verification
+
+### npm Publish Preparation
+
+1. Run release validation locally:
+   - `npm run verify:release`
+2. Validate npm auth/account:
+   - `npm whoami`
+3. Publish:
+   - `npm publish`
+
+`prepublishOnly` is enabled and will run release verification automatically before publishing.
+
+### Clean-Machine Install Checklist
+
+1. On a clean machine, create `opencode.json` with:
+   - `"plugin": ["opencode-plugin-teleprompt"]`
+2. Set required env vars:
+   - `OPENCODE_TELEGRAM_BOT_TOKEN`
+   - `OPENCODE_TELEGRAM_CHANNEL_ID`
+3. Start OpenCode and ensure plugin loads without startup errors.
+4. Open one session, run `/tp:start`, verify bridge binds.
+5. Send `/tp status` from Telegram and confirm status response.
+6. Send `/tp test ping` and confirm lifecycle + summary reply.
+7. Send `/tp:dc` and confirm local input is unlocked in OpenCode.
+
+## Telegram Live E2E Quick Checklist
+
+1. Start OpenCode session and run `/tp:start`.
+2. From Telegram channel, run `/tp status` and verify owner/session info.
+3. Run `/tp:model` and switch once with `/tp:model fast` (or explicit provider/model).
+4. Send `/tp write a 1-line summary of this session` and verify:
+   - `accepted` -> `running` -> `completed`
+   - summary arrives as reply to the same Telegram message
+5. Trigger a permissioned action prompt and verify:
+   - plugin posts permission request with `request_id`
+   - `/tp approve <request_id>` (or `/tp deny <request_id>`) is applied immediately
+6. Send `/tp:interrupt` during a long run and confirm graceful stop.
+7. Send `/tp:dc` and confirm disconnect/unlock behavior.
+
+## Command Reference
+
+### OpenCode Local Commands
+
+- `/tp:start`: Bind teleprompt to the current OpenCode session and start Telegram polling.
+- `/tp:start <bot_token> <channel_id>`: Bind with session-only credentials when env vars are not set.
+- `/tp:credentials <bot_token> <channel_id>`: Store session-only credentials for the current runtime.
+- `/tp:stop`: Unbind teleprompt, stop polling, and unlock local session input.
+- `/tp:status`: Show current bridge status in OpenCode (session, owner, model, queue, permissions).
+
+### Telegram Commands
+
+- `/tp <prompt>`: Queue a new prompt for the currently bound session.
+- `/tp:interrupt`: Abort the currently running remote prompt without disconnecting the bridge.
+- `/tp:queue`: Show active prompt and queued prompts.
+- `/tp:cancel <job_id|last>`: Remove a queued prompt by job ID, or remove the newest queued prompt with `last`.
+- `/tp:retry`: Re-queue the most recent prompt from prompt history.
+- `/tp:context`: Show compact session context (recent prompts, summaries, and changed files).
+- `/tp:compact`: Trigger session summarization/compaction for long-running sessions.
+- `/tp:newsession`: Create a new OpenCode session and switch teleprompt binding to it.
+- `/tp:reset-context`: Alias behavior for creating/switching to a fresh session context.
+- `/tp:who`: Show lease ownership details (current instance, lease owner, ownership state).
+- `/tp:health`: Show bridge health (lease age/staleness, poller/event stream status, queue stats).
+- `/tp:reclaim`: Try to reclaim bridge ownership for the current instance.
+- `/tp:history`: Show recent run history with status and short summaries.
+- `/tp:last-error`: Show the latest failed or interrupted run summary.
+- `/tp:model`: List available models by provider and show current model selection.
+- `/tp:model fast`: Select a model using the `fast` preset resolver.
+- `/tp:model smart`: Select a model using the `smart` preset resolver.
+- `/tp:model max`: Select a model using the `max` preset resolver.
+- `/tp:model <provider>/<model>`: Select an explicit provider/model for the bound session.
+- `/tp approve <request_id>`: Approve a pending permission request once.
+- `/tp approve-always <request_id>`: Approve a pending permission request and persist approval behavior when supported.
+- `/tp deny <request_id>`: Reject a pending permission request.
+- `/tp status`: Show bridge status from Telegram.
+- `/tp:dc`: Disconnect teleprompt from Telegram and unbind the current session.
+
+## Shutdown Behavior
+
+- On normal TUI disposal (`Ctrl+C`, clean exit), poller and heartbeat stop and lease is released.
+- On unclean termination, lease expires by TTL and next owner instance can reclaim.

package/dist/config.d.ts

@@ -0,0 +1,2 @@
+import type { BridgeConfig } from "./types.js";
+export declare function loadConfig(): BridgeConfig;

package/dist/config.js

@@ -0,0 +1,40 @@
+function readNumber(name, fallback) {
+    const raw = process.env[name];
+    if (!raw)
+        return fallback;
+    const parsed = Number(raw);
+    if (!Number.isFinite(parsed) || parsed <= 0) {
+        throw new Error(`${name} must be a positive number`);
+    }
+    return parsed;
+}
+function readBoolean(name, fallback) {
+    const raw = process.env[name];
+    if (!raw)
+        return fallback;
+    const normalized = raw.trim().toLowerCase();
+    if (normalized === "true" || normalized === "1" || normalized === "yes") {
+        return true;
+    }
+    if (normalized === "false" || normalized === "0" || normalized === "no") {
+        return false;
+    }
+    throw new Error(`${name} must be one of: true, false, 1, 0, yes, no`);
+}
+export function loadConfig() {
+    const botToken = process.env.OPENCODE_TELEGRAM_BOT_TOKEN?.trim();
+    const channelID = process.env.OPENCODE_TELEGRAM_CHANNEL_ID?.trim();
+    const prefix = "/tp";
+    return {
+        botToken: botToken || "",
+        channelID: channelID || "",
+        prefix,
+        pollTimeoutSec: readNumber("OPENCODE_TELEGRAM_POLL_TIMEOUT_SEC", 30),
+        heartbeatMs: readNumber("OPENCODE_TELEGRAM_HEARTBEAT_MS", 10_000),
+        leaseTtlMs: readNumber("OPENCODE_TELEGRAM_LEASE_TTL_MS", 30_000),
+        summaryMaxChars: readNumber("OPENCODE_TELEGRAM_SUMMARY_MAX_CHARS", 1_200),
+        onlineNotice: readBoolean("OPENCODE_TELEGRAM_ONLINE_NOTICE", true),
+        offlineNotice: readBoolean("OPENCODE_TELEGRAM_OFFLINE_NOTICE", true),
+    };
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAEA,SAAS,UAAU,CAAC,IAAY,EAAE,QAAgB;IAChD,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC9B,IAAI,CAAC,GAAG;QAAE,OAAO,QAAQ,CAAC;IAC1B,MAAM,MAAM,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;IAC3B,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,MAAM,IAAI,CAAC,EAAE,CAAC;QAC5C,MAAM,IAAI,KAAK,CAAC,GAAG,IAAI,4BAA4B,CAAC,CAAC;IACvD,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,WAAW,CAAC,IAAY,EAAE,QAAiB;IAClD,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC9B,IAAI,CAAC,GAAG;QAAE,OAAO,QAAQ,CAAC;IAC1B,MAAM,UAAU,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAC5C,IAAI,UAAU,KAAK,MAAM,IAAI,UAAU,KAAK,GAAG,IAAI,UAAU,KAAK,KAAK,EAAE,CAAC;QACxE,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IAAI,UAAU,KAAK,OAAO,IAAI,UAAU,KAAK,GAAG,IAAI,UAAU,KAAK,IAAI,EAAE,CAAC;QACxE,OAAO,KAAK,CAAC;IACf,CAAC;IACD,MAAM,IAAI,KAAK,CAAC,GAAG,IAAI,6CAA6C,CAAC,CAAC;AACxE,CAAC;AAED,MAAM,UAAU,UAAU;IACxB,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,2BAA2B,EAAE,IAAI,EAAE,CAAC;IACjE,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,4BAA4B,EAAE,IAAI,EAAE,CAAC;IACnE,MAAM,MAAM,GAAG,KAAK,CAAC;IACrB,OAAO;QACL,QAAQ,EAAE,QAAQ,IAAI,EAAE;QACxB,SAAS,EAAE,SAAS,IAAI,EAAE;QAC1B,MAAM;QACN,cAAc,EAAE,UAAU,CAAC,oCAAoC,EAAE,EAAE,CAAC;QACpE,WAAW,EAAE,UAAU,CAAC,gCAAgC,EAAE,MAAM,CAAC;QACjE,UAAU,EAAE,UAAU,CAAC,gCAAgC,EAAE,MAAM,CAAC;QAChE,eAAe,EAAE,UAAU,CAAC,qCAAqC,EAAE,KAAK,CAAC;QACzE,YAAY,EAAE,WAAW,CAAC,iCAAiC,EAAE,IAAI,CAAC;QAClE,aAAa,EAAE,WAAW,CAAC,kCAAkC,EAAE,IAAI,CAAC;KACrE,CAAC;AACJ,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+import { tui } from "./tui.js";
+declare const plugin: {
+    id: string;
+    tui: import("./tui-types.js").TuiPlugin;
+};
+export default plugin;
+export { tui };

package/dist/index.js

@@ -0,0 +1,8 @@
+import { tui } from "./tui.js";
+const plugin = {
+    id: "teleprompt",
+    tui,
+};
+export default plugin;
+export { tui };
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAE/B,MAAM,MAAM,GAAG;IACb,EAAE,EAAE,YAAY;IAChB,GAAG;CACJ,CAAC;AAEF,eAAe,MAAM,CAAC;AACtB,OAAO,EAAE,GAAG,EAAE,CAAC"}

package/dist/opencode/binding.d.ts

@@ -0,0 +1,2 @@
+import type { TuiPluginApi } from "../tui-types.js";
+export declare function getCurrentSessionID(api: TuiPluginApi): string;

package/dist/opencode/binding.js

@@ -0,0 +1,12 @@
+export function getCurrentSessionID(api) {
+    const route = api.route.current;
+    if (route.name !== "session") {
+        throw new Error("Open a session first, then run telegram.bind.");
+    }
+    const sessionID = route.params?.sessionID;
+    if (!sessionID || typeof sessionID !== "string") {
+        throw new Error("Current route does not contain a valid session ID.");
+    }
+    return sessionID;
+}
+//# sourceMappingURL=binding.js.map

package/dist/opencode/binding.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"binding.js","sourceRoot":"","sources":["../../src/opencode/binding.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,mBAAmB,CAAC,GAAiB;IACnD,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC;IAChC,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QAC7B,MAAM,IAAI,KAAK,CAAC,+CAA+C,CAAC,CAAC;IACnE,CAAC;IACD,MAAM,SAAS,GAAG,KAAK,CAAC,MAAM,EAAE,SAAS,CAAC;IAC1C,IAAI,CAAC,SAAS,IAAI,OAAO,SAAS,KAAK,QAAQ,EAAE,CAAC;QAChD,MAAM,IAAI,KAAK,CAAC,oDAAoD,CAAC,CAAC;IACxE,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/opencode/events.d.ts

@@ -0,0 +1,31 @@
+type EventHandlers = {
+    onAssistantCompleted: (sessionID: string, assistantMessageID: string, parentUserMessageID: string) => Promise<void>;
+    onPermissionAsked: (event: {
+        id: string;
+        sessionID: string;
+        permission: string;
+        patterns: string[];
+        metadata: Record<string, unknown>;
+    }) => Promise<void>;
+    onSessionError: (event: {
+        sessionID?: string;
+        error?: {
+            name?: string;
+        };
+    }) => Promise<void>;
+    onUserMessage: (sessionID: string, userMessageID: string) => Promise<void>;
+    onStreamError?: (error: unknown) => Promise<void>;
+};
+export declare class SessionEventStream {
+    private readonly client;
+    private readonly sessionID;
+    private readonly handlers;
+    private abort;
+    private running?;
+    constructor(client: any, sessionID: string, handlers: EventHandlers);
+    start(): void;
+    stop(): Promise<void>;
+    private loop;
+    private handleEvent;
+}
+export {};

package/dist/opencode/events.js

@@ -0,0 +1,74 @@
+export class SessionEventStream {
+    client;
+    sessionID;
+    handlers;
+    abort = new AbortController();
+    running;
+    constructor(client, sessionID, handlers) {
+        this.client = client;
+        this.sessionID = sessionID;
+        this.handlers = handlers;
+    }
+    start() {
+        if (this.running)
+            return;
+        this.running = this.loop().catch(async (error) => {
+            if (this.abort.signal.aborted)
+                return;
+            await this.handlers.onStreamError?.(error);
+        });
+    }
+    async stop() {
+        this.abort.abort();
+        await this.running;
+        this.running = undefined;
+    }
+    async loop() {
+        const streamResult = await this.client.event.subscribe();
+        try {
+            for await (const event of streamResult.stream) {
+                if (this.abort.signal.aborted)
+                    break;
+                if (!event || typeof event !== "object")
+                    continue;
+                await this.handleEvent(event);
+            }
+        }
+        catch {
+            if (!this.abort.signal.aborted) {
+                throw new Error("Event stream terminated unexpectedly.");
+            }
+        }
+    }
+    async handleEvent(event) {
+        if (event.type === "permission.asked") {
+            const data = event.properties;
+            if (data.sessionID !== this.sessionID)
+                return;
+            await this.handlers.onPermissionAsked(data);
+            return;
+        }
+        if (event.type === "session.error") {
+            const data = event.properties;
+            if (data.sessionID && data.sessionID !== this.sessionID)
+                return;
+            await this.handlers.onSessionError(data);
+            return;
+        }
+        if (event.type !== "message.updated")
+            return;
+        const data = event.properties;
+        if (data.sessionID !== this.sessionID)
+            return;
+        if (data.info.role === "assistant") {
+            if (!data.info.time?.completed || !data.info.parentID)
+                return;
+            await this.handlers.onAssistantCompleted(data.sessionID, data.info.id, data.info.parentID);
+            return;
+        }
+        if (data.info.role !== "user")
+            return;
+        await this.handlers.onUserMessage(data.sessionID, data.info.id);
+    }
+}
+//# sourceMappingURL=events.js.map

package/dist/opencode/events.js.map

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

package/dist/opencode/permissions.d.ts

@@ -0,0 +1,4 @@
+import type { PendingPermission, PermissionAskInput } from "../types.js";
+export declare function toPendingPermission(input: PermissionAskInput): PendingPermission;
+export declare function formatPermissionRequestMessage(prefix: string, permission: PendingPermission): string;
+export declare function replyPermission(client: any, requestID: string, action: "once" | "always" | "reject"): Promise<void>;

package/dist/opencode/permissions.js

@@ -0,0 +1,66 @@
+export function toPendingPermission(input) {
+    return {
+        requestID: input.id,
+        sessionID: input.sessionID,
+        permission: input.permission,
+        patterns: input.patterns,
+        metadata: input.metadata,
+        announcedAt: Date.now(),
+    };
+}
+export function formatPermissionRequestMessage(prefix, permission) {
+    const toolType = typeof permission.metadata?.tool === "string"
+        ? permission.metadata.tool
+        : typeof permission.metadata?.toolName === "string"
+            ? permission.metadata.toolName
+            : "unknown";
+    const risk = classifyRisk(permission.permission, permission.metadata);
+    const target = permission.patterns[0] || "(none)";
+    const patterns = permission.patterns.length > 0
+        ? permission.patterns.map((v) => `- ${v}`).join("\n")
+        : "- (none)";
+    return [
+        "OpenCode permission request:",
+        `request_id: ${permission.requestID}`,
+        `session_id: ${permission.sessionID}`,
+        `tool: ${toolType}`,
+        `permission: ${permission.permission}`,
+        `risk: ${risk}`,
+        `target: ${target}`,
+        "patterns:",
+        patterns,
+        "",
+        "Reply examples:",
+        `- Approve once: ${prefix} approve ${permission.requestID}`,
+        `- Approve always: ${prefix} approve-always ${permission.requestID}`,
+        `- Deny: ${prefix} deny ${permission.requestID}`,
+    ].join("\n");
+}
+function classifyRisk(permission, metadata) {
+    const merged = `${permission} ${JSON.stringify(metadata)}`.toLowerCase();
+    if (merged.includes("exec") ||
+        merged.includes("shell") ||
+        merged.includes("command")) {
+        return "exec";
+    }
+    if (merged.includes("network") ||
+        merged.includes("http") ||
+        merged.includes("fetch") ||
+        merged.includes("url")) {
+        return "network";
+    }
+    if (merged.includes("write") ||
+        merged.includes("delete") ||
+        merged.includes("modify") ||
+        merged.includes("create")) {
+        return "write";
+    }
+    return "read";
+}
+export async function replyPermission(client, requestID, action) {
+    await client.permission.reply({
+        requestID,
+        reply: action,
+    });
+}
+//# sourceMappingURL=permissions.js.map

package/dist/opencode/permissions.js.map

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

package/dist/opencode/submit.d.ts

@@ -0,0 +1,7 @@
+export declare function createTelegramUserMessageID(updateID: number): string;
+export declare function submitPrompt(client: any, sessionID: string, prompt: string, updateID: number, model?: {
+    providerID: string;
+    modelID: string;
+}): Promise<{
+    userMessageID: string;
+}>;

package/dist/opencode/submit.js

@@ -0,0 +1,14 @@
+export function createTelegramUserMessageID(updateID) {
+    return `tg-${updateID}`;
+}
+export async function submitPrompt(client, sessionID, prompt, updateID, model) {
+    const userMessageID = createTelegramUserMessageID(updateID);
+    await client.session.promptAsync({
+        sessionID,
+        messageID: userMessageID,
+        ...(model ? { model } : {}),
+        parts: [{ type: "text", text: prompt }],
+    });
+    return { userMessageID };
+}
+//# sourceMappingURL=submit.js.map

package/dist/opencode/submit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"submit.js","sourceRoot":"","sources":["../../src/opencode/submit.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,2BAA2B,CAAC,QAAgB;IAC1D,OAAO,MAAM,QAAQ,EAAE,CAAC;AAC1B,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,MAAW,EACX,SAAiB,EACjB,MAAc,EACd,QAAgB,EAChB,KAGC;IAED,MAAM,aAAa,GAAG,2BAA2B,CAAC,QAAQ,CAAC,CAAC;IAC5D,MAAM,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC;QAC/B,SAAS;QACT,SAAS,EAAE,aAAa;QACxB,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC3B,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;KACxC,CAAC,CAAC;IACH,OAAO,EAAE,aAAa,EAAE,CAAC;AAC3B,CAAC"}

package/dist/runtime/controller.d.ts

@@ -0,0 +1,78 @@
+import type { BridgeConfig, ParsedTelegramCommand, RuntimeDeps } from "../types.js";
+import type { TuiPluginApi } from "../tui-types.js";
+type SessionCredentials = {
+    botToken: string;
+    channelID: string;
+};
+export declare class BridgeController {
+    private readonly api;
+    private readonly config;
+    private readonly deps;
+    private readonly instanceID;
+    private readonly client;
+    private telegram;
+    private readonly store;
+    private readonly lease;
+    private data?;
+    private heartbeatTimer?;
+    private pollAbort?;
+    private pollTask?;
+    private eventStream?;
+    private eventRestartTimer?;
+    private readonly shutdownOnce;
+    private processingQueue;
+    private lastEscAt;
+    private sessionCredentials?;
+    constructor(api: TuiPluginApi, config: BridgeConfig, storePath: string, deps?: Partial<RuntimeDeps>);
+    init(): Promise<void>;
+    bindCurrent(credentials?: SessionCredentials): Promise<string>;
+    unbind(): Promise<void>;
+    statusLine(): Promise<string>;
+    handleTelegramCommand(command: ParsedTelegramCommand): Promise<void>;
+    shutdown(): Promise<void>;
+    handleLocalTuiCommand(command: string): Promise<void>;
+    private processPromptQueue;
+    private onAssistantCompleted;
+    private onUserMessage;
+    private onPermissionAsked;
+    private handlePermissionReply;
+    private handleModelCommand;
+    private fetchAvailableModels;
+    private buildSummary;
+    private handleQueue;
+    private handleCancel;
+    private handleRetry;
+    private handleContext;
+    private handleCompact;
+    private handleNewSession;
+    private handleResetContext;
+    private handleWho;
+    private handleHealth;
+    private handleReclaim;
+    private handleHistory;
+    private handleLastError;
+    private handleInterrupt;
+    private onSessionError;
+    private getGitBranch;
+    private appendPromptHistory;
+    private getSessionTitle;
+    private switchBoundSession;
+    private startHeartbeat;
+    private stopHeartbeat;
+    private startPolling;
+    private startEventStream;
+    private onEventStreamError;
+    private normalizeLocalCommand;
+    private splitCommandArgs;
+    private parseCredentialArgs;
+    private parseStartWithCredentials;
+    private parseCredentialCommand;
+    private resolveCredentials;
+    private getTelegramApi;
+    private requireChannelID;
+    private stopRuntime;
+    private requireState;
+    private persist;
+    private syncState;
+}
+export {};