@agentclientprotocol/claude-agent-acp 0.88.1-preview.5 → 0.88.1-preview.7

package/dist/diff.js

@@ -456,11 +456,47 @@ function textLines(text) {
  * its time budget.
  */
 function filePatch(oldText, newText) {
-    const hunks = diffHunks(oldText, newText);
+    const hunks = memoizedDiffHunks(oldText, newText);
     if (!hunks || hunks.length === 0)
         return undefined;
     return { change: oldText === null ? "create" : "update", hunks };
 }
+/** The number of recent line diffs that {@link memoizedDiffHunks} keeps. */
+const DIFF_MEMO_SIZE = 4;
+/** Recent line diffs not read again yet, the most recent last. A text of at
+ *  most {@link MAX_PATCH_FILE_BYTES} is held until it is read again or later
+ *  diffs push it out. */
+const diffMemo = [];
+/**
+ * {@link diffHunks} of a recent pair of texts again, without a second diff.
+ *
+ * The approval of an Edit or Write diffs the file against the predicted text,
+ * and the PostToolUse hook diffs the same texts once Claude wrote them. On a
+ * large file each diff can block the event loop for its whole time budget.
+ * Only a diff that completed is remembered: one that ran out of its budget
+ * says nothing about the texts, so a later call diffs them again. The hunks
+ * are shared, and no caller changes them.
+ */
+function memoizedDiffHunks(oldText, newText) {
+    const index = diffMemo.findIndex((entry) => entry.oldText === oldText && entry.newText === newText);
+    if (index >= 0) {
+        // The hook is normally the last reader of a pair, so the entry goes: the
+        // memo does not hold two large texts longer than needed.
+        const [entry] = diffMemo.splice(index, 1);
+        return entry.hunks;
+    }
+    const hunks = diffHunks(oldText, newText);
+    if (hunks) {
+        diffMemo.push({ oldText, newText, hunks });
+        if (diffMemo.length > DIFF_MEMO_SIZE)
+            diffMemo.shift();
+    }
+    return hunks;
+}
+/** Forget the remembered line diffs. For tests. */
+export function clearDiffMemo() {
+    diffMemo.length = 0;
+}
 /**
  * Reads a file as patch input.
  *

package/dist/mcp-command.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mcp-command.d.ts","sourceRoot":"","sources":["../src/mcp-command.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AACjE,OAAO,KAAK,EAAE,eAAe,EAAE,KAAK,EAAE,MAAM,gCAAgC,CAAC;AAI7E;;2BAE2B;AAC3B,eAAO,MAAM,qBAAqB,EAAE,gBAInC,CAAC;AAQF;;6EAE6E;AAC7E,MAAM,MAAM,UAAU,GAClB;IAAE,MAAM,EAAE,QAAQ,CAAA;CAAE,GACpB;IAAE,MAAM,EAAE,WAAW,GAAG,QAAQ,GAAG,SAAS,CAAC;IAAC,GAAG,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAElF;;+DAE+D;AAC/D,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI,CAW/D;AAED;;0CAE0C;AAC1C,wBAAsB,mBAAmB,CACvC,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,iBAAiB,CAAC,EACrC,MAAM,EAAE,WAAW,EACnB,QAAQ,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,GAClC,OAAO,CAAC,eAAe,EAAE,GAAG,IAAI,CAAC,CAkBnC;AAuED;;;;kBAIkB;AAClB,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAiBnD;AA2DD;;8BAE8B;AAC9B,wBAAgB,eAAe,CAAC,QAAQ,EAAE,eAAe,EAAE,GAAG,MAAM,CA6BnE;AAED,8CAA8C;AAC9C,MAAM,MAAM,eAAe,GAAG,IAAI,CAChC,KAAK,EACL,iBAAiB,GAAG,oBAAoB,GAAG,iBAAiB,CAC7D,CAAC;AAEF;;kCAEkC;AAClC,MAAM,MAAM,iBAAiB,GAAG;IAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,WAAW,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC;AA4DnF;;;;;sDAKsD;AACtD,wBAAsB,aAAa,CACjC,KAAK,EAAE,eAAe,EACtB,OAAO,EAAE,UAAU,EACnB,cAAc,EAAE,MAAM,EACtB,MAAM,EAAE,WAAW,EACnB,QAAQ,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,GAClC,OAAO,CAAC,iBAAiB,CAAC,CAoD5B"}
+{"version":3,"file":"mcp-command.d.ts","sourceRoot":"","sources":["../src/mcp-command.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AACjE,OAAO,KAAK,EAAE,eAAe,EAAE,KAAK,EAAE,MAAM,gCAAgC,CAAC;AAI7E;;2BAE2B;AAC3B,eAAO,MAAM,qBAAqB,EAAE,gBAInC,CAAC;AAQF;;6EAE6E;AAC7E,MAAM,MAAM,UAAU,GAClB;IAAE,MAAM,EAAE,QAAQ,CAAA;CAAE,GACpB;IAAE,MAAM,EAAE,WAAW,GAAG,QAAQ,GAAG,SAAS,CAAC;IAAC,GAAG,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAElF;;+DAE+D;AAC/D,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI,CAe/D;AAED;;0CAE0C;AAC1C,wBAAsB,mBAAmB,CACvC,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,iBAAiB,CAAC,EACrC,MAAM,EAAE,WAAW,EACnB,QAAQ,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,GAClC,OAAO,CAAC,eAAe,EAAE,GAAG,IAAI,CAAC,CAkBnC;AAuED;;;;kBAIkB;AAClB,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAiBnD;AA2DD;;8BAE8B;AAC9B,wBAAgB,eAAe,CAAC,QAAQ,EAAE,eAAe,EAAE,GAAG,MAAM,CA6BnE;AAED,8CAA8C;AAC9C,MAAM,MAAM,eAAe,GAAG,IAAI,CAChC,KAAK,EACL,iBAAiB,GAAG,oBAAoB,GAAG,iBAAiB,CAC7D,CAAC;AAEF;;kCAEkC;AAClC,MAAM,MAAM,iBAAiB,GAAG;IAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,WAAW,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC;AA4DnF;;;;;sDAKsD;AACtD,wBAAsB,aAAa,CACjC,KAAK,EAAE,eAAe,EACtB,OAAO,EAAE,UAAU,EACnB,cAAc,EAAE,MAAM,EACtB,MAAM,EAAE,WAAW,EACnB,QAAQ,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,GAClC,OAAO,CAAC,iBAAiB,CAAC,CAoD5B"}

package/dist/mcp-command.js

@@ -16,6 +16,11 @@ const MCP_ACTION_TIMEOUT_MS = 30_000;
  *  or `/mcp disable` with an optional server name or `all`. Any other `/mcp`
  *  argument gives null, and the prompt gets no replacement. */
 export function parseMcpCommand(text) {
+    // The first word is `/mcp` only when the text starts with it after the
+    // leading whitespace. Checking that first keeps a long prompt from being
+    // split into words. `trimStart` removes the characters that `\s` matches.
+    if (!text.trimStart().startsWith("/mcp"))
+        return null;
     const words = text.trim().split(/\s+/);
     if (words[0] !== "/mcp")
         return null;

package/dist/session-index/activity.d.ts

@@ -0,0 +1,56 @@
+/**
+ * The `activity` and `cost` of a session list row.
+ *
+ * A session that this connection runs reports the SDK's own state, and
+ * `error` when it is idle and its last turn failed with an error (not a
+ * cancel). Another session reports what the CLI registry and the transcript
+ * tell:
+ *
+ * - no live process holds it: `idle`, or `error` when its last turn ended
+ *   with an API error;
+ * - an interactive CLI that is not driven by an SDK holds it, and its registry
+ *   status is newer than the transcript: the registry status (an idle one is
+ *   `error` after such a turn);
+ * - otherwise the transcript tail: a finished turn is `idle` (`error` after
+ *   an API error), an unfinished turn written in the last 10 minutes is
+ *   `running`, and anything else has no known state.
+ *
+ * A user interrupt is no error. A new turn clears it.
+ *
+ * The SDK-driven CLIs (`entrypoint: sdk-*`, which includes the ones this
+ * adapter starts) keep `busy` in the registry long after a turn ends, so their
+ * registry status is not used.
+ */
+import type { LiveRecord } from "./live-registry.js";
+import type { TranscriptFacts } from "./transcript-scan.js";
+export type ActivityState = "running" | "idle" | "requires_action" | "error";
+export type SessionActivity = {
+    state?: ActivityState;
+    lastTurnEndedAt?: string;
+};
+/** What this connection knows about a session it runs. */
+export type OwnSessionState = {
+    state?: ActivityState;
+    /** Epoch ms of the end of the last turn. */
+    lastTurnEndedAt?: number;
+    /** `total_cost_usd` of the last result. */
+    costUsd?: number;
+    /** The last turn failed with an error (not a cancel). */
+    lastTurnFailed?: boolean;
+    /** The query of the session failed here at this time (epoch ms) and no
+     *  longer runs: the session is reported as any other one, `error` until
+     *  its transcript shows a prompt or a turn end after it. */
+    queryFailedAt?: number;
+};
+export declare function deriveActivity(input: {
+    own?: OwnSessionState;
+    live?: LiveRecord;
+    facts: TranscriptFacts;
+    transcriptMtimeMs: number;
+    now: number;
+}): SessionActivity | undefined;
+/** The cost of a session this connection runs: the `total_cost_usd` the SDK
+ *  gave in its last result. Only a positive amount; none for any other
+ *  session. */
+export declare function selectCost(own: OwnSessionState | undefined): number | undefined;
+//# sourceMappingURL=activity.d.ts.map

package/dist/session-index/activity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"activity.d.ts","sourceRoot":"","sources":["../../src/session-index/activity.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAE5D,MAAM,MAAM,aAAa,GAAG,SAAS,GAAG,MAAM,GAAG,iBAAiB,GAAG,OAAO,CAAC;AAE7E,MAAM,MAAM,eAAe,GAAG;IAC5B,KAAK,CAAC,EAAE,aAAa,CAAC;IACtB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B,CAAC;AAEF,0DAA0D;AAC1D,MAAM,MAAM,eAAe,GAAG;IAC5B,KAAK,CAAC,EAAE,aAAa,CAAC;IACtB,4CAA4C;IAC5C,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,2CAA2C;IAC3C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,yDAAyD;IACzD,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB;;gEAE4D;IAC5D,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB,CAAC;AA+BF,wBAAgB,cAAc,CAAC,KAAK,EAAE;IACpC,GAAG,CAAC,EAAE,eAAe,CAAC;IACtB,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB,KAAK,EAAE,eAAe,CAAC;IACvB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,GAAG,EAAE,MAAM,CAAC;CACb,GAAG,eAAe,GAAG,SAAS,CAqC9B;AAED;;eAEe;AACf,wBAAgB,UAAU,CAAC,GAAG,EAAE,eAAe,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAG/E"}

package/dist/session-index/activity.js

@@ -0,0 +1,96 @@
+/**
+ * The `activity` and `cost` of a session list row.
+ *
+ * A session that this connection runs reports the SDK's own state, and
+ * `error` when it is idle and its last turn failed with an error (not a
+ * cancel). Another session reports what the CLI registry and the transcript
+ * tell:
+ *
+ * - no live process holds it: `idle`, or `error` when its last turn ended
+ *   with an API error;
+ * - an interactive CLI that is not driven by an SDK holds it, and its registry
+ *   status is newer than the transcript: the registry status (an idle one is
+ *   `error` after such a turn);
+ * - otherwise the transcript tail: a finished turn is `idle` (`error` after
+ *   an API error), an unfinished turn written in the last 10 minutes is
+ *   `running`, and anything else has no known state.
+ *
+ * A user interrupt is no error. A new turn clears it.
+ *
+ * The SDK-driven CLIs (`entrypoint: sdk-*`, which includes the ones this
+ * adapter starts) keep `busy` in the registry long after a turn ends, so their
+ * registry status is not used.
+ */
+const RECENT_UNFINISHED_TURN_MS = 10 * 60 * 1000;
+function registryState(status) {
+    switch (status) {
+        case "busy":
+        case "shell":
+            return "running";
+        case "waiting":
+            return "requires_action";
+        case "idle":
+            return "idle";
+        default:
+            return undefined;
+    }
+}
+function usesRegistryStatus(record, transcriptMtimeMs) {
+    return (record.kind === "interactive" &&
+        !(record.entrypoint ?? "").startsWith("sdk-") &&
+        record.statusUpdatedAt !== undefined &&
+        record.statusUpdatedAt > transcriptMtimeMs);
+}
+function iso(ms) {
+    return ms === undefined || !Number.isFinite(ms) ? undefined : new Date(ms).toISOString();
+}
+export function deriveActivity(input) {
+    const { live, facts, transcriptMtimeMs, now } = input;
+    const failedAt = input.own?.queryFailedAt;
+    const own = failedAt === undefined ? input.own : undefined;
+    let state;
+    // A finished turn that ended with an API error, or this connection's query
+    // of the session failed and nothing was written since.
+    const failed = (facts.turnState === "finished" && facts.lastTurnError === true) ||
+        (failedAt !== undefined &&
+            !((facts.lastPromptAt ?? 0) > failedAt) &&
+            !((facts.lastTurnEndedAt ?? 0) > failedAt));
+    if (own) {
+        state = own.state ?? "idle";
+        if (state === "idle" && own.lastTurnFailed)
+            state = "error";
+    }
+    else if (!live) {
+        state = failed ? "error" : "idle";
+    }
+    else if (usesRegistryStatus(live, transcriptMtimeMs)) {
+        // A busy or waiting CLI wins; an idle one shows how its turn ended.
+        state = registryState(live.status);
+        if (state === "idle" && failed)
+            state = "error";
+    }
+    else if (failed) {
+        state = "error";
+    }
+    else if (facts.turnState === "finished") {
+        state = "idle";
+    }
+    else if (facts.turnState === "unfinished" &&
+        now - transcriptMtimeMs < RECENT_UNFINISHED_TURN_MS) {
+        state = "running";
+    }
+    const lastTurnEndedAt = iso(own?.lastTurnEndedAt ?? facts.lastTurnEndedAt);
+    if (state === undefined && lastTurnEndedAt === undefined)
+        return undefined;
+    return {
+        ...(state !== undefined && { state }),
+        ...(lastTurnEndedAt !== undefined && { lastTurnEndedAt }),
+    };
+}
+/** The cost of a session this connection runs: the `total_cost_usd` the SDK
+ *  gave in its last result. Only a positive amount; none for any other
+ *  session. */
+export function selectCost(own) {
+    const amount = own?.costUsd;
+    return amount !== undefined && Number.isFinite(amount) && amount > 0 ? amount : undefined;
+}

package/dist/session-index/archive-title.d.ts

@@ -0,0 +1,52 @@
+/**
+ * The session archive, in the on-disk format of JetBrains AIR's own Claude
+ * integration: a session is archived when its title carries the
+ * `[archived] ` prefix, and archive, unarchive and rename append the title as
+ * a pair of records to the transcript:
+ *
+ * ```
+ * {"type":"custom-title","customTitle":"[archived] Title","sessionId":"…"}
+ * {"type":"agent-name","agentName":"[archived] Title","sessionId":"…"}
+ * ```
+ *
+ * The archive state follows AIR's native Claude provider (see
+ * {@link effectiveTitle}): the last agent name decides, else the custom title
+ * the SDK reports (`SDKSessionInfo.customTitle`). Archive writes the prefix
+ * and the current title without it; unarchive writes the title without the
+ * prefix. Both are cut to the CLI's 200-character title limit. The records
+ * are metadata: they move neither `updatedAt` nor the list order. The
+ * `claude --resume` picker shows the prefix.
+ */
+/** The title prefix of an archived session. */
+export declare const ARCHIVED_TITLE_PREFIX = "[archived] ";
+/** Whitespace collapsed to single spaces and trimmed, as AIR stores a title. */
+export declare function normalizeStoredTitle(title: string): string;
+/** Whether a session name (see {@link effectiveTitle}) marks its session
+ *  archived. */
+export declare function isArchivedTitle(title: string | undefined): boolean;
+/** The title shown for a stored title: without the archive prefix,
+ *  removed once, as AIR shows it. */
+export declare function visibleTitle(title: string): string;
+/** The title of a session that has none at all, as AIR names it. */
+export declare function defaultSessionTitle(sessionId: string): string;
+/** The title that `title` is stored as in the given archive state: the
+ *  visible title, with the prefix when archived, normalized and cut to the
+ *  CLI limit. */
+export declare function storedTitle(title: string, archived: boolean, sessionId: string): string;
+/**
+ * The title of a session and its archive state, by the rule of AIR's native
+ * Claude provider: the session's name is its last agent name, else its custom
+ * title, and the session is archived exactly when that name starts with the
+ * prefix. The title is that agent name, else `summary`, the title the SDK
+ * gives the session; it is stored, so it may carry the prefix.
+ */
+export declare function effectiveTitle(agentName: string | undefined, { customTitle, summary }: {
+    customTitle?: string;
+    summary?: string;
+}): {
+    title: string | undefined;
+    archived: boolean;
+};
+/** The `custom-title` and `agent-name` records of `title`, one per line. */
+export declare function titleRecords(sessionId: string, title: string): string;
+//# sourceMappingURL=archive-title.d.ts.map

package/dist/session-index/archive-title.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"archive-title.d.ts","sourceRoot":"","sources":["../../src/session-index/archive-title.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,+CAA+C;AAC/C,eAAO,MAAM,qBAAqB,gBAAgB,CAAC;AAenD,gFAAgF;AAChF,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAE1D;AAOD;gBACgB;AAChB,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAElE;AAED;qCACqC;AACrC,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAElD;AAED,oEAAoE;AACpE,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAE7D;AAED;;iBAEiB;AACjB,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAKvF;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAC5B,SAAS,EAAE,MAAM,GAAG,SAAS,EAC7B,EAAE,WAAW,EAAE,OAAO,EAAE,EAAE;IAAE,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,GACnE;IAAE,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;IAAC,QAAQ,EAAE,OAAO,CAAA;CAAE,CAElD;AAED,4EAA4E;AAC5E,wBAAgB,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAOrE"}

package/dist/session-index/archive-title.js

@@ -0,0 +1,77 @@
+/**
+ * The session archive, in the on-disk format of JetBrains AIR's own Claude
+ * integration: a session is archived when its title carries the
+ * `[archived] ` prefix, and archive, unarchive and rename append the title as
+ * a pair of records to the transcript:
+ *
+ * ```
+ * {"type":"custom-title","customTitle":"[archived] Title","sessionId":"…"}
+ * {"type":"agent-name","agentName":"[archived] Title","sessionId":"…"}
+ * ```
+ *
+ * The archive state follows AIR's native Claude provider (see
+ * {@link effectiveTitle}): the last agent name decides, else the custom title
+ * the SDK reports (`SDKSessionInfo.customTitle`). Archive writes the prefix
+ * and the current title without it; unarchive writes the title without the
+ * prefix. Both are cut to the CLI's 200-character title limit. The records
+ * are metadata: they move neither `updatedAt` nor the list order. The
+ * `claude --resume` picker shows the prefix.
+ */
+/** The title prefix of an archived session. */
+export const ARCHIVED_TITLE_PREFIX = "[archived] ";
+/** What the CLI keeps of a stored title: `title.slice(0, 200).trim()`. */
+const CLI_TITLE_LIMIT = 200;
+/** A title once normalized starts with the prefix: leading space (what a
+ *  trim removes), the marker, a run of white space, then a title character.
+ *  The white space AIR collapses is ASCII white space, as in Java's `\s`. */
+const ARCHIVED_PATTERN = /^\s*\[archived\][ \t\n\v\f\r]+(?=[^ \t\n\v\f\r])/;
+/** Every leading archive prefix at once. */
+const ARCHIVED_PREFIXES = /^(?:\s*\[archived\][ \t\n\v\f\r]+(?=[^ \t\n\v\f\r]))+/;
+const WHITESPACE_RUN = /[ \t\n\v\f\r]+/g;
+/** Whitespace collapsed to single spaces and trimmed, as AIR stores a title. */
+export function normalizeStoredTitle(title) {
+    return title.replace(WHITESPACE_RUN, " ").trim();
+}
+/** Cut to what the CLI keeps of a title. */
+function capTitle(title) {
+    return title.length <= CLI_TITLE_LIMIT ? title : title.slice(0, CLI_TITLE_LIMIT).trim();
+}
+/** Whether a session name (see {@link effectiveTitle}) marks its session
+ *  archived. */
+export function isArchivedTitle(title) {
+    return title !== undefined && ARCHIVED_PATTERN.test(title);
+}
+/** The title shown for a stored title: without the archive prefix,
+ *  removed once, as AIR shows it. */
+export function visibleTitle(title) {
+    return title.replace(ARCHIVED_PATTERN, "");
+}
+/** The title of a session that has none at all, as AIR names it. */
+export function defaultSessionTitle(sessionId) {
+    return `Session ${sessionId.slice(0, 8)}`;
+}
+/** The title that `title` is stored as in the given archive state: the
+ *  visible title, with the prefix when archived, normalized and cut to the
+ *  CLI limit. */
+export function storedTitle(title, archived, sessionId) {
+    // Every prefix: a title stored twice prefixed must not stay archived.
+    const visible = normalizeStoredTitle(title.replace(ARCHIVED_PREFIXES, "")) || defaultSessionTitle(sessionId);
+    return capTitle(archived ? ARCHIVED_TITLE_PREFIX + visible : visible);
+}
+/**
+ * The title of a session and its archive state, by the rule of AIR's native
+ * Claude provider: the session's name is its last agent name, else its custom
+ * title, and the session is archived exactly when that name starts with the
+ * prefix. The title is that agent name, else `summary`, the title the SDK
+ * gives the session; it is stored, so it may carry the prefix.
+ */
+export function effectiveTitle(agentName, { customTitle, summary }) {
+    return { title: agentName ?? summary, archived: isArchivedTitle(agentName ?? customTitle) };
+}
+/** The `custom-title` and `agent-name` records of `title`, one per line. */
+export function titleRecords(sessionId, title) {
+    return (JSON.stringify({ type: "custom-title", customTitle: title, sessionId }) +
+        "\n" +
+        JSON.stringify({ type: "agent-name", agentName: title, sessionId }) +
+        "\n");
+}

package/dist/session-index/connection.d.ts

@@ -0,0 +1,152 @@
+/**
+ * The session index of one ACP connection: what `ClaudeAcpAgent` does for a
+ * client that declared `sessionIndex`, and the archive of an AIR client
+ * without it. The agent keeps thin call sites; everything else
+ * lives here.
+ *
+ * Wire contract: docs/air-extensions.md, "Session index".
+ */
+import { type AgentApp, type DeleteSessionRequest, type DeleteSessionResponse, type InitializeRequest, type ListSessionsRequest, type ListSessionsResponse } from "@agentclientprotocol/sdk";
+import type { AcpClient, Logger, Session } from "../acp-agent.js";
+import { type ListSubscribeRequest, type ListSubscribeResponse, type ListUnsubscribeRequest } from "./list-subscriptions.js";
+import { SessionIndexService, type RenameSessionRequest, type SessionIdRequest } from "./service.js";
+/** What the session index keeps on each `Session`. */
+export type SessionIndexFields = {
+    /** When the last turn ended (the last `session_state_changed: idle`), epoch
+     *  ms. Reported as `lastTurnEndedAt` in the session index. */
+    lastTurnEndedAt?: number;
+    /** The last turn failed with an error, not a cancel; a new turn clears
+     *  it. Reported as the `error` state in the session index. */
+    lastTurnFailed?: boolean;
+    /** `total_cost_usd` of the last result, reported as the cost of the session
+     *  in the session index. */
+    lastTotalCostUsd?: number;
+    /** The query resumed a stored conversation (load, resume, fork): the
+     *  session has a transcript, unlike a new one before its first turn. */
+    resumedFromHistory?: boolean;
+};
+/** Records the end of a turn at `session_state_changed`. */
+export declare function noteSessionState(session: Session, previous: Session["lastSessionState"], state: Session["lastSessionState"]): void;
+/** What the connection needs from the agent. */
+export type SessionIndexHost = {
+    /** Read when used: the agent may still be under construction. */
+    agent: {
+        readonly sessions: {
+            [key: string]: Session;
+        };
+        readonly client: AcpClient;
+        readonly logger: Logger;
+    };
+    /** Whether the client is an AIR client. */
+    isAirClient(): boolean;
+    /** Cancels the running turns of a session loaded here and sends its CLI
+     *  the interrupt, without awaiting the reply. */
+    interruptSession(sessionId: string): Promise<void>;
+    /** Closes a session loaded here, as `session/close` does. */
+    teardownSession(sessionId: string): Promise<void>;
+};
+type EmptyResponse = Record<string, never>;
+export declare class SessionIndexConnection {
+    private readonly host;
+    /**
+     * The session index of a client that declared `sessionIndex`. Undefined for
+     * every other client, which keeps the session list, delete and the watchers
+     * exactly as before.
+     */
+    service?: SessionIndexService;
+    /** The archive behind `session/delete` of an AIR client without
+     *  `sessionIndex`: the same writes, without a list or a watcher. */
+    private archiver?;
+    /** When the query of a session failed here, by session id. */
+    private readonly failedQueries;
+    constructor(host: SessionIndexHost);
+    /** Sets the index up for the client of `initialize`. ACP v2 does not route
+     *  the session index methods yet. */
+    negotiate(request: InitializeRequest, options: {
+        v2: boolean;
+    }): void;
+    /** A stored title as the client shows it: an AIR client gets the title
+     *  of an archived session without the archive prefix, as in its list;
+     *  every other client the title as stored. */
+    clientTitle(title: string): string;
+    /** The AIR capabilities the agent advertises for the index: the index
+     *  itself, archive, rename and the list subscription, all only to a client
+     *  that declared `sessionIndex`. */
+    capabilities(): string[];
+    dispose(): void;
+    /** The query of a session that ran here failed (not a cancel): its row
+     *  shows `error` until its transcript changes. */
+    onQueryFailed(sessionId: string): void;
+    /** A turn of a session started here: an earlier failed query of it no
+     *  longer counts. */
+    onTurnStarted(sessionId: string): void;
+    onTeardown(sessionId: string): void;
+    /** A session this connection runs changed its state, turn end or cost:
+     *  the list subscriptions send it at once. */
+    onOwnSessionChanged(sessionId: string): void;
+    /** `_session/list/subscribe`. */
+    subscribeList(params: ListSubscribeRequest): Promise<ListSubscribeResponse>;
+    /** `_session/list/unsubscribe`. Idempotent. */
+    unsubscribeList(params: ListUnsubscribeRequest): EmptyResponse;
+    /** `session/list` of a `sessionIndex` client; undefined for another one. */
+    list(params: ListSessionsRequest): Promise<ListSessionsResponse> | undefined;
+    /** An AIR client archives with session/delete (see {@link deleteSession}):
+     *  its archived sessions (an archived custom title) stay hidden from the
+     *  old list, as when the delete removed them. */
+    hideArchived<T extends {
+        customTitle?: string;
+    }>(sessions: T[]): T[];
+    /** `_session/rename`: names a session; no generated title replaces it.
+     *  An archived session stays archived. */
+    rename(request: RenameSessionRequest): Promise<EmptyResponse>;
+    /** `_session/archive`: hides a session from the default list and stops
+     *  it. Idempotent; the session need not be loaded. A session loaded here
+     *  is interrupted, retitled through its CLI while that still runs, then
+     *  closed as `session/close` closes it. */
+    archive(params: SessionIdRequest): Promise<EmptyResponse>;
+    /** `_session/unarchive`. Idempotent; it does not load the session. */
+    unarchive(params: SessionIdRequest): Promise<EmptyResponse>;
+    /**
+     * Retitles a session (see {@link SessionIndexService.retitle}). A session
+     * this connection runs is titled through its CLI (`rename_session`). A
+     * loaded session's title state takes the change as a client title, so no
+     * generated title replaces it; `publish` is the title it then publishes.
+     */
+    private retitle;
+    /**
+     * `session/delete`:
+     * - A `sessionIndex` client deletes for real: every transcript, whoever
+     *   else has the session open, as the CLI does.
+     * - Another AIR client uses delete to mark a session done, and may reopen
+     *   it later: the adapter archives it instead (as `_session/archive` does,
+     *   after the CLI closed), so the transcript survives.
+     * - Every other client: the SDK delete, as before.
+     */
+    deleteSession(params: DeleteSessionRequest): Promise<DeleteSessionResponse>;
+    private airArchiver;
+    private requireService;
+    /** What the session index reports for a session this connection runs. */
+    private ownSessionState;
+    /** A new session this connection runs that may have no transcript yet: it
+     *  resumed no stored conversation and no turn of it has ended. A session
+     *  whose query ended, or that has history, needs its transcript. */
+    private isUnwrittenSession;
+    /** Tells the client the archive state of a session that was loaded on
+     *  this connection (`session_info_update` with
+     *  `_meta.jetbrains.air.archived`, RFD #2161's `archived` field), also
+     *  once the archive closed it. */
+    private reportArchived;
+}
+/** The agent methods behind the session index extension methods. */
+type SessionIndexMethods = {
+    subscribeSessionList(params: ListSubscribeRequest): Promise<ListSubscribeResponse>;
+    unsubscribeSessionList(params: ListUnsubscribeRequest): Promise<EmptyResponse>;
+    renameSessionTitle(params: RenameSessionRequest): Promise<EmptyResponse>;
+    archiveSession(params: SessionIdRequest): Promise<EmptyResponse>;
+    unarchiveSession(params: SessionIdRequest): Promise<EmptyResponse>;
+};
+/** Routes `_session/list/subscribe`, `_session/list/unsubscribe`,
+ *  `_session/rename`, `_session/archive` and `_session/unarchive`. */
+export declare function onSessionIndexRequests(app: AgentApp, agent: () => SessionIndexMethods): AgentApp;
+export {};
+//# sourceMappingURL=connection.d.ts.map

package/dist/session-index/connection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection.d.ts","sourceRoot":"","sources":["../../src/session-index/connection.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAEL,KAAK,QAAQ,EACb,KAAK,oBAAoB,EACzB,KAAK,qBAAqB,EAC1B,KAAK,iBAAiB,EACtB,KAAK,mBAAmB,EACxB,KAAK,oBAAoB,EAC1B,MAAM,0BAA0B,CAAC;AAGlC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAWlE,OAAO,EAML,KAAK,oBAAoB,EACzB,KAAK,qBAAqB,EAC1B,KAAK,sBAAsB,EAC5B,MAAM,yBAAyB,CAAC;AACjC,OAAO,EASL,mBAAmB,EACnB,KAAK,oBAAoB,EAEzB,KAAK,gBAAgB,EAEtB,MAAM,cAAc,CAAC;AAEtB,sDAAsD;AACtD,MAAM,MAAM,kBAAkB,GAAG;IAC/B;kEAC8D;IAC9D,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB;kEAC8D;IAC9D,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB;gCAC4B;IAC5B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B;4EACwE;IACxE,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAC9B,CAAC;AAEF,4DAA4D;AAC5D,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,OAAO,EAChB,QAAQ,EAAE,OAAO,CAAC,kBAAkB,CAAC,EACrC,KAAK,EAAE,OAAO,CAAC,kBAAkB,CAAC,GACjC,IAAI,CAGN;AAED,gDAAgD;AAChD,MAAM,MAAM,gBAAgB,GAAG;IAC7B,iEAAiE;IACjE,KAAK,EAAE;QACL,QAAQ,CAAC,QAAQ,EAAE;YAAE,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;SAAE,CAAC;QAC9C,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC;QAC3B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;KACzB,CAAC;IACF,2CAA2C;IAC3C,WAAW,IAAI,OAAO,CAAC;IACvB;qDACiD;IACjD,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACnD,6DAA6D;IAC7D,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACnD,CAAC;AAEF,KAAK,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;AAE3C,qBAAa,sBAAsB;IAarB,OAAO,CAAC,QAAQ,CAAC,IAAI;IAZjC;;;;OAIG;IACH,OAAO,CAAC,EAAE,mBAAmB,CAAC;IAC9B;wEACoE;IACpE,OAAO,CAAC,QAAQ,CAAC,CAAsB;IACvC,8DAA8D;IAC9D,OAAO,CAAC,QAAQ,CAAC,aAAa,CAA6B;gBAE9B,IAAI,EAAE,gBAAgB;IAEnD;yCACqC;IACrC,SAAS,CAAC,OAAO,EAAE,iBAAiB,EAAE,OAAO,EAAE;QAAE,EAAE,EAAE,OAAO,CAAA;KAAE,GAAG,IAAI;IAkBrE;;kDAE8C;IAC9C,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;IAIlC;;wCAEoC;IACpC,YAAY,IAAI,MAAM,EAAE;IAWxB,OAAO,IAAI,IAAI;IAIf;sDACkD;IAClD,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAQtC;yBACqB;IACrB,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAItC,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAKnC;kDAC8C;IAC9C,mBAAmB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAI5C,iCAAiC;IACjC,aAAa,CAAC,MAAM,EAAE,oBAAoB,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAI3E,+CAA+C;IAC/C,eAAe,CAAC,MAAM,EAAE,sBAAsB,GAAG,aAAa;IAK9D,4EAA4E;IAC5E,IAAI,CAAC,MAAM,EAAE,mBAAmB,GAAG,OAAO,CAAC,oBAAoB,CAAC,GAAG,SAAS;IAI5E;;qDAEiD;IACjD,YAAY,CAAC,CAAC,SAAS;QAAE,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,EAAE,QAAQ,EAAE,CAAC,EAAE,GAAG,CAAC,EAAE;IAKpE;8CAC0C;IACpC,MAAM,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,aAAa,CAAC;IAgBnE;;;+CAG2C;IACrC,OAAO,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,aAAa,CAAC;IAgC/D,sEAAsE;IAChE,SAAS,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,aAAa,CAAC;IAWjE;;;;;OAKG;YACW,OAAO;IA8CrB;;;;;;;;OAQG;IACG,aAAa,CAAC,MAAM,EAAE,oBAAoB,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAiBjF,OAAO,CAAC,WAAW;IAQnB,OAAO,CAAC,cAAc;IAKtB,yEAAyE;IACzE,OAAO,CAAC,eAAe;IAgBvB;;wEAEoE;IACpE,OAAO,CAAC,kBAAkB;IAU1B;;;sCAGkC;YACpB,cAAc;CAc7B;AAED,oEAAoE;AACpE,KAAK,mBAAmB,GAAG;IACzB,oBAAoB,CAAC,MAAM,EAAE,oBAAoB,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAAC;IACnF,sBAAsB,CAAC,MAAM,EAAE,sBAAsB,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;IAC/E,kBAAkB,CAAC,MAAM,EAAE,oBAAoB,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;IACzE,cAAc,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;IACjE,gBAAgB,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;CACpE,CAAC;AAEF;sEACsE;AACtE,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,mBAAmB,GAAG,QAAQ,CA2BhG"}