@cursor/july 0.1.6 → 0.1.8

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

@@ -0,0 +1,96 @@
+/**
+ * HTTP client for playground eval batches (`/v1/dev/evals/runs`).
+ *
+ * Used by `agentkit eval --prod` (or `--url`) so the batch runs on the serve
+ * process and is mirrored to `defineStorage` when an `evals` table is
+ * configured. Without those flags, eval keeps the in-process ephemeral path
+ * in `cli-ax.ts`.
+ */
+import type { EvalRunSnapshot } from "../evals.js";
+import type { EvalRunResult } from "./eval-runner.js";
+import { type RequestAuth } from "./request-headers.js";
+export type RemoteEvalErrorCode = "no_matching_evals" | "eval_run_in_progress" | "unknown_eval_run" | "start_failed" | "poll_failed" | "aborted";
+export declare class RemoteEvalError extends Error {
+    readonly status?: number | undefined;
+    readonly code?: RemoteEvalErrorCode | undefined;
+    readonly activeRunId?: string | undefined;
+    constructor(message: string, status?: number | undefined, code?: RemoteEvalErrorCode | undefined, activeRunId?: string | undefined);
+}
+export interface RemoteEvalListItem {
+    id: string;
+    fileId: string;
+    description?: string;
+    tags?: string[];
+}
+export interface RunRemoteEvalsOptions extends RequestAuth {
+    baseUrl: string;
+    filterIds?: string[];
+    tags?: string[];
+    /** Per-case timeout override forwarded to the serve process. */
+    timeoutMs?: number;
+    /** Ask the serve harness to emit verbose case logs (server-side). */
+    verbose?: boolean;
+    fetchImpl?: typeof fetch;
+    /** Poll interval while the batch is `running`. */
+    pollMs?: number;
+    /** Abort the wait (not the remote batch). */
+    signal?: AbortSignal;
+    /** Called each time the polled snapshot changes. */
+    onSnapshot?: (snap: EvalRunSnapshot) => void;
+}
+/**
+ * Start a batch on the target serve via `POST /v1/dev/evals/runs`, poll until
+ * terminal, and return CLI-shaped case results.
+ */
+export declare function runRemoteEvals(options: RunRemoteEvalsOptions): Promise<{
+    snapshot: EvalRunSnapshot;
+    results: EvalRunResult[];
+}>;
+/** List datapoints from `GET /v1/dev/evals` (same surface a remote run uses). */
+export declare function listRemoteEvals(args: {
+    baseUrl: string;
+    auth?: RequestAuth;
+    fetchImpl?: typeof fetch;
+    filterIds?: string[];
+    tags?: string[];
+    signal?: AbortSignal;
+}): Promise<RemoteEvalListItem[]>;
+export declare function startRemoteEvalRun(args: {
+    baseUrl: string;
+    auth?: RequestAuth;
+    fetchImpl?: typeof fetch;
+    filterIds?: string[];
+    tags?: string[];
+    timeoutMs?: number;
+    verbose?: boolean;
+    signal?: AbortSignal;
+}): Promise<EvalRunSnapshot>;
+/** One-shot `GET /v1/dev/evals/runs/:runId` (no polling). */
+export declare function getRemoteEvalRun(args: {
+    baseUrl: string;
+    runId: string;
+    auth?: RequestAuth;
+    fetchImpl?: typeof fetch;
+    signal?: AbortSignal;
+}): Promise<EvalRunSnapshot>;
+/** Recent batches from `GET /v1/dev/evals/runs`. */
+export declare function listRemoteEvalRuns(args: {
+    baseUrl: string;
+    auth?: RequestAuth;
+    fetchImpl?: typeof fetch;
+    signal?: AbortSignal;
+}): Promise<{
+    runs: EvalRunSnapshot[];
+    activeRunId?: string;
+}>;
+export declare function pollRemoteEvalRun(args: {
+    baseUrl: string;
+    runId: string;
+    auth?: RequestAuth;
+    fetchImpl?: typeof fetch;
+    pollMs?: number;
+    signal?: AbortSignal;
+    onSnapshot?: (snap: EvalRunSnapshot) => void;
+}): Promise<EvalRunSnapshot>;
+export declare function snapshotToEvalRunResults(snapshot: EvalRunSnapshot): EvalRunResult[];
+//# sourceMappingURL=evals-client.d.ts.map

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

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

package/dist/internal/evals-client.js

@@ -0,0 +1,262 @@
+/**
+ * HTTP client for playground eval batches (`/v1/dev/evals/runs`).
+ *
+ * Used by `agentkit eval --prod` (or `--url`) so the batch runs on the serve
+ * process and is mirrored to `defineStorage` when an `evals` table is
+ * configured. Without those flags, eval keeps the in-process ephemeral path
+ * in `cli-ax.ts`.
+ */
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+import { matchesEvalIdFilter } from "../evals.js";
+import { mergeRequestHeaders } from "./request-headers.js";
+const DEFAULT_POLL_MS = 1000;
+export class RemoteEvalError extends Error {
+    constructor(message, status, code, activeRunId) {
+        super(message);
+        this.status = status;
+        this.code = code;
+        this.activeRunId = activeRunId;
+        this.name = "RemoteEvalError";
+    }
+}
+/**
+ * Start a batch on the target serve via `POST /v1/dev/evals/runs`, poll until
+ * terminal, and return CLI-shaped case results.
+ */
+export function runRemoteEvals(options) {
+    return __awaiter(this, void 0, void 0, function* () {
+        var _a;
+        var _b, _c;
+        const baseUrl = options.baseUrl.replace(/\/$/, "");
+        const fetchImpl = (_b = options.fetchImpl) !== null && _b !== void 0 ? _b : fetch;
+        const auth = {
+            bearerToken: options.bearerToken,
+            headers: options.headers,
+        };
+        const started = yield startRemoteEvalRun({
+            baseUrl,
+            auth,
+            fetchImpl,
+            filterIds: options.filterIds,
+            tags: options.tags,
+            timeoutMs: options.timeoutMs,
+            verbose: options.verbose,
+            signal: options.signal,
+        });
+        (_a = options.onSnapshot) === null || _a === void 0 ? void 0 : _a.call(options, started);
+        const snapshot = yield pollRemoteEvalRun({
+            baseUrl,
+            runId: started.runId,
+            auth,
+            fetchImpl,
+            pollMs: (_c = options.pollMs) !== null && _c !== void 0 ? _c : DEFAULT_POLL_MS,
+            signal: options.signal,
+            onSnapshot: options.onSnapshot,
+        });
+        return { snapshot, results: snapshotToEvalRunResults(snapshot) };
+    });
+}
+/** List datapoints from `GET /v1/dev/evals` (same surface a remote run uses). */
+export function listRemoteEvals(args) {
+    return __awaiter(this, void 0, void 0, function* () {
+        var _a, _b;
+        const baseUrl = args.baseUrl.replace(/\/$/, "");
+        const fetchImpl = (_a = args.fetchImpl) !== null && _a !== void 0 ? _a : fetch;
+        let resp;
+        try {
+            resp = yield fetchImpl(`${baseUrl}/v1/dev/evals`, {
+                headers: mergeRequestHeaders(args.auth),
+                signal: args.signal,
+            });
+        }
+        catch (error) {
+            throw new RemoteEvalError(error instanceof Error ? error.message : "Could not list evals.", undefined, "start_failed");
+        }
+        if (!resp.ok) {
+            throw new RemoteEvalError(`Could not list evals (HTTP ${resp.status}).`, resp.status, "start_failed");
+        }
+        const body = (yield resp.json());
+        const listed = [];
+        for (const row of (_b = body.evals) !== null && _b !== void 0 ? _b : []) {
+            if (typeof row.id !== "string" || row.id === "") {
+                continue;
+            }
+            if (typeof row.fileId !== "string" || row.fileId === "") {
+                continue;
+            }
+            const tags = Array.isArray(row.tags)
+                ? row.tags.filter((t) => typeof t === "string")
+                : undefined;
+            listed.push(Object.assign(Object.assign({ id: row.id, fileId: row.fileId }, (typeof row.description === "string"
+                ? { description: row.description }
+                : {})), (tags === undefined || tags.length === 0 ? {} : { tags })));
+        }
+        let selected = listed;
+        if (args.filterIds !== undefined && args.filterIds.length > 0) {
+            selected = selected.filter((e) => args.filterIds.some((f) => matchesEvalIdFilter(e.id, f)));
+        }
+        if (args.tags !== undefined && args.tags.length > 0) {
+            selected = selected.filter((e) => { var _a; return ((_a = e.tags) !== null && _a !== void 0 ? _a : []).some((t) => args.tags.includes(t)); });
+        }
+        return selected;
+    });
+}
+export function startRemoteEvalRun(args) {
+    return __awaiter(this, void 0, void 0, function* () {
+        var _a;
+        const baseUrl = args.baseUrl.replace(/\/$/, "");
+        const fetchImpl = (_a = args.fetchImpl) !== null && _a !== void 0 ? _a : fetch;
+        const body = {};
+        if (args.filterIds !== undefined && args.filterIds.length > 0) {
+            body.filterIds = args.filterIds;
+        }
+        if (args.tags !== undefined && args.tags.length > 0) {
+            body.tags = args.tags;
+        }
+        if (args.timeoutMs !== undefined) {
+            body.timeoutMs = args.timeoutMs;
+        }
+        if (args.verbose === true) {
+            body.verbose = true;
+        }
+        let resp;
+        try {
+            resp = yield fetchImpl(`${baseUrl}/v1/dev/evals/runs`, {
+                method: "POST",
+                headers: Object.assign({ "content-type": "application/json" }, mergeRequestHeaders(args.auth)),
+                body: JSON.stringify(body),
+                signal: args.signal,
+            });
+        }
+        catch (error) {
+            throw new RemoteEvalError(error instanceof Error ? error.message : "Could not start eval run.", undefined, "start_failed");
+        }
+        const json = (yield resp.json().catch(() => ({})));
+        if (json.error === "no_matching_evals") {
+            throw new RemoteEvalError("No matching evals found.", 404, "no_matching_evals");
+        }
+        if (resp.status === 409 || json.error === "eval_run_in_progress") {
+            throw new RemoteEvalError(json.activeRunId !== undefined && json.activeRunId !== ""
+                ? `An eval run is already in progress (${json.activeRunId}).`
+                : "An eval run is already in progress.", 409, "eval_run_in_progress", typeof json.activeRunId === "string" ? json.activeRunId : undefined);
+        }
+        if (!resp.ok) {
+            const detail = typeof json.message === "string" && json.message !== ""
+                ? json.message
+                : typeof json.error === "string" && json.error !== ""
+                    ? json.error
+                    : `HTTP ${resp.status}`;
+            throw new RemoteEvalError(`Could not start eval run: ${detail}`, resp.status, "start_failed");
+        }
+        if (typeof json.runId !== "string" || json.runId === "") {
+            throw new RemoteEvalError("Eval start response missing runId.", undefined, "start_failed");
+        }
+        return json;
+    });
+}
+/** One-shot `GET /v1/dev/evals/runs/:runId` (no polling). */
+export function getRemoteEvalRun(args) {
+    return __awaiter(this, void 0, void 0, function* () {
+        var _a;
+        const baseUrl = args.baseUrl.replace(/\/$/, "");
+        const fetchImpl = (_a = args.fetchImpl) !== null && _a !== void 0 ? _a : fetch;
+        let resp;
+        try {
+            resp = yield fetchImpl(`${baseUrl}/v1/dev/evals/runs/${encodeURIComponent(args.runId)}`, {
+                headers: mergeRequestHeaders(args.auth),
+                signal: args.signal,
+            });
+        }
+        catch (error) {
+            throw new RemoteEvalError(error instanceof Error ? error.message : "Could not fetch eval run.", undefined, "poll_failed");
+        }
+        if (resp.status === 404) {
+            throw new RemoteEvalError(`Unknown eval run ${args.runId}.`, 404, "unknown_eval_run");
+        }
+        if (!resp.ok) {
+            throw new RemoteEvalError(`Could not fetch eval run (HTTP ${resp.status}).`, resp.status, "poll_failed");
+        }
+        return (yield resp.json());
+    });
+}
+/** Recent batches from `GET /v1/dev/evals/runs`. */
+export function listRemoteEvalRuns(args) {
+    return __awaiter(this, void 0, void 0, function* () {
+        var _a;
+        const baseUrl = args.baseUrl.replace(/\/$/, "");
+        const fetchImpl = (_a = args.fetchImpl) !== null && _a !== void 0 ? _a : fetch;
+        let resp;
+        try {
+            resp = yield fetchImpl(`${baseUrl}/v1/dev/evals/runs`, {
+                headers: mergeRequestHeaders(args.auth),
+                signal: args.signal,
+            });
+        }
+        catch (error) {
+            throw new RemoteEvalError(error instanceof Error ? error.message : "Could not list eval runs.", undefined, "poll_failed");
+        }
+        if (!resp.ok) {
+            throw new RemoteEvalError(`Could not list eval runs (HTTP ${resp.status}).`, resp.status, "poll_failed");
+        }
+        const body = (yield resp.json());
+        const runs = Array.isArray(body.runs)
+            ? body.runs.filter((r) => r !== null &&
+                typeof r === "object" &&
+                typeof r.runId === "string")
+            : [];
+        return Object.assign({ runs }, (typeof body.activeRunId === "string" && body.activeRunId !== ""
+            ? { activeRunId: body.activeRunId }
+            : {}));
+    });
+}
+export function pollRemoteEvalRun(args) {
+    return __awaiter(this, void 0, void 0, function* () {
+        var _a, _b;
+        var _c;
+        const pollMs = (_c = args.pollMs) !== null && _c !== void 0 ? _c : DEFAULT_POLL_MS;
+        let lastJson = "";
+        for (;;) {
+            if (((_a = args.signal) === null || _a === void 0 ? void 0 : _a.aborted) === true) {
+                throw new RemoteEvalError("Eval wait aborted.", undefined, "aborted");
+            }
+            const snap = yield getRemoteEvalRun(args);
+            const serialized = JSON.stringify(snap);
+            if (serialized !== lastJson) {
+                lastJson = serialized;
+                (_b = args.onSnapshot) === null || _b === void 0 ? void 0 : _b.call(args, snap);
+            }
+            if (snap.status !== "running") {
+                return snap;
+            }
+            yield sleep(pollMs, args.signal);
+        }
+    });
+}
+export function snapshotToEvalRunResults(snapshot) {
+    return snapshot.cases.map((c) => { var _a, _b, _c, _d; return (Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign({ id: c.id, path: c.fileId }, (c.description === undefined ? {} : { description: c.description })), { ok: c.ok === true, assertions: (_a = c.assertions) !== null && _a !== void 0 ? _a : [] }), (c.sessionId === undefined ? {} : { sessionId: c.sessionId })), { inputs: (_b = c.inputs) !== null && _b !== void 0 ? _b : [] }), (c.finalText === undefined ? {} : { finalText: c.finalText })), (c.tools === undefined ? {} : { tools: c.tools })), (c.toolCalls === undefined ? {} : { toolCalls: c.toolCalls })), (c.error === undefined ? {} : { error: c.error })), { logs: (_c = c.logs) !== null && _c !== void 0 ? _c : [], durationMs: (_d = c.durationMs) !== null && _d !== void 0 ? _d : 0 })); });
+}
+function sleep(ms, signal) {
+    return new Promise((resolve, reject) => {
+        if ((signal === null || signal === void 0 ? void 0 : signal.aborted) === true) {
+            reject(new RemoteEvalError("Eval wait aborted.", undefined, "aborted"));
+            return;
+        }
+        const timer = setTimeout(() => {
+            signal === null || signal === void 0 ? void 0 : signal.removeEventListener("abort", onAbort);
+            resolve();
+        }, ms);
+        const onAbort = () => {
+            clearTimeout(timer);
+            reject(new RemoteEvalError("Eval wait aborted.", undefined, "aborted"));
+        };
+        signal === null || signal === void 0 ? void 0 : signal.addEventListener("abort", onAbort, { once: true });
+    });
+}

package/dist/internal/host-kv.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Author-facing durable JSON KV for {@link HostContext.kv}.
+ *
+ * When `defineStorage` is authored and exposes `get`, values live in that
+ * sink under {@link storageKeys.kv}. Otherwise they land as one JSON file
+ * per key under `--state-root/kv` (local dogfood / no durable plug-in).
+ */
+import type { HostKvApi } from "../types.js";
+import type { StorageCoordinator } from "./storage-coordinator.js";
+export interface CreateHostKvApiOptions {
+    agentName: string;
+    stateRoot: string;
+    storage?: StorageCoordinator;
+}
+/** Build the host KV API for one agent process. */
+export declare function createHostKvApi(options: CreateHostKvApiOptions): HostKvApi;
+//# sourceMappingURL=host-kv.d.ts.map

package/dist/internal/host-kv.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"host-kv.d.ts","sourceRoot":"","sources":["../../src/internal/host-kv.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAMH,OAAO,KAAK,EAAE,SAAS,EAAa,MAAM,aAAa,CAAC;AACxD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAEnE,MAAM,WAAW,sBAAsB;IACrC,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,kBAAkB,CAAC;CAC9B;AAED,mDAAmD;AACnD,wBAAgB,eAAe,CAAC,OAAO,EAAE,sBAAsB,GAAG,SAAS,CAa1E"}

package/dist/internal/host-kv.js

@@ -0,0 +1,77 @@
+/**
+ * Author-facing durable JSON KV for {@link HostContext.kv}.
+ *
+ * When `defineStorage` is authored and exposes `get`, values live in that
+ * sink under {@link storageKeys.kv}. Otherwise they land as one JSON file
+ * per key under `--state-root/kv` (local dogfood / no durable plug-in).
+ */
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+import { randomUUID } from "node:crypto";
+import { mkdir, readFile, rename, rm, writeFile } from "node:fs/promises";
+import { join } from "node:path";
+import { storageKeys } from "../storage.js";
+/** Build the host KV API for one agent process. */
+export function createHostKvApi(options) {
+    const storage = options.storage;
+    if ((storage === null || storage === void 0 ? void 0 : storage.supportsAuthorKv) === true) {
+        return {
+            get: (key) => storage.kvGet(normalizeAuthorKey(key)),
+            put: (key, value) => storage.kvPut(normalizeAuthorKey(key), value),
+            delete: (key) => storage.kvDelete(normalizeAuthorKey(key)),
+        };
+    }
+    return createFilesystemKvApi({
+        agentName: options.agentName,
+        stateRoot: options.stateRoot,
+    });
+}
+function createFilesystemKvApi(options) {
+    const dir = join(options.stateRoot, "kv");
+    const filePath = (authorKey) => join(dir, `${encodeURIComponent(storageKeys.kv(options.agentName, authorKey))}.json`);
+    return {
+        get(key) {
+            return __awaiter(this, void 0, void 0, function* () {
+                const authorKey = normalizeAuthorKey(key);
+                try {
+                    return JSON.parse(yield readFile(filePath(authorKey), "utf8"));
+                }
+                catch (error) {
+                    if (error.code === "ENOENT") {
+                        return undefined;
+                    }
+                    throw error;
+                }
+            });
+        },
+        put(key, value) {
+            return __awaiter(this, void 0, void 0, function* () {
+                const authorKey = normalizeAuthorKey(key);
+                yield mkdir(dir, { recursive: true });
+                const target = filePath(authorKey);
+                const tmp = join(dir, `.tmp-${randomUUID()}`);
+                yield writeFile(tmp, JSON.stringify(value), "utf8");
+                yield rename(tmp, target);
+            });
+        },
+        delete(key) {
+            return __awaiter(this, void 0, void 0, function* () {
+                const authorKey = normalizeAuthorKey(key);
+                yield rm(filePath(authorKey), { force: true });
+            });
+        },
+    };
+}
+function normalizeAuthorKey(key) {
+    if (typeof key !== "string" || key.trim() === "") {
+        throw new Error("host.kv key must be a non-empty string");
+    }
+    return key;
+}

package/dist/internal/init-project.js

@@ -301,15 +301,15 @@ Recommended loop once the project exists:
   1. Edit agent/ + tools under agent/tools/
   2. ${CLI_COMMAND_NAME} info --dir . --json
   3. ${CLI_COMMAND_NAME} run --dir . --message "..."
-  4. ${CLI_COMMAND_NAME} eval --local --dir .
+  4. ${CLI_COMMAND_NAME} eval --dir .
 
 Evals:
   Create evals/**/*.eval.ts using defineEval from ${PACKAGE_NAME}/evals
   Case id is the path: evals/weather/nyc.eval.ts → weather/nyc
   Required: evals/evals.config.ts with defineEvalConfig({ maxConcurrency })
     (hard-capped at 200 due to model provider request limits)
-  Run: ${CLI_COMMAND_NAME} eval --local [--json] [evalId...]
-    (omit --local to run against the hosted deployment)
+  Run: ${CLI_COMMAND_NAME} eval [--json] [evalId...]
+    (pass --prod to run against the hosted deployment)
 
 See AGENTS.md in the ${PACKAGE_NAME} package for the full loop.
 `);

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

@@ -1 +1 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/internal/server.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AA2BH,OAAO,KAAK,EACV,YAAY,EACZ,gBAAgB,EAOhB,YAAY,EACb,MAAM,aAAa,CAAC;AAoFrB,OAAO,EAAE,KAAK,WAAW,EAAmB,MAAM,iBAAiB,CAAC;AAapE,8EAA8E;AAC9E,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,YAAY,CAAC;CACvB;AAYD,6EAA6E;AAC7E,MAAM,WAAW,0BAA0B;IACzC,oEAAoE;IACpE,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED;;;;GAIG;AACH,wBAAsB,WAAW,CAC/B,MAAM,EAAE,UAAU,EAAE,EACpB,OAAO,GAAE,YAAY,GAAG,0BAA+B,GACtD,OAAO,CAAC,gBAAgB,CAAC,CA2lB3B"}
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/internal/server.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AA2BH,OAAO,KAAK,EACV,YAAY,EACZ,gBAAgB,EAOhB,YAAY,EACb,MAAM,aAAa,CAAC;AAoFrB,OAAO,EAAE,KAAK,WAAW,EAAmB,MAAM,iBAAiB,CAAC;AAapE,8EAA8E;AAC9E,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,YAAY,CAAC;CACvB;AAYD,6EAA6E;AAC7E,MAAM,WAAW,0BAA0B;IACzC,oEAAoE;IACpE,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED;;;;GAIG;AACH,wBAAsB,WAAW,CAC/B,MAAM,EAAE,UAAU,EAAE,EACpB,OAAO,GAAE,YAAY,GAAG,0BAA+B,GACtD,OAAO,CAAC,gBAAgB,CAAC,CAsmB3B"}

package/dist/internal/server.js

@@ -272,6 +272,10 @@ export function startServer(mounts_1) {
                             engine.trackBackground(promise);
                         },
                         resolveApproval: (sessionId, callId, decision, auth) => engine.resolveApproval(sessionId, callId, decision, auth),
+                        hasContinuationSession: (continuationToken) => engine.hasContinuationSession(channel.id, continuationToken),
+                        isContinuationBusy: (continuationToken) => engine.isContinuationBusy(channel.id, continuationToken),
+                        getContinuationLastBotMessageTs: (continuationToken) => engine.getContinuationLastBotMessageTs(channel.id, continuationToken),
+                        interruptContinuation: (continuationToken) => engine.interruptContinuation(channel.id, continuationToken),
                         logger,
                     };
                     try {
@@ -846,14 +850,16 @@ function mountAgentRoutes(router, runtime, args) {
             const body = yield readJsonObject(request);
             const filterIds = asStringArray(body === null || body === void 0 ? void 0 : body.filterIds);
             const tags = asStringArray(body === null || body === void 0 ? void 0 : body.tags);
+            const timeoutMs = asPositiveInt(body === null || body === void 0 ? void 0 : body.timeoutMs);
+            const verbose = (body === null || body === void 0 ? void 0 : body.verbose) === true;
             const authHeader = request.headers.get("authorization");
             const bearerToken = (authHeader === null || authHeader === void 0 ? void 0 : authHeader.toLowerCase().startsWith("bearer "))
                 ? authHeader.slice("bearer ".length).trim()
                 : undefined;
             try {
-                const snap = yield runtime.evalRuns.start(Object.assign(Object.assign(Object.assign({}, (filterIds === undefined ? {} : { filterIds })), (tags === undefined ? {} : { tags })), (bearerToken === undefined || bearerToken === ""
+                const snap = yield runtime.evalRuns.start(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign({}, (filterIds === undefined ? {} : { filterIds })), (tags === undefined ? {} : { tags })), (bearerToken === undefined || bearerToken === ""
                     ? {}
-                    : { bearerToken })));
+                    : { bearerToken })), (timeoutMs === undefined ? {} : { timeoutMs })), (verbose ? { verbose: true } : {})));
                 return jsonResponse(snap, { status: 202 });
             }
             catch (error) {
@@ -1252,6 +1258,10 @@ function startCursorSlackRelay(input) {
                     envelope,
                     send: args.send,
                     host: args.host,
+                    hasContinuationSession: (continuationToken) => target.runtime.engine.hasContinuationSession(target.channelId, continuationToken),
+                    isContinuationBusy: (continuationToken) => target.runtime.engine.isContinuationBusy(target.channelId, continuationToken),
+                    getContinuationLastBotMessageTs: (continuationToken) => target.runtime.engine.getContinuationLastBotMessageTs(target.channelId, continuationToken),
+                    interruptContinuation: (continuationToken) => target.runtime.engine.interruptContinuation(target.channelId, continuationToken),
                 });
             }),
         });
@@ -1488,6 +1498,13 @@ function asStringArray(value) {
     }
     return out.length === 0 ? undefined : out;
 }
+function asPositiveInt(value) {
+    if (typeof value !== "number" || !Number.isFinite(value)) {
+        return undefined;
+    }
+    const n = Math.floor(value);
+    return n > 0 ? n : undefined;
+}
 function assertReminderReadable(input) {
     return __awaiter(this, void 0, void 0, function* () {
         const existing = yield input.engine.sessions.findByContinuation(input.reminder.channelId, input.reminder.continuationToken);

package/dist/internal/session-engine.d.ts

@@ -6,6 +6,7 @@
  * are mapped onto the channel event vocabulary and dispatched to channel
  * event handlers and hooks.
  */
+import { SlackAskDedupeStore, SlackNudgeStore } from "../channels/slack/nudge-store.js";
 import { type AgentProject, type ApprovalDecision, type AuthContext, type CallToolOptions, type ChannelDefinition, type ChannelSession, type HostContext, type HttpChannelDefinition, type PendingApproval, type ReceiveInput, type SendMessageOptions, type SessionEvent, type SessionInfo, type SessionRecord, type SessionSummary, type ToolCallOutcome, type TurnOutcome } from "../types.js";
 import { type ABSnapshot } from "./ab-snapshot.js";
 import { type HostPlatforms } from "./host-platforms.js";
@@ -83,6 +84,10 @@ export declare class SessionEngine {
     readonly project: AgentProject;
     readonly stateRoot: string;
     readonly sessions: SessionStore;
+    /** Durable Slack mid-turn nudges under `<stateRoot>/slack-nudges`. */
+    readonly nudgeStore: SlackNudgeStore;
+    /** Durable `channelId:ts` ask claims under `<stateRoot>/slack-asks`. */
+    readonly askDedupe: SlackAskDedupeStore;
     /**
      * Runtime for `agent/storage.ts` (`defineStorage`), when
      * authored. All durable state changes funnel through it (session
@@ -105,6 +110,16 @@ export declare class SessionEngine {
     private readonly turnAborts;
     /** Serializes turn admission per session (latest follow-up wins). */
     private readonly admissionChains;
+    /**
+     * Per-session coalesce queue for `admission: "coalesce"` (Slack). Drained
+     * into one follow-up turn when the active turn finishes without interrupt.
+     */
+    private readonly coalesceQueues;
+    /**
+     * Sessions whose turn lifecycle is draining coalesced follow-ups. Counts as
+     * busy so inbound coalesce admits enqueue instead of racing `clearCoalesced`.
+     */
+    private readonly coalesceDrains;
     private readonly lastOutcomes;
     private readonly updateChains;
     private readonly dispatchChains;
@@ -114,6 +129,7 @@ export declare class SessionEngine {
     private readonly approvals;
     private readonly abCollector;
     private reminderApi;
+    private readonly kvApi;
     /** Serve-time resolved connections (see {@link setResolvedConnections}). */
     private resolvedConnections;
     constructor(options: SessionEngineOptions);
@@ -124,8 +140,9 @@ export declare class SessionEngine {
      * (`ctx.host.mcp`, always loopback).
      */
     setResolvedConnections(connections: EngineResolvedConnection[]): void;
-    /** Shared host services (MCP / GitHub / Slack / reminders). */
+    /** Shared host services (MCP / GitHub / Slack / reminders / kv / Slack nudges). */
     get host(): HostContext;
+    private slackNudgeHostApi;
     /** Attach the serve-host reminder API (called from startServer). */
     setReminders(api: HostContext["reminders"]): void;
     /**
@@ -134,6 +151,8 @@ export declare class SessionEngine {
      * session is created (keyed by the provided token, or a fresh one).
      */
     send(channelId: string, message: string, options?: EngineSendOptions): Promise<ChannelSession>;
+    /** Whether a continuation token already maps to a session on this channel. */
+    hasContinuationSession(channelId: string, continuationToken: string): Promise<boolean>;
     /**
      * Sticky A/B enrollment at session creation — before the first turn, so
      * variants are in the durable stream (and on {@link SessionRecord.abs})
@@ -167,13 +186,21 @@ export declare class SessionEngine {
         done: Promise<TurnOutcome>;
     }>;
     /**
-     * Admit a turn for `sessionId`. A follow-up that arrives while a turn is in
-     * flight preempts it: the running turn is cancelled and its SDK run marked
-     * terminal before the new turn starts. Admissions are serialized per session
-     * so a burst of follow-ups can't race two runs onto the same SDK agent — the
-     * last message wins. Resolves once the new turn has started (not finished).
+     * Admit a turn for `sessionId`.
+     *
+     * Default (`preempt`): a follow-up cancels the running turn and starts
+     * immediately (HTTP / MCP). With `admission: "coalesce"` (Slack), a busy
+     * session enqueues the message and returns without interrupting; the queue
+     * drains into one follow-up when the active turn finishes.
+     *
+     * Resolves to `true` when the message was coalesced (enqueued), `false`
+     * when a turn was started.
      */
     private startTurn;
+    private enqueueCoalesced;
+    private clearCoalesced;
+    private formatCoalescedFollowups;
+    private drainCoalescedFollowups;
     private admitTurn;
     /**
      * Cancel the turn in flight for `sessionId` (if any) and wait for it to
@@ -183,9 +210,17 @@ export declare class SessionEngine {
     private interruptActiveTurn;
     /**
      * Abort the in-flight turn without starting a follow-up. Returns whether
-     * a turn was active (or pending abort) when called.
+     * a turn was active (or pending abort) when called. Also clears any
+     * coalesced follow-ups queued behind the session.
      */
     interrupt(sessionId: string): Promise<boolean>;
+    isContinuationBusy(channelId: string, continuationToken: string): Promise<boolean>;
+    /**
+     * Last agent-posted Slack message ts for warm `<slack_thread_delta>`, from
+     * the session's channel state when present.
+     */
+    getContinuationLastBotMessageTs(channelId: string, continuationToken: string): Promise<string | undefined>;
+    interruptContinuation(channelId: string, continuationToken: string): Promise<boolean>;
     /**
      * Local harness cwd for a session: per-send override, else
      * `<agent.local.cwd>/<sessionId>`, else the durable session workspace.