trodo-node 1.2.0 → 2.1.0

package/dist/esm/index.js

@@ -1,20 +1,58 @@
 /**
  * trodo-node — Trodo Analytics SDK for Node.js
  *
- * Usage (singleton):
+ * Quick start (any stack):
  *   import trodo from 'trodo-node';
- *   trodo.init({ siteId: 'your-site-id' });
- *   const user = trodo.forUser('user-123');
- *   await user.track('purchase_completed', { amount: 99.99 });
+ *   trodo.init({ siteId: 'your-site-id' }); // autoInstrument on by default
  *
- * Usage (class):
- *   import { TrodoClient } from 'trodo-node';
- *   const client = new TrodoClient({ siteId: 'your-site-id' });
+ *   // OpenAI / Anthropic / LangChain / Vercel AI SDK — nothing else to do.
+ *   const { result, runId } = await trodo.wrapAgent(
+ *     'customer-support',
+ *     async (run) => {
+ *       run.setInput({ query });
+ *       const answer = await agent.run(query);
+ *       run.setOutput(answer);
+ *       return answer;
+ *     },
+ *     { distinctId, conversationId },
+ *   );
+ *
+ *   await trodo.feedback(runId, { satisfaction: 'positive', rating: 5 });
+ *
+ * Raw-HTTP LLM caller:
+ *   const resp = await fetch(url, { body }).then(r => r.json());
+ *   await trodo.trackLlmCall({
+ *     model: 'gemini-2.5-flash', provider: 'google',
+ *     inputTokens: resp.usageMetadata.promptTokenCount,
+ *     outputTokens: resp.usageMetadata.candidatesTokenCount,
+ *     prompt: body, completion: resp,
+ *   });
+ *
+ * Custom tool:
+ *   const runFunnelQuery = trodo.tool(
+ *     async (teamId, preset) => { ... },
+ *     { name: 'run_funnel_query' },
+ *   );
+ *
+ * Downstream microservice (join the caller's run instead of creating a new one):
+ *   // Express:
+ *   app.use(trodo.expressMiddleware());
+ *
+ *   // Or manually:
+ *   await trodo.joinRun(
+ *     headers['x-trodo-run-id'],
+ *     headers['x-trodo-parent-span-id'],
+ *     async () => { ... },
+ *   );
  */
 export { TrodoClient } from './TrodoClient.js';
 export { UserContext } from './UserContext.js';
 export * from './types/index.js';
 import { TrodoClient } from './TrodoClient.js';
+export { getActiveContext } from './otel/context.js';
+export { currentRunId, currentSpanId } from './otel/wrapAgent.js';
+import { propagationHeaders, trace, llm, retrieval, getTracer, tool as _toolImpl, } from './otel/helpers.js';
+export { propagationHeaders, trace, llm, retrieval, getTracer };
 // ============================================================================
 // Singleton convenience API
 // ============================================================================
@@ -87,22 +125,37 @@ export async function shutdown() {
     return getClient().shutdown();
 }
 // ----------------------------------------------------------------------------
-// Agent Analytics — singleton wrappers
+// Agent Runs — unified surface
 // ----------------------------------------------------------------------------
-export function track_agent_call(props) {
-    return getClient().track_agent_call(props);
+/**
+ * Wrap an async function as an agent run. All OTel-instrumented LLM/tool
+ * calls and nested withSpan calls are auto-captured as child spans.
+ */
+export function wrapAgent(agentName, fn, options) {
+    return getClient().wrapAgent(agentName, fn, options);
+}
+/** Create a nested span inside the current run. */
+export function withSpan(name, fn, options) {
+    return getClient().withSpan(name, fn, options);
+}
+/** Join an existing run owned by a remote service — spans nest under it. */
+export function joinRun(runId, parentSpanId, fn, options) {
+    return getClient().joinRun(runId, parentSpanId, fn, options);
 }
-export function track_tool_use(props) {
-    return getClient().track_tool_use(props);
+export function tool(a, b) {
+    return _toolImpl(a, b);
 }
-export function track_agent_response(props) {
-    return getClient().track_agent_response(props);
+/** Record a one-shot LLM span for a raw-HTTP caller. */
+export function trackLlmCall(params) {
+    return getClient().trackLlmCall(params);
 }
-export function track_agent_error(props) {
-    return getClient().track_agent_error(props);
+/** Return an Express/Connect middleware that auto-joins inbound runs. */
+export function expressMiddleware() {
+    return getClient().expressMiddleware();
 }
-export function track_feedback(props) {
-    return getClient().track_feedback(props);
+/** Attach feedback to a completed run. */
+export function feedback(runId, props) {
+    return getClient().feedback(runId, props);
 }
 // Default export: the singleton namespace (matches frontend SDK pattern)
 const trodo = {
@@ -121,11 +174,17 @@ const trodo = {
     disableAutoEvents,
     flush,
     shutdown,
-    track_agent_call,
-    track_tool_use,
-    track_agent_response,
-    track_agent_error,
-    track_feedback,
+    wrapAgent,
+    withSpan,
+    joinRun,
+    tool,
+    trace,
+    llm,
+    retrieval,
+    getTracer,
+    trackLlmCall,
+    expressMiddleware,
+    feedback,
 };
 export default trodo;
 //# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

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

package/dist/esm/otel/autoInstrument.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Optional: register OpenTelemetry auto-instrumentation that feeds spans into
+ * our TrodoSpanProcessor. Call `enableAutoInstrument()` once at app startup to
+ * pick up Anthropic, OpenAI, Vercel AI SDK, LangChain, Bedrock, Google
+ * Generative AI etc. without any more code from the user.
+ *
+ * Each underlying OTel package is an optional peer dependency — we require()
+ * them lazily and skip anything that isn't installed. The user picks which
+ * instrumentations they want by installing the packages.
+ */
+import type { TrodoSpanProcessor, TrodoSpan } from './processor.js';
+export type InstrumentationId = 'anthropic' | 'openai' | 'langchain' | 'bedrock' | 'cohere' | 'google-generativeai' | 'vertexai' | 'llama-index' | 'vercel-ai' | 'http' | 'fetch';
+export interface AutoInstrumentOptions {
+    processor: TrodoSpanProcessor;
+    /** Disable individual instrumentations by name. */
+    disable?: InstrumentationId[];
+}
+type OtelSpanLike = {
+    name: string;
+    attributes?: Record<string, unknown>;
+    status?: {
+        code?: number;
+    };
+    startTime?: [number, number];
+    endTime?: [number, number];
+    spanContext?: () => {
+        spanId: string;
+        traceId: string;
+    };
+    parentSpanId?: string;
+};
+/**
+ * Translate an OTel span to our TrodoSpan shape using GenAI semantic
+ * conventions (gen_ai.*). Accepts both stable and legacy/experimental keys.
+ */
+export declare function otelSpanToTrodoSpan(otel: OtelSpanLike): TrodoSpan | null;
+/**
+ * Adapter that lets the OTel SDK push spans into our processor.
+ * Register with `sdk.addSpanProcessor(otelAdapter(processor))` in your app
+ * bootstrap.
+ */
+export declare function otelAdapter(processor: TrodoSpanProcessor): {
+    onStart(): void;
+    onEnd(span: OtelSpanLike): void;
+    forceFlush(): Promise<void>;
+    shutdown(): Promise<void>;
+};
+/**
+ * Best-effort: register OTel auto-instrumentations if the user has them
+ * installed. This is optional — users can also configure OTel themselves and
+ * pass `otelAdapter(processor)` as a span processor.
+ *
+ * Returns the list of instrumentation ids that were successfully registered.
+ *
+ * Vercel AI SDK note: if you set `experimental_telemetry: { isEnabled: true,
+ * tracer: trace.getTracer('ai') }` on generateText/streamText calls, those
+ * spans flow through the SDK-registered OTel SpanProcessor automatically.
+ */
+export declare function enableAutoInstrument(opts: AutoInstrumentOptions): InstrumentationId[];
+export {};
+//# sourceMappingURL=autoInstrument.d.ts.map

package/dist/esm/otel/autoInstrument.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"autoInstrument.d.ts","sourceRoot":"","sources":["../../../src/otel/autoInstrument.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,KAAK,EAAE,kBAAkB,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAGpE,MAAM,MAAM,iBAAiB,GACzB,WAAW,GACX,QAAQ,GACR,WAAW,GACX,SAAS,GACT,QAAQ,GACR,qBAAqB,GACrB,UAAU,GACV,aAAa,GACb,WAAW,GACX,MAAM,GACN,OAAO,CAAC;AAEZ,MAAM,WAAW,qBAAqB;IACpC,SAAS,EAAE,kBAAkB,CAAC;IAC9B,mDAAmD;IACnD,OAAO,CAAC,EAAE,iBAAiB,EAAE,CAAC;CAC/B;AAED,KAAK,YAAY,GAAG;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,MAAM,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC3B,SAAS,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC3B,WAAW,CAAC,EAAE,MAAM;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IACxD,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,CAAC;AAuCF;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,YAAY,GAAG,SAAS,GAAG,IAAI,CA6DxE;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,SAAS,EAAE,kBAAkB,GAAG;IAC1D,OAAO,IAAI,IAAI,CAAC;IAChB,KAAK,CAAC,IAAI,EAAE,YAAY,GAAG,IAAI,CAAC;IAChC,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5B,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3B,CAgBA;AA4FD;;;;;;;;;;GAUG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,qBAAqB,GAAG,iBAAiB,EAAE,CA6BrF"}

package/dist/esm/otel/autoInstrument.js

@@ -0,0 +1,248 @@
+import { getActiveContext } from './context.js';
+function hrToIso(hr) {
+    if (!hr)
+        return undefined;
+    const ms = hr[0] * 1000 + Math.floor(hr[1] / 1e6);
+    return new Date(ms).toISOString();
+}
+function inferKind(attrs) {
+    if (!attrs)
+        return 'generic';
+    if (attrs['gen_ai.tool.name'])
+        return 'tool';
+    if (attrs['gen_ai.operation.name'] || attrs['gen_ai.request.model'])
+        return 'llm';
+    if (attrs['db.system'] || attrs['retrieval.query'])
+        return 'retrieval';
+    return 'generic';
+}
+function pickNum(attrs, keys) {
+    for (const k of keys) {
+        const v = attrs[k];
+        if (typeof v === 'number')
+            return v;
+        if (typeof v === 'string' && v !== '' && !isNaN(Number(v)))
+            return Number(v);
+    }
+    return undefined;
+}
+function pickStr(attrs, keys) {
+    for (const k of keys) {
+        const v = attrs[k];
+        if (typeof v === 'string' && v.length)
+            return v;
+    }
+    return undefined;
+}
+/**
+ * Translate an OTel span to our TrodoSpan shape using GenAI semantic
+ * conventions (gen_ai.*). Accepts both stable and legacy/experimental keys.
+ */
+export function otelSpanToTrodoSpan(otel) {
+    const ctx = getActiveContext();
+    if (!ctx)
+        return null; // outside of wrapAgent — drop
+    const sc = otel.spanContext?.();
+    if (!sc)
+        return null;
+    const attrs = otel.attributes || {};
+    const kind = inferKind(attrs);
+    const startedAt = hrToIso(otel.startTime) || new Date().toISOString();
+    const endedAt = hrToIso(otel.endTime);
+    const durationMs = otel.startTime && otel.endTime
+        ? Math.max(0, (otel.endTime[0] - otel.startTime[0]) * 1000 +
+            (otel.endTime[1] - otel.startTime[1]) / 1e6)
+        : undefined;
+    const model = pickStr(attrs, [
+        'gen_ai.request.model',
+        'gen_ai.response.model',
+        'llm.request.model',
+    ]);
+    const provider = pickStr(attrs, ['gen_ai.system', 'llm.vendor']);
+    const inputTokens = pickNum(attrs, [
+        'gen_ai.usage.input_tokens',
+        'gen_ai.usage.prompt_tokens',
+        'llm.usage.prompt_tokens',
+    ]);
+    const outputTokens = pickNum(attrs, [
+        'gen_ai.usage.output_tokens',
+        'gen_ai.usage.completion_tokens',
+        'llm.usage.completion_tokens',
+    ]);
+    const temperature = pickNum(attrs, ['gen_ai.request.temperature']);
+    const toolName = pickStr(attrs, ['gen_ai.tool.name']);
+    const input = pickStr(attrs, ['gen_ai.prompt', 'llm.prompts']);
+    const output = pickStr(attrs, ['gen_ai.completion', 'llm.completion']);
+    const span = {
+        span_id: sc.spanId,
+        run_id: ctx.runId,
+        parent_span_id: otel.parentSpanId || ctx.spanId,
+        kind,
+        name: otel.name,
+        status: otel.status?.code === 2 ? 'error' : 'ok',
+        started_at: startedAt,
+        ended_at: endedAt,
+        duration_ms: durationMs,
+        model,
+        provider,
+        input_tokens: inputTokens,
+        output_tokens: outputTokens,
+        temperature,
+        tool_name: toolName,
+        input,
+        output,
+        attributes: attrs,
+    };
+    return span;
+}
+/**
+ * Adapter that lets the OTel SDK push spans into our processor.
+ * Register with `sdk.addSpanProcessor(otelAdapter(processor))` in your app
+ * bootstrap.
+ */
+export function otelAdapter(processor) {
+    return {
+        onStart() {
+            /* noop */
+        },
+        onEnd(otel) {
+            const span = otelSpanToTrodoSpan(otel);
+            if (span)
+                processor.enqueueSpan(span);
+        },
+        async forceFlush() {
+            await processor.forceFlush();
+        },
+        async shutdown() {
+            await processor.shutdown();
+        },
+    };
+}
+function buildInstrumentors() {
+    return [
+        {
+            id: 'anthropic',
+            factory: () => {
+                // eslint-disable-next-line @typescript-eslint/no-var-requires
+                const m = require('@opentelemetry/instrumentation-anthropic');
+                return new m.AnthropicInstrumentation();
+            },
+        },
+        {
+            id: 'openai',
+            factory: () => {
+                // eslint-disable-next-line @typescript-eslint/no-var-requires
+                const m = require('@opentelemetry/instrumentation-openai');
+                return new m.OpenAIInstrumentation();
+            },
+        },
+        {
+            id: 'langchain',
+            factory: () => {
+                // eslint-disable-next-line @typescript-eslint/no-var-requires
+                const m = require('@opentelemetry/instrumentation-langchain');
+                return new m.LangChainInstrumentation();
+            },
+        },
+        {
+            id: 'bedrock',
+            factory: () => {
+                // eslint-disable-next-line @typescript-eslint/no-var-requires
+                const m = require('@opentelemetry/instrumentation-bedrock');
+                return new m.BedrockInstrumentation();
+            },
+        },
+        {
+            id: 'cohere',
+            factory: () => {
+                // eslint-disable-next-line @typescript-eslint/no-var-requires
+                const m = require('@opentelemetry/instrumentation-cohere');
+                return new m.CohereInstrumentation();
+            },
+        },
+        {
+            id: 'google-generativeai',
+            factory: () => {
+                // eslint-disable-next-line @typescript-eslint/no-var-requires
+                const m = require('@opentelemetry/instrumentation-google-generativeai');
+                return new m.GoogleGenerativeAIInstrumentation();
+            },
+        },
+        {
+            id: 'vertexai',
+            factory: () => {
+                // eslint-disable-next-line @typescript-eslint/no-var-requires
+                const m = require('@opentelemetry/instrumentation-vertexai');
+                return new m.VertexAIInstrumentation();
+            },
+        },
+        {
+            id: 'llama-index',
+            factory: () => {
+                // eslint-disable-next-line @typescript-eslint/no-var-requires
+                const m = require('@opentelemetry/instrumentation-llamaindex');
+                return new m.LlamaIndexInstrumentation();
+            },
+        },
+        {
+            id: 'http',
+            factory: () => {
+                // eslint-disable-next-line @typescript-eslint/no-var-requires
+                const m = require('@opentelemetry/instrumentation-http');
+                return new m.HttpInstrumentation();
+            },
+        },
+        {
+            id: 'fetch',
+            factory: () => {
+                // eslint-disable-next-line @typescript-eslint/no-var-requires
+                const m = require('@opentelemetry/instrumentation-fetch');
+                return new m.FetchInstrumentation();
+            },
+        },
+    ];
+}
+/**
+ * Best-effort: register OTel auto-instrumentations if the user has them
+ * installed. This is optional — users can also configure OTel themselves and
+ * pass `otelAdapter(processor)` as a span processor.
+ *
+ * Returns the list of instrumentation ids that were successfully registered.
+ *
+ * Vercel AI SDK note: if you set `experimental_telemetry: { isEnabled: true,
+ * tracer: trace.getTracer('ai') }` on generateText/streamText calls, those
+ * spans flow through the SDK-registered OTel SpanProcessor automatically.
+ */
+export function enableAutoInstrument(opts) {
+    const disabled = new Set(opts.disable || []);
+    const active = [];
+    try {
+        // eslint-disable-next-line @typescript-eslint/no-var-requires
+        const { NodeSDK } = require('@opentelemetry/sdk-node');
+        // eslint-disable-next-line @typescript-eslint/no-var-requires
+        const { Resource } = require('@opentelemetry/resources');
+        const instrumentations = [];
+        for (const spec of buildInstrumentors()) {
+            if (disabled.has(spec.id))
+                continue;
+            try {
+                instrumentations.push(spec.factory());
+                active.push(spec.id);
+            }
+            catch {
+                /* package not installed — skip */
+            }
+        }
+        const sdk = new NodeSDK({
+            resource: new Resource({ 'service.name': 'trodo-agent' }),
+            spanProcessor: otelAdapter(opts.processor),
+            instrumentations,
+        });
+        sdk.start();
+    }
+    catch {
+        // @opentelemetry/sdk-node not installed; wrapAgent + withSpan still work.
+    }
+    return active;
+}
+//# sourceMappingURL=autoInstrument.js.map

package/dist/esm/otel/autoInstrument.js.map

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

package/dist/esm/otel/context.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Run/span active-context — used by wrapAgent, joinRun, and withSpan to
+ * thread parent_span_id and run_id through nested function calls without
+ * the user touching IDs.
+ *
+ * Backed by AsyncLocalStorage in Node (Node >= 14). Falls back to a global
+ * store in other runtimes (best-effort — only the top of each call chain
+ * is preserved).
+ *
+ * When a user registers a real OpenTelemetry SDK, their OTel ContextManager
+ * supersedes this for cross-package propagation. This lightweight store is
+ * the baseline so wrapAgent works without any external OTel dependency.
+ */
+import type { TrodoSpanProcessor } from './processor.js';
+export interface ActiveSpanContext {
+    runId: string;
+    spanId: string;
+    parentSpanId: string | null;
+    teamSiteId: string;
+    processor: TrodoSpanProcessor;
+}
+export declare function getActiveContext(): ActiveSpanContext | null;
+export declare function runWithContext<R>(ctx: ActiveSpanContext, fn: () => R): R;
+/** Async variant — context is preserved across awaits via AsyncLocalStorage. */
+export declare function runWithContextAsync<R>(ctx: ActiveSpanContext, fn: () => Promise<R>): Promise<R>;
+//# sourceMappingURL=context.d.ts.map

package/dist/esm/otel/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../../src/otel/context.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAEzD,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,kBAAkB,CAAC;CAC/B;AAsBD,wBAAgB,gBAAgB,IAAI,iBAAiB,GAAG,IAAI,CAG3D;AAED,wBAAgB,cAAc,CAAC,CAAC,EAAE,GAAG,EAAE,iBAAiB,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,CASxE;AAED,gFAAgF;AAChF,wBAAgB,mBAAmB,CAAC,CAAC,EACnC,GAAG,EAAE,iBAAiB,EACtB,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GACnB,OAAO,CAAC,CAAC,CAAC,CAOZ"}

package/dist/esm/otel/context.js

@@ -0,0 +1,44 @@
+let AsyncLocalStorageCtor = null;
+try {
+    // eslint-disable-next-line @typescript-eslint/no-var-requires
+    AsyncLocalStorageCtor = require('node:async_hooks').AsyncLocalStorage;
+}
+catch {
+    try {
+        // eslint-disable-next-line @typescript-eslint/no-var-requires
+        AsyncLocalStorageCtor = require('async_hooks').AsyncLocalStorage;
+    }
+    catch {
+        AsyncLocalStorageCtor = null;
+    }
+}
+const als = AsyncLocalStorageCtor ? new AsyncLocalStorageCtor() : null;
+let fallbackStore = null;
+export function getActiveContext() {
+    if (als)
+        return als.getStore() ?? null;
+    return fallbackStore;
+}
+export function runWithContext(ctx, fn) {
+    if (als)
+        return als.run(ctx, fn);
+    const prev = fallbackStore;
+    fallbackStore = ctx;
+    try {
+        return fn();
+    }
+    finally {
+        fallbackStore = prev;
+    }
+}
+/** Async variant — context is preserved across awaits via AsyncLocalStorage. */
+export function runWithContextAsync(ctx, fn) {
+    if (als)
+        return als.run(ctx, fn);
+    const prev = fallbackStore;
+    fallbackStore = ctx;
+    return fn().finally(() => {
+        fallbackStore = prev;
+    });
+}
+//# sourceMappingURL=context.js.map

package/dist/esm/otel/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../../src/otel/context.ts"],"names":[],"mappings":"AAuBA,IAAI,qBAAqB,GAGb,IAAI,CAAC;AAEjB,IAAI,CAAC;IACH,8DAA8D;IAC9D,qBAAqB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAC,iBAAiB,CAAC;AACxE,CAAC;AAAC,MAAM,CAAC;IACP,IAAI,CAAC;QACH,8DAA8D;QAC9D,qBAAqB,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC,iBAAiB,CAAC;IACnE,CAAC;IAAC,MAAM,CAAC;QACP,qBAAqB,GAAG,IAAI,CAAC;IAC/B,CAAC;AACH,CAAC;AAED,MAAM,GAAG,GAAG,qBAAqB,CAAC,CAAC,CAAC,IAAI,qBAAqB,EAAqB,CAAC,CAAC,CAAC,IAAI,CAAC;AAC1F,IAAI,aAAa,GAA6B,IAAI,CAAC;AAEnD,MAAM,UAAU,gBAAgB;IAC9B,IAAI,GAAG;QAAE,OAAO,GAAG,CAAC,QAAQ,EAAE,IAAI,IAAI,CAAC;IACvC,OAAO,aAAa,CAAC;AACvB,CAAC;AAED,MAAM,UAAU,cAAc,CAAI,GAAsB,EAAE,EAAW;IACnE,IAAI,GAAG;QAAE,OAAO,GAAG,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;IACjC,MAAM,IAAI,GAAG,aAAa,CAAC;IAC3B,aAAa,GAAG,GAAG,CAAC;IACpB,IAAI,CAAC;QACH,OAAO,EAAE,EAAE,CAAC;IACd,CAAC;YAAS,CAAC;QACT,aAAa,GAAG,IAAI,CAAC;IACvB,CAAC;AACH,CAAC;AAED,gFAAgF;AAChF,MAAM,UAAU,mBAAmB,CACjC,GAAsB,EACtB,EAAoB;IAEpB,IAAI,GAAG;QAAE,OAAO,GAAG,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;IACjC,MAAM,IAAI,GAAG,aAAa,CAAC;IAC3B,aAAa,GAAG,GAAG,CAAC;IACpB,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,EAAE;QACvB,aAAa,GAAG,IAAI,CAAC;IACvB,CAAC,CAAC,CAAC;AACL,CAAC"}