@cursor/july 0.1.8 → 0.1.10

package/dist/internal/session-engine.js

@@ -46,12 +46,12 @@ import { createHostPlatforms } from "./host-platforms.js";
 import { formatContinuationToken, newContinuationKey, newSessionId, newToolCallId, } from "./ids.js";
 import { validateToolInput } from "./json-schema.js";
 import { McpHost } from "./mcp-host.js";
-import { buildIdentitySection, buildSessionContextBlock, SCHEDULE_CHANNEL_PREFIX, } from "./prompt-context.js";
+import { buildSessionContextBlock, SCHEDULE_CHANNEL_PREFIX, } from "./prompt-context.js";
 import { assertCloudCanHonorAccountServersFilters } from "./resolved-connections.js";
 import { SessionStore } from "./session-store.js";
 import { StorageCoordinator } from "./storage-coordinator.js";
 import { normalizeToolResult, toolCallErrorMessage } from "./tool-result.js";
-import { buildAgentToolsCatalog, materializeWorkspace, writeWorkspaceFiles, } from "./workspace.js";
+import { buildAgentsMdContent, isNestedInGitRepo, materializeWorkspace, writeWorkspaceFiles, } from "./workspace.js";
 export const HTTP_CHANNEL_ID = "http";
 export { SCHEDULE_CHANNEL_PREFIX } from "./prompt-context.js";
 export class SessionBusyError extends Error {
@@ -726,7 +726,15 @@ export class SessionEngine {
                         return rest;
                     });
                 }
-                const request = this.buildTurnRequest(record, agent, turnId, message, isFirstTurn, emit, (update) => __awaiter(this, void 0, void 0, function* () {
+                // The harness only loads the scaffolded AGENTS.md when the session
+                // workspace is its own project root. With a per-session cwd override
+                // (PR worktree) the scaffold lands elsewhere, and a workspace nested
+                // inside a git repo re-roots harness rules at that repo — in both
+                // cases deliver instructions inline on the first turn instead.
+                const instructionsInvisibleToHarness = isFirstTurn &&
+                    (record.workspaceOverride !== undefined ||
+                        (yield isNestedInGitRepo(harnessCwd)));
+                const request = this.buildTurnRequest(record, agent, turnId, message, isFirstTurn, instructionsInvisibleToHarness, emit, (update) => __awaiter(this, void 0, void 0, function* () {
                     mapper.handleUpdate(update);
                     // Yield so the HTTP NDJSON writer can flush tool start/result
                     // events while sibling parallel tools are still executing.
@@ -797,9 +805,8 @@ export class SessionEngine {
             return Object.assign(Object.assign(Object.assign({}, outcome), (finalResult === undefined ? {} : { result: finalResult })), (finalUsage === undefined ? {} : { usage: finalUsage }));
         });
     }
-    buildTurnRequest(record, agent, turnId, prompt, isFirstTurn, emit, onUpdate, signal) {
-        var _a, _b, _c;
-        var _d;
+    buildTurnRequest(record, agent, turnId, prompt, isFirstTurn, instructionsInvisibleToHarness, emit, onUpdate, signal) {
+        var _a, _b;
         // Per-session cloud attach (channel/tool handoff) forces cloud runtime
         // even when the agent defaults to local for chat server tools.
         const runtime = resolveSessionRuntime({
@@ -822,15 +829,22 @@ export class SessionEngine {
             });
             turnPrompt = `${contextBlock}\n\n${prompt}`;
         }
-        if (runtime === "cloud" && isFirstTurn) {
-            const preamble = [
-                (_d = (_c = agent.instructions) === null || _c === void 0 ? void 0 : _c.trim()) !== null && _d !== void 0 ? _d : "",
-                buildIdentitySection(agent),
-                buildAgentToolsCatalog(agent.tools, { includeScripts: true }),
-            ]
-                .filter((part) => part !== "")
-                .join("\n\n");
-            turnPrompt = `${preamble}\n\n${turnPrompt}`;
+        if (isFirstTurn) {
+            if (runtime === "cloud") {
+                // Cloud VMs have no materialized workspace: ship the full context,
+                // including agent tool script bodies.
+                const preamble = buildAgentsMdContent(agent, { includeScripts: true });
+                turnPrompt = `${preamble}\n\n${turnPrompt}`;
+            }
+            else if (instructionsInvisibleToHarness) {
+                // Local workspace whose AGENTS.md the harness will not load. With a
+                // per-session harness cwd override, agent tool scripts live only in
+                // the durable scaffold dir — embed bodies like cloud. Otherwise the
+                // catalog can reference on-disk paths under the harness cwd.
+                const includeScripts = record.workspaceOverride !== undefined;
+                const preamble = buildAgentsMdContent(agent, { includeScripts });
+                turnPrompt = `${preamble}\n\n${turnPrompt}`;
+            }
         }
         return Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign({ sessionId: record.sessionId }, (record.sdkAgentId === undefined
             ? {}
@@ -1347,22 +1361,82 @@ export class SessionEngine {
      * observability surface across every principal (channel-driven runs,
      * schedule/task sessions, other callers). The route auth chain still
      * gates who may call this at all.
+     *
+     * When the project uses `cursorHostedStorage`, prefers durable Bugbot rows
+     * (merged with any newer local records not flushed yet). Falls back to the
+     * local `--state-root` store when the sink is unavailable.
      */
     listSessions(caller, options) {
+        return __awaiter(this, void 0, void 0, function* () {
+            return (yield this.listSessionsWithSource(caller, options)).sessions;
+        });
+    }
+    /**
+     * Same as {@link listSessions}, plus which store answered
+     * (`cursor-hosted` = durable DB via the control-plane proxy; `local` =
+     * `--state-root`).
+     */
+    listSessionsWithSource(caller, options) {
         return __awaiter(this, void 0, void 0, function* () {
             var _a;
-            const includeAll = (_a = options === null || options === void 0 ? void 0 : options.includeAll) !== null && _a !== void 0 ? _a : false;
+            var _b;
+            const includeAll = (_b = options === null || options === void 0 ? void 0 : options.includeAll) !== null && _b !== void 0 ? _b : false;
+            if (((_a = this.storage) === null || _a === void 0 ? void 0 : _a.isCursorHosted) === true) {
+                try {
+                    const records = yield this.mergeStoredAndLocalSessions();
+                    return {
+                        sessions: this.summarizeSessionRecords(records, caller, includeAll),
+                        source: "cursor-hosted",
+                    };
+                }
+                catch (error) {
+                    this.logger(`[agentkit] cursor-hosted session list failed; falling back to local: ${describeError(error)}`);
+                }
+            }
             const records = yield this.sessions.list();
-            return records
-                .filter((record) => includeAll || samePrincipal(record.auth, caller))
-                .map((record) => {
-                const externalUrl = externalUrlForSession(record);
-                return Object.assign(Object.assign(Object.assign({ sessionId: record.sessionId, channelId: record.channelId, mode: record.mode }, (record.title === undefined ? {} : { title: record.title })), { turnCount: record.turnCount, running: this.activeTurns.has(record.sessionId) ||
-                        this.pendingTurns.has(record.sessionId), createdAt: record.createdAt, updatedAt: record.updatedAt, continuationToken: record.continuationKey === null
-                        ? null
-                        : formatContinuationToken(record.channelId, record.continuationKey) }), (externalUrl === undefined ? {} : { externalUrl }));
-            })
-                .reverse();
+            // Local store is createdAt-asc; reverse so newest created leads.
+            return {
+                sessions: this.summarizeSessionRecords([...records].reverse(), caller, includeAll),
+                source: "local",
+            };
+        });
+    }
+    /**
+     * Durable sink rows plus local records (local wins on the same id when
+     * newer — covers debounce windows that have not flushed yet). Newest
+     * `updatedAt` first.
+     */
+    mergeStoredAndLocalSessions() {
+        return __awaiter(this, void 0, void 0, function* () {
+            const storage = this.storage;
+            if (storage === undefined) {
+                throw new Error("storage is not configured");
+            }
+            const stored = yield storage.listSessionsFromSink();
+            const local = yield this.sessions.list();
+            const byId = new Map();
+            for (const record of stored) {
+                byId.set(record.sessionId, record);
+            }
+            for (const record of local) {
+                const existing = byId.get(record.sessionId);
+                if (existing === undefined ||
+                    record.updatedAt.localeCompare(existing.updatedAt) >= 0) {
+                    byId.set(record.sessionId, record);
+                }
+            }
+            return [...byId.values()].sort((a, b) => b.updatedAt.localeCompare(a.updatedAt));
+        });
+    }
+    summarizeSessionRecords(records, caller, includeAll) {
+        return records
+            .filter((record) => includeAll || samePrincipal(record.auth, caller))
+            .map((record) => {
+            const externalUrl = externalUrlForSession(record);
+            return Object.assign(Object.assign(Object.assign({ sessionId: record.sessionId, channelId: record.channelId, mode: record.mode }, (record.title === undefined ? {} : { title: record.title })), { turnCount: record.turnCount, running: this.activeTurns.has(record.sessionId) ||
+                    this.pendingTurns.has(record.sessionId), createdAt: record.createdAt, updatedAt: record.updatedAt, continuationToken: record.continuationKey === null
+                    ? null
+                    : formatContinuationToken(record.channelId, record.continuationKey) }), (externalUrl === undefined ? {} : { externalUrl }));
         });
     }
     /**

package/dist/internal/sessions-client.d.ts

@@ -3,13 +3,23 @@
  *
  * Customer-facing errors never include hosting URLs or infra jargon.
  */
-import type { SessionEvent, SessionSummary } from "../types.js";
+import type { SessionEvent, SessionListSource, SessionSummary } from "../types.js";
 import { type RequestAuth } from "./request-headers.js";
+export interface ListedSessions {
+    sessions: SessionSummary[];
+    /** Present when the server reports which store answered. */
+    source?: SessionListSource;
+}
 export declare function listSessions(args: {
     baseUrl: string;
     auth?: RequestAuth;
     fetchImpl?: typeof fetch;
 }): Promise<SessionSummary[]>;
+export declare function listSessionsWithSource(args: {
+    baseUrl: string;
+    auth?: RequestAuth;
+    fetchImpl?: typeof fetch;
+}): Promise<ListedSessions>;
 export declare function fetchSessionEvents(args: {
     baseUrl: string;
     sessionId: string;
@@ -29,6 +39,10 @@ export declare function resolvePreviousSessionId(args: {
     auth?: RequestAuth;
     fetchImpl?: typeof fetch;
 }): Promise<string | undefined>;
+/** Human label for {@link SessionListSource} in CLI output. */
+export declare function formatSessionListSource(source: SessionListSource): string;
 /** Format a sessions table (id, channel, mode, turns, running, updated). */
-export declare function formatSessionsTable(sessions: SessionSummary[]): string;
+export declare function formatSessionsTable(sessions: SessionSummary[], options?: {
+    source?: SessionListSource;
+}): string;
 //# sourceMappingURL=sessions-client.d.ts.map

package/dist/internal/sessions-client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sessions-client.d.ts","sourceRoot":"","sources":["../../src/internal/sessions-client.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAEhE,OAAO,EAAuB,KAAK,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAE7E,wBAAsB,YAAY,CAAC,IAAI,EAAE;IACvC,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,WAAW,CAAC;IACnB,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;CAC1B,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC,CA8B5B;AAED,wBAAsB,kBAAkB,CAAC,IAAI,EAAE;IAC7C,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,WAAW,CAAC;IACnB,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;CAC1B,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAuE1B;AAgCD;;;;;GAKG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,SAAS,cAAc,EAAE,GAClC,cAAc,GAAG,SAAS,CAU5B;AAED,+DAA+D;AAC/D,wBAAsB,wBAAwB,CAAC,IAAI,EAAE;IACnD,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,WAAW,CAAC;IACnB,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;CAC1B,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAO9B;AAED,4EAA4E;AAC5E,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,cAAc,EAAE,GAAG,MAAM,CActE"}
+{"version":3,"file":"sessions-client.d.ts","sourceRoot":"","sources":["../../src/internal/sessions-client.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EACV,YAAY,EACZ,iBAAiB,EACjB,cAAc,EACf,MAAM,aAAa,CAAC;AAErB,OAAO,EAAuB,KAAK,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAE7E,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,cAAc,EAAE,CAAC;IAC3B,4DAA4D;IAC5D,MAAM,CAAC,EAAE,iBAAiB,CAAC;CAC5B;AAED,wBAAsB,YAAY,CAAC,IAAI,EAAE;IACvC,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,WAAW,CAAC;IACnB,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;CAC1B,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC,CAE5B;AAED,wBAAsB,sBAAsB,CAAC,IAAI,EAAE;IACjD,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,WAAW,CAAC;IACnB,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;CAC1B,GAAG,OAAO,CAAC,cAAc,CAAC,CAiC1B;AAED,wBAAsB,kBAAkB,CAAC,IAAI,EAAE;IAC7C,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,WAAW,CAAC;IACnB,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;CAC1B,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAuE1B;AAgCD;;;;;GAKG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,SAAS,cAAc,EAAE,GAClC,cAAc,GAAG,SAAS,CAU5B;AAED,+DAA+D;AAC/D,wBAAsB,wBAAwB,CAAC,IAAI,EAAE;IACnD,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,WAAW,CAAC;IACnB,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;CAC1B,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAO9B;AAED,+DAA+D;AAC/D,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,iBAAiB,GAAG,MAAM,CAIzE;AAED,4EAA4E;AAC5E,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,cAAc,EAAE,EAC1B,OAAO,CAAC,EAAE;IAAE,MAAM,CAAC,EAAE,iBAAiB,CAAA;CAAE,GACvC,MAAM,CAkBR"}

package/dist/internal/sessions-client.js

@@ -15,6 +15,11 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
 import { sanitizeCustomerError } from "./logs-client.js";
 import { mergeRequestHeaders } from "./request-headers.js";
 export function listSessions(args) {
+    return __awaiter(this, void 0, void 0, function* () {
+        return (yield listSessionsWithSource(args)).sessions;
+    });
+}
+export function listSessionsWithSource(args) {
     return __awaiter(this, void 0, void 0, function* () {
         var _a;
         const baseUrl = args.baseUrl.replace(/\/$/, "");
@@ -32,17 +37,19 @@ export function listSessions(args) {
             throw new Error(`Could not list sessions (HTTP ${resp.status}).`);
         }
         const body = (yield resp.json());
-        if (!Array.isArray(body.sessions)) {
-            return [];
-        }
-        const out = [];
-        for (const row of body.sessions) {
-            const parsed = parseSessionSummary(row);
-            if (parsed !== undefined) {
-                out.push(parsed);
+        const sessions = [];
+        if (Array.isArray(body.sessions)) {
+            for (const row of body.sessions) {
+                const parsed = parseSessionSummary(row);
+                if (parsed !== undefined) {
+                    sessions.push(parsed);
+                }
             }
         }
-        return out;
+        const source = body.source === "cursor-hosted" || body.source === "local"
+            ? body.source
+            : undefined;
+        return source === undefined ? { sessions } : { sessions, source };
     });
 }
 export function fetchSessionEvents(args) {
@@ -167,10 +174,19 @@ export function resolvePreviousSessionId(args) {
         return (_a = pickPreviousSession(sessions)) === null || _a === void 0 ? void 0 : _a.sessionId;
     });
 }
+/** Human label for {@link SessionListSource} in CLI output. */
+export function formatSessionListSource(source) {
+    return source === "cursor-hosted"
+        ? "Listing from cursor-hosted storage (durable DB)."
+        : "Listing from local session store.";
+}
 /** Format a sessions table (id, channel, mode, turns, running, updated). */
-export function formatSessionsTable(sessions) {
+export function formatSessionsTable(sessions, options) {
+    const sourceLine = (options === null || options === void 0 ? void 0 : options.source) === undefined
+        ? ""
+        : `${formatSessionListSource(options.source)}\n`;
     if (sessions.length === 0) {
-        return "No sessions.\n";
+        return `${sourceLine}No sessions.\n`;
     }
     const header = ["SESSION", "CHANNEL", "MODE", "TURNS", "RUNNING", "UPDATED"];
     const rows = sessions.map((s) => [
@@ -181,7 +197,7 @@ export function formatSessionsTable(sessions) {
         s.running ? "yes" : "no",
         s.updatedAt,
     ]);
-    return `${renderTable(header, rows)}\n`;
+    return `${sourceLine}${renderTable(header, rows)}\n`;
 }
 function renderTable(header, rows) {
     const widths = header.map((h, i) => Math.max(h.length, ...rows.map((row) => { var _a; return ((_a = row[i]) !== null && _a !== void 0 ? _a : "").length; })));

package/dist/internal/storage-coordinator.d.ts

@@ -73,12 +73,23 @@ export declare class StorageCoordinator {
     private deleteOp;
     /** Whether the sink can serve the startup bulk restore (`list`). */
     get canBulkRestore(): boolean;
+    /**
+     * True when the authored sink is `cursorHostedStorage` (Bugbot via the
+     * control-plane proxy). `GET /v1/sessions` prefers this durable list.
+     */
+    get isCursorHosted(): boolean;
     /**
      * Saved session records for this agent (startup restore). Errors are
      * logged and read as "nothing saved" — a broken store must never block
      * serve start.
      */
     listSessions(): Promise<SessionRecord[]>;
+    /**
+     * Session records from the sink for the sessions API. Unlike
+     * {@link listSessions}, missing `list` or a thrown sink error **propagates**
+     * so the caller can fall back to the local session store.
+     */
+    listSessionsFromSink(): Promise<SessionRecord[]>;
     /**
      * Saved event stream for one session: chunk values concatenated in key
      * order (chunks are keyed by their first event's index, zero-padded, so

package/dist/internal/storage-coordinator.d.ts.map

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

package/dist/internal/storage-coordinator.js

@@ -24,6 +24,7 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
     });
 };
 import { resolveStoragePolicy, storageKeys, } from "../storage.js";
+import { isCursorHostedStorage } from "../storage-backends/cursor-hosted.js";
 import { describeError } from "./describe-error.js";
 import { isReminderRecord } from "./reminder-store.js";
 /** Event types that close a unit of work — flush point for turn-end batching. */
@@ -190,6 +191,13 @@ export class StorageCoordinator {
     get canBulkRestore() {
         return this.definition.list !== undefined;
     }
+    /**
+     * True when the authored sink is `cursorHostedStorage` (Bugbot via the
+     * control-plane proxy). `GET /v1/sessions` prefers this durable list.
+     */
+    get isCursorHosted() {
+        return isCursorHostedStorage(this.definition);
+    }
     /**
      * Saved session records for this agent (startup restore). Errors are
      * logged and read as "nothing saved" — a broken store must never block
@@ -203,6 +211,28 @@ export class StorageCoordinator {
                 .filter((record) => record != null);
         });
     }
+    /**
+     * Session records from the sink for the sessions API. Unlike
+     * {@link listSessions}, missing `list` or a thrown sink error **propagates**
+     * so the caller can fall back to the local session store.
+     */
+    listSessionsFromSink() {
+        return __awaiter(this, void 0, void 0, function* () {
+            const list = this.definition.list;
+            if (list === undefined) {
+                throw new Error("storage sink has no list");
+            }
+            const entries = yield list(storageKeys.sessionPrefix(this.agentName), this.context("restore"));
+            if (!Array.isArray(entries)) {
+                throw new Error("storage list returned a non-array");
+            }
+            return entries
+                .map((entry) => entry.value)
+                .filter((record) => record != null &&
+                typeof record.sessionId === "string" &&
+                record.sessionId !== "");
+        });
+    }
     /**
      * Saved event stream for one session: chunk values concatenated in key
      * order (chunks are keyed by their first event's index, zero-padded, so

package/dist/internal/workspace.d.ts

@@ -38,6 +38,25 @@ export declare function withIdentityPreamble(name: string, instructions: string
 export declare function buildAgentToolsCatalog(tools: DiscoveredTool[], options?: {
     includeScripts: boolean;
 }): string;
+/**
+ * The full AGENTS.md-equivalent context for an agent: instructions, identity
+ * section, and the agent-side tool catalog. Written to the session workspace
+ * as `AGENTS.md`, and inlined into the first turn's prompt when the harness
+ * cannot discover that file (cloud runtime, or a local workspace the harness
+ * will not treat as the project root — see {@link isNestedInGitRepo}).
+ */
+export declare function buildAgentsMdContent(agent: ResolvedAgent, options: {
+    includeScripts: boolean;
+}): string;
+/**
+ * True when `dir` sits strictly inside a git repository (a `.git` exists in
+ * an ancestor directory but not in `dir` itself). The Cursor harness resolves
+ * its project root by walking up to the nearest git root, so a nested session
+ * workspace loses its own `AGENTS.md` / `.cursor` scaffold: the enclosing
+ * repo's rules load instead, and the (necessarily gitignored) workspace files
+ * are skipped by nested rule discovery.
+ */
+export declare function isNestedInGitRepo(dir: string): Promise<boolean>;
 export declare function materializeWorkspace(options: MaterializeWorkspaceOptions): Promise<void>;
 /**
  * Generate the SKILL.md the harness reads: `name` + `description`

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;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"}
+{"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;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,aAAa,EACpB,OAAO,EAAE;IAAE,cAAc,EAAE,OAAO,CAAA;CAAE,GACnC,MAAM,CAUR;AAED;;;;;;;GAOG;AACH,wBAAsB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAcrE;AAED,wBAAsB,oBAAoB,CACxC,OAAO,EAAE,2BAA2B,GACnC,OAAO,CAAC,IAAI,CAAC,CA4Bf;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

@@ -16,7 +16,7 @@ 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 { dirname, join, parse, 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. */
@@ -103,22 +103,56 @@ export function buildAgentToolsCatalog(tools, options = { includeScripts: false
     }
     return `${parts.join("\n").trimEnd()}\n`;
 }
+/**
+ * The full AGENTS.md-equivalent context for an agent: instructions, identity
+ * section, and the agent-side tool catalog. Written to the session workspace
+ * as `AGENTS.md`, and inlined into the first turn's prompt when the harness
+ * cannot discover that file (cloud runtime, or a local workspace the harness
+ * will not treat as the project root — see {@link isNestedInGitRepo}).
+ */
+export function buildAgentsMdContent(agent, options) {
+    var _a;
+    var _b;
+    return [
+        (_b = (_a = agent.instructions) === null || _a === void 0 ? void 0 : _a.trim()) !== null && _b !== void 0 ? _b : "",
+        buildIdentitySection(agent),
+        buildAgentToolsCatalog(agent.tools, {
+            includeScripts: options.includeScripts,
+        }),
+    ]
+        .filter((part) => part !== "")
+        .join("\n\n");
+}
+/**
+ * True when `dir` sits strictly inside a git repository (a `.git` exists in
+ * an ancestor directory but not in `dir` itself). The Cursor harness resolves
+ * its project root by walking up to the nearest git root, so a nested session
+ * workspace loses its own `AGENTS.md` / `.cursor` scaffold: the enclosing
+ * repo's rules load instead, and the (necessarily gitignored) workspace files
+ * are skipped by nested rule discovery.
+ */
+export function isNestedInGitRepo(dir) {
+    return __awaiter(this, void 0, void 0, function* () {
+        let current = resolve(dir);
+        if (yield exists(join(current, ".git"))) {
+            // The workspace is itself a repo root; the harness roots rules here.
+            return false;
+        }
+        const { root } = parse(current);
+        while (current !== root) {
+            current = dirname(current);
+            if (yield exists(join(current, ".git"))) {
+                return true;
+            }
+        }
+        return false;
+    });
+}
 export function materializeWorkspace(options) {
     return __awaiter(this, void 0, void 0, function* () {
-        var _a;
-        var _b;
         const { agent, workspaceDir, seed } = options;
         yield mkdir(workspaceDir, { recursive: true });
-        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 : "",
-            buildIdentitySection(agent),
-            agentToolsSection,
-        ]
-            .filter((part) => part !== "")
-            .join("\n\n");
+        const agentsMd = buildAgentsMdContent(agent, { includeScripts: false });
         yield writeFile(join(workspaceDir, "AGENTS.md"), agentsMd, "utf8");
         for (const tool of agent.tools) {
             if (tool.execution !== "agent" || tool.script === undefined) {