@cursor/july 0.1.2 → 0.1.4

package/dist/internal/stream-progress.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"stream-progress.d.ts","sourceRoot":"","sources":["../../src/internal/stream-progress.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD,MAAM,WAAW,cAAc;IAC7B,OAAO,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI,CAAC;IACnC,KAAK,IAAI,IAAI,CAAC;CACf;AAED,wBAAgB,oBAAoB,CAAC,OAAO,CAAC,EAAE;IAC7C,KAAK,CAAC,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IAC5B,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB,GAAG,cAAc,CAmLjB"}
+{"version":3,"file":"stream-progress.d.ts","sourceRoot":"","sources":["../../src/internal/stream-progress.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD,MAAM,WAAW,cAAc;IAC7B,OAAO,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI,CAAC;IACnC,KAAK,IAAI,IAAI,CAAC;CACf;AAED,wBAAgB,oBAAoB,CAAC,OAAO,CAAC,EAAE;IAC7C,KAAK,CAAC,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IAC5B,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB,GAAG,cAAc,CAqNjB"}

package/dist/internal/stream-progress.js

@@ -21,7 +21,7 @@ export function createStreamProgress(options) {
     const elapsed = (since) => `${Date.now() - since}ms`;
     return {
         onEvent(event) {
-            var _a, _b;
+            var _a, _b, _c;
             switch (event.type) {
                 case "session.started": {
                     write(c.dim(`session ${event.sessionId}\n`));
@@ -49,6 +49,9 @@ export function createStreamProgress(options) {
                     break;
                 }
                 case "reasoning.appended": {
+                    if (event.data.parentCallId !== undefined) {
+                        break;
+                    }
                     if (!thinkingShown) {
                         thinkingShown = true;
                         write(c.dim("  · thinking…\n"));
@@ -56,6 +59,11 @@ export function createStreamProgress(options) {
                     break;
                 }
                 case "message.appended": {
+                    // Nested subagent deltas stay inside the task chip/indent, not
+                    // the parent agent stream.
+                    if (event.data.parentCallId !== undefined) {
+                        break;
+                    }
                     if (!assistantOpen) {
                         write(`${c.green("‹ agent")}  `);
                         assistantOpen = true;
@@ -64,6 +72,9 @@ export function createStreamProgress(options) {
                     break;
                 }
                 case "message.completed": {
+                    if (event.data.parentCallId !== undefined) {
+                        break;
+                    }
                     closeAssistant();
                     break;
                 }
@@ -79,8 +90,16 @@ export function createStreamProgress(options) {
                     closeAssistant();
                     const now = Date.now();
                     for (const call of event.data.calls) {
+                        if (call.toolName === "task" && call.parentCallId === undefined) {
+                            // Covered by subagent.called; avoid a duplicate bare `task` line.
+                            continue;
+                        }
                         toolStartedAt.set(call.callId, now);
-                        write(`  ${c.magenta("⚙")} ${c.bold(call.toolName)}${c.dim(formatArgs(call.args))}\n`);
+                        const indent = call.parentCallId !== undefined ||
+                            event.data.parentCallId !== undefined
+                            ? "    "
+                            : "  ";
+                        write(`${indent}${c.magenta("⚙")} ${c.bold(call.toolName)}${c.dim(formatArgs(call.args))}\n`);
                     }
                     break;
                 }
@@ -95,11 +114,16 @@ export function createStreamProgress(options) {
                     break;
                 }
                 case "action.result": {
+                    if (event.data.toolName === "task" &&
+                        event.data.parentCallId === undefined) {
+                        break;
+                    }
                     const started = toolStartedAt.get(event.data.callId);
                     toolStartedAt.delete(event.data.callId);
                     const dur = started === undefined ? "" : c.dim(` ${elapsed(started)}`);
                     const mark = event.data.isError ? c.red("✗") : c.magenta("✓");
-                    write(`    ${mark} ${c.bold(event.data.toolName)}${dur} ${c.dim(truncate(stringify(event.data.output), 90))}\n`);
+                    const indent = event.data.parentCallId !== undefined ? "      " : "    ";
+                    write(`${indent}${mark} ${c.bold(event.data.toolName)}${dur} ${c.dim(truncate(stringify(event.data.output), 90))}\n`);
                     break;
                 }
                 case "subagent.called": {
@@ -110,6 +134,10 @@ export function createStreamProgress(options) {
                     write(`  ${c.magenta("task")} ${c.bold((_b = event.data.name) !== null && _b !== void 0 ? _b : "subagent")}${c.dim(detail)}\n`);
                     break;
                 }
+                case "subagent.completed": {
+                    write(`  ${c.magenta("✓")} ${c.bold((_c = event.data.name) !== null && _c !== void 0 ? _c : "subagent")} ${c.dim("done")}\n`);
+                    break;
+                }
                 case "turn.completed": {
                     closeAssistant();
                     const usage = event.data.usage;

package/dist/internal/terminal-style.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Tiny ANSI helpers for CLI progress output. Respects `NO_COLOR` and
+ * only enables when the target stream is a TTY.
+ */
+export interface TerminalPalette {
+    dim: (s: string) => string;
+    bold: (s: string) => string;
+    cyan: (s: string) => string;
+    green: (s: string) => string;
+    red: (s: string) => string;
+    magenta: (s: string) => string;
+    yellow: (s: string) => string;
+}
+export declare function colorEnabledFor(stream?: NodeJS.WriteStream): boolean;
+export declare function makePalette(enabled: boolean): TerminalPalette;
+/** Palette for human-facing stdout (init summaries, next steps). */
+export declare function stdoutPalette(): TerminalPalette;
+/** Palette for human-facing stderr (login progress, warnings). */
+export declare function stderrPalette(): TerminalPalette;
+/** Wipe the terminal before a `dev` Enter-to-restart cycle. */
+export declare function clearTerminal(stream?: NodeJS.WriteStream): void;
+//# sourceMappingURL=terminal-style.d.ts.map

package/dist/internal/terminal-style.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminal-style.d.ts","sourceRoot":"","sources":["../../src/internal/terminal-style.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,MAAM,WAAW,eAAe;IAC9B,GAAG,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,CAAC;IAC3B,IAAI,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,CAAC;IAC5B,IAAI,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,CAAC;IAC5B,KAAK,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,CAAC;IAC7B,GAAG,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,CAAC;IAC3B,OAAO,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,CAAC;IAC/B,MAAM,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,CAAC;CAC/B;AAcD,wBAAgB,eAAe,CAC7B,MAAM,GAAE,MAAM,CAAC,WAA4B,GAC1C,OAAO,CAET;AAED,wBAAgB,WAAW,CAAC,OAAO,EAAE,OAAO,GAAG,eAAe,CAiB7D;AAED,oEAAoE;AACpE,wBAAgB,aAAa,IAAI,eAAe,CAE/C;AAED,kEAAkE;AAClE,wBAAgB,aAAa,IAAI,eAAe,CAE/C;AAED,+DAA+D;AAC/D,wBAAgB,aAAa,CAC3B,MAAM,GAAE,MAAM,CAAC,WAA4B,GAC1C,IAAI,CAMN"}

package/dist/internal/terminal-style.js

@@ -0,0 +1,49 @@
+/**
+ * Tiny ANSI helpers for CLI progress output. Respects `NO_COLOR` and
+ * only enables when the target stream is a TTY.
+ */
+import { clearScreenDown, cursorTo } from "node:readline";
+const IDENTITY = (s) => s;
+const PLAIN = {
+    dim: IDENTITY,
+    bold: IDENTITY,
+    cyan: IDENTITY,
+    green: IDENTITY,
+    red: IDENTITY,
+    magenta: IDENTITY,
+    yellow: IDENTITY,
+};
+export function colorEnabledFor(stream = process.stdout) {
+    return stream.isTTY === true && process.env.NO_COLOR === undefined;
+}
+export function makePalette(enabled) {
+    if (!enabled) {
+        return PLAIN;
+    }
+    const wrap = (code) => (s) => `\u001b[${code}m${s}\u001b[0m`;
+    return {
+        dim: wrap("2"),
+        bold: wrap("1"),
+        cyan: wrap("36"),
+        green: wrap("32"),
+        red: wrap("31"),
+        magenta: wrap("35"),
+        yellow: wrap("33"),
+    };
+}
+/** Palette for human-facing stdout (init summaries, next steps). */
+export function stdoutPalette() {
+    return makePalette(colorEnabledFor(process.stdout));
+}
+/** Palette for human-facing stderr (login progress, warnings). */
+export function stderrPalette() {
+    return makePalette(colorEnabledFor(process.stderr));
+}
+/** Wipe the terminal before a `dev` Enter-to-restart cycle. */
+export function clearTerminal(stream = process.stdout) {
+    if (stream.isTTY !== true) {
+        return;
+    }
+    cursorTo(stream, 0, 0);
+    clearScreenDown(stream);
+}

package/dist/internal/trajectory.d.ts

@@ -14,6 +14,15 @@ export interface TrajectoryToolCall {
     isError: boolean;
     /** Present when the tool required human approval before execute. */
     approvalDecision?: "approve" | "deny";
+    /** Parent task/subagent call id when this tool ran inside a subagent. */
+    parentCallId?: string;
+}
+export interface TrajectorySubagent {
+    callId: string;
+    name?: string;
+    description?: string;
+    /** Nested tool calls streamed while this subagent was running. */
+    toolCalls: TrajectoryToolCall[];
 }
 export interface TrajectoryTurn {
     turnId: string;
@@ -21,11 +30,7 @@ export interface TrajectoryTurn {
     assistantText: string;
     reasoningText?: string;
     toolCalls: TrajectoryToolCall[];
-    subagents: Array<{
-        callId: string;
-        name?: string;
-        description?: string;
-    }>;
+    subagents: TrajectorySubagent[];
     usage?: TurnUsage;
     result?: string;
     failed: boolean;

package/dist/internal/trajectory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"trajectory.d.ts","sourceRoot":"","sources":["../../src/internal/trajectory.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE3D,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;IACjB,oEAAoE;IACpE,gBAAgB,CAAC,EAAE,SAAS,GAAG,MAAM,CAAC;CACvC;AAED,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,kBAAkB,EAAE,CAAC;IAChC,SAAS,EAAE,KAAK,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC1E,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,OAAO,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,UAAU;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,EAAE,EAAE,OAAO,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,cAAc,EAAE,CAAC;CACzB;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,YAAY,EAAE,GAAG,UAAU,CAuKlE;AAED,2EAA2E;AAC3E,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,EAAE,CAc9D;AAED,sDAAsD;AACtD,wBAAsB,4BAA4B,CAChD,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,UAAU,CAAC,CAGrB;AAED,uEAAuE;AACvE,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,UAAU,GAAG,MAAM,CAwCnE"}
+{"version":3,"file":"trajectory.d.ts","sourceRoot":"","sources":["../../src/internal/trajectory.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE3D,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;IACjB,oEAAoE;IACpE,gBAAgB,CAAC,EAAE,SAAS,GAAG,MAAM,CAAC;IACtC,yEAAyE;IACzE,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,kEAAkE;IAClE,SAAS,EAAE,kBAAkB,EAAE,CAAC;CACjC;AAED,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,kBAAkB,EAAE,CAAC;IAChC,SAAS,EAAE,kBAAkB,EAAE,CAAC;IAChC,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,OAAO,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,UAAU;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,EAAE,EAAE,OAAO,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,cAAc,EAAE,CAAC;CACzB;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,YAAY,EAAE,GAAG,UAAU,CA4NlE;AAED,2EAA2E;AAC3E,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,EAAE,CAc9D;AAED,sDAAsD;AACtD,wBAAsB,4BAA4B,CAChD,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,UAAU,CAAC,CAGrB;AAED,uEAAuE;AACvE,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,UAAU,GAAG,MAAM,CAuDnE"}

package/dist/internal/trajectory.js

@@ -20,7 +20,7 @@ import { readFile } from "node:fs/promises";
  * folded into final assistant / reasoning text per turn.
  */
 export function buildTrajectory(events) {
-    var _a;
+    var _a, _b;
     let sessionId = "";
     let sdkAgentId;
     let agentUrl;
@@ -65,12 +65,20 @@ export function buildTrajectory(events) {
                 break;
             }
             case "message.completed": {
+                // Nested subagent text must not overwrite the parent turn reply.
+                if (event.data.parentCallId !== undefined) {
+                    break;
+                }
                 if (event.turnId !== undefined && event.data.text !== "") {
                     ensureTurn(event.turnId).assistantText = event.data.text;
                 }
                 break;
             }
             case "reasoning.appended": {
+                // Nested subagent thinking stays off the parent turn transcript.
+                if (event.data.parentCallId !== undefined) {
+                    break;
+                }
                 if (event.turnId !== undefined) {
                     ensureTurn(event.turnId).reasoningText = event.data.text;
                 }
@@ -82,9 +90,29 @@ export function buildTrajectory(events) {
                 }
                 const turn = ensureTurn(event.turnId);
                 for (const call of event.data.calls) {
-                    const entry = Object.assign({ callId: call.callId, toolName: call.toolName, isError: false }, (call.args === undefined ? {} : { args: call.args }));
+                    const parentCallId = (_a = call.parentCallId) !== null && _a !== void 0 ? _a : event.data.parentCallId;
+                    // Keep bare top-level `task` in toolCalls so evals like
+                    // `calledTool("task")` / `notCalledTool("task")` keep working.
+                    // Nested progress also appears under `subagents`.
+                    const entry = {
+                        callId: call.callId,
+                        toolName: call.toolName,
+                        isError: false,
+                        args: call.args,
+                        parentCallId,
+                    };
                     pendingCalls.set(call.callId, entry);
-                    turn.toolCalls.push(entry);
+                    if (parentCallId !== undefined) {
+                        let sub = turn.subagents.find((s) => s.callId === parentCallId);
+                        if (sub === undefined) {
+                            sub = { callId: parentCallId, toolCalls: [] };
+                            turn.subagents.push(sub);
+                        }
+                        sub.toolCalls.push(entry);
+                    }
+                    else {
+                        turn.toolCalls.push(entry);
+                    }
                 }
                 break;
             }
@@ -107,20 +135,47 @@ export function buildTrajectory(events) {
                     pending.toolName = event.data.toolName;
                 }
                 else if (event.turnId !== undefined) {
-                    ensureTurn(event.turnId).toolCalls.push({
+                    const turn = ensureTurn(event.turnId);
+                    const entry = {
                         callId: event.data.callId,
                         toolName: event.data.toolName,
                         output: event.data.output,
                         isError: event.data.isError,
-                    });
+                        parentCallId: event.data.parentCallId,
+                    };
+                    if (event.data.parentCallId !== undefined) {
+                        let sub = turn.subagents.find((s) => s.callId === event.data.parentCallId);
+                        if (sub === undefined) {
+                            sub = {
+                                callId: event.data.parentCallId,
+                                toolCalls: [],
+                            };
+                            turn.subagents.push(sub);
+                        }
+                        sub.toolCalls.push(entry);
+                    }
+                    else {
+                        turn.toolCalls.push(entry);
+                    }
                 }
                 break;
             }
             case "subagent.called": {
                 if (event.turnId !== undefined) {
-                    ensureTurn(event.turnId).subagents.push(Object.assign(Object.assign({ callId: event.data.callId }, (event.data.name === undefined ? {} : { name: event.data.name })), (event.data.description === undefined
-                        ? {}
-                        : { description: event.data.description })));
+                    const turn = ensureTurn(event.turnId);
+                    const existing = turn.subagents.find((s) => s.callId === event.data.callId);
+                    if (existing !== undefined) {
+                        existing.name = event.data.name;
+                        existing.description = event.data.description;
+                    }
+                    else {
+                        turn.subagents.push({
+                            callId: event.data.callId,
+                            name: event.data.name,
+                            description: event.data.description,
+                            toolCalls: [],
+                        });
+                    }
                 }
                 break;
             }
@@ -163,9 +218,11 @@ export function buildTrajectory(events) {
     }
     const turns = turnOrder.map((id) => turnsById.get(id));
     const turnsFailed = turns.filter((t) => t.failed).length;
-    const toolCallCount = turns.reduce((n, t) => n + t.toolCalls.length, 0);
+    const toolCallCount = turns.reduce((n, t) => n +
+        t.toolCalls.length +
+        t.subagents.reduce((m, s) => m + s.toolCalls.length, 0), 0);
     const lastGood = [...turns].reverse().find((t) => t.assistantText !== "");
-    return Object.assign(Object.assign(Object.assign(Object.assign({ sessionId }, (sdkAgentId === undefined ? {} : { sdkAgentId })), (agentUrl === undefined ? {} : { agentUrl })), (channelId === undefined ? {} : { channelId })), { ok: turnsFailed === 0 && turns.length > 0, finalText: (_a = lastGood === null || lastGood === void 0 ? void 0 : lastGood.assistantText) !== null && _a !== void 0 ? _a : "", turnsFailed,
+    return Object.assign(Object.assign(Object.assign(Object.assign({ sessionId }, (sdkAgentId === undefined ? {} : { sdkAgentId })), (agentUrl === undefined ? {} : { agentUrl })), (channelId === undefined ? {} : { channelId })), { ok: turnsFailed === 0 && turns.length > 0, finalText: (_b = lastGood === null || lastGood === void 0 ? void 0 : lastGood.assistantText) !== null && _b !== void 0 ? _b : "", turnsFailed,
         toolCallCount,
         turns });
 }
@@ -195,6 +252,7 @@ export function loadTrajectoryFromEventsFile(path) {
 }
 /** Human-readable one-line-per-turn dump (for non-JSON CLI output). */
 export function formatTrajectoryText(trajectory) {
+    var _a;
     const lines = [];
     lines.push(`session ${trajectory.sessionId || "(unknown)"}  ok=${trajectory.ok}`);
     if (trajectory.sdkAgentId !== undefined) {
@@ -217,6 +275,20 @@ export function formatTrajectoryText(trajectory) {
                 lines.push(`    ${truncate(stringify(call.output), 160)}`);
             }
         }
+        for (const sub of turn.subagents) {
+            const label = (_a = sub.name) !== null && _a !== void 0 ? _a : "subagent";
+            const detail = sub.description !== undefined
+                ? ` — ${truncate(sub.description, 80)}`
+                : "";
+            lines.push(`  task ${label}${detail}`);
+            for (const call of sub.toolCalls) {
+                const mark = call.isError ? "✗" : "→";
+                lines.push(`    ${mark} ${call.toolName}${formatArgs(call.args)}`);
+                if (call.output !== undefined) {
+                    lines.push(`      ${truncate(stringify(call.output), 160)}`);
+                }
+            }
+        }
         if (turn.assistantText.length > 0) {
             lines.push(`  agent: ${truncate(turn.assistantText, 400)}`);
         }

package/dist/internal/update-check.d.ts

@@ -0,0 +1,93 @@
+/**
+ * Outdated-version warning + `agentkit update`.
+ *
+ * Every CLI run of a published install compares its own version against the
+ * npm registry's `latest` dist-tag and warns on stderr when behind. The
+ * registry lookup is cached under the config dir
+ * (`~/.config/agent-serve/update-check.json`) so most runs never touch the
+ * network; a stale cache refreshes inline under a short timeout, and any
+ * network failure is silent (the warning is best-effort, never a blocker).
+ *
+ * `agentkit update` re-runs the lookup fresh, figures out how this copy was
+ * installed (global npm/pnpm/yarn/bun, or a project dependency), and runs the
+ * matching install command.
+ */
+import { z } from "zod";
+/**
+ * Semver-style ordering: negative when `a < b`, 0 when equal, positive when
+ * `a > b`. Unparseable versions compare equal (never warn on garbage).
+ */
+export declare function compareVersions(a: string, b: string): number;
+/**
+ * Latest published version of the package, from the registry's `latest`
+ * dist-tag. Returns undefined on any failure (offline, 404 pre-publish, …).
+ */
+export declare function fetchLatestPublishedVersion(options?: {
+    fetchImpl?: typeof fetch;
+    timeoutMs?: number;
+    packageName?: string;
+}): Promise<string | undefined>;
+declare const cacheSchema: z.ZodObject<{
+    checkedAt: z.ZodNumber;
+    latestVersion: z.ZodOptional<z.ZodString>;
+}, "strip">;
+export type UpdateCheckCache = z.infer<typeof cacheSchema>;
+export declare function updateCheckCachePath(configDir?: string): string;
+export declare function readUpdateCheckCache(configDir?: string): Promise<UpdateCheckCache | undefined>;
+export declare function writeUpdateCheckCache(cache: UpdateCheckCache, configDir?: string): Promise<void>;
+export interface WarnIfOutdatedOptions {
+    /** Defaults to the running package's own version. */
+    currentVersion?: string;
+    /** Test seam; defaults to the shared config dir. */
+    configDir?: string;
+    fetchImpl?: typeof fetch;
+    /** Test seam; defaults to Date.now(). */
+    now?: number;
+    env?: NodeJS.ProcessEnv;
+    /** Defaults to process.stderr.write. */
+    err?: (text: string) => void;
+    /** Skip the source-checkout guard (tests exercise the full path). */
+    force?: boolean;
+}
+/**
+ * Print an outdated-version warning to stderr when a newer release exists.
+ *
+ * Never throws and never blocks longer than {@link WARN_FETCH_TIMEOUT_MS}.
+ * Suppressed on source-checkout runs (there is no installed copy to update),
+ * in CI, and via NO_UPDATE_NOTIFIER / AGENT_SERVE_NO_UPDATE_CHECK.
+ */
+export declare function warnIfOutdated(options?: WarnIfOutdatedOptions): Promise<void>;
+export interface UpdateCommand {
+    cmd: string;
+    args: string[];
+    /** Working directory for local project installs. */
+    cwd?: string;
+    /** One-line human description of what will run and why. */
+    reason: string;
+}
+/**
+ * Figure out how the running copy was installed and which command upgrades
+ * it. Detection is path-shape based (global stores have recognizable
+ * layouts), then falls back to walking up to the project that declares the
+ * dependency. Returns undefined for layouts we cannot safely upgrade
+ * (npx cache, unrecognized stores).
+ */
+export declare function detectUpdateCommand(args: {
+    packageRoot: string;
+    packageName?: string;
+}): Promise<UpdateCommand | undefined>;
+export interface UpdateCliOptions {
+    /** Test seams. */
+    fetchImpl?: typeof fetch;
+    currentVersion?: string;
+    packageRoot?: string;
+    configDir?: string;
+    runCommand?: (command: UpdateCommand) => Promise<number>;
+    compiled?: boolean;
+    out?: (text: string) => void;
+    err?: (text: string) => void;
+}
+/** `agentkit update` — upgrade this install to the latest published version. */
+export declare function cmdUpdate(options?: UpdateCliOptions): Promise<number>;
+export {};
+//# sourceMappingURL=update-check.d.ts.map

package/dist/internal/update-check.d.ts.map

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