@cursor/bdk 0.2.5 → 0.2.7

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

@@ -1,31 +1,24 @@
 /**
- * Guest-local TAS diag (`hosted-execution.json`). Flushed with the durable
- * session-run document and the `start.log` tee by
- * `hosted-execution-flush.ts`.
+ * Local diagnostic record for one hosted execution. Flushed with durable
+ * execution history and process output.
  */
 import { type HostedFailureClassification } from "./hosted-delivery-protocol.js";
 export declare const HOSTED_EXECUTION_DIAG_VERSION = 1;
 /** Cap so a runaway message cannot fill the guest disk or the host log. */
 export declare const HOSTED_EXECUTION_DIAG_MAX_BYTES = 4096;
 /**
- * Correlate the on-disk record with the execution that produced it. One pod
- * serves many deliveries of a continuation session, and the file lives at a
- * single fixed path, so without this the host can read a *previous*
- * delivery's terminal record whenever July never reaches its own write —
- * the 9-minute host POST timeout, a 409 on an expired admission token, or a
- * replayed token that short-circuits on the memoized reply.
+ * Correlate the fixed-path record with the execution that produced it. An
+ * interrupted attempt can otherwise leave the previous execution's terminal
+ * record behind.
  *
- * Derived from the admission token (which both sides already hold) rather
- * than carried on the wire. The digest is one-way, so the token itself never
- * reaches the guest disk or the host logs.
+ * Derive the id from the admission token. The one-way digest prevents the
+ * token itself from reaching disk or logs.
  */
 export declare function hostedExecutionDiagId(admissionToken: string): string;
 export type HostedExecutionDiagAbortReason = "signal_abort" | "runner_cancelled" | "runner_error" | "execute_throw";
 /**
- * Bounded guest-side record of one hosted-execution attempt. No prompt,
- * tool content, or API key — the host copies known keys onto the Temporal
- * activity span for Datadog. `errorCode` and `message` are logged ungated;
- * `stack` stays behind the internal-diag gate.
+ * Bounded record of one hosted execution. It omits prompts, tool content, and
+ * credentials. Stack details remain behind the diagnostic gate.
  */
 export type HostedExecutionDiag = {
     v: typeof HOSTED_EXECUTION_DIAG_VERSION;
@@ -50,19 +43,15 @@ export type HostedExecutionDiag = {
 };
 /** 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. */
+/** Bounds for a short error stack summary. */
 export declare const HOSTED_ERROR_STACK_LINE_COUNT = 5;
 export declare const HOSTED_ERROR_SNIPPET_MAX_CHARS = 700;
 /**
- * Bounded throw text for on-disk diag `stack` (and non-hosted 500 bodies).
- * Prefers `Error.stack` (message line + `at` frames). Hosted HTTP `message`
- * uses {@link hostedErrorMessageOnly} so customer Datadog stays frame-free.
+ * Bounded throw text for diagnostics and non-hosted 500 bodies. Prefers
+ * `Error.stack` with its message and first frames.
  */
 export declare function hostedErrorStackSnippet(error: unknown): string;
-/**
- * Guest throw text without `at` frames. Hosted 500 `message` is ungated on
- * TAS (`hostedGuestMessage` / `last_error`); stack frames stay on `stack`.
- */
+/** Hosted response text without stack frames. */
 export declare function hostedErrorMessageOnly(error: unknown): string;
 export declare function hostedExecutionDiagPath(stateRoot: string): string;
 export declare function abortReasonFromTurnStatus(status: string, cancellationReason: "signal" | "runner" | undefined): HostedExecutionDiagAbortReason | 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":"AAAA;;;;GAIG;AAMH,OAAO,EAEL,KAAK,2BAA2B,EAEjC,MAAM,+BAA+B,CAAC;AAEvC,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;;;;;GAKG;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;IAC7C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,kFAAkF;IAClF,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,2BAA2B,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;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAgB7D;AAED,wBAAgB,uBAAuB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAEjE;AAED,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,MAAM,EACd,kBAAkB,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAClD,8BAA8B,GAAG,SAAS,CAQ5C;AAED,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,MAAM,GAAG,mBAAmB,GAAG,SAAS,CAiFrF;AAED;;;GAGG;AACH,wBAAsB,wBAAwB,CAC5C,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,mBAAmB,GACxB,OAAO,CAAC,IAAI,CAAC,CAmBf"}
+{"version":3,"file":"hosted-execution-diag.d.ts","sourceRoot":"","sources":["../../src/internal/hosted-execution-diag.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,OAAO,EAEL,KAAK,2BAA2B,EAEjC,MAAM,+BAA+B,CAAC;AAEvC,eAAO,MAAM,6BAA6B,IAAI,CAAC;AAC/C,2EAA2E;AAC3E,eAAO,MAAM,+BAA+B,OAAO,CAAC;AAEpD;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CAAC,cAAc,EAAE,MAAM,GAAG,MAAM,CAEpE;AAED,MAAM,MAAM,8BAA8B,GACtC,cAAc,GACd,kBAAkB,GAClB,cAAc,GACd,eAAe,CAAC;AAEpB;;;GAGG;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;IAC7C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,kFAAkF;IAClF,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,2BAA2B,CAAC;CAC9C,CAAC;AAEF,gFAAgF;AAChF,eAAO,MAAM,oCAAoC,YAAY,CAAC;AAmC9D,8CAA8C;AAC9C,eAAO,MAAM,6BAA6B,IAAI,CAAC;AAC/C,eAAO,MAAM,8BAA8B,MAAM,CAAC;AAElD;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAyB9D;AAED,iDAAiD;AACjD,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAgB7D;AAED,wBAAgB,uBAAuB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAEjE;AAED,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,MAAM,EACd,kBAAkB,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAClD,8BAA8B,GAAG,SAAS,CAQ5C;AAED,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,MAAM,GAAG,mBAAmB,GAAG,SAAS,CAiFrF;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

@@ -1,7 +1,6 @@
 /**
- * Guest-local TAS diag (`hosted-execution.json`). Flushed with the durable
- * session-run document and the `start.log` tee by
- * `hosted-execution-flush.ts`.
+ * Local diagnostic record for one hosted execution. Flushed with durable
+ * execution history and process output.
  */
 var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
     function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
@@ -20,16 +19,12 @@ export const HOSTED_EXECUTION_DIAG_VERSION = 1;
 /** Cap so a runaway message cannot fill the guest disk or the host log. */
 export const HOSTED_EXECUTION_DIAG_MAX_BYTES = 4096;
 /**
- * Correlate the on-disk record with the execution that produced it. One pod
- * serves many deliveries of a continuation session, and the file lives at a
- * single fixed path, so without this the host can read a *previous*
- * delivery's terminal record whenever July never reaches its own write —
- * the 9-minute host POST timeout, a 409 on an expired admission token, or a
- * replayed token that short-circuits on the memoized reply.
+ * Correlate the fixed-path record with the execution that produced it. An
+ * interrupted attempt can otherwise leave the previous execution's terminal
+ * record behind.
  *
- * Derived from the admission token (which both sides already hold) rather
- * than carried on the wire. The digest is one-way, so the token itself never
- * reaches the guest disk or the host logs.
+ * Derive the id from the admission token. The one-way digest prevents the
+ * token itself from reaching disk or logs.
  */
 export function hostedExecutionDiagId(admissionToken) {
     return createHash("sha256").update(admissionToken).digest("hex").slice(0, 16);
@@ -66,13 +61,12 @@ function boundedOptionalString(value, max) {
             : value
         : undefined;
 }
-/** First line + frames; factory `last_error` is 1024 chars with a TAS prefix. */
+/** Bounds for a short error stack summary. */
 export const HOSTED_ERROR_STACK_LINE_COUNT = 5;
 export const HOSTED_ERROR_SNIPPET_MAX_CHARS = 700;
 /**
- * Bounded throw text for on-disk diag `stack` (and non-hosted 500 bodies).
- * Prefers `Error.stack` (message line + `at` frames). Hosted HTTP `message`
- * uses {@link hostedErrorMessageOnly} so customer Datadog stays frame-free.
+ * Bounded throw text for diagnostics and non-hosted 500 bodies. Prefers
+ * `Error.stack` with its message and first frames.
  */
 export function hostedErrorStackSnippet(error) {
     var _a;
@@ -101,10 +95,7 @@ export function hostedErrorStackSnippet(error) {
         ? `${text.slice(0, HOSTED_ERROR_SNIPPET_MAX_CHARS)}…`
         : text;
 }
-/**
- * Guest throw text without `at` frames. Hosted 500 `message` is ungated on
- * TAS (`hostedGuestMessage` / `last_error`); stack frames stay on `stack`.
- */
+/** Hosted response text without stack frames. */
 export function hostedErrorMessageOnly(error) {
     const text = error instanceof Error && error.message.trim().length > 0
         ? error.message.trim()

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

@@ -1,19 +1,19 @@
 /**
- * One hosted-execution flush. Two artifacts, same moments:
+ * Flush local diagnostics, durable execution history, and process output at
+ * the same boundaries.
  *
- * - Guest-local `hosted-execution.json` — TAS failed-execute diag.
- * - Durable `session-runs/{ses_…}` plus the `start.log` tee — dashboard.
- *
- * Claim (`running`) → terminal → process-death. Process-death upgrades the
- * durable document and re-snapshots the tee; the local json stays `running`
- * so TAS does not treat a previous delivery's terminal record as this one.
+ * The lifecycle is running, terminal, then process death when applicable.
+ * Process death updates durable state and output while the local diagnostic
+ * stays running, preventing a stale terminal record from being reused.
+ * Between running and terminal, {@link refreshStartLogWhile} refreshes only
+ * process output.
  */
 import type { HostedFailureClassification } from "./hosted-delivery-protocol.js";
 import { type HostedExecutionDiagAbortReason } from "./hosted-execution-diag.js";
 import type { LogRingEntry } from "./log-ring.js";
 import { type SessionRunAbortReason, type SessionRunExecutionWrite } from "./session-run-log.js";
 export type HostedExecutionFlushSinks = {
-    /** Serve `--state-root`. Omit to skip the guest-local TAS diag. */
+    /** Local diagnostic state directory. Omit to skip the local record. */
     stateRoot?: string;
     persistSessionRun?(write: SessionRunExecutionWrite): Promise<void>;
     flushStartLog?(startLogId: string): Promise<void>;
@@ -33,10 +33,22 @@ export type HostedExecutionFlushFields = {
     error?: unknown;
 };
 /**
- * Write the local TAS diag and the durable session-run + tee together.
- * Soft-fail per sink so a store outage does not change hosted HTTP.
+ * Write local diagnostics and durable output together. Soft-fail per sink so
+ * a storage outage does not change the hosted response.
  */
 export declare function flushHostedExecutionRecord(sinks: HostedExecutionFlushSinks, fields: HostedExecutionFlushFields): Promise<void>;
+/**
+ * Each refresh is a store write on the deployment's shared write budget, so
+ * keep it coarse. An unchanged tee costs nothing (the store skips the put).
+ */
+export declare const HOSTED_START_LOG_REFRESH_INTERVAL_MS = 30000;
+/**
+ * Refresh the tee while `run` (the turn) settles: v2 has no engine to tail,
+ * so this snapshot is the only view of a running turn. A tick is skipped
+ * while a refresh is still in flight, and the last one settles before this
+ * returns so it cannot land after the terminal flush.
+ */
+export declare function refreshStartLogWhile<T>(sinks: HostedExecutionFlushSinks, startLogId: string, run: () => Promise<T>): Promise<T>;
 /**
  * Durable-only crash flush. Leaves `hosted-execution.json` at `running`.
  */

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

@@ -1 +1 @@
-{"version":3,"file":"hosted-execution-flush.d.ts","sourceRoot":"","sources":["../../src/internal/hosted-execution-flush.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,+BAA+B,CAAC;AACjF,OAAO,EACL,KAAK,8BAA8B,EAGpC,MAAM,4BAA4B,CAAC;AACpC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,EACL,KAAK,qBAAqB,EAC1B,KAAK,wBAAwB,EAG9B,MAAM,sBAAsB,CAAC;AAU9B,MAAM,MAAM,yBAAyB,GAAG;IACtC,mEAAmE;IACnE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,iBAAiB,CAAC,CAAC,KAAK,EAAE,wBAAwB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACnE,aAAa,CAAC,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAClD,YAAY,CAAC,IAAI,YAAY,EAAE,CAAC;CACjC,CAAC;AAEF,MAAM,MAAM,0BAA0B,GAAG;IACvC,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,8BAA8B,CAAC;IAC7C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,2BAA2B,CAAC;IAC7C,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB,CAAC;AAEF;;;GAGG;AACH,wBAAsB,0BAA0B,CAC9C,KAAK,EAAE,yBAAyB,EAChC,MAAM,EAAE,0BAA0B,GACjC,OAAO,CAAC,IAAI,CAAC,CAgDf;AAED;;GAEG;AACH,wBAAsB,gCAAgC,CAAC,IAAI,EAAE;IAC3D,iBAAiB,EAAE,CACjB,MAAM,EAAE,OAAO,CACb,qBAAqB,EACrB,cAAc,GAAG,oBAAoB,GAAG,qBAAqB,CAC9D,EACD,KAAK,CAAC,EAAE,OAAO,KACZ,OAAO,CAAC,IAAI,CAAC,CAAC;IACnB,aAAa,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACtD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,OAAO,CACb,qBAAqB,EACrB,cAAc,GAAG,oBAAoB,GAAG,qBAAqB,CAC9D,CAAC;IACF,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB,GAAG,OAAO,CAAC,IAAI,CAAC,CAKhB"}
+{"version":3,"file":"hosted-execution-flush.d.ts","sourceRoot":"","sources":["../../src/internal/hosted-execution-flush.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,+BAA+B,CAAC;AACjF,OAAO,EACL,KAAK,8BAA8B,EAGpC,MAAM,4BAA4B,CAAC;AACpC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,EACL,KAAK,qBAAqB,EAC1B,KAAK,wBAAwB,EAG9B,MAAM,sBAAsB,CAAC;AAU9B,MAAM,MAAM,yBAAyB,GAAG;IACtC,uEAAuE;IACvE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,iBAAiB,CAAC,CAAC,KAAK,EAAE,wBAAwB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACnE,aAAa,CAAC,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAClD,YAAY,CAAC,IAAI,YAAY,EAAE,CAAC;CACjC,CAAC;AAEF,MAAM,MAAM,0BAA0B,GAAG;IACvC,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,8BAA8B,CAAC;IAC7C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,2BAA2B,CAAC;IAC7C,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB,CAAC;AAEF;;;GAGG;AACH,wBAAsB,0BAA0B,CAC9C,KAAK,EAAE,yBAAyB,EAChC,MAAM,EAAE,0BAA0B,GACjC,OAAO,CAAC,IAAI,CAAC,CAgDf;AAED;;;GAGG;AACH,eAAO,MAAM,oCAAoC,QAAS,CAAC;AAE3D;;;;;GAKG;AACH,wBAAsB,oBAAoB,CAAC,CAAC,EAC1C,KAAK,EAAE,yBAAyB,EAChC,UAAU,EAAE,MAAM,EAClB,GAAG,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GACpB,OAAO,CAAC,CAAC,CAAC,CAqBZ;AAED;;GAEG;AACH,wBAAsB,gCAAgC,CAAC,IAAI,EAAE;IAC3D,iBAAiB,EAAE,CACjB,MAAM,EAAE,OAAO,CACb,qBAAqB,EACrB,cAAc,GAAG,oBAAoB,GAAG,qBAAqB,CAC9D,EACD,KAAK,CAAC,EAAE,OAAO,KACZ,OAAO,CAAC,IAAI,CAAC,CAAC;IACnB,aAAa,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACtD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,OAAO,CACb,qBAAqB,EACrB,cAAc,GAAG,oBAAoB,GAAG,qBAAqB,CAC9D,CAAC;IACF,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB,GAAG,OAAO,CAAC,IAAI,CAAC,CAKhB"}

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

@@ -1,12 +1,12 @@
 /**
- * One hosted-execution flush. Two artifacts, same moments:
+ * Flush local diagnostics, durable execution history, and process output at
+ * the same boundaries.
  *
- * - Guest-local `hosted-execution.json` — TAS failed-execute diag.
- * - Durable `session-runs/{ses_…}` plus the `start.log` tee — dashboard.
- *
- * Claim (`running`) → terminal → process-death. Process-death upgrades the
- * durable document and re-snapshots the tee; the local json stays `running`
- * so TAS does not treat a previous delivery's terminal record as this one.
+ * The lifecycle is running, terminal, then process death when applicable.
+ * Process death updates durable state and output while the local diagnostic
+ * stays running, preventing a stale terminal record from being reused.
+ * Between running and terminal, {@link refreshStartLogWhile} refreshes only
+ * process output.
  */
 var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
     function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
@@ -26,8 +26,8 @@ function boundedMessage(text) {
         : text;
 }
 /**
- * Write the local TAS diag and the durable session-run + tee together.
- * Soft-fail per sink so a store outage does not change hosted HTTP.
+ * Write local diagnostics and durable output together. Soft-fail per sink so
+ * a storage outage does not change the hosted response.
  */
 export function flushHostedExecutionRecord(sinks, fields) {
     return __awaiter(this, void 0, void 0, function* () {
@@ -58,6 +58,42 @@ export function flushHostedExecutionRecord(sinks, fields) {
         }
     });
 }
+/**
+ * Each refresh is a store write on the deployment's shared write budget, so
+ * keep it coarse. An unchanged tee costs nothing (the store skips the put).
+ */
+export const HOSTED_START_LOG_REFRESH_INTERVAL_MS = 30000;
+/**
+ * Refresh the tee while `run` (the turn) settles: v2 has no engine to tail,
+ * so this snapshot is the only view of a running turn. A tick is skipped
+ * while a refresh is still in flight, and the last one settles before this
+ * returns so it cannot land after the terminal flush.
+ */
+export function refreshStartLogWhile(sinks, startLogId, run) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const flush = sinks.flushStartLog;
+        if (flush === undefined) {
+            return yield run();
+        }
+        let refresh;
+        const timer = setInterval(() => {
+            // Soft-fail like the other flushes. A rejection left unhandled here would
+            // trip the process-death flush.
+            refresh !== null && refresh !== void 0 ? refresh : (refresh = flush(startLogId)
+                .catch(() => undefined)
+                .finally(() => {
+                refresh = undefined;
+            }));
+        }, HOSTED_START_LOG_REFRESH_INTERVAL_MS);
+        try {
+            return yield run();
+        }
+        finally {
+            clearInterval(timer);
+            yield refresh;
+        }
+    });
+}
 /**
  * Durable-only crash flush. Leaves `hosted-execution.json` at `running`.
  */

package/dist/internal/hosted-managed-automation.js

@@ -37,7 +37,7 @@ const MANAGED_AUTOMATION_TTL_MS = 60 * 60000;
 const MANAGED_AUTOMATION_MAX_ENTRIES = 10000;
 export function recordHostedManagedAutomation(delivery) {
     if (delivery.managedAutomation === undefined) {
-        console.info(`[agent-sdk] hosted managedAutomation not recorded deliveryId=${delivery.deliveryId}: admission envelope carried no managedAutomation slice (non-managed delivery, or the control plane resolved no MCP servers and no Slack channels)`);
+        console.info(`[bdk] hosted managedAutomation not recorded deliveryId=${delivery.deliveryId}: admission envelope carried no managedAutomation slice (non-managed delivery, or the control plane resolved no MCP servers and no Slack channels)`);
         return;
     }
     const managedAutomationByDelivery = managedAutomationTable();
@@ -48,7 +48,7 @@ export function recordHostedManagedAutomation(delivery) {
         }
     }
     if (managedAutomationByDelivery.size >= MANAGED_AUTOMATION_MAX_ENTRIES) {
-        console.info(`[agent-sdk] hosted managedAutomation table full (${String(managedAutomationByDelivery.size)} entries); clearing before recording deliveryId=${delivery.deliveryId}`);
+        console.info(`[bdk] hosted managedAutomation table full (${String(managedAutomationByDelivery.size)} entries); clearing before recording deliveryId=${delivery.deliveryId}`);
         managedAutomationByDelivery.clear();
     }
     managedAutomationByDelivery.set(delivery.deliveryId, {
@@ -56,7 +56,7 @@ export function recordHostedManagedAutomation(delivery) {
         expiresAt: now + MANAGED_AUTOMATION_TTL_MS,
     });
     const slackChannels = delivery.managedAutomation.slackChannels;
-    console.info(`[agent-sdk] hosted managedAutomation recorded deliveryId=${delivery.deliveryId} automationUuid=${delivery.managedAutomation.automationUuid} mcpServerNames=${String(delivery.managedAutomation.mcpServerNames.length)} slackChannels=${slackChannels === undefined ? "<absent>" : JSON.stringify(slackChannels)} ttlMs=${String(MANAGED_AUTOMATION_TTL_MS)} tableSize=${String(managedAutomationByDelivery.size)}`);
+    console.info(`[bdk] hosted managedAutomation recorded deliveryId=${delivery.deliveryId} automationUuid=${delivery.managedAutomation.automationUuid} mcpServerNames=${String(delivery.managedAutomation.mcpServerNames.length)} slackChannels=${slackChannels === undefined ? "<absent>" : JSON.stringify(slackChannels)} ttlMs=${String(MANAGED_AUTOMATION_TTL_MS)} tableSize=${String(managedAutomationByDelivery.size)}`);
 }
 /**
  * The managed automation the control plane attributed to a hosted delivery,
@@ -67,11 +67,11 @@ export function getHostedManagedAutomation(deliveryId) {
     const managedAutomationByDelivery = managedAutomationTable();
     const entry = managedAutomationByDelivery.get(deliveryId);
     if (entry === undefined) {
-        console.info(`[agent-sdk] hosted managedAutomation lookup miss deliveryId=${deliveryId}: no entry (never recorded in this process, or evicted) tableSize=${String(managedAutomationByDelivery.size)} knownDeliveryIds=${JSON.stringify([...managedAutomationByDelivery.keys()].slice(0, 10))}`);
+        console.info(`[bdk] hosted managedAutomation lookup miss deliveryId=${deliveryId}: no entry (never recorded in this process, or evicted) tableSize=${String(managedAutomationByDelivery.size)} knownDeliveryIds=${JSON.stringify([...managedAutomationByDelivery.keys()].slice(0, 10))}`);
         return undefined;
     }
     if (entry.expiresAt <= Date.now()) {
-        console.info(`[agent-sdk] hosted managedAutomation lookup expired deliveryId=${deliveryId} automationUuid=${entry.managedAutomation.automationUuid} expiredMsAgo=${String(Date.now() - entry.expiresAt)}`);
+        console.info(`[bdk] hosted managedAutomation lookup expired deliveryId=${deliveryId} automationUuid=${entry.managedAutomation.automationUuid} expiredMsAgo=${String(Date.now() - entry.expiresAt)}`);
         managedAutomationByDelivery.delete(deliveryId);
         return undefined;
     }

package/dist/internal/hosting.d.ts

@@ -1,10 +1,7 @@
 /**
- * Client-side mirrors of the Agent Serve hosting validation rules
- * (backend/server/src/agentServe/agentServeShared.ts). Shared by discovery
- * (`hosting` block diagnostics on `agent-sdk validate`) and the deploy /
- * secrets CLI verbs (actionable errors before any network call). The
- * backend stays authoritative — these exist so mistakes fail fast and
- * locally with the same grammar the server enforces.
+ * Client-side validation for hosting configuration and secret commands.
+ * These checks catch stable syntax and reserved-name errors before a network
+ * request. The server remains authoritative.
  */
 /** `hosting.egressDomains` cap (the manifest schema and deploy body agree). */
 export declare const MAX_EGRESS_DOMAINS = 64;
@@ -23,10 +20,8 @@ export declare const MAX_CONTAINER_IMAGE_BYTES: number;
 /** Returns a human error message, or undefined when the image name is valid. */
 export declare function validateContainerImageName(name: string): string | undefined;
 /**
- * Extra platform-managed env names (not `CURSOR_*`). Mirrored from
- * `@cursor/bdk/internal/cursor-hosted` so validate/secrets CLI stay in
- * sync without importing the storage backend into the CLI graph.
- * Hosted storage is HTTP-proxied; engines never see a database URL.
+ * Additional environment names managed by Cursor. Do not include these in
+ * `hosting.secretNames` or pass them to secret commands.
  */
 export declare const PLATFORM_HOSTED_STORAGE_SECRET_NAMES: readonly ["AGENT_SERVE_DEPLOYMENT_ID"];
 /** Returns a human error message, or undefined when the domain is valid. */

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

@@ -1 +1 @@
-{"version":3,"file":"hosting.d.ts","sourceRoot":"","sources":["../../src/internal/hosting.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,+EAA+E;AAC/E,eAAO,MAAM,kBAAkB,KAAK,CAAC;AACrC,kCAAkC;AAClC,eAAO,MAAM,WAAW,KAAK,CAAC;AAC9B,sCAAsC;AACtC,eAAO,MAAM,sBAAsB,OAAO,CAAC;AAC3C,8BAA8B;AAC9B,eAAO,MAAM,sBAAsB,KAAK,CAAC;AACzC,mEAAmE;AACnE,eAAO,MAAM,2BAA2B,YAAY,CAAC;AACrD,oEAAoE;AACpE,eAAO,MAAM,oBAAoB,MAAM,CAAC;AACxC,sDAAsD;AACtD,eAAO,MAAM,yBAAyB,EAAE,MAA+B,CAAC;AAIxE,gFAAgF;AAChF,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAK3E;AAED;;;;;GAKG;AACH,eAAO,MAAM,oCAAoC,YAAI,2BAA2B,CAAU,CAAC;AAW3F,4EAA4E;AAC5E,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CASvE;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAQnE;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAQ1D;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE;IAC3C,aAAa,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,WAAW,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACjC,GAAG,MAAM,EAAE,CAmBX;AAED;;;GAGG;AACH,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAS3E;AAID,sEAAsE;AACtE,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAE5D"}
+{"version":3,"file":"hosting.d.ts","sourceRoot":"","sources":["../../src/internal/hosting.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,+EAA+E;AAC/E,eAAO,MAAM,kBAAkB,KAAK,CAAC;AACrC,kCAAkC;AAClC,eAAO,MAAM,WAAW,KAAK,CAAC;AAC9B,sCAAsC;AACtC,eAAO,MAAM,sBAAsB,OAAO,CAAC;AAC3C,8BAA8B;AAC9B,eAAO,MAAM,sBAAsB,KAAK,CAAC;AACzC,mEAAmE;AACnE,eAAO,MAAM,2BAA2B,YAAY,CAAC;AACrD,oEAAoE;AACpE,eAAO,MAAM,oBAAoB,MAAM,CAAC;AACxC,sDAAsD;AACtD,eAAO,MAAM,yBAAyB,EAAE,MAA+B,CAAC;AAIxE,gFAAgF;AAChF,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAK3E;AAED;;;GAGG;AACH,eAAO,MAAM,oCAAoC,YAAI,2BAA2B,CAAU,CAAC;AAW3F,4EAA4E;AAC5E,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CASvE;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAQnE;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAQ1D;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE;IAC3C,aAAa,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,WAAW,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACjC,GAAG,MAAM,EAAE,CAmBX;AAED;;;GAGG;AACH,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAS3E;AAID,sEAAsE;AACtE,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAE5D"}

package/dist/internal/hosting.js

@@ -1,10 +1,7 @@
 /**
- * Client-side mirrors of the Agent Serve hosting validation rules
- * (backend/server/src/agentServe/agentServeShared.ts). Shared by discovery
- * (`hosting` block diagnostics on `agent-sdk validate`) and the deploy /
- * secrets CLI verbs (actionable errors before any network call). The
- * backend stays authoritative — these exist so mistakes fail fast and
- * locally with the same grammar the server enforces.
+ * Client-side validation for hosting configuration and secret commands.
+ * These checks catch stable syntax and reserved-name errors before a network
+ * request. The server remains authoritative.
  */
 /** `hosting.egressDomains` cap (the manifest schema and deploy body agree). */
 export const MAX_EGRESS_DOMAINS = 64;
@@ -29,10 +26,8 @@ export function validateContainerImageName(name) {
     return `Invalid image name "${name}": use 2–64 lowercase letters, digits, ".", "_" or "-", starting and ending with a letter or digit.`;
 }
 /**
- * Extra platform-managed env names (not `CURSOR_*`). Mirrored from
- * `@cursor/bdk/internal/cursor-hosted` so validate/secrets CLI stay in
- * sync without importing the storage backend into the CLI graph.
- * Hosted storage is HTTP-proxied; engines never see a database URL.
+ * Additional environment names managed by Cursor. Do not include these in
+ * `hosting.secretNames` or pass them to secret commands.
  */
 export const PLATFORM_HOSTED_STORAGE_SECRET_NAMES = ["AGENT_SERVE_DEPLOYMENT_ID"];
 const SECRET_NAME_PATTERN = /^[A-Z][A-Z0-9_]*$/;

package/dist/internal/init-interview.d.ts

@@ -50,7 +50,6 @@ export declare function runTemplateInit(input: {
     vars?: readonly string[];
     interactive: boolean;
 }): Promise<RunTemplateInitResult>;
-export declare function parseTemplateAnswers(spec: TemplateInitSpec, raw: Record<string, string>): ParseAnswersResult;
 export interface CollectAnswersInput {
     spec: TemplateInitSpec;
     vars?: Record<string, string>;

package/dist/internal/init-interview.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"init-interview.d.ts","sourceRoot":"","sources":["../../src/internal/init-interview.ts"],"names":[],"mappings":"AAAA;;;GAGG;AASH,eAAO,MAAM,kBAAkB,cAAc,CAAC;AAE9C,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC5B,KAAK,CAAC,EAAE,iBAAiB,CAAC;CAC3B;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,EAAE,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC;IAC5B,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,gBAAgB,EAAE,CAAC;IAC9B,OAAO,EAAE,eAAe,EAAE,CAAC;CAC5B;AAED,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE5C;AAED,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAOvD;AAED,wBAAgB,2BAA2B,CAAC,IAAI,EAAE,gBAAgB,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAGxF;AAED,wBAAsB,oBAAoB,CACxC,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,gBAAgB,GAAG,SAAS,CAAC,CAUvC;AAED,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,GAAG,gBAAgB,CAStE;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAa1F;AAED,MAAM,MAAM,kBAAkB,GAC1B;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,GAC7C;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAEjC,MAAM,MAAM,qBAAqB,GAC7B;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,IAAI,CAAC,EAAE,gBAAgB,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,GACvE;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAEjC,4DAA4D;AAC5D,wBAAsB,eAAe,CAAC,KAAK,EAAE;IAC3C,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACzB,WAAW,EAAE,OAAO,CAAC;CACtB,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAkBjC;AAED,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,gBAAgB,EACtB,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC1B,kBAAkB,CAapB;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,gBAAgB,CAAC;IACvB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9B,WAAW,EAAE,OAAO,CAAC;IACrB,GAAG,CAAC,EAAE,CAAC,QAAQ,EAAE,gBAAgB,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IACtD,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CAC9B;AAED,wBAAsB,sBAAsB,CAC1C,KAAK,EAAE,mBAAmB,GACzB,OAAO,CAAC,kBAAkB,CAAC,CA+B7B;AAED,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,MAAM,EAChB,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,gBAAgB,EACtB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC9B,MAAM,CAiBR;AAED,wBAAsB,sBAAsB,CAC1C,QAAQ,EAAE,gBAAgB,EAC1B,OAAO,GAAE;IACP,KAAK,CAAC,EAAE,MAAM,CAAC,cAAc,CAAC;IAC9B,MAAM,CAAC,EAAE,MAAM,CAAC,cAAc,CAAC;CAC3B,GACL,OAAO,CAAC,MAAM,CAAC,CAejB"}
+{"version":3,"file":"init-interview.d.ts","sourceRoot":"","sources":["../../src/internal/init-interview.ts"],"names":[],"mappings":"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"}

package/dist/internal/init-interview.js

@@ -94,40 +94,31 @@ export function runTemplateInit(input) {
         }
     });
 }
-export function parseTemplateAnswers(spec, raw) {
-    var _a;
-    const answers = {};
-    for (const question of spec.questions) {
-        if (!(question.id in raw)) {
-            continue;
-        }
-        const parsed = parseQuestionValue(question, (_a = raw[question.id]) !== null && _a !== void 0 ? _a : "");
-        if (!parsed.ok) {
-            return parsed;
-        }
-        answers[question.id] = parsed.value;
-    }
-    return { ok: true, answers };
-}
 export function collectTemplateAnswers(input) {
     return __awaiter(this, void 0, void 0, function* () {
-        var _a, _b, _c, _d;
-        const vars = (_a = input.vars) !== null && _a !== void 0 ? _a : {};
+        var _a;
+        var _b, _c, _d;
+        const vars = (_b = input.vars) !== null && _b !== void 0 ? _b : {};
         const answers = {};
-        const ask = (_b = input.ask) !== null && _b !== void 0 ? _b : promptTemplateQuestion;
-        const out = (_c = input.out) !== null && _c !== void 0 ? _c : (text => process.stdout.write(text));
+        const ask = (_c = input.ask) !== null && _c !== void 0 ? _c : promptTemplateQuestion;
+        const out = (_d = input.out) !== null && _d !== void 0 ? _d : (text => process.stdout.write(text));
         for (const question of input.spec.questions) {
-            if (question.id in vars) {
-                const parsed = parseQuestionValue(question, (_d = vars[question.id]) !== null && _d !== void 0 ? _d : "");
+            if (question.id in vars || !input.interactive) {
+                const raw = ((_a = vars[question.id]) === null || _a === void 0 ? void 0 : _a.trim()) || question.default;
+                if (raw === undefined) {
+                    // Skipping would scaffold the template's sample answer (e.g. owner/repo).
+                    return {
+                        ok: false,
+                        error: `${question.id} is required: pass --var ${question.id}=... (${question.prompt})`,
+                    };
+                }
+                const parsed = parseQuestionValue(question, raw);
                 if (!parsed.ok) {
                     return parsed;
                 }
                 answers[question.id] = parsed.value;
                 continue;
             }
-            if (!input.interactive) {
-                continue;
-            }
             for (;;) {
                 const line = yield ask(question);
                 const value = line.trim() === "" && question.default !== undefined ? question.default : line;

package/dist/internal/listen-port.js

@@ -59,7 +59,7 @@ export function listenHttpServer(args) {
                 server.listen(port, host);
                 yield once(server, "listening");
                 if (port !== startPort) {
-                    logger(`[agent-sdk] port ${startPort} in use; listening on ${port} instead (pass --port to pick)`);
+                    logger(`[bdk] port ${startPort} in use; listening on ${port} instead (pass --port to pick)`);
                 }
                 return port;
             }

package/dist/internal/local-control-plane.js

@@ -83,7 +83,7 @@ export function createLocalControlPlane(opts) {
                         continue;
                     }
                     void opts.fireSchedule(name).catch(error => {
-                        logger(`[agent-sdk] schedule "${name}" dispatch failed: ${error instanceof Error ? error.message : String(error)}`);
+                        logger(`[bdk] schedule "${name}" dispatch failed: ${error instanceof Error ? error.message : String(error)}`);
                     });
                 }
             }
@@ -106,7 +106,7 @@ export function createLocalControlPlane(opts) {
             const timer = setTimeout(() => {
                 reminderTimers.delete(record.id);
                 void onReminderDue(record.id).catch(error => {
-                    logger(`[agent-sdk] reminder "${record.id}" dispatch failed: ${error instanceof Error ? error.message : String(error)}`);
+                    logger(`[bdk] reminder "${record.id}" dispatch failed: ${error instanceof Error ? error.message : String(error)}`);
                 });
             }, delay);
             (_a = timer.unref) === null || _a === void 0 ? void 0 : _a.call(timer);
@@ -174,7 +174,7 @@ export function createLocalControlPlane(opts) {
                         outcome = yield opts.executeReminder(descriptor);
                     }
                     catch (error) {
-                        logger(`[agent-sdk] reminder "${id}" guest execution failed: ${error instanceof Error ? error.message : String(error)}`);
+                        logger(`[bdk] reminder "${id}" guest execution failed: ${error instanceof Error ? error.message : String(error)}`);
                         outcome = {
                             kind: "retry",
                             delayMs: 1000,
@@ -183,7 +183,7 @@ export function createLocalControlPlane(opts) {
                     }
                     const result = yield applyReminderOutcome(claimFromDescriptor(descriptor), outcome);
                     if (!result.applied) {
-                        logger(`[agent-sdk] reminder "${id}" outcome not applied: ${result.reason}`);
+                        logger(`[bdk] reminder "${id}" outcome not applied: ${result.reason}`);
                     }
                     return;
                 }
@@ -200,7 +200,7 @@ export function createLocalControlPlane(opts) {
                     yield opts.fireReminder(current.id, current.fireCount);
                 }
                 catch (error) {
-                    logger(`[agent-sdk] reminder "${id}" dispatch failed: ${error instanceof Error ? error.message : String(error)}`);
+                    logger(`[bdk] reminder "${id}" dispatch failed: ${error instanceof Error ? error.message : String(error)}`);
                 }
             });
         }
@@ -210,7 +210,7 @@ export function createLocalControlPlane(opts) {
             attachScmEvents(relay) {
                 scmRelay = relay;
                 relay.start();
-                logger("[agent-sdk] cursor-events: control-plane ingest started");
+                logger("[bdk] cursor-events: control-plane ingest started");
             },
             upsertSchedule(input) {
                 return __awaiter(this, void 0, void 0, function* () {

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

@@ -3,7 +3,7 @@
  *
  * Customer-facing output never includes hosting URLs, tokens, or infra jargon.
  */
-import { type DeploymentDetail, type DeploymentProgress } from "./deploy-client.js";
+import { type AgentkitSessionLog, type DeploymentDetail, type DeploymentProgress } from "./deploy-client.js";
 import { type RequestAuth } from "./request-headers.js";
 export interface LogRingEntry {
     index: number;
@@ -76,4 +76,23 @@ export interface RunLogsTailOptions {
     sleep?: (ms: number, signal?: AbortSignal) => Promise<void>;
 }
 export declare function runLogsTail(options: RunLogsTailOptions): Promise<void>;
+export interface FollowHostedLogsOptions {
+    slug: string;
+    read: (signal?: AbortSignal) => Promise<AgentkitSessionLog[]>;
+    /** One session: print its lines without `==> ses_… <==` headers. */
+    scoped: boolean;
+    once: boolean;
+    json: boolean;
+    signal?: AbortSignal;
+    intervalMs?: number;
+    write?: (text: string) => void;
+    err?: (text: string) => void;
+    sleep?: (ms: number, signal?: AbortSignal) => Promise<void>;
+}
+/**
+ * `logs --prod` on architecture v2: poll the recent sessions' output and print
+ * lines not seen yet. Like `tail -f` over several files, a `==> ses_… <==`
+ * header marks each switch to another session.
+ */
+export declare function followHostedLogs(options: FollowHostedLogsOptions): Promise<void>;
 //# sourceMappingURL=logs-client.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"logs-client.d.ts","sourceRoot":"","sources":["../../src/internal/logs-client.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"logs-client.d.ts","sourceRoot":"","sources":["../../src/internal/logs-client.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,KAAK,kBAAkB,EAEvB,KAAK,gBAAgB,EACrB,KAAK,kBAAkB,EACxB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAuB,KAAK,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAW7E,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,YAAY,EAAE,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,MAAM,YAAY,GACpB,kBAAkB,GAClB,QAAQ,GACR,WAAW,GACX,UAAU,GACV,UAAU,GACV,UAAU,GACV,YAAY,GACZ,SAAS,GACT,QAAQ,GACR,UAAU,GACV,SAAS,GACT,UAAU,GACV,UAAU,CAAC;AAiBf;;;;GAIG;AACH,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,YAAY,EACtB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,EACzB,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,GAC5B,MAAM,CAmBR;AAED,0EAA0E;AAC1E,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAa7D;AAED;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE;IAC1C,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,kBAAkB,CAAC;IAC9B,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B,GAAG,MAAM,CAeT;AAED,wBAAsB,SAAS,CAAC,IAAI,EAAE;IACpC,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,WAAW,CAAC;IACnB,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;IACzB,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB,GAAG,OAAO,CAAC,YAAY,CAAC,CA0BxB;AAED,MAAM,WAAW,kBAAkB;IACjC,+DAA+D;IAC/D,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;IACzB,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,iCAAiC;IACjC,KAAK,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC/B,iCAAiC;IACjC,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7B;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAChD,mEAAmE;IACnE,cAAc,CAAC,EAAE,MAAM,OAAO,CAAC;QAC7B,QAAQ,EAAE,MAAM,CAAC;QACjB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;KAClC,CAAC,CAAC;IACH,KAAK,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CAC7D;AAED,wBAAsB,WAAW,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CAkC5E;AA6ND,MAAM,WAAW,uBAAuB;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,CAAC,MAAM,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAAC;IAC9D,oEAAoE;IACpE,MAAM,EAAE,OAAO,CAAC;IAChB,IAAI,EAAE,OAAO,CAAC;IACd,IAAI,EAAE,OAAO,CAAC;IACd,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC/B,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7B,KAAK,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CAC7D;AAED;;;;GAIG;AACH,wBAAsB,gBAAgB,CAAC,OAAO,EAAE,uBAAuB,GAAG,OAAO,CAAC,IAAI,CAAC,CAgDtF"}