@trishchuk/codex-mcp-tool 1.2.0 → 1.4.0

package/dist/utils/commandExecutor.js.map

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

package/dist/utils/errorTypes.d.ts

@@ -0,0 +1,74 @@
+/**
+ * Structured Error Types for Codex MCP Tool
+ * Provides typed error handling with 8 categories for better debugging and user feedback
+ */
+/**
+ * Error categories for classification
+ */
+export declare enum ErrorCategory {
+    CLI_NOT_FOUND = "CLI_NOT_FOUND",
+    AUTHENTICATION = "AUTHENTICATION",
+    RATE_LIMIT = "RATE_LIMIT",
+    TIMEOUT = "TIMEOUT",
+    SANDBOX = "SANDBOX",
+    NETWORK = "NETWORK",
+    SESSION = "SESSION",
+    UNKNOWN = "UNKNOWN"
+}
+/**
+ * User-friendly error messages by category
+ */
+export declare const ERROR_MESSAGES: Record<ErrorCategory, {
+    title: string;
+    description: string;
+}>;
+/**
+ * Solutions/suggestions by error category
+ */
+export declare const ERROR_SOLUTIONS: Record<ErrorCategory, string[]>;
+/**
+ * Custom error class with category and structured data
+ */
+export declare class CodexError extends Error {
+    readonly category: ErrorCategory;
+    readonly originalError?: Error;
+    readonly context?: Record<string, unknown>;
+    constructor(category: ErrorCategory, message?: string, originalError?: Error, context?: Record<string, unknown>);
+    /**
+     * Get user-friendly error title
+     */
+    get title(): string;
+    /**
+     * Get solutions/suggestions for this error
+     */
+    get solutions(): string[];
+    /**
+     * Format error for display
+     */
+    toUserFriendlyString(): string;
+    /**
+     * Format as markdown
+     */
+    toMarkdown(): string;
+}
+/**
+ * Classify error message into category
+ */
+export declare function classifyError(errorMessage: string): ErrorCategory;
+/**
+ * Create CodexError from generic error
+ */
+export declare function createCodexError(error: Error | string, context?: Record<string, unknown>): CodexError;
+/**
+ * Format any error for user-friendly display
+ */
+export declare function formatErrorForUser(error: Error | string | CodexError): string;
+/**
+ * Check if error is retryable
+ */
+export declare function isRetryableError(error: CodexError | ErrorCategory): boolean;
+/**
+ * Get retry delay based on error category (in milliseconds)
+ */
+export declare function getRetryDelay(error: CodexError | ErrorCategory, attempt?: number): number;
+//# sourceMappingURL=errorTypes.d.ts.map

package/dist/utils/errorTypes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errorTypes.d.ts","sourceRoot":"","sources":["../../src/utils/errorTypes.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;GAEG;AACH,oBAAY,aAAa;IACvB,aAAa,kBAAkB;IAC/B,cAAc,mBAAmB;IACjC,UAAU,eAAe;IACzB,OAAO,YAAY;IACnB,OAAO,YAAY;IACnB,OAAO,YAAY;IACnB,OAAO,YAAY;IACnB,OAAO,YAAY;CACpB;AAED;;GAEG;AACH,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,aAAa,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,CAiCxF,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,aAAa,EAAE,MAAM,EAAE,CA2C3D,CAAC;AAEF;;GAEG;AACH,qBAAa,UAAW,SAAQ,KAAK;IACnC,SAAgB,QAAQ,EAAE,aAAa,CAAC;IACxC,SAAgB,aAAa,CAAC,EAAE,KAAK,CAAC;IACtC,SAAgB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;gBAGhD,QAAQ,EAAE,aAAa,EACvB,OAAO,CAAC,EAAE,MAAM,EAChB,aAAa,CAAC,EAAE,KAAK,EACrB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAUnC;;OAEG;IACH,IAAI,KAAK,IAAI,MAAM,CAElB;IAED;;OAEG;IACH,IAAI,SAAS,IAAI,MAAM,EAAE,CAExB;IAED;;OAEG;IACH,oBAAoB,IAAI,MAAM;IAW9B;;OAEG;IACH,UAAU,IAAI,MAAM;CAgBrB;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,YAAY,EAAE,MAAM,GAAG,aAAa,CAuEjE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,KAAK,GAAG,MAAM,EACrB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAChC,UAAU,CAMZ;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,GAAG,UAAU,GAAG,MAAM,CAO7E;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,UAAU,GAAG,aAAa,GAAG,OAAO,CAU3E;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,UAAU,GAAG,aAAa,EAAE,OAAO,GAAE,MAAU,GAAG,MAAM,CAmB5F"}

package/dist/utils/errorTypes.js

@@ -0,0 +1,268 @@
+/**
+ * Structured Error Types for Codex MCP Tool
+ * Provides typed error handling with 8 categories for better debugging and user feedback
+ */
+/**
+ * Error categories for classification
+ */
+export var ErrorCategory;
+(function (ErrorCategory) {
+    ErrorCategory["CLI_NOT_FOUND"] = "CLI_NOT_FOUND";
+    ErrorCategory["AUTHENTICATION"] = "AUTHENTICATION";
+    ErrorCategory["RATE_LIMIT"] = "RATE_LIMIT";
+    ErrorCategory["TIMEOUT"] = "TIMEOUT";
+    ErrorCategory["SANDBOX"] = "SANDBOX";
+    ErrorCategory["NETWORK"] = "NETWORK";
+    ErrorCategory["SESSION"] = "SESSION";
+    ErrorCategory["UNKNOWN"] = "UNKNOWN";
+})(ErrorCategory || (ErrorCategory = {}));
+/**
+ * User-friendly error messages by category
+ */
+export const ERROR_MESSAGES = {
+    [ErrorCategory.CLI_NOT_FOUND]: {
+        title: 'Codex CLI Not Found',
+        description: 'Codex CLI is not installed or not in PATH.',
+    },
+    [ErrorCategory.AUTHENTICATION]: {
+        title: 'Authentication Failed',
+        description: 'API key is invalid or authentication is required.',
+    },
+    [ErrorCategory.RATE_LIMIT]: {
+        title: 'Rate Limit Exceeded',
+        description: 'Too many requests. Please wait and try again.',
+    },
+    [ErrorCategory.TIMEOUT]: {
+        title: 'Request Timeout',
+        description: 'Operation took longer than expected.',
+    },
+    [ErrorCategory.SANDBOX]: {
+        title: 'Sandbox Permission Error',
+        description: 'Operation blocked by sandbox restrictions.',
+    },
+    [ErrorCategory.NETWORK]: {
+        title: 'Network Error',
+        description: 'Failed to connect to API server.',
+    },
+    [ErrorCategory.SESSION]: {
+        title: 'Session Error',
+        description: 'Session is invalid, expired, or not found.',
+    },
+    [ErrorCategory.UNKNOWN]: {
+        title: 'Unknown Error',
+        description: 'An unexpected error occurred.',
+    },
+};
+/**
+ * Solutions/suggestions by error category
+ */
+export const ERROR_SOLUTIONS = {
+    [ErrorCategory.CLI_NOT_FOUND]: [
+        'Install Codex CLI: `npm install -g @openai/codex`',
+        'Verify installation: `codex --version`',
+        'Check PATH environment variable',
+    ],
+    [ErrorCategory.AUTHENTICATION]: [
+        'Run `codex login` to authenticate',
+        'Set `OPENAI_API_KEY` environment variable',
+        'Verify API key has Codex access in OpenAI dashboard',
+    ],
+    [ErrorCategory.RATE_LIMIT]: [
+        'Wait a few minutes before retrying',
+        'Check usage quotas in OpenAI dashboard',
+        'Consider using a less powerful model',
+    ],
+    [ErrorCategory.TIMEOUT]: [
+        'Increase timeout: `timeout: 300000` (5 minutes)',
+        'Simplify request or break into smaller parts',
+        'Check network connectivity',
+    ],
+    [ErrorCategory.SANDBOX]: [
+        'Use `sandboxMode: "workspace-write"` for file operations',
+        'Use `approval: "on-request"` for interactive approval',
+        'Use `fullAuto: true` for automated operations',
+    ],
+    [ErrorCategory.NETWORK]: [
+        'Check internet connection',
+        'Verify firewall/proxy settings',
+        'Try again later - API may be experiencing issues',
+    ],
+    [ErrorCategory.SESSION]: [
+        'Session may have expired (default TTL: 24 hours)',
+        'Use `list-sessions` to check active sessions',
+        'Create new session by omitting `sessionId`',
+        'Use `resetSession: true` to start fresh',
+    ],
+    [ErrorCategory.UNKNOWN]: [
+        'Check Codex CLI: `codex --version`',
+        'Run `codex login` to verify authentication',
+        'Try simpler query to isolate the issue',
+        'Use `health` tool to diagnose',
+    ],
+};
+/**
+ * Custom error class with category and structured data
+ */
+export class CodexError extends Error {
+    category;
+    originalError;
+    context;
+    constructor(category, message, originalError, context) {
+        const errorInfo = ERROR_MESSAGES[category];
+        super(message || errorInfo.description);
+        this.name = 'CodexError';
+        this.category = category;
+        this.originalError = originalError;
+        this.context = context;
+    }
+    /**
+     * Get user-friendly error title
+     */
+    get title() {
+        return ERROR_MESSAGES[this.category].title;
+    }
+    /**
+     * Get solutions/suggestions for this error
+     */
+    get solutions() {
+        return ERROR_SOLUTIONS[this.category];
+    }
+    /**
+     * Format error for display
+     */
+    toUserFriendlyString() {
+        const lines = [];
+        lines.push(`**${this.title}**: ${this.message}`);
+        lines.push('');
+        lines.push('**Solutions:**');
+        for (const solution of this.solutions) {
+            lines.push(`- ${solution}`);
+        }
+        return lines.join('\n');
+    }
+    /**
+     * Format as markdown
+     */
+    toMarkdown() {
+        const emoji = this.category === ErrorCategory.UNKNOWN ? '?' : '';
+        let output = `## ${emoji} ${this.title}\n\n`;
+        output += `${this.message}\n\n`;
+        output += `### Recommended Actions\n\n`;
+        for (const solution of this.solutions) {
+            output += `- ${solution}\n`;
+        }
+        if (this.context) {
+            output += `\n### Context\n\n`;
+            output += '```json\n';
+            output += JSON.stringify(this.context, null, 2);
+            output += '\n```\n';
+        }
+        return output;
+    }
+}
+/**
+ * Classify error message into category
+ */
+export function classifyError(errorMessage) {
+    const message = errorMessage.toLowerCase();
+    // CLI not found
+    if (message.includes('command not found') ||
+        message.includes('not found') ||
+        message.includes('enoent')) {
+        return ErrorCategory.CLI_NOT_FOUND;
+    }
+    // Authentication
+    if (message.includes('authentication') ||
+        message.includes('unauthorized') ||
+        message.includes('api key') ||
+        message.includes('401')) {
+        return ErrorCategory.AUTHENTICATION;
+    }
+    // Rate limiting
+    if (message.includes('rate limit') ||
+        message.includes('quota') ||
+        message.includes('too many requests') ||
+        message.includes('429')) {
+        return ErrorCategory.RATE_LIMIT;
+    }
+    // Timeout
+    if (message.includes('timeout') ||
+        message.includes('timed out') ||
+        message.includes('etimedout')) {
+        return ErrorCategory.TIMEOUT;
+    }
+    // Sandbox/Permission
+    if (message.includes('sandbox') ||
+        message.includes('permission') ||
+        message.includes('denied') ||
+        message.includes('access')) {
+        return ErrorCategory.SANDBOX;
+    }
+    // Network
+    if (message.includes('network') ||
+        message.includes('connect') ||
+        message.includes('econnrefused') ||
+        message.includes('enotfound')) {
+        return ErrorCategory.NETWORK;
+    }
+    // Session
+    if (message.includes('session') ||
+        message.includes('expired') ||
+        message.includes('conversation id')) {
+        return ErrorCategory.SESSION;
+    }
+    return ErrorCategory.UNKNOWN;
+}
+/**
+ * Create CodexError from generic error
+ */
+export function createCodexError(error, context) {
+    const message = error instanceof Error ? error.message : error;
+    const category = classifyError(message);
+    const originalError = error instanceof Error ? error : undefined;
+    return new CodexError(category, message, originalError, context);
+}
+/**
+ * Format any error for user-friendly display
+ */
+export function formatErrorForUser(error) {
+    if (error instanceof CodexError) {
+        return error.toUserFriendlyString();
+    }
+    const codexError = createCodexError(error);
+    return codexError.toUserFriendlyString();
+}
+/**
+ * Check if error is retryable
+ */
+export function isRetryableError(error) {
+    const category = error instanceof CodexError ? error.category : error;
+    const retryableCategories = [
+        ErrorCategory.RATE_LIMIT,
+        ErrorCategory.TIMEOUT,
+        ErrorCategory.NETWORK,
+    ];
+    return retryableCategories.includes(category);
+}
+/**
+ * Get retry delay based on error category (in milliseconds)
+ */
+export function getRetryDelay(error, attempt = 1) {
+    const category = error instanceof CodexError ? error.category : error;
+    const baseDelays = {
+        [ErrorCategory.RATE_LIMIT]: 60000, // 1 minute
+        [ErrorCategory.TIMEOUT]: 5000, // 5 seconds
+        [ErrorCategory.NETWORK]: 10000, // 10 seconds
+        [ErrorCategory.CLI_NOT_FOUND]: 0,
+        [ErrorCategory.AUTHENTICATION]: 0,
+        [ErrorCategory.SANDBOX]: 0,
+        [ErrorCategory.SESSION]: 0,
+        [ErrorCategory.UNKNOWN]: 5000,
+    };
+    const baseDelay = baseDelays[category];
+    // Exponential backoff with jitter
+    const delay = baseDelay * Math.pow(2, attempt - 1);
+    const jitter = Math.random() * 1000;
+    return Math.min(delay + jitter, 300000); // Max 5 minutes
+}
+//# sourceMappingURL=errorTypes.js.map

package/dist/utils/errorTypes.js.map

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

package/dist/utils/modelDetection.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Model availability detection and fallback chain
+ * Ensures compatibility with different Codex CLI versions and user access levels
+ */
+export interface ModelInfo {
+    name: string;
+    available: boolean;
+    isDefault: boolean;
+    priority: number;
+}
+/**
+ * Check if a specific model is available via Codex CLI
+ *
+ * This function performs a real availability check by attempting to execute
+ * a minimal test prompt with the specified model. Results are cached for 5 minutes
+ * to reduce unnecessary CLI calls.
+ *
+ * @param modelName Model identifier to check (e.g., 'gpt-5.1-codex-max')
+ * @param bypassCache If true, ignores cache and forces fresh check
+ * @returns Promise<boolean> True if model is available and working
+ */
+export declare function isModelAvailable(modelName: string, bypassCache?: boolean): Promise<boolean>;
+/**
+ * Get the best available default model using fallback chain
+ * @returns Promise<string> The best available model name
+ */
+export declare function getDefaultModel(): Promise<string>;
+/**
+ * Validate if a user-specified model name is valid
+ * @param modelName User-provided model name
+ * @returns boolean True if model name exists in MODELS constant
+ */
+export declare function isValidModel(modelName: string): boolean;
+/**
+ * Get model name with fallback to default
+ * @param requestedModel User-requested model (optional)
+ * @returns Promise<string> Model name to use
+ */
+export declare function getModelWithFallback(requestedModel?: string): Promise<string>;
+/**
+ * Get all available models (for future use in model listing)
+ * @returns Promise<string[]> Array of available model names
+ */
+export declare function getAvailableModels(): Promise<string[]>;
+//# sourceMappingURL=modelDetection.d.ts.map

package/dist/utils/modelDetection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"modelDetection.d.ts","sourceRoot":"","sources":["../../src/utils/modelDetection.ts"],"names":[],"mappings":"AAIA;;;GAGG;AAEH,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,OAAO,CAAC;IACnB,SAAS,EAAE,OAAO,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAsBD;;;;;;;;;;GAUG;AACH,wBAAsB,gBAAgB,CACpC,SAAS,EAAE,MAAM,EACjB,WAAW,GAAE,OAAe,GAC3B,OAAO,CAAC,OAAO,CAAC,CAwDlB;AAED;;;GAGG;AACH,wBAAsB,eAAe,IAAI,OAAO,CAAC,MAAM,CAAC,CAqBvD;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAGvD;AAED;;;;GAIG;AACH,wBAAsB,oBAAoB,CAAC,cAAc,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAoBnF;AAED;;;GAGG;AACH,wBAAsB,kBAAkB,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC,CAgB5D"}

package/dist/utils/modelDetection.js

@@ -0,0 +1,148 @@
+import { MODELS } from '../constants.js';
+import { Logger } from './logger.js';
+import { executeCommand } from './commandExecutor.js';
+const modelAvailabilityCache = new Map();
+const CACHE_TTL_MS = 5 * 60 * 1000; // 5 minutes
+/**
+ * Priority-ordered fallback chain for default model selection
+ */
+const DEFAULT_MODEL_FALLBACK = [
+    MODELS.GPT5_1_CODEX_MAX, // Highest priority: Latest frontier model
+    MODELS.GPT5_CODEX, // Fallback: Previous default
+    MODELS.GPT5, // Ultimate fallback: Base GPT-5
+];
+/**
+ * Check if a specific model is available via Codex CLI
+ *
+ * This function performs a real availability check by attempting to execute
+ * a minimal test prompt with the specified model. Results are cached for 5 minutes
+ * to reduce unnecessary CLI calls.
+ *
+ * @param modelName Model identifier to check (e.g., 'gpt-5.1-codex-max')
+ * @param bypassCache If true, ignores cache and forces fresh check
+ * @returns Promise<boolean> True if model is available and working
+ */
+export async function isModelAvailable(modelName, bypassCache = false) {
+    // Check cache first (unless bypassed)
+    if (!bypassCache) {
+        const cached = modelAvailabilityCache.get(modelName);
+        if (cached && Date.now() - cached.timestamp < CACHE_TTL_MS) {
+            Logger.debug(`Using cached availability for model ${modelName}: ${cached.available}`);
+            return cached.available;
+        }
+    }
+    try {
+        // Strategy 1: Try to execute a minimal test prompt with the model
+        // This is the most reliable way to check if model is truly available
+        Logger.debug(`Testing model availability: ${modelName}`);
+        try {
+            // Attempt a very quick test with the model (5 second timeout)
+            await executeCommand('codex', ['exec', '-m', modelName, 'echo test'], undefined, 5000);
+            Logger.debug(`Model ${modelName} is available (test execution succeeded)`);
+            // Cache positive result
+            modelAvailabilityCache.set(modelName, {
+                available: true,
+                timestamp: Date.now(),
+            });
+            return true;
+        }
+        catch (testError) {
+            // If test execution failed, check if Codex CLI itself is working
+            Logger.debug(`Model test failed for ${modelName}, checking Codex CLI availability`);
+            // Strategy 2: Fallback - check if Codex CLI is installed at all
+            await executeCommand('codex', ['--version'], undefined, 3000);
+            // If we reach here, Codex CLI works but model might not be available
+            // This could mean: model doesn't exist, user doesn't have access, or model name is wrong
+            Logger.warn(`Model ${modelName} test execution failed but Codex CLI is working. Model may not be available or accessible.`);
+            // Cache negative result (shorter TTL for potentially transient failures)
+            modelAvailabilityCache.set(modelName, {
+                available: false,
+                timestamp: Date.now(),
+            });
+            return false;
+        }
+    }
+    catch (error) {
+        // Complete failure - Codex CLI is not working at all
+        Logger.warn(`Codex CLI availability check failed for ${modelName}:`, error);
+        // Don't cache complete CLI failures as they might be transient
+        return false;
+    }
+}
+/**
+ * Get the best available default model using fallback chain
+ * @returns Promise<string> The best available model name
+ */
+export async function getDefaultModel() {
+    Logger.log('Detecting best available default model...');
+    // Try each model in priority order
+    for (const modelName of DEFAULT_MODEL_FALLBACK) {
+        try {
+            const available = await isModelAvailable(modelName);
+            if (available) {
+                Logger.log(`Selected default model: ${modelName}`);
+                return modelName;
+            }
+        }
+        catch (error) {
+            Logger.warn(`Failed to check model ${modelName}:`, error);
+            continue;
+        }
+    }
+    // Ultimate fallback if all checks fail
+    Logger.warn(`All default models unavailable, falling back to ${MODELS.GPT5_CODEX}`);
+    return MODELS.GPT5_CODEX;
+}
+/**
+ * Validate if a user-specified model name is valid
+ * @param modelName User-provided model name
+ * @returns boolean True if model name exists in MODELS constant
+ */
+export function isValidModel(modelName) {
+    const validModels = Object.values(MODELS);
+    return validModels.includes(modelName);
+}
+/**
+ * Get model name with fallback to default
+ * @param requestedModel User-requested model (optional)
+ * @returns Promise<string> Model name to use
+ */
+export async function getModelWithFallback(requestedModel) {
+    // If no model requested, use default
+    if (!requestedModel) {
+        return await getDefaultModel();
+    }
+    // Validate requested model
+    if (!isValidModel(requestedModel)) {
+        Logger.warn(`Invalid model "${requestedModel}", falling back to default`);
+        return await getDefaultModel();
+    }
+    // Check if requested model is available
+    const available = await isModelAvailable(requestedModel);
+    if (!available) {
+        Logger.warn(`Model "${requestedModel}" not available, falling back to default`);
+        return await getDefaultModel();
+    }
+    return requestedModel;
+}
+/**
+ * Get all available models (for future use in model listing)
+ * @returns Promise<string[]> Array of available model names
+ */
+export async function getAvailableModels() {
+    const availableModels = [];
+    for (const modelName of Object.values(MODELS)) {
+        try {
+            const available = await isModelAvailable(modelName);
+            if (available) {
+                availableModels.push(modelName);
+            }
+        }
+        catch (error) {
+            // Skip unavailable models
+            continue;
+        }
+    }
+    return availableModels;
+}
+//# sourceMappingURL=modelDetection.js.map

package/dist/utils/modelDetection.js.map

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

package/dist/utils/sessionStorage.d.ts

@@ -0,0 +1,79 @@
+/**
+ * Session data structure
+ */
+export interface SessionData {
+    sessionId: string;
+    workspaceId: string;
+    codexConversationId?: string;
+    lastPrompt: string;
+    lastResponse: string;
+    model?: string;
+    workingDir?: string;
+    createdAt: number;
+    updatedAt: number;
+}
+/**
+ * Generate workspace ID using MD5 hash
+ * Format: repo:head:path -> 12-char hex
+ */
+export declare function generateWorkspaceId(workingDir: string): string;
+/**
+ * Generate unique session ID
+ */
+export declare function generateSessionId(): string;
+/**
+ * Save or update a session
+ */
+export declare function saveSession(data: Partial<SessionData> & {
+    sessionId: string;
+}): SessionData;
+/**
+ * Get session by ID
+ */
+export declare function getSession(sessionId: string): SessionData | null;
+/**
+ * Get session by workspace ID (returns most recent)
+ */
+export declare function getSessionByWorkspace(workspaceId: string): SessionData | null;
+/**
+ * Get or create session for a workspace
+ *
+ * When sessionId is provided: returns existing session or creates new with that ID
+ * When sessionId is NOT provided: returns workspace session or creates new with generated ID
+ */
+export declare function getOrCreateSession(workingDir: string, sessionId?: string): SessionData;
+/**
+ * Update session with Codex conversation ID (for native resume)
+ */
+export declare function setCodexConversationId(sessionId: string, conversationId: string): void;
+/**
+ * Get Codex conversation ID for resume
+ */
+export declare function getCodexConversationId(sessionId: string): string | undefined;
+/**
+ * List all active sessions
+ */
+export declare function listSessions(): SessionData[];
+/**
+ * Delete a session
+ */
+export declare function deleteSession(sessionId: string): boolean;
+/**
+ * Clear all sessions
+ */
+export declare function clearAllSessions(): void;
+/**
+ * Get session statistics
+ */
+export declare function getSessionStats(): {
+    total: number;
+    withConversationId: number;
+    maxSessions: number;
+    ttlMs: number;
+};
+/**
+ * Parse Codex conversation ID from stderr output
+ * Pattern: "conversation id: abc123" or "Conversation ID: abc-123-def"
+ */
+export declare function parseConversationIdFromOutput(output: string): string | null;
+//# sourceMappingURL=sessionStorage.d.ts.map