claude-code-infinite 1.0.11 → 1.0.16

package/dist/count-tokens.js

@@ -0,0 +1,277 @@
+/**
+ * Exact input-token counts from Anthropic's Count Tokens endpoint, made with
+ * the user's own credentials, for the size estimates that decide compaction
+ * and the fallback refusal (route-fallback.ts).
+ *
+ * The proxy normally sizes a request from an earlier response's reported
+ * usage (a tokens-per-byte sample). That sample can be missing (a fresh proxy
+ * after a resume), stale (a big jump of new content of unknown density), or
+ * wrong for the request at hand: on 2026-10-05 a 979-byte web-search helper
+ * reported 12,040 input tokens (server-side search results count as input),
+ * and the 12 tokens/byte it taught its lane sized the next 169,507-byte
+ * subagent request at 2.08M tokens and refused it. Counting is free but costs
+ * a round trip that re-uploads the body, so it runs only where the estimate
+ * is unknown or decides the outcome, never on every request.
+ */
+import { createHash } from "node:crypto";
+import https from "node:https";
+import { approxTokensFromBytes } from "./reqlog.js";
+/** Bound on a count call: past it the caller keeps its estimate. */
+export const COUNT_TOKENS_TIMEOUT_MS = 3_000;
+const MAX_COUNT_RESPONSE_BYTES = 64 * 1024;
+const MAX_COUNT_COOLDOWNS = 128;
+const COUNT_COOLDOWN_MS = 60_000;
+/**
+ * Plausible tokens per byte for a sample. Text runs ~0.25-0.5. Above 1 the
+ * sample measured something other than the body (server tool results), as on
+ * 2026-10-05 (12 tokens/byte). The floor is loose on purpose: base64 images
+ * are very cheap per byte (a ~1.5MB screenshot is ~1.6k tokens), so a
+ * screenshot-heavy session can sit well under 0.1 and must stay calibrated
+ * rather than be counted on every request.
+ */
+export const MIN_PLAUSIBLE_TOKENS_PER_BYTE = 0.02;
+export const MAX_PLAUSIBLE_TOKENS_PER_BYTE = 1;
+/** With no usable sample, count once bytes/4 reaches this share of the budget. */
+const UNCALIBRATED_COUNT_SHARE = 0.4;
+/** With a sample, count a jump of new content once the estimate nears the budget. */
+const NEAR_BUDGET_SHARE = 0.85;
+/** Growth since the sample (bytes/4) that counts as a jump, as a share of the budget. */
+const JUMP_BUDGET_SHARE = 0.05;
+/** Request fields Count Tokens accepts; others (max_tokens, stream, ...) it rejects. */
+const COUNTABLE_FIELDS = [
+    "model", "messages", "system", "tools", "tool_choice", "thinking",
+    "context_management", "output_config", "output_format", "cache_control",
+    "mcp_servers", "speed", "compaction",
+];
+/** Whether a sample's tokens-per-byte ratio can describe a request body. */
+export function plausibleSample(sample) {
+    if (!sample || !(sample.tokens > 0) || !(sample.forwardedBytes > 0))
+        return false;
+    const ratio = sample.tokens / sample.forwardedBytes;
+    return ratio >= MIN_PLAUSIBLE_TOKENS_PER_BYTE && ratio <= MAX_PLAUSIBLE_TOKENS_PER_BYTE;
+}
+/**
+ * Whether to count a request of `bytes` before deciding on it: with no usable
+ * sample once its estimate is a real share of the budget, and with one only
+ * after a jump of new content brings it near the budget. Small growth on a
+ * calibrated sample is estimated well and is not counted.
+ */
+export function shouldCountTokens(sample, bytes, estimateTokens, budgetTokens) {
+    if (!(budgetTokens > 0))
+        return false;
+    if (!plausibleSample(sample))
+        return estimateTokens >= UNCALIBRATED_COUNT_SHARE * budgetTokens;
+    if (bytes <= sample.forwardedBytes)
+        return false;
+    const addedTokens = approxTokensFromBytes(bytes - sample.forwardedBytes);
+    return addedTokens >= JUMP_BUDGET_SHARE * budgetTokens &&
+        estimateTokens >= NEAR_BUDGET_SHARE * budgetTokens;
+}
+/** Shared per proxy; only hashes of account/upstream identity are stored. */
+export class CountTokensCooldowns {
+    capacity;
+    now;
+    entries = new Map();
+    constructor(capacity = MAX_COUNT_COOLDOWNS, now = Date.now) {
+        this.capacity = capacity;
+        this.now = now;
+    }
+    active(key) {
+        const until = this.entries.get(key);
+        if (until === undefined)
+            return false;
+        if (until > this.now())
+            return true;
+        this.entries.delete(key);
+        return false;
+    }
+    record(key, result) {
+        if (![401, 403, 429].includes(result.status ?? 0))
+            return;
+        const now = this.now();
+        for (const [entry, until] of this.entries)
+            if (until <= now)
+                this.entries.delete(entry);
+        this.entries.delete(key);
+        if (this.capacity <= 0)
+            return;
+        while (this.entries.size >= this.capacity)
+            this.entries.delete(this.entries.keys().next().value);
+        this.entries.set(key, now + cooldownDuration(result.retryAfter, now));
+    }
+}
+/** Exact results belong to this request and body, never a shared sample slot. */
+export function createCountTokensSession(options, cooldowns = new CountTokensCooldowns()) {
+    const pending = new Map();
+    const completed = new Map();
+    const account = countAccountKey(options);
+    let deadline;
+    return {
+        peek: (body) => completed.get(bodyHash(body)),
+        count: (body) => {
+            const key = bodyHash(body);
+            const existing = pending.get(key);
+            if (existing)
+                return existing;
+            deadline ??= Date.now() + (options.timeoutMs ?? COUNT_TOKENS_TIMEOUT_MS);
+            const remaining = deadline - Date.now();
+            const skipped = options.signal?.aborted ? "aborted"
+                : cooldowns.active(account) ? "cooldown" : remaining <= 0 ? "deadline" : undefined;
+            const attempt = skipped
+                ? Promise.resolve({ ms: 0, outcome: skipped })
+                : countUpstreamTokens({ ...options, body, timeoutMs: remaining }).then((result) => {
+                    cooldowns.record(account, result);
+                    if (result.outcome !== "invalid-request" && result.outcome !== "deadline") {
+                        try {
+                            options.onAttempt?.(result);
+                        }
+                        catch { /* diagnostics cannot break forwarding */ }
+                    }
+                    return result;
+                });
+            const saved = attempt.then((result) => { completed.set(key, result); return result; });
+            pending.set(key, saved);
+            return saved;
+        },
+    };
+}
+/** All failures resolve without tokens, including synchronous request errors. */
+export function countUpstreamTokens(args) {
+    const started = Date.now();
+    const payload = countTokensBody(args.body);
+    if (!payload || args.signal?.aborted)
+        return Promise.resolve({
+            ms: 0, outcome: args.signal?.aborted ? "aborted" : "invalid-request",
+        });
+    const remaining = (args.timeoutMs ?? COUNT_TOKENS_TIMEOUT_MS) - (Date.now() - started);
+    if (remaining <= 0)
+        return Promise.resolve({ ms: Date.now() - started, outcome: "deadline" });
+    return new Promise((resolve) => {
+        let done = false;
+        let request;
+        let timer;
+        const finish = (result) => {
+            if (done)
+                return;
+            done = true;
+            clearTimeout(timer);
+            args.signal?.removeEventListener("abort", abort);
+            resolve({ ...result, ms: Date.now() - started });
+            request?.destroy();
+        };
+        const abort = () => finish({ outcome: "aborted" });
+        timer = setTimeout(() => finish({ outcome: "timeout" }), remaining);
+        args.signal?.addEventListener("abort", abort, { once: true });
+        try {
+            request = args.upstream.module.request({
+                host: args.upstream.host,
+                port: args.upstream.port,
+                method: "POST",
+                path: countTokensPath(args.requestUrl),
+                headers: countTokensHeaders(args.headers, payload.length),
+            }, (res) => readCount(res, finish));
+            request.on("error", () => finish({ outcome: "network-error" }));
+            if (args.signal?.aborted)
+                abort();
+            else
+                request.end(payload);
+        }
+        catch {
+            finish({ outcome: "network-error" });
+        }
+    });
+}
+/** The countable subset of a Messages request body, or null if it is not one. */
+export function countTokensBody(body) {
+    try {
+        const parsed = JSON.parse(body.toString("utf-8"));
+        if (!parsed || !Array.isArray(parsed.messages))
+            return null;
+        const countable = {};
+        for (const field of COUNTABLE_FIELDS) {
+            if (parsed[field] !== undefined)
+                countable[field] = parsed[field];
+        }
+        return Buffer.from(JSON.stringify(countable), "utf-8");
+    }
+    catch {
+        return null;
+    }
+}
+/** The Messages request's path with `/count_tokens` appended, query kept. */
+export function countTokensPath(requestUrl) {
+    const url = new URL(requestUrl ?? "/v1/messages", "http://127.0.0.1");
+    url.pathname = `${url.pathname.replace(/\/+$/, "")}/count_tokens`;
+    return `${url.pathname}${url.search}`;
+}
+function countTokensHeaders(headers, length) {
+    const out = {};
+    for (const [key, value] of Object.entries(headers)) {
+        const lower = key.toLowerCase();
+        if (lower === "content-length" || lower === "accept-encoding")
+            continue;
+        out[key] = value;
+    }
+    out["content-length"] = String(length);
+    out["content-type"] = "application/json";
+    out["accept-encoding"] = "identity";
+    return out;
+}
+function readCount(res, done) {
+    const status = res.statusCode;
+    res.on("error", () => done({ outcome: "network-error", status }));
+    res.on("aborted", () => done({ outcome: "network-error", status }));
+    if (status !== 200) {
+        const outcome = status === 401 || status === 403 ? "auth"
+            : status === 429 ? "rate-limit" : status !== undefined && status >= 500
+                ? "server-error" : "http-error";
+        done({ outcome, status, retryAfter: res.headers["retry-after"] });
+        res.destroy();
+        return;
+    }
+    const chunks = [];
+    let bytes = 0;
+    res.on("data", (chunk) => {
+        bytes += chunk.length;
+        if (bytes > MAX_COUNT_RESPONSE_BYTES) {
+            done({ outcome: "invalid-response", status });
+            res.destroy();
+        }
+        else
+            chunks.push(chunk);
+    });
+    res.on("end", () => {
+        try {
+            const tokens = JSON.parse(Buffer.concat(chunks).toString("utf-8"))?.input_tokens;
+            if (typeof tokens === "number" && Number.isSafeInteger(tokens) && tokens >= 0) {
+                done({ tokens, outcome: "success", status });
+            }
+            else
+                done({ outcome: "invalid-response", status });
+        }
+        catch {
+            done({ outcome: "invalid-response", status });
+        }
+    });
+}
+function bodyHash(body) {
+    return createHash("sha256").update(body).digest("hex");
+}
+function countAccountKey(options) {
+    const credentials = Object.entries(options.headers)
+        .filter(([key]) => ["authorization", "x-api-key"].includes(key.toLowerCase()))
+        .map(([key, value]) => [key.toLowerCase(), value]).sort();
+    return bodyHash(Buffer.from(JSON.stringify([
+        options.upstream.module.globalAgent === https.globalAgent ? "https" : "http", options.upstream.host,
+        options.upstream.port, credentials,
+    ])));
+}
+function cooldownDuration(retryAfter, now) {
+    if (!retryAfter)
+        return COUNT_COOLDOWN_MS;
+    const seconds = Number(retryAfter);
+    const duration = Number.isFinite(seconds) ? seconds * 1000 : Date.parse(retryAfter) - now;
+    return Number.isFinite(duration)
+        ? Math.max(1000, Math.min(COUNT_COOLDOWN_MS, duration)) : COUNT_COOLDOWN_MS;
+}
+//# sourceMappingURL=count-tokens.js.map

package/dist/count-tokens.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"count-tokens.js","sourceRoot":"","sources":["../src/count-tokens.ts"],"names":[],"mappings":"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"}

package/dist/final-index.d.ts

@@ -0,0 +1,10 @@
+import { type Message } from "./turns.js";
+export type FinalReplyReader = (signal?: AbortSignal) => Message | undefined | Promise<Message | undefined>;
+export declare function prepareFinalMessages(messages: Message[], signal: AbortSignal): Promise<{
+    messages: Message[];
+    retained: Message[];
+    key: string;
+    serialized: string;
+}>;
+export declare function readFinalReply(reader: FinalReplyReader | undefined, signal: AbortSignal): Promise<Message | undefined>;
+//# sourceMappingURL=final-index.d.ts.map

package/dist/final-index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"final-index.d.ts","sourceRoot":"","sources":["../src/final-index.ts"],"names":[],"mappings":"AAGA,OAAO,EAA0B,KAAK,OAAO,EAAE,MAAM,YAAY,CAAC;AAElE,MAAM,MAAM,gBAAgB,GAAG,CAAC,MAAM,CAAC,EAAE,WAAW,KAClD,OAAO,GAAG,SAAS,GAAG,OAAO,CAAC,OAAO,GAAG,SAAS,CAAC,CAAC;AAErD,wBAAsB,oBAAoB,CAAC,QAAQ,EAAE,OAAO,EAAE,EAAE,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC;IAC5F,QAAQ,EAAE,OAAO,EAAE,CAAC;IAAC,QAAQ,EAAE,OAAO,EAAE,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;CAC3E,CAAC,CAgBD;AAED,wBAAsB,cAAc,CAAC,MAAM,EAAE,gBAAgB,GAAG,SAAS,EACrC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,OAAO,GAAG,SAAS,CAAC,CAYrF"}

package/dist/final-index.js

@@ -0,0 +1,37 @@
+/** Cooperative final-index preparation, covered by the background abort signal. */
+import { createHash } from "node:crypto";
+import { setImmediate as yieldTurn } from "node:timers/promises";
+import { stripCcSystemReminders } from "./turns.js";
+export async function prepareFinalMessages(messages, signal) {
+    const hash = createHash("sha256").update("[");
+    const cleaned = [], retained = [], serialized = [];
+    for (let i = 0; i < messages.length; i++) {
+        await yieldTurn(undefined, { signal });
+        hash.update((i ? "," : "") + JSON.stringify(messages[i]));
+        const [message] = stripCcSystemReminders([messages[i]]);
+        if (message) {
+            cleaned.push(message);
+            retained.push(messages[i]);
+            serialized.push(JSON.stringify(message));
+        }
+    }
+    signal.throwIfAborted();
+    return { messages: cleaned, retained, key: hash.update("]").digest("hex"),
+        serialized: `[${serialized.join(",")}]` };
+}
+export async function readFinalReply(reader, signal) {
+    await yieldTurn(undefined, { signal });
+    if (!reader)
+        return undefined;
+    // An unreadable transcript is optional. Cancellation is not: do not send
+    // a late request after exit or after a new main-lane request superseded it.
+    return new Promise((resolve, reject) => {
+        const abort = () => reject(signal.reason ?? new Error("final index aborted"));
+        signal.addEventListener("abort", abort, { once: true });
+        Promise.resolve().then(() => reader(signal)).then(resolve, () => resolve(undefined))
+            .finally(() => signal.removeEventListener("abort", abort));
+        if (signal.aborted)
+            abort();
+    });
+}
+//# sourceMappingURL=final-index.js.map

package/dist/final-index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"final-index.js","sourceRoot":"","sources":["../src/final-index.ts"],"names":[],"mappings":"AAAA,mFAAmF;AACnF,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,YAAY,IAAI,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACjE,OAAO,EAAE,sBAAsB,EAAgB,MAAM,YAAY,CAAC;AAKlE,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,QAAmB,EAAE,MAAmB;IAGjF,MAAM,IAAI,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IAC9C,MAAM,OAAO,GAAc,EAAE,EAAE,QAAQ,GAAc,EAAE,EAAE,UAAU,GAAa,EAAE,CAAC;IACnF,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,QAAQ,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACzC,MAAM,SAAS,CAAC,SAAS,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;QACvC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAC1D,MAAM,CAAC,OAAO,CAAC,GAAG,sBAAsB,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACxD,IAAI,OAAO,EAAE,CAAC;YACZ,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YACtB,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;YAC3B,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC;QAC3C,CAAC;IACH,CAAC;IACD,MAAM,CAAC,cAAc,EAAE,CAAC;IACxB,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,QAAQ,EAAE,GAAG,EAAE,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;QACvE,UAAU,EAAE,IAAI,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC;AAC9C,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,MAAoC,EACrC,MAAmB;IACrD,MAAM,SAAS,CAAC,SAAS,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;IACvC,IAAI,CAAC,MAAM;QAAE,OAAO,SAAS,CAAC;IAC9B,yEAAyE;IACzE,4EAA4E;IAC5E,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,MAAM,KAAK,GAAG,GAAG,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,IAAI,IAAI,KAAK,CAAC,qBAAqB,CAAC,CAAC,CAAC;QAC9E,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;QACxD,OAAO,CAAC,OAAO,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;aACjF,OAAO,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,mBAAmB,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC;QAC7D,IAAI,MAAM,CAAC,OAAO;YAAE,KAAK,EAAE,CAAC;IAC9B,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/hooks.d.ts

@@ -0,0 +1,239 @@
+/**
+ * Display-only Claude Code hook support for MemTree notices.
+ *
+ * Notices must never be represented as Anthropic assistant content: Claude
+ * Code can reuse that content for hidden requests such as away recaps. Modern
+ * Claude Code releases provide MessageDisplay, whose output changes only the
+ * rendered delta. Stop's top-level systemMessage is the fallback for turns
+ * that never render text (for example, a tool-only response).
+ */
+export declare const MESSAGE_DISPLAY_MIN_VERSION = "2.1.166";
+/** Trailer labels; kept here so hooks.ts stays free of notices.ts imports. */
+export declare const TRAILER_LABEL = "\u2022 MemTree \u00B7";
+/** Label on a line that carries a MemTree page link. */
+export declare const LINK_LABEL = "\u2022 MemTree";
+/**
+ * A MemTree link notice: the label (and note, if any) on the first line and
+ * the URL alone, indented, on the next, so a long URL wraps on its own
+ * rather than dragging the label or note onto a second line. Label and note
+ * come pre-styled; the URL stays bare for the terminal's linkifier.
+ */
+export declare function linkLines(label: string, url: string, note?: string): string;
+export declare const DEFAULT_NOTICE_TTL_MS: number;
+/**
+ * `/memtree`: list the MemTree commands. The link label reads `/memtree` as a
+ * hint, and typing it exactly must not dead-end in "Unknown command".
+ */
+export declare const MEMTREE_HELP_COMMAND = "memtree";
+/** The session plugin's name, which prefixes its commands in Claude Code's menu. */
+export declare const SESSION_PLUGIN_NAME = "ccc";
+/** `/memtree-view`: print this session's MemTree page link. */
+export declare const MEMTREE_VIEW_COMMAND = "memtree-view";
+/**
+ * `/memtree-compact [tokens|off]`: compact this session on its next message
+ * and keep that compressed history until the budget is reached again.
+ */
+export declare const MEMTREE_COMPACT_COMMAND = "memtree-compact";
+/**
+ * The arguments of a submitted `/<name>` (bare or `/ccc:`-qualified), or
+ * undefined when the prompt is not that command.
+ */
+export declare function sessionCommandArgs(prompt: string, name: string): string | undefined;
+export declare function isMemtreeViewCommand(prompt: string): boolean;
+type NoticeText = string | (() => string);
+/**
+ * Resolves the link appended to the success line for a session at claim
+ * time, or undefined when there is none. Evaluated lazily so the newest
+ * value (for example a MemTree page whose index finished during the tool
+ * loop) is what the user sees. The link is rendered unstyled after the
+ * styled text: Claude Code linkifies bare URLs and would swallow a trailing
+ * SGR reset into the link text.
+ */
+type LinkResolver = (sessionId: string | undefined) => SuccessLink | undefined;
+/** A link to show on the success line, shown once per distinct `key`. */
+export interface SuccessLink {
+    /** What makes this link news — e.g. the index it stands for, not its URL. */
+    key: string;
+    link: string;
+    /**
+     * A short hint shown after the link, e.g.
+     * "not used to compress this session" when the turn behind the page was
+     * passed through whole.
+     */
+    note?: string;
+}
+/**
+ * Where the trailer (`• MemTree · <link>`) is shown: under every finished
+ * assistant message (with Stop as the fallback for a turn that rendered no
+ * text), or on Stop only, once per turn.
+ */
+export type TrailerPlacement = "message" | "stop" | "turn";
+interface ColorCapableStream {
+    hasColors?: (count?: number, env?: NodeJS.ProcessEnv) => boolean;
+}
+/** Respect explicit monochrome settings and Node's platform color detection. */
+export declare function terminalSupportsColor(env?: NodeJS.ProcessEnv, stream?: ColorCapableStream): boolean;
+/** Evaluated in the proxy's terminal, not the hook relay's piped stdout. */
+export declare function terminalSupportsHyperlinks(env?: NodeJS.ProcessEnv, stream?: {
+    isTTY?: boolean;
+}): boolean;
+export interface MessageDisplayHookInput {
+    hook_event_name: "MessageDisplay";
+    session_id: string;
+    turn_id: string;
+    message_id: string;
+    index: number;
+    final: boolean;
+    delta: string;
+    prompt_id?: string;
+    agent_id?: string;
+}
+export interface StopHookInput {
+    hook_event_name: "Stop";
+    session_id: string;
+    stop_hook_active?: boolean;
+    prompt_id?: string;
+    agent_id?: string;
+}
+export interface UserPromptSubmitHookInput {
+    hook_event_name: "UserPromptSubmit";
+    session_id: string;
+    prompt: string;
+    prompt_id?: string;
+    agent_id?: string;
+}
+export interface SubagentLifecycleHookInput {
+    hook_event_name: "SubagentStart" | "SubagentStop";
+    session_id: string;
+    agent_id: string;
+    agent_type?: string;
+    prompt_id?: string;
+}
+export interface SessionStartHookInput {
+    hook_event_name: "SessionStart";
+    session_id: string;
+    /** "startup" | "resume" | "clear" | "compact" | "fork". */
+    source?: string;
+    agent_id?: string;
+    prompt_id?: string;
+}
+export type NoticeHookInput = MessageDisplayHookInput | StopHookInput | UserPromptSubmitHookInput | SubagentLifecycleHookInput | SessionStartHookInput;
+export type MessageDisplayHookOutput = {
+    hookSpecificOutput: {
+        hookEventName: "MessageDisplay";
+        displayContent: string;
+    };
+};
+export type StopHookOutput = {
+    systemMessage: string;
+};
+export type NoticeHookOutput = MessageDisplayHookOutput | StopHookOutput;
+/**
+ * Single-session delivery queue. Claude Code serializes main-thread turns, so
+ * one replaceable pending notice is sufficient. A new user request clears any
+ * stale notice; tool-result requests deliberately do not.
+ */
+export declare class NoticeDeliveryQueue {
+    private readonly ttlMs;
+    private readonly now;
+    private readonly color;
+    private pending;
+    private link;
+    /** Key of the last link shown; the same key is not repeated. */
+    private readonly delivered;
+    private trailer;
+    private trailerPlacement;
+    /** Key of the last trailer shown; a different key is announced as new. */
+    constructor(ttlMs?: number, now?: () => number, color?: boolean);
+    /** Replace stale delivery state when a new main human prompt is submitted. */
+    clearForUserRequest(): void;
+    /**
+     * Install the per-session link that rides the success line, shown once per
+     * change: `<success text> · <link>`. Unlike prefix/suffix notices it is
+     * not per-prompt; it describes the conversation's current state whenever a
+     * success line is next shown.
+     */
+    setLink(resolve: LinkResolver | null): void;
+    /**
+     * The link line for a resumed session, shown by the SessionStart hook
+     * before any new turn. Marks the key as shown, so the next trailer under a
+     * message renders dim (unchanged) rather than green (new).
+     */
+    resumeLine(link: SuccessLink, sessionId?: string): string;
+    /** Whether the next success line would carry a link not shown before. */
+    linkPending(sessionId: string | undefined): boolean;
+    /**
+     * Install the trailer: the newest link for the session, shown after every
+     * message (or on every Stop), the first time under a new `key` marked as
+     * new. Not once-per-key like the success-line link: the point is that the
+     * link is always at the bottom of the screen.
+     */
+    setTrailer(resolve: LinkResolver | null, placement?: TrailerPlacement): void;
+    queuePrefix(text: NoticeText, onDelivered?: () => void, promptId?: string): void;
+    queueSuffix(text: NoticeText, onDelivered?: () => void, promptId?: string): void;
+    /**
+     * Claim eligible notice parts atomically for one hook invocation. Subagent
+     * hooks share the plugin but must never consume the main turn's notice.
+     */
+    claim(input: NoticeHookInput): NoticeHookOutput | null;
+    private claimForDisplay;
+    private promptMatches;
+    private styleSuccess;
+    /** Warnings get the same own-line treatment as success, in yellow. */
+    private styleWarning;
+    /**
+     * The success line with the session's current MemTree page on its own
+     * indented line below it (`✓ … optimized · ~813k → 408k tokens` then
+     * `  <link>`), every time the line is shown. The URL stays bare for the
+     * terminal's linkifier. Marks the key shown, so the end-of-turn trailer
+     * does not repeat the same link.
+     */
+    private renderSuccess;
+    /** The session's current link, shown or not. Resolver failures never break a hook. */
+    private currentLink;
+    /** The link if its key changed since last shown, without marking it. Resolver failures never break a hook. */
+    private resolveLink;
+    /**
+     * The trailer line for this session, or undefined when there is no link.
+     * The first time a key is seen the label says so in green; afterwards the
+     * label is dim. The URL stays bare either way (linkifier-safe). Rendering
+     * marks the key as seen. Resolver failures never break a hook.
+     */
+    private renderTrailer;
+    /** The link notice with its note dim. */
+    private linkNotice;
+    private styleDim;
+    private deliveryFor;
+    private style;
+    private freshPending;
+    private dropIfEmpty;
+}
+/** Strictly validate the subset of Claude hook input that delivery relies on. */
+export declare function parseNoticeHookInput(value: unknown): NoticeHookInput | null;
+export interface SessionNoticePlugin {
+    dir: string;
+    close(): void;
+}
+/** Prepend the repeatable global option without disturbing any user argv. */
+export declare function withSessionNoticePluginArgs(args: readonly string[], pluginDir: string): string[];
+/**
+ * Build a minimal session-only plugin. --plugin-dir is repeatable, unlike
+ * --settings (where Claude keeps only the final occurrence), so this composes
+ * with all user settings and hooks.
+ */
+export declare function createSessionNoticePlugin(hookUrl: string, opts?: {
+    messageDisplay?: boolean;
+    tempRoot?: string;
+    /** Session banner, rendered by Claude Code under a "SessionStart:… says:" label. */
+    startupMessage?: string;
+    /**
+     * Forward SessionStart(resume) to the proxy so a resumed session shows
+     * its MemTree link. SessionStart accepts no `http` hooks, so a tiny Node
+     * script (run with this process's own Node) relays stdin to `hookUrl`.
+     */
+    resumeLink?: boolean;
+}): SessionNoticePlugin;
+/** Return true only for known Claude versions that support MessageDisplay. */
+export declare function supportsMessageDisplay(versionOutput: string): boolean;
+export {};
+//# sourceMappingURL=hooks.d.ts.map

package/dist/hooks.d.ts.map

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