react-observer-agent 0.2.0 → 0.3.0

package/dist/index.d.cts

@@ -1,16 +1,64 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 
 type JSONSchema = Record<string, unknown>;
+/**
+ * Passed to every tool handler as its second argument. Handlers written
+ * against older versions take one argument, so read it as `context?.signal`.
+ */
+interface ToolContext {
+    /** Aborts when the interaction is cancelled. Forward it to fetch or other long work. */
+    signal?: AbortSignal;
+}
+type ToolHandler<TArgs = unknown> = (args: TArgs, context?: ToolContext) => unknown | Promise<unknown>;
+/**
+ * A minimal copy of the Standard Schema v1 interface (standardschema.dev).
+ * The spec is meant to be copied, which keeps this package dependency free
+ * while accepting validators from Zod 3.24+, Valibot 1+ and ArkType 2+.
+ */
+interface StandardSchemaV1<Input = unknown, Output = Input> {
+    readonly '~standard': StandardSchemaProps<Input, Output>;
+}
+interface StandardSchemaProps<Input = unknown, Output = Input> {
+    readonly version: 1;
+    readonly vendor: string;
+    readonly validate: (value: unknown) => StandardSchemaResult<Output> | Promise<StandardSchemaResult<Output>>;
+    readonly types?: {
+        readonly input: Input;
+        readonly output: Output;
+    } | undefined;
+}
+type StandardSchemaResult<Output> = {
+    readonly value: Output;
+    readonly issues?: undefined;
+} | {
+    readonly issues: ReadonlyArray<StandardSchemaIssue>;
+};
+interface StandardSchemaIssue {
+    readonly message: string;
+    readonly path?: ReadonlyArray<PropertyKey | {
+        readonly key: PropertyKey;
+    }> | undefined;
+}
+/** The value a schema produces after validation, which transforms may reshape. */
+type InferSchemaOutput<S extends StandardSchemaV1> = NonNullable<S['~standard']['types']>['output'];
 interface ToolOptions {
     description?: string;
     parameters?: JSONSchema;
+    /**
+     * Optional Standard Schema validator (Zod 3.24+, Valibot 1+, ArkType 2+).
+     * When present, runtime validation runs through it instead of the built-in
+     * JSON Schema subset, and the handler receives the validated value.
+     * `parameters` still supplies the JSON Schema the model sees.
+     */
+    schema?: StandardSchemaV1;
     confirm?: boolean;
 }
 interface ToolDefinition<TArgs = unknown> {
     name: string;
-    handler: (args: TArgs) => unknown | Promise<unknown>;
+    handler: ToolHandler<TArgs>;
     description?: string;
     parameters?: JSONSchema;
+    schema?: StandardSchemaV1;
     confirm: boolean;
 }
 /**
@@ -19,32 +67,65 @@ interface ToolDefinition<TArgs = unknown> {
  * handler parameters are contravariant.
  */
 type AnyToolDefinition = ToolDefinition<any>;
+type ToolCallStatus = 'success' | 'error' | 'denied' | 'confirmed' | 'cancelled';
 interface ToolCallResult {
     toolName: string;
     args: unknown;
     result: unknown;
-    status: 'success' | 'error' | 'denied' | 'confirmed' | 'cancelled';
+    status: ToolCallStatus;
 }
 interface ConversationEntry {
     role: 'user' | 'assistant' | 'tool';
     content: string;
     toolCalls?: ToolCallResult[];
+    /** Assistant entries only: the interaction ended with this error, ABORTED included. */
+    error?: AgentError;
     timestamp: number;
 }
+/** Observation only. Emitted through `AgentOptions.onEvent` as the loop runs. */
+type AgentEvent = {
+    type: 'turn_start';
+    turn: number;
+    maxTurns: number;
+} | {
+    type: 'state_read';
+    requested: string[];
+    keys: string[];
+} | {
+    type: 'tool_start';
+    toolName: string;
+    args: unknown;
+} | {
+    type: 'tool_end';
+    toolName: string;
+    args: unknown;
+    result: unknown;
+    status: ToolCallStatus;
+};
+type AgentErrorCode = 'ABORTED' | 'MAX_TURNS' | 'ADAPTER_ERROR' | 'TRUNCATED' | 'REFUSED';
 interface AgentError {
     message: string;
-    code?: string;
+    code?: AgentErrorCode;
+    /** HTTP status when the failure came from an adapter with one. */
+    status?: number;
     cause?: unknown;
 }
+interface TokenUsage {
+    /** Total input tokens for the call, cached portion included. */
+    promptTokens: number;
+    /** Output tokens generated by the model. */
+    completionTokens: number;
+    /** Part of `promptTokens` served from the cache, when the provider reports it. */
+    cacheReadTokens?: number;
+    /** Part of `promptTokens` written to the cache, when the provider reports it. */
+    cacheWriteTokens?: number;
+}
 interface AgentResponse {
     message: string;
     toolCalls: ToolCallResult[];
     error?: AgentError;
     /** Totalled across every model call in the interaction, when the adapter reports it. */
-    usage?: {
-        promptTokens: number;
-        completionTokens: number;
-    };
+    usage?: TokenUsage;
 }
 interface SendOptions {
     /** Cancels the interaction. The pending response resolves with an ABORTED error. */
@@ -67,6 +148,10 @@ interface ConversationMessage {
     content: string;
     toolCallId?: string;
     toolCalls?: LLMToolCall[];
+    /** Tool messages only: the result reports a failure (denied, invalid arguments, handler threw). */
+    isError?: boolean;
+    /** Opaque, adapter-owned. The loop copies it from ModelResponse and replays it verbatim. */
+    providerData?: unknown;
 }
 interface LLMToolDefinition {
     name: string;
@@ -90,13 +175,14 @@ interface ModelRequest {
     /** Adapters should forward this to their transport so requests cancel in flight. */
     signal?: AbortSignal;
 }
+/** Why the model stopped, normalized across providers. */
+type StopReason = 'end' | 'tool_use' | 'max_tokens' | 'refusal' | 'other';
 interface ModelResponse {
     content: string | null;
     toolCalls?: LLMToolCall[];
-    usage?: {
-        promptTokens: number;
-        completionTokens: number;
-    };
+    usage?: TokenUsage;
+    stopReason?: StopReason;
+    providerData?: unknown;
 }
 interface ModelAdapter {
     sendMessage(request: ModelRequest): Promise<ModelResponse>;
@@ -111,20 +197,25 @@ interface PendingToolCall {
     toolName: string;
     args: unknown;
     description?: string;
+    /** Aborts when the interaction is cancelled while confirmation is pending. */
+    signal?: AbortSignal;
 }
 interface ToolCallEvent {
     toolName: string;
     args: unknown;
     result: unknown;
-    status: ToolCallResult['status'];
+    status: ToolCallStatus;
 }
 interface AgentOptions {
     debug?: boolean;
     maxTurns?: number;
     systemPrompt?: string;
+    /** Byte ceiling per state key in a snapshot. Unset means no limit. */
+    maxStateBytes?: number;
     onError?: (error: AgentError) => void;
     onToolCall?: (call: ToolCallEvent) => void;
     onConfirm?: (call: PendingToolCall) => Promise<boolean>;
+    onEvent?: (event: AgentEvent) => void;
 }
 interface AIAgentProviderProps {
     model: ModelAdapter;
@@ -138,7 +229,8 @@ interface OpenAIAdapterConfig {
     apiKey?: string;
     model?: string;
     baseURL?: string;
-    temperature?: number;
+    /** Defaults to 0.2. Pass null to omit the field from the request. */
+    temperature?: number | null;
     headers?: Record<string, string>;
 }
 interface ClaudeAdapterConfig {
@@ -147,13 +239,57 @@ interface ClaudeAdapterConfig {
     baseURL?: string;
     /** Required by the Anthropic API. Defaults to 16000. */
     maxTokens?: number;
+    /** Prompt caching for tools and system prompt. Defaults to true. */
+    cache?: boolean;
     headers?: Record<string, string>;
 }
 
-declare function registerTool<TArgs = unknown>(name: string, handler: (args: TArgs) => unknown | Promise<unknown>, options?: ToolOptions): ToolDefinition<TArgs>;
+/**
+ * With a Standard Schema, the handler's argument type comes from the schema.
+ *
+ * `schema` is omitted before the intersection rather than narrowed in place.
+ * Intersecting leaves `StandardSchemaV1 & S`, and checking a validator against
+ * that walks its self-referential methods: a Zod 3 object has `deepPartial()`
+ * returning a different object type, which cannot satisfy the intersection, so
+ * the call fails to match this overload. Omitting the key first leaves `S`
+ * alone and costs nothing, since `S` is already constrained to a validator.
+ */
+declare function registerTool<S extends StandardSchemaV1>(name: string, handler: ToolHandler<InferSchemaOutput<S>>, options: Omit<ToolOptions, 'schema'> & {
+    schema: S;
+}): ToolDefinition<InferSchemaOutput<S>>;
+/**
+ * Without a schema the argument type is the handler's own. The conditional
+ * keeps an inferred schema whose output disagrees with that type from falling
+ * through to here instead of failing. `O` defaults to options without a
+ * `schema` key because an explicit type argument turns inference off, and with
+ * it the conditional: an inline schema next to an explicit type argument would
+ * leave two unchecked sources of truth for `TArgs`, so it is an excess
+ * property error. Drop the type argument and let the schema supply it. A
+ * variable typed as plain `ToolOptions` still passes, with or without an
+ * explicit type argument, since its schema output is `unknown`.
+ */
+declare function registerTool<TArgs = unknown, O extends ToolOptions = Omit<ToolOptions, 'schema'>>(name: string, handler: ToolHandler<TArgs>, options?: O & (O extends {
+    schema: StandardSchemaV1;
+} ? {
+    schema: StandardSchemaV1<unknown, TArgs>;
+} : unknown)): ToolDefinition<TArgs>;
 
 declare function validateToolNames(tools: AnyToolDefinition[]): void;
 
+type ToolArgsValidation = {
+    valid: true;
+    value: unknown;
+} | {
+    valid: false;
+    errors: string[];
+};
+/**
+ * Validates tool arguments, preferring a Standard Schema when the tool carries
+ * one. The returned `value` is what the handler should receive: a schema may
+ * apply defaults or transforms, so it is not always the input.
+ */
+declare function validateToolArgs(tool: AnyToolDefinition, args: unknown): Promise<ToolArgsValidation>;
+
 declare function AIAgentProvider({ model, state, tools, permissions, options, children, }: AIAgentProviderProps): react_jsx_runtime.JSX.Element;
 
 declare function useAgent(): AgentContext;
@@ -168,4 +304,20 @@ declare function openAIAdapter(config: OpenAIAdapterConfig): ModelAdapter;
 
 declare function claudeAdapter(config: ClaudeAdapterConfig): ModelAdapter;
 
-export { AIAgentProvider, type AIAgentProviderProps, type AgentContext, type AgentError, type AgentOptions, type AgentResponse, type AnyToolDefinition, type ClaudeAdapterConfig, type ConversationEntry, type ConversationMessage, type JSONSchema, type LLMToolCall, type LLMToolDefinition, type ModelAdapter, type ModelRequest, type ModelResponse, type OpenAIAdapterConfig, type PendingToolCall, type PermissionsConfig, type SendOptions, type StateSource, type ToolCallEvent, type ToolCallResult, type ToolDefinition, type ToolOptions, claudeAdapter, filterState, filterTools, openAIAdapter, registerTool, useAgent, validateToolCall, validateToolNames };
+/**
+ * Thrown by the built-in adapters. Carries the HTTP status and raw body when
+ * the failure came from a response, so callers can tell a 401 from a 429
+ * without parsing the message.
+ */
+declare class AdapterError extends Error {
+    readonly name: "AdapterError";
+    readonly status?: number;
+    readonly body?: string;
+    constructor(message: string, options?: {
+        status?: number;
+        body?: string;
+        cause?: unknown;
+    });
+}
+
+export { AIAgentProvider, type AIAgentProviderProps, AdapterError, type AgentContext, type AgentError, type AgentErrorCode, type AgentEvent, type AgentOptions, type AgentResponse, type AnyToolDefinition, type ClaudeAdapterConfig, type ConversationEntry, type ConversationMessage, type InferSchemaOutput, type JSONSchema, type LLMToolCall, type LLMToolDefinition, type ModelAdapter, type ModelRequest, type ModelResponse, type OpenAIAdapterConfig, type PendingToolCall, type PermissionsConfig, type SendOptions, type StandardSchemaIssue, type StandardSchemaProps, type StandardSchemaResult, type StandardSchemaV1, type StateSource, type StopReason, type TokenUsage, type ToolArgsValidation, type ToolCallEvent, type ToolCallResult, type ToolCallStatus, type ToolContext, type ToolDefinition, type ToolHandler, type ToolOptions, claudeAdapter, filterState, filterTools, openAIAdapter, registerTool, useAgent, validateToolArgs, validateToolCall, validateToolNames };

package/dist/index.d.ts

@@ -1,16 +1,64 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 
 type JSONSchema = Record<string, unknown>;
+/**
+ * Passed to every tool handler as its second argument. Handlers written
+ * against older versions take one argument, so read it as `context?.signal`.
+ */
+interface ToolContext {
+    /** Aborts when the interaction is cancelled. Forward it to fetch or other long work. */
+    signal?: AbortSignal;
+}
+type ToolHandler<TArgs = unknown> = (args: TArgs, context?: ToolContext) => unknown | Promise<unknown>;
+/**
+ * A minimal copy of the Standard Schema v1 interface (standardschema.dev).
+ * The spec is meant to be copied, which keeps this package dependency free
+ * while accepting validators from Zod 3.24+, Valibot 1+ and ArkType 2+.
+ */
+interface StandardSchemaV1<Input = unknown, Output = Input> {
+    readonly '~standard': StandardSchemaProps<Input, Output>;
+}
+interface StandardSchemaProps<Input = unknown, Output = Input> {
+    readonly version: 1;
+    readonly vendor: string;
+    readonly validate: (value: unknown) => StandardSchemaResult<Output> | Promise<StandardSchemaResult<Output>>;
+    readonly types?: {
+        readonly input: Input;
+        readonly output: Output;
+    } | undefined;
+}
+type StandardSchemaResult<Output> = {
+    readonly value: Output;
+    readonly issues?: undefined;
+} | {
+    readonly issues: ReadonlyArray<StandardSchemaIssue>;
+};
+interface StandardSchemaIssue {
+    readonly message: string;
+    readonly path?: ReadonlyArray<PropertyKey | {
+        readonly key: PropertyKey;
+    }> | undefined;
+}
+/** The value a schema produces after validation, which transforms may reshape. */
+type InferSchemaOutput<S extends StandardSchemaV1> = NonNullable<S['~standard']['types']>['output'];
 interface ToolOptions {
     description?: string;
     parameters?: JSONSchema;
+    /**
+     * Optional Standard Schema validator (Zod 3.24+, Valibot 1+, ArkType 2+).
+     * When present, runtime validation runs through it instead of the built-in
+     * JSON Schema subset, and the handler receives the validated value.
+     * `parameters` still supplies the JSON Schema the model sees.
+     */
+    schema?: StandardSchemaV1;
     confirm?: boolean;
 }
 interface ToolDefinition<TArgs = unknown> {
     name: string;
-    handler: (args: TArgs) => unknown | Promise<unknown>;
+    handler: ToolHandler<TArgs>;
     description?: string;
     parameters?: JSONSchema;
+    schema?: StandardSchemaV1;
     confirm: boolean;
 }
 /**
@@ -19,32 +67,65 @@ interface ToolDefinition<TArgs = unknown> {
  * handler parameters are contravariant.
  */
 type AnyToolDefinition = ToolDefinition<any>;
+type ToolCallStatus = 'success' | 'error' | 'denied' | 'confirmed' | 'cancelled';
 interface ToolCallResult {
     toolName: string;
     args: unknown;
     result: unknown;
-    status: 'success' | 'error' | 'denied' | 'confirmed' | 'cancelled';
+    status: ToolCallStatus;
 }
 interface ConversationEntry {
     role: 'user' | 'assistant' | 'tool';
     content: string;
     toolCalls?: ToolCallResult[];
+    /** Assistant entries only: the interaction ended with this error, ABORTED included. */
+    error?: AgentError;
     timestamp: number;
 }
+/** Observation only. Emitted through `AgentOptions.onEvent` as the loop runs. */
+type AgentEvent = {
+    type: 'turn_start';
+    turn: number;
+    maxTurns: number;
+} | {
+    type: 'state_read';
+    requested: string[];
+    keys: string[];
+} | {
+    type: 'tool_start';
+    toolName: string;
+    args: unknown;
+} | {
+    type: 'tool_end';
+    toolName: string;
+    args: unknown;
+    result: unknown;
+    status: ToolCallStatus;
+};
+type AgentErrorCode = 'ABORTED' | 'MAX_TURNS' | 'ADAPTER_ERROR' | 'TRUNCATED' | 'REFUSED';
 interface AgentError {
     message: string;
-    code?: string;
+    code?: AgentErrorCode;
+    /** HTTP status when the failure came from an adapter with one. */
+    status?: number;
     cause?: unknown;
 }
+interface TokenUsage {
+    /** Total input tokens for the call, cached portion included. */
+    promptTokens: number;
+    /** Output tokens generated by the model. */
+    completionTokens: number;
+    /** Part of `promptTokens` served from the cache, when the provider reports it. */
+    cacheReadTokens?: number;
+    /** Part of `promptTokens` written to the cache, when the provider reports it. */
+    cacheWriteTokens?: number;
+}
 interface AgentResponse {
     message: string;
     toolCalls: ToolCallResult[];
     error?: AgentError;
     /** Totalled across every model call in the interaction, when the adapter reports it. */
-    usage?: {
-        promptTokens: number;
-        completionTokens: number;
-    };
+    usage?: TokenUsage;
 }
 interface SendOptions {
     /** Cancels the interaction. The pending response resolves with an ABORTED error. */
@@ -67,6 +148,10 @@ interface ConversationMessage {
     content: string;
     toolCallId?: string;
     toolCalls?: LLMToolCall[];
+    /** Tool messages only: the result reports a failure (denied, invalid arguments, handler threw). */
+    isError?: boolean;
+    /** Opaque, adapter-owned. The loop copies it from ModelResponse and replays it verbatim. */
+    providerData?: unknown;
 }
 interface LLMToolDefinition {
     name: string;
@@ -90,13 +175,14 @@ interface ModelRequest {
     /** Adapters should forward this to their transport so requests cancel in flight. */
     signal?: AbortSignal;
 }
+/** Why the model stopped, normalized across providers. */
+type StopReason = 'end' | 'tool_use' | 'max_tokens' | 'refusal' | 'other';
 interface ModelResponse {
     content: string | null;
     toolCalls?: LLMToolCall[];
-    usage?: {
-        promptTokens: number;
-        completionTokens: number;
-    };
+    usage?: TokenUsage;
+    stopReason?: StopReason;
+    providerData?: unknown;
 }
 interface ModelAdapter {
     sendMessage(request: ModelRequest): Promise<ModelResponse>;
@@ -111,20 +197,25 @@ interface PendingToolCall {
     toolName: string;
     args: unknown;
     description?: string;
+    /** Aborts when the interaction is cancelled while confirmation is pending. */
+    signal?: AbortSignal;
 }
 interface ToolCallEvent {
     toolName: string;
     args: unknown;
     result: unknown;
-    status: ToolCallResult['status'];
+    status: ToolCallStatus;
 }
 interface AgentOptions {
     debug?: boolean;
     maxTurns?: number;
     systemPrompt?: string;
+    /** Byte ceiling per state key in a snapshot. Unset means no limit. */
+    maxStateBytes?: number;
     onError?: (error: AgentError) => void;
     onToolCall?: (call: ToolCallEvent) => void;
     onConfirm?: (call: PendingToolCall) => Promise<boolean>;
+    onEvent?: (event: AgentEvent) => void;
 }
 interface AIAgentProviderProps {
     model: ModelAdapter;
@@ -138,7 +229,8 @@ interface OpenAIAdapterConfig {
     apiKey?: string;
     model?: string;
     baseURL?: string;
-    temperature?: number;
+    /** Defaults to 0.2. Pass null to omit the field from the request. */
+    temperature?: number | null;
     headers?: Record<string, string>;
 }
 interface ClaudeAdapterConfig {
@@ -147,13 +239,57 @@ interface ClaudeAdapterConfig {
     baseURL?: string;
     /** Required by the Anthropic API. Defaults to 16000. */
     maxTokens?: number;
+    /** Prompt caching for tools and system prompt. Defaults to true. */
+    cache?: boolean;
     headers?: Record<string, string>;
 }
 
-declare function registerTool<TArgs = unknown>(name: string, handler: (args: TArgs) => unknown | Promise<unknown>, options?: ToolOptions): ToolDefinition<TArgs>;
+/**
+ * With a Standard Schema, the handler's argument type comes from the schema.
+ *
+ * `schema` is omitted before the intersection rather than narrowed in place.
+ * Intersecting leaves `StandardSchemaV1 & S`, and checking a validator against
+ * that walks its self-referential methods: a Zod 3 object has `deepPartial()`
+ * returning a different object type, which cannot satisfy the intersection, so
+ * the call fails to match this overload. Omitting the key first leaves `S`
+ * alone and costs nothing, since `S` is already constrained to a validator.
+ */
+declare function registerTool<S extends StandardSchemaV1>(name: string, handler: ToolHandler<InferSchemaOutput<S>>, options: Omit<ToolOptions, 'schema'> & {
+    schema: S;
+}): ToolDefinition<InferSchemaOutput<S>>;
+/**
+ * Without a schema the argument type is the handler's own. The conditional
+ * keeps an inferred schema whose output disagrees with that type from falling
+ * through to here instead of failing. `O` defaults to options without a
+ * `schema` key because an explicit type argument turns inference off, and with
+ * it the conditional: an inline schema next to an explicit type argument would
+ * leave two unchecked sources of truth for `TArgs`, so it is an excess
+ * property error. Drop the type argument and let the schema supply it. A
+ * variable typed as plain `ToolOptions` still passes, with or without an
+ * explicit type argument, since its schema output is `unknown`.
+ */
+declare function registerTool<TArgs = unknown, O extends ToolOptions = Omit<ToolOptions, 'schema'>>(name: string, handler: ToolHandler<TArgs>, options?: O & (O extends {
+    schema: StandardSchemaV1;
+} ? {
+    schema: StandardSchemaV1<unknown, TArgs>;
+} : unknown)): ToolDefinition<TArgs>;
 
 declare function validateToolNames(tools: AnyToolDefinition[]): void;
 
+type ToolArgsValidation = {
+    valid: true;
+    value: unknown;
+} | {
+    valid: false;
+    errors: string[];
+};
+/**
+ * Validates tool arguments, preferring a Standard Schema when the tool carries
+ * one. The returned `value` is what the handler should receive: a schema may
+ * apply defaults or transforms, so it is not always the input.
+ */
+declare function validateToolArgs(tool: AnyToolDefinition, args: unknown): Promise<ToolArgsValidation>;
+
 declare function AIAgentProvider({ model, state, tools, permissions, options, children, }: AIAgentProviderProps): react_jsx_runtime.JSX.Element;
 
 declare function useAgent(): AgentContext;
@@ -168,4 +304,20 @@ declare function openAIAdapter(config: OpenAIAdapterConfig): ModelAdapter;
 
 declare function claudeAdapter(config: ClaudeAdapterConfig): ModelAdapter;
 
-export { AIAgentProvider, type AIAgentProviderProps, type AgentContext, type AgentError, type AgentOptions, type AgentResponse, type AnyToolDefinition, type ClaudeAdapterConfig, type ConversationEntry, type ConversationMessage, type JSONSchema, type LLMToolCall, type LLMToolDefinition, type ModelAdapter, type ModelRequest, type ModelResponse, type OpenAIAdapterConfig, type PendingToolCall, type PermissionsConfig, type SendOptions, type StateSource, type ToolCallEvent, type ToolCallResult, type ToolDefinition, type ToolOptions, claudeAdapter, filterState, filterTools, openAIAdapter, registerTool, useAgent, validateToolCall, validateToolNames };
+/**
+ * Thrown by the built-in adapters. Carries the HTTP status and raw body when
+ * the failure came from a response, so callers can tell a 401 from a 429
+ * without parsing the message.
+ */
+declare class AdapterError extends Error {
+    readonly name: "AdapterError";
+    readonly status?: number;
+    readonly body?: string;
+    constructor(message: string, options?: {
+        status?: number;
+        body?: string;
+        cause?: unknown;
+    });
+}
+
+export { AIAgentProvider, type AIAgentProviderProps, AdapterError, type AgentContext, type AgentError, type AgentErrorCode, type AgentEvent, type AgentOptions, type AgentResponse, type AnyToolDefinition, type ClaudeAdapterConfig, type ConversationEntry, type ConversationMessage, type InferSchemaOutput, type JSONSchema, type LLMToolCall, type LLMToolDefinition, type ModelAdapter, type ModelRequest, type ModelResponse, type OpenAIAdapterConfig, type PendingToolCall, type PermissionsConfig, type SendOptions, type StandardSchemaIssue, type StandardSchemaProps, type StandardSchemaResult, type StandardSchemaV1, type StateSource, type StopReason, type TokenUsage, type ToolArgsValidation, type ToolCallEvent, type ToolCallResult, type ToolCallStatus, type ToolContext, type ToolDefinition, type ToolHandler, type ToolOptions, claudeAdapter, filterState, filterTools, openAIAdapter, registerTool, useAgent, validateToolArgs, validateToolCall, validateToolNames };