@nuvin/nuvin-core 2.0.0 → 2.1.0-rc.1

package/dist/VERSION

@@ -1,4 +1,4 @@
 {
-  "version": "2.0.0",
-  "commit": "6b69079"
+  "version": "2.1.0-rc.1",
+  "commit": "f897e19"
 }

package/dist/index.d.ts

@@ -409,6 +409,8 @@ type FileReadMetadata = FileMetadata & {
     lineRange?: LineRangeMetadata;
     encoding?: string;
     bomStripped?: boolean;
+    truncated?: boolean;
+    totalLines?: number;
 };
 type FileEditMetadata = FileMetadata & {
     eol: 'lf' | 'crlf';
@@ -1330,6 +1332,7 @@ declare class AgentOrchestrator {
     private memory;
     private hookPort?;
     private sessionId;
+    private sessionDir;
     constructor(cfg: AgentConfig, deps: {
         memory: MemoryPort<Message>;
         tools: ToolPort;
@@ -1405,6 +1408,14 @@ declare class AgentOrchestrator {
      * Gets the current session ID.
      */
     getSessionId(): string;
+    /**
+     * Updates the session directory path.
+     */
+    setSessionDir(dir: string | null): void;
+    /**
+     * Gets the current session directory path.
+     */
+    getSessionDir(): string | null;
     /**
      * Checks if hooks are registered for an event type.
      */
@@ -1833,6 +1844,7 @@ type ToolExecutionContext = {
     conversationId?: string;
     agentId?: string;
     sessionId?: string;
+    sessionDir?: string;
     workspaceDir?: string;
     delegationDepth?: number;
     messageId?: string;
@@ -3268,6 +3280,41 @@ declare function convertToolCallsWithErrorHandling(toolCalls: ToolCall[], option
     availableTools?: Set<string>;
 }): ToolCallConversionResult;
 
+type SpillOptions = {
+    /** Full output content to write */
+    content: string | Buffer;
+    /** Tool name, e.g. 'bash_tool' */
+    toolName: string;
+    /** Unique tool call ID */
+    toolCallId: string;
+    /** Session directory — if null, falls back to os.tmpdir() */
+    sessionDir?: string | null;
+};
+/**
+ * Write tool output to a session-scoped file.
+ *
+ * File is written as `{toolName}_{toolCallId}.log` inside the session
+ * directory (or os.tmpdir() if no session dir is available).
+ *
+ * @returns The absolute path of the written file
+ */
+declare function spillToolOutput(opts: SpillOptions): string;
+/**
+ * Open a spill file for incremental writing.
+ *
+ * Returns an object with `write()` to append chunks and `close()` to finalize.
+ * Call `close()` to get the final file path.
+ */
+declare function openToolOutputSpill(opts: Omit<SpillOptions, 'content'>): ToolOutputSpillHandle;
+interface ToolOutputSpillHandle {
+    /** Absolute path of the spill file */
+    readonly path: string;
+    /** Append a chunk to the spill file */
+    write(chunk: string | Buffer): void;
+    /** Close the file descriptor */
+    close(): void;
+}
+
 type FileReadParams = {
     path: string;
     lineStart?: number;
@@ -4266,4 +4313,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 AXElement, type AXPressResult, type AXSetValueResult, type AXSnapshotResult, AbortError, type AgentAwareToolPort, type AgentCatalog, type AgentConfig, type AgentEvent, AgentEventTypes, AgentFilePersistence, AgentManager, AgentManagerCommandRunner, AgentOrchestrator, AgentRegistry, type AgentSession, type AgentStateManager, type AgentTemplate, type AnnotateResult, AnthropicAISDKLLM, type AskUserArgs, type AskUserMetadata, AskUserTool, type AssignAliasHiddenAgentResolver, type AssignAliasTask, AssignAliasTool, type AssignAliasToolOptions, 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 ComputerAction, type ComputerBackend, type ComputerUseArgs, type ComputerUseMetadata, type ComputerUseParams, type ComputerUseResult, ComputerUseTool, 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, type MemoryEntryInput, type MemoryExtractArgs, type MemoryExtractToolInput, type MemoryExtractToolResult, type MemoryExtractionTaskBuilder, MemoryExtractionTool, MemoryExtractor, type MemoryPort, MemoryPortMetadataAdapter, type MemoryQueryArgs, type MemoryQueryToolHit, type MemoryQueryToolInput, type MemoryQueryToolResult, type MemorySaveToolInput, type MemoryScope, type MemorySearchOptions, type MemorySource, type MemoryStatement, type MemoryStatus, 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, computerToolSchema, 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, isComputerResult, isComputerSuccess, isComputerUseArgs, isError, isFileEditArgs, isFileEditResult, isFileEditSuccess, isFileNewArgs, isFileNewResult, isFileNewSuccess, isFileReadArgs, isFileReadResult, isFileReadSuccess, isGlobArgs, isGlobResult, isGlobSuccess, isGrepArgs, isGrepResult, isGrepSuccess, isInsufficientScopeError, isJsonResult, isLsArgs, isLsToolResult, isLsToolSuccess, isMemoryExtractArgs, isMemoryQueryArgs, isRetryableError, isRetryableStatusCode, isSuccess, isSuccessJson, isSuccessText, isTextResult, isTodoWriteArgs, isTodoWriteResult, isTodoWriteSuccess, isUnauthorizedError, isValidCommandId, isWebFetchArgs, isWebFetchResult, isWebFetchSuccess, isWebSearchArgs, isWebSearchResult, isWebSearchSuccess, loadHooksFromFrontmatter, lsToolSchema, memoryExtractSchema, memoryQuerySchema, memoryQueryToolDefinition, memorySaveToolDefinition, mergeAgentConfig, normalizeModelInfo, normalizeModelLimits, normalizeNewlines, okJson, okText, parseJSON, parseSubAgentToolCallArguments, parseToolArguments, parseWWWAuthenticate, rankMemories, renderTemplate, resolveBackspaces, resolveCarriageReturns, safeParseToolArguments, sanitizeCommandId, stripAnsiAndControls, supportsGetModels, todoWriteSchema, toolSchemas, toolValidators, validateToolParams, webFetchSchema, webSearchSchema };
+export { AGENT_CREATOR_SYSTEM_PROMPT, type AXElement, type AXPressResult, type AXSetValueResult, type AXSnapshotResult, AbortError, type AgentAwareToolPort, type AgentCatalog, type AgentConfig, type AgentEvent, AgentEventTypes, AgentFilePersistence, AgentManager, AgentManagerCommandRunner, AgentOrchestrator, AgentRegistry, type AgentSession, type AgentStateManager, type AgentTemplate, type AnnotateResult, AnthropicAISDKLLM, type AskUserArgs, type AskUserMetadata, AskUserTool, type AssignAliasHiddenAgentResolver, type AssignAliasTask, AssignAliasTool, type AssignAliasToolOptions, 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 ComputerAction, type ComputerBackend, type ComputerUseArgs, type ComputerUseMetadata, type ComputerUseParams, type ComputerUseResult, ComputerUseTool, 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, type MemoryEntryInput, type MemoryExtractArgs, type MemoryExtractToolInput, type MemoryExtractToolResult, type MemoryExtractionTaskBuilder, MemoryExtractionTool, MemoryExtractor, type MemoryPort, MemoryPortMetadataAdapter, type MemoryQueryArgs, type MemoryQueryToolHit, type MemoryQueryToolInput, type MemoryQueryToolResult, type MemorySaveToolInput, type MemoryScope, type MemorySearchOptions, type MemorySource, type MemoryStatement, type MemoryStatus, 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 SpillOptions, 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 ToolOutputSpillHandle, 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, computerToolSchema, 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, isComputerResult, isComputerSuccess, isComputerUseArgs, isError, isFileEditArgs, isFileEditResult, isFileEditSuccess, isFileNewArgs, isFileNewResult, isFileNewSuccess, isFileReadArgs, isFileReadResult, isFileReadSuccess, isGlobArgs, isGlobResult, isGlobSuccess, isGrepArgs, isGrepResult, isGrepSuccess, isInsufficientScopeError, isJsonResult, isLsArgs, isLsToolResult, isLsToolSuccess, isMemoryExtractArgs, isMemoryQueryArgs, isRetryableError, isRetryableStatusCode, isSuccess, isSuccessJson, isSuccessText, isTextResult, isTodoWriteArgs, isTodoWriteResult, isTodoWriteSuccess, isUnauthorizedError, isValidCommandId, isWebFetchArgs, isWebFetchResult, isWebFetchSuccess, isWebSearchArgs, isWebSearchResult, isWebSearchSuccess, loadHooksFromFrontmatter, lsToolSchema, memoryExtractSchema, memoryQuerySchema, memoryQueryToolDefinition, memorySaveToolDefinition, mergeAgentConfig, normalizeModelInfo, normalizeModelLimits, normalizeNewlines, okJson, okText, openToolOutputSpill, parseJSON, parseSubAgentToolCallArguments, parseToolArguments, parseWWWAuthenticate, rankMemories, renderTemplate, resolveBackspaces, resolveCarriageReturns, safeParseToolArguments, sanitizeCommandId, spillToolOutput, stripAnsiAndControls, supportsGetModels, todoWriteSchema, toolSchemas, toolValidators, validateToolParams, webFetchSchema, webSearchSchema };