infiniloom-node 0.4.7 → 0.4.8

package/README.md

@@ -187,10 +187,10 @@ Scan a repository with full configuration options.
 Count tokens in text for a specific model.
 
 **Parameters:**
-- `text` - Text to tokenize
+- `text` - Text to tokenize (null/undefined returns 0)
 - `model` - Optional model name (default: "claude")
 
-**Returns:** Token count
+**Returns:** Token count (0 for empty, null, or undefined input)
 
 #### `semanticCompress(text: string, similarityThreshold?: number, budgetRatio?: number): string`
 
@@ -199,9 +199,9 @@ Compress text using semantic compression while preserving important content.
 **Parameters:**
 - `text` - Text to compress
 - `similarityThreshold` - Threshold for grouping similar chunks (0.0-1.0, default: 0.7). Note: Only affects output when built with "embeddings" feature.
-- `budgetRatio` - Target size as ratio of original (0.0-1.0, default: 0.5). Lower values = more aggressive compression.
+- `budgetRatio` - Target size as ratio of original (0.0-1.0, default: 0.5). Lower values = more aggressive compression. Affects content as small as 10 characters. Use 1.0 to preserve content unchanged.
 
-**Returns:** Compressed text
+**Returns:** Compressed text (may include truncation markers showing percentage and character counts)
 
 #### `scanSecurity(path: string): SecurityFinding[]`
 
@@ -567,7 +567,7 @@ interface PackOptions {
   exclude?: string[];        // Glob patterns to exclude (e.g., ["**/*.test.ts"])
   includeTests?: boolean;    // Include test files (default: false)
   securityThreshold?: string;// Minimum severity to block: "critical", "high", "medium", "low"
-  tokenBudget?: number;      // Limit total output tokens (0 = no limit)
+  tokenBudget?: number;      // Limit total output tokens (0 = no limit, negative values rejected)
   // Git-based filtering options (PR review integration)
   changedOnly?: boolean;     // Only include files changed in git
   baseSha?: string;          // Base SHA/ref for diff comparison (e.g., "main", "HEAD~5")

package/index.d.ts

@@ -29,7 +29,10 @@ export interface PackOptions {
   includeTests?: boolean
   /** Minimum security severity to block on: "critical", "high", "medium", "low" (default: "critical") */
   securityThreshold?: string
-  /** Token budget for total output (0 = no limit). Files are included by importance until budget is reached. */
+  /**
+   * Token budget for total output (0 = no limit). Files are included by importance until budget is reached.
+   * Negative values are invalid and will throw an error.
+   */
   tokenBudget?: number
   /** Only include files changed in git (requires baseSha or uses uncommitted changes) */
   changedOnly?: boolean
@@ -154,7 +157,7 @@ export declare function scanWithOptions(path: string, options?: ScanOptions | un
  * Count tokens in text for a specific model
  *
  * # Arguments
- * * `text` - Text to tokenize
+ * * `text` - Text to tokenize (null/undefined returns 0)
  * * `model` - Optional model name (default: "claude")
  *
  * # Returns
@@ -168,7 +171,7 @@ export declare function scanWithOptions(path: string, options?: ScanOptions | un
  * console.log(`Tokens: ${count}`);
  * ```
  */
-export declare function countTokens(text: string, model?: string | undefined | null): number
+export declare function countTokens(text?: string | undefined | null, model?: string | undefined | null): number
 /**
  * Compress text using semantic compression
  *
@@ -821,6 +824,12 @@ export interface ImpactOptions {
   depth?: number
   /** Include test files in analysis */
   includeTests?: boolean
+  /** Target model for token counting (default: "claude") */
+  model?: string
+  /** Glob patterns to exclude (e.g., ["**/*.test.ts", "dist/**"]) */
+  exclude?: Array<string>
+  /** Glob patterns to include (e.g., ["src/**/*.ts"]) */
+  include?: Array<string>
 }
 /** Symbol affected by a change */
 export interface AffectedSymbol {
@@ -887,6 +896,12 @@ export interface DiffContextOptions {
   includeDiff?: boolean
   /** Output format: "xml", "markdown", "json" (default: "xml") */
   format?: string
+  /** Target model for token counting (default: "claude") */
+  model?: string
+  /** Glob patterns to exclude (e.g., ["**/*.test.ts", "dist/**"]) */
+  exclude?: Array<string>
+  /** Glob patterns to include (e.g., ["src/**/*.ts"]) */
+  include?: Array<string>
 }
 /** Context-aware diff result */
 export interface DiffContextResult {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "infiniloom-node",
-  "version": "0.4.7",
+  "version": "0.4.8",
   "description": "Node.js bindings for infiniloom - Repository context engine for LLMs",
   "main": "index.js",
   "types": "index.d.ts",