trodo-node 1.2.0 → 2.2.0

package/dist/esm/otel/uuid.js

@@ -0,0 +1,21 @@
+/**
+ * RFC4122 v4 UUIDs — used for run_id, span_id, parent_span_id.
+ * Uses the runtime's crypto.randomUUID when available, falls back to a
+ * Math.random-based generator so we don't pull in a dependency for tests.
+ */
+export function uuidv4() {
+    try {
+        const c = globalThis.crypto;
+        if (c?.randomUUID)
+            return c.randomUUID();
+    }
+    catch {
+        /* fall through */
+    }
+    return 'xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx'.replace(/[xy]/g, (ch) => {
+        const r = (Math.random() * 16) | 0;
+        const v = ch === 'x' ? r : (r & 0x3) | 0x8;
+        return v.toString(16);
+    });
+}
+//# sourceMappingURL=uuid.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"uuid.js","sourceRoot":"","sources":["../../../src/otel/uuid.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,UAAU,MAAM;IACpB,IAAI,CAAC;QACH,MAAM,CAAC,GAAI,UAAyD,CAAC,MAAM,CAAC;QAC5E,IAAI,CAAC,EAAE,UAAU;YAAE,OAAO,CAAC,CAAC,UAAU,EAAE,CAAC;IAC3C,CAAC;IAAC,MAAM,CAAC;QACP,kBAAkB;IACpB,CAAC;IACD,OAAO,sCAAsC,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC,EAAE,EAAE,EAAE;QACpE,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC;QACnC,MAAM,CAAC,GAAG,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,GAAG,GAAG,CAAC;QAC3C,OAAO,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;IACxB,CAAC,CAAC,CAAC;AACL,CAAC"}

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

@@ -0,0 +1,133 @@
+import type { TrodoSpanProcessor, TrodoSpan } from './processor.js';
+export interface WrapAgentOptions {
+    distinctId?: string | null;
+    conversationId?: string | null;
+    parentRunId?: string | null;
+    metadata?: Record<string, unknown>;
+}
+export interface WrapAgentResult<R> {
+    result: R;
+    runId: string;
+}
+export interface WithSpanOptions {
+    kind?: TrodoSpan['kind'];
+    input?: unknown;
+    attributes?: Record<string, unknown>;
+}
+export interface JoinRunOptions {
+    name?: string;
+    kind?: TrodoSpan['kind'];
+    input?: unknown;
+    attributes?: Record<string, unknown>;
+}
+/** Return the currently active run_id, if any. */
+export declare function currentRunId(): string | null;
+/** Return the currently active span_id, if any. */
+export declare function currentSpanId(): string | null;
+/**
+ * RunHandle — returned by wrapAgent so callers can set input/output after
+ * inspecting the arguments / result. Mirrors the Python RunHandle API.
+ */
+export declare class RunHandle {
+    readonly runId: string;
+    readonly agentName: string;
+    input?: string;
+    output?: string;
+    metadata: Record<string, unknown>;
+    constructor(runId: string, agentName: string);
+    setInput(value: unknown): void;
+    setOutput(value: unknown): void;
+    setMetadata(extra: Record<string, unknown>): void;
+}
+/**
+ * SpanHandle — returned by withSpan / joinRun. Collect LLM model/token/cost
+ * info and tool name here; the processor picks them up at span close.
+ */
+export declare class SpanHandle {
+    readonly spanId: string;
+    readonly name: string;
+    input?: string;
+    output?: string;
+    attributes: Record<string, unknown>;
+    model?: string;
+    provider?: string;
+    inputTokens?: number;
+    outputTokens?: number;
+    cost?: number;
+    temperature?: number;
+    toolName?: string;
+    constructor(spanId: string, name: string);
+    setInput(value: unknown): void;
+    setOutput(value: unknown): void;
+    setAttribute(key: string, value: unknown): void;
+    setLlm(opts: {
+        model?: string;
+        provider?: string;
+        inputTokens?: number;
+        outputTokens?: number;
+        cost?: number;
+        temperature?: number;
+    }): void;
+    setTool(name: string): void;
+}
+export interface StartRunOptions {
+    runId?: string;
+    distinctId?: string | null;
+    conversationId?: string | null;
+    parentRunId?: string | null;
+    metadata?: Record<string, unknown>;
+    input?: unknown;
+}
+export interface EndRunOptions {
+    output?: unknown;
+    status?: 'ok' | 'error';
+    errorSummary?: string;
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Open a Run record without holding a context manager.
+ *
+ * Pairs with {@link endRun} for sessions that span multiple processes or HTTP
+ * requests (e.g. an MCP server where ``initialize`` opens a run and later
+ * ``tools/call`` requests append spans before a final close).
+ *
+ * Returns the runId (caller-supplied or freshly minted). Between startRun and
+ * endRun any process can use ``joinRun(runId, ...)`` to add spans — they flush
+ * incrementally via append_spans.
+ */
+export declare function startRun(processor: TrodoSpanProcessor, agentName: string, options?: StartRunOptions): Promise<string>;
+/**
+ * Finalise a Run opened by {@link startRun}.
+ *
+ * Aggregates any locally-buffered spans for `runId`, POSTs to
+ * `/runs/{id}/end`, and unmarks the run as joined.
+ */
+export declare function endRun(processor: TrodoSpanProcessor, runId: string, options?: EndRunOptions): Promise<void>;
+/**
+ * Wrap an async function as an agent run. Every OTel span (or withSpan call)
+ * created inside `fn` is auto-nested under the run via AsyncLocalStorage.
+ *
+ * The callback receives a RunHandle so it can call `handle.setInput(...)` /
+ * `handle.setOutput(...)`. Old-style callbacks (no arg) still work.
+ */
+export declare function wrapAgent<R>(processor: TrodoSpanProcessor, teamSiteId: string, agentName: string, fn: (handle: RunHandle) => Promise<R> | R, options?: WrapAgentOptions): Promise<WrapAgentResult<R>>;
+/**
+ * Create a nested span for non-auto-instrumented work (KB lookups, custom
+ * tools, computation). Requires an enclosing wrapAgent/joinRun.
+ *
+ * The callback receives a SpanHandle so the caller can record LLM tokens /
+ * tool name / output inside the function body.
+ */
+export declare function withSpan<R>(_processor: TrodoSpanProcessor, name: string, fn: (handle: SpanHandle) => Promise<R> | R, options?: WithSpanOptions): Promise<R>;
+/**
+ * Join an existing agent run owned by a remote service. Opens a SPAN (not a
+ * run) under ``parentSpanId``; every span produced inside ``fn`` — including
+ * OTel auto-instrumented LLM spans — flushes to the backend as a child of
+ * the caller's run via append_spans. We never ingest a run here.
+ *
+ * Typical use: Express/FastAPI middleware detects ``X-Trodo-Run-Id`` +
+ * ``X-Trodo-Parent-Span-Id`` on an inbound request and wraps the handler
+ * with joinRun so the handler's work nests under the caller's run.
+ */
+export declare function joinRun<R>(processor: TrodoSpanProcessor, teamSiteId: string, runId: string, parentSpanId: string | null, fn: (handle: SpanHandle) => Promise<R> | R, options?: JoinRunOptions): Promise<R>;
+//# sourceMappingURL=wrapAgent.d.ts.map

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

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

package/dist/esm/otel/wrapAgent.js

@@ -0,0 +1,448 @@
+/**
+ * wrapAgent / withSpan / joinRun — user-facing surface for agent tracking.
+ *
+ * Users never generate IDs. The SDK creates run_id on wrapAgent, threads a
+ * span_id through AsyncLocalStorage, and any nested withSpan (or OTel
+ * auto-instrumented span from Anthropic/OpenAI/Vercel AI SDK/LangChain)
+ * inherits the current span as its parent.
+ *
+ * joinRun is for downstream microservices: opens a SPAN (not a run) in the
+ * context of the caller's run_id, flushing each span to the backend via
+ * append_spans. The originating service owns run lifecycle.
+ */
+import { uuidv4 } from './uuid.js';
+import { getActiveContext, runWithContextAsync, } from './context.js';
+function nowIso() {
+    return new Date().toISOString();
+}
+function truncate(value, max = 64000) {
+    if (value == null)
+        return undefined;
+    const str = typeof value === 'string' ? value : safeJson(value);
+    return str.length > max ? str.slice(0, max) : str;
+}
+function safeJson(v) {
+    try {
+        return JSON.stringify(v);
+    }
+    catch {
+        return String(v);
+    }
+}
+/** Return the currently active run_id, if any. */
+export function currentRunId() {
+    return getActiveContext()?.runId ?? null;
+}
+/** Return the currently active span_id, if any. */
+export function currentSpanId() {
+    return getActiveContext()?.spanId ?? null;
+}
+function aggregate(spans) {
+    let totalIn = 0;
+    let totalOut = 0;
+    let totalCost = 0;
+    let toolCount = 0;
+    let errorCount = 0;
+    for (const s of spans) {
+        if (s.input_tokens)
+            totalIn += Number(s.input_tokens);
+        if (s.output_tokens)
+            totalOut += Number(s.output_tokens);
+        if (s.cost)
+            totalCost += Number(s.cost);
+        if (s.kind === 'tool')
+            toolCount += 1;
+        if (s.status === 'error')
+            errorCount += 1;
+    }
+    return {
+        total_tokens_in: totalIn,
+        total_tokens_out: totalOut,
+        total_cost: totalCost ? Math.round(totalCost * 1e8) / 1e8 : 0,
+        span_count: spans.length,
+        tool_count: toolCount,
+        error_count: errorCount,
+    };
+}
+/**
+ * RunHandle — returned by wrapAgent so callers can set input/output after
+ * inspecting the arguments / result. Mirrors the Python RunHandle API.
+ */
+export class RunHandle {
+    constructor(runId, agentName) {
+        this.metadata = {};
+        this.runId = runId;
+        this.agentName = agentName;
+    }
+    setInput(value) {
+        this.input = truncate(value);
+    }
+    setOutput(value) {
+        this.output = truncate(value);
+    }
+    setMetadata(extra) {
+        Object.assign(this.metadata, extra);
+    }
+}
+/**
+ * SpanHandle — returned by withSpan / joinRun. Collect LLM model/token/cost
+ * info and tool name here; the processor picks them up at span close.
+ */
+export class SpanHandle {
+    constructor(spanId, name) {
+        this.attributes = {};
+        this.spanId = spanId;
+        this.name = name;
+    }
+    setInput(value) {
+        this.input = truncate(value);
+    }
+    setOutput(value) {
+        this.output = truncate(value);
+    }
+    setAttribute(key, value) {
+        this.attributes[key] = value;
+    }
+    setLlm(opts) {
+        if (opts.model !== undefined)
+            this.model = opts.model;
+        if (opts.provider !== undefined)
+            this.provider = opts.provider;
+        if (opts.inputTokens !== undefined)
+            this.inputTokens = Number(opts.inputTokens);
+        if (opts.outputTokens !== undefined)
+            this.outputTokens = Number(opts.outputTokens);
+        if (opts.cost !== undefined)
+            this.cost = Number(opts.cost);
+        if (opts.temperature !== undefined)
+            this.temperature = Number(opts.temperature);
+    }
+    setTool(name) {
+        this.toolName = name;
+    }
+}
+/**
+ * Open a Run record without holding a context manager.
+ *
+ * Pairs with {@link endRun} for sessions that span multiple processes or HTTP
+ * requests (e.g. an MCP server where ``initialize`` opens a run and later
+ * ``tools/call`` requests append spans before a final close).
+ *
+ * Returns the runId (caller-supplied or freshly minted). Between startRun and
+ * endRun any process can use ``joinRun(runId, ...)`` to add spans — they flush
+ * incrementally via append_spans.
+ */
+export async function startRun(processor, agentName, options = {}) {
+    const runId = options.runId || uuidv4();
+    const run = {
+        run_id: runId,
+        agent_name: agentName,
+        distinct_id: options.distinctId ?? null,
+        conversation_id: options.conversationId ?? null,
+        parent_run_id: options.parentRunId ?? null,
+        status: 'running',
+        input: truncate(options.input),
+        started_at: nowIso(),
+        metadata: options.metadata,
+    };
+    processor.markJoined(runId);
+    await processor.startRun(run);
+    return runId;
+}
+/**
+ * Finalise a Run opened by {@link startRun}.
+ *
+ * Aggregates any locally-buffered spans for `runId`, POSTs to
+ * `/runs/{id}/end`, and unmarks the run as joined.
+ */
+export async function endRun(processor, runId, options = {}) {
+    const pending = processor.getPending(runId);
+    const agg = aggregate(pending);
+    const payload = {
+        ended_at: nowIso(),
+        status: options.status ?? 'ok',
+        total_tokens_in: agg.total_tokens_in,
+        total_tokens_out: agg.total_tokens_out,
+        total_cost: agg.total_cost,
+        span_count: agg.span_count,
+        tool_count: agg.tool_count,
+        error_count: agg.error_count,
+    };
+    if (options.output !== undefined) {
+        payload.output = truncate(options.output);
+    }
+    if (options.errorSummary !== undefined) {
+        payload.error_summary = truncate(options.errorSummary, 4000);
+    }
+    if (options.metadata !== undefined) {
+        payload.metadata = options.metadata;
+    }
+    await processor.endRun(runId, payload);
+    processor.unmarkJoined(runId);
+}
+/**
+ * Wrap an async function as an agent run. Every OTel span (or withSpan call)
+ * created inside `fn` is auto-nested under the run via AsyncLocalStorage.
+ *
+ * The callback receives a RunHandle so it can call `handle.setInput(...)` /
+ * `handle.setOutput(...)`. Old-style callbacks (no arg) still work.
+ */
+export async function wrapAgent(processor, teamSiteId, agentName, fn, options = {}) {
+    const runId = uuidv4();
+    const rootSpanId = uuidv4();
+    const startedAt = nowIso();
+    const startedMs = Date.now();
+    const handle = new RunHandle(runId, agentName);
+    const ctx = {
+        runId,
+        spanId: rootSpanId,
+        parentSpanId: null,
+        teamSiteId,
+        processor,
+    };
+    let status = 'ok';
+    let output;
+    let errorSummary;
+    let result;
+    try {
+        result = await runWithContextAsync(ctx, async () => fn(handle));
+        output = handle.output ?? truncate(result);
+    }
+    catch (err) {
+        status = 'error';
+        errorSummary = truncate(err?.message ?? String(err), 4000);
+        const pending = processor.getPending(runId);
+        const agg = aggregate(pending);
+        const run = {
+            run_id: runId,
+            agent_name: agentName,
+            distinct_id: options.distinctId ?? null,
+            conversation_id: options.conversationId ?? null,
+            parent_run_id: options.parentRunId ?? null,
+            status,
+            input: handle.input,
+            started_at: startedAt,
+            ended_at: nowIso(),
+            duration_ms: Date.now() - startedMs,
+            error_summary: errorSummary,
+            metadata: { ...(options.metadata || {}), ...handle.metadata },
+            total_tokens_in: agg.total_tokens_in,
+            total_tokens_out: agg.total_tokens_out,
+            total_cost: agg.total_cost,
+            span_count: agg.span_count,
+            tool_count: agg.tool_count,
+            error_count: agg.error_count,
+        };
+        await processor.ingestRun(run);
+        throw err;
+    }
+    const pending = processor.getPending(runId);
+    const agg = aggregate(pending);
+    const run = {
+        run_id: runId,
+        agent_name: agentName,
+        distinct_id: options.distinctId ?? null,
+        conversation_id: options.conversationId ?? null,
+        parent_run_id: options.parentRunId ?? null,
+        status,
+        input: handle.input,
+        output,
+        started_at: startedAt,
+        ended_at: nowIso(),
+        duration_ms: Date.now() - startedMs,
+        metadata: { ...(options.metadata || {}), ...handle.metadata },
+        total_tokens_in: agg.total_tokens_in,
+        total_tokens_out: agg.total_tokens_out,
+        total_cost: agg.total_cost,
+        span_count: agg.span_count,
+        tool_count: agg.tool_count,
+        error_count: agg.error_count,
+    };
+    await processor.ingestRun(run);
+    return { result, runId };
+}
+/**
+ * Create a nested span for non-auto-instrumented work (KB lookups, custom
+ * tools, computation). Requires an enclosing wrapAgent/joinRun.
+ *
+ * The callback receives a SpanHandle so the caller can record LLM tokens /
+ * tool name / output inside the function body.
+ */
+export async function withSpan(_processor, name, fn, options = {}) {
+    const active = getActiveContext();
+    const spanId = uuidv4();
+    const handle = new SpanHandle(spanId, name);
+    if (options.input !== undefined)
+        handle.setInput(options.input);
+    if (options.attributes)
+        Object.assign(handle.attributes, options.attributes);
+    if (!active) {
+        // Outside of a run — execute but skip tracking (don't crash user code).
+        return Promise.resolve(fn(handle));
+    }
+    const startedAt = nowIso();
+    const startedMs = Date.now();
+    const child = {
+        runId: active.runId,
+        spanId,
+        parentSpanId: active.spanId,
+        teamSiteId: active.teamSiteId,
+        processor: active.processor,
+    };
+    let status = 'ok';
+    let errorType;
+    let errorMessage;
+    try {
+        const result = await runWithContextAsync(child, async () => fn(handle));
+        if (handle.output === undefined)
+            handle.setOutput(result);
+        const span = {
+            span_id: spanId,
+            run_id: active.runId,
+            parent_span_id: active.spanId,
+            kind: options.kind || 'generic',
+            name,
+            status,
+            started_at: startedAt,
+            ended_at: nowIso(),
+            duration_ms: Date.now() - startedMs,
+            input: handle.input,
+            output: handle.output,
+            model: handle.model,
+            provider: handle.provider,
+            input_tokens: handle.inputTokens,
+            output_tokens: handle.outputTokens,
+            cost: handle.cost,
+            temperature: handle.temperature,
+            tool_name: handle.toolName,
+            attributes: Object.keys(handle.attributes).length ? handle.attributes : undefined,
+        };
+        active.processor.enqueueSpan(span);
+        return result;
+    }
+    catch (err) {
+        status = 'error';
+        errorType = err?.name || 'Error';
+        errorMessage = truncate(err?.message ?? String(err), 4000);
+        const span = {
+            span_id: spanId,
+            run_id: active.runId,
+            parent_span_id: active.spanId,
+            kind: options.kind || 'generic',
+            name,
+            status,
+            started_at: startedAt,
+            ended_at: nowIso(),
+            duration_ms: Date.now() - startedMs,
+            input: handle.input,
+            output: handle.output,
+            error_type: errorType,
+            error_message: errorMessage,
+            model: handle.model,
+            provider: handle.provider,
+            input_tokens: handle.inputTokens,
+            output_tokens: handle.outputTokens,
+            cost: handle.cost,
+            temperature: handle.temperature,
+            tool_name: handle.toolName,
+            attributes: Object.keys(handle.attributes).length ? handle.attributes : undefined,
+        };
+        active.processor.enqueueSpan(span);
+        throw err;
+    }
+}
+/**
+ * Join an existing agent run owned by a remote service. Opens a SPAN (not a
+ * run) under ``parentSpanId``; every span produced inside ``fn`` — including
+ * OTel auto-instrumented LLM spans — flushes to the backend as a child of
+ * the caller's run via append_spans. We never ingest a run here.
+ *
+ * Typical use: Express/FastAPI middleware detects ``X-Trodo-Run-Id`` +
+ * ``X-Trodo-Parent-Span-Id`` on an inbound request and wraps the handler
+ * with joinRun so the handler's work nests under the caller's run.
+ */
+export async function joinRun(processor, teamSiteId, runId, parentSpanId, fn, options = {}) {
+    const spanId = uuidv4();
+    const name = options.name || 'remote.handler';
+    const kind = options.kind || 'agent';
+    const handle = new SpanHandle(spanId, name);
+    if (options.input !== undefined)
+        handle.setInput(options.input);
+    if (options.attributes)
+        Object.assign(handle.attributes, options.attributes);
+    processor.markJoined(runId);
+    const startedAt = nowIso();
+    const startedMs = Date.now();
+    const ctx = {
+        runId,
+        spanId,
+        parentSpanId: parentSpanId ?? null,
+        teamSiteId,
+        processor,
+    };
+    let status = 'ok';
+    let errorType;
+    let errorMessage;
+    try {
+        const result = await runWithContextAsync(ctx, async () => fn(handle));
+        if (handle.output === undefined)
+            handle.setOutput(result);
+        const span = {
+            span_id: spanId,
+            run_id: runId,
+            parent_span_id: parentSpanId ?? null,
+            kind,
+            name,
+            status,
+            started_at: startedAt,
+            ended_at: nowIso(),
+            duration_ms: Date.now() - startedMs,
+            input: handle.input,
+            output: handle.output,
+            model: handle.model,
+            provider: handle.provider,
+            input_tokens: handle.inputTokens,
+            output_tokens: handle.outputTokens,
+            cost: handle.cost,
+            temperature: handle.temperature,
+            tool_name: handle.toolName,
+            attributes: Object.keys(handle.attributes).length ? handle.attributes : undefined,
+        };
+        await processor.appendSpans(runId, [span]);
+        return result;
+    }
+    catch (err) {
+        status = 'error';
+        errorType = err?.name || 'Error';
+        errorMessage = truncate(err?.message ?? String(err), 4000);
+        const span = {
+            span_id: spanId,
+            run_id: runId,
+            parent_span_id: parentSpanId ?? null,
+            kind,
+            name,
+            status,
+            started_at: startedAt,
+            ended_at: nowIso(),
+            duration_ms: Date.now() - startedMs,
+            input: handle.input,
+            output: handle.output,
+            error_type: errorType,
+            error_message: errorMessage,
+            model: handle.model,
+            provider: handle.provider,
+            input_tokens: handle.inputTokens,
+            output_tokens: handle.outputTokens,
+            cost: handle.cost,
+            temperature: handle.temperature,
+            tool_name: handle.toolName,
+            attributes: Object.keys(handle.attributes).length ? handle.attributes : undefined,
+        };
+        await processor.appendSpans(runId, [span]);
+        throw err;
+    }
+    finally {
+        processor.unmarkJoined(runId);
+    }
+}
+//# sourceMappingURL=wrapAgent.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"wrapAgent.js","sourceRoot":"","sources":["../../../src/otel/wrapAgent.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AACnC,OAAO,EACL,gBAAgB,EAEhB,mBAAmB,GAEpB,MAAM,cAAc,CAAC;AA4BtB,SAAS,MAAM;IACb,OAAO,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;AAClC,CAAC;AAED,SAAS,QAAQ,CAAC,KAAc,EAAE,GAAG,GAAG,KAAM;IAC5C,IAAI,KAAK,IAAI,IAAI;QAAE,OAAO,SAAS,CAAC;IACpC,MAAM,GAAG,GAAG,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IAChE,OAAO,GAAG,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;AACpD,CAAC;AAED,SAAS,QAAQ,CAAC,CAAU;IAC1B,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;IAC3B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,MAAM,CAAC,CAAC,CAAC,CAAC;IACnB,CAAC;AACH,CAAC;AAED,kDAAkD;AAClD,MAAM,UAAU,YAAY;IAC1B,OAAO,gBAAgB,EAAE,EAAE,KAAK,IAAI,IAAI,CAAC;AAC3C,CAAC;AAED,mDAAmD;AACnD,MAAM,UAAU,aAAa;IAC3B,OAAO,gBAAgB,EAAE,EAAE,MAAM,IAAI,IAAI,CAAC;AAC5C,CAAC;AAWD,SAAS,SAAS,CAAC,KAAkB;IACnC,IAAI,OAAO,GAAG,CAAC,CAAC;IAChB,IAAI,QAAQ,GAAG,CAAC,CAAC;IACjB,IAAI,SAAS,GAAG,CAAC,CAAC;IAClB,IAAI,SAAS,GAAG,CAAC,CAAC;IAClB,IAAI,UAAU,GAAG,CAAC,CAAC;IACnB,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;QACtB,IAAI,CAAC,CAAC,YAAY;YAAE,OAAO,IAAI,MAAM,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC;QACtD,IAAI,CAAC,CAAC,aAAa;YAAE,QAAQ,IAAI,MAAM,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC;QACzD,IAAI,CAAC,CAAC,IAAI;YAAE,SAAS,IAAI,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QACxC,IAAI,CAAC,CAAC,IAAI,KAAK,MAAM;YAAE,SAAS,IAAI,CAAC,CAAC;QACtC,IAAI,CAAC,CAAC,MAAM,KAAK,OAAO;YAAE,UAAU,IAAI,CAAC,CAAC;IAC5C,CAAC;IACD,OAAO;QACL,eAAe,EAAE,OAAO;QACxB,gBAAgB,EAAE,QAAQ;QAC1B,UAAU,EAAE,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,SAAS,GAAG,GAAG,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC;QAC7D,UAAU,EAAE,KAAK,CAAC,MAAM;QACxB,UAAU,EAAE,SAAS;QACrB,WAAW,EAAE,UAAU;KACxB,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,OAAO,SAAS;IAOpB,YAAY,KAAa,EAAE,SAAiB;QAF5C,aAAQ,GAA4B,EAAE,CAAC;QAGrC,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;IAC7B,CAAC;IAED,QAAQ,CAAC,KAAc;QACrB,IAAI,CAAC,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IAC/B,CAAC;IAED,SAAS,CAAC,KAAc;QACtB,IAAI,CAAC,MAAM,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IAChC,CAAC;IAED,WAAW,CAAC,KAA8B;QACxC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;IACtC,CAAC;CACF;AAED;;;GAGG;AACH,MAAM,OAAO,UAAU;IAcrB,YAAY,MAAc,EAAE,IAAY;QATxC,eAAU,GAA4B,EAAE,CAAC;QAUvC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;IAED,QAAQ,CAAC,KAAc;QACrB,IAAI,CAAC,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IAC/B,CAAC;IAED,SAAS,CAAC,KAAc;QACtB,IAAI,CAAC,MAAM,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IAChC,CAAC;IAED,YAAY,CAAC,GAAW,EAAE,KAAc;QACtC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;IAC/B,CAAC;IAED,MAAM,CAAC,IAON;QACC,IAAI,IAAI,CAAC,KAAK,KAAK,SAAS;YAAE,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;QACtD,IAAI,IAAI,CAAC,QAAQ,KAAK,SAAS;YAAE,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC;QAC/D,IAAI,IAAI,CAAC,WAAW,KAAK,SAAS;YAAE,IAAI,CAAC,WAAW,GAAG,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QAChF,IAAI,IAAI,CAAC,YAAY,KAAK,SAAS;YAAE,IAAI,CAAC,YAAY,GAAG,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QACnF,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS;YAAE,IAAI,CAAC,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC3D,IAAI,IAAI,CAAC,WAAW,KAAK,SAAS;YAAE,IAAI,CAAC,WAAW,GAAG,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IAClF,CAAC;IAED,OAAO,CAAC,IAAY;QAClB,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;IACvB,CAAC;CACF;AAkBD;;;;;;;;;;GAUG;AACH,MAAM,CAAC,KAAK,UAAU,QAAQ,CAC5B,SAA6B,EAC7B,SAAiB,EACjB,UAA2B,EAAE;IAE7B,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,MAAM,EAAE,CAAC;IACxC,MAAM,GAAG,GAAa;QACpB,MAAM,EAAE,KAAK;QACb,UAAU,EAAE,SAAS;QACrB,WAAW,EAAE,OAAO,CAAC,UAAU,IAAI,IAAI;QACvC,eAAe,EAAE,OAAO,CAAC,cAAc,IAAI,IAAI;QAC/C,aAAa,EAAE,OAAO,CAAC,WAAW,IAAI,IAAI;QAC1C,MAAM,EAAE,SAAS;QACjB,KAAK,EAAE,QAAQ,CAAC,OAAO,CAAC,KAAK,CAAC;QAC9B,UAAU,EAAE,MAAM,EAAE;QACpB,QAAQ,EAAE,OAAO,CAAC,QAAQ;KAC3B,CAAC;IACF,SAAS,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;IAC5B,MAAM,SAAS,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;IAC9B,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,MAAM,CAC1B,SAA6B,EAC7B,KAAa,EACb,UAAyB,EAAE;IAE3B,MAAM,OAAO,GAAG,SAAS,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;IAC5C,MAAM,GAAG,GAAG,SAAS,CAAC,OAAO,CAAC,CAAC;IAC/B,MAAM,OAAO,GAA4B;QACvC,QAAQ,EAAE,MAAM,EAAE;QAClB,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,IAAI;QAC9B,eAAe,EAAE,GAAG,CAAC,eAAe;QACpC,gBAAgB,EAAE,GAAG,CAAC,gBAAgB;QACtC,UAAU,EAAE,GAAG,CAAC,UAAU;QAC1B,UAAU,EAAE,GAAG,CAAC,UAAU;QAC1B,UAAU,EAAE,GAAG,CAAC,UAAU;QAC1B,WAAW,EAAE,GAAG,CAAC,WAAW;KAC7B,CAAC;IACF,IAAI,OAAO,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;QACjC,OAAO,CAAC,MAAM,GAAG,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IAC5C,CAAC;IACD,IAAI,OAAO,CAAC,YAAY,KAAK,SAAS,EAAE,CAAC;QACvC,OAAO,CAAC,aAAa,GAAG,QAAQ,CAAC,OAAO,CAAC,YAAY,EAAE,IAAK,CAAC,CAAC;IAChE,CAAC;IACD,IAAI,OAAO,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;QACnC,OAAO,CAAC,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;IACtC,CAAC;IACD,MAAM,SAAS,CAAC,MAAM,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IACvC,SAAS,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC;AAChC,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAC7B,SAA6B,EAC7B,UAAkB,EAClB,SAAiB,EACjB,EAAyC,EACzC,UAA4B,EAAE;IAE9B,MAAM,KAAK,GAAG,MAAM,EAAE,CAAC;IACvB,MAAM,UAAU,GAAG,MAAM,EAAE,CAAC;IAC5B,MAAM,SAAS,GAAG,MAAM,EAAE,CAAC;IAC3B,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAC7B,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;IAE/C,MAAM,GAAG,GAAsB;QAC7B,KAAK;QACL,MAAM,EAAE,UAAU;QAClB,YAAY,EAAE,IAAI;QAClB,UAAU;QACV,SAAS;KACV,CAAC;IAEF,IAAI,MAAM,GAAmB,IAAI,CAAC;IAClC,IAAI,MAA0B,CAAC;IAC/B,IAAI,YAAgC,CAAC;IACrC,IAAI,MAAS,CAAC;IAEd,IAAI,CAAC;QACH,MAAM,GAAG,MAAM,mBAAmB,CAAC,GAAG,EAAE,KAAK,IAAI,EAAE,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC;QAChE,MAAM,GAAG,MAAM,CAAC,MAAM,IAAI,QAAQ,CAAC,MAAM,CAAC,CAAC;IAC7C,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,GAAG,OAAO,CAAC;QACjB,YAAY,GAAG,QAAQ,CAAE,GAAa,EAAE,OAAO,IAAI,MAAM,CAAC,GAAG,CAAC,EAAE,IAAK,CAAC,CAAC;QACvE,MAAM,OAAO,GAAG,SAAS,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;QAC5C,MAAM,GAAG,GAAG,SAAS,CAAC,OAAO,CAAC,CAAC;QAC/B,MAAM,GAAG,GAAa;YACpB,MAAM,EAAE,KAAK;YACb,UAAU,EAAE,SAAS;YACrB,WAAW,EAAE,OAAO,CAAC,UAAU,IAAI,IAAI;YACvC,eAAe,EAAE,OAAO,CAAC,cAAc,IAAI,IAAI;YAC/C,aAAa,EAAE,OAAO,CAAC,WAAW,IAAI,IAAI;YAC1C,MAAM;YACN,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,UAAU,EAAE,SAAS;YACrB,QAAQ,EAAE,MAAM,EAAE;YAClB,WAAW,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;YACnC,aAAa,EAAE,YAAY;YAC3B,QAAQ,EAAE,EAAE,GAAG,CAAC,OAAO,CAAC,QAAQ,IAAI,EAAE,CAAC,EAAE,GAAG,MAAM,CAAC,QAAQ,EAAE;YAC7D,eAAe,EAAE,GAAG,CAAC,eAAe;YACpC,gBAAgB,EAAE,GAAG,CAAC,gBAAgB;YACtC,UAAU,EAAE,GAAG,CAAC,UAAU;YAC1B,UAAU,EAAE,GAAG,CAAC,UAAU;YAC1B,UAAU,EAAE,GAAG,CAAC,UAAU;YAC1B,WAAW,EAAE,GAAG,CAAC,WAAW;SAC7B,CAAC;QACF,MAAM,SAAS,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;QAC/B,MAAM,GAAG,CAAC;IACZ,CAAC;IAED,MAAM,OAAO,GAAG,SAAS,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;IAC5C,MAAM,GAAG,GAAG,SAAS,CAAC,OAAO,CAAC,CAAC;IAC/B,MAAM,GAAG,GAAa;QACpB,MAAM,EAAE,KAAK;QACb,UAAU,EAAE,SAAS;QACrB,WAAW,EAAE,OAAO,CAAC,UAAU,IAAI,IAAI;QACvC,eAAe,EAAE,OAAO,CAAC,cAAc,IAAI,IAAI;QAC/C,aAAa,EAAE,OAAO,CAAC,WAAW,IAAI,IAAI;QAC1C,MAAM;QACN,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,MAAM;QACN,UAAU,EAAE,SAAS;QACrB,QAAQ,EAAE,MAAM,EAAE;QAClB,WAAW,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;QACnC,QAAQ,EAAE,EAAE,GAAG,CAAC,OAAO,CAAC,QAAQ,IAAI,EAAE,CAAC,EAAE,GAAG,MAAM,CAAC,QAAQ,EAAE;QAC7D,eAAe,EAAE,GAAG,CAAC,eAAe;QACpC,gBAAgB,EAAE,GAAG,CAAC,gBAAgB;QACtC,UAAU,EAAE,GAAG,CAAC,UAAU;QAC1B,UAAU,EAAE,GAAG,CAAC,UAAU;QAC1B,UAAU,EAAE,GAAG,CAAC,UAAU;QAC1B,WAAW,EAAE,GAAG,CAAC,WAAW;KAC7B,CAAC;IACF,MAAM,SAAS,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;IAE/B,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;AAC3B,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,QAAQ,CAC5B,UAA8B,EAC9B,IAAY,EACZ,EAA0C,EAC1C,UAA2B,EAAE;IAE7B,MAAM,MAAM,GAAG,gBAAgB,EAAE,CAAC;IAClC,MAAM,MAAM,GAAG,MAAM,EAAE,CAAC;IACxB,MAAM,MAAM,GAAG,IAAI,UAAU,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IAC5C,IAAI,OAAO,CAAC,KAAK,KAAK,SAAS;QAAE,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IAChE,IAAI,OAAO,CAAC,UAAU;QAAE,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,UAAU,EAAE,OAAO,CAAC,UAAU,CAAC,CAAC;IAE7E,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,wEAAwE;QACxE,OAAO,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC;IACrC,CAAC;IAED,MAAM,SAAS,GAAG,MAAM,EAAE,CAAC;IAC3B,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAC7B,MAAM,KAAK,GAAsB;QAC/B,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,MAAM;QACN,YAAY,EAAE,MAAM,CAAC,MAAM;QAC3B,UAAU,EAAE,MAAM,CAAC,UAAU;QAC7B,SAAS,EAAE,MAAM,CAAC,SAAS;KAC5B,CAAC;IAEF,IAAI,MAAM,GAAmB,IAAI,CAAC;IAClC,IAAI,SAA6B,CAAC;IAClC,IAAI,YAAgC,CAAC;IAErC,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,mBAAmB,CAAC,KAAK,EAAE,KAAK,IAAI,EAAE,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC;QACxE,IAAI,MAAM,CAAC,MAAM,KAAK,SAAS;YAAE,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;QAC1D,MAAM,IAAI,GAAc;YACtB,OAAO,EAAE,MAAM;YACf,MAAM,EAAE,MAAM,CAAC,KAAK;YACpB,cAAc,EAAE,MAAM,CAAC,MAAM;YAC7B,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,SAAS;YAC/B,IAAI;YACJ,MAAM;YACN,UAAU,EAAE,SAAS;YACrB,QAAQ,EAAE,MAAM,EAAE;YAClB,WAAW,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;YACnC,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,YAAY,EAAE,MAAM,CAAC,WAAW;YAChC,aAAa,EAAE,MAAM,CAAC,YAAY;YAClC,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,WAAW,EAAE,MAAM,CAAC,WAAW;YAC/B,SAAS,EAAE,MAAM,CAAC,QAAQ;YAC1B,UAAU,EAAE,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS;SAClF,CAAC;QACF,MAAM,CAAC,SAAS,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;QACnC,OAAO,MAAM,CAAC;IAChB,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,GAAG,OAAO,CAAC;QACjB,SAAS,GAAI,GAAa,EAAE,IAAI,IAAI,OAAO,CAAC;QAC5C,YAAY,GAAG,QAAQ,CAAE,GAAa,EAAE,OAAO,IAAI,MAAM,CAAC,GAAG,CAAC,EAAE,IAAK,CAAC,CAAC;QACvE,MAAM,IAAI,GAAc;YACtB,OAAO,EAAE,MAAM;YACf,MAAM,EAAE,MAAM,CAAC,KAAK;YACpB,cAAc,EAAE,MAAM,CAAC,MAAM;YAC7B,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,SAAS;YAC/B,IAAI;YACJ,MAAM;YACN,UAAU,EAAE,SAAS;YACrB,QAAQ,EAAE,MAAM,EAAE;YAClB,WAAW,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;YACnC,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,UAAU,EAAE,SAAS;YACrB,aAAa,EAAE,YAAY;YAC3B,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,YAAY,EAAE,MAAM,CAAC,WAAW;YAChC,aAAa,EAAE,MAAM,CAAC,YAAY;YAClC,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,WAAW,EAAE,MAAM,CAAC,WAAW;YAC/B,SAAS,EAAE,MAAM,CAAC,QAAQ;YAC1B,UAAU,EAAE,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS;SAClF,CAAC;QACF,MAAM,CAAC,SAAS,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;QACnC,MAAM,GAAG,CAAC;IACZ,CAAC;AACH,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,OAAO,CAC3B,SAA6B,EAC7B,UAAkB,EAClB,KAAa,EACb,YAA2B,EAC3B,EAA0C,EAC1C,UAA0B,EAAE;IAE5B,MAAM,MAAM,GAAG,MAAM,EAAE,CAAC;IACxB,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,IAAI,gBAAgB,CAAC;IAC9C,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,IAAI,OAAO,CAAC;IACrC,MAAM,MAAM,GAAG,IAAI,UAAU,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IAC5C,IAAI,OAAO,CAAC,KAAK,KAAK,SAAS;QAAE,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IAChE,IAAI,OAAO,CAAC,UAAU;QAAE,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,UAAU,EAAE,OAAO,CAAC,UAAU,CAAC,CAAC;IAE7E,SAAS,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;IAC5B,MAAM,SAAS,GAAG,MAAM,EAAE,CAAC;IAC3B,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAC7B,MAAM,GAAG,GAAsB;QAC7B,KAAK;QACL,MAAM;QACN,YAAY,EAAE,YAAY,IAAI,IAAI;QAClC,UAAU;QACV,SAAS;KACV,CAAC;IAEF,IAAI,MAAM,GAAmB,IAAI,CAAC;IAClC,IAAI,SAA6B,CAAC;IAClC,IAAI,YAAgC,CAAC;IAErC,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,mBAAmB,CAAC,GAAG,EAAE,KAAK,IAAI,EAAE,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC;QACtE,IAAI,MAAM,CAAC,MAAM,KAAK,SAAS;YAAE,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;QAC1D,MAAM,IAAI,GAAc;YACtB,OAAO,EAAE,MAAM;YACf,MAAM,EAAE,KAAK;YACb,cAAc,EAAE,YAAY,IAAI,IAAI;YACpC,IAAI;YACJ,IAAI;YACJ,MAAM;YACN,UAAU,EAAE,SAAS;YACrB,QAAQ,EAAE,MAAM,EAAE;YAClB,WAAW,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;YACnC,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,YAAY,EAAE,MAAM,CAAC,WAAW;YAChC,aAAa,EAAE,MAAM,CAAC,YAAY;YAClC,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,WAAW,EAAE,MAAM,CAAC,WAAW;YAC/B,SAAS,EAAE,MAAM,CAAC,QAAQ;YAC1B,UAAU,EAAE,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS;SAClF,CAAC;QACF,MAAM,SAAS,CAAC,WAAW,CAAC,KAAK,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC;QAC3C,OAAO,MAAM,CAAC;IAChB,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,GAAG,OAAO,CAAC;QACjB,SAAS,GAAI,GAAa,EAAE,IAAI,IAAI,OAAO,CAAC;QAC5C,YAAY,GAAG,QAAQ,CAAE,GAAa,EAAE,OAAO,IAAI,MAAM,CAAC,GAAG,CAAC,EAAE,IAAK,CAAC,CAAC;QACvE,MAAM,IAAI,GAAc;YACtB,OAAO,EAAE,MAAM;YACf,MAAM,EAAE,KAAK;YACb,cAAc,EAAE,YAAY,IAAI,IAAI;YACpC,IAAI;YACJ,IAAI;YACJ,MAAM;YACN,UAAU,EAAE,SAAS;YACrB,QAAQ,EAAE,MAAM,EAAE;YAClB,WAAW,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;YACnC,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,UAAU,EAAE,SAAS;YACrB,aAAa,EAAE,YAAY;YAC3B,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,YAAY,EAAE,MAAM,CAAC,WAAW;YAChC,aAAa,EAAE,MAAM,CAAC,YAAY;YAClC,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,WAAW,EAAE,MAAM,CAAC,WAAW;YAC/B,SAAS,EAAE,MAAM,CAAC,QAAQ;YAC1B,UAAU,EAAE,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS;SAClF,CAAC;QACF,MAAM,SAAS,CAAC,WAAW,CAAC,KAAK,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC;QAC3C,MAAM,GAAG,CAAC;IACZ,CAAC;YAAS,CAAC;QACT,SAAS,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC;IAChC,CAAC;AACH,CAAC"}