@nobulex/sdk 0.1.0

package/dist/adapters/express.js.map

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

package/dist/adapters/index.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Framework adapters for the Stele SDK.
+ *
+ * Re-exports all adapter factories and their associated types for
+ * Express/HTTP, Vercel AI SDK, and LangChain integrations.
+ *
+ * @packageDocumentation
+ */
+export { steleMiddleware, steleGuardHandler, createCovenantRouter, createWellKnownHandler, kovaGatewayMiddleware, } from './express.js';
+export type { IncomingRequest, OutgoingResponse, NextFunction, SteleMiddlewareOptions, SteleGuardHandlerOptions, CovenantRouterOptions, CovenantRouter, AsyncHandler, WellKnownOptions, KovaGatewayOptions, } from './express.js';
+export { SteleAccessDeniedError, withStele, withSteleTools, createToolGuard, } from './vercel-ai.js';
+export type { ToolLike, SteleToolOptions, } from './vercel-ai.js';
+export { SteleCallbackHandler, withSteleTool, createChainGuard, } from './langchain.js';
+export type { LangChainToolLike, SteleLangChainOptions, CallbackEvent, } from './langchain.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/adapters/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,EACL,eAAe,EACf,iBAAiB,EACjB,oBAAoB,EACpB,sBAAsB,EACtB,qBAAqB,GACtB,MAAM,cAAc,CAAC;AAEtB,YAAY,EACV,eAAe,EACf,gBAAgB,EAChB,YAAY,EACZ,sBAAsB,EACtB,wBAAwB,EACxB,qBAAqB,EACrB,cAAc,EACd,YAAY,EACZ,gBAAgB,EAChB,kBAAkB,GACnB,MAAM,cAAc,CAAC;AAItB,OAAO,EACL,sBAAsB,EACtB,SAAS,EACT,cAAc,EACd,eAAe,GAChB,MAAM,gBAAgB,CAAC;AAExB,YAAY,EACV,QAAQ,EACR,gBAAgB,GACjB,MAAM,gBAAgB,CAAC;AAIxB,OAAO,EACL,oBAAoB,EACpB,aAAa,EACb,gBAAgB,GACjB,MAAM,gBAAgB,CAAC;AAExB,YAAY,EACV,iBAAiB,EACjB,qBAAqB,EACrB,aAAa,GACd,MAAM,gBAAgB,CAAC"}

package/dist/adapters/index.js

@@ -0,0 +1,15 @@
+/**
+ * Framework adapters for the Stele SDK.
+ *
+ * Re-exports all adapter factories and their associated types for
+ * Express/HTTP, Vercel AI SDK, and LangChain integrations.
+ *
+ * @packageDocumentation
+ */
+// ─── Express / HTTP adapter ──────────────────────────────────────────────────
+export { steleMiddleware, steleGuardHandler, createCovenantRouter, createWellKnownHandler, kovaGatewayMiddleware, } from './express.js';
+// ─── Vercel AI SDK adapter ───────────────────────────────────────────────────
+export { SteleAccessDeniedError, withStele, withSteleTools, createToolGuard, } from './vercel-ai.js';
+// ─── LangChain adapter ──────────────────────────────────────────────────────
+export { SteleCallbackHandler, withSteleTool, createChainGuard, } from './langchain.js';
+//# sourceMappingURL=index.js.map

package/dist/adapters/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/adapters/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,gFAAgF;AAEhF,OAAO,EACL,eAAe,EACf,iBAAiB,EACjB,oBAAoB,EACpB,sBAAsB,EACtB,qBAAqB,GACtB,MAAM,cAAc,CAAC;AAetB,gFAAgF;AAEhF,OAAO,EACL,sBAAsB,EACtB,SAAS,EACT,cAAc,EACd,eAAe,GAChB,MAAM,gBAAgB,CAAC;AAOxB,+EAA+E;AAE/E,OAAO,EACL,oBAAoB,EACpB,aAAa,EACb,gBAAgB,GACjB,MAAM,gBAAgB,CAAC"}

package/dist/adapters/langchain.d.ts

@@ -0,0 +1,183 @@
+/**
+ * Stele adapter for LangChain.
+ *
+ * Provides a callback handler that logs agent actions to the Stele
+ * audit trail, and tool/chain wrappers that enforce covenant constraints
+ * before execution.
+ *
+ * @packageDocumentation
+ *
+ * @example
+ * ```typescript
+ * import { SteleClient, SteleCallbackHandler, withSteleTool } from '@nobulex/sdk';
+ *
+ * const handler = new SteleCallbackHandler({ client, covenant });
+ * const protectedTool = withSteleTool(myTool, { client, covenant });
+ * ```
+ */
+import type { SteleClient } from '../index.js';
+import type { CovenantDocument } from '@nobulex/core';
+import type { EvaluationResult } from '../types.js';
+export { SteleAccessDeniedError } from './vercel-ai.js';
+/**
+ * Minimal tool shape compatible with LangChain's BaseTool.
+ *
+ * Supports the three method patterns found in the LangChain ecosystem:
+ * - `call(input)` -- the public API in LangChain JS
+ * - `invoke(input)` -- the LCEL (LangChain Expression Language) API
+ * - `_call(input)` -- the internal/protected implementation method
+ */
+export interface LangChainToolLike {
+    /** The tool name, used for default action/resource derivation. */
+    name: string;
+    /** Optional description of what the tool does. */
+    description?: string;
+    /** LangChain public call method. */
+    call?: (input: unknown) => Promise<unknown>;
+    /** LCEL invoke method. */
+    invoke?: (input: unknown) => Promise<unknown>;
+    /** Internal implementation method. */
+    _call?: (input: unknown) => Promise<unknown>;
+    /** Allow additional properties. */
+    [key: string]: unknown;
+}
+/**
+ * Options for wrapping LangChain tools with Stele enforcement.
+ */
+export interface SteleLangChainOptions {
+    /** The SteleClient instance for covenant evaluation. */
+    client: SteleClient;
+    /** The covenant document whose constraints are enforced. */
+    covenant: CovenantDocument;
+    /**
+     * Custom function to derive the CCL action string from a tool and its input.
+     * Defaults to `tool.name`.
+     */
+    actionFromTool?: (tool: LangChainToolLike, input: unknown) => string;
+    /**
+     * Custom function to derive the CCL resource string from a tool and its input.
+     * Defaults to `'/' + tool.name`.
+     */
+    resourceFromTool?: (tool: LangChainToolLike, input: unknown) => string;
+    /**
+     * Custom handler invoked when a tool call is denied. If provided,
+     * its return value is returned instead of throwing. If not provided,
+     * a `SteleAccessDeniedError` is thrown.
+     */
+    onDenied?: (tool: LangChainToolLike, result: EvaluationResult) => unknown;
+}
+/** A recorded event from the SteleCallbackHandler audit trail. */
+export interface CallbackEvent {
+    /** The event type (e.g. 'tool:start', 'chain:end', 'tool:error'). */
+    type: string;
+    /** Payload data associated with the event. */
+    data: Record<string, unknown>;
+    /** ISO 8601 timestamp of when the event was recorded. */
+    timestamp: string;
+}
+/**
+ * A LangChain-compatible callback handler that records agent actions
+ * to a Stele audit trail.
+ *
+ * This handler does not enforce constraints; it only observes and
+ * logs. Use it alongside `withSteleTool` for enforcement + auditing.
+ *
+ * @example
+ * ```typescript
+ * const handler = new SteleCallbackHandler({ client, covenant });
+ * await handler.handleToolStart({ name: 'search' }, 'query');
+ * console.log(handler.events); // [{ type: 'tool:start', ... }]
+ * ```
+ */
+export declare class SteleCallbackHandler {
+    /** The SteleClient used for event emission. */
+    readonly client: SteleClient;
+    /** The covenant document being audited. */
+    readonly covenant: CovenantDocument;
+    /** Ordered list of recorded events. */
+    readonly events: CallbackEvent[];
+    constructor(options: {
+        client: SteleClient;
+        covenant: CovenantDocument;
+    });
+    /**
+     * Record a tool invocation start event.
+     *
+     * @param tool  - The tool being invoked.
+     * @param input - The input passed to the tool.
+     */
+    handleToolStart(tool: {
+        name: string;
+    }, input: unknown): Promise<void>;
+    /**
+     * Record a tool invocation completion event.
+     *
+     * @param output - The output produced by the tool.
+     */
+    handleToolEnd(output: unknown): Promise<void>;
+    /**
+     * Record a tool invocation error event.
+     *
+     * @param error - The error that occurred.
+     */
+    handleToolError(error: Error): Promise<void>;
+    /**
+     * Record a chain execution start event.
+     *
+     * @param chain  - The chain being executed.
+     * @param inputs - The inputs passed to the chain.
+     */
+    handleChainStart(chain: {
+        name?: string;
+    }, inputs: unknown): Promise<void>;
+    /**
+     * Record a chain execution completion event.
+     *
+     * @param outputs - The outputs produced by the chain.
+     */
+    handleChainEnd(outputs: unknown): Promise<void>;
+    /**
+     * Record a chain execution error event.
+     *
+     * @param error - The error that occurred.
+     */
+    handleChainError(error: Error): Promise<void>;
+}
+/**
+ * Wrap a LangChain-style tool with Stele covenant enforcement.
+ *
+ * Wraps all three call patterns (`call`, `invoke`, `_call`) when present.
+ * Before delegation, evaluates the action/resource against the covenant.
+ * If denied, throws a `SteleAccessDeniedError` (or invokes `onDenied`).
+ *
+ * @param tool    - The LangChain tool to wrap.
+ * @param options - Enforcement options including client and covenant.
+ * @returns A new tool with guarded call methods.
+ *
+ * @example
+ * ```typescript
+ * const protectedTool = withSteleTool(searchTool, { client, covenant });
+ * await protectedTool.invoke('my query'); // throws if denied
+ * ```
+ */
+export declare function withSteleTool<T extends LangChainToolLike>(tool: T, options: SteleLangChainOptions): T;
+/**
+ * Create a reusable guard for LangChain chain runs.
+ *
+ * Returns an async function that evaluates the chain name as both
+ * the action and resource before delegating to the provided function.
+ *
+ * @param options - Enforcement options.
+ * @returns An async function `(chainName, input, fn) => Promise<unknown>`
+ *          that enforces the covenant before executing the chain function.
+ *
+ * @example
+ * ```typescript
+ * const guard = createChainGuard({ client, covenant });
+ * const result = await guard('read', 'my input', async () => {
+ *   return runChain();
+ * });
+ * ```
+ */
+export declare function createChainGuard(options: SteleLangChainOptions): (chainName: string, input: unknown, fn: () => Promise<unknown>) => Promise<unknown>;
+//# sourceMappingURL=langchain.d.ts.map

package/dist/adapters/langchain.d.ts.map

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

package/dist/adapters/langchain.js

@@ -0,0 +1,203 @@
+/**
+ * Stele adapter for LangChain.
+ *
+ * Provides a callback handler that logs agent actions to the Stele
+ * audit trail, and tool/chain wrappers that enforce covenant constraints
+ * before execution.
+ *
+ * @packageDocumentation
+ *
+ * @example
+ * ```typescript
+ * import { SteleClient, SteleCallbackHandler, withSteleTool } from '@nobulex/sdk';
+ *
+ * const handler = new SteleCallbackHandler({ client, covenant });
+ * const protectedTool = withSteleTool(myTool, { client, covenant });
+ * ```
+ */
+import { SteleAccessDeniedError } from './vercel-ai.js';
+// Re-export the shared error so consumers can import from either adapter
+export { SteleAccessDeniedError } from './vercel-ai.js';
+// ─── SteleCallbackHandler ────────────────────────────────────────────────────
+/**
+ * A LangChain-compatible callback handler that records agent actions
+ * to a Stele audit trail.
+ *
+ * This handler does not enforce constraints; it only observes and
+ * logs. Use it alongside `withSteleTool` for enforcement + auditing.
+ *
+ * @example
+ * ```typescript
+ * const handler = new SteleCallbackHandler({ client, covenant });
+ * await handler.handleToolStart({ name: 'search' }, 'query');
+ * console.log(handler.events); // [{ type: 'tool:start', ... }]
+ * ```
+ */
+export class SteleCallbackHandler {
+    /** The SteleClient used for event emission. */
+    client;
+    /** The covenant document being audited. */
+    covenant;
+    /** Ordered list of recorded events. */
+    events = [];
+    constructor(options) {
+        this.client = options.client;
+        this.covenant = options.covenant;
+    }
+    /**
+     * Record a tool invocation start event.
+     *
+     * @param tool  - The tool being invoked.
+     * @param input - The input passed to the tool.
+     */
+    async handleToolStart(tool, input) {
+        this.events.push({
+            type: 'tool:start',
+            data: { tool: tool.name, input },
+            timestamp: new Date().toISOString(),
+        });
+    }
+    /**
+     * Record a tool invocation completion event.
+     *
+     * @param output - The output produced by the tool.
+     */
+    async handleToolEnd(output) {
+        this.events.push({
+            type: 'tool:end',
+            data: { output },
+            timestamp: new Date().toISOString(),
+        });
+    }
+    /**
+     * Record a tool invocation error event.
+     *
+     * @param error - The error that occurred.
+     */
+    async handleToolError(error) {
+        this.events.push({
+            type: 'tool:error',
+            data: { error: error.message },
+            timestamp: new Date().toISOString(),
+        });
+    }
+    /**
+     * Record a chain execution start event.
+     *
+     * @param chain  - The chain being executed.
+     * @param inputs - The inputs passed to the chain.
+     */
+    async handleChainStart(chain, inputs) {
+        this.events.push({
+            type: 'chain:start',
+            data: { chain: chain.name, inputs },
+            timestamp: new Date().toISOString(),
+        });
+    }
+    /**
+     * Record a chain execution completion event.
+     *
+     * @param outputs - The outputs produced by the chain.
+     */
+    async handleChainEnd(outputs) {
+        this.events.push({
+            type: 'chain:end',
+            data: { outputs },
+            timestamp: new Date().toISOString(),
+        });
+    }
+    /**
+     * Record a chain execution error event.
+     *
+     * @param error - The error that occurred.
+     */
+    async handleChainError(error) {
+        this.events.push({
+            type: 'chain:error',
+            data: { error: error.message },
+            timestamp: new Date().toISOString(),
+        });
+    }
+}
+// ─── withSteleTool ───────────────────────────────────────────────────────────
+/**
+ * Wrap a LangChain-style tool with Stele covenant enforcement.
+ *
+ * Wraps all three call patterns (`call`, `invoke`, `_call`) when present.
+ * Before delegation, evaluates the action/resource against the covenant.
+ * If denied, throws a `SteleAccessDeniedError` (or invokes `onDenied`).
+ *
+ * @param tool    - The LangChain tool to wrap.
+ * @param options - Enforcement options including client and covenant.
+ * @returns A new tool with guarded call methods.
+ *
+ * @example
+ * ```typescript
+ * const protectedTool = withSteleTool(searchTool, { client, covenant });
+ * await protectedTool.invoke('my query'); // throws if denied
+ * ```
+ */
+export function withSteleTool(tool, options) {
+    const { client, covenant, actionFromTool, resourceFromTool, onDenied } = options;
+    const wrapped = { ...tool };
+    const guard = async (input, originalFn) => {
+        const action = actionFromTool ? actionFromTool(tool, input) : tool.name;
+        const resource = resourceFromTool ? resourceFromTool(tool, input) : '/' + tool.name;
+        const result = await client.evaluateAction(covenant, action, resource);
+        if (!result.permitted) {
+            if (onDenied) {
+                return onDenied(tool, result);
+            }
+            throw new SteleAccessDeniedError(`Action '${action}' on resource '${resource}' denied by covenant`, result);
+        }
+        return originalFn.call(tool, input);
+    };
+    if (tool.call) {
+        const originalCall = tool.call;
+        wrapped.call = (input) => guard(input, originalCall);
+    }
+    if (tool.invoke) {
+        const originalInvoke = tool.invoke;
+        wrapped.invoke = (input) => guard(input, originalInvoke);
+    }
+    if (tool._call) {
+        const original_call = tool._call;
+        wrapped._call = (input) => guard(input, original_call);
+    }
+    return wrapped;
+}
+// ─── createChainGuard ────────────────────────────────────────────────────────
+/**
+ * Create a reusable guard for LangChain chain runs.
+ *
+ * Returns an async function that evaluates the chain name as both
+ * the action and resource before delegating to the provided function.
+ *
+ * @param options - Enforcement options.
+ * @returns An async function `(chainName, input, fn) => Promise<unknown>`
+ *          that enforces the covenant before executing the chain function.
+ *
+ * @example
+ * ```typescript
+ * const guard = createChainGuard({ client, covenant });
+ * const result = await guard('read', 'my input', async () => {
+ *   return runChain();
+ * });
+ * ```
+ */
+export function createChainGuard(options) {
+    const { client, covenant, onDenied } = options;
+    return async (chainName, input, fn) => {
+        const action = chainName;
+        const resource = '/' + chainName;
+        const result = await client.evaluateAction(covenant, action, resource);
+        if (!result.permitted) {
+            if (onDenied) {
+                return onDenied({ name: chainName }, result);
+            }
+            throw new SteleAccessDeniedError(`Chain '${chainName}' on resource '${resource}' denied by covenant`, result);
+        }
+        return fn();
+    };
+}
+//# sourceMappingURL=langchain.js.map

package/dist/adapters/langchain.js.map

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

package/dist/adapters/vercel-ai.d.ts

@@ -0,0 +1,122 @@
+/**
+ * Stele adapter for Vercel AI SDK.
+ *
+ * Wraps AI SDK tool definitions with covenant enforcement.
+ * Before a tool's `execute()` is called, the action/resource pair is
+ * evaluated against the covenant's CCL constraints. If denied, a
+ * `SteleAccessDeniedError` is thrown (or the custom `onDenied` handler
+ * is invoked). If permitted, the original `execute()` runs normally.
+ *
+ * @packageDocumentation
+ *
+ * @example
+ * ```typescript
+ * import { SteleClient, withStele, withSteleTools } from '@nobulex/sdk';
+ *
+ * const protectedTool = withStele(myTool, { client, covenant });
+ * const protectedTools = withSteleTools({ search, browse }, { client, covenant });
+ * ```
+ */
+import type { SteleClient } from '../index.js';
+import type { CovenantDocument } from '@nobulex/core';
+import type { EvaluationResult } from '../types.js';
+/**
+ * Error thrown when a tool call is denied by a Stele covenant.
+ *
+ * Carries the full `EvaluationResult` so callers can inspect the
+ * matched rule, severity, and reason for the denial.
+ */
+export declare class SteleAccessDeniedError extends Error {
+    /** The evaluation result that triggered the denial. */
+    readonly evaluationResult: EvaluationResult;
+    constructor(message: string, result: EvaluationResult);
+}
+/**
+ * Minimal tool shape compatible with the Vercel AI SDK.
+ *
+ * Only `execute` is required for wrapping; `name` and `description`
+ * are used for default action/resource derivation.
+ */
+export interface ToolLike {
+    name?: string;
+    description?: string;
+    execute?: (...args: unknown[]) => Promise<unknown>;
+    [key: string]: unknown;
+}
+/**
+ * Options for wrapping Vercel AI SDK tools with Stele enforcement.
+ */
+export interface SteleToolOptions {
+    /** The SteleClient instance for covenant evaluation. */
+    client: SteleClient;
+    /** The covenant document whose constraints are enforced. */
+    covenant: CovenantDocument;
+    /**
+     * Custom function to derive the CCL action string from a tool and its args.
+     * Defaults to `tool.name ?? 'execute'`.
+     */
+    actionFromTool?: (tool: ToolLike, args: unknown[]) => string;
+    /**
+     * Custom function to derive the CCL resource string from a tool and its args.
+     * Defaults to `'/' + (tool.name ?? 'unknown')`.
+     */
+    resourceFromTool?: (tool: ToolLike, args: unknown[]) => string;
+    /**
+     * Custom handler invoked when a tool call is denied. If provided,
+     * its return value is returned instead of throwing. If not provided,
+     * a `SteleAccessDeniedError` is thrown.
+     */
+    onDenied?: (tool: ToolLike, result: EvaluationResult) => unknown;
+}
+/**
+ * Wrap a single Vercel AI SDK tool with Stele covenant enforcement.
+ *
+ * Returns a new tool object whose `execute()` evaluates the
+ * action/resource against the covenant before delegating to the
+ * original implementation.
+ *
+ * @param tool    - The tool to wrap.
+ * @param options - Enforcement options including client and covenant.
+ * @returns A new tool with a guarded `execute()` method.
+ *
+ * @example
+ * ```typescript
+ * const protectedTool = withStele(myTool, { client, covenant });
+ * await protectedTool.execute('arg1'); // throws if denied
+ * ```
+ */
+export declare function withStele<T extends ToolLike>(tool: T, options: SteleToolOptions): T;
+/**
+ * Wrap an array of tools with Stele covenant enforcement.
+ *
+ * @param tools   - Array of tools to wrap.
+ * @param options - Enforcement options.
+ * @returns A new array of wrapped tools.
+ */
+export declare function withSteleTools(tools: ToolLike[], options: SteleToolOptions): ToolLike[];
+/**
+ * Wrap a record of tools with Stele covenant enforcement.
+ *
+ * @param tools   - Record of named tools to wrap.
+ * @param options - Enforcement options.
+ * @returns A new record with the same keys and wrapped tool values.
+ */
+export declare function withSteleTools(tools: Record<string, ToolLike>, options: SteleToolOptions): Record<string, ToolLike>;
+/**
+ * Create a reusable guard function that enforces a covenant on any tool call.
+ *
+ * Unlike `withStele` which returns a new tool, `createToolGuard` returns a
+ * function you call manually, passing the tool and arguments each time.
+ *
+ * @param options - Enforcement options.
+ * @returns An async function `(tool, ...args) => Promise<unknown>` that
+ *          evaluates the covenant and delegates to `tool.execute()`.
+ *
+ * @example
+ * ```typescript
+ * const guard = createToolGuard({ client, covenant });
+ * const result = await guard(myTool, 'arg1', 'arg2');
+ * ```
+ */
+export declare function createToolGuard(options: SteleToolOptions): (tool: ToolLike, ...args: unknown[]) => Promise<unknown>;
+//# sourceMappingURL=vercel-ai.d.ts.map

package/dist/adapters/vercel-ai.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vercel-ai.d.ts","sourceRoot":"","sources":["../../src/adapters/vercel-ai.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACtD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAIpD;;;;;GAKG;AACH,qBAAa,sBAAuB,SAAQ,KAAK;IAC/C,uDAAuD;IACvD,QAAQ,CAAC,gBAAgB,EAAE,gBAAgB,CAAC;gBAEhC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,gBAAgB;CAKtD;AAID;;;;;GAKG;AACH,MAAM,WAAW,QAAQ;IACvB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IACnD,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,wDAAwD;IACxD,MAAM,EAAE,WAAW,CAAC;IACpB,4DAA4D;IAC5D,QAAQ,EAAE,gBAAgB,CAAC;IAC3B;;;OAGG;IACH,cAAc,CAAC,EAAE,CAAC,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,MAAM,CAAC;IAC7D;;;OAGG;IACH,gBAAgB,CAAC,EAAE,CAAC,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,MAAM,CAAC;IAC/D;;;;OAIG;IACH,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,gBAAgB,KAAK,OAAO,CAAC;CAClE;AAID;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,SAAS,CAAC,CAAC,SAAS,QAAQ,EAAE,IAAI,EAAE,CAAC,EAAE,OAAO,EAAE,gBAAgB,GAAG,CAAC,CAkCnF;AAID;;;;;;GAMG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE,QAAQ,EAAE,EACjB,OAAO,EAAE,gBAAgB,GACxB,QAAQ,EAAE,CAAC;AAEd;;;;;;GAMG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,EAC/B,OAAO,EAAE,gBAAgB,GACxB,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;AAmB5B;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,eAAe,CAC7B,OAAO,EAAE,gBAAgB,GACxB,CAAC,IAAI,EAAE,QAAQ,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,CAAC,OAAO,CAAC,CA6B1D"}