codelantern-agent-cli 1.0.0 → 1.0.1

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 /**
- * Core type definitions for Orbit CLI
+ * Core type definitions for Code Lantern CLI
  */
 type ModelRole = 'user' | 'model' | 'tool' | 'system';
 interface FileAttachment {
@@ -40,9 +40,11 @@ interface OrbitSession {
     createdAt: string;
     updatedAt: string;
     workspace: string;
+    provider?: string;
     model: string;
     turns: ConversationTurn[];
     totalUsage: TokenUsage;
+    activeSkills?: string[];
 }
 interface McpServerConfig {
     command: string;
@@ -50,7 +52,56 @@ interface McpServerConfig {
     env?: Record<string, string>;
     disabled?: boolean;
 }
+type ProviderType = 'gemini' | 'openai' | 'anthropic' | 'openrouter' | 'custom';
+interface ProviderConfig {
+    id: string;
+    name: string;
+    type: ProviderType;
+    baseUrl?: string;
+    apiKey?: string;
+    defaultModel?: string;
+    headers?: Record<string, string>;
+    disabled?: boolean;
+}
+interface ModelCapabilities {
+    streaming: boolean;
+    tools: boolean;
+    images: boolean;
+    reasoning: boolean;
+    contextWindow?: number;
+}
+interface ProviderModelInfo {
+    id: string;
+    name: string;
+    provider: string;
+    description?: string;
+    contextWindow?: number;
+    capabilities: ModelCapabilities;
+    pricing?: {
+        promptPer1k?: number;
+        completionPer1k?: number;
+    };
+}
+interface TimingDiagnostics {
+    providerInitMs?: number;
+    connectMs?: number;
+    ttftMs?: number;
+    streamMs?: number;
+    totalMs: number;
+    toolExecutionMs: Record<string, number>;
+}
+interface Skill {
+    name: string;
+    description: string;
+    path: string;
+    source: 'project' | 'user';
+    enabled: boolean;
+    content: string;
+    references?: string[];
+    tags?: string[];
+}
 interface OrbitConfig {
+    activeProvider: string;
     defaultModel: string;
     maxSteps: number;
     temperature: number;
@@ -60,6 +111,11 @@ interface OrbitConfig {
     autoCompactThreshold: number;
     mcpServers?: Record<string, McpServerConfig>;
     timeoutMs: number;
+    firstTokenTimeoutMs: number;
+    showTiming: boolean;
+    lowLatency: boolean;
+    activeSkills: string[];
+    providers?: Record<string, ProviderConfig>;
 }
 interface ApprovalRequest {
     type: 'file_edit' | 'file_write' | 'command';
@@ -75,12 +131,20 @@ interface ApprovalRequest {
 type ApprovalDecision = 'allow' | 'deny' | 'yolo_all';
 interface AgentContext {
     workspace: string;
+    provider: string;
     model: string;
     yolo: boolean;
     planMode: boolean;
     jsonOutput: boolean;
     maxSteps: number;
+    timeoutMs: number;
+    firstTokenTimeoutMs: number;
+    showTiming: boolean;
+    lowLatency: boolean;
+    activeSkills?: string[];
     attachments?: FileAttachment[];
+    signal?: AbortSignal;
+    onStateChange?: (state: string) => void;
 }
 interface ToolDefinition {
     name: string;
@@ -104,6 +168,7 @@ interface ToolExecutionContext {
     yolo: boolean;
     planMode: boolean;
     requestApproval: (request: ApprovalRequest) => Promise<boolean>;
+    signal?: AbortSignal;
 }
 interface ToolExecutionResult {
     success: boolean;
@@ -124,7 +189,7 @@ declare function setConfigValue(key: string, value: unknown): {
 declare function getConfigValue<K extends keyof OrbitConfig>(key: K): OrbitConfig[K];
 
 declare const DEFAULT_CONFIG: OrbitConfig;
-declare const ALLOWED_CONFIG_KEYS: readonly ["defaultModel", "maxSteps", "temperature", "maxOutputTokens", "yolo", "theme", "autoCompactThreshold", "timeoutMs"];
+declare const ALLOWED_CONFIG_KEYS: readonly ["activeProvider", "defaultModel", "maxSteps", "temperature", "maxOutputTokens", "yolo", "theme", "autoCompactThreshold", "timeoutMs", "firstTokenTimeoutMs", "showTiming", "lowLatency", "activeSkills"];
 type ConfigKey = (typeof ALLOWED_CONFIG_KEYS)[number];
 declare function validateConfigValue(key: string, value: unknown): {
     valid: boolean;
@@ -143,36 +208,178 @@ interface StreamCallbacks {
     onChunk?: (text: string) => void;
     onToolCalls?: (toolCalls: ToolCallItem[]) => void;
     onUsage?: (usage: TokenUsage) => void;
+    onStateChange?: (state: string) => void;
 }
-declare class GeminiProvider {
-    private client;
-    private apiKey;
-    constructor(apiKey?: string);
+interface ProviderStreamParams {
+    model: string;
+    systemInstruction: string;
+    history: ConversationTurn[];
+    tools: ToolDefinition[];
+    callbacks: StreamCallbacks;
+    signal?: AbortSignal;
+    temperature?: number;
+    maxOutputTokens?: number;
+    timeoutMs?: number;
+    firstTokenTimeoutMs?: number;
+    lowLatency?: boolean;
+    enableSearchGrounding?: boolean;
+}
+interface ProviderStreamResult {
+    text: string;
+    toolCalls: ToolCallItem[];
+    usage: TokenUsage;
+    timing: TimingDiagnostics;
+}
+interface ProviderTestResult {
+    success: boolean;
+    latencyMs: number;
+    error?: string;
+    modelsCount?: number;
+    resolvedModel?: string;
+}
+interface IProviderAdapter {
+    id: string;
+    name: string;
+    displayName: string;
+    defaultModel: string;
     isConfigured(): boolean;
+    getApiKey(): string | null;
     getMaskedKey(): string;
-    private ensureClient;
-    streamGenerate(modelId: string, systemInstruction: string, history: ConversationTurn[], tools: ToolDefinition[], callbacks: StreamCallbacks, options?: {
-        temperature?: number;
-        maxOutputTokens?: number;
-        enableSearchGrounding?: boolean;
-    }): Promise<{
-        text: string;
-        toolCalls: ToolCallItem[];
-        usage: TokenUsage;
+    streamGenerate(params: ProviderStreamParams): Promise<ProviderStreamResult>;
+    listModels(refresh?: boolean): Promise<ProviderModelInfo[]>;
+    testConnection(): Promise<ProviderTestResult>;
+    getCapabilities(modelId: string): ModelCapabilities;
+}
+
+declare class ProviderRegistry {
+    private providers;
+    constructor();
+    private registerBuiltins;
+    private loadCustomProviders;
+    getProvider(id?: string): IProviderAdapter;
+    hasProvider(id: string): boolean;
+    listProviders(): Array<{
+        id: string;
+        name: string;
+        displayName: string;
+        isConfigured: boolean;
+        maskedKey: string;
+        defaultModel: string;
+        isActive: boolean;
     }>;
+    registerCustomProvider(cfg: ProviderConfig): void;
+    removeCustomProvider(id: string): boolean;
+    testProvider(id?: string): Promise<ProviderTestResult>;
+    listModels(providerId?: string, refresh?: boolean): Promise<ProviderModelInfo[]>;
+}
+
+declare class GeminiProvider implements IProviderAdapter {
+    id: string;
+    name: string;
+    displayName: string;
+    defaultModel: string;
+    private cachedModels;
+    isConfigured(): boolean;
+    getApiKey(): string | null;
+    getMaskedKey(): string;
+    private getClient;
+    getCapabilities(modelId: string): ModelCapabilities;
+    testConnection(): Promise<ProviderTestResult>;
+    listModels(refresh?: boolean): Promise<ProviderModelInfo[]>;
+    streamGenerate(params: ProviderStreamParams): Promise<ProviderStreamResult>;
     private convertHistoryToContents;
     private convertToolsToDeclarations;
 }
 
-declare class MissingApiKeyError extends Error {
+declare class OpenAIProvider implements IProviderAdapter {
+    id: string;
+    name: string;
+    displayName: string;
+    defaultModel: string;
+    baseUrl: string;
+    customHeaders: Record<string, string>;
+    private cachedModels;
+    constructor(options?: {
+        id?: string;
+        name?: string;
+        displayName?: string;
+        baseUrl?: string;
+        defaultModel?: string;
+        headers?: Record<string, string>;
+    });
+    isConfigured(): boolean;
+    getApiKey(): string | null;
+    getMaskedKey(): string;
+    getCapabilities(modelId: string): ModelCapabilities;
+    testConnection(): Promise<ProviderTestResult>;
+    listModels(refresh?: boolean): Promise<ProviderModelInfo[]>;
+    streamGenerate(params: ProviderStreamParams): Promise<ProviderStreamResult>;
+    private convertHistoryToMessages;
+    private convertTools;
+    private readSSEStream;
+}
+
+declare class AnthropicProvider implements IProviderAdapter {
+    id: string;
+    name: string;
+    displayName: string;
+    defaultModel: string;
+    baseUrl: string;
+    private cachedModels;
+    isConfigured(): boolean;
+    getApiKey(): string | null;
+    getMaskedKey(): string;
+    getCapabilities(modelId: string): ModelCapabilities;
+    testConnection(): Promise<ProviderTestResult>;
+    listModels(refresh?: boolean): Promise<ProviderModelInfo[]>;
+    streamGenerate(params: ProviderStreamParams): Promise<ProviderStreamResult>;
+    private convertHistoryToMessages;
+    private convertTools;
+    private readSSEStream;
+}
+
+declare class OpenRouterProvider extends OpenAIProvider {
     constructor();
+    getCapabilities(modelId: string): ModelCapabilities;
+    listModels(refresh?: boolean): Promise<ProviderModelInfo[]>;
+}
+
+declare function createLinkedAbortController(parentSignal?: AbortSignal, timeoutMs?: number): {
+    controller: AbortController;
+    cleanup: () => void;
+};
+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 {
+    timeoutMs: number;
+    constructor(timeoutMs: number, operation?: string);
+}
+declare class FirstTokenTimeoutError extends Error {
+    timeoutMs: number;
+    provider: string;
+    model: string;
+    constructor(timeoutMs: number, provider: string, model: string);
+}
+declare class CancelledError extends Error {
+    constructor(message?: string);
+}
+declare class MissingApiKeyError extends Error {
+    provider: string;
+    constructor(provider?: string, envVar?: string);
 }
 declare class RateLimitError extends Error {
     constructor(message?: string);
 }
-declare class GeminiProviderError extends Error {
+declare class AuthenticationError extends Error {
+    constructor(message?: string);
+}
+declare class ModelNotFoundError extends Error {
+    constructor(model: string, provider: string);
+}
+declare class LanternProviderError extends Error {
     statusCode?: number;
-    constructor(message: string, statusCode?: number);
+    provider?: string;
+    constructor(message: string, statusCode?: number, provider?: string);
 }
 declare function formatErrorMessage(err: unknown): string;
 
@@ -197,6 +404,21 @@ interface CommandValidationResult {
 }
 declare function validateCommand(command: string): CommandValidationResult;
 
+declare function encryptSecret(plainText: string): string;
+declare function decryptSecret(encryptedPayload: string): string | null;
+declare function maskApiKey(key: string): string;
+declare function getApiKey(provider: string): {
+    key: string | null;
+    source?: 'env' | 'store';
+};
+declare function setApiKey(provider: string, apiKey: string): void;
+declare function removeApiKey(provider: string): boolean;
+declare function listConfiguredKeys(): Record<string, {
+    configured: boolean;
+    source?: 'env' | 'store';
+    maskedKey: string;
+}>;
+
 declare class ApprovalEngine {
     private yolo;
     private planMode;
@@ -233,6 +455,42 @@ declare function exportSessionMarkdown(session: OrbitSession): string;
 declare function shouldCompact(turns: ConversationTurn[], threshold?: number): boolean;
 declare function compactTurns(turns: ConversationTurn[], retainRecentCount?: number): ConversationTurn[];
 
+declare class SkillManager {
+    private userSkillsDir;
+    constructor();
+    getUserSkillsDir(): string;
+    getProjectSkillsDirs(workspace: string): string[];
+    /**
+     * Discovers all available skills from user-level and project-level directories
+     */
+    listSkills(workspace?: string): Skill[];
+    private scanDirectoryForSkills;
+    parseSkillMd(rawContent: string, defaultName: string): {
+        name: string;
+        description: string;
+        content: string;
+    };
+    getSkill(name: string, workspace?: string): Skill | null;
+    enableSkill(name: string): boolean;
+    disableSkill(name: string): boolean;
+    addSkillFromPath(sourcePath: string): {
+        success: boolean;
+        skillName?: string;
+        error?: string;
+    };
+    addSkillFromGit(repoUrl: string): {
+        success: boolean;
+        skillName?: string;
+        error?: string;
+    };
+    removeSkill(name: string): boolean;
+    /**
+     * Matches prompt against available skills by keyword and intent.
+     * Transparent and non-intrusive.
+     */
+    matchSkillsForPrompt(userPrompt: string, workspace?: string): Skill[];
+}
+
 interface OrbitTool {
     definition: ToolDefinition;
     execute: (args: Record<string, any>, context: ToolExecutionContext) => Promise<ToolExecutionResult>;
@@ -264,21 +522,25 @@ declare function addMcpServer(name: string, config: McpServerConfig): void;
 declare function removeMcpServer(name: string): boolean;
 declare function toggleMcpServer(name: string, disabled: boolean): boolean;
 
-declare class OrbitAgent {
-    private provider;
+declare class LanternAgent {
+    private providerRegistry;
     private tools;
     private mcpManager;
+    private skillManager;
     private approvalEngine;
     private spinner;
-    constructor(apiKey?: string);
+    constructor();
+    getProviderRegistry(): ProviderRegistry;
+    getSkillManager(): SkillManager;
     initMcp(): Promise<void>;
     shutdown(): Promise<void>;
-    buildSystemPrompt(workspace: string, planMode?: boolean): string;
+    buildSystemPrompt(workspace: string, planMode?: boolean, activeSkills?: Skill[]): string;
     runTurn(session: OrbitSession, userPrompt: string, context: AgentContext, attachments?: FileAttachment[]): Promise<{
         reply: string;
         toolCount: number;
         usage: TokenUsage;
+        timing: TimingDiagnostics;
     }>;
 }
 
-export { ALLOWED_CONFIG_KEYS, type AgentContext, type ApprovalDecision, ApprovalEngine, type ApprovalRequest, type CommandValidationResult, type ConfigKey, type ConversationTurn, DEFAULT_CONFIG, type FileAttachment, GeminiProvider, GeminiProviderError, McpManager, type McpServerConfig, MissingApiKeyError, type ModelRole, OrbitAgent, type OrbitConfig, type OrbitSession, type OrbitTool, type PathValidationResult, type ProjectInstructions, RateLimitError, type StreamCallbacks, type TokenUsage, type ToolCallItem, type ToolDefinition, type ToolExecutionContext, type ToolExecutionResult, ToolRegistry, type ToolResultItem, addMcpServer, compactTurns, createNewSession, deleteSession, exportSessionMarkdown, formatErrorMessage, formatNewFilePreview, formatTerminalDiff, generateSessionId, getConfigFilePath, getConfigValue, getLanternHomeDir, getMcpConfigPath, getSessionsDir, isSecretFile, listSessions, loadAttachment, loadAttachments, loadConfig, loadMcpConfig, loadProjectInstructions, loadSession, removeMcpServer, sanitizeSecrets, saveConfig, saveMcpConfig, saveSession, setConfigValue, shouldCompact, toggleMcpServer, validateCommand, validateConfigValue, validateWorkspacePath };
+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 };

package/dist/index.js

@@ -1,30 +1,45 @@
 #!/usr/bin/env node
 import {
   ALLOWED_CONFIG_KEYS,
+  AnthropicProvider,
   ApprovalEngine,
+  AuthenticationError,
+  CancelledError,
   DEFAULT_CONFIG,
+  FirstTokenTimeoutError,
   GeminiProvider,
-  GeminiProviderError,
+  LanternAgent,
+  LanternProviderError,
   McpManager,
   MissingApiKeyError,
-  OrbitAgent,
+  ModelNotFoundError,
+  OpenAIProvider,
+  OpenRouterProvider,
+  ProviderRegistry,
   RateLimitError,
+  SkillManager,
+  TimeoutError,
   ToolRegistry,
   addMcpServer,
   compactTurns,
+  createLinkedAbortController,
   createNewSession,
+  decryptSecret,
   deleteSession,
+  encryptSecret,
   exportSessionMarkdown,
   formatErrorMessage,
   formatNewFilePreview,
   formatTerminalDiff,
   generateSessionId,
+  getApiKey,
   getConfigFilePath,
   getConfigValue,
   getLanternHomeDir,
   getMcpConfigPath,
   getSessionsDir,
   isSecretFile,
+  listConfiguredKeys,
   listSessions,
   loadAttachment,
   loadAttachments,
@@ -32,44 +47,64 @@ import {
   loadMcpConfig,
   loadProjectInstructions,
   loadSession,
+  maskApiKey,
+  removeApiKey,
   removeMcpServer,
   sanitizeSecrets,
   saveConfig,
   saveMcpConfig,
   saveSession,
+  setApiKey,
   setConfigValue,
   shouldCompact,
   toggleMcpServer,
   validateCommand,
   validateConfigValue,
-  validateWorkspacePath
-} from "./chunk-Y3PEOLTZ.js";
+  validateWorkspacePath,
+  wrapStreamWithFirstTokenTimeout
+} from "./chunk-PELESOCI.js";
 export {
   ALLOWED_CONFIG_KEYS,
+  AnthropicProvider,
   ApprovalEngine,
+  AuthenticationError,
+  CancelledError,
   DEFAULT_CONFIG,
+  FirstTokenTimeoutError,
   GeminiProvider,
-  GeminiProviderError,
+  LanternAgent,
+  LanternProviderError,
   McpManager,
   MissingApiKeyError,
-  OrbitAgent,
+  ModelNotFoundError,
+  OpenAIProvider,
+  OpenRouterProvider,
+  LanternAgent as OrbitAgent,
+  ProviderRegistry,
   RateLimitError,
+  SkillManager,
+  TimeoutError,
   ToolRegistry,
   addMcpServer,
   compactTurns,
+  createLinkedAbortController,
   createNewSession,
+  decryptSecret,
   deleteSession,
+  encryptSecret,
   exportSessionMarkdown,
   formatErrorMessage,
   formatNewFilePreview,
   formatTerminalDiff,
   generateSessionId,
+  getApiKey,
   getConfigFilePath,
   getConfigValue,
   getLanternHomeDir,
   getMcpConfigPath,
   getSessionsDir,
   isSecretFile,
+  listConfiguredKeys,
   listSessions,
   loadAttachment,
   loadAttachments,
@@ -77,16 +112,20 @@ export {
   loadMcpConfig,
   loadProjectInstructions,
   loadSession,
+  maskApiKey,
+  removeApiKey,
   removeMcpServer,
   sanitizeSecrets,
   saveConfig,
   saveMcpConfig,
   saveSession,
+  setApiKey,
   setConfigValue,
   shouldCompact,
   toggleMcpServer,
   validateCommand,
   validateConfigValue,
-  validateWorkspacePath
+  validateWorkspacePath,
+  wrapStreamWithFirstTokenTimeout
 };
 //# sourceMappingURL=index.js.map

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "codelantern-agent-cli",
-  "version": "1.0.0",
-  "description": "Code Lantern CLI - Personal AI coding assistant for the terminal powered by Google Gemini",
+  "version": "1.0.1",
+  "description": "Code Lantern CLI - Personal AI coding assistant for the terminal with multi-provider and skills support",
   "type": "module",
   "bin": {
     "lantern": "./dist/cli.js"