@cursor/july 0.1.40 → 0.1.42

package/dist/internal/ledger-serving.js

@@ -0,0 +1,174 @@
+/**
+ * Ledger-mode serving seam (`serving: "ledger"` on `defineAgent`):
+ * coordination only, no inbox. Every engine `send` acquires the session
+ * lease before its turn runs and commits (head+1, lease released) after
+ * it completes, so cross-pod mutual exclusion, generation fencing, and
+ * the committed head sequence are real.
+ *
+ * **Durability trade-off (deliberate):** there is no durable mailbox.
+ * An event that arrives while the lease is held does NOT park in the
+ * store — the delivering pod waits *in-process*: local concurrent sends
+ * serialize on a per-session promise chain (no claim spinning), and a
+ * lease held by another pod is waited out with bounded claim retries. A
+ * crash therefore loses the in-flight event exactly as resident serving
+ * does. A dead pod's lease simply expires (~30s TTL); the next delivery
+ * claims at generation+1 — no janitor is needed because nothing is
+ * parked.
+ *
+ * Re-entrancy caveat (same shape as resident `waitForCompletion`): a
+ * send issued from *inside* a running turn against the same session
+ * chains behind that turn's serve, so awaiting its resolution from the
+ * turn would deadlock. Fire-and-forget such sends.
+ */
+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 { randomBytes, randomUUID } from "node:crypto";
+import { HEARTBEAT_INTERVAL_MS, LEASE_TTL_MS, LedgerFencedError, } from "../ledger/session-ledger.js";
+import { newContinuationKey } from "./ids.js";
+/** Wait between claim retries while another holder has the lease. */
+export const CLAIM_RETRY_DELAY_MS = 250;
+/**
+ * Give up waiting for the lease after this long — two full lease TTLs,
+ * so a dead holder's expiry (~30s) is always survived with margin.
+ */
+export const CLAIM_WAIT_TIMEOUT_MS = 2 * LEASE_TTL_MS;
+export class LedgerServing {
+    constructor(options) {
+        var _a, _b, _c, _d, _e, _f;
+        /**
+         * Per-ledger-session in-process serialization: local concurrent sends
+         * queue here instead of spinning claim retries against our own lease.
+         */
+        this.chains = new Map();
+        this.ledger = options.ledger;
+        this.deliverTurn = options.deliverTurn;
+        this.logger = (_a = options.logger) !== null && _a !== void 0 ? _a : (() => { });
+        this.heartbeatIntervalMs = (_b = options.heartbeatIntervalMs) !== null && _b !== void 0 ? _b : HEARTBEAT_INTERVAL_MS;
+        this.claimRetryDelayMs = (_c = options.claimRetryDelayMs) !== null && _c !== void 0 ? _c : CLAIM_RETRY_DELAY_MS;
+        this.claimWaitTimeoutMs = (_d = options.claimWaitTimeoutMs) !== null && _d !== void 0 ? _d : CLAIM_WAIT_TIMEOUT_MS;
+        this.clock = (_e = options.clock) !== null && _e !== void 0 ? _e : Date.now;
+        this.sleep = (_f = options.sleep) !== null && _f !== void 0 ? _f : ((ms) => new Promise((resolve) => setTimeout(resolve, ms)));
+    }
+    /** Settle every queued and in-flight delivery. */
+    close() {
+        return __awaiter(this, void 0, void 0, function* () {
+            yield Promise.allSettled([...this.chains.values()]);
+        });
+    }
+    /**
+     * Ledger-mode `send`: resolve the session identity, wait for the
+     * lease (in-process queue first, then cross-pod claim retries), run
+     * the turn, commit. Resolves with the engine session handle after the
+     * commit released the lease.
+     */
+    deliver(channelId, message, options) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a;
+            const continuationToken = (_a = options.continuationToken) !== null && _a !== void 0 ? _a : newContinuationKey();
+            const ensured = yield this.ledger.ensureSession(`${channelId}/${continuationToken}`);
+            return this.enqueue(ensured.session.sessionId, () => this.serveOne(ensured.session.sessionId, {
+                channelId,
+                continuationToken,
+                message,
+                options,
+            }));
+        });
+    }
+    /** Chain a delivery behind the session's in-flight ones. */
+    enqueue(ledgerSessionId, run) {
+        var _a;
+        const prior = (_a = this.chains.get(ledgerSessionId)) !== null && _a !== void 0 ? _a : Promise.resolve();
+        const next = prior.then(() => run(), () => run());
+        this.chains.set(ledgerSessionId, next);
+        void next
+            .catch(() => { })
+            .finally(() => {
+            if (this.chains.get(ledgerSessionId) === next) {
+                this.chains.delete(ledgerSessionId);
+            }
+        });
+        return next;
+    }
+    /** claim (waiting) → resident turn → commit-release. */
+    serveOne(ledgerSessionId, request) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a;
+            const lease = yield this.claimWithWait(ledgerSessionId);
+            let fenced = false;
+            const heartbeat = setInterval(() => {
+                this.ledger.heartbeat(ledgerSessionId, lease.generation).then((result) => {
+                    if (!result.ok) {
+                        fenced = true;
+                    }
+                }, () => {
+                    // Transient KV failure: the next beat retries within the TTL.
+                });
+            }, this.heartbeatIntervalMs);
+            (_a = heartbeat.unref) === null || _a === void 0 ? void 0 : _a.call(heartbeat);
+            try {
+                let handle;
+                try {
+                    handle = yield this.deliverTurn(request);
+                    yield handle.waitForCompletion();
+                }
+                catch (error) {
+                    // The turn never committed; free the session for the next
+                    // delivery instead of making it wait out the TTL. A fenced
+                    // holder's release is a no-op.
+                    yield this.ledger
+                        .release(ledgerSessionId, lease.generation)
+                        .catch(() => { });
+                    throw error;
+                }
+                if (fenced) {
+                    // A new holder took over mid-turn (our lease lapsed). Discard:
+                    // committing would fence anyway, and warm state is now stale.
+                    this.logger(`[ledger] session ${ledgerSessionId} fenced mid-turn (generation ${lease.generation}); discarding without commit`);
+                    throw new LedgerFencedError(`deliver(${ledgerSessionId}): fenced mid-turn at generation ${lease.generation}`);
+                }
+                yield this.ledger.commit(ledgerSessionId, {
+                    generation: lease.generation,
+                    expectedHead: lease.head,
+                    commitId: randomUUID(),
+                });
+                return handle;
+            }
+            finally {
+                clearInterval(heartbeat);
+            }
+        });
+    }
+    /**
+     * Claim the lease, waiting out another holder with bounded retries.
+     * The common waits are short: our own pod's deliveries never reach
+     * here concurrently (the in-process chain serializes them), so a held
+     * lease means another pod is serving — usually for one turn — or died
+     * (expiry unblocks us at ~30s).
+     */
+    claimWithWait(ledgerSessionId) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const start = this.clock();
+            for (;;) {
+                const claim = yield this.ledger.claim(ledgerSessionId);
+                if (claim.claimed) {
+                    return { generation: claim.lease.generation, head: claim.head };
+                }
+                if (this.clock() - start >= this.claimWaitTimeoutMs) {
+                    throw new Error(`ledger serving: session ${ledgerSessionId} is still leased by ${claim.holder} after ${this.claimWaitTimeoutMs}ms; giving up on this delivery`);
+                }
+                yield this.sleep(this.claimRetryDelayMs);
+            }
+        });
+    }
+}
+/** Mint the lease holder id for this process. */
+export function newLedgerPodId() {
+    return `pod_${randomBytes(6).toString("hex")}`;
+}

package/dist/internal/listen-port.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Bind an HTTP server to a port, with a clear next-port path when 3000 (or
+ * whatever was requested) is already taken — a common onboarding failure.
+ */
+import type { Server } from "node:http";
+/** Default listen port for `serve` / `dev` when `--port` is omitted. */
+export declare const DEFAULT_SERVE_PORT = 3000;
+export declare function isAddrInUse(error: unknown): boolean;
+export declare function formatPortInUseHint(port: number): string;
+/**
+ * `server.listen` with fallback when the caller used the default port.
+ * Explicit `--port N` (including `0`) fails immediately with a next-port hint.
+ */
+export declare function listenHttpServer(args: {
+    server: Server;
+    host: string;
+    port: number;
+    /** True when the caller passed `port` (including 0); skip fallback. */
+    portWasExplicit: boolean;
+    logger: (line: string) => void;
+}): Promise<number>;
+//# sourceMappingURL=listen-port.d.ts.map

package/dist/internal/listen-port.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"listen-port.d.ts","sourceRoot":"","sources":["../../src/internal/listen-port.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAGxC,wEAAwE;AACxE,eAAO,MAAM,kBAAkB,OAAO,CAAC;AAKvC,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAOnD;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAMxD;AAED;;;GAGG;AACH,wBAAsB,gBAAgB,CAAC,IAAI,EAAE;IAC3C,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,uEAAuE;IACvE,eAAe,EAAE,OAAO,CAAC;IACzB,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CAChC,GAAG,OAAO,CAAC,MAAM,CAAC,CAyClB"}

package/dist/internal/listen-port.js

@@ -0,0 +1,77 @@
+/**
+ * Bind an HTTP server to a port, with a clear next-port path when 3000 (or
+ * whatever was requested) is already taken — a common onboarding failure.
+ */
+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 { once } from "node:events";
+import { CLI_COMMAND_NAME } from "./distribution.js";
+/** Default listen port for `serve` / `dev` when `--port` is omitted. */
+export const DEFAULT_SERVE_PORT = 3000;
+/** How many ports above the default to try when the default is taken. */
+const DEFAULT_PORT_FALLBACK_SPAN = 20;
+export function isAddrInUse(error) {
+    return (typeof error === "object" &&
+        error !== null &&
+        "code" in error &&
+        error.code === "EADDRINUSE");
+}
+export function formatPortInUseHint(port) {
+    const next = port === 0 ? 3001 : port + 1;
+    return (`port ${port} is already in use. ` +
+        `Try \`${CLI_COMMAND_NAME} dev --port ${next}\` or \`--port 0\` for any free port.`);
+}
+/**
+ * `server.listen` with fallback when the caller used the default port.
+ * Explicit `--port N` (including `0`) fails immediately with a next-port hint.
+ */
+export function listenHttpServer(args) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const { server, host, logger } = args;
+        const startPort = args.port;
+        if (args.portWasExplicit || startPort === 0) {
+            try {
+                server.listen(startPort, host);
+                yield once(server, "listening");
+            }
+            catch (error) {
+                if (isAddrInUse(error)) {
+                    throw new Error(formatPortInUseHint(startPort));
+                }
+                throw error;
+            }
+            const address = server.address();
+            if (address === null || typeof address === "string") {
+                throw new Error("server listening without an address");
+            }
+            return address.port;
+        }
+        const last = startPort + DEFAULT_PORT_FALLBACK_SPAN;
+        for (let port = startPort; port <= last; port++) {
+            try {
+                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)`);
+                }
+                return port;
+            }
+            catch (error) {
+                if (!isAddrInUse(error)) {
+                    throw error;
+                }
+                if (port === last) {
+                    throw new Error(formatPortInUseHint(port));
+                }
+            }
+        }
+        throw new Error(formatPortInUseHint(last));
+    });
+}

package/dist/internal/playground/static.d.ts

@@ -1,5 +1,5 @@
 /**
- * Serves the built Vite playground SPA and the multi-agent index page.
+ * Serves the built Vite playground SPA and the host home page.
  *
  * The playground is a Vite + React app (see `playground/`). `serve` auto-builds
  * `dist/playground/` when the local vite toolchain is present (see
@@ -25,14 +25,31 @@ export declare function playgroundBundleExists(): boolean;
 export declare function renderPlaygroundIndexHtml(baseHref: string): string;
 /** Serve one built asset from `dist/playground/assets/` by filename. */
 export declare function renderPlaygroundAsset(file: string): Response;
-/** One row on the multi-agent index page. */
+/** Slack surface summary for the host home / `GET /v1/agents`. */
+export type AgentIndexSlack = {
+    kind: "cursor-account";
+    handle: string;
+} | {
+    kind: "socket";
+};
+/** One row on the host home page and `GET /v1/agents`. */
 export interface AgentIndexEntry {
     slug: string;
     name: string;
     model: string;
     tools: number;
     channels: number;
+    slack?: AgentIndexSlack;
 }
-/** Standalone index page listing every mounted agent (multi-agent serving). */
-export declare function renderAgentsIndexHtml(agents: AgentIndexEntry[]): string;
+export interface HostHomeOptions {
+    /** When false, omit `/docs` from the route list. Default true. */
+    docs?: boolean;
+    /** Same as the serve host's `multi` — mounts `/v1/agents` + host `/v1/health`. */
+    multi?: boolean;
+}
+/**
+ * Orienting `/` page: mounted agents (playground links) plus live host routes.
+ * Used for both single-agent (empty slug) and multi-agent mounts.
+ */
+export declare function renderAgentsIndexHtml(agents: AgentIndexEntry[], options?: HostHomeOptions): string;
 //# sourceMappingURL=static.d.ts.map

package/dist/internal/playground/static.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"static.d.ts","sourceRoot":"","sources":["../../../src/internal/playground/static.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAcH,iFAAiF;AACjF,eAAO,MAAM,oBAAoB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAiBvD,CAAC;AAEF,uEAAuE;AACvE,wBAAgB,sBAAsB,IAAI,OAAO,CAEhD;AAED;;;;;;;GAOG;AACH,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAUlE;AAED,wEAAwE;AACxE,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,CAsB5D;AAED,6CAA6C;AAC7C,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,+EAA+E;AAC/E,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,eAAe,EAAE,GAAG,MAAM,CAiBvE"}
+{"version":3,"file":"static.d.ts","sourceRoot":"","sources":["../../../src/internal/playground/static.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAcH,iFAAiF;AACjF,eAAO,MAAM,oBAAoB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAiBvD,CAAC;AAEF,uEAAuE;AACvE,wBAAgB,sBAAsB,IAAI,OAAO,CAEhD;AAED;;;;;;;GAOG;AACH,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAUlE;AAED,wEAAwE;AACxE,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,CAsB5D;AAED,kEAAkE;AAClE,MAAM,MAAM,eAAe,GACvB;IAAE,IAAI,EAAE,gBAAgB,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAC1C;IAAE,IAAI,EAAE,QAAQ,CAAA;CAAE,CAAC;AAEvB,0DAA0D;AAC1D,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,eAAe,CAAC;CACzB;AAED,MAAM,WAAW,eAAe;IAC9B,kEAAkE;IAClE,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,kFAAkF;IAClF,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,eAAe,EAAE,EACzB,OAAO,GAAE,eAAoB,GAC5B,MAAM,CAgCR"}

package/dist/internal/playground/static.js

@@ -1,5 +1,5 @@
 /**
- * Serves the built Vite playground SPA and the multi-agent index page.
+ * Serves the built Vite playground SPA and the host home page.
  *
  * The playground is a Vite + React app (see `playground/`). `serve` auto-builds
  * `dist/playground/` when the local vite toolchain is present (see
@@ -83,19 +83,70 @@ export function renderPlaygroundAsset(file) {
         },
     });
 }
-/** Standalone index page listing every mounted agent (multi-agent serving). */
-export function renderAgentsIndexHtml(agents) {
+/**
+ * Orienting `/` page: mounted agents (playground links) plus live host routes.
+ * Used for both single-agent (empty slug) and multi-agent mounts.
+ */
+export function renderAgentsIndexHtml(agents, options = {}) {
+    const docs = options.docs !== false;
+    const multi = options.multi === true;
     const cards = agents
         .map((agent) => {
+        const playground = agent.slug === "" ? "/playground" : `/${agent.slug}/playground`;
+        const slugLabel = agent.slug === "" ? "/" : `/${agent.slug}`;
         const meta = `${agent.model || "—"} · ${agent.tools} tool${agent.tools === 1 ? "" : "s"} · ${agent.channels} channel${agent.channels === 1 ? "" : "s"}`;
-        return `      <a class="card" href="/${escapeHtml(agent.slug)}/playground">
+        return `      <a class="card" href="${escapeHtml(playground)}">
         <div class="card-name">${escapeHtml(agent.name)}</div>
-        <div class="card-slug">/${escapeHtml(agent.slug)}</div>
+        <div class="card-slug">${escapeHtml(slugLabel)} → playground</div>
         <div class="card-meta">${escapeHtml(meta)}</div>
       </a>`;
     })
         .join("\n");
-    return AGENTS_INDEX_TEMPLATE.replace("<!--CARDS-->", cards || '      <div class="card-meta">No agents mounted.</div>').replace("<!--COUNT-->", String(agents.length));
+    const routes = hostRouteRows(agents, docs, multi)
+        .map((row) => `        <tr><td><a href="${escapeHtml(row.href)}"><code>${escapeHtml(row.path)}</code></a></td><td>${escapeHtml(row.blurb)}</td></tr>`)
+        .join("\n");
+    return HOST_HOME_TEMPLATE.replace("<!--CARDS-->", cards || '      <div class="card-meta">No agents mounted.</div>')
+        .replace("<!--COUNT-->", String(agents.length))
+        .replace("<!--ROUTES-->", routes);
+}
+function hostRouteRows(agents, docs, multi) {
+    const rows = [
+        { path: "/", href: "/", blurb: "This page" },
+    ];
+    for (const agent of agents) {
+        const base = agent.slug === "" ? "" : `/${agent.slug}`;
+        const label = agent.slug === "" ? agent.name : agent.slug;
+        rows.push({
+            path: `${base}/playground`,
+            href: `${base}/playground`,
+            blurb: `Playground — ${label}`,
+        });
+        rows.push({
+            path: `${base}/v1/health`,
+            href: `${base}/v1/health`,
+            blurb: `Health — ${label}`,
+        });
+    }
+    if (multi) {
+        rows.push({
+            path: "/v1/agents",
+            href: "/v1/agents",
+            blurb: "JSON index of mounted agents",
+        });
+        rows.push({
+            path: "/v1/health",
+            href: "/v1/health",
+            blurb: "Host liveness",
+        });
+    }
+    if (docs) {
+        rows.push({
+            path: "/docs",
+            href: "/docs/",
+            blurb: "Agent SDK documentation",
+        });
+    }
+    return rows;
 }
 function escapeHtml(value) {
     return value
@@ -111,7 +162,7 @@ function fallbackHtml(baseHref) {
     <base href="${escapeHtml(baseHref)}" />
     <meta charset="utf-8" />
     <meta name="viewport" content="width=device-width, initial-scale=1" />
-    <title>agent-serve playground</title>
+    <title>agent-sdk playground</title>
     <style>
       body { margin: 0; background: #0e1116; color: #e6edf3; font: 14px/1.6 ui-sans-serif, system-ui, sans-serif; }
       .box { max-width: 640px; margin: 64px auto; padding: 0 24px; }
@@ -124,7 +175,7 @@ function fallbackHtml(baseHref) {
     <div class="box">
       <h1>Playground bundle not built</h1>
       <p>
-        The Vite playground has not been built yet. <code>agent-serve serve</code>
+        The Vite playground has not been built yet. <code>agent-sdk serve</code>
         auto-builds it when the local vite toolchain is available; otherwise run
         <code>pnpm run build:playground</code> from <code>packages/agent-serve</code>,
         or <code>pnpm run dev:playground</code> for Vite HMR.
@@ -133,33 +184,46 @@ function fallbackHtml(baseHref) {
   </body>
 </html>`;
 }
-const AGENTS_INDEX_TEMPLATE = `<!doctype html>
+const HOST_HOME_TEMPLATE = `<!doctype html>
 <html lang="en">
   <head>
     <meta charset="utf-8" />
     <meta name="viewport" content="width=device-width, initial-scale=1" />
-    <title>agent-serve — agents</title>
+    <title>Agent SDK</title>
     <style>
       :root { color-scheme: dark; }
       body { margin: 0; background: #0e1116; color: #e6edf3; font: 14px/1.6 ui-sans-serif, system-ui, -apple-system, sans-serif; }
-      .agents-wrap { max-width: 880px; margin: 0 auto; padding: 48px 24px; }
-      .agents-wrap h1 { font-size: 20px; font-weight: 650; margin: 0 0 2px; }
-      .agents-wrap .sub { color: #8b949e; font-size: 13px; margin-bottom: 28px; }
-      .agents-grid { display: grid; grid-template-columns: repeat(auto-fill, minmax(240px, 1fr)); gap: 14px; }
+      .wrap { max-width: 880px; margin: 0 auto; padding: 48px 24px; }
+      h1 { font-size: 20px; font-weight: 650; margin: 0 0 2px; }
+      h2 { font-size: 13px; font-weight: 600; text-transform: uppercase; letter-spacing: 0.04em; color: #8b949e; margin: 36px 0 12px; }
+      .sub { color: #8b949e; font-size: 13px; margin-bottom: 28px; }
+      .grid { display: grid; grid-template-columns: repeat(auto-fill, minmax(240px, 1fr)); gap: 14px; }
       .card { display: block; text-decoration: none; color: inherit; background: #161b22; border: 1px solid #30363d; border-radius: 12px; padding: 16px 18px; transition: border-color 0.12s; }
       .card:hover { border-color: #6cb6ff; }
       .card-name { font-size: 15px; font-weight: 600; }
       .card-slug { font-family: ui-monospace, monospace; font-size: 12px; color: #6cb6ff; margin-top: 2px; }
       .card-meta { color: #6e7681; font-size: 12px; margin-top: 10px; }
+      table.routes { width: 100%; border-collapse: collapse; font-size: 13px; }
+      table.routes td { padding: 8px 0; border-bottom: 1px solid #21262d; vertical-align: top; }
+      table.routes td:first-child { width: 42%; padding-right: 16px; }
+      table.routes code { font-family: ui-monospace, monospace; font-size: 12px; color: #6cb6ff; }
+      table.routes a { text-decoration: none; }
+      table.routes a:hover code { text-decoration: underline; }
+      .muted { color: #8b949e; }
     </style>
   </head>
   <body>
-    <div class="agents-wrap">
-      <h1>agent-serve</h1>
-      <div class="sub"><!--COUNT--> agents mounted</div>
-      <div class="agents-grid">
+    <div class="wrap">
+      <h1>Agent SDK</h1>
+      <div class="sub"><!--COUNT--> agent(s) on this host. Open a playground or use a route below.</div>
+      <h2>Agents</h2>
+      <div class="grid">
 <!--CARDS-->
       </div>
+      <h2>Routes</h2>
+      <table class="routes">
+<!--ROUTES-->
+      </table>
     </div>
   </body>
 </html>`;

package/dist/internal/sdk-runner.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sdk-runner.d.ts","sourceRoot":"","sources":["../../src/internal/sdk-runner.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAOL,KAAK,eAAe,EACpB,KAAK,cAAc,EACnB,KAAK,SAAS,EAEf,MAAM,aAAa,CAAC;AACrB,OAAO,EAEL,KAAK,YAAY,EAEjB,KAAK,iBAAiB,EACtB,KAAK,WAAW,EAEjB,MAAM,aAAa,CAAC;AAGrB,2EAA2E;AAC3E,MAAM,WAAW,WAAW;IAC1B,OAAO,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IAC1D;;;;;OAKG;IACH,OAAO,CAAC,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;IACjE,OAAO,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3B;AAED;;;;GAIG;AACH,MAAM,MAAM,oBAAoB,GAAG,IAAI,CACrC,iBAAiB,EACf,cAAc,GACd,gBAAgB,GAChB,SAAS,GACT,YAAY,GACZ,WAAW,GACX,OAAO,CACV,CAAC;AAEF,6EAA6E;AAC7E,MAAM,MAAM,cAAc,GACtB;IAAE,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAA;CAAE,GACzB;IAAE,QAAQ,CAAC,MAAM,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAcxD,MAAM,WAAW,sBAAsB;IACrC,6EAA6E;IAC7E,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;;OAIG;IACH,KAAK,CAAC,EAAE,eAAe,CAAC;IACxB,6DAA6D;IAC7D,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CACjC;AAwBD;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAKvE;AAED,qBAAa,eAAgB,YAAW,WAAW;IAKrC,OAAO,CAAC,QAAQ,CAAC,OAAO;IAJpC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAwC;IAC/D,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA+C;IACtE,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAkC;IAElE,YAA6B,OAAO,GAAE,sBAA2B,EAAI;IAE/D,OAAO,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,WAAW,CAAC,CAkC9D;YAEa,cAAc;IAmF5B;;;;OAIG;IACG,OAAO,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,cAAc,CAAC,CAepE;IAEK,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAY7B;IAED,OAAO,CAAC,QAAQ;IA0BhB;;;;OAIG;IACH,OAAO,CAAC,UAAU;IASlB,OAAO,CAAC,GAAG;IAIX,OAAO,CAAC,aAAa;IAUrB,OAAO,CAAC,kBAAkB;IAc1B;;;OAGG;YACW,iBAAiB;YAkBjB,SAAS;YAOT,cAAc;YA6Bd,cAAc;IA6C5B,OAAO,CAAC,QAAQ;CAUjB;AAED,4EAA4E;AAC5E,wBAAgB,0BAA0B,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAE9D;AAED;;;;;GAKG;AACH,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,MAAM,GACd,OAAO,CAMT;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,YAAY,GAAG,cAAc,CAQpE;AAwGD,wBAAgB,eAAe,CAAC,MAAM,EAAE,IAAI,CAAC,SAAS,EAAE,OAAO,CAAC,GAAG,MAAM,CAExE"}
+{"version":3,"file":"sdk-runner.d.ts","sourceRoot":"","sources":["../../src/internal/sdk-runner.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAOL,KAAK,eAAe,EACpB,KAAK,cAAc,EACnB,KAAK,SAAS,EAEf,MAAM,aAAa,CAAC;AACrB,OAAO,EAEL,KAAK,YAAY,EAEjB,KAAK,iBAAiB,EACtB,KAAK,WAAW,EAEjB,MAAM,aAAa,CAAC;AAGrB,2EAA2E;AAC3E,MAAM,WAAW,WAAW;IAC1B,OAAO,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IAC1D;;;;;OAKG;IACH,OAAO,CAAC,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;IACjE,OAAO,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3B;AAED;;;;GAIG;AACH,MAAM,MAAM,oBAAoB,GAAG,IAAI,CACrC,iBAAiB,EACf,cAAc,GACd,gBAAgB,GAChB,SAAS,GACT,YAAY,GACZ,WAAW,GACX,OAAO,CACV,CAAC;AAEF,6EAA6E;AAC7E,MAAM,MAAM,cAAc,GACtB;IAAE,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAA;CAAE,GACzB;IAAE,QAAQ,CAAC,MAAM,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAcxD,MAAM,WAAW,sBAAsB;IACrC,6EAA6E;IAC7E,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;;OAIG;IACH,KAAK,CAAC,EAAE,eAAe,CAAC;IACxB,6DAA6D;IAC7D,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CACjC;AAwBD;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAKvE;AAED,qBAAa,eAAgB,YAAW,WAAW;IAKrC,OAAO,CAAC,QAAQ,CAAC,OAAO;IAJpC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAwC;IAC/D,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA+C;IACtE,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAkC;IAElE,YAA6B,OAAO,GAAE,sBAA2B,EAAI;IAE/D,OAAO,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,WAAW,CAAC,CAkC9D;YAEa,cAAc;IA6F5B;;;;OAIG;IACG,OAAO,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,cAAc,CAAC,CAepE;IAEK,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAY7B;IAED,OAAO,CAAC,QAAQ;IA0BhB;;;;OAIG;IACH,OAAO,CAAC,UAAU;IASlB,OAAO,CAAC,GAAG;IAIX,OAAO,CAAC,aAAa;IAUrB,OAAO,CAAC,kBAAkB;IAc1B;;;OAGG;YACW,iBAAiB;YAkBjB,SAAS;YAOT,cAAc;YA6Bd,cAAc;IA6C5B,OAAO,CAAC,QAAQ;CAUjB;AAED,4EAA4E;AAC5E,wBAAgB,0BAA0B,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAE9D;AAED;;;;;GAKG;AACH,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,MAAM,GACd,OAAO,CAMT;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,YAAY,GAAG,cAAc,CAQpE;AAwGD,wBAAgB,eAAe,CAAC,MAAM,EAAE,IAAI,CAAC,SAAS,EAAE,OAAO,CAAC,GAAG,MAAM,CAExE"}

package/dist/internal/sdk-runner.js

@@ -90,7 +90,16 @@ export class CursorSdkRunner {
             const agentPromise = this.getAgent(request);
             try {
                 const agent = yield agentPromise;
-                const run = yield agent.send(request.prompt, Object.assign({ onDelta: (_a) => __awaiter(this, [_a], void 0, function* ({ update }) {
+                const sendMessage = request.images !== undefined && request.images.length > 0
+                    ? {
+                        text: request.prompt,
+                        images: request.images.map((image) => ({
+                            data: image.data,
+                            mimeType: image.mimeType,
+                        })),
+                    }
+                    : request.prompt;
+                const run = yield agent.send(sendMessage, Object.assign({ onDelta: (_a) => __awaiter(this, [_a], void 0, function* ({ update }) {
                         try {
                             yield request.onUpdate(update);
                         }

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;AA4BH,OAAO,KAAK,EACV,YAAY,EACZ,gBAAgB,EAOhB,YAAY,EACb,MAAM,aAAa,CAAC;AAoGrB,OAAO,EAAE,KAAK,WAAW,EAAmB,MAAM,iBAAiB,CAAC;AAiBpE,8EAA8E;AAC9E,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,YAAY,CAAC;CACvB;AAaD,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,CAmuB3B"}
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/internal/server.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AA4BH,OAAO,KAAK,EACV,YAAY,EACZ,gBAAgB,EAOhB,YAAY,EACb,MAAM,aAAa,CAAC;AAqGrB,OAAO,EAAE,KAAK,WAAW,EAAmB,MAAM,iBAAiB,CAAC;AAiBpE,8EAA8E;AAC9E,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,YAAY,CAAC;CACvB;AAaD,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,CAgtB3B"}