charness 0.0.0-stage → 3.1.0

package/dist/openCodeSessionTitle.js

@@ -0,0 +1,84 @@
+"use strict";
+/**
+ * Pure helpers for naming bot-created OpenCode sessions.
+ *
+ * Primary mechanism (R1, verified live 2026-06-04): a session created WITHOUT
+ * an explicit `title` lets opencode auto-name it from the first prompt's LLM
+ * turn — nicer than any raw snippet, and it ignores the glued thread-context
+ * preamble. A session created WITH a title is treated as user-set and never
+ * auto-renamed, so the bot only passes a title for the explicit `/opencode
+ * <args>` case.
+ *
+ * Fallback mechanism: if auto-title never lands (the title stays the bare
+ * `New session - <ts>` placeholder — e.g. the server failed to generate one),
+ * the adapter renames the session itself via `PATCH /session/:id {title}` on
+ * the first MEANINGFUL prompt, using {@link buildSessionTitleSnippet}. The
+ * snippet always derives from the RAW user text (the caller strips the
+ * preamble first), so it can never carry the service header.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.sessionTitleSnippetMaxLength = exports.meaningfulPromptMinLength = void 0;
+exports.checkIsMeaningfulPrompt = checkIsMeaningfulPrompt;
+exports.buildSessionTitleSnippet = buildSessionTitleSnippet;
+exports.checkIsPlaceholderTitle = checkIsPlaceholderTitle;
+const threadContextPreamble_1 = require("./threadContextPreamble");
+/**
+ * Minimum length (chars, after trim) for a prompt to count as "meaningful"
+ * enough to name a session after. Short acknowledgements ("да", "go", "ok")
+ * sit below it and leave the name to be decided by a later, substantial
+ * prompt. 10 is the locked value from the plan's IDEAL.
+ */
+exports.meaningfulPromptMinLength = 10;
+/** Max length (chars) of a fallback snippet title; longer text is truncated. */
+exports.sessionTitleSnippetMaxLength = 60;
+/** Marker appended when a snippet is truncated, so the cut is visible. */
+const truncationEllipsis = '…';
+/**
+ * Placeholder titles opencode assigns to a session that has no real name yet:
+ * the `New session - <ISO timestamp>` form (untitled create) and the legacy
+ * `Telegram session <key>` the bot used to set. A title matching either is
+ * "not yet meaningfully named", so the fallback rename may overwrite it; any
+ * other title is a real name (auto-generated or user-set) and is left alone.
+ */
+const untitledPlaceholderPrefix = 'New session - ';
+const legacyBotTitlePrefix = 'Telegram session ';
+/**
+ * @description Whether a forwarded prompt is substantial enough to name a
+ * session after. A slash command (`/clear`, `/model …`) is a control token,
+ * never a name source; anything shorter than {@link meaningfulPromptMinLength}
+ * is a throwaway acknowledgement. The argument MUST be the RAW user text —
+ * strip the thread-context preamble before calling (see
+ * {@link buildSessionTitleSnippet} for the same requirement).
+ */
+function checkIsMeaningfulPrompt(rawText) {
+    const trimmed = rawText.trim();
+    if (trimmed.startsWith('/'))
+        return false;
+    return trimmed.length >= exports.meaningfulPromptMinLength;
+}
+/**
+ * @description Build a fallback session-title snippet from the first
+ * meaningful prompt. Collapses all internal whitespace (incl. newlines) to
+ * single spaces, trims, and truncates to {@link sessionTitleSnippetMaxLength}
+ * with an ellipsis. The thread-context preamble is stripped first so the title
+ * reflects what the USER said, never the bot's glue.
+ */
+function buildSessionTitleSnippet(rawText) {
+    const withoutPreamble = (0, threadContextPreamble_1.stripThreadContextPreamble)(rawText);
+    const collapsed = withoutPreamble.replace(/\s+/g, ' ').trim();
+    if (collapsed.length <= exports.sessionTitleSnippetMaxLength)
+        return collapsed;
+    // Reserve one char for the ellipsis so the result never exceeds the cap.
+    return collapsed.slice(0, exports.sessionTitleSnippetMaxLength - 1).trimEnd() + truncationEllipsis;
+}
+/**
+ * @description Whether `title` is one of opencode's "no real name yet"
+ * placeholders, so the fallback rename is allowed to overwrite it. A real
+ * auto-generated or user-set title returns `false` and is left untouched.
+ */
+function checkIsPlaceholderTitle(title) {
+    if (!title)
+        return true;
+    return title.startsWith(untitledPlaceholderPrefix) || title.startsWith(legacyBotTitlePrefix);
+}
+//# sourceMappingURL=openCodeSessionTitle.js.map

package/dist/openCodeSessionTitle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"openCodeSessionTitle.js","sourceRoot":"","sources":["../src/openCodeSessionTitle.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;GAgBG;;;AAoCH,0DAIC;AASD,4DAMC;AAOD,0DAGC;AA/DD,mEAAqE;AAErE;;;;;GAKG;AACU,QAAA,yBAAyB,GAAG,EAAE,CAAC;AAE5C,gFAAgF;AACnE,QAAA,4BAA4B,GAAG,EAAE,CAAC;AAE/C,0EAA0E;AAC1E,MAAM,kBAAkB,GAAG,GAAG,CAAC;AAE/B;;;;;;GAMG;AACH,MAAM,yBAAyB,GAAG,gBAAgB,CAAC;AACnD,MAAM,oBAAoB,GAAG,mBAAmB,CAAC;AAEjD;;;;;;;GAOG;AACH,SAAgB,uBAAuB,CAAC,OAAe;IACrD,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;IAC/B,IAAI,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,OAAO,KAAK,CAAC;IAC1C,OAAO,OAAO,CAAC,MAAM,IAAI,iCAAyB,CAAC;AACrD,CAAC;AAED;;;;;;GAMG;AACH,SAAgB,wBAAwB,CAAC,OAAe;IACtD,MAAM,eAAe,GAAG,IAAA,kDAA0B,EAAC,OAAO,CAAC,CAAC;IAC5D,MAAM,SAAS,GAAG,eAAe,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;IAC9D,IAAI,SAAS,CAAC,MAAM,IAAI,oCAA4B;QAAE,OAAO,SAAS,CAAC;IACvE,yEAAyE;IACzE,OAAO,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,oCAA4B,GAAG,CAAC,CAAC,CAAC,OAAO,EAAE,GAAG,kBAAkB,CAAC;AAC7F,CAAC;AAED;;;;GAIG;AACH,SAAgB,uBAAuB,CAAC,KAAyB;IAC/D,IAAI,CAAC,KAAK;QAAE,OAAO,IAAI,CAAC;IACxB,OAAO,KAAK,CAAC,UAAU,CAAC,yBAAyB,CAAC,IAAI,KAAK,CAAC,UAAU,CAAC,oBAAoB,CAAC,CAAC;AAC/F,CAAC"}

package/dist/outputTrace.d.ts

@@ -0,0 +1,108 @@
+import type { SessionKey } from './sessionKey';
+/**
+ * @description Snapshot of the persisted trace toggle. Mirrors what is stored
+ * in `state.json` so the bot can read the current config back for `/trace`
+ * status replies and re-seed this module after a restart.
+ */
+export interface TraceConfig {
+    allThreads: boolean;
+    threadKeys: string[];
+}
+/**
+ * @description Replace the in-memory trace toggle from persisted state. Called
+ * once at boot (seed from `state.json`) and again on every `/trace` mutation so
+ * the writer and the persisted record never drift. Lifecycle-independent: only
+ * `/trace` touches it — session stop/new/quit/resume/unbind never do.
+ */
+export declare function setTraceConfig(config: TraceConfig): void;
+/** Current trace toggle as a plain snapshot — for `/trace` status + persistence. */
+export declare function getTraceConfig(): TraceConfig;
+/**
+ * @description Whether ANY tracing is active (all-flag set OR at least one
+ * thread opted in). The single fast-path gate every hook hits first — when it
+ * returns false the hook does no work beyond this check.
+ */
+export declare function checkIsTracingActive(): boolean;
+/**
+ * @description Whether a specific thread's events should be recorded:
+ * the all-flag covers everything, otherwise the thread must be opted in.
+ */
+export declare function checkIsThreadTraced(key: SessionKey): boolean;
+/**
+ * @description Delete trace buckets older than the shared 6h retention window
+ * (the hourly `output-trace-*.jsonl` files + their `.1` siblings). Best-effort;
+ * called at boot and on the file-sweep interval by the bot's janitor.
+ */
+export declare function pruneTraceBuckets(nowMs: number): Promise<void>;
+/**
+ * @description Truncate `text` to a greppable one-liner without splitting a
+ * UTF-16 surrogate pair. A naive `slice(0, 120)` can cut between the high and
+ * low half of an emoji, leaving a lone high surrogate that serialises to an
+ * unpaired `\ud83d` and breaks `jq` consumers of the trace file (observed in
+ * the real trace). If the slice ends on a high surrogate we drop that trailing
+ * half so only whole code points survive.
+ */
+export declare function createTracePreview(text: string): string;
+/**
+ * @description Filesystem + timer seams the buffered writer depends on. Tests
+ * inject fakes so they can assert flush ordering / threshold / rotation /
+ * exit-flush deterministically without real IO or wall-clock timers.
+ */
+export interface TraceWriterDeps {
+    appendFile(filePath: string, data: string): Promise<void>;
+    appendFileSync(filePath: string, data: string): void;
+    mkdir(dirPath: string): Promise<void>;
+    /** File size in bytes, or null if the file does not exist. */
+    getFileSize(filePath: string): Promise<number | null>;
+    rename(fromPath: string, toPath: string): Promise<void>;
+    setTimer(callback: () => void, ms: number): unknown;
+    clearTimer(handle: unknown): void;
+}
+/**
+ * @description Override the writer's fs/timer seams (tests only). Also resets
+ * the buffer + flush state so each test starts clean. Returns a restore fn.
+ */
+export declare function configureTraceWriterForTests(deps: Partial<TraceWriterDeps>): () => void;
+/**
+ * @description Best-effort SYNCHRONOUS flush of whatever is still buffered.
+ * Registered on `process.on('exit')` — exit handlers can only do sync work, so
+ * the async writer would otherwise lose the final unflushed window on shutdown.
+ */
+export declare function flushTraceBufferSyncOnExit(): void;
+export interface RecvTraceFields {
+    updateType: string;
+    updateId: number;
+    fromId?: number;
+    chatId?: number;
+    threadId?: number;
+    preview?: string;
+    /** Telegram-side `message.date` in seconds — lets us compute receive latency. */
+    tgDateSec?: number;
+}
+/**
+ * @description Record an incoming update the moment the first middleware sees
+ * it — only if the update's own thread is traced. The key is built the same way
+ * routing does (`{chatId, threadId}`); a missing thread id maps to the General
+ * topic's `threadId: 1` so it filters consistently. When `chatId` is absent
+ * (rare service updates) we can't derive a key, so it records only under the
+ * all-flag.
+ */
+export declare function traceRecvUpdate(fields: RecvTraceFields): void;
+/** Record an adapter `output`/`status`/`thinking`/`toolResult` event entering the bot's send path. */
+export declare function traceAgentEmit(event: 'output' | 'status' | 'thinking' | 'toolResult', key: SessionKey, text: string): void;
+/**
+ * @description Structural view of `Telegram`/`ApiClient` — just enough to wrap
+ * `callApi`. Method syntax keeps `Telegram` assignable (bivariant params), and
+ * lets unit tests pass a plain fake instead of booting Telegraf.
+ */
+export interface CallApiHost {
+    callApi(method: string, payload: object, options?: object): Promise<object | boolean | number | string>;
+}
+/**
+ * @description Wrap `telegram.callApi` so every outgoing Bot API call is
+ * traced with its outcome. Installed unconditionally at boot — when tracing is
+ * off each call costs one boolean check. The wrap sits BELOW `enqueueSend`'s
+ * queue/bucket/429-retry layers, so each real HTTP attempt traces separately.
+ */
+export declare function installCallApiTrace(host: CallApiHost): void;
+//# sourceMappingURL=outputTrace.d.ts.map

package/dist/outputTrace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"outputTrace.d.ts","sourceRoot":"","sources":["../src/outputTrace.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AA8D/C;;;;GAIG;AACH,MAAM,WAAW,WAAW;IAC1B,UAAU,EAAE,OAAO,CAAC;IACpB,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI,CAIxD;AAED,oFAAoF;AACpF,wBAAgB,cAAc,IAAI,WAAW,CAE5C;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,IAAI,OAAO,CAE9C;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,UAAU,GAAG,OAAO,CAE5D;AAcD;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE9D;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAQvD;AAMD;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1D,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACrD,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACtC,8DAA8D;IAC9D,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IACtD,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACxD,QAAQ,CAAC,QAAQ,EAAE,MAAM,IAAI,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC;IACpD,UAAU,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI,CAAC;CACnC;AAgCD;;;GAGG;AACH,wBAAgB,4BAA4B,CAAC,IAAI,EAAE,OAAO,CAAC,eAAe,CAAC,GAAG,MAAM,IAAI,CAavF;AAsDD;;;;GAIG;AACH,wBAAgB,0BAA0B,IAAI,IAAI,CAcjD;AAiBD,MAAM,WAAW,eAAe;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,iFAAiF;IACjF,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,eAAe,GAAG,IAAI,CAW7D;AAcD,sGAAsG;AACtG,wBAAgB,cAAc,CAAC,KAAK,EAAE,QAAQ,GAAG,QAAQ,GAAG,UAAU,GAAG,YAAY,EAAE,GAAG,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAQ1H;AAyED;;;;GAIG;AACH,MAAM,WAAW,WAAW;IAC1B,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,CAAC,CAAC;CACzG;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,WAAW,GAAG,IAAI,CA4B3D"}

package/dist/outputTrace.js

@@ -0,0 +1,430 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.setTraceConfig = setTraceConfig;
+exports.getTraceConfig = getTraceConfig;
+exports.checkIsTracingActive = checkIsTracingActive;
+exports.checkIsThreadTraced = checkIsThreadTraced;
+exports.pruneTraceBuckets = pruneTraceBuckets;
+exports.createTracePreview = createTracePreview;
+exports.configureTraceWriterForTests = configureTraceWriterForTests;
+exports.flushTraceBufferSyncOnExit = flushTraceBufferSyncOnExit;
+exports.traceRecvUpdate = traceRecvUpdate;
+exports.traceAgentEmit = traceAgentEmit;
+exports.installCallApiTrace = installCallApiTrace;
+const node_fs_1 = require("node:fs");
+const node_fs_2 = require("node:fs");
+const node_path_1 = __importDefault(require("node:path"));
+const state_1 = require("./state");
+const rotatingLogFile_1 = require("./utils/rotatingLogFile");
+const threadRouting_1 = require("./threadRouting");
+const sessionKey_1 = require("./sessionKey");
+const sessionKeyCodec_1 = require("./connectors/telegram/sessionKeyCodec");
+/**
+ * @description Output-trace special mode: a JSONL record of what the bot
+ * factually did versus what reached Telegram, so live verification can diff
+ * `emit → sendTry → sendOk/sendErr` against `get_history` instead of guessing
+ * from the controlling terminal (which is not capturable after the fact).
+ *
+ * Toggled at RUNTIME via the `/trace` command (no boot-time env var anymore):
+ *  - `/trace on`     — trace THIS topic's events
+ *  - `/trace on all` — trace every thread (cross-thread forensics)
+ *  - `/trace off`    — stop tracing this topic
+ *  - `/trace off all`— clear the all-threads flag AND the per-thread set
+ * The toggle state is persisted in `state.json` and seeded back into this
+ * module at boot via {@link setTraceConfig}, so it survives hot rebuilds.
+ *
+ * ON by default for ALL threads (always-on observability): a fresh state file
+ * reads back `allThreads: true`, so every thread is recorded with zero setup.
+ * `/trace off all` turns it off DURABLY. When tracing IS off (off-all + no
+ * opted-in thread) every hook early-returns after one cheap boolean / `Set`
+ * check (zero IO).
+ *
+ * When ON the writer is async-buffered: {@link appendTraceEntry} builds the
+ * JSON line immediately and pushes it to an in-memory buffer; a single-flight
+ * background flush (`fsp.appendFile`) drains the whole buffer at once, armed
+ * by a {@link traceFlushIntervalMs} timer or a {@link traceFlushMaxEntries}
+ * length threshold. A `process.on('exit')` hook does a best-effort SYNC flush
+ * of the remainder. Entries land in an hourly bucket file
+ * `DATA_DIR/output-trace-YYYYMMDDHH.jsonl` (size-capped per bucket with a single
+ * `.1` rollover like `diagLog.ts`); buckets older than 6h are pruned by the
+ * bot's janitor via {@link pruneTraceBuckets}.
+ *
+ * Entry kinds:
+ *  - `recv`    — incoming Telegram update (middleware): type, from, preview,
+ *                latency vs the update's own timestamp
+ *  - `emit`    — adapter `output`/`status` event entering the bot send path
+ *  - `sendTry` / `sendOk` / `sendErr` — every outgoing Bot API call, recorded
+ *                at the `callApi` chokepoint (i.e. AFTER queue/bucket waits;
+ *                each 429 retry attempt is its own try/err pair)
+ */
+const maxTraceBytes = 10 * 1024 * 1024;
+const previewLength = 120;
+/** Bucket file base + extension — `output-trace-YYYYMMDDHH.jsonl` per hour. */
+const traceFileBase = 'output-trace';
+const traceFileExt = 'jsonl';
+/** Flush the buffer at least this often (ms) even if it never fills up. */
+const traceFlushIntervalMs = 500;
+/** Flush early once the buffer reaches this many lines (bounds memory + lag). */
+const traceFlushMaxEntries = 200;
+/** Unicode high-surrogate range — a lone leading half breaks JSON consumers. */
+const highSurrogateMin = 0xd800;
+const highSurrogateMax = 0xdbff;
+// ─── runtime toggle state (seeded from state.json at boot via setTraceConfig) ───
+/** When true every thread is traced (cross-thread forensics). */
+let traceAllThreads = false;
+/** SessionKey strings (`"<chatId>:<threadId>"`) explicitly opted into tracing. */
+const tracedThreadKeys = new Set();
+/**
+ * @description Replace the in-memory trace toggle from persisted state. Called
+ * once at boot (seed from `state.json`) and again on every `/trace` mutation so
+ * the writer and the persisted record never drift. Lifecycle-independent: only
+ * `/trace` touches it — session stop/new/quit/resume/unbind never do.
+ */
+function setTraceConfig(config) {
+    traceAllThreads = config.allThreads;
+    tracedThreadKeys.clear();
+    for (const keyStr of config.threadKeys)
+        tracedThreadKeys.add(keyStr);
+}
+/** Current trace toggle as a plain snapshot — for `/trace` status + persistence. */
+function getTraceConfig() {
+    return { allThreads: traceAllThreads, threadKeys: [...tracedThreadKeys] };
+}
+/**
+ * @description Whether ANY tracing is active (all-flag set OR at least one
+ * thread opted in). The single fast-path gate every hook hits first — when it
+ * returns false the hook does no work beyond this check.
+ */
+function checkIsTracingActive() {
+    return traceAllThreads || tracedThreadKeys.size > 0;
+}
+/**
+ * @description Whether a specific thread's events should be recorded:
+ * the all-flag covers everything, otherwise the thread must be opted in.
+ */
+function checkIsThreadTraced(key) {
+    return traceAllThreads || tracedThreadKeys.has((0, sessionKey_1.keyToString)(key));
+}
+/**
+ * @description Path of the CURRENT hour's trace bucket
+ * (`DATA_DIR/output-trace-YYYYMMDDHH.jsonl`). Recomputed per flush so the writer
+ * rolls into a fresh file every hour with no live-file trimming — old buckets
+ * are pruned wholesale by {@link pruneTraceBuckets} (a writer never touches a
+ * past bucket, so prune races nothing). The per-bucket 10MB `.1` rollover still
+ * applies WITHIN an hour.
+ */
+function getTraceFilePath() {
+    return (0, rotatingLogFile_1.getHourBucketPath)((0, state_1.resolveDataDir)(), traceFileBase, traceFileExt, Date.now());
+}
+/**
+ * @description Delete trace buckets older than the shared 6h retention window
+ * (the hourly `output-trace-*.jsonl` files + their `.1` siblings). Best-effort;
+ * called at boot and on the file-sweep interval by the bot's janitor.
+ */
+function pruneTraceBuckets(nowMs) {
+    return (0, rotatingLogFile_1.pruneExpiredBuckets)((0, state_1.resolveDataDir)(), traceFileBase, traceFileExt, rotatingLogFile_1.retentionMs, nowMs);
+}
+/**
+ * @description Truncate `text` to a greppable one-liner without splitting a
+ * UTF-16 surrogate pair. A naive `slice(0, 120)` can cut between the high and
+ * low half of an emoji, leaving a lone high surrogate that serialises to an
+ * unpaired `\ud83d` and breaks `jq` consumers of the trace file (observed in
+ * the real trace). If the slice ends on a high surrogate we drop that trailing
+ * half so only whole code points survive.
+ */
+function createTracePreview(text) {
+    if (text.length <= previewLength)
+        return text;
+    let cut = previewLength;
+    const lastCharCode = text.charCodeAt(cut - 1);
+    if (lastCharCode >= highSurrogateMin && lastCharCode <= highSurrogateMax) {
+        cut -= 1;
+    }
+    return `${text.slice(0, cut)}…`;
+}
+const defaultWriterDeps = {
+    // Trace lines quote message previews / agent output → files are owner-only
+    // (0600; mode applies at creation), and DATA_DIR is created owner-only too.
+    appendFile: (filePath, data) => node_fs_1.promises.appendFile(filePath, data, { mode: 0o600 }),
+    appendFileSync: (filePath, data) => (0, node_fs_2.appendFileSync)(filePath, data, { mode: 0o600 }),
+    mkdir: async (dirPath) => {
+        await node_fs_1.promises.mkdir(dirPath, { recursive: true, mode: 0o700 });
+    },
+    getFileSize: async (filePath) => {
+        try {
+            return (await node_fs_1.promises.stat(filePath)).size;
+        }
+        catch {
+            return null;
+        }
+    },
+    rename: (fromPath, toPath) => node_fs_1.promises.rename(fromPath, toPath),
+    setTimer: (callback, ms) => setTimeout(callback, ms),
+    clearTimer: (handle) => clearTimeout(handle),
+};
+let writerDeps = defaultWriterDeps;
+/** Lines waiting to be flushed, in arrival order. */
+let traceBuffer = [];
+/** A flush is currently in flight — defer the next one (single-flight order). */
+let isFlushing = false;
+/** Armed flush timer handle (or null when none is pending). */
+let flushTimerHandle = null;
+/** mkdir is issued once per process, not per entry. */
+let isTraceDirEnsured = false;
+/**
+ * @description Override the writer's fs/timer seams (tests only). Also resets
+ * the buffer + flush state so each test starts clean. Returns a restore fn.
+ */
+function configureTraceWriterForTests(deps) {
+    writerDeps = { ...defaultWriterDeps, ...deps };
+    traceBuffer = [];
+    isFlushing = false;
+    flushTimerHandle = null;
+    isTraceDirEnsured = false;
+    return () => {
+        writerDeps = defaultWriterDeps;
+        traceBuffer = [];
+        isFlushing = false;
+        flushTimerHandle = null;
+        isTraceDirEnsured = false;
+    };
+}
+function armFlushTimer() {
+    if (flushTimerHandle !== null)
+        return;
+    flushTimerHandle = writerDeps.setTimer(() => {
+        flushTimerHandle = null;
+        void flushTraceBuffer();
+    }, traceFlushIntervalMs);
+}
+/**
+ * @description Rotate the trace file to `.1` if it has grown past the cap.
+ * Checked once per flush (not per entry) to keep the hot path append-only.
+ */
+async function rotateIfOversized(filePath) {
+    const size = await writerDeps.getFileSize(filePath);
+    if (size === null || size <= maxTraceBytes)
+        return;
+    await writerDeps.rename(filePath, `${filePath}.1`);
+}
+/**
+ * @description Drain the whole buffer into one `appendFile`. Single-flight: if
+ * a flush is already running, we return and the in-flight flush re-checks the
+ * buffer when it finishes, so lines are appended strictly in arrival order with
+ * no interleaving. Never throws — tracing must not be able to take the bot down.
+ */
+async function flushTraceBuffer() {
+    if (isFlushing)
+        return;
+    if (traceBuffer.length === 0)
+        return;
+    isFlushing = true;
+    try {
+        const filePath = getTraceFilePath();
+        if (!isTraceDirEnsured) {
+            await writerDeps.mkdir(node_path_1.default.dirname(filePath));
+            isTraceDirEnsured = true;
+        }
+        await rotateIfOversized(filePath);
+        // Snapshot + clear BEFORE the await so concurrent pushes land in a fresh
+        // buffer and are flushed by the re-check below, never lost or reordered.
+        const pending = traceBuffer;
+        traceBuffer = [];
+        await writerDeps.appendFile(filePath, pending.join(''));
+    }
+    catch {
+        // Tracing is best-effort; a logging failure must never break the bot.
+    }
+    finally {
+        isFlushing = false;
+        // A push (or another rotation-deferred chunk) may have arrived mid-flush.
+        if (traceBuffer.length > 0) {
+            if (traceBuffer.length >= traceFlushMaxEntries)
+                void flushTraceBuffer();
+            else
+                armFlushTimer();
+        }
+    }
+}
+/**
+ * @description Best-effort SYNCHRONOUS flush of whatever is still buffered.
+ * Registered on `process.on('exit')` — exit handlers can only do sync work, so
+ * the async writer would otherwise lose the final unflushed window on shutdown.
+ */
+function flushTraceBufferSyncOnExit() {
+    if (traceBuffer.length === 0)
+        return;
+    try {
+        const filePath = getTraceFilePath();
+        (0, node_fs_2.mkdirSync)(node_path_1.default.dirname(filePath), { recursive: true, mode: 0o700 });
+        if ((0, node_fs_2.existsSync)(filePath) && (0, node_fs_2.statSync)(filePath).size > maxTraceBytes) {
+            (0, node_fs_2.renameSync)(filePath, `${filePath}.1`);
+        }
+        const pending = traceBuffer;
+        traceBuffer = [];
+        writerDeps.appendFileSync(filePath, pending.join(''));
+    }
+    catch {
+        // Best-effort on shutdown; a failure here must not block the exit.
+    }
+}
+/**
+ * @description Build one trace entry and enqueue it for the buffered writer.
+ * The JSON line is materialised immediately (the field object is not retained),
+ * then a flush is triggered on the length threshold or armed on the timer.
+ * `undefined` fields are dropped by `JSON.stringify`.
+ */
+function appendTraceEntry(kind, fields) {
+    traceBuffer.push(`${JSON.stringify({ ts: new Date().toISOString(), kind, ...fields })}\n`);
+    if (traceBuffer.length >= traceFlushMaxEntries) {
+        void flushTraceBuffer();
+    }
+    else {
+        armFlushTimer();
+    }
+}
+/**
+ * @description Record an incoming update the moment the first middleware sees
+ * it — only if the update's own thread is traced. The key is built the same way
+ * routing does (`{chatId, threadId}`); a missing thread id maps to the General
+ * topic's `threadId: 1` so it filters consistently. When `chatId` is absent
+ * (rare service updates) we can't derive a key, so it records only under the
+ * all-flag.
+ */
+function traceRecvUpdate(fields) {
+    if (!checkIsTracingActive())
+        return;
+    const { tgDateSec, preview, chatId, threadId, ...rest } = fields;
+    if (!checkIsRecvThreadTraced(chatId, threadId))
+        return;
+    appendTraceEntry('recv', {
+        ...rest,
+        chatId,
+        threadId,
+        preview: preview === undefined ? undefined : createTracePreview(preview),
+        latencyMs: tgDateSec === undefined ? undefined : Date.now() - tgDateSec * 1000,
+    });
+}
+/**
+ * @description Decide whether a recv update belongs to a traced thread. The
+ * all-flag covers everything. Otherwise we need a chat id to build the key;
+ * a thread-less message (no `message_thread_id`) is the General topic, which
+ * routing keys under `GENERAL_THREAD_ID`.
+ */
+function checkIsRecvThreadTraced(chatId, threadId) {
+    if (traceAllThreads)
+        return true;
+    if (chatId === undefined)
+        return false;
+    return tracedThreadKeys.has((0, sessionKey_1.keyToString)((0, sessionKeyCodec_1.makeTelegramKey)(chatId, threadId ?? threadRouting_1.GENERAL_THREAD_ID)));
+}
+/** Record an adapter `output`/`status`/`thinking`/`toolResult` event entering the bot's send path. */
+function traceAgentEmit(event, key, text) {
+    if (!checkIsThreadTraced(key))
+        return;
+    appendTraceEntry('emit', {
+        event,
+        key: (0, sessionKey_1.keyToString)(key),
+        len: text.length,
+        preview: createTracePreview(text),
+    });
+}
+function extractTelegramErrorFields(err) {
+    if (typeof err !== 'object' || err === null) {
+        return { error: JSON.stringify(err) };
+    }
+    const e = err;
+    return {
+        errorCode: e.response?.error_code,
+        description: e.response?.description,
+        retryAfterSec: e.response?.parameters?.retry_after,
+        error: typeof e.message === 'string' ? e.message : undefined,
+    };
+}
+function getNumberField(source, field) {
+    const value = source[field];
+    return typeof value === 'number' ? value : undefined;
+}
+function getStringField(source, field) {
+    const value = source[field];
+    return typeof value === 'string' ? value : undefined;
+}
+function getBooleanField(source, field) {
+    const value = source[field];
+    return typeof value === 'boolean' ? value : undefined;
+}
+function extractApiCallFields(method, payload) {
+    const p = payload;
+    const text = getStringField(p, 'text');
+    return {
+        method,
+        chatId: getNumberField(p, 'chat_id'),
+        threadId: getNumberField(p, 'message_thread_id'),
+        messageId: getNumberField(p, 'message_id'),
+        callbackQueryId: getStringField(p, 'callback_query_id'),
+        // Whether a (un)pin / send suppresses the member notification — load-bearing
+        // for the question-pin "one question = one notification" rule (first pin
+        // notifies, repins are silent), so it must be visible in the trace.
+        disableNotification: getBooleanField(p, 'disable_notification'),
+        len: text?.length,
+        preview: text === undefined ? undefined : createTracePreview(text),
+    };
+}
+/**
+ * @description Decide whether an outgoing Bot API call should be recorded.
+ * A call WITH a derivable thread id (chat_id + the General-default thread)
+ * filters like recv/emit. A call with NO derivable thread id (e.g.
+ * `editMessageText` payloads carry only `message_id`) is recorded whenever ANY
+ * tracing is active — over-inclusion beats silently losing edit records
+ * (locked decision, plan S3).
+ */
+function checkIsApiCallTraced(fields) {
+    if (traceAllThreads)
+        return true;
+    const chatId = typeof fields.chatId === 'number' ? fields.chatId : undefined;
+    if (chatId === undefined)
+        return true;
+    const threadId = typeof fields.threadId === 'number' ? fields.threadId : threadRouting_1.GENERAL_THREAD_ID;
+    return tracedThreadKeys.has((0, sessionKey_1.keyToString)((0, sessionKeyCodec_1.makeTelegramKey)(chatId, threadId)));
+}
+/**
+ * @description Wrap `telegram.callApi` so every outgoing Bot API call is
+ * traced with its outcome. Installed unconditionally at boot — when tracing is
+ * off each call costs one boolean check. The wrap sits BELOW `enqueueSend`'s
+ * queue/bucket/429-retry layers, so each real HTTP attempt traces separately.
+ */
+function installCallApiTrace(host) {
+    const originalCallApi = host.callApi.bind(host);
+    host.callApi = async (method, payload, options) => {
+        if (!checkIsTracingActive())
+            return originalCallApi(method, payload, options);
+        const callFields = extractApiCallFields(method, payload);
+        if (!checkIsApiCallTraced(callFields))
+            return originalCallApi(method, payload, options);
+        appendTraceEntry('sendTry', callFields);
+        const startedAt = Date.now();
+        try {
+            const result = await originalCallApi(method, payload, options);
+            appendTraceEntry('sendOk', {
+                ...callFields,
+                durMs: Date.now() - startedAt,
+                resultMessageId: typeof result === 'object' && result !== null
+                    ? getNumberField(result, 'message_id')
+                    : undefined,
+            });
+            return result;
+        }
+        catch (err) {
+            appendTraceEntry('sendErr', {
+                ...callFields,
+                durMs: Date.now() - startedAt,
+                ...extractTelegramErrorFields(err),
+            });
+            throw err;
+        }
+    };
+}
+//# sourceMappingURL=outputTrace.js.map

package/dist/outputTrace.js.map

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