@aria-cli/tools 1.0.18 → 1.0.31

package/dist-cjs/tool-factory.d.ts

@@ -1,46 +0,0 @@
-/**
- * @aria/tools - Tool factory function
- *
- * Creates Tool objects from Zod schemas with runtime validation.
- */
-import type { ZodType } from "zod";
-import type { Tool, ToolCategory, ToolContext, ToolResult, RiskLevel, LoadingTier } from "./types.js";
-/** Options for the tool() factory function */
-export interface ToolFactoryOptions<T> {
-    /** Unique tool name */
-    name: string;
-    /** Human-readable description */
-    description: string;
-    /** Zod schema for parameter validation */
-    parameters: ZodType<T>;
-    /** Tool execution handler - receives Zod-validated input */
-    execute: (input: T, context: ToolContext) => Promise<ToolResult>;
-    /** Risk level for auto-approval (default: "safe") */
-    riskLevel?: RiskLevel;
-    /** Whether this tool only reads state (default: true) */
-    isReadOnly?: boolean;
-    /** Tool category (default: "meta") */
-    category?: ToolCategory;
-    /** Loading tier for TTFT optimization (default: "always") */
-    loadingTier?: LoadingTier;
-}
-/**
- * Factory function for creating Tool objects from Zod schemas.
- *
- * Converts the Zod schema to JSON Schema 7 for LLM consumption,
- * and wraps the execute handler with Zod validation.
- *
- * @example
- * ```ts
- * const getWeather = tool({
- *   name: "get_weather",
- *   description: "Get weather for a city",
- *   parameters: z.object({ city: z.string(), units: z.enum(["F", "C"]) }),
- *   execute: async (input) => ({
- *     success: true,
- *     message: `Weather in ${input.city}: sunny`,
- *   }),
- * });
- * ```
- */
-export declare function tool<T>(options: ToolFactoryOptions<T>): Tool;