@agentrun/sdk 0.0.1-test.21dd786

package/dist/toolset/client.d.ts

@@ -0,0 +1,65 @@
+/**
+ * ToolSet Client
+ *
+ * ToolSet 客户端，提供 ToolSet 的管理功能。
+ * Client for managing ToolSet resources.
+ */
+import { Config } from "../utils/config";
+import { ToolSetCreateInput, ToolSetListInput, ToolSetUpdateInput } from "./model";
+import { ToolSet } from "./toolset";
+/**
+ * ToolSet Client
+ *
+ * 提供 ToolSet 的管理功能。
+ */
+export declare class ToolSetClient {
+    private config?;
+    constructor(config?: Config);
+    /**
+     * Create a ToolSet
+     */
+    createToolSet: (params: {
+        input: ToolSetCreateInput;
+        config?: Config;
+    }) => Promise<ToolSet>;
+    /**
+     * Delete a ToolSet by name
+     */
+    deleteToolSet: (params: {
+        name: string;
+        config?: Config;
+    }) => Promise<ToolSet>;
+    /**
+     * Get a ToolSet by name
+     */
+    getToolSet: (params: {
+        name: string;
+        config?: Config;
+    }) => Promise<ToolSet>;
+    /**
+     * Update a ToolSet by name
+     */
+    updateToolSet: (params: {
+        name: string;
+        input: ToolSetUpdateInput;
+        config?: Config;
+    }) => Promise<ToolSet>;
+    /**
+     * List ToolSets
+     */
+    listToolSets: (params?: {
+        input?: ToolSetListInput;
+        config?: Config;
+    }) => Promise<ToolSet[]>;
+    /**
+     * List all ToolSets with pagination
+     */
+    listAllToolSets: (params?: {
+        options?: {
+            prefix?: string;
+            labels?: Record<string, string>;
+        };
+        config?: Config;
+    }) => Promise<ToolSet[]>;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/toolset/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/toolset/client.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAEzC,OAAO,EACL,kBAAkB,EAClB,gBAAgB,EAChB,kBAAkB,EACnB,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC;;;;GAIG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAAC,CAAS;gBAEZ,MAAM,CAAC,EAAE,MAAM;IAI3B;;OAEG;IACH,aAAa,GAAU,QAAQ;QAC7B,KAAK,EAAE,kBAAkB,CAAC;QAC1B,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,KAAG,OAAO,CAAC,OAAO,CAAC,CAGlB;IAEF;;OAEG;IACH,aAAa,GAAU,QAAQ;QAC7B,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,KAAG,OAAO,CAAC,OAAO,CAAC,CAGlB;IAEF;;OAEG;IACH,UAAU,GAAU,QAAQ;QAC1B,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,KAAG,OAAO,CAAC,OAAO,CAAC,CAGlB;IAEF;;OAEG;IACH,aAAa,GAAU,QAAQ;QAC7B,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,EAAE,kBAAkB,CAAC;QAC1B,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,KAAG,OAAO,CAAC,OAAO,CAAC,CAGlB;IAEF;;OAEG;IACH,YAAY,GAAU,SAAS;QAC7B,KAAK,CAAC,EAAE,gBAAgB,CAAC;QACzB,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,KAAG,OAAO,CAAC,OAAO,EAAE,CAAC,CAGpB;IAEF;;OAEG;IACH,eAAe,GAAU,SAAS;QAChC,OAAO,CAAC,EAAE;YAAE,MAAM,CAAC,EAAE,MAAM,CAAC;YAAC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;SAAE,CAAC;QAC/D,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,KAAG,OAAO,CAAC,OAAO,EAAE,CAAC,CAGpB;CACH"}

package/dist/toolset/index.d.ts

@@ -0,0 +1,15 @@
+/**
+ * ToolSet Module
+ *
+ * ToolSet 模块，提供 ToolSet 资源的管理功能。
+ * Module for managing ToolSet resources.
+ */
+export { ToolSetClient } from "./client";
+export { ToolSet } from "./toolset";
+export { OpenAPI, ApiSet } from "./openapi";
+export { ToolSetSchemaType, ToolSchema, ToolInfo } from "./model";
+export { ToolControlAPI } from "./api/control";
+export { MCPSession, MCPToolSet } from "./api/mcp";
+export type { ToolSetCreateInput, ToolSetUpdateInput, ToolSetListInput, ToolSetData, ToolSetAuthorization, ToolSetSchema, ToolSetSpec, ToolSetStatus, ToolSetStatusOutputs, MCPToolMeta, } from "./model";
+export type { ToolParameterSchema, InvokeResult, OpenAPIOptions, } from "./openapi";
+//# sourceMappingURL=index.d.ts.map

package/dist/toolset/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/toolset/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,EAAE,iBAAiB,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAClE,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACnD,YAAY,EACV,kBAAkB,EAClB,kBAAkB,EAClB,gBAAgB,EAChB,WAAW,EACX,oBAAoB,EACpB,aAAa,EACb,WAAW,EACX,aAAa,EACb,oBAAoB,EACpB,WAAW,GACZ,MAAM,SAAS,CAAC;AACjB,YAAY,EACV,mBAAmB,EACnB,YAAY,EACZ,cAAc,GACf,MAAM,WAAW,CAAC"}

package/dist/toolset/model.d.ts

@@ -0,0 +1,246 @@
+/**
+ * ToolSet Models
+ *
+ * ToolSet 相关的数据模型。
+ * Data models for ToolSet.
+ */
+import { Status } from "../utils/model";
+/**
+ * ToolSet schema type
+ */
+export declare enum ToolSetSchemaType {
+    OPENAPI = "OpenAPI",
+    MCP = "MCP"
+}
+/**
+ * ToolSet schema
+ */
+export interface ToolSetSchema {
+    /**
+     * Schema type (OpenAPI, MCP)
+     */
+    type?: ToolSetSchemaType;
+    /**
+     * Schema detail (URL or inline definition)
+     */
+    detail?: string;
+}
+/**
+ * ToolSet authorization configuration
+ */
+export interface ToolSetAuthorization {
+    /**
+     * Authorization type
+     */
+    type?: string;
+    /**
+     * API Key header name
+     */
+    apiKeyHeaderName?: string;
+    /**
+     * API Key value
+     */
+    apiKeyValue?: string;
+}
+/**
+ * ToolSet specification
+ */
+export interface ToolSetSpec {
+    /**
+     * Schema configuration
+     */
+    schema?: ToolSetSchema;
+    /**
+     * Authorization configuration
+     */
+    authConfig?: ToolSetAuthorization;
+}
+/**
+ * MCP Tool meta
+ */
+export interface MCPToolMeta {
+    /**
+     * Tool name
+     */
+    name?: string;
+    /**
+     * Tool description
+     */
+    description?: string;
+}
+/**
+ * ToolSet status outputs
+ */
+export interface ToolSetStatusOutputs {
+    /**
+     * MCP server configuration
+     */
+    mcpServerConfig?: {
+        url?: string;
+        transport?: string;
+    };
+    /**
+     * Tools list
+     */
+    tools?: MCPToolMeta[];
+    /**
+     * URLs
+     */
+    urls?: {
+        cdpUrl?: string;
+        liveViewUrl?: string;
+        streamUrl?: string;
+    };
+}
+/**
+ * ToolSet status
+ */
+export interface ToolSetStatus {
+    /**
+     * Current status
+     */
+    status?: Status;
+    /**
+     * Status reason
+     */
+    statusReason?: string;
+    /**
+     * Outputs
+     */
+    outputs?: ToolSetStatusOutputs;
+}
+/**
+ * ToolSet data interface
+ */
+export interface ToolSetData {
+    name?: string;
+    uid?: string;
+    kind?: string;
+    description?: string;
+    createdTime?: string;
+    generation?: number;
+    labels?: Record<string, string>;
+    spec?: ToolSetSpec;
+    status?: ToolSetStatus;
+}
+/**
+ * ToolSet create input
+ */
+export interface ToolSetCreateInput {
+    /**
+     * ToolSet name (required)
+     */
+    name: string;
+    /**
+     * Description
+     */
+    description?: string;
+    /**
+     * Labels
+     */
+    labels?: Record<string, string>;
+    /**
+     * Spec configuration
+     */
+    spec?: ToolSetSpec;
+}
+/**
+ * ToolSet update input
+ */
+export interface ToolSetUpdateInput {
+    /**
+     * Description
+     */
+    description?: string;
+    /**
+     * Labels
+     */
+    labels?: Record<string, string>;
+    /**
+     * Spec configuration
+     */
+    spec?: ToolSetSpec;
+}
+/**
+ * ToolSet list input
+ */
+export interface ToolSetListInput {
+    /**
+     * Prefix filter
+     */
+    prefix?: string;
+    /**
+     * Page size
+     */
+    pageSize?: number;
+    /**
+     * Next token for pagination
+     */
+    nextToken?: string;
+    /**
+     * Labels filter
+     */
+    labels?: Record<string, string>;
+}
+/**
+ * JSON Schema compatible tool parameter description
+ *
+ * Supports complete JSON Schema fields for describing complex nested data structures.
+ * JSON Schema 兼容的工具参数描述
+ *
+ * 支持完整的 JSON Schema 字段，能够描述复杂的嵌套数据结构。
+ */
+export declare class ToolSchema {
+    type?: string;
+    description?: string;
+    title?: string;
+    properties?: Record<string, ToolSchema>;
+    required?: string[];
+    additionalProperties?: boolean;
+    items?: ToolSchema;
+    minItems?: number;
+    maxItems?: number;
+    pattern?: string;
+    minLength?: number;
+    maxLength?: number;
+    format?: string;
+    enum?: unknown[];
+    minimum?: number;
+    maximum?: number;
+    exclusiveMinimum?: number;
+    exclusiveMaximum?: number;
+    anyOf?: ToolSchema[];
+    oneOf?: ToolSchema[];
+    allOf?: ToolSchema[];
+    default?: unknown;
+    constructor(data?: Partial<ToolSchema>);
+    /**
+     * Create ToolSchema from any OpenAPI/JSON Schema
+     * 从任意 OpenAPI/JSON Schema 创建 ToolSchema
+     *
+     * Recursively parses all nested structures, preserving complete schema information.
+     * 递归解析所有嵌套结构，保留完整的 schema 信息。
+     */
+    static fromAnyOpenAPISchema(schema: unknown): ToolSchema;
+    /**
+     * Convert to standard JSON Schema format
+     * 转换为标准 JSON Schema 格式
+     */
+    toJSONSchema(): Record<string, unknown>;
+}
+/**
+ * Tool information
+ * 工具信息
+ */
+export declare class ToolInfo {
+    name?: string;
+    description?: string;
+    parameters?: ToolSchema;
+    constructor(data?: Partial<ToolInfo>);
+    /**
+     * Create ToolInfo from MCP tool
+     * 从 MCP tool 创建 ToolInfo
+     */
+    static fromMCPTool(tool: unknown): ToolInfo;
+}
+//# sourceMappingURL=model.d.ts.map

package/dist/toolset/model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model.d.ts","sourceRoot":"","sources":["../../src/toolset/model.ts"],"names":[],"mappings":"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"}

package/dist/toolset/openapi.d.ts

@@ -0,0 +1,174 @@
+/**
+ * OpenAPI Protocol Handler
+ *
+ * 处理 OpenAPI 规范的工具解析和调用。
+ * Handles tool parsing and invocation for OpenAPI specification.
+ */
+import { Config } from "../utils/config";
+/**
+ * Tool parameter schema
+ */
+export 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
+ */
+export interface ToolInfo {
+    name: string;
+    description?: string;
+    parameters?: ToolParameterSchema;
+    operationId?: string;
+    method?: string;
+    path?: string;
+}
+/**
+ * Invoke result
+ */
+export interface InvokeResult {
+    status_code: number;
+    headers?: Record<string, string>;
+    body?: unknown;
+    error?: string;
+}
+/**
+ * OpenAPI handler options
+ */
+export 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.
+ */
+export 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 工具
+ */
+export 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;
+}
+//# sourceMappingURL=openapi.d.ts.map

package/dist/toolset/openapi.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openapi.d.ts","sourceRoot":"","sources":["../../src/toolset/openapi.ts"],"names":[],"mappings":"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"}

package/dist/toolset/toolset.d.ts

@@ -0,0 +1,161 @@
+/**
+ * ToolSet Resource Class
+ *
+ * ToolSet 资源类，用于管理 ToolSet 资源。
+ * Resource class for managing ToolSet resources.
+ */
+import * as $Devs from "@alicloud/devs20230714";
+import { Config } from "../utils/config";
+import { ToolSetCreateInput, ToolSetData, ToolSetListInput, ToolSetSpec, ToolSetStatus, ToolSetUpdateInput } from "./model";
+/**
+ * ToolSet resource class
+ */
+export declare class ToolSet implements ToolSetData {
+    name?: string;
+    uid?: string;
+    kind?: string;
+    description?: string;
+    createdTime?: string;
+    generation?: number;
+    labels?: Record<string, string>;
+    spec?: ToolSetSpec;
+    status?: ToolSetStatus;
+    private _config?;
+    constructor(data?: Partial<ToolSetData>, config?: Config);
+    /**
+     * Get ToolSet name (alias for name)
+     */
+    get toolSetName(): string | undefined;
+    /**
+     * Get ToolSet ID (alias for uid)
+     */
+    get toolSetId(): string | undefined;
+    /**
+     * Check if the toolset is ready
+     */
+    get isReady(): boolean;
+    /**
+     * Create toolset from SDK response object
+     */
+    static fromInnerObject(obj: $Devs.Toolset, config?: Config): ToolSet;
+    /**
+     * Get DevS client
+     */
+    private static getClient;
+    /**
+     * Create a new ToolSet
+     */
+    static create(params: {
+        input: ToolSetCreateInput;
+        config?: Config;
+    }): Promise<ToolSet>;
+    /**
+     * Delete a ToolSet by Name
+     */
+    static delete(params: {
+        name: string;
+        config?: Config;
+    }): Promise<ToolSet>;
+    /**
+     * Get a ToolSet by Name
+     */
+    static get(params: {
+        name: string;
+        config?: Config;
+    }): Promise<ToolSet>;
+    /**
+     * List ToolSets
+     */
+    static list(input?: ToolSetListInput, config?: Config): Promise<ToolSet[]>;
+    /**
+     * List all ToolSets with pagination
+     */
+    static listAll(options?: {
+        prefix?: string;
+        labels?: Record<string, string>;
+    }, config?: Config): Promise<ToolSet[]>;
+    /**
+     * Update a ToolSet by Name
+     */
+    static update(params: {
+        name: string;
+        input: ToolSetUpdateInput;
+        config?: Config;
+    }): Promise<ToolSet>;
+    /**
+     * Handle API errors
+     */
+    private static handleError;
+    /**
+     * Delete this toolset
+     */
+    delete: (params?: {
+        config?: Config;
+    }) => Promise<ToolSet>;
+    /**
+     * Update this toolset
+     */
+    update: (params: {
+        input: ToolSetUpdateInput;
+        config?: Config;
+    }) => Promise<ToolSet>;
+    /**
+     * Refresh this toolset's data
+     */
+    refresh: (params?: {
+        config?: Config;
+    }) => Promise<ToolSet>;
+    /**
+     * Wait until the toolset is ready
+     */
+    waitUntilReady: (options?: {
+        timeoutSeconds?: number;
+        intervalSeconds?: number;
+        beforeCheck?: (toolset: ToolSet) => void;
+    }, config?: Config) => Promise<ToolSet>;
+    /**
+     * Get toolset type
+     * 获取工具集类型
+     */
+    type(): string | undefined;
+    /**
+     * List tools (async)
+     * 异步获取工具列表，返回统一的 ToolInfo 列表
+     */
+    listToolsAsync: (params?: {
+        config?: Config;
+    }) => Promise<any[]>;
+    /**
+     * List tools (sync wrapper)
+     * 同步获取工具列表，返回统一的 ToolInfo 列表
+     */
+    listTools: (config?: Config) => Promise<any[]>;
+    /**
+     * Call tool (async)
+     * 异步调用工具，统一使用 ApiSet 实现
+     */
+    callToolAsync: (name: string, args?: Record<string, unknown>, config?: Config) => Promise<any>;
+    /**
+     * Call tool (sync wrapper)
+     * 同步调用工具，统一使用 ApiSet 实现
+     */
+    callTool: (name: string, args?: Record<string, unknown>, config?: Config) => Promise<any>;
+    /**
+     * Convert ToolSet to unified ApiSet object
+     * 将 ToolSet 转换为统一的 ApiSet 对象
+     */
+    toApiSet: (params?: {
+        config?: Config;
+    }) => Promise<any>;
+    /**
+     * Get OpenAPI authentication defaults
+     * 获取 OpenAPI 认证默认值
+     */
+    private _getOpenAPIAuthDefaults;
+    /**
+     * Get OpenAPI base URL
+     * 获取 OpenAPI 基础 URL
+     */
+    private _getOpenAPIBaseUrl;
+}
+//# sourceMappingURL=toolset.d.ts.map

package/dist/toolset/toolset.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toolset.d.ts","sourceRoot":"","sources":["../../src/toolset/toolset.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,KAAK,MAAM,wBAAwB,CAAC;AAIhD,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAMzC,OAAO,EACL,kBAAkB,EAClB,WAAW,EACX,gBAAgB,EAChB,WAAW,EACX,aAAa,EACb,kBAAkB,EACnB,MAAM,SAAS,CAAC;AAEjB;;GAEG;AACH,qBAAa,OAAQ,YAAW,WAAW;IACzC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,IAAI,CAAC,EAAE,WAAW,CAAC;IACnB,MAAM,CAAC,EAAE,aAAa,CAAC;IAEvB,OAAO,CAAC,OAAO,CAAC,CAAS;gBAEb,IAAI,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC,EAAE,MAAM;IAOxD;;OAEG;IACH,IAAI,WAAW,IAAI,MAAM,GAAG,SAAS,CAEpC;IAED;;OAEG;IACH,IAAI,SAAS,IAAI,MAAM,GAAG,SAAS,CAElC;IAED;;OAEG;IACH,IAAI,OAAO,IAAI,OAAO,CAErB;IAED;;OAEG;IACH,MAAM,CAAC,eAAe,CAAC,GAAG,EAAE,KAAK,CAAC,OAAO,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO;IAmDpE;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,SAAS;IAuBxB;;OAEG;WACU,MAAM,CAAC,MAAM,EAAE;QAC1B,KAAK,EAAE,kBAAkB,CAAC;QAC1B,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,GAAG,OAAO,CAAC,OAAO,CAAC;IA8DpB;;OAEG;WACU,MAAM,CAAC,MAAM,EAAE;QAC1B,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,GAAG,OAAO,CAAC,OAAO,CAAC;IAwBpB;;OAEG;WACU,GAAG,CAAC,MAAM,EAAE;QACvB,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,GAAG,OAAO,CAAC,OAAO,CAAC;IA+BpB;;OAEG;WACU,IAAI,CACf,KAAK,CAAC,EAAE,gBAAgB,EACxB,MAAM,CAAC,EAAE,MAAM,GACd,OAAO,CAAC,OAAO,EAAE,CAAC;IAyCrB;;OAEG;WACU,OAAO,CAClB,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;KAAE,EAC9D,MAAM,CAAC,EAAE,MAAM,GACd,OAAO,CAAC,OAAO,EAAE,CAAC;IAiCrB;;OAEG;WACU,MAAM,CAAC,MAAM,EAAE;QAC1B,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,EAAE,kBAAkB,CAAC;QAC1B,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,GAAG,OAAO,CAAC,OAAO,CAAC;IA8DpB;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,WAAW;IAoB1B;;OAEG;IACH,MAAM,GAAU,SAAS;QAAE,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,KAAG,OAAO,CAAC,OAAO,CAAC,CAY7D;IAEF;;OAEG;IACH,MAAM,GAAU,QAAQ;QACtB,KAAK,EAAE,kBAAkB,CAAC;QAC1B,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,KAAG,OAAO,CAAC,OAAO,CAAC,CAalB;IAEF;;OAEG;IACH,OAAO,GAAU,SAAS;QAAE,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,KAAG,OAAO,CAAC,OAAO,CAAC,CAY9D;IAEF;;OAEG;IACH,cAAc,GACZ,UAAU;QACR,cAAc,CAAC,EAAE,MAAM,CAAC;QACxB,eAAe,CAAC,EAAE,MAAM,CAAC;QACzB,WAAW,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC;KAC1C,EACD,SAAS,MAAM,KACd,OAAO,CAAC,OAAO,CAAC,CA6BjB;IAEF;;;OAGG;IACH,IAAI,IAAI,MAAM,GAAG,SAAS;IAI1B;;;OAGG;IACH,cAAc,GAAU,SAAS;QAAE,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,KAAG,OAAO,CAAC,GAAG,EAAE,CAAC,CAgBnE;IAEF;;;OAGG;IACH,SAAS,GAAI,SAAS,MAAM,KAAG,OAAO,CAAC,GAAG,EAAE,CAAC,CAE3C;IAEF;;;OAGG;IACH,aAAa,GACX,MAAM,MAAM,EACZ,OAAO,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,SAAS,MAAM,KACd,OAAO,CAAC,GAAG,CAAC,CA2Bb;IAEF;;;OAGG;IACH,QAAQ,GACN,MAAM,MAAM,EACZ,OAAO,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,SAAS,MAAM,KACd,OAAO,CAAC,GAAG,CAAC,CAEb;IAEF;;;OAGG;IACH,QAAQ,GAAU,SAAS;QAAE,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,KAAG,OAAO,CAAC,GAAG,CAAC,CA8D3D;IAEF;;;OAGG;IACH,OAAO,CAAC,uBAAuB;IA2B/B;;;OAGG;IACH,OAAO,CAAC,kBAAkB;CAI3B"}