@agentuity/core 1.0.33 → 1.0.34

package/dist/services/schedule.js

@@ -1,425 +0,0 @@
-import { buildUrl, toServiceException } from "./_util.js";
-/**
- * Client for the Agentuity Schedule service.
- *
- * Provides methods for creating, managing, and monitoring cron-based scheduled jobs.
- * Schedules fire at intervals defined by cron expressions and deliver HTTP requests
- * to configured destinations (URLs or sandboxes).
- *
- * The service supports:
- * - CRUD operations on schedules and their destinations
- * - Cron expression validation
- * - Delivery history and monitoring
- * - Automatic due date computation from cron expressions
- *
- * All methods are instrumented with OpenTelemetry spans for observability.
- *
- * @example
- * ```typescript
- * const schedules = new ScheduleService(baseUrl, adapter);
- *
- * // Create a schedule that fires every hour
- * const result = await schedules.create({
- *   name: 'Hourly Sync',
- *   expression: '0 * * * *',
- *   destinations: [{ type: 'url', config: { url: 'https://example.com/sync' } }],
- * });
- *
- * // List all schedules
- * const { schedules: list, total } = await schedules.list();
- * ```
- */
-export class ScheduleService {
-    #adapter;
-    #baseUrl;
-    /**
-     * Create a new ScheduleService instance.
-     *
-     * @param baseUrl - The base URL for the Agentuity Schedule API (e.g., `https://api.agentuity.com`)
-     * @param adapter - The HTTP fetch adapter used for making API requests
-     */
-    constructor(baseUrl, adapter) {
-        this.#adapter = adapter;
-        this.#baseUrl = baseUrl;
-    }
-    /**
-     * Create a new schedule with optional destinations.
-     *
-     * The schedule and its destinations are created atomically — if any validation
-     * fails, the entire operation is rolled back.
-     *
-     * @param params - The schedule creation parameters including name, cron expression, and optional destinations
-     * @returns The created schedule and its destinations
-     * @throws ServiceException on API errors (e.g., invalid cron expression, invalid destination URL)
-     *
-     * @example
-     * ```typescript
-     * const result = await schedules.create({
-     *   name: 'Daily Report',
-     *   description: 'Generate and send daily reports',
-     *   expression: '0 9 * * *',
-     *   destinations: [
-     *     { type: 'url', config: { url: 'https://example.com/reports' } },
-     *   ],
-     * });
-     * console.log('Created schedule:', result.schedule.id);
-     * console.log('Next run:', result.schedule.due_date);
-     * ```
-     */
-    async create(params) {
-        const url = buildUrl(this.#baseUrl, '/schedule/create');
-        const signal = AbortSignal.timeout(30_000);
-        const res = await this.#adapter.invoke(url, {
-            method: 'POST',
-            signal,
-            body: JSON.stringify(params),
-            contentType: 'application/json',
-            telemetry: {
-                name: 'agentuity.schedule.create',
-                attributes: {
-                    destinationCount: String(params.destinations?.length ?? 0),
-                    name: params.name,
-                },
-            },
-        });
-        if (res.ok) {
-            return res.data;
-        }
-        throw await toServiceException('POST', url, res.response);
-    }
-    /**
-     * List all schedules with optional pagination.
-     *
-     * @param params - Optional pagination parameters
-     * @param params.limit - Maximum number of schedules to return (max 500)
-     * @param params.offset - Number of schedules to skip for pagination
-     * @returns A paginated list of schedules with the total count
-     * @throws ServiceException on API errors
-     *
-     * @example
-     * ```typescript
-     * // List first page
-     * const { schedules, total } = await service.list({ limit: 20 });
-     * console.log(`Showing ${schedules.length} of ${total} schedules`);
-     *
-     * // Paginate through all schedules
-     * const page2 = await service.list({ limit: 20, offset: 20 });
-     * ```
-     */
-    async list(params) {
-        const qs = new URLSearchParams();
-        if (params?.limit !== undefined) {
-            qs.set('limit', String(params.limit));
-        }
-        if (params?.offset !== undefined) {
-            qs.set('offset', String(params.offset));
-        }
-        const path = qs.toString() ? `/schedule/list?${qs.toString()}` : '/schedule/list';
-        const url = buildUrl(this.#baseUrl, path);
-        const signal = AbortSignal.timeout(30_000);
-        const res = await this.#adapter.invoke(url, {
-            method: 'GET',
-            signal,
-            telemetry: {
-                name: 'agentuity.schedule.list',
-                attributes: {
-                    limit: String(params?.limit ?? ''),
-                    offset: String(params?.offset ?? ''),
-                },
-            },
-        });
-        if (res.ok) {
-            return res.data;
-        }
-        throw await toServiceException('GET', url, res.response);
-    }
-    /**
-     * Get a schedule by its ID, including all configured destinations.
-     *
-     * @param scheduleId - The schedule ID (prefixed with `sch_`)
-     * @returns The schedule record and its array of destinations
-     * @throws ServiceException on API errors (including 404 if not found)
-     *
-     * @example
-     * ```typescript
-     * const { schedule, destinations } = await service.get('sch_abc123');
-     * console.log('Schedule:', schedule.name);
-     * console.log('Next run:', schedule.due_date);
-     * console.log('Destinations:', destinations.length);
-     * ```
-     */
-    async get(scheduleId) {
-        const url = buildUrl(this.#baseUrl, `/schedule/get/${encodeURIComponent(scheduleId)}`);
-        const signal = AbortSignal.timeout(30_000);
-        const res = await this.#adapter.invoke(url, {
-            method: 'GET',
-            signal,
-            telemetry: {
-                name: 'agentuity.schedule.get',
-                attributes: {
-                    scheduleId,
-                },
-            },
-        });
-        if (res.ok) {
-            return res.data;
-        }
-        if (res.response.status === 404) {
-            throw await toServiceException('GET', url, res.response);
-        }
-        throw await toServiceException('GET', url, res.response);
-    }
-    /**
-     * Update an existing schedule. Only the provided fields are modified.
-     *
-     * @remarks If the `expression` field is changed, the `due_date` is automatically
-     * recomputed based on the new cron expression.
-     *
-     * @param scheduleId - The schedule ID (prefixed with `sch_`)
-     * @param params - The fields to update (all optional)
-     * @returns The updated schedule record
-     * @throws ServiceException on API errors (e.g., invalid cron expression, schedule not found)
-     *
-     * @example
-     * ```typescript
-     * // Update the name and expression
-     * const { schedule } = await service.update('sch_abc123', {
-     *   name: 'Daily Midnight Sync',
-     *   expression: '0 0 * * *',
-     * });
-     * console.log('Updated. Next run:', schedule.due_date);
-     * ```
-     */
-    async update(scheduleId, params) {
-        const url = buildUrl(this.#baseUrl, `/schedule/update/${encodeURIComponent(scheduleId)}`);
-        const signal = AbortSignal.timeout(30_000);
-        const res = await this.#adapter.invoke(url, {
-            method: 'PUT',
-            signal,
-            body: JSON.stringify(params),
-            contentType: 'application/json',
-            telemetry: {
-                name: 'agentuity.schedule.update',
-                attributes: {
-                    scheduleId,
-                },
-            },
-        });
-        if (res.ok) {
-            return res.data;
-        }
-        throw await toServiceException('PUT', url, res.response);
-    }
-    /**
-     * Delete a schedule and all of its destinations and delivery history.
-     *
-     * @param scheduleId - The schedule ID (prefixed with `sch_`)
-     * @throws ServiceException on API errors (e.g., schedule not found)
-     *
-     * @example
-     * ```typescript
-     * await service.delete('sch_abc123');
-     * console.log('Schedule deleted');
-     * ```
-     */
-    async delete(scheduleId) {
-        const url = buildUrl(this.#baseUrl, `/schedule/delete/${encodeURIComponent(scheduleId)}`);
-        const signal = AbortSignal.timeout(30_000);
-        const res = await this.#adapter.invoke(url, {
-            method: 'DELETE',
-            signal,
-            telemetry: {
-                name: 'agentuity.schedule.delete',
-                attributes: {
-                    scheduleId,
-                },
-            },
-        });
-        if (res.ok) {
-            return;
-        }
-        throw await toServiceException('DELETE', url, res.response);
-    }
-    /**
-     * Create a new destination on an existing schedule.
-     *
-     * @param scheduleId - The schedule ID (prefixed with `sch_`)
-     * @param params - The destination configuration including type and type-specific config
-     * @returns The newly created destination record
-     * @throws ServiceException on API errors (e.g., invalid URL, schedule not found)
-     *
-     * @example
-     * ```typescript
-     * const { destination } = await service.createDestination('sch_abc123', {
-     *   type: 'url',
-     *   config: {
-     *     url: 'https://example.com/webhook',
-     *     headers: { 'Authorization': 'Bearer token' },
-     *   },
-     * });
-     * console.log('Destination created:', destination.id);
-     * ```
-     */
-    async createDestination(scheduleId, params) {
-        const url = buildUrl(this.#baseUrl, `/schedule/destinations/create/${encodeURIComponent(scheduleId)}`);
-        const signal = AbortSignal.timeout(30_000);
-        const res = await this.#adapter.invoke(url, {
-            method: 'POST',
-            signal,
-            body: JSON.stringify(params),
-            contentType: 'application/json',
-            telemetry: {
-                name: 'agentuity.schedule.createDestination',
-                attributes: {
-                    scheduleId,
-                    type: params.type,
-                },
-            },
-        });
-        if (res.ok) {
-            return res.data;
-        }
-        throw await toServiceException('POST', url, res.response);
-    }
-    /**
-     * Delete a destination from a schedule.
-     *
-     * @param destinationId - The destination ID (prefixed with `sdst_`)
-     * @throws ServiceException on API errors (e.g., destination not found)
-     *
-     * @example
-     * ```typescript
-     * await service.deleteDestination('sdst_xyz789');
-     * console.log('Destination removed');
-     * ```
-     */
-    async deleteDestination(destinationId) {
-        const url = buildUrl(this.#baseUrl, `/schedule/destinations/delete/${encodeURIComponent(destinationId)}`);
-        const signal = AbortSignal.timeout(30_000);
-        const res = await this.#adapter.invoke(url, {
-            method: 'DELETE',
-            signal,
-            telemetry: {
-                name: 'agentuity.schedule.deleteDestination',
-                attributes: {
-                    destinationId,
-                },
-            },
-        });
-        if (res.ok) {
-            return;
-        }
-        throw await toServiceException('DELETE', url, res.response);
-    }
-    /**
-     * List delivery attempts for a schedule with optional pagination.
-     *
-     * @param scheduleId - The schedule ID (prefixed with `sch_`)
-     * @param params - Optional pagination parameters
-     * @param params.limit - Maximum number of deliveries to return
-     * @param params.offset - Number of deliveries to skip for pagination
-     * @returns A list of delivery attempt records
-     * @throws ServiceException on API errors (including 404 if schedule not found)
-     *
-     * @example
-     * ```typescript
-     * const { deliveries } = await service.listDeliveries('sch_abc123');
-     * for (const d of deliveries) {
-     *   console.log(`${d.date}: ${d.status} (retries: ${d.retries})`);
-     *   if (d.error) {
-     *     console.error('  Error:', d.error);
-     *   }
-     * }
-     * ```
-     */
-    async listDeliveries(scheduleId, params) {
-        const qs = new URLSearchParams();
-        if (params?.limit !== undefined) {
-            qs.set('limit', String(params.limit));
-        }
-        if (params?.offset !== undefined) {
-            qs.set('offset', String(params.offset));
-        }
-        const basePath = `/schedule/deliveries/${encodeURIComponent(scheduleId)}`;
-        const path = qs.toString() ? `${basePath}?${qs.toString()}` : basePath;
-        const url = buildUrl(this.#baseUrl, path);
-        const signal = AbortSignal.timeout(30_000);
-        const res = await this.#adapter.invoke(url, {
-            method: 'GET',
-            signal,
-            telemetry: {
-                name: 'agentuity.schedule.listDeliveries',
-                attributes: {
-                    scheduleId,
-                    limit: String(params?.limit ?? ''),
-                    offset: String(params?.offset ?? ''),
-                },
-            },
-        });
-        if (res.ok) {
-            return res.data;
-        }
-        if (res.response.status === 404) {
-            throw await toServiceException('GET', url, res.response);
-        }
-        throw await toServiceException('GET', url, res.response);
-    }
-    /**
-     * Get a specific destination for a schedule by its ID.
-     *
-     * @remarks This is a convenience method that fetches the schedule and filters
-     * its destinations client-side. For large destination lists, prefer using
-     * {@link get} directly.
-     *
-     * @param scheduleId - The schedule ID (prefixed with `sch_`)
-     * @param destinationId - The destination ID (prefixed with `sdst_`)
-     * @returns The matching destination record
-     * @throws Error if the destination is not found within the schedule
-     * @throws ServiceException on API errors when fetching the schedule
-     *
-     * @example
-     * ```typescript
-     * const dest = await service.getDestination('sch_abc123', 'sdst_xyz789');
-     * console.log('Destination type:', dest.type);
-     * console.log('Config:', dest.config);
-     * ```
-     */
-    async getDestination(scheduleId, destinationId) {
-        const result = await this.get(scheduleId);
-        const destination = result.destinations.find((d) => d.id === destinationId);
-        if (!destination) {
-            throw new Error(`Destination not found: ${destinationId}`);
-        }
-        return destination;
-    }
-    /**
-     * Get a specific delivery record by its ID.
-     *
-     * @remarks This is a convenience method that lists deliveries and filters
-     * client-side. Use the optional `params` to control the search window if
-     * the delivery may not be in the first page of results.
-     *
-     * @param scheduleId - The schedule ID (prefixed with `sch_`)
-     * @param deliveryId - The delivery ID to find
-     * @param params - Optional pagination parameters to control the search window
-     * @returns The matching delivery record
-     * @throws Error if the delivery is not found in the result set
-     * @throws ServiceException on API errors when listing deliveries
-     *
-     * @example
-     * ```typescript
-     * const delivery = await service.getDelivery('sch_abc123', 'del_xyz789');
-     * console.log('Status:', delivery.status);
-     * console.log('Retries:', delivery.retries);
-     * ```
-     */
-    async getDelivery(scheduleId, deliveryId, params) {
-        const result = await this.listDeliveries(scheduleId, params);
-        const delivery = result.deliveries.find((d) => d.id === deliveryId);
-        if (!delivery) {
-            throw new Error(`Delivery not found: ${deliveryId}`);
-        }
-        return delivery;
-    }
-}
-//# sourceMappingURL=schedule.js.map

package/dist/services/schedule.js.map

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

package/dist/services/session.d.ts

@@ -1,127 +0,0 @@
-import { z } from 'zod';
-export declare const SessionStartEventSchema: z.ZodObject<{
-    id: z.ZodString;
-    threadId: z.ZodOptional<z.ZodString>;
-    orgId: z.ZodString;
-    projectId: z.ZodString;
-    deploymentId: z.ZodOptional<z.ZodString>;
-    routeId: z.ZodString;
-    environment: z.ZodString;
-    devmode: z.ZodBoolean;
-    url: z.ZodString;
-    method: z.ZodString;
-    trigger: z.ZodEnum<{
-        agent: "agent";
-        api: "api";
-        email: "email";
-        sms: "sms";
-        cron: "cron";
-        manual: "manual";
-        discord: "discord";
-        websocket: "websocket";
-    }>;
-    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-}, z.core.$strip>;
-export type SessionStartEvent = z.infer<typeof SessionStartEventSchema>;
-export declare const SessionCompleteEventSchema: z.ZodObject<{
-    id: z.ZodString;
-    threadId: z.ZodNullable<z.ZodString>;
-    error: z.ZodOptional<z.ZodString>;
-    agentIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
-    statusCode: z.ZodNumber;
-    userData: z.ZodOptional<z.ZodString>;
-    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-}, z.core.$strip>;
-export type SessionCompleteEvent = z.infer<typeof SessionCompleteEventSchema>;
-export declare const SessionStartEventDelayedSchema: z.ZodIntersection<z.ZodObject<{
-    id: z.ZodString;
-    threadId: z.ZodOptional<z.ZodString>;
-    orgId: z.ZodString;
-    projectId: z.ZodString;
-    deploymentId: z.ZodOptional<z.ZodString>;
-    routeId: z.ZodString;
-    environment: z.ZodString;
-    devmode: z.ZodBoolean;
-    url: z.ZodString;
-    method: z.ZodString;
-    trigger: z.ZodEnum<{
-        agent: "agent";
-        api: "api";
-        email: "email";
-        sms: "sms";
-        cron: "cron";
-        manual: "manual";
-        discord: "discord";
-        websocket: "websocket";
-    }>;
-    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-}, z.core.$strip>, z.ZodObject<{
-    timestamp: z.ZodNumber;
-}, z.core.$strip>>;
-export declare const SessionCompleteEventDelayedSchema: z.ZodIntersection<z.ZodObject<{
-    id: z.ZodString;
-    threadId: z.ZodNullable<z.ZodString>;
-    error: z.ZodOptional<z.ZodString>;
-    agentIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
-    statusCode: z.ZodNumber;
-    userData: z.ZodOptional<z.ZodString>;
-    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-}, z.core.$strip>, z.ZodObject<{
-    timestamp: z.ZodNumber;
-}, z.core.$strip>>;
-/**
- * SessionEventProvider is a provider for logging and tracking agent session lifecycle events.
- * Sessions represent individual agent executions triggered by API calls, cron jobs, or other sources.
- */
-export interface SessionEventProvider {
-    /**
-     * Called when an agent session starts. Records the initial context and metadata
-     * for the session including trigger source, environment, and routing information.
-     *
-     * @param event - SessionStartEvent containing session initialization data
-     *
-     * @example
-     * ```typescript
-     * await sessionProvider.start({
-     *   id: 'session-123',
-     *   threadId: 'thread-abc',
-     *   orgId: 'org-456',
-     *   projectId: 'proj-789',
-     *   deploymentId: 'deploy-xyz',
-     *   routeId: 'route-001',
-     *   environment: 'production',
-     *   devmode: false,
-     *   url: '/api/agent/chat',
-     *   method: 'POST',
-     *   trigger: 'api'
-     * });
-     * ```
-     */
-    start(event: SessionStartEvent): Promise<void>;
-    /**
-     * Called when an agent session completes (successfully or with error).
-     * Records final status, any errors, and which agents participated.
-     *
-     * @param event - SessionCompleteEvent containing completion status and results
-     *
-     * @example
-     * ```typescript
-     * // Successful completion
-     * await sessionProvider.complete({
-     *   id: 'session-123',
-     *   statusCode: 200,
-     *   agentIds: ['agent-1', 'agent-2']
-     * });
-     *
-     * // Completion with error
-     * await sessionProvider.complete({
-     *   id: 'session-123',
-     *   statusCode: 500,
-     *   error: 'Database connection timeout',
-     *   agentIds: ['agent-1']
-     * });
-     * ```
-     */
-    complete(event: SessionCompleteEvent): Promise<void>;
-}
-//# sourceMappingURL=session.d.ts.map

package/dist/services/session.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../src/services/session.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;iBAoBe,CAAC;AAEpD,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAExE,eAAO,MAAM,0BAA0B;;;;;;;;iBAgB2B,CAAC;AAEnE,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAE9E,eAAO,MAAM,8BAA8B;;;;;;;;;;;;;;;;;;;;;;;;kBAG1C,CAAC;AAEF,eAAO,MAAM,iCAAiC;;;;;;;;;;kBAG7C,CAAC;AAEF;;;GAGG;AACH,MAAM,WAAW,oBAAoB;IACpC;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACH,KAAK,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE/C;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACH,QAAQ,CAAC,KAAK,EAAE,oBAAoB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACrD"}

package/dist/services/session.js

@@ -1,42 +0,0 @@
-import { z } from 'zod';
-export const SessionStartEventSchema = z
-    .object({
-    id: z.string().describe('the session id'),
-    threadId: z.string().optional().describe('the thread id (optional, can be set in complete)'),
-    orgId: z.string().describe('the organization id'),
-    projectId: z.string().describe('the project id'),
-    deploymentId: z.string().optional().describe('the deployment id'),
-    routeId: z.string().describe('the route id'),
-    environment: z.string().describe('the environment (AGENTUITY_ENVIRONMENT)'),
-    devmode: z.boolean().describe('true if running in devmode'),
-    url: z.string().describe('the url for the session event'),
-    method: z.string().describe('the method for the session event'),
-    trigger: z
-        .enum(['agent', 'api', 'email', 'sms', 'cron', 'manual', 'discord', 'websocket'])
-        .describe('how the session was triggered'),
-    metadata: z
-        .record(z.string(), z.unknown())
-        .optional()
-        .describe('optional unencrypted key-value metadata'),
-})
-    .describe('The event to record a session started');
-export const SessionCompleteEventSchema = z
-    .object({
-    id: z.string().describe('the session id'),
-    threadId: z.string().nullable().describe('the thread id (null if thread has no data)'),
-    error: z.string().optional().describe('the optional error message if the session failed'),
-    agentIds: z
-        .array(z.string())
-        .optional()
-        .describe('optional array of ids for the agents that executed for the session'),
-    statusCode: z.number().describe('the HTTP status code'),
-    userData: z.string().optional().describe('optional JSON string of session state data'),
-    metadata: z
-        .record(z.string(), z.unknown())
-        .optional()
-        .describe('optional unencrypted key-value metadata'),
-})
-    .describe('The event to record a session completed successfully');
-export const SessionStartEventDelayedSchema = z.intersection(SessionStartEventSchema, z.object({ timestamp: z.number().int().describe('the event timestamp in epoch') }));
-export const SessionCompleteEventDelayedSchema = z.intersection(SessionCompleteEventSchema, z.object({ timestamp: z.number().int().describe('the event timestamp in epoch') }));
-//# sourceMappingURL=session.js.map

package/dist/services/session.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"session.js","sourceRoot":"","sources":["../../src/services/session.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC;KACtC,MAAM,CAAC;IACP,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,gBAAgB,CAAC;IACzC,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,kDAAkD,CAAC;IAC5F,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,qBAAqB,CAAC;IACjD,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,gBAAgB,CAAC;IAChD,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,mBAAmB,CAAC;IACjE,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,cAAc,CAAC;IAC5C,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,yCAAyC,CAAC;IAC3E,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,CAAC,4BAA4B,CAAC;IAC3D,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,+BAA+B,CAAC;IACzD,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,kCAAkC,CAAC;IAC/D,OAAO,EAAE,CAAC;SACR,IAAI,CAAC,CAAC,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,WAAW,CAAC,CAAC;SAChF,QAAQ,CAAC,+BAA+B,CAAC;IAC3C,QAAQ,EAAE,CAAC;SACT,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC;SAC/B,QAAQ,EAAE;SACV,QAAQ,CAAC,yCAAyC,CAAC;CACrD,CAAC;KACD,QAAQ,CAAC,uCAAuC,CAAC,CAAC;AAIpD,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAC;KACzC,MAAM,CAAC;IACP,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,gBAAgB,CAAC;IACzC,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,4CAA4C,CAAC;IACtF,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,kDAAkD,CAAC;IACzF,QAAQ,EAAE,CAAC;SACT,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;SACjB,QAAQ,EAAE;SACV,QAAQ,CAAC,oEAAoE,CAAC;IAChF,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,sBAAsB,CAAC;IACvD,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,4CAA4C,CAAC;IACtF,QAAQ,EAAE,CAAC;SACT,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC;SAC/B,QAAQ,EAAE;SACV,QAAQ,CAAC,yCAAyC,CAAC;CACrD,CAAC;KACD,QAAQ,CAAC,sDAAsD,CAAC,CAAC;AAInE,MAAM,CAAC,MAAM,8BAA8B,GAAG,CAAC,CAAC,YAAY,CAC3D,uBAAuB,EACvB,CAAC,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,8BAA8B,CAAC,EAAE,CAAC,CAClF,CAAC;AAEF,MAAM,CAAC,MAAM,iCAAiC,GAAG,CAAC,CAAC,YAAY,CAC9D,0BAA0B,EAC1B,CAAC,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,8BAA8B,CAAC,EAAE,CAAC,CAClF,CAAC"}