@microsoft/opentelemetry 0.1.0-alpha.1

package/dist/commonjs/genai/instrumentations/langchain/langchainTraceInstrumentor.js

@@ -0,0 +1,164 @@
+"use strict";
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT License.
+// Vendored from microsoft/Agent365-nodejs packages/agents-a365-observability-extensions-langchain
+// Adapted: removed ObservabilityManager dependency, uses diag logger instead of A365 logger
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LangChainTraceInstrumentor = void 0;
+exports.addTracerToHandlers = addTracerToHandlers;
+const api_1 = require("@opentelemetry/api");
+const instrumentation_1 = require("@opentelemetry/instrumentation");
+const tracer_js_1 = require("./tracer.js");
+class LangChainTraceInstrumentorImpl extends instrumentation_1.InstrumentationBase {
+    static _instance = null;
+    _hasBeenEnabled = false;
+    _isPatched = false;
+    otelTracer;
+    isContentRecordingEnabled;
+    constructor(options) {
+        if (LangChainTraceInstrumentorImpl._instance !== null) {
+            throw new Error("LangChainTraceInstrumentor can only be instantiated once.");
+        }
+        super("microsoft-otel-langchain-instrumentor", "1.0.0", {
+            enabled: true,
+        });
+        this.otelTracer = api_1.trace.getTracer("microsoft-otel-langchain", "1.0.0");
+        this.isContentRecordingEnabled = options?.isContentRecordingEnabled ?? false;
+        LangChainTraceInstrumentorImpl._instance = this;
+        api_1.diag.info("[LangChainTraceInstrumentor] Initialized and automatically enabled");
+    }
+    static getInstance(options) {
+        if (!LangChainTraceInstrumentorImpl._instance) {
+            LangChainTraceInstrumentorImpl._instance = new LangChainTraceInstrumentorImpl(options);
+        }
+        return LangChainTraceInstrumentorImpl._instance;
+    }
+    static hasInstance() {
+        return LangChainTraceInstrumentorImpl._instance !== null;
+    }
+    static resetInstance() {
+        if (LangChainTraceInstrumentorImpl._instance) {
+            LangChainTraceInstrumentorImpl._instance._isPatched = false;
+        }
+        LangChainTraceInstrumentorImpl._instance = null;
+    }
+    init() {
+        return {
+            name: "@langchain/core/callbacks/manager",
+            supportedVersions: [">=0.2.0"],
+            files: [],
+            patch: this.patch.bind(this),
+            unpatch: this.unpatch.bind(this),
+        };
+    }
+    unpatch(moduleExports) {
+        const CallbackManager = moduleExports?.CallbackManager;
+        if (!CallbackManager || !(0, instrumentation_1.isWrapped)(CallbackManager._configureSync)) {
+            return;
+        }
+        this._unwrap(CallbackManager, "_configureSync");
+        this._isPatched = false;
+        api_1.diag.info("[LangChainTraceInstrumentor] Unpatched OTEL LangChain instrumentation");
+    }
+    patch(module) {
+        if (this._isPatched) {
+            return module;
+        }
+        const { CallbackManager } = module;
+        if (!CallbackManager || !("_configureSync" in CallbackManager)) {
+            return module;
+        }
+        // eslint-disable-next-line @typescript-eslint/no-this-alias
+        const instrumentor = this;
+        this._wrap(CallbackManager, "_configureSync", (original) => {
+            return function (...args) {
+                args[0] = addTracerToHandlers(instrumentor.otelTracer, args[0], {
+                    isContentRecordingEnabled: instrumentor.isContentRecordingEnabled,
+                });
+                api_1.diag.debug("[LangChainTraceInstrumentor] _configureSync wrapped to add LangChainTracer");
+                return original.apply(this, args);
+            };
+        });
+        api_1.diag.info("[LangChainTraceInstrumentor] Patched OTEL LangChain instrumentation");
+        this._isPatched = true;
+        return module;
+    }
+    manuallyInstrumentImpl(module) {
+        api_1.diag.info("[LangChainTraceInstrumentor] Manually instrumenting CallbackManagerModule");
+        this.patch(module);
+    }
+    instrumentationDependencies() {
+        return ["@langchain/core >= 0.2.0"];
+    }
+    enable() {
+        if (this._hasBeenEnabled) {
+            return;
+        }
+        this._hasBeenEnabled = true;
+        api_1.diag.info("[LangChainTraceInstrumentor] Enabled LangChain instrumentation");
+        super.enable();
+    }
+    disable() {
+        this._hasBeenEnabled = false;
+        api_1.diag.info("[LangChainTraceInstrumentor] Disabled LangChain instrumentation");
+        super.disable();
+    }
+}
+/**
+ * Static wrapper for LangChain tracing instrumentation
+ */
+class LangChainTraceInstrumentor {
+    static throwNotInitialized() {
+        throw new Error("LangChainTraceInstrumentor must be initialized first. " +
+            "Call LangChainTraceInstrumentor.instrument() before using enable/disable.");
+    }
+    /**
+     * Initialize and auto-instrument for LangChain
+     * @param module The CallbackManager module to instrument
+     * @param options Optional configuration options
+     */
+    static instrument(module, options) {
+        LangChainTraceInstrumentorImpl.getInstance(options).manuallyInstrumentImpl(module);
+    }
+    /**
+     * Enable LangChain instrumentation
+     */
+    static enable() {
+        if (!LangChainTraceInstrumentorImpl.hasInstance()) {
+            this.throwNotInitialized();
+        }
+        LangChainTraceInstrumentorImpl.getInstance().enable();
+    }
+    /**
+     * Disable LangChain instrumentation
+     */
+    static disable() {
+        if (!LangChainTraceInstrumentorImpl.hasInstance()) {
+            this.throwNotInitialized();
+        }
+        LangChainTraceInstrumentorImpl.getInstance().disable();
+    }
+    /**
+     * Reset the instrumentor instance (for testing)
+     */
+    static resetInstance() {
+        LangChainTraceInstrumentorImpl.resetInstance();
+    }
+}
+exports.LangChainTraceInstrumentor = LangChainTraceInstrumentor;
+function addTracerToHandlers(tracer, handlers, options) {
+    if (handlers == null) {
+        return [new tracer_js_1.LangChainTracer(tracer, options)];
+    }
+    if (Array.isArray(handlers)) {
+        if (!handlers.some((h) => h instanceof tracer_js_1.LangChainTracer)) {
+            handlers.push(new tracer_js_1.LangChainTracer(tracer, options));
+        }
+        return handlers;
+    }
+    if (!handlers.inheritableHandlers.some((h) => h instanceof tracer_js_1.LangChainTracer)) {
+        handlers.addHandler(new tracer_js_1.LangChainTracer(tracer, options), true);
+    }
+    return handlers;
+}
+//# sourceMappingURL=langchainTraceInstrumentor.js.map

package/dist/commonjs/genai/instrumentations/langchain/langchainTraceInstrumentor.js.map

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

package/dist/commonjs/genai/instrumentations/langchain/tracer.d.ts

@@ -0,0 +1,59 @@
+import { Tracer } from "@opentelemetry/api";
+import { BaseTracer, Run } from "@langchain/core/tracers/base";
+/**
+ * OpenTelemetry-based tracer for LangChain / LangGraph applications.
+ *
+ * Extends LangChain's `BaseTracer` callback handler so it can be injected into
+ * the LangChain callback system (via `LangChainTraceInstrumentor`). Every
+ * LangChain "run" (agent invocation, tool execution, or LLM call) is mapped to
+ * an OTel span with GenAI semantic convention attributes.
+ *
+ * Key behaviors:
+ * - Creates a span on `onRunCreate` and ends it on `_endTrace`.
+ * - Maintains parent–child span relationships by tracking run IDs and walking
+ *   up the parent chain to find the nearest span context.
+ * - Skips LangChain-internal runs (tagged `langsmith:hidden`, `Branch*`, or
+ *   unmapped run types) to avoid noisy traces.
+ * - Guards against unbounded memory with a hard cap of {@link MAX_RUNS}.
+ * - Content-sensitive attributes (messages, tool args, system instructions)
+ *   are only recorded when `isContentRecordingEnabled` is true.
+ */
+export declare class LangChainTracer extends BaseTracer {
+    /** Hard cap on concurrent tracked runs to prevent memory leaks. */
+    private static readonly MAX_RUNS;
+    private tracer;
+    private isContentRecordingEnabled;
+    /** Active runs keyed by LangChain run ID. */
+    private runs;
+    /** Maps each run ID → its parent run ID for parent-span-context lookup. */
+    private parentByRunId;
+    constructor(tracer: Tracer, options?: {
+        isContentRecordingEnabled?: boolean;
+    });
+    name: string;
+    protected persistRun(_run: Run): Promise<void>;
+    /**
+     * Called by LangChain when a new run starts. Records the parent mapping
+     * and opens a span via {@link startTracing}.
+     */
+    onRunCreate(run: Run): Promise<void>;
+    /**
+     * Opens an OTel span for the given run. The span name is derived from the
+     * operation type (invoke_agent, execute_tool, chat) and the run/model name.
+     * Internal or unknown runs are silently skipped.
+     */
+    protected startTracing(run: Run): void;
+    /**
+     * Called by LangChain when a run finishes. Sets status, enriches the span
+     * with GenAI attributes, and ends it. If content recording is enabled,
+     * message bodies, tool arguments, and system instructions are also attached.
+     */
+    protected _endTrace(run: Run): Promise<void>;
+    /**
+     * Walks up the parent run chain to find the nearest ancestor that has an
+     * active span, returning its `SpanContext` so the new span can be linked
+     * as a child.
+     */
+    private getNearestParentSpanContext;
+}
+//# sourceMappingURL=tracer.d.ts.map

package/dist/commonjs/genai/instrumentations/langchain/tracer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tracer.d.ts","sourceRoot":"","sources":["../../../../../src/genai/instrumentations/langchain/tracer.ts"],"names":[],"mappings":"AAIA,OAAO,EAAkD,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAC5F,OAAO,EAAE,UAAU,EAAE,GAAG,EAAE,MAAM,8BAA8B,CAAC;AAQ/D;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,eAAgB,SAAQ,UAAU;IAC7C,mEAAmE;IACnE,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAU;IAC1C,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,yBAAyB,CAAU;IAC3C,6CAA6C;IAC7C,OAAO,CAAC,IAAI,CAAkC;IAC9C,2EAA2E;IAC3E,OAAO,CAAC,aAAa,CAAyC;gBAElD,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,yBAAyB,CAAC,EAAE,OAAO,CAAA;KAAE;IAM7E,IAAI,SAAkC;IAEtC,SAAS,CAAC,UAAU,CAAC,IAAI,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC;IAI9C;;;OAGG;IACG,WAAW,CAAC,GAAG,EAAE,GAAG;IAM1B;;;;OAIG;IACH,SAAS,CAAC,YAAY,CAAC,GAAG,EAAE,GAAG;IAuD/B;;;;OAIG;cACa,SAAS,CAAC,GAAG,EAAE,GAAG;IAoElC;;;;OAIG;IACH,OAAO,CAAC,2BAA2B;CAUpC"}

package/dist/commonjs/genai/instrumentations/langchain/tracer.js

@@ -0,0 +1,218 @@
+"use strict";
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT License.
+// Vendored from microsoft/Agent365-nodejs packages/agents-a365-observability-extensions-langchain
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LangChainTracer = void 0;
+const api_1 = require("@opentelemetry/api");
+const base_1 = require("@langchain/core/tracers/base");
+const core_1 = require("@opentelemetry/core");
+const api_2 = require("@opentelemetry/api");
+const index_js_1 = require("../../index.js");
+const Utils = __importStar(require("./utils.js"));
+/**
+ * OpenTelemetry-based tracer for LangChain / LangGraph applications.
+ *
+ * Extends LangChain's `BaseTracer` callback handler so it can be injected into
+ * the LangChain callback system (via `LangChainTraceInstrumentor`). Every
+ * LangChain "run" (agent invocation, tool execution, or LLM call) is mapped to
+ * an OTel span with GenAI semantic convention attributes.
+ *
+ * Key behaviors:
+ * - Creates a span on `onRunCreate` and ends it on `_endTrace`.
+ * - Maintains parent–child span relationships by tracking run IDs and walking
+ *   up the parent chain to find the nearest span context.
+ * - Skips LangChain-internal runs (tagged `langsmith:hidden`, `Branch*`, or
+ *   unmapped run types) to avoid noisy traces.
+ * - Guards against unbounded memory with a hard cap of {@link MAX_RUNS}.
+ * - Content-sensitive attributes (messages, tool args, system instructions)
+ *   are only recorded when `isContentRecordingEnabled` is true.
+ */
+class LangChainTracer extends base_1.BaseTracer {
+    /** Hard cap on concurrent tracked runs to prevent memory leaks. */
+    static MAX_RUNS = 10_000;
+    tracer;
+    isContentRecordingEnabled;
+    /** Active runs keyed by LangChain run ID. */
+    runs = new Map();
+    /** Maps each run ID → its parent run ID for parent-span-context lookup. */
+    parentByRunId = new Map();
+    constructor(tracer, options) {
+        super();
+        this.tracer = tracer;
+        this.isContentRecordingEnabled = options?.isContentRecordingEnabled ?? false;
+    }
+    name = "OpenTelemetryLangChainTracer";
+    persistRun(_run) {
+        return Promise.resolve();
+    }
+    /**
+     * Called by LangChain when a new run starts. Records the parent mapping
+     * and opens a span via {@link startTracing}.
+     */
+    async onRunCreate(run) {
+        this.parentByRunId.set(run.id, run.parent_run_id);
+        if (super.onRunCreate)
+            await super.onRunCreate(run);
+        this.startTracing(run);
+    }
+    /**
+     * Opens an OTel span for the given run. The span name is derived from the
+     * operation type (invoke_agent, execute_tool, chat) and the run/model name.
+     * Internal or unknown runs are silently skipped.
+     */
+    startTracing(run) {
+        if ((0, core_1.isTracingSuppressed)(api_1.context.active())) {
+            return;
+        }
+        const operation = Utils.getOperationType(run);
+        // Skip internal runs (LangSmith hidden, Branch nodes, unknown operations)
+        if (run.tags?.includes("langsmith:hidden") ||
+            run.name?.startsWith("Branch") ||
+            operation === "unknown") {
+            api_2.diag.debug(`[LangChainTracer] Skipping internal run: ${run.name} (parent: ${run.parent_run_id})`);
+            return;
+        }
+        // Attach to parent span if one exists in the run hierarchy
+        const parentCtx = this.getNearestParentSpanContext(run);
+        const activeContext = parentCtx
+            ? api_1.trace.setSpanContext(api_1.context.active(), parentCtx)
+            : api_1.context.active();
+        // Build span name: "<operation> <name|model>"
+        let spanName = run.name;
+        if (operation === "invoke_agent") {
+            spanName = `${operation} ${run.name}`;
+        }
+        else if (operation === "execute_tool") {
+            spanName = `${operation} ${run.name}`;
+        }
+        else if (operation === "chat") {
+            spanName = `${operation} ${Utils.getModel(run) || run.name}`.trim();
+        }
+        if (this.runs.size >= LangChainTracer.MAX_RUNS) {
+            api_2.diag.warn(`[LangChainTracer] Max runs (${LangChainTracer.MAX_RUNS}) reached, skipping span`);
+            this.parentByRunId.delete(run.id);
+            return;
+        }
+        const startTime = run.start_time ?? Date.now();
+        const span = this.tracer.startSpan(spanName, {
+            kind: api_1.SpanKind.INTERNAL,
+            startTime,
+            attributes: { [index_js_1.ATTR_GEN_AI_PROVIDER_NAME]: "langchain" },
+        }, activeContext);
+        this.runs.set(run.id, { run, span, startTime, lastAccessTime: startTime });
+    }
+    /**
+     * Called by LangChain when a run finishes. Sets status, enriches the span
+     * with GenAI attributes, and ends it. If content recording is enabled,
+     * message bodies, tool arguments, and system instructions are also attached.
+     */
+    async _endTrace(run) {
+        if ((0, core_1.isTracingSuppressed)(api_1.context.active())) {
+            // End any span that was started before suppression to avoid leaks.
+            const suppressedEntry = this.runs.get(run.id);
+            if (suppressedEntry) {
+                suppressedEntry.span.end(run.end_time ?? undefined);
+            }
+            this.parentByRunId.delete(run.id);
+            this.runs.delete(run.id);
+            return;
+        }
+        const operation = Utils.getOperationType(run);
+        if (run.tags?.includes("langsmith:hidden") ||
+            run.name?.startsWith("Branch") ||
+            operation === "unknown") {
+            api_2.diag.debug(`[LangChainTracer] Skipping internal run: ${run.name} (parent: ${run.parent_run_id})`);
+            return;
+        }
+        const entry = this.runs.get(run.id);
+        if (!entry) {
+            return;
+        }
+        const { span } = entry;
+        try {
+            entry.lastAccessTime = Date.now();
+            if (run.error) {
+                span.setStatus({ code: api_1.SpanStatusCode.ERROR });
+                span.setAttribute(index_js_1.ATTR_ERROR_MESSAGE, String(run.error));
+            }
+            else {
+                span.setStatus({ code: api_1.SpanStatusCode.OK });
+            }
+            // Always-on attributes: operation type, agent info, model, provider, session, tokens
+            Utils.setOperationTypeAttribute(operation, span);
+            Utils.setAgentAttributes(run, span);
+            Utils.setModelAttribute(run, span);
+            Utils.setProviderNameAttribute(run, span);
+            Utils.setSessionIdAttribute(run, span);
+            Utils.setTokenAttributes(run, span);
+            // Opt-in content attributes (may contain PII / large payloads)
+            if (this.isContentRecordingEnabled) {
+                Utils.setToolAttributes(run, span);
+                Utils.setInputMessagesAttribute(run, span);
+                Utils.setOutputMessagesAttribute(run, span);
+                Utils.setSystemInstructionsAttribute(run, span);
+            }
+        }
+        catch (error) {
+            api_2.diag.error(`[LangChainTracer] Error setting span attributes for run ${run.name}: ${error instanceof Error ? error.message : String(error)}`);
+            span.setStatus({ code: api_1.SpanStatusCode.ERROR });
+        }
+        finally {
+            span.end(run.end_time ?? undefined);
+            this.runs.delete(run.id);
+            this.parentByRunId.delete(run.id);
+            await super._endTrace(run);
+        }
+    }
+    /**
+     * Walks up the parent run chain to find the nearest ancestor that has an
+     * active span, returning its `SpanContext` so the new span can be linked
+     * as a child.
+     */
+    getNearestParentSpanContext(run) {
+        let pid = run.parent_run_id;
+        while (pid) {
+            const entry = this.runs.get(pid);
+            if (entry)
+                return entry.span.spanContext();
+            pid = this.parentByRunId.get(pid);
+        }
+        return undefined;
+    }
+}
+exports.LangChainTracer = LangChainTracer;
+//# sourceMappingURL=tracer.js.map

package/dist/commonjs/genai/instrumentations/langchain/tracer.js.map

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

package/dist/commonjs/genai/instrumentations/langchain/utils.d.ts

@@ -0,0 +1,16 @@
+import { Run } from "@langchain/core/tracers/base";
+import { Span } from "@opentelemetry/api";
+export declare function isString(value: unknown): value is string;
+export declare function getOperationType(run: Run): string;
+export declare function setOperationTypeAttribute(operation: string, span: Span): void;
+export declare function setAgentAttributes(run: Run, span: Span): void;
+export declare function setToolAttributes(run: Run, span: Span): void;
+export declare function setInputMessagesAttribute(run: Run, span: Span): void;
+export declare function setOutputMessagesAttribute(run: Run, span: Span): void;
+export declare function getModel(run: Run): string | undefined;
+export declare function setModelAttribute(run: Run, span: Span): void;
+export declare function setProviderNameAttribute(run: Run, span: Span): void;
+export declare function setSessionIdAttribute(run: Run, span: Span): void;
+export declare function setSystemInstructionsAttribute(run: Run, span: Span): Span | undefined;
+export declare function setTokenAttributes(run: Run, span: Span): void;
+//# sourceMappingURL=utils.d.ts.map

package/dist/commonjs/genai/instrumentations/langchain/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../../../src/genai/instrumentations/langchain/utils.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,GAAG,EAAE,MAAM,8BAA8B,CAAC;AACnD,OAAO,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAC;AAuB1C,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAExD;AAGD,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,GAAG,GAAG,MAAM,CAWjD;AAGD,wBAAgB,yBAAyB,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,QAEtE;AAGD,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,QAOtD;AAGD,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,QAyBrD;AAED,wBAAgB,yBAAyB,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,QAwB7D;AA+ED,wBAAgB,0BAA0B,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,QAgE9D;AAGD,wBAAgB,QAAQ,CAAC,GAAG,EAAE,GAAG,GAAG,MAAM,GAAG,SAAS,CASrD;AAGD,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,QAGrD;AAGD,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,QAG5D;AAED,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,GAAG,IAAI,CAShE;AAGD,wBAAgB,8BAA8B,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,oBAuBlE;AAGD,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,QA2BtD"}