@cursor/july 0.1.100 → 0.1.102

package/dist/internal/session-engine.js

@@ -25,6 +25,7 @@ import { SlackAskDedupeStore, SlackNudgeStore, } from "../channels/slack/nudge-s
 import { resolveDedicatedSlackHostBinding } from "../channels/slack/slack-channel.js";
 import { AGENT_SERVE_USER_STORE_FILES_SOURCE_ID, agentStoreKeys, } from "../files.js";
 import { cursorHostedFiles, isCursorHostedFilesAvailable, isCursorUserStoreFilesAvailable, } from "../files-backends/cursor-hosted.js";
+import { storageKeysForArchitecture } from "../storage.js";
 import { DEFAULT_MODEL, DIRECT_TOOL_CALL_CHANNEL_ID, isCursorAccountTransport, isHostOauthConnectionTransport, isSymbolicConnectionTransport, } from "../types.js";
 import { ABCollector } from "./ab-collector.js";
 import { foldABStream } from "./ab-fold.js";
@@ -32,7 +33,7 @@ import { buildABSnapshot } from "./ab-snapshot.js";
 import { resolveAdvertisedTools, } from "./advertise-tools.js";
 import { ApprovalGate } from "./approval-gate.js";
 import { ArtifactsStore } from "./artifacts-store.js";
-import { assertTimeArgs, normalizeAsOf, sessionClock } from "./as-of.js";
+import { assertTimeArgs, normalizeAsOf, schemaTimeWindowKeys, sessionClock, } from "./as-of.js";
 import { SessionAuthError, samePrincipal } from "./auth.js";
 import { mergeCloudOptions, resolveSessionRuntime } from "./cloud-merge.js";
 import { applyCloudUsageToEvents, cloudSdkAgentIdFromEvents, isUnpricedCompletedTurn, mapSdkTokenUsage, } from "./cloud-turn-cost.js";
@@ -65,6 +66,7 @@ import { estimateTurnCostFromApi, roundCostUsd, } from "./turn-cost.js";
 import { TurnGovernor } from "./turn-governor.js";
 import { TurnLeaseStore } from "./turn-lease-store.js";
 import { TurnOutbox } from "./turn-outbox.js";
+import { resolveAgentV2Hosting } from "./v2-hosting.js";
 import { buildAgentsMdContent, buildCloudMemorySection, ensureOwnGitRoot, isNestedInGitRepo, materializeWorkspace, SERVER_TOOLS_MCP_SERVER_NAME, writeWorkspaceFiles, } from "./workspace.js";
 export const HTTP_CHANNEL_ID = "http";
 export { SCHEDULE_CHANNEL_PREFIX } from "./prompt-context.js";
@@ -246,16 +248,27 @@ export class SessionEngine {
                     agentName: options.project.name,
                     projectRoot: options.project.rootDir,
                     logger: this.logger,
+                    keys: storageKeysForArchitecture(options.project.agent.architecture),
                 });
         this.kvApi = createHostKvApi(Object.assign({ agentName: options.project.name, stateRoot: options.stateRoot }, (this.storage === undefined ? {} : { storage: this.storage })));
+        const v2Hosting = resolveAgentV2Hosting({
+            architecture: options.project.agent.architecture,
+        });
+        const managedV2Files = v2Hosting.kind === "cursor-managed"
+            ? () => cursorHostedFiles({
+                resolveStoreSourceId: () => v2Hosting.resolveStoreIds().deploymentStoreSourceId,
+            })
+            : undefined;
         this.filesApi = createHostFilesApi({
             agentName: options.project.name,
             stateRoot: options.stateRoot,
+            sink: managedV2Files === null || managedV2Files === void 0 ? void 0 : managedV2Files(),
         });
         this.artifactsStore = new ArtifactsStore({
             stateRoot: options.stateRoot,
             agentName: options.project.name,
             config: options.project.artifacts,
+            sink: managedV2Files === null || managedV2Files === void 0 ? void 0 : managedV2Files(),
         });
         this.abCollector = new ABCollector(options.project.abs, this.logger, (sessionId) => __awaiter(this, void 0, void 0, function* () { return (yield this.logs.get(sessionId)).snapshot(0); }), 
         // Samples flow to the defineStorage `abs` table (no-op without one).
@@ -300,14 +313,18 @@ export class SessionEngine {
     setResolvedConnections(connections) {
         this.resolvedConnections = connections;
         for (const connection of connections) {
-            this.mcpHost.addConnection({
-                name: connection.name,
-                transport: Object.assign({ url: connection.localUrl }, (connection.headers === undefined
-                    ? {}
-                    : { headers: connection.headers })),
-            });
+            const authored = this.authoredConnection(connection.name);
+            this.mcpHost.addConnection(Object.assign(Object.assign({}, (authored !== null && authored !== void 0 ? authored : { name: connection.name })), { name: connection.name, transport: {
+                    url: connection.localUrl,
+                    headers: connection.headers,
+                } }));
         }
     }
+    authoredConnection(name) {
+        var _a;
+        var _b;
+        return ((_b = this.project.agent.connections.find((item) => item.name === name)) !== null && _b !== void 0 ? _b : (_a = this.project.agent.hostConnections) === null || _a === void 0 ? void 0 : _a.find((item) => item.name === name));
+    }
     setCloudServerToolsConnection(connection) {
         this.cloudServerToolsConnection = connection;
     }
@@ -1552,7 +1569,19 @@ export class SessionEngine {
      * a personal API key writes into the USER store under `agent-serve/`.
      */
     cloudSkillsStore() {
-        if (isCursorHostedFilesAvailable()) {
+        const v2Hosting = resolveAgentV2Hosting({
+            architecture: this.project.agent.architecture,
+        });
+        if (v2Hosting.kind === "cursor-managed") {
+            return {
+                sink: cursorHostedFiles({
+                    resolveStoreSourceId: () => v2Hosting.resolveStoreIds().deploymentStoreSourceId,
+                }),
+                skillsPrefix: agentStoreKeys.skillsPrefix(),
+                label: "deployment store",
+            };
+        }
+        if (v2Hosting.kind === "not-v2" && isCursorHostedFilesAvailable()) {
             return {
                 sink: cursorHostedFiles(),
                 skillsPrefix: agentStoreKeys.skillsPrefix(),
@@ -1990,32 +2019,23 @@ export class SessionEngine {
                 return toolErrorResult(`Invalid input for tool "${args.tool.name}": ${validation.message}`);
             }
             const toolCallId = (_b = args.toolCallId) !== null && _b !== void 0 ? _b : newToolCallId(args.tool.name);
-            const toolCtx = {
-                toolCallId,
-                session: this.sessionInfo(args.record),
-                workspaceDir: this.harnessCwd(args.record),
-                stateRoot: this.stateRoot,
-                host: this.hostForSession(args.record.sessionId),
-                artifacts: this.artifactsApi({
+            const toolCtx = Object.assign({ toolCallId, session: this.sessionInfo(args.record), workspaceDir: this.harnessCwd(args.record), stateRoot: this.stateRoot, host: this.hostForSession(args.record.sessionId), artifacts: this.artifactsApi({
                     sessionId: args.record.sessionId,
                     turnId: args.turnId,
-                }),
-                send: (channelId, message, sendOptions = {}) => { var _a; return this.send(channelId, message, Object.assign(Object.assign({}, sendOptions), { auth: (_a = sendOptions.auth) !== null && _a !== void 0 ? _a : args.record.auth })); },
-                getSession: (channelId, sessionId) => this.getChannelSession(channelId, sessionId),
-                emit: args.emit,
-                now: sessionClock(args.record.asOf),
-            };
+                }), send: (channelId, message, sendOptions = {}) => { var _a; return this.send(channelId, message, Object.assign(Object.assign({}, sendOptions), { auth: (_a = sendOptions.auth) !== null && _a !== void 0 ? _a : args.record.auth })); }, getSession: (channelId, sessionId) => this.getChannelSession(channelId, sessionId), emit: args.emit, now: sessionClock(args.record.asOf) }, (args.record.asOf === undefined ? {} : { asOf: args.record.asOf }));
             try {
                 // Before the approval gate: a dry run is unattended, so parking a write
                 // for a human would hang the turn rather than answer it.
-                const decision = decideToolCall(Object.assign(Object.assign({ dryRun: args.record.dryRun === true, effect: args.tool.definition.effect }, (args.tool.advertised === true
+                const decision = decideToolCall(Object.assign(Object.assign(Object.assign({ dryRun: args.record.dryRun === true, effect: args.tool.definition.effect }, (args.tool.advertised === true
                     ? {
                         mcpTool: {
                             name: args.tool.name,
                             annotations: args.tool.annotations,
                         },
                     }
-                    : {})), { dryRunResult: args.tool.definition.dryRunResult, input: validation.value, asOf: args.record.asOf, timeArgs: args.tool.definition.timeArgs }));
+                    : {})), { dryRunResult: args.tool.definition.dryRunResult, input: validation.value, asOf: args.record.asOf, timeArgs: args.tool.definition.timeArgs }), (args.tool.advertised === true && args.record.asOf !== undefined
+                    ? { timeWindow: schemaTimeWindowKeys(args.tool.inputSchema) }
+                    : {})));
                 if (decision.kind === "answer") {
                     (_a = this.stubbedCallIds.get(args.record.sessionId)) === null || _a === void 0 ? void 0 : _a.add(toolCallId);
                     this.logger(`[session] tool ${args.tool.name} answered by host (${toolCallId})`);
@@ -2050,13 +2070,18 @@ export class SessionEngine {
                 }
                 const started = Date.now();
                 this.logger(`[session] tool ${args.tool.name} start`);
-                const result = yield mcpAuthAls.run({
+                const result = yield this.runToolExecute({
+                    record: args.record,
+                    turnId: args.turnId,
+                    callId: toolCallId,
+                    toolName: args.tool.name,
+                }, () => mcpAuthAls.run({
                     sessionId: args.record.sessionId,
                     turnId: args.turnId,
                     callId: toolCallId,
                     toolName: args.tool.name,
                     emit: args.emit,
-                }, () => execute(validation.value, toolCtx));
+                }, () => execute(validation.value, toolCtx)));
                 this.logger(`[session] tool ${args.tool.name} done (${Date.now() - started}ms)`);
                 return normalizeToolResult(result);
             }
@@ -2066,6 +2091,24 @@ export class SessionEngine {
             }
         });
     }
+    /**
+     * Bind outbound inject (Factory / Cursor API `traceparent`) to the
+     * tool span. No-op when OTel is off.
+     */
+    runToolExecute(args, fn) {
+        const otel = this.otel;
+        const run = () => Promise.resolve(fn());
+        if (otel === undefined) {
+            return run();
+        }
+        return otel.runInCall({
+            sessionId: args.record.sessionId,
+            session: this.sessionInfo(args.record),
+            turnId: args.turnId,
+            callId: args.callId,
+            toolName: args.toolName,
+        }, run);
+    }
     /**
      * Park a server-tool call until a human approves or denies. Emits
      * `action.approval_requested` / `action.approval_resolved` on the
@@ -2258,11 +2301,6 @@ export class SessionEngine {
             yield this.oauthHub.persistFor(connection, authored.transport.url);
         });
     }
-    authoredConnection(name) {
-        var _a;
-        var _b;
-        return ((_b = this.project.agent.connections.find((entry) => entry.name === name)) !== null && _b !== void 0 ? _b : (_a = this.project.agent.hostConnections) === null || _a === void 0 ? void 0 : _a.find((entry) => entry.name === name));
-    }
     mintAuthUrl(connection, sessionId) {
         return __awaiter(this, void 0, void 0, function* () {
             const authored = this.authoredConnection(connection);
@@ -2679,9 +2717,11 @@ export class SessionEngine {
             // A separate body from the model path, so it asks the same policy: a
             // session-bound `POST /v1/tools/:name`, `call --session`, or
             // `handle.callTool` performs a write just as readily.
-            const decision = decideToolCall(Object.assign(Object.assign({ dryRun: (record === null || record === void 0 ? void 0 : record.dryRun) === true, effect: tool.definition.effect }, (tool.advertised === true
+            const decision = decideToolCall(Object.assign(Object.assign(Object.assign({ dryRun: (record === null || record === void 0 ? void 0 : record.dryRun) === true, effect: tool.definition.effect }, (tool.advertised === true
                 ? { mcpTool: { name: tool.name, annotations: tool.annotations } }
-                : {})), { dryRunResult: tool.definition.dryRunResult, input: validation.value, asOf: record === null || record === void 0 ? void 0 : record.asOf, timeArgs: tool.definition.timeArgs }));
+                : {})), { dryRunResult: tool.definition.dryRunResult, input: validation.value, asOf: record === null || record === void 0 ? void 0 : record.asOf, timeArgs: tool.definition.timeArgs }), (tool.advertised === true && (record === null || record === void 0 ? void 0 : record.asOf) !== undefined
+                ? { timeWindow: schemaTimeWindowKeys(tool.inputSchema) }
+                : {})));
             const started = Date.now();
             this.logger(`[session] tool ${toolName} start (direct ${callId})`);
             let result;
@@ -2714,35 +2754,34 @@ export class SessionEngine {
                     isError = false;
                 }
                 else {
-                    const run = () => execute(validation.value, {
-                        toolCallId: callId,
-                        session,
-                        workspaceDir,
-                        stateRoot: this.stateRoot,
-                        host: this.hostForSession(record === null || record === void 0 ? void 0 : record.sessionId),
+                    const run = () => execute(validation.value, Object.assign({ toolCallId: callId, session,
+                        workspaceDir, stateRoot: this.stateRoot, host: this.hostForSession(record === null || record === void 0 ? void 0 : record.sessionId), 
                         // Scratch calls have no real session; their facade stays unbound.
                         artifacts: record === undefined
                             ? this.artifactsApi()
                             : this.artifactsApi({
                                 sessionId: record.sessionId,
                                 turnId: callId,
-                            }),
-                        send: (channelId, message, sendOptions = {}) => this.send(channelId, message, Object.assign(Object.assign({}, sendOptions), { auth: sendOptions.auth !== undefined
+                            }), send: (channelId, message, sendOptions = {}) => this.send(channelId, message, Object.assign(Object.assign({}, sendOptions), { auth: sendOptions.auth !== undefined
                                 ? sendOptions.auth
-                                : session.auth })),
-                        getSession: (channelId, sessionId) => this.getChannelSession(channelId, sessionId),
-                        emit,
-                        now: sessionClock(record === null || record === void 0 ? void 0 : record.asOf),
-                    });
-                    result = normalizeToolResult(record !== undefined && emit !== undefined
-                        ? yield mcpAuthAls.run({
+                                : session.auth })), getSession: (channelId, sessionId) => this.getChannelSession(channelId, sessionId), emit, now: sessionClock(record === null || record === void 0 ? void 0 : record.asOf) }, ((record === null || record === void 0 ? void 0 : record.asOf) === undefined ? {} : { asOf: record.asOf })));
+                    const executeBody = record !== undefined && emit !== undefined
+                        ? () => mcpAuthAls.run({
                             sessionId: record.sessionId,
                             turnId: callId,
                             callId,
                             toolName,
                             emit,
                         }, run)
-                        : yield run());
+                        : run;
+                    result = normalizeToolResult(record !== undefined
+                        ? yield this.runToolExecute({
+                            record,
+                            turnId: callId,
+                            callId,
+                            toolName,
+                        }, executeBody)
+                        : yield executeBody());
                     isError = isErrorEnvelope(result);
                 }
             }
@@ -2789,23 +2828,34 @@ export class SessionEngine {
         });
     }
     /**
-     * Whether a dry run answers a bridged MCP call, for the cloud host bridge —
+     * Whether the host answers a bridged MCP call, for the cloud host bridge —
      * the one tool path that does not reach {@link executeServerTool}, because
      * it forwards to `host.mcp` instead of invoking a tool body.
      *
-     * A bridged tool carries no `defineTool`, so it declares no effect, and the
-     * policy reads an undeclared tool as a write. In a dry run that answers
-     * bridged reads too; resolving effects from a server's own listing is the
-     * next unit's work.
+     * A frozen session refuses forward-looking time args here even when it is
+     * not a dry run. A bridged tool carries no `defineTool`, so it declares no
+     * effect, and the policy reads an undeclared tool as a write. In a dry run
+     * that answers bridged reads too; resolving effects from a server's own
+     * listing is the next unit's work.
      */
     bridgedCallAnswer(args) {
         return __awaiter(this, void 0, void 0, function* () {
             // Read off the in-flight turn's context rather than the session store:
             // the bridge already refuses a call with no active turn, so the record is
-            // in memory. That keeps this free for the sessions that are not dry runs,
-            // which is every session today — the listing below is only paid inside a
-            // dry run.
+            // in memory. The listing below is only paid inside a dry run.
             const context = this.activeToolContexts.get(args.sessionId);
+            if ((context === null || context === void 0 ? void 0 : context.record.asOf) !== undefined) {
+                const decision = decideToolCall({
+                    dryRun: false,
+                    effect: undefined,
+                    input: args.input,
+                    asOf: context.record.asOf,
+                });
+                if (decision.kind === "unbounded") {
+                    this.logger(`[session] bridged tool ${args.toolName} refused, unbounded_time (${args.sessionId})`);
+                    return { answered: true, result: toolErrorResult(decision.message) };
+                }
+            }
             if ((context === null || context === void 0 ? void 0 : context.record.dryRun) !== true) {
                 return { answered: false };
             }
@@ -2813,12 +2863,10 @@ export class SessionEngine {
             // server's own listing annotations; a tool the listing cannot classify
             // refuses rather than being stubbed. A failed listing classifies nothing,
             // which lands on the same refusal — never on a run.
-            const annotations = yield this.bridgedToolAnnotations(args.connectionName, args.toolName);
-            const decision = decideToolCall({
-                dryRun: true,
-                effect: undefined,
-                mcpTool: { name: args.toolName, annotations },
-            });
+            const info = yield this.bridgedToolInfo(args.connectionName, args.toolName);
+            const decision = decideToolCall(Object.assign({ dryRun: true, effect: undefined, mcpTool: { name: args.toolName, annotations: info === null || info === void 0 ? void 0 : info.annotations }, input: args.input, asOf: context.record.asOf }, (context.record.asOf !== undefined
+                ? { timeWindow: schemaTimeWindowKeys(info === null || info === void 0 ? void 0 : info.inputSchema) }
+                : {})));
             if (decision.kind === "run") {
                 return { answered: false };
             }
@@ -2847,14 +2895,13 @@ export class SessionEngine {
      * undefined when the tool is unlisted, unannotated, or the listing fails —
      * all of which the policy reads as unclassified, the refusing state.
      */
-    bridgedToolAnnotations(connectionName, toolName) {
+    bridgedToolInfo(connectionName, toolName) {
         return __awaiter(this, void 0, void 0, function* () {
-            var _a;
             try {
                 const listed = yield this.host.mcp.listTools(connectionName);
-                return (_a = listed.find((tool) => tool.name === toolName)) === null || _a === void 0 ? void 0 : _a.annotations;
+                return listed.find((tool) => tool.name === toolName);
             }
-            catch (_b) {
+            catch (_a) {
                 return undefined;
             }
         });

package/dist/internal/session-run-log.d.ts

@@ -14,7 +14,9 @@
  * session key with `processDeath: true` and the real throw. Soft-fail on
  * persist so a store outage never changes the hosted-execution HTTP reply.
  *
- * Keys: {@link storageKeys.sessionRun}.
+ * Same flush moments as `hosted-execution.json` and the start.log tee —
+ * see `hosted-execution-flush.ts`. Keys:
+ * {@link agentSdkStorageKeys.sessionRun}.
  */
 import type { FileSink } from "../files.js";
 import type { AgentProject } from "../types.js";

package/dist/internal/session-run-log.d.ts.map

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

package/dist/internal/session-run-log.js

@@ -14,7 +14,9 @@
  * session key with `processDeath: true` and the real throw. Soft-fail on
  * persist so a store outage never changes the hosted-execution HTTP reply.
  *
- * Keys: {@link storageKeys.sessionRun}.
+ * Same flush moments as `hosted-execution.json` and the start.log tee —
+ * see `hosted-execution-flush.ts`. Keys:
+ * {@link agentSdkStorageKeys.sessionRun}.
  */
 var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
     function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
@@ -25,11 +27,11 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
         step((generator = generator.apply(thisArg, _arguments || [])).next());
     });
 };
-import { cursorFrameworkStoreSourceId, cursorHostedFiles, } from "../files-backends/cursor-hosted.js";
-import { storageKeys } from "../storage-protocol.js";
+import { cursorHostedFiles } from "../files-backends/cursor-hosted.js";
+import { agentSdkStorageKeys } from "../storage-protocol.js";
 import { resolveApiKeySync } from "./cursor/credentials.js";
-import { AGENT_SERVE_GENERATION_ENV_VAR } from "./cursor-relay-core.js";
 import { describeError } from "./describe-error.js";
+import { resolveAgentV2Hosting } from "./v2-hosting.js";
 export const SESSION_RUN_LOG_VERSION = 1;
 /** Last N log-ring lines kept on each execution. */
 export const SESSION_RUN_LOG_MAX_ENTRIES = 200;
@@ -249,7 +251,7 @@ export function createSessionRunLogStore(input) {
     const logger = (_a = input.logger) !== null && _a !== void 0 ? _a : (() => { });
     let active;
     const readDocument = (sessionPublicId) => __awaiter(this, void 0, void 0, function* () {
-        const key = storageKeys.sessionRun(agentName, sessionPublicId);
+        const key = agentSdkStorageKeys.sessionRun(agentName, sessionPublicId);
         const body = yield sink.get(key);
         if (body === undefined) {
             return undefined;
@@ -280,7 +282,7 @@ export function createSessionRunLogStore(input) {
             updatedAt: fitted.writtenAt,
             executions,
         });
-        const key = storageKeys.sessionRun(agentName, document.sessionPublicId);
+        const key = agentSdkStorageKeys.sessionRun(agentName, document.sessionPublicId);
         try {
             yield sink.put(key, new TextEncoder().encode(JSON.stringify(document)));
         }
@@ -340,17 +342,15 @@ export function createSessionRunLogStore(input) {
  * local disk / today's behavior.
  */
 export function selectSessionRunLogStore(input) {
-    var _a;
-    if (input.project.agent.architecture !== "v2") {
-        return undefined;
-    }
-    const env = (_a = input.env) !== null && _a !== void 0 ? _a : process.env;
-    if (env[AGENT_SERVE_GENERATION_ENV_VAR] === undefined) {
+    const hosting = resolveAgentV2Hosting({
+        architecture: input.project.agent.architecture,
+        env: input.env,
+    });
+    if (hosting.kind !== "cursor-managed") {
         return undefined;
     }
-    const envSnapshot = env;
     return createSessionRunLogStore(Object.assign({ sink: cursorHostedFiles({
-            resolveStoreSourceId: () => cursorFrameworkStoreSourceId(envSnapshot),
+            resolveStoreSourceId: () => hosting.resolveStoreIds().frameworkStoreSourceId,
             resolveApiKey: () => { var _a; return (_a = resolveApiKeySync()) === null || _a === void 0 ? void 0 : _a.apiKey; },
         }), agentName: input.project.name, logger: input.logger }, (input.snapshotLogs === undefined
         ? {}

package/dist/internal/start-log-store.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Durable hosted `start.log` on the framework file store. **v2 only.**
+ *
+ * The engine tees stdout/stderr to a local file. That file is the v2
+ * customer log (errors, traces, debug). It is NOT written to S3 per line:
+ * callers snapshot the local buffer and PUT once. The Temporal host does
+ * a last catch-up at the end of the delivery so the object is complete
+ * after park/discard.
+ *
+ * Same flush moments as `hosted-execution.json` and session-runs —
+ * see `hosted-execution-flush.ts`. Keys: {@link agentSdkStorageKeys.log}.
+ * Values are raw UTF-8, not JSON.
+ */
+import type { FileSink } from "../files.js";
+import type { AgentProject } from "../types.js";
+/**
+ * Last N bytes flushed to the store. Matches the Temporal catch-up cap
+ * so guest snapshots and host catch-up stay interchangeable. The store
+ * allows 64 MiB; this keeps the dashboard snapshot bounded.
+ */
+export declare const START_LOG_STORE_MAX_BYTES: number;
+/** Same path the hosted start command tees. Overridable in tests. */
+export declare const DEFAULT_ENGINE_START_LOG_PATH = "/workspace/.agent-serve/start.log";
+export interface StartLogStore {
+    persist(startLogId: string, contents: string): Promise<void>;
+    read(startLogId: string): Promise<string | undefined>;
+}
+export declare function tailStartLogText(raw: string, maxBytes: number): string;
+export declare function resolveEngineStartLogPath(env?: NodeJS.ProcessEnv): string;
+/**
+ * Read the local engine tee. Missing/empty is `undefined` (no store write).
+ * Soft-fail: a local read error must not change hosted-execution HTTP.
+ */
+export declare function readLocalStartLogText(args?: {
+    path?: string;
+    maxBytes?: number;
+}): Promise<string | undefined>;
+export declare function createStartLogStore(input: {
+    sink: FileSink;
+    agentName: string;
+    logger?: (line: string) => void;
+}): StartLogStore;
+/**
+ * Same selection as the session-run log: architecture-v2 hosted engines.
+ */
+export declare function selectStartLogStore(input: {
+    project: AgentProject;
+    logger?: (line: string) => void;
+    env?: Record<string, string | undefined>;
+}): StartLogStore | undefined;
+/**
+ * Snapshot the local tee into the store. No-op when the file is missing
+ * or empty. Soft-fail inside {@link StartLogStore.persist}.
+ */
+export declare function flushLocalStartLog(args: {
+    store: StartLogStore;
+    startLogId: string;
+    path?: string;
+}): Promise<void>;
+//# sourceMappingURL=start-log-store.d.ts.map

package/dist/internal/start-log-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"start-log-store.d.ts","sourceRoot":"","sources":["../../src/internal/start-log-store.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAGH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAG5C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAKhD;;;;GAIG;AACH,eAAO,MAAM,yBAAyB,EAAE,MAAwB,CAAC;AAEjE,qEAAqE;AACrE,eAAO,MAAM,6BAA6B,sCACL,CAAC;AAEtC,MAAM,WAAW,aAAa;IAC5B,OAAO,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7D,IAAI,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;CACvD;AAMD,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAQtE;AAED,wBAAgB,yBAAyB,CACvC,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC,MAAM,CAKR;AAED;;;GAGG;AACH,wBAAsB,qBAAqB,CAAC,IAAI,CAAC,EAAE;IACjD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAoB9B;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE;IACzC,IAAI,EAAE,QAAQ,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CACjC,GAAG,aAAa,CAkChB;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE;IACzC,OAAO,EAAE,YAAY,CAAC;IACtB,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAChC,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;CAC1C,GAAG,aAAa,GAAG,SAAS,CAiB5B;AAED;;;GAGG;AACH,wBAAsB,kBAAkB,CAAC,IAAI,EAAE;IAC7C,KAAK,EAAE,aAAa,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,GAAG,OAAO,CAAC,IAAI,CAAC,CAQhB"}

package/dist/internal/start-log-store.js

@@ -0,0 +1,149 @@
+/**
+ * Durable hosted `start.log` on the framework file store. **v2 only.**
+ *
+ * The engine tees stdout/stderr to a local file. That file is the v2
+ * customer log (errors, traces, debug). It is NOT written to S3 per line:
+ * callers snapshot the local buffer and PUT once. The Temporal host does
+ * a last catch-up at the end of the delivery so the object is complete
+ * after park/discard.
+ *
+ * Same flush moments as `hosted-execution.json` and session-runs —
+ * see `hosted-execution-flush.ts`. Keys: {@link agentSdkStorageKeys.log}.
+ * Values are raw UTF-8, not JSON.
+ */
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+import { readFile } from "node:fs/promises";
+import { cursorHostedFiles } from "../files-backends/cursor-hosted.js";
+import { agentSdkStorageKeys } from "../storage-protocol.js";
+import { resolveApiKeySync } from "./cursor/credentials.js";
+import { describeError } from "./describe-error.js";
+import { resolveAgentV2Hosting } from "./v2-hosting.js";
+/**
+ * Last N bytes flushed to the store. Matches the Temporal catch-up cap
+ * so guest snapshots and host catch-up stay interchangeable. The store
+ * allows 64 MiB; this keeps the dashboard snapshot bounded.
+ */
+export const START_LOG_STORE_MAX_BYTES = 2 * 1024 * 1024;
+/** Same path the hosted start command tees. Overridable in tests. */
+export const DEFAULT_ENGINE_START_LOG_PATH = "/workspace/.agent-serve/start.log";
+function decodeSinkBody(body) {
+    return body instanceof Uint8Array ? body : body.body;
+}
+export function tailStartLogText(raw, maxBytes) {
+    const encoded = new TextEncoder().encode(raw);
+    if (encoded.byteLength <= maxBytes) {
+        return raw;
+    }
+    return new TextDecoder().decode(encoded.subarray(encoded.byteLength - maxBytes));
+}
+export function resolveEngineStartLogPath(env = process.env) {
+    var _a;
+    const configured = (_a = env.AGENT_SERVE_ENGINE_START_LOG_PATH) === null || _a === void 0 ? void 0 : _a.trim();
+    return configured !== undefined && configured.length > 0
+        ? configured
+        : DEFAULT_ENGINE_START_LOG_PATH;
+}
+/**
+ * Read the local engine tee. Missing/empty is `undefined` (no store write).
+ * Soft-fail: a local read error must not change hosted-execution HTTP.
+ */
+export function readLocalStartLogText(args) {
+    return __awaiter(this, void 0, void 0, function* () {
+        var _a, _b;
+        const path = (_a = args === null || args === void 0 ? void 0 : args.path) !== null && _a !== void 0 ? _a : resolveEngineStartLogPath();
+        const maxBytes = (_b = args === null || args === void 0 ? void 0 : args.maxBytes) !== null && _b !== void 0 ? _b : START_LOG_STORE_MAX_BYTES;
+        try {
+            const raw = yield readFile(path, "utf8");
+            if (raw.length === 0) {
+                return undefined;
+            }
+            return tailStartLogText(raw, maxBytes);
+        }
+        catch (error) {
+            if (error !== null &&
+                typeof error === "object" &&
+                "code" in error &&
+                error.code === "ENOENT") {
+                return undefined;
+            }
+            return undefined;
+        }
+    });
+}
+export function createStartLogStore(input) {
+    var _a;
+    const { sink, agentName } = input;
+    const logger = (_a = input.logger) !== null && _a !== void 0 ? _a : (() => { });
+    return {
+        persist(startLogId, contents) {
+            return __awaiter(this, void 0, void 0, function* () {
+                const key = agentSdkStorageKeys.log(agentName, startLogId);
+                const body = tailStartLogText(contents, START_LOG_STORE_MAX_BYTES);
+                try {
+                    yield sink.put(key, new TextEncoder().encode(body));
+                }
+                catch (error) {
+                    logger(`[agent-sdk] start-log: persist failed for ${startLogId} (${describeError(error)})`);
+                }
+            });
+        },
+        read(startLogId) {
+            return __awaiter(this, void 0, void 0, function* () {
+                const key = agentSdkStorageKeys.log(agentName, startLogId);
+                try {
+                    const body = yield sink.get(key);
+                    if (body === undefined) {
+                        return undefined;
+                    }
+                    const text = new TextDecoder().decode(decodeSinkBody(body));
+                    return text.length === 0 ? undefined : text;
+                }
+                catch (error) {
+                    logger(`[agent-sdk] start-log: read failed for ${startLogId} (${describeError(error)})`);
+                    return undefined;
+                }
+            });
+        },
+    };
+}
+/**
+ * Same selection as the session-run log: architecture-v2 hosted engines.
+ */
+export function selectStartLogStore(input) {
+    const hosting = resolveAgentV2Hosting({
+        architecture: input.project.agent.architecture,
+        env: input.env,
+    });
+    if (hosting.kind !== "cursor-managed") {
+        return undefined;
+    }
+    return createStartLogStore({
+        sink: cursorHostedFiles({
+            resolveStoreSourceId: () => hosting.resolveStoreIds().frameworkStoreSourceId,
+            resolveApiKey: () => { var _a; return (_a = resolveApiKeySync()) === null || _a === void 0 ? void 0 : _a.apiKey; },
+        }),
+        agentName: input.project.name,
+        logger: input.logger,
+    });
+}
+/**
+ * Snapshot the local tee into the store. No-op when the file is missing
+ * or empty. Soft-fail inside {@link StartLogStore.persist}.
+ */
+export function flushLocalStartLog(args) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const contents = yield readLocalStartLogText(args.path === undefined ? undefined : { path: args.path });
+        if (contents === undefined) {
+            return;
+        }
+        yield args.store.persist(args.startLogId, contents);
+    });
+}