audit-tools 0.33.6 → 0.33.7

package/dist/shared/providers/proxyCatalog.d.ts

@@ -1,14 +1,14 @@
 import type { DispatchableSource } from "../types/sessionConfig.js";
 /**
- * The POPULATE cache for the repair-proxy lane: `GET <proxy>/registry` expanded into
- * ready-to-fold `claude-worker` {@link DispatchableSource}s, written once per populate
- * (Gate-0 build / explicit refresh) and READ by resolve — never fetched mid-resolve
- * (`docs/reviews/commit3-proxy-kind1-transport-plan-2026-07-16.md` §populate/resolve).
+ * The POPULATE cache for the proxy lane: discovered via `GET <proxy>/v1/models` +
+ * `GET <proxy>/model/info` (OpenAI-compatible surfaces) expanded into ready-to-fold
+ * `claude-worker` {@link DispatchableSource}s, written once per populate (Gate-0 build
+ * / explicit refresh) and READ by resolve — never fetched mid-resolve.
  *
  * Named `catalog-cache.json`, NOT the `catalog-<auditor-id>.json` the reserved-name
  * comment at `auditorSources.ts` anticipates: populate/resolve run on the AMBIENT
  * path, where no auditor id exists to key on. The cache is machine-level like the
- * declaration beside it — and it is a CACHE of live registry state, not resolved
+ * declaration beside it — and it is a CACHE of live discovery state, not resolved
  * per-auditor capability, so an auditor-id key would assert an isolation the data
  * doesn't have. Per-auditor never-inherit still holds: every resolve re-proves proxy
  * REACH itself; the cache only supplies the expansion.
@@ -38,15 +38,17 @@ export interface ProxyCatalog {
     sources: DispatchableSource[];
 }
 export interface PopulateProxyCatalogOptions {
-    /** The repair-proxy base url (`GET <endpoint>/registry`). */
+    /** The proxy base url (`GET <endpoint>/v1/models`, `GET <endpoint>/model/info`). */
     endpoint: string;
-    /** Models expanded per backend provider (declared `repair_proxy.top_k`); default {@link DEFAULT_PROXY_TOP_K}. */
+    /** Models expanded per backend provider (declared `proxy.top_k`); default {@link DEFAULT_PROXY_TOP_K}. */
     topK?: number;
     /**
-     * Operator-declared blended $/Mtok for the proxied lane (`repair_proxy.cost_per_mtok`,
-     * the free-to-operator axis). WINS over any registry list price.
+     * Operator-declared blended $/Mtok for the proxied lane (`proxy.cost_per_mtok`,
+     * the free-to-operator axis). WINS over any advert price.
      */
     costPerMtok?: number;
+    /** Env var holding the proxy's master key when authentication is required. */
+    apiKeyEnv?: string;
     /** Injectable fetch (tests); defaults to global fetch. */
     fetchImpl?: typeof fetch;
     /** Home dir override for the cache path (tests). */
@@ -68,13 +70,14 @@ export interface PopulateProxyCatalogResult {
     }>;
 }
 /**
- * POPULATE: fetch `GET <endpoint>/registry` and write the expanded `claude-worker`
- * sources to the machine-level cache. Network-bound and cacheable — runs at Gate-0
- * build / explicit refresh, NEVER inside `resolveAmbientSources` (which only READS
- * via {@link readProxyCatalog}). Never throws: a failed fetch returns
- * `{written:false, reason}` and leaves any prior cache untouched; an empty/zero-match
- * registry WRITES an empty expansion (fresh knowledge — resolve reports the lane
- * unexpanded with a reason).
+ * POPULATE: discover and expand models from an OpenAI-compatible proxy
+ * (`GET <endpoint>/v1/models` + `GET <endpoint>/model/info`) into
+ * ready-to-fold `claude-worker` sources, then write to the machine-level cache.
+ * Network-bound and cacheable — runs at Gate-0 build / explicit refresh, NEVER
+ * inside `resolveAmbientSources` (which only READS via {@link readProxyCatalog}).
+ * Never throws: a failed fetch returns `{written:false, reason}` and leaves any
+ * prior cache untouched; an empty discovery WRITES an empty expansion (fresh
+ * knowledge — resolve reports the lane unexpanded with a reason).
  */
 export declare function populateProxyCatalog(options: PopulateProxyCatalogOptions): Promise<PopulateProxyCatalogResult>;
 export interface ReadProxyCatalogDeps {

package/dist/shared/providers/proxyCatalog.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"proxyCatalog.d.ts","sourceRoot":"","sources":["../../../src/shared/providers/proxyCatalog.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAGpE;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,sBAAsB,uBAAuB,CAAC;AAE3D,wFAAwF;AACxF,eAAO,MAAM,mBAAmB,IAAI,CAAC;AAErC,gEAAgE;AAChE,eAAO,MAAM,yBAAyB,OAAO,CAAC;AAE9C,qEAAqE;AACrE,eAAO,MAAM,0BAA0B,IAAI,CAAC;AAE5C;;;;GAIG;AACH,eAAO,MAAM,2BAA2B,QAAc,CAAC;AAEvD,yFAAyF;AACzF,wBAAgB,uBAAuB,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAEhE;AAED,yFAAyF;AACzF,MAAM,WAAW,YAAY;IAC3B,yFAAyF;IACzF,UAAU,EAAE,MAAM,CAAC;IACnB,wDAAwD;IACxD,QAAQ,EAAE,MAAM,CAAC;IACjB,8EAA8E;IAC9E,OAAO,EAAE,kBAAkB,EAAE,CAAC;CAC/B;AAaD,MAAM,WAAW,2BAA2B;IAC1C,6DAA6D;IAC7D,QAAQ,EAAE,MAAM,CAAC;IACjB,iHAAiH;IACjH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,0DAA0D;IAC1D,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;IACzB,oDAAoD;IACpD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,uDAAuD;IACvD,GAAG,CAAC,EAAE,MAAM,IAAI,CAAC;CAClB;AAED,MAAM,WAAW,0BAA0B;IACzC,2EAA2E;IAC3E,OAAO,EAAE,kBAAkB,EAAE,CAAC;IAC9B,uFAAuF;IACvF,OAAO,EAAE,OAAO,CAAC;IACjB,iFAAiF;IACjF,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,8DAA8D;IAC9D,OAAO,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAChD;AAsSD;;;;;;;;GAQG;AACH,wBAAsB,oBAAoB,CACxC,OAAO,EAAE,2BAA2B,GACnC,OAAO,CAAC,0BAA0B,CAAC,CAkGrC;AAED,MAAM,WAAW,oBAAoB;IACnC,oDAAoD;IACpD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,2EAA2E;IAC3E,eAAe,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,GAAG,IAAI,CAAC;CACnD;AAUD;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,GAAE,oBAAyB,GAC9B,YAAY,GAAG,IAAI,CAmBrB"}
+{"version":3,"file":"proxyCatalog.d.ts","sourceRoot":"","sources":["../../../src/shared/providers/proxyCatalog.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAGpE;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,sBAAsB,uBAAuB,CAAC;AAE3D,wFAAwF;AACxF,eAAO,MAAM,mBAAmB,IAAI,CAAC;AAErC,gEAAgE;AAChE,eAAO,MAAM,yBAAyB,OAAO,CAAC;AAE9C,qEAAqE;AACrE,eAAO,MAAM,0BAA0B,IAAI,CAAC;AAE5C;;;;GAIG;AACH,eAAO,MAAM,2BAA2B,QAAc,CAAC;AAEvD,yFAAyF;AACzF,wBAAgB,uBAAuB,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAEhE;AAED,yFAAyF;AACzF,MAAM,WAAW,YAAY;IAC3B,yFAAyF;IACzF,UAAU,EAAE,MAAM,CAAC;IACnB,wDAAwD;IACxD,QAAQ,EAAE,MAAM,CAAC;IACjB,8EAA8E;IAC9E,OAAO,EAAE,kBAAkB,EAAE,CAAC;CAC/B;AA8BD,MAAM,WAAW,2BAA2B;IAC1C,oFAAoF;IACpF,QAAQ,EAAE,MAAM,CAAC;IACjB,0GAA0G;IAC1G,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,8EAA8E;IAC9E,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,0DAA0D;IAC1D,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;IACzB,oDAAoD;IACpD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,uDAAuD;IACvD,GAAG,CAAC,EAAE,MAAM,IAAI,CAAC;CAClB;AAED,MAAM,WAAW,0BAA0B;IACzC,2EAA2E;IAC3E,OAAO,EAAE,kBAAkB,EAAE,CAAC;IAC9B,uFAAuF;IACvF,OAAO,EAAE,OAAO,CAAC;IACjB,iFAAiF;IACjF,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,8DAA8D;IAC9D,OAAO,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAChD;AAiWD;;;;;;;;;GASG;AACH,wBAAsB,oBAAoB,CACxC,OAAO,EAAE,2BAA2B,GACnC,OAAO,CAAC,0BAA0B,CAAC,CAyJrC;AAED,MAAM,WAAW,oBAAoB;IACnC,oDAAoD;IACpD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,2EAA2E;IAC3E,eAAe,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,GAAG,IAAI,CAAC;CACnD;AAUD;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,GAAE,oBAAyB,GAC9B,YAAY,GAAG,IAAI,CAmBrB"}