@nuvin/nuvin-core 1.0.0 → 1.1.0

package/dist/VERSION

@@ -1,4 +1,4 @@
 {
-  "version": "1.0.0",
-  "commit": "63191c8"
+  "version": "1.1.0",
+  "commit": "6618d91"
 }

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;
@@ -439,7 +440,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 +461,7 @@ type AgentEvent = {
     conversationId: string;
     messageId: string;
     toolCalls: ToolCall[];
+    usage?: UsageData;
 } | {
     type: typeof AgentEventTypes.ToolApprovalRequired;
     conversationId: string;
@@ -497,10 +498,6 @@ type AgentEvent = {
     messageId: string;
     finishReason?: string;
     usage?: UsageData;
-} | {
-    type: typeof AgentEventTypes.MemoryAppended;
-    conversationId: string;
-    delta: Message[];
 } | {
     type: typeof AgentEventTypes.Done;
     conversationId: string;
@@ -799,7 +796,7 @@ declare class SystemClock implements Clock {
 }
 
 declare class SimpleCost implements CostCalculator {
-    estimate(_model: string, _usage?: UsageData): number | undefined;
+    estimate(_model: string, usage?: UsageData): number | undefined;
 }
 
 declare class NoopReminders implements RemindersPort {
@@ -1088,12 +1085,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 = {
@@ -1151,42 +1142,6 @@ declare class GithubAuthTransport implements HttpTransport {
     postStream(url: string, body: unknown, headers?: HttpHeaders, signal?: AbortSignal): Promise<Response>;
 }
 
-declare class OpenRouterAuthTransport implements HttpTransport {
-    private readonly inner;
-    private readonly apiKey?;
-    private readonly baseUrl;
-    constructor(inner: FetchTransport, apiKey?: string, baseUrl?: string);
-    private buildFullUrl;
-    private makeAuthHeaders;
-    get(url: string, headers?: HttpHeaders, signal?: AbortSignal): Promise<TransportResponse>;
-    postJson(url: string, body: unknown, headers?: HttpHeaders, signal?: AbortSignal): Promise<TransportResponse>;
-    postStream(url: string, body: unknown, headers?: HttpHeaders, signal?: AbortSignal): Promise<Response>;
-}
-
-declare class DeepInfraAuthTransport implements HttpTransport {
-    private readonly inner;
-    private readonly apiKey?;
-    private readonly baseUrl;
-    constructor(inner: FetchTransport, apiKey?: string, baseUrl?: string);
-    private buildFullUrl;
-    private makeAuthHeaders;
-    get(url: string, headers?: HttpHeaders, signal?: AbortSignal): Promise<TransportResponse>;
-    postJson(url: string, body: unknown, headers?: HttpHeaders, signal?: AbortSignal): Promise<TransportResponse>;
-    postStream(url: string, body: unknown, headers?: HttpHeaders, signal?: AbortSignal): Promise<Response>;
-}
-
-declare class ZAIAuthTransport implements HttpTransport {
-    private readonly inner;
-    private readonly apiKey?;
-    private readonly baseUrl;
-    constructor(inner: FetchTransport, apiKey?: string, baseUrl?: string);
-    private buildFullUrl;
-    private makeAuthHeaders;
-    get(url: string, headers?: HttpHeaders, signal?: AbortSignal): Promise<TransportResponse>;
-    postJson(url: string, body: unknown, headers?: HttpHeaders, signal?: AbortSignal): Promise<TransportResponse>;
-    postStream(url: string, body: unknown, headers?: HttpHeaders, signal?: AbortSignal): Promise<Response>;
-}
-
 declare class LLMError extends Error {
     readonly statusCode?: number;
     readonly isRetryable: boolean;
@@ -1222,138 +1177,6 @@ declare class GithubLLM extends BaseLLM implements LLMPort {
     protected createTransport(): GithubAuthTransport;
 }
 
-type OpenRouterOptions = {
-    apiKey?: string;
-    apiUrl?: string;
-    httpLogFile?: string;
-    enablePromptCaching?: boolean;
-    includeUsage?: boolean;
-};
-type OpenRouterModel = {
-    id: string;
-    canonical_slug: string;
-    hugging_face_id: string;
-    name: string;
-    created: number;
-    description: string;
-    context_length: number;
-    architecture: {
-        modality: string;
-        input_modalities: string[];
-        output_modalities: string[];
-        tokenizer: string;
-        instruct_type: string | null;
-    };
-    pricing: {
-        prompt: string;
-        completion: string;
-        request: string;
-        image: string;
-        web_search: string;
-        internal_reasoning: string;
-        input_cache_read: string;
-    };
-    top_provider: {
-        context_length: number;
-        max_completion_tokens: number | null;
-        is_moderated: boolean;
-    };
-    per_request_limits: {
-        prompt_tokens: string;
-        completion_tokens: string;
-    } | null;
-    supported_parameters: string[];
-    default_parameters: {
-        temperature: number | null;
-        top_p: number | null;
-        frequency_penalty: number | null;
-    };
-};
-declare class OpenRouterLLM extends BaseLLM implements LLMPort {
-    private readonly includeUsage;
-    constructor(opts?: OpenRouterOptions);
-    private readonly opts;
-    protected createTransport(): OpenRouterAuthTransport;
-    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>;
-    getModels(signal?: AbortSignal): Promise<OpenRouterModel[]>;
-}
-
-type DeepInfraOptions = {
-    apiKey?: string;
-    apiUrl?: string;
-    httpLogFile?: string;
-};
-type DeepInfraModel = {
-    id: string;
-    object: string;
-    created: number;
-    owned_by: string;
-    root: string;
-    parent: string | null;
-    metadata: {
-        description: string;
-        context_length: number;
-        max_tokens: number;
-        pricing: {
-            input_tokens: number;
-            output_tokens: number;
-            cache_read_tokens?: number;
-        };
-        tags: string[];
-    };
-};
-declare class DeepInfraLLM extends BaseLLM implements LLMPort {
-    private readonly opts;
-    constructor(opts?: DeepInfraOptions);
-    protected createTransport(): DeepInfraAuthTransport;
-    getModels(signal?: AbortSignal): Promise<DeepInfraModel[]>;
-}
-
-type ZaiOptions = {
-    apiKey?: string;
-    apiUrl?: string;
-    httpLogFile?: string;
-};
-declare class ZaiLLM extends BaseLLM implements LLMPort {
-    private readonly opts;
-    constructor(opts?: ZaiOptions);
-    protected createTransport(): ZAIAuthTransport;
-}
-
-type AnthropicOptions = {
-    apiKey?: string;
-    oauth?: {
-        type: 'oauth';
-        access: string;
-        refresh: string;
-        expires: number;
-    };
-    apiUrl?: string;
-    httpLogFile?: string;
-};
-declare class AnthropicLLM {
-    private transport;
-    private readonly opts;
-    private readonly apiUrl;
-    constructor(opts?: AnthropicOptions);
-    private getTransport;
-    private transformToAnthropicMessages;
-    private transformTools;
-    private transformToolChoice;
-    private transformResponse;
-    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 = {
     apiKey?: string;
     oauth?: {
@@ -1394,6 +1217,28 @@ 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, 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';
     url: string;
@@ -1483,4 +1328,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, AnthropicLLM, type AssignParams, BashTool, CompositeToolPort, type Conversation, ConversationContext, type ConversationMetadata, type ConversationSnapshot, ConversationStore, CoreMCPClient, DeepInfraLLM, type DeepInfraModel, DefaultDelegationPolicy, DefaultDelegationResultFormatter, DefaultDelegationService, DefaultSpecialistAgentFactory, type DelegationService, type DelegationServiceConfig, DelegationServiceFactory, EchoLLM, type FolderTreeOptions, GithubLLM, InMemoryMemory, InMemoryMetadata, JsonFileMemoryPersistence, type LLMConfig, LLMError, type LLMFactory, type LLMPort, LLMResolver, type MCPConfig, type MCPServerConfig, MCPToolPort, type MemoryPort, MemoryPortMetadataAdapter, type Message, type MessageContent, type MessageContentPart, type MetadataPort, NoopReminders, OpenRouterLLM, type OpenRouterModel, 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, ZaiLLM, buildAgentCreationPrompt, buildInjectedSystem, canonicalizeTerminalPaste, generateFolderTree, loadMCPConfig, normalizeNewlines, renderTemplate, resolveBackspaces, resolveCarriageReturns, stripAnsiAndControls };
+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, 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 };