@krischoichoi/channel-telegram 0.6.0

package/lib/api-error.d.ts

@@ -0,0 +1,74 @@
+/**
+ * Structured Telegram Bot API error (execution plan §3.1 / §5.4).
+ *
+ * Telegram's error envelope carries `error_code`/`description` and, for some
+ * failures, a `parameters` object (e.g. `retry_after`, `migrate_to_chat_id`).
+ * The previous code collapsed every non-ok `sendMessage` into a bare
+ * "invalid response" catch-all, which made it impossible to distinguish a
+ * rich-formatting parse failure (→ plain fallback) from a 401/403 (→ never
+ * fallback), a 429 (→ rate-limit retry) or a 5xx/network failure (→ retry).
+ *
+ * `TelegramApiError` preserves the original fields and classifies each error
+ * into a stable `TelegramErrorKind`. It is constructed at the envelope/post
+ * boundary in `HttpTelegramUpstream`, so downstream code (the renderer and the
+ * reply engine) can decide retry / fallback / fail without rebuilding the
+ * classification from raw numbers.
+ */
+import { ChannelError } from '@krischoichoi/channel-core';
+/**
+ * Machine-readable Telegram error class used to drive fallback/retry policy.
+ *
+ * - `format`    — Telegram rejected the formatted payload (bad entity, rich
+ *                 message parse failure). The only kind that may trigger a
+ *                 one-shot plain fallback.
+ * - `rate-limit`— HTTP 429; retry after `parameters.retryAfter`.
+ * - `auth`      — 401 invalid token.
+ * - `permission`— 403 the bot lacks permission / was removed; never fallback.
+ * - `network`   — the HTTP request never got a valid Bot API response (timeout,
+ *                 aborted, transport failure). Not a formatting problem.
+ * - `upstream`  — 5xx / other genuine Telegram-side server errors. Retry.
+ */
+export type TelegramErrorKind = 'format' | 'rate-limit' | 'auth' | 'permission' | 'network' | 'upstream';
+/** Fields Telegram may return in the error `parameters` object. */
+export interface TelegramErrorParameters {
+    retryAfter?: number;
+    migrateToChatId?: number;
+}
+/**
+ * Classify a Telegram `error_code` (plus optional retry/migration parameters)
+ * into a stable `TelegramErrorKind`. This is the single source of truth for
+ * fallback / retry policy; no caller should infer the kind from raw numbers.
+ *
+ * Logic (execution plan §20.9):
+ * - explicit retry_after      -> rate-limit
+ * - 401                       -> auth
+ * - 403                       -> permission
+ * - 429                       -> rate-limit
+ * - 5xx                       -> upstream
+ * - description match addenda  -> format (only for 400-class non-authed)
+ * - other 400 responses        -> upstream (Telegram also uses 400 for chat,
+ *   message, thread, and button errors; those must never trigger fallback)
+ * - unknown / missing code     -> upstream (not enough evidence to fallback)
+ */
+export declare function classifyTelegramError(errorCode: number | undefined, description: string | undefined, parameters?: TelegramErrorParameters): TelegramErrorKind;
+export interface TelegramApiErrorOptions extends ErrorOptions {
+    method?: string;
+    errorCode?: number;
+    description?: string;
+    parameters?: TelegramErrorParameters;
+    kind?: TelegramErrorKind;
+}
+/**
+ * Structured Telegram error. Extends `ChannelError` so existing adapter-level
+ * error mapping (which asserts `ChannelError`) keeps working, while preserving
+ * the Telegram-specific original fields and the stable classification.
+ */
+export declare class TelegramApiError extends ChannelError {
+    readonly method: string;
+    readonly errorCode?: number;
+    readonly description?: string;
+    readonly parameters?: TelegramErrorParameters;
+    readonly kind: TelegramErrorKind;
+    constructor(options?: TelegramApiErrorOptions);
+}
+//# sourceMappingURL=api-error.d.ts.map

package/lib/api-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-error.d.ts","sourceRoot":"","sources":["../src/api-error.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAE1D;;;;;;;;;;;;GAYG;AACH,MAAM,MAAM,iBAAiB,GACzB,QAAQ,GACR,YAAY,GACZ,MAAM,GACN,YAAY,GACZ,SAAS,GACT,UAAU,CAAC;AAEf,mEAAmE;AACnE,MAAM,WAAW,uBAAuB;IACtC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAcD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,qBAAqB,CACnC,SAAS,EAAE,MAAM,GAAG,SAAS,EAC7B,WAAW,EAAE,MAAM,GAAG,SAAS,EAC/B,UAAU,CAAC,EAAE,uBAAuB,GACnC,iBAAiB,CAcnB;AAcD,MAAM,WAAW,uBAAwB,SAAQ,YAAY;IAC3D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,uBAAuB,CAAC;IACrC,IAAI,CAAC,EAAE,iBAAiB,CAAC;CAC1B;AAED;;;;GAIG;AACH,qBAAa,gBAAiB,SAAQ,YAAY;IAChD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,UAAU,CAAC,EAAE,uBAAuB,CAAC;IAC9C,QAAQ,CAAC,IAAI,EAAE,iBAAiB,CAAC;gBAErB,OAAO,GAAE,uBAA4B;CAalD"}

package/lib/api-error.js

@@ -0,0 +1,103 @@
+/**
+ * Structured Telegram Bot API error (execution plan §3.1 / §5.4).
+ *
+ * Telegram's error envelope carries `error_code`/`description` and, for some
+ * failures, a `parameters` object (e.g. `retry_after`, `migrate_to_chat_id`).
+ * The previous code collapsed every non-ok `sendMessage` into a bare
+ * "invalid response" catch-all, which made it impossible to distinguish a
+ * rich-formatting parse failure (→ plain fallback) from a 401/403 (→ never
+ * fallback), a 429 (→ rate-limit retry) or a 5xx/network failure (→ retry).
+ *
+ * `TelegramApiError` preserves the original fields and classifies each error
+ * into a stable `TelegramErrorKind`. It is constructed at the envelope/post
+ * boundary in `HttpTelegramUpstream`, so downstream code (the renderer and the
+ * reply engine) can decide retry / fallback / fail without rebuilding the
+ * classification from raw numbers.
+ */
+import { ChannelError } from '@krischoichoi/channel-core';
+/** Telegram errors Telegram may legitimately return (by description text). */
+const FORMAT_TEXT_MARKERS = [
+    'can\'t parse entities',
+    'entity is too long',
+    'failed to parse',
+    'rich message',
+    'message entities',
+    'unsupported start tag',
+    'unsupported end tag',
+    'unclosed start tag',
+];
+/**
+ * Classify a Telegram `error_code` (plus optional retry/migration parameters)
+ * into a stable `TelegramErrorKind`. This is the single source of truth for
+ * fallback / retry policy; no caller should infer the kind from raw numbers.
+ *
+ * Logic (execution plan §20.9):
+ * - explicit retry_after      -> rate-limit
+ * - 401                       -> auth
+ * - 403                       -> permission
+ * - 429                       -> rate-limit
+ * - 5xx                       -> upstream
+ * - description match addenda  -> format (only for 400-class non-authed)
+ * - other 400 responses        -> upstream (Telegram also uses 400 for chat,
+ *   message, thread, and button errors; those must never trigger fallback)
+ * - unknown / missing code     -> upstream (not enough evidence to fallback)
+ */
+export function classifyTelegramError(errorCode, description, parameters) {
+    if (parameters?.retryAfter !== undefined)
+        return 'rate-limit';
+    if (errorCode === 401)
+        return 'auth';
+    if (errorCode === 403)
+        return 'permission';
+    if (errorCode === 429)
+        return 'rate-limit';
+    if (errorCode !== undefined && errorCode >= 500)
+        return 'upstream';
+    if (errorCode === 400 && description) {
+        const lower = description.toLowerCase();
+        if (FORMAT_TEXT_MARKERS.some((marker) => lower.includes(marker)))
+            return 'format';
+        return 'upstream';
+    }
+    if (errorCode === 400)
+        return 'upstream';
+    // No usable code / unexpected shape — treat as an upstream-level failure.
+    return 'upstream';
+}
+/** Map the resolved kind to a stable, readable message fragment. */
+function kindLabel(kind) {
+    switch (kind) {
+        case 'format': return 'format';
+        case 'rate-limit': return 'rate-limit';
+        case 'auth': return 'auth';
+        case 'permission': return 'permission';
+        case 'network': return 'network';
+        case 'upstream': return 'upstream';
+    }
+}
+/**
+ * Structured Telegram error. Extends `ChannelError` so existing adapter-level
+ * error mapping (which asserts `ChannelError`) keeps working, while preserving
+ * the Telegram-specific original fields and the stable classification.
+ */
+export class TelegramApiError extends ChannelError {
+    method;
+    errorCode;
+    description;
+    parameters;
+    kind;
+    constructor(options = {}) {
+        const kind = options.kind ?? classifyTelegramError(options.errorCode, options.description, options.parameters);
+        const method = options.method ?? 'telegram';
+        const detail = options.description ?? 'unknown error';
+        const code = kind === 'auth' ? 'CHANNEL_AUTH_FAILED' : 'CHANNEL_ERROR';
+        super(code, `telegram ${method} failed (${kindLabel(kind)}): ${detail}`, options);
+        this.name = 'TelegramApiError';
+        this.method = method;
+        this.errorCode = options.errorCode;
+        this.description = options.description;
+        this.parameters = options.parameters;
+        this.kind = kind;
+    }
+}
+//# sourceMappingURL=api-error.js.map

package/lib/api-error.js.map

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

package/lib/config.d.ts

@@ -0,0 +1,115 @@
+/**
+ * Telegram adapter configuration (Schemastery).
+ *
+ * Every deployment-tunable parameter is configurable here — no hardcoded
+ * deployment constants. The Bot API token is a secret: config carries only its
+ * credential reference (`tokenRef`, default `TELEGRAM_BOT_TOKEN`); the real
+ * value is resolved through `ctx.credentials` at startup and never lives in
+ * profile config, logs, or fixtures.
+ *
+ * Migration note: legacy configs may still carry a plaintext `token`. The field
+ * is deprecated and hidden; the plugin's apply() migrates it into
+ * `ctx.credentials` under `tokenRef` exactly once and strips the plaintext.
+ */
+import Schema from '@deepseek-ai/schemastery';
+import type { Volatile } from '@deepseek-ai/cordis';
+/** Default credential reference name for the Telegram Bot API token. */
+export declare const TELEGRAM_BOT_TOKEN_REF = "TELEGRAM_BOT_TOKEN";
+export interface TelegramReconnectConfig {
+    enabled: boolean;
+    baseDelayMs: number;
+    maxDelayMs: number;
+    maxRetries: number;
+}
+export interface TelegramDedupConfig {
+    enabled: boolean;
+    windowMs: number;
+}
+export interface TelegramStreamingConfig {
+    /**
+     * Whether incremental outbound streaming is enabled. When false, the reply
+     * router falls back to the buffered send-once strategy.
+     */
+    enabled: boolean;
+    /** Text sent as the initial placeholder while the model is working. */
+    placeholder: string;
+}
+/** Telegram's typing action expires after a few seconds, so it is refreshed. */
+export interface TelegramTypingConfig {
+    enabled: boolean;
+    refreshMs: number;
+}
+/**
+ * Outbound formatting policy (plan §5.1). The adapter's minimum supported
+ * upstream is Bot API 10.2, so `auto` always selects Rich Markdown.
+ */
+export interface TelegramFormattingConfig {
+    /**
+     * Output renderer:
+     * - `auto`         -> Rich Markdown
+     * - `rich-markdown`-> sendRichMessage / sendRichMessageDraft
+     * - `html`         -> sendMessage(parse_mode=HTML) via the safe HTML renderer
+     * - `markdown-v2`  -> expert-compat mode (fully escaped, never raw Agent MD)
+     * - `plain`        -> no formatting parsed
+     */
+    mode: 'auto' | 'rich-markdown' | 'html' | 'markdown-v2' | 'plain';
+    /**
+     * What to fall back to when the selected mode fails with a *format* error.
+     * Only `plain` is supported today; 401/403 / 429 / network / 5xx never
+     * trigger this fallback (plan §20.9).
+     */
+    fallback: 'plain';
+}
+export interface TelegramConfig {
+    enabled: boolean;
+    /** Account id within the telegram channel (defaults to 'main'). */
+    accountId: string;
+    /** Base URL of the Telegram Bot API. */
+    baseUrl: string;
+    /**
+     * Credential reference name for the Bot API token (resolved via
+     * `ctx.credentials`). Defaults to `TELEGRAM_BOT_TOKEN_REF`. Only the
+     * reference name lives in config — never the token itself.
+     */
+    tokenRef: string;
+    /**
+     * @deprecated Migration-only compatibility field. Legacy plaintext configs
+     * still parse; apply() migrates the value into `ctx.credentials` under
+     * `tokenRef` and deletes this field. New configs must use `tokenRef`.
+     */
+    token?: string;
+    /** Per-request timeout. */
+    timeoutMs: number;
+    /** Long-poll hang time for one getUpdates cycle. */
+    longPollTimeoutMs: number;
+    reconnect: TelegramReconnectConfig;
+    dedup: TelegramDedupConfig;
+    streaming: TelegramStreamingConfig;
+    typing: TelegramTypingConfig;
+    /** Outbound formatting / rich rendering policy. */
+    formatting: TelegramFormattingConfig;
+    /** Hard byte cap for one inbound media download (image / document). */
+    maxDownloadBytes: number;
+}
+/**
+ * Activation-time config shape (Harness 0.2.0): every volatile field resolves
+ * to a `Volatile<T>` live handle instead of a plain value. `apply()` unwraps
+ * these once via `resolveVolatileConfig` into a plain `TelegramConfig`.
+ */
+export interface TelegramConfigLive {
+    enabled: Volatile<boolean>;
+    accountId: Volatile<string>;
+    baseUrl: Volatile<string>;
+    tokenRef: string;
+    token?: string;
+    timeoutMs: Volatile<number>;
+    longPollTimeoutMs: Volatile<number>;
+    reconnect: Volatile<TelegramReconnectConfig>;
+    dedup: Volatile<TelegramDedupConfig>;
+    streaming: Volatile<TelegramStreamingConfig>;
+    typing: Volatile<TelegramTypingConfig>;
+    formatting: Volatile<TelegramFormattingConfig>;
+    maxDownloadBytes: Volatile<number>;
+}
+export declare const Config: Schema<TelegramConfigLive>;
+//# sourceMappingURL=config.d.ts.map

package/lib/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,MAAM,MAAM,0BAA0B,CAAC;AAC9C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAEpD,wEAAwE;AACxE,eAAO,MAAM,sBAAsB,uBAAuB,CAAC;AAE3D,MAAM,WAAW,uBAAuB;IACtC,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,uBAAuB;IACtC;;;OAGG;IACH,OAAO,EAAE,OAAO,CAAC;IACjB,uEAAuE;IACvE,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,gFAAgF;AAChF,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;GAGG;AACH,MAAM,WAAW,wBAAwB;IACvC;;;;;;;OAOG;IACH,IAAI,EAAE,MAAM,GAAG,eAAe,GAAG,MAAM,GAAG,aAAa,GAAG,OAAO,CAAC;IAClE;;;;OAIG;IACH,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,OAAO,CAAC;IACjB,mEAAmE;IACnE,SAAS,EAAE,MAAM,CAAC;IAClB,wCAAwC;IACxC,OAAO,EAAE,MAAM,CAAC;IAChB;;;;OAIG;IACH,QAAQ,EAAE,MAAM,CAAC;IACjB;;;;OAIG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,2BAA2B;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,oDAAoD;IACpD,iBAAiB,EAAE,MAAM,CAAC;IAC1B,SAAS,EAAE,uBAAuB,CAAC;IACnC,KAAK,EAAE,mBAAmB,CAAC;IAC3B,SAAS,EAAE,uBAAuB,CAAC;IACnC,MAAM,EAAE,oBAAoB,CAAC;IAC7B,mDAAmD;IACnD,UAAU,EAAE,wBAAwB,CAAC;IACrC,uEAAuE;IACvE,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED;;;;GAIG;AACH,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAC;IAC3B,SAAS,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;IAC5B,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;IAC5B,iBAAiB,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;IACpC,SAAS,EAAE,QAAQ,CAAC,uBAAuB,CAAC,CAAC;IAC7C,KAAK,EAAE,QAAQ,CAAC,mBAAmB,CAAC,CAAC;IACrC,SAAS,EAAE,QAAQ,CAAC,uBAAuB,CAAC,CAAC;IAC7C,MAAM,EAAE,QAAQ,CAAC,oBAAoB,CAAC,CAAC;IACvC,UAAU,EAAE,QAAQ,CAAC,wBAAwB,CAAC,CAAC;IAC/C,gBAAgB,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;CACpC;AAMD,eAAO,MAAM,MAAM,EA6CF,MAAM,CAAC,kBAAkB,CAAC,CAAC"}

package/lib/config.js

@@ -0,0 +1,67 @@
+/**
+ * Telegram adapter configuration (Schemastery).
+ *
+ * Every deployment-tunable parameter is configurable here — no hardcoded
+ * deployment constants. The Bot API token is a secret: config carries only its
+ * credential reference (`tokenRef`, default `TELEGRAM_BOT_TOKEN`); the real
+ * value is resolved through `ctx.credentials` at startup and never lives in
+ * profile config, logs, or fixtures.
+ *
+ * Migration note: legacy configs may still carry a plaintext `token`. The field
+ * is deprecated and hidden; the plugin's apply() migrates it into
+ * `ctx.credentials` under `tokenRef` exactly once and strips the plaintext.
+ */
+import Schema from '@deepseek-ai/schemastery';
+/** Default credential reference name for the Telegram Bot API token. */
+export const TELEGRAM_BOT_TOKEN_REF = 'TELEGRAM_BOT_TOKEN';
+// The runtime schema is genuine Schemastery (validation happens at the Loader
+// boundary); the annotation records the activation-time output shape. The cast
+// is required because Schemastery's inferred ObjectT models per-field optionality
+// more precisely than the hand-written `TelegramConfigLive` alias.
+export const Config = Schema.object({
+    // Harness 0.2.0 settings model: fields the control plane / settings page may
+    // write at runtime are declared `.volatile()` — they surface on the
+    // auto-generated settings form, `ctx.settings.update(entryId, patch)` accepts
+    // exactly these paths, and at activation they resolve to `Volatile<T>`
+    // handles (unwrapped by `resolveVolatileConfig` in definition.ts / apply()).
+    enabled: Schema.boolean().default(true).volatile(),
+    accountId: Schema.string().default('main').volatile(),
+    baseUrl: Schema.string().default('https://api.telegram.org').volatile(),
+    // Credential reference name only — never the secret value itself.
+    tokenRef: Schema.string().default(TELEGRAM_BOT_TOKEN_REF),
+    // DEPRECATED migration-only legacy plaintext field: kept so old configs still
+    // parse. apply() migrates its value to credentials once and deletes it.
+    token: Schema.string().hidden(),
+    timeoutMs: Schema.natural().default(30000).volatile(),
+    longPollTimeoutMs: Schema.natural().default(25000).volatile(),
+    reconnect: Schema.object({
+        enabled: Schema.boolean().default(true),
+        baseDelayMs: Schema.natural().default(1000),
+        maxDelayMs: Schema.natural().default(30000),
+        maxRetries: Schema.natural().default(10),
+    }).default({}).volatile(),
+    dedup: Schema.object({
+        enabled: Schema.boolean().default(true),
+        windowMs: Schema.natural().default(5000),
+    }).default({}).volatile(),
+    streaming: Schema.object({
+        enabled: Schema.boolean().default(true),
+        placeholder: Schema.string().default('…'),
+    }).default({}).volatile(),
+    typing: Schema.object({
+        enabled: Schema.boolean().default(true),
+        refreshMs: Schema.natural().min(1000).default(4000),
+    }).default({}).volatile(),
+    formatting: Schema.object({
+        mode: Schema.union([
+            Schema.const('auto'),
+            Schema.const('rich-markdown'),
+            Schema.const('html'),
+            Schema.const('markdown-v2'),
+            Schema.const('plain'),
+        ]).default('auto'),
+        fallback: Schema.const('plain').default('plain'),
+    }).default({}).volatile(),
+    maxDownloadBytes: Schema.natural().default(20 * 1024 * 1024).volatile(),
+});
+//# sourceMappingURL=config.js.map

package/lib/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,MAAM,MAAM,0BAA0B,CAAC;AAG9C,wEAAwE;AACxE,MAAM,CAAC,MAAM,sBAAsB,GAAG,oBAAoB,CAAC;AAyG3D,8EAA8E;AAC9E,+EAA+E;AAC/E,kFAAkF;AAClF,mEAAmE;AACnE,MAAM,CAAC,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;IAClC,6EAA6E;IAC7E,oEAAoE;IACpE,8EAA8E;IAC9E,uEAAuE;IACvE,6EAA6E;IAC7E,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE;IAClD,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,QAAQ,EAAE;IACrD,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,0BAA0B,CAAC,CAAC,QAAQ,EAAE;IACvE,kEAAkE;IAClE,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,sBAAsB,CAAC;IACzD,8EAA8E;IAC9E,wEAAwE;IACxE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,MAAM,EAAE;IAC/B,SAAS,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,QAAQ,EAAE;IACrD,iBAAiB,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,QAAQ,EAAE;IAC7D,SAAS,EAAE,MAAM,CAAC,MAAM,CAAC;QACvB,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC;QACvC,WAAW,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC;QAC3C,UAAU,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;QAC3C,UAAU,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC;KACzC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,QAAQ,EAAE;IACzB,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC;QACnB,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC;QACvC,QAAQ,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC;KACzC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,QAAQ,EAAE;IACzB,SAAS,EAAE,MAAM,CAAC,MAAM,CAAC;QACvB,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC;QACvC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC;KAC1C,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,QAAQ,EAAE;IACzB,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC;QACpB,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC;QACvC,SAAS,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC;KACpD,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,QAAQ,EAAE;IACzB,UAAU,EAAE,MAAM,CAAC,MAAM,CAAC;QACxB,IAAI,EAAE,MAAM,CAAC,KAAK,CAAC;YACjB,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC;YACpB,MAAM,CAAC,KAAK,CAAC,eAAe,CAAC;YAC7B,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC;YACpB,MAAM,CAAC,KAAK,CAAC,aAAa,CAAC;YAC3B,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC;SACtB,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC;QAClB,QAAQ,EAAE,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC;KACjD,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,QAAQ,EAAE;IACzB,gBAAgB,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,EAAE,GAAG,IAAI,GAAG,IAAI,CAAC,CAAC,QAAQ,EAAE;CACxE,CAA0C,CAAC"}

package/lib/definition.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Telegram ChannelDefinition — the description of the telegram channel exposed
+ * to the Channel Control Plane.
+ *
+ * The control plane drives setup, configured-state reporting and adapter
+ * instantiation purely through this object, never through per-channel
+ * conditionals.
+ *
+ * - `setup.fields`   — a single secret field (`token`) backed by the
+ *                       `TELEGRAM_BOT_TOKEN_REF` credential reference. The real
+ *                       token is only ever written through the credentials seam.
+ * - `getConfiguredState` — configured when the token credential exists.
+ * - `saveConfig`     — merges only non-secret keys (behavioural tuning) into an
+ *                       internal mutable snapshot used by createAdapter. Secret
+ *                       fields are rejected upstream by the control plane.
+ * - `createAdapter`  — resolves `tokenRef` via the injected credentials seam
+ *                       and throws a stable error when it is missing.
+ * - `setup.setupUrl` — points at @BotFather, where operators create a bot and
+ *                       obtain the Bot API token.
+ *
+ * Fully offline-testable: inject a fake credentials seam and a fake transport
+ * via `deps` — no network, no host.
+ */
+import type { ChannelDefinition } from '@krischoichoi/channel-control';
+import type { TelegramConfig } from './config.js';
+import { type TelegramAdapterDeps } from './adapter.js';
+/**
+ * Structural credential seam used by the definition. Mirrors the tiny slice of
+ * `ctx.credentials` the control plane needs; injected so the definition stays
+ * host-agnostic and offline-testable. Resolution is per call and must not be
+ * cached across calls.
+ */
+export interface TelegramCredentialSeam {
+    resolve(ref: string): Promise<{
+        value: string;
+        source: string;
+    } | undefined>;
+    describe(ref: string): Promise<{
+        configured: boolean;
+        source?: string;
+        writable: boolean;
+    }>;
+    set(ref: string, value: string): Promise<void>;
+}
+export interface CreateTelegramDefinitionOptions {
+    config: TelegramConfig;
+    deps?: TelegramAdapterDeps;
+    /** Injected credentials seam (wraps ctx.credentials in apply()). */
+    credentials: TelegramCredentialSeam;
+    /** Durable store for the enabled intent (doc §21) when the host provides one. */
+    persistEnabled?: (enabled: boolean) => Promise<void>;
+}
+/**
+ * Build the telegram ChannelDefinition for the control plane. Returns a fresh
+ * object each call (cheap) so a plugin can register it against any control
+ * instance.
+ */
+export declare function createTelegramDefinition(options: CreateTelegramDefinitionOptions): ChannelDefinition;
+//# sourceMappingURL=definition.d.ts.map

package/lib/definition.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"definition.d.ts","sourceRoot":"","sources":["../src/definition.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,OAAO,KAAK,EACV,iBAAiB,EAGlB,MAAM,+BAA+B,CAAC;AAEvC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAGlD,OAAO,EAAmB,KAAK,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAEzE;;;;;GAKG;AACH,MAAM,WAAW,sBAAsB;IACrC,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG,SAAS,CAAC,CAAC;IAC7E,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,UAAU,EAAE,OAAO,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;IAC5F,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAChD;AAED,MAAM,WAAW,+BAA+B;IAC9C,MAAM,EAAE,cAAc,CAAC;IACvB,IAAI,CAAC,EAAE,mBAAmB,CAAC;IAC3B,oEAAoE;IACpE,WAAW,EAAE,sBAAsB,CAAC;IACpC,iFAAiF;IACjF,cAAc,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACtD;AAsDD;;;;GAIG;AACH,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,+BAA+B,GACvC,iBAAiB,CAyGnB"}

package/lib/definition.js

@@ -0,0 +1,158 @@
+import { ControlError } from '@krischoichoi/channel-control';
+import { resolveVolatileConfig } from '@krischoichoi/channel-core';
+import { Config, TELEGRAM_BOT_TOKEN_REF } from './config.js';
+import { TelegramAdapter } from './adapter.js';
+/** Allowed non-secret nested sub-config keys merged by saveConfig. */
+const NESTED_KEYS = ['reconnect', 'dedup', 'streaming', 'typing', 'formatting'];
+/** Allowed non-secret top-level scalar keys merged by saveConfig. */
+const SCALAR_KEYS = [
+    'accountId',
+    'baseUrl',
+    'timeoutMs',
+    'longPollTimeoutMs',
+    'maxDownloadBytes',
+];
+/** Deep-copy a TelegramConfig into an independent mutable snapshot. */
+function snapshotOf(config) {
+    // Harness 0.2.0: volatile fields arrive as `Volatile<T>` handles; unwrap
+    // them once so the snapshot (and everything reading it) sees plain values.
+    const plain = resolveVolatileConfig(config);
+    return {
+        ...plain,
+        reconnect: { ...plain.reconnect },
+        dedup: { ...plain.dedup },
+        streaming: { ...plain.streaming },
+        typing: { ...plain.typing },
+        formatting: { ...plain.formatting },
+    };
+}
+function applyScalarPatch(snapshot, key, value) {
+    switch (key) {
+        case 'accountId':
+            if (typeof value === 'string' && value)
+                snapshot.accountId = value;
+            return;
+        case 'baseUrl':
+            if (typeof value === 'string' && value)
+                snapshot.baseUrl = value;
+            return;
+        case 'timeoutMs':
+            if (typeof value === 'number' && Number.isFinite(value) && value > 0) {
+                snapshot.timeoutMs = Math.floor(value);
+            }
+            return;
+        case 'longPollTimeoutMs':
+            if (typeof value === 'number' && Number.isFinite(value) && value > 0) {
+                snapshot.longPollTimeoutMs = Math.floor(value);
+            }
+            return;
+        case 'maxDownloadBytes':
+            if (typeof value === 'number' && Number.isFinite(value) && value > 0) {
+                snapshot.maxDownloadBytes = Math.floor(value);
+            }
+            return;
+    }
+}
+/**
+ * Build the telegram ChannelDefinition for the control plane. Returns a fresh
+ * object each call (cheap) so a plugin can register it against any control
+ * instance.
+ */
+export function createTelegramDefinition(options) {
+    const credentials = options.credentials;
+    const deps = options.deps ?? {};
+    // Mutable snapshot: saveConfig merges non-secret patches into this; the same
+    // object feeds getConfiguredState + createAdapter so both always agree.
+    const state = snapshotOf(options.config);
+    const tokenRef = () => state.tokenRef || TELEGRAM_BOT_TOKEN_REF;
+    const setup = {
+        fields: [
+            {
+                name: 'token',
+                kind: 'secret',
+                secret: true,
+                configured: false,
+                writable: true,
+                ref: tokenRef(),
+            },
+        ],
+        authMethods: ['credentials'],
+        setupUrl: 'https://t.me/BotFather',
+    };
+    const configuredState = async () => {
+        const described = await credentials.describe(tokenRef());
+        return {
+            configured: described.configured,
+            fields: {
+                token: {
+                    configured: described.configured,
+                    writable: described.writable,
+                    source: described.source,
+                },
+            },
+        };
+    };
+    const saveConfig = async (patch) => {
+        for (const key of NESTED_KEYS) {
+            const value = patch[key];
+            if (value && typeof value === 'object') {
+                Object.assign(state[key], value);
+            }
+        }
+        for (const key of SCALAR_KEYS) {
+            if (patch[key] !== undefined) {
+                applyScalarPatch(state, key, patch[key]);
+            }
+        }
+        if (patch.enabled !== undefined)
+            state.enabled = Boolean(patch.enabled);
+        // `token` / `tokenRef` are secret fields and are rejected by the control
+        // plane before reaching this definition; nothing to persist here.
+    };
+    const restoreConfig = async (saved) => {
+        // Schemastery validates and normalizes the persisted control-plane value.
+        const restored = snapshotOf(Config(saved));
+        Object.assign(state, restored);
+        state.reconnect = restored.reconnect;
+        state.dedup = restored.dedup;
+        state.streaming = restored.streaming;
+        state.typing = restored.typing;
+        state.formatting = restored.formatting;
+    };
+    const createAdapter = async () => {
+        const resolved = await credentials.resolve(tokenRef());
+        const token = resolved?.value;
+        if (!token) {
+            throw new ControlError('CONTROL_ERROR', `telegram credential "${tokenRef()}" is not configured`);
+        }
+        return new TelegramAdapter(state, { ...deps, token });
+    };
+    return {
+        id: 'telegram',
+        get enabled() {
+            return state.enabled;
+        },
+        async setEnabled(enabled) {
+            state.enabled = enabled;
+            await options.persistEnabled?.(enabled);
+        },
+        setup,
+        getConfiguredState: configuredState,
+        saveConfig,
+        snapshotConfig: () => snapshotOf(state),
+        restoreConfig,
+        createAdapter,
+        autoStart: true,
+        // Telegram entities are mapped to a reliable mentionedBot activation fact;
+        // new group rules default to requiring an explicit bot mention.
+        access: {
+            directMessages: true,
+            groups: true,
+            mentions: true,
+            ownerDiscovery: 'claim',
+            identityLabels: { user: 'Telegram User ID', group: 'Telegram Chat ID' },
+            defaults: { requireMention: true },
+        },
+    };
+}
+//# sourceMappingURL=definition.js.map

package/lib/definition.js.map

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