@cursor/july 0.1.2 → 0.1.3

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/workspace.d.ts

@@ -18,6 +18,17 @@ export interface MaterializeWorkspaceOptions {
 }
 /** Relative path of an agent-side tool script inside the session workspace. */
 export declare function agentToolScriptPath(toolName: string): string;
+/**
+ * Always-on identity line prepended when composing instructions. Sourced from
+ * {@link ResolvedAgent.name} (`defineAgent({ name })`, else package/dir name)
+ * so agents know who they are without restating it in authored prose.
+ */
+export declare function buildIdentityPreamble(name: string): string;
+/**
+ * Prepend {@link buildIdentityPreamble} to authored instructions. Used when
+ * loading `instructions.md` / `.ts` / dir into {@link ResolvedAgent.instructions}.
+ */
+export declare function withIdentityPreamble(name: string, instructions: string | undefined): string | undefined;
 /**
  * Markdown catalog of agent-side tools for AGENTS.md / cloud first prompt.
  *

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

@@ -1 +1 @@
-{"version":3,"file":"workspace.d.ts","sourceRoot":"","sources":["../../src/internal/workspace.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,KAAK,EACV,eAAe,EACf,cAAc,EACd,aAAa,EACd,MAAM,aAAa,CAAC;AAGrB,MAAM,WAAW,2BAA2B;IAC1C,KAAK,EAAE,aAAa,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB;;;OAGG;IACH,IAAI,EAAE,OAAO,CAAC;CACf;AAED,+EAA+E;AAC/E,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAE5D;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,cAAc,EAAE,EACvB,OAAO,GAAE;IAAE,cAAc,EAAE,OAAO,CAAA;CAA8B,GAC/D,MAAM,CA6CR;AAED,wBAAsB,oBAAoB,CACxC,OAAO,EAAE,2BAA2B,GACnC,OAAO,CAAC,IAAI,CAAC,CAmCf;AAmDD;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,eAAe,GAAG,MAAM,CAO3D;AAED;;;GAGG;AACH,wBAAsB,mBAAmB,CACvC,YAAY,EAAE,MAAM,EACpB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC5B,OAAO,CAAC,IAAI,CAAC,CAMf"}
+{"version":3,"file":"workspace.d.ts","sourceRoot":"","sources":["../../src/internal/workspace.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,KAAK,EACV,eAAe,EACf,cAAc,EACd,aAAa,EACd,MAAM,aAAa,CAAC;AAIrB,MAAM,WAAW,2BAA2B;IAC1C,KAAK,EAAE,aAAa,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB;;;OAGG;IACH,IAAI,EAAE,OAAO,CAAC;CACf;AAED,+EAA+E;AAC/E,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAE5D;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAM1D;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,MAAM,EACZ,YAAY,EAAE,MAAM,GAAG,SAAS,GAC/B,MAAM,GAAG,SAAS,CAapB;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,cAAc,EAAE,EACvB,OAAO,GAAE;IAAE,cAAc,EAAE,OAAO,CAAA;CAA8B,GAC/D,MAAM,CA6CR;AAED,wBAAsB,oBAAoB,CACxC,OAAO,EAAE,2BAA2B,GACnC,OAAO,CAAC,IAAI,CAAC,CAqCf;AAmDD;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,eAAe,GAAG,MAAM,CAO3D;AAED;;;GAGG;AACH,wBAAsB,mBAAmB,CACvC,YAAY,EAAE,MAAM,EACpB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC5B,OAAO,CAAC,IAAI,CAAC,CAMf"}

package/dist/internal/workspace.js

@@ -18,10 +18,42 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
 import { chmod, copyFile, mkdir, stat, writeFile } from "node:fs/promises";
 import { dirname, join, relative, resolve } from "node:path";
 import { parseFrontmatter, serializeFrontmatter } from "./frontmatter.js";
+import { buildIdentitySection } from "./prompt-context.js";
 /** Relative path of an agent-side tool script inside the session workspace. */
 export function agentToolScriptPath(toolName) {
     return `.agent-serve/tools/${toolName}.sh`;
 }
+/**
+ * Always-on identity line prepended when composing instructions. Sourced from
+ * {@link ResolvedAgent.name} (`defineAgent({ name })`, else package/dir name)
+ * so agents know who they are without restating it in authored prose.
+ */
+export function buildIdentityPreamble(name) {
+    const trimmed = name.trim();
+    if (trimmed === "") {
+        return "";
+    }
+    return `You are ${trimmed}. That is your name; use it when people ask who you are.`;
+}
+/**
+ * Prepend {@link buildIdentityPreamble} to authored instructions. Used when
+ * loading `instructions.md` / `.ts` / dir into {@link ResolvedAgent.instructions}.
+ */
+export function withIdentityPreamble(name, instructions) {
+    var _a;
+    const preamble = buildIdentityPreamble(name);
+    const body = (_a = instructions === null || instructions === void 0 ? void 0 : instructions.trim()) !== null && _a !== void 0 ? _a : "";
+    if (preamble === "" && body === "") {
+        return undefined;
+    }
+    if (preamble === "") {
+        return body === "" ? undefined : body;
+    }
+    if (body === "") {
+        return preamble;
+    }
+    return `${preamble}\n\n${body}`;
+}
 /**
  * Markdown catalog of agent-side tools for AGENTS.md / cloud first prompt.
  *
@@ -80,12 +112,14 @@ export function materializeWorkspace(options) {
         const agentToolsSection = buildAgentToolsCatalog(agent.tools, {
             includeScripts: false,
         });
-        const agentsMd = [(_b = (_a = agent.instructions) === null || _a === void 0 ? void 0 : _a.trim()) !== null && _b !== void 0 ? _b : "", agentToolsSection]
+        const agentsMd = [
+            (_b = (_a = agent.instructions) === null || _a === void 0 ? void 0 : _a.trim()) !== null && _b !== void 0 ? _b : "",
+            buildIdentitySection(agent),
+            agentToolsSection,
+        ]
             .filter((part) => part !== "")
             .join("\n\n");
-        if (agentsMd !== "") {
-            yield writeFile(join(workspaceDir, "AGENTS.md"), agentsMd, "utf8");
-        }
+        yield writeFile(join(workspaceDir, "AGENTS.md"), agentsMd, "utf8");
         for (const tool of agent.tools) {
             if (tool.execution !== "agent" || tool.script === undefined) {
                 continue;