@cursor/bdk 0.2.1 → 0.2.3

package/dist/internal/hosted-delivery-protocol.d.ts

@@ -1,3 +1,9 @@
+/**
+ * Private control-plane/engine wire contract. Version 2 is unreleased and
+ * intentionally strict: unknown fields and modes fail closed. After release,
+ * any shape or semantic change must use a new version and a rolling
+ * compatibility window. See `docs/agent-serve/hosted-delivery-protocol.md`.
+ */
 export declare const HOSTED_DELIVERY_PROTOCOL_VERSION = 2;
 export declare const HOSTED_DELIVERY_HEADER = "x-agent-sdk-hosted-delivery";
 export declare const HOSTED_ADMISSION_PATH = "/v1/internal/hosted-admission";
@@ -109,7 +115,7 @@ export type HostedAdmissionPlatformHandoff = {
         streamed: false;
     };
 };
-export type HostedAdmission = {
+export type HostedAdmissionInput = {
     v: 2;
     channelId: string;
     /**
@@ -127,6 +133,15 @@ export type HostedAdmission = {
     /** Present only when control-plane Slack fast-act posted a placeholder. */
     platformHandoff?: HostedAdmissionPlatformHandoff;
 };
+export type HostedAdmissionStart = HostedAdmissionInput & {
+    mode: "start";
+};
+export type HostedAdmissionStatus = {
+    v: 2;
+    mode: "status";
+    deliveryId: string;
+};
+export type HostedAdmission = HostedAdmissionStart | HostedAdmissionStatus;
 export type HostedAdmissionOutcome = {
     ok: true;
     v: 2;
@@ -136,6 +151,10 @@ export type HostedAdmissionOutcome = {
     v: 2;
     outcome: "send";
     admissionToken: string;
+} | {
+    ok: true;
+    v: 2;
+    outcome: "started" | "running";
 };
 /**
  * Cap on delivery IDs an owner execute may report as consumed (primary +
@@ -143,18 +162,18 @@ export type HostedAdmissionOutcome = {
  * `not_active`.
  */
 export declare const HOSTED_MAX_CONSUMED_DELIVERY_IDS = 16;
-/** Hosted-execution run mode. Omitted/`execute` is the legacy wait path. */
-export type HostedExecutionMode = "execute" | "enqueue";
+/** Hosted-execution is unary: start/status for owners, enqueue for guests. */
+export type HostedExecutionMode = "enqueue" | "start" | "status";
 export type HostedExecution = {
     v: 2;
     admissionToken: string;
     sessionPublicId: string;
     /**
-     * `execute` (default when omitted) runs the owner send and waits for the
-     * coalesce chain. `enqueue` injects into an accepting owner or returns
-     * `not_active`.
+     * `enqueue` injects into an accepting owner or returns `not_active`.
+     * `start` launches the owner turn and returns `started` immediately.
+     * `status` returns `running` or replays the terminal response.
      */
-    mode?: HostedExecutionMode;
+    mode: HostedExecutionMode;
 };
 export type HostedExecutionOutcome = {
     ok: true;
@@ -162,10 +181,8 @@ export type HostedExecutionOutcome = {
     outcome: "send";
     /**
      * Primary delivery id then accepted enqueue ids; length 1..16.
-     * Optional for old-guest compatibility; callers must normalize absent
-     * lists to `[primaryDeliveryId]`.
      */
-    consumedDeliveryIds?: string[];
+    consumedDeliveryIds: string[];
 } | {
     ok: true;
     v: 2;
@@ -174,6 +191,14 @@ export type HostedExecutionOutcome = {
     ok: true;
     v: 2;
     outcome: "not_active";
+} | {
+    ok: true;
+    v: 2;
+    outcome: "started";
+} | {
+    ok: true;
+    v: 2;
+    outcome: "running";
 };
 export declare const HOSTED_PLATFORM_HANDOFF_KEYS: ReadonlySet<string>;
 export declare const HOSTED_SLACK_PLACEHOLDER_HANDOFF_KEYS: ReadonlySet<string>;
@@ -184,7 +209,7 @@ export declare function parseHostedExecutionOutcome(value: unknown): HostedExecu
  * True when the admission envelope is the reserved internal reminder fire
  * path (not an authored channel event).
  */
-export declare function isHostedReminderAdmission(delivery: HostedAdmission): boolean;
+export declare function isHostedReminderAdmission(delivery: HostedAdmissionInput): boolean;
 /**
  * Parse `{ reminderId, fireCount }` from a reserved reminder admission
  * payload. Rejects unknown keys and non-integer fireCount.

package/dist/internal/hosted-delivery-protocol.d.ts.map

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

package/dist/internal/hosted-delivery-protocol.js

@@ -1,3 +1,9 @@
+/**
+ * Private control-plane/engine wire contract. Version 2 is unreleased and
+ * intentionally strict: unknown fields and modes fail closed. After release,
+ * any shape or semantic change must use a new version and a rolling
+ * compatibility window. See `docs/agent-serve/hosted-delivery-protocol.md`.
+ */
 export const HOSTED_DELIVERY_PROTOCOL_VERSION = 2;
 export const HOSTED_DELIVERY_HEADER = "x-agent-sdk-hosted-delivery";
 export const HOSTED_ADMISSION_PATH = "/v1/internal/hosted-admission";
@@ -118,6 +124,7 @@ export const HOSTED_REMINDER_EVENT_TYPE = "agent-sdk.reminder/fire";
 export const HOSTED_MAX_CONSUMED_DELIVERY_IDS = 16;
 const DELIVERY_KEYS = new Set([
     "v",
+    "mode",
     "channelId",
     "channelKind",
     "eventType",
@@ -222,9 +229,17 @@ export function parseHostedAdmission(value) {
         return undefined;
     }
     const body = value;
+    if (body.mode === "status") {
+        return Object.keys(body).every(key => key === "v" || key === "mode" || key === "deliveryId") &&
+            body.v === HOSTED_DELIVERY_PROTOCOL_VERSION &&
+            boundedString(body.deliveryId, 256)
+            ? body
+            : undefined;
+    }
     if (Object.keys(body).some(key => !DELIVERY_KEYS.has(key)) ||
         !Object.hasOwn(body, "payload") ||
         body.v !== HOSTED_DELIVERY_PROTOCOL_VERSION ||
+        body.mode !== "start" ||
         !boundedString(body.channelId, 128) ||
         !boundedString(body.channelKind, 128) ||
         !boundedString(body.eventType, 128) ||
@@ -250,7 +265,7 @@ export function parseHostedExecution(value) {
         !/^ses_[a-f0-9]{24}$/.test(body.sessionPublicId)) {
         return undefined;
     }
-    if (body.mode !== undefined && body.mode !== "execute" && body.mode !== "enqueue") {
+    if (body.mode !== "enqueue" && body.mode !== "start" && body.mode !== "status") {
         return undefined;
     }
     return body;
@@ -278,7 +293,10 @@ export function parseHostedExecutionOutcome(value) {
         body.v !== HOSTED_DELIVERY_PROTOCOL_VERSION) {
         return undefined;
     }
-    if (body.outcome === "enqueued" || body.outcome === "not_active") {
+    if (body.outcome === "enqueued" ||
+        body.outcome === "not_active" ||
+        body.outcome === "started" ||
+        body.outcome === "running") {
         if (body.consumedDeliveryIds !== undefined) {
             return undefined;
         }
@@ -287,10 +305,6 @@ export function parseHostedExecutionOutcome(value) {
     if (body.outcome !== "send") {
         return undefined;
     }
-    // Old guests omit consumedDeliveryIds; accept and let callers normalize.
-    if (body.consumedDeliveryIds === undefined) {
-        return { ok: true, v: 2, outcome: "send" };
-    }
     const consumedDeliveryIds = parseConsumedDeliveryIds(body.consumedDeliveryIds);
     if (consumedDeliveryIds === undefined) {
         return undefined;
@@ -499,18 +513,27 @@ export function parseHostedReminderFireDescriptorPayload(value) {
     }
     return Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign({ protocolVersion: 1, id: body.id, fireCount: body.fireCount, generation: body.generation, purpose: body.purpose, channelId: body.channelId, continuationToken: body.continuationToken }, (target === undefined ? {} : { target })), { scheduleKind: body.scheduleKind, scheduleValue: body.scheduleValue }), (body.intervalMs === undefined ? {} : { intervalMs: body.intervalMs })), (body.prompt === undefined ? {} : { prompt: body.prompt })), (body.handler === undefined ? {} : { handler: body.handler })), (args === undefined ? {} : { args })), { hasRunHandler: body.hasRunHandler, hasUntilFn: body.hasUntilFn }), (body.untilPrompt === undefined ? {} : { untilPrompt: body.untilPrompt })), { busyPolicy: body.busyPolicy, nextFireAtMs: body.nextFireAtMs, claimedAtMs: body.claimedAtMs });
 }
+const HOSTED_ADMISSION_OUTCOME_KEYS = new Set(["ok", "v", "outcome", "admissionToken"]);
 export function parseHostedAdmissionOutcome(value) {
     if (typeof value !== "object" || value === null || Array.isArray(value)) {
         return undefined;
     }
     const body = value;
-    if (body.ok !== true ||
+    if (Object.keys(body).some(key => !HOSTED_ADMISSION_OUTCOME_KEYS.has(key)) ||
+        body.ok !== true ||
         body.v !== HOSTED_DELIVERY_PROTOCOL_VERSION ||
-        (body.outcome !== "skip" && body.outcome !== "send" && body.outcome !== "task")) {
+        (body.outcome !== "skip" &&
+            body.outcome !== "send" &&
+            body.outcome !== "task" &&
+            body.outcome !== "started" &&
+            body.outcome !== "running")) {
         return undefined;
     }
     if (body.outcome === "send" && !boundedString(body.admissionToken, 128)) {
         return undefined;
     }
+    if (body.outcome !== "send" && Object.hasOwn(body, "admissionToken")) {
+        return undefined;
+    }
     return body;
 }

package/dist/internal/hosted-delivery.d.ts

@@ -1,12 +1,12 @@
 import type { ChannelHandlerArgs, SendMessageOptions } from "../types.js";
 import { type HostedBoundSecretsResult } from "./cursor/hosted-bound-secrets.js";
 import { type GuestNetworkWaitResult } from "./guest-network.js";
-import { type HostedAdmission, type HostedReminderFireDescriptorPayload } from "./hosted-delivery-protocol.js";
+import { type HostedAdmissionInput, type HostedReminderFireDescriptorPayload } from "./hosted-delivery-protocol.js";
 import type { LogRingEntry } from "./log-ring.js";
 import type { Router } from "./router.js";
 import type { SessionRunExecutionWrite } from "./session-run-log.js";
 type DispatchInput = {
-    delivery: HostedAdmission;
+    delivery: HostedAdmissionInput;
     definition: object;
     args: ChannelHandlerArgs;
 };

package/dist/internal/hosted-delivery.d.ts.map

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

package/dist/internal/hosted-delivery.js

@@ -26,6 +26,29 @@ import { endActiveHttpSpan } from "./otel/http.js";
 import { ReminderValidationError, UnknownReminderError } from "./reminder-runner.js";
 import { mapThrownRequestError, statusForThrownRequestError } from "./request-error-status.js";
 import { HostedEnqueueNotActiveError } from "./session-engine.js";
+function responseToReply(response) {
+    return __awaiter(this, void 0, void 0, function* () {
+        var _a;
+        const value = (yield response.json());
+        if (typeof value !== "object" || value === null || Array.isArray(value)) {
+            throw new Error("Hosted delivery produced a non-object JSON response.");
+        }
+        return {
+            status: response.status,
+            body: value,
+            serverTiming: (_a = response.headers.get("server-timing")) !== null && _a !== void 0 ? _a : undefined,
+        };
+    });
+}
+function responseFromReply(reply) {
+    return Response.json(reply.body, {
+        status: reply.status,
+        headers: reply.serverTiming === undefined ? undefined : { "server-timing": reply.serverTiming },
+    });
+}
+function isTransientRetryReply(reply) {
+    return reply.body.retry === HOSTED_GUEST_RETRY_TRANSIENT;
+}
 /**
  * A second `send()` in one delivery is a deterministic authored bug — the
  * wire protocol carries exactly one pending send per delivery — so it must
@@ -49,6 +72,23 @@ function boundedMessage(text) {
         ? `${text.slice(0, MAX_ERROR_MESSAGE_LENGTH)}…`
         : text;
 }
+/**
+ * A channel's non-OK dispatch response body is the only record of why the
+ * delivery was refused (e.g. an authored 400 with a validation message).
+ * Carry it, bounded, into the terminal channel_dispatch_failed so the
+ * control plane's failure log is diagnosable.
+ */
+function channelDispatchDetail(response) {
+    return __awaiter(this, void 0, void 0, function* () {
+        try {
+            const text = (yield response.text()).trim();
+            return text === "" ? undefined : boundedMessage(text);
+        }
+        catch (_a) {
+            return undefined;
+        }
+    });
+}
 function terminalHostedError(status, error, message) {
     return hostedGuestErrorResponse({
         status,
@@ -231,7 +271,7 @@ function runAdmission(input, adapter) {
         }
         if (!dispatched.ok) {
             return {
-                response: terminalHostedError(dispatched.status >= 400 ? dispatched.status : 502, "channel_dispatch_failed"),
+                response: terminalHostedError(dispatched.status >= 400 ? dispatched.status : 502, "channel_dispatch_failed", yield channelDispatchDetail(dispatched)),
             };
         }
         try {
@@ -333,8 +373,11 @@ function logGuestNetworkWait(phase, stats) {
 export function registerHostedDeliveryRoute(input) {
     var _a, _b;
     const pending = new Map();
+    const admissions = new Map();
     const activeOwners = new Map();
     const pendingTtlMs = 10 * 60000;
+    /** Keep an in-flight owner turn addressable for status polls. */
+    const ownerTurnPendingTtlMs = 12 * 60 * 60000;
     const waitForNetwork = (_a = input.waitForGuestNetwork) !== null && _a !== void 0 ? _a : (() => waitForGuestNetworkReady());
     const consumeBoundSecrets = (_b = input.consumeBoundSecrets) !== null && _b !== void 0 ? _b : (() => consumeHostedBoundSecrets());
     /**
@@ -375,8 +418,58 @@ export function registerHostedDeliveryRoute(input) {
                 pending.delete(token);
             }
         }
+        for (const [deliveryId, operation] of admissions) {
+            if (operation.expiresAt <= now) {
+                admissions.delete(deliveryId);
+            }
+        }
     };
-    // Hosted callers reach this only through AnyRun's signed pod-port URL.
+    const runAdmissionOperation = (delivery, definition) => __awaiter(this, void 0, void 0, function* () {
+        return afterHostedWork(input.flushOtel, () => __awaiter(this, void 0, void 0, function* () {
+            const startedAt = performance.now();
+            let guestNetwork;
+            const finish = (response) => withServerTiming(response, performance.now() - startedAt, guestNetwork);
+            try {
+                const network = yield finishNetworkWait("admission");
+                guestNetwork = network.timing;
+                if (network.response !== undefined) {
+                    return yield responseToReply(finish(network.response));
+                }
+                if (isHostedReminderAdmission(delivery)) {
+                    return yield responseToReply(finish(yield dispatchHostedReminderAdmission(input, delivery)));
+                }
+                if (definition === undefined) {
+                    return yield responseToReply(finish(terminalHostedError(404, "channel_not_found", `No channel named "${delivery.channelId}" is mounted.`)));
+                }
+                const admitted = yield dispatchHostedAdmission({
+                    delivery,
+                    definition,
+                    args: input.buildHandlerArgs(delivery.channelId),
+                });
+                if (admitted.pendingSend === undefined) {
+                    return yield responseToReply(finish(admitted.response));
+                }
+                pruneExpired();
+                const admissionToken = randomBytes(24).toString("hex");
+                pending.set(admissionToken, {
+                    send: admitted.pendingSend,
+                    channelKind: delivery.channelKind,
+                    expiresAt: Date.now() + pendingTtlMs,
+                    deliveryId: delivery.deliveryId,
+                });
+                return yield responseToReply(finish(Response.json({
+                    ok: true,
+                    v: HOSTED_DELIVERY_PROTOCOL_VERSION,
+                    outcome: "send",
+                    admissionToken,
+                })));
+            }
+            catch (error) {
+                return yield responseToReply(finish(terminalHostedError(503, "internal_error", boundedMessage(error instanceof Error ? error.message : String(error)))));
+            }
+        }));
+    });
+    // Hosted callers reach this only through Anyrun's signed pod-port URL.
     // The marker is a second, route-specific fence distinct from channel auth.
     const auth = request => {
         if (request.headers.get(HOSTED_DELIVERY_HEADER) !== "1") {
@@ -394,9 +487,9 @@ export function registerHostedDeliveryRoute(input) {
         auth: [auth],
         handler: (request) => __awaiter(this, void 0, void 0, function* () {
             return afterHostedWork(input.flushOtel, () => __awaiter(this, void 0, void 0, function* () {
+                var _a;
                 const startedAt = performance.now();
-                let guestNetwork;
-                const finish = (response) => withServerTiming(response, performance.now() - startedAt, guestNetwork);
+                const finish = (response) => withServerTiming(response, performance.now() - startedAt);
                 const unconsumed = finishBoundSecrets();
                 if (unconsumed !== undefined) {
                     return finish(unconsumed);
@@ -412,46 +505,65 @@ export function registerHostedDeliveryRoute(input) {
                     console.info(`[agent-sdk] hosted admission rejected: envelope failed to parse keys=${JSON.stringify(rawKeys)} hasManagedAutomation=${String(rawKeys.includes("managedAutomation"))}`);
                     return finish(terminalHostedError(400, "invalid_hosted_admission", "Expected a supported Agent SDK hosted-admission envelope."));
                 }
-                console.info(`[agent-sdk] hosted admission received deliveryId=${delivery.deliveryId} channelId=${delivery.channelId} channelKind=${delivery.channelKind} eventType=${delivery.eventType} sessionMode=${delivery.sessionMode} managedAutomation=${delivery.managedAutomation === undefined ? "<absent>" : `automationUuid=${delivery.managedAutomation.automationUuid} mcpServerNames=${String(delivery.managedAutomation.mcpServerNames.length)} slackChannels=${delivery.managedAutomation.slackChannels === undefined ? "<absent>" : JSON.stringify(delivery.managedAutomation.slackChannels)}`}`);
-                recordHostedManagedAutomation(delivery);
-                if (isHostedReminderAdmission(delivery)) {
-                    const network = yield finishNetworkWait("admission");
-                    guestNetwork = network.timing;
-                    if (network.response !== undefined) {
-                        return finish(network.response);
+                pruneExpired();
+                const existing = admissions.get(delivery.deliveryId);
+                if (delivery.mode === "status") {
+                    if (existing === undefined) {
+                        return finish(transientHostedError(409, "hosted_admission_unavailable", "No hosted admission is in flight for this delivery."));
                     }
-                    return finish(yield dispatchHostedReminderAdmission(input, delivery));
+                    return existing.settledReply === undefined
+                        ? finish(Response.json({
+                            ok: true,
+                            v: HOSTED_DELIVERY_PROTOCOL_VERSION,
+                            outcome: "running",
+                        }))
+                        : responseFromReply(existing.settledReply);
                 }
-                const channel = input.channels.find(candidate => candidate.id === delivery.channelId);
-                if (channel === undefined) {
-                    return finish(terminalHostedError(404, "channel_not_found", `No channel named "${delivery.channelId}" is mounted.`));
+                if (existing !== undefined) {
+                    if (existing.settledReply !== undefined && isTransientRetryReply(existing.settledReply)) {
+                        admissions.delete(delivery.deliveryId);
+                    }
+                    else {
+                        return existing.settledReply === undefined
+                            ? finish(Response.json({
+                                ok: true,
+                                v: HOSTED_DELIVERY_PROTOCOL_VERSION,
+                                outcome: "started",
+                            }))
+                            : responseFromReply(existing.settledReply);
+                    }
                 }
-                const network = yield finishNetworkWait("admission");
-                guestNetwork = network.timing;
-                if (network.response !== undefined) {
-                    return finish(network.response);
+                console.info(`[agent-sdk] hosted admission received deliveryId=${delivery.deliveryId} channelId=${delivery.channelId} channelKind=${delivery.channelKind} eventType=${delivery.eventType} sessionMode=${delivery.sessionMode} managedAutomation=${delivery.managedAutomation === undefined ? "<absent>" : `automationUuid=${delivery.managedAutomation.automationUuid} mcpServerNames=${String(delivery.managedAutomation.mcpServerNames.length)} slackChannels=${delivery.managedAutomation.slackChannels === undefined ? "<absent>" : JSON.stringify(delivery.managedAutomation.slackChannels)}`}`);
+                recordHostedManagedAutomation(delivery);
+                const reminder = isHostedReminderAdmission(delivery);
+                const definition = reminder
+                    ? undefined
+                    : (_a = input.channels.find(candidate => candidate.id === delivery.channelId)) === null || _a === void 0 ? void 0 : _a.definition;
+                if (!reminder && definition === undefined) {
+                    return finish(terminalHostedError(404, "channel_not_found", `No channel named "${delivery.channelId}" is mounted.`));
                 }
-                const admitted = yield dispatchHostedAdmission({
-                    delivery,
-                    definition: channel.definition,
-                    args: input.buildHandlerArgs(delivery.channelId),
+                let operation;
+                const execution = runAdmissionOperation(delivery, definition).then(reply => {
+                    operation.settledReply = reply;
+                    operation.expiresAt = Date.now() + pendingTtlMs;
+                    return reply;
                 });
-                if (admitted.pendingSend === undefined) {
-                    return finish(admitted.response);
+                operation = {
+                    execution,
+                    expiresAt: Date.now() + ownerTurnPendingTtlMs,
+                };
+                admissions.set(delivery.deliveryId, operation);
+                const quickReply = yield Promise.race([
+                    execution,
+                    new Promise(resolve => setImmediate(() => resolve(undefined))),
+                ]);
+                if (quickReply !== undefined) {
+                    return responseFromReply(quickReply);
                 }
-                pruneExpired();
-                const admissionToken = randomBytes(24).toString("hex");
-                pending.set(admissionToken, {
-                    send: admitted.pendingSend,
-                    channelKind: delivery.channelKind,
-                    expiresAt: Date.now() + pendingTtlMs,
-                    deliveryId: delivery.deliveryId,
-                });
                 return finish(Response.json({
                     ok: true,
                     v: HOSTED_DELIVERY_PROTOCOL_VERSION,
-                    outcome: "send",
-                    admissionToken,
+                    outcome: "started",
                 }));
             }));
         }),
@@ -484,13 +596,40 @@ export function registerHostedDeliveryRoute(input) {
                     admitted.sessionPublicId !== execution.sessionPublicId) {
                     return finish(transientHostedError(409, "hosted_admission_session_mismatch", "The hosted admission token is already bound to another session."));
                 }
-                const network = yield finishNetworkWait("execution");
-                guestNetwork = network.timing;
-                if (network.response !== undefined) {
-                    return finish(network.response);
+                if (execution.mode === "start" &&
+                    admitted.settledReply !== undefined &&
+                    isTransientRetryReply(admitted.settledReply)) {
+                    delete admitted.settledReply;
+                    delete admitted.execution;
+                }
+                if (execution.mode === "status" ||
+                    (execution.mode === "start" && admitted.execution !== undefined)) {
+                    if (admitted.settledReply !== undefined) {
+                        return responseFromReply(admitted.settledReply);
+                    }
+                    if (admitted.execution === undefined) {
+                        return finish(transientHostedError(409, "hosted_admission_unavailable", "The hosted admission token has no owner turn in flight."));
+                    }
+                    if (execution.mode === "start") {
+                        return finish(Response.json({
+                            ok: true,
+                            v: HOSTED_DELIVERY_PROTOCOL_VERSION,
+                            outcome: "started",
+                        }));
+                    }
+                    return finish(Response.json({
+                        ok: true,
+                        v: HOSTED_DELIVERY_PROTOCOL_VERSION,
+                        outcome: "running",
+                    }));
                 }
                 admitted.sessionPublicId = execution.sessionPublicId;
                 if (execution.mode === "enqueue") {
+                    const network = yield finishNetworkWait("execution");
+                    guestNetwork = network.timing;
+                    if (network.response !== undefined) {
+                        return finish(network.response);
+                    }
                     const enqueueOutcome = yield enqueueIntoActiveOwner({
                         activeOwners,
                         sessionPublicId: execution.sessionPublicId,
@@ -500,7 +639,15 @@ export function registerHostedDeliveryRoute(input) {
                     });
                     return finish(Response.json(Object.assign({ ok: true, v: HOSTED_DELIVERY_PROTOCOL_VERSION }, enqueueOutcome)));
                 }
-                (_a = admitted.execution) !== null && _a !== void 0 ? _a : (admitted.execution = (() => __awaiter(this, void 0, void 0, function* () {
+                if (admitted.execution === undefined) {
+                    admitted.expiresAt = Date.now() + ownerTurnPendingTtlMs;
+                }
+                (_a = admitted.execution) !== null && _a !== void 0 ? _a : (admitted.execution = afterHostedWork(input.flushOtel, () => __awaiter(this, void 0, void 0, function* () {
+                    const network = yield finishNetworkWait("execution");
+                    guestNetwork = network.timing;
+                    if (network.response !== undefined) {
+                        return yield responseToReply(finish(network.response));
+                    }
                     const startedAt = performance.now();
                     const executionId = hostedExecutionDiagId(execution.admissionToken);
                     const sinks = Object.assign(Object.assign(Object.assign(Object.assign({}, (input.stateRoot === undefined ? {} : { stateRoot: input.stateRoot })), (input.persistSessionRun === undefined
@@ -512,10 +659,10 @@ export function registerHostedDeliveryRoute(input) {
                             : hostedFailureClassification(fields.failureCode);
                         yield flushHostedExecutionRecord(sinks, Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign({ executionId, sessionPublicId: execution.sessionPublicId, sessionId: fields.sessionId, turnStatus: fields.turnStatus, durationMs: Math.max(0, Math.round(performance.now() - startedAt)) }, (fields.message === undefined ? {} : { message: fields.message })), (fields.abortReason === undefined ? {} : { abortReason: fields.abortReason })), { failureCode: fields.failureCode }), (fields.errorCode === undefined ? {} : { errorCode: fields.errorCode })), { classification }), (fields.error === undefined ? {} : { error: fields.error })));
                     });
-                    // 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
-                    // is still going; without this marker that read would surface the
-                    // PREVIOUS delivery's terminal record as if it were this one's.
+                    // Claim the file before the turn runs. If a later status request
+                    // fails, the host reads this record while the turn may still be
+                    // running; the marker prevents it from surfacing the previous
+                    // delivery's terminal record.
                     yield writeDiag({
                         sessionId: "",
                         turnStatus: HOSTED_EXECUTION_DIAG_RUNNING_STATUS,
@@ -562,7 +709,10 @@ export function registerHostedDeliveryRoute(input) {
                             // survive the park just like a finished turn's.
                             yield (_a = input.drainSessionDurability) === null || _a === void 0 ? void 0 : _a.call(input, session.id);
                             drainAt = hostedExecutionNow();
-                            const consumedDeliveryIds = [owner.primaryDeliveryId, ...owner.acceptedDeliveryIds];
+                            const consumedDeliveryIds = [
+                                owner.primaryDeliveryId,
+                                ...owner.acceptedDeliveryIds,
+                            ];
                             if (consumedDeliveryIds.length > HOSTED_MAX_CONSUMED_DELIVERY_IDS) {
                                 throw new Error(`hosted execute consumedDeliveryIds length ${String(consumedDeliveryIds.length)} exceeds cap ${String(HOSTED_MAX_CONSUMED_DELIVERY_IDS)}`);
                             }
@@ -597,7 +747,7 @@ export function registerHostedDeliveryRoute(input) {
                                 drainAt,
                                 endedAt: hostedExecutionNow(),
                             });
-                            return reply;
+                            return yield responseToReply(finish(Response.json(reply.body, { status: reply.status })));
                         }
                         catch (error) {
                             owner.accepting = false;
@@ -623,9 +773,39 @@ export function registerHostedDeliveryRoute(input) {
                             }
                         }
                     }));
-                }))());
-                const reply = yield admitted.execution;
-                return finish(Response.json(reply.body, { status: reply.status }));
+                })).then(reply => {
+                    admitted.settledReply = reply;
+                    admitted.expiresAt = Date.now() + pendingTtlMs;
+                    return reply;
+                }, error => {
+                    admitted.settledReply = {
+                        status: 503,
+                        body: {
+                            ok: false,
+                            error: "internal_error",
+                            retry: HOSTED_GUEST_RETRY_TERMINAL,
+                            classification: hostedFailureClassification("internal_error"),
+                            message: error instanceof Error ? error.message : String(error),
+                        },
+                    };
+                    admitted.expiresAt = Date.now() + pendingTtlMs;
+                    return admitted.settledReply;
+                }));
+                if (execution.mode === "start") {
+                    const quickReply = yield Promise.race([
+                        admitted.execution,
+                        new Promise(resolve => setImmediate(() => resolve(undefined))),
+                    ]);
+                    if (quickReply !== undefined) {
+                        return responseFromReply(quickReply);
+                    }
+                    return finish(Response.json({
+                        ok: true,
+                        v: HOSTED_DELIVERY_PROTOCOL_VERSION,
+                        outcome: "started",
+                    }));
+                }
+                return finish(terminalHostedError(400, "invalid_hosted_execution", "Owner execution requires start or status mode."));
             }));
         }),
     });