@nuvin/nuvin-core 1.0.1 → 1.1.1

package/dist/VERSION

@@ -1,4 +1,4 @@
 {
-  "version": "1.0.1",
-  "commit": "d5c55a1"
+  "version": "1.1.1",
+  "commit": "6744c77"
 }

package/dist/index.d.ts

@@ -290,6 +290,7 @@ type Message = {
     tool_calls?: ToolCall[];
     tool_call_id?: string;
     name?: string;
+    usage?: UsageData;
 };
 type MessageResponse = {
     id: string;
@@ -348,15 +349,29 @@ type ToolDefinition = {
 type ToolInvocation = {
     id: string;
     name: string;
-    parameters: Record<string, any>;
+    parameters: Record<string, unknown>;
 };
+declare enum ErrorReason {
+    Aborted = "aborted",
+    Denied = "denied",
+    Timeout = "timeout",
+    NotFound = "not_found",
+    PermissionDenied = "permission_denied",
+    InvalidInput = "invalid_input",
+    NetworkError = "network_error",
+    RateLimit = "rate_limit",
+    ToolNotFound = "tool_not_found",
+    Unknown = "unknown"
+}
 type ToolExecutionResult = {
     id: string;
     name: string;
     status: 'success' | 'error';
     type: 'text' | 'json';
     result: string | object;
-    metadata?: Record<string, unknown>;
+    metadata?: Record<string, unknown> & {
+        errorReason?: ErrorReason;
+    };
     durationMs?: number;
 };
 interface ToolPort {
@@ -439,7 +454,6 @@ declare const AgentEventTypes: {
     readonly AssistantChunk: "assistant_chunk";
     readonly AssistantMessage: "assistant_message";
     readonly StreamFinish: "stream_finish";
-    readonly MemoryAppended: "memory_appended";
     readonly Done: "done";
     readonly Error: "error";
     readonly MCPStderr: "mcp_stderr";
@@ -461,6 +475,7 @@ type AgentEvent = {
     conversationId: string;
     messageId: string;
     toolCalls: ToolCall[];
+    usage?: UsageData;
 } | {
     type: typeof AgentEventTypes.ToolApprovalRequired;
     conversationId: string;
@@ -497,10 +512,6 @@ type AgentEvent = {
     messageId: string;
     finishReason?: string;
     usage?: UsageData;
-} | {
-    type: typeof AgentEventTypes.MemoryAppended;
-    conversationId: string;
-    delta: Message[];
 } | {
     type: typeof AgentEventTypes.Done;
     conversationId: string;
@@ -1088,12 +1099,6 @@ declare class BashTool implements FunctionTool<BashParams, ToolExecutionContext>
     private shellArgs;
 }
 
-declare class EchoLLM implements LLMPort {
-    generateCompletion(params: CompletionParams): Promise<CompletionResult>;
-    private hasTool;
-    private id;
-}
-
 type LogLevel = 'DEBUG' | 'INFO' | 'WARN' | 'ERROR';
 type LogFormat = 'json' | 'structured';
 type PersistOptions = {
@@ -1226,16 +1231,27 @@ declare class AnthropicAISDKLLM {
     }, signal?: AbortSignal): Promise<CompletionResult>;
 }
 
+type ModelConfig = false | true | string | string[] | Array<{
+    id: string;
+    name?: string;
+    [key: string]: unknown;
+}>;
 interface LLMOptions {
     apiKey?: string;
     apiUrl?: string;
     httpLogFile?: string;
     enablePromptCaching?: boolean;
     includeUsage?: boolean;
+    version?: string;
+}
+interface CustomProviderDefinition {
+    type?: 'openai-compat' | 'anthropic';
+    baseUrl?: string;
+    models?: ModelConfig;
 }
-declare function createLLM(providerName: string, options?: LLMOptions): LLMPort;
-declare function getAvailableProviders(): string[];
-declare function supportsGetModels(providerName: string): boolean;
+declare function createLLM(providerName: string, options?: LLMOptions, customProviders?: Record<string, CustomProviderDefinition>): LLMPort;
+declare function getAvailableProviders(customProviders?: Record<string, CustomProviderDefinition>): string[];
+declare function supportsGetModels(providerName: string, customProviders?: Record<string, CustomProviderDefinition>): boolean;
 
 type MCPHttpOptions = {
     type: 'http';
@@ -1326,4 +1342,4 @@ declare function resolveBackspaces(s: string): string;
 declare function stripAnsiAndControls(s: string): string;
 declare function canonicalizeTerminalPaste(raw: string): string;
 
-export { AGENT_CREATOR_SYSTEM_PROMPT, type AgentAwareToolPort, type AgentCatalog, type AgentConfig, type AgentEvent, AgentEventTypes, AgentFilePersistence, AgentManager, AgentManagerCommandRunner, AgentOrchestrator, AgentRegistry, type AgentTemplate, AnthropicAISDKLLM, type AssignParams, BashTool, CompositeToolPort, type Conversation, ConversationContext, type ConversationMetadata, type ConversationSnapshot, ConversationStore, CoreMCPClient, DefaultDelegationPolicy, DefaultDelegationResultFormatter, DefaultDelegationService, DefaultSpecialistAgentFactory, type DelegationService, type DelegationServiceConfig, DelegationServiceFactory, EchoLLM, type FolderTreeOptions, GithubLLM, InMemoryMemory, InMemoryMetadata, JsonFileMemoryPersistence, type LLMConfig, LLMError, type LLMFactory, type LLMOptions, type LLMPort, LLMResolver, type MCPConfig, type MCPServerConfig, MCPToolPort, type MemoryPort, MemoryPortMetadataAdapter, type Message, type MessageContent, type MessageContentPart, type MetadataPort, NoopReminders, type OrchestratorAwareToolPort, PersistedMemory, PersistingConsoleEventPort, RuntimeEnv, type SendMessageOptions, SimpleContextBuilder, SimpleCost, SimpleId, type SpecialistAgentConfig, type SpecialistAgentResult, SystemClock, type ToolApprovalDecision, type ToolCall, type ToolExecutionResult, type ToolPort, ToolRegistry, type UserAttachment, type UserMessagePayload, buildAgentCreationPrompt, buildInjectedSystem, canonicalizeTerminalPaste, createLLM, generateFolderTree, getAvailableProviders, loadMCPConfig, normalizeNewlines, renderTemplate, resolveBackspaces, resolveCarriageReturns, stripAnsiAndControls, supportsGetModels };
+export { AGENT_CREATOR_SYSTEM_PROMPT, type AgentAwareToolPort, type AgentCatalog, type AgentConfig, type AgentEvent, AgentEventTypes, AgentFilePersistence, AgentManager, AgentManagerCommandRunner, AgentOrchestrator, AgentRegistry, type AgentTemplate, AnthropicAISDKLLM, type AssignParams, BashTool, CompositeToolPort, type Conversation, ConversationContext, type ConversationMetadata, type ConversationSnapshot, ConversationStore, CoreMCPClient, DefaultDelegationPolicy, DefaultDelegationResultFormatter, DefaultDelegationService, DefaultSpecialistAgentFactory, type DelegationService, type DelegationServiceConfig, DelegationServiceFactory, ErrorReason, type FolderTreeOptions, GithubLLM, InMemoryMemory, InMemoryMetadata, JsonFileMemoryPersistence, type LLMConfig, LLMError, type LLMFactory, type LLMOptions, type LLMPort, LLMResolver, type MCPConfig, type MCPServerConfig, MCPToolPort, type MemoryPort, MemoryPortMetadataAdapter, type Message, type MessageContent, type MessageContentPart, type MetadataPort, NoopReminders, type OrchestratorAwareToolPort, PersistedMemory, PersistingConsoleEventPort, RuntimeEnv, type SendMessageOptions, SimpleContextBuilder, SimpleCost, SimpleId, type SpecialistAgentConfig, type SpecialistAgentResult, SystemClock, type ToolApprovalDecision, type ToolCall, type ToolExecutionResult, type ToolPort, ToolRegistry, type UserAttachment, type UserMessagePayload, buildAgentCreationPrompt, buildInjectedSystem, canonicalizeTerminalPaste, createLLM, generateFolderTree, getAvailableProviders, loadMCPConfig, normalizeNewlines, renderTemplate, resolveBackspaces, resolveCarriageReturns, stripAnsiAndControls, supportsGetModels };

package/dist/index.js

@@ -1,4 +1,17 @@
 // ports.ts
+var ErrorReason = /* @__PURE__ */ ((ErrorReason2) => {
+  ErrorReason2["Aborted"] = "aborted";
+  ErrorReason2["Denied"] = "denied";
+  ErrorReason2["Timeout"] = "timeout";
+  ErrorReason2["NotFound"] = "not_found";
+  ErrorReason2["PermissionDenied"] = "permission_denied";
+  ErrorReason2["InvalidInput"] = "invalid_input";
+  ErrorReason2["NetworkError"] = "network_error";
+  ErrorReason2["RateLimit"] = "rate_limit";
+  ErrorReason2["ToolNotFound"] = "tool_not_found";
+  ErrorReason2["Unknown"] = "unknown";
+  return ErrorReason2;
+})(ErrorReason || {});
 var MessageRoles = {
   System: "system",
   User: "user",
@@ -14,7 +27,6 @@ var AgentEventTypes = {
   AssistantChunk: "assistant_chunk",
   AssistantMessage: "assistant_message",
   StreamFinish: "stream_finish",
-  MemoryAppended: "memory_appended",
   Done: "done",
   Error: "error",
   MCPStderr: "mcp_stderr",
@@ -161,19 +173,22 @@ var AgentOrchestrator = class {
     const todoTools = ["todo_write", "todo_read"];
     return readOnlyTools.includes(toolName) || todoTools.includes(toolName);
   }
-  async handleToolDenial(denialMessage, conversationId, messageId, accumulatedMessages, turnHistory, originalToolCalls, assistantContent) {
-    accumulatedMessages.push({
-      role: "assistant",
-      content: assistantContent ?? null,
-      tool_calls: originalToolCalls
-    });
-    turnHistory.push({
+  async handleToolDenial(denialMessage, conversationId, messageId, accumulatedMessages, turnHistory, originalToolCalls, assistantContent, usage) {
+    const assistantMsg = {
       id: this.deps.ids.uuid(),
       role: "assistant",
       content: assistantContent ?? null,
       timestamp: this.deps.clock.iso(),
+      tool_calls: originalToolCalls,
+      usage
+    };
+    accumulatedMessages.push({
+      role: "assistant",
+      content: assistantContent ?? null,
       tool_calls: originalToolCalls
     });
+    turnHistory.push(assistantMsg);
+    const toolResultMsgs = [];
     for (const toolCall of originalToolCalls) {
       const toolDenialResult = "Tool execution denied by user";
       accumulatedMessages.push({
@@ -182,23 +197,27 @@ var AgentOrchestrator = class {
         tool_call_id: toolCall.id,
         name: toolCall.function.name
       });
-      turnHistory.push({
+      const toolMsg = {
         id: toolCall.id,
         role: "tool",
         content: toolDenialResult,
         timestamp: this.deps.clock.iso(),
         tool_call_id: toolCall.id,
         name: toolCall.function.name
-      });
+      };
+      turnHistory.push(toolMsg);
+      toolResultMsgs.push(toolMsg);
     }
+    await this.deps.memory.append(conversationId, [assistantMsg, ...toolResultMsgs]);
     await this.deps.events?.emit({
       type: AgentEventTypes.AssistantMessage,
       conversationId,
       messageId,
-      content: denialMessage
+      content: denialMessage,
+      usage: void 0
     });
   }
-  async processToolApproval(toolCalls, conversationId, messageId, accumulatedMessages, turnHistory, assistantContent) {
+  async processToolApproval(toolCalls, conversationId, messageId, accumulatedMessages, turnHistory, assistantContent, usage) {
     if (this.cfg.requireToolApproval === false) {
       return { approvedCalls: toolCalls, wasDenied: false };
     }
@@ -220,7 +239,8 @@ var AgentOrchestrator = class {
         accumulatedMessages,
         turnHistory,
         toolCalls,
-        assistantContent
+        assistantContent,
+        usage
       );
       return { approvedCalls: [], wasDenied: true, denialMessage };
     }
@@ -263,6 +283,7 @@ var AgentOrchestrator = class {
       userDisplay = resolveDisplayText(normalized.text, attachments, normalized.displayText);
       const userTimestamp = this.deps.clock.iso();
       userMessages = [{ id: this.deps.ids.uuid(), role: "user", content: userContent, timestamp: userTimestamp }];
+      await this.deps.memory.append(convo, userMessages);
     }
     if (opts.signal?.aborted) throw new Error("Aborted");
     const toolDefs = this.deps.tools.getToolDefinitions(this.cfg.enabledTools ?? []);
@@ -293,8 +314,10 @@ var AgentOrchestrator = class {
     let result;
     let toolApprovalDenied = false;
     let denialMessage = "";
+    let finalResponseSaved = false;
     try {
       if (opts.stream && typeof this.deps.llm.streamCompletion === "function") {
+        let isFirstChunk = true;
         result = await this.deps.llm.streamCompletion(
           params,
           {
@@ -303,7 +326,8 @@ var AgentOrchestrator = class {
                 streamedAssistantContent += delta;
               } catch {
               }
-              const cleanDelta = delta.replace(/^\n+/, "");
+              const cleanDelta = isFirstChunk ? delta.replace(/^\n+/, "") : delta;
+              isFirstChunk = false;
               const chunkEvent = {
                 type: AgentEventTypes.AssistantChunk,
                 conversationId: convo,
@@ -329,6 +353,28 @@ var AgentOrchestrator = class {
       } else {
         result = await this.deps.llm.generateCompletion(params, opts.signal);
       }
+      if (!result.tool_calls?.length && result.content && !finalResponseSaved) {
+        const content2 = opts.stream ? streamedAssistantContent : result.content;
+        const assistantMsg = {
+          id: msgId,
+          role: "assistant",
+          content: content2,
+          timestamp: this.deps.clock.iso(),
+          usage: result.usage
+        };
+        await this.deps.memory.append(convo, [assistantMsg]);
+        finalResponseSaved = true;
+        if (content2.trim()) {
+          const messageEvent = {
+            type: AgentEventTypes.AssistantMessage,
+            conversationId: convo,
+            messageId: msgId,
+            content: content2,
+            ...result.usage && { usage: result.usage }
+          };
+          await this.deps.events?.emit(messageEvent);
+        }
+      }
       while (result.tool_calls?.length) {
         if (result.content?.trim()) {
           const messageEvent = {
@@ -345,7 +391,8 @@ var AgentOrchestrator = class {
           type: AgentEventTypes.ToolCalls,
           conversationId: convo,
           messageId: msgId,
-          toolCalls: result.tool_calls
+          toolCalls: result.tool_calls,
+          usage: result.usage
         });
         const approvalResult = await this.processToolApproval(
           result.tool_calls,
@@ -353,7 +400,8 @@ var AgentOrchestrator = class {
           msgId,
           accumulatedMessages,
           turnHistory,
-          result.content
+          result.content,
+          result.usage
         );
         if (approvalResult.wasDenied) {
           denialMessage = approvalResult.denialMessage || "";
@@ -375,18 +423,18 @@ var AgentOrchestrator = class {
           opts.signal
         );
         allToolResults.push(...toolResults);
-        accumulatedMessages.push({ role: "assistant", content: result.content ?? null, tool_calls: approvedCalls });
-        turnHistory.push({
+        const assistantMsg = {
           id: this.deps.ids.uuid(),
           role: "assistant",
           content: result.content ?? null,
           timestamp: this.deps.clock.iso(),
-          tool_calls: approvedCalls
-        });
+          tool_calls: approvedCalls,
+          usage: result.usage
+        };
+        const toolResultMsgs = [];
         for (const tr of toolResults) {
           const contentStr = tr.status === "error" ? String(tr.result) : typeof tr.result === "string" ? tr.result : JSON.stringify(tr.result);
-          accumulatedMessages.push({ role: "tool", content: contentStr, tool_call_id: tr.id, name: tr.name });
-          turnHistory.push({
+          toolResultMsgs.push({
             id: tr.id,
             role: "tool",
             content: contentStr,
@@ -401,8 +449,16 @@ var AgentOrchestrator = class {
             result: tr
           });
         }
+        await this.deps.memory.append(convo, [assistantMsg, ...toolResultMsgs]);
+        accumulatedMessages.push({ role: "assistant", content: result.content ?? null, tool_calls: approvedCalls });
+        for (const tr of toolResults) {
+          const contentStr = tr.status === "error" ? String(tr.result) : typeof tr.result === "string" ? tr.result : JSON.stringify(tr.result);
+          accumulatedMessages.push({ role: "tool", content: contentStr, tool_call_id: tr.id, name: tr.name });
+        }
         if (opts.signal?.aborted) throw new Error("Aborted");
+        streamedAssistantContent = "";
         if (opts.stream && typeof this.deps.llm.streamCompletion === "function") {
+          let isFirstChunk = true;
           result = await this.deps.llm.streamCompletion(
             { ...params, messages: accumulatedMessages },
             {
@@ -411,7 +467,8 @@ var AgentOrchestrator = class {
                   streamedAssistantContent += delta;
                 } catch {
                 }
-                const cleanDelta = delta.replace(/^\n+/, "");
+                const cleanDelta = isFirstChunk ? delta.replace(/^\n+/, "") : delta;
+                isFirstChunk = false;
                 const chunkEvent = {
                   type: AgentEventTypes.AssistantChunk,
                   conversationId: convo,
@@ -437,16 +494,32 @@ var AgentOrchestrator = class {
         } else {
           result = await this.deps.llm.generateCompletion({ ...params, messages: accumulatedMessages }, opts.signal);
         }
+        if (!result.tool_calls?.length && result.content && !finalResponseSaved) {
+          const content2 = opts.stream ? streamedAssistantContent : result.content;
+          const assistantMsg2 = {
+            id: msgId,
+            role: "assistant",
+            content: content2,
+            timestamp: this.deps.clock.iso(),
+            usage: result.usage
+          };
+          await this.deps.memory.append(convo, [assistantMsg2]);
+          finalResponseSaved = true;
+          if (content2.trim()) {
+            const messageEvent = {
+              type: AgentEventTypes.AssistantMessage,
+              conversationId: convo,
+              messageId: msgId,
+              content: content2,
+              ...result.usage && { usage: result.usage }
+            };
+            await this.deps.events?.emit(messageEvent);
+          }
+        }
       }
       const t1 = this.deps.clock.now();
       const timestamp = this.deps.clock.iso();
-      const newHistory = [];
-      for (const m of userMessages) newHistory.push(m);
-      for (const m of turnHistory) newHistory.push(m);
-      if (!toolApprovalDenied) {
-        newHistory.push({ id: msgId, role: "assistant", content: result.content, timestamp });
-      }
-      const shouldEmitFinalMessage = result.content?.trim() && !toolApprovalDenied;
+      const shouldEmitFinalMessage = result.content?.trim() && !toolApprovalDenied && !finalResponseSaved;
       if (shouldEmitFinalMessage) {
         const messageEvent = {
           type: AgentEventTypes.AssistantMessage,
@@ -475,8 +548,6 @@ var AgentOrchestrator = class {
           toolCalls: allToolResults.length
         }
       };
-      await this.deps.memory.append(convo, newHistory);
-      await this.deps.events?.emit({ type: AgentEventTypes.MemoryAppended, conversationId: convo, delta: newHistory });
       await this.deps.events?.emit({
         type: AgentEventTypes.Done,
         conversationId: convo,
@@ -486,26 +557,6 @@ var AgentOrchestrator = class {
       });
       return resp;
     } catch (err2) {
-      try {
-        const partial = [];
-        for (const m of userMessages) partial.push(m);
-        for (const m of turnHistory) partial.push(m);
-        const partialAssistant = (streamedAssistantContent || "").trim();
-        const assistantAlreadyRecorded = turnHistory.some((m) => m.role === "assistant");
-        if (partialAssistant && !assistantAlreadyRecorded) {
-          partial.push({
-            id: this.deps.ids.uuid(),
-            role: "assistant",
-            content: partialAssistant,
-            timestamp: this.deps.clock.iso()
-          });
-        }
-        if (partial.length) {
-          await this.deps.memory.append(convo, partial);
-          await this.deps.events?.emit({ type: AgentEventTypes.MemoryAppended, conversationId: convo, delta: partial });
-        }
-      } catch {
-      }
       throw err2;
     }
   }
@@ -1822,8 +1873,9 @@ import * as path3 from "path";
 function ok(result, metadata) {
   return { status: "success", type: "text", result, metadata };
 }
-function err(result, metadata) {
-  return { status: "error", type: "text", result, metadata };
+function err(result, metadata, errorReason) {
+  const finalMetadata = errorReason ? { ...metadata, errorReason } : metadata;
+  return { status: "error", type: "text", result, metadata: finalMetadata };
 }
 
 // tools/FileReadTool.ts
@@ -1842,7 +1894,10 @@ var FileReadTool = class {
   parameters = {
     type: "object",
     properties: {
-      description: { type: "string", description: 'Explanation of what file is being read and why (e.g., "Read package.json to check dependencies")' },
+      description: {
+        type: "string",
+        description: 'Explanation of what file is being read and why (e.g., "Read package.json to check dependencies")'
+      },
       path: { type: "string", description: "Read contents of this file" },
       lineStart: { type: "integer", minimum: 1, description: "Start reading from this line number (1-based)" },
       lineEnd: { type: "integer", minimum: 1, description: "Stop reading at this line number (inclusive)" }
@@ -1883,7 +1938,7 @@ var FileReadTool = class {
         const [lo, hi] = a <= b ? [a, b] : [b, a];
         const numberedLines = lines.slice(lo - 1, hi).map((line, index) => {
           const lineNum = lo + index;
-          return `${lineNum}:${line}`;
+          return `${lineNum}\u2502${line}`;
         });
         const slice = numberedLines.join("\n");
         return ok(slice, {
@@ -2247,15 +2302,15 @@ var BashTool = class {
       return await this.execOnce(p, ctx?.signal);
     } catch (e) {
       if (e instanceof Error && e.name === "AbortError") {
-        return err("Command execution aborted by user");
+        return err("Command execution aborted by user", void 0, "aborted" /* Aborted */);
       }
       const message = e instanceof Error ? e.message : String(e);
-      return err(message);
+      return err(message, void 0, "unknown" /* Unknown */);
     }
   }
   async execOnce(p, signal) {
     if (signal?.aborted) {
-      return err("Command execution aborted by user");
+      return err("Command execution aborted by user", void 0, "aborted" /* Aborted */);
     }
     const { cmd, cwd = process.cwd(), timeoutMs = DEFAULTS.timeoutMs } = p;
     const maxOutputBytes = DEFAULTS.maxOutputBytes;
@@ -2273,7 +2328,7 @@ var BashTool = class {
       });
     } catch (error) {
       if (error instanceof Error && "code" in error && error.code === "ENOENT") {
-        return err(`Shell not found: ${executable}`);
+        return err(`Shell not found: ${executable}`, void 0, "not_found" /* NotFound */);
       }
       throw error;
     }
@@ -2283,8 +2338,10 @@ var BashTool = class {
       }
     });
     let timer = null;
+    let timedOut = false;
     const deadline = new Promise((_, rej) => {
       timer = setTimeout(() => {
+        timedOut = true;
         try {
           child.kill("SIGKILL");
         } catch {
@@ -2342,10 +2399,17 @@ var BashTool = class {
         const partialOutput = output ? `
 Output before abort:
 ${output}` : "";
-        return err(`Command execution aborted by user${partialOutput}`);
+        return err(`Command execution aborted by user${partialOutput}`, { cwd }, "aborted" /* Aborted */);
       }
       if (code !== 0) {
-        return err(output, { code, signal: exitSignal, cwd });
+        const metadata = { code, signal: exitSignal, cwd };
+        if (output.toLowerCase().includes("permission denied")) {
+          return err(output, { ...metadata, errorReason: "permission_denied" /* PermissionDenied */ });
+        }
+        if (output.toLowerCase().includes("command not found") || output.toLowerCase().includes("not found")) {
+          return err(output, { ...metadata, errorReason: "not_found" /* NotFound */ });
+        }
+        return err(output, metadata);
       }
       return ok(output, { code, signal: exitSignal, cwd });
     } catch (e) {
@@ -2358,9 +2422,12 @@ ${output}` : "";
         const partialOutput = output ? `
 Output before abort:
 ${output}` : "";
-        return err(`Command execution aborted by user${partialOutput}`);
+        return err(`Command execution aborted by user${partialOutput}`, { cwd }, "aborted" /* Aborted */);
       }
-      return err(message);
+      if (timedOut) {
+        return err(message, { cwd }, "timeout" /* Timeout */);
+      }
+      return err(message, { cwd }, "unknown" /* Unknown */);
     }
   }
   defaultShell() {
@@ -3382,6 +3449,7 @@ var ToolRegistry = class {
             status: "error",
             type: "text",
             result: "Tool execution aborted by user",
+            metadata: { errorReason: "aborted" /* Aborted */ },
             durationMs: 0
           });
         }
@@ -3397,6 +3465,7 @@ var ToolRegistry = class {
               status: "error",
               type: "text",
               result: "Tool execution aborted by user",
+              metadata: { errorReason: "aborted" /* Aborted */ },
               durationMs: 0
             };
           }
@@ -3410,6 +3479,7 @@ var ToolRegistry = class {
               status: "error",
               type: "text",
               result: `Tool '${c.name}' not found`,
+              metadata: { errorReason: "tool_not_found" /* ToolNotFound */ },
               durationMs: durationMs2
             };
           }
@@ -3642,59 +3712,6 @@ var AgentFilePersistence = class {
   }
 };
 
-// llm-providers/llm-echo.ts
-var EchoLLM = class {
-  async generateCompletion(params) {
-    const last = [...params.messages].reverse().find((m) => m.role === "user");
-    const content = String(last?.content ?? "");
-    const toolCalls = [];
-    if (content.startsWith("!reverse ") && this.hasTool(params, "reverse_text")) {
-      const text = content.slice("!reverse ".length);
-      toolCalls.push({
-        id: this.id("rev"),
-        type: "function",
-        function: { name: "reverse_text", arguments: JSON.stringify({ text }) }
-      });
-    } else if (content.startsWith("!wc ") && this.hasTool(params, "word_count")) {
-      const text = content.slice("!wc ".length);
-      toolCalls.push({
-        id: this.id("wc"),
-        type: "function",
-        function: { name: "word_count", arguments: JSON.stringify({ text }) }
-      });
-    } else if (content.startsWith("!todo ") && this.hasTool(params, "todo_write")) {
-      const payload = content.slice("!todo ".length);
-      let todos;
-      try {
-        todos = JSON.parse(payload);
-      } catch {
-        todos = [];
-      }
-      toolCalls.push({
-        id: this.id("todo"),
-        type: "function",
-        function: { name: "todo_write", arguments: JSON.stringify({ todos }) }
-      });
-    }
-    const sawTool = params.messages.some((m) => m.role === "tool");
-    if (sawTool) {
-      const lastTool = [...params.messages].reverse().find((m) => m.role === "tool");
-      const toolText = typeof lastTool?.content === "string" ? lastTool.content : "";
-      return { content: `Tool result: ${toolText}` };
-    }
-    if (toolCalls.length > 0) {
-      return { content: "", tool_calls: toolCalls };
-    }
-    return { content: `Echo: ${content}` };
-  }
-  hasTool(params, name) {
-    return !!params.tools?.some((t) => t.function.name === name);
-  }
-  id(prefix) {
-    return `${prefix}_${Math.random().toString(36).slice(2, 10)}`;
-  }
-};
-
 // llm-providers/llm-utils.ts
 function mergeChoices(choices) {
   const contentParts = [];
@@ -4456,10 +4473,12 @@ var BaseBearerAuthTransport = class {
   inner;
   apiKey;
   baseUrl;
-  constructor(inner, apiKey, baseUrl) {
+  version;
+  constructor(inner, apiKey, baseUrl, version) {
     this.inner = inner;
     this.apiKey = apiKey;
     this.baseUrl = baseUrl ?? this.getDefaultBaseUrl();
+    this.version = version;
   }
   buildFullUrl(path9) {
     if (path9.startsWith("/")) {
@@ -4473,6 +4492,9 @@ var BaseBearerAuthTransport = class {
     }
     const base = headers ? { ...headers } : {};
     base.Authorization = `Bearer ${this.apiKey}`;
+    if (!base["User-Agent"] && this.version) {
+      base["User-Agent"] = `nuvin-cli/${this.version}`;
+    }
     return base;
   }
   async get(url, headers, signal) {
@@ -4492,8 +4514,8 @@ var BaseBearerAuthTransport = class {
 // transports/simple-bearer-transport.ts
 var SimpleBearerAuthTransport = class extends BaseBearerAuthTransport {
   defaultUrl;
-  constructor(inner, defaultBaseUrl, apiKey, baseUrl) {
-    super(inner, apiKey, baseUrl ?? defaultBaseUrl);
+  constructor(inner, defaultBaseUrl, apiKey, baseUrl, version) {
+    super(inner, apiKey, baseUrl ?? defaultBaseUrl, version);
     this.defaultUrl = defaultBaseUrl;
   }
   getDefaultBaseUrl() {
@@ -4502,8 +4524,8 @@ var SimpleBearerAuthTransport = class extends BaseBearerAuthTransport {
 };
 
 // transports/transport-factory.ts
-function createTransport(_name, inner, defaultBaseUrl, apiKey, baseUrl) {
-  return new SimpleBearerAuthTransport(inner, defaultBaseUrl, apiKey, baseUrl);
+function createTransport(inner, defaultBaseUrl, apiKey, baseUrl, version) {
+  return new SimpleBearerAuthTransport(inner, defaultBaseUrl, apiKey, baseUrl, version);
 }
 
 // llm-providers/llm-github.ts
@@ -4980,9 +5002,8 @@ var llm_provider_config_default = {
   providers: [
     {
       name: "deepinfra",
-      className: "DeepInfraLLM",
+      type: "openai-compat",
       baseUrl: "https://api.deepinfra.com/v1/openai",
-      transportName: "deepinfra",
       features: {
         promptCaching: false,
         getModels: true
@@ -4990,9 +5011,8 @@ var llm_provider_config_default = {
     },
     {
       name: "openrouter",
-      className: "OpenRouterLLM",
+      type: "openai-compat",
       baseUrl: "https://openrouter.ai/api/v1",
-      transportName: "openrouter",
       features: {
         promptCaching: true,
         getModels: true,
@@ -5001,9 +5021,8 @@ var llm_provider_config_default = {
     },
     {
       name: "zai",
-      className: "ZaiLLM",
+      type: "openai-compat",
       baseUrl: "https://api.z.ai/api/coding/paas/v4",
-      transportName: "zai",
       features: {
         promptCaching: false,
         getModels: false
@@ -5011,9 +5030,8 @@ var llm_provider_config_default = {
     },
     {
       name: "moonshot",
-      className: "MoonshotLLM",
+      type: "openai-compat",
       baseUrl: "https://api.moonshot.ai/v1",
-      transportName: "moonshot",
       features: {
         promptCaching: false,
         getModels: true
@@ -5026,15 +5044,13 @@ var llm_provider_config_default = {
 var providers = llm_provider_config_default.providers;
 var GenericLLM = class extends BaseLLM {
   opts;
-  transportName;
   includeUsage;
-  supportsModels;
-  constructor(transportName, baseUrl, supportsModels, opts = {}) {
+  modelConfig;
+  constructor(baseUrl, modelConfig, opts = {}) {
     const { enablePromptCaching = false, includeUsage = false, ...restOpts } = opts;
     super(opts.apiUrl || baseUrl, { enablePromptCaching });
-    this.transportName = transportName;
     this.includeUsage = includeUsage;
-    this.supportsModels = supportsModels;
+    this.modelConfig = modelConfig;
     this.opts = restOpts;
   }
   createTransport() {
@@ -5045,11 +5061,24 @@ var GenericLLM = class extends BaseLLM {
       maxFileSize: 5 * 1024 * 1024,
       captureResponseBody: true
     });
-    return createTransport(this.transportName, base, this.apiUrl, this.opts.apiKey, this.opts.apiUrl);
+    return createTransport(base, this.apiUrl, this.opts.apiKey, this.opts.apiUrl, this.opts.version);
   }
   async getModels(signal) {
-    if (!this.supportsModels) {
-      throw new Error(`Provider ${this.transportName} does not support getModels`);
+    if (this.modelConfig === false) {
+      throw new Error("Provider does not support getModels");
+    }
+    if (Array.isArray(this.modelConfig)) {
+      return this.modelConfig.map((m) => typeof m === "string" ? { id: m } : m);
+    }
+    if (typeof this.modelConfig === "string") {
+      const transport2 = this.createTransport();
+      const res2 = await transport2.get(this.modelConfig, void 0, signal);
+      if (!res2.ok) {
+        const text = await res2.text();
+        throw new Error(`Failed to fetch models: ${res2.status} ${text}`);
+      }
+      const data2 = await res2.json();
+      return data2.data;
     }
     const transport = this.createTransport();
     const res = await transport.get("/models", void 0, signal);
@@ -5075,23 +5104,62 @@ var GenericLLM = class extends BaseLLM {
     return super.streamCompletion(enhancedParams, handlers, signal);
   }
 };
-function createLLM(providerName, options = {}) {
-  const config = providers.find((p) => p.name.toLowerCase() === providerName.toLowerCase());
+function normalizeModelConfig(config) {
+  if (config.models !== void 0) {
+    return config.models;
+  }
+  return config.features.getModels ?? false;
+}
+function mergeProviders(customProviders) {
+  const merged = /* @__PURE__ */ new Map();
+  for (const provider of providers) {
+    merged.set(provider.name.toLowerCase(), provider);
+  }
+  if (customProviders) {
+    for (const [name, custom] of Object.entries(customProviders)) {
+      if (!custom.baseUrl) {
+        continue;
+      }
+      const existing = merged.get(name.toLowerCase());
+      const providerConfig = {
+        name,
+        type: custom.type ?? "openai-compat",
+        baseUrl: custom.baseUrl,
+        models: custom.models ?? false,
+        features: existing?.features ?? {
+          promptCaching: false,
+          getModels: custom.models !== false,
+          includeUsage: false
+        }
+      };
+      merged.set(name.toLowerCase(), providerConfig);
+    }
+  }
+  return Array.from(merged.values());
+}
+function createLLM(providerName, options = {}, customProviders) {
+  const allProviders = mergeProviders(customProviders);
+  const config = allProviders.find((p) => p.name.toLowerCase() === providerName.toLowerCase());
   if (!config) {
-    throw new Error(`Unknown LLM provider: ${providerName}. Available: ${providers.map((p) => p.name).join(", ")}`);
+    throw new Error(`Unknown LLM provider: ${providerName}. Available: ${allProviders.map((p) => p.name).join(", ")}`);
   }
-  return new GenericLLM(config.transportName, config.baseUrl, config.features.getModels ?? false, {
+  const modelConfig = normalizeModelConfig(config);
+  return new GenericLLM(config.baseUrl, modelConfig, {
     ...options,
     enablePromptCaching: options.enablePromptCaching ?? config.features.promptCaching,
     includeUsage: options.includeUsage ?? config.features.includeUsage
   });
 }
-function getAvailableProviders() {
-  return providers.map((p) => p.name);
+function getAvailableProviders(customProviders) {
+  const allProviders = mergeProviders(customProviders);
+  return allProviders.map((p) => p.name);
 }
-function supportsGetModels(providerName) {
-  const config = providers.find((p) => p.name.toLowerCase() === providerName.toLowerCase());
-  return config?.features.getModels ?? false;
+function supportsGetModels(providerName, customProviders) {
+  const allProviders = mergeProviders(customProviders);
+  const config = allProviders.find((p) => p.name.toLowerCase() === providerName.toLowerCase());
+  if (!config) return false;
+  const modelConfig = normalizeModelConfig(config);
+  return modelConfig !== false;
 }
 
 // mcp/mcp-client.ts
@@ -5404,7 +5472,7 @@ export {
   DefaultDelegationService,
   DefaultSpecialistAgentFactory,
   DelegationServiceFactory,
-  EchoLLM,
+  ErrorReason,
   GithubLLM,
   InMemoryMemory,
   InMemoryMetadata,

package/package.json

@@ -1,11 +1,17 @@
 {
   "name": "@nuvin/nuvin-core",
-  "version": "1.0.1",
+  "version": "1.1.1",
   "description": "",
   "private": false,
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "type": "module",
+  "author": "Marsch Huynh <marsch.huynh@gmail.com>",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/marschhuynh/nuvin-cli.git",
+    "directory": "packages/nuvin-core"
+  },
   "files": [
     "dist"
   ],
@@ -19,7 +25,6 @@
     "access": "public"
   },
   "keywords": [],
-  "author": "Marsch Huynh <marsch.huynh@gmail.com>",
   "license": "Apache-2.0",
   "dependencies": {
     "@ai-sdk/anthropic": "^2.0.30",