@nuvin/nuvin-core 1.19.0-rc.7 → 1.19.0

package/dist/VERSION

@@ -1,4 +1,4 @@
 {
-  "version": "1.19.0-rc.7",
-  "commit": "bebc7aa"
+  "version": "1.19.0",
+  "commit": "62fe16d"
 }

package/dist/index.d.ts

@@ -21,8 +21,11 @@ type AgentTemplate = {
     share_context?: boolean;
     stream?: boolean;
     metadata?: Record<string, unknown>;
+    location?: 'built-in' | 'global' | 'profile' | 'local';
+};
+type CompleteAgent = Required<Pick<AgentTemplate, 'instructions' | 'name' | 'description' | 'allowed_tools' | 'temperature'>> & Pick<AgentTemplate, 'model' | 'disable_model_invocation' | 'user_invocable' | 'context' | 'agent' | 'provider' | 'top_p' | 'max_tokens' | 'timeout_ms' | 'share_context' | 'metadata'> & {
+    location?: 'built-in' | 'global' | 'profile' | 'local';
 };
-type CompleteAgent = Required<Pick<AgentTemplate, 'instructions' | 'name' | 'description' | 'allowed_tools' | 'temperature'>> & Pick<AgentTemplate, 'model' | 'disable_model_invocation' | 'user_invocable' | 'context' | 'agent' | 'provider' | 'top_p' | 'max_tokens' | 'timeout_ms' | 'share_context' | 'metadata'>;
 /**
  * Specialist Agent Configuration (Internal - used by AgentManager)
  */
@@ -107,14 +110,19 @@ declare class AgentRegistry {
     private agents;
     private defaultAgentIds;
     private persistence?;
-    private filePersistence?;
+    private localFilePersistence?;
+    private profileFilePersistence?;
+    private globalFilePersistence?;
     private loadingPromise?;
     constructor(options?: {
         persistence?: MemoryPort<AgentTemplate>;
-        filePersistence?: AgentFilePersistence;
+        localFilePersistence?: AgentFilePersistence;
+        profileFilePersistence?: AgentFilePersistence;
+        globalFilePersistence?: AgentFilePersistence;
     });
     /**
      * Load agents from both persistence and files
+     * Load order matters: global → profile → local (later loads can override)
      */
     private loadAgents;
     /**
@@ -136,10 +144,6 @@ declare class AgentRegistry {
      * Load agents from file system
      */
     private loadFromFiles;
-    /**
-     * Save current agents to persistence
-     */
-    private saveToPersistence;
     /**
      * Validate agent template (only instructions required)
      */
@@ -150,14 +154,20 @@ declare class AgentRegistry {
     register(agent: Partial<AgentTemplate> & {
         instructions: string;
     }): void;
+    /**
+     * Get the appropriate persistence layer for a given location
+     */
+    private getPersistenceForLocation;
     /**
      * Save agent to file
      */
     saveToFile(agent: CompleteAgent): Promise<void>;
     /**
-     * Delete agent from file
+     * Delete agent from file.
+     * Location is required — callers must know where the agent lives.
+     * Directory placement is the single source of truth for location.
      */
-    deleteFromFile(agentName: string): Promise<void>;
+    deleteFromFile(agentName: string, location: 'local' | 'profile' | 'global'): Promise<void>;
     /**
      * Check if an agent is a default agent
      */
@@ -178,6 +188,12 @@ declare class AgentRegistry {
      * Check if an agent exists
      */
     exists(agentName: string): boolean;
+    /**
+     * Reload all agents from disk.
+     * Clears non-default agents and re-reads from all file persistence layers.
+     * Similar to commands' registry.reload() pattern.
+     */
+    reload(): Promise<void>;
 }
 
 /**
@@ -194,6 +210,7 @@ type BashToolArgs = {
     cwd?: string;
     timeoutMs?: number;
     description?: string;
+    ignoreOutput?: boolean;
 };
 type FileReadArgs = {
     path: string;
@@ -794,8 +811,16 @@ type ToolExecutionResult = {
     id: string;
     name: string;
     status: 'success';
-    type: 'text' | 'json';
-    result: string | Record<string, unknown> | unknown[];
+    type: 'mixed';
+    result: Array<TextContentPart | ImageContentPart>;
+    metadata?: Record<string, unknown>;
+    durationMs?: number;
+} | {
+    id: string;
+    name: string;
+    status: 'success';
+    type: 'text' | 'json' | 'mixed';
+    result: string | Record<string, unknown> | unknown[] | Array<TextContentPart | ImageContentPart>;
     metadata?: Record<string, unknown>;
     durationMs?: number;
 } | {
@@ -1409,6 +1434,10 @@ type InjectedSystemParams = {
         description: string;
     }>;
     folderTree?: string;
+    shell?: string;
+    gitBranch?: string;
+    gitRepo?: string;
+    recentCommits?: string;
 };
 declare function buildInjectedSystem(p: InjectedSystemParams, { withSubAgent }?: {
     withSubAgent?: boolean;
@@ -1856,6 +1885,11 @@ type SystemContext = {
     arch: string;
     tempDir: string;
     workspaceDir: string;
+    shell?: string;
+    gitBranch?: string;
+    gitRepo?: string;
+    recentCommits?: string;
+    folderTree?: string;
 };
 type AgentInfo = {
     id: string;
@@ -2065,6 +2099,7 @@ type BashParams = {
     cmd: string;
     cwd?: string;
     timeoutMs?: number;
+    ignoreOutput?: boolean;
 };
 type BashSuccessResult$1 = {
     status: 'success';
@@ -2100,6 +2135,10 @@ declare class BashTool implements FunctionTool<BashParams, ToolExecutionContext,
                 readonly minimum: 1;
                 readonly description: "Timeout in ms. Default: 30000.";
             };
+            readonly ignoreOutput: {
+                readonly type: "boolean";
+                readonly description: "If true, discard stdout/stderr and return only the exit code. Useful when you only care whether the command succeeded or failed.";
+            };
         };
         readonly required: readonly ["cmd"];
     };
@@ -2151,6 +2190,7 @@ declare const bashToolSchema: z.ZodObject<{
     cwd: z.ZodOptional<z.ZodString>;
     timeoutMs: z.ZodOptional<z.ZodNumber>;
     description: z.ZodOptional<z.ZodString>;
+    ignoreOutput: z.ZodOptional<z.ZodBoolean>;
 }, z.core.$strip>;
 declare const fileReadSchema: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodObject<{
     path: z.ZodPipe<z.ZodTransform<string, unknown>, z.ZodString>;
@@ -2236,6 +2276,7 @@ declare const toolSchemas: {
         cwd: z.ZodOptional<z.ZodString>;
         timeoutMs: z.ZodOptional<z.ZodNumber>;
         description: z.ZodOptional<z.ZodString>;
+        ignoreOutput: z.ZodOptional<z.ZodBoolean>;
     }, z.core.$strip>;
     readonly file_read: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodObject<{
         path: z.ZodPipe<z.ZodTransform<string, unknown>, z.ZodString>;
@@ -2446,6 +2487,7 @@ type GrepParams = {
     path?: string;
     include?: string;
     limit?: number;
+    context?: number;
 };
 type GrepSuccessResult$1 = {
     status: 'success';
@@ -2940,6 +2982,29 @@ type AnthropicAISDKOptions = {
         expires: number;
     }) => void;
 };
+/**
+ * Converts ChatMessage content to AI SDK tool result output format.
+ *
+ * When content contains ProviderContentPart[] with image_url parts,
+ * uses the AI SDK 'content' output type with 'media' parts for images.
+ * Falls back to a simple 'text' output for string content.
+ *
+ * @see LanguageModelV2ToolResultOutput from @ai-sdk/provider
+ */
+declare function buildAISDKToolResultOutput(content: string | null | ProviderContentPart[]): {
+    type: 'text';
+    value: string;
+} | {
+    type: 'content';
+    value: Array<{
+        type: 'text';
+        text: string;
+    } | {
+        type: 'media';
+        data: string;
+        mediaType: string;
+    }>;
+};
 declare class AnthropicAISDKLLM {
     private readonly opts;
     private provider?;
@@ -3042,6 +3107,7 @@ declare class CoreMCPClient {
     constructor(opts: MCPOptions, timeoutMs?: number);
     private getAuthHeaders;
     connect(): Promise<void>;
+    private performConnect;
     reconnectWithNewToken(): Promise<void>;
     isConnected(): boolean;
     getCurrentToken(): string | null;
@@ -3358,4 +3424,4 @@ declare function resolveBackspaces(s: string): string;
 declare function stripAnsiAndControls(s: string): string;
 declare function canonicalizeTerminalPaste(raw: string): string;
 
-export { AGENT_CREATOR_SYSTEM_PROMPT, AbortError, type AgentAwareToolPort, type AgentCatalog, type AgentConfig, type AgentEvent, AgentEventTypes, AgentFilePersistence, AgentManager, AgentManagerCommandRunner, AgentOrchestrator, AgentRegistry, type AgentSession, type AgentStateManager, type AgentTemplate, AnthropicAISDKLLM, type AskUserArgs, type AskUserMetadata, AskUserTool, type AssignErrorResult, type AssignParams, type AssignResult, type AssignSuccessResult$1 as AssignSuccessResult, type AssignTaskArgs, type AssignTaskMetadata, type AuthFlowResult, type AuthServerMetadata, type BaseLLMOptions, type BashErrorResult, type BashParams, type BashResult, type BashSuccessResult$1 as BashSuccessResult, BashTool, type BashToolArgs, type BashToolMetadata, CommandFilePersistence, CommandHookExecutor, type CommandMetadata, type CommandSource, type CompleteAgent, type CompleteCustomCommand, CompositeHookPort, CompositeToolPort, type Conversation, ConversationContext, type ConversationMetadata, type ConversationSnapshot, ConversationStore, CoreMCPClient, type CustomCommandFrontmatter, type CustomCommandTemplate, DEFAULT_RETRY_CONFIG, DefaultAgentStateManager, DefaultDelegationService, DefaultSpecialistAgentFactory, type DelegationMetadata, type DelegationService, type DelegationServiceConfig, DelegationServiceFactory, type DirEntry, type ErrorMetadata, ErrorReason, type ExecResult, type ExecResultError, type ExecResultSuccess, type FileEditArgs, type FileEditMetadata, type FileEditResult, type FileEditSuccessResult$1 as FileEditSuccessResult, type FileMetadata, type FileNewArgs, type FileNewMetadata, type FileNewParams, type FileNewResult, type FileNewSuccessResult$1 as FileNewSuccessResult, type FileReadArgs, type FileReadErrorResult, type FileReadMetadata, type FileReadParams, type FileReadResult, type FileReadSuccessResult$1 as FileReadSuccessResult, type FolderTreeOptions, type FunctionTool, GithubLLM, type GlobArgs, type GlobParams, type GlobResult, type GlobSuccessResult$1 as GlobSuccessResult, type GlobToolMetadata, type GrepArgs, type GrepParams, type GrepResult, type GrepSuccessResult$1 as GrepSuccessResult, type GrepToolMetadata, type HookContext, HookDecision, type HookDecisionType, type HookDefinition, type HookEventConfig, type HookEventType, HookEventTypes, type HookPort, HookRegistry, type HookResult, type HooksConfig, InMemoryMemory, InMemoryMetadata, InMemoryMetricsPort, JsonFileMemoryPersistence, type LLMConfig, LLMError, type LLMFactory, type LLMOptions, type LLMPort, LLMResolver, type LineRangeMetadata, type LsArgs, type LsMetadata, type LsParams, type LsResult, type LsSuccessResult$1 as LsSuccessResult, type LspService, LspTool, type MCPAuthOptions, type MCPCallResult, type MCPConfig, type MCPHttpOptions, MCPOAuthClient, type MCPOAuthConfig, type MCPOptions, type MCPServerConfig, type MCPStdioOptions, type MCPToolCall, MCPToolPort, type MCPToolSchema, 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, type ParseResult, PersistedMemory, PersistingConsoleEventPort, type ProtectedResourceMetadata, type RetryConfig, RetryTransport, RuntimeEnv, type SendMessageOptions, SimpleContextBuilder, SimpleCost, SimpleId, type SkillErrorResult, type SkillMetadata, type SkillParams, type SkillProvider, type SkillResult, type SkillSuccessResult, SkillTool, type SkillInfo as SkillToolInfo, type SpecialistAgentConfig, type SpecialistAgentResult, type StoredTokens, type SubAgentState, type SubAgentToolCall, SystemClock, type TaskOutputMetadata, type TaskOutputParams, type TaskOutputResult, type TaskOutputSuccessResult, type TodoWriteArgs, type TodoWriteMetadata, type TodoWriteResult, type TodoWriteSuccessResult$1 as TodoWriteSuccessResult, type TokenStorage, type ToolApprovalDecision, type ToolArguments, type ToolCall, type ToolCallConversionResult, type ToolCallValidation, type ToolErrorMetadata, type ToolExecutionContext, type ToolExecutionResult, type ToolMetadataMap, type ToolName, type ToolParameterMap, type ToolPort, ToolRegistry, type ToolValidator, type TypedToolInvocation, type UsageData, type UserAttachment, type UserMessagePayload, type ValidationError, type ValidationResult, type WebFetchArgs, type WebFetchMetadata, type WebFetchParams, type WebFetchResult, type WebFetchSuccessResult$1 as WebFetchSuccessResult, type WebSearchArgs, type WebSearchMetadata, type WebSearchParams, type WebSearchResult, type WebSearchSuccessResult$1 as WebSearchSuccessResult, type WebSearchToolResult, assignTaskSchema, bashToolSchema, buildAgentCreationPrompt, buildInjectedSystem, canonicalizeTerminalPaste, convertToolCall, convertToolCalls, convertToolCallsWithErrorHandling, createEmptySnapshot, createLLM, deduplicateModels, err, fileEditSchema, fileNewSchema, fileReadSchema, generateFolderTree, getAvailableProviders, getFallbackLimits, getProviderAuthMethods, getProviderDefaultModels, getProviderLabel, globToolSchema, grepToolSchema, isAssignResult, isAssignSuccess, isAssignTaskArgs, isBashResult, isBashSuccess, isBashToolArgs, isError, isFileEditArgs, isFileEditResult, isFileEditSuccess, isFileNewArgs, isFileNewResult, isFileNewSuccess, isFileReadArgs, isFileReadResult, isFileReadSuccess, isGlobArgs, isGlobResult, isGlobSuccess, isGrepArgs, isGrepResult, isGrepSuccess, isInsufficientScopeError, isJsonResult, isLsArgs, isLsToolResult, isLsToolSuccess, isRetryableError, isRetryableStatusCode, isSuccess, isSuccessJson, isSuccessText, isTextResult, isTodoWriteArgs, isTodoWriteResult, isTodoWriteSuccess, isUnauthorizedError, isValidCommandId, isWebFetchArgs, isWebFetchResult, isWebFetchSuccess, isWebSearchArgs, isWebSearchResult, isWebSearchSuccess, loadHooksFromFrontmatter, lsToolSchema, mergeAgentConfig, normalizeModelInfo, normalizeModelLimits, normalizeNewlines, okJson, okText, parseJSON, parseSubAgentToolCallArguments, parseToolArguments, parseWWWAuthenticate, renderTemplate, resolveBackspaces, resolveCarriageReturns, sanitizeCommandId, stripAnsiAndControls, supportsGetModels, todoWriteSchema, toolSchemas, toolValidators, validateToolParams, webFetchSchema, webSearchSchema };
+export { AGENT_CREATOR_SYSTEM_PROMPT, AbortError, type AgentAwareToolPort, type AgentCatalog, type AgentConfig, type AgentEvent, AgentEventTypes, AgentFilePersistence, AgentManager, AgentManagerCommandRunner, AgentOrchestrator, AgentRegistry, type AgentSession, type AgentStateManager, type AgentTemplate, AnthropicAISDKLLM, type AskUserArgs, type AskUserMetadata, AskUserTool, type AssignErrorResult, type AssignParams, type AssignResult, type AssignSuccessResult$1 as AssignSuccessResult, type AssignTaskArgs, type AssignTaskMetadata, type AuthFlowResult, type AuthServerMetadata, type BaseLLMOptions, type BashErrorResult, type BashParams, type BashResult, type BashSuccessResult$1 as BashSuccessResult, BashTool, type BashToolArgs, type BashToolMetadata, CommandFilePersistence, CommandHookExecutor, type CommandMetadata, type CommandSource, type CompleteAgent, type CompleteCustomCommand, CompositeHookPort, CompositeToolPort, type Conversation, ConversationContext, type ConversationMetadata, type ConversationSnapshot, ConversationStore, CoreMCPClient, type CustomCommandFrontmatter, type CustomCommandTemplate, DEFAULT_RETRY_CONFIG, DefaultAgentStateManager, DefaultDelegationService, DefaultSpecialistAgentFactory, type DelegationMetadata, type DelegationService, type DelegationServiceConfig, DelegationServiceFactory, type DirEntry, type ErrorMetadata, ErrorReason, type ExecResult, type ExecResultError, type ExecResultSuccess, type FileEditArgs, type FileEditMetadata, type FileEditResult, type FileEditSuccessResult$1 as FileEditSuccessResult, type FileMetadata, type FileNewArgs, type FileNewMetadata, type FileNewParams, type FileNewResult, type FileNewSuccessResult$1 as FileNewSuccessResult, type FileReadArgs, type FileReadErrorResult, type FileReadMetadata, type FileReadParams, type FileReadResult, type FileReadSuccessResult$1 as FileReadSuccessResult, type FolderTreeOptions, type FunctionTool, GithubLLM, type GlobArgs, type GlobParams, type GlobResult, type GlobSuccessResult$1 as GlobSuccessResult, type GlobToolMetadata, type GrepArgs, type GrepParams, type GrepResult, type GrepSuccessResult$1 as GrepSuccessResult, type GrepToolMetadata, type HookContext, HookDecision, type HookDecisionType, type HookDefinition, type HookEventConfig, type HookEventType, HookEventTypes, type HookPort, HookRegistry, type HookResult, type HooksConfig, InMemoryMemory, InMemoryMetadata, InMemoryMetricsPort, JsonFileMemoryPersistence, type LLMConfig, LLMError, type LLMFactory, type LLMOptions, type LLMPort, LLMResolver, type LineRangeMetadata, type LsArgs, type LsMetadata, type LsParams, type LsResult, type LsSuccessResult$1 as LsSuccessResult, type LspService, LspTool, type MCPAuthOptions, type MCPCallResult, type MCPConfig, type MCPHttpOptions, MCPOAuthClient, type MCPOAuthConfig, type MCPOptions, type MCPServerConfig, type MCPStdioOptions, type MCPToolCall, MCPToolPort, type MCPToolSchema, 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, type ParseResult, PersistedMemory, PersistingConsoleEventPort, type ProtectedResourceMetadata, type RetryConfig, RetryTransport, RuntimeEnv, type SendMessageOptions, SimpleContextBuilder, SimpleCost, SimpleId, type SkillErrorResult, type SkillMetadata, type SkillParams, type SkillProvider, type SkillResult, type SkillSuccessResult, SkillTool, type SkillInfo as SkillToolInfo, type SpecialistAgentConfig, type SpecialistAgentResult, type StoredTokens, type SubAgentState, type SubAgentToolCall, SystemClock, type TaskOutputMetadata, type TaskOutputParams, type TaskOutputResult, type TaskOutputSuccessResult, type TodoWriteArgs, type TodoWriteMetadata, type TodoWriteResult, type TodoWriteSuccessResult$1 as TodoWriteSuccessResult, type TokenStorage, type ToolApprovalDecision, type ToolArguments, type ToolCall, type ToolCallConversionResult, type ToolCallValidation, type ToolErrorMetadata, type ToolExecutionContext, type ToolExecutionResult, type ToolMetadataMap, type ToolName, type ToolParameterMap, type ToolPort, ToolRegistry, type ToolValidator, type TypedToolInvocation, type UsageData, type UserAttachment, type UserMessagePayload, type ValidationError, type ValidationResult, type WebFetchArgs, type WebFetchMetadata, type WebFetchParams, type WebFetchResult, type WebFetchSuccessResult$1 as WebFetchSuccessResult, type WebSearchArgs, type WebSearchMetadata, type WebSearchParams, type WebSearchResult, type WebSearchSuccessResult$1 as WebSearchSuccessResult, type WebSearchToolResult, assignTaskSchema, bashToolSchema, buildAISDKToolResultOutput, buildAgentCreationPrompt, buildInjectedSystem, canonicalizeTerminalPaste, convertToolCall, convertToolCalls, convertToolCallsWithErrorHandling, createEmptySnapshot, createLLM, deduplicateModels, err, fileEditSchema, fileNewSchema, fileReadSchema, generateFolderTree, getAvailableProviders, getFallbackLimits, getProviderAuthMethods, getProviderDefaultModels, getProviderLabel, globToolSchema, grepToolSchema, isAssignResult, isAssignSuccess, isAssignTaskArgs, isBashResult, isBashSuccess, isBashToolArgs, isError, isFileEditArgs, isFileEditResult, isFileEditSuccess, isFileNewArgs, isFileNewResult, isFileNewSuccess, isFileReadArgs, isFileReadResult, isFileReadSuccess, isGlobArgs, isGlobResult, isGlobSuccess, isGrepArgs, isGrepResult, isGrepSuccess, isInsufficientScopeError, isJsonResult, isLsArgs, isLsToolResult, isLsToolSuccess, isRetryableError, isRetryableStatusCode, isSuccess, isSuccessJson, isSuccessText, isTextResult, isTodoWriteArgs, isTodoWriteResult, isTodoWriteSuccess, isUnauthorizedError, isValidCommandId, isWebFetchArgs, isWebFetchResult, isWebFetchSuccess, isWebSearchArgs, isWebSearchResult, isWebSearchSuccess, loadHooksFromFrontmatter, lsToolSchema, mergeAgentConfig, normalizeModelInfo, normalizeModelLimits, normalizeNewlines, okJson, okText, parseJSON, parseSubAgentToolCallArguments, parseToolArguments, parseWWWAuthenticate, renderTemplate, resolveBackspaces, resolveCarriageReturns, sanitizeCommandId, stripAnsiAndControls, supportsGetModels, todoWriteSchema, toolSchemas, toolValidators, validateToolParams, webFetchSchema, webSearchSchema };