@cursor/bdk 0.2.5 → 0.2.7

package/dist/internal/artifacts-store.js

@@ -2,10 +2,8 @@
  * Durable artifact rows and payloads behind `ctx.artifacts`
  * ({@link ArtifactsApi}).
  *
- * On Cursor-managed hosting rows and file payloads live on the deployment's
- * Agent Store (the same store behind `ctx.host.files`, so they survive
- * deploys and are visible on cloud VMs under the store mount); otherwise
- * they land under `--state-root/artifacts` on local disk.
+ * Cursor-managed hosting preserves artifacts across deployment replacement.
+ * Self-hosted agents store them under `--state-root/artifacts`.
  */
 var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
     function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
@@ -36,26 +34,19 @@ export const ARTIFACTS_PAGE_MAX_LIMIT = 1000;
  */
 const ARTIFACTS_PAGE_SCAN_MIN = 250;
 /**
- * Row-body hydration fan-out cap. `list()` fetches one object per row; on
- * the Agent Store each fetch is a control-plane request, and an unbounded
- * `Promise.all` over ~1k rows is a fleet-visible read burst (the 2026-09-18
- * Agent Store read storm was this exact fan-out, run once per insert by the
- * pre-metadata eviction path).
+ * Row-body hydration concurrency. A bounded fan-out keeps large listings
+ * from overwhelming the backing store.
  */
 const ROW_HYDRATION_CONCURRENCY = 8;
 /**
- * Rows hydrated per round trip when the row store batches
- * ({@link ArtifactRowStore.getMany}). Matches the hosted sink's presign
- * batch, so one page-scan slice is one control-plane request instead of one
- * per row.
+ * Rows hydrated per round trip when the row store supports
+ * {@link ArtifactRowStore.getMany}.
  */
 const ARTIFACTS_SCAN_BATCH_ROWS = 100;
 /**
  * Most rows one eviction pass may delete. Bounds the tag-latency cost of
- * draining a store that sits far past the retention cap (see
- * {@link ArtifactsStore.evictPastCap}): at ~0.7s per Agent Store delete and
- * {@link ROW_HYDRATION_CONCURRENCY}-way batching, a full pass stays under
- * ~10s while a backlog drains across the inserts that keep arriving.
+ * draining a store far past the retention cap; a backlog drains across
+ * subsequent inserts.
  */
 const ARTIFACTS_EVICT_MAX_PER_PASS = 64;
 /** Kind used by freeform tags when no kinds are declared. */
@@ -157,7 +148,7 @@ export class ArtifactsStore {
     }
     /**
      * Bounded cursor pagination, newest-updated first. On a store whose
-     * listing tracks mtimes (the hosted Agent Store), a page hydrates only
+     * listing tracks mtimes, a page hydrates only
      * the rows it examines — roughly `limit` bodies, never the whole store.
      * Row-body order is the listing's mtime order (upserts rewrite the row,
      * so mtime tracks `updatedAt`; same argument as eviction). The
@@ -165,15 +156,15 @@ export class ArtifactsStore {
      * exactly by `updatedAt`.
      *
      * `matches` is a host-side *visibility* predicate composed with the
-     * public filter — the engine passes session-ownership through it. Its
+     * public filter. The engine passes session ownership through it. Its
      * presence forces the exact hydrated lane: the metadata lane's cursor
-     * and its short-page continuation are derived from every row in the
-     * store, and handing them to a caller who may not see every row is a
+     * and short-page continuation include hidden records. Returning them to a
+     * caller who cannot see those records would create a
      * side channel (existence, count within the scan budget, boundary
      * mtimes and cohort depths of hidden rows) that the pre-pagination
      * filtered list never had. The exact lane's cursor names only a record
      * the caller received, and continues only while more *visible* records
-     * remain — at the pre-pagination cost (hydrate all rows, bounded).
+     * remain, at the bounded cost of hydrating the full set.
      */
     page(options) {
         return __awaiter(this, void 0, void 0, function* () {
@@ -230,9 +221,8 @@ export class ArtifactsStore {
             const records = [];
             let examined = 0;
             let lastExamined = start - 1;
-            // A batched row store hydrates a bigger slice per round trip (one
-            // control-plane call on the hosted sink); without one, keep the slice at
-            // the per-row fan-out bound so concurrency stays capped. An unfiltered
+            // A batched row store hydrates a bigger slice per round trip. Without
+            // one, keep the slice at the per-row fan-out bound. An unfiltered
             // page needs exactly the rows it returns — every hydrated row matches —
             // so cap its slice at the remaining page instead of over-hydrating a
             // full batch for a small `limit`.
@@ -351,21 +341,11 @@ export class ArtifactsStore {
     /**
      * Trim toward the retention cap from listing metadata alone. Past the
      * cap this runs on every new-row insert, so it must not hydrate row
-     * bodies: on the Agent Store that is one read per row (~`max` reads per
-     * insert, forever, since eviction trims right back to the cap) — the
-     * 2026-09-18 read storm on the security-reviewer deployment. The store
-     * listing carries last-modified metadata, and a row is rewritten on
-     * every upsert, so listing mtime orders rows the same way their
-     * `updatedAt` does.
+     * bodies. The listing carries last-modified metadata, and each upsert
+     * rewrites its row, so listing mtime orders rows like `updatedAt`.
      *
-     * Deletes are capped per pass: eviction runs inside `tag()`'s per-pod
-     * chain, so its wall time is tag latency for every queued caller. A
-     * store far past the cap (evictions failed during the 2026-09-19 read
-     * throttling and the backlog grew unchecked) must drain amortized
-     * across inserts, not wedge one insert deleting the whole backlog — on
-     * 2026-09-20 an uncapped pass held security-reviewer tags for hours and
-     * tripled review stage durations. Steady state (excess of 1) is
-     * unaffected.
+     * Deletes are capped per pass so a store far past the cap drains across
+     * inserts instead of delaying one insert for the entire backlog.
      */
     evictPastCap() {
         return __awaiter(this, void 0, void 0, function* () {
@@ -387,9 +367,8 @@ export class ArtifactsStore {
         return __awaiter(this, void 0, void 0, function* () {
             if (metas.some(meta => meta.mtimeMs !== undefined)) {
                 // A store that tracks mtimes must never regress to per-insert
-                // hydration. The rare entry missing one (anomalous on such a store)
-                // sorts oldest via the comparator's `?? 0` and gets evicted first —
-                // evicting an anomaly beats re-reading every row on every insert.
+                // hydration. An entry missing one sorts oldest via the comparator's
+                // `?? 0` and is evicted first, avoiding a full hydration on each insert.
                 return metas
                     .sort(byOldestModified)
                     .slice(0, excess)
@@ -457,9 +436,9 @@ export function artifactIdForKey(key) {
     return `art_${createHash("sha256").update(key, "utf8").digest("hex").slice(0, 32)}`;
 }
 /**
- * Oldest-modified first. Store mtimes can be coarse (S3 rounds to the
- * second), so equal stamps tie-break by id — deterministic, and within a
- * same-stamp cohort any victim is equally past the retention cap.
+ * Oldest-modified first. Store mtimes can be coarse, so equal stamps
+ * tie-break by id. Within the same-stamp cohort, any victim is equally past
+ * the retention cap.
  */
 function byOldestModified(a, b) {
     var _a, _b;
@@ -517,7 +496,7 @@ function sinkBody(found) {
     }
     return found instanceof Uint8Array ? found : found.body;
 }
-/** Rows as one JSON file each on the deployment's Agent Store. */
+/** Rows as one JSON document each in the durable sink. */
 function createSinkRowStore(sink, agentName) {
     const key = (id) => agentStoreKeys.artifactRow(agentName, id);
     return {

package/dist/internal/cli-ax.d.ts

@@ -67,15 +67,13 @@ export interface AxCliOptions {
     /** Remote agent base URL (skip local host) for run/eval/chat. */
     url?: string;
     /**
-     * Route chat/resume/run/call/eval/logs/sessions at the team's hosted
+     * Route chat/resume/run/call/logs/sessions at the team's hosted
      * deployment instead of a local ephemeral server. Mutually exclusive with
-     * `--url`. For `eval`, this runs a server-side batch via
-     * `/v1/dev/evals/runs` (persisted when `defineStorage` has an `evals` table);
-     * without `--prod`, eval defaults to an ephemeral local harness.
+     * `--url`. `eval` rejects it.
      */
     prod?: boolean;
     /**
-     * `eval` (`--prod` / `--url` only): start the batch via
+     * `eval` (`--url` only): start the batch via
      * `POST /v1/dev/evals/runs` and return the `runId` without polling.
      * Mutually exclusive with `--list`.
      */
@@ -157,26 +155,20 @@ export declare function cmdCall(options: AxCliOptions): Promise<number>;
 export declare function cmdSkill(skillName: string | undefined, options: AxCliOptions): Promise<number>;
 export declare function cmdTrajectory(options: AxCliOptions): Promise<number>;
 /**
- * Which surface `eval` should target. Local (ephemeral) is the default;
- * `--prod` uses the hosted deployment, `--url` a running server.
- * Exported for tests.
+ * Which surface `eval` should target: an ephemeral local server by default,
+ * or a running server with `--url`. Exported for tests.
  */
-export declare function resolveEvalTargetMode(options: Pick<AxCliOptions, "prod" | "url">): "local" | "url" | "deployment" | {
+export declare function resolveEvalTargetMode(options: Pick<AxCliOptions, "prod" | "url">): "local" | "url" | {
     error: string;
 };
 export declare function cmdEval(options: AxCliOptions): Promise<number>;
-/**
- * Flags to re-target the same surface from an `eval --no-wait` hint.
- * Exported for tests.
- */
-export declare function formatEvalStatusFlags(options: Pick<AxCliOptions, "prod" | "url" | "slug" | "team">): string;
 /**
  * `eval cancel <runId>` — cancel a running remote batch by Eval ID.
  */
 export declare function cmdEvalCancel(runId: string | undefined, options: AxCliOptions): Promise<number>;
 /**
- * `eval status [runId]` — fetch one batch (or list recent) on the deployment /
- * `--url` target. Exit `0` when the batch is completed with all cases passing,
+ * `eval status [runId]` — fetch one batch (or list recent) on the `--url`
+ * target. Exit `0` when the batch is completed with all cases passing,
  * `1` when failed / any case failed / unknown, `2` for usage errors, `3` when
  * the batch is still running (for poll loops after `--no-wait`).
  */
@@ -196,7 +188,8 @@ export declare function resolveEvalArtifactsDir(projectRoot: string, options: Pi
 export declare function formatEvalAssertionLine(assertion: EvalAssertionResult): string;
 /**
  * `logs` — follow deploy progress (`--prod`) then runtime agent logs.
- * Local / `--url` tails `/v1/logs` only.
+ * Local / `--url` tails `/v1/logs` only. On architecture v2, `--prod` tails
+ * the output of the deployment's recent sessions, or one with `--session`.
  */
 export declare function cmdLogs(options: AxCliOptions): Promise<number>;
 /**

package/dist/internal/cli-ax.d.ts.map

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

package/dist/internal/cli-ax.js

@@ -30,12 +30,12 @@ import { cancelRemoteEvalRun, getRemoteEvalRun, listRemoteEvalRuns, listRemoteEv
 import { runTemplateInit } from "./init-interview.js";
 import { checkInitTarget, formatInitNextSteps, formatInitScaffoldSummary, initNextCommands, initProject, installScaffoldDependencies, linkCliOntoPath, printInitGuide, resolveTemplate, } from "./init-project.js";
 import { offerInstallCursorSkills } from "./install-cursor-skills.js";
-import { rejectV2ForLegacyCommand, v2HostedVerifyHint } from "./legacy-command-guard.js";
-import { runLogsTail, sanitizeCustomerError } from "./logs-client.js";
+import { deploymentArchitecture, v2HostedVerifyHint } from "./legacy-command-guard.js";
+import { followHostedLogs, runLogsTail, sanitizeCustomerError } from "./logs-client.js";
 import { mapPool } from "./map-pool.js";
 import { openBrowser } from "./open-browser.js";
 import { startPlaygroundProxy } from "./playground-proxy.js";
-import { ProdTargetError, resolveProdAliasPlaygroundUrl, resolveProdPlaygroundUrl, resolveProdSlug, resolveProdTarget, } from "./resolve-prod-target.js";
+import { resolveProdPlaygroundUrl, resolveProdSlug, resolveProdTarget, } from "./resolve-prod-target.js";
 import { runSession } from "./run-client.js";
 import { buildSessionCostReport, formatSessionCostText, formatSessionsCostText, } from "./session-cost.js";
 import { fetchSessionEvents, formatSessionsTable, listSessionsWithSource, resolvePreviousSessionId, } from "./sessions-client.js";
@@ -70,16 +70,17 @@ function pickAgentUrl(handle, slug) {
     const root = handle.agents.find(a => a.slug === "");
     return (root !== null && root !== void 0 ? root : handle.agents[0]).url;
 }
-function startEphemeral(options) {
-    return __awaiter(this, void 0, void 0, function* () {
+function startEphemeral(options_1) {
+    return __awaiter(this, arguments, void 0, function* (options, evals = false) {
         var _a, _b;
         const dir = resolve((_a = options.cwd) !== null && _a !== void 0 ? _a : process.cwd(), options.dir);
         const stateRoot = (_b = options.stateRoot) !== null && _b !== void 0 ? _b : (yield mkdtemp(join(tmpdir(), "agent-serve-ax-")));
-        const handle = yield serve(dir, Object.assign({ host: "127.0.0.1", port: 0, stateRoot, playground: false, schedules: false, 
+        const serveOptions = Object.assign({ host: "127.0.0.1", port: 0, stateRoot, playground: false, schedules: false, evals, 
             // Keep host/tool timing off stdout so `run`/`eval` JSON stays clean.
             logger: (line) => {
                 process.stderr.write(`${line}\n`);
-            } }, (options.bearerToken === undefined ? {} : { authToken: options.bearerToken })));
+            } }, (options.bearerToken === undefined ? {} : { authToken: options.bearerToken }));
+        const handle = yield serve(dir, serveOptions);
         return {
             agentUrl: pickAgentUrl(handle, options.slug),
             close: () => __awaiter(this, void 0, void 0, function* () {
@@ -682,25 +683,17 @@ export function cmdTrajectory(options) {
     });
 }
 /**
- * Which surface `eval` should target. Local (ephemeral) is the default;
- * `--prod` uses the hosted deployment, `--url` a running server.
- * Exported for tests.
+ * Which surface `eval` should target: an ephemeral local server by default,
+ * or a running server with `--url`. Exported for tests.
  */
 export function resolveEvalTargetMode(options) {
-    const flags = [
-        options.prod === true ? "--prod" : undefined,
-        options.url !== undefined ? "--url" : undefined,
-    ].filter(flag => flag !== undefined);
-    if (flags.length > 1) {
-        return { error: `${flags.join(" and ")} are mutually exclusive` };
-    }
-    if (options.url !== undefined) {
-        return "url";
-    }
     if (options.prod === true) {
-        return "deployment";
+        return {
+            error: `eval does not support --prod. Run \`${CLI_COMMAND_NAME} eval\` locally, ` +
+                `or pass --url for a running server.`,
+        };
     }
-    return "local";
+    return options.url === undefined ? "local" : "url";
 }
 /** Resolve the eval target; prints a CLI-ready error and returns an exit code on failure. */
 function resolveEvalTarget(options) {
@@ -713,34 +706,7 @@ function resolveEvalTarget(options) {
         if (mode === "url") {
             return { agentUrl: options.url.replace(/\/$/, "") };
         }
-        if (mode === "local") {
-            return startEphemeral(options);
-        }
-        try {
-            const prod = yield resolveProdTarget({
-                dir: options.dir,
-                cwd: options.cwd,
-                slug: options.slug,
-                team: options.team,
-                apiKey: options.apiKey,
-                fetchImpl: options.fetchImpl,
-            });
-            return { agentUrl: prod.agentUrl, headers: prod.headers };
-        }
-        catch (error) {
-            if (error instanceof ProdTargetError && error.notFound) {
-                // Keep the API error text: a 404 can also mean a wrong API host or a
-                // disabled feature gate, and the message distinguishes those from a
-                // genuinely missing deployment.
-                process.stderr.write(`${sanitizeCustomerError(error.message)}\n` +
-                    `  deploy it first:  ${CLI_COMMAND_NAME} deploy --slug ${error.slug}\n` +
-                    `  or omit --prod:   ${CLI_COMMAND_NAME} eval --dir ${options.dir}\n`);
-                return 1;
-            }
-            process.stderr.write(`${sanitizeCustomerError(error instanceof Error ? error.message : String(error))}\n` +
-                `Pass --prod for the hosted deployment, or omit it to run on an ephemeral local server.\n`);
-            return 1;
-        }
+        return startEphemeral(options, true);
     });
 }
 export function cmdEval(options) {
@@ -759,7 +725,7 @@ export function cmdEval(options) {
                 return 2;
             }
             if (mode === "local") {
-                process.stderr.write("--no-wait requires --prod or --url (not the default local target)\n");
+                process.stderr.write("--no-wait requires --url (not the default local target)\n");
                 return 2;
             }
         }
@@ -777,7 +743,7 @@ export function cmdEval(options) {
         const tags = options.tags === undefined || options.tags.length === 0 ? undefined : options.tags;
         if (options.list) {
             // List the same surface a run will execute: local filesystem by default,
-            // GET /v1/dev/evals on --prod / --url.
+            // GET /v1/dev/evals on --url.
             if (mode === "local") {
                 return listLocalEvals(projectRoot, options, filterIds, tags);
             }
@@ -823,7 +789,7 @@ export function cmdEval(options) {
                 process.stderr.write(`eval target: ${target.agentUrl}\n`);
             }
             // Default local: ephemeral in-process harness against local eval sources.
-            // --prod / --url: run on the serve process via /v1/dev/evals/runs so the
+            // --url: run on the serve process via /v1/dev/evals/runs so the
             // batch lands in playground history and defineStorage evals (when set).
             if (mode === "local") {
                 const progress = stream ? createStreamProgress() : undefined;
@@ -869,7 +835,7 @@ export function cmdEval(options) {
                         },
                         fetchImpl: options.fetchImpl,
                     });
-                    return yield printEvalAccepted(started, options, target.agentUrl);
+                    return printEvalAccepted(started, options, target.agentUrl);
                 }
                 const progress = createRemoteEvalProgress(options.verbose === true || stream);
                 // Start first so we can print the Eval ID before the (often long) wait.
@@ -885,7 +851,7 @@ export function cmdEval(options) {
                     },
                     fetchImpl: options.fetchImpl,
                 });
-                yield printEvalIdBanner(started, options, target.agentUrl);
+                printEvalIdBanner(started, options, target.agentUrl);
                 (_a = progress === null || progress === void 0 ? void 0 : progress.onSnapshot) === null || _a === void 0 ? void 0 : _a.call(progress, started);
                 const snapshot = yield pollRemoteEvalRun({
                     baseUrl: target.agentUrl,
@@ -924,106 +890,58 @@ export function cmdEval(options) {
         }
     });
 }
-/**
- * Flags to re-target the same surface from an `eval --no-wait` hint.
- * Exported for tests.
- */
-export function formatEvalStatusFlags(options) {
-    const parts = [];
-    if (options.url !== undefined) {
-        parts.push(`--url ${options.url.replace(/\/$/, "")}`);
-    }
-    else {
-        parts.push("--prod");
-        if (options.slug !== undefined && options.slug !== "") {
-            parts.push(`--slug ${options.slug}`);
-        }
-    }
-    if (options.team !== undefined && options.team !== "") {
-        parts.push(`--team ${options.team}`);
-    }
-    return parts.length === 0 ? "" : ` ${parts.join(" ")}`;
-}
 /** Print Eval ID + cancel/status hints after a remote batch is accepted. */
 function printEvalIdBanner(started, options, agentUrl) {
-    return __awaiter(this, void 0, void 0, function* () {
-        const pollPath = `${agentUrl.replace(/\/$/, "")}/v1/dev/evals/runs/${started.runId}`;
-        const statusFlags = formatEvalStatusFlags(options);
-        const playgroundUrl = yield resolveEvalPlaygroundDeepLink(options, started.runId, agentUrl);
-        if (options.json) {
-            // Waiters still want the id on stderr so progress text stays readable.
-            process.stderr.write(`${JSON.stringify(Object.assign({ evalId: started.runId, runId: started.runId, status: started.status, summary: started.summary, pollUrl: pollPath }, (playgroundUrl === undefined ? {} : { playgroundUrl })))}\n`);
-            return;
-        }
-        const durable = started.config.durableRuns === true ? " (persisted)" : "";
-        process.stderr.write(`Eval ID: ${started.runId}${durable} — ${started.summary.total} case(s)\n`);
-        process.stderr.write(`Cancel:  ${CLI_COMMAND_NAME} eval cancel ${started.runId}${statusFlags}\n`);
-        process.stderr.write(`Status:  ${CLI_COMMAND_NAME} eval status ${started.runId}${statusFlags}\n`);
-        if (playgroundUrl !== undefined) {
-            process.stderr.write(`Playground: ${playgroundUrl}\n`);
-        }
-    });
+    const pollPath = `${agentUrl.replace(/\/$/, "")}/v1/dev/evals/runs/${started.runId}`;
+    const statusFlags = ` --url ${agentUrl.replace(/\/$/, "")}`;
+    const playgroundUrl = evalPlaygroundDeepLink(started.runId, agentUrl);
+    if (options.json) {
+        // Waiters still want the id on stderr so progress text stays readable.
+        process.stderr.write(`${JSON.stringify(Object.assign({ evalId: started.runId, runId: started.runId, status: started.status, summary: started.summary, pollUrl: pollPath }, (playgroundUrl === undefined ? {} : { playgroundUrl })))}\n`);
+        return;
+    }
+    const durable = started.config.durableRuns === true ? " (persisted)" : "";
+    process.stderr.write(`Eval ID: ${started.runId}${durable} — ${started.summary.total} case(s)\n`);
+    process.stderr.write(`Cancel:  ${CLI_COMMAND_NAME} eval cancel ${started.runId}${statusFlags}\n`);
+    process.stderr.write(`Status:  ${CLI_COMMAND_NAME} eval status ${started.runId}${statusFlags}\n`);
+    if (playgroundUrl !== undefined) {
+        process.stderr.write(`Playground: ${playgroundUrl}\n`);
+    }
 }
 /** `--no-wait`: print the accepted batch id (and how to poll) then exit. */
 function printEvalAccepted(started, options, agentUrl) {
-    return __awaiter(this, void 0, void 0, function* () {
-        const pollPath = `${agentUrl.replace(/\/$/, "")}/v1/dev/evals/runs/${started.runId}`;
-        const statusFlags = formatEvalStatusFlags(options);
-        const playgroundUrl = yield resolveEvalPlaygroundDeepLink(options, started.runId, agentUrl);
-        if (options.json) {
-            process.stdout.write(`${JSON.stringify(Object.assign({ ok: true, accepted: true, evalId: started.runId, runId: started.runId, status: started.status, summary: started.summary, pollUrl: pollPath, durableRuns: started.config.durableRuns === true }, (playgroundUrl === undefined ? {} : { playgroundUrl })), null, 2)}\n`);
-        }
-        else {
-            const durable = started.config.durableRuns === true ? " (persisted)" : "";
-            process.stdout.write(`Eval ID: ${started.runId}${durable} — ${started.summary.total} case(s)\n`);
-            process.stdout.write(`Cancel:  ${CLI_COMMAND_NAME} eval cancel ${started.runId}${statusFlags}\n`);
-            process.stdout.write(`Status:  ${CLI_COMMAND_NAME} eval status ${started.runId}${statusFlags}\n`);
-            if (playgroundUrl !== undefined) {
-                process.stdout.write(`Playground: ${playgroundUrl}\n`);
-            }
-            process.stdout.write(`Poll: ${pollPath}\n`);
+    const pollPath = `${agentUrl.replace(/\/$/, "")}/v1/dev/evals/runs/${started.runId}`;
+    const statusFlags = ` --url ${agentUrl.replace(/\/$/, "")}`;
+    const playgroundUrl = evalPlaygroundDeepLink(started.runId, agentUrl);
+    if (options.json) {
+        process.stdout.write(`${JSON.stringify(Object.assign({ ok: true, accepted: true, evalId: started.runId, runId: started.runId, status: started.status, summary: started.summary, pollUrl: pollPath, durableRuns: started.config.durableRuns === true }, (playgroundUrl === undefined ? {} : { playgroundUrl })), null, 2)}\n`);
+    }
+    else {
+        const durable = started.config.durableRuns === true ? " (persisted)" : "";
+        process.stdout.write(`Eval ID: ${started.runId}${durable} — ${started.summary.total} case(s)\n`);
+        process.stdout.write(`Cancel:  ${CLI_COMMAND_NAME} eval cancel ${started.runId}${statusFlags}\n`);
+        process.stdout.write(`Status:  ${CLI_COMMAND_NAME} eval status ${started.runId}${statusFlags}\n`);
+        if (playgroundUrl !== undefined) {
+            process.stdout.write(`Playground: ${playgroundUrl}\n`);
         }
-        return 0;
-    });
+        process.stdout.write(`Poll: ${pollPath}\n`);
+    }
+    return 0;
 }
 /**
- * Hosted alias playground URL with `view=evals` + `evalRunId` so the SPA
- * opens the batch that CLI / Slack started (not a stale sessionStorage id).
+ * Playground URL with `view=evals` + `evalRunId` so the SPA opens the batch
+ * that CLI / Slack started (not a stale sessionStorage id).
  */
-function resolveEvalPlaygroundDeepLink(options, runId, agentUrl) {
-    return __awaiter(this, void 0, void 0, function* () {
-        if (options.prod !== true) {
-            const base = `${agentUrl.replace(/\/$/, "")}/playground`;
-            try {
-                const url = new URL(base);
-                url.searchParams.set("view", "evals");
-                url.searchParams.set("evalRunId", runId);
-                return url.toString();
-            }
-            catch (_a) {
-                return undefined;
-            }
-        }
-        try {
-            const resolved = yield resolveProdAliasPlaygroundUrl({
-                dir: options.dir,
-                cwd: options.cwd,
-                slug: options.slug,
-                team: options.team,
-                apiKey: options.apiKey,
-                fetchImpl: options.fetchImpl,
-                // Avoid a second "Using hosted deployment" line; banner already has context.
-                err: () => { },
-            });
-            const url = new URL(resolved.playgroundUrl);
-            url.searchParams.set("view", "evals");
-            url.searchParams.set("evalRunId", runId);
-            return url.toString();
-        }
-        catch (_b) {
-            return undefined;
-        }
-    });
+function evalPlaygroundDeepLink(runId, agentUrl) {
+    try {
+        const url = new URL(`${agentUrl.replace(/\/$/, "")}/playground`);
+        url.searchParams.set("view", "evals");
+        url.searchParams.set("evalRunId", runId);
+        return url.toString();
+    }
+    catch (_a) {
+        return undefined;
+    }
 }
 /**
  * `eval cancel <runId>` — cancel a running remote batch by Eval ID.
@@ -1036,11 +954,11 @@ export function cmdEvalCancel(runId, options) {
             return 2;
         }
         if (mode === "local") {
-            process.stderr.write("eval cancel requires --prod or --url (not the default local target)\n");
+            process.stderr.write("eval cancel requires --url (not the default local target)\n");
             return 2;
         }
         if (runId === undefined || runId === "") {
-            process.stderr.write("usage: eval cancel <evalId> --prod|--url …\n");
+            process.stderr.write("usage: eval cancel <evalId> --url <baseUrl>\n");
             return 2;
         }
         if (options.list === true || options.noWait === true) {
@@ -1081,8 +999,8 @@ export function cmdEvalCancel(runId, options) {
     });
 }
 /**
- * `eval status [runId]` — fetch one batch (or list recent) on the deployment /
- * `--url` target. Exit `0` when the batch is completed with all cases passing,
+ * `eval status [runId]` — fetch one batch (or list recent) on the `--url`
+ * target. Exit `0` when the batch is completed with all cases passing,
  * `1` when failed / any case failed / unknown, `2` for usage errors, `3` when
  * the batch is still running (for poll loops after `--no-wait`).
  */
@@ -1094,7 +1012,7 @@ export function cmdEvalStatus(runId, options) {
             return 2;
         }
         if (mode === "local") {
-            process.stderr.write("eval status requires --prod or --url (not the default local target)\n");
+            process.stderr.write("eval status requires --url (not the default local target)\n");
             return 2;
         }
         if (options.list === true || options.noWait === true) {
@@ -1399,7 +1317,8 @@ export function formatEvalAssertionLine(assertion) {
 }
 /**
  * `logs` — follow deploy progress (`--prod`) then runtime agent logs.
- * Local / `--url` tails `/v1/logs` only.
+ * Local / `--url` tails `/v1/logs` only. On architecture v2, `--prod` tails
+ * the output of the deployment's recent sessions, or one with `--session`.
  */
 export function cmdLogs(options) {
     return __awaiter(this, void 0, void 0, function* () {
@@ -1408,6 +1327,11 @@ export function cmdLogs(options) {
             process.stderr.write("--prod and --url are mutually exclusive\n");
             return 2;
         }
+        const sessionId = trimNonEmpty(options.sessionId);
+        if (sessionId !== undefined && options.prod !== true) {
+            process.stderr.write("A session id needs --prod on an architecture v2 deployment\n");
+            return 2;
+        }
         const controller = new AbortController();
         const onSignal = () => {
             controller.abort();
@@ -1429,11 +1353,26 @@ export function cmdLogs(options) {
                 if (typeof auth === "number") {
                     return auth;
                 }
-                yield rejectV2ForLegacyCommand({
+                const architecture = yield deploymentArchitecture({
                     client: auth.client,
                     teamId: auth.teamId,
                     slug,
                 });
+                if (architecture === "v2") {
+                    yield followHostedLogs({
+                        slug,
+                        read: signal => auth.client.getAgentkitDeploymentLogs({ teamId: auth.teamId, slug, sessionId, signal }),
+                        scoped: sessionId !== undefined,
+                        once: options.once === true,
+                        json: options.json === true,
+                        signal: controller.signal,
+                    });
+                    return 0;
+                }
+                if (sessionId !== undefined) {
+                    process.stderr.write(`A session id needs an architecture v2 deployment; "${slug}" is v1\n`);
+                    return 2;
+                }
                 yield runLogsTail({
                     prod: true,
                     dir: options.dir,