agent-afk 5.286.2 → 5.287.1

package/dist/config/env.telegram.d.ts

@@ -0,0 +1,77 @@
+export declare const TELEGRAM_ENV_REGISTRY: readonly [{
+    readonly name: "TELEGRAM_BOT_TOKEN";
+    readonly description: "Telegram bot token from @BotFather. Required to run the Telegram bot surface.";
+    readonly type: "string";
+    readonly required: false;
+    readonly category: "telegram";
+    readonly secret: true;
+}, {
+    readonly name: "AFK_TELEGRAM_BOT_TOKEN";
+    readonly description: "Alternative env var name for the Telegram bot token, accepted by the setup wizard.";
+    readonly type: "string";
+    readonly required: false;
+    readonly category: "telegram";
+    readonly secret: true;
+}, {
+    readonly name: "AFK_TELEGRAM_ALLOWED_CHAT_IDS";
+    readonly description: "Comma-separated list of Telegram chat IDs allowed to interact with the bot. Required when the bot is running.";
+    readonly type: "string";
+    readonly required: false;
+    readonly example: "123456789,987654321";
+    readonly category: "telegram";
+}, {
+    readonly name: "AFK_TELEGRAM_TAG_ONLY_CHAT_IDS";
+    readonly description: "Comma-separated list of Telegram chat IDs where the bot answers only when addressed (a reply to the bot, an @mention of the bot, or a text_mention resolving to the bot). Slash-commands are unaffected; chats not listed behave as usual. The afk.config.json telegram.tagOnlyChats block takes precedence. Requires Telegram privacy mode OFF (BotFather /setprivacy Disable) for non-addressed group messages to reach the bot.";
+    readonly type: "string";
+    readonly required: false;
+    readonly example: "-100987654321,123456789";
+    readonly category: "telegram";
+}, {
+    readonly name: "AFK_TELEGRAM_PRIMARY_CHAT_ID";
+    readonly description: "Default chat ID for outbound notifications (primary-mode routing). When unset, notifications go to the first private/DM chat in AFK_TELEGRAM_ALLOWED_CHAT_IDS. The afk.config.json telegram.notify block takes precedence.";
+    readonly type: "string";
+    readonly required: false;
+    readonly example: "123456789";
+    readonly category: "telegram";
+}, {
+    readonly name: "AFK_TELEGRAM_NOTIFY_MODE";
+    readonly description: "Outbound notification fan-out: primary (default — one chat), broadcast (every allowed chat), or custom (afk.config.json telegram.notify.targets). The afk.config.json telegram.notify.mode takes precedence.";
+    readonly type: "string";
+    readonly required: false;
+    readonly example: "broadcast";
+    readonly category: "telegram";
+}, {
+    readonly name: "TELEGRAM_DATA_DIR";
+    readonly description: "Override the directory where Telegram bot state is stored. Defaults to ~/.afk/state/telegram/.";
+    readonly type: "string";
+    readonly required: false;
+    readonly category: "telegram";
+}, {
+    readonly name: "TELEGRAM_VERBOSE";
+    readonly description: "Set to a truthy value ('1'/'true'/'yes'/'on', case-insensitive) to log per-message details from the Telegram bot — chat IDs, message text, latency.";
+    readonly type: "boolean";
+    readonly required: false;
+    readonly example: "true";
+    readonly category: "telegram";
+}, {
+    readonly name: "AFK_TELEGRAM_TRACE";
+    readonly description: "Set to 1 to dump raw bridge traffic between the agent and the Telegram bot — debugging only.";
+    readonly type: "boolean";
+    readonly required: false;
+    readonly example: "1";
+    readonly category: "debug";
+}, {
+    readonly name: "AFK_TELEGRAM_CWD";
+    readonly description: "Override the working directory used by the Telegram bot when spawning agent sessions.";
+    readonly type: "string";
+    readonly required: false;
+    readonly category: "telegram";
+}, {
+    readonly name: "AFK_TELEGRAM_SESSION_IDLE_MS";
+    readonly description: "Milliseconds of inactivity after which an idle AgentSession is closed and its memory freed. sessionData (model/cwd preferences) is kept in-memory and reloaded on demand from disk. Default: 14400000 (4 hours).";
+    readonly type: "number";
+    readonly required: false;
+    readonly default: "14400000";
+    readonly example: "3600000";
+    readonly category: "telegram";
+}];

package/dist/config/env.ui.d.ts

@@ -0,0 +1,112 @@
+export declare const UI_ENV_REGISTRY: readonly [{
+    readonly name: "AFK_BANNER_PLAIN";
+    readonly description: "Suppress the ANSI-colored banner at REPL startup. Useful for non-TTY captures and CI logs.";
+    readonly type: "boolean";
+    readonly required: false;
+    readonly example: "1";
+    readonly category: "misc";
+}, {
+    readonly name: "AFK_PLAIN_OUTPUT";
+    readonly description: string;
+    readonly type: "boolean";
+    readonly required: false;
+    readonly example: "1";
+    readonly category: "misc";
+}, {
+    readonly name: "AFK_SPINNER_TIPS";
+    readonly description: "Show rotating tips in the loading spinner during long calls. 1 = on, 0 = off.";
+    readonly type: "boolean";
+    readonly required: false;
+    readonly category: "misc";
+}, {
+    readonly name: "AFK_GOBLIN_SPINNER";
+    readonly description: "Goblin-themed working spinner (olive frames + goblin verbs) while the agent runs tools. 1 = on (default), 0 = classic dim spinner.";
+    readonly type: "boolean";
+    readonly required: false;
+    readonly example: "0";
+    readonly category: "misc";
+}, {
+    readonly name: "AFK_GOBLIN_MASCOT";
+    readonly description: "Reacting goblin mini-sprite in the reserved footer band while the agent runs tools (3 rows, animated). 1 = on, unset/0 = off (default). Claims terminal rows, so it is opt-in.";
+    readonly type: "boolean";
+    readonly required: false;
+    readonly example: "1";
+    readonly category: "misc";
+}, {
+    readonly name: "AFK_TERM_TITLE";
+    readonly description: "Set the terminal/tab title (OSC 2) to reflect afk state — \"afk — <cwd> · running\" during a turn, \"afk — <cwd>\" when idle, cleared on exit. 1 = on (default when stdout is a TTY), 0 = leave the title alone. TTY-only.";
+    readonly type: "boolean";
+    readonly required: false;
+    readonly example: "0";
+    readonly category: "misc";
+}, {
+    readonly name: "AFK_NOTIFY";
+    readonly description: "Emit a desktop completion notification (OSC 9) on turn completion, for terminals that map OSC 9 to system notifications (iTerm2, kitty, WezTerm). Opt-in and off by default (intrusive). 1 = on. TTY-only.";
+    readonly type: "boolean";
+    readonly required: false;
+    readonly example: "1";
+    readonly category: "misc";
+}, {
+    readonly name: "AFK_SHOW_DIFFS";
+    readonly description: "Show inline diffs in the tool-lane output for edit/write tool calls. 1 = on, 0 = off.";
+    readonly type: "boolean";
+    readonly required: false;
+    readonly category: "misc";
+}, {
+    readonly name: "AFK_TURN_SEPARATOR";
+    readonly description: "Render a dim horizontal rule between conversation turns in the REPL. 0 = off, unset/1 = on (default). TTY-only: piped/one-shot output (afk chat) never emits the rule.";
+    readonly type: "boolean";
+    readonly required: false;
+    readonly example: "0";
+    readonly category: "misc";
+}, {
+    readonly name: "AFK_STREAM_BUFFER_MS";
+    readonly description: "Input buffer window for TUI streaming in milliseconds. When set to a positive value, incoming tokens are micro-batched before parsing and rendering, producing smoother visual output. The first token after idle always passes through immediately (leading-edge). 0 = disabled (every token is parsed individually). Reasonable range: 8-50.";
+    readonly type: "number";
+    readonly required: false;
+    readonly default: "0";
+    readonly example: "16";
+    readonly category: "display";
+}, {
+    readonly name: "AFK_SKILL_STREAM_VERBOSE";
+    readonly description: "Verbose streaming output when a skill is dispatched. Logs sub-agent setup, intermediate events, and final result.";
+    readonly type: "boolean";
+    readonly required: false;
+    readonly category: "debug";
+}, {
+    readonly name: "FORCE_COLOR";
+    readonly description: "Standard Node convention. Force-enable ANSI color output even when stdout is not a TTY.";
+    readonly type: "string";
+    readonly required: false;
+    readonly example: "1";
+    readonly category: "process";
+}, {
+    readonly name: "NO_COLOR";
+    readonly description: "Standard convention (https://no-color.org). When set to any non-empty value, disables ANSI color output.";
+    readonly type: "string";
+    readonly required: false;
+    readonly example: "1";
+    readonly category: "process";
+}, {
+    readonly name: "AFK_THEME";
+    readonly description: string;
+    readonly type: "string";
+    readonly required: false;
+    readonly default: "dark";
+    readonly example: "light";
+    readonly category: "misc";
+}, {
+    readonly name: "COLORFGBG";
+    readonly description: string;
+    readonly type: "string";
+    readonly required: false;
+    readonly example: "15;0";
+    readonly category: "process";
+}, {
+    readonly name: "COLORTERM";
+    readonly description: string;
+    readonly type: "string";
+    readonly required: false;
+    readonly example: "truecolor";
+    readonly category: "process";
+}];

package/dist/http-client/scrape-diagnostics.d.ts

@@ -0,0 +1,2 @@
+import type { ScrapeResult } from './scrape.js';
+export declare function emptyScrapeMessage(url: string, result: ScrapeResult): string;

package/dist/http-client/scrape.d.ts

@@ -7,11 +7,23 @@ export interface ScrapeOptions {
     signal: AbortSignal;
     lookupFn?: EgressGuardOptions['lookupFn'];
 }
+export interface ScrapeDiagnostics {
+    fetch?: {
+        httpStatus: number;
+        finalUrl: string;
+        contentType: string;
+        rawBodyBytes?: number;
+    };
+    render: 'not-run' | 'failed' | 'succeeded';
+    renderHttpStatus?: number | null;
+    renderFinalUrl?: string;
+}
 export interface ScrapeResult {
     title: string;
     markdown: string;
     finalUrl: string;
     usedRender: boolean;
+    diagnostics?: ScrapeDiagnostics;
     advisory?: string;
 }
 export declare function scrapeToMarkdown(url: string, opts: ScrapeOptions): Promise<ScrapeResult>;