pi-fabric 0.96.3 → 0.97.0

package/README.md

@@ -142,12 +142,13 @@ See the [interface & commands reference](docs/interface.md) for every view, keyb
 
 - [Configuration](docs/configuration.md): `fabric.json`, code modes, tool capture, approvals, and budgets.
 - [Execution kernels](docs/kernels.md): exclusive TypeScript/Python selection, Monty sandboxing, CPython escape hatch, agent inheritance, and examples.
+- [Prompt cache](docs/prompt-cache.md): honest cache observations and optional, time-bounded native warming leases.
 - [Memory & recall](docs/memory-recall.md): compact ranked hits, uniform follow calls, lossless expansion, and guest-local `memory.walk` computation.
 - [Interface & commands](docs/interface.md): dashboard, settings, keybindings, slash commands, and headless runs.
 - [Agents, actors & mesh](docs/agents.md): model handoff, `/fabric prewalk`, runners, transports, actors, councils, recursive queries, and durable coordination.
 - [Durable residency through Pi](docs/residency-runtime.md): background host lifecycle and the Pi-runtime launcher boundary.
-- [External connector components](docs/harnesses.md): connector-owned browser/macOS extensions using the generic component lifecycle. No connector-specific runtime registration; works with ordinary models, deterministic code, or Jev.
-- [Jev System One programs](docs/jev.md): typed judgments, `/login jev`, `openrouter`, or `vercel-ai-gateway` credentials, foreground/background loops, and budgets.
+- [Harness CLI composition](docs/harnesses.md): use browser/macOS tools through their existing CLIs, without Fabric-specific bridges or component configuration.
+- [Jev shell orchestration](docs/jev.md): bounded process supervision, event-driven task wait/watch, optional explicit typed judgments, and foreground/background budgets.
 - [Components & committed capabilities](docs/components.md): supervised effects, exact requirements, external per-model guidance and execution-profile replacement, rolling provider generations, actor commitments, and both formal calculi.
 - [External providers](docs/providers.md): the versioned provider protocol for extensions.
 - [Architecture & security](docs/architecture.md): the host bridge, sandboxing, tool-call robustness, and limits.

package/dist/cache/leases.d.ts

@@ -0,0 +1,24 @@
+import type { ExtensionAPI, ExtensionContext } from "@earendil-works/pi-coding-agent";
+import type { FabricCacheHoldOptions, FabricCacheHoldResult, FabricCacheLease } from "./types.js";
+export declare const MAX_CACHE_LEASE_MS: number;
+export declare const MAX_CACHE_LEASES = 128;
+export declare class CacheLeases {
+    #private;
+    private readonly pi;
+    private readonly sessionId;
+    constructor(pi: ExtensionAPI, sessionId: string);
+    supported(context: ExtensionContext): boolean;
+    get cleanupError(): string | null;
+    values(): FabricCacheLease[];
+    reconcile(context: ExtensionContext): void;
+    hold(options: FabricCacheHoldOptions, context: ExtensionContext, scope: FabricCacheLease["scope"], invocationId: string, signal?: AbortSignal): FabricCacheHoldResult;
+    release(id: string): {
+        released: boolean;
+        cleanupError: string | null;
+    };
+    dispose(id: string): void;
+    invocationEnded(id: string): void;
+    invalidate(): void;
+    close(): void;
+}
+//# sourceMappingURL=leases.d.ts.map

package/dist/cache/leases.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"leases.d.ts","sourceRoot":"","sources":["../../src/cache/leases.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AACtF,OAAO,KAAK,EAAE,sBAAsB,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAUlG,eAAO,MAAM,kBAAkB,QAAc,CAAC;AAC9C,eAAO,MAAM,gBAAgB,MAAM,CAAC;AAEpC,qBAAa,WAAW;;IASV,OAAO,CAAC,QAAQ,CAAC,EAAE;IAAgB,OAAO,CAAC,QAAQ,CAAC,SAAS;gBAA5C,EAAE,EAAE,YAAY,EAAmB,SAAS,EAAE,MAAM;IAEjF,SAAS,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO;IAG7C,IAAI,YAAY,IAAI,MAAM,GAAG,IAAI,CAA+B;IAChE,MAAM,IAAI,gBAAgB,EAAE;IAU5B,SAAS,CAAC,OAAO,EAAE,gBAAgB,GAAG,IAAI;IA2B1C,IAAI,CAAC,OAAO,EAAE,sBAAsB,EAAE,OAAO,EAAE,gBAAgB,EAAE,KAAK,EAAE,gBAAgB,CAAC,OAAO,CAAC,EAC/F,YAAY,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,qBAAqB;IAuCpE,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG;QAAE,QAAQ,EAAE,OAAO,CAAC;QAAC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE;IAKvE,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAIzB,eAAe,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IA0BjC,UAAU,IAAI,IAAI;IAIlB,KAAK,IAAI,IAAI;CAOd"}

package/dist/cache/observations.d.ts

@@ -0,0 +1,8 @@
+import type { ExtensionContext } from "@earendil-works/pi-coding-agent";
+import type { FabricCacheObservation, FabricCacheSample } from "./types.js";
+export declare const CACHE_OBSERVATION_LIMIT = 256;
+/** Unknown counters are not zero-percent cache misses. */
+export declare function cacheSample(usage: unknown, entryId: string, timestamp: string): FabricCacheSample | null;
+/** Bounded active-branch walk; never scans session files or abandoned branches. */
+export declare function observePromptCache(context: ExtensionContext): FabricCacheObservation;
+//# sourceMappingURL=observations.d.ts.map

package/dist/cache/observations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"observations.d.ts","sourceRoot":"","sources":["../../src/cache/observations.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AACxE,OAAO,KAAK,EAAE,sBAAsB,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAE5E,eAAO,MAAM,uBAAuB,MAAM,CAAC;AAM3C,0DAA0D;AAC1D,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,iBAAiB,GAAG,IAAI,CAYxG;AAED,mFAAmF;AACnF,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,gBAAgB,GAAG,sBAAsB,CA+CpF"}

package/dist/cache/types.d.ts

@@ -0,0 +1,68 @@
+export interface FabricCacheHoldOptions {
+    /** self is the local Pi session; main is accepted only in a root Pi runtime. */
+    target?: "self" | "main";
+    durationMs: number;
+    /** Requires native admission support; currently returns unsupported, never ignored. */
+    maxRefreshes?: number;
+    /** Requires native admission support; currently returns unsupported, never ignored. */
+    maxCostUsd?: number;
+}
+export interface FabricCacheLease {
+    id: string;
+    scope: "session" | "component";
+    sessionId: string;
+    model: string;
+    expiresAt: number;
+}
+export type FabricCacheHoldResult = ({
+    status: "held";
+} & FabricCacheLease) | {
+    status: "unsupported" | "unavailable";
+    reason: string;
+};
+export interface FabricCacheSample {
+    entryId: string;
+    observedAt: number;
+    input: number;
+    cacheRead: number;
+    cacheWrite: number;
+    output: number;
+    totalInput: number;
+    cacheReadShare: number;
+    reportedCostUsd: number | null;
+}
+export interface FabricCacheObservation {
+    lastRequest: FabricCacheSample | null;
+    lastRefresh: FabricCacheSample | null;
+    maintenance: {
+        requests: number;
+        tokens: number;
+        reportedCostUsd: number;
+        unknownCostRequests: number;
+        unknownTokenRequests: number;
+    };
+    window: {
+        entries: number;
+        limit: number;
+        truncated: boolean;
+        stoppedAt: string | null;
+    };
+}
+export interface FabricCacheStatus {
+    target: "self";
+    sessionId: string;
+    model: string | null;
+    supported: boolean;
+    reason: string | null;
+    limits: {
+        durationMs: true;
+        maxRefreshes: false;
+        maxCostUsd: false;
+    };
+    leases: FabricCacheLease[];
+    /** Native scheduling/residency is not observable through the scoped lease API. */
+    scheduled: null;
+    cleanupError: string | null;
+    observation: FabricCacheObservation;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/cache/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/cache/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,sBAAsB;IACrC,gFAAgF;IAChF,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,uFAAuF;IACvF,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,uFAAuF;IACvF,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,SAAS,GAAG,WAAW,CAAC;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,MAAM,qBAAqB,GAC7B,CAAC;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,GAAG,gBAAgB,CAAC,GACvC;IAAE,MAAM,EAAE,aAAa,GAAG,aAAa,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAE9D,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;IACvB,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;CAChC;AAED,MAAM,WAAW,sBAAsB;IACrC,WAAW,EAAE,iBAAiB,GAAG,IAAI,CAAC;IACtC,WAAW,EAAE,iBAAiB,GAAG,IAAI,CAAC;IACtC,WAAW,EAAE;QACX,QAAQ,EAAE,MAAM,CAAC;QACjB,MAAM,EAAE,MAAM,CAAC;QACf,eAAe,EAAE,MAAM,CAAC;QACxB,mBAAmB,EAAE,MAAM,CAAC;QAC5B,oBAAoB,EAAE,MAAM,CAAC;KAC9B,CAAC;IACF,MAAM,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,OAAO,CAAC;QAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC;CAC1F;AAED,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,SAAS,EAAE,OAAO,CAAC;IACnB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,MAAM,EAAE;QAAE,UAAU,EAAE,IAAI,CAAC;QAAC,YAAY,EAAE,KAAK,CAAC;QAAC,UAAU,EAAE,KAAK,CAAA;KAAE,CAAC;IACrE,MAAM,EAAE,gBAAgB,EAAE,CAAC;IAC3B,kFAAkF;IAClF,SAAS,EAAE,IAAI,CAAC;IAChB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,WAAW,EAAE,sBAAsB,CAAC;CACrC"}

package/dist/chunks/{chunk-3CJETB4S.js → chunk-2LBC6TTP.js}

@@ -29,7 +29,7 @@ import {
 } from "./chunk-KS44WKJJ.js";
 import {
   FABRIC_NESTED_TOOL_CALL_ID_PREFIX
-} from "./chunk-Y57UHPIK.js";
+} from "./chunk-KBHITFTO.js";
 import {
   FabricResolutionError,
   FabricTraceSafeError,
@@ -2101,4 +2101,4 @@ export {
   scoreActionSearch,
   ActionRegistry
 };
-//# sourceMappingURL=chunk-3CJETB4S.js.map
+//# sourceMappingURL=chunk-2LBC6TTP.js.map

package/dist/chunks/{chunk-GGETIGM5.js → chunk-5WUW727L.js}

@@ -1358,6 +1358,7 @@ var FABRIC_COMPONENT_PROVIDER_NAMES = [
   "state",
   "schema",
   "compact",
+  "cache",
   "prewalk",
   "agents",
   "memory",
@@ -1792,4 +1793,4 @@ export {
   captureLoadedFileIdentity,
   runtimeIdentityStatus
 };
-//# sourceMappingURL=chunk-GGETIGM5.js.map
+//# sourceMappingURL=chunk-5WUW727L.js.map