@reminix/sdk 0.10.0 → 0.12.0

package/resources/agents.d.ts

@@ -1,46 +1,50 @@
 import { APIResource } from "../core/resource.js";
 import * as AgentsAPI from "./agents.js";
 import { APIPromise } from "../core/api-promise.js";
+import { Cursor, type CursorParams, PagePromise } from "../core/pagination.js";
 import { Stream } from "../core/streaming.js";
 import { RequestOptions } from "../internal/request-options.js";
 export declare class Agents extends APIResource {
     /**
-     * Have a conversational interaction with an agent. This endpoint maintains
-     * conversation context through the messages array, allowing for multi-turn
-     * conversations.
+     * Get details of a specific agent by name.
      *
-     * **Timeout:** Chat requests have a 60-second timeout. If the agent takes longer
-     * to respond, you will receive a 504 Gateway Timeout error. For long-running
-     * conversations, consider using streaming mode which does not have the same
-     * timeout constraints.
-     *
-     * **Idempotency:** For non-streaming requests, send an `Idempotency-Key` header
-     * with a unique value (e.g., UUID) to ensure duplicate requests return the same
-     * response. Keys are valid for 24 hours. Streaming responses are not cached.
+     * @example
+     * ```ts
+     * const agent = await client.agents.retrieve('x');
+     * ```
+     */
+    retrieve(name: string, options?: RequestOptions): APIPromise<Agent>;
+    /**
+     * List all agents in the project with optional filtering by type and status.
      *
-     * **Use cases:**
+     * @example
+     * ```ts
+     * // Automatically fetches more pages as needed.
+     * for await (const agent of client.agents.list()) {
+     *   // ...
+     * }
+     * ```
+     */
+    list(query?: AgentListParams | null | undefined, options?: RequestOptions): PagePromise<AgentsCursor, Agent>;
+    /**
+     * Send a chat message to an agent and receive a response.
      *
-     * - Customer support chatbots
-     * - AI assistants with memory
-     * - Multi-step question answering
-     * - Conversational agents that need context
+     * **Supported Agents:** Managed agents only. Custom agents should use the /execute
+     * endpoint.
      *
-     * **Message format:** Follows OpenAI-compliant message structure with support for:
+     * **Tool Calls:** Messages support the OpenAI tool calling format:
      *
-     * - `system`, `user`, `assistant`, and `tool` roles
-     * - Multimodal content (text + images)
-     * - Tool/function calling
+     * - Assistant messages can include `tool_calls` array with function calls
+     * - Tool result messages use `role: "tool"` with `tool_call_id` and `name`
+     * - Content can be `null` when `tool_calls` is present
      *
-     * **Streaming:** Set `stream: true` in the request body to receive Server-Sent
-     * Events (SSE) stream with incremental chunks. Perfect for ChatGPT-like real-time
-     * chat interfaces.
+     * **Streaming:** Set `stream: true` to receive Server-Sent Events (SSE) for
+     * real-time responses.
      *
      * @example
      * ```ts
      * const response = await client.agents.chat('name', {
-     *   messages: [
-     *     { role: 'user', content: 'What is the weather today?' },
-     *   ],
+     *   messages: [{ content: 'string', role: 'system' }],
      * });
      * ```
      */
@@ -48,8 +52,12 @@ export declare class Agents extends APIResource {
     chat(name: string, body: AgentChatParamsStreaming, options?: RequestOptions): APIPromise<Stream<StreamChunk>>;
     chat(name: string, body: AgentChatParamsBase, options?: RequestOptions): APIPromise<Stream<StreamChunk> | AgentChatResponse>;
     /**
-     * Execute a one-shot task with an agent. This endpoint is designed for
-     * task-oriented operations where you provide input and receive a complete output.
+     * Invoke a custom agent with the provided input.
+     *
+     * **Supported Agents:** Custom agents only. Managed agents should use the /chat
+     * endpoint.
+     *
+     * **Input:** Pass structured input data matching the agent's parameter schema.
      *
      * **Timeout:** Agent invocations have a 60-second timeout. If the agent takes
      * longer to respond, you will receive a 504 Gateway Timeout error. For
@@ -60,38 +68,153 @@ export declare class Agents extends APIResource {
      * with a unique value (e.g., UUID) to ensure duplicate requests return the same
      * response. Keys are valid for 24 hours. Streaming responses are not cached.
      *
-     * **Use cases:**
-     *
-     * - Data analysis and processing
-     * - Content generation (with streaming for long outputs)
-     * - One-time operations that don't require conversation history
-     * - API-like operations
-     *
      * **Streaming:** Set `stream: true` in the request body to receive Server-Sent
      * Events (SSE) stream with incremental chunks. Useful for long-running tasks or
-     * real-time progress updates.
+     * real-time responses.
      *
      * @example
      * ```ts
-     * const response = await client.agents.invoke('name', {
-     *   input: {
-     *     task: 'analyze this data',
-     *     data: { value: 123, items: ['a', 'b', 'c'] },
-     *   },
-     * });
+     * const response = await client.agents.invoke('name');
      * ```
      */
-    invoke(name: string, body: AgentInvokeParamsNonStreaming, options?: RequestOptions): APIPromise<AgentInvokeResponse>;
+    invoke(name: string, body?: AgentInvokeParamsNonStreaming, options?: RequestOptions): APIPromise<AgentInvokeResponse>;
     invoke(name: string, body: AgentInvokeParamsStreaming, options?: RequestOptions): APIPromise<Stream<StreamChunk>>;
-    invoke(name: string, body: AgentInvokeParamsBase, options?: RequestOptions): APIPromise<Stream<StreamChunk> | AgentInvokeResponse>;
+    invoke(name: string, body?: AgentInvokeParamsBase | undefined, options?: RequestOptions): APIPromise<Stream<StreamChunk> | AgentInvokeResponse>;
+}
+export type AgentsCursor = Cursor<Agent>;
+export interface Agent {
+    /**
+     * Unique agent ID
+     */
+    id: string;
+    /**
+     * Whether agent supports chat interface
+     */
+    canChat: boolean | null;
+    /**
+     * Whether agent supports streaming
+     */
+    canStream: boolean | null;
+    /**
+     * Agent configuration (for managed agents)
+     */
+    config: AgentConfig | null;
+    /**
+     * Creation timestamp
+     */
+    createdAt: string;
+    /**
+     * User who created the agent
+     */
+    createdBy: string | null;
+    /**
+     * Agent description
+     */
+    description: string | null;
+    /**
+     * When the agent was discovered (for custom agents)
+     */
+    discoveredAt: string | null;
+    /**
+     * Agent name
+     */
+    name: string;
+    /**
+     * JSON Schema for agent input parameters
+     */
+    output: Agent.Output | null;
+    /**
+     * JSON Schema for agent input parameters
+     */
+    parameters: Agent.Parameters | null;
+    /**
+     * Project ID
+     */
+    projectId: string;
+    /**
+     * Top-level keys expected in request body
+     */
+    requestKeys: Array<string> | null;
+    /**
+     * Top-level keys returned in response body
+     */
+    responseKeys: Array<string> | null;
+    /**
+     * Agent status
+     */
+    status: 'active' | 'inactive';
+    /**
+     * Agent type: "managed" for UI-created, "{language}" for custom agents (e.g.,
+     * "python"), or "{language}-{adapter}" for adapter-based (e.g.,
+     * "python-langchain")
+     */
+    type: string;
+    /**
+     * Last update timestamp
+     */
+    updatedAt: string;
+}
+export declare namespace Agent {
+    /**
+     * JSON Schema for agent input parameters
+     */
+    interface Output {
+        type: string;
+        properties?: {
+            [key: string]: unknown;
+        };
+        required?: Array<string>;
+        [k: string]: unknown;
+    }
+    /**
+     * JSON Schema for agent input parameters
+     */
+    interface Parameters {
+        type: string;
+        properties?: {
+            [key: string]: unknown;
+        };
+        required?: Array<string>;
+        [k: string]: unknown;
+    }
+}
+/**
+ * Agent configuration (for managed agents)
+ */
+export interface AgentConfig {
+    /**
+     * Model identifier (e.g., "gpt-4o", "claude-sonnet-4-20250514")
+     */
+    model: string;
+    /**
+     * LLM provider
+     */
+    provider: 'openai' | 'anthropic';
+    /**
+     * System prompt for the agent
+     */
+    systemPrompt: string;
+    /**
+     * List of tools available to the agent
+     */
+    tools: Array<string>;
+    /**
+     * Maximum tool call iterations
+     */
+    maxIterations?: number;
+    /**
+     * Whether to require approval for tool calls
+     */
+    requireApproval?: boolean;
 }
 export interface ChatMessage {
     /**
-     * Message content. Can be string, array (multimodal), or object (tool).
+     * Message content. Can be string, array (multimodal), object (tool), or null (when
+     * tool_calls present).
      */
     content: string | Array<ChatMessage.MultimodalContent> | {
         [key: string]: unknown;
-    };
+    } | null;
     /**
      * Message role
      */
@@ -101,9 +224,13 @@ export interface ChatMessage {
      */
     name?: string;
     /**
-     * Tool call ID (for tool role)
+     * Tool call ID (for tool role messages)
      */
     tool_call_id?: string;
+    /**
+     * Tool calls requested by assistant (for assistant role messages)
+     */
+    tool_calls?: Array<ChatMessage.ToolCall>;
 }
 export declare namespace ChatMessage {
     interface MultimodalContent {
@@ -116,113 +243,142 @@ export declare namespace ChatMessage {
             url: string;
         }
     }
-}
-/**
- * Optional request context passed to the agent handler.
- */
-export interface Context {
-    /**
-     * ID to track multi-turn conversations
-     */
-    conversation_id?: string;
-    /**
-     * Additional custom context fields
-     */
-    custom?: {
-        [key: string]: unknown;
-    };
-    /**
-     * ID of the user making the request
-     */
-    user_id?: string;
+    interface ToolCall {
+        id: string;
+        function: ToolCall.Function;
+        type: 'function';
+    }
+    namespace ToolCall {
+        interface Function {
+            arguments: string;
+            name: string;
+        }
+    }
 }
 export interface StreamChunk {
     /**
      * Text chunk from the stream
      */
     chunk: string;
+    [k: string]: unknown;
 }
 export interface AgentChatResponse {
     /**
-     * Full conversation history including the assistant response
+     * Array of assistant response messages
      */
     messages: Array<ChatMessage>;
     /**
-     * Final assistant response text
+     * Conversation ID (present when conversation persistence is enabled)
      */
-    output: string;
+    conversation_id?: string;
 }
-export interface AgentInvokeResponse {
+/**
+ * Response with dynamic keys based on agent configuration. Regular agents return {
+ * output: ... }, chat agents return { messages: [...] }.
+ */
+export type AgentInvokeResponse = {
+    [key: string]: unknown;
+};
+export interface AgentListParams extends CursorParams {
     /**
-     * Output from the agent. Structure depends on agent implementation.
+     * Filter by agent status
      */
-    output?: unknown;
+    status?: 'active' | 'inactive';
+    /**
+     * Filter by agent type (managed, python, typescript, python-langchain, etc.)
+     */
+    type?: string;
 }
 export type AgentChatParams = AgentChatParamsNonStreaming | AgentChatParamsStreaming;
 export interface AgentChatParamsBase {
     /**
-     * Conversation history. Must include at least one message.
+     * Array of chat messages
      */
     messages: Array<ChatMessage>;
     /**
-     * Optional request context passed to the agent handler.
+     * Optional context for the agent execution
+     */
+    context?: AgentChatParams.Context;
+    /**
+     * Conversation ID to continue an existing conversation
      */
-    context?: Context;
+    conversation_id?: string;
     /**
-     * Whether to stream the response as SSE.
+     * Enable streaming response
      */
     stream?: boolean;
 }
 export declare namespace AgentChatParams {
+    /**
+     * Optional context for the agent execution
+     */
+    interface Context {
+        /**
+         * Identity fields for conversation scoping (e.g., user_id, tenant_id)
+         */
+        identity?: {
+            [key: string]: unknown;
+        };
+        [k: string]: unknown;
+    }
     type AgentChatParamsNonStreaming = AgentsAPI.AgentChatParamsNonStreaming;
     type AgentChatParamsStreaming = AgentsAPI.AgentChatParamsStreaming;
 }
 export interface AgentChatParamsNonStreaming extends AgentChatParamsBase {
     /**
-     * Whether to stream the response as SSE.
+     * Enable streaming response
      */
     stream?: false;
 }
 export interface AgentChatParamsStreaming extends AgentChatParamsBase {
     /**
-     * Whether to stream the response as SSE.
+     * Enable streaming response
      */
     stream: true;
 }
 export type AgentInvokeParams = AgentInvokeParamsNonStreaming | AgentInvokeParamsStreaming;
 export interface AgentInvokeParamsBase {
     /**
-     * Input data for the agent. Structure depends on agent implementation.
+     * Optional context for the agent execution
      */
-    input: {
-        [key: string]: unknown;
-    };
-    /**
-     * Optional request context passed to the agent handler.
-     */
-    context?: Context;
+    context?: AgentInvokeParams.Context;
     /**
-     * Whether to stream the response as SSE.
+     * Enable streaming response (SSE)
      */
     stream?: boolean;
+    [k: string]: unknown;
 }
 export declare namespace AgentInvokeParams {
+    /**
+     * Optional context for the agent execution
+     */
+    interface Context {
+        /**
+         * Identity fields for conversation scoping (e.g., user_id, tenant_id)
+         */
+        identity?: {
+            [key: string]: unknown;
+        };
+        [k: string]: unknown;
+    }
     type AgentInvokeParamsNonStreaming = AgentsAPI.AgentInvokeParamsNonStreaming;
     type AgentInvokeParamsStreaming = AgentsAPI.AgentInvokeParamsStreaming;
 }
 export interface AgentInvokeParamsNonStreaming extends AgentInvokeParamsBase {
     /**
-     * Whether to stream the response as SSE.
+     * Enable streaming response (SSE)
      */
     stream?: false;
+    [k: string]: unknown;
 }
 export interface AgentInvokeParamsStreaming extends AgentInvokeParamsBase {
     /**
-     * Whether to stream the response as SSE.
+     * Enable streaming response (SSE)
      */
     stream: true;
+    [k: string]: unknown;
 }
 export declare namespace Agents {
-    export { type ChatMessage as ChatMessage, type Context as Context, type StreamChunk as StreamChunk, type AgentChatResponse as AgentChatResponse, type AgentInvokeResponse as AgentInvokeResponse, type AgentChatParams as AgentChatParams, type AgentChatParamsNonStreaming as AgentChatParamsNonStreaming, type AgentChatParamsStreaming as AgentChatParamsStreaming, type AgentInvokeParams as AgentInvokeParams, type AgentInvokeParamsNonStreaming as AgentInvokeParamsNonStreaming, type AgentInvokeParamsStreaming as AgentInvokeParamsStreaming, };
+    export { type Agent as Agent, type AgentConfig as AgentConfig, type ChatMessage as ChatMessage, type StreamChunk as StreamChunk, type AgentChatResponse as AgentChatResponse, type AgentInvokeResponse as AgentInvokeResponse, type AgentsCursor as AgentsCursor, type AgentListParams as AgentListParams, type AgentChatParams as AgentChatParams, type AgentChatParamsNonStreaming as AgentChatParamsNonStreaming, type AgentChatParamsStreaming as AgentChatParamsStreaming, type AgentInvokeParams as AgentInvokeParams, type AgentInvokeParamsNonStreaming as AgentInvokeParamsNonStreaming, type AgentInvokeParamsStreaming as AgentInvokeParamsStreaming, };
 }
 //# sourceMappingURL=agents.d.ts.map

package/resources/agents.d.ts.map

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

package/resources/agents.js

@@ -3,8 +3,34 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Agents = void 0;
 const resource_1 = require("../core/resource.js");
+const pagination_1 = require("../core/pagination.js");
 const path_1 = require("../internal/utils/path.js");
 class Agents extends resource_1.APIResource {
+    /**
+     * Get details of a specific agent by name.
+     *
+     * @example
+     * ```ts
+     * const agent = await client.agents.retrieve('x');
+     * ```
+     */
+    retrieve(name, options) {
+        return this._client.get((0, path_1.path) `/agents/${name}`, options);
+    }
+    /**
+     * List all agents in the project with optional filtering by type and status.
+     *
+     * @example
+     * ```ts
+     * // Automatically fetches more pages as needed.
+     * for await (const agent of client.agents.list()) {
+     *   // ...
+     * }
+     * ```
+     */
+    list(query = {}, options) {
+        return this._client.getAPIList('/agents', (pagination_1.Cursor), { query, ...options });
+    }
     chat(name, body, options) {
         return this._client.post((0, path_1.path) `/agents/${name}/chat`, {
             body,
@@ -12,11 +38,11 @@ class Agents extends resource_1.APIResource {
             stream: body.stream ?? false,
         });
     }
-    invoke(name, body, options) {
+    invoke(name, body = {}, options) {
         return this._client.post((0, path_1.path) `/agents/${name}/invoke`, {
             body,
             ...options,
-            stream: body.stream ?? false,
+            stream: body?.stream ?? false,
         });
     }
 }

package/resources/agents.js.map

@@ -1 +1 @@
-{"version":3,"file":"agents.js","sourceRoot":"","sources":["../src/resources/agents.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,kDAA+C;AAK/C,oDAA8C;AAE9C,MAAa,MAAO,SAAQ,sBAAW;IAwDrC,IAAI,CACF,IAAY,EACZ,IAAqB,EACrB,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAA,WAAI,EAAA,WAAW,IAAI,OAAO,EAAE;YACnD,IAAI;YACJ,GAAG,OAAO;YACV,MAAM,EAAE,IAAI,CAAC,MAAM,IAAI,KAAK;SAC7B,CAAoE,CAAC;IACxE,CAAC;IAmDD,MAAM,CACJ,IAAY,EACZ,IAAuB,EACvB,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAA,WAAI,EAAA,WAAW,IAAI,SAAS,EAAE;YACrD,IAAI;YACJ,GAAG,OAAO;YACV,MAAM,EAAE,IAAI,CAAC,MAAM,IAAI,KAAK;SAC7B,CAAsE,CAAC;IAC1E,CAAC;CACF;AAhID,wBAgIC"}
+{"version":3,"file":"agents.js","sourceRoot":"","sources":["../src/resources/agents.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,kDAA+C;AAG/C,sDAA4E;AAG5E,oDAA8C;AAE9C,MAAa,MAAO,SAAQ,sBAAW;IACrC;;;;;;;OAOG;IACH,QAAQ,CAAC,IAAY,EAAE,OAAwB;QAC7C,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAA,WAAI,EAAA,WAAW,IAAI,EAAE,EAAE,OAAO,CAAC,CAAC;IAC1D,CAAC;IAED;;;;;;;;;;OAUG;IACH,IAAI,CACF,QAA4C,EAAE,EAC9C,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,SAAS,EAAE,CAAA,mBAAa,CAAA,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAClF,CAAC;IAuCD,IAAI,CACF,IAAY,EACZ,IAAqB,EACrB,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAA,WAAI,EAAA,WAAW,IAAI,OAAO,EAAE;YACnD,IAAI;YACJ,GAAG,OAAO;YACV,MAAM,EAAE,IAAI,CAAC,MAAM,IAAI,KAAK;SAC7B,CAAoE,CAAC;IACxE,CAAC;IA2CD,MAAM,CACJ,IAAY,EACZ,OAAsC,EAAE,EACxC,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAA,WAAI,EAAA,WAAW,IAAI,SAAS,EAAE;YACrD,IAAI;YACJ,GAAG,OAAO;YACV,MAAM,EAAE,IAAI,EAAE,MAAM,IAAI,KAAK;SAC9B,CAAsE,CAAC;IAC1E,CAAC;CACF;AApID,wBAoIC"}

package/resources/agents.mjs

@@ -1,7 +1,33 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 import { APIResource } from "../core/resource.mjs";
+import { Cursor } from "../core/pagination.mjs";
 import { path } from "../internal/utils/path.mjs";
 export class Agents extends APIResource {
+    /**
+     * Get details of a specific agent by name.
+     *
+     * @example
+     * ```ts
+     * const agent = await client.agents.retrieve('x');
+     * ```
+     */
+    retrieve(name, options) {
+        return this._client.get(path `/agents/${name}`, options);
+    }
+    /**
+     * List all agents in the project with optional filtering by type and status.
+     *
+     * @example
+     * ```ts
+     * // Automatically fetches more pages as needed.
+     * for await (const agent of client.agents.list()) {
+     *   // ...
+     * }
+     * ```
+     */
+    list(query = {}, options) {
+        return this._client.getAPIList('/agents', (Cursor), { query, ...options });
+    }
     chat(name, body, options) {
         return this._client.post(path `/agents/${name}/chat`, {
             body,
@@ -9,11 +35,11 @@ export class Agents extends APIResource {
             stream: body.stream ?? false,
         });
     }
-    invoke(name, body, options) {
+    invoke(name, body = {}, options) {
         return this._client.post(path `/agents/${name}/invoke`, {
             body,
             ...options,
-            stream: body.stream ?? false,
+            stream: body?.stream ?? false,
         });
     }
 }

package/resources/agents.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"agents.mjs","sourceRoot":"","sources":["../src/resources/agents.ts"],"names":[],"mappings":"AAAA,sFAAsF;OAE/E,EAAE,WAAW,EAAE;OAKf,EAAE,IAAI,EAAE;AAEf,MAAM,OAAO,MAAO,SAAQ,WAAW;IAwDrC,IAAI,CACF,IAAY,EACZ,IAAqB,EACrB,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAA,WAAW,IAAI,OAAO,EAAE;YACnD,IAAI;YACJ,GAAG,OAAO;YACV,MAAM,EAAE,IAAI,CAAC,MAAM,IAAI,KAAK;SAC7B,CAAoE,CAAC;IACxE,CAAC;IAmDD,MAAM,CACJ,IAAY,EACZ,IAAuB,EACvB,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAA,WAAW,IAAI,SAAS,EAAE;YACrD,IAAI;YACJ,GAAG,OAAO;YACV,MAAM,EAAE,IAAI,CAAC,MAAM,IAAI,KAAK;SAC7B,CAAsE,CAAC;IAC1E,CAAC;CACF"}
+{"version":3,"file":"agents.mjs","sourceRoot":"","sources":["../src/resources/agents.ts"],"names":[],"mappings":"AAAA,sFAAsF;OAE/E,EAAE,WAAW,EAAE;OAGf,EAAE,MAAM,EAAkC;OAG1C,EAAE,IAAI,EAAE;AAEf,MAAM,OAAO,MAAO,SAAQ,WAAW;IACrC;;;;;;;OAOG;IACH,QAAQ,CAAC,IAAY,EAAE,OAAwB;QAC7C,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAA,WAAW,IAAI,EAAE,EAAE,OAAO,CAAC,CAAC;IAC1D,CAAC;IAED;;;;;;;;;;OAUG;IACH,IAAI,CACF,QAA4C,EAAE,EAC9C,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,SAAS,EAAE,CAAA,MAAa,CAAA,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAClF,CAAC;IAuCD,IAAI,CACF,IAAY,EACZ,IAAqB,EACrB,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAA,WAAW,IAAI,OAAO,EAAE;YACnD,IAAI;YACJ,GAAG,OAAO;YACV,MAAM,EAAE,IAAI,CAAC,MAAM,IAAI,KAAK;SAC7B,CAAoE,CAAC;IACxE,CAAC;IA2CD,MAAM,CACJ,IAAY,EACZ,OAAsC,EAAE,EACxC,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAA,WAAW,IAAI,SAAS,EAAE;YACrD,IAAI;YACJ,GAAG,OAAO;YACV,MAAM,EAAE,IAAI,EAAE,MAAM,IAAI,KAAK;SAC9B,CAAsE,CAAC;IAC1E,CAAC;CACF"}