@robota-sdk/agent-core 3.0.0-beta.1

package/dist/interfaces/service.d.ts

@@ -0,0 +1,205 @@
+/**
+ * Service layer interfaces for the agents package
+ * Defines contracts for stateless service implementations
+ */
+import type { TUniversalMessage } from './messages';
+import type { IToolSchema, IAIProvider } from './provider';
+import type { TUniversalValue } from './types';
+import type { IToolCall } from './messages';
+import type { IOwnerPathSegment, IEventService } from './event-service';
+import type { TToolParameters, TToolMetadata } from './tool';
+/**
+ * Reusable type definitions for service layer
+ */
+/**
+ * Metadata type for conversation and execution context
+ * Used for storing additional information about conversations, responses, and execution
+ */
+export type TConversationContextMetadata = Record<string, string | number | boolean | Date>;
+/**
+ * Tool execution parameters type
+ * Used for passing parameters to tool execution methods
+ */
+export type TToolExecutionParameters = Record<string, string | number | boolean | string[] | number[] | boolean[]>;
+/**
+ * Execution metadata type
+ * Used for storing metadata about execution processes and options
+ */
+export type TExecutionMetadata = Record<string, string | number | boolean | Date>;
+/**
+ * Response metadata type
+ * Used for storing metadata about AI provider responses and streaming chunks
+ */
+export type TResponseMetadata = Record<string, string | number | boolean | Date>;
+/**
+ * Tool call data structure for function calls
+ */
+/**
+ * Tool execution request
+ */
+export interface IToolExecutionRequest {
+    toolName: string;
+    parameters: TToolParameters;
+    executionId?: string;
+    metadata?: TToolMetadata;
+    ownerType?: string;
+    ownerId?: string;
+    ownerPath?: IOwnerPathSegment[];
+    eventService?: IEventService;
+    baseEventService?: IEventService;
+}
+/**
+ * Conversation context containing messages and metadata
+ */
+export interface IConversationContext {
+    /** All messages in the conversation */
+    messages: TUniversalMessage[];
+    /** System message for the conversation */
+    systemMessage?: string;
+    /** Model to use for generation */
+    model: string;
+    /** Provider to use for generation */
+    provider: string;
+    /** Temperature for generation */
+    temperature?: number;
+    /** Maximum tokens to generate */
+    maxTokens?: number;
+    /** Available tools */
+    tools?: IToolSchema[];
+    /** Additional metadata */
+    metadata?: TConversationContextMetadata;
+}
+/**
+ * Response from AI provider
+ */
+export interface IConversationResponse {
+    /** Generated content */
+    content: string;
+    /** Tool calls if any */
+    toolCalls?: IToolCall[];
+    /** Usage statistics */
+    usage?: {
+        promptTokens: number;
+        completionTokens: number;
+        totalTokens: number;
+    };
+    /** Response metadata */
+    metadata?: TResponseMetadata;
+    /** Finish reason */
+    finishReason?: string;
+}
+/**
+ * Streaming response chunk
+ */
+export interface IStreamingChunk {
+    /** Content delta */
+    delta: string;
+    /** Whether this is the final chunk */
+    done: boolean;
+    /** Tool calls if any */
+    toolCalls?: IToolCall[];
+    /** Usage statistics (only in final chunk) */
+    usage?: {
+        promptTokens: number;
+        completionTokens: number;
+        totalTokens: number;
+    };
+}
+/**
+ * Service options for conversation operations
+ */
+export interface IConversationServiceOptions {
+    /** Maximum conversation history length */
+    maxHistoryLength?: number;
+    /** Whether to automatically retry on failure */
+    enableRetry?: boolean;
+    /** Maximum number of retries */
+    maxRetries?: number;
+    /** Retry delay in milliseconds */
+    retryDelay?: number;
+    /** Request timeout in milliseconds */
+    timeout?: number;
+}
+/**
+ * Context options for conversation preparation
+ */
+export interface IContextOptions {
+    systemMessage?: string;
+    temperature?: number;
+    maxTokens?: number;
+    tools?: IToolSchema[];
+    metadata?: TConversationContextMetadata;
+}
+/**
+ * Execution service options
+ */
+export interface IExecutionServiceOptions {
+    /** Maximum number of tool execution rounds */
+    maxToolRounds?: number;
+    /** Tool execution timeout */
+    toolTimeout?: number;
+    /** Whether to enable parallel tool execution */
+    enableParallelExecution?: boolean;
+    /** Additional execution metadata */
+    metadata?: TExecutionMetadata;
+}
+/**
+ * Interface for conversation service operations
+ * All methods should be stateless and pure functions
+ */
+export interface IConversationService {
+    /**
+     * Prepare conversation context from messages and configuration
+     * Pure function that transforms inputs to context object
+     */
+    prepareContext(messages: TUniversalMessage[], model: string, provider: string, contextOptions?: IContextOptions, serviceOptions?: IConversationServiceOptions): IConversationContext;
+    /**
+     * Generate a response using the AI provider
+     * Stateless operation that handles the full request-response cycle
+     */
+    generateResponse(provider: IAIProvider, context: IConversationContext, serviceOptions?: IConversationServiceOptions): Promise<IConversationResponse>;
+    /**
+     * Generate streaming response using the AI provider
+     * Stateless streaming operation
+     */
+    generateStreamingResponse(provider: IAIProvider, context: IConversationContext, serviceOptions?: IConversationServiceOptions): AsyncGenerator<IStreamingChunk, void, never>;
+    /**
+     * Validate conversation context
+     * Pure validation function
+     */
+    validateContext(context: IConversationContext): {
+        isValid: boolean;
+        errors: string[];
+    };
+}
+/**
+ * Interface for tool execution service operations
+ */
+export interface IToolExecutionService {
+    /**
+     * Execute a single tool
+     */
+    executeTool(toolName: string, parameters: TToolParameters): Promise<TUniversalValue>;
+    /**
+     * Execute multiple tools in parallel
+     */
+    executeToolsParallel(toolCalls: IToolExecutionRequest[]): Promise<TUniversalValue[]>;
+    /**
+     * Execute multiple tools sequentially
+     */
+    executeToolsSequential(toolCalls: IToolExecutionRequest[]): Promise<TUniversalValue[]>;
+}
+/**
+ * Interface for execution service operations
+ */
+export interface IExecutionService {
+    /**
+     * Execute complete agent pipeline
+     */
+    execute(input: string, context: IConversationContext, options?: IExecutionServiceOptions): Promise<string>;
+    /**
+     * Execute streaming agent pipeline
+     */
+    executeStream(input: string, context: IConversationContext, options?: IExecutionServiceOptions): AsyncGenerator<string, void, never>;
+}
+//# sourceMappingURL=service.d.ts.map

package/dist/interfaces/service.d.ts.map

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

package/dist/interfaces/service.js

@@ -0,0 +1,6 @@
+/**
+ * Service layer interfaces for the agents package
+ * Defines contracts for stateless service implementations
+ */
+export {};
+//# sourceMappingURL=service.js.map

package/dist/interfaces/service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.js","sourceRoot":"","sources":["../../src/interfaces/service.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/dist/interfaces/tool.d.ts

@@ -0,0 +1,248 @@
+import type { IToolSchema } from './provider';
+import type { IEventService, IOwnerPathSegment } from './event-service';
+import type { TContextData, TLoggerData, TToolParameters, TUniversalValue } from './types';
+export type { TToolParameters } from './types';
+export type TToolContextExtensionValue = TUniversalValue | Date | Error | TLoggerData | TContextData | TToolParameters | TToolMetadata;
+/**
+ * Tool metadata structure - specific type definition
+ */
+export type TToolMetadata = Record<string, string | number | boolean | string[] | number[] | boolean[] | TToolParameters>;
+/**
+ * Tool execution data - domain payload for tool results.
+ *
+ * IMPORTANT:
+ * - This must support structured tool outputs without resorting to `any`.
+ * - Prefer `ToolResultData` (derived from the canonical `UniversalValue` axis).
+ */
+/**
+ * Tool execution result - extended for ToolExecutionData compatibility
+ */
+export interface IToolResult {
+    success: boolean;
+    data?: TUniversalValue;
+    error?: string;
+    metadata?: TToolMetadata;
+    [key: string]: TToolContextExtensionValue | undefined;
+}
+/**
+ * Enhanced tool execution result with additional metadata
+ */
+export interface IToolExecutionResult {
+    /** Whether execution was successful */
+    success: boolean;
+    /** Tool name that was executed */
+    toolName?: string;
+    /** Execution result or data */
+    result?: TUniversalValue;
+    /** Error message if execution failed */
+    error?: string;
+    /** Execution duration in milliseconds */
+    duration?: number;
+    /** Unique execution ID */
+    executionId?: string;
+    /** Additional metadata */
+    metadata?: TToolMetadata;
+}
+/**
+ * Tool execution context - type-safe context for tool execution
+ * Enhanced with hierarchical execution tracking support
+ */
+export interface IToolExecutionContext {
+    toolName: string;
+    parameters: TToolParameters;
+    executionId?: string;
+    userId?: string;
+    sessionId?: string;
+    metadata?: TToolMetadata;
+    /** Parent execution ID for hierarchical tool execution tracking */
+    parentExecutionId?: string;
+    /** Root execution ID (Team/Agent level) for complete execution tree tracking */
+    rootExecutionId?: string;
+    /** Execution depth level (0: Team, 1: Agent, 2: Tool, etc.) */
+    executionLevel?: number;
+    /** Execution path array showing the complete execution hierarchy */
+    executionPath?: string[];
+    /** Real-time execution data for accurate tracking (no simulation) */
+    realTimeData?: {
+        /** Actual execution start time */
+        startTime: Date;
+        /** Actual input parameters passed to the tool */
+        actualParameters: TToolParameters;
+        /** Tool-provided estimated duration (optional) */
+        estimatedDuration?: number;
+    };
+    /**
+     * Additional tool execution context extensions.
+     *
+     * IMPORTANT:
+     * - Avoid ad-hoc top-level fields to keep the contract stable.
+     * - Use this map for forward-compatible extra data with constrained value types.
+     */
+    extensions?: Record<string, TToolContextExtensionValue>;
+    /** Owner context propagated from EventService */
+    ownerType?: string;
+    ownerId?: string;
+    ownerPath?: IOwnerPathSegment[];
+    sourceId?: string;
+    /**
+     * Tool-call scoped EventService instance.
+     * Caller (ExecutionService/ToolExecutionService) is responsible for providing
+     * an ownerPath-bound EventService for this tool call.
+     */
+    eventService?: IEventService;
+    /**
+     * Unbound base EventService instance.
+     *
+     * Required when a tool needs to create another owner-bound EventService
+     * for a different owner (e.g., creating an agent from a tool call).
+     *
+     * NOTE: Do not wrap an already owner-bound EventService to bind a different owner.
+     * Owner-bound instances must not be layered across different owners.
+     */
+    baseEventService?: IEventService;
+}
+/**
+ * Parameter validation result
+ */
+export interface IParameterValidationResult {
+    /** Whether parameters are valid */
+    isValid: boolean;
+    /** Validation error messages */
+    errors: string[];
+}
+/**
+ * Generic tool executor function
+ */
+export type TToolExecutor<TParams = TToolParameters, TResult = TUniversalValue> = (parameters: TParams, context?: IToolExecutionContext) => Promise<TResult>;
+/**
+ * OpenAPI specification configuration
+ */
+export interface IOpenAPIToolConfig {
+    /** OpenAPI 3.0 specification */
+    spec: {
+        openapi: string;
+        info: {
+            title: string;
+            version: string;
+            description?: string;
+        };
+        servers?: Array<{
+            url: string;
+            description?: string;
+        }>;
+        paths: Record<string, Record<string, string | number | boolean | Record<string, string | number | boolean>>>;
+        components?: Record<string, Record<string, string | number | boolean>>;
+    };
+    /** Operation ID from the OpenAPI spec */
+    operationId: string;
+    /** Base URL for API calls */
+    baseURL: string;
+    /** Authentication configuration */
+    auth?: {
+        type: 'bearer' | 'apiKey' | 'basic';
+        token?: string;
+        apiKey?: string;
+        header?: string;
+        username?: string;
+        password?: string;
+    };
+}
+/**
+ * MCP (Model Context Protocol) configuration
+ */
+export interface IMCPToolConfig {
+    /** MCP server endpoint */
+    endpoint: string;
+    /** Protocol version */
+    version?: string;
+    /** Authentication configuration */
+    auth?: {
+        type: 'bearer' | 'apiKey';
+        token: string;
+    };
+    /** Tool-specific configuration */
+    toolConfig?: Record<string, string | number | boolean>;
+    /** Timeout in milliseconds */
+    timeout?: number;
+}
+/**
+ * Base tool interface
+ */
+export interface ITool {
+    /** Tool schema */
+    schema: IToolSchema;
+    /**
+     * Execute the tool with given parameters
+     */
+    execute(parameters: TToolParameters, context?: IToolExecutionContext): Promise<IToolResult>;
+    /**
+     * Validate tool parameters
+     */
+    validate(parameters: TToolParameters): boolean;
+    /**
+     * Validate tool parameters with detailed result
+     */
+    validateParameters(parameters: TToolParameters): IParameterValidationResult;
+    /**
+     * Get tool description
+     */
+    getDescription(): string;
+}
+/**
+ * Function tool implementation
+ */
+export interface IFunctionTool extends ITool {
+    /** Function to execute */
+    fn: TToolExecutor;
+}
+/**
+ * Tool registry interface
+ */
+export interface IToolRegistry {
+    /**
+     * Register a tool
+     */
+    register(tool: ITool): void;
+    /**
+     * Unregister a tool
+     */
+    unregister(name: string): void;
+    /**
+     * Get tool by name
+     */
+    get(name: string): ITool | undefined;
+    /**
+     * Get all registered tools
+     */
+    getAll(): ITool[];
+    /**
+     * Get tool schemas
+     */
+    getSchemas(): IToolSchema[];
+    /**
+     * Check if tool exists
+     */
+    has(name: string): boolean;
+    /**
+     * Clear all tools
+     */
+    clear(): void;
+}
+/**
+ * Tool factory interface
+ */
+export interface IToolFactory {
+    /**
+     * Create function tool from schema and function
+     */
+    createFunctionTool(schema: IToolSchema, fn: TToolExecutor): IFunctionTool;
+    /**
+     * Create tool from OpenAPI specification
+     */
+    createOpenAPITool(config: IOpenAPIToolConfig): ITool;
+    /**
+     * Create MCP tool
+     */
+    createMCPTool(config: IMCPToolConfig): ITool;
+}
+//# sourceMappingURL=tool.d.ts.map

package/dist/interfaces/tool.d.ts.map

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

package/dist/interfaces/tool.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=tool.js.map

package/dist/interfaces/tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool.js","sourceRoot":"","sources":["../../src/interfaces/tool.ts"],"names":[],"mappings":""}

package/dist/interfaces/types.d.ts

@@ -0,0 +1,71 @@
+/**
+ * Agent-specific type definitions
+ * Local types for agent functionality - not forced to use base types unless needed for cross-connections
+ */
+import type { TUniversalMessage } from './messages';
+/**
+ * Primitive value types - foundation for all other types
+ * Extended to include null/undefined for agent contexts
+ */
+export type TPrimitiveValue = string | number | boolean | null | undefined;
+/**
+ * Universal value type axis (recursive, JSON-like + Date).
+ *
+ * IMPORTANT:
+ * - This axis is the single source of truth for payload/context/result values.
+ * - It must support nested objects/arrays without `any`/`unknown`.
+ */
+export type TUniversalValue = TPrimitiveValue | Date | TUniversalArrayValue | IUniversalObjectValue;
+export type TUniversalArrayValue = TUniversalValue[];
+export interface IUniversalObjectValue {
+    [key: string]: TUniversalValue;
+}
+/**
+ * Metadata type - consistent across agent components
+ */
+export type TMetadataValue = TPrimitiveValue | TUniversalArrayValue | Date;
+export type TMetadata = Record<string, TMetadataValue>;
+/**
+ * Context data type - for execution contexts
+ */
+export type TContextData = Record<string, TUniversalValue>;
+/**
+ * Logger data type - for logging contexts
+ */
+export type TLoggerData = Record<string, TUniversalValue | Date | Error>;
+/**
+ * Configuration types - for agent configuration
+ */
+export type TComplexConfigValue = Record<string, TPrimitiveValue | TUniversalArrayValue | IUniversalObjectValue>;
+export type TConfigValue = TPrimitiveValue | TUniversalArrayValue | IUniversalObjectValue | Array<TComplexConfigValue> | Array<Record<string, TPrimitiveValue | TUniversalArrayValue | IUniversalObjectValue>> | Array<TComplexConfigValue> | TComplexConfigValue;
+export type TConfigData = Record<string, TConfigValue>;
+/**
+ * Tool parameter value type - specific for tool parameters
+ */
+export type TToolParameters = Record<string, TUniversalValue>;
+/**
+ * Tool result data type - for tool execution results
+ */
+/**
+ * Plugin context type - for plugin execution contexts
+ */
+export interface IPluginContext {
+    input?: string;
+    response?: string;
+    messages?: TUniversalMessage[];
+    responseMessage?: TUniversalMessage;
+    metadata?: TMetadata;
+    error?: Error;
+    executionContext?: TContextData;
+}
+/**
+ * Type utility functions for safe type checking and validation
+ * @internal
+ */
+export declare const TypeUtils: {
+    isPrimitive: (value: TUniversalValue) => value is TPrimitiveValue;
+    isArray: (value: TUniversalValue) => value is TUniversalArrayValue;
+    isObject: (value: TUniversalValue) => value is IUniversalObjectValue;
+    isUniversalValue: (value: TUniversalValue) => value is TUniversalValue;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/interfaces/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/interfaces/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAEpD;;;GAGG;AACH,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,GAAG,SAAS,CAAC;AAE3E;;;;;;GAMG;AACH,MAAM,MAAM,eAAe,GACrB,eAAe,GACf,IAAI,GACJ,oBAAoB,GACpB,qBAAqB,CAAC;AAE5B,MAAM,MAAM,oBAAoB,GAAG,eAAe,EAAE,CAAC;AAErD,MAAM,WAAW,qBAAqB;IAClC,CAAC,GAAG,EAAE,MAAM,GAAG,eAAe,CAAC;CAClC;AAED;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,eAAe,GAAG,oBAAoB,GAAG,IAAI,CAAC;AAC3E,MAAM,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;AAEvD;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;AAE3D;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,eAAe,GAAG,IAAI,GAAG,KAAK,CAAC,CAAC;AAEzE;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAAG,MAAM,CAAC,MAAM,EAAE,eAAe,GAAG,oBAAoB,GAAG,qBAAqB,CAAC,CAAC;AACjH,MAAM,MAAM,YAAY,GAAG,eAAe,GAAG,oBAAoB,GAAG,qBAAqB,GAAG,KAAK,CAAC,mBAAmB,CAAC,GAAG,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,eAAe,GAAG,oBAAoB,GAAG,qBAAqB,CAAC,CAAC,GAAG,KAAK,CAAC,mBAAmB,CAAC,GAAG,mBAAmB,CAAC;AAClQ,MAAM,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;AAEvD;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;AAE9D;;GAEG;AASH;;GAEG;AACH,MAAM,WAAW,cAAc;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,iBAAiB,EAAE,CAAC;IAC/B,eAAe,CAAC,EAAE,iBAAiB,CAAC;IACpC,QAAQ,CAAC,EAAE,SAAS,CAAC;IACrB,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,gBAAgB,CAAC,EAAE,YAAY,CAAC;CACnC;AAED;;;GAGG;AACH,eAAO,MAAM,SAAS;yBACG,eAAe,KAAG,KAAK,IAAI,eAAe;qBAQ9C,eAAe,KAAG,KAAK,IAAI,oBAAoB;sBAI9C,eAAe,KAAG,KAAK,IAAI,qBAAqB;8BAQxC,eAAe,KAAG,KAAK,IAAI,eAAe;CAIvE,CAAC"}

package/dist/interfaces/types.js

@@ -0,0 +1,33 @@
+/**
+ * Agent-specific type definitions
+ * Local types for agent functionality - not forced to use base types unless needed for cross-connections
+ */
+/**
+ * Type utility functions for safe type checking and validation
+ * @internal
+ */
+export const TypeUtils = {
+    isPrimitive: (value) => {
+        return value === null ||
+            value === undefined ||
+            typeof value === 'string' ||
+            typeof value === 'number' ||
+            typeof value === 'boolean';
+    },
+    isArray: (value) => {
+        return Array.isArray(value) && value.every(item => TypeUtils.isUniversalValue(item));
+    },
+    isObject: (value) => {
+        return typeof value === 'object' &&
+            value !== null &&
+            !Array.isArray(value) &&
+            !(value instanceof Date) &&
+            Object.values(value).every(val => TypeUtils.isUniversalValue(val));
+    },
+    isUniversalValue: (value) => {
+        if (value instanceof Date)
+            return true;
+        return TypeUtils.isPrimitive(value) || TypeUtils.isArray(value) || TypeUtils.isObject(value);
+    }
+};
+//# sourceMappingURL=types.js.map

package/dist/interfaces/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/interfaces/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAiFH;;;GAGG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG;IACrB,WAAW,EAAE,CAAC,KAAsB,EAA4B,EAAE;QAC9D,OAAO,KAAK,KAAK,IAAI;YACjB,KAAK,KAAK,SAAS;YACnB,OAAO,KAAK,KAAK,QAAQ;YACzB,OAAO,KAAK,KAAK,QAAQ;YACzB,OAAO,KAAK,KAAK,SAAS,CAAC;IACnC,CAAC;IAED,OAAO,EAAE,CAAC,KAAsB,EAAiC,EAAE;QAC/D,OAAO,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,SAAS,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC,CAAC;IACzF,CAAC;IAED,QAAQ,EAAE,CAAC,KAAsB,EAAkC,EAAE;QACjE,OAAO,OAAO,KAAK,KAAK,QAAQ;YAC5B,KAAK,KAAK,IAAI;YACd,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;YACrB,CAAC,CAAC,KAAK,YAAY,IAAI,CAAC;YACxB,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,SAAS,CAAC,gBAAgB,CAAC,GAAG,CAAC,CAAC,CAAC;IAC3E,CAAC;IAED,gBAAgB,EAAE,CAAC,KAAsB,EAA4B,EAAE;QACnE,IAAI,KAAK,YAAY,IAAI;YAAE,OAAO,IAAI,CAAC;QACvC,OAAO,SAAS,CAAC,WAAW,CAAC,KAAK,CAAC,IAAI,SAAS,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,SAAS,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IACjG,CAAC;CACJ,CAAC"}