@agntk/core 0.3.5 → 1.0.0

package/dist/streaming/transient.js

@@ -0,0 +1,201 @@
+/**
+ * @agntk/core - Transient Streaming Infrastructure
+ *
+ * Enables tools to stream data to the UI without persisting to conversation context.
+ * This keeps the context window lean while providing rich UI feedback.
+ */
+import { createLogger } from '@agntk/logger';
+const log = createLogger('@agntk/core:streaming');
+// ============================================================================
+// Main API: withTransientStreaming
+// ============================================================================
+/**
+ * Wrap tools to enable transient streaming.
+ *
+ * Tools wrapped with this function will have access to a `stream()` helper
+ * in their context that allows streaming data to the UI without adding
+ * it to the conversation context.
+ *
+ * @param tools - Record of tools to wrap
+ * @param writer - Stream writer for sending data to the client
+ * @returns Wrapped tools with transient streaming enabled
+ *
+ * @example
+ * ```typescript
+ * const wrappedTools = withTransientStreaming(myTools, dataStream);
+ *
+ * // Inside a tool's execute function:
+ * execute: async (input, ctx) => {
+ *   ctx.stream('file-content', {
+ *     path: input.path,
+ *     content: fileContent,
+ *     truncated: false,
+ *   });
+ *   return `Read ${input.path}`;
+ * }
+ * ```
+ */
+export function withTransientStreaming(tools, writer) {
+    const wrappedTools = {};
+    for (const [name, tool] of Object.entries(tools)) {
+        wrappedTools[name] = wrapToolWithTransient(tool, writer, name);
+    }
+    return wrappedTools;
+}
+// ============================================================================
+// Tool Wrapping
+// ============================================================================
+/**
+ * Wrap a single tool with transient streaming capabilities.
+ */
+function wrapToolWithTransient(tool, writer, toolName) {
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    const originalExecute = tool.execute;
+    if (!originalExecute) {
+        return tool;
+    }
+    return {
+        ...tool,
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        execute: async (input, options) => {
+            // Create enhanced context with streaming helper
+            const enhancedContext = {
+                ...(options || {}),
+                agentId: options?.agentId || 'unknown',
+                stepNumber: options?.stepNumber || 0,
+                writer,
+                stream: (type, data) => {
+                    writeTransient(writer, type, data);
+                },
+            };
+            return originalExecute(input, enhancedContext);
+        },
+    };
+}
+// ============================================================================
+// Transient Data Writers
+// ============================================================================
+/**
+ * Stream typed transient data to the UI.
+ *
+ * @param writer - Stream writer instance
+ * @param type - Data part type
+ * @param data - Data to stream
+ */
+export function writeTransient(writer, type, data) {
+    const dataPart = {
+        type,
+        data,
+    };
+    writer.writeData({
+        ...dataPart,
+        transient: true,
+    });
+}
+/**
+ * Helper for tools to stream transient data from within their execute function.
+ *
+ * @param ctx - Tool context (must have writer)
+ * @param type - Data part type
+ * @param data - Data to stream
+ *
+ * @example
+ * ```typescript
+ * // Inside a tool's execute function:
+ * streamTransient(ctx, 'shell-output', {
+ *   command: 'npm test',
+ *   output: result.stdout,
+ *   exitCode: result.code,
+ * });
+ * ```
+ */
+export function streamTransient(ctx, type, data) {
+    // Cast to TransientStreamWriter - they have compatible interfaces
+    const writer = ctx.writer;
+    if (writer) {
+        writeTransient(writer, type, data);
+    }
+}
+// ============================================================================
+// Specialized Streamers
+// ============================================================================
+/**
+ * Stream file content transiently.
+ */
+export function streamFileContent(ctx, path, content, options = {}) {
+    streamTransient(ctx, 'file-content', {
+        path,
+        content,
+        truncated: options.truncated ?? false,
+        totalBytes: options.totalBytes,
+        language: options.language,
+        lineRange: options.lineRange,
+    });
+}
+/**
+ * Stream shell output transiently.
+ */
+export function streamShellOutput(ctx, command, output, exitCode, options = {}) {
+    streamTransient(ctx, 'shell-output', {
+        command,
+        output,
+        exitCode,
+        cwd: options.cwd,
+        truncated: options.truncated,
+        durationMs: options.durationMs,
+    });
+}
+/**
+ * Stream search results transiently.
+ */
+export function streamSearchResult(ctx, path, content, matches, options = {}) {
+    streamTransient(ctx, 'search-result', {
+        path,
+        content,
+        matches,
+        line: options.line,
+        pattern: options.pattern,
+    });
+}
+/**
+ * Stream tool progress update transiently.
+ */
+export function streamProgress(ctx, toolName, progress, message, options = {}) {
+    streamTransient(ctx, 'tool-progress', {
+        toolName,
+        progress,
+        message,
+        estimatedRemaining: options.estimatedRemaining,
+        step: options.step,
+    });
+}
+/**
+ * Stream reasoning step transiently.
+ *
+ * @internal Forward-designed for CLI streaming feature. No production callers yet.
+ */
+export function streamReasoningStep(ctx, stepNumber, totalSteps, thought, options = {}) {
+    streamTransient(ctx, 'reasoning-step', {
+        stepNumber,
+        totalSteps,
+        thought,
+        isRevision: options.isRevision,
+        revisesThought: options.revisesThought,
+        branchId: options.branchId,
+    });
+}
+/**
+ * Stream sub-agent output transiently.
+ *
+ * @internal Forward-designed for CLI streaming feature. No production callers yet.
+ */
+export function streamSubAgent(ctx, agentId, role, text, status, error) {
+    streamTransient(ctx, 'sub-agent-stream', {
+        agentId,
+        role,
+        text,
+        status,
+        error,
+    });
+}
+//# sourceMappingURL=transient.js.map

package/dist/streaming/transient.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transient.js","sourceRoot":"","sources":["../../src/streaming/transient.ts"],"names":[],"mappings":"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"}

package/dist/system-detect.d.ts

@@ -1,81 +1,24 @@
-/**
- * @fileoverview System hardware detection for automatic Ollama model selection.
- *
- * Detects available RAM/VRAM and selects the best model the system can
- * comfortably run. Falls back conservatively — better to run a smaller
- * model fast than a larger model that swaps to disk.
- *
- * Supports both local models and Ollama cloud models (-cloud suffix).
- * Cloud models are always preferred when available since they run on
- * remote infrastructure regardless of local hardware.
- *
- * Memory thresholds (Q4_K_M quantization, local models):
- *   qwen3:8b         ~5-6 GB  → needs ≥8 GB total RAM
- *   qwen3-coder:30b  ~17 GB   → needs ≥24 GB total RAM (MoE, fast inference)
- *   qwen3.5:35b      ~20 GB   → needs ≥32 GB total RAM
- */
 export interface SystemProfile {
-    /** Total system RAM in GB */
     totalRAMGb: number;
-    /** Usable memory for models in GB (accounts for OS overhead + GPU sharing) */
     usableForModelsGb: number;
-    /** Platform: darwin, linux, win32 */
     platform: string;
-    /** Whether this is Apple Silicon (unified memory architecture) */
     isAppleSilicon: boolean;
-    /** NVIDIA VRAM in GB, if detected */
     nvidiaVRAMGb: number | null;
 }
 export type OllamaModelTier = 'small' | 'medium' | 'large';
 export interface OllamaModelRecommendation {
-    /** Recommended tier */
     tier: OllamaModelTier;
-    /** Model tag to pull/use for each agent tier */
     fast: string;
     standard: string;
     reasoning: string;
     powerful: string;
-    /** Human-readable reason */
     reason: string;
-    /** True when installed models exist but none are usable (all < 8b, no cloud) */
     noUsableModels?: boolean;
 }
-/** Cloud models run on remote infrastructure — always usable regardless of local hardware. */
 export declare function isCloudModel(tag: string): boolean;
-/**
- * Check if a model is large enough for reliable agent tool-calling.
- * Models need >= 8b parameters. Cloud models are always usable.
- * Unknown sizes (e.g. "deepseek-coder:latest") are assumed usable.
- */
 export declare function isUsableSize(tag: string): boolean;
-/**
- * Detect system hardware profile.
- */
 export declare function detectSystem(): SystemProfile;
-/**
- * Select the best Ollama model tier based on system capabilities
- * and (optionally) which models are actually installed.
- *
- * When installedModels is provided, the recommendation is constrained
- * to models the user already has pulled — the best available model is
- * used for every tier rather than recommending something that would 404.
- *
- * If only sub-8b models are installed (and no cloud models), sets
- * `noUsableModels: true` so the caller can skip Ollama entirely.
- *
- * Hardware thresholds (usable memory for model weights):
- *   < 6 GB  → too small, warn user
- *   6-10 GB → small (qwen3:8b everywhere)
- *   10-20 GB → medium (qwen3-coder:30b for standard+)
- *   20+ GB  → large (qwen3.5:35b for reasoning/powerful)
- */
 export declare function recommendOllamaModels(profile?: SystemProfile, installedModels?: string[]): OllamaModelRecommendation;
-/**
- * Check which models Ollama already has pulled.
- */
 export declare function getOllamaModels(baseUrl?: string): Promise<string[]>;
-/**
- * Check if a specific model is available in Ollama.
- */
 export declare function hasOllamaModel(model: string, baseUrl?: string): Promise<boolean>;
 //# sourceMappingURL=system-detect.d.ts.map

package/dist/system-detect.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"system-detect.d.ts","sourceRoot":"","sources":["../src/system-detect.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAYH,MAAM,WAAW,aAAa;IAC5B,6BAA6B;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,8EAA8E;IAC9E,iBAAiB,EAAE,MAAM,CAAC;IAC1B,qCAAqC;IACrC,QAAQ,EAAE,MAAM,CAAC;IACjB,kEAAkE;IAClE,cAAc,EAAE,OAAO,CAAC;IACxB,qCAAqC;IACrC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B;AAED,MAAM,MAAM,eAAe,GAAG,OAAO,GAAG,QAAQ,GAAG,OAAO,CAAC;AAE3D,MAAM,WAAW,yBAAyB;IACxC,uBAAuB;IACvB,IAAI,EAAE,eAAe,CAAC;IACtB,gDAAgD;IAChD,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,4BAA4B;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,gFAAgF;IAChF,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAMD,8FAA8F;AAC9F,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAGjD;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAMjD;AA2FD;;GAEG;AACH,wBAAgB,YAAY,IAAI,aAAa,CAuC5C;AAMD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,CAAC,EAAE,aAAa,EACvB,eAAe,CAAC,EAAE,MAAM,EAAE,GACzB,yBAAyB,CA4E3B;AAiCD;;GAEG;AACH,wBAAsB,eAAe,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAqBzE;AAED;;GAEG;AACH,wBAAsB,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAKtF"}
+{"version":3,"file":"system-detect.d.ts","sourceRoot":"","sources":["../src/system-detect.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,aAAa;IAC5B,UAAU,EAAE,MAAM,CAAC;IAEnB,iBAAiB,EAAE,MAAM,CAAC;IAE1B,QAAQ,EAAE,MAAM,CAAC;IAEjB,cAAc,EAAE,OAAO,CAAC;IAExB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B;AAED,MAAM,MAAM,eAAe,GAAG,OAAO,GAAG,QAAQ,GAAG,OAAO,CAAC;AAE3D,MAAM,WAAW,yBAAyB;IACxC,IAAI,EAAE,eAAe,CAAC;IAEtB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IAEjB,MAAM,EAAE,MAAM,CAAC;IAEf,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAGjD;AAED,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAMjD;AAuED,wBAAgB,YAAY,IAAI,aAAa,CA6B5C;AAED,wBAAgB,qBAAqB,CACnC,OAAO,CAAC,EAAE,aAAa,EACvB,eAAe,CAAC,EAAE,MAAM,EAAE,GACzB,yBAAyB,CAoE3B;AAkBD,wBAAsB,eAAe,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAqBzE;AAED,wBAAsB,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAKtF"}

package/dist/system-detect.js

@@ -1,48 +1,19 @@
-/**
- * @fileoverview System hardware detection for automatic Ollama model selection.
- *
- * Detects available RAM/VRAM and selects the best model the system can
- * comfortably run. Falls back conservatively — better to run a smaller
- * model fast than a larger model that swaps to disk.
- *
- * Supports both local models and Ollama cloud models (-cloud suffix).
- * Cloud models are always preferred when available since they run on
- * remote infrastructure regardless of local hardware.
- *
- * Memory thresholds (Q4_K_M quantization, local models):
- *   qwen3:8b         ~5-6 GB  → needs ≥8 GB total RAM
- *   qwen3-coder:30b  ~17 GB   → needs ≥24 GB total RAM (MoE, fast inference)
- *   qwen3.5:35b      ~20 GB   → needs ≥32 GB total RAM
- */
 import { createLogger } from '@agntk/logger';
 import os from 'node:os';
 import { execSync } from 'node:child_process';
 const log = createLogger('@agntk/core:system-detect');
-// ============================================================================
-// Model Classification
-// ============================================================================
-/** Cloud models run on remote infrastructure — always usable regardless of local hardware. */
 export function isCloudModel(tag) {
     const lower = tag.toLowerCase();
     return lower.includes('-cloud') || lower.endsWith(':cloud');
 }
-/**
- * Check if a model is large enough for reliable agent tool-calling.
- * Models need >= 8b parameters. Cloud models are always usable.
- * Unknown sizes (e.g. "deepseek-coder:latest") are assumed usable.
- */
 export function isUsableSize(tag) {
     if (isCloudModel(tag))
         return true;
-    // Parse size from tags like "qwen3:14b", "llama3.1:70b", "qwen3-coder:30b"
     const match = tag.match(/(\d+(?:\.\d+)?)b/i);
     if (!match)
-        return true; // unknown size → assume usable
+        return true;
     return parseFloat(match[1]) >= 8;
 }
-// ============================================================================
-// Model Tier Definitions
-// ============================================================================
 const MODEL_TIERS = {
     small: {
         tier: 'small',
@@ -66,17 +37,11 @@ const MODEL_TIERS = {
         powerful: 'qwen3.5:35b',
     },
 };
-/**
- * Preferred models ordered from best to least preferred.
- * Cloud models first (run on remote infra), then best local models.
- */
 const MODEL_PREFERENCE = [
-    // Cloud (always top priority)
     'qwen3-coder:480b-cloud',
     'qwen3.5:cloud',
     'qwen3.5:397b-cloud',
     'gpt-oss:120b-cloud',
-    // Local (newest/best first)
     'qwen3-coder:30b',
     'qwen3.5:35b',
     'qwen3.5:27b',
@@ -84,12 +49,6 @@ const MODEL_PREFERENCE = [
     'qwen3:14b',
     'qwen3:8b',
 ];
-// ============================================================================
-// System Detection
-// ============================================================================
-/**
- * Detect whether this is an Apple Silicon Mac.
- */
 function detectAppleSilicon() {
     if (os.platform() !== 'darwin')
         return false;
@@ -101,21 +60,19 @@ function detectAppleSilicon() {
         return brand.includes('Apple');
     }
     catch {
-        // Fallback: check arch
         return os.arch() === 'arm64';
     }
 }
-/**
- * Try to detect NVIDIA GPU VRAM via nvidia-smi.
- * Returns VRAM in GB or null if no NVIDIA GPU / nvidia-smi not found.
- */
 function detectNvidiaVRAM() {
     try {
-        const output = execSync('nvidia-smi --query-gpu=memory.total --format=csv,noheader,nounits', { encoding: 'utf-8', timeout: 3000, stdio: ['pipe', 'pipe', 'pipe'] }).trim();
-        // nvidia-smi returns MB, could have multiple GPUs — take the first
+        const output = execSync('nvidia-smi --query-gpu=memory.total --format=csv,noheader,nounits', {
+            encoding: 'utf-8',
+            timeout: 3000,
+            stdio: ['pipe', 'pipe', 'pipe'],
+        }).trim();
         const mb = parseInt(output.split('\n')[0], 10);
         if (!isNaN(mb) && mb > 0) {
-            return Math.round(mb / 1024 * 10) / 10; // GB with 1 decimal
+            return Math.round((mb / 1024) * 10) / 10;
         }
         return null;
     }
@@ -123,33 +80,20 @@ function detectNvidiaVRAM() {
         return null;
     }
 }
-/**
- * Detect system hardware profile.
- */
 export function detectSystem() {
     const totalBytes = os.totalmem();
-    const totalRAMGb = Math.round(totalBytes / (1024 ** 3) * 10) / 10;
+    const totalRAMGb = Math.round((totalBytes / 1024 ** 3) * 10) / 10;
     const platform = os.platform();
     const isAppleSilicon = detectAppleSilicon();
     const nvidiaVRAMGb = detectNvidiaVRAM();
-    // Calculate usable memory for models:
-    // - Reserve ~3 GB for OS + Ollama server overhead
-    // - On Apple Silicon: GPU gets ~75% of unified memory, but we're more conservative
-    // - On NVIDIA: model loads into VRAM, which is separate from system RAM
     let usableForModelsGb;
     if (nvidiaVRAMGb !== null) {
-        // NVIDIA GPU: model goes into VRAM. Use that as the constraint.
-        usableForModelsGb = nvidiaVRAMGb - 1; // reserve 1 GB for GPU driver/overhead
+        usableForModelsGb = nvidiaVRAMGb - 1;
     }
     else if (isAppleSilicon) {
-        // Apple Silicon: unified memory shared between CPU and GPU.
-        // Ollama uses Metal — model sits in unified memory.
-        // Reserve ~25% for OS + apps + KV cache growth.
         usableForModelsGb = totalRAMGb * 0.65;
     }
     else {
-        // CPU-only inference: slower but uses system RAM.
-        // Reserve 3 GB for OS overhead.
         usableForModelsGb = totalRAMGb - 3;
     }
     usableForModelsGb = Math.max(0, usableForModelsGb);
@@ -163,30 +107,9 @@ export function detectSystem() {
     log.debug('System profile', { ...profile });
     return profile;
 }
-// ============================================================================
-// Model Recommendation
-// ============================================================================
-/**
- * Select the best Ollama model tier based on system capabilities
- * and (optionally) which models are actually installed.
- *
- * When installedModels is provided, the recommendation is constrained
- * to models the user already has pulled — the best available model is
- * used for every tier rather than recommending something that would 404.
- *
- * If only sub-8b models are installed (and no cloud models), sets
- * `noUsableModels: true` so the caller can skip Ollama entirely.
- *
- * Hardware thresholds (usable memory for model weights):
- *   < 6 GB  → too small, warn user
- *   6-10 GB → small (qwen3:8b everywhere)
- *   10-20 GB → medium (qwen3-coder:30b for standard+)
- *   20+ GB  → large (qwen3.5:35b for reasoning/powerful)
- */
 export function recommendOllamaModels(profile, installedModels) {
     const sys = profile || detectSystem();
     const mem = sys.usableForModelsGb;
-    // Determine the hardware-ideal tier
     let ideal;
     if (mem < 4) {
         log.warn('Very limited memory for local models', { usableGb: mem });
@@ -213,15 +136,12 @@ export function recommendOllamaModels(profile, installedModels) {
             reason: `${sys.totalRAMGb} GB RAM → qwen3.5:35b for reasoning/powerful, qwen3-coder:30b for standard`,
         };
     }
-    // If we don't know what's installed, return the hardware-ideal recommendation
     if (!installedModels || installedModels.length === 0) {
         return ideal;
     }
-    // Constrain to what's actually pulled — pick the best available model
     const installed = new Set(installedModels.map((m) => m.toLowerCase()));
     const bestAvailable = pickBestAvailable(installed);
     if (!bestAvailable) {
-        // No usable models installed (all sub-8b, no cloud)
         log.info('No usable models installed', { installed: [...installed] });
         return {
             ...ideal,
@@ -229,9 +149,6 @@ export function recommendOllamaModels(profile, installedModels) {
             reason: 'No usable models found (need 8b+ local or cloud model)',
         };
     }
-    // Clamp each tier to what's installed.
-    // Cloud models always win over local — they run on remote infrastructure
-    // so they're faster and more capable regardless of local hardware.
     const bestIsCloud = isCloudModel(bestAvailable);
     const clamp = (model) => {
         if (bestIsCloud)
@@ -250,41 +167,23 @@ export function recommendOllamaModels(profile, installedModels) {
         powerful: clamp(ideal.powerful),
         reason: '',
     };
-    // Build reason showing what standard tier will actually use
     const unique = [...new Set([result.fast, result.standard, result.reasoning, result.powerful])];
     result.reason = `${sys.totalRAMGb} GB RAM → ${unique.join(', ')}`;
     return result;
 }
-/**
- * Pick the best usable model from what's installed.
- *
- * Priority:
- * 1. Preferred models in order (cloud first, then best local)
- * 2. Any other installed model that passes isUsableSize()
- * 3. null if nothing qualifies
- */
 function pickBestAvailable(installed) {
-    // Check preferred models in order
     for (const model of MODEL_PREFERENCE) {
         if (installed.has(model) || [...installed].some((m) => m.startsWith(model))) {
             return model;
         }
     }
-    // Check for any other usable model (non-qwen, non-preferred but >= 8b or cloud)
     for (const model of installed) {
         if (isUsableSize(model)) {
             return model;
         }
     }
-    // Nothing qualifies
     return null;
 }
-// ============================================================================
-// Ollama Model Availability
-// ============================================================================
-/**
- * Check which models Ollama already has pulled.
- */
 export async function getOllamaModels(baseUrl) {
     const rawUrl = baseUrl || process.env['OLLAMA_BASE_URL'] || 'http://localhost:11434';
     const url = rawUrl.replace(/\/(api|v1)\/?$/, '');
@@ -306,12 +205,8 @@ export async function getOllamaModels(baseUrl) {
         return [];
     }
 }
-/**
- * Check if a specific model is available in Ollama.
- */
 export async function hasOllamaModel(model, baseUrl) {
     const models = await getOllamaModels(baseUrl);
-    // Normalize: "qwen3:8b" should match "qwen3:8b" and "qwen3:8b-q4_K_M"
     const normalized = model.toLowerCase();
     return models.some((m) => m.toLowerCase().startsWith(normalized));
 }

package/dist/system-detect.js.map

@@ -1 +1 @@
-{"version":3,"file":"system-detect.js","sourceRoot":"","sources":["../src/system-detect.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAE9C,MAAM,GAAG,GAAG,YAAY,CAAC,2BAA2B,CAAC,CAAC;AAmCtD,+EAA+E;AAC/E,uBAAuB;AACvB,+EAA+E;AAE/E,8FAA8F;AAC9F,MAAM,UAAU,YAAY,CAAC,GAAW;IACtC,MAAM,KAAK,GAAG,GAAG,CAAC,WAAW,EAAE,CAAC;IAChC,OAAO,KAAK,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;AAC9D,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,YAAY,CAAC,GAAW;IACtC,IAAI,YAAY,CAAC,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC;IACnC,2EAA2E;IAC3E,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,mBAAmB,CAAC,CAAC;IAC7C,IAAI,CAAC,KAAK;QAAE,OAAO,IAAI,CAAC,CAAC,+BAA+B;IACxD,OAAO,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;AACnC,CAAC;AAED,+EAA+E;AAC/E,yBAAyB;AACzB,+EAA+E;AAE/E,MAAM,WAAW,GAAuE;IACtF,KAAK,EAAE;QACL,IAAI,EAAE,OAAO;QACb,IAAI,EAAE,UAAU;QAChB,QAAQ,EAAE,UAAU;QACpB,SAAS,EAAE,UAAU;QACrB,QAAQ,EAAE,UAAU;KACrB;IACD,MAAM,EAAE;QACN,IAAI,EAAE,QAAQ;QACd,IAAI,EAAE,UAAU;QAChB,QAAQ,EAAE,iBAAiB;QAC3B,SAAS,EAAE,iBAAiB;QAC5B,QAAQ,EAAE,iBAAiB;KAC5B;IACD,KAAK,EAAE;QACL,IAAI,EAAE,OAAO;QACb,IAAI,EAAE,UAAU;QAChB,QAAQ,EAAE,iBAAiB;QAC3B,SAAS,EAAE,aAAa;QACxB,QAAQ,EAAE,aAAa;KACxB;CACF,CAAC;AAEF;;;GAGG;AACH,MAAM,gBAAgB,GAAG;IACvB,8BAA8B;IAC9B,wBAAwB;IACxB,eAAe;IACf,oBAAoB;IACpB,oBAAoB;IACpB,4BAA4B;IAC5B,iBAAiB;IACjB,aAAa;IACb,aAAa;IACb,WAAW;IACX,WAAW;IACX,UAAU;CACX,CAAC;AAEF,+EAA+E;AAC/E,mBAAmB;AACnB,+EAA+E;AAE/E;;GAEG;AACH,SAAS,kBAAkB;IACzB,IAAI,EAAE,CAAC,QAAQ,EAAE,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC7C,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,QAAQ,CAAC,oCAAoC,EAAE;YAC3D,QAAQ,EAAE,OAAO;YACjB,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC;SAChC,CAAC,CAAC,IAAI,EAAE,CAAC;QACV,OAAO,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;IACjC,CAAC;IAAC,MAAM,CAAC;QACP,uBAAuB;QACvB,OAAO,EAAE,CAAC,IAAI,EAAE,KAAK,OAAO,CAAC;IAC/B,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,SAAS,gBAAgB;IACvB,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,QAAQ,CACrB,mEAAmE,EACnE,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,CACtE,CAAC,IAAI,EAAE,CAAC;QACT,mEAAmE;QACnE,MAAM,EAAE,GAAG,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QAC/C,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,IAAI,EAAE,GAAG,CAAC,EAAE,CAAC;YACzB,OAAO,IAAI,CAAC,KAAK,CAAC,EAAE,GAAG,IAAI,GAAG,EAAE,CAAC,GAAG,EAAE,CAAC,CAAC,oBAAoB;QAC9D,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY;IAC1B,MAAM,UAAU,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC;IACjC,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,UAAU,GAAG,CAAC,IAAI,IAAI,CAAC,CAAC,GAAG,EAAE,CAAC,GAAG,EAAE,CAAC;IAClE,MAAM,QAAQ,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC;IAC/B,MAAM,cAAc,GAAG,kBAAkB,EAAE,CAAC;IAC5C,MAAM,YAAY,GAAG,gBAAgB,EAAE,CAAC;IAExC,sCAAsC;IACtC,kDAAkD;IAClD,mFAAmF;IACnF,wEAAwE;IACxE,IAAI,iBAAyB,CAAC;IAE9B,IAAI,YAAY,KAAK,IAAI,EAAE,CAAC;QAC1B,gEAAgE;QAChE,iBAAiB,GAAG,YAAY,GAAG,CAAC,CAAC,CAAC,uCAAuC;IAC/E,CAAC;SAAM,IAAI,cAAc,EAAE,CAAC;QAC1B,4DAA4D;QAC5D,oDAAoD;QACpD,gDAAgD;QAChD,iBAAiB,GAAG,UAAU,GAAG,IAAI,CAAC;IACxC,CAAC;SAAM,CAAC;QACN,kDAAkD;QAClD,gCAAgC;QAChC,iBAAiB,GAAG,UAAU,GAAG,CAAC,CAAC;IACrC,CAAC;IAED,iBAAiB,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,iBAAiB,CAAC,CAAC;IAEnD,MAAM,OAAO,GAAkB;QAC7B,UAAU;QACV,iBAAiB;QACjB,QAAQ;QACR,cAAc;QACd,YAAY;KACb,CAAC;IAEF,GAAG,CAAC,KAAK,CAAC,gBAAgB,EAAE,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC5C,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,+EAA+E;AAC/E,uBAAuB;AACvB,+EAA+E;AAE/E;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,qBAAqB,CACnC,OAAuB,EACvB,eAA0B;IAE1B,MAAM,GAAG,GAAG,OAAO,IAAI,YAAY,EAAE,CAAC;IACtC,MAAM,GAAG,GAAG,GAAG,CAAC,iBAAiB,CAAC;IAElC,oCAAoC;IACpC,IAAI,KAAgC,CAAC;IAErC,IAAI,GAAG,GAAG,CAAC,EAAE,CAAC;QACZ,GAAG,CAAC,IAAI,CAAC,sCAAsC,EAAE,EAAE,QAAQ,EAAE,GAAG,EAAE,CAAC,CAAC;QACpE,KAAK,GAAG;YACN,GAAG,WAAW,CAAC,KAAK;YACpB,MAAM,EAAE,QAAQ,GAAG,CAAC,UAAU,gFAAgF;SAC/G,CAAC;IACJ,CAAC;SAAM,IAAI,GAAG,GAAG,EAAE,EAAE,CAAC;QACpB,KAAK,GAAG;YACN,GAAG,WAAW,CAAC,KAAK;YACpB,MAAM,EAAE,GAAG,GAAG,CAAC,UAAU,iDAAiD;SAC3E,CAAC;IACJ,CAAC;SAAM,IAAI,GAAG,GAAG,EAAE,EAAE,CAAC;QACpB,KAAK,GAAG;YACN,GAAG,WAAW,CAAC,MAAM;YACrB,MAAM,EAAE,GAAG,GAAG,CAAC,UAAU,uEAAuE;SACjG,CAAC;IACJ,CAAC;SAAM,CAAC;QACN,KAAK,GAAG;YACN,GAAG,WAAW,CAAC,KAAK;YACpB,MAAM,EAAE,GAAG,GAAG,CAAC,UAAU,4EAA4E;SACtG,CAAC;IACJ,CAAC;IAED,8EAA8E;IAC9E,IAAI,CAAC,eAAe,IAAI,eAAe,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACrD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,sEAAsE;IACtE,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC;IACvE,MAAM,aAAa,GAAG,iBAAiB,CAAC,SAAS,CAAC,CAAC;IAEnD,IAAI,CAAC,aAAa,EAAE,CAAC;QACnB,oDAAoD;QACpD,GAAG,CAAC,IAAI,CAAC,4BAA4B,EAAE,EAAE,SAAS,EAAE,CAAC,GAAG,SAAS,CAAC,EAAE,CAAC,CAAC;QACtE,OAAO;YACL,GAAG,KAAK;YACR,cAAc,EAAE,IAAI;YACpB,MAAM,EAAE,wDAAwD;SACjE,CAAC;IACJ,CAAC;IAED,uCAAuC;IACvC,yEAAyE;IACzE,mEAAmE;IACnE,MAAM,WAAW,GAAG,YAAY,CAAC,aAAa,CAAC,CAAC;IAChD,MAAM,KAAK,GAAG,CAAC,KAAa,EAAE,EAAE;QAC9B,IAAI,WAAW;YAAE,OAAO,aAAa,CAAC;QACtC,MAAM,IAAI,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC;QACjC,IAAI,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,SAAS,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC;YAC1E,OAAO,KAAK,CAAC;QACf,CAAC;QACD,OAAO,aAAa,CAAC;IACvB,CAAC,CAAC;IAEF,MAAM,MAAM,GAAG;QACb,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,IAAI,EAAE,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC;QACvB,QAAQ,EAAE,KAAK,CAAC,KAAK,CAAC,QAAQ,CAAC;QAC/B,SAAS,EAAE,KAAK,CAAC,KAAK,CAAC,SAAS,CAAC;QACjC,QAAQ,EAAE,KAAK,CAAC,KAAK,CAAC,QAAQ,CAAC;QAC/B,MAAM,EAAE,EAAE;KACX,CAAC;IAEF,4DAA4D;IAC5D,MAAM,MAAM,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;IAC/F,MAAM,CAAC,MAAM,GAAG,GAAG,GAAG,CAAC,UAAU,aAAa,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;IAElE,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;;;;GAOG;AACH,SAAS,iBAAiB,CAAC,SAAsB;IAC/C,kCAAkC;IAClC,KAAK,MAAM,KAAK,IAAI,gBAAgB,EAAE,CAAC;QACrC,IAAI,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,SAAS,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC;YAC5E,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IAED,gFAAgF;IAChF,KAAK,MAAM,KAAK,IAAI,SAAS,EAAE,CAAC;QAC9B,IAAI,YAAY,CAAC,KAAK,CAAC,EAAE,CAAC;YACxB,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IAED,oBAAoB;IACpB,OAAO,IAAI,CAAC;AACd,CAAC;AAED,+EAA+E;AAC/E,4BAA4B;AAC5B,+EAA+E;AAE/E;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,OAAgB;IACpD,MAAM,MAAM,GAAG,OAAO,IAAI,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC,IAAI,wBAAwB,CAAC;IACrF,MAAM,GAAG,GAAG,MAAM,CAAC,OAAO,CAAC,gBAAgB,EAAE,EAAE,CAAC,CAAC;IACjD,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;IACzC,MAAM,OAAO,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,EAAE,IAAI,CAAC,CAAC;IAE3D,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,GAAG,WAAW,EAAE;YACzC,MAAM,EAAE,UAAU,CAAC,MAAM;YACzB,MAAM,EAAE,KAAK;SACd,CAAC,CAAC;QACH,YAAY,CAAC,OAAO,CAAC,CAAC;QAEtB,IAAI,CAAC,GAAG,CAAC,EAAE;YAAE,OAAO,EAAE,CAAC;QAEvB,MAAM,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAAyC,CAAC;QACxE,OAAO,CAAC,IAAI,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IAChD,CAAC;IAAC,MAAM,CAAC;QACP,YAAY,CAAC,OAAO,CAAC,CAAC;QACtB,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,KAAa,EAAE,OAAgB;IAClE,MAAM,MAAM,GAAG,MAAM,eAAe,CAAC,OAAO,CAAC,CAAC;IAC9C,sEAAsE;IACtE,MAAM,UAAU,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC;IACvC,OAAO,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC,CAAC;AACpE,CAAC"}
+{"version":3,"file":"system-detect.js","sourceRoot":"","sources":["../src/system-detect.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAE9C,MAAM,GAAG,GAAG,YAAY,CAAC,2BAA2B,CAAC,CAAC;AA6BtD,MAAM,UAAU,YAAY,CAAC,GAAW;IACtC,MAAM,KAAK,GAAG,GAAG,CAAC,WAAW,EAAE,CAAC;IAChC,OAAO,KAAK,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;AAC9D,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,GAAW;IACtC,IAAI,YAAY,CAAC,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC;IAEnC,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,mBAAmB,CAAC,CAAC;IAC7C,IAAI,CAAC,KAAK;QAAE,OAAO,IAAI,CAAC;IACxB,OAAO,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;AACnC,CAAC;AAED,MAAM,WAAW,GAAuE;IACtF,KAAK,EAAE;QACL,IAAI,EAAE,OAAO;QACb,IAAI,EAAE,UAAU;QAChB,QAAQ,EAAE,UAAU;QACpB,SAAS,EAAE,UAAU;QACrB,QAAQ,EAAE,UAAU;KACrB;IACD,MAAM,EAAE;QACN,IAAI,EAAE,QAAQ;QACd,IAAI,EAAE,UAAU;QAChB,QAAQ,EAAE,iBAAiB;QAC3B,SAAS,EAAE,iBAAiB;QAC5B,QAAQ,EAAE,iBAAiB;KAC5B;IACD,KAAK,EAAE;QACL,IAAI,EAAE,OAAO;QACb,IAAI,EAAE,UAAU;QAChB,QAAQ,EAAE,iBAAiB;QAC3B,SAAS,EAAE,aAAa;QACxB,QAAQ,EAAE,aAAa;KACxB;CACF,CAAC;AAEF,MAAM,gBAAgB,GAAG;IACvB,wBAAwB;IACxB,eAAe;IACf,oBAAoB;IACpB,oBAAoB;IAEpB,iBAAiB;IACjB,aAAa;IACb,aAAa;IACb,WAAW;IACX,WAAW;IACX,UAAU;CACX,CAAC;AAEF,SAAS,kBAAkB;IACzB,IAAI,EAAE,CAAC,QAAQ,EAAE,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC7C,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,QAAQ,CAAC,oCAAoC,EAAE;YAC3D,QAAQ,EAAE,OAAO;YACjB,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC;SAChC,CAAC,CAAC,IAAI,EAAE,CAAC;QACV,OAAO,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;IACjC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC,IAAI,EAAE,KAAK,OAAO,CAAC;IAC/B,CAAC;AACH,CAAC;AAED,SAAS,gBAAgB;IACvB,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,QAAQ,CAAC,mEAAmE,EAAE;YAC3F,QAAQ,EAAE,OAAO;YACjB,OAAO,EAAE,IAAI;YACb,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC;SAChC,CAAC,CAAC,IAAI,EAAE,CAAC;QAEV,MAAM,EAAE,GAAG,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QAC/C,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,IAAI,EAAE,GAAG,CAAC,EAAE,CAAC;YACzB,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,GAAG,EAAE,CAAC;QAC3C,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,MAAM,UAAU,YAAY;IAC1B,MAAM,UAAU,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC;IACjC,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,UAAU,GAAG,IAAI,IAAI,CAAC,CAAC,GAAG,EAAE,CAAC,GAAG,EAAE,CAAC;IAClE,MAAM,QAAQ,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC;IAC/B,MAAM,cAAc,GAAG,kBAAkB,EAAE,CAAC;IAC5C,MAAM,YAAY,GAAG,gBAAgB,EAAE,CAAC;IAExC,IAAI,iBAAyB,CAAC;IAE9B,IAAI,YAAY,KAAK,IAAI,EAAE,CAAC;QAC1B,iBAAiB,GAAG,YAAY,GAAG,CAAC,CAAC;IACvC,CAAC;SAAM,IAAI,cAAc,EAAE,CAAC;QAC1B,iBAAiB,GAAG,UAAU,GAAG,IAAI,CAAC;IACxC,CAAC;SAAM,CAAC;QACN,iBAAiB,GAAG,UAAU,GAAG,CAAC,CAAC;IACrC,CAAC;IAED,iBAAiB,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,iBAAiB,CAAC,CAAC;IAEnD,MAAM,OAAO,GAAkB;QAC7B,UAAU;QACV,iBAAiB;QACjB,QAAQ;QACR,cAAc;QACd,YAAY;KACb,CAAC;IAEF,GAAG,CAAC,KAAK,CAAC,gBAAgB,EAAE,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC5C,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,MAAM,UAAU,qBAAqB,CACnC,OAAuB,EACvB,eAA0B;IAE1B,MAAM,GAAG,GAAG,OAAO,IAAI,YAAY,EAAE,CAAC;IACtC,MAAM,GAAG,GAAG,GAAG,CAAC,iBAAiB,CAAC;IAElC,IAAI,KAAgC,CAAC;IAErC,IAAI,GAAG,GAAG,CAAC,EAAE,CAAC;QACZ,GAAG,CAAC,IAAI,CAAC,sCAAsC,EAAE,EAAE,QAAQ,EAAE,GAAG,EAAE,CAAC,CAAC;QACpE,KAAK,GAAG;YACN,GAAG,WAAW,CAAC,KAAK;YACpB,MAAM,EAAE,QAAQ,GAAG,CAAC,UAAU,gFAAgF;SAC/G,CAAC;IACJ,CAAC;SAAM,IAAI,GAAG,GAAG,EAAE,EAAE,CAAC;QACpB,KAAK,GAAG;YACN,GAAG,WAAW,CAAC,KAAK;YACpB,MAAM,EAAE,GAAG,GAAG,CAAC,UAAU,iDAAiD;SAC3E,CAAC;IACJ,CAAC;SAAM,IAAI,GAAG,GAAG,EAAE,EAAE,CAAC;QACpB,KAAK,GAAG;YACN,GAAG,WAAW,CAAC,MAAM;YACrB,MAAM,EAAE,GAAG,GAAG,CAAC,UAAU,uEAAuE;SACjG,CAAC;IACJ,CAAC;SAAM,CAAC;QACN,KAAK,GAAG;YACN,GAAG,WAAW,CAAC,KAAK;YACpB,MAAM,EAAE,GAAG,GAAG,CAAC,UAAU,4EAA4E;SACtG,CAAC;IACJ,CAAC;IAED,IAAI,CAAC,eAAe,IAAI,eAAe,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACrD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC;IACvE,MAAM,aAAa,GAAG,iBAAiB,CAAC,SAAS,CAAC,CAAC;IAEnD,IAAI,CAAC,aAAa,EAAE,CAAC;QACnB,GAAG,CAAC,IAAI,CAAC,4BAA4B,EAAE,EAAE,SAAS,EAAE,CAAC,GAAG,SAAS,CAAC,EAAE,CAAC,CAAC;QACtE,OAAO;YACL,GAAG,KAAK;YACR,cAAc,EAAE,IAAI;YACpB,MAAM,EAAE,wDAAwD;SACjE,CAAC;IACJ,CAAC;IAED,MAAM,WAAW,GAAG,YAAY,CAAC,aAAa,CAAC,CAAC;IAChD,MAAM,KAAK,GAAG,CAAC,KAAa,EAAE,EAAE;QAC9B,IAAI,WAAW;YAAE,OAAO,aAAa,CAAC;QACtC,MAAM,IAAI,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC;QACjC,IAAI,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,SAAS,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC;YAC1E,OAAO,KAAK,CAAC;QACf,CAAC;QACD,OAAO,aAAa,CAAC;IACvB,CAAC,CAAC;IAEF,MAAM,MAAM,GAAG;QACb,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,IAAI,EAAE,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC;QACvB,QAAQ,EAAE,KAAK,CAAC,KAAK,CAAC,QAAQ,CAAC;QAC/B,SAAS,EAAE,KAAK,CAAC,KAAK,CAAC,SAAS,CAAC;QACjC,QAAQ,EAAE,KAAK,CAAC,KAAK,CAAC,QAAQ,CAAC;QAC/B,MAAM,EAAE,EAAE;KACX,CAAC;IAEF,MAAM,MAAM,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;IAC/F,MAAM,CAAC,MAAM,GAAG,GAAG,GAAG,CAAC,UAAU,aAAa,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;IAElE,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,iBAAiB,CAAC,SAAsB;IAC/C,KAAK,MAAM,KAAK,IAAI,gBAAgB,EAAE,CAAC;QACrC,IAAI,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,SAAS,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC;YAC5E,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IAED,KAAK,MAAM,KAAK,IAAI,SAAS,EAAE,CAAC;QAC9B,IAAI,YAAY,CAAC,KAAK,CAAC,EAAE,CAAC;YACxB,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,OAAgB;IACpD,MAAM,MAAM,GAAG,OAAO,IAAI,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC,IAAI,wBAAwB,CAAC;IACrF,MAAM,GAAG,GAAG,MAAM,CAAC,OAAO,CAAC,gBAAgB,EAAE,EAAE,CAAC,CAAC;IACjD,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;IACzC,MAAM,OAAO,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,EAAE,IAAI,CAAC,CAAC;IAE3D,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,GAAG,WAAW,EAAE;YACzC,MAAM,EAAE,UAAU,CAAC,MAAM;YACzB,MAAM,EAAE,KAAK;SACd,CAAC,CAAC;QACH,YAAY,CAAC,OAAO,CAAC,CAAC;QAEtB,IAAI,CAAC,GAAG,CAAC,EAAE;YAAE,OAAO,EAAE,CAAC;QAEvB,MAAM,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAAyC,CAAC;QACxE,OAAO,CAAC,IAAI,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IAChD,CAAC;IAAC,MAAM,CAAC;QACP,YAAY,CAAC,OAAO,CAAC,CAAC;QACtB,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,KAAa,EAAE,OAAgB;IAClE,MAAM,MAAM,GAAG,MAAM,eAAe,CAAC,OAAO,CAAC,CAAC;IAE9C,MAAM,UAAU,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC;IACvC,OAAO,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC,CAAC;AACpE,CAAC"}

package/dist/tools/approval.d.ts

@@ -1,67 +1,20 @@
-/**
- * @agntk/core - Tool Approval System
- *
- * Wraps tools with AI SDK's native `needsApproval` flag for human-in-the-loop
- * safety. When `approval: true` is set on the agent, dangerous tools
- * (shell, browser, file_write, file_edit) automatically require approval.
- *
- * Supports:
- * - Auto-flagging dangerous tools
- * - Typed approval payloads via Zod schemas
- * - Timeout with default values (approve/deny after N ms)
- * - Custom approval handlers
- */
 import type { Tool, ToolSet } from 'ai';
-/** Configuration for the approval system. */
 export interface ApprovalConfig {
-    /** Enable approval for dangerous tools. Default: false */
     enabled: boolean;
-    /** Tool names that require approval. If not set, uses DANGEROUS_TOOLS. */
     tools?: string[];
-    /** Default timeout in ms before auto-resolution. Default: none (wait forever) */
     timeout?: number;
-    /** Default action when timeout expires. Default: 'deny' */
     timeoutAction?: 'approve' | 'deny';
-    /** Custom handler called when a tool needs approval.
-     * Return true to approve, false to deny.
-     * If not provided, uses the AI SDK's built-in approval mechanism. */
     handler?: ApprovalHandler;
 }
-/** Custom approval handler function. */
 export type ApprovalHandler = (request: ApprovalRequest) => Promise<boolean> | boolean;
-/** Details about a tool call requiring approval. */
 export interface ApprovalRequest {
     toolName: string;
     input: unknown;
     toolCallId: string;
 }
-/** Default set of tool names considered dangerous and requiring approval. */
 export declare const DANGEROUS_TOOLS: Set<string>;
-/**
- * Check if a tool name is considered dangerous.
- */
 export declare function isDangerousTool(toolName: string, customList?: string[]): boolean;
-/**
- * Wrap a single tool with `needsApproval`, applying timeout + default action
- * if configured.
- */
 export declare function wrapToolWithApproval<T extends Tool>(toolName: string, tool: T, config: ApprovalConfig): T;
-/**
- * Apply approval to all dangerous tools in a toolset.
- *
- * @example
- * ```typescript
- * const tools = createToolPreset('standard', { workspaceRoot });
- * const approvedTools = applyApproval(tools, { enabled: true });
- * ```
- */
 export declare function applyApproval(tools: ToolSet, config: ApprovalConfig): ToolSet;
-/**
- * Create an approval config from agent options shorthand.
- *
- * Supports:
- * - `approval: true` → enable with defaults
- * - `approval: { tools: [...], timeout: 30000 }` → custom config
- */
 export declare function resolveApprovalConfig(input: boolean | ApprovalConfig | undefined): ApprovalConfig | undefined;
 //# sourceMappingURL=approval.d.ts.map

package/dist/tools/approval.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"approval.d.ts","sourceRoot":"","sources":["../../src/tools/approval.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,IAAI,CAAC;AASxC,6CAA6C;AAC7C,MAAM,WAAW,cAAc;IAC7B,0DAA0D;IAC1D,OAAO,EAAE,OAAO,CAAC;IAEjB,0EAA0E;IAC1E,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IAEjB,iFAAiF;IACjF,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,2DAA2D;IAC3D,aAAa,CAAC,EAAE,SAAS,GAAG,MAAM,CAAC;IAEnC;;yEAEqE;IACrE,OAAO,CAAC,EAAE,eAAe,CAAC;CAC3B;AAED,wCAAwC;AACxC,MAAM,MAAM,eAAe,GAAG,CAAC,OAAO,EAAE,eAAe,KAAK,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC;AAEvF,oDAAoD;AACpD,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,OAAO,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;CACpB;AAMD,6EAA6E;AAC7E,eAAO,MAAM,eAAe,aAM1B,CAAC;AAMH;;GAEG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,EAAE,GAAG,OAAO,CAKhF;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,CAAC,SAAS,IAAI,EACjD,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,CAAC,EACP,MAAM,EAAE,cAAc,GACrB,CAAC,CAoCH;AAED;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAC3B,KAAK,EAAE,OAAO,EACd,MAAM,EAAE,cAAc,GACrB,OAAO,CAgBT;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,OAAO,GAAG,cAAc,GAAG,SAAS,GAC1C,cAAc,GAAG,SAAS,CAI5B"}
+{"version":3,"file":"approval.d.ts","sourceRoot":"","sources":["../../src/tools/approval.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,IAAI,CAAC;AAKxC,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,OAAO,CAAC;IAEjB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IAEjB,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,aAAa,CAAC,EAAE,SAAS,GAAG,MAAM,CAAC;IAEnC,OAAO,CAAC,EAAE,eAAe,CAAC;CAC3B;AAED,MAAM,MAAM,eAAe,GAAG,CAAC,OAAO,EAAE,eAAe,KAAK,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC;AAEvF,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,OAAO,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,eAAO,MAAM,eAAe,aAM1B,CAAC;AAEH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,EAAE,GAAG,OAAO,CAKhF;AAED,wBAAgB,oBAAoB,CAAC,CAAC,SAAS,IAAI,EACjD,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,CAAC,EACP,MAAM,EAAE,cAAc,GACrB,CAAC,CAiCH;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,cAAc,GAAG,OAAO,CAgB7E;AAED,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,OAAO,GAAG,cAAc,GAAG,SAAS,GAC1C,cAAc,GAAG,SAAS,CAI5B"}