@agentrun/sdk 0.0.3 → 0.0.4

package/dist/toolset/index.d.ts

@@ -0,0 +1,182 @@
+export { T as ToolSetClient } from '../client-DHXxjuo3.js';
+export { M as MCPToolMeta, k as ToolInfo, l as ToolSchema, T as ToolSet, a as ToolSetAuthorization, b as ToolSetCreateInput, c as ToolSetData, d as ToolSetListInput, e as ToolSetSchema, f as ToolSetSchemaType, g as ToolSetSpec, h as ToolSetStatus, i as ToolSetStatusOutputs, j as ToolSetUpdateInput } from '../toolset-CSRsJxCb.js';
+import { C as Config } from '../config-07gMelJP.js';
+export { MCPSession, MCPToolSet, ToolControlAPI } from './api/index.js';
+import '../model--I90nCqy.js';
+import '@alicloud/devs20230714';
+
+/**
+ * OpenAPI Protocol Handler
+ *
+ * 处理 OpenAPI 规范的工具解析和调用。
+ * Handles tool parsing and invocation for OpenAPI specification.
+ */
+
+/**
+ * Tool parameter schema
+ */
+interface ToolParameterSchema {
+    type?: string;
+    description?: string;
+    properties?: Record<string, ToolParameterSchema>;
+    required?: string[];
+    items?: ToolParameterSchema;
+    enum?: unknown[];
+    default?: unknown;
+    format?: string;
+    minimum?: number;
+    maximum?: number;
+    minLength?: number;
+    maxLength?: number;
+    pattern?: string;
+}
+/**
+ * Tool information
+ */
+interface ToolInfo {
+    name: string;
+    description?: string;
+    parameters?: ToolParameterSchema;
+    operationId?: string;
+    method?: string;
+    path?: string;
+}
+/**
+ * Invoke result
+ */
+interface InvokeResult {
+    status_code: number;
+    headers?: Record<string, string>;
+    body?: unknown;
+    error?: string;
+}
+/**
+ * OpenAPI handler options
+ */
+interface OpenAPIOptions {
+    /** OpenAPI schema (JSON string or object) */
+    schema: string | Record<string, unknown>;
+    /** Base URL for API calls */
+    baseUrl?: string;
+    /** Default headers for all requests */
+    headers?: Record<string, string>;
+    /** Default query parameters */
+    queryParams?: Record<string, string>;
+    /** Configuration */
+    config?: Config;
+}
+/**
+ * OpenAPI Handler class
+ *
+ * Parses OpenAPI schema and provides tool invocation capabilities.
+ */
+declare class OpenAPI {
+    private _schema;
+    private _baseUrl;
+    private _defaultHeaders;
+    private _defaultQueryParams;
+    private _config?;
+    private _tools;
+    constructor(options: OpenAPIOptions);
+    /**
+     * Get the parsed schema
+     */
+    get schema(): Record<string, unknown>;
+    /**
+     * Get all parsed tools
+     */
+    get tools(): ToolInfo[];
+    /**
+     * Get a specific tool by name
+     */
+    getTool(name: string): ToolInfo | undefined;
+    /**
+     * Invoke a tool
+     */
+    invokeToolAsync: (name: string, args?: Record<string, unknown>, _config?: Config) => Promise<InvokeResult>;
+    /**
+     * Synchronous invoke (wrapper for async)
+     */
+    invokeToolSync(_name: string, _args?: Record<string, unknown>): InvokeResult;
+    invoke_tool: (name: string, args?: Record<string, unknown>, _config?: Config) => Promise<InvokeResult>;
+    /**
+     * Extract base URL from schema
+     */
+    private _extractBaseUrl;
+    /**
+     * Resolve all $ref references in the schema
+     */
+    private _resolveAllRefs;
+    /**
+     * Recursively resolve $ref references
+     */
+    private _resolveRefs;
+    /**
+     * Resolve a single $ref path
+     */
+    private _resolveRef;
+    /**
+     * Parse tools from OpenAPI paths
+     */
+    private _parseTools;
+    /**
+     * Parse operation parameters into a schema
+     */
+    private _parseParameters;
+}
+/**
+ * ApiSet class for unified tool invocation
+ * 统一的工具集接口，支持 OpenAPI 和 MCP 工具
+ */
+declare class ApiSet {
+    private _tools;
+    private _invoker;
+    private _baseUrl?;
+    private _defaultHeaders;
+    private _defaultQueryParams;
+    private _baseConfig?;
+    constructor(tools: ToolInfo[], invoker: any, baseUrl?: string, headers?: Record<string, string>, queryParams?: Record<string, unknown>, config?: Config);
+    /**
+     * Invoke a tool by name
+     * 调用指定的工具
+     */
+    invoke: (name: string, args?: Record<string, unknown>, config?: Config) => Promise<Record<string, unknown>>;
+    /**
+     * Get all tools
+     * 返回所有工具列表
+     */
+    get tools(): ToolInfo[];
+    /**
+     * Get a specific tool
+     * 获取指定名称的工具
+     */
+    getTool(name: string): ToolInfo | undefined;
+    /**
+     * Convert arguments from framework-specific types to native JavaScript types
+     * 将常见框架类型转换为 JavaScript 原生类型
+     *
+     * Purpose: Ensure we send JSON-serializable data to OpenAPI
+     * 目的：确保我们发送到 OpenAPI 的 JSON body 是可以被序列化的
+     */
+    private _convertToNative;
+    /**
+     * Convert arguments dictionary
+     * 转换参数字典
+     */
+    private _convertArguments;
+    /**
+     * Create ApiSet from MCP tools
+     * 从 MCP tools 创建 ApiSet
+     *
+     * @param tools - MCP tools list or single tool / MCP tools 列表或单个工具
+     * @param mcpClient - MCP client (MCPToolSet instance) / MCP 客户端（MCPToolSet 实例）
+     * @param config - Configuration object / 配置对象
+     */
+    static fromMCPTools(params: {
+        tools: unknown;
+        mcpClient: any;
+        config?: Config;
+    }): ApiSet;
+}
+
+export { ApiSet, type InvokeResult, OpenAPI, type OpenAPIOptions, type ToolParameterSchema };