@cursor/july 0.1.2 → 0.1.4

package/dist/internal/server.js

@@ -42,7 +42,7 @@ import { assertSlackCursorAgentName } from "../channels/slack/types.js";
 import { allowAll, bearerAuth, localDevStrict } from "../channels.js";
 import { CursorAccountMcpBridge, collectCursorAccountConnections, cursorAccountMcpPath, } from "./cursor/account-mcp.js";
 import { CursorBackendClient } from "./cursor/backend-client.js";
-import { cursorBackendUrl, resolveApiKey, SIGN_IN_HINT, } from "./cursor/credentials.js";
+import { cursorBackendUrl, cursorExternalApiUrl, resolveApiKey, SIGN_IN_HINT, } from "./cursor/credentials.js";
 import { CursorGithubCredentialProvider } from "./cursor/github-credentials.js";
 import { CursorEventRelay, formatCursorScmEventLog, scmMetadataToGitHubPayload, } from "./cursor-event-relay.js";
 import { CursorSlackRelay, createCursorSlackApiCaller, formatCursorSlackEventLog, } from "./cursor-slack-relay.js";
@@ -120,10 +120,13 @@ export function startServer(mounts_1) {
                 throw new Error("githubChannel({ cursorAccount: true }) could not resolve Cursor event authentication.");
             }
             if (options.allowAnonymous === true) {
-                throw new Error("githubChannel({ cursorAccount: true }) cannot be served with --allow-anonymous because admitted callers could use the signed-in account's GitHub access.");
+                if (options.allowAnonymousCursorGithub !== true) {
+                    throw new Error("githubChannel({ cursorAccount: true }) cannot be served with --allow-anonymous because admitted callers could use the signed-in account's GitHub access. If every admitted caller is trusted (e.g. behind an SSO proxy), opt in with --allow-anonymous-cursor-github.");
+                }
+                logger("[agentkit] warning: --allow-anonymous-cursor-github — every admitted HTTP caller can drive sessions holding the signed-in account's repo-scoped GitHub credential; serve this only behind a trusted boundary (e.g. an SSO proxy)");
             }
             if (cursorGithubConfig.scope.permissions === "contents-write") {
-                logger('[agent-serve] warning: Cursor GitHub credentials include contents:write — the host holds a push-capable token shared with model-driven tools and untrusted webhook content; prefer permissions: "pr-write" unless this agent must push code');
+                logger('[agentkit] warning: Cursor GitHub credentials include contents:write — the host holds a push-capable token shared with model-driven tools and untrusted webhook content; prefer permissions: "pr-write" unless this agent must push code');
             }
             const provider = new CursorGithubCredentialProvider({
                 client: new CursorBackendClient({
@@ -158,7 +161,7 @@ export function startServer(mounts_1) {
             yield ensureDocsSiteBundle(logger);
         }
         if (options.allowAnonymous === true) {
-            logger("[agent-serve] warning: --allow-anonymous admits every HTTP caller as the same principal; use only on a trusted network (e.g. Tailscale) and prefer --bearer-token for shared hosts");
+            logger("[agentkit] warning: --allow-anonymous admits every HTTP caller as the same principal; use only on a trusted network (e.g. Tailscale) and prefer --bearer-token for shared hosts");
         }
         const runner = (_l = options.runner) !== null && _l !== void 0 ? _l : new CursorSdkRunner(accountKey === undefined ? {} : { apiKey: accountKey.apiKey });
         const router = new Router();
@@ -276,7 +279,7 @@ export function startServer(mounts_1) {
                         yield definition.onStart(startArgs);
                     }
                     catch (error) {
-                        logger(`[agent-serve] channel "${channel.id}" onStart failed: ${error instanceof Error
+                        logger(`[agentkit] channel "${channel.id}" onStart failed: ${error instanceof Error
                             ? ((_o = error.stack) !== null && _o !== void 0 ? _o : error.message)
                             : String(error)}`);
                     }
@@ -564,7 +567,7 @@ export function startServer(mounts_1) {
                         yield stop();
                     }
                     catch (error) {
-                        logger(`[agent-serve] channel onStop failed: ${error instanceof Error
+                        logger(`[agentkit] channel onStop failed: ${error instanceof Error
                             ? ((_a = error.stack) !== null && _a !== void 0 ? _a : error.message)
                             : String(error)}`);
                     }
@@ -1037,14 +1040,17 @@ function mountAgentRoutes(router, runtime, args) {
  * serve instead of starting with a relay that could never run.
  */
 function requireCursorEventsAuth(config, accountKey) {
-    var _a, _b, _c, _d;
+    var _a, _b, _c;
     const apiKey = ((_b = (_a = config.apiKey) !== null && _a !== void 0 ? _a : accountKey === null || accountKey === void 0 ? void 0 : accountKey.apiKey) !== null && _b !== void 0 ? _b : "").trim();
     if (apiKey === "") {
-        throw new Error(`[agent-serve] --cursor-events (serve({ cursorEvents })) requires a signed-in Cursor account: the SCM event stream is read as the host's user. ${SIGN_IN_HINT}`);
+        throw new Error(`[agentkit] --cursor-events (serve({ cursorEvents })) requires a signed-in Cursor account: the SCM event stream is read as the host's user. ${SIGN_IN_HINT}`);
     }
     return {
         apiKey,
-        baseUrl: (_d = (_c = config.baseUrl) !== null && _c !== void 0 ? _c : accountKey === null || accountKey === void 0 ? void 0 : accountKey.backendUrl) !== null && _d !== void 0 ? _d : cursorBackendUrl(),
+        // `/v0/scm-events/*` lives on the external API (api.cursor.com), not
+        // api2. Prefer that default over the account key's backendUrl, which
+        // follows cursorBackendUrl() (api2) when CURSOR_API_KEY is set.
+        baseUrl: (_c = config.baseUrl) !== null && _c !== void 0 ? _c : cursorExternalApiUrl(),
     };
 }
 /**
@@ -1061,13 +1067,13 @@ function startCursorEventRelay(input) {
     }
     const repos = [...new Set(config.repos.map((repo) => repo.trim()))].filter((repo) => repo.length > 0);
     if (repos.length === 0) {
-        logger("[agent-serve] cursor-events: no repos configured (pass --repo owner/name); relay disabled");
+        logger("[agentkit] cursor-events: no repos configured (pass --repo owner/name); relay disabled");
         return undefined;
     }
     const githubTargets = findGitHubChannelTargets(mounts);
     const events = [...new Set(githubTargets.flatMap((target) => target.events))];
     if (events.length === 0) {
-        logger("[agent-serve] cursor-events: no mounted agent declares a github channel; relay disabled");
+        logger("[agentkit] cursor-events: no mounted agent declares a github channel; relay disabled");
         return undefined;
     }
     const baseStateRoot = stateRoot !== null && stateRoot !== void 0 ? stateRoot : join((_b = (_a = mounts[0]) === null || _a === void 0 ? void 0 : _a.project.rootDir) !== null && _b !== void 0 ? _b : process.cwd(), ".agent-serve");
@@ -1104,11 +1110,11 @@ function startCursorEventRelay(input) {
             const outcomes = result.targets
                 .map((target) => `${target.slug || "default"}:${target.status}`)
                 .join(", ");
-            logger(`[agent-serve] cursor-events: dispatched ${formatCursorScmEventLog(event)}${outcomes === "" ? "" : ` → ${outcomes}`}`);
+            logger(`[agentkit] cursor-events: dispatched ${formatCursorScmEventLog(event)}${outcomes === "" ? "" : ` → ${outcomes}`}`);
         }),
     });
     relay.start();
-    logger(`[agent-serve] cursor-events: relaying ${events.length} event kind(s) for ${repos.join(", ")} from ${auth.baseUrl}`);
+    logger(`[agentkit] cursor-events: relaying ${events.length} event kind(s) for ${repos.join(", ")} from ${auth.baseUrl}`);
     return relay;
 }
 function collectCursorGithubTargets(mounts) {
@@ -1238,7 +1244,7 @@ function startCursorSlackRelay(input) {
                     runtime: target.runtime,
                     channelId: target.channelId,
                 });
-                logger(`[agent-serve] cursor-slack: dispatching ${formatCursorSlackEventLog(envelope)} → ${target.runtime.slug || "default"}`);
+                logger(`[agentkit] cursor-slack: dispatching ${formatCursorSlackEventLog(envelope)} → ${target.runtime.slug || "default"}`);
                 yield dispatchCursorSlackEnvelope({
                     runtime: target.accountRuntime,
                     envelope,
@@ -1260,7 +1266,7 @@ function startCursorSlackRelay(input) {
             }));
         }
         relay.start();
-        logger(`[agent-serve] cursor-slack: relaying Slack for ${targets
+        logger(`[agentkit] cursor-slack: relaying Slack for ${targets
             .map((target) => `${target.agentName} (${target.runtime.slug || "default"})`)
             .join(", ")} from ${baseUrl} — mention "@Cursor <agent name> …" in the linked workspace`);
         return relay;
@@ -1325,7 +1331,7 @@ function handleRequest(router, req, res, logger) {
                 response = errorResponse(403, "forbidden", error.message);
             }
             else {
-                logger(`[agent-serve] request failed: ${error instanceof Error
+                logger(`[agentkit] request failed: ${error instanceof Error
                     ? ((_c = error.stack) !== null && _c !== void 0 ? _c : error.message)
                     : String(error)}`);
                 response = errorResponse(500, "internal_error", "Internal server error.");
@@ -1335,7 +1341,7 @@ function handleRequest(router, req, res, logger) {
             yield writeFetchResponse(response, res, method);
         }
         catch (error) {
-            logger(`[agent-serve] response write failed: ${error instanceof Error ? error.message : String(error)}`);
+            logger(`[agentkit] response write failed: ${error instanceof Error ? error.message : String(error)}`);
             res.destroy();
         }
     });

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

@@ -13,7 +13,7 @@ import type { AgentRunner } from "./sdk-runner.js";
 import { SessionStore } from "./session-store.js";
 import { StorageCoordinator } from "./storage-coordinator.js";
 export declare const HTTP_CHANNEL_ID = "http";
-export declare const SCHEDULE_CHANNEL_PREFIX = "schedule:";
+export { SCHEDULE_CHANNEL_PREFIX } from "./prompt-context.js";
 export declare class SessionBusyError extends Error {
     constructor(sessionId: string);
 }

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

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

package/dist/internal/session-engine.js

@@ -37,19 +37,21 @@ import { buildABSnapshot } from "./ab-snapshot.js";
 import { ApprovalGate } from "./approval-gate.js";
 import { samePrincipal } from "./auth.js";
 import { mergeCloudOptions, resolveSessionRuntime } from "./cloud-merge.js";
+import { isDevMode } from "./dev-mode.js";
 import { EventLogStore } from "./event-log.js";
 import { TurnEventMapper } from "./event-mapper.js";
 import { createHostPlatforms } from "./host-platforms.js";
 import { formatContinuationToken, newContinuationKey, newSessionId, newToolCallId, } from "./ids.js";
 import { validateToolInput } from "./json-schema.js";
 import { McpHost } from "./mcp-host.js";
+import { buildIdentitySection, buildSessionContextBlock, SCHEDULE_CHANNEL_PREFIX, } from "./prompt-context.js";
 import { assertCloudCanHonorAccountServersFilters } from "./resolved-connections.js";
 import { SessionStore } from "./session-store.js";
 import { StorageCoordinator } from "./storage-coordinator.js";
 import { normalizeToolResult, toolCallErrorMessage } from "./tool-result.js";
 import { buildAgentToolsCatalog, materializeWorkspace, writeWorkspaceFiles, } from "./workspace.js";
 export const HTTP_CHANNEL_ID = "http";
-export const SCHEDULE_CHANNEL_PREFIX = "schedule:";
+export { SCHEDULE_CHANNEL_PREFIX } from "./prompt-context.js";
 export class SessionBusyError extends Error {
     constructor(sessionId) {
         super(`Session ${sessionId} already has a running turn; wait for session.waiting before sending a follow-up`);
@@ -131,7 +133,7 @@ export class SessionEngine {
         this.runner = options.runner;
         this.logger = (_c = options.logger) !== null && _c !== void 0 ? _c : (() => { });
         this.sessions = new SessionStore(join(options.stateRoot, "sessions"));
-        this.logs = new EventLogStore((sessionId) => this.sessions.eventFilePath(sessionId), (sessionId, error) => this.logger(`[agent-serve] failed to persist events for ${sessionId}: ${describeError(error)}`));
+        this.logs = new EventLogStore((sessionId) => this.sessions.eventFilePath(sessionId), (sessionId, error) => this.logger(`[agentkit] failed to persist events for ${sessionId}: ${describeError(error)}`));
         this.storage =
             options.project.storage === undefined
                 ? undefined
@@ -286,7 +288,7 @@ export class SessionEngine {
                     }
                 }
                 catch (error) {
-                    this.logger(`[agent-serve] ab "${experiment.name}" enrollment failed (sticky skip): ${describeError(error)}`);
+                    this.logger(`[agentkit] ab "${experiment.name}" enrollment failed (sticky skip): ${describeError(error)}`);
                     variant = null;
                 }
                 abs[experiment.name] = variant;
@@ -509,7 +511,7 @@ export class SessionEngine {
                     this.queueDispatch(sessionId, event);
                 }
                 catch (error) {
-                    this.logger(`[agent-serve] failed to record event for ${sessionId}: ${describeError(error)}`);
+                    this.logger(`[agentkit] failed to record event for ${sessionId}: ${describeError(error)}`);
                 }
             };
             const mapper = new TurnEventMapper(emit);
@@ -537,7 +539,10 @@ export class SessionEngine {
                     // Yield so the HTTP NDJSON writer can flush tool start/result
                     // events while sibling parallel tools are still executing.
                     if (update.type === "tool-call-started" ||
-                        update.type === "tool-call-completed") {
+                        update.type === "tool-call-completed" ||
+                        // Nested subagent progress (newer SDKs); string check keeps
+                        // typecheck green against older published `@cursor/sdk` pins.
+                        update.type === "tool-call-delta") {
                         yield yieldEventLoop();
                     }
                 }), signal);
@@ -601,8 +606,8 @@ export class SessionEngine {
         });
     }
     buildTurnRequest(record, agent, turnId, prompt, isFirstTurn, emit, onUpdate, signal) {
-        var _a;
-        var _b;
+        var _a, _b, _c;
+        var _d;
         // Per-session cloud attach (channel/tool handoff) forces cloud runtime
         // even when the agent defaults to local for chat server tools.
         const runtime = resolveSessionRuntime({
@@ -616,14 +621,24 @@ export class SessionEngine {
             })
             : undefined;
         let turnPrompt = prompt;
+        if (isFirstTurn) {
+            const contextBlock = buildSessionContextBlock({
+                sessionId: record.sessionId,
+                channelId: record.channelId,
+                channelKind: (_b = (_a = this.channelsById.get(record.channelId)) === null || _a === void 0 ? void 0 : _a.meta) === null || _b === void 0 ? void 0 : _b.kind,
+                environment: isDevMode() ? "local dev server" : "hosted deployment",
+            });
+            turnPrompt = `${contextBlock}\n\n${prompt}`;
+        }
         if (runtime === "cloud" && isFirstTurn) {
             const preamble = [
-                (_b = (_a = agent.instructions) === null || _a === void 0 ? void 0 : _a.trim()) !== null && _b !== void 0 ? _b : "",
+                (_d = (_c = agent.instructions) === null || _c === void 0 ? void 0 : _c.trim()) !== null && _d !== void 0 ? _d : "",
+                buildIdentitySection(agent),
                 buildAgentToolsCatalog(agent.tools, { includeScripts: true }),
             ]
                 .filter((part) => part !== "")
                 .join("\n\n");
-            turnPrompt = preamble === "" ? prompt : `${preamble}\n\n${prompt}`;
+            turnPrompt = `${preamble}\n\n${turnPrompt}`;
         }
         return Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign({ sessionId: record.sessionId }, (record.sdkAgentId === undefined
             ? {}
@@ -1026,7 +1041,7 @@ export class SessionEngine {
         const next = chain
             .then(() => this.dispatchEvent(sessionId, event))
             .catch((error) => {
-            this.logger(`[agent-serve] event dispatch failed for ${sessionId}: ${describeError(error)}`);
+            this.logger(`[agentkit] event dispatch failed for ${sessionId}: ${describeError(error)}`);
         })
             .then(() => {
             var _a;
@@ -1067,7 +1082,7 @@ export class SessionEngine {
                         yield handler(event, channelCtx, sessionCtx);
                     }
                     catch (error) {
-                        this.logger(`[agent-serve] channel "${record.channelId}" handler for ${event.type} threw: ${describeError(error)}`);
+                        this.logger(`[agentkit] channel "${record.channelId}" handler for ${event.type} threw: ${describeError(error)}`);
                     }
                 }
                 // Handlers mutate channel state in place; persist after each batch.
@@ -1093,7 +1108,7 @@ export class SessionEngine {
                         });
                     }
                     catch (error) {
-                        this.logger(`[agent-serve] hook "${hook.name}" handler for ${event.type} threw: ${describeError(error)}`);
+                        this.logger(`[agentkit] hook "${hook.name}" handler for ${event.type} threw: ${describeError(error)}`);
                     }
                 }
             }
@@ -1207,7 +1222,7 @@ export class SessionEngine {
                     });
                 }
                 catch (error) {
-                    this.logger(`[agent-serve] ab persistSnapshots.save threw: ${describeError(error)}`);
+                    this.logger(`[agentkit] ab persistSnapshots.save threw: ${describeError(error)}`);
                 }
             }
             else {
@@ -1373,7 +1388,7 @@ export class SessionEngine {
                 yield this.runBulkRestore(storage, policy);
             }
             catch (error) {
-                this.logger(`[agent-serve] session restore failed: ${describeError(error)}`);
+                this.logger(`[agentkit] session restore failed: ${describeError(error)}`);
             }
         });
     }
@@ -1418,7 +1433,7 @@ export class SessionEngine {
                         return { record, events };
                     }
                     catch (error) {
-                        this.logger(`[agent-serve] failed to restore session ${record.sessionId}: ${describeError(error)}`);
+                        this.logger(`[agentkit] failed to restore session ${record.sessionId}: ${describeError(error)}`);
                         return undefined;
                     }
                 })));
@@ -1433,7 +1448,7 @@ export class SessionEngine {
                     const bytes = Buffer.byteLength(JSON.stringify(item.record), "utf8") +
                         (ndjson === undefined ? 0 : Buffer.byteLength(ndjson, "utf8"));
                     if (bytes > budget) {
-                        this.logger(`[agent-serve] session restore stopped at the ${policy.maxTotalBytes}-byte budget after ${restored} session(s); remaining sessions restore lazily on resume`);
+                        this.logger(`[agentkit] session restore stopped at the ${policy.maxTotalBytes}-byte budget after ${restored} session(s); remaining sessions restore lazily on resume`);
                         break outer;
                     }
                     try {
@@ -1442,12 +1457,12 @@ export class SessionEngine {
                         restored += 1;
                     }
                     catch (error) {
-                        this.logger(`[agent-serve] failed to restore session ${item.record.sessionId}: ${describeError(error)}`);
+                        this.logger(`[agentkit] failed to restore session ${item.record.sessionId}: ${describeError(error)}`);
                     }
                 }
             }
             if (restored > 0) {
-                this.logger(`[agent-serve] restored ${restored} session(s) from storage`);
+                this.logger(`[agentkit] restored ${restored} session(s) from storage`);
             }
         });
     }
@@ -1488,7 +1503,7 @@ export class SessionEngine {
             }
             const events = yield storage.listSessionEvents(record.sessionId);
             yield this.materializeSession(record, eventsNdjson(events));
-            this.logger(`[agent-serve] lazily restored session ${record.sessionId} from storage`);
+            this.logger(`[agentkit] lazily restored session ${record.sessionId} from storage`);
             return record;
         });
     }

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

@@ -0,0 +1,34 @@
+/**
+ * Session list / event fetch for CLI (`sessions`, `session`, chat reattach).
+ *
+ * Customer-facing errors never include hosting URLs or infra jargon.
+ */
+import type { SessionEvent, SessionSummary } from "../types.js";
+import { type RequestAuth } from "./request-headers.js";
+export declare function listSessions(args: {
+    baseUrl: string;
+    auth?: RequestAuth;
+    fetchImpl?: typeof fetch;
+}): Promise<SessionSummary[]>;
+export declare function fetchSessionEvents(args: {
+    baseUrl: string;
+    sessionId: string;
+    auth?: RequestAuth;
+    fetchImpl?: typeof fetch;
+}): Promise<SessionEvent[]>;
+/**
+ * Pick the previous (most recently updated) followable session for
+ * `resume` / `chat --resume` when no session id was passed.
+ * Followable = has a non-empty continuation token (task sessions without
+ * one are skipped).
+ */
+export declare function pickPreviousSession(sessions: readonly SessionSummary[]): SessionSummary | undefined;
+/** Look up the most recently updated followable session id. */
+export declare function resolvePreviousSessionId(args: {
+    baseUrl: string;
+    auth?: RequestAuth;
+    fetchImpl?: typeof fetch;
+}): Promise<string | undefined>;
+/** Format a sessions table (id, channel, mode, turns, running, updated). */
+export declare function formatSessionsTable(sessions: SessionSummary[]): string;
+//# sourceMappingURL=sessions-client.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sessions-client.d.ts","sourceRoot":"","sources":["../../src/internal/sessions-client.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAEhE,OAAO,EAAuB,KAAK,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAE7E,wBAAsB,YAAY,CAAC,IAAI,EAAE;IACvC,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,WAAW,CAAC;IACnB,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;CAC1B,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC,CA8B5B;AAED,wBAAsB,kBAAkB,CAAC,IAAI,EAAE;IAC7C,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,WAAW,CAAC;IACnB,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;CAC1B,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAuE1B;AAgCD;;;;;GAKG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,SAAS,cAAc,EAAE,GAClC,cAAc,GAAG,SAAS,CAU5B;AAED,+DAA+D;AAC/D,wBAAsB,wBAAwB,CAAC,IAAI,EAAE;IACnD,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,WAAW,CAAC;IACnB,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;CAC1B,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAO9B;AAED,4EAA4E;AAC5E,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,cAAc,EAAE,GAAG,MAAM,CActE"}

package/dist/internal/sessions-client.js

@@ -0,0 +1,193 @@
+/**
+ * Session list / event fetch for CLI (`sessions`, `session`, chat reattach).
+ *
+ * Customer-facing errors never include hosting URLs or infra jargon.
+ */
+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 { sanitizeCustomerError } from "./logs-client.js";
+import { mergeRequestHeaders } from "./request-headers.js";
+export function listSessions(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/sessions`, {
+                headers: mergeRequestHeaders(args.auth),
+            });
+        }
+        catch (error) {
+            throw new Error(sanitizeCustomerError(error instanceof Error ? error.message : "Could not list sessions."));
+        }
+        if (!resp.ok) {
+            throw new Error(`Could not list sessions (HTTP ${resp.status}).`);
+        }
+        const body = (yield resp.json());
+        if (!Array.isArray(body.sessions)) {
+            return [];
+        }
+        const out = [];
+        for (const row of body.sessions) {
+            const parsed = parseSessionSummary(row);
+            if (parsed !== undefined) {
+                out.push(parsed);
+            }
+        }
+        return out;
+    });
+}
+export function fetchSessionEvents(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 path = `/v1/session/${encodeURIComponent(args.sessionId)}/events`;
+        try {
+            const jsonResp = yield fetchImpl(`${baseUrl}${path}?format=json`, {
+                headers: mergeRequestHeaders(args.auth),
+            });
+            if (jsonResp.ok) {
+                const body = (yield jsonResp.json());
+                if (Array.isArray(body.events)) {
+                    return body.events;
+                }
+            }
+            else if (jsonResp.status === 404) {
+                throw new Error(`Session ${args.sessionId} not found.`);
+            }
+            else if (jsonResp.status === 403) {
+                throw new Error(`Session ${args.sessionId} is not readable by this caller.`);
+            }
+        }
+        catch (error) {
+            if (error instanceof Error && error.message.startsWith("Session ")) {
+                throw error;
+            }
+            // Fall through to NDJSON.
+        }
+        try {
+            const resp = yield fetchImpl(`${baseUrl}${path}`, {
+                headers: mergeRequestHeaders(args.auth),
+            });
+            if (resp.status === 404) {
+                throw new Error(`Session ${args.sessionId} not found.`);
+            }
+            if (resp.status === 403) {
+                throw new Error(`Session ${args.sessionId} is not readable by this caller.`);
+            }
+            if (!resp.ok) {
+                throw new Error(`Could not fetch session events (HTTP ${resp.status}).`);
+            }
+            const text = yield resp.text();
+            const events = [];
+            for (const line of text.split("\n")) {
+                if (line.trim() === "") {
+                    continue;
+                }
+                try {
+                    events.push(JSON.parse(line));
+                }
+                catch (_b) {
+                    // skip malformed lines
+                }
+            }
+            return events;
+        }
+        catch (error) {
+            if (error instanceof Error && error.message.startsWith("Session ")) {
+                throw error;
+            }
+            if (error instanceof Error && error.message.startsWith("Could not fetch")) {
+                throw new Error(sanitizeCustomerError(error.message));
+            }
+            throw new Error(sanitizeCustomerError(error instanceof Error
+                ? error.message
+                : "Could not fetch session events."));
+        }
+    });
+}
+/** Lenient parse so partial stubs / older servers still list by sessionId. */
+function parseSessionSummary(value) {
+    if (typeof value !== "object" || value === null) {
+        return undefined;
+    }
+    const row = value;
+    if (typeof row.sessionId !== "string" || row.sessionId === "") {
+        return undefined;
+    }
+    const continuationToken = typeof row.continuationToken === "string"
+        ? row.continuationToken
+        : row.continuationToken === null
+            ? null
+            : null;
+    return {
+        sessionId: row.sessionId,
+        channelId: typeof row.channelId === "string" ? row.channelId : "",
+        mode: row.mode === "task" ? "task" : "chat",
+        title: typeof row.title === "string" ? row.title : undefined,
+        turnCount: typeof row.turnCount === "number" ? row.turnCount : 0,
+        running: row.running === true,
+        createdAt: typeof row.createdAt === "string" ? row.createdAt : "",
+        updatedAt: typeof row.updatedAt === "string" ? row.updatedAt : "",
+        continuationToken,
+        externalUrl: typeof row.externalUrl === "string" ? row.externalUrl : undefined,
+    };
+}
+/**
+ * Pick the previous (most recently updated) followable session for
+ * `resume` / `chat --resume` when no session id was passed.
+ * Followable = has a non-empty continuation token (task sessions without
+ * one are skipped).
+ */
+export function pickPreviousSession(sessions) {
+    const followable = sessions.filter((s) => typeof s.continuationToken === "string" && s.continuationToken !== "");
+    if (followable.length === 0) {
+        return undefined;
+    }
+    return [...followable].sort((a, b) => b.updatedAt.localeCompare(a.updatedAt))[0];
+}
+/** Look up the most recently updated followable session id. */
+export function resolvePreviousSessionId(args) {
+    return __awaiter(this, void 0, void 0, function* () {
+        var _a;
+        const sessions = yield listSessions({
+            baseUrl: args.baseUrl,
+            auth: args.auth,
+            fetchImpl: args.fetchImpl,
+        });
+        return (_a = pickPreviousSession(sessions)) === null || _a === void 0 ? void 0 : _a.sessionId;
+    });
+}
+/** Format a sessions table (id, channel, mode, turns, running, updated). */
+export function formatSessionsTable(sessions) {
+    if (sessions.length === 0) {
+        return "No sessions.\n";
+    }
+    const header = ["SESSION", "CHANNEL", "MODE", "TURNS", "RUNNING", "UPDATED"];
+    const rows = sessions.map((s) => [
+        s.sessionId,
+        s.channelId,
+        s.mode,
+        String(s.turnCount),
+        s.running ? "yes" : "no",
+        s.updatedAt,
+    ]);
+    return `${renderTable(header, rows)}\n`;
+}
+function renderTable(header, rows) {
+    const widths = header.map((h, i) => Math.max(h.length, ...rows.map((row) => { var _a; return ((_a = row[i]) !== null && _a !== void 0 ? _a : "").length; })));
+    const renderRow = (row) => row
+        .map((cell, i) => { var _a; return cell.padEnd((_a = widths[i]) !== null && _a !== void 0 ? _a : 0); })
+        .join("  ")
+        .trimEnd();
+    return [renderRow(header), ...rows.map(renderRow)].join("\n");
+}

package/dist/internal/storage-coordinator.js

@@ -252,7 +252,7 @@ export class StorageCoordinator {
                 // Index entry without its record (e.g. the record write was shed
                 // under at-most-once). The session is unrecoverable; treat as a miss
                 // so the conversation can continue rather than failing forever.
-                this.logger(`[agent-serve] storage continuation entry points at missing session ${sessionId}; treating as a miss`);
+                this.logger(`[agentkit] storage continuation entry points at missing session ${sessionId}; treating as a miss`);
                 return undefined;
             }
             // The sink must answer for the exact key it was asked about — a
@@ -383,7 +383,7 @@ export class StorageCoordinator {
                 return value == null ? undefined : value;
             }
             catch (error) {
-                this.logger(`[agent-serve] storage get(ab-snapshot) failed: ${describeError(error)}`);
+                this.logger(`[agentkit] storage get(ab-snapshot) failed: ${describeError(error)}`);
                 return undefined;
             }
         });
@@ -415,7 +415,7 @@ export class StorageCoordinator {
             ]);
             clearTimeout(timer);
             if (!drained) {
-                this.logger(`[agent-serve] storage shutdown drain timed out after ${CLOSE_DRAIN_TIMEOUT_MS}ms with ${this.pending} write(s) undelivered`);
+                this.logger(`[agentkit] storage shutdown drain timed out after ${CLOSE_DRAIN_TIMEOUT_MS}ms with ${this.pending} write(s) undelivered`);
             }
         });
     }
@@ -455,7 +455,7 @@ export class StorageCoordinator {
                 return Array.isArray(entries) ? entries : [];
             }
             catch (error) {
-                this.logger(`[agent-serve] storage list(${prefix}) failed: ${describeError(error)}`);
+                this.logger(`[agentkit] storage list(${prefix}) failed: ${describeError(error)}`);
                 return [];
             }
         });
@@ -467,7 +467,7 @@ export class StorageCoordinator {
         if (this.pending + ops.length > MAX_PENDING_OPS) {
             this.dropped += ops.length;
             if (this.dropped <= ops.length || this.dropped % 1000 < ops.length) {
-                this.logger(`[agent-serve] storage queue full (${MAX_PENDING_OPS} pending writes); dropped ${this.dropped} write(s) so far — the sink is too slow for the traffic`);
+                this.logger(`[agentkit] storage queue full (${MAX_PENDING_OPS} pending writes); dropped ${this.dropped} write(s) so far — the sink is too slow for the traffic`);
             }
             return;
         }
@@ -485,7 +485,7 @@ export class StorageCoordinator {
                     }
                 }
                 catch (error) {
-                    this.logger(`[agent-serve] storage ${op.op}(${op.key}) failed: ${describeError(error)}`);
+                    this.logger(`[agentkit] storage ${op.op}(${op.key}) failed: ${describeError(error)}`);
                 }
                 finally {
                     this.pending -= 1;