@cursor/july 0.1.100 → 0.1.101

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

@@ -14,7 +14,8 @@
  * 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 storageKeys.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,8 @@
  * 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 storageKeys.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); }); }

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 storageKeys.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;AAM5C,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,151 @@
+/**
+ * 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 storageKeys.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 { cursorFrameworkStoreSourceId, cursorHostedFiles, } from "../files-backends/cursor-hosted.js";
+import { storageKeys } 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";
+/**
+ * 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 = storageKeys.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 = storageKeys.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) {
+    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) {
+        return undefined;
+    }
+    const envSnapshot = env;
+    return createStartLogStore({
+        sink: cursorHostedFiles({
+            resolveStoreSourceId: () => cursorFrameworkStoreSourceId(envSnapshot),
+            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);
+    });
+}

package/dist/internal/tool-policy.d.ts

@@ -68,6 +68,14 @@ export interface ToolCallFacts {
     asOf?: string;
     /** The tool's declared time-bound argument names, if it made them. */
     timeArgs?: readonly string[];
+    /**
+     * String-typed time-window property names a vendor tool's own input schema
+     * declares (`from`/`to`/`since`/...). In a frozen session a call that omits
+     * one is refused: the vendor fills an omitted window with a live default
+     * the argument walker can never see. Advertised/bridged MCP tools only —
+     * authored tools declare {@link timeArgs} instead.
+     */
+    timeWindow?: readonly string[];
 }
 /**
  * The effect of one specific call.

package/dist/internal/tool-policy.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tool-policy.d.ts","sourceRoot":"","sources":["../../src/internal/tool-policy.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EACV,cAAc,EACd,kBAAkB,EAClB,UAAU,EACV,qBAAqB,EACrB,iBAAiB,EAClB,MAAM,aAAa,CAAC;AAGrB,6CAA6C;AAC7C,MAAM,MAAM,YAAY;AACtB,yBAAyB;AACvB;IAAE,IAAI,EAAE,KAAK,CAAA;CAAE;AACjB,uDAAuD;GACrD;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,MAAM,EAAE,iBAAiB,CAAA;CAAE;AAC/C;;;;;GAKG;GACD;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE;AACrC;;;GAGG;GACD;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAE3C,2DAA2D;AAC3D,MAAM,WAAW,aAAa;IAC5B,0DAA0D;IAC1D,MAAM,EAAE,OAAO,CAAC;IAChB,8CAA8C;IAC9C,MAAM,EAAE,qBAAqB,CAAC,KAAK,CAAC,GAAG,SAAS,CAAC;IACjD;;;;;;OAMG;IACH,OAAO,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,kBAAkB,CAAA;KAAE,CAAC;IAC7D,yEAAyE;IACzE,YAAY,CAAC,EAAE,iBAAiB,GAAG,CAAC,CAAC,KAAK,EAAE,KAAK,KAAK,iBAAiB,CAAC,CAAC;IACzE;;;;;OAKG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,qDAAqD;IACrD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,sEAAsE;IACtE,QAAQ,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC9B;AAUD;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAC3B,MAAM,EAAE,qBAAqB,CAAC,KAAK,CAAC,GAAG,SAAS,EAChD,KAAK,EAAE,OAAO,GACb,UAAU,CAIZ;AAED;;;;;;;;;GASG;AACH,wBAAgB,yBAAyB,CACvC,WAAW,EAAE,kBAAkB,GAAG,SAAS,GAC1C,UAAU,GAAG,SAAS,CAiBxB;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,IAAI,CAAC,cAAc,EAAE,YAAY,GAAG,aAAa,GAAG,YAAY,CAAC,EACvE,KAAK,EAAE,OAAO,GACb,UAAU,GAAG,SAAS,CAKxB;AAkBD,4EAA4E;AAC5E,wBAAgB,cAAc,CAAC,KAAK,EAAE,aAAa,GAAG,YAAY,CAuCjE"}
+{"version":3,"file":"tool-policy.d.ts","sourceRoot":"","sources":["../../src/internal/tool-policy.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EACV,cAAc,EACd,kBAAkB,EAClB,UAAU,EACV,qBAAqB,EACrB,iBAAiB,EAClB,MAAM,aAAa,CAAC;AAOrB,6CAA6C;AAC7C,MAAM,MAAM,YAAY;AACtB,yBAAyB;AACvB;IAAE,IAAI,EAAE,KAAK,CAAA;CAAE;AACjB,uDAAuD;GACrD;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,MAAM,EAAE,iBAAiB,CAAA;CAAE;AAC/C;;;;;GAKG;GACD;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE;AACrC;;;GAGG;GACD;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAE3C,2DAA2D;AAC3D,MAAM,WAAW,aAAa;IAC5B,0DAA0D;IAC1D,MAAM,EAAE,OAAO,CAAC;IAChB,8CAA8C;IAC9C,MAAM,EAAE,qBAAqB,CAAC,KAAK,CAAC,GAAG,SAAS,CAAC;IACjD;;;;;;OAMG;IACH,OAAO,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,kBAAkB,CAAA;KAAE,CAAC;IAC7D,yEAAyE;IACzE,YAAY,CAAC,EAAE,iBAAiB,GAAG,CAAC,CAAC,KAAK,EAAE,KAAK,KAAK,iBAAiB,CAAC,CAAC;IACzE;;;;;OAKG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,qDAAqD;IACrD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,sEAAsE;IACtE,QAAQ,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC7B;;;;;;OAMG;IACH,UAAU,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAChC;AAUD;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAC3B,MAAM,EAAE,qBAAqB,CAAC,KAAK,CAAC,GAAG,SAAS,EAChD,KAAK,EAAE,OAAO,GACb,UAAU,CAIZ;AAED;;;;;;;;;GASG;AACH,wBAAgB,yBAAyB,CACvC,WAAW,EAAE,kBAAkB,GAAG,SAAS,GAC1C,UAAU,GAAG,SAAS,CAiBxB;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,IAAI,CAAC,cAAc,EAAE,YAAY,GAAG,aAAa,GAAG,YAAY,CAAC,EACvE,KAAK,EAAE,OAAO,GACb,UAAU,GAAG,SAAS,CAKxB;AAkBD,4EAA4E;AAC5E,wBAAgB,cAAc,CAAC,KAAK,EAAE,aAAa,GAAG,YAAY,CAyDjE"}

package/dist/internal/tool-policy.js

@@ -8,7 +8,7 @@
  * decision lives here, in one pure function, and every path asks it rather
  * than re-implementing it.
  */
-import { timeArgViolation } from "./as-of.js";
+import { forwardTimeArgument, missingTimeWindow, timeArgViolation, } from "./as-of.js";
 /**
  * What a stubbed write answers. Deliberately not self-describing: a model told
  * mid-turn that its writes are not real starts hedging its conclusions, and
@@ -82,12 +82,24 @@ function unclassifiedRefusal(toolName) {
 export function decideToolCall(facts) {
     // Before the dry-run split: a frozen session bounds its reads whether or
     // not its writes are stubbed.
-    if (facts.asOf !== undefined &&
-        facts.timeArgs !== undefined &&
-        facts.timeArgs.length > 0) {
-        const violation = timeArgViolation(facts.input, facts.timeArgs, facts.asOf);
-        if (violation !== undefined) {
-            return { kind: "unbounded", message: violation };
+    if (facts.asOf !== undefined) {
+        if (facts.timeArgs !== undefined && facts.timeArgs.length > 0) {
+            const violation = timeArgViolation(facts.input, facts.timeArgs, facts.asOf);
+            if (violation !== undefined) {
+                return { kind: "unbounded", message: violation };
+            }
+        }
+        const forward = forwardTimeArgument(facts.input, facts.asOf);
+        if (forward !== undefined) {
+            return { kind: "unbounded", message: forward };
+        }
+        // Present values are checked above; absent ones are the vendor's live
+        // default window, which no walker can see. Require them explicitly.
+        if (facts.timeWindow !== undefined) {
+            const omitted = missingTimeWindow(facts.input, facts.timeWindow, facts.asOf);
+            if (omitted !== undefined) {
+                return { kind: "unbounded", message: omitted };
+            }
         }
     }
     if (!facts.dryRun) {