@textjs/app 0.0.0-stage → 1.0.3

package/dist/mcp/logs.js

@@ -0,0 +1,217 @@
+/**
+ * Console capture for `text mcp`. On the stdio transport stdout carries
+ * JSON-RPC, so app output must never reach it: every `console.*` call is
+ * recorded into a bounded ring buffer that agents read with the `logs` tool.
+ */
+import { formatWithOptions } from "node:util";
+const MAX_MESSAGE = 8_000;
+/** `TX###` code of an error-like value (duck-typed so this works with any Text.js version). */
+export function txCodeOf(value) {
+    if (value === null || typeof value !== "object")
+        return undefined;
+    const code = value.code;
+    if (typeof code === "string" && /^TX\d{3}$/.test(code))
+        return code;
+    const message = value.message;
+    if (typeof message === "string")
+        return /\b(TX\d{3})\b/.exec(message)?.[1];
+    return undefined;
+}
+/**
+ * Format console arguments like Node's `util.format`, dropping `%c` styling
+ * (the browser console's styled-span syntax) together with the style argument
+ * it consumes. Directives are scanned left to right, so `%%c` stays a literal
+ * `%c` and `%s` / `%c` mixes consume arguments in order.
+ */
+export function formatLogArgs(args) {
+    let list = args;
+    const fmt = list[0];
+    if (typeof fmt === "string" && fmt.includes("%c")) {
+        const rest = list.slice(1);
+        const kept = [];
+        let next = 0;
+        const out = fmt.replace(/%[csdifjoO%]/g, (token) => {
+            if (token === "%%")
+                return token;
+            if (next >= rest.length)
+                return token;
+            const arg = rest[next++];
+            if (token === "%c")
+                return "";
+            kept.push(arg);
+            return token;
+        });
+        list = [out, ...kept, ...rest.slice(next)];
+    }
+    const text = formatWithOptions({ colors: false, depth: 4, breakLength: 120 }, ...list);
+    return text.length > MAX_MESSAGE ? `${text.slice(0, MAX_MESSAGE)}… (${text.length - MAX_MESSAGE} more chars)` : text;
+}
+export class LogBuffer {
+    capacity;
+    entries = [];
+    seq = 0;
+    started = Date.now();
+    listeners = new Set();
+    constructor(capacity = 1_000) {
+        this.capacity = capacity;
+    }
+    /** Record an entry; `indent` is the `console.group` depth (two spaces per level). */
+    push(level, source, args, indent = 0) {
+        const code = args.map(txCodeOf).find((c) => c !== undefined);
+        const text = formatLogArgs(args);
+        const message = indent > 0 ? text.replace(/^/gm, "  ".repeat(indent)) : text;
+        const entry = { seq: ++this.seq, t: Date.now() - this.started, level, source, message, ...(code ? { code } : {}) };
+        this.entries.push(entry);
+        if (this.entries.length > this.capacity)
+            this.entries.splice(0, this.entries.length - this.capacity);
+        for (const l of this.listeners)
+            l(entry);
+        return entry;
+    }
+    /** Entries with `seq > since`, optionally filtered by level, newest last. */
+    read(options = {}) {
+        const { since = 0, levels, limit = 200 } = options;
+        const out = this.entries.filter((e) => e.seq > since && (!levels || levels.includes(e.level)));
+        return limit > 0 && out.length > limit ? out.slice(out.length - limit) : out;
+    }
+    /** Highest sequence number issued so far. */
+    get cursor() {
+        return this.seq;
+    }
+    /** Errors logged after `since`. */
+    errorsSince(since) {
+        let n = 0;
+        for (const e of this.entries)
+            if (e.seq > since && e.level === "error")
+                n++;
+        return n;
+    }
+    clear() {
+        this.entries.length = 0;
+    }
+    onEntry(listener) {
+        this.listeners.add(listener);
+        return () => this.listeners.delete(listener);
+    }
+}
+/**
+ * Route every `console` method into `buffer`. `mirror` additionally receives
+ * each entry (e.g. stderr when `--verbose`); stdout is never written.
+ *
+ * All methods are replaced, not just `log`/`info`/`warn`/`error`/`debug`: Bun's
+ * native `console.count`, `group`, `table`, `dir`, `write` (and Node's) print
+ * straight to file descriptor 1, which would corrupt a stdio JSON-RPC stream,
+ * and `assert` / `timeLog` / `timeEnd` would bypass the buffer.
+ */
+export function captureConsole(buffer, mirror) {
+    const target = console;
+    let depth = 0;
+    const counts = new Map();
+    const timers = new Map();
+    const push = (level, args) => {
+        const entry = buffer.push(level, "console", args, depth);
+        mirror?.(entry);
+    };
+    const label = (v) => (v === undefined ? "default" : String(v));
+    const elapsed = (name) => {
+        const start = timers.get(name);
+        if (start === undefined)
+            return null;
+        return `${name}: ${(performance.now() - start).toFixed(3)}ms`;
+    };
+    const handlers = {
+        log: (...a) => push("log", a),
+        info: (...a) => push("info", a),
+        warn: (...a) => push("warn", a),
+        error: (...a) => push("error", a),
+        debug: (...a) => push("debug", a),
+        dir: (obj) => push("log", [obj]),
+        dirxml: (...a) => push("log", a),
+        table: (data, columns) => push("log", columns === undefined ? [data] : [data, columns]),
+        trace: (...a) => {
+            const stack = new Error().stack?.split("\n").slice(2).join("\n") ?? "";
+            push("debug", [`Trace${a.length > 0 ? `: ${formatLogArgs(a)}` : ""}${stack ? `\n${stack}` : ""}`]);
+        },
+        assert: (condition, ...a) => {
+            if (condition)
+                return;
+            push("error", a.length > 0 ? ["Assertion failed:", ...a] : ["Assertion failed"]);
+        },
+        count: (name) => {
+            const key = label(name);
+            const n = (counts.get(key) ?? 0) + 1;
+            counts.set(key, n);
+            push("log", [`${key}: ${n}`]);
+        },
+        countReset: (name) => void counts.set(label(name), 0),
+        group: (...a) => {
+            if (a.length > 0)
+                push("log", a);
+            depth++;
+        },
+        groupCollapsed: (...a) => {
+            if (a.length > 0)
+                push("log", a);
+            depth++;
+        },
+        groupEnd: () => {
+            depth = Math.max(0, depth - 1);
+        },
+        time: (name) => void timers.set(label(name), performance.now()),
+        timeLog: (name, ...a) => {
+            const line = elapsed(label(name));
+            if (line === null)
+                push("warn", [`Timer "${label(name)}" does not exist`]);
+            else
+                push("log", [line, ...a]);
+        },
+        timeEnd: (name) => {
+            const line = elapsed(label(name));
+            if (line === null)
+                push("warn", [`Timer "${label(name)}" does not exist`]);
+            else
+                push("log", [line]);
+            timers.delete(label(name));
+        },
+        clear: () => undefined,
+        // Bun: `console.write(...chunks)` writes raw bytes to stdout and returns the byte count.
+        write: (...chunks) => {
+            const text = chunks.map((c) => (typeof c === "string" ? c : c instanceof Uint8Array ? new TextDecoder().decode(c) : String(c))).join("");
+            push("log", [text.replace(/\n$/, "")]);
+            return new TextEncoder().encode(text).length;
+        },
+    };
+    const originals = new Map();
+    const names = new Set([...Object.keys(handlers), ...Object.getOwnPropertyNames(console)]);
+    for (const name of names) {
+        if (name === "Console" || name.startsWith("_"))
+            continue;
+        const current = target[name];
+        if (!(name in handlers) && typeof current !== "function")
+            continue;
+        originals.set(name, Object.getOwnPropertyDescriptor(console, name));
+        // Anything else (`profile`, `timeStamp`, Bun's `record` / `screenshot`, …) becomes a no-op.
+        const fn = handlers[name] ?? (() => undefined);
+        try {
+            Object.defineProperty(console, name, { value: fn, writable: true, configurable: true, enumerable: true });
+        }
+        catch {
+            target[name] = fn;
+        }
+    }
+    let restored = false;
+    return {
+        restore() {
+            if (restored)
+                return;
+            restored = true;
+            for (const [name, desc] of originals) {
+                if (desc)
+                    Object.defineProperty(console, name, desc);
+                else
+                    delete target[name];
+            }
+        },
+    };
+}
+//# sourceMappingURL=logs.js.map

package/dist/mcp/logs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logs.js","sourceRoot":"","sources":["../../src/mcp/logs.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAiB9C,MAAM,WAAW,GAAG,KAAK,CAAC;AAE1B,+FAA+F;AAC/F,MAAM,UAAU,QAAQ,CAAC,KAAc;IACrC,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,SAAS,CAAC;IAClE,MAAM,IAAI,GAAI,KAA4B,CAAC,IAAI,CAAC;IAChD,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IACpE,MAAM,OAAO,GAAI,KAA+B,CAAC,OAAO,CAAC;IACzD,IAAI,OAAO,OAAO,KAAK,QAAQ;QAAE,OAAO,eAAe,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IAC3E,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,aAAa,CAAC,IAAwB;IACpD,IAAI,IAAI,GAAG,IAAI,CAAC;IAChB,MAAM,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;IACpB,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QAClD,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QAC3B,MAAM,IAAI,GAAc,EAAE,CAAC;QAC3B,IAAI,IAAI,GAAG,CAAC,CAAC;QACb,MAAM,GAAG,GAAG,GAAG,CAAC,OAAO,CAAC,eAAe,EAAE,CAAC,KAAK,EAAE,EAAE;YACjD,IAAI,KAAK,KAAK,IAAI;gBAAE,OAAO,KAAK,CAAC;YACjC,IAAI,IAAI,IAAI,IAAI,CAAC,MAAM;gBAAE,OAAO,KAAK,CAAC;YACtC,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;YACzB,IAAI,KAAK,KAAK,IAAI;gBAAE,OAAO,EAAE,CAAC;YAC9B,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YACf,OAAO,KAAK,CAAC;QACf,CAAC,CAAC,CAAC;QACH,IAAI,GAAG,CAAC,GAAG,EAAE,GAAG,IAAI,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;IAC7C,CAAC;IACD,MAAM,IAAI,GAAG,iBAAiB,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,EAAE,WAAW,EAAE,GAAG,EAAE,EAAE,GAAG,IAAI,CAAC,CAAC;IACvF,OAAO,IAAI,CAAC,MAAM,GAAG,WAAW,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,WAAW,CAAC,MAAM,IAAI,CAAC,MAAM,GAAG,WAAW,cAAc,CAAC,CAAC,CAAC,IAAI,CAAC;AACvH,CAAC;AAED,MAAM,OAAO,SAAS;IAMS;IALZ,OAAO,GAAe,EAAE,CAAC;IAClC,GAAG,GAAG,CAAC,CAAC;IACC,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACrB,SAAS,GAAG,IAAI,GAAG,EAA6B,CAAC;IAElE,YAA6B,WAAW,KAAK;QAAhB,aAAQ,GAAR,QAAQ,CAAQ;IAAG,CAAC;IAEjD,qFAAqF;IACrF,IAAI,CAAC,KAAe,EAAE,MAA0B,EAAE,IAAwB,EAAE,MAAM,GAAG,CAAC;QACpF,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,SAAS,CAAC,CAAC;QAC7D,MAAM,IAAI,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC;QACjC,MAAM,OAAO,GAAG,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QAC7E,MAAM,KAAK,GAAa,EAAE,GAAG,EAAE,EAAE,IAAI,CAAC,GAAG,EAAE,CAAC,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;QAC7H,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACzB,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,QAAQ;YAAE,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,EAAE,IAAI,CAAC,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC;QACrG,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,SAAS;YAAE,CAAC,CAAC,KAAK,CAAC,CAAC;QACzC,OAAO,KAAK,CAAC;IACf,CAAC;IAED,6EAA6E;IAC7E,IAAI,CAAC,UAA4E,EAAE;QACjF,MAAM,EAAE,KAAK,GAAG,CAAC,EAAE,MAAM,EAAE,KAAK,GAAG,GAAG,EAAE,GAAG,OAAO,CAAC;QACnD,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,GAAG,KAAK,IAAI,CAAC,CAAC,MAAM,IAAI,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QAC/F,OAAO,KAAK,GAAG,CAAC,IAAI,GAAG,CAAC,MAAM,GAAG,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;IAC/E,CAAC;IAED,6CAA6C;IAC7C,IAAI,MAAM;QACR,OAAO,IAAI,CAAC,GAAG,CAAC;IAClB,CAAC;IAED,mCAAmC;IACnC,WAAW,CAAC,KAAa;QACvB,IAAI,CAAC,GAAG,CAAC,CAAC;QACV,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,OAAO;YAAE,IAAI,CAAC,CAAC,GAAG,GAAG,KAAK,IAAI,CAAC,CAAC,KAAK,KAAK,OAAO;gBAAE,CAAC,EAAE,CAAC;QAC5E,OAAO,CAAC,CAAC;IACX,CAAC;IAED,KAAK;QACH,IAAI,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC;IAC1B,CAAC;IAED,OAAO,CAAC,QAAmC;QACzC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAC7B,OAAO,GAAG,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IAC/C,CAAC;CACF;AAQD;;;;;;;;GAQG;AACH,MAAM,UAAU,cAAc,CAAC,MAAiB,EAAE,MAAkC;IAClF,MAAM,MAAM,GAAG,OAA6C,CAAC;IAC7D,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,MAAM,MAAM,GAAG,IAAI,GAAG,EAAkB,CAAC;IACzC,MAAM,MAAM,GAAG,IAAI,GAAG,EAAkB,CAAC;IACzC,MAAM,IAAI,GAAG,CAAC,KAAe,EAAE,IAAwB,EAAQ,EAAE;QAC/D,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC;QACzD,MAAM,EAAE,CAAC,KAAK,CAAC,CAAC;IAClB,CAAC,CAAC;IACF,MAAM,KAAK,GAAG,CAAC,CAAU,EAAU,EAAE,CAAC,CAAC,CAAC,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;IAChF,MAAM,OAAO,GAAG,CAAC,IAAY,EAAiB,EAAE;QAC9C,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAC/B,IAAI,KAAK,KAAK,SAAS;YAAE,OAAO,IAAI,CAAC;QACrC,OAAO,GAAG,IAAI,KAAK,CAAC,WAAW,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC;IAChE,CAAC,CAAC;IAEF,MAAM,QAAQ,GAA8B;QAC1C,GAAG,EAAE,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;QAC7B,IAAI,EAAE,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;QAC/B,IAAI,EAAE,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;QAC/B,KAAK,EAAE,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;QACjC,KAAK,EAAE,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;QACjC,GAAG,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,GAAG,CAAC,CAAC;QAChC,MAAM,EAAE,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;QAChC,KAAK,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,EAAE,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QACvF,KAAK,EAAE,CAAC,GAAG,CAAC,EAAE,EAAE;YACd,MAAM,KAAK,GAAG,IAAI,KAAK,EAAE,CAAC,KAAK,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;YACvE,IAAI,CAAC,OAAO,EAAE,CAAC,QAAQ,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,aAAa,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,KAAK,CAAC,CAAC,CAAC,KAAK,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;QACrG,CAAC;QACD,MAAM,EAAE,CAAC,SAAS,EAAE,GAAG,CAAC,EAAE,EAAE;YAC1B,IAAI,SAAS;gBAAE,OAAO;YACtB,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,mBAAmB,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC;QACnF,CAAC;QACD,KAAK,EAAE,CAAC,IAAI,EAAE,EAAE;YACd,MAAM,GAAG,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC;YACxB,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;YACrC,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;YACnB,IAAI,CAAC,KAAK,EAAE,CAAC,GAAG,GAAG,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC;QAChC,CAAC;QACD,UAAU,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,KAAK,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACrD,KAAK,EAAE,CAAC,GAAG,CAAC,EAAE,EAAE;YACd,IAAI,CAAC,CAAC,MAAM,GAAG,CAAC;gBAAE,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;YACjC,KAAK,EAAE,CAAC;QACV,CAAC;QACD,cAAc,EAAE,CAAC,GAAG,CAAC,EAAE,EAAE;YACvB,IAAI,CAAC,CAAC,MAAM,GAAG,CAAC;gBAAE,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;YACjC,KAAK,EAAE,CAAC;QACV,CAAC;QACD,QAAQ,EAAE,GAAG,EAAE;YACb,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC;QACjC,CAAC;QACD,IAAI,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,KAAK,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,WAAW,CAAC,GAAG,EAAE,CAAC;QAC/D,OAAO,EAAE,CAAC,IAAI,EAAE,GAAG,CAAC,EAAE,EAAE;YACtB,MAAM,IAAI,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;YAClC,IAAI,IAAI,KAAK,IAAI;gBAAE,IAAI,CAAC,MAAM,EAAE,CAAC,UAAU,KAAK,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC,CAAC;;gBACtE,IAAI,CAAC,KAAK,EAAE,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC;QACjC,CAAC;QACD,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE;YAChB,MAAM,IAAI,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;YAClC,IAAI,IAAI,KAAK,IAAI;gBAAE,IAAI,CAAC,MAAM,EAAE,CAAC,UAAU,KAAK,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC,CAAC;;gBACtE,IAAI,CAAC,KAAK,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC;YACzB,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;QAC7B,CAAC;QACD,KAAK,EAAE,GAAG,EAAE,CAAC,SAAS;QACtB,yFAAyF;QACzF,KAAK,EAAE,CAAC,GAAG,MAAM,EAAE,EAAE;YACnB,MAAM,IAAI,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,YAAY,UAAU,CAAC,CAAC,CAAC,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACzI,IAAI,CAAC,KAAK,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC;YACvC,OAAO,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC;QAC/C,CAAC;KACF,CAAC;IAEF,MAAM,SAAS,GAAG,IAAI,GAAG,EAA0C,CAAC;IACpE,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,GAAG,MAAM,CAAC,mBAAmB,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;IAC1F,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,IAAI,KAAK,SAAS,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;YAAE,SAAS;QACzD,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC;QAC7B,IAAI,CAAC,CAAC,IAAI,IAAI,QAAQ,CAAC,IAAI,OAAO,OAAO,KAAK,UAAU;YAAE,SAAS;QACnE,SAAS,CAAC,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,wBAAwB,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC;QACpE,4FAA4F;QAC5F,MAAM,EAAE,GAAG,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;QAC/C,IAAI,CAAC;YACH,MAAM,CAAC,cAAc,CAAC,OAAO,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC,CAAC;QAC5G,CAAC;QAAC,MAAM,CAAC;YACP,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC;QACpB,CAAC;IACH,CAAC;IACD,IAAI,QAAQ,GAAG,KAAK,CAAC;IACrB,OAAO;QACL,OAAO;YACL,IAAI,QAAQ;gBAAE,OAAO;YACrB,QAAQ,GAAG,IAAI,CAAC;YAChB,KAAK,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,SAAS,EAAE,CAAC;gBACrC,IAAI,IAAI;oBAAE,MAAM,CAAC,cAAc,CAAC,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;;oBAChD,OAAO,MAAM,CAAC,IAAI,CAAC,CAAC;YAC3B,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/mcp/server.d.ts

@@ -0,0 +1,64 @@
+/**
+ * The `text mcp` tool surface: an MCP server whose tools drive a headless
+ * Text.js app session (see `session.ts`).
+ */
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { type StyledRow } from "./frame.js";
+import { LogBuffer } from "./logs.js";
+import { HeadlessSession, type FrameSnapshot, type SessionOptions } from "./session.js";
+export interface TextMcpServerOptions extends SessionOptions {
+    /** Server name reported to clients (default `"textjs"`). */
+    name?: string;
+    /**
+     * Route `console.*` into the `logs` tool while the server runs (default
+     * `true`). Off when the caller already captures (the `text mcp` CLI does,
+     * before anything else loads).
+     */
+    captureConsole?: boolean;
+}
+/** Mutex: tool calls run one at a time so input order is deterministic. */
+export declare class Lock {
+    private tail;
+    /** Wait for every earlier holder to release, then hold the lock until `release()` is called. */
+    acquire(): Promise<() => void>;
+}
+export declare class TimeoutError extends Error {
+}
+/**
+ * Race `work` against `ms`. On timeout the caller gets a {@link TimeoutError}
+ * at once and `controller` is aborted so cancellable work stops.
+ */
+export declare function withTimeout<T>(work: Promise<T>, ms: number, label: string, controller?: AbortController): Promise<T>;
+/** Owns the session lifecycle: the app loads in the background so the MCP handshake never waits on it. */
+export declare class SessionController {
+    private readonly options;
+    private readonly shouldCapture;
+    private session;
+    private starting;
+    private capture;
+    readonly logs: LogBuffer;
+    constructor(options: SessionOptions, shouldCapture?: boolean);
+    /** Start loading the app (idempotent). */
+    start(): Promise<HeadlessSession>;
+    get(): Promise<HeadlessSession>;
+    /** Reload the running session, or retry a failed start. */
+    reload(): Promise<{
+        session: HeadlessSession;
+        purged: number;
+    }>;
+    dispose(): Promise<void>;
+}
+/** Header lines + the frame text, the default content of every frame-returning tool. */
+export declare function formatFrame(f: FrameSnapshot): string;
+/**
+ * Styled runs as compact lines for the text content (the JSON lives once, in
+ * `structuredContent.styles`): `y x+width fg bg attrs "text"`, skipping
+ * blank default-styled runs.
+ */
+export declare function formatStyles(rows: readonly StyledRow[]): string;
+/** Create the MCP server. Call `controller.start()` (or any tool) to load the app. */
+export declare function createTextMcpServer(options: TextMcpServerOptions): {
+    server: McpServer;
+    controller: SessionController;
+};
+//# sourceMappingURL=server.d.ts.map

package/dist/mcp/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/mcp/server.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAIpE,OAAO,EAAY,KAAK,SAAS,EAAE,MAAM,SAAS,CAAC;AAGnD,OAAO,EAAkB,SAAS,EAAgD,MAAM,QAAQ,CAAC;AACjG,OAAO,EAAE,eAAe,EAAgB,KAAK,aAAa,EAAE,KAAK,cAAc,EAAE,MAAM,WAAW,CAAC;AAEnG,MAAM,WAAW,oBAAqB,SAAQ,cAAc;IAC1D,4DAA4D;IAC5D,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;;OAIG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAMD,2EAA2E;AAC3E,qBAAa,IAAI;IACf,OAAO,CAAC,IAAI,CAAoC;IAEhD,gGAAgG;IAC1F,OAAO,IAAI,OAAO,CAAC,MAAM,IAAI,CAAC;CAUrC;AAED,qBAAa,YAAa,SAAQ,KAAK;CAAG;AAE1C;;;GAGG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,CAAC,CAAC,CAUpH;AAED,0GAA0G;AAC1G,qBAAa,iBAAiB;IAO1B,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,aAAa;IAPhC,OAAO,CAAC,OAAO,CAAgC;IAC/C,OAAO,CAAC,QAAQ,CAAyC;IACzD,OAAO,CAAC,OAAO,CAA+B;IAC9C,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;gBAGN,OAAO,EAAE,cAAc,EACvB,aAAa,UAAO;IAKvC,0CAA0C;IAC1C,KAAK,IAAI,OAAO,CAAC,eAAe,CAAC;IAmBjC,GAAG,IAAI,OAAO,CAAC,eAAe,CAAC;IAI/B,2DAA2D;IACrD,MAAM,IAAI,OAAO,CAAC;QAAE,OAAO,EAAE,eAAe,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAM/D,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CAQ/B;AA8BD,wFAAwF;AACxF,wBAAgB,WAAW,CAAC,CAAC,EAAE,aAAa,GAAG,MAAM,CAapD;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,SAAS,SAAS,EAAE,GAAG,MAAM,CAS/D;AAyBD,sFAAsF;AACtF,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,oBAAoB,GAAG;IAAE,MAAM,EAAE,SAAS,CAAC;IAAC,UAAU,EAAE,iBAAiB,CAAA;CAAE,CAsYvH"}