@melara/sdk 0.0.0-stage → 0.1.0

package/esm/lib/tool-event-broadcaster.js

@@ -0,0 +1,146 @@
+/**
+ * A push-based event broadcaster that supports multiple concurrent consumers.
+ * Similar to ReusableReadableStream but for push-based events from tool execution.
+ *
+ * Each consumer gets their own position in the buffer and receives all events
+ * from their join point onward. This enables real-time streaming of generator
+ * tool preliminary results to multiple consumers simultaneously.
+ *
+ * @template T - The event type being broadcast
+ */
+export class ToolEventBroadcaster {
+    constructor() {
+        this.buffer = [];
+        this.consumers = new Map();
+        this.nextConsumerId = 0;
+        this.isComplete = false;
+        this.completionError = null;
+    }
+    /**
+     * Push a new event to all consumers.
+     * Events are buffered so late-joining consumers can catch up.
+     */
+    push(event) {
+        if (this.isComplete) {
+            return;
+        }
+        this.buffer.push(event);
+        this.notifyWaitingConsumers();
+    }
+    /**
+     * Mark the broadcaster as complete - no more events will be pushed.
+     * Optionally pass an error to signal failure to all consumers.
+     * Cleans up buffer and consumers after completion.
+     */
+    complete(error) {
+        this.isComplete = true;
+        this.completionError = error ?? null;
+        this.notifyWaitingConsumers();
+        // Schedule cleanup after consumers have processed completion
+        queueMicrotask(() => this.cleanup());
+    }
+    /**
+     * Clean up resources after all consumers have finished.
+     * Called automatically after complete(), but can be called manually.
+     */
+    cleanup() {
+        // Only cleanup if complete and all consumers are done
+        if (this.isComplete && this.consumers.size === 0) {
+            this.buffer = [];
+        }
+    }
+    /**
+     * Create a new consumer that can independently iterate over events.
+     * Consumers can join at any time and will receive events from position 0.
+     * Multiple consumers can be created and will all receive the same events.
+     */
+    createConsumer() {
+        const consumerId = this.nextConsumerId++;
+        const state = {
+            position: 0,
+            waitingPromise: null,
+            cancelled: false,
+        };
+        this.consumers.set(consumerId, state);
+        // eslint-disable-next-line @typescript-eslint/no-this-alias
+        const self = this;
+        return {
+            async next() {
+                const consumer = self.consumers.get(consumerId);
+                if (!consumer) {
+                    return { done: true, value: undefined };
+                }
+                if (consumer.cancelled) {
+                    return { done: true, value: undefined };
+                }
+                // Return buffered event if available
+                if (consumer.position < self.buffer.length) {
+                    const value = self.buffer[consumer.position];
+                    consumer.position++;
+                    return { done: false, value };
+                }
+                // If complete and caught up, we're done
+                if (self.isComplete) {
+                    self.consumers.delete(consumerId);
+                    self.cleanup();
+                    if (self.completionError) {
+                        throw self.completionError;
+                    }
+                    return { done: true, value: undefined };
+                }
+                // Set up waiting promise FIRST to avoid race condition
+                const waitPromise = new Promise((resolve, reject) => {
+                    consumer.waitingPromise = { resolve, reject };
+                    // Immediately check if we should resolve after setting up promise
+                    if (self.isComplete ||
+                        self.completionError ||
+                        consumer.position < self.buffer.length) {
+                        resolve();
+                    }
+                });
+                await waitPromise;
+                consumer.waitingPromise = null;
+                // Recursively try again after waking up
+                return this.next();
+            },
+            async return() {
+                const consumer = self.consumers.get(consumerId);
+                if (consumer) {
+                    consumer.cancelled = true;
+                    self.consumers.delete(consumerId);
+                    self.cleanup();
+                }
+                return { done: true, value: undefined };
+            },
+            async throw(e) {
+                const consumer = self.consumers.get(consumerId);
+                if (consumer) {
+                    consumer.cancelled = true;
+                    self.consumers.delete(consumerId);
+                    self.cleanup();
+                }
+                throw e;
+            },
+            [Symbol.asyncIterator]() {
+                return this;
+            },
+        };
+    }
+    /**
+     * Notify all waiting consumers that new data is available or stream completed
+     */
+    notifyWaitingConsumers() {
+        for (const consumer of this.consumers.values()) {
+            if (consumer.waitingPromise) {
+                if (this.completionError) {
+                    consumer.waitingPromise.reject(this.completionError);
+                }
+                else {
+                    consumer.waitingPromise.resolve();
+                }
+                consumer.waitingPromise = null;
+            }
+        }
+    }
+}
+//# sourceMappingURL=tool-event-broadcaster.js.map

package/esm/lib/tool-event-broadcaster.js.map

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

package/esm/lib/tool-executor.d.ts

@@ -0,0 +1,74 @@
+import type { $ZodType } from 'zod/v4/core';
+import type { $ZodObject, $ZodShape } from 'zod/v4/core';
+import type { APITool, ParsedToolCall, Tool, ToolExecutionResult, TurnContext } from './tool-types.js';
+import * as z4 from 'zod/v4';
+import { type ToolContextStore } from './tool-context.js';
+export declare const ZodError: z4.z.core.$constructor<z4.ZodError<unknown>, z4.z.core.$ZodIssue[]>;
+/**
+ * Recursively remove keys prefixed with ~ from an object.
+ * These are metadata properties (like ~standard from Standard Schema)
+ * that should not be sent to downstream providers.
+ * @see https://github.com/Melara/typescript-sdk/issues/131
+ *
+ * When given a Record<string, unknown>, returns Record<string, unknown>.
+ * When given unknown, returns unknown (preserves primitives, null, etc).
+ */
+export declare function sanitizeJsonSchema(obj: Record<string, unknown>): Record<string, unknown>;
+export declare function sanitizeJsonSchema(obj: unknown): unknown;
+/**
+ * Convert a Zod schema to JSON Schema using Zod v4's toJSONSchema function.
+ * Accepts ZodType from the main zod package for user compatibility.
+ * The resulting schema is sanitized to remove metadata properties (like ~standard)
+ * that would cause 400 errors with downstream providers.
+ */
+export declare function convertZodToJsonSchema(zodSchema: $ZodType): Record<string, unknown>;
+/**
+ * Convert tools to Melara API format
+ * Accepts readonly arrays for better type compatibility
+ */
+export declare function convertToolsToAPIFormat(tools: readonly Tool[]): APITool[];
+/**
+ * Validate tool input against Zod schema
+ * @throws ZodError if validation fails
+ */
+export declare function validateToolInput<T>(schema: $ZodType<T>, args: unknown): T;
+/**
+ * Validate tool output against Zod schema
+ * @throws ZodError if validation fails
+ */
+export declare function validateToolOutput<T>(schema: $ZodType<T>, result: unknown): T;
+/**
+ * Parse tool call arguments from JSON string.
+ * Treats empty/whitespace-only strings as an empty object ,  some providers
+ * return `arguments: ""` for tools that take no parameters.
+ */
+export declare function parseToolCallArguments(argumentsString: string): unknown;
+/**
+ * Execute a regular (non-generator) tool
+ */
+export declare function executeRegularTool(tool: Tool, toolCall: ParsedToolCall<Tool>, context: TurnContext, contextStore?: ToolContextStore, sharedSchema?: $ZodObject<$ZodShape>): Promise<ToolExecutionResult<Tool>>;
+/**
+ * Execute a generator tool and collect preliminary and final results
+ * - Intermediate yields are validated against eventSchema (preliminary events)
+ * - Last yield is validated against outputSchema (final result sent to model)
+ * - Generator must emit at least one value
+ */
+export declare function executeGeneratorTool(tool: Tool, toolCall: ParsedToolCall<Tool>, context: TurnContext, onPreliminaryResult?: (toolCallId: string, result: unknown) => void, contextStore?: ToolContextStore, sharedSchema?: $ZodObject<$ZodShape>): Promise<ToolExecutionResult<Tool>>;
+/**
+ * Execute a tool call
+ * Automatically detects if it's a regular or generator tool
+ */
+export declare function executeTool(tool: Tool, toolCall: ParsedToolCall<Tool>, context: TurnContext, onPreliminaryResult?: (toolCallId: string, result: unknown) => void, contextStore?: ToolContextStore, sharedSchema?: $ZodObject<$ZodShape>): Promise<ToolExecutionResult<Tool>>;
+/**
+ * Find a tool by name in the tools array
+ */
+export declare function findToolByName(tools: Tool[], name: string): Tool | undefined;
+/**
+ * Format tool execution result as a string for sending to the model
+ */
+export declare function formatToolResultForModel(result: ToolExecutionResult<Tool>): string;
+/**
+ * Create a user-friendly error message for tool execution errors
+ */
+export declare function formatToolExecutionError(error: Error, toolCall: ParsedToolCall<Tool>): string;
+//# sourceMappingURL=tool-executor.d.ts.map

package/esm/lib/tool-executor.d.ts.map

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

package/esm/lib/tool-executor.js

@@ -0,0 +1,269 @@
+// Modified by Melara for the Melara SDK fork.
+import { en } from "../locales/en.js";
+import * as z4 from 'zod/v4';
+import { hasExecuteFunction, isGeneratorTool, isRegularExecuteTool } from './tool-types.js';
+import { buildToolExecuteContext } from './tool-context.js';
+// Re-export ZodError for convenience
+export const ZodError = z4.ZodError;
+/**
+ * Typeguard to check if a value is a non-null object (not an array).
+ */
+function isNonNullObject(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+export function sanitizeJsonSchema(obj) {
+    if (obj === null || typeof obj !== 'object') {
+        return obj;
+    }
+    if (Array.isArray(obj)) {
+        return obj.map(sanitizeJsonSchema);
+    }
+    // At this point, obj is a non-null, non-array object
+    // Use typeguard to narrow the type for type-safe property access
+    if (!isNonNullObject(obj)) {
+        return obj;
+    }
+    const result = {};
+    for (const key of Object.keys(obj)) {
+        if (!key.startsWith('~')) {
+            result[key] = sanitizeJsonSchema(obj[key]);
+        }
+    }
+    return result;
+}
+/**
+ * Typeguard to check if a value is a valid Zod schema compatible with zod/v4.
+ * Zod schemas have a _zod property that contains schema metadata.
+ */
+function isZodSchema(value) {
+    if (typeof value !== 'object' || value === null) {
+        return false;
+    }
+    if (!('_zod' in value)) {
+        return false;
+    }
+    // After the 'in' check, TypeScript knows value has _zod property
+    return typeof value._zod === 'object';
+}
+/**
+ * Convert a Zod schema to JSON Schema using Zod v4's toJSONSchema function.
+ * Accepts ZodType from the main zod package for user compatibility.
+ * The resulting schema is sanitized to remove metadata properties (like ~standard)
+ * that would cause 400 errors with downstream providers.
+ */
+export function convertZodToJsonSchema(zodSchema) {
+    if (!isZodSchema(zodSchema)) {
+        throw new Error(en.invalidZodSchemaProvided);
+    }
+    // Use draft-7 as it's closest to OpenAPI 3.0's JSON Schema variant
+    const jsonSchema = z4.toJSONSchema(zodSchema, {
+        target: 'draft-7',
+    });
+    // jsonSchema is always a Record<string, unknown> from toJSONSchema
+    // The overloaded sanitizeJsonSchema preserves this type
+    return sanitizeJsonSchema(jsonSchema);
+}
+/**
+ * Convert tools to Melara API format
+ * Accepts readonly arrays for better type compatibility
+ */
+export function convertToolsToAPIFormat(tools) {
+    return tools.map((tool) => ({
+        type: 'function',
+        name: tool.function.name,
+        description: tool.function.description || null,
+        strict: null,
+        parameters: convertZodToJsonSchema(tool.function.inputSchema),
+    }));
+}
+/**
+ * Validate tool input against Zod schema
+ * @throws ZodError if validation fails
+ */
+export function validateToolInput(schema, args) {
+    return z4.parse(schema, args);
+}
+/**
+ * Validate tool output against Zod schema
+ * @throws ZodError if validation fails
+ */
+export function validateToolOutput(schema, result) {
+    return z4.parse(schema, result);
+}
+/**
+ * Try to validate a value against a Zod schema without throwing
+ * @returns true if validation succeeds, false otherwise
+ */
+function tryValidate(schema, value) {
+    const result = z4.safeParse(schema, value);
+    return result.success;
+}
+/**
+ * Parse tool call arguments from JSON string.
+ * Treats empty/whitespace-only strings as an empty object ,  some providers
+ * return `arguments: ""` for tools that take no parameters.
+ */
+export function parseToolCallArguments(argumentsString) {
+    const trimmed = argumentsString.trim();
+    if (!trimmed) {
+        return {};
+    }
+    try {
+        return JSON.parse(trimmed);
+    }
+    catch (error) {
+        throw new Error(en.failedToParseToolCallArguments(error instanceof Error ? error.message : String(error)));
+    }
+}
+/**
+ * Build a ToolExecuteContext for a tool from a TurnContext and optional context store
+ */
+function buildExecuteCtx(tool, turnContext, contextStore, sharedSchema) {
+    return buildToolExecuteContext(turnContext, contextStore, tool.function.name, tool.function.contextSchema, sharedSchema);
+}
+/**
+ * Execute a regular (non-generator) tool
+ */
+export async function executeRegularTool(tool, toolCall, context, contextStore, sharedSchema) {
+    if (!isRegularExecuteTool(tool)) {
+        throw new Error(en.toolIsNotARegularExecuteToolOrHas(toolCall.name));
+    }
+    try {
+        const validatedInput = validateToolInput(tool.function.inputSchema, toolCall.arguments);
+        const executeContext = buildExecuteCtx(tool, context, contextStore, sharedSchema);
+        // Execute tool with context
+        const result = await Promise.resolve(tool.function.execute(validatedInput, executeContext));
+        // Validate output if schema is provided
+        if (tool.function.outputSchema) {
+            const validatedOutput = validateToolOutput(tool.function.outputSchema, result);
+            return {
+                toolCallId: toolCall.id,
+                toolName: toolCall.name,
+                result: validatedOutput,
+            };
+        }
+        return {
+            toolCallId: toolCall.id,
+            toolName: toolCall.name,
+            result,
+        };
+    }
+    catch (error) {
+        return {
+            toolCallId: toolCall.id,
+            toolName: toolCall.name,
+            result: null,
+            error: error instanceof Error ? error : new Error(String(error)),
+        };
+    }
+}
+/**
+ * Execute a generator tool and collect preliminary and final results
+ * - Intermediate yields are validated against eventSchema (preliminary events)
+ * - Last yield is validated against outputSchema (final result sent to model)
+ * - Generator must emit at least one value
+ */
+export async function executeGeneratorTool(tool, toolCall, context, onPreliminaryResult, contextStore, sharedSchema) {
+    if (!isGeneratorTool(tool)) {
+        throw new Error(en.toolIsNotAGeneratorTool(toolCall.name));
+    }
+    try {
+        const validatedInput = validateToolInput(tool.function.inputSchema, toolCall.arguments);
+        const executeContext = buildExecuteCtx(tool, context, contextStore, sharedSchema);
+        const preliminaryResults = [];
+        let finalResult;
+        let hasFinalResult = false;
+        let lastEmittedValue;
+        let hasEmittedValue = false;
+        const iterator = tool.function.execute(validatedInput, executeContext);
+        let iterResult = await iterator.next();
+        while (!iterResult.done) {
+            const event = iterResult.value;
+            lastEmittedValue = event;
+            hasEmittedValue = true;
+            const matchesOutputSchema = tryValidate(tool.function.outputSchema, event);
+            const matchesEventSchema = tryValidate(tool.function.eventSchema, event);
+            if (matchesOutputSchema && !matchesEventSchema && !hasFinalResult) {
+                finalResult = validateToolOutput(tool.function.outputSchema, event);
+                hasFinalResult = true;
+            }
+            else {
+                const validatedPreliminary = validateToolOutput(tool.function.eventSchema, event);
+                preliminaryResults.push(validatedPreliminary);
+                if (onPreliminaryResult) {
+                    onPreliminaryResult(toolCall.id, validatedPreliminary);
+                }
+            }
+            iterResult = await iterator.next();
+        }
+        if (iterResult.value !== undefined) {
+            finalResult = validateToolOutput(tool.function.outputSchema, iterResult.value);
+            hasFinalResult = true;
+        }
+        if (!hasFinalResult) {
+            if (!hasEmittedValue) {
+                throw new Error(en.generatorToolCompletedWithoutEmittingAnyValuesOrReturning(toolCall.name));
+            }
+            finalResult = validateToolOutput(tool.function.outputSchema, lastEmittedValue);
+        }
+        return {
+            toolCallId: toolCall.id,
+            toolName: toolCall.name,
+            result: finalResult,
+            preliminaryResults,
+        };
+    }
+    catch (error) {
+        return {
+            toolCallId: toolCall.id,
+            toolName: toolCall.name,
+            result: null,
+            error: error instanceof Error ? error : new Error(String(error)),
+        };
+    }
+}
+/**
+ * Execute a tool call
+ * Automatically detects if it's a regular or generator tool
+ */
+export async function executeTool(tool, toolCall, context, onPreliminaryResult, contextStore, sharedSchema) {
+    if (!hasExecuteFunction(tool)) {
+        throw new Error(en.toolHasNoExecuteFunctionUseManualToolExecution(toolCall.name));
+    }
+    if (isGeneratorTool(tool)) {
+        return executeGeneratorTool(tool, toolCall, context, onPreliminaryResult, contextStore, sharedSchema);
+    }
+    return executeRegularTool(tool, toolCall, context, contextStore, sharedSchema);
+}
+/**
+ * Find a tool by name in the tools array
+ */
+export function findToolByName(tools, name) {
+    return tools.find((tool) => tool.function.name === name);
+}
+/**
+ * Format tool execution result as a string for sending to the model
+ */
+export function formatToolResultForModel(result) {
+    if (result.error) {
+        return JSON.stringify({
+            error: result.error.message,
+            toolName: result.toolName,
+        });
+    }
+    return JSON.stringify(result.result);
+}
+/**
+ * Create a user-friendly error message for tool execution errors
+ */
+export function formatToolExecutionError(error, toolCall) {
+    if (error instanceof ZodError) {
+        const issues = error.issues.map((issue) => ({
+            path: issue.path.join('.'),
+            message: issue.message,
+        }));
+        return en.toolValidationError(toolCall.name, JSON.stringify(issues, null, 2));
+    }
+    return en.toolExecutionError(toolCall.name, error.message);
+}
+//# sourceMappingURL=tool-executor.js.map

package/esm/lib/tool-executor.js.map

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

package/esm/lib/tool-orchestrator.d.ts

@@ -0,0 +1,52 @@
+import type { InputsUnion } from '../models/inputsunion.js';
+import type { OpenResponsesResult } from '../models/openresponsesresult.js';
+import type { ResponsesRequest } from '../models/responsesrequest.js';
+import type { APITool, Tool, ToolExecutionResult } from './tool-types.js';
+/**
+ * Options for tool execution
+ */
+export interface ToolExecutionOptions {
+    onPreliminaryResult?: (toolCallId: string, result: unknown) => void;
+}
+/**
+ * Result of the tool execution loop
+ */
+export interface ToolOrchestrationResult {
+    finalResponse: OpenResponsesResult;
+    allResponses: OpenResponsesResult[];
+    toolExecutionResults: ToolExecutionResult<Tool>[];
+    conversationInput: InputsUnion;
+}
+/**
+ * Execute tool calls and manage multi-turn conversations
+ * This orchestrates the loop of: request -> tool calls -> execute -> send results -> repeat
+ *
+ * @param sendRequest - Function to send a request and get a response
+ * @param initialInput - Starting input for the conversation
+ * @param initialRequest - Full initial request with all parameters
+ * @param tools - Enhanced tools with Zod schemas and execute functions
+ * @param apiTools - Converted tools in API format (JSON Schema)
+ * @param options - Execution options
+ * @returns Result containing final response and all execution data
+ */
+export declare function executeToolLoop(sendRequest: (input: InputsUnion, tools: APITool[]) => Promise<OpenResponsesResult>, initialInput: InputsUnion, initialRequest: ResponsesRequest, tools: Tool[], apiTools: APITool[], options?: ToolExecutionOptions): Promise<ToolOrchestrationResult>;
+/**
+ * Convert tool execution results to a map for easy lookup
+ */
+export declare function toolResultsToMap(results: ToolExecutionResult<Tool>[]): Map<string, {
+    result: unknown;
+    preliminaryResults?: unknown[];
+}>;
+/**
+ * Build a summary of tool executions for debugging/logging
+ */
+export declare function summarizeToolExecutions(results: ToolExecutionResult<Tool>[]): string;
+/**
+ * Check if any tool executions had errors
+ */
+export declare function hasToolExecutionErrors(results: ToolExecutionResult<Tool>[]): boolean;
+/**
+ * Get all tool execution errors
+ */
+export declare function getToolExecutionErrors(results: ToolExecutionResult<Tool>[]): Error[];
+//# sourceMappingURL=tool-orchestrator.d.ts.map

package/esm/lib/tool-orchestrator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-orchestrator.d.ts","sourceRoot":"","sources":["../../src/lib/tool-orchestrator.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AAE5E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AACtE,OAAO,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAS1E;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,mBAAmB,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,KAAK,IAAI,CAAC;CACrE;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,aAAa,EAAE,mBAAmB,CAAC;IACnC,YAAY,EAAE,mBAAmB,EAAE,CAAC;IACpC,oBAAoB,EAAE,mBAAmB,CAAC,IAAI,CAAC,EAAE,CAAC;IAClD,iBAAiB,EAAE,WAAW,CAAC;CAChC;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,eAAe,CACnC,WAAW,EAAE,CACX,KAAK,EAAE,WAAW,EAClB,KAAK,EAAE,OAAO,EAAE,KACb,OAAO,CAAC,mBAAmB,CAAC,EACjC,YAAY,EAAE,WAAW,EACzB,cAAc,EAAE,gBAAgB,EAChC,KAAK,EAAE,IAAI,EAAE,EACb,QAAQ,EAAE,OAAO,EAAE,EACnB,OAAO,GAAE,oBAAyB,GACjC,OAAO,CAAC,uBAAuB,CAAC,CAmJlC;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,mBAAmB,CAAC,IAAI,CAAC,EAAE,GAAG,GAAG,CACzE,MAAM,EACN;IACE,MAAM,EAAE,OAAO,CAAC;IAChB,kBAAkB,CAAC,EAAE,OAAO,EAAE,CAAC;CAChC,CACF,CAWA;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,mBAAmB,CAAC,IAAI,CAAC,EAAE,GAAG,MAAM,CAcpF;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,mBAAmB,CAAC,IAAI,CAAC,EAAE,GAAG,OAAO,CAEpF;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,mBAAmB,CAAC,IAAI,CAAC,EAAE,GAAG,KAAK,EAAE,CAMpF"}