@lleverage-ai/agent-sdk 0.0.1

package/dist/middleware/apply.js

@@ -0,0 +1,219 @@
+/**
+ * Middleware application utilities.
+ *
+ * Applies middleware to collect hooks and manages middleware lifecycle.
+ *
+ * @packageDocumentation
+ */
+import { createMiddlewareContext } from "./context.js";
+/**
+ * Applies an array of middleware and returns the combined HookRegistration.
+ *
+ * Processes middleware in order, preserving hook registration order.
+ * Each middleware's hooks are added to the combined registration in the
+ * order the middleware appears in the array.
+ *
+ * @param middleware - Array of middleware to apply
+ * @returns Combined HookRegistration from all middleware
+ *
+ * @example
+ * ```typescript
+ * const middleware = [
+ *   createLoggingMiddleware({ transport: consoleTransport }),
+ *   createMetricsMiddleware({ registry }),
+ * ];
+ *
+ * const hooks = applyMiddleware(middleware);
+ * // hooks contains all hooks from both middleware
+ * ```
+ *
+ * @category Middleware
+ */
+export function applyMiddleware(middleware) {
+    if (middleware.length === 0) {
+        return {};
+    }
+    // Create a shared context that all middleware will register into
+    const { context, getHooks } = createMiddlewareContext();
+    // Let each middleware register its hooks
+    for (const mw of middleware) {
+        try {
+            mw.register(context);
+        }
+        catch (error) {
+            console.error(`Error registering middleware "${mw.name}":`, error);
+            // Continue with other middleware even if one fails
+        }
+    }
+    return getHooks();
+}
+/**
+ * Calls setup on all middleware that have a setup method.
+ *
+ * @param middleware - Array of middleware to setup
+ * @returns Promise that resolves when all setup is complete
+ *
+ * @category Middleware
+ */
+export async function setupMiddleware(middleware) {
+    const setupPromises = middleware
+        .filter((mw) => mw.setup !== undefined)
+        .map(async (mw) => {
+        try {
+            await mw.setup();
+        }
+        catch (error) {
+            console.error(`Error in middleware "${mw.name}" setup:`, error);
+        }
+    });
+    await Promise.all(setupPromises);
+}
+/**
+ * Calls teardown on all middleware that have a teardown method.
+ *
+ * @param middleware - Array of middleware to teardown
+ * @returns Promise that resolves when all teardown is complete
+ *
+ * @category Middleware
+ */
+export async function teardownMiddleware(middleware) {
+    const teardownPromises = middleware
+        .filter((mw) => mw.teardown !== undefined)
+        .map(async (mw) => {
+        try {
+            await mw.teardown();
+        }
+        catch (error) {
+            console.error(`Error in middleware "${mw.name}" teardown:`, error);
+        }
+    });
+    await Promise.all(teardownPromises);
+}
+/**
+ * Merges multiple HookRegistration objects into one.
+ *
+ * Hooks are concatenated in order for each event type. This allows
+ * combining hooks from middleware with explicitly provided hooks.
+ *
+ * @param registrations - HookRegistration objects to merge
+ * @returns Merged HookRegistration
+ *
+ * @example
+ * ```typescript
+ * const middlewareHooks = applyMiddleware(middleware);
+ * const explicitHooks = { PreToolUse: [{ matcher: "bash", hooks: [requireApproval] }] };
+ *
+ * const merged = mergeHooks(middlewareHooks, explicitHooks);
+ * // merged contains hooks from both, with middleware hooks first
+ * ```
+ *
+ * @category Middleware
+ */
+export function mergeHooks(...registrations) {
+    const result = {};
+    for (const reg of registrations) {
+        if (!reg)
+            continue;
+        // Merge generation hooks (arrays of HookCallback)
+        if (reg.PreGenerate) {
+            result.PreGenerate = [...(result.PreGenerate ?? []), ...reg.PreGenerate];
+        }
+        if (reg.PostGenerate) {
+            result.PostGenerate = [...(result.PostGenerate ?? []), ...reg.PostGenerate];
+        }
+        if (reg.PostGenerateFailure) {
+            result.PostGenerateFailure = [
+                ...(result.PostGenerateFailure ?? []),
+                ...reg.PostGenerateFailure,
+            ];
+        }
+        // Merge tool hooks (arrays of HookMatcher)
+        if (reg.PreToolUse) {
+            result.PreToolUse = mergeToolHooks(result.PreToolUse, reg.PreToolUse);
+        }
+        if (reg.PostToolUse) {
+            result.PostToolUse = mergeToolHooks(result.PostToolUse, reg.PostToolUse);
+        }
+        if (reg.PostToolUseFailure) {
+            result.PostToolUseFailure = mergeToolHooks(result.PostToolUseFailure, reg.PostToolUseFailure);
+        }
+        // Merge compaction hooks
+        if (reg.PreCompact) {
+            result.PreCompact = [...(result.PreCompact ?? []), ...reg.PreCompact];
+        }
+        if (reg.PostCompact) {
+            result.PostCompact = [...(result.PostCompact ?? []), ...reg.PostCompact];
+        }
+        // Merge session hooks
+        if (reg.SessionStart) {
+            result.SessionStart = [...(result.SessionStart ?? []), ...reg.SessionStart];
+        }
+        if (reg.SessionEnd) {
+            result.SessionEnd = [...(result.SessionEnd ?? []), ...reg.SessionEnd];
+        }
+        // Merge subagent hooks
+        if (reg.SubagentStart) {
+            result.SubagentStart = [...(result.SubagentStart ?? []), ...reg.SubagentStart];
+        }
+        if (reg.SubagentStop) {
+            result.SubagentStop = [...(result.SubagentStop ?? []), ...reg.SubagentStop];
+        }
+        // Merge MCP hooks
+        if (reg.MCPConnectionFailed) {
+            result.MCPConnectionFailed = [
+                ...(result.MCPConnectionFailed ?? []),
+                ...reg.MCPConnectionFailed,
+            ];
+        }
+        if (reg.MCPConnectionRestored) {
+            result.MCPConnectionRestored = [
+                ...(result.MCPConnectionRestored ?? []),
+                ...reg.MCPConnectionRestored,
+            ];
+        }
+        // Merge tool registry hooks
+        if (reg.ToolRegistered) {
+            result.ToolRegistered = [...(result.ToolRegistered ?? []), ...reg.ToolRegistered];
+        }
+        if (reg.ToolLoadError) {
+            result.ToolLoadError = [...(result.ToolLoadError ?? []), ...reg.ToolLoadError];
+        }
+    }
+    return result;
+}
+/**
+ * Merges tool hook matchers.
+ *
+ * Tool hooks use HookMatcher arrays which need special handling.
+ * Matchers with the same pattern have their hooks combined.
+ *
+ * @param existing - Existing tool hook matchers
+ * @param incoming - Incoming tool hook matchers
+ * @returns Merged tool hook matchers
+ *
+ * @internal
+ */
+function mergeToolHooks(existing, incoming) {
+    if (!existing) {
+        return [...incoming];
+    }
+    const result = [...existing];
+    for (const incomingMatcher of incoming) {
+        // Look for existing matcher with same pattern
+        const existingIndex = result.findIndex((m) => m.matcher === incomingMatcher.matcher);
+        if (existingIndex >= 0) {
+            // Merge hooks into existing matcher
+            const existingMatcher = result[existingIndex];
+            result[existingIndex] = {
+                ...existingMatcher,
+                hooks: [...existingMatcher.hooks, ...incomingMatcher.hooks],
+            };
+        }
+        else {
+            // Add new matcher
+            result.push(incomingMatcher);
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=apply.js.map

package/dist/middleware/apply.js.map

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

package/dist/middleware/context.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Middleware context implementation.
+ *
+ * Creates a context that collects hook registrations from middleware.
+ *
+ * @packageDocumentation
+ */
+import type { MiddlewareContextResult } from "./types.js";
+/**
+ * Creates a middleware context that collects hook registrations.
+ *
+ * The context provides methods for middleware to register hooks for various
+ * lifecycle events. Hooks are collected and can be retrieved as a
+ * HookRegistration object.
+ *
+ * @returns The context and a function to get the collected hooks
+ *
+ * @example
+ * ```typescript
+ * const { context, getHooks } = createMiddlewareContext();
+ *
+ * // Middleware registers hooks through the context
+ * middleware.register(context);
+ *
+ * // Get the collected hooks as HookRegistration
+ * const hooks = getHooks();
+ * ```
+ *
+ * @category Middleware
+ * @internal
+ */
+export declare function createMiddlewareContext(): MiddlewareContextResult;
+//# sourceMappingURL=context.d.ts.map

package/dist/middleware/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/middleware/context.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAqB,uBAAuB,EAAE,MAAM,YAAY,CAAC;AAE7E;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,uBAAuB,IAAI,uBAAuB,CA0KjE"}

package/dist/middleware/context.js

@@ -0,0 +1,176 @@
+/**
+ * Middleware context implementation.
+ *
+ * Creates a context that collects hook registrations from middleware.
+ *
+ * @packageDocumentation
+ */
+/**
+ * Creates a middleware context that collects hook registrations.
+ *
+ * The context provides methods for middleware to register hooks for various
+ * lifecycle events. Hooks are collected and can be retrieved as a
+ * HookRegistration object.
+ *
+ * @returns The context and a function to get the collected hooks
+ *
+ * @example
+ * ```typescript
+ * const { context, getHooks } = createMiddlewareContext();
+ *
+ * // Middleware registers hooks through the context
+ * middleware.register(context);
+ *
+ * // Get the collected hooks as HookRegistration
+ * const hooks = getHooks();
+ * ```
+ *
+ * @category Middleware
+ * @internal
+ */
+export function createMiddlewareContext() {
+    // Storage for collected hooks
+    const preGenerate = [];
+    const postGenerate = [];
+    const postGenerateFailure = [];
+    const preToolUse = [];
+    const postToolUse = [];
+    const postToolUseFailure = [];
+    const preCompact = [];
+    const postCompact = [];
+    const sessionStart = [];
+    const sessionEnd = [];
+    const subagentStart = [];
+    const subagentStop = [];
+    const mcpConnectionFailed = [];
+    const mcpConnectionRestored = [];
+    const interruptRequested = [];
+    const interruptResolved = [];
+    /**
+     * Helper to add a tool hook with optional matcher.
+     */
+    function addToolHook(storage, callback, matcher) {
+        // Find existing matcher or create new one
+        const existingMatcher = storage.find((m) => m.matcher === matcher);
+        if (existingMatcher) {
+            existingMatcher.hooks.push(callback);
+        }
+        else {
+            storage.push({
+                matcher,
+                hooks: [callback],
+            });
+        }
+    }
+    const context = {
+        onPreGenerate(callback) {
+            preGenerate.push(callback);
+        },
+        onPostGenerate(callback) {
+            postGenerate.push(callback);
+        },
+        onPostGenerateFailure(callback) {
+            postGenerateFailure.push(callback);
+        },
+        onPreToolUse(callback, matcher) {
+            addToolHook(preToolUse, callback, matcher);
+        },
+        onPostToolUse(callback, matcher) {
+            addToolHook(postToolUse, callback, matcher);
+        },
+        onPostToolUseFailure(callback, matcher) {
+            addToolHook(postToolUseFailure, callback, matcher);
+        },
+        onPreCompact(callback) {
+            preCompact.push(callback);
+        },
+        onPostCompact(callback) {
+            postCompact.push(callback);
+        },
+        onSessionStart(callback) {
+            sessionStart.push(callback);
+        },
+        onSessionEnd(callback) {
+            sessionEnd.push(callback);
+        },
+        onSubagentStart(callback) {
+            subagentStart.push(callback);
+        },
+        onSubagentStop(callback) {
+            subagentStop.push(callback);
+        },
+        onMCPConnectionFailed(callback) {
+            mcpConnectionFailed.push(callback);
+        },
+        onMCPConnectionRestored(callback) {
+            mcpConnectionRestored.push(callback);
+        },
+        onInterruptRequested(callback) {
+            interruptRequested.push(callback);
+        },
+        onInterruptResolved(callback) {
+            interruptResolved.push(callback);
+        },
+    };
+    function getHooks() {
+        const hooks = {};
+        // Add generation hooks if any were registered
+        if (preGenerate.length > 0) {
+            hooks.PreGenerate = preGenerate;
+        }
+        if (postGenerate.length > 0) {
+            hooks.PostGenerate = postGenerate;
+        }
+        if (postGenerateFailure.length > 0) {
+            hooks.PostGenerateFailure = postGenerateFailure;
+        }
+        // Add tool hooks if any were registered
+        if (preToolUse.length > 0) {
+            hooks.PreToolUse = preToolUse;
+        }
+        if (postToolUse.length > 0) {
+            hooks.PostToolUse = postToolUse;
+        }
+        if (postToolUseFailure.length > 0) {
+            hooks.PostToolUseFailure = postToolUseFailure;
+        }
+        // Add compaction hooks if any were registered
+        if (preCompact.length > 0) {
+            hooks.PreCompact = preCompact;
+        }
+        if (postCompact.length > 0) {
+            hooks.PostCompact = postCompact;
+        }
+        // Add session hooks if any were registered
+        if (sessionStart.length > 0) {
+            hooks.SessionStart = sessionStart;
+        }
+        if (sessionEnd.length > 0) {
+            hooks.SessionEnd = sessionEnd;
+        }
+        // Add subagent hooks if any were registered
+        if (subagentStart.length > 0) {
+            hooks.SubagentStart = subagentStart;
+        }
+        if (subagentStop.length > 0) {
+            hooks.SubagentStop = subagentStop;
+        }
+        // Add MCP hooks if any were registered
+        if (mcpConnectionFailed.length > 0) {
+            hooks.MCPConnectionFailed = mcpConnectionFailed;
+        }
+        if (mcpConnectionRestored.length > 0) {
+            hooks.MCPConnectionRestored = mcpConnectionRestored;
+        }
+        // Add interrupt hooks if any were registered
+        if (interruptRequested.length > 0) {
+            hooks.InterruptRequested = interruptRequested;
+        }
+        if (interruptResolved.length > 0) {
+            hooks.InterruptResolved = interruptResolved;
+        }
+        return hooks;
+    }
+    return { context, getHooks };
+}
+//# sourceMappingURL=context.js.map

package/dist/middleware/context.js.map

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

package/dist/middleware/index.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Middleware system for agent cross-cutting concerns.
+ *
+ * Middleware provides a clean API for adding features like logging, metrics,
+ * caching, and rate limiting to agents. Middleware wraps the underlying hook
+ * system with a more ergonomic interface.
+ *
+ * @example
+ * ```typescript
+ * import {
+ *   createAgent,
+ *   createLoggingMiddleware,
+ *   createConsoleTransport,
+ * } from "@lleverage-ai/agent-sdk";
+ *
+ * const agent = createAgent({
+ *   model,
+ *   middleware: [
+ *     createLoggingMiddleware({ transport: createConsoleTransport() }),
+ *   ],
+ * });
+ * ```
+ *
+ * @packageDocumentation
+ */
+export { applyMiddleware, mergeHooks, setupMiddleware, teardownMiddleware, } from "./apply.js";
+export { createMiddlewareContext } from "./context.js";
+export type { LoggingMiddlewareOptions } from "./logging.js";
+export { createLoggingMiddleware } from "./logging.js";
+export type { AgentMiddleware, MiddlewareContext, MiddlewareContextResult, } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/middleware/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/middleware/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAGH,OAAO,EACL,eAAe,EACf,UAAU,EACV,eAAe,EACf,kBAAkB,GACnB,MAAM,YAAY,CAAC;AAGpB,OAAO,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAC;AACvD,YAAY,EAAE,wBAAwB,EAAE,MAAM,cAAc,CAAC;AAG7D,OAAO,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAC;AAEvD,YAAY,EACV,eAAe,EACf,iBAAiB,EACjB,uBAAuB,GACxB,MAAM,YAAY,CAAC"}

package/dist/middleware/index.js

@@ -0,0 +1,32 @@
+/**
+ * Middleware system for agent cross-cutting concerns.
+ *
+ * Middleware provides a clean API for adding features like logging, metrics,
+ * caching, and rate limiting to agents. Middleware wraps the underlying hook
+ * system with a more ergonomic interface.
+ *
+ * @example
+ * ```typescript
+ * import {
+ *   createAgent,
+ *   createLoggingMiddleware,
+ *   createConsoleTransport,
+ * } from "@lleverage-ai/agent-sdk";
+ *
+ * const agent = createAgent({
+ *   model,
+ *   middleware: [
+ *     createLoggingMiddleware({ transport: createConsoleTransport() }),
+ *   ],
+ * });
+ * ```
+ *
+ * @packageDocumentation
+ */
+// Application utilities
+export { applyMiddleware, mergeHooks, setupMiddleware, teardownMiddleware, } from "./apply.js";
+// Context creation (internal)
+export { createMiddlewareContext } from "./context.js";
+// Built-in middleware
+export { createLoggingMiddleware } from "./logging.js";
+//# sourceMappingURL=index.js.map

package/dist/middleware/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/middleware/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,wBAAwB;AACxB,OAAO,EACL,eAAe,EACf,UAAU,EACV,eAAe,EACf,kBAAkB,GACnB,MAAM,YAAY,CAAC;AAEpB,8BAA8B;AAC9B,OAAO,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAC;AAGvD,sBAAsB;AACtB,OAAO,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAC"}

package/dist/middleware/logging.d.ts

@@ -0,0 +1,137 @@
+/**
+ * Logging middleware.
+ *
+ * Provides middleware for logging agent lifecycle events using the SDK's
+ * logging primitives. The middleware is transport-agnostic - users provide
+ * their own transport which determines where logs go.
+ *
+ * @packageDocumentation
+ */
+import type { LogLevel, LogTransport } from "../observability/logger.js";
+import type { AgentMiddleware } from "./types.js";
+/**
+ * Options for configuring logging middleware.
+ *
+ * @category Middleware
+ */
+export interface LoggingMiddlewareOptions {
+    /**
+     * Transport to write logs to.
+     *
+     * The transport determines where logs go - could be console, file,
+     * or streaming to a client. SDK is agnostic to the destination.
+     *
+     * @example
+     * ```typescript
+     * // Console logging
+     * import { createConsoleTransport } from "@lleverage-ai/agent-sdk";
+     * const transport = createConsoleTransport();
+     *
+     * // Custom transport (e.g., streaming to client)
+     * const streamTransport: LogTransport = {
+     *   name: "stream",
+     *   write: (entry) => res.write(JSON.stringify(entry) + "\n"),
+     * };
+     * ```
+     */
+    transport: LogTransport;
+    /**
+     * Log level for filtering events.
+     * @default "info"
+     */
+    level?: LogLevel;
+    /**
+     * Which events to log.
+     * @default all enabled
+     */
+    events?: {
+        /** Log generation start/end events */
+        generation?: boolean;
+        /** Log tool use events */
+        tools?: boolean;
+        /** Log context compaction events */
+        compaction?: boolean;
+        /** Log failure/error events */
+        failures?: boolean;
+        /** Log subagent events */
+        subagents?: boolean;
+        /** Log interrupt events (approval requests, custom interrupts) */
+        interrupts?: boolean;
+    };
+    /**
+     * Maximum content length for truncation.
+     * @default 500
+     */
+    maxContentLength?: number;
+    /**
+     * Include timing information in logs.
+     * @default true
+     */
+    includeTiming?: boolean;
+    /**
+     * Logger name for identification.
+     * @default "agent"
+     */
+    name?: string;
+}
+/**
+ * Creates logging middleware that logs agent lifecycle events.
+ *
+ * The transport determines where logs go - SDK is agnostic. If you want
+ * streaming to a client, create a transport that writes to your stream.
+ *
+ * @param options - Logging middleware configuration
+ * @returns AgentMiddleware instance
+ *
+ * @example
+ * ```typescript
+ * // Console logging
+ * import { createAgent, createLoggingMiddleware, createConsoleTransport } from "@lleverage-ai/agent-sdk";
+ *
+ * const agent = createAgent({
+ *   model,
+ *   middleware: [
+ *     createLoggingMiddleware({ transport: createConsoleTransport() }),
+ *   ],
+ * });
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // Custom transport (e.g., streaming to client)
+ * const streamTransport: LogTransport = {
+ *   name: "client-stream",
+ *   write: (entry) => {
+ *     // User decides how to get this to the client
+ *     res.write(`data: ${JSON.stringify(entry)}\n\n`);
+ *   },
+ * };
+ *
+ * const agent = createAgent({
+ *   model,
+ *   middleware: [
+ *     createLoggingMiddleware({ transport: streamTransport }),
+ *   ],
+ * });
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // External service (e.g., Datadog)
+ * const datadogTransport: LogTransport = {
+ *   name: "datadog",
+ *   write: (entry) => datadog.log(entry.level, entry.message, entry.context),
+ * };
+ *
+ * const agent = createAgent({
+ *   model,
+ *   middleware: [
+ *     createLoggingMiddleware({ transport: datadogTransport }),
+ *   ],
+ * });
+ * ```
+ *
+ * @category Middleware
+ */
+export declare function createLoggingMiddleware(options: LoggingMiddlewareOptions): AgentMiddleware;
+//# sourceMappingURL=logging.d.ts.map

package/dist/middleware/logging.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logging.d.ts","sourceRoot":"","sources":["../../src/middleware/logging.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAgBzE,OAAO,KAAK,EAAE,eAAe,EAAqB,MAAM,YAAY,CAAC;AAErE;;;;GAIG;AACH,MAAM,WAAW,wBAAwB;IACvC;;;;;;;;;;;;;;;;;;OAkBG;IACH,SAAS,EAAE,YAAY,CAAC;IAExB;;;OAGG;IACH,KAAK,CAAC,EAAE,QAAQ,CAAC;IAEjB;;;OAGG;IACH,MAAM,CAAC,EAAE;QACP,sCAAsC;QACtC,UAAU,CAAC,EAAE,OAAO,CAAC;QACrB,0BAA0B;QAC1B,KAAK,CAAC,EAAE,OAAO,CAAC;QAChB,oCAAoC;QACpC,UAAU,CAAC,EAAE,OAAO,CAAC;QACrB,+BAA+B;QAC/B,QAAQ,CAAC,EAAE,OAAO,CAAC;QACnB,0BAA0B;QAC1B,SAAS,CAAC,EAAE,OAAO,CAAC;QACpB,kEAAkE;QAClE,UAAU,CAAC,EAAE,OAAO,CAAC;KACtB,CAAC;IAEF;;;OAGG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAE1B;;;OAGG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;IAExB;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAsBD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0DG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,wBAAwB,GAAG,eAAe,CA6V1F"}