pi-fabric 0.76.2 → 0.78.0

package/dist/providers/arg-normalization.d.ts

@@ -7,6 +7,9 @@ export interface ArgNormalizationSpec {
     knownKeys?: readonly string[];
 }
 export type ActionArgNormalizer = (actionName: string, args: Record<string, unknown>) => Record<string, unknown>;
+/** Unique declared key for a spilled spelling, or undefined when already
+ * canonical / ambiguous / unmatched. Used by the catalog repair compiler. */
+export declare const uniqueDeclaredKeyForSpelling: (spilled: string, declared: readonly string[]) => string | undefined;
 export declare const normalizeActionArgs: (args: Record<string, unknown>, spec: ArgNormalizationSpec) => Record<string, unknown>;
 export declare const actionArgNormalizer: (describeActions: () => ReadonlyArray<Pick<FabricActionDescriptor, "name" | "inputSchema">>, table?: Record<string, ArgNormalizationSpec>) => ActionArgNormalizer;
 //# sourceMappingURL=arg-normalization.d.ts.map

package/dist/providers/arg-normalization.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"arg-normalization.d.ts","sourceRoot":"","sources":["../../src/providers/arg-normalization.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AAiC7D,MAAM,WAAW,oBAAoB;IAGnC,OAAO,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAC3C,QAAQ,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC7B,aAAa,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,MAAM,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;IAGrE,SAAS,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC/B;AAED,MAAM,MAAM,mBAAmB,GAAG,CAChC,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAC1B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAoQ7B,eAAO,MAAM,mBAAmB,GAC9B,MAAM,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,MAAM,oBAAoB,KACzB,MAAM,CAAC,MAAM,EAAE,OAAO,CAqBxB,CAAC;AAOF,eAAO,MAAM,mBAAmB,GAC9B,iBAAiB,MAAM,aAAa,CAAC,IAAI,CAAC,sBAAsB,EAAE,MAAM,GAAG,aAAa,CAAC,CAAC,EAC1F,QAAO,MAAM,CAAC,MAAM,EAAE,oBAAoB,CAAM,KAC/C,mBAgBF,CAAC"}
+{"version":3,"file":"arg-normalization.d.ts","sourceRoot":"","sources":["../../src/providers/arg-normalization.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AAiC7D,MAAM,WAAW,oBAAoB;IAGnC,OAAO,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAC3C,QAAQ,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC7B,aAAa,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,MAAM,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;IAGrE,SAAS,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC/B;AAED,MAAM,MAAM,mBAAmB,GAAG,CAChC,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAC1B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAoM7B;6EAC6E;AAC7E,eAAO,MAAM,4BAA4B,GACvC,SAAS,MAAM,EACf,UAAU,SAAS,MAAM,EAAE,KAC1B,MAAM,GAAG,SAeX,CAAC;AAkEF,eAAO,MAAM,mBAAmB,GAC9B,MAAM,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,MAAM,oBAAoB,KACzB,MAAM,CAAC,MAAM,EAAE,OAAO,CAqBxB,CAAC;AAOF,eAAO,MAAM,mBAAmB,GAC9B,iBAAiB,MAAM,aAAa,CAAC,IAAI,CAAC,sBAAsB,EAAE,MAAM,GAAG,aAAa,CAAC,CAAC,EAC1F,QAAO,MAAM,CAAC,MAAM,EAAE,oBAAoB,CAAM,KAC/C,mBAgBF,CAAC"}

package/dist/providers/memory-provider.js

@@ -1,7 +1,7 @@
 import {
   MemoryProvider,
   normalizeMemoryArgs
-} from "../chunks/chunk-6BBFFEPO.js";
+} from "../chunks/chunk-DYEOFQ64.js";
 import "../chunks/chunk-BOIV6E3C.js";
 import "../chunks/chunk-NNFA2OIC.js";
 import "../chunks/chunk-E3V22XGU.js";

package/dist/providers/pi-tools-provider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pi-tools-provider.d.ts","sourceRoot":"","sources":["../../src/providers/pi-tools-provider.ts"],"names":[],"mappings":"AAcA,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAI5D,OAAO,KAAK,EACV,sBAAsB,EACtB,uBAAuB,EAEvB,cAAc,EACd,yBAAyB,EAE1B,MAAM,gBAAgB,CAAC;AAExB,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AAmJrE,qBAAa,eAAgB,YAAW,cAAc;;IACpD,QAAQ,CAAC,IAAI,QAAQ;IACrB,QAAQ,CAAC,WAAW,gCAAgC;gBAQlD,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE,mBAAmB,EAC7B,aAAa,CAAC,EAAE,qBAAqB;IAgBjC,IAAI,CACR,OAAO,EAAE,yBAAyB,EAClC,QAAQ,EAAE,uBAAuB,GAChC,OAAO,CAAC,sBAAsB,EAAE,CAAC;IAY9B,QAAQ,CACZ,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,uBAAuB,GAChC,OAAO,CAAC,sBAAsB,GAAG,SAAS,CAAC;IAS9C,gBAAgB,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAsCtF,MAAM,CACV,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,OAAO,EAAE,uBAAuB,GAC/B,OAAO,CAAC,OAAO,CAAC;CA8SpB"}
+{"version":3,"file":"pi-tools-provider.d.ts","sourceRoot":"","sources":["../../src/providers/pi-tools-provider.ts"],"names":[],"mappings":"AAeA,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAI5D,OAAO,KAAK,EACV,sBAAsB,EACtB,uBAAuB,EAEvB,cAAc,EACd,yBAAyB,EAE1B,MAAM,gBAAgB,CAAC;AAExB,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AAmJrE,qBAAa,eAAgB,YAAW,cAAc;;IACpD,QAAQ,CAAC,IAAI,QAAQ;IACrB,QAAQ,CAAC,WAAW,gCAAgC;gBAQlD,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE,mBAAmB,EAC7B,aAAa,CAAC,EAAE,qBAAqB;IAgBjC,IAAI,CACR,OAAO,EAAE,yBAAyB,EAClC,QAAQ,EAAE,uBAAuB,GAChC,OAAO,CAAC,sBAAsB,EAAE,CAAC;IAY9B,QAAQ,CACZ,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,uBAAuB,GAChC,OAAO,CAAC,sBAAsB,GAAG,SAAS,CAAC;IAS9C,gBAAgB,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAsCtF,MAAM,CACV,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,OAAO,EAAE,uBAAuB,GAC/B,OAAO,CAAC,OAAO,CAAC;CAqTpB"}

package/dist/repairs/active.d.ts

@@ -0,0 +1,7 @@
+import type { RepairCompiler } from "./compiler.js";
+export declare const setActiveRepairCompiler: (compiler: RepairCompiler | undefined) => void;
+export declare const clearActiveRepairCompiler: (compiler: RepairCompiler | undefined) => void;
+export declare const getActiveRepairCompiler: () => RepairCompiler | undefined;
+export declare const applyActiveArgRepairs: (ref: string, args: Record<string, unknown>, schema: Record<string, unknown>) => Record<string, unknown>;
+export declare const applyActiveActionName: (provider: string, actionName: string, declared: readonly string[]) => string;
+//# sourceMappingURL=active.d.ts.map

package/dist/repairs/active.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"active.d.ts","sourceRoot":"","sources":["../../src/repairs/active.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAIpD,eAAO,MAAM,uBAAuB,GAAI,UAAU,cAAc,GAAG,SAAS,KAAG,IAE9E,CAAC;AAEF,eAAO,MAAM,yBAAyB,GAAI,UAAU,cAAc,GAAG,SAAS,KAAG,IAEhF,CAAC;AAEF,eAAO,MAAM,uBAAuB,QAAO,cAAc,GAAG,SAAmB,CAAC;AAEhF,eAAO,MAAM,qBAAqB,GAChC,KAAK,MAAM,EACX,MAAM,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,QAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAC9B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAiD,CAAC;AAE3E,eAAO,MAAM,qBAAqB,GAChC,UAAU,MAAM,EAChB,YAAY,MAAM,EAClB,UAAU,SAAS,MAAM,EAAE,KAC1B,MAA+E,CAAC"}

package/dist/repairs/apply.d.ts

@@ -0,0 +1,7 @@
+import type { CatalogRepair } from "./types.js";
+export declare const applyActionAliasRepairs: (provider: string, actionName: string, repairs: readonly CatalogRepair[], declared: readonly string[]) => string | undefined;
+export declare const applyCatalogArgRepairs: (ref: string, args: Record<string, unknown>, repairs: readonly CatalogRepair[], schema: Record<string, unknown>) => {
+    args: Record<string, unknown>;
+    changed: boolean;
+};
+//# sourceMappingURL=apply.d.ts.map

package/dist/repairs/apply.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"apply.d.ts","sourceRoot":"","sources":["../../src/repairs/apply.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAqDhD,eAAO,MAAM,uBAAuB,GAClC,UAAU,MAAM,EAChB,YAAY,MAAM,EAClB,SAAS,SAAS,aAAa,EAAE,EACjC,UAAU,SAAS,MAAM,EAAE,KAC1B,MAAM,GAAG,SAYX,CAAC;AAEF,eAAO,MAAM,sBAAsB,GACjC,KAAK,MAAM,EACX,MAAM,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,SAAS,SAAS,aAAa,EAAE,EACjC,QAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAC9B;IAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CACF,CAAC"}

package/dist/repairs/catalog-digest.d.ts

@@ -0,0 +1,5 @@
+export declare const catalogDigestFromSurface: (surface: {
+    providers: readonly string[];
+    capturedTools: readonly string[];
+}) => string;
+//# sourceMappingURL=catalog-digest.d.ts.map

package/dist/repairs/catalog-digest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog-digest.d.ts","sourceRoot":"","sources":["../../src/repairs/catalog-digest.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,wBAAwB,GAAI,SAAS;IAChD,SAAS,EAAE,SAAS,MAAM,EAAE,CAAC;IAC7B,aAAa,EAAE,SAAS,MAAM,EAAE,CAAC;CAClC,KAAG,MAKA,CAAC"}

package/dist/repairs/classify.d.ts

@@ -0,0 +1,10 @@
+import type { RepairClassification } from "./types.js";
+export declare const classifyInvalidArgs: (ref: string, message: string, extraKeys?: readonly string[]) => RepairClassification;
+export declare const classifyUnknownAction: (ref: string) => RepairClassification;
+export declare const classifyTypeErrors: (messages: readonly string[], enclosingTool?: string) => RepairClassification[];
+export declare const classifyToolResult: (input: {
+    toolName?: string;
+    isError?: boolean;
+    content?: unknown;
+}) => RepairClassification | undefined;
+//# sourceMappingURL=classify.d.ts.map

package/dist/repairs/classify.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"classify.d.ts","sourceRoot":"","sources":["../../src/repairs/classify.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAiB,oBAAoB,EAAe,MAAM,YAAY,CAAC;AAmFnF,eAAO,MAAM,mBAAmB,GAC9B,KAAK,MAAM,EACX,SAAS,MAAM,EACf,YAAW,SAAS,MAAM,EAAkC,KAC3D,oBAMF,CAAC;AAEF,eAAO,MAAM,qBAAqB,GAAI,KAAK,MAAM,KAAG,oBAMnD,CAAC;AAEF,eAAO,MAAM,kBAAkB,GAC7B,UAAU,SAAS,MAAM,EAAE,EAC3B,gBAAgB,MAAM,KACrB,oBAAoB,EA8CtB,CAAC;AAEF,eAAO,MAAM,kBAAkB,GAAI,OAAO;IACxC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB,KAAG,oBAAoB,GAAG,SAwC1B,CAAC"}

package/dist/repairs/compiler.d.ts

@@ -0,0 +1,32 @@
+import { type CatalogRepair, type RepairClassification, type RepairStatus } from "./types.js";
+export interface RepairCompilerOptions {
+    agentDir: string;
+    enabled?: boolean;
+}
+export declare class RepairCompiler {
+    #private;
+    readonly directory: string;
+    readonly enabled: boolean;
+    constructor(options: RepairCompilerOptions);
+    get catalogDigest(): string;
+    get repairs(): readonly CatalogRepair[];
+    setCatalogSurface(surface: {
+        providers: readonly string[];
+        capturedTools: readonly string[];
+    }): void;
+    observe(classification: RepairClassification, options?: {
+        countError?: boolean;
+    }): CatalogRepair | undefined;
+    recordInvocationError(): void;
+    observeInvalidArgs(ref: string, args: Record<string, unknown>, declared: readonly string[], message: string, options?: {
+        countError?: boolean;
+        extraKeys?: readonly string[];
+    }): CatalogRepair | undefined;
+    observeUnknownAction(provider: string, actionName: string, declared: readonly string[], options?: {
+        countError?: boolean;
+    }): CatalogRepair | undefined;
+    applyArgs(ref: string, args: Record<string, unknown>, schema: Record<string, unknown>): Record<string, unknown>;
+    applyActionName(provider: string, actionName: string, declared: readonly string[]): string;
+    status(): RepairStatus;
+}
+//# sourceMappingURL=compiler.d.ts.map

package/dist/repairs/compiler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compiler.d.ts","sourceRoot":"","sources":["../../src/repairs/compiler.ts"],"names":[],"mappings":"AAIA,OAAO,EAIL,KAAK,aAAa,EAClB,KAAK,oBAAoB,EAEzB,KAAK,YAAY,EAElB,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,qBAAqB;IACpC,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAWD,qBAAa,cAAc;;IACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;gBASd,OAAO,EAAE,qBAAqB;IAM1C,IAAI,aAAa,IAAI,MAAM,CAE1B;IAED,IAAI,OAAO,IAAI,SAAS,aAAa,EAAE,CAEtC;IAED,iBAAiB,CAAC,OAAO,EAAE;QACzB,SAAS,EAAE,SAAS,MAAM,EAAE,CAAC;QAC7B,aAAa,EAAE,SAAS,MAAM,EAAE,CAAC;KAClC,GAAG,IAAI;IAiBR,OAAO,CACL,cAAc,EAAE,oBAAoB,EACpC,OAAO,CAAC,EAAE;QAAE,UAAU,CAAC,EAAE,OAAO,CAAA;KAAE,GACjC,aAAa,GAAG,SAAS;IAkB5B,qBAAqB,IAAI,IAAI;IAI7B,kBAAkB,CAChB,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,QAAQ,EAAE,SAAS,MAAM,EAAE,EAC3B,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE;QAAE,UAAU,CAAC,EAAE,OAAO,CAAC;QAAC,SAAS,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;KAAE,GAChE,aAAa,GAAG,SAAS;IAc5B,oBAAoB,CAClB,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,SAAS,MAAM,EAAE,EAC3B,OAAO,CAAC,EAAE;QAAE,UAAU,CAAC,EAAE,OAAO,CAAA;KAAE,GACjC,aAAa,GAAG,SAAS;IAY5B,SAAS,CACP,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAO1B,eAAe,CACb,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,SAAS,MAAM,EAAE,GAC1B,MAAM;IAeT,MAAM,IAAI,YAAY;CAwDvB"}

package/dist/repairs/promote.d.ts

@@ -0,0 +1,4 @@
+import type { CatalogRepair } from "./types.js";
+export declare const keyAliasCandidate: (ref: string, extraKeys: readonly string[], declared: readonly string[]) => CatalogRepair | undefined;
+export declare const actionAliasCandidate: (provider: string, actionName: string, declared: readonly string[]) => CatalogRepair | undefined;
+//# sourceMappingURL=promote.d.ts.map

package/dist/repairs/promote.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"promote.d.ts","sourceRoot":"","sources":["../../src/repairs/promote.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD,eAAO,MAAM,iBAAiB,GAC5B,KAAK,MAAM,EACX,WAAW,SAAS,MAAM,EAAE,EAC5B,UAAU,SAAS,MAAM,EAAE,KAC1B,aAAa,GAAG,SAMlB,CAAC;AAEF,eAAO,MAAM,oBAAoB,GAC/B,UAAU,MAAM,EAChB,YAAY,MAAM,EAClB,UAAU,SAAS,MAAM,EAAE,KAC1B,aAAa,GAAG,SASlB,CAAC"}

package/dist/repairs/store.d.ts

@@ -0,0 +1,9 @@
+import { type RepairTableFile } from "./types.js";
+export declare const repairsDirectory: (agentDir: string) => string;
+export interface LoadedRepairTable {
+    table: RepairTableFile;
+    error?: string;
+}
+export declare const loadRepairTable: (directory: string, catalogDigest: string) => LoadedRepairTable;
+export declare const saveRepairTable: (directory: string, table: RepairTableFile) => RepairTableFile;
+//# sourceMappingURL=store.d.ts.map

package/dist/repairs/store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../src/repairs/store.ts"],"names":[],"mappings":"AAIA,OAAO,EAML,KAAK,eAAe,EACrB,MAAM,YAAY,CAAC;AAMpB,eAAO,MAAM,gBAAgB,GAAI,UAAU,MAAM,KAAG,MACV,CAAC;AAwN3C,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,eAAe,CAAC;IACvB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,eAAO,MAAM,eAAe,GAC1B,WAAW,MAAM,EACjB,eAAe,MAAM,KACpB,iBA4BF,CAAC;AAEF,eAAO,MAAM,eAAe,GAC1B,WAAW,MAAM,EACjB,OAAO,eAAe,KACrB,eA2BC,CAAC"}

package/dist/repairs/types.d.ts

@@ -0,0 +1,49 @@
+export declare const REPAIR_TABLE_VERSION: 1;
+export declare const MAX_CATALOG_REPAIRS = 256;
+export type RepairStage = "invocation_outer_schema" | "invocation_typecheck" | "invocation_args" | "invocation_unknown_action" | "didactic" | "effect";
+interface KeyAliasRepair {
+    kind: "keyAlias";
+    ref: string;
+    from: string;
+    to: string;
+}
+interface ActionAliasRepair {
+    kind: "actionAlias";
+    provider: string;
+    from: string;
+    to: string;
+}
+export type CatalogRepair = KeyAliasRepair | ActionAliasRepair;
+export interface RepairTableFile {
+    version: typeof REPAIR_TABLE_VERSION;
+    catalogDigest: string;
+    repairs: CatalogRepair[];
+    createdAt: string;
+    updatedAt: string;
+}
+export interface RepairClassification {
+    stage: RepairStage;
+    fingerprint: string;
+    /** When set, a unique mapping the compiler may insert on first hit. */
+    candidate?: CatalogRepair;
+}
+interface RepairFingerprintCount {
+    fingerprint: string;
+    stage: RepairStage;
+    count: number;
+}
+export interface RepairStatus {
+    enabled: boolean;
+    catalogDigest: string;
+    repairCount: number;
+    applyHits: number;
+    invocationErrors: number;
+    effectDropped: number;
+    storeError?: string;
+    fingerprints: RepairFingerprintCount[];
+    repairs: CatalogRepair[];
+}
+export declare const repairIdentity: (repair: CatalogRepair) => string;
+export declare const emptyRepairTable: (catalogDigest: string, now?: string) => RepairTableFile;
+export {};
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/repairs/types.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,oBAAoB,EAAG,CAAU,CAAC;AAC/C,eAAO,MAAM,mBAAmB,MAAM,CAAC;AAEvC,MAAM,MAAM,WAAW,GACnB,yBAAyB,GACzB,sBAAsB,GACtB,iBAAiB,GACjB,2BAA2B,GAC3B,UAAU,GACV,QAAQ,CAAC;AAEb,UAAU,cAAc;IACtB,IAAI,EAAE,UAAU,CAAC;IACjB,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;CACZ;AAED,UAAU,iBAAiB;IACzB,IAAI,EAAE,aAAa,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;CACZ;AAED,MAAM,MAAM,aAAa,GAAG,cAAc,GAAG,iBAAiB,CAAC;AAE/D,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,OAAO,oBAAoB,CAAC;IACrC,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,aAAa,EAAE,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,WAAW,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,uEAAuE;IACvE,SAAS,CAAC,EAAE,aAAa,CAAC;CAC3B;AAED,UAAU,sBAAsB;IAC9B,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,WAAW,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,OAAO,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,gBAAgB,EAAE,MAAM,CAAC;IACzB,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,sBAAsB,EAAE,CAAC;IACvC,OAAO,EAAE,aAAa,EAAE,CAAC;CAC1B;AAED,eAAO,MAAM,cAAc,GAAI,QAAQ,aAAa,KAAG,MAKtD,CAAC;AAEF,eAAO,MAAM,gBAAgB,GAC3B,eAAe,MAAM,EACrB,YAA8B,KAC7B,eAMD,CAAC"}

package/dist/residency/client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/residency/client.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,cAAc,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAI3H,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,iCAAiC,CAAC;AAChF,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AAC9D,OAAO,EAAE,SAAS,EAAuB,MAAM,kBAAkB,CAAC;AAClE,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AACpE,OAAO,EAQL,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,EACvB,MAAM,eAAe,CAAC;AA6DvB,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,kBAAkB,CAAC;IAC3B,IAAI,EAAE,SAAS,CAAC;IAChB,YAAY,EAAE,uBAAuB,CAAC;IACtC,SAAS,EAAE,qBAAqB,CAAC;IACjC,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,qBAAa,eAAe;;IAed,QAAQ,CAAC,OAAO,EAAE,sBAAsB;IAdpD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;gBAcH,OAAO,EAAE,sBAAsB;IAYpD,KAAK,IAAI,IAAI;IAUP,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAO5B,mBAAmB,CAAC,QAAQ,EAAE,SAAS,wBAAwB,EAAE,GAAG,IAAI;IAWlE,UAAU,IAAI,OAAO,CAAC,iBAAiB,CAAC;IAqCxC,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKtC,UAAU,CAAC,OAAO,EAAE,eAAe,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,eAAe,CAAC;IAsB1F,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAI7B,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,cAAc,GAAG,eAAe;IAezD,UAAU,IAAI,KAAK,CAAC,cAAc,GAAG,eAAe,CAAC;IAkB/C,SAAS,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,cAAc,CAAC;IAmB1E,YAAY,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,GAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAO,GAAG,cAAc;IAiBrF,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC;IAatD,YAAY,CAAC,EAAE,EAAE,MAAM,EAAE,YAAY,UAAQ,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC;CAgLpF"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/residency/client.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,cAAc,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAK3H,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,iCAAiC,CAAC;AAChF,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AAC9D,OAAO,EAAE,SAAS,EAAuB,MAAM,kBAAkB,CAAC;AAClE,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AACpE,OAAO,EAQL,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,EACvB,MAAM,eAAe,CAAC;AA6DvB,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,kBAAkB,CAAC;IAC3B,IAAI,EAAE,SAAS,CAAC;IAChB,YAAY,EAAE,uBAAuB,CAAC;IACtC,SAAS,EAAE,qBAAqB,CAAC;IACjC,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,qBAAa,eAAe;;IAed,QAAQ,CAAC,OAAO,EAAE,sBAAsB;IAdpD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;gBAcH,OAAO,EAAE,sBAAsB;IAYpD,KAAK,IAAI,IAAI;IAUP,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAO5B,mBAAmB,CAAC,QAAQ,EAAE,SAAS,wBAAwB,EAAE,GAAG,IAAI;IAWlE,UAAU,IAAI,OAAO,CAAC,iBAAiB,CAAC;IAqCxC,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKtC,UAAU,CAAC,OAAO,EAAE,eAAe,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,eAAe,CAAC;IAsB1F,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAI7B,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,cAAc,GAAG,eAAe;IAezD,UAAU,IAAI,KAAK,CAAC,cAAc,GAAG,eAAe,CAAC;IAkB/C,SAAS,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,cAAc,CAAC;IAmB1E,YAAY,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,GAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAO,GAAG,cAAc;IAiBrF,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC;IAatD,YAAY,CAAC,EAAE,EAAE,MAAM,EAAE,YAAY,UAAQ,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC;CA4KpF"}

package/dist/residency/host.js

@@ -1,14 +1,14 @@
 #!/usr/bin/env node
 import {
   runResidentHostFromConfigPath
-} from "../chunks/chunk-BT6UELLP.js";
-import "../chunks/chunk-F2GKEXGI.js";
+} from "../chunks/chunk-DUIHQAIZ.js";
+import "../chunks/chunk-PFF3X7OO.js";
 import "../chunks/chunk-PM5I335G.js";
 import "../chunks/chunk-VPPIJRNZ.js";
 import "../chunks/chunk-QWIKS6CT.js";
 import "../chunks/chunk-FL52NCFS.js";
 import "../chunks/chunk-WRKD7W34.js";
-import "../chunks/chunk-QXB75FLD.js";
+import "../chunks/chunk-2E3CAABA.js";
 import "../chunks/chunk-7B55UIZL.js";
 import "../chunks/chunk-R7ZFQATZ.js";
 import "../chunks/chunk-2YCOXT4W.js";

package/dist/residency/pi-entry.js

@@ -1,13 +1,13 @@
 import {
   runResidentHostFromConfigPath
-} from "../chunks/chunk-BT6UELLP.js";
-import "../chunks/chunk-F2GKEXGI.js";
+} from "../chunks/chunk-DUIHQAIZ.js";
+import "../chunks/chunk-PFF3X7OO.js";
 import "../chunks/chunk-PM5I335G.js";
 import "../chunks/chunk-VPPIJRNZ.js";
 import "../chunks/chunk-QWIKS6CT.js";
 import "../chunks/chunk-FL52NCFS.js";
 import "../chunks/chunk-WRKD7W34.js";
-import "../chunks/chunk-QXB75FLD.js";
+import "../chunks/chunk-2E3CAABA.js";
 import "../chunks/chunk-7B55UIZL.js";
 import "../chunks/chunk-R7ZFQATZ.js";
 import "../chunks/chunk-2YCOXT4W.js";

package/dist/speculation/store.d.ts

@@ -6,10 +6,14 @@ import type { FabricSpeculationConfig, FabricSpeculationReplay, FabricSpeculatio
  * Correctness contract: a stored promise may only be served to a real call
  * when (1) the mutation epoch has not advanced since the speculation launched
  * — the epoch bumps after any real in-program invocation whose effect kind is
- * not "none" — and (2) the entry's freshness checker, when present, still
- * holds. Entries are take-once (identical duplicate calls each need their own
- * speculation) and are aborted + counted wasted when their execution finishes
- * without serving them or when the turn resets.
+ * not "none" — (2) the entry's freshness checker, when present, still holds,
+ * and (3) the entry was launched against the same provider binding the real
+ * call resolved: the binding token is part of the cache key, so an entry that
+ * a reset could not abort (its speculate() was still mid-describe when the
+ * binding was replaced) can never match the replacement's serve key. Entries
+ * are take-once (identical duplicate calls each need their own speculation)
+ * and are aborted + counted wasted when their execution finishes without
+ * serving them or when the turn resets.
  */
 export declare class FabricSpeculationStore implements FabricSpeculationRuntime {
     #private;
@@ -19,14 +23,14 @@ export declare class FabricSpeculationStore implements FabricSpeculationRuntime
         pending: number;
     };
     bumpEpoch(): void;
-    static key(parentToolCallId: string, ref: string, preparedArgs: Record<string, unknown>): string;
+    static key(parentToolCallId: string, ref: string, preparedArgs: Record<string, unknown>, bindingToken: string): string;
     /**
      * Register and start a speculative invocation. Returns false when at
      * capacity; the candidate is dropped silently (a miss costs nothing, the
      * real call executes normally later).
      */
-    launch(parentToolCallId: string, ref: string, preparedArgs: Record<string, unknown>, execute: (signal: AbortSignal) => Promise<unknown>, freshness: FabricFreshnessChecker | undefined, replay: FabricSpeculationReplay): boolean;
-    tryServe(parentToolCallId: string, ref: string, preparedArgs: Record<string, unknown>): Promise<FabricSpeculationServeResult>;
+    launch(parentToolCallId: string, ref: string, preparedArgs: Record<string, unknown>, execute: (signal: AbortSignal) => Promise<unknown>, freshness: FabricFreshnessChecker | undefined, replay: FabricSpeculationReplay, bindingToken: string): boolean;
+    tryServe(parentToolCallId: string, ref: string, preparedArgs: Record<string, unknown>, bindingToken: string): Promise<FabricSpeculationServeResult>;
     /** Execution for this tool call finished: everything unserved is waste. */
     onInvocationEnd(parentToolCallId: string): void;
     /** Turn backstop: speculation never outlives a turn. */

package/dist/speculation/store.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../src/speculation/store.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AAC7D,OAAO,KAAK,EACV,uBAAuB,EACvB,uBAAuB,EACvB,wBAAwB,EACxB,4BAA4B,EAC5B,sBAAsB,EACvB,MAAM,YAAY,CAAC;AAcpB;;;;;;;;;;GAUG;AACH,qBAAa,sBAAuB,YAAW,wBAAwB;;gBAgBzD,MAAM,EAAE,IAAI,CAAC,uBAAuB,EAAE,eAAe,GAAG,YAAY,GAAG,YAAY,CAAC;IAMhG,IAAI,KAAK,IAAI,MAAM,CAElB;IAED,KAAK,IAAI,sBAAsB,GAAG;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE;IAIrD,SAAS,IAAI,IAAI;IAIjB,MAAM,CAAC,GAAG,CACR,gBAAgB,EAAE,MAAM,EACxB,GAAG,EAAE,MAAM,EACX,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACpC,MAAM;IAIT;;;;OAIG;IACH,MAAM,CACJ,gBAAgB,EAAE,MAAM,EACxB,GAAG,EAAE,MAAM,EACX,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACrC,OAAO,EAAE,CAAC,MAAM,EAAE,WAAW,KAAK,OAAO,CAAC,OAAO,CAAC,EAClD,SAAS,EAAE,sBAAsB,GAAG,SAAS,EAC7C,MAAM,EAAE,uBAAuB,GAC9B,OAAO;IAmCJ,QAAQ,CACZ,gBAAgB,EAAE,MAAM,EACxB,GAAG,EAAE,MAAM,EACX,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACpC,OAAO,CAAC,4BAA4B,CAAC;IA0BxC,2EAA2E;IAC3E,eAAe,CAAC,gBAAgB,EAAE,MAAM,GAAG,IAAI;IAS/C,wDAAwD;IACxD,KAAK,IAAI,IAAI;CAqBd"}
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../src/speculation/store.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AAC7D,OAAO,KAAK,EACV,uBAAuB,EACvB,uBAAuB,EACvB,wBAAwB,EACxB,4BAA4B,EAC5B,sBAAsB,EACvB,MAAM,YAAY,CAAC;AAcpB;;;;;;;;;;;;;;GAcG;AACH,qBAAa,sBAAuB,YAAW,wBAAwB;;gBAgBzD,MAAM,EAAE,IAAI,CAAC,uBAAuB,EAAE,eAAe,GAAG,YAAY,GAAG,YAAY,CAAC;IAMhG,IAAI,KAAK,IAAI,MAAM,CAElB;IAED,KAAK,IAAI,sBAAsB,GAAG;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE;IAIrD,SAAS,IAAI,IAAI;IAIjB,MAAM,CAAC,GAAG,CACR,gBAAgB,EAAE,MAAM,EACxB,GAAG,EAAE,MAAM,EACX,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACrC,YAAY,EAAE,MAAM,GACnB,MAAM;IAIT;;;;OAIG;IACH,MAAM,CACJ,gBAAgB,EAAE,MAAM,EACxB,GAAG,EAAE,MAAM,EACX,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACrC,OAAO,EAAE,CAAC,MAAM,EAAE,WAAW,KAAK,OAAO,CAAC,OAAO,CAAC,EAClD,SAAS,EAAE,sBAAsB,GAAG,SAAS,EAC7C,MAAM,EAAE,uBAAuB,EAC/B,YAAY,EAAE,MAAM,GACnB,OAAO;IAmCJ,QAAQ,CACZ,gBAAgB,EAAE,MAAM,EACxB,GAAG,EAAE,MAAM,EACX,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACrC,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,4BAA4B,CAAC;IA0BxC,2EAA2E;IAC3E,eAAe,CAAC,gBAAgB,EAAE,MAAM,GAAG,IAAI;IAS/C,wDAAwD;IACxD,KAAK,IAAI,IAAI;CAqBd"}

package/dist/speculation/types.d.ts

@@ -36,8 +36,9 @@ export type FabricSpeculationServeResult = {
  * the speculation package.
  */
 export interface FabricSpeculationRuntime {
-    tryServe(parentToolCallId: string, ref: string, preparedArgs: Record<string, unknown>): Promise<FabricSpeculationServeResult>;
+    tryServe(parentToolCallId: string, ref: string, preparedArgs: Record<string, unknown>, bindingToken: string): Promise<FabricSpeculationServeResult>;
     bumpEpoch(): void;
+    reset?(): void;
     onInvocationEnd?(parentToolCallId: string): void;
 }
 //# sourceMappingURL=types.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/speculation/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAC;AAC5D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAIvD,YAAY,EAAE,uBAAuB,EAAE,CAAC;AAGxC,8EAA8E;AAC9E,MAAM,WAAW,0BAA0B;IACzC,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC/B;AAED,oHAAoH;AACpH,MAAM,WAAW,uBAAuB;IACtC,KAAK,CAAC,EAAE,gBAAgB,EAAE,CAAC;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACtC,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,gBAAgB,EAAE,MAAM,CAAC;IACzB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,MAAM,4BAA4B,GACpC;IAAE,GAAG,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,uBAAuB,CAAA;CAAE,GAC9D;IAAE,GAAG,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,QAAQ,GAAG,OAAO,GAAG,WAAW,GAAG,QAAQ,CAAA;CAAE,CAAC;AAExE;;;;GAIG;AACH,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CACN,gBAAgB,EAAE,MAAM,EACxB,GAAG,EAAE,MAAM,EACX,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACpC,OAAO,CAAC,4BAA4B,CAAC,CAAC;IACzC,SAAS,IAAI,IAAI,CAAC;IAClB,eAAe,CAAC,CAAC,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;CAClD"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/speculation/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAC;AAC5D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAIvD,YAAY,EAAE,uBAAuB,EAAE,CAAC;AAGxC,8EAA8E;AAC9E,MAAM,WAAW,0BAA0B;IACzC,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC/B;AAED,oHAAoH;AACpH,MAAM,WAAW,uBAAuB;IACtC,KAAK,CAAC,EAAE,gBAAgB,EAAE,CAAC;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACtC,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,gBAAgB,EAAE,MAAM,CAAC;IACzB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,MAAM,4BAA4B,GACpC;IAAE,GAAG,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,uBAAuB,CAAA;CAAE,GAC9D;IAAE,GAAG,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,QAAQ,GAAG,OAAO,GAAG,WAAW,GAAG,QAAQ,CAAA;CAAE,CAAC;AAExE;;;;GAIG;AACH,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CACN,gBAAgB,EAAE,MAAM,EACxB,GAAG,EAAE,MAAM,EACX,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACrC,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,4BAA4B,CAAC,CAAC;IACzC,SAAS,IAAI,IAAI,CAAC;IAClB,KAAK,CAAC,IAAI,IAAI,CAAC;IACf,eAAe,CAAC,CAAC,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;CAClD"}

package/docs/agents.md

@@ -228,7 +228,7 @@ localterm start
 
 `/fabric agents` lists the children. Run `/fabric attach <id>` to show the correct attach command. Abort signals propagate to the transport and the selected child process. When a program uses orchestration entry points such as `agent`/`workflow.agent`, `agents.run`/`agents.wait`/`agents.ask`, `council.run`, or `rlm.query`, Fabric increases the whole-program `executor.timeoutMs` to at least `agents.timeoutMs`. The same increase applies to `agents.*` refs called through `tools.call()` and to refs calculated at runtime. The parent deadline then cannot stop a child that remains within its own agent budget.
 
-Set `worktree: true` to create a dedicated Git worktree and a `pi-fabric/<name>-<id>` branch from the repository containing the selected `cwd`. Fabric retains worktrees for inspection until you call `agents.cleanup()`. When the selected cwd is a repository subdirectory, Fabric uses the matching subdirectory in the generated worktree when it exists; otherwise it uses the worktree root. The reported effective cwd is the generated worktree path, and Pi evaluates that generated path as its own canonical cwd. The caller's project and mesh roots remain unchanged, so a child targeting another repository still belongs to the orchestrating Fabric topology. A recursive child in a worktree stays in the same participant directory and does not create another `.pi/fabric/mesh` inside that worktree.
+Set `worktree: true` to create a dedicated Git worktree and a `pi-fabric/<name>-<id>` branch from the repository containing the selected `cwd`. Fabric writes that worktree at `<repo>/.pi/fabric/worktrees/<id>` so copy-on-write cloning can keep ignored build artifacts on the same volume, and it records the path in the repository `.git/info/exclude` file. Simple `git worktree add` commands run through `pi.bash` take the same clone-first path. Fabric retains worktrees for inspection until you call `agents.cleanup()`. When the selected cwd is a repository subdirectory, Fabric uses the matching subdirectory in the generated worktree when it exists; otherwise it uses the worktree root. The reported effective cwd is the generated worktree path, and Pi evaluates that generated path as its own canonical cwd. The caller's project and mesh roots remain unchanged, so a child targeting another repository still belongs to the orchestrating Fabric topology. A recursive child in a worktree stays in the same participant directory and does not create another `.pi/fabric/mesh` inside that worktree.
 
 [Model-guidance components](components.md#model-facing-guidance-components) can target participants by canonical provider/model. Direct agents and actors retain their role prompt and receive matching append guidance after it. Recursive Pi children load the project components and resolve their own replaceable Fabric execution slot, so the parent does not duplicate guidance. Durable owners use the latest atomically committed guidance snapshot for each launch. Guidance changes prompts only; it cannot widen tools, approvals, or committed capabilities. Task text, message envelopes, run IDs, and timestamps stay out of the guidance system prompt, so repeated runs with the same role, model, and component projection retain a byte-stable prefix.
 

package/docs/architecture.md

@@ -25,6 +25,8 @@ ActionRegistry ◀── staged commit ── ComponentSupervisor
 ActivityStore → compact widget + footer status + interactive dashboard
 ```
 
+Unique provider extra keys and unknown actions feed a [catalog repair table](repairs.md). Session JSONL is the log; `current.json` holds unique schema maps. Effect failures (bash, edit miss) and guest typecheck are classified for status but never promoted.
+
 In the default QuickJS runtime, guest code runs without `process`, `require`, filesystem, network, or subprocess globals. Every effect crosses the host bridge, and schemas, approvals, audit records, timeouts, and cancellation apply there. Each execution gets a fresh QuickJS context. Strings the caller names in the `payloads` tool parameter appear as `π.key`. Reading a missing key throws a clear, actionable error that lists the provided keys.
 
 The optional `node-process` executor runs the same type-checked guest API and host-call protocol inside a fresh child process with a configurable V8 heap. It serves workloads that exceed the WASM32 memory ceiling. This mode is not a security boundary, because Node's `vm` module cannot safely contain hostile code. Fabric restricts this mode to trusted configuration and describes it as unsafe in `/fabric settings`. Schema enforce mode disables it. Parent-side deadlines and cancellation terminate the whole child process.
@@ -123,7 +125,7 @@ Control topics and topology and legacy state prefixes are reserved from guest me
 - `/fabric prewalk` pre-authorizes the same one-shot delegation through `prewalk.model` or an interactively selected Pi executor. The command adapts [Stencil's Prewalk](https://stencil.so/blog/prewalk) and [oh-my-pi's in-place implementation](https://github.com/can1357/oh-my-pi/blob/main/packages/coding-agent/src/session/agent-session.ts) into a prompt-free form. It uses a coarser atomic boundary. The first monitored mutation marks the outer Fabric invocation, every remaining nested call still runs, and the executor starts only from the complete native `fabric_exec` call/result pair.
 - Claude `extensions: true` preserves the user's normal Claude Code customizations, including applicable settings and hooks. Those hooks execute with their usual host privileges. Set `extensions: false` for Claude safe mode. When allowed, `Bash` stays unrestricted inside the child, in the same way as Fabric's `bash` capability.
 - Claude model discovery sends a local initialization control request and never invokes a model. One-shot and actor activations use the account or API billing already configured in Claude Code. Fabric records the CLI's reported `total_cost_usd` in its normal usage and budget ledgers.
-- A Git worktree isolates files. It does not isolate credentials, network access, processes, or external services.
+- A Git worktree isolates files. It does not isolate credentials, network access, processes, or external services. Fabric-managed worktrees live at `<repo>/.pi/fabric/worktrees/<id>` and clone the source tree copy-on-write when the filesystem allows it.
 - Fabric projects agent transcripts from local `events.jsonl` run logs. The dashboard redacts common credentials from compact tool previews. The permission-restricted raw event log can still contain assistant text, tool arguments and results, diagnostics, and extension protocol payloads. Persisted `fabric_exec` traces also retain projected bash command text for command previews. Treat retained session and run data as sensitive.
 - Fabric stops session-resident background children when the parent Pi session shuts down. A hidden per-root resident host launches `agents.spawn({ residency: "durable" })`, and that child continues after the TUI exits. A detached spawn sends a follow-up completion message unless the caller later waits for it or `notifyOnComplete` is disabled. Resident completion messages queue in mesh state until Main resumes. Durable participant lifecycle subscriptions deliver source-qualified Pi and run notifications across roots, agents, and actors with no transcript disclosure. Completed worktrees are retained on purpose.
 - Fabric suspends session-resident actors on shutdown and restores them after project trust. `agents.create({ residency: "durable" })` transfers execution to the hidden resident host before it returns. The mailbox, mesh subscriptions, relayed Main events, and runner session continue after Main exits.

package/docs/configuration.md

@@ -461,3 +461,7 @@ Mesh topics, shared state, and the participant directory remain project-scoped.
 ## Compaction
 
 The deterministic, LLM-free compaction engine is on by default. It keeps Pi's bounded `keepRecentTokens` continuity tail. `compaction.targetContextRatio` sets a hard occupancy ceiling. Set `compaction.engine` to `"pi"` to restore pi-core compaction. When pi-vcc is also installed, Fabric takes precedence for automatic compaction. An explicit `/pi-vcc` command always uses pi-vcc's engine. See [compaction](compaction.md) for invariants, loss guarantees, sections, and limits.
+
+## Catalog repairs
+
+Silent invocation repairs are on by default. `repairs.enabled` controls the catalog-scoped table at `~/.pi/agent/fabric/repairs/current.json`. Inspect it with `/fabric repairs`. See [catalog repairs](repairs.md).

package/docs/interface.md

@@ -102,6 +102,7 @@ async invoke(actionName, args, context) {
 /fabric messages <actor-id>
 /fabric attach <agent-id>
 /fabric stop <actor-or-agent-id>
+/fabric repairs
 ```
 
 Actor slash commands mirror the [global template API](agents.md#global-actor-templates). `/fabric global` lists templates. `/fabric import <name> [as <new>]` stamps one into the project. `/fabric export <id> [--overwrite]` promotes a project actor. `/fabric log <id>` previews an actor or run transcript, and `/fabric export-log <id> [path]` writes the raw `session.jsonl` plus retained `runs/` to disk.

package/docs/repairs.md

@@ -0,0 +1,57 @@
+# Catalog repairs
+
+Pi Fabric learns **silent catalog-argument repairs** from unique invocation near-misses. It does not rewrite guidelines, `AGENTS.md`, or the system prompt. Session JSONL remains the only log. The durable product is a catalog-scoped table of spilled→declared maps.
+
+KPI: repeat **invocation** fingerprints → 0. Bash nonzero, edit misses, missing files, and guest typecheck/syntax are classified for status but never promoted.
+
+## Loop
+
+```text
+invalid args / unknown action
+        │
+  unique bijection against the live schema
+        │
+        ├─ effect / didactic / typecheck  → count, do not promote
+        └─ unique extra key or unique verb → insert into current.json
+                │
+         next ActionRegistry prepare / resolve applies the row
+         (canonical input is a no-op)
+```
+
+Repair-candidate observation and apply happen in `ActionRegistry` only. Unique extra keys are observed on the **caller's spilled args** before `prepareArguments`, so a bundled lexicon repair still persists the map for providers that lack one. `tool_execution_end` records effect drops and non-promotable fingerprints without double-counting inner invocation errors.
+
+## Store
+
+`~/.pi/agent/fabric/repairs/current.json` (under `PI_CODING_AGENT_DIR`).
+
+`catalogDigest` hashes sorted provider names plus captured tool names. A digest change starts empty and **clears in-memory fingerprint counters** so a previous candidate cannot be re-inserted. Schema field/action renames do not bump the digest; apply re-proves each row's unique mapping against the **live** declared names instead. Repairs are **global across models**, not per project.
+
+Table rows:
+
+- `keyAlias`: extra argument key → declared key (`sessionId` → `session`)
+- `actionAlias`: spilled action name → declared name (never applied when a committed capability view pins the call)
+
+Cap: 256 rows. Promotion is on the first unique hit; uniqueness against the live schema is the bound. Insert is identity-keyed (idempotent) and locked across Pi processes sharing the agent directory; stale-lock recovery is an exclusive rename claim, so racing reapers can never delete a lock a fresh writer owns. Persistence failures never fail the user's invocation and appear in `/fabric repairs`. Apply is a no-op when the schema accepts extension keys, the live mapping is absent or ambiguous, or the call is already canonical.
+
+Two failure modes stay visible, never silent:
+
+- A **transient catalog** (capture suspension between sessions or during `/fabric reload`) never re-keys the table: the surface freezes until the catalog re-arms, so promotion cannot persist rows under an empty-catalog digest that would destroy the stable table.
+- A **damaged table** (unreadable or malformed `current.json`) surfaces as `storeError` in `/fabric repairs`, blocks the merge that would overwrite it, and keeps promoted rows active in memory. A missing table, or one persisted under a different digest, starts fresh without an error.
+
+## Commands
+
+```text
+/fabric repairs              # status, top fingerprints, current table
+```
+
+## Configuration
+
+```json
+{
+  "repairs": {
+    "enabled": true
+  }
+}
+```
+
+Disable with `"enabled": false`. Promotion never edits execution guidance or Schema text.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-fabric",
-  "version": "0.76.2",
+  "version": "0.78.0",
   "description": "A programmable tool and agent runtime for Pi",
   "type": "module",
   "main": "./dist/index.js",

package/skills/fabric-exec/references/agents.md

@@ -22,11 +22,11 @@ For Pi leaf agents, selecting `cwd` neither grants nor requires project trust. F
 - `tools` defaults to `agents.defaultTools`. Claude maps `read→Read`, `grep→Grep`, `find/ls→Glob`, `bash→Bash`, `edit→Edit`, and `write→Write`; other tool names fail before launch.
 - `schema` is a JSON Schema; the worker returns validated structured data in `result.value`.
 - `cwd` changes only a leaf child's execution directory. Workflow helpers and `council.run()` forward it; recursive `rlm.query()` deliberately does not accept it. Persistent actor definitions and trajectory handoff also do not accept it. A request combining `cwd` with `recursive: true` is rejected before launch.
-- `worktree: true` creates a dedicated Git worktree on branch `pi-fabric/<name>-<id>` from the repository containing the selected `cwd`, retained until `agents.cleanup()`. A selected repository subdirectory is preserved in the generated worktree when available. The effective cwd is the generated canonical path. Project and mesh ownership remain those of the caller.
-- Worktree path gotcha (cost us four aborted agent rounds): the harness names the worktree directory after ITSELF, not the target repo — even a pi-fovea worktree lands under `$TMPDIR/pi-fabric-worktrees/<id>`. Repo identity lives in the registered worktree list and branch tip, not the directory name. Never instruct an agent to verify its location by directory-name pattern; verify by repo instead (`git rev-parse --show-toplevel` + `git log -1 --format=%H` against the expected base, or `git remote get-url origin`).
+- `worktree: true` creates a dedicated Git worktree on branch `pi-fabric/<name>-<id>` from the repository containing the selected `cwd`, retained until `agents.cleanup()`. Fabric writes it at `<repo>/.pi/fabric/worktrees/<id>` (agent id, not the target repo name) and clone-first copy-on-write keeps ignored build artifacts when the filesystem supports it. A selected repository subdirectory is preserved in the generated worktree when available. The effective cwd is the generated canonical path. Project and mesh ownership remain those of the caller.
+- Worktree path gotcha: the directory name is the agent id, not the target repo. Repo identity lives in the registered worktree list and branch tip. Never instruct an agent to verify its location by directory-name pattern; verify by repo (`git rev-parse --show-toplevel` + `git log -1 --format=%H` against the expected base, or `git remote get-url origin`).
 - Preferred pattern for parallel implementers (deterministic, full branch control): pre-create the worktrees yourself in the target repo (`git worktree add -b <branch> <path> <base>`), pass each canonical path as `cwd`, leave `worktree` unset, and state the exact expected top-level in the task. Canonical-path gotcha on macOS: `git rev-parse --show-toplevel` reports `/private/tmp/...` for worktrees created under `/tmp/...` — assign and verify the canonical `/private` form or the agent's guard will correctly refuse.
 - Give every autonomous coding agent a mandatory first command that verifies repo identity (exact canonical toplevel or remote URL) and a hard rule to abort with zero changes on mismatch. Guards cost one cheap round when wrong and prevent cross-repo contamination when right — four successive guards caught a wrong-repo worktree, a self-inflicted symlink mismatch, and a too-literal directory check at zero bytes of damage.
-- Cleanup after cancelled/failed agent runs: check `agents.list({ scope: "project" })` and `agents.stop` any still-running handles first; worktree registrations live in the repo that OWNS the worktree (check `git worktree list` in every candidate repo — the temp-dir name will mislead you), then `git worktree remove --force` + `git branch -D` + `git worktree prune` in each. Leave pre-existing non-agent worktrees alone; filter by the branch prefix your runs created (e.g. `pi-fabric/<name>`).
+- Cleanup after cancelled/failed agent runs: check `agents.list({ scope: "project" })` and `agents.stop` any still-running handles first; worktree registrations live in the repo that OWNS the worktree (check `git worktree list` in every candidate repo; `.pi/fabric/worktrees/<id>` names the agent, not the repo), then `git worktree remove --force` + `git branch -D` + `git worktree prune` in each. Leave pre-existing non-agent worktrees alone; filter by the branch prefix your runs created (e.g. `pi-fabric/<name>`).
 - `residency` is available on `agents.spawn` only: `"session"` (default) ties the run to the current Pi host; `"durable"` launches it on Fabric's hidden resident host so it can finish after Main exits. Durable handles still support `status`, `wait`, `log`, `stop`, and `cleanup` when the same root resumes. It requires a trusted project mesh and is unavailable in Schema enforce mode.
 - Omit `timeoutMs` normally. It defaults to `agents.timeoutMs` (60 minutes by default), and per-call values below that configured default are ignored. Set it only to request a longer run.