codelantern-agent-cli 1.0.1 → 1.0.2

package/dist/index.d.ts

@@ -273,6 +273,25 @@ declare class ProviderRegistry {
     listModels(providerId?: string, refresh?: boolean): Promise<ProviderModelInfo[]>;
 }
 
+type ModelCategory = 'coding' | 'chat' | 'specialized';
+interface ModelClassification {
+    id: string;
+    category: ModelCategory;
+    specializedType?: string;
+    isRecommendedForCoding: boolean;
+    capabilities: ModelCapabilities;
+    warning?: string;
+}
+/**
+ * Inspects a model ID and optional capability hints to classify whether it is
+ * suitable for interactive autonomous coding (tools + chat), chat-only, or specialized.
+ */
+declare function classifyModel(modelId: string, capabilities?: Partial<ModelCapabilities>, description?: string): ModelClassification;
+/**
+ * Returns a list of known compatible coding models for the given provider.
+ */
+declare function getRecommendedCodingModels(providerId: string, availableModels?: ProviderModelInfo[]): string[];
+
 declare class GeminiProvider implements IProviderAdapter {
     id: string;
     name: string;
@@ -348,6 +367,11 @@ declare function createLinkedAbortController(parentSignal?: AbortSignal, timeout
     controller: AbortController;
     cleanup: () => void;
 };
+/**
+ * Race a promise against a timeout duration and optional AbortSignal.
+ * Cleans up timer and listeners unconditionally in finally.
+ */
+declare function withTimeoutRace<T>(promise: Promise<T>, timeoutMs: number, operationName: string, signal?: AbortSignal, onTimeout?: () => void): Promise<T>;
 declare function wrapStreamWithFirstTokenTimeout<T>(stream: AsyncIterable<T>, firstTokenTimeoutMs: number, provider: string, model: string, signal?: AbortSignal, onFirstToken?: (latencyMs: number) => void): AsyncGenerator<T, void, unknown>;
 
 declare class TimeoutError extends Error {
@@ -404,20 +428,82 @@ interface CommandValidationResult {
 }
 declare function validateCommand(command: string): CommandValidationResult;
 
+interface INativeCredentialStore {
+    name: string;
+    isAvailable(): boolean;
+    get(service: string, account: string): string | null;
+    set(service: string, account: string, secret: string): boolean;
+    delete(service: string, account: string): boolean;
+}
+declare class NativeCredentialStore {
+    private static instance;
+    private primaryStore;
+    private fallbackStore;
+    private constructor();
+    static getInstance(): NativeCredentialStore;
+    getStoreName(): string;
+    isAvailable(): boolean;
+    get(service: string, account: string): string | null;
+    set(service: string, account: string, secret: string): boolean;
+    delete(service: string, account: string): boolean;
+}
+
+declare const SERVICE_NAME = "codelantern";
+declare function getLegacyCredentialsFilePath(): string;
+/**
+ * Returns user-friendly name of the active OS credential store
+ */
+declare function getStoreName(): string;
 declare function encryptSecret(plainText: string): string;
 declare function decryptSecret(encryptedPayload: string): string | null;
 declare function maskApiKey(key: string): string;
-declare function getApiKey(provider: string): {
+interface KeyResult {
     key: string | null;
     source?: 'env' | 'store';
-};
+    sourceDescription?: string;
+}
+interface MigrationReport {
+    attempted: boolean;
+    migratedProviders: string[];
+    failedProviders: string[];
+}
+/**
+ * Automatically migrates existing credentials from legacy ~/.codelantern/credentials.json
+ * into the native OS credential store (Keychain on macOS, Windows Credential Manager on Windows).
+ * Verifies each key's retrieval before removing from the legacy vault to ensure crash safety.
+ */
+declare function migrateLegacyCredentials(force?: boolean): MigrationReport;
+/**
+ * Retrieves the API key for a given provider with explicit precedence:
+ * 1. Environment variables (GEMINI_API_KEY, etc.)
+ * 2. Native OS credential store (macOS Keychain, Windows Credential Manager)
+ */
+declare function getApiKey(provider: string): KeyResult;
+/**
+ * Securely saves an API key to the native OS credential store.
+ * Verifies that the saved key can be retrieved before returning.
+ */
 declare function setApiKey(provider: string, apiKey: string): void;
+/**
+ * Removes an API key from the native OS credential store.
+ */
 declare function removeApiKey(provider: string): boolean;
-declare function listConfiguredKeys(): Record<string, {
+interface ConfiguredKeyInfo {
     configured: boolean;
     source?: 'env' | 'store';
+    sourceDescription: string;
     maskedKey: string;
-}>;
+}
+/**
+ * Lists all configured provider keys, indicating source and masked representation.
+ * Never exposes plaintext keys.
+ */
+declare function listConfiguredKeys(): Record<string, ConfiguredKeyInfo>;
+/**
+ * Prompts the user interactively with a masked prompt ('*').
+ * Keystrokes are not echoed in plaintext to the terminal.
+ */
+declare function promptMaskedApiKey(query: string): Promise<string>;
 
 declare class ApprovalEngine {
     private yolo;
@@ -543,4 +629,4 @@ declare class LanternAgent {
     }>;
 }
 
-export { ALLOWED_CONFIG_KEYS, type AgentContext, AnthropicProvider, type ApprovalDecision, ApprovalEngine, type ApprovalRequest, AuthenticationError, CancelledError, type CommandValidationResult, type ConfigKey, type ConversationTurn, DEFAULT_CONFIG, type FileAttachment, FirstTokenTimeoutError, GeminiProvider, type IProviderAdapter, LanternAgent, LanternProviderError, McpManager, type McpServerConfig, MissingApiKeyError, type ModelCapabilities, ModelNotFoundError, type ModelRole, OpenAIProvider, OpenRouterProvider, LanternAgent as OrbitAgent, type OrbitConfig, type OrbitSession, type OrbitTool, type PathValidationResult, type ProjectInstructions, type ProviderConfig, type ProviderModelInfo, ProviderRegistry, type ProviderStreamParams, type ProviderStreamResult, type ProviderTestResult, type ProviderType, RateLimitError, type Skill, SkillManager, type StreamCallbacks, TimeoutError, type TimingDiagnostics, type TokenUsage, type ToolCallItem, type ToolDefinition, type ToolExecutionContext, type ToolExecutionResult, ToolRegistry, type ToolResultItem, addMcpServer, compactTurns, createLinkedAbortController, createNewSession, decryptSecret, deleteSession, encryptSecret, exportSessionMarkdown, formatErrorMessage, formatNewFilePreview, formatTerminalDiff, generateSessionId, getApiKey, getConfigFilePath, getConfigValue, getLanternHomeDir, getMcpConfigPath, getSessionsDir, isSecretFile, listConfiguredKeys, listSessions, loadAttachment, loadAttachments, loadConfig, loadMcpConfig, loadProjectInstructions, loadSession, maskApiKey, removeApiKey, removeMcpServer, sanitizeSecrets, saveConfig, saveMcpConfig, saveSession, setApiKey, setConfigValue, shouldCompact, toggleMcpServer, validateCommand, validateConfigValue, validateWorkspacePath, wrapStreamWithFirstTokenTimeout };
+export { ALLOWED_CONFIG_KEYS, type AgentContext, AnthropicProvider, type ApprovalDecision, ApprovalEngine, type ApprovalRequest, AuthenticationError, CancelledError, type CommandValidationResult, type ConfigKey, type ConfiguredKeyInfo, type ConversationTurn, DEFAULT_CONFIG, type FileAttachment, FirstTokenTimeoutError, GeminiProvider, type INativeCredentialStore, type IProviderAdapter, type KeyResult, LanternAgent, LanternProviderError, McpManager, type McpServerConfig, type MigrationReport, MissingApiKeyError, type ModelCapabilities, type ModelCategory, type ModelClassification, ModelNotFoundError, type ModelRole, NativeCredentialStore, OpenAIProvider, OpenRouterProvider, LanternAgent as OrbitAgent, type OrbitConfig, type OrbitSession, type OrbitTool, type PathValidationResult, type ProjectInstructions, type ProviderConfig, type ProviderModelInfo, ProviderRegistry, type ProviderStreamParams, type ProviderStreamResult, type ProviderTestResult, type ProviderType, RateLimitError, SERVICE_NAME, type Skill, SkillManager, type StreamCallbacks, TimeoutError, type TimingDiagnostics, type TokenUsage, type ToolCallItem, type ToolDefinition, type ToolExecutionContext, type ToolExecutionResult, ToolRegistry, type ToolResultItem, addMcpServer, classifyModel, compactTurns, createLinkedAbortController, createNewSession, decryptSecret, deleteSession, encryptSecret, exportSessionMarkdown, formatErrorMessage, formatNewFilePreview, formatTerminalDiff, generateSessionId, getApiKey, getConfigFilePath, getConfigValue, getLanternHomeDir, getLegacyCredentialsFilePath, getMcpConfigPath, getRecommendedCodingModels, getSessionsDir, getStoreName, isSecretFile, listConfiguredKeys, listSessions, loadAttachment, loadAttachments, loadConfig, loadMcpConfig, loadProjectInstructions, loadSession, maskApiKey, migrateLegacyCredentials, promptMaskedApiKey, removeApiKey, removeMcpServer, sanitizeSecrets, saveConfig, saveMcpConfig, saveSession, setApiKey, setConfigValue, shouldCompact, toggleMcpServer, validateCommand, validateConfigValue, validateWorkspacePath, withTimeoutRace, wrapStreamWithFirstTokenTimeout };

package/dist/index.js

@@ -13,14 +13,17 @@ import {
   McpManager,
   MissingApiKeyError,
   ModelNotFoundError,
+  NativeCredentialStore,
   OpenAIProvider,
   OpenRouterProvider,
   ProviderRegistry,
   RateLimitError,
+  SERVICE_NAME,
   SkillManager,
   TimeoutError,
   ToolRegistry,
   addMcpServer,
+  classifyModel,
   compactTurns,
   createLinkedAbortController,
   createNewSession,
@@ -36,8 +39,11 @@ import {
   getConfigFilePath,
   getConfigValue,
   getLanternHomeDir,
+  getLegacyCredentialsFilePath,
   getMcpConfigPath,
+  getRecommendedCodingModels,
   getSessionsDir,
+  getStoreName,
   isSecretFile,
   listConfiguredKeys,
   listSessions,
@@ -48,6 +54,8 @@ import {
   loadProjectInstructions,
   loadSession,
   maskApiKey,
+  migrateLegacyCredentials,
+  promptMaskedApiKey,
   removeApiKey,
   removeMcpServer,
   sanitizeSecrets,
@@ -61,8 +69,9 @@ import {
   validateCommand,
   validateConfigValue,
   validateWorkspacePath,
+  withTimeoutRace,
   wrapStreamWithFirstTokenTimeout
-} from "./chunk-PELESOCI.js";
+} from "./chunk-45FEFNMM.js";
 export {
   ALLOWED_CONFIG_KEYS,
   AnthropicProvider,
@@ -77,15 +86,18 @@ export {
   McpManager,
   MissingApiKeyError,
   ModelNotFoundError,
+  NativeCredentialStore,
   OpenAIProvider,
   OpenRouterProvider,
   LanternAgent as OrbitAgent,
   ProviderRegistry,
   RateLimitError,
+  SERVICE_NAME,
   SkillManager,
   TimeoutError,
   ToolRegistry,
   addMcpServer,
+  classifyModel,
   compactTurns,
   createLinkedAbortController,
   createNewSession,
@@ -101,8 +113,11 @@ export {
   getConfigFilePath,
   getConfigValue,
   getLanternHomeDir,
+  getLegacyCredentialsFilePath,
   getMcpConfigPath,
+  getRecommendedCodingModels,
   getSessionsDir,
+  getStoreName,
   isSecretFile,
   listConfiguredKeys,
   listSessions,
@@ -113,6 +128,8 @@ export {
   loadProjectInstructions,
   loadSession,
   maskApiKey,
+  migrateLegacyCredentials,
+  promptMaskedApiKey,
   removeApiKey,
   removeMcpServer,
   sanitizeSecrets,
@@ -126,6 +143,7 @@ export {
   validateCommand,
   validateConfigValue,
   validateWorkspacePath,
+  withTimeoutRace,
   wrapStreamWithFirstTokenTimeout
 };
 //# sourceMappingURL=index.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "codelantern-agent-cli",
-  "version": "1.0.1",
+  "version": "1.0.2",
   "description": "Code Lantern CLI - Personal AI coding assistant for the terminal with multi-provider and skills support",
   "type": "module",
   "bin": {
@@ -41,6 +41,7 @@
   "dependencies": {
     "@google/genai": "^2.32.0",
     "@modelcontextprotocol/sdk": "^1.32.2",
+    "@napi-rs/keyring": "^2.1.2",
     "commander": "^14.0.3",
     "diff": "^8.0.4",
     "fast-glob": "^3.3.3",