@agentclientprotocol/claude-agent-acp 0.88.1-preview.6 → 0.89.0

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

@@ -0,0 +1,16 @@
+/**
+ * A session index row as the client sees it: the `SessionInfo` of
+ * `session/list` and of `_session/list/changes`, with the flat row fields of
+ * the RFDs in `_meta.jetbrains.air`.
+ */
+import type { SessionInfo } from "@agentclientprotocol/sdk";
+import { type OwnSessionState } from "./activity.js";
+import type { LiveRecord } from "./live-registry.js";
+import type { IndexRow } from "./session-index.js";
+/** The `SessionInfo` of `row`. `own` is what this connection knows of a
+ *  session it runs, `live` the registry record of the session. */
+export declare function sessionInfoOf(row: IndexRow, own: OwnSessionState | undefined, live: LiveRecord | undefined, now: number): SessionInfo;
+/** What a change of the row is compared by: everything but `updatedAt`,
+ *  which alone is no change. */
+export declare function changeSignature(info: SessionInfo): string;
+//# sourceMappingURL=session-info.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"session-info.d.ts","sourceRoot":"","sources":["../../src/session-index/session-info.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAE5D,OAAO,EAA8B,KAAK,eAAe,EAAE,MAAM,eAAe,CAAC;AACjF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAMnD;kEACkE;AAClE,wBAAgB,aAAa,CAC3B,GAAG,EAAE,QAAQ,EACb,GAAG,EAAE,eAAe,GAAG,SAAS,EAChC,IAAI,EAAE,UAAU,GAAG,SAAS,EAC5B,GAAG,EAAE,MAAM,GACV,WAAW,CAgCb;AAED;gCACgC;AAChC,wBAAgB,eAAe,CAAC,IAAI,EAAE,WAAW,GAAG,MAAM,CAEzD"}

package/dist/session-index/session-info.js

@@ -0,0 +1,51 @@
+/**
+ * A session index row as the client sees it: the `SessionInfo` of
+ * `session/list` and of `_session/list/changes`, with the flat row fields of
+ * the RFDs in `_meta.jetbrains.air`.
+ */
+import { withAirMeta } from "../air-extension.js";
+import { deriveActivity, selectCost } from "./activity.js";
+function iso(ms) {
+    return ms === undefined || !Number.isFinite(ms) ? undefined : new Date(ms).toISOString();
+}
+/** The `SessionInfo` of `row`. `own` is what this connection knows of a
+ *  session it runs, `live` the registry record of the session. */
+export function sessionInfoOf(row, own, live, now) {
+    const activity = deriveActivity({
+        own,
+        live,
+        facts: row.facts,
+        transcriptMtimeMs: row.mtimeMs,
+        now,
+    });
+    const cost = selectCost(own);
+    const { facts } = row;
+    // The row fields of the session list extensions RFD and RFD #2161, flat;
+    // each is omitted when unknown, except `archived`.
+    const fields = {
+        archived: row.archived,
+        lastPromptAt: iso(facts.lastPromptAt),
+        model: facts.model,
+        forkedFrom: facts.forkedFrom,
+        state: activity?.state,
+        lastTurnEndedAt: activity?.lastTurnEndedAt,
+        cost: cost === undefined ? undefined : { amount: cost, currency: "USD" },
+    };
+    let meta;
+    for (const [key, value] of Object.entries(fields)) {
+        if (value !== undefined)
+            meta = withAirMeta(meta, key, value);
+    }
+    return {
+        sessionId: row.sessionId,
+        cwd: row.cwd,
+        title: row.title,
+        updatedAt: new Date(row.updatedAtMs).toISOString(),
+        _meta: meta,
+    };
+}
+/** What a change of the row is compared by: everything but `updatedAt`,
+ *  which alone is no change. */
+export function changeSignature(info) {
+    return JSON.stringify([info.sessionId, info.cwd, info.title, info._meta ?? null]);
+}

package/dist/session-index/transcript-scan.d.ts

@@ -0,0 +1,137 @@
+/**
+ * What the session list needs from a transcript beyond the SDK metadata.
+ *
+ * One open reads the first and the last {@link CHUNK_SIZE} bytes, the same
+ * window that the SDK reads. The tail gives the time of the last message, the
+ * end of the last turn. The head and the tail give the `cwd` candidates.
+ *
+ * A last message longer than the tail window leaves no message in it: then
+ * the tail window grows, up to {@link MAX_TAIL_SIZE}, until it holds one.
+ */
+import * as fs from "node:fs/promises";
+export type TurnState = "finished" | "unfinished";
+export type TranscriptFacts = {
+    /** Time of the last user or assistant message in the tail, epoch ms. */
+    lastMessageAt?: number;
+    /** Whether the last turn in the tail ended. Undefined when the tail shows
+     *  no turn at all. */
+    turnState?: TurnState;
+    /** Time the last ended turn ended, epoch ms. */
+    lastTurnEndedAt?: number;
+    /** The last turn ended with an API error (an `isApiErrorMessage`
+     *  assistant record), not a user interrupt, and nothing came after it. */
+    lastTurnError?: boolean;
+    /** The first `cwd` of the head. */
+    headCwd?: string;
+    /** The last `cwd` of the tail. */
+    tailCwd?: string;
+    /** Time of the last real user prompt in the tail (not a tool result, a
+     *  meta record or a slash command), epoch ms. */
+    lastPromptAt?: number;
+    /** Whether `lastPromptAt` is final: the prompt was found, or the tail
+     *  window searched up to {@link MAX_TAIL_SIZE} holds none. */
+    promptSearched?: boolean;
+    /** The model of the last assistant message in the tail. */
+    model?: string;
+    /** The session this one was forked from: the `forkedFrom.sessionId` that
+     *  the SDK and CLI fork write on every copied record. */
+    forkedFrom?: string;
+    /** Whether the head or the tail holds a user or an assistant message. A
+     *  transcript without one is a metadata-only stub. */
+    hasMessages: boolean;
+};
+export type HeadTail = {
+    head: string;
+    tail: string;
+};
+/** Facts that an earlier scan may have found before the tail window. */
+declare const INHERITED_FACTS: readonly ["model", "tailCwd", "lastTurnEndedAt"];
+/** What an earlier scan of the same file found, at `size`. */
+export type PreviousScan = {
+    size: number;
+} & Pick<TranscriptFacts, "lastPromptAt" | "promptSearched" | (typeof INHERITED_FACTS)[number]>;
+/** The first and the last 64 KB of the first `size` bytes of `filePath`:
+ *  what was appended after the file was stat'ed is not read, so the result
+ *  matches the size it is cached by. The tail is the head for a file that
+ *  fits in one chunk. */
+export declare function readHeadTail(filePath: string, size: number): Promise<HeadTail>;
+/** {@link readHeadTail} of a file that is open already. */
+export declare function readHeadTailOf(handle: fs.FileHandle, size: number): Promise<HeadTail>;
+/**
+ * The facts of `filePath`, from its head and tail. When the transcript has
+ * messages but the tail window lacks the last message or the last user
+ * prompt (a long answer or tool output follows it), the window grows,
+ * reading only the new range each step, until it holds both or reaches
+ * {@link MAX_TAIL_SIZE}. The result of a full search is kept per
+ * `(path, size)`.
+ *
+ * `previous` is what an earlier scan of the same file found: when the file
+ * only grew by less than the tail window, and the tail holds no prompt, the
+ * appended bytes hold none either, so the earlier `lastPromptAt` stands.
+ */
+export declare function scanTranscriptFile(filePath: string, size: number, headTail?: HeadTail, previous?: PreviousScan, 
+/** Tells a file replaced by another of the same size apart (its inode). */
+identity?: number): Promise<TranscriptFacts>;
+/** The cwd of the last `relocated` record of the tail: where the session
+ *  was moved, whatever cwd its earlier messages carry. */
+export declare function relocatedCwd(tail: string): string | undefined;
+/** The cwd a transcript belongs to, as the SDK reads it: the last
+ *  `relocated` record of the tail, else the first cwd of the head. */
+export declare function transcriptProjectCwd({ head, tail }: HeadTail): string | undefined;
+type Entry = Record<string, unknown>;
+/**
+ * How a main-chain record bears on the end of the turn: `finished` for a
+ * record that ends a turn (an assistant `end_turn`, an API error, a user
+ * interrupt, the CLI's turn-end system records), `unfinished` for a record of
+ * a turn in progress, and undefined for a record that says nothing.
+ */
+export declare function turnEffect(entry: Entry): TurnState | undefined;
+/** The facts of a transcript, from its head and its tail. */
+export declare function scanTranscript({ head, tail }: HeadTail, options?: {
+    wide?: boolean;
+    known?: {
+        model?: string;
+        tailCwd?: string;
+    };
+}): TranscriptFacts;
+/** Whether the first record of the transcript is a sidechain one, which the
+ *  SDK never lists. */
+export declare function isSidechainTranscript(head: string): boolean;
+/** The last `customTitle` of the tail, as the SDK reads it. */
+export declare function tailCustomTitle(tail: string): string | undefined;
+/** The last agent name of a transcript, as AIR's native Claude provider
+ *  reads it: the top-level `agentName` of any record, from the tail, else
+ *  from the head. */
+export declare function transcriptAgentName({ head, tail }: HeadTail): string | undefined;
+/** What the SDK reports as the titles of a session. */
+export type SdkTitles = {
+    /** `SDKSessionInfo.customTitle`: the title the CLI or a client set. */
+    customTitle?: string;
+    /** `SDKSessionInfo.summary`: the custom title, else a generated one. */
+    summary?: string;
+};
+/**
+ * The titles the SDK gives a transcript, from its own head and tail, in the
+ * SDK's order: custom title (tail, the sidecar, head), AI title, then
+ * {@link generatedTitle}. For a transcript that the SDK `getSessionInfo`
+ * does not read (another copy of the session comes first in its search).
+ * The sidecar title counts only when the tail has no custom title.
+ */
+export declare function sdkTitles({ head, tail }: HeadTail, sidecarTitle?: string): SdkTitles;
+/** The title of a transcript without a custom title, in the SDK's order: AI
+ *  title, last prompt, summary, first prompt. */
+export declare function generatedTitle({ head, tail }: HeadTail): string | undefined;
+/** The time of the last `"timestamp"` in the last 64 KB of a file, cut
+ *  line included, epoch ms: a record longer than that still ends with it. */
+export declare function lastTimestamp(filePath: string, size: number): Promise<number | undefined>;
+/**
+ * The session this transcript was continued in, as the SDK list reads it: the
+ * last `continued-in` record of the tail, unless a completed turn follows it
+ * (the session was resumed here again).
+ */
+export declare function continuedInSessionId(tail: string): string | undefined;
+/** Whether the transcript at `filePath` holds conversation history (a record
+ *  with a `parentUuid`), as the SDK checks a continuation's successor. */
+export declare function hasHistory(filePath: string): Promise<boolean>;
+export {};
+//# sourceMappingURL=transcript-scan.d.ts.map

package/dist/session-index/transcript-scan.d.ts.map

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