shadok-ai 0.1.0

package/README.md

@@ -0,0 +1,196 @@
+# shadok-ai
+
+> **Working on this codebase?** Read [`CLAUDE.md`](CLAUDE.md) (map, build/run,
+> invariants) and [`docs/architecture.md`](docs/architecture.md) first — they
+> are the current source of truth. This README covers the original single-session
+> library/CLI; shadok-ai is now a multi-session web cockpit (see those docs).
+
+## Quick start
+
+```bash
+npx shadok-ai            # first run asks once for an optional Telegram bot token
+```
+
+Open **http://localhost:3789**. To drive agents from Telegram, send the bot to a
+group with Topics enabled and type `/setup` there; then `/spawn <name>` per agent.
+Keep it current with `/update` (fetches `@latest` and respawns itself). Flags:
+`--port <n>`, `--no-telegram`, `--version`.
+
+---
+
+Drives a **Claude Code TUI** session (the interactive `claude` CLI) from Node.js, through a pseudo-terminal.
+
+> ⚠️ The Claude Code TUI is not a stable API: a CLI update can break the
+> detection heuristics (`❯`, `⏺`, `esc to interrupt` markers).
+> For production use, prefer the
+> [Claude Agent SDK](https://www.npmjs.com/package/@anthropic-ai/claude-agent-sdk)
+> or `claude -p --output-format stream-json`.
+
+## How it works
+
+- **node-pty** spawns `claude` inside a real pseudo-terminal (the TUI believes it talks to a human);
+- **@xterm/headless** replays the ANSI stream into a virtual screen: we read
+  the screen as it would be displayed instead of parsing escape sequences;
+- the **responses to terminal queries** (cursor position `\x1b[?6n`,
+  identification `\x1b[c`…) generated by xterm are forwarded back to the
+  PTY — without this, the TUI ignores every keystroke;
+- prompts are sent via **bracketed paste** (`\x1b[200~…\x1b[201~`) with
+  retries, because the TUI flushes stdin received during its initialization;
+- the "Claude is done" state is detected heuristically: no
+  `esc to interrupt` marker + screen stable for N ms.
+
+## Install
+
+```bash
+npm install
+npm run build
+```
+
+The `postinstall` script fixes the executable bit of node-pty's
+`spawn-helper` (a known npm prebuilds bug on macOS).
+
+## CLI
+
+```bash
+node dist/cli.js [options] "<prompt>"
+
+  --cwd <dir>       working directory of the claude session
+  --continue, -c    resume the latest session of this directory
+  --resume <id>, -r resume a specific session (id printed at end of run)
+  --watch           mirror the TUI live on stdout
+  --keep            keep the session open at the end
+  --timeout <sec>   max wait for the response (default 600)
+```
+
+Without `--continue`/`--resume`, every run starts a **new** session.
+The session id is printed at the end of the run (found in
+`~/.claude/projects/<encoded cwd>/`, like any Claude Code session):
+
+```bash
+node dist/cli.js --cwd ~/my-project "Explain this project's structure"
+# ▶ session: 5fe046dd-…
+
+node dist/cli.js --cwd ~/my-project --resume 5fe046dd-… "Now refactor it"
+node dist/cli.js --cwd ~/my-project -c "Continue on the latest session"
+```
+
+## Web interface
+
+```bash
+npm run web        # http://localhost:3789  (PORT=… to change)
+```
+
+A chat in the browser driving persistent TUI sessions, in parallel through
+channels:
+
+- **channels** (left column): "＋ new channel" opens a new independent
+  claude session (one WebSocket connection each). Each channel's LED shows
+  its state (green: ready, amber: responding, red: ended); the × closes the
+  channel and detaches from its session; double-click a name to rename it
+  (the name is remembered by session id and reapplied on resume). The
+  header, composer and Terminal view follow the active channel. Channels
+  are remembered (localStorage): on the next page load each one is restored
+  automatically — session resumed via `--resume` and history replayed.
+  Closing a channel (×) removes it from the remembered list;
+- **interactive dialogs**: when the TUI shows a choice (multiple-choice
+  question, permission prompt…), the options appear as clickable buttons in
+  the chat. Single select: one click validates. Multi-select (`[ ]`
+  checkboxes in the TUI): clicks toggle (the displayed state is re-read
+  from the TUI screen), then "Submit selection" confirms (Tab → Submit page
+  → Enter). The composer is locked while a choice is pending. The
+  "Type something" option becomes a free-form text input inside the dialog
+  bubble;
+- **history on resume**: when resuming a session (`--continue` or
+  `--resume`), the transcript is re-read from the session's `.jsonl` and
+  replayed in the chat (last 100 turns, dimmed). The markdown of the
+  responses is rendered as HTML (tables, code, lists) via `marked`, served
+  locally;
+- **"engine room"** (Terminal button): the raw TUI screen live, with
+  clickable keys (Esc, Enter, arrows, 1/2/3, y/n…) to answer permission
+  dialogs, and "Resync chat" to resynchronize the chat after a manual
+  intervention.
+
+### WebSocket protocol (to replace the interface)
+
+The interface is a plain static page: all the intelligence lives server-side.
+Any client (another front-end, a Slack bot, a script…) can replace it by
+speaking this JSON protocol on `ws://…/ws`.
+
+**Shared sessions**: the server keeps a single claude process per session
+id. If several clients (tabs, browsers, interfaces) "start" the same id,
+they attach to the same process and all receive the same events — other
+clients' prompts (`prompt-echo`), answers, dialogs, screen. Closing a
+connection detaches the client; the process is only stopped when the last
+client detaches (session stays resumable) or on an explicit `stop` (ends it
+for everyone).
+
+**client → server**
+
+| Message | Purpose |
+|---|---|
+| `{type:"start", cwd?, resume?, continue?}` | starts or attaches to the session (once per connection) |
+| `{type:"prompt", text}` | sends a prompt |
+| `{type:"choose", n}` | single-select dialog: picks and validates option n |
+| `{type:"toggle", n}` | multi-select dialog: toggles option n |
+| `{type:"confirm"}` | multi-select dialog: submits the selection |
+| `{type:"freetext", n, text}` | "Type something" option: sends a free-form answer |
+| `{type:"key", key}` | raw keystroke (`enter`, `escape`, `up`, `down`, `tab`, `ctrl-c`, or a single character) |
+| `{type:"settle"}` | after a manual intervention: waits for the turn to finish |
+| `{type:"stop"}` | closes the session cleanly (/exit) for all clients |
+
+**server → client**
+
+| Message | Purpose |
+|---|---|
+| `{type:"ready", sessionId, cwd}` | session started (or attached) |
+| `{type:"working"}` | turn in progress |
+| `{type:"prompt-echo", text}` | prompt sent by another client of the session |
+| `{type:"answer", text, sessionId}` | response extracted from the transcript |
+| `{type:"dialog", question, options:[{n,label,hint,checked?}], multi}` | choice pending |
+| `{type:"history", turns:[{role,text}]}` | transcript replayed when resuming/attaching |
+| `{type:"screen", text, working}` | rendered TUI screen (whenever it changes) |
+| `{type:"error", message}` / `{type:"exited", code}` / `{type:"stopped"}` | errors and termination |
+
+## Library
+
+```js
+import { PtyPilot } from "shadok-ai";
+
+const pilot = new PtyPilot({ cwd: "/my/project" });
+pilot.start();
+await pilot.waitForIdle();                 // TUI ready
+
+await pilot.submit("Fix the bug in auth.ts");
+await pilot.waitForIdle({ timeoutMs: 600_000 });
+console.log(pilot.screen());               // rendered screen (visible transcript)
+
+await pilot.submit("Now add a test");      // same session, second turn
+await pilot.waitForIdle();
+
+await pilot.stop();                        // clean /exit, kill as fallback
+```
+
+Main API:
+
+| Method | Purpose |
+|---|---|
+| `start()` / `stop()` / `kill()` | process lifecycle |
+| `submit(text)` | types a prompt + Enter, with verification and retries |
+| `write(text)` / `press(key)` | low-level keystrokes (`enter`, `escape`, `up`, `tab`, `ctrl-c`…) |
+| `screen()` / `fullBuffer()` | rendered screen / full buffer |
+| `waitForIdle({stableMs, timeoutMs})` | waits for the end of a turn |
+| `waitFor(predicate)` | waits for an arbitrary screen condition (dialogs, permissions…) |
+| `isWorking()` | true while Claude is working |
+| `onData(cb)` / `onExit(cb)` | raw ANSI stream (mirror mode) / process exit |
+
+`examples/two-turns.mjs` shows a two-turn conversation;
+`debug/probe.mjs` logs the terminal sequences exchanged (useful when a CLI
+update breaks the detection).
+
+## Known limits
+
+- Every session launched consumes your Claude quota like a normal session.
+- Dialogs the chat cannot handle in one click are managed through the
+  engine room (`waitFor()` + `press()` in library mode).
+- The TUI runs in the alternate screen: `fullBuffer()` ≈ visible screen;
+  very long responses scroll out of view (increase `rows` if needed).

package/dist/args.d.ts

@@ -0,0 +1,8 @@
+export interface Args {
+    port?: number;
+    noTelegram: boolean;
+    help: boolean;
+    version: boolean;
+}
+/** Parse the CLI flags. Unknown flags are ignored (forward-compatible). */
+export declare function parseArgs(argv: string[]): Args;

package/dist/args.js

@@ -0,0 +1,17 @@
+/** Parse the CLI flags. Unknown flags are ignored (forward-compatible). */
+export function parseArgs(argv) {
+    const a = { noTelegram: false, help: false, version: false };
+    for (let i = 0; i < argv.length; i++) {
+        const arg = argv[i];
+        if (arg === "--port" || arg === "-p")
+            a.port = Number(argv[++i]);
+        else if (arg === "--no-telegram")
+            a.noTelegram = true;
+        else if (arg === "--help" || arg === "-h")
+            a.help = true;
+        else if (arg === "--version" || arg === "-v")
+            a.version = true;
+    }
+    return a;
+}
+//# sourceMappingURL=args.js.map

package/dist/args.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"args.js","sourceRoot":"","sources":["../src/args.ts"],"names":[],"mappings":"AAOA,2EAA2E;AAC3E,MAAM,UAAU,SAAS,CAAC,IAAc;IACtC,MAAM,CAAC,GAAS,EAAE,UAAU,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;IACnE,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACrC,MAAM,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QACpB,IAAI,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,IAAI;YAAE,CAAC,CAAC,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;aAC5D,IAAI,GAAG,KAAK,eAAe;YAAE,CAAC,CAAC,UAAU,GAAG,IAAI,CAAC;aACjD,IAAI,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,IAAI;YAAE,CAAC,CAAC,IAAI,GAAG,IAAI,CAAC;aACpD,IAAI,GAAG,KAAK,WAAW,IAAI,GAAG,KAAK,IAAI;YAAE,CAAC,CAAC,OAAO,GAAG,IAAI,CAAC;IACjE,CAAC;IACD,OAAO,CAAC,CAAC;AACX,CAAC"}

package/dist/channels.d.ts

@@ -0,0 +1,61 @@
+/** A Telegram chat/topic a channel is bound to (folded into the channel). */
+export interface TgBinding {
+    chatId: number;
+    threadId?: number;
+}
+/** A remembered session — the ONE registry, whatever created it (web or
+ *  Telegram). Enough to restore, resume, and route it. */
+export interface Channel {
+    sessionId: string;
+    cwd: string;
+    name?: string;
+    branch?: string | null;
+    /** Repo the worktree belongs to, to recreate a reclaimed checkout. */
+    repo?: string;
+    /** Tab group id (client-owned metadata). */
+    group?: number | null;
+    /** Present iff the session is bound to a Telegram chat/topic. */
+    telegram?: TgBinding | null;
+}
+export declare function loadChannels(): Channel[];
+export declare function saveChannels(list: Channel[]): void;
+/**
+ * Insert or update a channel by sessionId, shallow-merging the given fields
+ * (an `undefined` field never clobbers an existing value). The server calls
+ * this whenever a session reaches `ready`, so every session — web or Telegram —
+ * lands in the one list.
+ */
+/** Pure core of upsertChannel — returns a new list; exported for testing. */
+export declare function upsertInto(list: Channel[], patch: Partial<Channel> & {
+    sessionId: string;
+}): Channel[];
+export declare function upsertChannel(patch: Partial<Channel> & {
+    sessionId: string;
+}): void;
+export declare function removeChannel(sessionId: string): void;
+/** Pure lookup of the channel bound to a Telegram chat/topic. */
+export declare function findTelegramChannel(list: Channel[], chatId: number, threadId?: number): Channel | undefined;
+/** The channel bound to a given Telegram chat/topic, or undefined. */
+export declare function channelForTelegram(chatId: number, threadId?: number): Channel | undefined;
+/**
+ * Pure core of the PUT merge (exported for testing). The client drives order
+ * and its own metadata (name, group); server-owned fields are preserved per
+ * sessionId, and any stored channel the client omitted is kept when its session
+ * is live or it has a Telegram binding — so persistence never drops a
+ * live/Telegram session (invariant #6).
+ */
+export declare function mergeChannels(stored: Channel[], clientList: Channel[], liveIds: Set<string>): Channel[];
+export declare function mergeClientChannels(clientList: Channel[], liveIds: Set<string>): Channel[];
+/** Tab groups (id, name, collapsed, order), persisted the same way as channels. */
+export declare function loadGroups(): any[];
+export declare function saveGroups(list: any[]): void;
+/** The single group this instance is bound to (one board per instance), or null.
+ *  Instance-level, not a session — kept separate from the channel registry. */
+export declare function loadTgGroup(): number | null;
+export declare function saveTgGroup(groupId: number | null): void;
+/**
+ * One-time migration of the old separate `…-telegram.json` bindings into the
+ * channel registry. Idempotent: renames the file once folded so it's never
+ * re-applied. cwd/name are filled in later when the session next reaches ready.
+ */
+export declare function migrateTgBindings(): void;

package/dist/channels.js

@@ -0,0 +1,169 @@
+import fs from "node:fs";
+import os from "node:os";
+import path from "node:path";
+/** Fields the server owns; a browser PUT must never overwrite or drop them. */
+const SERVER_OWNED = ["cwd", "branch", "repo", "telegram"];
+/**
+ * The registry is stored server-side, keyed by the directory the server was
+ * launched from — so the set of sessions survives a wiped browser, another
+ * device, a restart, or a reboot. One file per launch dir:
+ * ~/.shadok-ai/channels/<encoded cwd>.json.
+ */
+function storeFile(kind) {
+    const enc = process.cwd().replace(/[^a-zA-Z0-9]/g, "-");
+    const suffix = kind === "channels" ? "" : "-" + kind;
+    return path.join(os.homedir(), ".shadok-ai", "channels", enc + suffix + ".json");
+}
+function readJson(kind) {
+    try {
+        const v = JSON.parse(fs.readFileSync(storeFile(kind), "utf8"));
+        return Array.isArray(v) ? v : [];
+    }
+    catch {
+        return [];
+    }
+}
+function writeJson(kind, value) {
+    const f = storeFile(kind);
+    try {
+        fs.mkdirSync(path.dirname(f), { recursive: true });
+        fs.writeFileSync(f, JSON.stringify(value, null, 2));
+    }
+    catch {
+        // best effort: losing the persisted list is non-fatal
+    }
+}
+export function loadChannels() {
+    return readJson("channels").filter((c) => c && typeof c.sessionId === "string");
+}
+export function saveChannels(list) {
+    writeJson("channels", list);
+}
+/**
+ * Insert or update a channel by sessionId, shallow-merging the given fields
+ * (an `undefined` field never clobbers an existing value). The server calls
+ * this whenever a session reaches `ready`, so every session — web or Telegram —
+ * lands in the one list.
+ */
+/** Pure core of upsertChannel — returns a new list; exported for testing. */
+export function upsertInto(list, patch) {
+    const out = list.map((c) => ({ ...c }));
+    const cur = out.find((c) => c.sessionId === patch.sessionId);
+    if (!cur) {
+        out.push({ cwd: "", ...patch });
+    }
+    else {
+        for (const [k, v] of Object.entries(patch))
+            if (v !== undefined)
+                cur[k] = v;
+    }
+    return out;
+}
+export function upsertChannel(patch) {
+    saveChannels(upsertInto(loadChannels(), patch));
+}
+export function removeChannel(sessionId) {
+    saveChannels(loadChannels().filter((c) => c.sessionId !== sessionId));
+}
+/** Pure lookup of the channel bound to a Telegram chat/topic. */
+export function findTelegramChannel(list, chatId, threadId) {
+    return list.find((c) => c.telegram && c.telegram.chatId === chatId && (c.telegram.threadId ?? undefined) === threadId);
+}
+/** The channel bound to a given Telegram chat/topic, or undefined. */
+export function channelForTelegram(chatId, threadId) {
+    return findTelegramChannel(loadChannels(), chatId, threadId);
+}
+/**
+ * Pure core of the PUT merge (exported for testing). The client drives order
+ * and its own metadata (name, group); server-owned fields are preserved per
+ * sessionId, and any stored channel the client omitted is kept when its session
+ * is live or it has a Telegram binding — so persistence never drops a
+ * live/Telegram session (invariant #6).
+ */
+export function mergeChannels(stored, clientList, liveIds) {
+    const byId = new Map(stored.map((c) => [c.sessionId, c]));
+    const result = [];
+    const seen = new Set();
+    for (const c of Array.isArray(clientList) ? clientList : []) {
+        if (!c || typeof c.sessionId !== "string")
+            continue;
+        seen.add(c.sessionId);
+        const prev = byId.get(c.sessionId);
+        if (!prev) {
+            result.push(c); // a new channel the client just created
+            continue;
+        }
+        const merged = { ...c };
+        for (const k of SERVER_OWNED)
+            if (prev[k] !== undefined)
+                merged[k] = prev[k];
+        result.push(merged);
+    }
+    for (const c of stored) {
+        if (seen.has(c.sessionId))
+            continue;
+        if (liveIds.has(c.sessionId) || c.telegram)
+            result.push(c); // never erase live/Telegram
+    }
+    return result;
+}
+export function mergeClientChannels(clientList, liveIds) {
+    const result = mergeChannels(loadChannels(), clientList, liveIds);
+    saveChannels(result);
+    return result;
+}
+/** Tab groups (id, name, collapsed, order), persisted the same way as channels. */
+export function loadGroups() {
+    return readJson("groups");
+}
+export function saveGroups(list) {
+    writeJson("groups", list);
+}
+/** The single group this instance is bound to (one board per instance), or null.
+ *  Instance-level, not a session — kept separate from the channel registry. */
+export function loadTgGroup() {
+    const v = readJson("telegram-group")[0];
+    return typeof v === "number" ? v : null;
+}
+export function saveTgGroup(groupId) {
+    writeJson("telegram-group", groupId == null ? [] : [groupId]);
+}
+/**
+ * One-time migration of the old separate `…-telegram.json` bindings into the
+ * channel registry. Idempotent: renames the file once folded so it's never
+ * re-applied. cwd/name are filled in later when the session next reaches ready.
+ */
+export function migrateTgBindings() {
+    const f = storeFile("telegram");
+    let raw;
+    try {
+        raw = fs.readFileSync(f, "utf8");
+    }
+    catch {
+        return; // already migrated or never existed
+    }
+    let bindings;
+    try {
+        bindings = JSON.parse(raw);
+    }
+    catch {
+        return;
+    }
+    if (Array.isArray(bindings)) {
+        for (const b of bindings) {
+            if (b && typeof b.sessionId === "string" && typeof b.chatId === "number") {
+                upsertChannel({
+                    sessionId: b.sessionId,
+                    telegram: { chatId: b.chatId, ...(typeof b.threadId === "number" ? { threadId: b.threadId } : {}) },
+                });
+            }
+        }
+    }
+    try {
+        fs.renameSync(f, f + ".migrated");
+    }
+    catch {
+        /* best effort */
+    }
+}
+//# sourceMappingURL=channels.js.map

package/dist/channels.js.map

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

package/dist/cli.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/cli.js

@@ -0,0 +1,100 @@
+#!/usr/bin/env node
+import { extractResponse, findSessionId } from "./extract.js";
+import { PtyPilot } from "./session.js";
+function usage() {
+    console.error(`Usage: shadok-ai [options] "<prompt>"
+
+Sends a prompt to a PTY-driven Claude Code TUI session and prints the
+response once the session becomes idle again.
+
+Options:
+  --cwd <dir>       Working directory of the session (default: current cwd)
+  --continue, -c    Resume the latest session of this directory
+  --resume <id>, -r Resume a specific session (id printed at end of run)
+  --watch           Mirror the TUI live on stdout
+  --keep            Keep the session open at the end (Ctrl-C to quit)
+  --timeout <sec>   Max wait for the response (default: 600)
+`);
+    process.exit(1);
+}
+const argv = process.argv.slice(2);
+let cwd = process.cwd();
+let watch = false;
+let keep = false;
+let timeoutSec = 600;
+let continueSession = false;
+let resumeId = null;
+const rest = [];
+for (let i = 0; i < argv.length; i++) {
+    const a = argv[i];
+    if (a === "--cwd")
+        cwd = argv[++i] ?? usage();
+    else if (a === "--continue" || a === "-c")
+        continueSession = true;
+    else if (a === "--resume" || a === "-r")
+        resumeId = argv[++i] ?? usage();
+    else if (a === "--watch")
+        watch = true;
+    else if (a === "--keep")
+        keep = true;
+    else if (a === "--timeout")
+        timeoutSec = Number(argv[++i] ?? usage());
+    else if (a === "--help" || a === "-h")
+        usage();
+    else
+        rest.push(a);
+}
+const prompt = rest.join(" ").trim();
+if (!prompt)
+    usage();
+if (continueSession && resumeId) {
+    console.error("--continue and --resume are mutually exclusive.");
+    usage();
+}
+const claudeArgs = [];
+if (continueSession)
+    claudeArgs.push("--continue");
+if (resumeId)
+    claudeArgs.push("--resume", resumeId);
+const pilot = new PtyPilot({ cwd, args: claudeArgs });
+async function main() {
+    console.error("▶ starting claude…");
+    pilot.start();
+    if (watch)
+        pilot.onData((chunk) => process.stdout.write(chunk));
+    // Wait for the TUI to be ready (stable screen, no spinner).
+    let screen = await pilot.waitForIdle({ stableMs: 1200, timeoutMs: 60_000 });
+    // First launch in a directory: trust dialog.
+    if (/do you trust the files/i.test(screen)) {
+        console.error("▶ trust dialog detected, accepting…");
+        pilot.press("enter");
+        screen = await pilot.waitForIdle({ stableMs: 1200, timeoutMs: 30_000 });
+    }
+    console.error(`▶ sending prompt: ${prompt}`);
+    await pilot.submit(prompt);
+    await pilot.waitForIdle({ stableMs: 2000, timeoutMs: timeoutSec * 1000 });
+    console.error("▶ response received:\n");
+    process.stdout.write(extractResponse(pilot.fullBuffer(), prompt) + "\n");
+    const sessionId = findSessionId(cwd);
+    if (sessionId) {
+        console.error(`\n▶ session: ${sessionId}`);
+        console.error(`  resume with: shadok-ai --resume ${sessionId} "<prompt>"`);
+    }
+    if (keep) {
+        console.error("\n▶ session kept open (--keep). Ctrl-C to quit.");
+        process.on("SIGINT", async () => {
+            await pilot.stop();
+            process.exit(0);
+        });
+    }
+    else {
+        await pilot.stop();
+        process.exit(0);
+    }
+}
+main().catch((err) => {
+    console.error(err instanceof Error ? err.message : err);
+    pilot.kill();
+    process.exit(1);
+});
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/config.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Global CLI config, stored at ~/.shadok-ai/config.json (mode 600). Holds the
+ * Telegram bot token and the port. Replaces the old telegram.env shell hack:
+ * the token now lives here and is passed to the server child via env.
+ *
+ * `telegramToken` semantics:
+ *   undefined → never asked yet (first run should prompt)
+ *   null      → asked and deliberately skipped (never prompt again)
+ *   string    → the token
+ */
+export interface Config {
+    telegramToken?: string | null;
+    port?: number;
+}
+export declare const SHADOK_DIR: string;
+export declare function loadConfig(): Config;
+export declare function saveConfig(cfg: Config): void;
+/**
+ * One-time migration of the legacy ~/.shadok-ai/telegram.env
+ * (`TELEGRAM_BOT_TOKEN=...`) into config.json. Returns the migrated token, or
+ * null if there was nothing to migrate. The env file is left on disk but no
+ * longer read by anything.
+ */
+export declare function migrateLegacyEnv(cfg: Config): string | null;
+/** Pull TELEGRAM_BOT_TOKEN out of a shell-style env file body. */
+export declare function parseLegacyToken(raw: string): string | null;
+/**
+ * The effective token to hand the server: an explicit env var always wins,
+ * otherwise the configured value (a null/undefined config means "no token").
+ */
+export declare function effectiveToken(cfg: Config, env?: NodeJS.ProcessEnv): string | null;