codex-anywhere 0.1.0

package/dist/service.js

@@ -0,0 +1,322 @@
+import { execFile as execFileCallback } from "node:child_process";
+import { createHash } from "node:crypto";
+import fs from "node:fs/promises";
+import { createRequire } from "node:module";
+import os from "node:os";
+import path from "node:path";
+import process from "node:process";
+import { fileURLToPath } from "node:url";
+import { promisify } from "node:util";
+import { prepareCodexAnywhereConfig } from "./configuration.js";
+import { getStoragePaths } from "./paths.js";
+import { loadConfig } from "./persistence.js";
+const execFileAsync = promisify(execFileCallback);
+const require = createRequire(import.meta.url);
+const LAUNCH_AGENT_DOMAIN = "gui";
+const LAUNCH_AGENT_LABEL_PREFIX = "ai.mempat.codex-anywhere";
+export function buildMacosLaunchAgentSpec(options) {
+    const serviceId = buildServiceId(options.storageRoot);
+    const label = `${LAUNCH_AGENT_LABEL_PREFIX}.${serviceId}`;
+    const launchAgentsDir = path.join(options.homeDir, "Library", "LaunchAgents");
+    const domainTarget = `${LAUNCH_AGENT_DOMAIN}/${options.uid}`;
+    const serviceTarget = `${domainTarget}/${label}`;
+    const logDir = path.join(options.storageRoot, "logs");
+    const environmentVariables = sanitizeEnvironmentVariables({
+        PATH: options.pathEnv,
+        CODEX_ANYWHERE_HOME: options.storageRoot,
+        ...options.extraEnv,
+    });
+    return {
+        label,
+        domainTarget,
+        serviceTarget,
+        plistPath: path.join(launchAgentsDir, `${label}.plist`),
+        stdoutPath: path.join(logDir, "launchd.stdout.log"),
+        stderrPath: path.join(logDir, "launchd.stderr.log"),
+        workingDirectory: options.repoCwd,
+        storageRoot: options.storageRoot,
+        programArguments: options.programArguments,
+        environmentVariables,
+    };
+}
+export function renderLaunchAgentPlist(spec) {
+    const programArguments = spec.programArguments
+        .map((argument) => `    <string>${escapeXml(argument)}</string>`)
+        .join("\n");
+    const environmentVariables = Object.entries(spec.environmentVariables)
+        .sort(([left], [right]) => left.localeCompare(right))
+        .map(([key, value]) => `    <key>${escapeXml(key)}</key>\n    <string>${escapeXml(value)}</string>`)
+        .join("\n");
+    return `<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+  <key>Label</key>
+  <string>${escapeXml(spec.label)}</string>
+  <key>ProgramArguments</key>
+  <array>
+${programArguments}
+  </array>
+  <key>WorkingDirectory</key>
+  <string>${escapeXml(spec.workingDirectory)}</string>
+  <key>EnvironmentVariables</key>
+  <dict>
+${environmentVariables}
+  </dict>
+  <key>RunAtLoad</key>
+  <true/>
+  <key>KeepAlive</key>
+  <true/>
+  <key>StandardOutPath</key>
+  <string>${escapeXml(spec.stdoutPath)}</string>
+  <key>StandardErrorPath</key>
+  <string>${escapeXml(spec.stderrPath)}</string>
+</dict>
+</plist>
+`;
+}
+export async function runBackgroundServiceCommand(command, options = {}) {
+    const platform = options.platform ?? process.platform;
+    if (platform !== "darwin") {
+        throw new Error(`Background service management is not implemented on ${platform} yet.`);
+    }
+    const cwd = options.cwd ?? process.cwd();
+    const env = options.env ?? process.env;
+    const storagePaths = options.storagePaths ?? getStoragePaths(env);
+    const storageRoot = path.dirname(storagePaths.configPath);
+    const homeDir = options.homeDir ?? os.homedir();
+    const uid = options.uid ?? currentUid();
+    const execFile = options.execFile ?? execFileAsync;
+    const log = options.log ?? console.log;
+    const packageRoot = options.packageRoot ?? resolvePackageRoot();
+    const existingConfig = (await (options.loadConfig ?? loadConfig)(storagePaths.configPath)) ?? null;
+    const programArguments = await resolveServiceProgramArguments({
+        packageRoot,
+        nodePath: options.nodePath ?? process.execPath,
+        tsxCliPath: options.tsxCliPath,
+    });
+    const spec = buildMacosLaunchAgentSpec({
+        repoCwd: packageRoot,
+        storageRoot,
+        homeDir,
+        uid,
+        pathEnv: env.PATH ?? "",
+        programArguments,
+        extraEnv: {
+            HOME: env.HOME ?? homeDir,
+            LANG: env.LANG,
+            LC_ALL: env.LC_ALL,
+            TMPDIR: env.TMPDIR,
+            USER: env.USER,
+        },
+    });
+    switch (command) {
+        case "install-service":
+            await prepareCodexAnywhereConfig({
+                cwd,
+                env,
+                storagePaths,
+                loadConfig: options.loadConfig,
+                saveConfig: options.saveConfig,
+                runSetupWizard: options.runSetupWizard,
+                runPreflightChecks: options.runPreflightChecks,
+                log,
+            });
+            await installLaunchAgent(spec, execFile);
+            log(`Installed LaunchAgent ${spec.label}`);
+            log(`Plist: ${spec.plistPath}`);
+            log(`Logs: ${spec.stdoutPath}`);
+            return;
+        case "start-service":
+            await assertLaunchAgentInstalled(spec);
+            if (!existingConfig) {
+                throw new Error("Codex Anywhere is not configured yet. Run `npm run connect` or `pnpm run connect` once before starting the service.");
+            }
+            await startLaunchAgent(spec, execFile);
+            log(`Started LaunchAgent ${spec.label}`);
+            return;
+        case "stop-service":
+            await assertLaunchAgentInstalled(spec);
+            await stopLaunchAgent(spec, execFile);
+            log(`Stopped LaunchAgent ${spec.label}`);
+            return;
+        case "service-status":
+            await printLaunchAgentStatus(spec, execFile, log);
+            return;
+        case "uninstall-service":
+            await uninstallLaunchAgent(spec, execFile);
+            log(`Removed LaunchAgent ${spec.label}`);
+            return;
+    }
+}
+async function installLaunchAgent(spec, execFile) {
+    await fs.mkdir(path.dirname(spec.plistPath), { recursive: true });
+    await fs.mkdir(path.dirname(spec.stdoutPath), { recursive: true });
+    await fs.writeFile(spec.plistPath, renderLaunchAgentPlist(spec), "utf8");
+    await runLaunchctl(execFile, ["enable", spec.serviceTarget], { ignoreFailure: true });
+    await runLaunchctl(execFile, ["bootout", spec.domainTarget, spec.plistPath], {
+        ignoreFailure: true,
+    });
+    await runLaunchctl(execFile, ["bootstrap", spec.domainTarget, spec.plistPath]);
+    await runLaunchctl(execFile, ["kickstart", "-k", spec.serviceTarget]);
+}
+async function startLaunchAgent(spec, execFile) {
+    await runLaunchctl(execFile, ["enable", spec.serviceTarget], { ignoreFailure: true });
+    await runLaunchctl(execFile, ["bootout", spec.domainTarget, spec.plistPath], {
+        ignoreFailure: true,
+    });
+    await runLaunchctl(execFile, ["bootstrap", spec.domainTarget, spec.plistPath]);
+    await runLaunchctl(execFile, ["kickstart", "-k", spec.serviceTarget]);
+}
+async function stopLaunchAgent(spec, execFile) {
+    await runLaunchctl(execFile, ["disable", spec.serviceTarget], { ignoreFailure: true });
+    await runLaunchctl(execFile, ["bootout", spec.domainTarget, spec.plistPath], {
+        ignoreFailure: true,
+    });
+}
+async function uninstallLaunchAgent(spec, execFile) {
+    await runLaunchctl(execFile, ["disable", spec.serviceTarget], { ignoreFailure: true });
+    await runLaunchctl(execFile, ["bootout", spec.domainTarget, spec.plistPath], {
+        ignoreFailure: true,
+    });
+    await fs.rm(spec.plistPath, { force: true });
+}
+async function printLaunchAgentStatus(spec, execFile, log) {
+    const installed = await fileExists(spec.plistPath);
+    const loaded = await runLaunchctl(execFile, ["print", spec.serviceTarget], {
+        ignoreFailure: true,
+    });
+    const lines = [
+        `platform: darwin`,
+        `label: ${spec.label}`,
+        `plist: ${spec.plistPath}`,
+        `installed: ${installed ? "yes" : "no"}`,
+        `loaded: ${loaded.ok ? "yes" : "no"}`,
+        `storage-root: ${spec.storageRoot}`,
+        `stdout-log: ${spec.stdoutPath}`,
+        `stderr-log: ${spec.stderrPath}`,
+    ];
+    if (loaded.stdout.trim()) {
+        lines.push("");
+        lines.push("launchctl print:");
+        lines.push(loaded.stdout.trim());
+    }
+    else if (!installed) {
+        lines.push("");
+        lines.push("LaunchAgent plist is not installed.");
+    }
+    log(lines.join("\n"));
+}
+async function assertLaunchAgentInstalled(spec) {
+    if (!(await fileExists(spec.plistPath))) {
+        throw new Error(`LaunchAgent is not installed yet: ${spec.plistPath}\nRun \`npm run service:install\` or \`pnpm run service:install\` first.`);
+    }
+}
+async function fileExists(filePath) {
+    try {
+        await fs.access(filePath);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function currentUid() {
+    if (typeof process.getuid !== "function") {
+        throw new Error("Unable to determine the current user id for launchctl.");
+    }
+    return process.getuid();
+}
+function resolvePackageRoot() {
+    return path.resolve(path.dirname(fileURLToPath(import.meta.url)), "..");
+}
+export async function resolveServiceProgramArguments(options) {
+    const sourceCliPath = path.join(options.packageRoot, "src", "cli.ts");
+    if (await fileExists(sourceCliPath)) {
+        return [options.nodePath, options.tsxCliPath ?? resolveTsxCliPath(), sourceCliPath, "connect"];
+    }
+    const builtCliPath = path.join(options.packageRoot, "dist", "cli.js");
+    if (await fileExists(builtCliPath)) {
+        return [options.nodePath, builtCliPath, "connect"];
+    }
+    throw new Error(`Unable to find a runnable Codex Anywhere CLI entrypoint under ${options.packageRoot}. Expected src/cli.ts or dist/cli.js.`);
+}
+function resolveTsxCliPath() {
+    try {
+        return require.resolve("tsx/cli");
+    }
+    catch {
+        const packageJsonPath = require.resolve("tsx/package.json");
+        const packageJson = require(packageJsonPath);
+        const binEntry = typeof packageJson.bin === "string"
+            ? packageJson.bin
+            : packageJson.bin?.tsx;
+        if (!binEntry) {
+            throw new Error("Unable to resolve the tsx CLI entrypoint.");
+        }
+        return path.join(path.dirname(packageJsonPath), binEntry);
+    }
+}
+function sanitizeEnvironmentVariables(variables) {
+    const sanitized = {};
+    for (const [key, value] of Object.entries(variables)) {
+        if (value) {
+            sanitized[key] = value;
+        }
+    }
+    return sanitized;
+}
+function buildServiceId(storageRoot) {
+    const basename = path.basename(storageRoot) || "codex-anywhere";
+    const slug = basename
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, "-")
+        .replace(/^-+|-+$/g, "")
+        .slice(0, 48);
+    const hash = createHash("sha256").update(storageRoot).digest("hex").slice(0, 12);
+    return slug ? `${slug}-${hash}` : hash;
+}
+function escapeXml(value) {
+    return value
+        .replaceAll("&", "&amp;")
+        .replaceAll("<", "&lt;")
+        .replaceAll(">", "&gt;")
+        .replaceAll('"', "&quot;")
+        .replaceAll("'", "&apos;");
+}
+async function runLaunchctl(execFile, args, options = {}) {
+    try {
+        const result = await execFile("launchctl", args, {
+            env: process.env,
+        });
+        return {
+            ok: true,
+            stdout: result.stdout,
+            stderr: result.stderr,
+        };
+    }
+    catch (error) {
+        const stdout = extractProcessOutput(error, "stdout");
+        const stderr = extractProcessOutput(error, "stderr");
+        if (options.ignoreFailure) {
+            return {
+                ok: false,
+                stdout,
+                stderr,
+            };
+        }
+        throw new Error(formatLaunchctlError(args, stderr || stdout));
+    }
+}
+function extractProcessOutput(error, key) {
+    if (!error || typeof error !== "object" || !(key in error)) {
+        return "";
+    }
+    const value = error[key];
+    return typeof value === "string" ? value : "";
+}
+function formatLaunchctlError(args, output) {
+    const suffix = output.trim() ? `: ${output.trim()}` : "";
+    return `launchctl ${args.join(" ")} failed${suffix}`;
+}
+//# sourceMappingURL=service.js.map

package/dist/service.js.map

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

package/dist/sessions.d.ts

@@ -0,0 +1,7 @@
+export type SessionAction = "takeover" | "status";
+export declare function formatSessionCallbackData(action: SessionAction, threadId: string): string;
+export declare function parseSessionCallbackData(data: string): {
+    action: SessionAction;
+    threadId: string;
+} | null;
+//# sourceMappingURL=sessions.d.ts.map

package/dist/sessions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sessions.d.ts","sourceRoot":"","sources":["../src/sessions.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,aAAa,GAAG,UAAU,GAAG,QAAQ,CAAC;AAElD,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,aAAa,EACrB,QAAQ,EAAE,MAAM,GACf,MAAM,CAER;AAED,wBAAgB,wBAAwB,CACtC,IAAI,EAAE,MAAM,GACX;IAAE,MAAM,EAAE,aAAa,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAcpD"}

package/dist/sessions.js

@@ -0,0 +1,20 @@
+const SESSIONS_PREFIX = "ses";
+export function formatSessionCallbackData(action, threadId) {
+    return `${SESSIONS_PREFIX}:${action}:${threadId}`;
+}
+export function parseSessionCallbackData(data) {
+    const parts = data.split(":");
+    if (parts.length !== 3 || parts[0] !== SESSIONS_PREFIX) {
+        return null;
+    }
+    const action = parts[1];
+    const threadId = parts[2];
+    if (!threadId || (action !== "takeover" && action !== "status")) {
+        return null;
+    }
+    return {
+        action,
+        threadId,
+    };
+}
+//# sourceMappingURL=sessions.js.map

package/dist/sessions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sessions.js","sourceRoot":"","sources":["../src/sessions.ts"],"names":[],"mappings":"AAAA,MAAM,eAAe,GAAG,KAAK,CAAC;AAI9B,MAAM,UAAU,yBAAyB,CACvC,MAAqB,EACrB,QAAgB;IAEhB,OAAO,GAAG,eAAe,IAAI,MAAM,IAAI,QAAQ,EAAE,CAAC;AACpD,CAAC;AAED,MAAM,UAAU,wBAAwB,CACtC,IAAY;IAEZ,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC9B,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,eAAe,EAAE,CAAC;QACvD,OAAO,IAAI,CAAC;IACd,CAAC;IACD,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;IACxB,MAAM,QAAQ,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;IAC1B,IAAI,CAAC,QAAQ,IAAI,CAAC,MAAM,KAAK,UAAU,IAAI,MAAM,KAAK,QAAQ,CAAC,EAAE,CAAC;QAChE,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO;QACL,MAAM;QACN,QAAQ;KACT,CAAC;AACJ,CAAC"}

package/dist/slashCommands.d.ts

@@ -0,0 +1,13 @@
+export interface ParsedTelegramSlashCommand {
+    name: string;
+    args: string;
+}
+export declare function parseTelegramSlashCommand(text: string): ParsedTelegramSlashCommand | null;
+export declare function isRecognizedCodexSlashCommand(name: string): boolean;
+export declare function isSupportedCodexSlashCommand(name: string): boolean;
+export declare function isUnsupportedTelegramOnlyCodexCommand(name: string): boolean;
+export declare function isTaskBlockingSlashCommand(name: string): boolean;
+export declare function normalizeApprovalPolicy(value: string): string | null;
+export declare function normalizeReasoningEffort(value: string): string | null;
+export declare function codexSlashHelpText(): string;
+//# sourceMappingURL=slashCommands.d.ts.map

package/dist/slashCommands.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"slashCommands.d.ts","sourceRoot":"","sources":["../src/slashCommands.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,0BAA0B;IACzC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAqED,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,MAAM,GAAG,0BAA0B,GAAG,IAAI,CAUzF;AAED,wBAAgB,6BAA6B,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEnE;AAED,wBAAgB,4BAA4B,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAElE;AAED,wBAAgB,qCAAqC,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAE3E;AAED,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAmBhE;AAED,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAEpE;AAED,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAMrE;AAED,wBAAgB,kBAAkB,IAAI,MAAM,CAkC3C"}

package/dist/slashCommands.js

@@ -0,0 +1,150 @@
+const SUPPORTED_CODEX_COMMANDS = new Set([
+    "approvals",
+    "agent",
+    "apps",
+    "clear",
+    "collab",
+    "compact",
+    "copy",
+    "diff",
+    "esc",
+    "experimental",
+    "ese",
+    "fast",
+    "feedback",
+    "fork",
+    "init",
+    "logout",
+    "mcp",
+    "mention",
+    "model",
+    "new",
+    "personality",
+    "plan",
+    "permissions",
+    "plugins",
+    "quit",
+    "rename",
+    "resume",
+    "review",
+    "rollout",
+    "skills",
+    "status",
+    "stop",
+    "subagents",
+    "verbose",
+    "clean",
+    "exit",
+]);
+const KNOWN_BUT_UNSUPPORTED_COMMANDS = new Set([
+    "debug-config",
+    "ps",
+    "realtime",
+    "sandbox-add-read-dir",
+    "settings",
+    "setup-default-sandbox",
+    "statusline",
+    "test-approval",
+    "theme",
+    "title",
+    "debug-m-drop",
+    "debug-m-update",
+]);
+const APPROVAL_POLICY_ALIASES = new Map([
+    ["untrusted", "untrusted"],
+    ["unless-trusted", "untrusted"],
+    ["unless_trusted", "untrusted"],
+    ["on-failure", "on-failure"],
+    ["onfailure", "on-failure"],
+    ["on_failure", "on-failure"],
+    ["on-request", "on-request"],
+    ["onrequest", "on-request"],
+    ["on_request", "on-request"],
+    ["never", "never"],
+]);
+export function parseTelegramSlashCommand(text) {
+    const trimmed = text.trim();
+    const match = /^\/([^\s@]+)(?:@[^\s]+)?(?:\s+([\s\S]*))?$/.exec(trimmed);
+    if (!match) {
+        return null;
+    }
+    return {
+        name: match[1].toLowerCase(),
+        args: (match[2] ?? "").trim(),
+    };
+}
+export function isRecognizedCodexSlashCommand(name) {
+    return SUPPORTED_CODEX_COMMANDS.has(name) || KNOWN_BUT_UNSUPPORTED_COMMANDS.has(name);
+}
+export function isSupportedCodexSlashCommand(name) {
+    return SUPPORTED_CODEX_COMMANDS.has(name);
+}
+export function isUnsupportedTelegramOnlyCodexCommand(name) {
+    return KNOWN_BUT_UNSUPPORTED_COMMANDS.has(name);
+}
+export function isTaskBlockingSlashCommand(name) {
+    return new Set([
+        "approvals",
+        "clear",
+        "compact",
+        "experimental",
+        "fast",
+        "fork",
+        "init",
+        "logout",
+        "model",
+        "new",
+        "personality",
+        "plan",
+        "permissions",
+        "rename",
+        "resume",
+        "review",
+    ]).has(name);
+}
+export function normalizeApprovalPolicy(value) {
+    return APPROVAL_POLICY_ALIASES.get(value.trim().toLowerCase()) ?? null;
+}
+export function normalizeReasoningEffort(value) {
+    const normalized = value.trim().toLowerCase();
+    if (["minimal", "low", "medium", "high"].includes(normalized)) {
+        return normalized;
+    }
+    return null;
+}
+export function codexSlashHelpText() {
+    return [
+        "Codex Anywhere commands:",
+        "/start, /help, /new, /resume, /interrupt, /cancel, /status, /sh <command>, /workspace <path>",
+        "Telegram will also show the registered command list when you type /",
+        "",
+        "Codex slash commands supported in Telegram:",
+        "/model [status|reset|<model> [effort]]",
+        "/fast [status|on|off]",
+        "/personality [friendly|pragmatic|none]",
+        "/permissions [status|untrusted|on-failure|on-request|never]",
+        "/plan [task]",
+        "/collab [mode]",
+        "/agent, /subagents",
+        "/resume",
+        "/review [base <branch>|commit <sha>|<custom instructions>]",
+        "/rename <name>, /fork, /compact, /clear",
+        "/diff, /copy, /mention <query>, /skills, /mcp, /apps, /plugins, /feedback, /verbose [on|off|status]",
+        "/experimental [status|<feature> on|off], /rollout, /logout, /quit, /exit, /stop",
+        "/esc (/ese alias) to interrupt the current turn",
+        "/omx [args] to run supported oh-my-codex CLI commands",
+        "",
+        "Interactive prompts:",
+        "- approvals and file changes appear as Telegram buttons",
+        "- choice prompts are rendered as Telegram cards",
+        "- freeform prompts ask you to reply in chat",
+        "- some slash commands open Telegram pickers when invoked without args",
+        "- send a photo with an optional caption to include image + text in one turn",
+        "- while a turn is active, sending a message steers it; use Queue Next to hold the next message",
+        "- send /cancel to cancel an active prompt",
+        "",
+        "Recognized but not meaningful in Telegram yet:",
+        "/ps, /theme, /title, /statusline, /realtime, /settings",
+    ].join("\n");
+}
+//# sourceMappingURL=slashCommands.js.map

package/dist/slashCommands.js.map

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

package/dist/telegram.d.ts

@@ -0,0 +1,21 @@
+import type { JsonObject, TelegramBotCommand, TelegramUpdate } from "./types.js";
+import type { TelegramParseMode } from "./telegramFormatting.js";
+export declare class TelegramBotApi {
+    #private;
+    constructor(token: string);
+    getMe(): Promise<Record<string, unknown>>;
+    setMyCommands(commands: TelegramBotCommand[]): Promise<void>;
+    getUpdates(offset: number | null, timeoutSeconds: number): Promise<TelegramUpdate[]>;
+    getFile(fileId: string): Promise<{
+        file_path: string;
+    }>;
+    downloadFile(filePath: string): Promise<Buffer>;
+    sendChatAction(chatId: number, action: "typing"): Promise<void>;
+    sendMessage(chatId: number, text: string, replyMarkup?: JsonObject, parseMode?: TelegramParseMode): Promise<{
+        message_id: number;
+    }>;
+    editMessageText(chatId: number, messageId: number, text: string, replyMarkup?: JsonObject, parseMode?: TelegramParseMode): Promise<void>;
+    answerCallbackQuery(callbackQueryId: string, text: string): Promise<void>;
+    deleteMessage(chatId: number, messageId: number): Promise<void>;
+}
+//# 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,OAAO,KAAK,EAAE,UAAU,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AACjF,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAEjE,qBAAa,cAAc;;gBAGb,KAAK,EAAE,MAAM;IAInB,KAAK,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAIzC,aAAa,CAAC,QAAQ,EAAE,kBAAkB,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAI5D,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,EAAE,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;IAWpF,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;IAMvD,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAQ/C,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IAO/D,WAAW,CACf,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,WAAW,CAAC,EAAE,UAAU,EACxB,SAAS,CAAC,EAAE,iBAAiB,GAC5B,OAAO,CAAC;QAAE,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC;IAc5B,eAAe,CACnB,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,MAAM,EACZ,WAAW,CAAC,EAAE,UAAU,EACxB,SAAS,CAAC,EAAE,iBAAiB,GAC5B,OAAO,CAAC,IAAI,CAAC;IAsBV,mBAAmB,CAAC,eAAe,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQzE,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAyBtE"}