@nuvin/nuvin-core 2.0.0-rc.0 → 2.0.0-rc.2

package/dist/VERSION

@@ -1,4 +1,4 @@
 {
-  "version": "2.0.0-rc.0",
-  "commit": "91054e4"
+  "version": "2.0.0-rc.2",
+  "commit": "96b6846"
 }

package/dist/index.d.ts

@@ -1434,6 +1434,10 @@ type InjectedSystemParams = {
         name: string;
         description: string;
     }>;
+    availableSkills?: Array<{
+        name: string;
+        description: string;
+    }>;
     folderTree?: string;
     shell?: string;
     gitBranch?: string;
@@ -1495,6 +1499,103 @@ declare class PersistedMemory<T = unknown> implements MemoryPort<T> {
     importSnapshot(snapshot: MemorySnapshot<T>): Promise<void>;
 }
 
+type MemoryType = 'semantic' | 'episodic' | 'procedural';
+type MemoryScope = 'global' | 'project';
+type MemorySource = 'extracted' | 'explicit' | 'imported';
+interface MemoryEntry {
+    id: string;
+    content: string;
+    type: MemoryType;
+    scope: MemoryScope;
+    tags: string[];
+    createdAt: string;
+    updatedAt: string;
+    accessCount: number;
+    lastAccessedAt: string;
+    source: MemorySource;
+}
+interface MemorySearchOptions {
+    type?: MemoryType;
+    scope?: MemoryScope;
+    tags?: string[];
+    limit?: number;
+}
+interface MemoryStorePort {
+    add(entry: Omit<MemoryEntry, 'id' | 'createdAt' | 'updatedAt' | 'accessCount' | 'lastAccessedAt'>): Promise<MemoryEntry>;
+    update(id: string, updates: Partial<Pick<MemoryEntry, 'content' | 'tags'>>): Promise<MemoryEntry | null>;
+    delete(id: string): Promise<boolean>;
+    get(id: string): Promise<MemoryEntry | null>;
+    search(options?: MemorySearchOptions): Promise<MemoryEntry[]>;
+    getAll(): Promise<MemoryEntry[]>;
+    recordAccess(id: string): Promise<void>;
+    clear(scope?: MemoryScope): Promise<void>;
+}
+
+/**
+ * JSON file-backed implementation of MemoryStorePort.
+ *
+ * Persists entries as a flat JSON array at `{dir}/memories.json`.
+ * Lazy-loads from disk on first access; eagerly persists on every mutation.
+ */
+declare class JsonFileMemoryStore implements MemoryStorePort {
+    private entries;
+    private initialized;
+    private readonly filePath;
+    constructor(dir: string);
+    private ensureInitialized;
+    private loadFromDisk;
+    private persist;
+    private now;
+    private generateId;
+    add(input: Omit<MemoryEntry, 'id' | 'createdAt' | 'updatedAt' | 'accessCount' | 'lastAccessedAt'>): Promise<MemoryEntry>;
+    update(id: string, updates: Partial<Pick<MemoryEntry, 'content' | 'tags'>>): Promise<MemoryEntry | null>;
+    delete(id: string): Promise<boolean>;
+    get(id: string): Promise<MemoryEntry | null>;
+    search(options?: MemorySearchOptions): Promise<MemoryEntry[]>;
+    getAll(): Promise<MemoryEntry[]>;
+    recordAccess(id: string): Promise<void>;
+    clear(scope?: MemoryScope): Promise<void>;
+}
+
+/**
+ * Ranks memory entries by a composite score combining recency, frequency, and
+ * type importance. Returns entries sorted descending by score.
+ *
+ * Score formula: recencyScore * 0.5 + frequencyScore * 0.3 + typeWeight * 0.2
+ */
+declare function rankMemories(entries: MemoryEntry[], limit?: number): MemoryEntry[];
+/**
+ * Formats a list of memory entries into a prompt-ready markdown string.
+ *
+ * Groups entries by type under labelled section headers, ordered:
+ * semantic → episodic → procedural. Each entry is rendered as a bullet.
+ * Returns an empty string when entries is empty.
+ */
+declare function formatMemoriesForPrompt(entries: MemoryEntry[]): string;
+
+type MemoryCandidate = {
+    content: string;
+    type: MemoryType;
+    tags: string[];
+};
+declare class MemoryExtractor {
+    /**
+     * Builds a prompt string instructing an LLM to extract memories from the
+     * given conversation messages.
+     *
+     * Returns an empty string when the messages array is empty so callers can
+     * skip the LLM call entirely.
+     */
+    buildExtractionPrompt(messages: Message[]): string;
+    /**
+     * Parses an LLM response into an array of MemoryCandidates.
+     *
+     * Tolerates JSON wrapped in markdown code fences and silently discards any
+     * items that have invalid or missing fields. Never throws.
+     */
+    parseExtractionResponse(response: string): MemoryCandidate[];
+}
+
 declare class MemoryPortMetadataAdapter<T> implements MetadataPort<T> {
     private memory;
     private prefix;
@@ -1891,6 +1992,10 @@ type SystemContext = {
     gitRepo?: string;
     recentCommits?: string;
     folderTree?: string;
+    availableSkills?: Array<{
+        name: string;
+        description: string;
+    }>;
 };
 type AgentInfo = {
     id: string;
@@ -2040,6 +2145,44 @@ declare class LLMResolver {
     resolve(config: SpecialistAgentConfig): LLMPort;
 }
 
+declare const memorySaveToolDefinition: {
+    name: string;
+    description: string;
+    parameters: {
+        type: "object";
+        properties: {
+            content: {
+                type: string;
+                description: string;
+            };
+            type: {
+                type: string;
+                enum: string[];
+                description: string;
+            };
+            scope: {
+                type: string;
+                enum: string[];
+                description: string;
+            };
+            tags: {
+                type: string;
+                items: {
+                    type: string;
+                };
+                description: string;
+            };
+        };
+        required: string[];
+    };
+};
+interface MemorySaveToolInput {
+    content: string;
+    type: 'semantic' | 'episodic' | 'procedural';
+    scope: 'global' | 'project';
+    tags?: string[];
+}
+
 declare class ToolRegistry implements ToolPort, AgentAwareToolPort, OrchestratorAwareToolPort {
     private tools;
     private toolsMemory?;
@@ -2049,6 +2192,7 @@ declare class ToolRegistry implements ToolPort, AgentAwareToolPort, Orchestrator
     private lspTool?;
     private skillTool?;
     private enabledAgentsConfig;
+    private memoryHandler;
     private orchestratorConfig?;
     private orchestratorTools?;
     private orchestratorLLMFactory?;
@@ -2063,6 +2207,11 @@ declare class ToolRegistry implements ToolPort, AgentAwareToolPort, Orchestrator
     setLspService(service: LspService): void;
     setSkillProvider(provider: SkillProvider): void;
     updateSkillToolDescription(): void;
+    /**
+     * Wire the memory_save tool handler from the CLI layer.
+     * Called after the MemoryService is available (in OrchestratorManager.init).
+     */
+    setMemoryHandler(handler: (input: MemorySaveToolInput) => Promise<string>): void;
     private persistToolNames;
     listRegisteredTools(): Promise<string[]>;
     getToolDefinitions(enabledTools: string[]): ToolDefinition[];
@@ -3425,4 +3574,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, 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 };
+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, JsonFileMemoryStore, 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 MemoryCandidate, type MemoryEntry, MemoryExtractor, type MemoryPort, MemoryPortMetadataAdapter, type MemorySaveToolInput, type MemoryScope, type MemorySearchOptions, type MemorySource, type MemoryStorePort, type MemoryType, 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, formatMemoriesForPrompt, 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, memorySaveToolDefinition, mergeAgentConfig, normalizeModelInfo, normalizeModelLimits, normalizeNewlines, okJson, okText, parseJSON, parseSubAgentToolCallArguments, parseToolArguments, parseWWWAuthenticate, rankMemories, renderTemplate, resolveBackspaces, resolveCarriageReturns, sanitizeCommandId, stripAnsiAndControls, supportsGetModels, todoWriteSchema, toolSchemas, toolValidators, validateToolParams, webFetchSchema, webSearchSchema };