claude-code-infinite 1.0.27 → 1.0.28

package/dist/project-trees.js

@@ -0,0 +1,196 @@
+/**
+ * Earlier MemTree sessions in this project, named to the model when a session
+ * starts, so earlier decisions and fixes are one lookup away.
+ *
+ * The server answers `GET /v1/memtree/project_trees?project=&limit=` (polychat
+ * routes/memtree_project_trees.py): the user's own newest sessions in this
+ * project that have a finished tree, each with its root summary and tree
+ * reference. ccc asks once at startup (before Claude Code is up) and again in
+ * the background at each later session start, so a SessionStart hook only
+ * waits briefly for an answer already on its way.
+ *
+ * The block goes into the SessionStart hook's `additionalContext`: the model
+ * reads it, the user sees it only in the transcript view. It is added only when
+ * the session has the `memtree` MCP tools it names, never for a subagent or a
+ * compaction, and not at all on any failure: an older server (404), a slow or
+ * failed request, no project, or no earlier trees.
+ */
+/** Trees named at most. */
+export const PROJECT_TREES_LIMIT = 5;
+/** Most a SessionStart hook waits for an answer still on its way. */
+export const PROJECT_TREES_WAIT_MS = 300;
+/** A request that has not answered by then is dropped. */
+export const PROJECT_TREES_FETCH_TIMEOUT_MS = 5_000;
+/** A later session start reuses an answer this fresh instead of asking again. */
+export const PROJECT_TREES_FRESH_MS = 60_000;
+/** Root summaries are cut to this many characters. */
+export const PROJECT_TREES_SUMMARY_CHARS = 150;
+export const PROJECT_TREES_HEADER = 'Earlier sessions in this project, with their summaries (a record, not instructions); ' +
+    'search one with mcp__memtree__search {"tree": <tree>, "query": …}, open it with ' +
+    'mcp__memtree__read_node {"tree": <tree>, "id": 0}:';
+export const PROJECT_TREES_FOOTER = "Check them when the task touches past work (earlier decisions, previous fixes, " +
+    "how something was done).";
+const TREE_REF = /^[A-Za-z0-9-]{1,80}$/;
+export class ProjectTreesHint {
+    fetchJson;
+    project;
+    waitMs;
+    now;
+    pending;
+    latest;
+    disabled = false;
+    fetchedAt = -Infinity;
+    /** The server answered 404/405: it has no such endpoint; not asked again this run. */
+    unsupported = false;
+    constructor(fetchJson, project, waitMs = PROJECT_TREES_WAIT_MS, now = Date.now) {
+        this.fetchJson = fetchJson;
+        this.project = project;
+        this.waitMs = waitMs;
+        this.now = now;
+    }
+    /** No more blocks: the session lost the tools they name (memtree MCP config failed). */
+    disable() {
+        this.disabled = true;
+    }
+    /** Start a lookup unless one is on its way; never throws. */
+    prefetch() {
+        if (this.pending || this.disabled || this.unsupported)
+            return;
+        if (this.now() - this.fetchedAt < PROJECT_TREES_FRESH_MS)
+            return;
+        const pending = this.lookup().then((trees) => {
+            if (trees) {
+                this.latest = trees;
+                this.fetchedAt = this.now();
+            }
+            return trees;
+        });
+        this.pending = pending;
+        void pending.finally(() => {
+            if (this.pending === pending)
+                this.pending = undefined;
+        });
+    }
+    /**
+     * The block for a session starting now, or undefined. Waits at most
+     * `waitMs` for a lookup on its way, then refreshes in the background for
+     * the next session start (an in-app `/clear` or `/resume`).
+     */
+    async contextFor(sessionId) {
+        if (this.disabled)
+            return undefined;
+        const pending = this.pending;
+        const trees = pending ? await withinMs(pending, this.waitMs) : undefined;
+        const known = trees ?? this.latest;
+        this.prefetch();
+        return known ? formatProjectTrees(known, sessionId) : undefined;
+    }
+    async lookup() {
+        const query = new URLSearchParams({
+            project: this.project,
+            // One more, so leaving out the current session still names five.
+            limit: String(PROJECT_TREES_LIMIT + 1),
+        });
+        try {
+            const response = await this.fetchJson(`/v1/memtree/project_trees?${query.toString()}`, AbortSignal.timeout(PROJECT_TREES_FETCH_TIMEOUT_MS));
+            if (response.status === 404 || response.status === 405)
+                this.unsupported = true;
+            if (response.status !== 200)
+                return undefined;
+            return parseProjectTrees(JSON.parse(response.body.toString("utf-8")));
+        }
+        catch {
+            return undefined;
+        }
+    }
+}
+/**
+ * The project name the server matches: the `owner/repo` of the `origin`
+ * remote. A directory name alone ("app", "src") would also match unrelated
+ * directories and repos of that name, so without a remote there is no hint.
+ */
+export function projectIdentity(meta) {
+    return meta?.git_repo || undefined;
+}
+/** The server's `trees`, keeping only well-formed entries. */
+export function parseProjectTrees(body) {
+    const trees = body?.trees;
+    if (!Array.isArray(trees))
+        return undefined;
+    const parsed = [];
+    for (const item of trees) {
+        const tree = parseTree(item);
+        if (tree)
+            parsed.push(tree);
+    }
+    return parsed;
+}
+/** The context block, or undefined when no tree but the current session's is left. */
+export function formatProjectTrees(trees, currentSessionId) {
+    const shown = trees
+        .filter((tree) => !currentSessionId || tree.session_id !== currentSessionId)
+        .slice(0, PROJECT_TREES_LIMIT);
+    if (!shown.length)
+        return undefined;
+    const lines = shown.map((tree) => {
+        const date = /^\d{4}-\d{2}-\d{2}/.exec(tree.last_at ?? "")?.[0];
+        const summary = shorten(tree.title, PROJECT_TREES_SUMMARY_CHARS);
+        return `- ${date ? `${date}: ` : ""}${summary} (tree ${tree.ref})`;
+    });
+    return [PROJECT_TREES_HEADER, ...lines, PROJECT_TREES_FOOTER].join("\n");
+}
+function parseTree(item) {
+    if (!item || typeof item !== "object")
+        return undefined;
+    const raw = item;
+    const tree = raw.tree;
+    const ref = typeof tree?.ref === "string" ? tree.ref : tree?.request_id;
+    if (typeof ref !== "string" || !TREE_REF.test(ref))
+        return undefined;
+    if (typeof raw.title !== "string" || !raw.title.trim())
+        return undefined;
+    return {
+        session_id: typeof raw.session_id === "string" ? raw.session_id : null,
+        last_at: typeof raw.last_at === "string" ? raw.last_at : null,
+        title: raw.title,
+        ref,
+    };
+}
+function shorten(text, limit) {
+    // One line: a summary is model-written and must not add lines of its own.
+    const flat = text.replace(/\s+/g, " ").trim();
+    return flat.length <= limit ? flat : `${flat.slice(0, limit - 1).trimEnd()}…`;
+}
+/** `promise`'s value, or undefined if it takes longer than `ms`. */
+async function withinMs(promise, ms) {
+    let timer;
+    const timeout = new Promise((resolve) => {
+        timer = setTimeout(() => resolve(undefined), ms);
+        timer.unref?.();
+    });
+    try {
+        return await Promise.race([promise, timeout]);
+    }
+    finally {
+        if (timer)
+            clearTimeout(timer);
+    }
+}
+/**
+ * The hint for this run, or undefined: interactive sessions only (print runs
+ * keep Claude Code's output as it is) with MemTree on (a valid key, not
+ * continued past the payment gate: the lookup could only fail), with both
+ * `search` and `read_node` (the block names them), a known project, and not
+ * `CCC_PROJECT_TREES=0`.
+ */
+export function projectTreesHintFor(s) {
+    if (!s.interactive || s.env.CCC_PROJECT_TREES === "0")
+        return undefined;
+    if (s.keyCheck === "invalid" || s.memtreeOff)
+        return undefined;
+    if (!s.tools.includes("search") || !s.tools.includes("read_node"))
+        return undefined;
+    const project = projectIdentity(s.meta);
+    return project ? new ProjectTreesHint(s.fetchJson, project) : undefined;
+}
+//# sourceMappingURL=project-trees.js.map

package/dist/project-trees.js.map

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

package/dist/proxy.d.ts

@@ -48,6 +48,7 @@ import type { StablePrefixStore } from "./prefix-store.js";
 import type { NewestTreeLookup } from "./memtree-newest.js";
 import type { TranscriptUsageSource } from "./transcript-usage.js";
 import type { ProjectMeta } from "./project-meta.js";
+import type { ProjectTreesHint } from "./project-trees.js";
 import type { DiagnosticsRecorder } from "./diagnostics.js";
 import { type MessagesRecord, type RequestLogSink } from "./reqlog.js";
 export interface ProxyOptions {
@@ -185,6 +186,11 @@ export interface ProxyOptions {
      * provider decides how often it has something to say.
      */
     sessionStartNotice?: () => string | undefined;
+    /**
+     * Earlier MemTree sessions in this project, added to a main session's
+     * SessionStart as model context (project-trees.ts). Omitted means none.
+     */
+    projectTrees?: ProjectTreesHint;
     /**
      * Client diagnostics (diagnostics.ts): session starts, paused notices shown,
      * and refusals, as allowlisted enums and numbers. Never content.
@@ -239,7 +245,14 @@ export declare function fallbackBudgetRatio(model: unknown, modelContextLimit: n
 export declare function startProxy(opts: ProxyOptions): Promise<RunningProxy>;
 /** The page id in a server-stamped link (`…/m/<id>` or `…/usage/memtree/<id>`). */
 export declare function memtreePageId(pageUrl: string): string | undefined;
+/**
+ * The SessionStart hook's answer: the banner line for the user
+ * (`systemMessage`), model context (`additionalContext`), or both.
+ */
+export declare function sessionStartOutput(line: string | undefined, context: string | undefined): Record<string, unknown>;
 export declare const MEMTREE_COMPACT_MIN_TOKENS = 20000;
+/** How long a paused turn waits for the short checkout link before its notice (once). */
+export declare const PAYMENT_LINK_NOTICE_WAIT_MS = 1000;
 export declare const SUBAGENT_VIEW_NOTE = "(main session's page; subagent pages aren't linked yet)";
 export declare const SUBAGENT_COMPACT_REPLY = "MemTree compact applies to the main session only.";
 /** "50k", "50000", "1.5m" → tokens; undefined when not a positive count. */

package/dist/proxy.d.ts.map

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

package/dist/proxy.js

@@ -56,6 +56,7 @@ import { COMPRESSED_NOTICE, compressedTotalsText, DEGRADED_NOTICE, NOT_COMPRESSE
 import { NoticeDeliveryQueue, MEMTREE_COMPACT_COMMAND, MEMTREE_HELP_COMMAND, TRAILER_LABEL, LINK_LABEL, linkLines, urlLine, terminalSupportsHyperlinks, isMemtreeViewCommand, sessionCommandArgs, parseNoticeHookInput, } from "./hooks.js";
 import { USAGE_LABEL, USAGE_SIGN_IN_NOTE } from "./usage-link.js";
 import { hyperlink } from "./payment-gate.js";
+import { keyInvalidNoticeText, keyInvalidRefusalMessage } from "./key-status.js";
 import { PaymentNoticeThrottle, pausedCompactionText, pausedRefusalMessage, paymentNoticeText, subscribeUrlFromDetail } from "./payment-notice.js";
 import { MEMTREE_LINKS_MAX_SESSIONS } from "./memtree-links.js";
 import { describeClaudeCodeRequest, inspectMonitorTranscript, knownSideRequestKind, transcriptWarning, isClaudeCodeSideRequest, memtreeClientMeta, sessionTag, } from "./cc-request.js";
@@ -304,11 +305,15 @@ export function startProxy(opts) {
     const shutdownAbort = new AbortController();
     const state = {
         paymentNotice: new PaymentNoticeThrottle(opts.paymentNoticeIntervalMs),
+        keyNotice: new PaymentNoticeThrottle(opts.paymentNoticeIntervalMs),
+        keyInvalid: () => opts.memtree.keyInvalid,
+        keyPageUrl: opts.memtree.keyPageUrl,
         pausedNearWindowWarned: new Set(),
         unpaidDetail: () => opts.memtree.paymentRequiredDetail,
         pausedDetail: () => opts.memtree.pausedDetail,
         usageUrl: opts.memtree.usageDashboardUrl,
         sessionStartNotice: opts.sessionStartNotice,
+        projectTrees: opts.projectTrees,
         diagnostics: opts.diagnostics,
         notices: new NoticeDeliveryQueue(),
         mainNoticePending: false,
@@ -726,17 +731,20 @@ onMainStop) {
             recordSessionStart(state, parsed.source);
             noteMainSessionStart(state, parsed.source, parsed.session_id);
         }
+        // Earlier trees in this project: asked now, so its wait overlaps the resume's.
+        const contextPromise = projectTreesContext(state.projectTrees, parsed);
         // A resume waits briefly for the newest tree; a fresh session has none to wait for.
         if (parsed.agent_id === undefined && parsed.source === "resume") {
             await state.newestTrees?.settle(parsed.session_id);
         }
         const line = joinNoticeLines(resumeLinkLine(state, parsed), resumePaymentNotice(state, parsed), extraSessionStartLine(state.sessionStartNotice, parsed));
-        if (!line) {
+        const context = await contextPromise;
+        if (!line && !context) {
             res.writeHead(204);
             res.end();
             return;
         }
-        const body = Buffer.from(JSON.stringify({ systemMessage: line }), "utf-8");
+        const body = Buffer.from(JSON.stringify(sessionStartOutput(line, context)), "utf-8");
         res.writeHead(200, {
             "content-type": "application/json",
             "content-length": String(body.length),
@@ -1697,6 +1705,13 @@ async function handleMessages(req, res, opts, upstream, state) {
     // it pending for the next turn.
     if (result && sessionId !== undefined)
         state.compactNow.delete(sessionId);
+    // A first 402 starts fetching the short checkout link (memtree.ts): give the
+    // paused notice below a moment to show it instead of the long one. Only a turn
+    // that can show the notice waits, and only while that fetch is in flight.
+    if (!result && displayForThisTurn && state.mainPromptGeneration === noticePromptGeneration &&
+        state.paymentNotice.due() && opts.memtree.paymentRequiredDetail !== null) {
+        await opts.memtree.paymentLinkSettled?.(PAYMENT_LINK_NOTICE_WAIT_MS);
+    }
     if (downstreamClosedDuringCompression ||
         (res.destroyed && !res.writableFinished)) {
         releaseUncommittedRouteDecision();
@@ -1724,7 +1739,15 @@ async function handleMessages(req, res, opts, upstream, state) {
         const paymentDetail = opts.memtree.paymentRequiredDetail;
         const mayQueueNotice = displayForThisTurn && state.mainPromptGeneration === noticePromptGeneration;
         const overBudget = reachedBudget(rec.compaction);
-        if (mayQueueNotice && paymentDetail !== null &&
+        if (state.keyInvalid()) {
+            // A refused key (401/403) says why MemTree is off and how to fix it;
+            // throttled like the payment notice, and quiet in between.
+            if (mayQueueNotice && state.keyNotice.due()) {
+                // A refusal of this very request says the same and withdraws it.
+                pausedNotices.set(rec, state.notices.queueSuffix(keyInvalidNoticeText(state.keyPageUrl), () => state.keyNotice.markShown(), noticePromptId));
+            }
+        }
+        else if (mayQueueNotice && paymentDetail !== null &&
             (state.paymentNotice.due() || (overBudget && !nearWindowWarned(state, sessionId)))) {
             // A paused refusal of this very request withdraws it (refuseWholeRequest),
             // and any later one withdraws its near-window line.
@@ -1984,11 +2007,39 @@ function extraSessionStartLine(provider, input) {
         return undefined;
     }
 }
+/**
+ * Earlier sessions in this project (project-trees.ts) for a main session's
+ * start: fresh, resumed, cleared or forked, never a compaction. Never throws.
+ */
+async function projectTreesContext(hint, input) {
+    if (!hint || input.agent_id !== undefined || input.source === "compact")
+        return undefined;
+    try {
+        return await hint.contextFor(input.session_id);
+    }
+    catch {
+        return undefined;
+    }
+}
+/**
+ * The SessionStart hook's answer: the banner line for the user
+ * (`systemMessage`), model context (`additionalContext`), or both.
+ */
+export function sessionStartOutput(line, context) {
+    return {
+        ...(line ? { systemMessage: line } : {}),
+        ...(context
+            ? { hookSpecificOutput: { hookEventName: "SessionStart", additionalContext: context } }
+            : {}),
+    };
+}
 function joinNoticeLines(...parts) {
     const present = parts.filter((part) => !!part);
     return present.length ? present.join("\n") : undefined;
 }
 export const MEMTREE_COMPACT_MIN_TOKENS = 20_000;
+/** How long a paused turn waits for the short checkout link before its notice (once). */
+export const PAYMENT_LINK_NOTICE_WAIT_MS = 1_000;
 /** The reply to a ccc slash command, or undefined for an ordinary prompt. */
 function sessionCommandReply(state, sessionId, prompt) {
     const unpaid = state.unpaidDetail();
@@ -3554,7 +3605,9 @@ async function recoverToolRouteMiss(args) {
         // a later turn. An unpaid key (402, possibly set by this very compress)
         // or a shutting-down proxy gets no retry.
         if (!state.shutdownSignal.aborted &&
-            opts.memtree.paymentRequiredDetail === null) {
+            opts.memtree.paymentRequiredDetail === null &&
+            !opts.memtree.keyInvalid // a refused key refuses the index too
+        ) {
             opts.memtree.indexInBackground(hash, msgsForMemtree, modelContextLimit, requestSessionId(req), args.clientMeta, transcriptTimesFor(opts, requestSessionId(req), agentAttributionId(req)));
         }
         return forwardOriginal();
@@ -3962,9 +4015,12 @@ async function wholeRequestRefused(sizing, candidate, limits) {
 }
 /** Write the bounded fallback refusal (route-fallback.ts); always false. */
 function refuseWholeRequest(args, inputTokens, budgetTokens) {
-    const unpaid = args.state.pausedDetail();
-    const failure = unpaid !== null ? pausedRefusal(pausedRefusalMessage(unpaid))
-        : args.state.fallbackFailures.fail(args.routeKey, { awaitingIndex: args.rec.indexBehind === true });
+    // A refused key or a paused one: a retry cannot fix either, so it is final at once.
+    const keyInvalid = args.state.keyInvalid();
+    const unpaid = keyInvalid ? null : args.state.pausedDetail();
+    const failure = keyInvalid ? pausedRefusal(keyInvalidRefusalMessage(args.state.keyPageUrl))
+        : unpaid !== null ? pausedRefusal(pausedRefusalMessage(unpaid))
+            : args.state.fallbackFailures.fail(args.routeKey, { awaitingIndex: args.rec.indexBehind === true });
     args.rec.forwardedBytes = 0;
     args.rec.approxInputTokens = 0;
     args.state.diagnostics?.record("refusal", {
@@ -3977,8 +4033,9 @@ function refuseWholeRequest(args, inputTokens, budgetTokens) {
         inputTokens, outputTokens: args.body.max_tokens ?? 0,
         outputReservation: bodyOutputReservation(args.body), indexBehind: args.rec.indexBehind === true,
         budgetTokens, modelContextLimit: args.modelContextLimit, ...(unpaid !== null ? { paused: true } : {}),
+        ...(keyInvalid ? { keyInvalid: true } : {}),
     };
-    if (unpaid !== null)
+    if (unpaid !== null || keyInvalid)
         cancelPausedNotice(args.state, args.rec);
     if (args.res.headersSent || args.res.destroyed)
         return false;
@@ -3987,6 +4044,9 @@ function refuseWholeRequest(args, inputTokens, budgetTokens) {
     if (unpaid !== null) {
         notePausedRefusal(args.state, args.rec, args.routeKey, requestSessionId(args.req));
     }
+    // The refusal named the key: it counts as the key notice on the user's screen.
+    if (keyInvalid && args.rec.routeLane === "main")
+        args.state.keyNotice.markShown();
     return false;
 }
 /**
@@ -4025,6 +4085,8 @@ function cancelPausedNotice(state, rec) {
  * already queued the paused notice carries the line itself.
  */
 function warnPausedNearWindow(state, rec, sessionId) {
+    if (state.keyInvalid())
+        return; // a refused key, not a pause: the key notice says why
     const detail = state.unpaidDetail();
     // Paid again: a later pause (next month's limit) warns afresh.
     if (detail === null)