@defai.digital/provider-adapters 13.0.3

package/dist/error-classifier.js

@@ -0,0 +1,257 @@
+/**
+ * Error classifier for CLI-based providers
+ *
+ * Classifies errors from:
+ * - CLI exit codes
+ * - stderr output
+ * - Error messages
+ *
+ * Provides retry/fallback guidance based on error type
+ */
+/**
+ * Error patterns for classification
+ * Organized by category, each pattern is case-insensitive regex
+ */
+const ERROR_PATTERNS = {
+    // Quota exhausted - fallback to different provider
+    quota: [
+        /insufficient.?quota/i,
+        /quota.?exceeded/i,
+        /billing.?hard.?limit/i,
+        /RESOURCE_EXHAUSTED/i,
+        /credit.?limit/i,
+        /usage.?limit/i,
+    ],
+    // Rate limit - retry with backoff
+    rate_limit: [
+        /rate.?limit/i,
+        /too.?many.?requests/i,
+        /overloaded/i,
+        /RATE_LIMIT_EXCEEDED/i,
+        /throttl/i,
+        /\b429\b/, // Word boundary to prevent false matches like "4290"
+    ],
+    // Authentication - don't retry
+    authentication: [
+        /invalid.?api.?key/i,
+        /unauthorized/i,
+        /UNAUTHENTICATED/i,
+        /PERMISSION_DENIED/i,
+        /authentication.?failed/i,
+        /not.?authenticated/i,
+        /\b401\b/, // Word boundary to prevent false matches
+        /\b403\b/, // Word boundary to prevent false matches
+    ],
+    // Validation - don't retry
+    validation: [
+        /invalid.?request/i,
+        /malformed/i,
+        /bad.?request/i,
+        /validation.?error/i,
+        /invalid.?parameter/i,
+        /\b400\b/, // Word boundary to prevent false matches
+    ],
+    // Network - retry
+    network: [
+        /ECONNRESET/,
+        /ETIMEDOUT/,
+        /ENOTFOUND/,
+        /ECONNREFUSED/,
+        /network.?error/i,
+        /connection.?failed/i,
+        /DEADLINE_EXCEEDED/i,
+        /socket.?hang.?up/i,
+    ],
+    // Server errors - retry then fallback
+    server: [
+        /internal.?server.?error/i,
+        /service.?unavailable/i,
+        /bad.?gateway/i,
+        /\b500\b/, // Word boundary to prevent false matches
+        /\b502\b/, // Word boundary to prevent false matches
+        /\b503\b/, // Word boundary to prevent false matches
+        /\b504\b/, // Word boundary to prevent false matches
+    ],
+    // Timeout - retry or fallback
+    timeout: [
+        /timed?.?out/i,
+        /timeout/i,
+        /SIGTERM/,
+        /SIGKILL/,
+    ],
+    // Not found - don't retry
+    not_found: [
+        /command.?not.?found/i,
+        /ENOENT/,
+        /not.?found/i,
+        /model.?not.?found/i,
+        /\b404\b/, // Word boundary to prevent false matches
+    ],
+    // Configuration - don't retry
+    configuration: [
+        /not.?configured/i,
+        /missing.?config/i,
+        /invalid.?config/i,
+        /cli.?not.?installed/i,
+    ],
+    // Unknown - default
+    unknown: [],
+};
+/**
+ * Retry guidance by error category
+ */
+const RETRY_GUIDANCE = {
+    quota: { shouldRetry: false, shouldFallback: true },
+    rate_limit: { shouldRetry: true, shouldFallback: false },
+    authentication: { shouldRetry: false, shouldFallback: false },
+    validation: { shouldRetry: false, shouldFallback: false },
+    network: { shouldRetry: true, shouldFallback: true },
+    server: { shouldRetry: true, shouldFallback: true },
+    timeout: { shouldRetry: true, shouldFallback: true },
+    not_found: { shouldRetry: false, shouldFallback: true },
+    configuration: { shouldRetry: false, shouldFallback: false },
+    unknown: { shouldRetry: false, shouldFallback: true },
+};
+/**
+ * Classifies an error from various sources
+ *
+ * @param error - The error to classify (Error, string, or unknown)
+ * @returns Classified error with retry/fallback guidance
+ */
+export function classifyError(error) {
+    const message = extractErrorMessage(error);
+    const category = categorizeError(message);
+    const guidance = RETRY_GUIDANCE[category];
+    return {
+        category,
+        message,
+        shouldRetry: guidance.shouldRetry,
+        shouldFallback: guidance.shouldFallback,
+        retryAfterMs: extractRetryAfter(message),
+        originalError: error,
+    };
+}
+/**
+ * Safely truncates a string without cutting in the middle of multi-byte UTF-8 characters
+ * Uses Array.from to properly handle grapheme clusters
+ */
+function safeTruncate(str, maxLength) {
+    const chars = Array.from(str);
+    if (chars.length <= maxLength) {
+        return str;
+    }
+    return chars.slice(0, maxLength).join('');
+}
+/**
+ * Classifies a CLI spawn result
+ *
+ * @param result - The spawn result to classify
+ * @returns Classified error with retry/fallback guidance
+ */
+export function classifySpawnResult(result) {
+    // Check for timeout
+    if (result.timedOut) {
+        return {
+            category: 'timeout',
+            message: 'Process timed out',
+            shouldRetry: true,
+            shouldFallback: true,
+            retryAfterMs: null,
+            originalError: result,
+        };
+    }
+    // Check stderr first, then exit code
+    const errorText = result.stderr.length > 0 ? result.stderr : `Exit code: ${String(result.exitCode)}`;
+    const category = categorizeError(errorText);
+    const guidance = RETRY_GUIDANCE[category];
+    return {
+        category,
+        message: safeTruncate(errorText, 500), // Truncate long error messages safely
+        shouldRetry: guidance.shouldRetry,
+        shouldFallback: guidance.shouldFallback,
+        retryAfterMs: extractRetryAfter(errorText),
+        originalError: result,
+    };
+}
+/**
+ * Extracts error message from various error types
+ */
+function extractErrorMessage(error) {
+    if (error instanceof Error) {
+        return error.message;
+    }
+    if (typeof error === 'string') {
+        return error;
+    }
+    if (typeof error === 'object' && error !== null) {
+        // Handle objects with message property
+        const obj = error;
+        if (typeof obj.message === 'string') {
+            return obj.message;
+        }
+        if (typeof obj.error === 'string') {
+            return obj.error;
+        }
+        if (typeof obj.error === 'object' && obj.error !== null) {
+            const nested = obj.error;
+            if (typeof nested.message === 'string') {
+                return nested.message;
+            }
+        }
+    }
+    return String(error);
+}
+/**
+ * Categorizes an error message using pattern matching
+ */
+function categorizeError(message) {
+    // Check each category's patterns
+    for (const [category, patterns] of Object.entries(ERROR_PATTERNS)) {
+        for (const pattern of patterns) {
+            if (pattern.test(message)) {
+                return category;
+            }
+        }
+    }
+    // Default to unknown
+    return 'unknown';
+}
+/**
+ * Extracts retry-after duration from error message
+ * Looks for common patterns like "retry after X seconds"
+ */
+function extractRetryAfter(message) {
+    // Pattern: "retry after X seconds"
+    const secondsMatch = /retry.?after\s+(\d+)\s*s/i.exec(message);
+    if (secondsMatch?.[1] !== undefined) {
+        return parseInt(secondsMatch[1], 10) * 1000;
+    }
+    // Pattern: "retry after X milliseconds" or "retry after Xms"
+    const msMatch = /retry.?after\s+(\d+)\s*(?:ms|milliseconds)/i.exec(message);
+    if (msMatch?.[1] !== undefined) {
+        return parseInt(msMatch[1], 10);
+    }
+    // Pattern: "wait X seconds"
+    const waitMatch = /wait\s+(\d+)\s*s/i.exec(message);
+    if (waitMatch?.[1] !== undefined) {
+        return parseInt(waitMatch[1], 10) * 1000;
+    }
+    // For rate limits without explicit retry-after, suggest 1 second
+    if (/rate.?limit/i.test(message) || /too.?many.?requests/i.test(message)) {
+        return 1000;
+    }
+    return null;
+}
+/**
+ * Checks if an error is retryable
+ */
+export function isRetryable(error) {
+    return error.shouldRetry;
+}
+/**
+ * Checks if fallback to another provider should be attempted
+ */
+export function shouldFallback(error) {
+    return error.shouldFallback;
+}
+//# sourceMappingURL=error-classifier.js.map

package/dist/error-classifier.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Provider adapters (CLI-based)
+ *
+ * DESIGN: AutomatosX does NOT manage credentials.
+ * Each provider CLI handles its own authentication:
+ * - claude, gemini, codex: Official CLIs with built-in auth
+ * - qwen: Qwen CLI with DashScope auth
+ * - ax-glm: GLM CLI wrapper (handles ZAI_API_KEY)
+ * - ax-grok: Grok CLI wrapper (handles XAI_API_KEY)
+ */
+export type { MessageRole, Message, CompletionRequest, CompletionResponse, CompletionSuccess, CompletionFailure, TokenUsage, LLMProvider, CLIProviderConfig, ModelConfig, HealthCheckResult, ErrorCategory, ClassifiedError, SpawnResult, SpawnOptions, ParsedOutput, } from './types.js';
+export { createCLIAdapter, createCLIAdapters } from './cli-adapter.js';
+export { spawnCLI, isCommandAvailable, getCommandVersion, buildPromptFromMessages, } from './process-manager.js';
+export { parseOutput, estimateTokenUsage, extractOrEstimateTokenUsage, } from './output-parser.js';
+export { classifyError, classifySpawnResult, isRetryable, shouldFallback, } from './error-classifier.js';
+export { claudeConfig, geminiConfig, codexConfig, qwenConfig, glmConfig, grokConfig, ALL_PROVIDER_CONFIGS, getProviderConfig, getAllProviderIds, } from './providers/index.js';
+export { ProviderRegistry, createProviderRegistry, createEmptyRegistry, } from './registry.js';
+export { ResilientProviderRegistry, createResilientProviderRegistry, type ResilientRegistryConfig, } from './resilient-registry.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,YAAY,EACV,WAAW,EACX,OAAO,EACP,iBAAiB,EACjB,kBAAkB,EAClB,iBAAiB,EACjB,iBAAiB,EACjB,UAAU,EACV,WAAW,EACX,iBAAiB,EACjB,WAAW,EACX,iBAAiB,EACjB,aAAa,EACb,eAAe,EACf,WAAW,EACX,YAAY,EACZ,YAAY,GACb,MAAM,YAAY,CAAC;AAGpB,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAGvE,OAAO,EACL,QAAQ,EACR,kBAAkB,EAClB,iBAAiB,EACjB,uBAAuB,GACxB,MAAM,sBAAsB,CAAC;AAG9B,OAAO,EACL,WAAW,EACX,kBAAkB,EAClB,2BAA2B,GAC5B,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EACL,aAAa,EACb,mBAAmB,EACnB,WAAW,EACX,cAAc,GACf,MAAM,uBAAuB,CAAC;AAG/B,OAAO,EACL,YAAY,EACZ,YAAY,EACZ,WAAW,EACX,UAAU,EACV,SAAS,EACT,UAAU,EACV,oBAAoB,EACpB,iBAAiB,EACjB,iBAAiB,GAClB,MAAM,sBAAsB,CAAC;AAG9B,OAAO,EACL,gBAAgB,EAChB,sBAAsB,EACtB,mBAAmB,GACpB,MAAM,eAAe,CAAC;AAGvB,OAAO,EACL,yBAAyB,EACzB,+BAA+B,EAC/B,KAAK,uBAAuB,GAC7B,MAAM,yBAAyB,CAAC"}

package/dist/index.js

@@ -0,0 +1,25 @@
+/**
+ * Provider adapters (CLI-based)
+ *
+ * DESIGN: AutomatosX does NOT manage credentials.
+ * Each provider CLI handles its own authentication:
+ * - claude, gemini, codex: Official CLIs with built-in auth
+ * - qwen: Qwen CLI with DashScope auth
+ * - ax-glm: GLM CLI wrapper (handles ZAI_API_KEY)
+ * - ax-grok: Grok CLI wrapper (handles XAI_API_KEY)
+ */
+// CLI Adapter
+export { createCLIAdapter, createCLIAdapters } from './cli-adapter.js';
+// Process Manager
+export { spawnCLI, isCommandAvailable, getCommandVersion, buildPromptFromMessages, } from './process-manager.js';
+// Output Parser
+export { parseOutput, estimateTokenUsage, extractOrEstimateTokenUsage, } from './output-parser.js';
+// Error Classifier
+export { classifyError, classifySpawnResult, isRetryable, shouldFallback, } from './error-classifier.js';
+// Provider Configurations
+export { claudeConfig, geminiConfig, codexConfig, qwenConfig, glmConfig, grokConfig, ALL_PROVIDER_CONFIGS, getProviderConfig, getAllProviderIds, } from './providers/index.js';
+// Provider Registry
+export { ProviderRegistry, createProviderRegistry, createEmptyRegistry, } from './registry.js';
+// Resilient Provider Registry
+export { ResilientProviderRegistry, createResilientProviderRegistry, } from './resilient-registry.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAsBH,cAAc;AACd,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAEvE,kBAAkB;AAClB,OAAO,EACL,QAAQ,EACR,kBAAkB,EAClB,iBAAiB,EACjB,uBAAuB,GACxB,MAAM,sBAAsB,CAAC;AAE9B,gBAAgB;AAChB,OAAO,EACL,WAAW,EACX,kBAAkB,EAClB,2BAA2B,GAC5B,MAAM,oBAAoB,CAAC;AAE5B,mBAAmB;AACnB,OAAO,EACL,aAAa,EACb,mBAAmB,EACnB,WAAW,EACX,cAAc,GACf,MAAM,uBAAuB,CAAC;AAE/B,0BAA0B;AAC1B,OAAO,EACL,YAAY,EACZ,YAAY,EACZ,WAAW,EACX,UAAU,EACV,SAAS,EACT,UAAU,EACV,oBAAoB,EACpB,iBAAiB,EACjB,iBAAiB,GAClB,MAAM,sBAAsB,CAAC;AAE9B,oBAAoB;AACpB,OAAO,EACL,gBAAgB,EAChB,sBAAsB,EACtB,mBAAmB,GACpB,MAAM,eAAe,CAAC;AAEvB,8BAA8B;AAC9B,OAAO,EACL,yBAAyB,EACzB,+BAA+B,GAEhC,MAAM,yBAAyB,CAAC"}

package/dist/output-parser.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Output parser for CLI responses
+ *
+ * Handles different output formats:
+ * - json: Single JSON object
+ * - stream-json: JSON Lines (one JSON object per line)
+ * - text: Plain text output
+ */
+import type { ParsedOutput, TokenUsage, CLIProviderConfig } from './types.js';
+/**
+ * Parses CLI output based on the expected format
+ *
+ * @param stdout - Raw stdout from CLI process
+ * @param format - Expected output format
+ * @returns Parsed output with content and optional metadata
+ */
+export declare function parseOutput(stdout: string, format: CLIProviderConfig['outputFormat']): ParsedOutput;
+/**
+ * Estimates token usage from prompt and completion text
+ * Uses approximate ratio of 4 characters per token
+ *
+ * @param prompt - Input prompt text
+ * @param completion - Generated completion text
+ * @returns Estimated token usage
+ */
+export declare function estimateTokenUsage(prompt: string, completion: string): TokenUsage;
+/**
+ * Extracts token usage from CLI response metadata if available
+ * Falls back to estimation if not present
+ *
+ * @param metadata - Parsed metadata from CLI response
+ * @param prompt - Input prompt for estimation fallback
+ * @param completion - Completion text for estimation fallback
+ * @returns Token usage (extracted or estimated)
+ */
+export declare function extractOrEstimateTokenUsage(metadata: Record<string, unknown> | undefined, prompt: string, completion: string): TokenUsage;
+//# sourceMappingURL=output-parser.d.ts.map

package/dist/output-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"output-parser.d.ts","sourceRoot":"","sources":["../src/output-parser.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAW9E;;;;;;GAMG;AACH,wBAAgB,WAAW,CACzB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,iBAAiB,CAAC,cAAc,CAAC,GACxC,YAAY,CAYd;AAkLD;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,UAAU,CAUjF;AAED;;;;;;;;GAQG;AACH,wBAAgB,2BAA2B,CACzC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,EAC7C,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,MAAM,GACjB,UAAU,CA+BZ"}

package/dist/output-parser.js

@@ -0,0 +1,251 @@
+/**
+ * Output parser for CLI responses
+ *
+ * Handles different output formats:
+ * - json: Single JSON object
+ * - stream-json: JSON Lines (one JSON object per line)
+ * - text: Plain text output
+ */
+/**
+ * Strips ANSI escape codes from text
+ * These are terminal control sequences like colors, cursor movement, etc.
+ */
+function stripAnsi(text) {
+    // eslint-disable-next-line no-control-regex
+    return text.replace(/\x1B(?:[@-Z\\-_]|\[[0-?]*[ -/]*[@-~])/g, '');
+}
+/**
+ * Parses CLI output based on the expected format
+ *
+ * @param stdout - Raw stdout from CLI process
+ * @param format - Expected output format
+ * @returns Parsed output with content and optional metadata
+ */
+export function parseOutput(stdout, format) {
+    // Strip ANSI escape codes first
+    const cleaned = stripAnsi(stdout);
+    switch (format) {
+        case 'json':
+            return parseJSON(cleaned);
+        case 'stream-json':
+            return parseStreamJSON(cleaned);
+        case 'text':
+            return parseText(cleaned);
+    }
+}
+/**
+ * Parses a single JSON object from stdout
+ */
+function parseJSON(stdout) {
+    try {
+        const trimmed = stdout.trim();
+        if (trimmed.length === 0) {
+            return { content: '' };
+        }
+        const data = JSON.parse(trimmed);
+        // Try common response fields
+        const content = extractContent(data);
+        return {
+            content,
+            metadata: data,
+        };
+    }
+    catch {
+        // If JSON parsing fails, treat as text
+        return { content: stdout.trim() };
+    }
+}
+/**
+ * Parses JSON Lines format (one JSON object per line)
+ * Used by streaming CLI outputs
+ */
+function parseStreamJSON(stdout) {
+    const lines = stdout.trim().split('\n');
+    const contentChunks = [];
+    let lastMetadata;
+    for (const line of lines) {
+        const trimmedLine = line.trim();
+        if (trimmedLine.length === 0) {
+            continue;
+        }
+        // Skip known informational lines from CLIs
+        if (trimmedLine.startsWith('Reading prompt from stdin')) {
+            continue;
+        }
+        try {
+            const data = JSON.parse(trimmedLine);
+            const chunk = extractContent(data);
+            if (chunk.length > 0) {
+                contentChunks.push(chunk);
+            }
+            // Store metadata from turn.completed for usage info
+            if (data.type === 'turn.completed') {
+                lastMetadata = data;
+            }
+        }
+        catch {
+            // Non-JSON line - skip non-content lines
+            // Only add if it looks like actual content (not CLI progress messages)
+            if (!trimmedLine.includes('...') && trimmedLine.length > 10) {
+                contentChunks.push(trimmedLine);
+            }
+        }
+    }
+    return {
+        content: contentChunks.join(''),
+        metadata: lastMetadata,
+    };
+}
+/**
+ * Parses plain text output
+ */
+function parseText(stdout) {
+    return {
+        content: stdout.trim(),
+    };
+}
+/**
+ * Extracts content from a parsed JSON response
+ * Tries common field names used by different providers
+ */
+function extractContent(data) {
+    // Handle Codex-style item.completed events
+    // {"type":"item.completed","item":{"type":"agent_message","text":"..."}}
+    if (data.type === 'item.completed' && typeof data.item === 'object' && data.item !== null) {
+        const item = data.item;
+        // Only extract agent_message type, not reasoning
+        if (item.type === 'agent_message' && typeof item.text === 'string') {
+            return item.text;
+        }
+        return '';
+    }
+    // Skip non-content events (thread.started, turn.started, turn.completed, etc.)
+    if (data.type === 'thread.started' || data.type === 'turn.started' || data.type === 'turn.completed') {
+        return '';
+    }
+    // Handle ax-glm/ax-grok style: {"role":"assistant","content":"..."}
+    // Only extract assistant messages, skip user messages
+    if (data.role === 'assistant' && typeof data.content === 'string') {
+        return data.content;
+    }
+    if (data.role === 'user') {
+        return ''; // Skip user echo
+    }
+    // Handle ax-glm/ax-grok --json output: {"messages":[{"role":"assistant","content":"..."}]}
+    if (Array.isArray(data.messages)) {
+        const assistantMessages = data.messages
+            .filter((msg) => {
+            if (typeof msg !== 'object' || msg === null)
+                return false;
+            const m = msg;
+            return m.role === 'assistant' && typeof m.content === 'string';
+        })
+            .map((msg) => msg.content);
+        if (assistantMessages.length > 0) {
+            return assistantMessages.join('\n');
+        }
+    }
+    // Common response field names
+    const contentFields = ['content', 'text', 'response', 'message', 'output', 'result'];
+    for (const field of contentFields) {
+        const value = data[field];
+        if (typeof value === 'string') {
+            return value;
+        }
+        // Handle nested content (e.g., { message: { content: "..." } })
+        if (typeof value === 'object' && value !== null) {
+            const nested = value;
+            if (typeof nested.content === 'string') {
+                return nested.content;
+            }
+            if (typeof nested.text === 'string') {
+                return nested.text;
+            }
+        }
+    }
+    // Handle array of content blocks (Anthropic style)
+    if (Array.isArray(data.content)) {
+        const textBlocks = data.content
+            .filter((block) => {
+            if (typeof block !== 'object' || block === null) {
+                return false;
+            }
+            const obj = block;
+            return obj.type === 'text' && typeof obj.text === 'string';
+        })
+            .map((block) => block.text);
+        if (textBlocks.length > 0) {
+            return textBlocks.join('');
+        }
+    }
+    // Handle choices array (OpenAI style)
+    if (Array.isArray(data.choices) && data.choices.length > 0) {
+        const firstChoice = data.choices[0];
+        if (typeof firstChoice.message === 'object' && firstChoice.message !== null) {
+            const message = firstChoice.message;
+            if (typeof message.content === 'string') {
+                return message.content;
+            }
+        }
+        if (typeof firstChoice.text === 'string') {
+            return firstChoice.text;
+        }
+    }
+    return '';
+}
+/**
+ * Estimates token usage from prompt and completion text
+ * Uses approximate ratio of 4 characters per token
+ *
+ * @param prompt - Input prompt text
+ * @param completion - Generated completion text
+ * @returns Estimated token usage
+ */
+export function estimateTokenUsage(prompt, completion) {
+    // Conservative estimate: ~4 characters per token
+    const inputTokens = Math.ceil(prompt.length / 4);
+    const outputTokens = Math.ceil(completion.length / 4);
+    return {
+        inputTokens,
+        outputTokens,
+        totalTokens: inputTokens + outputTokens,
+    };
+}
+/**
+ * Extracts token usage from CLI response metadata if available
+ * Falls back to estimation if not present
+ *
+ * @param metadata - Parsed metadata from CLI response
+ * @param prompt - Input prompt for estimation fallback
+ * @param completion - Completion text for estimation fallback
+ * @returns Token usage (extracted or estimated)
+ */
+export function extractOrEstimateTokenUsage(metadata, prompt, completion) {
+    if (metadata === undefined) {
+        return estimateTokenUsage(prompt, completion);
+    }
+    // Try to extract usage from metadata
+    const usage = metadata.usage;
+    if (usage !== undefined) {
+        const inputTokens = typeof usage.input_tokens === 'number'
+            ? usage.input_tokens
+            : typeof usage.prompt_tokens === 'number'
+                ? usage.prompt_tokens
+                : undefined;
+        const outputTokens = typeof usage.output_tokens === 'number'
+            ? usage.output_tokens
+            : typeof usage.completion_tokens === 'number'
+                ? usage.completion_tokens
+                : undefined;
+        if (inputTokens !== undefined && outputTokens !== undefined) {
+            return {
+                inputTokens,
+                outputTokens,
+                totalTokens: inputTokens + outputTokens,
+            };
+        }
+    }
+    // Fallback to estimation
+    return estimateTokenUsage(prompt, completion);
+}
+//# sourceMappingURL=output-parser.js.map

package/dist/output-parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"output-parser.js","sourceRoot":"","sources":["../src/output-parser.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH;;;GAGG;AACH,SAAS,SAAS,CAAC,IAAY;IAC7B,4CAA4C;IAC5C,OAAO,IAAI,CAAC,OAAO,CAAC,wCAAwC,EAAE,EAAE,CAAC,CAAC;AACpE,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,WAAW,CACzB,MAAc,EACd,MAAyC;IAEzC,gCAAgC;IAChC,MAAM,OAAO,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC;IAElC,QAAQ,MAAM,EAAE,CAAC;QACf,KAAK,MAAM;YACT,OAAO,SAAS,CAAC,OAAO,CAAC,CAAC;QAC5B,KAAK,aAAa;YAChB,OAAO,eAAe,CAAC,OAAO,CAAC,CAAC;QAClC,KAAK,MAAM;YACT,OAAO,SAAS,CAAC,OAAO,CAAC,CAAC;IAC9B,CAAC;AACH,CAAC;AAED;;GAEG;AACH,SAAS,SAAS,CAAC,MAAc;IAC/B,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC;QAC9B,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACzB,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;QACzB,CAAC;QAED,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAA4B,CAAC;QAE5D,6BAA6B;QAC7B,MAAM,OAAO,GAAG,cAAc,CAAC,IAAI,CAAC,CAAC;QAErC,OAAO;YACL,OAAO;YACP,QAAQ,EAAE,IAAI;SACf,CAAC;IACJ,CAAC;IAAC,MAAM,CAAC;QACP,uCAAuC;QACvC,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC;IACpC,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,SAAS,eAAe,CAAC,MAAc;IACrC,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACxC,MAAM,aAAa,GAAa,EAAE,CAAC;IACnC,IAAI,YAAiD,CAAC;IAEtD,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;QAChC,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC7B,SAAS;QACX,CAAC;QAED,2CAA2C;QAC3C,IAAI,WAAW,CAAC,UAAU,CAAC,2BAA2B,CAAC,EAAE,CAAC;YACxD,SAAS;QACX,CAAC;QAED,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,WAAW,CAA4B,CAAC;YAChE,MAAM,KAAK,GAAG,cAAc,CAAC,IAAI,CAAC,CAAC;YACnC,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACrB,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAC5B,CAAC;YACD,oDAAoD;YACpD,IAAI,IAAI,CAAC,IAAI,KAAK,gBAAgB,EAAE,CAAC;gBACnC,YAAY,GAAG,IAAI,CAAC;YACtB,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,yCAAyC;YACzC,uEAAuE;YACvE,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,WAAW,CAAC,MAAM,GAAG,EAAE,EAAE,CAAC;gBAC5D,aAAa,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;YAClC,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO;QACL,OAAO,EAAE,aAAa,CAAC,IAAI,CAAC,EAAE,CAAC;QAC/B,QAAQ,EAAE,YAAY;KACvB,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,SAAS,SAAS,CAAC,MAAc;IAC/B,OAAO;QACL,OAAO,EAAE,MAAM,CAAC,IAAI,EAAE;KACvB,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,SAAS,cAAc,CAAC,IAA6B;IACnD,2CAA2C;IAC3C,yEAAyE;IACzE,IAAI,IAAI,CAAC,IAAI,KAAK,gBAAgB,IAAI,OAAO,IAAI,CAAC,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,IAAI,KAAK,IAAI,EAAE,CAAC;QAC1F,MAAM,IAAI,GAAG,IAAI,CAAC,IAA+B,CAAC;QAClD,iDAAiD;QACjD,IAAI,IAAI,CAAC,IAAI,KAAK,eAAe,IAAI,OAAO,IAAI,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YACnE,OAAO,IAAI,CAAC,IAAI,CAAC;QACnB,CAAC;QACD,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,+EAA+E;IAC/E,IAAI,IAAI,CAAC,IAAI,KAAK,gBAAgB,IAAI,IAAI,CAAC,IAAI,KAAK,cAAc,IAAI,IAAI,CAAC,IAAI,KAAK,gBAAgB,EAAE,CAAC;QACrG,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,oEAAoE;IACpE,sDAAsD;IACtD,IAAI,IAAI,CAAC,IAAI,KAAK,WAAW,IAAI,OAAO,IAAI,CAAC,OAAO,KAAK,QAAQ,EAAE,CAAC;QAClE,OAAO,IAAI,CAAC,OAAO,CAAC;IACtB,CAAC;IACD,IAAI,IAAI,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;QACzB,OAAO,EAAE,CAAC,CAAE,iBAAiB;IAC/B,CAAC;IAED,2FAA2F;IAC3F,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;QACjC,MAAM,iBAAiB,GAAG,IAAI,CAAC,QAAQ;aACpC,MAAM,CAAC,CAAC,GAAG,EAA4C,EAAE;YACxD,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,IAAI;gBAAE,OAAO,KAAK,CAAC;YAC1D,MAAM,CAAC,GAAG,GAA8B,CAAC;YACzC,OAAO,CAAC,CAAC,IAAI,KAAK,WAAW,IAAI,OAAO,CAAC,CAAC,OAAO,KAAK,QAAQ,CAAC;QACjE,CAAC,CAAC;aACD,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAC7B,IAAI,iBAAiB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACjC,OAAO,iBAAiB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACtC,CAAC;IACH,CAAC;IAED,8BAA8B;IAC9B,MAAM,aAAa,GAAG,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC;IAErF,KAAK,MAAM,KAAK,IAAI,aAAa,EAAE,CAAC;QAClC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC;QAC1B,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YAC9B,OAAO,KAAK,CAAC;QACf,CAAC;QACD,gEAAgE;QAChE,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;YAChD,MAAM,MAAM,GAAG,KAAgC,CAAC;YAChD,IAAI,OAAO,MAAM,CAAC,OAAO,KAAK,QAAQ,EAAE,CAAC;gBACvC,OAAO,MAAM,CAAC,OAAO,CAAC;YACxB,CAAC;YACD,IAAI,OAAO,MAAM,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;gBACpC,OAAO,MAAM,CAAC,IAAI,CAAC;YACrB,CAAC;QACH,CAAC;IACH,CAAC;IAED,mDAAmD;IACnD,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;QAChC,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO;aAC5B,MAAM,CAAC,CAAC,KAAK,EAA2C,EAAE;YACzD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;gBAChD,OAAO,KAAK,CAAC;YACf,CAAC;YACD,MAAM,GAAG,GAAG,KAAgC,CAAC;YAC7C,OAAO,GAAG,CAAC,IAAI,KAAK,MAAM,IAAI,OAAO,GAAG,CAAC,IAAI,KAAK,QAAQ,CAAC;QAC7D,CAAC,CAAC;aACD,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC9B,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC1B,OAAO,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAC7B,CAAC;IACH,CAAC;IAED,sCAAsC;IACtC,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC3D,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC,CAA4B,CAAC;QAC/D,IAAI,OAAO,WAAW,CAAC,OAAO,KAAK,QAAQ,IAAI,WAAW,CAAC,OAAO,KAAK,IAAI,EAAE,CAAC;YAC5E,MAAM,OAAO,GAAG,WAAW,CAAC,OAAkC,CAAC;YAC/D,IAAI,OAAO,OAAO,CAAC,OAAO,KAAK,QAAQ,EAAE,CAAC;gBACxC,OAAO,OAAO,CAAC,OAAO,CAAC;YACzB,CAAC;QACH,CAAC;QACD,IAAI,OAAO,WAAW,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YACzC,OAAO,WAAW,CAAC,IAAI,CAAC;QAC1B,CAAC;IACH,CAAC;IAED,OAAO,EAAE,CAAC;AACZ,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,kBAAkB,CAAC,MAAc,EAAE,UAAkB;IACnE,iDAAiD;IACjD,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IACjD,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAEtD,OAAO;QACL,WAAW;QACX,YAAY;QACZ,WAAW,EAAE,WAAW,GAAG,YAAY;KACxC,CAAC;AACJ,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,2BAA2B,CACzC,QAA6C,EAC7C,MAAc,EACd,UAAkB;IAElB,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;QAC3B,OAAO,kBAAkB,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IAChD,CAAC;IAED,qCAAqC;IACrC,MAAM,KAAK,GAAG,QAAQ,CAAC,KAA4C,CAAC;IACpE,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxB,MAAM,WAAW,GAAG,OAAO,KAAK,CAAC,YAAY,KAAK,QAAQ;YACxD,CAAC,CAAC,KAAK,CAAC,YAAY;YACpB,CAAC,CAAC,OAAO,KAAK,CAAC,aAAa,KAAK,QAAQ;gBACvC,CAAC,CAAC,KAAK,CAAC,aAAa;gBACrB,CAAC,CAAC,SAAS,CAAC;QAEhB,MAAM,YAAY,GAAG,OAAO,KAAK,CAAC,aAAa,KAAK,QAAQ;YAC1D,CAAC,CAAC,KAAK,CAAC,aAAa;YACrB,CAAC,CAAC,OAAO,KAAK,CAAC,iBAAiB,KAAK,QAAQ;gBAC3C,CAAC,CAAC,KAAK,CAAC,iBAAiB;gBACzB,CAAC,CAAC,SAAS,CAAC;QAEhB,IAAI,WAAW,KAAK,SAAS,IAAI,YAAY,KAAK,SAAS,EAAE,CAAC;YAC5D,OAAO;gBACL,WAAW;gBACX,YAAY;gBACZ,WAAW,EAAE,WAAW,GAAG,YAAY;aACxC,CAAC;QACJ,CAAC;IACH,CAAC;IAED,yBAAyB;IACzB,OAAO,kBAAkB,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;AAChD,CAAC"}

package/dist/process-manager.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Process manager for spawning CLI processes
+ *
+ * Handles:
+ * - Process spawning with stdin/stdout
+ * - Timeout handling with graceful shutdown
+ * - Command availability checking
+ */
+import type { SpawnOptions, SpawnResult } from './types.js';
+/**
+ * Spawns a CLI process and returns the result
+ *
+ * @param options - Spawn options including command, args, stdin, env, timeout
+ * @returns Promise resolving to spawn result with stdout, stderr, exitCode
+ */
+export declare function spawnCLI(options: SpawnOptions): Promise<SpawnResult>;
+/**
+ * Checks if a CLI command is available on the system PATH
+ *
+ * @param command - The command to check
+ * @returns Promise resolving to true if available, false otherwise
+ */
+export declare function isCommandAvailable(command: string): Promise<boolean>;
+/**
+ * Gets the version of a CLI command if available
+ *
+ * @param command - The command to check
+ * @param versionFlag - The flag to get version (default: --version)
+ * @returns Promise resolving to version string or undefined
+ */
+export declare function getCommandVersion(command: string, versionFlag?: string): Promise<string | undefined>;
+/**
+ * Builds a prompt string from messages for CLI input
+ *
+ * @param messages - Array of messages
+ * @param systemPrompt - Optional system prompt
+ * @returns Formatted prompt string
+ */
+export declare function buildPromptFromMessages(messages: {
+    role: string;
+    content: string;
+}[], systemPrompt?: string): string;
+//# sourceMappingURL=process-manager.d.ts.map

package/dist/process-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"process-manager.d.ts","sourceRoot":"","sources":["../src/process-manager.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAsB5D;;;;;GAKG;AACH,wBAAsB,QAAQ,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,WAAW,CAAC,CAqF1E;AAED;;;;;GAKG;AACH,wBAAsB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAc1E;AAED;;;;;;GAMG;AACH,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,MAAM,EACf,WAAW,SAAc,GACxB,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAmB7B;AAED;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,EAAE,EAC7C,YAAY,CAAC,EAAE,MAAM,GACpB,MAAM,CAqBR"}