@cursor/july 0.1.97 → 0.1.99

package/dist/internal/hosted-delivery.js

@@ -8,13 +8,14 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
     });
 };
 import { randomBytes } from "node:crypto";
-import { dispatchGitHubWebhook, getGitHubChannelOptions, getGitHubDispatchOutcome, withPropagatingGitHubBackgroundErrors, } from "../channels/github/github-channel.js";
 import { createDeferredChannelSession, DeferredChannelSessionError, } from "./deferred-channel-session.js";
+import { getHostedAdmissionAdapter, } from "./hosted-admission-adapter.js";
 import { HostedAdmissionLocalSendError, runDuringHostedAdmission, } from "./hosted-admission-context.js";
 import { HOSTED_ADMISSION_PATH, HOSTED_DELIVERY_HEADER, HOSTED_DELIVERY_PROTOCOL_VERSION, HOSTED_EXECUTION_PATH, parseHostedAdmission, parseHostedExecution, } from "./hosted-delivery-protocol.js";
-import { abortReasonFromTurnStatus, HOSTED_EXECUTION_DIAG_RUNNING_STATUS, hostedExecutionDiagId, writeHostedExecutionDiag, } from "./hosted-execution-diag.js";
+import { abortReasonFromTurnStatus, HOSTED_EXECUTION_DIAG_RUNNING_STATUS, hostedErrorStackSnippet, hostedExecutionDiagId, writeHostedExecutionDiag, } from "./hosted-execution-diag.js";
 import { recordHostedManagedAutomation } from "./hosted-managed-automation.js";
 import { errorResponse, readJsonObject } from "./http-channel.js";
+import { serializeSessionRunError, snapshotSessionRunLogs, } from "./session-run-log.js";
 /**
  * A second `send()` in one delivery is a deterministic authored bug — the
  * wire protocol carries exactly one pending send per delivery — so it must
@@ -59,30 +60,35 @@ function nonRetryableRejection(error) {
     };
 }
 /**
- * Run authored admission without creating a framework session. V1 GitHub
+ * Run authored admission without creating a framework session. Authored
  * `task` callbacks execute as sessionless work; the first `send` is captured
  * and executed only after the control plane allocates `ses_…`. Capturing
  * does not terminate the caller — `send` returns an inert deferred handle so
  * a task body runs to completion before the admission response is computed.
+ *
+ * Dispatch is the adapter the mounted channel attached. Hosted delivery
+ * does not switch on `channelKind`.
  */
 export function dispatchHostedAdmission(input) {
     return __awaiter(this, void 0, void 0, function* () {
-        const github = getGitHubChannelOptions(input.definition);
-        if (github === undefined) {
+        const adapter = getHostedAdmissionAdapter(input.definition);
+        if (adapter === undefined || adapter.kind !== input.delivery.channelKind) {
             return {
                 response: Response.json({ ok: false, error: "channel_kind_mismatch" }, { status: 422 }),
             };
         }
         // The admission window marker follows the async graph into task bodies so
         // the engine can refuse local sends that would bypass the capture stub.
-        return runDuringHostedAdmission(() => runAdmission(input, github));
+        return runDuringHostedAdmission(() => runAdmission(input, adapter));
     });
 }
-function runAdmission(input, github) {
+function runAdmission(input, adapter) {
     return __awaiter(this, void 0, void 0, function* () {
+        var _a;
+        var _b;
         const background = [];
         let captured;
-        const args = withPropagatingGitHubBackgroundErrors(Object.assign(Object.assign({}, input.args), { send: (message_1, ...args_1) => __awaiter(this, [message_1, ...args_1], void 0, function* (message, options = {}) {
+        const capturingArgs = Object.assign(Object.assign({}, input.args), { send: (message_1, ...args_1) => __awaiter(this, [message_1, ...args_1], void 0, function* (message, options = {}) {
                 if (captured !== undefined) {
                     throw new HostedSendLimitExceeded();
                 }
@@ -90,12 +96,12 @@ function runAdmission(input, github) {
                 return createDeferredChannelSession();
             }), waitUntil: (promise) => {
                 background.push(promise);
-            } }));
+            } });
+        const args = (_b = (_a = adapter.prepareArgs) === null || _a === void 0 ? void 0 : _a.call(adapter, capturingArgs)) !== null && _b !== void 0 ? _b : capturingArgs;
         let dispatched;
         try {
-            dispatched = yield dispatchGitHubWebhook({
-                options: github,
-                eventName: input.delivery.eventType,
+            dispatched = yield adapter.dispatch({
+                eventType: input.delivery.eventType,
                 payload: input.delivery.payload,
                 deliveryId: input.delivery.deliveryId,
                 args,
@@ -140,7 +146,7 @@ function runAdmission(input, github) {
                 },
             };
         }
-        const outcome = getGitHubDispatchOutcome(dispatched);
+        const outcome = adapter.getOutcome(dispatched);
         if (outcome === undefined) {
             return {
                 response: Response.json({ ok: false, error: "channel_outcome_missing" }, { status: 502 }),
@@ -252,17 +258,36 @@ export function registerHostedDeliveryRoute(input) {
                 const startedAt = performance.now();
                 const executionId = hostedExecutionDiagId(execution.admissionToken);
                 const writeDiag = (fields) => __awaiter(this, void 0, void 0, function* () {
-                    if (input.stateRoot === undefined) {
-                        return;
-                    }
+                    var _a;
+                    var _b;
+                    const durationMs = Math.max(0, Math.round(performance.now() - startedAt));
                     const message = fields.message === undefined
                         ? undefined
                         : boundedMessage(fields.message);
-                    yield writeHostedExecutionDiag(input.stateRoot, Object.assign(Object.assign(Object.assign({ v: 1, executionId, writtenAt: new Date().toISOString(), sessionPublicId: execution.sessionPublicId, sessionId: fields.sessionId, turnStatus: fields.turnStatus, durationMs: Math.max(0, Math.round(performance.now() - startedAt)) }, (message === undefined ? {} : { message })), (message !== undefined && /abort/i.test(message)
-                        ? { signalAborted: true }
-                        : {})), (fields.abortReason === undefined
-                        ? {}
-                        : { abortReason: fields.abortReason })));
+                    const stack = fields.error === undefined
+                        ? undefined
+                        : hostedErrorStackSnippet(fields.error);
+                    if (input.stateRoot !== undefined) {
+                        yield writeHostedExecutionDiag(input.stateRoot, Object.assign(Object.assign(Object.assign(Object.assign({ v: 1, executionId, writtenAt: new Date().toISOString(), sessionPublicId: execution.sessionPublicId, sessionId: fields.sessionId, turnStatus: fields.turnStatus, durationMs }, (message === undefined ? {} : { message })), (stack === undefined || stack.length === 0 ? {} : { stack })), (message !== undefined && /abort/i.test(message)
+                            ? { signalAborted: true }
+                            : {})), (fields.abortReason === undefined
+                            ? {}
+                            : { abortReason: fields.abortReason })));
+                    }
+                    if (input.persistSessionRun === undefined) {
+                        return;
+                    }
+                    const error = fields.error === undefined
+                        ? undefined
+                        : serializeSessionRunError(fields.error);
+                    try {
+                        yield input.persistSessionRun(Object.assign(Object.assign(Object.assign(Object.assign({ executionId, writtenAt: new Date().toISOString(), sessionPublicId: execution.sessionPublicId, sessionId: fields.sessionId, turnStatus: fields.turnStatus, durationMs }, (fields.abortReason === undefined
+                            ? {}
+                            : { abortReason: fields.abortReason })), (message === undefined ? {} : { message })), (error === undefined ? {} : { error })), { logs: snapshotSessionRunLogs((_b = (_a = input.snapshotLogs) === null || _a === void 0 ? void 0 : _a.call(input)) !== null && _b !== void 0 ? _b : []) }));
+                    }
+                    catch (_c) {
+                        // Soft-fail: a store outage must not change the HTTP reply.
+                    }
                 });
                 // Claim the file before the turn runs. The host reads it after its
                 // own POST returns, which for a 9-minute timeout is while this turn
@@ -313,6 +338,7 @@ export function registerHostedDeliveryRoute(input) {
                         turnStatus: "error",
                         message: error instanceof Error ? error.message : String(error),
                         abortReason: "execute_throw",
+                        error,
                     });
                     throw error;
                 }

package/dist/internal/hosted-execution-diag.d.ts

@@ -31,12 +31,23 @@ export type HostedExecutionDiag = {
     turnStatus: string;
     durationMs: number;
     message?: string;
+    /** First frames of a thrown Error; omitted on soft turn failures. */
+    stack?: string;
     signalAborted?: boolean;
     requestId?: string;
     abortReason?: HostedExecutionDiagAbortReason;
 };
 /** Written before the turn starts so a stalled execution still has a record. */
 export declare const HOSTED_EXECUTION_DIAG_RUNNING_STATUS = "running";
+/** First line + frames; factory `last_error` is 1024 chars with a TAS prefix. */
+export declare const HOSTED_ERROR_STACK_LINE_COUNT = 5;
+export declare const HOSTED_ERROR_SNIPPET_MAX_CHARS = 700;
+/**
+ * Bounded throw text for the hosted 500 body and the on-disk diag `stack`.
+ * Prefers `Error.stack` (message line + `at` frames) so `last_error` is not
+ * the generic "Internal server error." when the throw has a stack.
+ */
+export declare function hostedErrorStackSnippet(error: unknown): string;
 export declare function hostedExecutionDiagPath(stateRoot: string): string;
 export declare function abortReasonFromTurnStatus(status: string, message: string | undefined): HostedExecutionDiagAbortReason | undefined;
 export declare function parseHostedExecutionDiag(raw: string): HostedExecutionDiag | undefined;

package/dist/internal/hosted-execution-diag.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hosted-execution-diag.d.ts","sourceRoot":"","sources":["../../src/internal/hosted-execution-diag.ts"],"names":[],"mappings":"AAMA,eAAO,MAAM,6BAA6B,IAAI,CAAC;AAC/C,2EAA2E;AAC3E,eAAO,MAAM,+BAA+B,OAAO,CAAC;AAEpD;;;;;;;;;;;GAWG;AACH,wBAAgB,qBAAqB,CAAC,cAAc,EAAE,MAAM,GAAG,MAAM,CAEpE;AAED,MAAM,MAAM,8BAA8B,GACtC,cAAc,GACd,kBAAkB,GAClB,cAAc,GACd,eAAe,CAAC;AAEpB;;;;GAIG;AACH,MAAM,MAAM,mBAAmB,GAAG;IAChC,CAAC,EAAE,OAAO,6BAA6B,CAAC;IACxC,6EAA6E;IAC7E,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,EAAE,MAAM,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,8EAA8E;IAC9E,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,8BAA8B,CAAC;CAC9C,CAAC;AAEF,gFAAgF;AAChF,eAAO,MAAM,oCAAoC,YAAY,CAAC;AAkC9D,wBAAgB,uBAAuB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAEjE;AAED,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,GAAG,SAAS,GAC1B,8BAA8B,GAAG,SAAS,CAU5C;AAED,wBAAgB,wBAAwB,CACtC,GAAG,EAAE,MAAM,GACV,mBAAmB,GAAG,SAAS,CAsEjC;AAED;;;GAGG;AACH,wBAAsB,wBAAwB,CAC5C,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,mBAAmB,GACxB,OAAO,CAAC,IAAI,CAAC,CAkBf"}
+{"version":3,"file":"hosted-execution-diag.d.ts","sourceRoot":"","sources":["../../src/internal/hosted-execution-diag.ts"],"names":[],"mappings":"AAMA,eAAO,MAAM,6BAA6B,IAAI,CAAC;AAC/C,2EAA2E;AAC3E,eAAO,MAAM,+BAA+B,OAAO,CAAC;AAEpD;;;;;;;;;;;GAWG;AACH,wBAAgB,qBAAqB,CAAC,cAAc,EAAE,MAAM,GAAG,MAAM,CAEpE;AAED,MAAM,MAAM,8BAA8B,GACtC,cAAc,GACd,kBAAkB,GAClB,cAAc,GACd,eAAe,CAAC;AAEpB;;;;GAIG;AACH,MAAM,MAAM,mBAAmB,GAAG;IAChC,CAAC,EAAE,OAAO,6BAA6B,CAAC;IACxC,6EAA6E;IAC7E,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,EAAE,MAAM,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,8EAA8E;IAC9E,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,qEAAqE;IACrE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,8BAA8B,CAAC;CAC9C,CAAC;AAEF,gFAAgF;AAChF,eAAO,MAAM,oCAAoC,YAAY,CAAC;AAmC9D,iFAAiF;AACjF,eAAO,MAAM,6BAA6B,IAAI,CAAC;AAC/C,eAAO,MAAM,8BAA8B,MAAM,CAAC;AAElD;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAyB9D;AAED,wBAAgB,uBAAuB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAEjE;AAED,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,GAAG,SAAS,GAC1B,8BAA8B,GAAG,SAAS,CAU5C;AAED,wBAAgB,wBAAwB,CACtC,GAAG,EAAE,MAAM,GACV,mBAAmB,GAAG,SAAS,CA2EjC;AAED;;;GAGG;AACH,wBAAsB,wBAAwB,CAC5C,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,mBAAmB,GACxB,OAAO,CAAC,IAAI,CAAC,CAmBf"}

package/dist/internal/hosted-execution-diag.js

@@ -40,6 +40,7 @@ const DIAG_KEYS = new Set([
     "turnStatus",
     "durationMs",
     "message",
+    "stack",
     "signalAborted",
     "requestId",
     "abortReason",
@@ -57,6 +58,41 @@ function boundedOptionalString(value, max) {
             : value
         : undefined;
 }
+/** First line + frames; factory `last_error` is 1024 chars with a TAS prefix. */
+export const HOSTED_ERROR_STACK_LINE_COUNT = 5;
+export const HOSTED_ERROR_SNIPPET_MAX_CHARS = 700;
+/**
+ * Bounded throw text for the hosted 500 body and the on-disk diag `stack`.
+ * Prefers `Error.stack` (message line + `at` frames) so `last_error` is not
+ * the generic "Internal server error." when the throw has a stack.
+ */
+export function hostedErrorStackSnippet(error) {
+    var _a;
+    if (error instanceof Error) {
+        const stack = (_a = error.stack) === null || _a === void 0 ? void 0 : _a.trim();
+        if (stack !== undefined && stack.length > 0) {
+            const lines = stack
+                .split("\n")
+                .map((line) => line.trimEnd())
+                .filter((line) => line.trim().length > 0)
+                .slice(0, HOSTED_ERROR_STACK_LINE_COUNT);
+            const text = lines.join("\n");
+            return text.length > HOSTED_ERROR_SNIPPET_MAX_CHARS
+                ? `${text.slice(0, HOSTED_ERROR_SNIPPET_MAX_CHARS)}…`
+                : text;
+        }
+        return error.message.length > HOSTED_ERROR_SNIPPET_MAX_CHARS
+            ? `${error.message.slice(0, HOSTED_ERROR_SNIPPET_MAX_CHARS)}…`
+            : error.message;
+    }
+    const text = String(error);
+    if (text.length === 0) {
+        return "";
+    }
+    return text.length > HOSTED_ERROR_SNIPPET_MAX_CHARS
+        ? `${text.slice(0, HOSTED_ERROR_SNIPPET_MAX_CHARS)}…`
+        : text;
+}
 export function hostedExecutionDiagPath(stateRoot) {
     return join(stateRoot, HOSTED_EXECUTION_DIAG_FILENAME);
 }
@@ -110,6 +146,7 @@ export function parseHostedExecutionDiag(raw) {
         return undefined;
     }
     const message = boundedOptionalString(body.message, 1024);
+    const stack = boundedOptionalString(body.stack, HOSTED_ERROR_SNIPPET_MAX_CHARS);
     const requestId = boundedOptionalString(body.requestId, 128);
     const abortReason = body.abortReason === undefined
         ? undefined
@@ -124,7 +161,7 @@ export function parseHostedExecutionDiag(raw) {
         typeof body.signalAborted !== "boolean") {
         return undefined;
     }
-    return Object.assign(Object.assign(Object.assign(Object.assign({ v: HOSTED_EXECUTION_DIAG_VERSION, executionId: body.executionId, writtenAt: body.writtenAt, sessionPublicId: body.sessionPublicId, sessionId: body.sessionId, turnStatus: body.turnStatus, durationMs: body.durationMs }, (message === undefined ? {} : { message })), (body.signalAborted === true ? { signalAborted: true } : {})), (requestId === undefined ? {} : { requestId })), (abortReason === undefined ? {} : { abortReason }));
+    return Object.assign(Object.assign(Object.assign(Object.assign(Object.assign({ v: HOSTED_EXECUTION_DIAG_VERSION, executionId: body.executionId, writtenAt: body.writtenAt, sessionPublicId: body.sessionPublicId, sessionId: body.sessionId, turnStatus: body.turnStatus, durationMs: body.durationMs }, (message === undefined ? {} : { message })), (stack === undefined ? {} : { stack })), (body.signalAborted === true ? { signalAborted: true } : {})), (requestId === undefined ? {} : { requestId })), (abortReason === undefined ? {} : { abortReason }));
 }
 /**
  * Overwrite the per-execution diag file. Soft-fail: a write error must not
@@ -138,7 +175,7 @@ export function writeHostedExecutionDiag(stateRoot, diag) {
             yield mkdir(stateRoot, { recursive: true });
             const serialized = JSON.stringify(diag);
             const body = serialized.length > HOSTED_EXECUTION_DIAG_MAX_BYTES
-                ? JSON.stringify(Object.assign(Object.assign({}, diag), { message: boundedOptionalString(diag.message, 256) }))
+                ? JSON.stringify(Object.assign(Object.assign({}, diag), { stack: undefined, message: boundedOptionalString(diag.message, 256) }))
                 : serialized;
             yield writeFile(tmp, body, "utf8");
             yield rename(tmp, path);

package/dist/internal/http-channel.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"http-channel.d.ts","sourceRoot":"","sources":["../../src/internal/http-channel.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAEV,WAAW,EACX,UAAU,EACV,qBAAqB,EACrB,aAAa,EACd,MAAM,aAAa,CAAC;AAIrB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,EAOL,KAAK,aAAa,EACnB,MAAM,qBAAqB,CAAC;AAQ7B,wBAAgB,sBAAsB,CAAC,IAAI,EAAE;IAC3C,MAAM,EAAE,aAAa,CAAC;IACtB,MAAM,EAAE,qBAAqB,CAAC;IAC9B,IAAI,EAAE,UAAU,EAAE,CAAC;IACnB,4DAA4D;IAC5D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;;;;OAMG;IACH,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B;;;OAGG;IACH,kCAAkC,CAAC,EAAE,OAAO,CAAC;IAC7C;;;;;OAKG;IACH,wBAAwB,CAAC,EAAE,OAAO,CAAC;CACpC,GAAG,WAAW,EAAE,CAmfhB;AAED,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,aAAa,EACrB,MAAM,EAAE,WAAW,GAAG,IAAI,EAC1B,OAAO,CAAC,EAAE;IACR,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B,GACA,QAAQ,GAAG,SAAS,CAiBtB;AAED,wBAAgB,YAAY,CAC1B,IAAI,EAAE,OAAO,EACb,IAAI,GAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAAO,GAC/D,QAAQ,CAQV;AAED,wBAAgB,aAAa,CAC3B,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,GACd,QAAQ,CAEV;AAoGD,wBAAsB,cAAc,CAClC,OAAO,EAAE,OAAO,GACf,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC,CAc9C"}
+{"version":3,"file":"http-channel.d.ts","sourceRoot":"","sources":["../../src/internal/http-channel.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAEV,WAAW,EACX,UAAU,EACV,qBAAqB,EACrB,aAAa,EACd,MAAM,aAAa,CAAC;AAIrB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,EAOL,KAAK,aAAa,EACnB,MAAM,qBAAqB,CAAC;AAQ7B,wBAAgB,sBAAsB,CAAC,IAAI,EAAE;IAC3C,MAAM,EAAE,aAAa,CAAC;IACtB,MAAM,EAAE,qBAAqB,CAAC;IAC9B,IAAI,EAAE,UAAU,EAAE,CAAC;IACnB,4DAA4D;IAC5D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;;;;OAMG;IACH,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B;;;OAGG;IACH,kCAAkC,CAAC,EAAE,OAAO,CAAC;IAC7C;;;;;OAKG;IACH,wBAAwB,CAAC,EAAE,OAAO,CAAC;CACpC,GAAG,WAAW,EAAE,CA2fhB;AAED,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,aAAa,EACrB,MAAM,EAAE,WAAW,GAAG,IAAI,EAC1B,OAAO,CAAC,EAAE;IACR,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B,GACA,QAAQ,GAAG,SAAS,CAiBtB;AAED,wBAAgB,YAAY,CAC1B,IAAI,EAAE,OAAO,EACb,IAAI,GAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAAO,GAC/D,QAAQ,CAQV;AAED,wBAAgB,aAAa,CAC3B,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,GACd,QAAQ,CAEV;AAoGD,wBAAsB,cAAc,CAClC,OAAO,EAAE,OAAO,GACf,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC,CAc9C"}

package/dist/internal/http-channel.js

@@ -48,12 +48,15 @@ export function buildHttpChannelRoutes(args) {
             if (body === undefined || typeof body.message !== "string") {
                 return errorResponse(400, "invalid_request", "Expected a JSON body with a string `message`.");
             }
+            if (body.asOf !== undefined && typeof body.asOf !== "string") {
+                return errorResponse(400, "invalid_request", "`asOf` must be an ISO-8601 instant with a timezone when provided.");
+            }
             const message = yield transformMessage(body.message, ctx.auth);
             const workspaceFiles = readWorkspaceFiles(body.workspaceFiles);
             // Per-session cloud attach (create only). Eval harness uses this to pin
             // fixture repos without putting them on the agent's default cloud.repos.
             const cloud = readCloudOptions(body.cloud);
-            const session = yield engine.send(HTTP_CHANNEL_ID, message, Object.assign(Object.assign(Object.assign(Object.assign(Object.assign({ auth: ctx.auth }, (typeof body.title === "string" ? { title: body.title } : {})), (body.purpose === "eval" ? { purpose: "eval" } : {})), (body.dryRun === true ? { dryRun: true } : {})), (workspaceFiles === undefined ? {} : { workspaceFiles })), (cloud === undefined ? {} : { cloud })));
+            const session = yield engine.send(HTTP_CHANNEL_ID, message, Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign({ auth: ctx.auth }, (typeof body.title === "string" ? { title: body.title } : {})), (body.purpose === "eval" ? { purpose: "eval" } : {})), (body.dryRun === true ? { dryRun: true } : {})), { asOf: body.asOf }), (workspaceFiles === undefined ? {} : { workspaceFiles })), (cloud === undefined ? {} : { cloud })));
             return jsonResponse({
                 ok: true,
                 sessionId: session.id,

package/dist/internal/null-kv-storage.d.ts

@@ -0,0 +1,48 @@
+/**
+ * The inert KV half of hosted v2 storage.
+ *
+ * The control-plane KV proxy (`/internal/agent-serve/storage/*`) authorizes a
+ * request by mapping the caller's pod service account to a row in the v1
+ * deployment table. Architecture v2 registers its deployments in the factory
+ * control plane instead, so every proxy call from a v2 pod answers
+ * `403 No Agent Serve deployment is bound to this service account`. The
+ * lazy-restore path deliberately propagates read failures (a store outage must
+ * not read as "unknown continuation token"), so those 403s fail follow-up
+ * deliveries outright.
+ *
+ * This backend stands in for the proxy until it can resolve v2 deployments:
+ * writes are dropped, reads are definitive misses, and lists are empty. It is
+ * paired with the framework file store (see framework-file-storage.ts), which
+ * authorizes by store source id rather than by deployment row and therefore
+ * still carries session records, event transcripts, and the continuation
+ * index — the state sessions are restored from.
+ *
+ * Author KV is the one thing that must not silently accept writes here, since
+ * handlers read their own writes back. {@link AUTHOR_KV_UNSUPPORTED} marks the
+ * definition so `ctx.host.kv` falls back to `--state-root` disk instead, the
+ * same fallback a deployment with no configured backend gets.
+ */
+import type { StorageConfig } from "../storage.js";
+/**
+ * Marker stamped on a definition whose KV core cannot serve `ctx.host.kv`,
+ * even though `get` is present for framework session state. Explicit
+ * `unique symbol` annotation required for `--isolatedDeclarations` (TS9010).
+ */
+export declare const AUTHOR_KV_UNSUPPORTED: unique symbol;
+/** True when `value` was built from {@link nullKvStorage}. */
+export declare function isAuthorKvUnsupported(value: unknown): boolean;
+type NullKvStorageMethods = Required<Pick<StorageConfig, "put" | "get" | "delete" | "list">> & {
+    readonly [AUTHOR_KV_UNSUPPORTED]: true;
+};
+/**
+ * A KV core that stores nothing. `get` resolving `undefined` is honest here
+ * rather than dangerous: nothing was ever written, so a miss cannot shadow a
+ * session that exists elsewhere.
+ *
+ * No `cas` group and no `listNewest`: conditional writes over a store that
+ * forgets would report a lock acquired, and write-time ordering means nothing
+ * without writes.
+ */
+export declare function nullKvStorage(): NullKvStorageMethods;
+export {};
+//# sourceMappingURL=null-kv-storage.d.ts.map

package/dist/internal/null-kv-storage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"null-kv-storage.d.ts","sourceRoot":"","sources":["../../src/internal/null-kv-storage.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAGnD;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,EAAE,OAAO,MAE1C,CAAC;AAEF,8DAA8D;AAC9D,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAM7D;AAED,KAAK,oBAAoB,GAAG,QAAQ,CAClC,IAAI,CAAC,aAAa,EAAE,KAAK,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC,CACvD,GAAG;IACF,QAAQ,CAAC,CAAC,qBAAqB,CAAC,EAAE,IAAI,CAAC;CACxC,CAAC;AAEF;;;;;;;;GAQG;AACH,wBAAgB,aAAa,IAAI,oBAAoB,CAYpD"}

package/dist/internal/null-kv-storage.js

@@ -0,0 +1,58 @@
+/**
+ * The inert KV half of hosted v2 storage.
+ *
+ * The control-plane KV proxy (`/internal/agent-serve/storage/*`) authorizes a
+ * request by mapping the caller's pod service account to a row in the v1
+ * deployment table. Architecture v2 registers its deployments in the factory
+ * control plane instead, so every proxy call from a v2 pod answers
+ * `403 No Agent Serve deployment is bound to this service account`. The
+ * lazy-restore path deliberately propagates read failures (a store outage must
+ * not read as "unknown continuation token"), so those 403s fail follow-up
+ * deliveries outright.
+ *
+ * This backend stands in for the proxy until it can resolve v2 deployments:
+ * writes are dropped, reads are definitive misses, and lists are empty. It is
+ * paired with the framework file store (see framework-file-storage.ts), which
+ * authorizes by store source id rather than by deployment row and therefore
+ * still carries session records, event transcripts, and the continuation
+ * index — the state sessions are restored from.
+ *
+ * Author KV is the one thing that must not silently accept writes here, since
+ * handlers read their own writes back. {@link AUTHOR_KV_UNSUPPORTED} marks the
+ * definition so `ctx.host.kv` falls back to `--state-root` disk instead, the
+ * same fallback a deployment with no configured backend gets.
+ */
+/**
+ * Marker stamped on a definition whose KV core cannot serve `ctx.host.kv`,
+ * even though `get` is present for framework session state. Explicit
+ * `unique symbol` annotation required for `--isolatedDeclarations` (TS9010).
+ */
+export const AUTHOR_KV_UNSUPPORTED = Symbol.for("@cursor/july.storage.author-kv-unsupported");
+/** True when `value` was built from {@link nullKvStorage}. */
+export function isAuthorKvUnsupported(value) {
+    return (typeof value === "object" &&
+        value !== null &&
+        value[AUTHOR_KV_UNSUPPORTED] === true);
+}
+/**
+ * A KV core that stores nothing. `get` resolving `undefined` is honest here
+ * rather than dangerous: nothing was ever written, so a miss cannot shadow a
+ * session that exists elsewhere.
+ *
+ * No `cas` group and no `listNewest`: conditional writes over a store that
+ * forgets would report a lock acquired, and write-time ordering means nothing
+ * without writes.
+ */
+export function nullKvStorage() {
+    return {
+        [AUTHOR_KV_UNSUPPORTED]: true,
+        put() { },
+        get() {
+            return undefined;
+        },
+        delete() { },
+        list() {
+            return [];
+        },
+    };
+}

package/dist/internal/server.d.ts

@@ -7,6 +7,7 @@
 import type { AgentProject, AgentServeHandle, ServeOptions } from "../types.js";
 import type { McpOauthSecretsTarget } from "./mcp-oauth-persist.js";
 import { type AgentRunner } from "./sdk-runner.js";
+import { selectSessionRunLogStore } from "./session-run-log.js";
 /** One agent to serve: its slug (empty for single-agent mode) and project. */
 export interface AgentMount {
     slug: string;
@@ -18,6 +19,8 @@ export interface StartServerInternalOptions {
     runner?: AgentRunner;
     /** Test seam: bind the `--store` secrets client for on-demand MCP OAuth. */
     mcpOauthSecrets?: McpOauthSecretsTarget;
+    /** Test seam: persist hosted-execution run logs without a live store. */
+    sessionRunLog?: ReturnType<typeof selectSessionRunLogStore>;
 }
 /**
  * Start an HTTP server hosting one or more agents. A single agent with an

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

@@ -1 +1 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/internal/server.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAoCH,OAAO,KAAK,EACV,YAAY,EACZ,gBAAgB,EAOhB,YAAY,EACb,MAAM,aAAa,CAAC;AAqFrB,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAyCpE,OAAO,EAAE,KAAK,WAAW,EAAmB,MAAM,iBAAiB,CAAC;AA2BpE,8EAA8E;AAC9E,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,YAAY,CAAC;CACvB;AAmCD,6EAA6E;AAC7E,MAAM,WAAW,0BAA0B;IACzC,oEAAoE;IACpE,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,4EAA4E;IAC5E,eAAe,CAAC,EAAE,qBAAqB,CAAC;CACzC;AAED;;;;GAIG;AACH,wBAAsB,WAAW,CAC/B,MAAM,EAAE,UAAU,EAAE,EACpB,OAAO,GAAE,YAAY,GAAG,0BAA+B,GACtD,OAAO,CAAC,gBAAgB,CAAC,CAw9B3B"}
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/internal/server.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAoCH,OAAO,KAAK,EACV,YAAY,EACZ,gBAAgB,EAOhB,YAAY,EACb,MAAM,aAAa,CAAC;AAuFrB,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAyCpE,OAAO,EAAE,KAAK,WAAW,EAAmB,MAAM,iBAAiB,CAAC;AAWpE,OAAO,EAEL,wBAAwB,EAEzB,MAAM,sBAAsB,CAAC;AAiB9B,8EAA8E;AAC9E,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,YAAY,CAAC;CACvB;AAmCD,6EAA6E;AAC7E,MAAM,WAAW,0BAA0B;IACzC,oEAAoE;IACpE,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,4EAA4E;IAC5E,eAAe,CAAC,EAAE,qBAAqB,CAAC;IACxC,yEAAyE;IACzE,aAAa,CAAC,EAAE,UAAU,CAAC,OAAO,wBAAwB,CAAC,CAAC;CAC7D;AAED;;;;GAIG;AACH,wBAAsB,WAAW,CAC/B,MAAM,EAAE,UAAU,EAAE,EACpB,OAAO,GAAE,YAAY,GAAG,0BAA+B,GACtD,OAAO,CAAC,gBAAgB,CAAC,CA2+B3B"}