pi-smart-compact 9.7.1 → 10.0.1

package/dist/infra/ai-messages.d.ts

@@ -18,7 +18,7 @@
 import { type Message } from "@earendil-works/pi-ai";
 import type { LlmMessage, SessionMessageEntry } from "../types.ts";
 import type { SecretScrubber } from "../domain/scrub.ts";
-/** Preserve the host's context projection and original entry IDs, including custom and branch summaries. */
+/** Project a full selected branch, preserving source IDs and intentional edits. */
 export declare function contextMessageEntries(entries: readonly unknown[]): SessionMessageEntry[];
 /** Text transcript without the host summarizer's implicit 2,000-character tool-result cap. */
 export declare function serializeConversationText(messages: LlmMessage[]): string;

package/dist/infra/ai-messages.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ai-messages.d.ts","sourceRoot":"","sources":["../../src/infra/ai-messages.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAAe,KAAK,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAClE,OAAO,KAAK,EAAE,UAAU,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAEnE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEzD,4GAA4G;AAC5G,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,SAAS,OAAO,EAAE,GAAG,mBAAmB,EAAE,CAKxF;AAED,8FAA8F;AAC9F,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE,UAAU,EAAE,GAAG,MAAM,CAKxE;AAED;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAEzD;AAED;;;;;;;;GAQG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,UAAU,EAAE,GAAG,OAAO,EAAE,CAIpE;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,UAAU,EAAE,EAAE,QAAQ,EAAE,cAAc,GAAG,UAAU,EAAE,CAE3F"}
+{"version":3,"file":"ai-messages.d.ts","sourceRoot":"","sources":["../../src/infra/ai-messages.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAAe,KAAK,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAClE,OAAO,KAAK,EAAE,UAAU,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAEnE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEzD,mFAAmF;AACnF,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,SAAS,OAAO,EAAE,GAAG,mBAAmB,EAAE,CAYxF;AAED,8FAA8F;AAC9F,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE,UAAU,EAAE,GAAG,MAAM,CAKxE;AAED;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAEzD;AAED;;;;;;;;GAQG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,UAAU,EAAE,GAAG,OAAO,EAAE,CAIpE;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,UAAU,EAAE,EAAE,QAAQ,EAAE,cAAc,GAAG,UAAU,EAAE,CAE3F"}

package/dist/infra/context-graph.d.ts

@@ -46,19 +46,50 @@ export declare function indexCompactionState(projectId: string, state: Compactio
 export declare function scheduleCompactionStateIndex(projectId: string, state: CompactionState): Promise<boolean>;
 /** Test seam; production drains in a microtask. */
 export declare function flushCompactionStateIndexes(): void;
-/** Resolve or supersede an explicit memory by stable fact identity within one project. */
-export declare function closeContextMemory(projectId: string, kind: SavedContextMemory["kind"], content: string, status: "resolved" | "superseded"): number;
+export interface ClosedContextMemory {
+    closed: number;
+    kind: string;
+    title: string;
+}
+/** Look up one explicit memory by its stable ref id, within one project. */
+export declare function getContextMemoryByRef(projectId: string, id: string): {
+    kind: string;
+    title: string;
+    content: string;
+    relatedPaths: string[];
+} | null;
+/**
+ * Resolve an explicit memory by its stable ref id within one project. The id
+ * is a hash of project, kind and fact key, so a ref from another project
+ * simply matches nothing here.
+ */
+export declare function closeContextMemoryByRef(projectId: string, id: string): ClosedContextMemory | null;
+/** Stable identity of an explicit memory; matches the id saveContextMemory assigns. */
+export declare function manualMemoryId(projectId: string, kind: SavedContextMemory["kind"], content: string): string;
 /** Save one explicit, user-confirmed project memory. */
 export declare function saveContextMemory(scope: ContextGraphScope, memory: Omit<SavedContextMemory, "id">): SavedContextMemory;
 /** Weighted project recall: lexical seeds + one-hop file relationships + scope/recency boosts. */
 export declare function recallContext(scope: ContextGraphScope, query: string, options?: ContextRecallOptions): ContextRecallResult[];
 export declare function formatRecallResults(results: ContextRecallResult[], maxChars?: number): string;
 export declare function getContextGraphStats(projectId: string): ContextGraphStats;
+/** Node counts by provenance for the /forget choice. */
+export interface ContextGraphMemoryCounts {
+    manual: number;
+    derived: number;
+    unknown: number;
+}
+export declare function getContextGraphMemoryCounts(projectId: string): ContextGraphMemoryCounts;
+/** What a scoped forget deletes. */
+export type ForgetGraphScope = "all" | "derived-only";
 /**
- * Permanently forget all graph memory for a project (#63): FTS copies,
- * edges, and nodes in one transaction. Drains any queued index writes
- * first so a scheduled compaction cannot resurrect the memory afterwards.
- * Compaction state files (restore data) and backups are left intact.
+ * Permanently forget graph memory for a project (#63). Drains any queued
+ * index writes first so a scheduled compaction cannot resurrect the memory
+ * afterwards. Compaction state files (restore data) and backups are left
+ * intact, and no other store (Mnemopi, Hindsight) is ever touched.
+ *
+ * `derived-only` deletes just the compaction-derived nodes (including their
+ * session/file infrastructure) with their FTS copies and edges; user-confirmed
+ * memories and unknown-provenance rows are preserved.
  */
-export declare function forgetProjectGraph(projectId: string): boolean;
+export declare function forgetProjectGraph(projectId: string, scope?: ForgetGraphScope): boolean;
 //# sourceMappingURL=context-graph.d.ts.map

package/dist/infra/context-graph.d.ts.map

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

package/dist/infra/fs.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fs.d.ts","sourceRoot":"","sources":["../../src/infra/fs.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAWH,0EAA0E;AAC1E,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAG3C;AAWD;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI,CAYnF;AAED,wBAAsB,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAW9F;AA2CD,gFAAgF;AAChF,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,IAAI,CAI1D;AAYD,+EAA+E;AAC/E,wBAAsB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,CAAC,CASrE;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAoCtF;AAED,+EAA+E;AAC/E,wBAAsB,qBAAqB,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAwC1G;AAED,iFAAiF;AACjF,wBAAgB,aAAa,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,SAAa,GAAG,CAAC,EAAE,CAoB1F;AAED,oEAAoE;AACpE,wBAAsB,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAgBxF;AAGD,wBAAgB,YAAY,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,GAAG,CAAC,GAAG,IAAI,CASxD;AAED,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,UAAQ,GAAG,IAAI,CAElF"}
+{"version":3,"file":"fs.d.ts","sourceRoot":"","sources":["../../src/infra/fs.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAYH,0EAA0E;AAC1E,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAG3C;AAWD;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI,CAYnF;AAED,wBAAsB,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAW9F;AA2CD,gFAAgF;AAChF,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,IAAI,CAI1D;AAYD,+EAA+E;AAC/E,wBAAsB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,CAAC,CASrE;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAoCtF;AAED,+EAA+E;AAC/E,wBAAsB,qBAAqB,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAwC1G;AAED,iFAAiF;AACjF,wBAAgB,aAAa,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,SAAa,GAAG,CAAC,EAAE,CAoB1F;AAED,oEAAoE;AACpE,wBAAsB,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAgBxF;AAGD,wBAAgB,YAAY,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,GAAG,CAAC,GAAG,IAAI,CAcxD;AAED,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,UAAQ,GAAG,IAAI,CAElF"}

package/dist/infra/hindsight-client.d.ts

@@ -0,0 +1,73 @@
+/**
+ * Minimal Hindsight HTTP client for Smart Compact's confirmed memory path.
+ *
+ * Deliberately exposes only four fixed bank-scoped routes (retain, operation
+ * status, recall, delete one document). There is no generic request method, so
+ * destructive bank-wide routes such as `DELETE /memories` are unreachable.
+ */
+export interface HindsightTarget {
+    /** Normalized origin plus optional path prefix, without trailing slash. */
+    baseUrl: string;
+    bankId: string;
+    /** Bearer token value; never persisted or rendered. */
+    apiKey?: string;
+    timeoutMs: number;
+}
+export type HindsightErrorKind = "config" | "aborted" | "timeout" | "network" | "unauthorized" | "not-found" | "conflict" | "http" | "invalid-response";
+export declare class HindsightError extends Error {
+    readonly kind: HindsightErrorKind;
+    readonly status?: number;
+    constructor(kind: HindsightErrorKind, message: string, status?: number);
+    /** True when the server may or may not have received the request. */
+    get outcomeUnknown(): boolean;
+}
+export type HindsightOperationStatus = "pending" | "processing" | "completed" | "failed" | "cancelled" | "not_found";
+export interface HindsightRetainItem {
+    content: string;
+    documentId: string;
+    context?: string;
+    tags: string[];
+    metadata: Record<string, string>;
+}
+export interface HindsightRecallFact {
+    id: string;
+    text: string;
+    type: string | null;
+    documentId: string | null;
+    tags: string[];
+    metadata: Record<string, string>;
+    mentionedAt: string | null;
+}
+/**
+ * Validate and normalize a configured base URL. HTTPS is required except for
+ * loopback development servers; credentials, query and fragment are refused.
+ */
+export declare function normalizeHindsightBaseUrl(raw: unknown): string;
+export declare function isValidHindsightBankId(value: unknown): value is string;
+/** Display-safe destination label (origin + bank), never includes secrets. */
+export declare function describeHindsightTarget(target: HindsightTarget): string;
+/**
+ * Submit one asynchronous retain. The caller-supplied operation id makes
+ * retries of the same submission idempotent on the server. Acceptance is not
+ * completion: extracted facts are not searchable until the operation completes.
+ */
+export declare function retainDocument(target: HindsightTarget, item: HindsightRetainItem, operationId: string, signal?: AbortSignal): Promise<{
+    operationId: string;
+}>;
+export declare function getOperationStatus(target: HindsightTarget, operationId: string, signal?: AbortSignal): Promise<{
+    status: HindsightOperationStatus;
+    failed: boolean;
+}>;
+export interface HindsightRecallRequest {
+    query: string;
+    tags: string[];
+    maxTokens: number;
+}
+/** Bounded, strictly tag-scoped recall. No reflect, chunks or source facts. */
+export declare function recallFacts(target: HindsightTarget, request: HindsightRecallRequest, signal?: AbortSignal): Promise<HindsightRecallFact[]>;
+/** Delete exactly one owned document. A missing document is reported, not thrown. */
+export declare function deleteDocument(target: HindsightTarget, documentId: string, signal?: AbortSignal): Promise<{
+    found: boolean;
+    memoryUnitsDeleted: number;
+}>;
+//# sourceMappingURL=hindsight-client.d.ts.map

package/dist/infra/hindsight-client.d.ts.map

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

package/dist/infra/hindsight-receipts.d.ts

@@ -0,0 +1,68 @@
+export type HindsightReceiptState = 
+/** Request sent, no response yet (process died mid-flight). */
+"submitted"
+/** Server acknowledged the async operation; extraction not yet complete. */
+ | "accepted"
+/** Operation completed; facts are searchable. */
+ | "completed"
+/** Server reported failure/cancellation, or refused the request. */
+ | "failed"
+/** Transport failure: the server may or may not have accepted it. */
+ | "unknown"
+/** The owned document was deleted by a confirmed resolve. */
+ | "deleted";
+export interface HindsightReceipt {
+    key: string;
+    baseUrl: string;
+    bankId: string;
+    projectId: string;
+    documentId: string;
+    revision: string;
+    operationId: string;
+    /** Operation id the server acknowledged, when it differs from `operationId`. */
+    serverOperationId?: string;
+    kind: string;
+    title: string;
+    state: HindsightReceiptState;
+    createdAt: number;
+    updatedAt: number;
+    /** Short, secret-free failure reason. */
+    detail?: string;
+}
+export interface HindsightReceiptScope {
+    baseUrl: string;
+    bankId: string;
+    projectId: string;
+}
+export declare const MAX_HINDSIGHT_RECEIPTS = 500;
+/** An operation missing server-side this long is treated as failed so the ledger drains. */
+export declare const NOT_FOUND_DRAIN_HOURS = 24;
+export declare function isOpenReceipt(receipt: HindsightReceipt): boolean;
+export declare function hindsightReceiptsFile(): string;
+export declare function receiptKey(scope: HindsightReceiptScope, documentId: string, revision: string): string;
+/**
+ * Deterministic UUID-shaped operation id for one submission, so a retry of the
+ * same confirmed save is idempotent server-side and never double-retains.
+ */
+export declare function operationIdFor(scope: HindsightReceiptScope, documentId: string, revision: string): string;
+/**
+ * A present but unreadable ledger is never treated as empty: that would let a
+ * resolve delete a document with in-flight retains, and the next save would
+ * overwrite the evidence. Callers refuse instead; the file is left untouched.
+ */
+export declare class ReceiptLedgerUnreadableError extends Error {
+    constructor(file: string, detail: string);
+}
+export declare function listReceipts(scope: HindsightReceiptScope, documentId?: string, file?: string): HindsightReceipt[];
+export declare class ReceiptLedgerFullError extends Error {
+    constructor(file?: string);
+}
+/**
+ * Insert or update one receipt. Terminal receipts are pruned oldest-first when
+ * the cap is reached; open receipts are never evicted — the write is refused.
+ */
+export declare function upsertReceipt(receipt: HindsightReceipt, file?: string): HindsightReceipt;
+export declare function updateReceiptState(key: string, state: HindsightReceiptState, detail?: string, extra?: Pick<HindsightReceipt, "serverOperationId">, file?: string): HindsightReceipt | null;
+/** Capacity check before a remote submission, without writing. */
+export declare function receiptCapacityAvailable(file?: string): boolean;
+//# sourceMappingURL=hindsight-receipts.d.ts.map

package/dist/infra/hindsight-receipts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hindsight-receipts.d.ts","sourceRoot":"","sources":["../../src/infra/hindsight-receipts.ts"],"names":[],"mappings":"AAcA,MAAM,MAAM,qBAAqB;AAC/B,+DAA+D;AAC7D,WAAW;AACb,4EAA4E;GAC1E,UAAU;AACZ,iDAAiD;GAC/C,WAAW;AACb,oEAAoE;GAClE,QAAQ;AACV,qEAAqE;GACnE,SAAS;AACX,6DAA6D;GAC3D,SAAS,CAAC;AAEd,MAAM,WAAW,gBAAgB;IAC/B,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,gFAAgF;IAChF,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,qBAAqB,CAAC;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,yCAAyC;IACzC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;CACnB;AAOD,eAAO,MAAM,sBAAsB,MAAM,CAAC;AAC1C,4FAA4F;AAC5F,eAAO,MAAM,qBAAqB,KAAK,CAAC;AAQxC,wBAAgB,aAAa,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAEhE;AAED,wBAAgB,qBAAqB,IAAI,MAAM,CAE9C;AAMD,wBAAgB,UAAU,CACxB,KAAK,EAAE,qBAAqB,EAC5B,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,GACf,MAAM,CAER;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE,qBAAqB,EAC5B,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,GACf,MAAM,CAeR;AAED;;;;GAIG;AACH,qBAAa,4BAA6B,SAAQ,KAAK;IACrD,YAAY,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EASvC;CACF;AA2CD,wBAAgB,YAAY,CAC1B,KAAK,EAAE,qBAAqB,EAC5B,UAAU,CAAC,EAAE,MAAM,EACnB,IAAI,SAA0B,GAC7B,gBAAgB,EAAE,CAMpB;AAED,qBAAa,sBAAuB,SAAQ,KAAK;IAC/C,YAAY,IAAI,SAA0B,EASzC;CACF;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAC3B,OAAO,EAAE,gBAAgB,EACzB,IAAI,SAA0B,GAC7B,gBAAgB,CA4BlB;AAED,wBAAgB,kBAAkB,CAChC,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,qBAAqB,EAC5B,MAAM,CAAC,EAAE,MAAM,EACf,KAAK,GAAE,IAAI,CAAC,gBAAgB,EAAE,mBAAmB,CAAM,EACvD,IAAI,SAA0B,GAC7B,gBAAgB,GAAG,IAAI,CAgBzB;AAED,kEAAkE;AAClE,wBAAgB,wBAAwB,CAAC,IAAI,SAA0B,GAAG,OAAO,CAMhF"}

package/dist/infra/llm-client.d.ts

@@ -1,31 +1,35 @@
 /**
  * LLM client seam.
  *
- * Why we have a seam at all:
+ * Production requests go through the requesting session's public model
+ * runtime (`ctx.modelRegistry`), never pi-ai's standalone completers: only the
+ * session runtime applies request-time auth, OAuth and extension provider
+ * overrides registered with `pi.registerProvider` (e.g. a subscription
+ * adapter that owns final payload normalization). Clients are built per run
+ * from that runtime, so one session can never route through another's.
  *
- *  - pi-ai's completers are the only runtime entry points into a model.
- *    Importing them directly from utility modules tied even the metrics test
- *    path to the peer dependency, which made `bun test` fail when the peer
- *    was not installed.
- *
- *  - Test fakes need to assert which `phase` was used, control failures, and
- *    return synthetic usage tokens for calibration tests.
- *
- *  - Future provider fallback work (per `implement-llm-provider-fallback`)
- *    becomes a single-file change instead of a cross-module refactor.
+ * Test fakes need to assert which `phase` was used, control failures, and
+ * return synthetic usage tokens, so `setLlmClient` installs a process-wide
+ * test override that takes precedence over every run's runtime client.
  *
  * The interface is intentionally narrow: a single `complete()` method matching
  * the pi-ai shape, plus the same options object existing callers already pass.
- *
- * The default implementation keeps `complete()` for existing calls and uses
- * `completeSimple()` when generic reasoning is explicitly configured.
- * `setLlmClient` is exposed for tests and wrapping/fallback clients. Both
- * completers are resolved below through the host's compat alias.
+ * Provider-specific `stream()` keeps existing calls; `streamSimple()` is used
+ * when generic reasoning is explicitly configured.
  */
-import type { Model, Api, AssistantMessage, Context, SimpleStreamOptions } from "@earendil-works/pi-ai";
+import type { Model, Api, AssistantMessage, AssistantMessageEventStream, Context, ProviderStreamOptions, SimpleStreamOptions } from "@earendil-works/pi-ai";
 export type LlmCompleteOptions = SimpleStreamOptions & {
     codexWatchdogMs?: number;
 };
+/** The public session model runtime slice used for requests (`ctx.modelRegistry`). */
+export interface LlmModelRuntime {
+    stream(model: Model<Api>, context: Context, options?: ProviderStreamOptions): AssistantMessageEventStream;
+    streamSimple(model: Model<Api>, context: Context, options?: SimpleStreamOptions): AssistantMessageEventStream;
+}
+/** `ctx.modelRegistry.isUsingOAuth(model)`, false when unavailable or throwing. */
+export declare function usesOAuth(ctx: {
+    modelRegistry?: unknown;
+}, model: Model<Api>): boolean;
 export interface LlmClient {
     complete(model: Model<Api>, body: Context, opts: LlmCompleteOptions): Promise<AssistantMessage>;
 }
@@ -36,12 +40,11 @@ export declare function resolveCodexWatchdogMs(maxTokens: number | undefined, co
 export declare function resolveProviderWatchdogMs(provider: string | undefined, maxTokens: number | undefined, configuredMs?: number): number;
 /** @internal Test seam for the transport deadline used by every provider. */
 export declare function withProviderDeadline(opts: LlmCompleteOptions, invoke: (bounded: LlmCompleteOptions) => Promise<AssistantMessage>, provider?: string): Promise<AssistantMessage>;
-/** Raw client — map generic reasoning only when explicitly configured. */
-export declare const rawLlmClient: LlmClient;
-/** Production default: never replay an expensive compaction request automatically. */
-export declare const defaultLlmClient: LlmClient;
-export declare function getLlmClient(): LlmClient;
+/** Client for one session runtime — maps generic reasoning only when explicitly configured. */
+export declare function createModelRuntimeLlmClient(runtime: LlmModelRuntime): LlmClient;
+/** The test/wrapping override, resolved at call time; undefined in production. */
+export declare function getLlmClient(): LlmClient | undefined;
 export declare function setLlmClient(client: LlmClient): void;
-/** Restore the production client. Tests should always pair `setLlmClient` with this. */
+/** Remove the override. Tests should always pair `setLlmClient` with this. */
 export declare function resetLlmClient(): void;
 //# sourceMappingURL=llm-client.d.ts.map

package/dist/infra/llm-client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"llm-client.d.ts","sourceRoot":"","sources":["../../src/infra/llm-client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,OAAO,KAAK,EACV,KAAK,EACL,GAAG,EACH,gBAAgB,EAGhB,OAAO,EAEP,mBAAmB,EACpB,MAAM,uBAAuB,CAAC;AA0B/B,MAAM,MAAM,kBAAkB,GAAG,mBAAmB,GAAG;IACrD,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B,CAAC;AAmDF,MAAM,WAAW,SAAS;IACxB,QAAQ,CACN,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,EACjB,IAAI,EAAE,OAAO,EACb,IAAI,EAAE,kBAAkB,GACvB,OAAO,CAAC,gBAAgB,CAAC,CAAC;CAC9B;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,GAAG,OAAO,CAGzD;AAED,iGAAiG;AACjG,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,EACjB,IAAI,EAAE,kBAAkB,GACvB,kBAAkB,CAqBpB;AAED,wBAAgB,sBAAsB,CACpC,SAAS,EAAE,MAAM,GAAG,SAAS,EAC7B,YAAY,SAAI,GACf,MAAM,CAGR;AAmBD,wBAAgB,yBAAyB,CACvC,QAAQ,EAAE,MAAM,GAAG,SAAS,EAC5B,SAAS,EAAE,MAAM,GAAG,SAAS,EAC7B,YAAY,SAAI,GACf,MAAM,CAQR;AAED,6EAA6E;AAC7E,wBAAsB,oBAAoB,CACxC,IAAI,EAAE,kBAAkB,EACxB,MAAM,EAAE,CAAC,OAAO,EAAE,kBAAkB,KAAK,OAAO,CAAC,gBAAgB,CAAC,EAClE,QAAQ,CAAC,EAAE,MAAM,GAChB,OAAO,CAAC,gBAAgB,CAAC,CAuC3B;AA8DD,0EAA0E;AAC1E,eAAO,MAAM,YAAY,EAAE,SAqB1B,CAAC;AAEF,sFAAsF;AACtF,eAAO,MAAM,gBAAgB,EAAE,SAAwB,CAAC;AAIxD,wBAAgB,YAAY,IAAI,SAAS,CAExC;AAED,wBAAgB,YAAY,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAEpD;AAED,wFAAwF;AACxF,wBAAgB,cAAc,IAAI,IAAI,CAErC"}
+{"version":3,"file":"llm-client.d.ts","sourceRoot":"","sources":["../../src/infra/llm-client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,KAAK,EACV,KAAK,EACL,GAAG,EACH,gBAAgB,EAEhB,2BAA2B,EAC3B,OAAO,EACP,qBAAqB,EACrB,mBAAmB,EACpB,MAAM,uBAAuB,CAAC;AAG/B,MAAM,MAAM,kBAAkB,GAAG,mBAAmB,GAAG;IACrD,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B,CAAC;AAEF,sFAAsF;AACtF,MAAM,WAAW,eAAe;IAC9B,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,qBAAqB,GAAG,2BAA2B,CAAC;IAC1G,YAAY,CAAC,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,mBAAmB,GAAG,2BAA2B,CAAC;CAC/G;AAED,mFAAmF;AACnF,wBAAgB,SAAS,CAAC,GAAG,EAAE;IAAE,aAAa,CAAC,EAAE,OAAO,CAAA;CAAE,EAAE,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,GAAG,OAAO,CAOtF;AAiBD,MAAM,WAAW,SAAS;IACxB,QAAQ,CACN,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,EACjB,IAAI,EAAE,OAAO,EACb,IAAI,EAAE,kBAAkB,GACvB,OAAO,CAAC,gBAAgB,CAAC,CAAC;CAC9B;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,GAAG,OAAO,CAGzD;AAED,iGAAiG;AACjG,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,EACjB,IAAI,EAAE,kBAAkB,GACvB,kBAAkB,CAqBpB;AAED,wBAAgB,sBAAsB,CACpC,SAAS,EAAE,MAAM,GAAG,SAAS,EAC7B,YAAY,SAAI,GACf,MAAM,CAGR;AAmBD,wBAAgB,yBAAyB,CACvC,QAAQ,EAAE,MAAM,GAAG,SAAS,EAC5B,SAAS,EAAE,MAAM,GAAG,SAAS,EAC7B,YAAY,SAAI,GACf,MAAM,CAQR;AAED,6EAA6E;AAC7E,wBAAsB,oBAAoB,CACxC,IAAI,EAAE,kBAAkB,EACxB,MAAM,EAAE,CAAC,OAAO,EAAE,kBAAkB,KAAK,OAAO,CAAC,gBAAgB,CAAC,EAClE,QAAQ,CAAC,EAAE,MAAM,GAChB,OAAO,CAAC,gBAAgB,CAAC,CAuC3B;AA4DD,+FAA+F;AAC/F,wBAAgB,2BAA2B,CAAC,OAAO,EAAE,eAAe,GAAG,SAAS,CAe/E;AAID,kFAAkF;AAClF,wBAAgB,YAAY,IAAI,SAAS,GAAG,SAAS,CAEpD;AAED,wBAAgB,YAAY,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAEpD;AAED,8EAA8E;AAC9E,wBAAgB,cAAc,IAAI,IAAI,CAErC"}

package/dist/infra/memory-ref.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Stable memory references shown by save/recall results and required by
+ * smart_save_memory status=resolved.
+ *
+ * A ref names the backend that holds the fact, the id that backend assigned,
+ * and a digest of the exact target (graph file / data root / server+bank).
+ * Hindsight also binds the project and document id. Saving the same fact to
+ * two targets therefore produces two distinct refs, and after a configuration
+ * switch an old ref refuses to act instead of silently retargeting.
+ *
+ * Refs never carry a raw URL, bank id, or filesystem path, so a caller cannot
+ * redirect an action to another target: the destination is always re-derived
+ * from current configuration and compared against the digest.
+ */
+export type MemoryRefBackend = "local" | "mnemopi" | "hindsight";
+export interface MemoryRef {
+    backend: MemoryRefBackend;
+    id: string;
+    /** Mandatory 96-bit digest of the exact backend storage target. */
+    target: string;
+}
+export declare function localTargetDigest(graphFile: string): string;
+export declare function hindsightTargetDigest(baseUrl: string, bankId: string, projectId: string, memoryId: string): string;
+export declare function mnemopiTargetDigest(dbPath: string): string;
+/** Parse and validate one ref; anything else (URLs, paths, free text) is null. */
+export declare function parseMemoryRef(value: string): MemoryRef | null;
+//# sourceMappingURL=memory-ref.d.ts.map

package/dist/infra/memory-ref.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-ref.d.ts","sourceRoot":"","sources":["../../src/infra/memory-ref.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;GAaG;AAEH,MAAM,MAAM,gBAAgB,GAAG,OAAO,GAAG,SAAS,GAAG,WAAW,CAAC;AAEjE,MAAM,WAAW,SAAS;IACzB,OAAO,EAAE,gBAAgB,CAAC;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,mEAAmE;IACnE,MAAM,EAAE,MAAM,CAAC;CACf;AAQD,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAK3D;AAED,wBAAgB,qBAAqB,CACpC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAClE,MAAM,CAKR;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAK1D;AAED,kFAAkF;AAClF,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAK9D"}

package/dist/infra/native-protocol.d.ts

@@ -0,0 +1,54 @@
+export declare const NATIVE_APIS: readonly ["anthropic-messages", "openai-responses", "openai-codex-responses"];
+export type NativeApi = (typeof NATIVE_APIS)[number];
+/** A JSON object as it appears in provider payloads. */
+export type JsonObject = Record<string, unknown>;
+/** Stored in the compaction entry's `details.native`. */
+export interface NativeState {
+    version: 1;
+    api: NativeApi;
+    provider: string;
+    model: string;
+    /** Provider items in replay order: one Anthropic compaction block, or an OpenAI window. */
+    items: JsonObject[];
+}
+export interface NativeUsage {
+    input: number;
+    output: number;
+    cacheRead: number;
+    cacheWrite: number;
+}
+export interface NativeCompactionResult {
+    state: NativeState;
+    /** What other models read: Anthropic's summary, or for OpenAI routes a notice plus the retained user messages. */
+    summary: string;
+    usage: NativeUsage;
+}
+export interface CompactionFetchOptions {
+    api: NativeApi;
+    provider: string;
+    model: string;
+    /** Summarization guidance; only Anthropic accepts it. */
+    instructions?: string;
+    /** Transport for the one real request. Defaults to the global fetch. */
+    fetch?: typeof fetch;
+}
+/** Required on Anthropic's compaction request and on every request that replays its block. */
+export declare const ANTHROPIC_COMPACTION_BETA = "compact-2026-09-04";
+export declare function isNativeApi(api: string): api is NativeApi;
+export declare function isNativeState(value: unknown): value is NativeState;
+/**
+ * A fetch for one nested Pi request. The first call becomes the compaction request; every
+ * call answers Pi with a 400, so the nested stream ends as an error that callers ignore
+ * once `result()` is defined. `result()` stays undefined when Pi never sent a request.
+ */
+export declare function createCompactionFetch(options: CompactionFetchOptions): {
+    fetch: typeof fetch;
+    result(): NativeCompactionResult | Error | undefined;
+};
+/**
+ * Returns a copy of an ordinary provider payload whose compaction-summary message is replaced
+ * by the stored state. Undefined when the summary is not the first conversation message, the
+ * only place replay is valid; Pi's text summary then goes out unchanged.
+ */
+export declare function replayNativeState(api: NativeApi, payload: unknown, state: NativeState, summary: string): JsonObject | undefined;
+//# sourceMappingURL=native-protocol.d.ts.map

package/dist/infra/native-protocol.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"native-protocol.d.ts","sourceRoot":"","sources":["../../src/infra/native-protocol.ts"],"names":[],"mappings":"AAcA,eAAO,MAAM,WAAW,YAAI,oBAAoB,EAAE,kBAAkB,EAAE,wBAAwB,CAAU,CAAC;AACzG,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,WAAW,CAAC,CAAC,MAAM,CAAC,CAAC;AAErD,wDAAwD;AACxD,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAEjD,yDAAyD;AACzD,MAAM,WAAW,WAAW;IAC3B,OAAO,EAAE,CAAC,CAAC;IACX,GAAG,EAAE,SAAS,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,2FAA2F;IAC3F,KAAK,EAAE,UAAU,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,WAAW;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,sBAAsB;IACtC,KAAK,EAAE,WAAW,CAAC;IACnB,kHAAkH;IAClH,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,WAAW,CAAC;CACnB;AAED,MAAM,WAAW,sBAAsB;IACtC,GAAG,EAAE,SAAS,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,yDAAyD;IACzD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,wEAAwE;IACxE,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;CACrB;AAED,8FAA8F;AAC9F,eAAO,MAAM,yBAAyB,uBAAuB,CAAC;AAW9D,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,IAAI,SAAS,CAEzD;AAMD,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,WAAW,CA0BlE;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,sBAAsB,GAAG;IACvE,KAAK,EAAE,OAAO,KAAK,CAAC;IACpB,MAAM,IAAI,sBAAsB,GAAG,KAAK,GAAG,SAAS,CAAC;CACrD,CAiBA;AA+ND;;;;GAIG;AACH,wBAAgB,iBAAiB,CAChC,GAAG,EAAE,SAAS,EACd,OAAO,EAAE,OAAO,EAChB,KAAK,EAAE,WAAW,EAClB,OAAO,EAAE,MAAM,GACb,UAAU,GAAG,SAAS,CAwBxB"}

package/dist/infra/optional-components.d.ts

@@ -0,0 +1,15 @@
+import { OPTIONAL_COMPONENTS } from "../constants.ts";
+export type OptionalComponent = keyof typeof OPTIONAL_COMPONENTS;
+/** This package's directory: the nearest ancestor of the module holding a package.json (dist/ or src/ layout). */
+export declare function packageDir(parentUrl?: string): string;
+/**
+ * Where `npm install --prefix` must put a component so Node resolves it from
+ * this package: Pi's install root for npm installs (the package sits in its
+ * node_modules), the package itself for git or path installs.
+ */
+export declare function installRoot(parentUrl?: string): string;
+/** Present when its manifest is on the module's lookup paths; exports conditions never matter. */
+export declare function componentInstalled(component: OptionalComponent, parentUrl?: string): boolean;
+/** The copy-pasteable install command for the given components, with Pi's own peer flag. */
+export declare function installCommand(components: readonly OptionalComponent[], parentUrl?: string): string;
+//# sourceMappingURL=optional-components.d.ts.map

package/dist/infra/optional-components.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"optional-components.d.ts","sourceRoot":"","sources":["../../src/infra/optional-components.ts"],"names":[],"mappings":"AAWA,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAEtD,MAAM,MAAM,iBAAiB,GAAG,MAAM,OAAO,mBAAmB,CAAC;AAEjE,kHAAkH;AAClH,wBAAgB,UAAU,CAAC,SAAS,GAAE,MAAwB,GAAG,MAAM,CAQtE;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,SAAS,GAAE,MAAwB,GAAG,MAAM,CAIvE;AAED,kGAAkG;AAClG,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,iBAAiB,EAAE,SAAS,GAAE,MAAwB,GAAG,OAAO,CAI7G;AAED,4FAA4F;AAC5F,wBAAgB,cAAc,CAAC,UAAU,EAAE,SAAS,iBAAiB,EAAE,EAAE,SAAS,GAAE,MAAwB,GAAG,MAAM,CAGpH"}

package/dist/infra/paths.d.ts

@@ -35,6 +35,8 @@ export declare function metricsLogFile(): string;
 export declare function runLocksDir(): string;
 /** One-shot, branch-scoped native-compaction continuity handoffs. */
 export declare function nativeContinuityDir(): string;
+/** Durable, private tool-output spill files, distinct from disposable caches. */
+export declare function toolArtifactsDir(): string;
 /** Project-scoped persistent context graph (SQLite + FTS5). */
 export declare function contextGraphFile(): string;
 /** Damage reports JSONL log. */

package/dist/infra/paths.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../src/infra/paths.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAMH;;;;GAIG;AACH,wBAAgB,IAAI,IAAI,MAAM,CAG7B;AAED,+CAA+C;AAC/C,wBAAgB,UAAU,IAAI,MAAM,CAEnC;AAsBD,6CAA6C;AAC7C,wBAAgB,WAAW,IAAI,MAAM,CAEpC;AAED,qCAAqC;AACrC,wBAAgB,YAAY,IAAI,MAAM,CAErC;AAED,gCAAgC;AAChC,wBAAgB,gBAAgB,IAAI,MAAM,CAEzC;AAED,yBAAyB;AACzB,wBAAgB,cAAc,IAAI,MAAM,CAEvC;AAED,qEAAqE;AACrE,wBAAgB,WAAW,IAAI,MAAM,CAEpC;AAED,qEAAqE;AACrE,wBAAgB,mBAAmB,IAAI,MAAM,CAE5C;AAED,+DAA+D;AAC/D,wBAAgB,gBAAgB,IAAI,MAAM,CAEzC;AAED,gCAAgC;AAChC,wBAAgB,iBAAiB,IAAI,MAAM,CAE1C;AAED,iDAAiD;AACjD,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAK7D;AAED,uDAAuD;AACvD,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAEhE;AAED,sDAAsD;AACtD,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAK7D;AAED,iFAAiF;AACjF,wBAAgB,+BAA+B,CAC9C,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,GACf,MAAM,CAIR;AAED,iFAAiF;AACjF,wBAAgB,yBAAyB,CACxC,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,MAAM,GAClB,MAAM,CAKR;AAED,0EAA0E;AAC1E,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAE9D;AAED,mCAAmC;AACnC,wBAAgB,oBAAoB,IAAI,MAAM,CAE7C"}
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../src/infra/paths.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAMH;;;;GAIG;AACH,wBAAgB,IAAI,IAAI,MAAM,CAG7B;AAED,+CAA+C;AAC/C,wBAAgB,UAAU,IAAI,MAAM,CAEnC;AAsBD,6CAA6C;AAC7C,wBAAgB,WAAW,IAAI,MAAM,CAEpC;AAED,qCAAqC;AACrC,wBAAgB,YAAY,IAAI,MAAM,CAErC;AAED,gCAAgC;AAChC,wBAAgB,gBAAgB,IAAI,MAAM,CAEzC;AAED,yBAAyB;AACzB,wBAAgB,cAAc,IAAI,MAAM,CAEvC;AAED,qEAAqE;AACrE,wBAAgB,WAAW,IAAI,MAAM,CAEpC;AAED,qEAAqE;AACrE,wBAAgB,mBAAmB,IAAI,MAAM,CAE5C;AAED,iFAAiF;AACjF,wBAAgB,gBAAgB,IAAI,MAAM,CAEzC;AAED,+DAA+D;AAC/D,wBAAgB,gBAAgB,IAAI,MAAM,CAEzC;AAED,gCAAgC;AAChC,wBAAgB,iBAAiB,IAAI,MAAM,CAE1C;AAED,iDAAiD;AACjD,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAK7D;AAED,uDAAuD;AACvD,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAEhE;AAED,sDAAsD;AACtD,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAK7D;AAED,iFAAiF;AACjF,wBAAgB,+BAA+B,CAC9C,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,GACf,MAAM,CAIR;AAED,iFAAiF;AACjF,wBAAgB,yBAAyB,CACxC,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,MAAM,GAClB,MAAM,CAKR;AAED,0EAA0E;AAC1E,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAE9D;AAED,mCAAmC;AACnC,wBAAgB,oBAAoB,IAAI,MAAM,CAE7C"}

package/dist/infra/services.d.ts

@@ -22,11 +22,13 @@
  * when recreated for each compaction. Tests keep isolated defaults.
  *
  * Services that are stateless or already inject through their own seam
- * (`LlmClient`, `Clock`, file system helpers in `infra/fs.ts`) are exposed via
- * the container for convenience but never mutated through it.
+ * (`Clock`, file system helpers in `infra/fs.ts`) are exposed via the
+ * container for convenience but never mutated through it. The LLM client is
+ * built from the requesting session's model runtime, never a process global.
  */
+import type { Api, Model } from "@earendil-works/pi-ai";
 import type { Clock } from "./clock.ts";
-import type { LlmClient } from "./llm-client.ts";
+import type { LlmClient, LlmModelRuntime } from "./llm-client.ts";
 import type { CompactConfig, LLMCallMetric } from "../types.ts";
 import { TokenCalibrationStore } from "../utils/tokens.ts";
 import { SecretScrubber } from "../domain/scrub.ts";
@@ -139,11 +141,19 @@ export interface SmartCompactServices {
     codexWatchdogMs: number;
     /** Per-run prompt-cache namespace for providers that support prompt caching. */
     compactSessionId: string;
+    /** Whether a route authenticates via OAuth (subscription); stamps the metrics billing basis. */
+    isUsingOAuth?: (model: Model<Api>) => boolean;
 }
 export declare function makeCompactSessionId(): string;
-export declare function createServices(overrides?: Partial<SmartCompactServices>): SmartCompactServices;
+/** Construction inputs: service overrides plus the session model runtime requests go through. */
+export type ServiceOverrides = Partial<SmartCompactServices> & {
+    modelRuntime?: LlmModelRuntime;
+};
+export declare function createServices(overrides?: ServiceOverrides): SmartCompactServices;
 /** Production run services: per-run metrics/budgets, shared bounded provider knowledge. */
-export declare function createProductionServices(overrides?: Partial<SmartCompactServices>): SmartCompactServices;
+export declare function createProductionServices(overrides?: ServiceOverrides): SmartCompactServices;
+/** @internal Test-only: forget process-wide calibration learned from reported usage. */
+export declare function __resetProcessCalibrationForTests(): void;
 export declare function getDefaultServices(): SmartCompactServices;
 /** Swap the default container; tests use this to inject a clock/llm. */
 export declare function setDefaultServices(services: SmartCompactServices): void;

package/dist/infra/services.d.ts.map

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

package/dist/infra/visual-renderer.d.ts

@@ -0,0 +1,16 @@
+import type { VisualArchive } from "../types.ts";
+export declare const VISUAL_WIDTH = 1280;
+export declare const VISUAL_COLUMNS = 138;
+export declare const VISUAL_ROWS = 74;
+export declare const VISUAL_MAX_FRAMES = 2;
+export declare const VISUAL_MAX_BYTES = 1000000;
+export declare const VISUAL_MIN_WIDTH = 256;
+/** Crop whitespace, not glyph size. Nine pixels safely covers the bundled 14px mono font. */
+export declare function visualPageSize(lines: readonly string[]): {
+    width: number;
+    height: number;
+};
+/** Conservative request-planning allowance, not measured provider billing. */
+export declare function estimateVisualTokens(width: number, height: number): number;
+export declare function renderVisualPages(pages: string[][], signal: AbortSignal): Promise<VisualArchive["frames"]>;
+//# sourceMappingURL=visual-renderer.d.ts.map

package/dist/infra/visual-renderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"visual-renderer.d.ts","sourceRoot":"","sources":["../../src/infra/visual-renderer.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEjD,eAAO,MAAM,YAAY,OAAO,CAAC;AACjC,eAAO,MAAM,cAAc,MAAM,CAAC;AAClC,eAAO,MAAM,WAAW,KAAK,CAAC;AAC9B,eAAO,MAAM,iBAAiB,IAAI,CAAC;AACnC,eAAO,MAAM,gBAAgB,UAAY,CAAC;AAC1C,eAAO,MAAM,gBAAgB,MAAM,CAAC;AAEpC,6FAA6F;AAC7F,wBAAgB,cAAc,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE;IAE5C,KAAK;IACZ,MAAM;EACT;AAED,8EAA8E;AAC9E,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAE1E;AAaD,wBAAsB,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC,CAuBhH"}