@nuvin/agent-core 0.0.0-rc.1 → 0.0.0-rc.3

package/dist/tools/index.d.ts

@@ -1,473 +1,1021 @@
-import { aZ as ToolDefinition, aq as ToolOutputEnvelope, a_ as AnyToolDefinition, aT as ToolRuntimeEventHandler, aS as ToolRuntimeToolCallHandler, aV as ToolRuntime, H as JsonObject, V as JsonSchemaObject, W as JsonSchema, b8 as AgentDefinitionFactoryContext, A as AgentOptions, aX as ToolOutputValue, ap as ToolResultChunk, aW as InferJsonSchema, av as ToolExecutionContext, af as ToolSchema, I as JsonValue } from '../types-D11KxtW1.js';
+// Generated by dts-bundle-generator v9.5.1
+
 import { OAuthClientProvider } from '@modelcontextprotocol/sdk/client/auth.js';
-import { MCPAuthConfig, MCPServerConfig } from '@nuvin/config';
 import { CallToolResult, ListToolsResult } from '@modelcontextprotocol/sdk/types.js';
 
-interface BashToolInput {
-    command: string;
-    cwd?: string;
-    timeoutMs?: number;
-    ignoreOutput?: boolean;
-}
-interface BashToolOptions {
-    defaultCwd?: string;
-    defaultTimeoutMs?: number;
-    description?: string;
-    env?: NodeJS.ProcessEnv;
-    name?: string;
-    shellPath?: string;
-    stripAnsi?: boolean;
-}
-declare function createBashTool(options?: BashToolOptions): ToolDefinition<{
-    command: string;
-    cwd?: string | undefined;
-    timeoutMs?: number | undefined;
-    ignoreOutput?: boolean | undefined;
+export type JsonPrimitive = boolean | number | string | null;
+export interface JsonObject {
+	[key: string]: JsonValue;
+}
+export type JsonValue = JsonObject | JsonPrimitive | JsonValue[];
+export interface JsonSchemaString {
+	type: "string";
+}
+export interface JsonSchemaNumber {
+	type: "number";
+}
+export interface JsonSchemaBoolean {
+	type: "boolean";
+}
+export interface JsonSchemaArray<TItem extends JsonSchema = JsonSchema> {
+	type: "array";
+	items: TItem;
+}
+export interface JsonSchemaObject<TProperties extends Record<string, JsonSchema> = Record<string, JsonSchema>, TRequired extends readonly string[] | undefined = readonly string[] | undefined> {
+	type: "object";
+	properties: TProperties;
+	required?: TRequired;
+}
+export type JsonSchema = JsonSchemaArray | JsonSchemaBoolean | JsonSchemaNumber | JsonSchemaObject | JsonSchemaString;
+export interface TextBlock {
+	type: "text";
+	text: string;
+}
+export type ImageMediaType = "image/gif" | "image/jpeg" | "image/png" | "image/webp";
+export interface ImageBlock {
+	type: "image";
+	source: {
+		type: "base64";
+		media_type: ImageMediaType;
+		data: string;
+	};
+}
+export type ToolResultContentBlock = ImageBlock | TextBlock;
+export type ToolResultContent = string | ToolResultContentBlock[];
+export interface AnthropicThinkingBlock {
+	type: "anthropic_thinking";
+	thinking: string;
+	signature: string;
+}
+export interface AnthropicRedactedThinkingBlock {
+	type: "anthropic_redacted_thinking";
+	data: string;
+}
+export interface OpenAiReasoningSummaryText {
+	type: "summary_text";
+	text: string;
+}
+export interface OpenAiReasoningBlock {
+	type: "openai_reasoning";
+	encryptedContent?: string;
+	id?: string;
+	summary: OpenAiReasoningSummaryText[];
+	text?: string;
+}
+export interface ToolUseBlock {
+	type: "tool_use";
+	id: string;
+	name: string;
+	input: JsonValue;
+}
+export interface ToolResultBlock {
+	type: "tool_result";
+	tool_use_id: string;
+	content: ToolResultContent;
+	is_error: boolean;
+}
+export interface AnthropicThinkingWireBlock {
+	type: "thinking";
+	thinking: string;
+	signature: string;
+}
+export interface AnthropicRedactedThinkingWireBlock {
+	type: "redacted_thinking";
+	data: string;
+}
+export type AnthropicAssistantContentBlock = AnthropicRedactedThinkingWireBlock | AnthropicThinkingWireBlock | TextBlock | ToolUseBlock;
+export type ReasoningVisibility = "continuity-only" | "user-visible";
+export type AutoReasoningEffort = "low" | "medium" | "high";
+export interface AutoReasoningConfig {
+	effort: AutoReasoningEffort;
+}
+export type AnthropicThinkingDisplay = "omitted" | "summarized";
+export type AnthropicThinkingEffort = "low" | "medium" | "high";
+export interface AnthropicEnabledThinkingConfig {
+	type: "enabled";
+	budgetTokens: number;
+	display?: AnthropicThinkingDisplay;
+	interleaved?: boolean;
+}
+export interface AnthropicAdaptiveThinkingConfig {
+	type: "adaptive";
+	display?: AnthropicThinkingDisplay;
+	effort?: AnthropicThinkingEffort;
+	interleaved?: boolean;
+}
+export interface AnthropicDisabledThinkingConfig {
+	type: "disabled";
+}
+export type AnthropicThinkingConfig = AnthropicAdaptiveThinkingConfig | AnthropicDisabledThinkingConfig | AnthropicEnabledThinkingConfig;
+export type OpenAiReasoningEffort = "high" | "low" | "medium" | "minimal" | "none" | "xhigh";
+export type OpenAiReasoningSummary = "auto" | "concise" | "detailed";
+export interface OpenAiReasoningConfig {
+	effort?: OpenAiReasoningEffort;
+	includeEncryptedContent?: boolean;
+	summary?: OpenAiReasoningSummary;
+}
+export interface ReasoningConfig {
+	auto?: AutoReasoningConfig;
+	anthropic?: AnthropicThinkingConfig;
+	openai?: OpenAiReasoningConfig;
+	visibility?: ReasoningVisibility;
+}
+export interface MessageProviderState {
+	anthropicAssistantContent?: AnthropicAssistantContentBlock[];
+	openaiResponsesOutput?: OpenAiResponsesOutputItem[];
+	openaiResponsesResponseId?: string;
+}
+export type AssistantContentBlock = AnthropicRedactedThinkingBlock | AnthropicThinkingBlock | OpenAiReasoningBlock | TextBlock | ToolUseBlock;
+export type ContentBlock = AssistantContentBlock | ToolResultBlock;
+export type ContentInput = ContentBlock[] | string | null | undefined;
+export type MessageRole = "assistant" | "user";
+export interface Message {
+	id?: string;
+	role: MessageRole;
+	content: ContentBlock[];
+	providerState?: MessageProviderState;
+}
+export interface IdentifiedMessage extends Message {
+	id: string;
+}
+export interface MessageInput {
+	id?: string;
+	role: MessageRole;
+	content?: ContentInput;
+	providerState?: MessageProviderState;
+}
+export interface ToolSchema {
+	name: string;
+	description: string;
+	input_schema: JsonSchemaObject;
+}
+export interface ChatRequest {
+	model: string;
+	maxTokens: number;
+	reasoning?: ReasoningConfig;
+	system: TextBlock[];
+	messages: Message[];
+	tools: ToolSchema[];
+	metadata: {
+		sessionId: string;
+		turnId: string;
+	};
+}
+export interface ChatResponse {
+	id: string;
+	content: AssistantContentBlock[];
+	stopReason: "end_turn" | "tool_use";
+	usage: {
+		inputTokens: number;
+		outputTokens: number;
+		reasoningTokens?: number;
+	};
+	providerState?: MessageProviderState;
+}
+export interface ContentDeltaChunk {
+	type: "content_delta";
+	index?: number;
+	text?: string;
+}
+export interface ToolUseDeltaChunk {
+	type: "tool_use_delta";
+	id: string;
+	index: number;
+	inputDelta?: string;
+	name?: string;
+}
+export interface AnthropicThinkingDeltaChunk {
+	type: "anthropic_thinking_delta";
+	index: number;
+	thinking: string;
+}
+export interface OpenAiReasoningDeltaChunk {
+	type: "openai_reasoning_delta";
+	contentIndex: number;
+	delta: string;
+	itemId: string;
+	outputIndex: number;
+}
+export interface OpenAiReasoningSummaryDeltaChunk {
+	type: "openai_reasoning_summary_delta";
+	delta: string;
+	itemId: string;
+	outputIndex: number;
+	summaryIndex: number;
+}
+export interface ChatResponseChunk {
+	type: "anthropic_signature_delta" | "anthropic_thinking_delta" | "content_delta" | "done" | "openai_reasoning_delta" | "openai_reasoning_summary_delta" | "tool_use_delta";
+	contentIndex?: number;
+	delta?: string;
+	index?: number;
+	itemId?: string;
+	outputIndex?: number;
+	signature?: string;
+	summaryIndex?: number;
+	text?: string;
+	thinking?: string;
+	inputDelta?: string;
+	name?: string;
+	id?: string;
+	response?: ChatResponse;
+}
+export interface ModelLimits {
+	contextWindow?: number;
+	maxOutput?: number;
+}
+export interface ModelInfo {
+	id: string;
+	name: string;
+	limits?: ModelLimits;
+	supportedEndpoints?: string[];
+}
+export interface ToolResultMeta {
+	truncated?: boolean;
+	originalBytes?: number;
+	transforms: string[];
+}
+export interface ToolResultChunk {
+	output: string;
+	structured: JsonObject;
+	content?: ToolResultContent;
+}
+export interface ToolOutputEnvelope {
+	output: string;
+	structured?: JsonObject;
+	content?: ToolResultContent;
+}
+export interface ToolResult {
+	callId: string;
+	toolName: string;
+	status: "error" | "ok";
+	output: string;
+	structured: JsonObject;
+	content?: ToolResultContent;
+	chunks: ToolResultChunk[];
+	meta: ToolResultMeta;
+}
+export interface TurnState {
+	sessionId: string;
+	turnId: string;
+	system: TextBlock[];
+	messages: Message[];
+	lastResponse?: ChatResponse;
+	toolResults: ToolResult[];
+	finalMessage?: IdentifiedMessage;
+}
+export interface ModelExecutionOptions {
+	signal?: AbortSignal;
+}
+export interface EngineChatModel {
+	model: string;
+	maxTokens?: number;
+	complete(request: ChatRequest, options?: ModelExecutionOptions): Promise<ChatResponse>;
+	stream?(request: ChatRequest, options?: ModelExecutionOptions): AsyncIterable<ChatResponseChunk>;
+	getModels?(signal?: AbortSignal): Promise<ModelInfo[]>;
+}
+export interface AgentEventContext {
+	sessionId: string;
+	turnId: string;
+	state: TurnState;
+}
+export interface ToolExecutionContext extends AgentEventContext {
+	signal: AbortSignal;
+	toolCallId?: string;
+}
+export interface ToolRuntimeStartedEvent {
+	type: "tool_started";
+	toolCall: ToolUseBlock;
+}
+export interface ToolRuntimeOutputChunkEvent {
+	type: "tool_output_chunk";
+	toolCall: ToolUseBlock;
+	chunk: ToolResultChunk;
+}
+export interface ToolRuntimeCompletedEvent {
+	type: "tool_completed";
+	toolCall: ToolUseBlock;
+	result: ToolResult;
+}
+export interface ToolRuntimeRejectedEvent {
+	type: "tool_rejected";
+	toolCall: ToolUseBlock;
+	result: ToolResult;
+}
+export type ToolRuntimeEvent = ToolRuntimeOutputChunkEvent | ToolRuntimeCompletedEvent | ToolRuntimeRejectedEvent | ToolRuntimeStartedEvent;
+export interface AgentUserMessageEvent {
+	type: "user_message";
+	message: Message;
+}
+export interface AgentModelRequestEvent {
+	type: "model_request";
+	request: ChatRequest;
+}
+export interface AgentModelResponseEvent {
+	type: "model_response";
+	response: ChatResponse;
+}
+export interface AgentAssistantMessageEvent {
+	type: "assistant_message";
+	message: IdentifiedMessage;
+}
+export interface AgentAssistantChunkEvent {
+	type: "assistant_chunk";
+	index: number;
+	messageId: string;
+	chunk: ContentDeltaChunk;
+}
+export interface AgentToolUseMessageEvent {
+	type: "tool_use_message";
+	message: IdentifiedMessage;
+}
+export interface AgentToolUseChunkEvent {
+	type: "tool_use_chunk";
+	index: number;
+	messageId: string;
+	chunk: ToolUseDeltaChunk;
+}
+export interface AgentReasoningMessageEvent {
+	type: "reasoning_message";
+	message: IdentifiedMessage;
+}
+export interface AgentReasoningChunkEvent {
+	type: "reasoning_chunk";
+	index: number;
+	messageId: string;
+	chunk: AnthropicThinkingDeltaChunk | OpenAiReasoningDeltaChunk | OpenAiReasoningSummaryDeltaChunk;
+	text: string;
+}
+export interface AgentToolCallEvent {
+	type: "tool_call";
+	toolCall: ToolUseBlock;
+}
+export interface AgentToolResultEvent {
+	type: "tool_result";
+	result: ToolResult;
+}
+export interface AgentToolResultMessageEvent {
+	type: "tool_result_message";
+	message: Message;
+}
+export interface AgentFinalMessageEvent {
+	type: "final_message";
+	message: IdentifiedMessage;
+}
+export interface AgentTurnCompleteEvent {
+	type: "turn_complete";
+	state: TurnState;
+}
+export type AgentLifecycleEvent = AgentAssistantChunkEvent | AgentAssistantMessageEvent | AgentFinalMessageEvent | AgentModelRequestEvent | AgentModelResponseEvent | AgentReasoningChunkEvent | AgentReasoningMessageEvent | AgentToolCallEvent | AgentToolUseChunkEvent | AgentToolUseMessageEvent | AgentToolResultEvent | AgentToolResultMessageEvent | AgentTurnCompleteEvent | AgentUserMessageEvent;
+export type AgentEvent = AgentLifecycleEvent | ToolRuntimeEvent;
+export type ToolRuntimeDispatchDecision = {
+	action: "reject";
+	reason?: string;
+} | {
+	action: "run";
+};
+export type ToolRuntimeToolCallHandler = (toolCall: ToolUseBlock, ctx: ToolExecutionContext) => Promise<ToolRuntimeDispatchDecision | undefined> | ToolRuntimeDispatchDecision | undefined;
+export type ToolRuntimeEventHandler = (event: ToolRuntimeEvent, ctx: ToolExecutionContext) => Promise<void> | void;
+export type AgentEventHandler = (event: AgentEvent, ctx: AgentEventContext) => Promise<void> | void;
+export interface ToolRuntime {
+	listToolSchemas(): ToolSchema[];
+	setTools(tools: AnyToolDefinition[]): void;
+	executeCalls(toolCalls: ToolUseBlock[], ctx: ToolExecutionContext): Promise<ToolResult[]>;
+	execute(toolCall: ToolUseBlock, ctx: ToolExecutionContext): Promise<ToolResult>;
+}
+export type InferJsonSchema<TSchema extends JsonSchema> = TSchema extends JsonSchemaString ? string : TSchema extends JsonSchemaNumber ? number : TSchema extends JsonSchemaBoolean ? boolean : TSchema extends JsonSchemaArray<infer TItem> ? InferJsonSchema<TItem>[] : TSchema extends JsonSchemaObject<infer TProperties, infer TRequired> ? Expand<RequiredProperties<TProperties, TRequired> & OptionalProperties<TProperties, TRequired>> : never;
+export type Expand<TValue> = TValue extends infer TObject ? {
+	[TKey in keyof TObject]: TObject[TKey];
+} : never;
+export type RequiredKeyUnion<TRequired extends readonly string[] | undefined> = TRequired extends readonly string[] ? TRequired[number] : never;
+export type OptionalKeyUnion<TProperties extends Record<string, JsonSchema>, TRequired extends readonly string[] | undefined> = Exclude<keyof TProperties, RequiredKeyUnion<TRequired>>;
+export type RequiredProperties<TProperties extends Record<string, JsonSchema>, TRequired extends readonly string[] | undefined> = {
+	[TKey in Extract<keyof TProperties, RequiredKeyUnion<TRequired>>]: InferJsonSchema<TProperties[TKey]>;
+};
+export type OptionalProperties<TProperties extends Record<string, JsonSchema>, TRequired extends readonly string[] | undefined> = {
+	[TKey in OptionalKeyUnion<TProperties, TRequired>]?: InferJsonSchema<TProperties[TKey]>;
+};
+export type ToolOutputValue = JsonValue | ToolOutputEnvelope;
+export type ToolGenerator<TYield extends ToolOutputValue = ToolOutputValue, TReturn extends ToolOutputValue | undefined = ToolOutputValue | undefined> = AsyncGenerator<TYield, TReturn, void>;
+export interface ToolDefinition<TInput extends JsonObject = JsonObject, TYield extends ToolOutputValue = ToolOutputValue, TReturn extends ToolOutputValue | undefined = ToolOutputValue | undefined, TSchema extends JsonSchemaObject = JsonSchemaObject> {
+	name: string;
+	description: string;
+	inputSchema: TSchema;
+	execute(input: TInput, ctx: ToolExecutionContext): ToolGenerator<TYield, TReturn>;
+}
+export type AnyToolDefinition = ToolDefinition<JsonObject, ToolOutputValue, ToolOutputValue | undefined, JsonSchemaObject>;
+export type Stage = "afterModelResponse" | "afterToolResult" | "afterTurnComplete" | "beforeAssistantAppend" | "beforeFinalOutput" | "beforeModelRequest" | "beforeToolExecution" | "beforeToolResultAppend" | "onUserMessage";
+export interface PayloadByStage {
+	onUserMessage: Message;
+	beforeModelRequest: ChatRequest;
+	afterModelResponse: ChatResponse;
+	beforeToolExecution: ToolUseBlock;
+	afterToolResult: ToolResult;
+	beforeAssistantAppend: Message;
+	beforeFinalOutput: Message;
+	beforeToolResultAppend: Message;
+	afterTurnComplete: TurnState;
+}
+export interface ExtensionContext {
+	state: TurnState;
+}
+type Transformer$1<S extends Stage> = (payload: PayloadByStage[S], ctx: ExtensionContext) => PayloadByStage[S] | Promise<PayloadByStage[S]>;
+export type Observer<S extends Stage> = (payload: PayloadByStage[S], ctx: ExtensionContext) => Promise<void> | void;
+export interface TransformerExtensionRegistration<S extends Stage = Stage> {
+	id: string;
+	stage: S;
+	kind: "transformer";
+	order: number;
+	enabled: boolean;
+	run: Transformer$1<S>;
+}
+export interface ObserverExtensionRegistration<S extends Stage = Stage> {
+	id: string;
+	stage: S;
+	kind: "observer";
+	order: number;
+	enabled: boolean;
+	run: Observer<S>;
+}
+export type ExtensionRegistration<S extends Stage = Stage> = ObserverExtensionRegistration<S> | TransformerExtensionRegistration<S>;
+export type AnyExtensionRegistration = {
+	[S in Stage]: ExtensionRegistration<S>;
+}[Stage];
+export interface ExtensionRegistry {
+	register(extension: AnyExtensionRegistration): void;
+	runTransformers<S extends Stage>(stage: S, payload: PayloadByStage[S], ctx: ExtensionContext): Promise<PayloadByStage[S]>;
+	runObservers<S extends Stage>(stage: S, payload: PayloadByStage[S], ctx: ExtensionContext): Promise<void>;
+}
+export type AgentInput = MessageInput | string;
+export interface AgentOptions {
+	sessionId?: string;
+	systemPrompt?: string;
+	messages?: MessageInput[];
+	message?: AgentInput;
+	onEvent?: AgentEventHandler;
+	onToolCall?: ToolRuntimeToolCallHandler;
+	registry?: ExtensionRegistry;
+	extensions?: AnyExtensionRegistration[];
+	chatModel?: EngineChatModel;
+	tools?: AnyToolDefinition[];
+}
+export interface AgentDefinitionFactoryContext {
+	agentId: string;
+	parentSessionId?: string;
+	runId?: string;
+	toolCallId?: string;
+}
+export interface OpenAiFunctionCall {
+	type: "function_call";
+	call_id: string;
+	name: string;
+	arguments: string;
+}
+export interface OpenAiOutputTextPart {
+	type: "output_text";
+	text: string;
+}
+export interface OpenAiRefusalPart {
+	type: "refusal";
+	refusal: string;
+}
+export interface OpenAiOutputMessage {
+	type: "message";
+	content?: Array<OpenAiOutputTextPart | OpenAiRefusalPart>;
+	role?: string;
+	status?: string;
+}
+export interface OpenAiReasoningOutputItem {
+	type: "reasoning";
+	content?: Array<{
+		text?: string;
+		type?: string;
+	}>;
+	encrypted_content?: string;
+	id?: string;
+	status?: string;
+	summary?: OpenAiReasoningSummaryText[];
+	text?: string;
+}
+export type OpenAiResponsesOutputItem = JsonObject | OpenAiFunctionCall | OpenAiOutputMessage | OpenAiReasoningOutputItem;
+export interface BashToolInput {
+	command: string;
+	cwd?: string;
+	timeoutMs?: number;
+	ignoreOutput?: boolean;
+}
+export interface BashToolOptions {
+	defaultCwd?: string;
+	defaultTimeoutMs?: number;
+	description?: string;
+	env?: NodeJS.ProcessEnv;
+	name?: string;
+	shellPath?: string;
+	stripAnsi?: boolean;
+}
+export declare function createBashTool(options?: BashToolOptions): ToolDefinition<{
+	command: string;
+	cwd?: string | undefined;
+	timeoutMs?: number | undefined;
+	ignoreOutput?: boolean | undefined;
 }, string, ToolOutputEnvelope, {
-    type: "object";
-    properties: {
-        command: {
-            type: "string";
-        };
-        cwd: {
-            type: "string";
-        };
-        timeoutMs: {
-            type: "number";
-        };
-        ignoreOutput: {
-            type: "boolean";
-        };
-    };
-    required: readonly ["command"];
+	type: "object";
+	properties: {
+		command: {
+			type: "string";
+		};
+		cwd: {
+			type: "string";
+		};
+		timeoutMs: {
+			type: "number";
+		};
+		ignoreOutput: {
+			type: "boolean";
+		};
+	};
+	required: readonly [
+		"command"
+	];
 }>;
-declare function createShellExecTool(options?: BashToolOptions): ToolDefinition<{
-    command: string;
-    cwd?: string | undefined;
-    timeoutMs?: number | undefined;
-    ignoreOutput?: boolean | undefined;
+export declare function createShellExecTool(options?: BashToolOptions): ToolDefinition<{
+	command: string;
+	cwd?: string | undefined;
+	timeoutMs?: number | undefined;
+	ignoreOutput?: boolean | undefined;
 }, string, ToolOutputEnvelope, {
-    type: "object";
-    properties: {
-        command: {
-            type: "string";
-        };
-        cwd: {
-            type: "string";
-        };
-        timeoutMs: {
-            type: "number";
-        };
-        ignoreOutput: {
-            type: "boolean";
-        };
-    };
-    required: readonly ["command"];
+	type: "object";
+	properties: {
+		command: {
+			type: "string";
+		};
+		cwd: {
+			type: "string";
+		};
+		timeoutMs: {
+			type: "number";
+		};
+		ignoreOutput: {
+			type: "boolean";
+		};
+	};
+	required: readonly [
+		"command"
+	];
 }>;
-
-interface CommandSource {
-    path: string;
-    directory?: string;
-    scope?: string;
-}
-interface CommandReference {
-    id: string;
-    name: string;
-    description: string;
-    argumentHint?: string;
-    arguments?: string[];
-    source: CommandSource;
-}
-interface LoadedCommand extends CommandReference {
-    instructions: string;
-}
-interface CommandToolOptions<TRef extends CommandReference = CommandReference> {
-    commands: TRef[];
-    loadCommand: (reference: TRef) => Promise<LoadedCommand>;
-}
-declare function createInvokeCommandTool<TRef extends CommandReference>(options: CommandToolOptions<TRef>): ToolDefinition<{
-    name: string;
-    args?: string | undefined;
+export interface MCPOAuthConfig {
+	clientId?: string;
+	clientMetadataUrl?: string;
+	authorizationServer?: string;
+	scopes?: string[];
+	tokenStorageKey?: string;
+}
+export interface MCPAuthConfig {
+	type: "none" | "bearer" | "oauth";
+	token?: string;
+	oauth?: MCPOAuthConfig;
+}
+export interface MCPServerConfig {
+	command?: string;
+	args?: string[];
+	env?: Record<string, string>;
+	transport?: "stdio" | "http";
+	url?: string;
+	headers?: Record<string, string>;
+	prefix?: string;
+	timeoutMs?: number;
+	enabled?: boolean;
+	auth?: MCPAuthConfig;
+}
+export interface CommandDefinitionSource {
+	scope: AgentDefinitionSourceScope;
+	path: string;
+	directory?: string;
+	kind?: "custom" | "default";
+}
+export interface CommandDefinitionReference {
+	id: string;
+	name: string;
+	description: string;
+	argumentHint?: string;
+	arguments?: string[];
+	source: CommandDefinitionSource;
+}
+export interface SerializedCommandDefinition extends CommandDefinitionReference {
+	instructions: string;
+}
+export type AgentDefinitionSourceScope = "builtin" | "direct" | "env" | "explicit" | "global" | "local" | "profile";
+export type CommandReference = CommandDefinitionReference;
+export type LoadedCommand = SerializedCommandDefinition;
+export interface CommandToolOptions<TRef extends CommandReference = CommandReference> {
+	commands: TRef[];
+	loadCommand: (reference: TRef) => Promise<LoadedCommand>;
+}
+export declare function createInvokeCommandTool<TRef extends CommandReference>(options: CommandToolOptions<TRef>): ToolDefinition<{
+	name: string;
+	args?: string | undefined;
 }, ToolOutputEnvelope, undefined, {
-    type: "object";
-    properties: {
-        name: {
-            type: "string";
-        };
-        args: {
-            type: "string";
-        };
-    };
-    required: readonly ["name"];
+	type: "object";
+	properties: {
+		name: {
+			type: "string";
+		};
+		args: {
+			type: "string";
+		};
+	};
+	required: readonly [
+		"name"
+	];
 }>;
-
-interface FileEditToolOptions {
-    defaultCwd?: string;
-    name?: string;
-}
-declare function createFileEditTool(options?: FileEditToolOptions): ToolDefinition<{
-    filePath: string;
-    oldText: string;
-    newText: string;
-    dryRun?: boolean | undefined;
+export interface FileEditToolOptions {
+	defaultCwd?: string;
+	name?: string;
+}
+export declare function createFileEditTool(options?: FileEditToolOptions): ToolDefinition<{
+	filePath: string;
+	oldText: string;
+	newText: string;
+	dryRun?: boolean | undefined;
 }, ToolOutputEnvelope, undefined, {
-    type: "object";
-    properties: {
-        filePath: {
-            type: "string";
-        };
-        oldText: {
-            type: "string";
-        };
-        newText: {
-            type: "string";
-        };
-        dryRun: {
-            type: "boolean";
-        };
-    };
-    required: readonly ["filePath", "oldText", "newText"];
+	type: "object";
+	properties: {
+		filePath: {
+			type: "string";
+		};
+		oldText: {
+			type: "string";
+		};
+		newText: {
+			type: "string";
+		};
+		dryRun: {
+			type: "boolean";
+		};
+	};
+	required: readonly [
+		"filePath",
+		"oldText",
+		"newText"
+	];
 }>;
-
-interface FileNewToolOptions {
-    defaultCwd?: string;
-    name?: string;
+export interface FileNewToolOptions {
+	defaultCwd?: string;
+	name?: string;
 }
-declare function createFileNewTool(options?: FileNewToolOptions): ToolDefinition<{
-    filePath: string;
-    content: string;
+export declare function createFileNewTool(options?: FileNewToolOptions): ToolDefinition<{
+	content: string;
+	filePath: string;
 }, ToolOutputEnvelope, undefined, {
-    type: "object";
-    properties: {
-        filePath: {
-            type: "string";
-        };
-        content: {
-            type: "string";
-        };
-    };
-    required: readonly ["filePath", "content"];
+	type: "object";
+	properties: {
+		filePath: {
+			type: "string";
+		};
+		content: {
+			type: "string";
+		};
+	};
+	required: readonly [
+		"filePath",
+		"content"
+	];
 }>;
-
-interface FileReadToolOptions {
-    defaultCwd?: string;
-    name?: string;
-}
-declare function createFileReadTool(options?: FileReadToolOptions): ToolDefinition<{
-    path: string;
-    lineStart?: number | undefined;
-    lineEnd?: number | undefined;
+export interface FileReadToolOptions {
+	defaultCwd?: string;
+	name?: string;
+}
+export declare function createFileReadTool(options?: FileReadToolOptions): ToolDefinition<{
+	path: string;
+	lineStart?: number | undefined;
+	lineEnd?: number | undefined;
 }, ToolOutputEnvelope, undefined, {
-    type: "object";
-    properties: {
-        path: {
-            type: "string";
-        };
-        lineStart: {
-            type: "number";
-        };
-        lineEnd: {
-            type: "number";
-        };
-    };
-    required: readonly ["path"];
+	type: "object";
+	properties: {
+		path: {
+			type: "string";
+		};
+		lineStart: {
+			type: "number";
+		};
+		lineEnd: {
+			type: "number";
+		};
+	};
+	required: readonly [
+		"path"
+	];
 }>;
-
-interface GlobToolOptions {
-    defaultCwd?: string;
-    limit?: number;
-    name?: string;
-}
-declare function createGlobTool(options?: GlobToolOptions): ToolDefinition<{
-    pattern: string;
-    path?: string | undefined;
-    limit?: number | undefined;
+export interface GlobToolOptions {
+	defaultCwd?: string;
+	limit?: number;
+	name?: string;
+}
+export declare function createGlobTool(options?: GlobToolOptions): ToolDefinition<{
+	pattern: string;
+	path?: string | undefined;
+	limit?: number | undefined;
 }, ToolOutputEnvelope, undefined, {
-    type: "object";
-    properties: {
-        pattern: {
-            type: "string";
-        };
-        path: {
-            type: "string";
-        };
-        limit: {
-            type: "number";
-        };
-    };
-    required: readonly ["pattern"];
+	type: "object";
+	properties: {
+		pattern: {
+			type: "string";
+		};
+		path: {
+			type: "string";
+		};
+		limit: {
+			type: "number";
+		};
+	};
+	required: readonly [
+		"pattern"
+	];
 }>;
-
-interface GrepToolOptions {
-    defaultCwd?: string;
-    limit?: number;
-    name?: string;
-}
-declare function createGrepTool(options?: GrepToolOptions): ToolDefinition<{
-    pattern: string;
-    path?: string | undefined;
-    limit?: number | undefined;
-    include?: string | undefined;
-    context?: number | undefined;
+export interface GrepToolOptions {
+	defaultCwd?: string;
+	limit?: number;
+	name?: string;
+}
+export declare function createGrepTool(options?: GrepToolOptions): ToolDefinition<{
+	pattern: string;
+	path?: string | undefined;
+	limit?: number | undefined;
+	include?: string | undefined;
+	context?: number | undefined;
 }, ToolOutputEnvelope, undefined, {
-    type: "object";
-    properties: {
-        pattern: {
-            type: "string";
-        };
-        path: {
-            type: "string";
-        };
-        include: {
-            type: "string";
-        };
-        limit: {
-            type: "number";
-        };
-        context: {
-            type: "number";
-        };
-    };
-    required: readonly ["pattern"];
+	type: "object";
+	properties: {
+		pattern: {
+			type: "string";
+		};
+		path: {
+			type: "string";
+		};
+		include: {
+			type: "string";
+		};
+		limit: {
+			type: "number";
+		};
+		context: {
+			type: "number";
+		};
+	};
+	required: readonly [
+		"pattern"
+	];
 }>;
-
-interface InternalToolRuntimeOptions {
-    onEvent?: ToolRuntimeEventHandler;
-    onToolCall?: ToolRuntimeToolCallHandler;
+export interface InternalToolRuntimeOptions {
+	onEvent?: ToolRuntimeEventHandler;
+	onToolCall?: ToolRuntimeToolCallHandler;
 }
-declare function createInternalToolRuntime(tools?: AnyToolDefinition[], options?: InternalToolRuntimeOptions): ToolRuntime;
-
-interface LsToolOptions {
-    defaultCwd?: string;
-    name?: string;
+export declare function createInternalToolRuntime(tools?: AnyToolDefinition[], options?: InternalToolRuntimeOptions): ToolRuntime;
+export interface LsToolOptions {
+	defaultCwd?: string;
+	name?: string;
 }
-declare function createLsTool(options?: LsToolOptions): ToolDefinition<{
-    path: string;
-    limit: number;
+export declare function createLsTool(options?: LsToolOptions): ToolDefinition<{
+	path: string;
+	limit: number;
 }, ToolOutputEnvelope, undefined, {
-    type: "object";
-    properties: {
-        path: {
-            type: "string";
-        };
-        limit: {
-            type: "number";
-        };
-    };
+	type: "object";
+	properties: {
+		path: {
+			type: "string";
+		};
+		limit: {
+			type: "number";
+		};
+	};
 }>;
-
-interface McpOAuthProviderOptions {
-    serverName: string;
-    callbackUrl: string;
-    storageDir: string;
-    config: MCPAuthConfig;
-    onRedirect(url: URL): void | Promise<void>;
-}
-declare function createMcpOAuthProvider(options: McpOAuthProviderOptions): OAuthClientProvider;
-
-interface McpToolDescriptor {
-    name: string;
-    description?: string;
-    inputSchema?: unknown;
-}
-interface McpToolClient {
-    callTool(input: {
-        name: string;
-        arguments?: JsonObject;
-    }): Promise<CallToolResult>;
-}
-declare function createMcpToolName(serverName: string, toolName: string): string;
-declare function toNuvinToolSchema(inputSchema: unknown): JsonSchemaObject;
-declare function createMcpTool(options: {
-    serverName: string;
-    tool: McpToolDescriptor;
-    client: McpToolClient;
+export interface McpOAuthProviderOptions {
+	serverName: string;
+	callbackUrl: string;
+	storageDir: string;
+	config: MCPAuthConfig;
+	onRedirect(url: URL): void | Promise<void>;
+}
+export declare function createMcpOAuthProvider(options: McpOAuthProviderOptions): OAuthClientProvider;
+export interface McpToolDescriptor {
+	name: string;
+	description?: string;
+	inputSchema?: unknown;
+}
+export interface McpToolClient {
+	callTool(input: {
+		name: string;
+		arguments?: JsonObject;
+	}): Promise<CallToolResult>;
+}
+export declare function createMcpToolName(serverName: string, toolName: string): string;
+export declare function toNuvinToolSchema(inputSchema: unknown): JsonSchemaObject;
+export declare function createMcpTool(options: {
+	serverName: string;
+	tool: McpToolDescriptor;
+	client: McpToolClient;
 }): ToolDefinition<{
-    [x: string]: string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | /*elided*/ any | {
-        [x: string]: string | number | boolean | /*elided*/ any | /*elided*/ any;
-    })[] | {
-        [x: string]: string | number | boolean | (string | number | boolean | /*elided*/ any | /*elided*/ any)[] | /*elided*/ any;
-    })[] | {
-        [x: string]: string | number | boolean | (string | number | boolean | (string | number | boolean | /*elided*/ any | /*elided*/ any)[] | /*elided*/ any)[] | /*elided*/ any;
-    })[] | {
-        [x: string]: string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | /*elided*/ any | /*elided*/ any)[] | /*elided*/ any)[] | /*elided*/ any)[] | /*elided*/ any;
-    })[] | {
-        [x: string]: string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | /*elided*/ any | /*elided*/ any)[] | /*elided*/ any)[] | /*elided*/ any)[] | /*elided*/ any)[] | /*elided*/ any;
-    })[] | {
-        [x: string]: string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | /*elided*/ any | /*elided*/ any)[] | /*elided*/ any)[] | /*elided*/ any)[] | /*elided*/ any)[] | /*elided*/ any)[] | /*elided*/ any;
-    })[] | {
-        [x: string]: string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | /*elided*/ any | /*elided*/ any)[] | /*elided*/ any)[] | /*elided*/ any)[] | /*elided*/ any)[] | /*elided*/ any)[] | /*elided*/ any)[] | /*elided*/ any;
-    })[] | {
-        [x: string]: string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | /*elided*/ any | /*elided*/ any)[] | /*elided*/ any)[] | /*elided*/ any)[] | /*elided*/ any)[] | /*elided*/ any)[] | /*elided*/ any)[] | /*elided*/ any)[] | /*elided*/ any;
-    })[] | {
-        [x: string]: string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | /*elided*/ any | /*elided*/ any)[] | /*elided*/ any)[] | /*elided*/ any)[] | /*elided*/ any)[] | /*elided*/ any)[] | /*elided*/ any)[] | /*elided*/ any)[] | /*elided*/ any)[] | /*elided*/ any;
-    })[] | {
-        [x: string]: string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | /*elided*/ any | /*elided*/ any)[] | /*elided*/ any)[] | /*elided*/ any)[] | /*elided*/ any)[] | /*elided*/ any)[] | /*elided*/ any)[] | /*elided*/ any)[] | /*elided*/ any)[] | /*elided*/ any)[] | /*elided*/ any;
-    })[] | {
-        [x: string]: string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | /*elided*/ any | /*elided*/ any)[] | /*elided*/ any)[] | /*elided*/ any)[] | /*elided*/ any)[] | /*elided*/ any)[] | /*elided*/ any)[] | /*elided*/ any)[] | /*elided*/ any)[] | /*elided*/ any)[] | /*elided*/ any)[] | /*elided*/ any;
-    })[] | {
-        [x: string]: string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | /*elided*/ any | /*elided*/ any)[] | /*elided*/ any)[] | /*elided*/ any)[] | /*elided*/ any)[] | /*elided*/ any)[] | /*elided*/ any)[] | /*elided*/ any)[] | /*elided*/ any)[] | /*elided*/ any)[] | /*elided*/ any)[] | /*elided*/ any)[] | /*elided*/ any;
-    };
+	[x: string]: string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | /*elided*/ any | {
+		[x: string]: string | number | boolean | /*elided*/ any | /*elided*/ any;
+	})[] | {
+		[x: string]: string | number | boolean | (string | number | boolean | /*elided*/ any | /*elided*/ any)[] | /*elided*/ any;
+	})[] | {
+		[x: string]: string | number | boolean | (string | number | boolean | (string | number | boolean | /*elided*/ any | /*elided*/ any)[] | /*elided*/ any)[] | /*elided*/ any;
+	})[] | {
+		[x: string]: string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | /*elided*/ any | /*elided*/ any)[] | /*elided*/ any)[] | /*elided*/ any)[] | /*elided*/ any;
+	})[] | {
+		[x: string]: string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | /*elided*/ any | /*elided*/ any)[] | /*elided*/ any)[] | /*elided*/ any)[] | /*elided*/ any)[] | /*elided*/ any;
+	})[] | {
+		[x: string]: string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | /*elided*/ any | /*elided*/ any)[] | /*elided*/ any)[] | /*elided*/ any)[] | /*elided*/ any)[] | /*elided*/ any)[] | /*elided*/ any;
+	})[] | {
+		[x: string]: string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | /*elided*/ any | /*elided*/ any)[] | /*elided*/ any)[] | /*elided*/ any)[] | /*elided*/ any)[] | /*elided*/ any)[] | /*elided*/ any)[] | /*elided*/ any;
+	})[] | {
+		[x: string]: string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | /*elided*/ any | /*elided*/ any)[] | /*elided*/ any)[] | /*elided*/ any)[] | /*elided*/ any)[] | /*elided*/ any)[] | /*elided*/ any)[] | /*elided*/ any)[] | /*elided*/ any;
+	})[] | {
+		[x: string]: string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | /*elided*/ any | /*elided*/ any)[] | /*elided*/ any)[] | /*elided*/ any)[] | /*elided*/ any)[] | /*elided*/ any)[] | /*elided*/ any)[] | /*elided*/ any)[] | /*elided*/ any)[] | /*elided*/ any;
+	})[] | {
+		[x: string]: string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | /*elided*/ any | /*elided*/ any)[] | /*elided*/ any)[] | /*elided*/ any)[] | /*elided*/ any)[] | /*elided*/ any)[] | /*elided*/ any)[] | /*elided*/ any)[] | /*elided*/ any)[] | /*elided*/ any)[] | /*elided*/ any;
+	})[] | {
+		[x: string]: string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | /*elided*/ any | /*elided*/ any)[] | /*elided*/ any)[] | /*elided*/ any)[] | /*elided*/ any)[] | /*elided*/ any)[] | /*elided*/ any)[] | /*elided*/ any)[] | /*elided*/ any)[] | /*elided*/ any)[] | /*elided*/ any)[] | /*elided*/ any;
+	})[] | {
+		[x: string]: string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | (string | number | boolean | /*elided*/ any | /*elided*/ any)[] | /*elided*/ any)[] | /*elided*/ any)[] | /*elided*/ any)[] | /*elided*/ any)[] | /*elided*/ any)[] | /*elided*/ any)[] | /*elided*/ any)[] | /*elided*/ any)[] | /*elided*/ any)[] | /*elided*/ any)[] | /*elided*/ any;
+	};
 }, ToolOutputEnvelope, undefined, JsonSchemaObject<Record<string, JsonSchema>, readonly string[] | undefined>>;
-
-interface ConnectedMcpClient extends McpToolClient {
-    listTools(): Promise<ListToolsResult>;
-    close(): Promise<void>;
+export interface ConnectedMcpClient extends McpToolClient {
+	listTools(): Promise<ListToolsResult>;
+	close(): Promise<void>;
 }
-type McpServerConnectionStatus = {
-    status: "connected";
-    toolCount: number;
+export type McpServerConnectionStatus = {
+	status: "connected";
+	toolCount: number;
 } | {
-    status: "disabled";
+	status: "disabled";
 } | {
-    status: "authRequired";
-    message: string;
+	status: "authRequired";
+	message: string;
 } | {
-    status: "error";
-    message: string;
+	status: "error";
+	message: string;
 };
-interface McpToolBundle {
-    tools: AnyToolDefinition[];
-    servers: Record<string, McpServerConnectionStatus>;
-    close(): Promise<void>;
-}
-interface McpConnectionOptions {
-    oauth?: {
-        storageDir: string;
-        callbackUrl: string;
-        onRedirect(serverName: string, url: URL): void | Promise<void>;
-    };
-}
-type McpConnector = (serverName: string, config: MCPServerConfig, options?: McpConnectionOptions) => Promise<ConnectedMcpClient>;
-declare function buildMcpHttpHeaders(config: MCPServerConfig): Record<string, string> | undefined;
-declare function connectMcpServer(serverName: string, config: MCPServerConfig, options?: McpConnectionOptions): Promise<ConnectedMcpClient>;
-declare function createMcpToolsFromServers(options: {
-    servers?: Record<string, MCPServerConfig>;
-    allowedTools?: Record<string, Record<string, boolean>>;
-    connection?: McpConnectionOptions;
-    connect?: McpConnector;
+export interface McpToolBundle {
+	tools: AnyToolDefinition[];
+	servers: Record<string, McpServerConnectionStatus>;
+	close(): Promise<void>;
+}
+export interface McpConnectionOptions {
+	oauth?: {
+		storageDir: string;
+		callbackUrl: string;
+		onRedirect(serverName: string, url: URL): void | Promise<void>;
+	};
+}
+export type McpConnector = (serverName: string, config: MCPServerConfig, options?: McpConnectionOptions) => Promise<ConnectedMcpClient>;
+export declare function buildMcpHttpHeaders(config: MCPServerConfig): Record<string, string> | undefined;
+export declare function connectMcpServer(serverName: string, config: MCPServerConfig, options?: McpConnectionOptions): Promise<ConnectedMcpClient>;
+export declare function createMcpToolsFromServers(options: {
+	servers?: Record<string, MCPServerConfig>;
+	allowedTools?: Record<string, Record<string, boolean>>;
+	connection?: McpConnectionOptions;
+	connect?: McpConnector;
 }): Promise<McpToolBundle>;
-
-declare function createMockToolRuntime(): ToolRuntime;
-
-type RipgrepMatch = {
-    filePath: string;
-    isContext?: boolean;
-    lineNum: number;
-    lineText: string;
+export declare function createMockToolRuntime(): ToolRuntime;
+export type RipgrepMatch = {
+	filePath: string;
+	isContext?: boolean;
+	lineNum: number;
+	lineText: string;
 };
-declare function filepath(): Promise<string>;
-declare function files(opts: {
-    cwd: string;
-    glob?: string[];
+export declare function filepath(): Promise<string>;
+export declare function files(opts: {
+	cwd: string;
+	glob?: string[];
 }): AsyncGenerator<string>;
-declare function search(opts: {
-    context?: number;
-    cwd: string;
-    file?: string;
-    glob?: string;
-    limit?: number;
-    pattern: string;
+export declare function search(opts: {
+	context?: number;
+	cwd: string;
+	file?: string;
+	glob?: string;
+	limit?: number;
+	pattern: string;
 }): Promise<RipgrepMatch[]>;
-
-interface DelegatedAgentFactoryContext extends AgentDefinitionFactoryContext {
-    parentSessionId: string;
-    runId: string;
+export interface DelegatedAgentFactoryContext extends AgentDefinitionFactoryContext {
+	parentSessionId: string;
+	runId: string;
 }
-type DelegatedAgentDefinition = AgentOptions | ((ctx: DelegatedAgentFactoryContext) => AgentOptions | Promise<AgentOptions>);
-interface CreateDelegationToolsOptions {
-    agents?: Record<string, DelegatedAgentDefinition>;
+export type DelegatedAgentDefinition = AgentOptions | ((ctx: DelegatedAgentFactoryContext) => AgentOptions | Promise<AgentOptions>);
+export interface CreateDelegationToolsOptions {
+	agents?: Record<string, DelegatedAgentDefinition>;
 }
-declare function createAssignTaskTool(options: CreateDelegationToolsOptions): ToolDefinition<{
-    task: string;
-    agentId: string;
+export declare function createAssignTaskTool(options: CreateDelegationToolsOptions): ToolDefinition<{
+	task: string;
+	agentId: string;
 }, ToolOutputEnvelope, ToolOutputEnvelope, {
-    type: "object";
-    properties: {
-        agentId: {
-            type: "string";
-        };
-        task: {
-            type: "string";
-        };
-    };
-    required: string[];
+	type: "object";
+	properties: {
+		agentId: {
+			type: "string";
+		};
+		task: {
+			type: "string";
+		};
+	};
+	required: string[];
 }>;
-declare const createDelegateToAgentTool: typeof createAssignTaskTool;
-declare function createDelegationTools(options: CreateDelegationToolsOptions): ToolDefinition<{
-    task: string;
-    agentId: string;
+export declare const createDelegateToAgentTool: typeof createAssignTaskTool;
+export declare function createDelegationTools(options: CreateDelegationToolsOptions): ToolDefinition<{
+	task: string;
+	agentId: string;
 }, ToolOutputEnvelope, ToolOutputEnvelope, {
-    type: "object";
-    properties: {
-        agentId: {
-            type: "string";
-        };
-        task: {
-            type: "string";
-        };
-    };
-    required: string[];
+	type: "object";
+	properties: {
+		agentId: {
+			type: "string";
+		};
+		task: {
+			type: "string";
+		};
+	};
+	required: string[];
 }>[];
-
 /** Minimal shape of a skill source reference — matches @nuvin/config SkillDefinitionSource */
-interface SkillSource {
-    path: string;
-    directory?: string;
-    scope?: string;
+export interface SkillSource {
+	path: string;
+	directory?: string;
+	scope?: string;
 }
 /** Minimal shape of a skill reference — matches @nuvin/config SkillDefinitionReference */
-interface SkillReference {
-    id: string;
-    name: string;
-    description: string;
-    source: SkillSource;
+export interface SkillReference {
+	id: string;
+	name: string;
+	description: string;
+	source: SkillSource;
 }
 /** Minimal shape of a loaded skill — matches @nuvin/config SerializedSkillDefinition */
-interface LoadedSkill extends SkillReference {
-    instructions: string;
+export interface LoadedSkill extends SkillReference {
+	instructions: string;
 }
-interface SkillToolOptions<TRef extends SkillReference = SkillReference> {
-    skills: TRef[];
-    loadSkill: (reference: TRef) => Promise<LoadedSkill>;
+export interface SkillToolOptions<TRef extends SkillReference = SkillReference> {
+	skills: TRef[];
+	loadSkill: (reference: TRef) => Promise<LoadedSkill>;
 }
-declare function createLoadSkillTool<TRef extends SkillReference>(options: SkillToolOptions<TRef>): ToolDefinition<{
-    name: string;
+export declare function createLoadSkillTool<TRef extends SkillReference>(options: SkillToolOptions<TRef>): ToolDefinition<{
+	name: string;
 }, ToolOutputEnvelope, undefined, {
-    type: "object";
-    properties: {
-        name: {
-            type: "string";
-        };
-    };
-    required: readonly ["name"];
+	type: "object";
+	properties: {
+		name: {
+			type: "string";
+		};
+	};
+	required: readonly [
+		"name"
+	];
 }>;
-
-declare function normalizeToolOutputValue(output: ToolOutputValue): ToolResultChunk;
-declare function createToolOutput(output: string, structured?: JsonObject): ToolOutputEnvelope;
-declare class ToolExecutionError extends Error {
-    readonly structured: JsonObject;
-    constructor(message: string, structured?: JsonObject);
-}
-declare function defineTool<TSchema extends JsonSchemaObject, TYield extends ToolOutputValue = ToolOutputValue, TReturn extends ToolOutputValue | undefined = ToolOutputValue | undefined>(definition: {
-    name: string;
-    description: string;
-    inputSchema: TSchema;
-    execute(input: InferJsonSchema<TSchema>, ctx: ToolExecutionContext): AsyncGenerator<TYield, TReturn, void>;
+export declare function normalizeToolOutputValue(output: ToolOutputValue): ToolResultChunk;
+export declare function createToolOutput(output: string, structured?: JsonObject, content?: ToolResultContent): ToolOutputEnvelope;
+export declare class ToolExecutionError extends Error {
+	readonly structured: JsonObject;
+	constructor(message: string, structured?: JsonObject);
+}
+export declare function defineTool<TSchema extends JsonSchemaObject, TYield extends ToolOutputValue = ToolOutputValue, TReturn extends ToolOutputValue | undefined = ToolOutputValue | undefined>(definition: {
+	name: string;
+	description: string;
+	inputSchema: TSchema;
+	execute(input: InferJsonSchema<TSchema>, ctx: ToolExecutionContext): AsyncGenerator<TYield, TReturn, void>;
 }): ToolDefinition<InferJsonSchema<TSchema>, TYield, TReturn, TSchema>;
-declare class ToolRegistry {
-    private readonly toolsByName;
-    constructor(tools?: AnyToolDefinition[]);
-    register(tool: AnyToolDefinition): void;
-    get(name: string): AnyToolDefinition | undefined;
-    list(): AnyToolDefinition[];
-    listToolSchemas(): ToolSchema[];
-}
-declare function validateToolInput<TSchema extends JsonSchemaObject>(input: JsonValue, schema: TSchema): InferJsonSchema<TSchema>;
-declare function deriveFinalToolOutput(chunks: ToolResultChunk[]): ToolResultChunk;
-
-declare function resolveWorkspacePath(rootDir: string, inputPath: string): string;
-declare function assertWorkspaceFile(filePath: string): Promise<void>;
-declare function isProbablyBinary(buffer: Buffer): boolean;
+export declare class ToolRegistry {
+	private readonly toolsByName;
+	constructor(tools?: AnyToolDefinition[]);
+	register(tool: AnyToolDefinition): void;
+	get(name: string): AnyToolDefinition | undefined;
+	list(): AnyToolDefinition[];
+	listToolSchemas(): ToolSchema[];
+}
+export declare function validateToolInput<TSchema extends JsonSchemaObject>(input: JsonValue, schema: TSchema): InferJsonSchema<TSchema>;
+export declare function deriveFinalToolOutput(chunks: ToolResultChunk[]): ToolResultChunk;
+export interface ViewFileToolOptions {
+	defaultCwd?: string;
+	maxBytes?: number;
+	name?: string;
+}
+export declare function createViewFileTool(options?: ViewFileToolOptions): ToolDefinition<{
+	path: string;
+	detail?: string | undefined;
+}, ToolOutputEnvelope, undefined, {
+	type: "object";
+	properties: {
+		path: {
+			type: "string";
+		};
+		detail: {
+			type: "string";
+		};
+	};
+	required: readonly [
+		"path"
+	];
+}>;
+export declare function resolveWorkspacePath(rootDir: string, inputPath: string): string;
+export declare function assertWorkspaceFile(filePath: string): Promise<void>;
+export declare function isProbablyBinary(buffer: Buffer): boolean;
 
-export { type BashToolInput, type BashToolOptions, type CommandReference, type CommandSource, type CommandToolOptions, type CreateDelegationToolsOptions, type DelegatedAgentDefinition, type DelegatedAgentFactoryContext, type FileEditToolOptions, type FileNewToolOptions, type FileReadToolOptions, type GlobToolOptions, type GrepToolOptions, type LoadedCommand, type LoadedSkill, type LsToolOptions, type McpConnectionOptions, type McpConnector, type McpOAuthProviderOptions, type McpServerConnectionStatus, type McpToolBundle, type McpToolClient, type McpToolDescriptor, type RipgrepMatch, type SkillReference, type SkillSource, type SkillToolOptions, ToolExecutionError, ToolRegistry, assertWorkspaceFile, buildMcpHttpHeaders, connectMcpServer, createAssignTaskTool, createBashTool, createDelegateToAgentTool, createDelegationTools, createFileEditTool, createFileNewTool, createFileReadTool, createGlobTool, createGrepTool, createInternalToolRuntime, createInvokeCommandTool, createLoadSkillTool, createLsTool, createMcpOAuthProvider, createMcpTool, createMcpToolName, createMcpToolsFromServers, createMockToolRuntime, createShellExecTool, createToolOutput, defineTool, deriveFinalToolOutput, filepath, files, isProbablyBinary, normalizeToolOutputValue, resolveWorkspacePath, search, toNuvinToolSchema, validateToolInput };
+export {};