shadok-ai 0.1.0

package/dist/tail.js

@@ -0,0 +1,244 @@
+import fs from "node:fs";
+import os from "node:os";
+import path from "node:path";
+/** Max characters of a tool result to stream (long outputs are truncated). */
+const MAX_RESULT = 4000;
+/**
+ * Path of the .jsonl transcript Claude Code writes for a session.
+ *
+ * The obvious path is `<encoded cwd>/<id>.jsonl`, but Claude derives the
+ * encoded dir from the cwd it was LAUNCHED with. After a repo/worktree move
+ * (or the shadok-ai rename) a still-running agent keeps writing under its
+ * original encoded dir, which no longer matches the current cwd — so the tail
+ * would watch a stale file and nothing streams. To be immune to that drift we
+ * prefer the newest `<id>.jsonl` found anywhere under ~/.claude/projects; the
+ * file being actively appended is always the newest. Falls back to the
+ * cwd-derived path for a brand-new session whose file doesn't exist yet.
+ */
+export function sessionFilePath(cwd, sessionId) {
+    const newest = newestTranscriptById(sessionId);
+    if (newest)
+        return newest;
+    const encoded = path.resolve(cwd).replace(/[^a-zA-Z0-9]/g, "-");
+    return path.join(os.homedir(), ".claude", "projects", encoded, sessionId + ".jsonl");
+}
+/** The most-recently-modified `<id>.jsonl` across all project dirs, or null. */
+export function newestTranscriptById(sessionId) {
+    const root = path.join(os.homedir(), ".claude", "projects");
+    let best = null;
+    let bestMtime = -1;
+    let dirs;
+    try {
+        dirs = fs.readdirSync(root);
+    }
+    catch {
+        return null;
+    }
+    for (const d of dirs) {
+        const f = path.join(root, d, sessionId + ".jsonl");
+        try {
+            const m = fs.statSync(f).mtimeMs;
+            if (m > bestMtime) {
+                bestMtime = m;
+                best = f;
+            }
+        }
+        catch {
+            /* no such file in this dir */
+        }
+    }
+    return best;
+}
+/** One-line summary of a tool_use block (e.g. `Read auth.ts`, `Bash: npm test`). */
+function toolSummary(input) {
+    if (!input || typeof input !== "object")
+        return "";
+    const v = input.file_path ?? input.path ?? input.command ?? input.pattern ?? input.query ?? input.url ?? input.description;
+    if (typeof v !== "string")
+        return "";
+    const s = v.replace(/\s+/g, " ").trim();
+    return s.length > 80 ? s.slice(0, 79) + "…" : s;
+}
+/**
+ * Tails a session .jsonl: watches for appended lines and yields the assistant
+ * `text` and `tool_use` blocks as they are written — the authoritative,
+ * untruncated content, streamed at message granularity.
+ *
+ * `onEvent` fires for each new block. Returns a stop() function.
+ * Starts from the current end of file, so only NEW turns are streamed
+ * (existing history is replayed separately via loadHistory).
+ */
+export function tailSession(file, onEvent, intervalMs = 250) {
+    let pos = 0;
+    try {
+        pos = fs.statSync(file).size; // start at EOF: only stream what comes next
+    }
+    catch {
+        pos = 0; // file not written yet (new session) — stream from the start
+    }
+    let buf = "";
+    let stopped = false;
+    const read = () => {
+        if (stopped)
+            return;
+        let size;
+        try {
+            size = fs.statSync(file).size;
+        }
+        catch {
+            return; // file not there yet
+        }
+        if (size < pos) {
+            // File shrank/rotated (rare) — reset.
+            pos = 0;
+            buf = "";
+        }
+        if (size === pos)
+            return;
+        let chunk = "";
+        try {
+            const fd = fs.openSync(file, "r");
+            try {
+                const b = Buffer.alloc(size - pos);
+                const n = fs.readSync(fd, b, 0, b.length, pos);
+                chunk = b.toString("utf8", 0, n);
+                pos += n;
+            }
+            finally {
+                fs.closeSync(fd);
+            }
+        }
+        catch {
+            return;
+        }
+        buf += chunk;
+        let nl;
+        while ((nl = buf.indexOf("\n")) >= 0) {
+            const line = buf.slice(0, nl);
+            buf = buf.slice(nl + 1);
+            emitLine(line, onEvent);
+        }
+    };
+    const timer = setInterval(read, intervalMs);
+    return () => {
+        stopped = true;
+        clearInterval(timer);
+    };
+}
+function emitLine(line, onEvent) {
+    for (const ev of parseLine(line))
+        onEvent(ev);
+}
+/**
+ * Pure parser for one transcript line → the events it yields. Exported for
+ * tests; `tailSession` streams these live. Returns [] for anything that isn't
+ * a streamable assistant/user event.
+ */
+export function parseLine(line) {
+    if (!line.trim())
+        return [];
+    let e;
+    try {
+        e = JSON.parse(line);
+    }
+    catch {
+        return [];
+    }
+    if (e.isMeta || !Array.isArray(e.message?.content))
+        return [];
+    const out = [];
+    if (e.type === "assistant") {
+        const usage = parseUsage(e.message);
+        if (usage)
+            out.push({ kind: "usage", messageId: e.message.id ?? e.uuid, usage });
+        for (const block of e.message.content) {
+            if (block?.type === "text" && typeof block.text === "string" && block.text.trim()) {
+                out.push({ kind: "text", text: block.text });
+            }
+            else if (block?.type === "tool_use" && typeof block.name === "string") {
+                out.push({
+                    kind: "tool",
+                    id: typeof block.id === "string" ? block.id : "",
+                    name: block.name,
+                    summary: toolSummary(block.input),
+                });
+            }
+            // `thinking` blocks are intentionally skipped.
+        }
+    }
+    else if (e.type === "user") {
+        // User events carry tool results (command output, file reads…). The real
+        // user prompt is echoed by the server itself, so only results are emitted.
+        for (const block of e.message.content) {
+            if (block?.type !== "tool_result")
+                continue;
+            const text = resultText(block.content);
+            if (text) {
+                out.push({
+                    kind: "result",
+                    toolUseId: typeof block.tool_use_id === "string" ? block.tool_use_id : "",
+                    text,
+                    isError: !!block.is_error,
+                });
+            }
+        }
+    }
+    return out;
+}
+export function parseUsage(message) {
+    const u = message?.usage;
+    if (!u || typeof u !== "object")
+        return null;
+    return {
+        input: u.input_tokens ?? 0,
+        output: u.output_tokens ?? 0,
+        cacheCreation: u.cache_creation_input_tokens ?? 0,
+        cacheRead: u.cache_read_input_tokens ?? 0,
+    };
+}
+/**
+ * Sums the token usage already written to a transcript, keyed by message id.
+ * Streaming writes several records per message with the same id and growing
+ * counts — keeping the last record per id yields each message's final usage.
+ */
+export function scanUsage(file) {
+    const map = new Map();
+    let raw;
+    try {
+        raw = fs.readFileSync(file, "utf8");
+    }
+    catch {
+        return map; // new session: nothing written yet
+    }
+    for (const line of raw.split("\n")) {
+        if (!line.trim())
+            continue;
+        let e;
+        try {
+            e = JSON.parse(line);
+        }
+        catch {
+            continue;
+        }
+        if (e.type !== "assistant")
+            continue;
+        const usage = parseUsage(e.message);
+        if (usage)
+            map.set(e.message.id ?? e.uuid, usage);
+    }
+    return map;
+}
+/** Flattens a tool_result's content (string or block array) to display text. */
+export function resultText(content) {
+    let s = "";
+    if (typeof content === "string")
+        s = content;
+    else if (Array.isArray(content))
+        s = content
+            .filter((b) => b?.type === "text" && typeof b.text === "string")
+            .map((b) => b.text)
+            .join("\n");
+    s = s.trimEnd();
+    return s.length > MAX_RESULT ? s.slice(0, MAX_RESULT) + "\n… (truncated)" : s;
+}
+//# sourceMappingURL=tail.js.map

package/dist/tail.js.map

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

package/dist/telegram.d.ts

@@ -0,0 +1,48 @@
+/** The binding key for a chat + optional forum topic thread. */
+export declare function bindKey(chat: {
+    id: number;
+    type: string;
+}, threadId?: number): string;
+/** Split text into Telegram-sized chunks, preferring line boundaries. */
+export declare function chunk(text: string, max?: number): string[];
+/** Parse a leading bot command: "/spawn foo" → {cmd:"spawn", arg:"foo"}. */
+export declare function parseCommand(text: string): {
+    cmd: string;
+    arg: string;
+} | null;
+/** Telegram's "typing…" indicator lives ~5 s per sendChatAction and dies on
+ *  every sendMessage — a single beat can't cover a turn that runs for minutes.
+ *  This keeps it alive: an immediate beat, then one every `intervalMs` until
+ *  stop(). start() while beating is a no-op; stop() is idempotent. */
+export declare function makeTyping(beat: () => void, intervalMs?: number): {
+    start: () => void;
+    stop: () => void;
+};
+interface DialogOption {
+    n: number;
+    label: string;
+    hint?: string;
+    checked?: boolean;
+}
+interface Dialog {
+    question: string;
+    options: DialogOption[];
+    multi: boolean;
+}
+/** Inline keyboard for a TUI dialog. Single-select → one button per option
+ *  (choose); multi-select → toggle buttons (with ☑/☐) + a Submit row. */
+export declare function dialogKeyboard(d: Dialog): {
+    inline_keyboard: {
+        text: string;
+        callback_data: string;
+    }[][];
+};
+/** Parse a dialog callback_data → an action for the WS. */
+export declare function parseCallback(data: string): {
+    kind: "choose" | "toggle" | "confirm";
+    n?: number;
+} | null;
+export declare function renameTelegramTopic(chatId: number, threadId: number, name: string): void;
+export declare function closeTelegramTopic(chatId: number, threadId: number): void;
+export declare function startTelegram(port: number): void;
+export {};