@vpxa/aikit 0.1.254 → 0.1.256

package/packages/tools/dist/index.d.ts

@@ -419,15 +419,23 @@ declare class FileCache {
 }
 //#endregion
 //#region packages/tools/src/compact.d.ts
-interface CompactOptions {
-  /** The text to compress (at least one of text/path/ref required) */
-  text?: string;
-  /** File path to read server-side — avoids read_file round-trip (at least one of text/path/ref required) */
-  path?: string;
-  /** Cached reversible ref from compact/digest/search/find/knowledge output. */
-  ref?: string;
-  /** The focus query — what are we trying to understand? Required unless ref is provided. */
+type CompactInputOptions = {
+  /** The text to compress. */text: string; /** The focus query — what are we trying to understand? */
+  query: string;
+  path?: never;
+  ref?: never;
+} | {
+  /** File path to read server-side — avoids read_file round-trip. */path: string; /** The focus query — what are we trying to understand? */
+  query: string;
+  text?: never;
+  ref?: never;
+} | {
+  /** Cached reversible ref from compact/digest/search/find/knowledge output. */ref: string; /** Optional focus query when re-compacting a cached artifact. */
   query?: string;
+  text?: never;
+  path?: never;
+};
+interface CompactSharedOptions {
   /** Target output size in characters (default: 3000) */
   maxChars?: number;
   /** Token budget — when set, overrides maxChars (approx 4 chars per token) */
@@ -447,6 +455,7 @@ interface CompactOptions {
    */
   mode?: 'full' | 'delta';
 }
+type CompactOptions = CompactInputOptions & CompactSharedOptions;
 interface CompactResult {
   /** The compressed text */
   text: string;