@prefactor/sdk 0.1.3 → 0.1.5

package/dist/instrumentation/langchain/middleware.js

@@ -1,181 +0,0 @@
-import { SpanContext } from '../../tracing/context.js';
-import { SpanType } from '../../tracing/span.js';
-import { extractTokenUsage } from './metadata-extractor.js';
-/**
- * Prefactor middleware for LangChain.js agents.
- *
- * This middleware automatically traces LLM calls, tool executions, and agent workflows.
- * It integrates with LangChain.js middleware API to provide transparent instrumentation.
- *
- * Features:
- * - Automatic parent-child span relationships via context propagation
- * - Token usage extraction for LLM calls
- * - Error tracking and debugging
- * - Zero-overhead instrumentation (graceful failure)
- *
- * @example
- * ```typescript
- * import { init } from '@prefactor/sdk';
- * import { createReactAgent } from '@langchain/langgraph/prebuilt';
- *
- * const middleware = init();
- * const agent = createReactAgent({
- *   llm: model,
- *   tools: [myTool],
- *   middleware: [middleware],
- * });
- * ```
- */
-export class PrefactorMiddleware {
-    tracer;
-    rootSpan = null;
-    constructor(tracer) {
-        this.tracer = tracer;
-    }
-    /**
-     * Called before agent execution starts
-     *
-     * @param state - Agent state containing messages
-     */
-    // biome-ignore lint/suspicious/noExplicitAny: LangChain state can be any structure
-    async beforeAgent(state) {
-        const parentSpan = SpanContext.getCurrent();
-        const messages = state?.messages ?? [];
-        this.tracer.startAgentInstance();
-        const span = this.tracer.startSpan({
-            name: 'agent',
-            spanType: SpanType.AGENT,
-            inputs: { messages: messages.slice(-3).map((m) => String(m)) },
-            parentSpanId: parentSpan?.spanId,
-            traceId: parentSpan?.traceId,
-        });
-        this.rootSpan = span;
-    }
-    /**
-     * Called after agent execution completes
-     *
-     * @param state - Agent state containing messages
-     */
-    // biome-ignore lint/suspicious/noExplicitAny: LangChain state can be any structure
-    async afterAgent(state) {
-        if (!this.rootSpan) {
-            return;
-        }
-        const messages = state?.messages ?? [];
-        this.tracer.endSpan(this.rootSpan, {
-            outputs: { messages: messages.slice(-3).map((m) => String(m)) },
-        });
-        this.tracer.finishAgentInstance();
-        SpanContext.clear();
-        this.rootSpan = null;
-    }
-    /**
-     * Wrap a model call to trace LLM invocations
-     *
-     * @param request - Model invocation request
-     * @param handler - The actual model call function
-     * @returns Promise resolving to the model response
-     */
-    // biome-ignore lint/suspicious/noExplicitAny: LangChain request/handler types are dynamic
-    async wrapModelCall(request, handler) {
-        const parentSpan = SpanContext.getCurrent();
-        const span = this.tracer.startSpan({
-            name: this.extractModelName(request),
-            spanType: SpanType.LLM,
-            inputs: this.extractModelInputs(request),
-            parentSpanId: parentSpan?.spanId,
-            traceId: parentSpan?.traceId,
-        });
-        try {
-            // CRITICAL: Wrap handler in context so child operations see this span
-            const response = await SpanContext.runAsync(span, async () => {
-                return handler(request);
-            });
-            const outputs = this.extractModelOutputs(response);
-            const tokenUsage = extractTokenUsage(response);
-            this.tracer.endSpan(span, { outputs, tokenUsage: tokenUsage ?? undefined });
-            return response;
-        }
-        catch (error) {
-            this.tracer.endSpan(span, { error: error });
-            throw error;
-        }
-    }
-    /**
-     * Wrap a tool call to trace tool executions
-     *
-     * @param request - Tool invocation request
-     * @param handler - The actual tool call function
-     * @returns Promise resolving to the tool response
-     */
-    // biome-ignore lint/suspicious/noExplicitAny: LangChain request/handler types are dynamic
-    async wrapToolCall(request, handler) {
-        const parentSpan = SpanContext.getCurrent();
-        const span = this.tracer.startSpan({
-            name: this.extractToolName(request),
-            spanType: SpanType.TOOL,
-            inputs: this.extractToolInputs(request),
-            parentSpanId: parentSpan?.spanId,
-            traceId: parentSpan?.traceId,
-        });
-        try {
-            // CRITICAL: Wrap handler in context so child operations see this span
-            const response = await SpanContext.runAsync(span, async () => {
-                return handler(request);
-            });
-            this.tracer.endSpan(span, {
-                outputs: this.extractToolOutputs(response),
-            });
-            return response;
-        }
-        catch (error) {
-            this.tracer.endSpan(span, { error: error });
-            throw error;
-        }
-    }
-    /**
-     * Extract model name from request
-     */
-    // biome-ignore lint/suspicious/noExplicitAny: LangChain request structure is dynamic
-    extractModelName(request) {
-        return request?.model ?? request?.modelName ?? 'unknown';
-    }
-    /**
-     * Extract model inputs from request
-     */
-    // biome-ignore lint/suspicious/noExplicitAny: LangChain request structure is dynamic
-    extractModelInputs(request) {
-        const messages = request?.messages ?? [];
-        return { messages: messages.slice(-3).map((m) => String(m)) };
-    }
-    /**
-     * Extract model outputs from response
-     */
-    // biome-ignore lint/suspicious/noExplicitAny: LangChain response structure is dynamic
-    extractModelOutputs(response) {
-        const content = response?.content ?? response?.text ?? '';
-        return { content: String(content) };
-    }
-    /**
-     * Extract tool name from request
-     */
-    // biome-ignore lint/suspicious/noExplicitAny: LangChain request structure is dynamic
-    extractToolName(request) {
-        return request?.name ?? request?.tool ?? 'unknown';
-    }
-    /**
-     * Extract tool inputs from request
-     */
-    // biome-ignore lint/suspicious/noExplicitAny: LangChain request structure is dynamic
-    extractToolInputs(request) {
-        return { input: request?.input ?? request?.args ?? {} };
-    }
-    /**
-     * Extract tool outputs from response
-     */
-    // biome-ignore lint/suspicious/noExplicitAny: LangChain response structure is dynamic
-    extractToolOutputs(response) {
-        return { output: response?.output ?? response };
-    }
-}
-//# sourceMappingURL=middleware.js.map

package/dist/instrumentation/langchain/middleware.js.map

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

package/dist/package.json

@@ -1,56 +0,0 @@
-{
-  "name": "@prefactor/sdk",
-  "version": "0.1.3",
-  "description": "Automatic observability for LangChain.js agents",
-  "type": "module",
-  "main": "dist/index.cjs",
-  "module": "dist/index.js",
-  "types": "dist/index.d.ts",
-  "exports": {
-    ".": {
-      "types": "./dist/index.d.ts",
-      "import": "./dist/index.js",
-      "require": "./dist/index.cjs"
-    }
-  },
-  "files": [
-    "dist"
-  ],
-  "scripts": {
-    "build": "bun run scripts/build.ts",
-    "test": "bun test",
-    "test:watch": "bun test --watch",
-    "typecheck": "tsc --noEmit",
-    "lint": "biome check .",
-    "format": "biome format --write .",
-    "example:basic": "bun examples/basic.ts",
-    "example:anthropic": "bun examples/anthropic-agent/simple-agent.ts",
-    "prepublishOnly": "bun run build && bun run test && bun run typecheck"
-  },
-  "keywords": [
-    "prefactor",
-    "observability",
-    "tracing",
-    "langchain",
-    "llm",
-    "agent",
-    "monitoring"
-  ],
-  "author": "Prefactor",
-  "license": "MIT",
-  "dependencies": {
-    "@langchain/core": "^0.3.0",
-    "@prefactor/pfid": "^0.1.0",
-    "zod": "^3.23.0"
-  },
-  "devDependencies": {
-    "@biomejs/biome": "2.3.11",
-    "@types/node": "^20.0.0",
-    "bun-types": "latest",
-    "langchain": "^1.0.0",
-    "typescript": "^5.3.0"
-  },
-  "engines": {
-    "node": ">=18.0.0"
-  }
-}

package/dist/tracing/context.d.ts

@@ -1,53 +0,0 @@
-import type { Span } from './span.js';
-/**
- * SpanContext manages the current span in async execution contexts.
- * This enables automatic parent-child span relationships without manual tracking.
- *
- * Uses Node.js AsyncLocalStorage which provides async-safe context propagation.
- *
- * @example
- * ```typescript
- * const span = tracer.startSpan({ name: 'parent', ... });
- *
- * await SpanContext.runAsync(span, async () => {
- *   // Inside this function, getCurrent() returns the parent span
- *   const parent = SpanContext.getCurrent();
- *
- *   const child = tracer.startSpan({
- *     name: 'child',
- *     parentSpanId: parent?.spanId,
- *     traceId: parent?.traceId,
- *   });
- *   // ...
- * });
- * ```
- */
-export declare class SpanContext {
-    /**
-     * Get the current span from the async context
-     *
-     * @returns The current span, or undefined if no span is active
-     */
-    static getCurrent(): Span | undefined;
-    /**
-     * Run a synchronous function with the given span as the current context
-     *
-     * @param span - The span to set as current
-     * @param fn - The function to execute
-     * @returns The return value of the function
-     */
-    static run<T>(span: Span, fn: () => T): T;
-    /**
-     * Run an asynchronous function with the given span as the current context
-     *
-     * @param span - The span to set as current
-     * @param fn - The async function to execute
-     * @returns A promise resolving to the return value of the function
-     */
-    static runAsync<T>(span: Span, fn: () => Promise<T>): Promise<T>;
-    /**
-     * Clear the current context (primarily for testing)
-     */
-    static clear(): void;
-}
-//# sourceMappingURL=context.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/tracing/context.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAOtC;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,qBAAa,WAAW;IACtB;;;;OAIG;IACH,MAAM,CAAC,UAAU,IAAI,IAAI,GAAG,SAAS;IAIrC;;;;;;OAMG;IACH,MAAM,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC;IAIzC;;;;;;OAMG;WACU,QAAQ,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAItE;;OAEG;IACH,MAAM,CAAC,KAAK,IAAI,IAAI;CAGrB"}

package/dist/tracing/context.js

@@ -1,65 +0,0 @@
-import { AsyncLocalStorage } from 'node:async_hooks';
-/**
- * Storage for the current span in async context
- */
-const spanStorage = new AsyncLocalStorage();
-/**
- * SpanContext manages the current span in async execution contexts.
- * This enables automatic parent-child span relationships without manual tracking.
- *
- * Uses Node.js AsyncLocalStorage which provides async-safe context propagation.
- *
- * @example
- * ```typescript
- * const span = tracer.startSpan({ name: 'parent', ... });
- *
- * await SpanContext.runAsync(span, async () => {
- *   // Inside this function, getCurrent() returns the parent span
- *   const parent = SpanContext.getCurrent();
- *
- *   const child = tracer.startSpan({
- *     name: 'child',
- *     parentSpanId: parent?.spanId,
- *     traceId: parent?.traceId,
- *   });
- *   // ...
- * });
- * ```
- */
-export class SpanContext {
-    /**
-     * Get the current span from the async context
-     *
-     * @returns The current span, or undefined if no span is active
-     */
-    static getCurrent() {
-        return spanStorage.getStore();
-    }
-    /**
-     * Run a synchronous function with the given span as the current context
-     *
-     * @param span - The span to set as current
-     * @param fn - The function to execute
-     * @returns The return value of the function
-     */
-    static run(span, fn) {
-        return spanStorage.run(span, fn);
-    }
-    /**
-     * Run an asynchronous function with the given span as the current context
-     *
-     * @param span - The span to set as current
-     * @param fn - The async function to execute
-     * @returns A promise resolving to the return value of the function
-     */
-    static async runAsync(span, fn) {
-        return spanStorage.run(span, fn);
-    }
-    /**
-     * Clear the current context (primarily for testing)
-     */
-    static clear() {
-        spanStorage.disable();
-    }
-}
-//# sourceMappingURL=context.js.map

package/dist/tracing/context.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"context.js","sourceRoot":"","sources":["../../src/tracing/context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAGrD;;GAEG;AACH,MAAM,WAAW,GAAG,IAAI,iBAAiB,EAAQ,CAAC;AAElD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,OAAO,WAAW;IACtB;;;;OAIG;IACH,MAAM,CAAC,UAAU;QACf,OAAO,WAAW,CAAC,QAAQ,EAAE,CAAC;IAChC,CAAC;IAED;;;;;;OAMG;IACH,MAAM,CAAC,GAAG,CAAI,IAAU,EAAE,EAAW;QACnC,OAAO,WAAW,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;IACnC,CAAC;IAED;;;;;;OAMG;IACH,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAI,IAAU,EAAE,EAAoB;QACvD,OAAO,WAAW,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;IACnC,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,KAAK;QACV,WAAW,CAAC,OAAO,EAAE,CAAC;IACxB,CAAC;CACF"}

package/dist/tracing/span.d.ts

@@ -1,68 +0,0 @@
-/**
- * Types of spans that can be traced
- */
-export declare enum SpanType {
-    AGENT = "agent",
-    LLM = "llm",
-    TOOL = "tool",
-    CHAIN = "chain",
-    RETRIEVER = "retriever"
-}
-/**
- * Status of a span
- */
-export declare enum SpanStatus {
-    RUNNING = "running",
-    SUCCESS = "success",
-    ERROR = "error"
-}
-/**
- * Token usage information for LLM calls
- */
-export interface TokenUsage {
-    promptTokens: number;
-    completionTokens: number;
-    totalTokens: number;
-}
-/**
- * Error information captured when a span fails
- */
-export interface ErrorInfo {
-    errorType: string;
-    message: string;
-    stacktrace: string;
-}
-/**
- * A span represents a single operation in a trace
- */
-export interface Span {
-    /** Unique identifier for this span */
-    spanId: string;
-    /** ID of the parent span, or null if this is a root span */
-    parentSpanId: string | null;
-    /** Trace ID shared by all spans in a single trace */
-    traceId: string;
-    /** Human-readable name for this span */
-    name: string;
-    /** Type of operation this span represents */
-    spanType: SpanType;
-    /** Start time in milliseconds since Unix epoch */
-    startTime: number;
-    /** End time in milliseconds since Unix epoch, or null if still running */
-    endTime: number | null;
-    /** Current status of the span */
-    status: SpanStatus;
-    /** Input data for this operation */
-    inputs: Record<string, unknown>;
-    /** Output data from this operation, or null if not completed */
-    outputs: Record<string, unknown> | null;
-    /** Token usage for LLM calls, or null if not applicable */
-    tokenUsage: TokenUsage | null;
-    /** Error information if the span failed, or null if successful */
-    error: ErrorInfo | null;
-    /** Additional metadata about this span */
-    metadata: Record<string, unknown>;
-    /** Tags for categorizing and filtering spans */
-    tags: string[];
-}
-//# sourceMappingURL=span.d.ts.map

package/dist/tracing/span.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"span.d.ts","sourceRoot":"","sources":["../../src/tracing/span.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,oBAAY,QAAQ;IAClB,KAAK,UAAU;IACf,GAAG,QAAQ;IACX,IAAI,SAAS;IACb,KAAK,UAAU;IACf,SAAS,cAAc;CACxB;AAED;;GAEG;AACH,oBAAY,UAAU;IACpB,OAAO,YAAY;IACnB,OAAO,YAAY;IACnB,KAAK,UAAU;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,YAAY,EAAE,MAAM,CAAC;IACrB,gBAAgB,EAAE,MAAM,CAAC;IACzB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,IAAI;IACnB,sCAAsC;IACtC,MAAM,EAAE,MAAM,CAAC;IAEf,4DAA4D;IAC5D,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAE5B,qDAAqD;IACrD,OAAO,EAAE,MAAM,CAAC;IAEhB,wCAAwC;IACxC,IAAI,EAAE,MAAM,CAAC;IAEb,6CAA6C;IAC7C,QAAQ,EAAE,QAAQ,CAAC;IAEnB,kDAAkD;IAClD,SAAS,EAAE,MAAM,CAAC;IAElB,0EAA0E;IAC1E,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAEvB,iCAAiC;IACjC,MAAM,EAAE,UAAU,CAAC;IAEnB,oCAAoC;IACpC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAEhC,gEAAgE;IAChE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAExC,2DAA2D;IAC3D,UAAU,EAAE,UAAU,GAAG,IAAI,CAAC;IAE9B,kEAAkE;IAClE,KAAK,EAAE,SAAS,GAAG,IAAI,CAAC;IAExB,0CAA0C;IAC1C,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAElC,gDAAgD;IAChD,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB"}

package/dist/tracing/span.js

@@ -1,21 +0,0 @@
-/**
- * Types of spans that can be traced
- */
-export var SpanType;
-(function (SpanType) {
-    SpanType["AGENT"] = "agent";
-    SpanType["LLM"] = "llm";
-    SpanType["TOOL"] = "tool";
-    SpanType["CHAIN"] = "chain";
-    SpanType["RETRIEVER"] = "retriever";
-})(SpanType || (SpanType = {}));
-/**
- * Status of a span
- */
-export var SpanStatus;
-(function (SpanStatus) {
-    SpanStatus["RUNNING"] = "running";
-    SpanStatus["SUCCESS"] = "success";
-    SpanStatus["ERROR"] = "error";
-})(SpanStatus || (SpanStatus = {}));
-//# sourceMappingURL=span.js.map

package/dist/tracing/span.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"span.js","sourceRoot":"","sources":["../../src/tracing/span.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,CAAN,IAAY,QAMX;AAND,WAAY,QAAQ;IAClB,2BAAe,CAAA;IACf,uBAAW,CAAA;IACX,yBAAa,CAAA;IACb,2BAAe,CAAA;IACf,mCAAuB,CAAA;AACzB,CAAC,EANW,QAAQ,KAAR,QAAQ,QAMnB;AAED;;GAEG;AACH,MAAM,CAAN,IAAY,UAIX;AAJD,WAAY,UAAU;IACpB,iCAAmB,CAAA;IACnB,iCAAmB,CAAA;IACnB,6BAAe,CAAA;AACjB,CAAC,EAJW,UAAU,KAAV,UAAU,QAIrB"}

package/dist/tracing/tracer.d.ts

@@ -1,100 +0,0 @@
-import { type Partition } from '@prefactor/pfid';
-import type { Transport } from '../transport/base.js';
-import type { Span, SpanType, TokenUsage } from './span.js';
-/**
- * Options for starting a new span
- */
-export interface StartSpanOptions {
-    /** Name of the span */
-    name: string;
-    /** Type of operation this span represents */
-    spanType: SpanType;
-    /** Input data for this operation */
-    inputs: Record<string, unknown>;
-    /** ID of the parent span (optional) */
-    parentSpanId?: string;
-    /** Trace ID to use (optional, will generate if not provided) */
-    traceId?: string;
-    /** Additional metadata (optional) */
-    metadata?: Record<string, unknown>;
-    /** Tags for categorizing the span (optional) */
-    tags?: string[];
-}
-/**
- * Options for ending a span
- */
-export interface EndSpanOptions {
-    /** Output data from the operation */
-    outputs?: Record<string, unknown>;
-    /** Error that occurred (if any) */
-    error?: Error;
-    /** Token usage information (for LLM calls) */
-    tokenUsage?: TokenUsage;
-}
-/**
- * Tracer manages the lifecycle of spans.
- *
- * The tracer is responsible for:
- * - Creating spans with unique IDs
- * - Managing span lifecycle (start/end)
- * - Delegating to the transport layer for span emission
- * - Handling agent instance lifecycle
- *
- * @example
- * ```typescript
- * const tracer = new Tracer(transport);
- *
- * const span = tracer.startSpan({
- *   name: 'llm-call',
- *   spanType: SpanType.LLM,
- *   inputs: { prompt: 'Hello' }
- * });
- *
- * try {
- *   // ... do work ...
- *   tracer.endSpan(span, { outputs: { response: 'Hi!' } });
- * } catch (error) {
- *   tracer.endSpan(span, { error });
- * }
- * ```
- */
-export declare class Tracer {
-    private transport;
-    private partition;
-    /**
-     * Initialize the tracer.
-     *
-     * @param transport - The transport to use for emitting spans
-     * @param partition - The partition for ID generation. If not provided, a random partition will be generated.
-     */
-    constructor(transport: Transport, partition?: Partition);
-    /**
-     * Start a new span
-     *
-     * @param options - Span configuration options
-     * @returns The created span
-     */
-    startSpan(options: StartSpanOptions): Span;
-    /**
-     * End a span and emit it to the transport
-     *
-     * @param span - The span to end
-     * @param options - End span options (outputs, error, token usage)
-     */
-    endSpan(span: Span, options?: EndSpanOptions): void;
-    /**
-     * Signal the start of an agent instance execution
-     */
-    startAgentInstance(): void;
-    /**
-     * Signal the completion of an agent instance execution
-     */
-    finishAgentInstance(): void;
-    /**
-     * Close the tracer and flush any pending spans
-     *
-     * @returns Promise that resolves when the tracer is closed
-     */
-    close(): Promise<void>;
-}
-//# sourceMappingURL=tracer.d.ts.map

package/dist/tracing/tracer.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"tracer.d.ts","sourceRoot":"","sources":["../../src/tracing/tracer.ts"],"names":[],"mappings":"AAAA,OAAO,EAA+B,KAAK,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC9E,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAG5D;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,uBAAuB;IACvB,IAAI,EAAE,MAAM,CAAC;IAEb,6CAA6C;IAC7C,QAAQ,EAAE,QAAQ,CAAC;IAEnB,oCAAoC;IACpC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAEhC,uCAAuC;IACvC,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB,gEAAgE;IAChE,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,qCAAqC;IACrC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAEnC,gDAAgD;IAChD,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,qCAAqC;IACrC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAElC,mCAAmC;IACnC,KAAK,CAAC,EAAE,KAAK,CAAC;IAEd,8CAA8C;IAC9C,UAAU,CAAC,EAAE,UAAU,CAAC;CACzB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,qBAAa,MAAM;IASL,OAAO,CAAC,SAAS;IAR7B,OAAO,CAAC,SAAS,CAAY;IAE7B;;;;;OAKG;gBACiB,SAAS,EAAE,SAAS,EAAE,SAAS,CAAC,EAAE,SAAS;IAI/D;;;;;OAKG;IACH,SAAS,CAAC,OAAO,EAAE,gBAAgB,GAAG,IAAI;IAkC1C;;;;;OAKG;IACH,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,IAAI;IA6BnD;;OAEG;IACH,kBAAkB,IAAI,IAAI;IAQ1B;;OAEG;IACH,mBAAmB,IAAI,IAAI;IAQ3B;;;;OAIG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAO7B"}