@nuvin/nuvin-core 1.1.2 → 1.3.0

package/dist/VERSION

@@ -1,4 +1,4 @@
 {
-  "version": "1.1.2",
-  "commit": "76be190"
+  "version": "1.3.0",
+  "commit": "83fe0f5"
 }

package/dist/index.d.ts

@@ -237,6 +237,7 @@ type ChatMessage = {
     tool_calls?: ToolCall[];
     tool_call_id?: string;
     name?: string;
+    [key: string]: unknown;
 };
 type CompletionParams = {
     messages: ChatMessage[];
@@ -264,6 +265,7 @@ type CompletionParams = {
     usage?: {
         include?: boolean;
     };
+    [key: string]: unknown;
 };
 type UsageData = {
     prompt_tokens?: number;
@@ -286,6 +288,7 @@ type CompletionResult = {
     content: string;
     tool_calls?: ToolCall[];
     usage?: UsageData;
+    [key: string]: unknown;
 };
 type Message = {
     id: string;
@@ -296,6 +299,7 @@ type Message = {
     tool_call_id?: string;
     name?: string;
     usage?: UsageData;
+    [key: string]: unknown;
 };
 type MessageResponse = {
     id: string;
@@ -335,6 +339,14 @@ interface LLMPort {
         onToolCallDelta?: (tc: ToolCall) => void;
         onStreamFinish?: (finishReason?: string, usage?: UsageData) => void;
     }, signal?: AbortSignal): Promise<CompletionResult>;
+    getModels?(signal?: AbortSignal): Promise<Array<{
+        id: string;
+        limits?: {
+            contextWindow: number;
+            maxOutput?: number;
+        };
+        [key: string]: unknown;
+    }>>;
 }
 type LLMConfig = {
     provider?: string;
@@ -432,6 +444,33 @@ interface Clock {
 interface CostCalculator {
     estimate(model: string, usage?: UsageData): number | undefined;
 }
+type MetricsSnapshot = {
+    totalTokens: number;
+    totalPromptTokens: number;
+    totalCompletionTokens: number;
+    totalCachedTokens: number;
+    totalReasoningTokens: number;
+    requestCount: number;
+    llmCallCount: number;
+    toolCallCount: number;
+    totalTimeMs: number;
+    totalCost: number;
+    currentTokens: number;
+    currentPromptTokens: number;
+    currentCompletionTokens: number;
+    currentCachedTokens: number;
+    currentCost: number;
+    contextWindowLimit?: number;
+    contextWindowUsage?: number;
+};
+interface MetricsPort {
+    recordLLMCall(usage: UsageData, cost?: number): void;
+    recordToolCall(): void;
+    recordRequestComplete(responseTimeMs: number): void;
+    setContextWindow(limit: number, usage: number): void;
+    reset(): void;
+    getSnapshot(): MetricsSnapshot;
+}
 type AgentConfig = {
     id: string;
     systemPrompt: string;
@@ -575,17 +614,27 @@ interface EventPort {
 
 declare class AgentOrchestrator {
     private cfg;
-    private deps;
     private pendingApprovals;
+    private context;
+    private ids;
+    private clock;
+    private cost;
+    private reminders;
+    private metrics;
+    private events?;
+    private llm?;
+    private tools;
+    private memory;
     constructor(cfg: AgentConfig, deps: {
         memory: MemoryPort<Message>;
-        llm: LLMPort;
         tools: ToolPort;
-        context: ContextBuilder;
-        ids: IdGenerator$1;
-        clock: Clock;
-        cost: CostCalculator;
-        reminders: RemindersPort;
+        context?: ContextBuilder;
+        ids?: IdGenerator$1;
+        clock?: Clock;
+        cost?: CostCalculator;
+        reminders?: RemindersPort;
+        llm?: LLMPort;
+        metrics?: MetricsPort;
         events?: EventPort;
     });
     /**
@@ -610,7 +659,7 @@ declare class AgentOrchestrator {
     /**
      * Gets the current LLM port.
      */
-    getLLM(): LLMPort;
+    getLLM(): LLMPort | undefined;
     /**
      * Gets the current agent configuration.
      */
@@ -626,6 +675,14 @@ declare class AgentOrchestrator {
      * This is useful when switching to a new session with a different event log file.
      */
     setEvents(newEvents: EventPort): void;
+    /**
+     * Updates the metrics port without reinitializing the entire orchestrator.
+     */
+    setMetrics(newMetrics: MetricsPort): void;
+    /**
+     * Gets the current metrics port.
+     */
+    getMetrics(): MetricsPort | undefined;
     /**
      * Determines if a tool should bypass approval requirements.
      * Read-only tools and todo management tools are auto-approved.
@@ -772,6 +829,10 @@ type ConversationMetadata = {
     promptTokens?: number;
     completionTokens?: number;
     contextWindow?: TokenUsage;
+    requestCount?: number;
+    toolCallCount?: number;
+    totalTimeMs?: number;
+    totalPrice?: number;
 };
 type Conversation = {
     messages: Message[];
@@ -787,6 +848,14 @@ declare class ConversationStore {
     appendMessages(conversationId: string, messages: Message[]): Promise<void>;
     updateMetadata(conversationId: string, updates: Partial<ConversationMetadata>): Promise<void>;
     incrementTokens(conversationId: string, tokenUsage: TokenUsage): Promise<void>;
+    recordRequestMetrics(conversationId: string, metrics: {
+        promptTokens?: number;
+        completionTokens?: number;
+        totalTokens?: number;
+        toolCalls?: number;
+        responseTimeMs?: number;
+        cost?: number;
+    }): Promise<ConversationMetadata>;
     updateTopic(conversationId: string, topic: string): Promise<void>;
     deleteConversation(conversationId: string): Promise<void>;
     listConversations(): Promise<{
@@ -805,6 +874,30 @@ declare class ConversationContext {
     private slugify;
 }
 
+declare const createEmptySnapshot: () => MetricsSnapshot;
+declare class NoopMetricsPort implements MetricsPort {
+    recordLLMCall(_usage: UsageData, _cost?: number): void;
+    recordToolCall(): void;
+    recordRequestComplete(_responseTimeMs: number): void;
+    setContextWindow(_limit: number, _usage: number): void;
+    reset(): void;
+    getSnapshot(): MetricsSnapshot;
+}
+type MetricsChangeHandler = (snapshot: MetricsSnapshot) => void;
+declare class InMemoryMetricsPort implements MetricsPort {
+    private snapshot;
+    private onChange?;
+    constructor(onChange?: MetricsChangeHandler);
+    private emit;
+    recordLLMCall(usage: UsageData, cost?: number): void;
+    recordToolCall(): void;
+    recordRequestComplete(responseTimeMs: number): void;
+    setContextWindow(limit: number, usage: number): void;
+    reset(): void;
+    getSnapshot(): MetricsSnapshot;
+    setOnChange(fn: MetricsChangeHandler): void;
+}
+
 declare class SimpleId implements IdGenerator$1 {
     uuid(): string;
 }
@@ -1174,7 +1267,7 @@ declare abstract class BaseLLM implements LLMPort {
         enablePromptCaching?: boolean;
     });
     protected abstract createTransport(): HttpTransport;
-    private getTransport;
+    protected getTransport(): HttpTransport;
     protected applyCacheControl(params: CompletionParams): CompletionParams;
     generateCompletion(params: CompletionParams, signal?: AbortSignal): Promise<CompletionResult>;
     streamCompletion(params: CompletionParams, handlers?: {
@@ -1184,6 +1277,21 @@ declare abstract class BaseLLM implements LLMPort {
     }, signal?: AbortSignal): Promise<CompletionResult>;
 }
 
+type ModelLimits = {
+    contextWindow: number;
+    maxOutput?: number;
+};
+type ModelInfo = {
+    id: string;
+    name?: string;
+    limits?: ModelLimits;
+    [key: string]: unknown;
+};
+type RawModelResponse = Record<string, unknown>;
+declare function normalizeModelLimits(provider: string, model: RawModelResponse): ModelLimits | null;
+declare function getFallbackLimits(provider: string, model: string): ModelLimits | null;
+declare function normalizeModelInfo(provider: string, model: RawModelResponse): ModelInfo;
+
 type GithubOptions = {
     apiKey?: string;
     accessToken?: string;
@@ -1194,6 +1302,14 @@ declare class GithubLLM extends BaseLLM implements LLMPort {
     private readonly opts;
     constructor(opts?: GithubOptions);
     protected createTransport(): GithubAuthTransport;
+    getModels(signal?: AbortSignal): Promise<ModelInfo[]>;
+    private handleError;
+    generateCompletion(params: CompletionParams, signal?: AbortSignal): Promise<CompletionResult>;
+    streamCompletion(params: CompletionParams, handlers?: {
+        onChunk?: (delta: string, usage?: UsageData) => void;
+        onToolCallDelta?: (tc: ToolCall) => void;
+        onStreamFinish?: (finishReason?: string, usage?: UsageData) => void;
+    }, signal?: AbortSignal): Promise<CompletionResult>;
 }
 
 type AnthropicAISDKOptions = {
@@ -1248,6 +1364,7 @@ interface LLMOptions {
     enablePromptCaching?: boolean;
     includeUsage?: boolean;
     version?: string;
+    providerName?: string;
 }
 interface CustomProviderDefinition {
     type?: 'openai-compat' | 'anthropic';
@@ -1348,4 +1465,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, type CompleteAgent, 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 };
+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, type CompleteAgent, 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, InMemoryMetricsPort, 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, type MetricsChangeHandler, type MetricsPort, type MetricsSnapshot, type ModelInfo, type ModelLimits, NoopMetricsPort, 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 UsageData, type UserAttachment, type UserMessagePayload, buildAgentCreationPrompt, buildInjectedSystem, canonicalizeTerminalPaste, createEmptySnapshot, createLLM, generateFolderTree, getAvailableProviders, getFallbackLimits, loadMCPConfig, normalizeModelInfo, normalizeModelLimits, normalizeNewlines, renderTemplate, resolveBackspaces, resolveCarriageReturns, stripAnsiAndControls, supportsGetModels };