@agentuity/core 2.0.1 → 2.0.2

package/dist/services/workflow/api-reference.js

@@ -0,0 +1,335 @@
+import { CreateWorkflowRequestSchema, UpdateWorkflowRequestSchema, UpdateWorkflowGraphRequestSchema, TestWorkflowRequestSchema, WorkflowListResultSchema, WorkflowGetResultSchema, WorkflowCreateResultSchema, WorkflowUpdateResultSchema, WorkflowActivitySchema, WorkflowExecutionSchema, WorkflowDeliverySchema, TestWorkflowResultSchema, } from "./types.js";
+import { z } from 'zod';
+const service = {
+    name: 'Workflows',
+    slug: 'workflows',
+    description: 'Create and manage workflows that route events from sources to destinations',
+    endpoints: [
+        {
+            id: 'list-workflows',
+            title: 'List Workflows',
+            sectionTitle: 'Workflow Management',
+            method: 'GET',
+            path: '/workflow/list',
+            description: 'List all workflows with optional filtering and pagination.',
+            pathParams: [],
+            queryParams: [
+                {
+                    name: 'limit',
+                    type: 'number',
+                    description: 'Maximum number of workflows to return',
+                    required: false,
+                },
+                {
+                    name: 'offset',
+                    type: 'number',
+                    description: 'Pagination offset',
+                    required: false,
+                },
+                {
+                    name: 'status',
+                    type: 'string',
+                    description: 'Filter by status (enabled or disabled)',
+                    required: false,
+                },
+                {
+                    name: 'source_type',
+                    type: 'string',
+                    description: 'Filter by source type (email, queue, webhook, or schedule)',
+                    required: false,
+                },
+                {
+                    name: 'filter',
+                    type: 'string',
+                    description: 'Filter workflows by name',
+                    required: false,
+                },
+            ],
+            requestBody: null,
+            responseDescription: 'Returns paginated list of workflows.',
+            responseFields: { schema: WorkflowListResultSchema },
+            statuses: [
+                { code: 200, description: 'Workflows returned' },
+                { code: 401, description: 'Unauthorized — invalid or missing Bearer token' },
+            ],
+            examplePath: '/workflow/list',
+        },
+        {
+            id: 'get-workflow',
+            title: 'Get Workflow',
+            sectionTitle: 'Workflow Management',
+            method: 'GET',
+            path: '/workflow/{workflowId}',
+            description: 'Get a specific workflow by ID.',
+            pathParams: [
+                {
+                    name: 'workflowId',
+                    type: 'string',
+                    description: 'Workflow ID (wf_ prefix)',
+                    required: true,
+                },
+            ],
+            queryParams: [],
+            requestBody: null,
+            responseDescription: 'Returns the workflow object.',
+            responseFields: { schema: WorkflowGetResultSchema, stripRequired: true },
+            statuses: [
+                { code: 200, description: 'Workflow returned' },
+                { code: 401, description: 'Unauthorized — invalid or missing Bearer token' },
+                { code: 404, description: 'Workflow not found' },
+            ],
+            examplePath: '/workflow/wf_abc123',
+        },
+        {
+            id: 'create-workflow',
+            title: 'Create Workflow',
+            sectionTitle: 'Workflow Management',
+            method: 'POST',
+            path: '/workflow/create',
+            description: 'Create a new workflow with a source type and reference.',
+            pathParams: [],
+            queryParams: [],
+            requestBody: {
+                description: 'Workflow creation payload.',
+                fields: { schema: CreateWorkflowRequestSchema },
+            },
+            responseDescription: 'Returns the created workflow.',
+            responseFields: { schema: WorkflowCreateResultSchema },
+            statuses: [
+                { code: 201, description: 'Workflow created' },
+                { code: 401, description: 'Unauthorized — invalid or missing Bearer token' },
+            ],
+            examplePath: '/workflow/create',
+            exampleBody: {
+                name: 'GitHub to Slack',
+                source_type: 'webhook',
+                source_ref_id: 'wh_abc123',
+            },
+        },
+        {
+            id: 'update-workflow',
+            title: 'Update Workflow',
+            sectionTitle: 'Workflow Management',
+            method: 'PATCH',
+            path: '/workflow/{workflowId}',
+            description: "Update a workflow's name, description, or status.",
+            pathParams: [
+                {
+                    name: 'workflowId',
+                    type: 'string',
+                    description: 'Workflow ID',
+                    required: true,
+                },
+            ],
+            queryParams: [],
+            requestBody: {
+                description: 'Fields to update.',
+                fields: { schema: UpdateWorkflowRequestSchema },
+            },
+            responseDescription: 'Returns the updated workflow.',
+            responseFields: { schema: WorkflowUpdateResultSchema, stripRequired: true },
+            statuses: [
+                { code: 200, description: 'Workflow updated' },
+                { code: 401, description: 'Unauthorized — invalid or missing Bearer token' },
+                { code: 404, description: 'Workflow not found' },
+            ],
+            examplePath: '/workflow/wf_abc123',
+            exampleBody: { name: 'Renamed Workflow', status: 'disabled' },
+        },
+        {
+            id: 'update-workflow-graph',
+            title: 'Update Workflow Graph',
+            sectionTitle: 'Workflow Management',
+            method: 'PUT',
+            path: '/workflow/{workflowId}/graph',
+            description: 'Update the workflow graph definition (nodes and edges).',
+            pathParams: [
+                {
+                    name: 'workflowId',
+                    type: 'string',
+                    description: 'Workflow ID',
+                    required: true,
+                },
+            ],
+            queryParams: [],
+            requestBody: {
+                description: 'Graph definition with nodes and edges.',
+                fields: { schema: UpdateWorkflowGraphRequestSchema },
+            },
+            responseDescription: 'Returns the updated workflow.',
+            responseFields: { schema: WorkflowUpdateResultSchema, stripRequired: true },
+            statuses: [
+                { code: 200, description: 'Workflow graph updated' },
+                { code: 401, description: 'Unauthorized — invalid or missing Bearer token' },
+                { code: 404, description: 'Workflow not found' },
+            ],
+            examplePath: '/workflow/wf_abc123/graph',
+            exampleBody: {
+                nodes: [
+                    { id: 'n1', type: 'filter' },
+                    { id: 'n2', type: 'action' },
+                ],
+                edges: [{ id: 'e1', source: 'n1', target: 'n2' }],
+            },
+        },
+        {
+            id: 'delete-workflow',
+            title: 'Delete Workflow',
+            sectionTitle: 'Workflow Management',
+            method: 'DELETE',
+            path: '/workflow/{workflowId}',
+            description: 'Delete a workflow and all associated executions and deliveries.',
+            pathParams: [
+                {
+                    name: 'workflowId',
+                    type: 'string',
+                    description: 'Workflow ID',
+                    required: true,
+                },
+            ],
+            queryParams: [],
+            requestBody: null,
+            responseDescription: 'Empty response on success.',
+            statuses: [
+                { code: 204, description: 'Workflow deleted' },
+                { code: 401, description: 'Unauthorized — invalid or missing Bearer token' },
+                { code: 404, description: 'Workflow not found' },
+            ],
+            examplePath: '/workflow/wf_abc123',
+        },
+        {
+            id: 'test-workflow',
+            title: 'Test Workflow',
+            sectionTitle: 'Testing',
+            method: 'POST',
+            path: '/workflow/{workflowId}/test',
+            description: 'Test a workflow with a sample payload.',
+            pathParams: [
+                {
+                    name: 'workflowId',
+                    type: 'string',
+                    description: 'Workflow ID',
+                    required: true,
+                },
+            ],
+            queryParams: [],
+            requestBody: {
+                description: 'Test payload to send through the workflow.',
+                fields: { schema: TestWorkflowRequestSchema },
+            },
+            responseDescription: 'Returns the test execution result.',
+            responseFields: { schema: TestWorkflowResultSchema },
+            statuses: [
+                { code: 200, description: 'Test completed' },
+                { code: 401, description: 'Unauthorized — invalid or missing Bearer token' },
+                { code: 404, description: 'Workflow not found' },
+            ],
+            examplePath: '/workflow/wf_abc123/test',
+            exampleBody: { payload: { event: 'test', data: { key: 'value' } } },
+        },
+        {
+            id: 'workflow-activity',
+            title: 'Get Workflow Activity',
+            sectionTitle: 'Analytics',
+            method: 'GET',
+            path: '/workflow/activity',
+            description: 'Get workflow activity statistics for the organization.',
+            pathParams: [],
+            queryParams: [
+                {
+                    name: 'days',
+                    type: 'number',
+                    description: 'Number of days to look back',
+                    required: false,
+                },
+            ],
+            requestBody: null,
+            responseDescription: 'Returns aggregate workflow activity statistics.',
+            responseFields: { schema: WorkflowActivitySchema },
+            statuses: [
+                { code: 200, description: 'Activity returned' },
+                { code: 401, description: 'Unauthorized — invalid or missing Bearer token' },
+            ],
+            examplePath: '/workflow/activity',
+        },
+        {
+            id: 'list-workflow-executions',
+            title: 'List Workflow Executions',
+            sectionTitle: 'Executions',
+            method: 'GET',
+            path: '/workflow/{workflowId}/executions',
+            description: 'List execution records for a specific workflow.',
+            pathParams: [
+                {
+                    name: 'workflowId',
+                    type: 'string',
+                    description: 'Workflow ID',
+                    required: true,
+                },
+            ],
+            queryParams: [],
+            requestBody: null,
+            responseDescription: 'Returns list of executions.',
+            responseFields: { schema: z.array(WorkflowExecutionSchema) },
+            statuses: [
+                { code: 200, description: 'Executions returned' },
+                { code: 401, description: 'Unauthorized — invalid or missing Bearer token' },
+                { code: 404, description: 'Workflow not found' },
+            ],
+            examplePath: '/workflow/wf_abc123/executions',
+        },
+        {
+            id: 'list-workflow-deliveries',
+            title: 'List Workflow Deliveries',
+            sectionTitle: 'Deliveries',
+            method: 'GET',
+            path: '/workflow/executions/{executionId}/deliveries',
+            description: 'List delivery records for a specific execution.',
+            pathParams: [
+                {
+                    name: 'executionId',
+                    type: 'string',
+                    description: 'Execution ID',
+                    required: true,
+                },
+            ],
+            queryParams: [],
+            requestBody: null,
+            responseDescription: 'Returns list of deliveries.',
+            responseFields: { schema: z.array(WorkflowDeliverySchema) },
+            statuses: [
+                { code: 200, description: 'Deliveries returned' },
+                { code: 401, description: 'Unauthorized — invalid or missing Bearer token' },
+                { code: 404, description: 'Execution not found' },
+            ],
+            examplePath: '/workflow/executions/exec_abc123/deliveries',
+        },
+        {
+            id: 'get-recent-payload',
+            title: 'Get Recent Payload',
+            sectionTitle: 'Analytics',
+            method: 'GET',
+            path: '/workflow/{workflowId}/recent-payload',
+            description: 'Get the most recent payload received by a workflow.',
+            pathParams: [
+                {
+                    name: 'workflowId',
+                    type: 'string',
+                    description: 'Workflow ID',
+                    required: true,
+                },
+            ],
+            queryParams: [],
+            requestBody: null,
+            responseDescription: 'Returns the most recent payload data.',
+            statuses: [
+                { code: 200, description: 'Payload returned' },
+                { code: 401, description: 'Unauthorized — invalid or missing Bearer token' },
+                { code: 404, description: 'Workflow not found or no recent payload' },
+            ],
+            examplePath: '/workflow/wf_abc123/recent-payload',
+        },
+    ],
+};
+export default service;
+//# sourceMappingURL=api-reference.js.map

package/dist/services/workflow/api-reference.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-reference.js","sourceRoot":"","sources":["../../../src/services/workflow/api-reference.ts"],"names":[],"mappings":"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"}

package/dist/services/workflow/index.d.ts

@@ -0,0 +1,3 @@
+export * from './service.ts';
+export * from './types.ts';
+//# sourceMappingURL=index.d.ts.map

package/dist/services/workflow/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/services/workflow/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC"}

package/dist/services/workflow/index.js

@@ -0,0 +1,3 @@
+export * from "./service.js";
+export * from "./types.js";
+//# sourceMappingURL=index.js.map

package/dist/services/workflow/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/services/workflow/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC"}

package/dist/services/workflow/service.d.ts

@@ -0,0 +1,235 @@
+import type { CreateWorkflowRequest, ListWorkflowsRequest, UpdateWorkflowGraphRequest, UpdateWorkflowRequest, WorkflowActivity, WorkflowCreateResult, WorkflowDelivery, WorkflowExecution, WorkflowGetResult, WorkflowListResult, WorkflowUpdateResult, TestWorkflowRequest, TestWorkflowResult } from './types.ts';
+import type { FetchAdapter } from '../adapter.ts';
+/**
+ * Client for the Agentuity Workflow service.
+ *
+ * Provides methods for creating and managing workflows that route events from
+ * sources (email, queue, webhook, schedule) to configured destinations. The
+ * service supports:
+ *
+ * - **Workflows**: Named routing configurations with a source and graph
+ * - **Executions**: Records of workflow runs with step-level detail
+ * - **Deliveries**: Records of destination delivery attempts
+ * - **Testing**: Send test payloads through a workflow
+ *
+ * All methods are instrumented with OpenTelemetry spans for observability.
+ *
+ * @example
+ * ```typescript
+ * const workflows = new WorkflowService(baseUrl, adapter);
+ *
+ * // Create a workflow
+ * const { workflow } = await workflows.create({
+ *   name: 'GitHub to Slack',
+ *   source_type: 'webhook',
+ *   source_ref_id: 'wh_abc123',
+ * });
+ *
+ * // List active workflows
+ * const { workflows: list } = await workflows.list({ status: 'enabled' });
+ * ```
+ */
+export declare class WorkflowService {
+    #private;
+    /**
+     * Creates a new WorkflowService instance.
+     *
+     * @param baseUrl - The base URL of the workflow API
+     * @param adapter - The HTTP fetch adapter used for making API requests
+     */
+    constructor(baseUrl: string, adapter: FetchAdapter);
+    /**
+     * Lists all workflows for the authenticated organization.
+     *
+     * @param params - Optional filter and pagination parameters
+     * @returns A promise resolving to the paginated list of workflows
+     * @throws {@link WorkflowResponseError} If the API returns a failure response body
+     * @throws {@link ServiceException} If the HTTP request fails
+     *
+     * @example
+     * ```typescript
+     * const result = await service.list({ status: 'enabled', limit: 10 });
+     * console.log(`Found ${result.total} workflows`);
+     * for (const wf of result.workflows) {
+     *   console.log(`${wf.name} (${wf.source_type})`);
+     * }
+     * ```
+     */
+    list(params?: ListWorkflowsRequest): Promise<WorkflowListResult>;
+    /**
+     * Gets a single workflow by its ID.
+     *
+     * @param workflowId - The unique workflow identifier (prefixed with wf_)
+     * @returns A promise resolving to the workflow details
+     * @throws {@link WorkflowResponseError} If the API returns a failure response body
+     * @throws {@link ServiceException} If the HTTP request fails
+     *
+     * @example
+     * ```typescript
+     * const result = await service.get('wf_abc123');
+     * console.log(result.workflow.name);
+     * ```
+     */
+    get(workflowId: string): Promise<WorkflowGetResult>;
+    /**
+     * Creates a new workflow.
+     *
+     * @param params - The workflow creation parameters including name, source type, and source reference
+     * @returns A promise resolving to the newly created workflow
+     * @throws {@link WorkflowResponseError} If the API returns a failure response body
+     * @throws {@link ServiceException} If the HTTP request fails
+     *
+     * @example
+     * ```typescript
+     * const result = await service.create({
+     *   name: 'Email to Slack',
+     *   source_type: 'email',
+     *   source_ref_id: 'user@example.com',
+     * });
+     * console.log('Created:', result.workflow.id);
+     * ```
+     */
+    create(params: CreateWorkflowRequest): Promise<WorkflowCreateResult>;
+    /**
+     * Updates an existing workflow's name, description, or status.
+     *
+     * @param workflowId - The unique workflow identifier
+     * @param params - Fields to update; only provided fields are changed
+     * @returns A promise resolving to the updated workflow
+     * @throws {@link WorkflowResponseError} If the API returns a failure response body
+     * @throws {@link ServiceException} If the HTTP request fails
+     *
+     * @example
+     * ```typescript
+     * const result = await service.update('wf_abc123', {
+     *   name: 'Updated Workflow Name',
+     *   status: 'disabled',
+     * });
+     * console.log('Updated:', result.workflow.name);
+     * ```
+     */
+    update(workflowId: string, params: UpdateWorkflowRequest): Promise<WorkflowUpdateResult>;
+    /**
+     * Updates the workflow graph (nodes and edges) for a workflow.
+     *
+     * @param workflowId - The unique workflow identifier
+     * @param params - The new graph definition with nodes and edges
+     * @returns A promise resolving to the updated workflow
+     * @throws {@link WorkflowResponseError} If the API returns a failure response body
+     * @throws {@link ServiceException} If the HTTP request fails
+     *
+     * @example
+     * ```typescript
+     * const result = await service.updateGraph('wf_abc123', {
+     *   nodes: [{ id: 'n1', type: 'filter', data: { expr: '...' } }],
+     *   edges: [{ id: 'e1', source: 'n1', target: 'n2' }],
+     * });
+     * ```
+     */
+    updateGraph(workflowId: string, params: UpdateWorkflowGraphRequest): Promise<WorkflowUpdateResult>;
+    /**
+     * Deletes a workflow and all associated data.
+     *
+     * @param workflowId - The unique workflow identifier
+     * @throws {@link WorkflowResponseError} If the API returns a failure response body
+     * @throws {@link ServiceException} If the HTTP request fails
+     *
+     * @example
+     * ```typescript
+     * await service.delete('wf_abc123');
+     * console.log('Workflow deleted');
+     * ```
+     */
+    delete(workflowId: string): Promise<void>;
+    /**
+     * Tests a workflow with a sample payload.
+     *
+     * Sends the provided payload through the workflow and returns the execution
+     * result including individual step outcomes.
+     *
+     * @param workflowId - The unique workflow identifier
+     * @param params - The test parameters including the payload to send
+     * @returns A promise resolving to the test execution result
+     * @throws {@link WorkflowResponseError} If the API returns a failure response body
+     * @throws {@link ServiceException} If the HTTP request fails
+     *
+     * @example
+     * ```typescript
+     * const result = await service.test('wf_abc123', {
+     *   payload: { event: 'push', repo: 'my-repo' },
+     * });
+     * console.log('Test status:', result.status);
+     * ```
+     */
+    test(workflowId: string, params: TestWorkflowRequest): Promise<TestWorkflowResult>;
+    /**
+     * Gets workflow activity statistics for the authenticated organization.
+     *
+     * Returns aggregate counts of workflows, executions, and their statuses.
+     *
+     * @param days - Optional number of days to look back for activity (default: server-side default)
+     * @returns A promise resolving to the activity statistics
+     * @throws {@link WorkflowResponseError} If the API returns a failure response body
+     * @throws {@link ServiceException} If the HTTP request fails
+     *
+     * @example
+     * ```typescript
+     * const activity = await service.activity(7);
+     * console.log(`${activity.total_workflows} workflows, ${activity.total_executions} executions`);
+     * ```
+     */
+    activity(days?: number): Promise<WorkflowActivity>;
+    /**
+     * Lists execution records for a specific workflow.
+     *
+     * @param workflowId - The unique workflow identifier
+     * @returns A promise resolving to the list of executions
+     * @throws {@link WorkflowResponseError} If the API returns a failure response body
+     * @throws {@link ServiceException} If the HTTP request fails
+     *
+     * @example
+     * ```typescript
+     * const executions = await service.listExecutions('wf_abc123');
+     * for (const exec of executions) {
+     *   console.log(`${exec.id}: ${exec.status}`);
+     * }
+     * ```
+     */
+    listExecutions(workflowId: string): Promise<WorkflowExecution[]>;
+    /**
+     * Lists delivery records for a specific workflow execution.
+     *
+     * @param executionId - The unique execution identifier
+     * @returns A promise resolving to the list of deliveries
+     * @throws {@link WorkflowResponseError} If the API returns a failure response body
+     * @throws {@link ServiceException} If the HTTP request fails
+     *
+     * @example
+     * ```typescript
+     * const deliveries = await service.listDeliveries('exec_abc123');
+     * for (const d of deliveries) {
+     *   console.log(`${d.destination_type}: ${d.status}`);
+     * }
+     * ```
+     */
+    listDeliveries(executionId: string): Promise<WorkflowDelivery[]>;
+    /**
+     * Gets the most recent payload received by a workflow.
+     *
+     * Useful for inspecting the last event that triggered the workflow, e.g.
+     * when building or debugging workflow graphs.
+     *
+     * @param workflowId - The unique workflow identifier
+     * @returns A promise resolving to the recent payload data
+     * @throws {@link WorkflowResponseError} If the API returns a failure response body
+     * @throws {@link ServiceException} If the HTTP request fails
+     *
+     * @example
+     * ```typescript
+     * const payload = await service.getRecentPayload('wf_abc123');
+     * console.log('Last payload:', JSON.stringify(payload, null, 2));
+     * ```
+     */
+    getRecentPayload(workflowId: string): Promise<unknown>;
+}
+//# sourceMappingURL=service.d.ts.map

package/dist/services/workflow/service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../../../src/services/workflow/service.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACX,qBAAqB,EACrB,oBAAoB,EACpB,0BAA0B,EAC1B,qBAAqB,EACrB,gBAAgB,EAChB,oBAAoB,EACpB,gBAAgB,EAChB,iBAAiB,EACjB,iBAAiB,EACjB,kBAAkB,EAClB,oBAAoB,EACpB,mBAAmB,EACnB,kBAAkB,EAClB,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AA8ClD;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,qBAAa,eAAe;;IAI3B;;;;;OAKG;gBACS,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY;IAUlD;;;;;;;;;;;;;;;;OAgBG;IACG,IAAI,CAAC,MAAM,CAAC,EAAE,oBAAoB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAkCtE;;;;;;;;;;;;;OAaG;IACG,GAAG,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC;IA6BzD;;;;;;;;;;;;;;;;;OAiBG;IACG,MAAM,CAAC,MAAM,EAAE,qBAAqB,GAAG,OAAO,CAAC,oBAAoB,CAAC;IA+B1E;;;;;;;;;;;;;;;;;OAiBG;IACG,MAAM,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,qBAAqB,GAAG,OAAO,CAAC,oBAAoB,CAAC;IA8B9F;;;;;;;;;;;;;;;;OAgBG;IACG,WAAW,CAChB,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,0BAA0B,GAChC,OAAO,CAAC,oBAAoB,CAAC;IA8BhC;;;;;;;;;;;;OAYG;IACG,MAAM,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAiC/C;;;;;;;;;;;;;;;;;;;OAmBG;IACG,IAAI,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,mBAAmB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IA8BxF;;;;;;;;;;;;;;;OAeG;IACG,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IA8BxD;;;;;;;;;;;;;;;OAeG;IACG,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC;IA6BtE;;;;;;;;;;;;;;;OAeG;IACG,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC;IA+BtE;;;;;;;;;;;;;;;;OAgBG;IACG,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;CA4B5D"}