opencode-gateway 0.2.2 → 0.2.4

package/dist/telegram/client.d.ts

@@ -6,7 +6,7 @@ export declare class TelegramApiError extends Error {
 export declare class TelegramBotClient {
     private readonly botToken;
     constructor(botToken: string);
-    getUpdates(offset: number | null, timeoutSeconds: number): Promise<TelegramUpdate[]>;
+    getUpdates(offset: number | null, timeoutSeconds: number, signal?: AbortSignal): Promise<TelegramUpdate[]>;
     getMe(): Promise<TelegramBotProfile>;
     getChat(chatId: string): Promise<TelegramChat>;
     getFile(fileId: string): Promise<TelegramFileRecord>;

package/dist/telegram/poller.d.ts

@@ -6,6 +6,11 @@ import type { GatewayMailboxRuntime } from "../runtime/mailbox";
 import type { SqliteStore } from "../store/sqlite";
 import { type TelegramPollingClientLike } from "./client";
 import type { TelegramInboundMediaStore } from "./media";
+type PollerTiming = {
+    timeoutFloorMs: number;
+    timeoutGraceMs: number;
+    stallGraceMs: number;
+};
 export declare class TelegramPollingService {
     private readonly client;
     private readonly mailbox;
@@ -16,14 +21,24 @@ export declare class TelegramPollingService {
     private readonly mediaStore;
     private readonly questions;
     private readonly allowlist;
+    private readonly timing;
     private running;
+    private inFlightStartedAtMs;
+    private consecutiveFailures;
+    private recoveredAtMs;
     constructor(client: TelegramPollingClientLike, mailbox: GatewayMailboxRuntimeLike, store: SqliteStore, logger: BindingLoggerHost, config: Extract<TelegramConfig, {
         enabled: true;
-    }>, mailboxRouter: GatewayMailboxRouter, mediaStore: TelegramInboundMediaStore, questions: GatewayQuestionRuntime);
+    }>, mailboxRouter: MailboxRouterLike, mediaStore: TelegramInboundMediaStoreLike, questions: GatewayQuestionRuntimeLike, timing?: Partial<PollerTiming>);
     start(): void;
     isRunning(): boolean;
+    currentPollStartedAtMs(): number | null;
+    requestTimeoutMs(): number;
+    recoveryRecordedAtMs(): number | null;
     private runLoop;
     private advanceOffset;
 }
 type GatewayMailboxRuntimeLike = Pick<GatewayMailboxRuntime, "enqueueInboundMessage">;
+type MailboxRouterLike = Pick<GatewayMailboxRouter, "resolve">;
+type TelegramInboundMediaStoreLike = Pick<TelegramInboundMediaStore, "materializeInboundMessage">;
+type GatewayQuestionRuntimeLike = Pick<GatewayQuestionRuntime, "handleTelegramCallbackQuery">;
 export {};

package/dist/telegram/runtime.d.ts

@@ -13,6 +13,7 @@ type OpencodeEventStreamLike = {
 export type GatewayTelegramStatus = TelegramHealthSnapshot & {
     enabled: boolean;
     polling: boolean;
+    pollState: "disabled" | "idle" | "running" | "stalled" | "recovering";
     allowlistMode: "disabled" | "explicit";
     allowedChatsCount: number;
     allowedUsersCount: number;
@@ -32,6 +33,7 @@ export type TelegramSendTestResult = {
     mode: "oneshot" | "progressive";
 };
 type TelegramTextDeliveryLike = Pick<GatewayTextDelivery, "sendTest">;
+type TelegramPollingStateLike = Pick<TelegramPollingService, "currentPollStartedAtMs" | "isRunning" | "recoveryRecordedAtMs" | "requestTimeoutMs" | "start">;
 export declare class GatewayTelegramRuntime {
     private readonly client;
     private readonly delivery;
@@ -40,7 +42,7 @@ export declare class GatewayTelegramRuntime {
     private readonly config;
     private readonly polling;
     private readonly opencodeEvents;
-    constructor(client: TelegramRuntimeClientLike | null, delivery: TelegramTextDeliveryLike, store: SqliteStore, logger: BindingLoggerHost, config: TelegramConfig, polling: TelegramPollingService | null, opencodeEvents: OpencodeEventStreamLike);
+    constructor(client: TelegramRuntimeClientLike | null, delivery: TelegramTextDeliveryLike, store: SqliteStore, logger: BindingLoggerHost, config: TelegramConfig, polling: TelegramPollingStateLike | null, opencodeEvents: OpencodeEventStreamLike);
     isEnabled(): boolean;
     isPolling(): boolean;
     allowlistMode(): "disabled" | "explicit";

package/dist/telegram/state.d.ts

@@ -4,8 +4,12 @@ export type TelegramStreamingFallbackReason = "non_private_chat" | "progressive_
 export type TelegramHealthSnapshot = {
     updateOffset: number | null;
     lastPollSuccessMs: number | null;
+    lastPollStartedMs: number | null;
+    lastPollCompletedMs: number | null;
     lastPollErrorAtMs: number | null;
     lastPollErrorMessage: string | null;
+    lastPollTimeoutAtMs: number | null;
+    lastPollTimeoutMessage: string | null;
     lastSendSuccessMs: number | null;
     lastSendErrorAtMs: number | null;
     lastSendErrorMessage: string | null;
@@ -22,8 +26,11 @@ export type TelegramHealthSnapshot = {
     lastStreamFallbackReason: TelegramStreamingFallbackReason | null;
 };
 export declare function readTelegramHealthSnapshot(store: SqliteStore): TelegramHealthSnapshot;
+export declare function recordTelegramPollStarted(store: SqliteStore, recordedAtMs: number): void;
+export declare function recordTelegramPollCompleted(store: SqliteStore, recordedAtMs: number): void;
 export declare function recordTelegramPollSuccess(store: SqliteStore, recordedAtMs: number): void;
 export declare function recordTelegramPollFailure(store: SqliteStore, message: string, recordedAtMs: number): void;
+export declare function recordTelegramPollTimeout(store: SqliteStore, message: string, recordedAtMs: number): void;
 export declare function recordTelegramSendSuccess(store: SqliteStore, recordedAtMs: number): void;
 export declare function recordTelegramSendFailure(store: SqliteStore, message: string, recordedAtMs: number): void;
 export declare function recordTelegramProbeSuccess(store: SqliteStore, bot: TelegramBotProfile, recordedAtMs: number): void;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "opencode-gateway",
-  "version": "0.2.2",
+  "version": "0.2.4",
   "description": "Gateway plugin for OpenCode",
   "license": "MIT",
   "type": "module",

package/dist/binding/execution.js

@@ -1 +0,0 @@
-export {};

package/dist/binding/gateway.js

@@ -1 +0,0 @@
-export {};

package/dist/binding/index.js

@@ -1,4 +0,0 @@
-const GENERATED_NODE_ENTRYPOINT = new URL("../../generated/wasm/pkg/opencode_gateway_ffi.js", import.meta.url);
-export async function loadGatewayBindingModule() {
-    return (await import(GENERATED_NODE_ENTRYPOINT.href));
-}

package/dist/binding/opencode.js

@@ -1 +0,0 @@
-export {};

package/dist/cli/args.js

@@ -1,53 +0,0 @@
-import { resolve } from "node:path";
-export function parseCliCommand(argv) {
-    const [command, ...rest] = argv;
-    if (!command || command === "help" || command === "--help" || command === "-h") {
-        return { kind: "help" };
-    }
-    if (command !== "init" && command !== "doctor") {
-        throw new Error(`unknown command: ${command}`);
-    }
-    let managed = false;
-    let configDir = null;
-    for (let index = 0; index < rest.length; index += 1) {
-        const argument = rest[index];
-        if (argument === "--managed") {
-            managed = true;
-            continue;
-        }
-        if (argument === "--config-dir") {
-            const value = rest[index + 1];
-            if (!value) {
-                throw new Error("--config-dir requires a value");
-            }
-            configDir = resolve(value);
-            index += 1;
-            continue;
-        }
-        if (argument === "--help" || argument === "-h") {
-            return { kind: "help" };
-        }
-        throw new Error(`unknown argument: ${argument}`);
-    }
-    if (managed && configDir !== null) {
-        throw new Error("--managed cannot be combined with --config-dir");
-    }
-    return {
-        kind: command,
-        managed,
-        configDir,
-    };
-}
-export function formatCliHelp() {
-    return [
-        "opencode-gateway",
-        "",
-        "Commands:",
-        "  opencode-gateway init [--managed] [--config-dir <path>]",
-        "  opencode-gateway doctor [--managed] [--config-dir <path>]",
-        "",
-        "Defaults:",
-        "  init/doctor use OPENCODE_CONFIG_DIR when set, otherwise ~/.config/opencode",
-        "  --managed uses ~/.config/opencode-gateway/opencode",
-    ].join("\n");
-}

package/dist/cli/doctor.js

@@ -1,49 +0,0 @@
-import { readFile } from "node:fs/promises";
-import { join } from "node:path";
-import { GATEWAY_CONFIG_FILE, resolveGatewayWorkspacePath } from "../config/paths";
-import { inspectGatewayPlugin, parseOpencodeConfig } from "./opencode-config";
-import { resolveOpencodeConfigFile } from "./opencode-config-file";
-import { pathExists, resolveCliConfigDir } from "./paths";
-export async function runDoctor(options, env) {
-    const configDir = resolveCliConfigDir(options, env);
-    const gatewayConfigPath = join(configDir, GATEWAY_CONFIG_FILE);
-    const workspaceDirPath = resolveGatewayWorkspacePath(gatewayConfigPath);
-    const opencodeConfig = await resolveOpencodeConfigFile(configDir);
-    const opencodeStatus = await inspectOpencodeConfig(opencodeConfig.path);
-    const gatewayOverride = env.OPENCODE_GATEWAY_CONFIG?.trim() || null;
-    console.log("doctor report");
-    console.log(`  config dir: ${configDir}`);
-    console.log(`  opencode config: ${await describePath(opencodeConfig.path)}`);
-    console.log(`  gateway config: ${await describePath(gatewayConfigPath)}`);
-    console.log(`  gateway workspace: ${await describePath(workspaceDirPath)}`);
-    console.log(`  gateway config override: ${gatewayOverride ?? "not set"}`);
-    console.log(`  plugin configured: ${opencodeStatus.pluginConfigured}`);
-    console.log(`  TELEGRAM_BOT_TOKEN: ${env.TELEGRAM_BOT_TOKEN?.trim() ? "set" : "missing"}`);
-    if (opencodeStatus.error !== null) {
-        console.log(`  opencode config error: ${opencodeStatus.error}`);
-    }
-}
-async function describePath(path) {
-    return (await pathExists(path)) ? `present at ${path}` : `missing at ${path}`;
-}
-async function inspectOpencodeConfig(path) {
-    if (!(await pathExists(path))) {
-        return {
-            pluginConfigured: "no",
-            error: null,
-        };
-    }
-    try {
-        const parsed = parseOpencodeConfig(await readFile(path, "utf8"), path);
-        return {
-            pluginConfigured: inspectGatewayPlugin(parsed),
-            error: null,
-        };
-    }
-    catch (error) {
-        return {
-            pluginConfigured: "unknown",
-            error: error instanceof Error ? error.message : String(error),
-        };
-    }
-}

package/dist/cli/init.js

@@ -1,40 +0,0 @@
-import { mkdir, readFile, writeFile } from "node:fs/promises";
-import { dirname, join } from "node:path";
-import { defaultGatewayStateDbPath, GATEWAY_CONFIG_FILE, resolveGatewayWorkspacePath } from "../config/paths";
-import { createDefaultOpencodeConfig, ensureGatewayPlugin, parseOpencodeConfig, stringifyOpencodeConfig, } from "./opencode-config";
-import { resolveOpencodeConfigFile } from "./opencode-config-file";
-import { pathExists, resolveCliConfigDir } from "./paths";
-import { buildGatewayConfigTemplate } from "./templates";
-export async function runInit(options, env) {
-    const configDir = resolveCliConfigDir(options, env);
-    const gatewayConfigPath = join(configDir, GATEWAY_CONFIG_FILE);
-    const workspaceDirPath = resolveGatewayWorkspacePath(gatewayConfigPath);
-    const opencodeConfig = await resolveOpencodeConfigFile(configDir);
-    const opencodeConfigPath = opencodeConfig.path;
-    await mkdir(configDir, { recursive: true });
-    await mkdir(workspaceDirPath, { recursive: true });
-    let opencodeStatus = "already present";
-    if (!opencodeConfig.exists) {
-        await writeFile(opencodeConfigPath, stringifyOpencodeConfig(createDefaultOpencodeConfig(options.managed)));
-        opencodeStatus = "created";
-    }
-    else {
-        const source = await readFile(opencodeConfigPath, "utf8");
-        const parsed = parseOpencodeConfig(source, opencodeConfigPath);
-        const next = ensureGatewayPlugin(parsed);
-        if (next.changed) {
-            await writeFile(opencodeConfigPath, stringifyOpencodeConfig(next.document));
-            opencodeStatus = "updated";
-        }
-    }
-    let gatewayStatus = "already present";
-    if (!(await pathExists(gatewayConfigPath))) {
-        await mkdir(dirname(gatewayConfigPath), { recursive: true });
-        await writeFile(gatewayConfigPath, buildGatewayConfigTemplate(defaultGatewayStateDbPath(env)));
-        gatewayStatus = "created";
-    }
-    console.log(`config dir: ${configDir}`);
-    console.log(`opencode config: ${opencodeConfigPath} (${opencodeStatus})`);
-    console.log(`gateway config: ${gatewayConfigPath} (${gatewayStatus})`);
-    console.log(`gateway workspace: ${workspaceDirPath} (ready)`);
-}

package/dist/cli/opencode-config-file.js

@@ -1,18 +0,0 @@
-import { join } from "node:path";
-import { OPENCODE_CONFIG_FILE_CANDIDATES, OPENCODE_CONFIG_FILE_JSONC } from "../config/paths";
-import { pathExists } from "./paths";
-export async function resolveOpencodeConfigFile(configDir) {
-    for (const fileName of OPENCODE_CONFIG_FILE_CANDIDATES) {
-        const path = join(configDir, fileName);
-        if (await pathExists(path)) {
-            return {
-                path,
-                exists: true,
-            };
-        }
-    }
-    return {
-        path: join(configDir, OPENCODE_CONFIG_FILE_JSONC),
-        exists: false,
-    };
-}

package/dist/cli/opencode-config.js

@@ -1,194 +0,0 @@
-const OPENCODE_SCHEMA_URL = "https://opencode.ai/config.json";
-const PACKAGE_NAME = "opencode-gateway";
-const PACKAGE_SPEC = "opencode-gateway@latest";
-export function createDefaultOpencodeConfig(managed) {
-    const document = {
-        $schema: OPENCODE_SCHEMA_URL,
-        plugin: [PACKAGE_SPEC],
-    };
-    if (managed) {
-        document.server = {
-            hostname: "127.0.0.1",
-            port: 4096,
-        };
-    }
-    return document;
-}
-export function ensureGatewayPlugin(document) {
-    const plugins = readPluginArray(document);
-    if (plugins === undefined) {
-        return {
-            changed: true,
-            document: {
-                ...document,
-                plugin: [PACKAGE_SPEC],
-            },
-        };
-    }
-    if (plugins.includes(PACKAGE_SPEC)) {
-        return {
-            changed: false,
-            document,
-        };
-    }
-    return {
-        changed: true,
-        document: {
-            ...document,
-            plugin: [...plugins, PACKAGE_SPEC],
-        },
-    };
-}
-export function parseOpencodeConfig(source, path) {
-    let parsed;
-    try {
-        parsed = JSON.parse(toStrictJson(source));
-    }
-    catch (error) {
-        throw new Error(`failed to parse opencode config ${path}: ${formatError(error)}`);
-    }
-    if (parsed === null || typeof parsed !== "object" || Array.isArray(parsed)) {
-        throw new Error(`opencode config ${path} must decode to a JSON object`);
-    }
-    return parsed;
-}
-export function stringifyOpencodeConfig(document) {
-    return `${JSON.stringify(document, null, 2)}\n`;
-}
-export function inspectGatewayPlugin(document) {
-    const plugins = readPluginArray(document);
-    if (plugins === undefined) {
-        return "no";
-    }
-    if (plugins.includes(PACKAGE_SPEC)) {
-        return "yes";
-    }
-    return plugins.some((entry) => isGatewayPluginReference(entry)) ? "needs_update" : "no";
-}
-function formatError(error) {
-    return error instanceof Error ? error.message : String(error);
-}
-function readPluginArray(document) {
-    const plugins = document.plugin;
-    if (plugins === undefined) {
-        return undefined;
-    }
-    if (!Array.isArray(plugins)) {
-        throw new Error("opencode config field `plugin` must be an array when present");
-    }
-    const normalized = [];
-    for (const [index, entry] of plugins.entries()) {
-        if (typeof entry !== "string") {
-            throw new Error(`opencode config field \`plugin[${index}]\` must be a string`);
-        }
-        normalized.push(entry);
-    }
-    return normalized;
-}
-function toStrictJson(source) {
-    return stripTrailingCommas(stripJsonComments(source));
-}
-function stripJsonComments(source) {
-    let result = "";
-    let inString = false;
-    let escaped = false;
-    let inLineComment = false;
-    let inBlockComment = false;
-    for (let index = 0; index < source.length; index += 1) {
-        const current = source[index];
-        const next = source[index + 1];
-        if (inLineComment) {
-            if (current === "\n") {
-                inLineComment = false;
-                result += current;
-            }
-            continue;
-        }
-        if (inBlockComment) {
-            if (current === "*" && next === "/") {
-                inBlockComment = false;
-                index += 1;
-            }
-            else if (current === "\n") {
-                result += current;
-            }
-            continue;
-        }
-        if (inString) {
-            result += current;
-            if (escaped) {
-                escaped = false;
-            }
-            else if (current === "\\") {
-                escaped = true;
-            }
-            else if (current === '"') {
-                inString = false;
-            }
-            continue;
-        }
-        if (current === '"') {
-            inString = true;
-            result += current;
-            continue;
-        }
-        if (current === "/" && next === "/") {
-            inLineComment = true;
-            index += 1;
-            continue;
-        }
-        if (current === "/" && next === "*") {
-            inBlockComment = true;
-            index += 1;
-            continue;
-        }
-        result += current;
-    }
-    return result;
-}
-function stripTrailingCommas(source) {
-    let result = "";
-    let inString = false;
-    let escaped = false;
-    for (let index = 0; index < source.length; index += 1) {
-        const current = source[index];
-        if (inString) {
-            result += current;
-            if (escaped) {
-                escaped = false;
-            }
-            else if (current === "\\") {
-                escaped = true;
-            }
-            else if (current === '"') {
-                inString = false;
-            }
-            continue;
-        }
-        if (current === '"') {
-            inString = true;
-            result += current;
-            continue;
-        }
-        if (current === ",") {
-            const nextSignificant = findNextSignificantCharacter(source, index + 1);
-            if (nextSignificant === "]" || nextSignificant === "}") {
-                continue;
-            }
-        }
-        result += current;
-    }
-    return result;
-}
-function findNextSignificantCharacter(source, startIndex) {
-    for (let index = startIndex; index < source.length; index += 1) {
-        const current = source[index];
-        if (!/\s/.test(current)) {
-            return current;
-        }
-    }
-    return null;
-}
-function isGatewayPluginReference(entry) {
-    return entry === PACKAGE_NAME || entry.startsWith(`${PACKAGE_NAME}@`);
-}

package/dist/cli/paths.js

@@ -1,22 +0,0 @@
-import { constants } from "node:fs";
-import { access } from "node:fs/promises";
-import { resolve } from "node:path";
-import { resolveManagedOpencodeConfigDir, resolveOpencodeConfigDir } from "../config/paths";
-export function resolveCliConfigDir(options, env) {
-    if (options.configDir !== null) {
-        return resolve(options.configDir);
-    }
-    if (options.managed) {
-        return resolveManagedOpencodeConfigDir(env);
-    }
-    return resolveOpencodeConfigDir(env);
-}
-export async function pathExists(path) {
-    try {
-        await access(path, constants.F_OK);
-        return true;
-    }
-    catch {
-        return false;
-    }
-}

package/dist/cli/templates.js

@@ -1,41 +0,0 @@
-export function buildGatewayConfigTemplate(stateDbPath) {
-    return [
-        "# Opencode Gateway configuration",
-        "# Fill in secrets and provider details before enabling real integrations.",
-        "",
-        "[gateway]",
-        `state_db = "${escapeTomlString(stateDbPath)}"`,
-        '# log_level = "warn"',
-        "",
-        "[cron]",
-        "enabled = true",
-        "tick_seconds = 5",
-        "max_concurrent_runs = 1",
-        '# timezone = "Asia/Shanghai"',
-        "",
-        "[channels.telegram]",
-        "enabled = false",
-        'bot_token_env = "TELEGRAM_BOT_TOKEN"',
-        "poll_timeout_seconds = 25",
-        "allowed_chats = []",
-        "allowed_users = []",
-        "",
-        "# Optional long-lived memory sources injected into gateway-managed sessions.",
-        "# Relative paths are resolved from opencode-gateway-workspace.",
-        "#",
-        "# [[memory.entries]]",
-        '# path = "memory/project.md"',
-        '# description = "Project conventions and long-lived context"',
-        "# inject_content = true",
-        "#",
-        "# [[memory.entries]]",
-        '# path = "memory/notes"',
-        '# description = "Domain notes and operating docs"',
-        "# inject_markdown_contents = true",
-        '# globs = ["**/*.rs", "notes/**/*.txt"]',
-        "",
-    ].join("\n");
-}
-function escapeTomlString(value) {
-    return value.replaceAll("\\", "\\\\").replaceAll('"', '\\"');
-}

package/dist/config/cron.js

@@ -1,52 +0,0 @@
-export function parseCronConfig(value) {
-    const table = readCronTable(value);
-    return {
-        enabled: readBoolean(table.enabled, "cron.enabled", true),
-        tickSeconds: readPositiveInteger(table.tick_seconds, "cron.tick_seconds", 5),
-        maxConcurrentRuns: readPositiveInteger(table.max_concurrent_runs, "cron.max_concurrent_runs", 1),
-        timezone: readOptionalString(table.timezone, "cron.timezone"),
-    };
-}
-function readCronTable(value) {
-    if (value === undefined) {
-        return {};
-    }
-    if (value === null || typeof value !== "object" || Array.isArray(value)) {
-        throw new Error("cron must be a table when present");
-    }
-    return value;
-}
-function readBoolean(value, field, fallback) {
-    if (value === undefined) {
-        return fallback;
-    }
-    if (typeof value !== "boolean") {
-        throw new Error(`${field} must be a boolean when present`);
-    }
-    return value;
-}
-function readPositiveInteger(value, field, fallback) {
-    if (value === undefined) {
-        return fallback;
-    }
-    if (typeof value !== "number" || !Number.isInteger(value)) {
-        throw new Error(`${field} must be an integer when present`);
-    }
-    if (value < 1) {
-        throw new Error(`${field} must be greater than or equal to 1`);
-    }
-    return value;
-}
-function readOptionalString(value, field) {
-    if (value === undefined) {
-        return null;
-    }
-    if (typeof value !== "string") {
-        throw new Error(`${field} must be a string when present`);
-    }
-    const trimmed = value.trim();
-    if (trimmed.length === 0) {
-        throw new Error(`${field} must not be empty when present`);
-    }
-    return trimmed;
-}