@adcp/client 0.2.0

package/dist/lib/core/ConversationTypes.d.ts

@@ -0,0 +1,242 @@
+/**
+ * Represents a single message in a conversation with an agent
+ */
+export interface Message {
+    /** Unique identifier for this message */
+    id: string;
+    /** Role of the message sender */
+    role: 'user' | 'agent' | 'system';
+    /** Message content - can be structured or text */
+    content: any;
+    /** Timestamp when message was created */
+    timestamp: string;
+    /** Optional metadata about the message */
+    metadata?: {
+        /** Tool/task name if this message is tool-related */
+        toolName?: string;
+        /** Message type (request, response, clarification, etc.) */
+        type?: string;
+        /** Additional context data */
+        [key: string]: any;
+    };
+}
+/**
+ * Request for input from the agent - sent when clarification is needed
+ */
+export interface InputRequest {
+    /** Human-readable question or prompt */
+    question: string;
+    /** Specific field being requested (if applicable) */
+    field?: string;
+    /** Expected type of response */
+    expectedType?: 'string' | 'number' | 'boolean' | 'object' | 'array';
+    /** Suggested values or options */
+    suggestions?: any[];
+    /** Whether this input is required */
+    required?: boolean;
+    /** Validation rules for the input */
+    validation?: {
+        min?: number;
+        max?: number;
+        pattern?: string;
+        enum?: any[];
+    };
+    /** Additional context about why this input is needed */
+    context?: string;
+}
+/**
+ * Different types of responses an input handler can provide
+ */
+export type InputHandlerResponse = any | Promise<any> | {
+    defer: true;
+    token: string;
+} | {
+    abort: true;
+    reason?: string;
+} | never;
+/**
+ * Function signature for input handlers
+ */
+export type InputHandler = (context: ConversationContext) => InputHandlerResponse;
+/**
+ * Complete conversation context provided to input handlers
+ */
+export interface ConversationContext {
+    /** Full conversation history for this task */
+    messages: Message[];
+    /** Current input request from the agent */
+    inputRequest: InputRequest;
+    /** Unique task identifier */
+    taskId: string;
+    /** Agent configuration */
+    agent: {
+        id: string;
+        name: string;
+        protocol: 'mcp' | 'a2a';
+    };
+    /** Current clarification attempt number (1-based) */
+    attempt: number;
+    /** Maximum allowed clarification attempts */
+    maxAttempts: number;
+    /** Helper method to defer task to human */
+    deferToHuman(): Promise<{
+        defer: true;
+        token: string;
+    }>;
+    /** Helper method to abort the task */
+    abort(reason?: string): never;
+    /** Get conversation summary for context */
+    getSummary(): string;
+    /** Check if a field was previously discussed */
+    wasFieldDiscussed(field: string): boolean;
+    /** Get previous response for a field */
+    getPreviousResponse(field: string): any;
+}
+/**
+ * Status of a task execution
+ */
+export type TaskStatus = 'pending' | 'running' | 'needs_input' | 'completed' | 'failed' | 'deferred' | 'aborted' | 'submitted';
+/**
+ * Options for task execution
+ */
+export interface TaskOptions {
+    /** Timeout for entire task (ms) */
+    timeout?: number;
+    /** Maximum clarification rounds before failing */
+    maxClarifications?: number;
+    /** Context ID to continue existing conversation */
+    contextId?: string;
+    /** Enable debug logging for this task */
+    debug?: boolean;
+    /** Additional metadata to include */
+    metadata?: Record<string, any>;
+}
+/**
+ * Internal task state for tracking execution
+ */
+export interface TaskState {
+    /** Unique task identifier */
+    taskId: string;
+    /** Task name (tool name) */
+    taskName: string;
+    /** Original parameters */
+    params: any;
+    /** Current status */
+    status: TaskStatus;
+    /** Message history */
+    messages: Message[];
+    /** Current input request (if waiting for input) */
+    pendingInput?: InputRequest;
+    /** Start time */
+    startTime: number;
+    /** Current attempt number */
+    attempt: number;
+    /** Maximum attempts allowed */
+    maxAttempts: number;
+    /** Task options */
+    options: TaskOptions;
+    /** Agent configuration */
+    agent: {
+        id: string;
+        name: string;
+        protocol: 'mcp' | 'a2a';
+    };
+}
+/**
+ * Task tracking information from tasks/get endpoint (PR #78)
+ */
+export interface TaskInfo {
+    /** Task ID */
+    taskId: string;
+    /** Current status */
+    status: string;
+    /** Task type/name */
+    taskType: string;
+    /** Creation timestamp */
+    createdAt: number;
+    /** Last update timestamp */
+    updatedAt: number;
+    /** Task result (if completed) */
+    result?: any;
+    /** Error message (if failed) */
+    error?: string;
+    /** Webhook URL (if applicable) */
+    webhookUrl?: string;
+}
+/**
+ * Continuation for deferred client tasks (client needs time)
+ */
+export interface DeferredContinuation<T> {
+    /** Token for resuming the task */
+    token: string;
+    /** Question that triggered the deferral */
+    question?: string;
+    /** Resume the task with user input */
+    resume: (input: any) => Promise<TaskResult<T>>;
+}
+/**
+ * Continuation for submitted server tasks (server needs time)
+ */
+export interface SubmittedContinuation<T> {
+    /** Task ID for tracking */
+    taskId: string;
+    /** Webhook URL where server will notify completion */
+    webhookUrl?: string;
+    /** Get current task status */
+    track: () => Promise<TaskInfo>;
+    /** Wait for completion with polling */
+    waitForCompletion: (pollInterval?: number) => Promise<TaskResult<T>>;
+}
+/**
+ * Result of a task execution
+ */
+export interface TaskResult<T = any> {
+    /** Whether the task completed successfully */
+    success: boolean;
+    /** Task execution status */
+    status: 'completed' | 'deferred' | 'submitted';
+    /** Task result data (if successful) */
+    data?: T;
+    /** Error message (if failed) */
+    error?: string;
+    /** Deferred continuation (client needs time for input) */
+    deferred?: DeferredContinuation<T>;
+    /** Submitted continuation (server needs time for processing) */
+    submitted?: SubmittedContinuation<T>;
+    /** Task execution metadata */
+    metadata: {
+        taskId: string;
+        taskName: string;
+        agent: {
+            id: string;
+            name: string;
+            protocol: 'mcp' | 'a2a';
+        };
+        /** Total execution time in milliseconds */
+        responseTimeMs: number;
+        /** ISO timestamp of completion */
+        timestamp: string;
+        /** Number of clarification rounds */
+        clarificationRounds: number;
+        /** Final status */
+        status: TaskStatus;
+    };
+    /** Full conversation history */
+    conversation?: Message[];
+    /** Debug logs (if debug enabled) */
+    debugLogs?: any[];
+}
+/**
+ * Configuration for conversation management
+ */
+export interface ConversationConfig {
+    /** Maximum messages to keep in history */
+    maxHistorySize?: number;
+    /** Whether to persist conversations */
+    persistConversations?: boolean;
+    /** Timeout for 'working' status (max 120s per PR #78) */
+    workingTimeout?: number;
+    /** Default max clarifications */
+    defaultMaxClarifications?: number;
+}
+//# sourceMappingURL=ConversationTypes.d.ts.map

package/dist/lib/core/ConversationTypes.d.ts.map

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

package/dist/lib/core/ConversationTypes.js

@@ -0,0 +1,5 @@
+"use strict";
+// Core conversation types for ADCP client library
+// These types support the conversation and clarification pattern
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=ConversationTypes.js.map

package/dist/lib/core/ConversationTypes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConversationTypes.js","sourceRoot":"","sources":["../../../src/lib/core/ConversationTypes.ts"],"names":[],"mappings":";AAAA,kDAAkD;AAClD,iEAAiE"}

package/dist/lib/core/ProtocolResponseParser.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Simple ADCP-compliant response parser
+ * Implements ADCP spec PR #77 for standardized status field
+ */
+import type { InputRequest } from './ConversationTypes';
+/**
+ * ADCP standardized status values as per spec PR #78
+ * Clear semantics for async task management:
+ * - submitted: Long-running tasks (hours to days) - webhook required
+ * - working: Processing tasks (<120 seconds) - keep connection open
+ * - input-required: Tasks needing user interaction via handler
+ * - completed: Successful task completion
+ */
+export declare const ADCP_STATUS: {
+    readonly SUBMITTED: "submitted";
+    readonly WORKING: "working";
+    readonly INPUT_REQUIRED: "input-required";
+    readonly COMPLETED: "completed";
+    readonly FAILED: "failed";
+    readonly CANCELED: "canceled";
+    readonly REJECTED: "rejected";
+    readonly AUTH_REQUIRED: "auth-required";
+    readonly UNKNOWN: "unknown";
+};
+export type ADCPStatus = typeof ADCP_STATUS[keyof typeof ADCP_STATUS];
+/**
+ * Simple parser that follows ADCP spec exactly
+ */
+export declare class ProtocolResponseParser {
+    /**
+     * Check if response indicates input is needed per ADCP spec
+     */
+    isInputRequest(response: any): boolean;
+    /**
+     * Parse input request from response
+     */
+    parseInputRequest(response: any): InputRequest;
+    /**
+     * Get ADCP status from response
+     */
+    getStatus(response: any): ADCPStatus | null;
+    private parseExpectedType;
+}
+export declare const responseParser: ProtocolResponseParser;
+//# sourceMappingURL=ProtocolResponseParser.d.ts.map

package/dist/lib/core/ProtocolResponseParser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ProtocolResponseParser.d.ts","sourceRoot":"","sources":["../../../src/lib/core/ProtocolResponseParser.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAExD;;;;;;;GAOG;AACH,eAAO,MAAM,WAAW;;;;;;;;;;CAUd,CAAC;AAEX,MAAM,MAAM,UAAU,GAAG,OAAO,WAAW,CAAC,MAAM,OAAO,WAAW,CAAC,CAAC;AAEtE;;GAEG;AACH,qBAAa,sBAAsB;IACjC;;OAEG;IACH,cAAc,CAAC,QAAQ,EAAE,GAAG,GAAG,OAAO;IAetC;;OAEG;IACH,iBAAiB,CAAC,QAAQ,EAAE,GAAG,GAAG,YAAY;IAgB9C;;OAEG;IACH,SAAS,CAAC,QAAQ,EAAE,GAAG,GAAG,UAAU,GAAG,IAAI;IAO3C,OAAO,CAAC,iBAAiB;CAO1B;AAGD,eAAO,MAAM,cAAc,wBAA+B,CAAC"}

package/dist/lib/core/ProtocolResponseParser.js

@@ -0,0 +1,82 @@
+"use strict";
+/**
+ * Simple ADCP-compliant response parser
+ * Implements ADCP spec PR #77 for standardized status field
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.responseParser = exports.ProtocolResponseParser = exports.ADCP_STATUS = void 0;
+/**
+ * ADCP standardized status values as per spec PR #78
+ * Clear semantics for async task management:
+ * - submitted: Long-running tasks (hours to days) - webhook required
+ * - working: Processing tasks (<120 seconds) - keep connection open
+ * - input-required: Tasks needing user interaction via handler
+ * - completed: Successful task completion
+ */
+exports.ADCP_STATUS = {
+    SUBMITTED: 'submitted', // Long-running (hours/days) - webhook required
+    WORKING: 'working', // Processing (<120s) - keep connection open  
+    INPUT_REQUIRED: 'input-required', // Needs user input via handler
+    COMPLETED: 'completed', // Task completed successfully
+    FAILED: 'failed', // Task failed
+    CANCELED: 'canceled', // Task was canceled
+    REJECTED: 'rejected', // Task was rejected
+    AUTH_REQUIRED: 'auth-required', // Authentication required
+    UNKNOWN: 'unknown' // Unknown status
+};
+/**
+ * Simple parser that follows ADCP spec exactly
+ */
+class ProtocolResponseParser {
+    /**
+     * Check if response indicates input is needed per ADCP spec
+     */
+    isInputRequest(response) {
+        // ADCP spec: check status field first
+        if (response?.status === exports.ADCP_STATUS.INPUT_REQUIRED) {
+            return true;
+        }
+        // Legacy fallback for backward compatibility
+        return (response?.type === 'input_request' ||
+            response?.question !== undefined ||
+            response?.input_required === true ||
+            response?.needs_clarification === true);
+    }
+    /**
+     * Parse input request from response
+     */
+    parseInputRequest(response) {
+        const question = response.message || response.question || response.prompt || 'Please provide input';
+        const field = response.field || response.parameter;
+        const suggestions = response.options || response.choices || response.suggestions;
+        return {
+            question,
+            field,
+            expectedType: this.parseExpectedType(response.expected_type || response.type),
+            suggestions,
+            required: response.required !== false,
+            validation: response.validation,
+            context: response.context || response.description
+        };
+    }
+    /**
+     * Get ADCP status from response
+     */
+    getStatus(response) {
+        if (response?.status && Object.values(exports.ADCP_STATUS).includes(response.status)) {
+            return response.status;
+        }
+        return null;
+    }
+    parseExpectedType(rawType) {
+        if (typeof rawType === 'string') {
+            const allowedTypes = ["string", "number", "boolean", "object", "array"];
+            return allowedTypes.includes(rawType) ? rawType : undefined;
+        }
+        return undefined;
+    }
+}
+exports.ProtocolResponseParser = ProtocolResponseParser;
+// Export singleton instance
+exports.responseParser = new ProtocolResponseParser();
+//# sourceMappingURL=ProtocolResponseParser.js.map

package/dist/lib/core/ProtocolResponseParser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ProtocolResponseParser.js","sourceRoot":"","sources":["../../../src/lib/core/ProtocolResponseParser.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAIH;;;;;;;GAOG;AACU,QAAA,WAAW,GAAG;IACzB,SAAS,EAAE,WAAW,EAAO,+CAA+C;IAC5E,OAAO,EAAE,SAAS,EAAW,8CAA8C;IAC3E,cAAc,EAAE,gBAAgB,EAAG,+BAA+B;IAClE,SAAS,EAAE,WAAW,EAAO,8BAA8B;IAC3D,MAAM,EAAE,QAAQ,EAAY,cAAc;IAC1C,QAAQ,EAAE,UAAU,EAAQ,oBAAoB;IAChD,QAAQ,EAAE,UAAU,EAAQ,oBAAoB;IAChD,aAAa,EAAE,eAAe,EAAG,0BAA0B;IAC3D,OAAO,EAAE,SAAS,CAAU,iBAAiB;CACrC,CAAC;AAIX;;GAEG;AACH,MAAa,sBAAsB;IACjC;;OAEG;IACH,cAAc,CAAC,QAAa;QAC1B,sCAAsC;QACtC,IAAI,QAAQ,EAAE,MAAM,KAAK,mBAAW,CAAC,cAAc,EAAE,CAAC;YACpD,OAAO,IAAI,CAAC;QACd,CAAC;QAED,6CAA6C;QAC7C,OAAO,CACL,QAAQ,EAAE,IAAI,KAAK,eAAe;YAClC,QAAQ,EAAE,QAAQ,KAAK,SAAS;YAChC,QAAQ,EAAE,cAAc,KAAK,IAAI;YACjC,QAAQ,EAAE,mBAAmB,KAAK,IAAI,CACvC,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,iBAAiB,CAAC,QAAa;QAC7B,MAAM,QAAQ,GAAG,QAAQ,CAAC,OAAO,IAAI,QAAQ,CAAC,QAAQ,IAAI,QAAQ,CAAC,MAAM,IAAI,sBAAsB,CAAC;QACpG,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,IAAI,QAAQ,CAAC,SAAS,CAAC;QACnD,MAAM,WAAW,GAAG,QAAQ,CAAC,OAAO,IAAI,QAAQ,CAAC,OAAO,IAAI,QAAQ,CAAC,WAAW,CAAC;QAEjF,OAAO;YACL,QAAQ;YACR,KAAK;YACL,YAAY,EAAE,IAAI,CAAC,iBAAiB,CAAC,QAAQ,CAAC,aAAa,IAAI,QAAQ,CAAC,IAAI,CAAC;YAC7E,WAAW;YACX,QAAQ,EAAE,QAAQ,CAAC,QAAQ,KAAK,KAAK;YACrC,UAAU,EAAE,QAAQ,CAAC,UAAU;YAC/B,OAAO,EAAE,QAAQ,CAAC,OAAO,IAAI,QAAQ,CAAC,WAAW;SAClD,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,SAAS,CAAC,QAAa;QACrB,IAAI,QAAQ,EAAE,MAAM,IAAI,MAAM,CAAC,MAAM,CAAC,mBAAW,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;YAC7E,OAAO,QAAQ,CAAC,MAAoB,CAAC;QACvC,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAEO,iBAAiB,CAAC,OAAY;QACpC,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;YAChC,MAAM,YAAY,GAAG,CAAC,QAAQ,EAAE,QAAQ,EAAE,SAAS,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;YACxE,OAAO,YAAY,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAc,CAAC,CAAC,CAAC,SAAS,CAAC;QACrE,CAAC;QACD,OAAO,SAAS,CAAC;IACnB,CAAC;CACF;AAvDD,wDAuDC;AAED,4BAA4B;AACf,QAAA,cAAc,GAAG,IAAI,sBAAsB,EAAE,CAAC"}

package/dist/lib/core/TaskExecutor.d.ts

@@ -0,0 +1,108 @@
+import type { AgentConfig } from '../types';
+import type { Storage } from '../storage/interfaces';
+import type { Message, InputHandler, TaskOptions, TaskResult, TaskState, TaskInfo } from './ConversationTypes';
+/**
+ * Custom errors for task execution
+ */
+export declare class TaskTimeoutError extends Error {
+    constructor(taskId: string, timeout: number);
+}
+export declare class MaxClarificationError extends Error {
+    constructor(taskId: string, maxAttempts: number);
+}
+export declare class DeferredTaskError extends Error {
+    token: string;
+    constructor(token: string);
+}
+export declare class InputRequiredError extends Error {
+    constructor(question: string);
+}
+/**
+ * Webhook manager for submitted tasks
+ */
+interface WebhookManager {
+    generateUrl(taskId: string): string;
+    registerWebhook(agent: AgentConfig, taskId: string, webhookUrl: string): Promise<void>;
+    processWebhook(token: string, body: any): Promise<void>;
+}
+/**
+ * Deferred task storage for client deferrals
+ */
+interface DeferredTaskState {
+    taskId: string;
+    contextId: string;
+    agent: AgentConfig;
+    taskName: string;
+    params: any;
+    messages: Message[];
+    createdAt: number;
+}
+/**
+ * Core task execution engine that handles the conversation loop with agents
+ */
+export declare class TaskExecutor {
+    private config;
+    private responseParser;
+    private activeTasks;
+    private conversationStorage?;
+    constructor(config?: {
+        /** Default timeout for 'working' status (max 120s per PR #78) */
+        workingTimeout?: number;
+        /** Default max clarification attempts */
+        defaultMaxClarifications?: number;
+        /** Enable conversation storage */
+        enableConversationStorage?: boolean;
+        /** Webhook manager for submitted tasks */
+        webhookManager?: WebhookManager;
+        /** Storage for deferred task state */
+        deferredStorage?: Storage<DeferredTaskState>;
+    });
+    /**
+     * Execute a task with an agent using PR #78 async patterns
+     * Handles: working (keep SSE open), submitted (webhook), input-required (handler), completed
+     */
+    executeTask<T = any>(agent: AgentConfig, taskName: string, params: any, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<T>>;
+    /**
+     * Handle agent response based on ADCP status (PR #78)
+     */
+    private handleAsyncResponse;
+    /**
+     * Wait for 'working' status completion (max 120s per PR #78)
+     */
+    private waitForWorkingCompletion;
+    /**
+     * Set up submitted task with webhook
+     */
+    private setupSubmittedTask;
+    /**
+     * Handle input-required status (handler mandatory)
+     */
+    private handleInputRequired;
+    /**
+     * Task tracking methods (PR #78)
+     */
+    listTasks(agent: AgentConfig): Promise<TaskInfo[]>;
+    getTaskStatus(agent: AgentConfig, taskId: string): Promise<TaskInfo>;
+    pollTaskCompletion<T>(agent: AgentConfig, taskId: string, pollInterval?: number): Promise<TaskResult<T>>;
+    /**
+     * Resume a deferred task (client deferral)
+     */
+    resumeDeferredTask<T>(token: string, input: any): Promise<TaskResult<T>>;
+    /**
+     * Continue a task after receiving input
+     */
+    private continueTaskWithInput;
+    /**
+     * Utility methods
+     */
+    private sleep;
+    private createErrorResult;
+    /**
+     * Legacy methods for backward compatibility
+     */
+    getConversationHistory(taskId: string): Message[] | undefined;
+    clearConversationHistory(taskId: string): void;
+    getActiveTasks(): TaskState[];
+}
+export {};
+//# sourceMappingURL=TaskExecutor.d.ts.map

package/dist/lib/core/TaskExecutor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TaskExecutor.d.ts","sourceRoot":"","sources":["../../../src/lib/core/TaskExecutor.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAE5C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AACrD,OAAO,KAAK,EACV,OAAO,EAEP,YAAY,EAEZ,WAAW,EACX,UAAU,EACV,SAAS,EAET,QAAQ,EAGT,MAAM,qBAAqB,CAAC;AAG7B;;GAEG;AACH,qBAAa,gBAAiB,SAAQ,KAAK;gBAC7B,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;CAI5C;AAED,qBAAa,qBAAsB,SAAQ,KAAK;gBAClC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM;CAIhD;AAED,qBAAa,iBAAkB,SAAQ,KAAK;IACvB,KAAK,EAAE,MAAM;gBAAb,KAAK,EAAE,MAAM;CAIjC;AAED,qBAAa,kBAAmB,SAAQ,KAAK;gBAC/B,QAAQ,EAAE,MAAM;CAI7B;AAED;;GAEG;AACH,UAAU,cAAc;IACtB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC;IACpC,eAAe,CAAC,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACvF,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACzD;AAED;;GAEG;AACH,UAAU,iBAAiB;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,WAAW,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,GAAG,CAAC;IACZ,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,qBAAa,YAAY;IAMrB,OAAO,CAAC,MAAM;IALhB,OAAO,CAAC,cAAc,CAAyB;IAC/C,OAAO,CAAC,WAAW,CAAgC;IACnD,OAAO,CAAC,mBAAmB,CAAC,CAAyB;gBAG3C,MAAM,GAAE;QACd,iEAAiE;QACjE,cAAc,CAAC,EAAE,MAAM,CAAC;QACxB,yCAAyC;QACzC,wBAAwB,CAAC,EAAE,MAAM,CAAC;QAClC,kCAAkC;QAClC,yBAAyB,CAAC,EAAE,OAAO,CAAC;QACpC,0CAA0C;QAC1C,cAAc,CAAC,EAAE,cAAc,CAAC;QAChC,sCAAsC;QACtC,eAAe,CAAC,EAAE,OAAO,CAAC,iBAAiB,CAAC,CAAC;KACzC;IAQR;;;OAGG;IACG,WAAW,CAAC,CAAC,GAAG,GAAG,EACvB,KAAK,EAAE,WAAW,EAClB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,GAAG,EACX,YAAY,CAAC,EAAE,YAAY,EAC3B,OAAO,GAAE,WAAgB,GACxB,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;IAmDzB;;OAEG;YACW,mBAAmB;IAoFjC;;OAEG;YACW,wBAAwB;IAiEtC;;OAEG;YACW,kBAAkB;IA2ChC;;OAEG;YACW,mBAAmB;IA4FjC;;OAEG;IACG,SAAS,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;IAUlD,aAAa,CAAC,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;IAKpE,kBAAkB,CAAC,CAAC,EACxB,KAAK,EAAE,WAAW,EAClB,MAAM,EAAE,MAAM,EACd,YAAY,SAAQ,GACnB,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;IA6BzB;;OAEG;IACG,kBAAkB,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;IAiB9E;;OAEG;YACW,qBAAqB;IA8CnC;;OAEG;IACH,OAAO,CAAC,KAAK;IAIb,OAAO,CAAC,iBAAiB;IAuBzB;;OAEG;IACH,sBAAsB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,EAAE,GAAG,SAAS;IAI7D,wBAAwB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAI9C,cAAc,IAAI,SAAS,EAAE;CAG9B"}