codelantern-agent-cli 0.0.0-stage → 1.0.1

package/dist/index.d.ts

@@ -0,0 +1,546 @@
+/**
+ * Core type definitions for Code Lantern CLI
+ */
+type ModelRole = 'user' | 'model' | 'tool' | 'system';
+interface FileAttachment {
+    path: string;
+    name: string;
+    mimeType: string;
+    size: number;
+    base64Data?: string;
+    textContent?: string;
+}
+interface ToolCallItem {
+    id: string;
+    name: string;
+    args: Record<string, unknown>;
+}
+interface ToolResultItem {
+    callId: string;
+    name: string;
+    result: unknown;
+    error?: string;
+}
+interface ConversationTurn {
+    role: ModelRole;
+    text?: string;
+    toolCalls?: ToolCallItem[];
+    toolResults?: ToolResultItem[];
+    attachments?: FileAttachment[];
+    timestamp: string;
+}
+interface TokenUsage {
+    promptTokens: number;
+    candidatesTokens: number;
+    totalTokens: number;
+}
+interface OrbitSession {
+    id: string;
+    title: string;
+    createdAt: string;
+    updatedAt: string;
+    workspace: string;
+    provider?: string;
+    model: string;
+    turns: ConversationTurn[];
+    totalUsage: TokenUsage;
+    activeSkills?: string[];
+}
+interface McpServerConfig {
+    command: string;
+    args?: string[];
+    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;
+    maxOutputTokens?: number;
+    yolo: boolean;
+    theme: 'default' | 'ocean' | 'minimal';
+    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';
+    summary: string;
+    details?: {
+        path?: string;
+        before?: string;
+        after?: string;
+        diff?: string;
+        command?: string;
+    };
+}
+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;
+    description: string;
+    parameters: {
+        type: 'object';
+        properties: Record<string, {
+            type: string;
+            description: string;
+            enum?: string[];
+            items?: {
+                type: string;
+            };
+        }>;
+        required?: string[];
+    };
+    readOnly?: boolean;
+}
+interface ToolExecutionContext {
+    workspace: string;
+    yolo: boolean;
+    planMode: boolean;
+    requestApproval: (request: ApprovalRequest) => Promise<boolean>;
+    signal?: AbortSignal;
+}
+interface ToolExecutionResult {
+    success: boolean;
+    output: string;
+    error?: string;
+    metadata?: Record<string, unknown>;
+}
+
+declare function getLanternHomeDir(): string;
+declare function getConfigFilePath(): string;
+declare function loadConfig(): OrbitConfig;
+declare function saveConfig(config: OrbitConfig): void;
+declare function setConfigValue(key: string, value: unknown): {
+    success: boolean;
+    error?: string;
+    updatedConfig?: OrbitConfig;
+};
+declare function getConfigValue<K extends keyof OrbitConfig>(key: K): OrbitConfig[K];
+
+declare const DEFAULT_CONFIG: OrbitConfig;
+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;
+    error?: string;
+    parsedValue?: unknown;
+};
+
+interface ProjectInstructions {
+    found: boolean;
+    filePath?: string;
+    content?: string;
+}
+declare function loadProjectInstructions(workspaceDir: string): ProjectInstructions;
+
+interface StreamCallbacks {
+    onChunk?: (text: string) => void;
+    onToolCalls?: (toolCalls: ToolCallItem[]) => void;
+    onUsage?: (usage: TokenUsage) => void;
+    onStateChange?: (state: string) => void;
+}
+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;
+    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 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 AuthenticationError extends Error {
+    constructor(message?: string);
+}
+declare class ModelNotFoundError extends Error {
+    constructor(model: string, provider: string);
+}
+declare class LanternProviderError extends Error {
+    statusCode?: number;
+    provider?: string;
+    constructor(message: string, statusCode?: number, provider?: string);
+}
+declare function formatErrorMessage(err: unknown): string;
+
+declare function loadAttachment(filePath: string): FileAttachment;
+declare function loadAttachments(filePaths?: string[]): FileAttachment[];
+
+interface PathValidationResult {
+    allowed: boolean;
+    resolvedPath: string;
+    relativePath: string;
+    reason?: string;
+}
+declare function validateWorkspacePath(targetPath: string, workspaceDir: string, allowedExternalPaths?: string[]): PathValidationResult;
+
+declare function isSecretFile(filePath: string): boolean;
+declare function sanitizeSecrets(text: string): string;
+
+interface CommandValidationResult {
+    allowed: boolean;
+    reason?: string;
+    isHighRisk?: boolean;
+}
+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;
+    constructor(options: {
+        yolo?: boolean;
+        planMode?: boolean;
+    });
+    isYolo(): boolean;
+    setYolo(val: boolean): void;
+    isPlanMode(): boolean;
+    requestApproval(req: ApprovalRequest): Promise<boolean>;
+    private promptUser;
+}
+
+declare function formatTerminalDiff(filePath: string, oldContent: string, newContent: string, contextLines?: number): string;
+declare function formatNewFilePreview(filePath: string, content: string, maxPreviewLines?: number): string;
+
+declare function getSessionsDir(): string;
+declare function generateSessionId(): string;
+declare function createNewSession(workspace: string, model: string, initialTitle?: string): OrbitSession;
+declare function saveSession(session: OrbitSession): void;
+declare function loadSession(sessionId: string): OrbitSession | null;
+declare function listSessions(): Array<{
+    id: string;
+    title: string;
+    updatedAt: string;
+    turnCount: number;
+    workspace: string;
+    model: string;
+}>;
+declare function deleteSession(sessionId: string): boolean;
+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>;
+}
+
+declare class ToolRegistry {
+    private tools;
+    constructor();
+    private registerBuiltins;
+    registerTool(tool: OrbitTool): void;
+    registerTools(tools: OrbitTool[]): void;
+    getTool(name: string): OrbitTool | undefined;
+    getDefinitions(planMode?: boolean): ToolDefinition[];
+    executeTool(name: string, args: Record<string, unknown>, context: ToolExecutionContext): Promise<ToolExecutionResult>;
+}
+
+declare class McpManager {
+    private connections;
+    initialize(): Promise<OrbitTool[]>;
+    connectServer(serverName: string, config: McpServerConfig): Promise<OrbitTool[]>;
+    disconnectServer(serverName: string): Promise<void>;
+    closeAll(): Promise<void>;
+}
+
+declare function getMcpConfigPath(): string;
+declare function loadMcpConfig(): Record<string, McpServerConfig>;
+declare function saveMcpConfig(servers: Record<string, McpServerConfig>): void;
+declare function addMcpServer(name: string, config: McpServerConfig): void;
+declare function removeMcpServer(name: string): boolean;
+declare function toggleMcpServer(name: string, disabled: boolean): boolean;
+
+declare class LanternAgent {
+    private providerRegistry;
+    private tools;
+    private mcpManager;
+    private skillManager;
+    private approvalEngine;
+    private spinner;
+    constructor();
+    getProviderRegistry(): ProviderRegistry;
+    getSkillManager(): SkillManager;
+    initMcp(): Promise<void>;
+    shutdown(): Promise<void>;
+    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, 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

@@ -0,0 +1,131 @@
+#!/usr/bin/env node
+import {
+  ALLOWED_CONFIG_KEYS,
+  AnthropicProvider,
+  ApprovalEngine,
+  AuthenticationError,
+  CancelledError,
+  DEFAULT_CONFIG,
+  FirstTokenTimeoutError,
+  GeminiProvider,
+  LanternAgent,
+  LanternProviderError,
+  McpManager,
+  MissingApiKeyError,
+  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,
+  loadConfig,
+  loadMcpConfig,
+  loadProjectInstructions,
+  loadSession,
+  maskApiKey,
+  removeApiKey,
+  removeMcpServer,
+  sanitizeSecrets,
+  saveConfig,
+  saveMcpConfig,
+  saveSession,
+  setApiKey,
+  setConfigValue,
+  shouldCompact,
+  toggleMcpServer,
+  validateCommand,
+  validateConfigValue,
+  validateWorkspacePath,
+  wrapStreamWithFirstTokenTimeout
+} from "./chunk-PELESOCI.js";
+export {
+  ALLOWED_CONFIG_KEYS,
+  AnthropicProvider,
+  ApprovalEngine,
+  AuthenticationError,
+  CancelledError,
+  DEFAULT_CONFIG,
+  FirstTokenTimeoutError,
+  GeminiProvider,
+  LanternAgent,
+  LanternProviderError,
+  McpManager,
+  MissingApiKeyError,
+  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,
+  loadConfig,
+  loadMcpConfig,
+  loadProjectInstructions,
+  loadSession,
+  maskApiKey,
+  removeApiKey,
+  removeMcpServer,
+  sanitizeSecrets,
+  saveConfig,
+  saveMcpConfig,
+  saveSession,
+  setApiKey,
+  setConfigValue,
+  shouldCompact,
+  toggleMcpServer,
+  validateCommand,
+  validateConfigValue,
+  validateWorkspacePath,
+  wrapStreamWithFirstTokenTimeout
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}