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

package/dist/session-index/first-prompt.js

@@ -0,0 +1,195 @@
+/**
+ * The first prompt of a transcript, extracted the way the SDK does for a
+ * session title (its `rf`, `ti` and `jP` in `@anthropic-ai/claude-agent-sdk`).
+ * Used when the SDK `getSessionInfo` read another copy of the session.
+ *
+ * - Only main-chain user records count: no tool result, meta or compact
+ *   summary record.
+ * - Each text (the string content, or every text block) is expanded from its
+ *   `<pasted_content>` blocks and flattened to one line.
+ * - A slash command (`<command-name>/init</command-name>`) is only a fallback
+ *   while a real prompt may follow; `<bash-input>x</bash-input>` is `! x`;
+ *   a text that starts with another tag or with an interrupt marker is
+ *   skipped.
+ * - A prompt longer than 200 characters is cut and gets an ellipsis.
+ * - Without any text, an image or a document prompt is `Image` or `Document`.
+ */
+const MAX_PROMPT_LENGTH = 200;
+const COMMAND_NAME = /<command-name>(.*?)<\/command-name>/;
+const BASH_INPUT = /<bash-input>([\s\S]*?)<\/bash-input>/;
+const SKIPPED_TEXT = /^(?:\s*<[a-z][\w-]*[\s>]|\[Request interrupted by user[^\]]*\])/;
+const PASTED_OPEN = '<pasted_content id="';
+function isPastedId(value) {
+    return /^[0-9a-f]{4}$/.test(value);
+}
+/** `text` with each `<pasted_content id="xxxx">` block replaced by its body. */
+function expandPastedContent(text) {
+    const parts = [];
+    let done = 0;
+    let from = 0;
+    let expanded = false;
+    for (;;) {
+        const open = text.indexOf(PASTED_OPEN, from);
+        if (open === -1)
+            break;
+        const idStart = open + PASTED_OPEN.length;
+        const id = text.slice(idStart, idStart + 4);
+        if (!isPastedId(id) || !text.startsWith('">\n', idStart + 4)) {
+            from = idStart;
+            continue;
+        }
+        const bodyStart = idStart + 4 + 3;
+        const close = `</pasted_content id="${id}">`;
+        const closeAt = text.indexOf(`\n${close}`, bodyStart - 1) + 1;
+        if (closeAt === 0)
+            break;
+        let start = open;
+        for (let i = 0; i < 2 && start > done && text[start - 1] === "\n"; i++)
+            start--;
+        if (start > done)
+            parts.push(text.slice(done, start));
+        done = closeAt + close.length;
+        for (let i = 0; i < 2 && text[done] === "\n"; i++)
+            done++;
+        parts.push(text.slice(bodyStart, closeAt - 1));
+        expanded = true;
+        from = done;
+    }
+    if (!expanded)
+        return text;
+    if (done < text.length)
+        parts.push(text.slice(done));
+    return parts.join("");
+}
+/** At most `length` UTF-16 units, without a split surrogate pair. */
+function cut(text, length) {
+    if (text.length <= length)
+        return text;
+    const head = text.slice(0, length);
+    const last = head.charCodeAt(length - 1);
+    return last >= 0xd800 && last <= 0xdbff ? head.slice(0, -1) : head;
+}
+/**
+ * The prompt of one user record, or undefined when it has none. A slash
+ * command is recorded in `state.commandFallback` instead.
+ */
+export function promptOf(entry, state) {
+    if (entry.type !== "user")
+        return undefined;
+    if (entry.isMeta === true || entry.isCompactSummary === true)
+        return undefined;
+    const message = entry.message;
+    if (!message)
+        return undefined;
+    const content = message.content;
+    const texts = [];
+    if (typeof content === "string") {
+        texts.push(content);
+    }
+    else if (Array.isArray(content)) {
+        for (const block of content) {
+            if (!block || typeof block !== "object")
+                continue;
+            const { type, text } = block;
+            if (type === "tool_result")
+                return undefined;
+            if (type === "text" && typeof text === "string")
+                texts.push(text);
+        }
+    }
+    for (const raw of texts) {
+        let text = expandPastedContent(raw).replaceAll("\n", " ").trim();
+        if (!text)
+            continue;
+        const command = COMMAND_NAME.exec(text);
+        if (command) {
+            if (!state.commandFallback)
+                state.commandFallback = command[1];
+            continue;
+        }
+        const bash = BASH_INPUT.exec(text);
+        if (bash)
+            return `! ${bash[1].trim()}`;
+        if (SKIPPED_TEXT.test(text))
+            continue;
+        if (text.length > MAX_PROMPT_LENGTH)
+            text = `${cut(text, MAX_PROMPT_LENGTH).trim()}…`;
+        return text;
+    }
+    return undefined;
+}
+/**
+ * Whether a user record is a prompt the user sent: one with prompt text
+ * ({@link promptOf}), or one with an image or a document, which the SDK
+ * titles `Image` or `Document` when it has no prompt text. A tool result, a meta or compact summary
+ * record, an interrupt and a slash command are none.
+ */
+export function isUserPrompt(entry) {
+    if (promptOf(entry, { commandFallback: "" }) !== undefined)
+        return true;
+    if (entry.type !== "user" || entry.isMeta === true || entry.isCompactSummary === true) {
+        return false;
+    }
+    const content = entry.message?.content;
+    if (!Array.isArray(content))
+        return false;
+    let media = false;
+    for (const block of content) {
+        if (!block || typeof block !== "object")
+            continue;
+        const { type } = block;
+        if (type === "tool_result")
+            return false;
+        if (type === "image" || type === "document")
+            media = true;
+    }
+    return media;
+}
+function isUserLine(line) {
+    return line.includes('"type":"user"') || line.includes('"type": "user"');
+}
+/** The first prompt of the head, else the first slash command, else "". */
+export function firstPrompt(head) {
+    const state = { commandFallback: "" };
+    for (const line of head.split("\n")) {
+        if (!isUserLine(line))
+            continue;
+        if (line.includes('"tool_result"'))
+            continue;
+        if (line.includes('"isMeta":true') || line.includes('"isMeta": true'))
+            continue;
+        if (line.includes('"isCompactSummary":true') || line.includes('"isCompactSummary": true')) {
+            continue;
+        }
+        let entry;
+        try {
+            entry = JSON.parse(line);
+        }
+        catch {
+            continue;
+        }
+        if (!entry || typeof entry !== "object")
+            continue;
+        const prompt = promptOf(entry, state);
+        if (prompt !== undefined)
+            return prompt;
+    }
+    return state.commandFallback;
+}
+/** `Image` or `Document` for a first user record that holds one, else "". */
+export function mediaPrompt(head) {
+    for (const line of head.split("\n")) {
+        if (!isUserLine(line))
+            continue;
+        if (line.includes('"tool_result"'))
+            continue;
+        if (line.includes('"isMeta":true') || line.includes('"isMeta": true'))
+            continue;
+        if (line.includes('"type":"image"') || line.includes('"type": "image"'))
+            return "Image";
+        if (line.includes('"type":"document"') || line.includes('"type": "document"')) {
+            return "Document";
+        }
+    }
+    return "";
+}

package/dist/session-index/list-subscriptions.d.ts

@@ -0,0 +1,190 @@
+/**
+ * `_session/list/subscribe`: pushes the changed rows of a cwd's session list
+ * to a `sessionIndex` client.
+ *
+ * A subscription covers the sessions of its cwd and of the same subdirectory
+ * in every linked worktree (the `includeWorktrees` scope of the list), in any
+ * archive state. All subscriptions of one cwd share one {@link ScopeWatch}:
+ * a non-recursive `fs.watch` on each project directory of the scope, the
+ * stats of its transcripts, and the row of each session read since. The
+ * registry and the projects root are watched once per connection.
+ *
+ * Subscribe reads no row: it opens the watchers, stats the transcripts and
+ * reads the registry. A row is read on the first
+ * event of its session and sent unconditionally; later rows are compared
+ * with it.
+ *
+ * - A transcript event names the file: only that file is stat'ed and, when
+ *   it changed, its metadata read again (the index's metadata cache and tail
+ *   scan).
+ * - A registry event names the record: only that record is read, and only
+ *   the sessions whose record changed get their `state` recomputed.
+ * - A session this connection runs reports its SDK state at once.
+ *
+ * Events are coalesced: 150 ms after the last one, at most 1 s after the
+ * first. Each subscription compares a recomputed row with the last row it
+ * sent; a change of `updatedAt` alone is no change. A session is sent at most
+ * once a second per subscription. A rescan every 10 s stats the scope again
+ * and reads the transcripts whose stat changed (or whose last read
+ * failed), which covers events `fs.watch` missed;
+ * the state of a live session ages from the metadata the index holds.
+ *
+ * Delivery is best effort: there is no resync and no sequence number; the
+ * client also reads the list now and then.
+ */
+import { type SessionInfo } from "@agentclientprotocol/sdk";
+import type { OwnSessionState } from "./activity.js";
+import { type LiveSessionRegistry } from "./live-registry.js";
+import { type SessionIndex } from "./session-index.js";
+export declare const LIST_SUBSCRIBE_METHOD = "_session/list/subscribe";
+export declare const LIST_UNSUBSCRIBE_METHOD = "_session/list/unsubscribe";
+export declare const LIST_CHANGES_METHOD = "_session/list/changes";
+/** Subscriptions per connection. */
+export declare const MAX_SUBSCRIPTIONS = 128;
+export type ListSubscribeRequest = {
+    cwd: string;
+};
+export type ListSubscribeResponse = {
+    subscriptionId: string;
+};
+export type ListUnsubscribeRequest = {
+    subscriptionId: string;
+};
+export type ListChanges = {
+    subscriptionId: string;
+    sessions: SessionInfo[];
+    removed: string[];
+};
+/** `{ cwd }`: an absolute path. Other parameters are ignored. */
+export declare function parseListSubscribeRequest(value: unknown): ListSubscribeRequest;
+/** `{ subscriptionId }`. */
+export declare function parseListUnsubscribeRequest(value: unknown): ListUnsubscribeRequest;
+export type ListSubscriptionDeps = {
+    index: Pick<SessionIndex, "listedPaths" | "projectDirs" | "enumerateFiles" | "rowsOf" | "cachedRowsOf" | "continuedIn" | "isRead">;
+    registry: Pick<LiveSessionRegistry, "readFiles">;
+    /** What this connection knows of a session it runs. */
+    own: (sessionId: string) => OwnSessionState | undefined;
+    notify: (changes: ListChanges) => Promise<void>;
+    logError: (message: string, error: unknown) => void;
+    now?: () => number;
+    debounceMs?: number;
+    maxWaitMs?: number;
+    rescanMs?: number;
+    minSessionIntervalMs?: number;
+};
+export declare class ListSubscriptions {
+    private readonly deps;
+    private readonly subscriptions;
+    /** Sessions whose row shows this connection's SDK state: the rescan
+     *  presents them again, in case a change of it was not reported. */
+    private readonly ownShown;
+    private readonly watches;
+    private readonly shared;
+    /** The directory each shared watcher watches (see {@link dirIdentity}). */
+    private readonly sharedIdentity;
+    /** The nearest existing ancestor of each shared directory that does not
+     *  exist yet, watched for its creation. */
+    private readonly ancestors;
+    private rescanTimer?;
+    /** The live records by registry file name. */
+    private liveFiles;
+    private live;
+    private registryLoaded?;
+    private registryNames;
+    private registryFull;
+    private registryDebounce?;
+    private registryMaxWait?;
+    private registryWorking?;
+    private disposed;
+    /** Orders subscriptions and session births (see {@link ScopeWatch.born}). */
+    private seq;
+    private readonly now;
+    private readonly debounceMs;
+    private readonly maxWaitMs;
+    private readonly rescanMs;
+    private readonly minIntervalMs;
+    constructor(deps: ListSubscriptionDeps);
+    /** Subscribes to the sessions of `cwd`. Changes are tracked from the
+     *  return on. Reads no row (see {@link createWatch}). */
+    subscribe(cwd: string): Promise<ListSubscribeResponse>;
+    /** Idempotent: an unknown id is no error. */
+    unsubscribe(subscriptionId: string): void;
+    /** A session this connection runs changed its state, turn end or cost. */
+    ownSessionChanged(id: string): void;
+    dispose(): void;
+    /** The open watchers and armed timers, for tests and diagnostics. */
+    openHandles(): {
+        watches: number;
+        watchers: number;
+        timers: number;
+    };
+    private createWatch;
+    private closeWatch;
+    /** The registry and the projects root, watched once for all cwds, and the
+     *  rescan. */
+    private ensureShared;
+    /** Watches the nearest existing ancestor of each of `missing` (a config
+     *  directory without `projects` or `sessions` yet): any event there checks
+     *  again. */
+    private watchAncestors;
+    private stopShared;
+    private rescanAll;
+    private onTranscriptEvent;
+    /** A project directory that a scope lacked may have been created. */
+    private onProjectsRootEvent;
+    private onRegistryEvent;
+    /**
+     * Runs the work of `watch`: `debounced` after the quiet period, `now` at
+     * once, and `states` at once for the recomputed states only, leaving the
+     * transcript events to their quiet period (a registry that changes every
+     * 200 ms then does not read the transcripts that often).
+     */
+    private schedule;
+    private clearWatchTimers;
+    private scheduleRegistry;
+    private registryWork;
+    /** Reads the changed registry records (all with `full`) and returns the
+     *  ids of the sessions whose record changed. */
+    private readRegistry;
+    private onLiveChanged;
+    /** Reads the scope paths and watches their project directories. */
+    private refreshDirs;
+    private setFiles;
+    /** `known`: the sessions with a transcript before; another one is born. */
+    private putFile;
+    private dropFile;
+    private present;
+    /** Runs one pass of the pending work of `watch`, one at a time. `files`:
+     *  the transcript events and the rescan too, not only the states. */
+    private work;
+    private pass;
+    /** Records which session each transcript is continued in, by the metadata
+     *  the index holds now (a list read it): kept when the index evicts it.
+     *  Reads nothing. */
+    private learnSuccessors;
+    /**
+     * The rows of the live sessions of the scope without a row here (and not
+     * in `except`), from the metadata the index holds (a list read them), not
+     * from their transcripts; one it holds nothing for the client did not
+     * list. Reads no transcript: a continued one only checks its successor.
+     */
+    private liveSeeds;
+    /** The transcripts of a session the watch knows. */
+    private filesOf;
+    /**
+     * Which of `ids`, without a row read here, may have had a row in the scope
+     * before: those that the metadata the index holds for their earlier
+     * transcripts (a list read them) gives a row, and those it gives no answer
+     * for (unknown: a removal is sent once). Not a session without a
+     * transcript before, nor one known to have had no row (another path of
+     * the project directory, a hidden session). Reads no transcript.
+     */
+    private shownBefore;
+    /** Sends the pending sessions of `subscription` that differ from what it
+     *  last sent (a session never sent differs), each at most once per
+     *  interval, in one notification. */
+    private deliver;
+    /** Drops send times older than the interval: they hold nothing back. */
+    private forgetOldSends;
+}
+//# sourceMappingURL=list-subscriptions.d.ts.map

package/dist/session-index/list-subscriptions.d.ts.map

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