@nuvin/nuvin-core 1.14.1 → 1.16.0

package/dist/VERSION

@@ -1,4 +1,4 @@
 {
-  "version": "1.14.1",
-  "commit": "c5c2537"
+  "version": "1.16.0",
+  "commit": "6f699bb"
 }

package/dist/index.d.ts

@@ -1416,6 +1416,169 @@ interface FunctionTool<P = Record<string, unknown>, C = ToolExecutionContext, R
     execute(params: P, context?: C): Promise<R> | R;
 }
 
+type SkillParams = {
+    name: string;
+};
+type SkillMetadata = {
+    name: string;
+    dir: string;
+};
+type SkillSuccessResult = {
+    status: 'success';
+    type: 'text';
+    result: string;
+    metadata: SkillMetadata;
+};
+type SkillErrorResult = ExecResultError & {
+    metadata?: {
+        name?: string;
+        errorReason?: ErrorReason;
+    };
+};
+type SkillResult = SkillSuccessResult | SkillErrorResult;
+interface SkillInfo {
+    name: string;
+    description: string;
+    location: string;
+}
+interface SkillProvider {
+    get(name: string): Promise<SkillInfo | null>;
+    getAll(): Promise<Record<string, SkillInfo>>;
+    buildToolDescription(): string;
+    getPermission(name: string): 'allow' | 'ask' | 'deny';
+}
+declare class SkillTool implements FunctionTool<SkillParams, ToolExecutionContext, SkillResult> {
+    name: "skill";
+    private provider;
+    private dynamicDescription;
+    parameters: {
+        readonly type: "object";
+        readonly properties: {
+            readonly name: {
+                readonly type: "string";
+                readonly description: "The skill identifier from available_skills (e.g., \"front-end-skill\" or \"vitest-skill\")";
+            };
+        };
+        readonly required: readonly ["name"];
+    };
+    setProvider(provider: SkillProvider): void;
+    updateDescription(): void;
+    definition(): ToolDefinition['function'];
+    execute(params: SkillParams, _context?: ToolExecutionContext): Promise<SkillResult>;
+}
+
+type LspOperation = 'goToDefinition' | 'findReferences' | 'hover' | 'documentSymbol' | 'workspaceSymbol' | 'goToImplementation' | 'prepareCallHierarchy' | 'incomingCalls' | 'outgoingCalls' | 'diagnostics';
+type LspParams = {
+    operation: LspOperation;
+    filePath: string;
+    line: number;
+    character: number;
+    query?: string;
+};
+type LspSuccessResult = {
+    status: 'success';
+    type: 'text';
+    result: string;
+    metadata?: {
+        operation: LspOperation;
+        filePath: string;
+        line: number;
+        character: number;
+        resultCount?: number;
+    };
+};
+type LspResult = LspSuccessResult | ExecResultError;
+interface LspService {
+    init(): Promise<void>;
+    isEnabled(): boolean;
+    hasClients(file: string): Promise<boolean>;
+    touchFile(filePath: string, waitDiagnostics?: boolean): Promise<void>;
+    diagnostics(): Promise<Record<string, unknown[]>>;
+    diagnosticsForFile(filePath: string): Promise<unknown[]>;
+    definition(pos: {
+        file: string;
+        line: number;
+        character: number;
+    }): Promise<unknown[]>;
+    references(pos: {
+        file: string;
+        line: number;
+        character: number;
+    }): Promise<unknown[]>;
+    hover(pos: {
+        file: string;
+        line: number;
+        character: number;
+    }): Promise<unknown | null>;
+    documentSymbol(uri: string): Promise<unknown[]>;
+    workspaceSymbol(query: string): Promise<unknown[]>;
+    implementation(pos: {
+        file: string;
+        line: number;
+        character: number;
+    }): Promise<unknown[]>;
+    prepareCallHierarchy(pos: {
+        file: string;
+        line: number;
+        character: number;
+    }): Promise<unknown[]>;
+    incomingCalls(pos: {
+        file: string;
+        line: number;
+        character: number;
+    }): Promise<unknown[]>;
+    outgoingCalls(pos: {
+        file: string;
+        line: number;
+        character: number;
+    }): Promise<unknown[]>;
+}
+type LspToolOptions = {
+    rootDir?: string;
+    lspService?: LspService;
+};
+declare class LspTool implements FunctionTool<LspParams, ToolExecutionContext, LspResult> {
+    name: "lsp";
+    private readonly rootDir;
+    private lspService?;
+    constructor(opts?: LspToolOptions);
+    setLspService(service: LspService): void;
+    parameters: {
+        readonly type: "object";
+        readonly properties: {
+            readonly operation: {
+                readonly type: "string";
+                readonly enum: LspOperation[];
+                readonly description: "The LSP operation to perform";
+            };
+            readonly filePath: {
+                readonly type: "string";
+                readonly description: "The absolute or relative path to the file";
+            };
+            readonly line: {
+                readonly type: "number";
+                readonly description: "The line number (1-based, as shown in editors)";
+            };
+            readonly character: {
+                readonly type: "number";
+                readonly description: "The character offset (1-based, as shown in editors)";
+            };
+            readonly query: {
+                readonly type: "string";
+                readonly description: "Search query for workspaceSymbol operation (optional)";
+            };
+        };
+        readonly required: readonly ["operation", "filePath", "line", "character"];
+    };
+    definition(): ToolDefinition['function'];
+    execute(params: LspParams, context?: ToolExecutionContext): Promise<LspResult>;
+    private formatResult;
+    private formatHover;
+    private formatDiagnostics;
+    private formatLocations;
+    private formatSymbols;
+}
+
 interface AgentCatalog {
     list(): AgentTemplate[];
     get(agentId: string): AgentTemplate | undefined;
@@ -1613,6 +1776,8 @@ declare class ToolRegistry implements ToolPort, AgentAwareToolPort, Orchestrator
     private agentRegistry;
     private delegationServiceFactory?;
     private assignTool?;
+    private lspTool?;
+    private skillTool?;
     private enabledAgentsConfig;
     private orchestratorConfig?;
     private orchestratorTools?;
@@ -1623,7 +1788,12 @@ declare class ToolRegistry implements ToolPort, AgentAwareToolPort, Orchestrator
         toolsMemory?: MemoryPort<string>;
         agentRegistry?: AgentRegistry;
         delegationServiceFactory?: DelegationServiceFactory;
+        enableLsp?: boolean;
+        enableSkills?: boolean;
     });
+    setLspService(service: LspService): void;
+    setSkillProvider(provider: SkillProvider): void;
+    updateSkillToolDescription(): void;
     private persistToolNames;
     listRegisteredTools(): Promise<string[]>;
     getToolDefinitions(enabledTools: string[]): ToolDefinition[];
@@ -2605,4 +2775,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 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, 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, 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 TaskOutputMetadata, type TaskOutputParams, type TaskOutputResult, type TaskOutputSuccessResult, type TodoWriteArgs, type TodoWriteMetadata, type TodoWriteResult, type TodoWriteSuccessResult$1 as TodoWriteSuccessResult, 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, isJsonResult, isLsArgs, isLsToolResult, isLsToolSuccess, isRetryableError, isRetryableStatusCode, isSuccess, isSuccessJson, isSuccessText, isTextResult, isTodoWriteArgs, isTodoWriteResult, isTodoWriteSuccess, isValidCommandId, isWebFetchArgs, isWebFetchResult, isWebFetchSuccess, isWebSearchArgs, isWebSearchResult, isWebSearchSuccess, lsToolSchema, normalizeModelInfo, normalizeModelLimits, normalizeNewlines, okJson, okText, parseJSON, parseSubAgentToolCallArguments, parseToolArguments, 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 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, 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, 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 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 SkillErrorResult, type SkillMetadata, type SkillParams, type SkillProvider, type SkillResult, type SkillSuccessResult, SkillTool, type SkillInfo as SkillToolInfo, type SpecialistAgentConfig, type SpecialistAgentResult, 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 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, isJsonResult, isLsArgs, isLsToolResult, isLsToolSuccess, isRetryableError, isRetryableStatusCode, isSuccess, isSuccessJson, isSuccessText, isTextResult, isTodoWriteArgs, isTodoWriteResult, isTodoWriteSuccess, isValidCommandId, isWebFetchArgs, isWebFetchResult, isWebFetchSuccess, isWebSearchArgs, isWebSearchResult, isWebSearchSuccess, lsToolSchema, normalizeModelInfo, normalizeModelLimits, normalizeNewlines, okJson, okText, parseJSON, parseSubAgentToolCallArguments, parseToolArguments, renderTemplate, resolveBackspaces, resolveCarriageReturns, sanitizeCommandId, stripAnsiAndControls, supportsGetModels, todoWriteSchema, toolSchemas, toolValidators, validateToolParams, webFetchSchema, webSearchSchema };