@nuvin/nuvin-core 1.9.4 → 1.11.0

package/dist/VERSION

@@ -1,4 +1,4 @@
 {
-  "version": "1.9.4",
-  "commit": "88246cb"
+  "version": "1.11.0",
+  "commit": "1768138"
 }

package/dist/index.d.ts

@@ -230,11 +230,22 @@ type FileNewArgs = {
     content: string;
     description?: string;
 };
-type DirLsArgs = {
+type LsArgs = {
     path?: string;
     limit?: number;
     description?: string;
 };
+type GlobArgs = {
+    pattern: string;
+    path?: string;
+    description?: string;
+};
+type GrepArgs = {
+    pattern: string;
+    path?: string;
+    include?: string;
+    description?: string;
+};
 type WebSearchArgs = {
     query: string;
     count?: number;
@@ -267,7 +278,7 @@ type AssignTaskArgs = {
     task: string;
     description: string;
 };
-type ToolArguments = BashToolArgs | FileReadArgs | FileEditArgs | FileNewArgs | DirLsArgs | WebSearchArgs | WebFetchArgs | TodoWriteArgs | AssignTaskArgs;
+type ToolArguments = BashToolArgs | FileReadArgs | FileEditArgs | FileNewArgs | LsArgs | GlobArgs | GrepArgs | WebSearchArgs | WebFetchArgs | TodoWriteArgs | AssignTaskArgs;
 /**
  * Type guard to safely parse tool arguments
  */
@@ -283,13 +294,17 @@ declare function isTodoWriteArgs(args: ToolArguments): args is TodoWriteArgs;
 declare function isAssignTaskArgs(args: ToolArguments): args is AssignTaskArgs;
 declare function isWebSearchArgs(args: ToolArguments): args is WebSearchArgs;
 declare function isWebFetchArgs(args: ToolArguments): args is WebFetchArgs;
-declare function isDirLsArgs(args: ToolArguments): args is DirLsArgs;
+declare function isGlobArgs(args: ToolArguments): args is GlobArgs;
+declare function isGrepArgs(args: ToolArguments): args is GrepArgs;
+declare function isLsArgs(args: ToolArguments): args is LsArgs;
 type ToolParameterMap = {
     bash_tool: BashToolArgs;
     file_read: FileReadArgs;
     file_edit: FileEditArgs;
     file_new: FileNewArgs;
-    dir_ls: DirLsArgs;
+    ls_tool: LsArgs;
+    glob: GlobArgs;
+    grep: GrepArgs;
     web_search: WebSearchArgs;
     web_fetch: WebFetchArgs;
     todo_write: TodoWriteArgs;
@@ -376,10 +391,24 @@ type FileNewMetadata = {
     created: string;
     overwritten?: boolean;
 };
-type DirLsMetadata = {
+type LsMetadata = {
     limit: number;
     includeHidden: boolean;
 };
+type GlobToolMetadata = {
+    searchPath: string;
+    pattern: string;
+    count: number;
+    truncated: boolean;
+};
+type GrepToolMetadata = {
+    searchPath: string;
+    pattern: string;
+    include?: string;
+    matchCount: number;
+    fileCount: number;
+    truncated: boolean;
+};
 type WebSearchMetadata = {
     offset: number;
     totalRequested: number;
@@ -428,7 +457,9 @@ type ToolMetadataMap = {
     file_read: FileReadMetadata;
     file_edit: FileEditMetadata;
     file_new: FileNewMetadata;
-    dir_ls: DirLsMetadata;
+    ls_tool: LsMetadata;
+    glob: GlobToolMetadata;
+    grep: GrepToolMetadata;
     web_search: WebSearchMetadata;
     web_fetch: WebFetchMetadata;
     todo_write: TodoWriteMetadata;
@@ -629,8 +660,8 @@ type ToolInvocation = {
     editInstruction?: string;
 } | {
     id: string;
-    name: 'dir_ls';
-    parameters: DirLsArgs;
+    name: 'ls_tool';
+    parameters: LsArgs;
     editInstruction?: string;
 } | {
     id: string;
@@ -705,11 +736,11 @@ type ToolExecutionResult = {
     durationMs?: number;
 } | {
     id: string;
-    name: 'dir_ls';
+    name: 'ls_tool';
     status: 'success';
     type: 'text';
     result: string;
-    metadata?: DirLsMetadata;
+    metadata?: LsMetadata;
     durationMs?: number;
 } | {
     id: string;
@@ -1707,7 +1738,7 @@ type FileNewSuccessResult$1 = {
 };
 type FileNewResult = FileNewSuccessResult$1 | ExecResultError;
 
-type DirLsParams = {
+type LsParams = {
     path?: string;
     limit?: number;
 };
@@ -1719,18 +1750,38 @@ type DirEntry = {
     mode?: number;
     lineCount?: number;
 };
-type DirLsSuccessResult$1 = {
+type LsSuccessResult$1 = {
     status: 'success';
-    type: 'json';
-    result: {
-        path: string;
-        entries: DirEntry[];
-        truncated: boolean;
-        total: number;
-    };
-    metadata?: DirLsMetadata;
+    type: 'text';
+    result: string;
+    metadata?: LsMetadata;
 };
-type DirLsResult = DirLsSuccessResult$1 | ExecResultError;
+type LsResult = LsSuccessResult$1 | ExecResultError;
+
+type GlobParams = {
+    pattern: string;
+    path?: string;
+};
+type GlobSuccessResult$1 = {
+    status: 'success';
+    type: 'text';
+    result: string;
+    metadata?: GlobToolMetadata;
+};
+type GlobResult = GlobSuccessResult$1 | ExecResultError;
+
+type GrepParams = {
+    pattern: string;
+    path?: string;
+    include?: string;
+};
+type GrepSuccessResult$1 = {
+    status: 'success';
+    type: 'text';
+    result: string;
+    metadata?: GrepToolMetadata;
+};
+type GrepResult = GrepSuccessResult$1 | ExecResultError;
 
 /**
  * WebSearchTool — Google Programmable Search Engine (CSE) ONLY
@@ -1849,7 +1900,9 @@ type BashSuccessResult = WithToolExecutionFields<BashSuccessResult$1>;
 type FileReadSuccessResult = WithToolExecutionFields<FileReadSuccessResult$1>;
 type FileEditSuccessResult = WithToolExecutionFields<FileEditSuccessResult$1>;
 type FileNewSuccessResult = WithToolExecutionFields<FileNewSuccessResult$1>;
-type DirLsSuccessResult = WithToolExecutionFields<DirLsSuccessResult$1>;
+type LsSuccessResult = WithToolExecutionFields<LsSuccessResult$1>;
+type GlobSuccessResult = WithToolExecutionFields<GlobSuccessResult$1>;
+type GrepSuccessResult = WithToolExecutionFields<GrepSuccessResult$1>;
 type WebSearchSuccessResult = WithToolExecutionFields<WebSearchSuccessResult$1>;
 type WebFetchSuccessResult = WithToolExecutionFields<WebFetchSuccessResult$1>;
 type TodoWriteSuccessResult = WithToolExecutionFields<TodoWriteSuccessResult$1>;
@@ -1862,8 +1915,12 @@ declare function isFileEditResult(result: ToolExecutionResult): result is ToolEx
 declare function isFileEditSuccess(result: ToolExecutionResult): result is FileEditSuccessResult;
 declare function isFileNewResult(result: ToolExecutionResult): result is ToolExecutionResult;
 declare function isFileNewSuccess(result: ToolExecutionResult): result is FileNewSuccessResult;
-declare function isDirLsResult(result: ToolExecutionResult): result is ToolExecutionResult;
-declare function isDirLsSuccess(result: ToolExecutionResult): result is DirLsSuccessResult;
+declare function isLsToolResult(result: ToolExecutionResult): result is ToolExecutionResult;
+declare function isLsToolSuccess(result: ToolExecutionResult): result is LsSuccessResult;
+declare function isGlobResult(result: ToolExecutionResult): result is ToolExecutionResult;
+declare function isGlobSuccess(result: ToolExecutionResult): result is GlobSuccessResult;
+declare function isGrepResult(result: ToolExecutionResult): result is ToolExecutionResult;
+declare function isGrepSuccess(result: ToolExecutionResult): result is GrepSuccessResult;
 declare function isWebSearchResult(result: ToolExecutionResult): result is ToolExecutionResult;
 declare function isWebSearchSuccess(result: ToolExecutionResult): result is WebSearchSuccessResult;
 declare function isWebFetchResult(result: ToolExecutionResult): result is ToolExecutionResult;
@@ -1973,17 +2030,6 @@ type SubAgentState = {
  */
 declare function parseSubAgentToolCallArguments(argsString?: string): Record<string, unknown>;
 
-type LogLevel = 'DEBUG' | 'INFO' | 'WARN' | 'ERROR';
-type LogFormat = 'json' | 'structured';
-type PersistOptions = {
-    persistFile?: string;
-    logLevel?: LogLevel;
-    logFormat?: LogFormat;
-    maxFileSize?: number;
-    enableConsoleLog?: boolean;
-    captureResponseBody?: boolean;
-};
-
 type HttpHeaders = Record<string, string>;
 interface TransportResponse {
     ok: boolean;
@@ -1995,36 +2041,6 @@ interface HttpTransport {
     get(url: string, headers?: HttpHeaders, signal?: AbortSignal): Promise<TransportResponse>;
     post(url: string, body: unknown, headers?: HttpHeaders, signal?: AbortSignal): Promise<Response>;
 }
-declare class FetchTransport implements HttpTransport {
-    private opts;
-    private logger;
-    constructor(opts?: PersistOptions);
-    private getResponseSize;
-    private headersToRecord;
-    post(url: string, body: unknown, headers?: HttpHeaders, signal?: AbortSignal): Promise<Response>;
-    get(url: string, headers?: HttpHeaders, signal?: AbortSignal): Promise<TransportResponse>;
-}
-
-declare class GithubAuthTransport implements HttpTransport {
-    private apiKey?;
-    private accessToken?;
-    private dynamicApiUrl?;
-    private readonly baseUrl;
-    private readonly inner;
-    constructor(inner: FetchTransport, opts: {
-        apiKey?: string;
-        accessToken?: string;
-        baseUrl?: string;
-    });
-    private exchangeToken;
-    private buildFullUrl;
-    private hasVisionPayload;
-    private makeAuthHeaders;
-    private determineInitiator;
-    private generateRequestId;
-    post(url: string, body: unknown, headers?: HttpHeaders, signal?: AbortSignal): Promise<Response>;
-    get(url: string, headers?: HttpHeaders, signal?: AbortSignal): Promise<TransportResponse>;
-}
 
 interface RetryConfig {
     maxRetries: number;
@@ -2054,6 +2070,15 @@ declare class RetryTransport implements HttpTransport {
 declare function isRetryableStatusCode(status: number, retryableStatusCodes?: number[]): boolean;
 declare function isRetryableError(error: unknown, retryableStatusCodes?: number[]): boolean;
 
+declare class LLMErrorTransport implements HttpTransport {
+    private inner;
+    constructor(inner: HttpTransport);
+    get(url: string, headers?: HttpHeaders, signal?: AbortSignal): Promise<TransportResponse>;
+    post(url: string, body: unknown, headers?: HttpHeaders, signal?: AbortSignal): Promise<Response>;
+    private throwLLMError;
+    private handleError;
+}
+
 interface BaseLLMOptions {
     enablePromptCaching?: boolean;
     retry?: Partial<RetryConfig>;
@@ -2072,6 +2097,7 @@ declare abstract class BaseLLM implements LLMPort {
     protected abstract createTransport(): HttpTransport;
     protected transformUsage(rawUsage: unknown): UsageData | undefined;
     protected getTransport(): HttpTransport;
+    protected throwResponseError(statusCode: number, message: string): never;
     protected applyCacheControl(params: CompletionParams): CompletionParams;
     generateCompletion(params: CompletionParams, signal?: AbortSignal): Promise<CompletionResult>;
     streamCompletion(params: CompletionParams, handlers?: {
@@ -2109,7 +2135,7 @@ type GithubOptions = {
 declare class GithubLLM extends BaseLLM implements LLMPort {
     private readonly opts;
     constructor(opts?: GithubOptions);
-    protected createTransport(): GithubAuthTransport | RetryTransport;
+    protected createTransport(): LLMErrorTransport;
     protected transformUsage(rawUsage: unknown): UsageData | undefined;
     getModels(signal?: AbortSignal): Promise<ModelInfo[]>;
     private handleError;
@@ -2285,4 +2311,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 AgentTemplate, AnthropicAISDKLLM, type AssignErrorResult, type AssignParams, type AssignResult, type AssignSuccessResult$1 as AssignSuccessResult, type AssignTaskArgs, type AssignTaskMetadata, type BaseLLMOptions, type BashErrorResult, type BashParams, type BashResult, type BashSuccessResult$1 as BashSuccessResult, BashTool, type BashToolArgs, type BashToolMetadata, CommandFilePersistence, type CommandMetadata, type CommandSource, type CompleteAgent, type CompleteCustomCommand, CompositeToolPort, type Conversation, ConversationContext, type ConversationMetadata, type ConversationSnapshot, ConversationStore, CoreMCPClient, type CustomCommandFrontmatter, type CustomCommandTemplate, DEFAULT_RETRY_CONFIG, DefaultDelegationPolicy, DefaultDelegationResultFormatter, DefaultDelegationService, DefaultSpecialistAgentFactory, type DelegationMetadata, type DelegationService, type DelegationServiceConfig, DelegationServiceFactory, type DirEntry, type DirLsArgs, type DirLsMetadata, type DirLsParams, type DirLsResult, type DirLsSuccessResult$1 as DirLsSuccessResult, 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, InMemoryMemory, InMemoryMetadata, InMemoryMetricsPort, JsonFileMemoryPersistence, type LLMConfig, LLMError, type LLMFactory, type LLMOptions, type LLMPort, LLMResolver, type LineRangeMetadata, 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, type ParseResult, PersistedMemory, PersistingConsoleEventPort, type RetryConfig, RetryTransport, RuntimeEnv, type SendMessageOptions, SimpleContextBuilder, SimpleCost, SimpleId, type SpecialistAgentConfig, type SpecialistAgentResult, type SubAgentState, type SubAgentToolCall, SystemClock, type TodoWriteArgs, type TodoWriteMetadata, type TodoWriteResult, type TodoWriteSuccessResult$1 as TodoWriteSuccessResult, type ToolApprovalDecision, type ToolArguments, type ToolCall, 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 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, buildAgentCreationPrompt, buildInjectedSystem, canonicalizeTerminalPaste, convertToolCall, convertToolCalls, createEmptySnapshot, createLLM, deduplicateModels, err, generateFolderTree, getAvailableProviders, getFallbackLimits, getProviderLabel, isAssignResult, isAssignSuccess, isAssignTaskArgs, isBashResult, isBashSuccess, isBashToolArgs, isDirLsArgs, isDirLsResult, isDirLsSuccess, isError, isFileEditArgs, isFileEditResult, isFileEditSuccess, isFileNewArgs, isFileNewResult, isFileNewSuccess, isFileReadArgs, isFileReadResult, isFileReadSuccess, isJsonResult, isRetryableError, isRetryableStatusCode, isSuccess, isSuccessJson, isSuccessText, isTextResult, isTodoWriteArgs, isTodoWriteResult, isTodoWriteSuccess, isValidCommandId, isWebFetchArgs, isWebFetchResult, isWebFetchSuccess, isWebSearchArgs, isWebSearchResult, isWebSearchSuccess, normalizeModelInfo, normalizeModelLimits, normalizeNewlines, okJson, okText, parseJSON, parseSubAgentToolCallArguments, parseToolArguments, renderTemplate, resolveBackspaces, resolveCarriageReturns, sanitizeCommandId, stripAnsiAndControls, supportsGetModels, toolValidators };
+export { AGENT_CREATOR_SYSTEM_PROMPT, AbortError, type AgentAwareToolPort, type AgentCatalog, type AgentConfig, type AgentEvent, AgentEventTypes, AgentFilePersistence, AgentManager, AgentManagerCommandRunner, AgentOrchestrator, AgentRegistry, type AgentTemplate, AnthropicAISDKLLM, type AssignErrorResult, type AssignParams, type AssignResult, type AssignSuccessResult$1 as AssignSuccessResult, type AssignTaskArgs, type AssignTaskMetadata, type BaseLLMOptions, type BashErrorResult, type BashParams, type BashResult, type BashSuccessResult$1 as BashSuccessResult, BashTool, type BashToolArgs, type BashToolMetadata, CommandFilePersistence, type CommandMetadata, type CommandSource, type CompleteAgent, type CompleteCustomCommand, CompositeToolPort, type Conversation, ConversationContext, type ConversationMetadata, type ConversationSnapshot, ConversationStore, CoreMCPClient, type CustomCommandFrontmatter, type CustomCommandTemplate, DEFAULT_RETRY_CONFIG, DefaultDelegationPolicy, DefaultDelegationResultFormatter, 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, 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 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, type ParseResult, PersistedMemory, PersistingConsoleEventPort, type RetryConfig, RetryTransport, RuntimeEnv, type SendMessageOptions, SimpleContextBuilder, SimpleCost, SimpleId, type SpecialistAgentConfig, type SpecialistAgentResult, type SubAgentState, type SubAgentToolCall, SystemClock, type TodoWriteArgs, type TodoWriteMetadata, type TodoWriteResult, type TodoWriteSuccessResult$1 as TodoWriteSuccessResult, type ToolApprovalDecision, type ToolArguments, type ToolCall, 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 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, buildAgentCreationPrompt, buildInjectedSystem, canonicalizeTerminalPaste, convertToolCall, convertToolCalls, createEmptySnapshot, createLLM, deduplicateModels, err, generateFolderTree, getAvailableProviders, getFallbackLimits, getProviderLabel, isAssignResult, isAssignSuccess, isAssignTaskArgs, isBashResult, isBashSuccess, isBashToolArgs, isError, isFileEditArgs, isFileEditResult, isFileEditSuccess, isFileNewArgs, isFileNewResult, isFileNewSuccess, isFileReadArgs, isFileReadResult, isFileReadSuccess, isGlobArgs, isGlobResult, isGlobSuccess, isGrepArgs, isGrepResult, isGrepSuccess, isJsonResult, isLsArgs, isLsToolResult, isLsToolSuccess, isRetryableError, isRetryableStatusCode, isSuccess, isSuccessJson, isSuccessText, isTextResult, isTodoWriteArgs, isTodoWriteResult, isTodoWriteSuccess, isValidCommandId, isWebFetchArgs, isWebFetchResult, isWebFetchSuccess, isWebSearchArgs, isWebSearchResult, isWebSearchSuccess, normalizeModelInfo, normalizeModelLimits, normalizeNewlines, okJson, okText, parseJSON, parseSubAgentToolCallArguments, parseToolArguments, renderTemplate, resolveBackspaces, resolveCarriageReturns, sanitizeCommandId, stripAnsiAndControls, supportsGetModels, toolValidators };