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

package/dist/tools/index.d.ts

@@ -1,1021 +1,570 @@
-// Generated by dts-bundle-generator v9.5.1
-
+import { b1 as ToolDefinition, au as ToolOutputEnvelope, b2 as AnyToolDefinition, aX as ToolRuntimeEventHandler, aW as ToolRuntimeToolCallHandler, aZ as ToolRuntime, H as JsonObject, V as JsonSchemaObject, W as JsonSchema, bc as AgentDefinitionFactoryContext, A as AgentOptions, a$ as ToolOutputValue, at as ToolResultChunk, _ as ToolResultContent, a_ as InferJsonSchema, az as ToolExecutionContext, aj as ToolSchema, I as JsonValue } from '../types-QPBW5jHO.js';
+import { CommandDefinitionReference, SerializedCommandDefinition, MCPAuthConfig, MCPServerConfig } from '@nuvin/config';
 import { OAuthClientProvider } from '@modelcontextprotocol/sdk/client/auth.js';
 import { CallToolResult, ListToolsResult } from '@modelcontextprotocol/sdk/types.js';
 
-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;
+interface BashToolInput {
+    command: string;
+    cwd?: string;
+    timeoutMs?: number;
+    ignoreOutput?: boolean;
+}
+interface BashToolOptions {
+    allowedDirs?: readonly string[];
+    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;
 }, 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"];
 }>;
-export declare function createShellExecTool(options?: BashToolOptions): ToolDefinition<{
-	command: string;
-	cwd?: string | undefined;
-	timeoutMs?: number | undefined;
-	ignoreOutput?: boolean | undefined;
+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"];
 }>;
-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;
+
+type CommandReference = CommandDefinitionReference;
+type LoadedCommand = SerializedCommandDefinition;
+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;
 }, 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"];
 }>;
-export interface FileEditToolOptions {
-	defaultCwd?: string;
-	name?: string;
-}
-export declare function createFileEditTool(options?: FileEditToolOptions): ToolDefinition<{
-	filePath: string;
-	oldText: string;
-	newText: string;
-	dryRun?: boolean | undefined;
+
+interface FileEditToolOptions {
+    allowedDirs?: readonly string[];
+    defaultCwd?: string;
+    name?: string;
+}
+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"];
 }>;
-export interface FileNewToolOptions {
-	defaultCwd?: string;
-	name?: string;
-}
-export declare function createFileNewTool(options?: FileNewToolOptions): ToolDefinition<{
-	content: string;
-	filePath: string;
+
+interface FileNewToolOptions {
+    allowedDirs?: readonly string[];
+    defaultCwd?: string;
+    name?: string;
+}
+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"];
 }>;
-export interface FileReadToolOptions {
-	defaultCwd?: string;
-	name?: string;
-}
-export declare function createFileReadTool(options?: FileReadToolOptions): ToolDefinition<{
-	path: string;
-	lineStart?: number | undefined;
-	lineEnd?: number | undefined;
+
+interface FileReadToolOptions {
+    allowedDirs?: readonly string[];
+    defaultCwd?: string;
+    name?: string;
+}
+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"];
 }>;
-export interface GlobToolOptions {
-	defaultCwd?: string;
-	limit?: number;
-	name?: string;
-}
-export declare function createGlobTool(options?: GlobToolOptions): ToolDefinition<{
-	pattern: string;
-	path?: string | undefined;
-	limit?: number | undefined;
+
+interface GlobToolOptions {
+    allowedDirs?: readonly string[];
+    defaultCwd?: string;
+    limit?: number;
+    name?: string;
+}
+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"];
 }>;
-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;
+
+interface GrepToolOptions {
+    allowedDirs?: readonly string[];
+    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;
 }, 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"];
 }>;
-export interface InternalToolRuntimeOptions {
-	onEvent?: ToolRuntimeEventHandler;
-	onToolCall?: ToolRuntimeToolCallHandler;
-}
-export declare function createInternalToolRuntime(tools?: AnyToolDefinition[], options?: InternalToolRuntimeOptions): ToolRuntime;
-export interface LsToolOptions {
-	defaultCwd?: string;
-	name?: string;
+
+interface InternalToolRuntimeOptions {
+    onEvent?: ToolRuntimeEventHandler;
+    onToolCall?: ToolRuntimeToolCallHandler;
 }
-export declare function createLsTool(options?: LsToolOptions): ToolDefinition<{
-	path: string;
-	limit: number;
+declare function createInternalToolRuntime(tools?: AnyToolDefinition[], options?: InternalToolRuntimeOptions): ToolRuntime;
+
+interface LsToolOptions {
+    allowedDirs?: readonly string[];
+    defaultCwd?: string;
+    name?: string;
+}
+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";
+        };
+    };
 }>;
-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;
+
+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;
 }): 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>>;
-export interface ConnectedMcpClient extends McpToolClient {
-	listTools(): Promise<ListToolsResult>;
-	close(): Promise<void>;
+
+interface ConnectedMcpClient extends McpToolClient {
+    listTools(): Promise<ListToolsResult>;
+    close(): Promise<void>;
 }
-export type McpServerConnectionStatus = {
-	status: "connected";
-	toolCount: number;
+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;
 };
-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;
+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;
 }): Promise<McpToolBundle>;
-export declare function createMockToolRuntime(): ToolRuntime;
-export type RipgrepMatch = {
-	filePath: string;
-	isContext?: boolean;
-	lineNum: number;
-	lineText: string;
+
+declare function createMockToolRuntime(): ToolRuntime;
+
+type RipgrepMatch = {
+    filePath: string;
+    isContext?: boolean;
+    lineNum: number;
+    lineText: string;
 };
-export declare function filepath(): Promise<string>;
-export declare function files(opts: {
-	cwd: string;
-	glob?: string[];
+declare function filepath(): Promise<string>;
+declare function files(opts: {
+    cwd: string;
+    glob?: string[];
 }): AsyncGenerator<string>;
-export declare function search(opts: {
-	context?: number;
-	cwd: string;
-	file?: string;
-	glob?: string;
-	limit?: number;
-	pattern: string;
+declare function search(opts: {
+    context?: number;
+    cwd: string;
+    file?: string;
+    glob?: string;
+    limit?: number;
+    pattern: string;
 }): Promise<RipgrepMatch[]>;
-export interface DelegatedAgentFactoryContext extends AgentDefinitionFactoryContext {
-	parentSessionId: string;
-	runId: string;
+
+interface DelegatedAgentFactoryContext extends AgentDefinitionFactoryContext {
+    parentSessionId: string;
+    runId: string;
 }
-export type DelegatedAgentDefinition = AgentOptions | ((ctx: DelegatedAgentFactoryContext) => AgentOptions | Promise<AgentOptions>);
-export interface CreateDelegationToolsOptions {
-	agents?: Record<string, DelegatedAgentDefinition>;
+type DelegatedAgentDefinition = AgentOptions | ((ctx: DelegatedAgentFactoryContext) => AgentOptions | Promise<AgentOptions>);
+interface CreateDelegationToolsOptions {
+    agents?: Record<string, DelegatedAgentDefinition>;
 }
-export declare function createAssignTaskTool(options: CreateDelegationToolsOptions): ToolDefinition<{
-	task: string;
-	agentId: string;
+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[];
 }>;
-export declare const createDelegateToAgentTool: typeof createAssignTaskTool;
-export declare function createDelegationTools(options: CreateDelegationToolsOptions): ToolDefinition<{
-	task: string;
-	agentId: string;
+declare const createDelegateToAgentTool: typeof createAssignTaskTool;
+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 */
-export interface SkillSource {
-	path: string;
-	directory?: string;
-	scope?: string;
+interface SkillSource {
+    path: string;
+    directory?: string;
+    scope?: string;
 }
 /** Minimal shape of a skill reference — matches @nuvin/config SkillDefinitionReference */
-export interface SkillReference {
-	id: string;
-	name: string;
-	description: string;
-	source: SkillSource;
+interface SkillReference {
+    id: string;
+    name: string;
+    description: string;
+    source: SkillSource;
 }
 /** Minimal shape of a loaded skill — matches @nuvin/config SerializedSkillDefinition */
-export interface LoadedSkill extends SkillReference {
-	instructions: string;
+interface LoadedSkill extends SkillReference {
+    instructions: string;
 }
-export interface SkillToolOptions<TRef extends SkillReference = SkillReference> {
-	skills: TRef[];
-	loadSkill: (reference: TRef) => Promise<LoadedSkill>;
+interface SkillToolOptions<TRef extends SkillReference = SkillReference> {
+    skills: TRef[];
+    loadSkill: (reference: TRef) => Promise<LoadedSkill>;
 }
-export declare function createLoadSkillTool<TRef extends SkillReference>(options: SkillToolOptions<TRef>): ToolDefinition<{
-	name: string;
+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"];
 }>;
-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>;
+
+declare function normalizeToolOutputValue(output: ToolOutputValue): ToolResultChunk;
+declare function createToolOutput(output: string, structured?: JsonObject, content?: ToolResultContent): 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>;
 }): ToolDefinition<InferJsonSchema<TSchema>, TYield, TReturn, TSchema>;
-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;
+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;
+
+interface ViewFileToolOptions {
+    allowedDirs?: readonly string[];
+    defaultCwd?: string;
+    maxBytes?: number;
+    name?: string;
+}
+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"];
+}>;
+
+interface WebFetchToolOptions {
+    maxBytes?: number;
+    timeoutMs?: number;
+    name?: string;
+}
+declare function createWebFetchTool(options?: WebFetchToolOptions): ToolDefinition<{
+    url: string;
+    description?: string | undefined;
 }, ToolOutputEnvelope, undefined, {
-	type: "object";
-	properties: {
-		path: {
-			type: "string";
-		};
-		detail: {
-			type: "string";
-		};
-	};
-	required: readonly [
-		"path"
-	];
+    type: "object";
+    properties: {
+        description: {
+            type: "string";
+        };
+        url: {
+            type: "string";
+        };
+    };
+    required: readonly ["url"];
 }>;
-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 {};
+interface WebSearchToolOptions {
+    googleCseKey: string;
+    googleCseCx: string;
+    name?: string;
+}
+declare function createWebSearchTool(options: WebSearchToolOptions): ToolDefinition<{
+    query: string;
+    type?: string | undefined;
+    count?: number | undefined;
+    description?: string | undefined;
+    offset?: number | undefined;
+    safe?: boolean | undefined;
+    domains?: string[] | undefined;
+    recencyDays?: number | undefined;
+    lang?: string | undefined;
+    region?: string | undefined;
+    hydrateMeta?: boolean | undefined;
+}, ToolOutputEnvelope, undefined, {
+    type: "object";
+    properties: {
+        description: {
+            type: "string";
+        };
+        query: {
+            type: "string";
+        };
+        count: {
+            type: "number";
+        };
+        offset: {
+            type: "number";
+        };
+        domains: {
+            type: "array";
+            items: {
+                type: "string";
+            };
+        };
+        recencyDays: {
+            type: "number";
+        };
+        lang: {
+            type: "string";
+        };
+        region: {
+            type: "string";
+        };
+        safe: {
+            type: "boolean";
+        };
+        type: {
+            type: "string";
+        };
+        hydrateMeta: {
+            type: "boolean";
+        };
+    };
+    required: readonly ["query"];
+}>;
+
+declare function resolveWorkspacePath(rootDir: string, inputPath: string): string;
+declare function resolveAllowedPath(rootDir: string, allowedDirs: readonly string[], inputPath: string): string;
+declare function assertWorkspaceFile(filePath: string): Promise<void>;
+declare function isProbablyBinary(buffer: Buffer): boolean;
+
+export { type BashToolInput, type BashToolOptions, type CommandReference, 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, type ViewFileToolOptions, type WebFetchToolOptions, type WebSearchToolOptions, assertWorkspaceFile, buildMcpHttpHeaders, connectMcpServer, createAssignTaskTool, createBashTool, createDelegateToAgentTool, createDelegationTools, createFileEditTool, createFileNewTool, createFileReadTool, createGlobTool, createGrepTool, createInternalToolRuntime, createInvokeCommandTool, createLoadSkillTool, createLsTool, createMcpOAuthProvider, createMcpTool, createMcpToolName, createMcpToolsFromServers, createMockToolRuntime, createShellExecTool, createToolOutput, createViewFileTool, createWebFetchTool, createWebSearchTool, defineTool, deriveFinalToolOutput, filepath, files, isProbablyBinary, normalizeToolOutputValue, resolveAllowedPath, resolveWorkspacePath, search, toNuvinToolSchema, validateToolInput };