trellis-herbivore 0.1.0

package/dist/commands/channel/kill.js

@@ -0,0 +1,121 @@
+import fs from "node:fs";
+import { appendEvent } from "./store/events.js";
+import { withLock } from "./store/lock.js";
+import { resolveExistingChannelRef, workerFile, workerLockPath, } from "./store/paths.js";
+import { parseChannelScope } from "./store/schema.js";
+const POLL_INTERVAL_MS = 100;
+const KILL_GRACE_MS = 8000; // generous: supervisor's own grace is ~6s
+export async function channelKill(channelName, opts) {
+    const ref = resolveExistingChannelRef(channelName, {
+        scope: parseChannelScope(opts.scope),
+    });
+    // Take the worker lock so kill ↔ spawn can't race: spawn won't claim a
+    // stale pid file while we're tearing it down; we won't try to kill a
+    // worker whose pid file is mid-creation.
+    return withLock(workerLockPath(channelName, opts.as, ref.project), () => killLocked(channelName, opts, ref.project), { maxWaitMs: KILL_GRACE_MS + 2000 });
+}
+async function killLocked(channelName, opts, project) {
+    const pidPath = workerFile(channelName, opts.as, "pid", project);
+    if (!fs.existsSync(pidPath)) {
+        throw new Error(`Worker '${opts.as}' not running in channel '${channelName}'`);
+    }
+    const supervisorPid = Number(fs.readFileSync(pidPath, "utf-8").trim());
+    if (!supervisorPid || !alive(supervisorPid)) {
+        await appendEvent(channelName, {
+            kind: "error",
+            by: `cli:kill`,
+            message: `supervisor lost (pid ${supervisorPid})`,
+            worker: opts.as,
+        }, project);
+        cleanupFiles(channelName, opts.as, project);
+        return;
+    }
+    if (opts.force) {
+        // Also kill the inner worker so it doesn't become an orphan.
+        const workerPidPath = workerFile(channelName, opts.as, "worker-pid", project);
+        if (fs.existsSync(workerPidPath)) {
+            const wpid = Number(fs.readFileSync(workerPidPath, "utf-8").trim());
+            if (wpid && alive(wpid)) {
+                try {
+                    process.kill(wpid, "SIGKILL");
+                }
+                catch {
+                    // already dead
+                }
+            }
+        }
+        try {
+            process.kill(supervisorPid, "SIGKILL");
+        }
+        catch {
+            // already dead
+        }
+        // SIGKILL skips supervisor's onShutdown handler, so the `killed`
+        // event would never make it into events.jsonl. Write it from here
+        // so forensic readers see the kill happened.
+        await appendEvent(channelName, {
+            kind: "killed",
+            by: "cli:kill",
+            worker: opts.as,
+            reason: "explicit-kill",
+            signal: "SIGKILL",
+        }, project);
+    }
+    else {
+        try {
+            process.kill(supervisorPid, "SIGTERM");
+        }
+        catch {
+            // already dead
+        }
+    }
+    // Wait for supervisor to actually exit
+    const deadline = Date.now() + KILL_GRACE_MS;
+    while (alive(supervisorPid) && Date.now() < deadline) {
+        await sleep(POLL_INTERVAL_MS);
+    }
+    if (alive(supervisorPid)) {
+        // Grace expired — force kill. Supervisor's onShutdown handler never
+        // got to fire (or it deadlocked), so we write the `killed` event from
+        // the CLI side to keep the channel log truthful.
+        try {
+            process.kill(supervisorPid, "SIGKILL");
+        }
+        catch {
+            // already dead
+        }
+        await appendEvent(channelName, {
+            kind: "killed",
+            by: "cli:kill",
+            worker: opts.as,
+            reason: "explicit-kill",
+            signal: "SIGKILL",
+            detail: "grace expired, supervisor SIGKILL'd by CLI",
+        }, project);
+    }
+    cleanupFiles(channelName, opts.as, project);
+}
+function alive(pid) {
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function cleanupFiles(channelName, worker, project) {
+    // Keep `log` (forensic), `session-id` / `thread-id` (resume).
+    for (const suffix of ["pid", "worker-pid", "config", "spawnlock"]) {
+        try {
+            fs.unlinkSync(workerFile(channelName, worker, suffix, project));
+        }
+        catch {
+            // already gone
+        }
+    }
+}
+function sleep(ms) {
+    return new Promise((r) => setTimeout(r, ms));
+}
+//# sourceMappingURL=kill.js.map

package/dist/commands/channel/kill.js.map

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

package/dist/commands/channel/list.d.ts

@@ -0,0 +1,17 @@
+/**
+ * `trellis channel list` — table summary of all channels in `~/.trellis/channels/`.
+ *
+ * Columns: name, created (ts), workers (alive/total), last activity, task.
+ * Sorted by most recent activity first.
+ */
+export interface ListOptions {
+    json?: boolean;
+    project?: string;
+    /** Include ephemeral channels in the output (default: hide them). */
+    all?: boolean;
+    /** Scan every project bucket, not just the current cwd's. */
+    allProjects?: boolean;
+    scope?: string;
+}
+export declare function channelList(opts?: ListOptions): Promise<void>;
+//# sourceMappingURL=list.d.ts.map

package/dist/commands/channel/list.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list.d.ts","sourceRoot":"","sources":["../../../src/commands/channel/list.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAuCH,MAAM,WAAW,WAAW;IAC1B,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,qEAAqE;IACrE,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,6DAA6D;IAC7D,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,wBAAsB,WAAW,CAAC,IAAI,GAAE,WAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CA8EvE"}

package/dist/commands/channel/list.js

@@ -0,0 +1,233 @@
+/**
+ * `trellis channel list` — table summary of all channels in `~/.trellis/channels/`.
+ *
+ * Columns: name, created (ts), workers (alive/total), last activity, task.
+ * Sorted by most recent activity first.
+ */
+import fs from "node:fs";
+import path from "node:path";
+import chalk from "chalk";
+import { isCreateEvent, reduceChannelMetadata, } from "./store/events.js";
+import { channelDir, currentProjectKey, listProjects, migrateLegacyChannels, projectDir, } from "./store/paths.js";
+import { GLOBAL_PROJECT_KEY, parseChannelScope } from "./store/schema.js";
+export async function channelList(opts = {}) {
+    // Move any pre-bucket flat channels into `_legacy/` before listing,
+    // so the new layout is the authoritative view.
+    migrateLegacyChannels();
+    const scope = parseChannelScope(opts.scope);
+    const projects = scope === "global"
+        ? [GLOBAL_PROJECT_KEY]
+        : opts.allProjects
+            ? listProjects()
+            : [currentProjectKey()];
+    const summaries = [];
+    for (const project of projects) {
+        const dir = projectDir(project);
+        if (!fs.existsSync(dir))
+            continue;
+        let names;
+        try {
+            names = fs.readdirSync(dir).filter((n) => {
+                if (n.startsWith("."))
+                    return false; // skip .bucket marker etc.
+                try {
+                    return fs.statSync(path.join(dir, n)).isDirectory();
+                }
+                catch {
+                    return false;
+                }
+            });
+        }
+        catch {
+            continue;
+        }
+        for (const name of names) {
+            const s = summarize(name, project);
+            if (s)
+                summaries.push(s);
+        }
+    }
+    // Filter by project (matches task substring for now)
+    const projectFilter = opts.project;
+    let filtered = projectFilter
+        ? summaries.filter((s) => s.task?.includes(projectFilter))
+        : summaries;
+    // Hide ephemeral channels unless --all (keeps the default `list`
+    // uncluttered after lots of one-shot CR / brainstorm sessions).
+    const ephemeralHidden = opts.all
+        ? 0
+        : filtered.filter((s) => s.ephemeral).length;
+    if (!opts.all) {
+        filtered = filtered.filter((s) => !s.ephemeral);
+    }
+    // Sort by last activity desc; channels without activity bubble to bottom
+    filtered.sort((a, b) => {
+        const ta = a.lastEventTs ?? "";
+        const tb = b.lastEventTs ?? "";
+        return tb.localeCompare(ta);
+    });
+    if (opts.json) {
+        console.log(JSON.stringify(filtered, null, 2));
+        return;
+    }
+    if (filtered.length === 0) {
+        console.log("(no channels match)");
+        if (ephemeralHidden > 0) {
+            console.log(`(${ephemeralHidden} ephemeral channel${ephemeralHidden === 1 ? "" : "s"} hidden — use --all to show)`);
+        }
+        return;
+    }
+    printTable(filtered);
+    if (ephemeralHidden > 0) {
+        console.log(`\n(${ephemeralHidden} ephemeral channel${ephemeralHidden === 1 ? "" : "s"} hidden — use --all to show)`);
+    }
+}
+function summarize(name, project) {
+    const dir = channelDir(name, project);
+    const eventsFile = path.join(dir, "events.jsonl");
+    if (!fs.existsSync(eventsFile))
+        return null;
+    // Read events to find: createdAt + task, last event ts/kind, total
+    // count. Channels stay small (no auto-rotation; ~few MB at worst), so
+    // a single full readFile per `list` invocation is fine.
+    let firstEvent = null;
+    let lastEvent = null;
+    let totalEvents = 0;
+    const events = [];
+    try {
+        const allText = fs.readFileSync(eventsFile, "utf-8");
+        const lines = allText.split("\n").filter((l) => l.trim());
+        totalEvents = lines.length;
+        for (const line of lines) {
+            try {
+                events.push(JSON.parse(line));
+            }
+            catch {
+                // skip corrupted lines
+            }
+        }
+        if (events.length > 0) {
+            const first = events[0];
+            firstEvent = isCreateEvent(first) ? first : null;
+            lastEvent = events[events.length - 1];
+        }
+    }
+    catch {
+        return null;
+    }
+    // Worker counts: scan *.pid files in dir, probe each pid.
+    let workersAlive = 0;
+    let workersTotal = 0;
+    try {
+        const entries = fs.readdirSync(dir);
+        for (const e of entries) {
+            if (!e.endsWith(".pid"))
+                continue;
+            workersTotal++;
+            const pidFile = path.join(dir, e);
+            const pid = Number(fs.readFileSync(pidFile, "utf-8").trim());
+            if (pid && pidAlive(pid))
+                workersAlive++;
+        }
+    }
+    catch {
+        // ignore
+    }
+    // Use the full event-stream reducer so projected metadata reflects
+    // title set/clear, context add/delete, and legacy linkedContext.
+    const metadata = reduceChannelMetadata(events);
+    return {
+        name,
+        project,
+        createdAt: firstEvent?.ts,
+        task: firstEvent?.task,
+        type: metadata.type,
+        description: metadata.title ?? metadata.description,
+        workersAlive,
+        workersTotal,
+        lastEventTs: lastEvent?.ts,
+        lastEventKind: lastEvent?.kind,
+        totalEvents,
+        ephemeral: firstEvent?.ephemeral === true,
+    };
+}
+function pidAlive(pid) {
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function printTable(rows) {
+    const cols = [
+        { key: "name", label: "NAME", width: 24 },
+        { key: "workers", label: "WORKERS", width: 9 },
+        { key: "events", label: "EVENTS", width: 7 },
+        { key: "last", label: "LAST", width: 19 },
+        { key: "kind", label: "KIND", width: 9 },
+        { key: "type", label: "TYPE", width: 7 },
+        { key: "task", label: "TASK", width: 0 }, // last column, no truncate
+    ];
+    // Header
+    console.log(chalk.bold(cols.map((c) => (c.width ? c.label.padEnd(c.width) : c.label)).join("  ")));
+    // Rows
+    for (const r of rows) {
+        const displayName = r.ephemeral ? `${r.name} *` : r.name;
+        const name = trunc(displayName, cols[0].width);
+        const workers = r.workersAlive > 0
+            ? chalk.green(`${r.workersAlive}/${r.workersTotal}`)
+            : r.workersTotal > 0
+                ? chalk.gray(`0/${r.workersTotal}`)
+                : chalk.gray("-");
+        const events = String(r.totalEvents);
+        const last = r.lastEventTs
+            ? r.lastEventTs.slice(0, 19).replace("T", " ")
+            : "-";
+        const kind = colorKind(r.lastEventKind);
+        const task = r.task ?? r.description ?? "-";
+        console.log([
+            name.padEnd(cols[0].width),
+            // workers cell needs visible-width padding (chalk adds ANSI bytes)
+            padVisible(workers, cols[1].width),
+            events.padEnd(cols[2].width),
+            last.padEnd(cols[3].width),
+            padVisible(kind, cols[4].width),
+            r.type.padEnd(cols[5].width),
+            task,
+        ].join("  "));
+    }
+}
+function trunc(s, w) {
+    if (s.length <= w)
+        return s;
+    return s.slice(0, w - 1) + "…";
+}
+/** Pad a string accounting for ANSI escape codes which take 0 visible width. */
+function padVisible(s, w) {
+    // eslint-disable-next-line no-control-regex
+    const visible = s.replace(/\x1b\[[0-9;]*m/g, "");
+    const pad = Math.max(0, w - visible.length);
+    return s + " ".repeat(pad);
+}
+function colorKind(k) {
+    if (!k)
+        return chalk.gray("-");
+    switch (k) {
+        case "done":
+            return chalk.green(k);
+        case "error":
+        case "killed":
+            return chalk.red(k);
+        case "spawned":
+            return chalk.cyan(k);
+        case "message":
+            return chalk.yellow(k);
+        case "progress":
+            return chalk.gray(k);
+        default:
+            return k;
+    }
+}
+//# sourceMappingURL=list.js.map

package/dist/commands/channel/list.js.map

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

package/dist/commands/channel/messages.d.ts

@@ -0,0 +1,16 @@
+export interface MessagesOptions {
+    raw?: boolean;
+    follow?: boolean;
+    last?: number;
+    since?: number;
+    kind?: string;
+    from?: string;
+    to?: string;
+    noProgress?: boolean;
+    tag?: string;
+    scope?: string;
+    thread?: string;
+    action?: string;
+}
+export declare function channelMessages(channelName: string, opts: MessagesOptions): Promise<void>;
+//# sourceMappingURL=messages.d.ts.map

package/dist/commands/channel/messages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"messages.d.ts","sourceRoot":"","sources":["../../../src/commands/channel/messages.ts"],"names":[],"mappings":"AAuBA,MAAM,WAAW,eAAe;IAC9B,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,wBAAsB,eAAe,CACnC,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE,eAAe,GACpB,OAAO,CAAC,IAAI,CAAC,CAwEf"}

package/dist/commands/channel/messages.js

@@ -0,0 +1,237 @@
+import fs from "node:fs";
+import chalk from "chalk";
+import { parseChannelKind, readChannelEvents, readChannelMetadata, } from "./store/events.js";
+import { matchesEventFilter } from "./store/filter.js";
+import { eventsPath, resolveExistingChannelRef } from "./store/paths.js";
+import { normalizeThreadKey, parseCsv, parseChannelScope, parseThreadAction, } from "./store/schema.js";
+import { formatThreadBoard, reduceThreads } from "./store/thread-state.js";
+import { watchEvents } from "./store/watch.js";
+export async function channelMessages(channelName, opts) {
+    const ref = resolveExistingChannelRef(channelName, {
+        scope: parseChannelScope(opts.scope),
+    });
+    const file = eventsPath(channelName, ref.project);
+    if (!fs.existsSync(file)) {
+        throw new Error(`Channel '${channelName}' not found at ${file}`);
+    }
+    const all = await readChannelEvents(channelName, ref.project);
+    const fromList = parseCsv(opts.from);
+    // Validate --kind against whitelist up front so typos fail fast.
+    const kindFilter = parseChannelKind(opts.kind);
+    const threadFilter = opts.thread
+        ? normalizeThreadKey(opts.thread)
+        : undefined;
+    const actionFilter = opts.action
+        ? parseThreadAction(opts.action)
+        : undefined;
+    const metadata = await readChannelMetadata(channelName, ref.project);
+    if (metadata.type === "chat" && (threadFilter || actionFilter)) {
+        throw new Error(`Channel '${channelName}' is type 'chat'. --thread/--action require a thread channel.`);
+    }
+    const filter = {
+        kind: kindFilter,
+        from: fromList,
+        to: opts.to,
+        tag: opts.tag,
+        thread: threadFilter,
+        action: actionFilter,
+        includeProgress: !opts.noProgress,
+        includeNonMeaningful: true,
+    };
+    const filtered = all.filter((ev) => {
+        if (opts.since !== undefined && ev.seq <= opts.since)
+            return false;
+        return matchesEventFilter(ev, filter);
+    });
+    const view = opts.last ? filtered.slice(-opts.last) : filtered;
+    const threadBoardView = !opts.raw &&
+        metadata.type === "threads" &&
+        !threadFilter &&
+        !kindFilter &&
+        !actionFilter &&
+        !opts.from &&
+        !opts.to &&
+        !opts.tag;
+    if (threadBoardView) {
+        console.log("Thread channel: showing threads. Use --thread <key> for timeline, --raw for event log.");
+        printThreadBoard(view);
+    }
+    else {
+        for (const ev of view)
+            printEvent(ev, opts.raw ?? false);
+    }
+    if (opts.follow) {
+        const abort = new AbortController();
+        process.on("SIGINT", () => abort.abort());
+        for await (const ev of watchEvents(channelName, filter, {
+            signal: abort.signal,
+            project: ref.project,
+        })) {
+            printEvent(ev, opts.raw ?? false);
+        }
+    }
+}
+function printEvent(ev, raw) {
+    if (raw) {
+        console.log(JSON.stringify(ev));
+        return;
+    }
+    const ts = (ev.ts || "").slice(11, 19);
+    const by = colorBy(ev.by);
+    switch (ev.kind) {
+        case "create": {
+            const cwd = ev.cwd ?? "";
+            const task = ev.task ?? "";
+            printLine(`${kindTag("create")} by=${by}  cwd=${cwd}${task ? "  task=" + task : ""}`, ts);
+            if (ev.description)
+                console.log(`         ${chalk.dim("description:")} ${ev.description}`);
+            printContext(ev.context ?? ev.linkedContext);
+            break;
+        }
+        case "spawned": {
+            const as = ev.as ?? "?";
+            const provider = ev.provider ?? "?";
+            const pid = ev.pid ?? "?";
+            const agent = ev.agent;
+            const files = ev.files;
+            const manifests = ev.manifests;
+            const agentStr = agent ? `  agent=${chalk.magenta(agent)}` : "";
+            printLine(`${kindTag("spawned")} by=${by}  worker=${colorTo(as)} provider=${provider}${agentStr} pid=${pid}`, ts);
+            if (files && files.length > 0) {
+                console.log(`         ${chalk.dim("files:")} ${files.join(", ")}`);
+            }
+            if (manifests && manifests.length > 0) {
+                console.log(`         ${chalk.dim("manifests:")} ${manifests.join(", ")}`);
+            }
+            break;
+        }
+        case "killed": {
+            const reason = ev.reason ?? "?";
+            const sig = ev.signal ?? "?";
+            printLine(`${kindTag("killed")} by=${by}  reason=${reason} signal=${sig}`, ts);
+            break;
+        }
+        case "message": {
+            const text = (ev.text ?? "").replace(/\n/g, "\n         ");
+            const tag = ev.tag;
+            const to = ev.to;
+            const toStr = to
+                ? `  to=${colorTo(Array.isArray(to) ? to.join(",") : to)}`
+                : "";
+            const tagStr = tag ? `  ${chalk.yellow(`<${tag}>`)}` : "";
+            printLine(`${kindTag("message")} by=${by}${toStr}${tagStr}`, ts);
+            console.log(`         ${text}`);
+            break;
+        }
+        case "thread": {
+            const action = ev.action ?? "?";
+            const text = (ev.text ?? "").replace(/\n/g, "\n         ");
+            printLine(`${kindTag("thread")} by=${by}  ${action} ${ev.thread}`, ts);
+            if (ev.description)
+                console.log(`         ${chalk.dim("description:")} ${ev.description}`);
+            printContext(ev.context ?? ev.linkedContext);
+            if (text)
+                console.log(`         ${text}`);
+            break;
+        }
+        case "done": {
+            const dur = ev.duration_ms;
+            printLine(`${kindTag("done")} by=${by}${dur !== undefined ? "  duration=" + dur + "ms" : ""}`, ts);
+            break;
+        }
+        case "error": {
+            const msg = ev.message ?? "";
+            printLine(`${kindTag("error")} by=${by}  ${msg}`, ts);
+            break;
+        }
+        case "progress": {
+            const detail = ev.detail ?? {};
+            const summary = summarizeProgress(detail);
+            printLine(`${kindTag("progress")} by=${by}  ${summary}`, ts);
+            break;
+        }
+        default: {
+            printLine(`${kindTag(ev.kind)} by=${by}`, ts);
+        }
+    }
+}
+function printContext(context) {
+    if (!context || context.length === 0)
+        return;
+    for (const entry of context) {
+        const detail = entry.type === "file" ? entry.path : summarizeContextText(entry.text);
+        console.log(`         ${chalk.dim(`context:${entry.type}:`)} ${detail}`);
+    }
+}
+function summarizeContextText(text) {
+    const oneLine = text.replace(/\s+/g, " ").trim();
+    return oneLine.length > 100 ? `${oneLine.slice(0, 100)}...` : oneLine;
+}
+function printThreadBoard(events) {
+    for (const line of formatThreadBoard(reduceThreads(events))) {
+        console.log(line);
+    }
+}
+/**
+ * Print `body` right-padded with `ts` at the terminal's right edge. The ANSI
+ * escape codes don't count toward visible width, so we strip them before
+ * computing the pad amount.
+ */
+function printLine(body, ts) {
+    const width = process.stdout.columns || 100;
+    // eslint-disable-next-line no-control-regex
+    const visible = body.replace(/\x1b\[[0-9;]*m/g, "").length;
+    const tsCols = ts.length; // "HH:MM:SS" = 8
+    const gap = Math.max(2, width - visible - tsCols);
+    console.log(body + " ".repeat(gap) + chalk.dim(ts));
+}
+function colorBy(name) {
+    if (name === "main")
+        return chalk.magenta(name);
+    if (name.startsWith("supervisor:") || name.startsWith("cli:")) {
+        return chalk.gray(name);
+    }
+    return chalk.cyan(name);
+}
+function colorTo(name) {
+    return chalk.greenBright(name);
+}
+function kindTag(k) {
+    const padded = `[${k}]`.padEnd(10);
+    switch (k) {
+        case "done":
+            return chalk.green(padded);
+        case "error":
+        case "killed":
+            return chalk.red(padded);
+        case "spawned":
+            return chalk.cyan(padded);
+        case "respawned":
+            return chalk.cyan(padded);
+        case "message":
+            return chalk.yellow(padded);
+        case "thread":
+            return chalk.blue(padded);
+        case "progress":
+            return chalk.gray(padded);
+        case "create":
+            return chalk.blueBright(padded);
+        default:
+            return padded;
+    }
+}
+function summarizeProgress(detail) {
+    const parts = [];
+    for (const key of ["kind", "tool", "tool_name", "server", "status", "cmd"]) {
+        if (detail[key] !== undefined) {
+            const v = String(detail[key]);
+            parts.push(`${key}=${v.length > 60 ? v.slice(0, 60) + "…" : v}`);
+        }
+    }
+    if (detail.text_delta) {
+        const t = String(detail.text_delta);
+        parts.push(`delta="${t.length > 40 ? t.slice(0, 40) + "…" : t}"`);
+    }
+    return parts.join(" ");
+}
+//# sourceMappingURL=messages.js.map