avantgate 1.2.0 → 1.2.1

package/dist/agent/dto.d.ts

@@ -1,7 +1,7 @@
 /**
  * Declarative DTO Projection Helpers for avantgate/agent.
- * Standardizes common tool output projections (booleans, count, field pick)
- * to minimize LLM token consumption and prevent PII leakage.
+ * Standardizes common tool output projections (booleans, count, field pick, exhaustive projection)
+ * to minimize LLM token consumption, prevent PII leakage, and guard against schema drift.
  */
 export interface DtoBooleanResult {
     success: boolean;
@@ -10,6 +10,25 @@ export interface DtoCountResult {
     success: true;
     count: number;
 }
+/**
+ * Type Guard ensuring compile-time exhaustiveness for DTO projections.
+ * Requires every key of TSource to be explicitly assigned to either 'keep' or 'drop'.
+ * Emits descriptive type errors (_unassignedSourceFields or _overlappingFields) upon discrepancy.
+ */
+export type ExhaustiveProjectionConfig<TSource, TKeep extends keyof TSource, TDrop extends keyof TSource> = [Exclude<keyof TSource, TKeep | TDrop>] extends [never] ? [Extract<TKeep, TDrop>] extends [never] ? {
+    keep: readonly TKeep[];
+    drop: readonly TDrop[];
+} : {
+    keep: readonly TKeep[];
+    drop: readonly TDrop[];
+    /** ❌ Compile Error: A field cannot be present in both 'keep' and 'drop' */
+    _overlappingFields: Extract<TKeep, TDrop>;
+} : {
+    keep: readonly TKeep[];
+    drop: readonly TDrop[];
+    /** ❌ Compile Error: Unassigned source fields! You must explicitly add these keys to either 'keep' or 'drop' */
+    _unassignedSourceFields: Exclude<keyof TSource, TKeep | TDrop>;
+};
 export declare const dto: {
     /**
      * Generates a boolean acknowledgment for mutations ({ success: true | false }).
@@ -25,8 +44,15 @@ export declare const dto: {
      */
     count: (arrayKey?: string) => (data: any) => DtoCountResult;
     /**
-     * Filters raw output by extracting only a strict whitelist of allowed fields.
+     * Filters raw output by extracting only a whitelist of allowed fields.
+     * Supports optional TSource generic parameter for auto-completion.
+     */
+    pick: <TSource = any, K extends keyof TSource = any>(keys: readonly K[] | K[]) => (data: TSource) => Pick<TSource, K>;
+    /**
+     * Compile-time guarded exhaustive projection.
+     * Forces developers to explicitly classify every key of TSource as either 'keep' (sent to LLM)
+     * or 'drop' (ignored), preventing silent schema drift when source types evolve.
      */
-    pick: <T extends string>(keys: readonly T[] | T[]) => (data: any) => Record<T, unknown>;
+    exhaustivePick: <TSource>() => <const TKeep extends keyof TSource, const TDrop extends keyof TSource>(config: ExhaustiveProjectionConfig<TSource, TKeep, TDrop>) => (data: TSource) => Pick<TSource, TKeep>;
 };
 //# sourceMappingURL=dto.d.ts.map

package/dist/agent/dto.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dto.d.ts","sourceRoot":"","sources":["../../src/agent/dto.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,IAAI,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACf;AAED,eAAO,MAAM,GAAG;IACd;;;OAGG;oBACa,MAAM,GAAG,KAAG,gBAAgB;IAI5C;;OAEG;oBACa,CAAC,SAAS,MAAM,iBAAgB,CAAC,MAC9C,MAAM,GAAG,KAAG,gBAAgB,GAAG,MAAM,CAAC,CAAC,EAAE,OAAO,CAAC;IAMpD;;OAEG;uBAEW,MAAM,MACjB,MAAM,GAAG,KAAG,cAAc;IAQ7B;;OAEG;WAEA,CAAC,SAAS,MAAM,QAAQ,SAAS,CAAC,EAAE,GAAG,CAAC,EAAE,MAC1C,MAAM,GAAG,KAAG,MAAM,CAAC,CAAC,EAAE,OAAO,CAAC;CAYlC,CAAC"}
+{"version":3,"file":"dto.d.ts","sourceRoot":"","sources":["../../src/agent/dto.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,IAAI,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;;GAIG;AACH,MAAM,MAAM,0BAA0B,CACpC,OAAO,EACP,KAAK,SAAS,MAAM,OAAO,EAC3B,KAAK,SAAS,MAAM,OAAO,IACzB,CAAC,OAAO,CAAC,MAAM,OAAO,EAAE,KAAK,GAAG,KAAK,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,GACvD,CAAC,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,GACrC;IACE,IAAI,EAAE,SAAS,KAAK,EAAE,CAAC;IACvB,IAAI,EAAE,SAAS,KAAK,EAAE,CAAC;CACxB,GACD;IACE,IAAI,EAAE,SAAS,KAAK,EAAE,CAAC;IACvB,IAAI,EAAE,SAAS,KAAK,EAAE,CAAC;IACvB,2EAA2E;IAC3E,kBAAkB,EAAE,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;CAC3C,GACH;IACE,IAAI,EAAE,SAAS,KAAK,EAAE,CAAC;IACvB,IAAI,EAAE,SAAS,KAAK,EAAE,CAAC;IACvB,+GAA+G;IAC/G,uBAAuB,EAAE,OAAO,CAAC,MAAM,OAAO,EAAE,KAAK,GAAG,KAAK,CAAC,CAAC;CAChE,CAAC;AAkBN,eAAO,MAAM,GAAG;IACd;;;OAGG;oBACa,MAAM,GAAG,KAAG,gBAAgB;IAI5C;;OAEG;oBACa,CAAC,SAAS,MAAM,iBAAgB,CAAC,MAC9C,MAAM,GAAG,KAAG,gBAAgB,GAAG,MAAM,CAAC,CAAC,EAAE,OAAO,CAAC;IAMpD;;OAEG;uBAEW,MAAM,MACjB,MAAM,GAAG,KAAG,cAAc;IAQ7B;;;OAGG;WAEA,OAAO,QAAQ,CAAC,SAAS,MAAM,OAAO,cAAc,SAAS,CAAC,EAAE,GAAG,CAAC,EAAE,MACtE,MAAM,OAAO,KAAG,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;IAGnC;;;;OAIG;qBAEA,OAAO,QACP,KAAK,CAAC,KAAK,SAAS,MAAM,OAAO,EAAE,KAAK,CAAC,KAAK,SAAS,MAAM,OAAO,EACnE,QAAQ,0BAA0B,CAAC,OAAO,EAAE,KAAK,EAAE,KAAK,CAAC,MAE1D,MAAM,OAAO,KAAG,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC;CAExC,CAAC"}

package/dist/agent/index.js

@@ -381,6 +381,18 @@ function createIsolatedTool(config) {
 }
 
 // src/agent/dto.ts
+function extractWhitelistedFields(data, keys) {
+  const result = {};
+  if (!data || typeof data !== "object") {
+    return result;
+  }
+  for (const key of keys) {
+    if (key in data) {
+      result[key] = data[key];
+    }
+  }
+  return result;
+}
 var dto = {
   /**
    * Generates a boolean acknowledgment for mutations ({ success: true | false }).
@@ -407,20 +419,16 @@ var dto = {
     };
   },
   /**
-   * Filters raw output by extracting only a strict whitelist of allowed fields.
+   * Filters raw output by extracting only a whitelist of allowed fields.
+   * Supports optional TSource generic parameter for auto-completion.
    */
-  pick: (keys) => (data) => {
-    const result = {};
-    if (!data || typeof data !== "object") {
-      return result;
-    }
-    for (const key of keys) {
-      if (key in data) {
-        result[key] = data[key];
-      }
-    }
-    return result;
-  }
+  pick: (keys) => (data) => extractWhitelistedFields(data, keys),
+  /**
+   * Compile-time guarded exhaustive projection.
+   * Forces developers to explicitly classify every key of TSource as either 'keep' (sent to LLM)
+   * or 'drop' (ignored), preventing silent schema drift when source types evolve.
+   */
+  exhaustivePick: () => (config) => (data) => extractWhitelistedFields(data, config.keep)
 };
 
 // src/agent/factory.ts

package/dist/agent/index.mjs

@@ -278,6 +278,18 @@ function createIsolatedTool(config) {
 }
 
 // src/agent/dto.ts
+function extractWhitelistedFields(data, keys) {
+  const result = {};
+  if (!data || typeof data !== "object") {
+    return result;
+  }
+  for (const key of keys) {
+    if (key in data) {
+      result[key] = data[key];
+    }
+  }
+  return result;
+}
 var dto = {
   /**
    * Generates a boolean acknowledgment for mutations ({ success: true | false }).
@@ -304,20 +316,16 @@ var dto = {
     };
   },
   /**
-   * Filters raw output by extracting only a strict whitelist of allowed fields.
+   * Filters raw output by extracting only a whitelist of allowed fields.
+   * Supports optional TSource generic parameter for auto-completion.
    */
-  pick: (keys) => (data) => {
-    const result = {};
-    if (!data || typeof data !== "object") {
-      return result;
-    }
-    for (const key of keys) {
-      if (key in data) {
-        result[key] = data[key];
-      }
-    }
-    return result;
-  }
+  pick: (keys) => (data) => extractWhitelistedFields(data, keys),
+  /**
+   * Compile-time guarded exhaustive projection.
+   * Forces developers to explicitly classify every key of TSource as either 'keep' (sent to LLM)
+   * or 'drop' (ignored), preventing silent schema drift when source types evolve.
+   */
+  exhaustivePick: () => (config) => (data) => extractWhitelistedFields(data, config.keep)
 };
 
 // src/agent/factory.ts

package/dist/index.mjs

@@ -1,10 +1,10 @@
-import {
-  sanitizePII
-} from "./chunk-DVCF4CSV.mjs";
 import {
   extractAndCleanJSON,
   validateWithZod
 } from "./chunk-CO26LNFD.mjs";
+import {
+  sanitizePII
+} from "./chunk-DVCF4CSV.mjs";
 
 // src/types.ts
 var ConfigurationError = class extends Error {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "avantgate",
-  "version": "1.2.0",
+  "version": "1.2.1",
   "description": "Zero-infrastructure, in-process LLM control plane & SaaS observability bridge: real-time cost control, token budgets, PII redaction, prompt guardrails, multi-model failover, durable agent workflow harness, and HTTP telemetry without hosting heavy servers.",
   "author": "Antigravity & LexTalk Team",
   "license": "MIT",