@senpi/runtime 1.1.0-dev.runtime-phase-2.20260609123448 → 1.1.0-dev.runtime-phase-2.20260609132603

package/dist/otel/emitter.js

@@ -0,0 +1,248 @@
+/**
+ * Per-Runtime OTEL emitter. Constructed once with the identity envelope baked
+ * in; stamps `position.id` from the OTEL ALS frame onto every span/log at emit
+ * time. Independent of the deprecating `src/tracking/` layer.
+ *
+ * Base host is shared with the legacy tracking layer via SENPI_TRACKING_URL
+ * (defaulting to the prod tracking host); the OTEL route paths are appended.
+ * When SENPI_OTEL_API_KEY is unset the emitter is `disabled` and all methods
+ * are cheap no-ops (the ingest rejects unauthenticated batches).
+ */
+import os from "node:os";
+import { createLogger } from "../utils/logger.js";
+import { ensureDefaultPiiRedactor } from "../tracking/spans/redact-pii.js";
+import { VERSION } from "../version.js";
+import { getCurrentSpan, getPositionId } from "./context.js";
+import { newSpanId, newTraceId, nowNs, nowNsBigInt, toStringMap, toStringValue } from "./encode.js";
+import { OtelHttpTransport } from "./transport.js";
+const logger = createLogger("[senpi-core][otel-emitter]");
+// Same base host as the legacy tracking layer (events/spans). Local constant so
+// the OTEL path stays self-contained while still honoring SENPI_TRACKING_URL.
+const DEFAULT_TRACKING_BASE_URL = "https://agent-telemetry.prod.senpi.ai";
+/** Severity → OTEL semconv 1-24 number. Lowercase is the canonical wire form. */
+const SEVERITY_NUMBER = {
+    trace: 1,
+    debug: 5,
+    info: 9,
+    warn: 13,
+    error: 17,
+    fatal: 21,
+};
+export class OtelEmitter {
+    resource;
+    serviceName;
+    spans;
+    logs;
+    disabled;
+    constructor(options) {
+        const endpoint = options.endpoint ??
+            process.env.SENPI_TRACKING_URL ??
+            DEFAULT_TRACKING_BASE_URL;
+        // Intentionally NO fallback to SENPI_API_KEY. The master Senpi API key
+        // grants broad access; posting it as a Bearer would expose it beyond its
+        // intended scope. Require SENPI_OTEL_API_KEY explicitly — without it the
+        // emitter disables rather than posting unauth (the ingest rejects
+        // unauthenticated batches with 401).
+        const apiKey = options.apiKey ?? process.env.SENPI_OTEL_API_KEY;
+        // Resource map produced once at construction (no per-call rebuild).
+        const id = options.identity;
+        const resource = {
+            "service.name": id.serviceName,
+            "service.version": VERSION,
+            "host.name": os.hostname(),
+            "runtime.boot_id": id.runtimeBootId,
+            "runtime.version": id.runtimeVersion ?? VERSION,
+        };
+        // `user.id` is intentionally NOT stamped here. The ingest service
+        // overwrites it from the verified bearer token (`stampUser` in
+        // agent_telemetry's otel route), so a producer-side stamp is bytes on
+        // the wire and a small attack-surface: a compromised producer credential
+        // could otherwise lie about identity for empty-`strategy.address` rows
+        // that bypass the ownership gate. Server-stamp is the authoritative path.
+        if (id.strategyAddress)
+            resource["strategy.address"] = id.strategyAddress;
+        if (id.recipeName)
+            resource["recipe.name"] = id.recipeName;
+        if (id.recipeVersion)
+            resource["recipe.version"] = id.recipeVersion;
+        this.resource = resource;
+        this.serviceName = id.serviceName;
+        this.disabled = options.disabled === true || !apiKey;
+        if (this.disabled) {
+            if (!apiKey && options.disabled !== true) {
+                logger.info("OTEL emitter disabled: SENPI_OTEL_API_KEY unset");
+            }
+            this.spans = null;
+            this.logs = null;
+            return;
+        }
+        this.spans = new OtelHttpTransport({
+            url: joinUrl(endpoint, "/api/v1/tracking/traces"),
+            apiKey,
+            kind: "spans",
+        });
+        this.logs = new OtelHttpTransport({
+            url: joinUrl(endpoint, "/api/v1/tracking/logs"),
+            apiKey,
+            kind: "logs",
+        });
+        // Kick off PII redactor init on the V2 path too (the legacy span tracker
+        // also calls this; the helper is idempotent). Without this, an OTel-only
+        // deployment with `SENPI_API_KEY` unset would never construct the legacy
+        // span tracker and emit un-redacted.
+        void ensureDefaultPiiRedactor();
+    }
+    startSpan(name, opts = {}) {
+        // B1 — when no explicit parent, fall back to ALS-`currentSpan`.
+        const parent = opts.parent ?? getCurrentSpan();
+        const traceId = parent?.traceId ?? newTraceId();
+        const spanId = newSpanId();
+        const parentSpanId = parent?.spanId ?? "";
+        const startTimeNs = nowNsBigInt();
+        const kind = opts.kind ?? "Internal";
+        const attrMap = {};
+        if (opts.attrs) {
+            for (const [k, v] of Object.entries(opts.attrs)) {
+                // Skip undefined; emit empty-string for null per CH convention.
+                if (v === undefined)
+                    continue;
+                attrMap[k] = toStringValue(v);
+            }
+        }
+        const events = [];
+        let ended = false;
+        let exceptionRecorded = false;
+        const emit = (row) => {
+            this.spans?.emit(row);
+        };
+        const cachedResource = this.resource;
+        const cachedServiceName = this.serviceName;
+        const handle = {
+            traceId,
+            spanId,
+            name,
+            setAttr(key, value) {
+                // C6 — only skip `undefined`; null, false, 0, '' are all valid values.
+                if (value === undefined)
+                    return;
+                attrMap[key] = toStringValue(value);
+            },
+            setAttrs(record) {
+                for (const [k, v] of Object.entries(record)) {
+                    if (v === undefined)
+                        continue;
+                    attrMap[k] = toStringValue(v);
+                }
+            },
+            addEvent(eventName, eventAttrs) {
+                events.push({
+                    Timestamp: nowNs(),
+                    Name: eventName,
+                    Attributes: eventAttrs ? toStringMap(eventAttrs) : {},
+                });
+            },
+            recordException(err) {
+                const e = err;
+                events.push({
+                    Timestamp: nowNs(),
+                    Name: "exception",
+                    Attributes: {
+                        "exception.type": e?.name ?? "Error",
+                        "exception.message": e?.message ?? String(err),
+                        "exception.stacktrace": e?.stack ?? "",
+                    },
+                });
+                exceptionRecorded = true;
+            },
+            end(endOpts) {
+                if (ended)
+                    return;
+                ended = true;
+                const positionId = getPositionId();
+                if (positionId && attrMap["position.id"] === undefined) {
+                    attrMap["position.id"] = positionId;
+                }
+                // C2 — default StatusCode: explicit > exception-implied 'Error' > 'Ok'.
+                const statusCode = endOpts?.statusCode ?? (exceptionRecorded ? "Error" : "Ok");
+                const endTimeNs = nowNsBigInt();
+                const startTimestamp = startTimeNs.toString();
+                const duration = (endTimeNs - startTimeNs).toString();
+                const row = {
+                    Timestamp: startTimestamp,
+                    TraceId: traceId,
+                    SpanId: spanId,
+                    ParentSpanId: parentSpanId,
+                    SpanName: name,
+                    SpanKind: kind,
+                    Duration: duration,
+                    ServiceName: cachedServiceName,
+                    StatusCode: statusCode,
+                    StatusMessage: endOpts?.message ?? "",
+                    SpanAttributes: attrMap,
+                    ResourceAttributes: cachedResource,
+                    Events: events,
+                    ScopeName: "",
+                    ScopeVersion: "",
+                    TraceFlags: 0,
+                    TraceState: "",
+                };
+                emit(row);
+            },
+        };
+        return handle;
+    }
+    emitLog(opts) {
+        if (!this.logs)
+            return;
+        const severity = opts.severity ?? "info";
+        const parent = opts.parent ?? getCurrentSpan();
+        const baseAttrs = {
+            "event.name": opts.eventName,
+            ...(opts.attrs ?? {}),
+        };
+        const positionId = getPositionId();
+        if (positionId && baseAttrs["position.id"] === undefined) {
+            baseAttrs["position.id"] = positionId;
+        }
+        let body = "";
+        if (opts.body !== undefined && opts.body !== null) {
+            body = typeof opts.body === "string" ? opts.body : toStringValue(opts.body);
+        }
+        const row = {
+            Timestamp: nowNs(),
+            TraceId: parent?.traceId ?? "",
+            SpanId: parent?.spanId ?? "",
+            ServiceName: this.serviceName,
+            SeverityText: severity,
+            SeverityNumber: SEVERITY_NUMBER[severity],
+            Body: body,
+            LogAttributes: toStringMap(baseAttrs),
+            ResourceAttributes: this.resource,
+            EventName: opts.eventName,
+        };
+        this.logs.emit(row);
+    }
+    /** Drain both transports' buffers and await in-flight POSTs. */
+    async shutdown() {
+        await Promise.allSettled([
+            this.spans?.shutdown() ?? Promise.resolve(),
+            this.logs?.shutdown() ?? Promise.resolve(),
+        ]);
+    }
+    /**
+     * No-op emitter satisfying the `OtelEmitter` shape. Useful as a fallback in
+     * paths (e.g. tests or callers that build a runtime context without a real
+     * runtime) where stamping `{ disabled: true }` plus an identity envelope is
+     * boilerplate.
+     */
+    static disabled() {
+        return new OtelEmitter({
+            identity: { serviceName: "senpi-trading-runtime", runtimeBootId: "disabled" },
+            disabled: true,
+        });
+    }
+}
+function joinUrl(base, path) {
+    return base.replace(/\/+$/, "") + path;
+}
+//# sourceMappingURL=emitter.js.map

package/dist/otel/emitter.js.map

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

package/dist/otel/encode.d.ts

@@ -0,0 +1,48 @@
+/**
+ * ID generation, ns timestamps, and string-attribute encoding.
+ *
+ * Wire-format requirements (see remediation plan "Wire format"):
+ *  - traceId = 32-hex lowercase from 16 random bytes
+ *  - spanId  = 16-hex lowercase from 8 random bytes
+ *  - timestamps = epoch nanoseconds as UInt64-string
+ *  - attribute values = flat strings (`Map(LC(String), String)` in HyperDX)
+ *
+ * Callers pre-flatten nested objects via the separate `flatten()` helper —
+ * `toStringValue` JSON-stringifies arrays and plain objects as a fallback.
+ */
+export declare function newTraceId(): string;
+export declare function newSpanId(): string;
+/**
+ * High-precision ns timestamp combining `performance.timeOrigin` (epoch ms
+ * resolved at process start) with `performance.now()` (sub-ms monotonic).
+ * Returned as a UInt64-string for direct insertion into DateTime64(9) columns.
+ *
+ * Arithmetic note: a naive `(timeOrigin + now()) * 1e6` overflows Number
+ * precision (timeOrigin*1e6 ≈ 1.7e18, well past 2^53 ≈ 9e15) and would zero
+ * the sub-µs bits. We keep the large epoch component in BigInt and only
+ * multiply the small `performance.now()` value inside a Number — that
+ * preserves `performance.now()`'s native µs precision end-to-end.
+ */
+export declare function nowNs(): string;
+/** BigInt variant for callers that need to subtract (span duration). */
+export declare function nowNsBigInt(): bigint;
+/**
+ * Stringify any JS value into the canonical CH-row attribute encoding.
+ * Strings pass through; primitives map to their natural string form;
+ * objects/arrays are JSON-stringified. Returns `''` for null/undefined so
+ * callers can decide whether to emit the entry or skip it.
+ */
+export declare function toStringValue(v: unknown): string;
+/**
+ * Convert a record of mixed values to a flat string-only attribute map.
+ * Entries whose value is `null` or `undefined` are skipped — CH schema
+ * defaults handle absence (per CH convention, empty-string > null > undefined).
+ */
+export declare function toStringMap(record: Record<string, unknown> | undefined): Record<string, string>;
+/**
+ * Flatten a `Record<string, primitive>` into dot-namespaced string attrs.
+ * Primitives map to their natural string form; arrays and nested objects
+ * are JSON-stringified via `toStringValue` so nothing gets silently dropped.
+ */
+export declare function flatten(prefix: string, obj: Record<string, unknown> | undefined): Record<string, string>;
+//# sourceMappingURL=encode.d.ts.map

package/dist/otel/encode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"encode.d.ts","sourceRoot":"","sources":["../../src/otel/encode.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAKH,wBAAgB,UAAU,IAAI,MAAM,CAEnC;AAED,wBAAgB,SAAS,IAAI,MAAM,CAElC;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,KAAK,IAAI,MAAM,CAE9B;AAED,wEAAwE;AACxE,wBAAgB,WAAW,IAAI,MAAM,CAOpC;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,OAAO,GAAG,MAAM,CAWhD;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAQ/F;AAED;;;;GAIG;AACH,wBAAgB,OAAO,CACrB,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GACvC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAQxB"}

package/dist/otel/encode.js

@@ -0,0 +1,100 @@
+/**
+ * ID generation, ns timestamps, and string-attribute encoding.
+ *
+ * Wire-format requirements (see remediation plan "Wire format"):
+ *  - traceId = 32-hex lowercase from 16 random bytes
+ *  - spanId  = 16-hex lowercase from 8 random bytes
+ *  - timestamps = epoch nanoseconds as UInt64-string
+ *  - attribute values = flat strings (`Map(LC(String), String)` in HyperDX)
+ *
+ * Callers pre-flatten nested objects via the separate `flatten()` helper —
+ * `toStringValue` JSON-stringifies arrays and plain objects as a fallback.
+ */
+import { randomBytes } from "node:crypto";
+import { performance } from "node:perf_hooks";
+export function newTraceId() {
+    return randomBytes(16).toString("hex");
+}
+export function newSpanId() {
+    return randomBytes(8).toString("hex");
+}
+/**
+ * High-precision ns timestamp combining `performance.timeOrigin` (epoch ms
+ * resolved at process start) with `performance.now()` (sub-ms monotonic).
+ * Returned as a UInt64-string for direct insertion into DateTime64(9) columns.
+ *
+ * Arithmetic note: a naive `(timeOrigin + now()) * 1e6` overflows Number
+ * precision (timeOrigin*1e6 ≈ 1.7e18, well past 2^53 ≈ 9e15) and would zero
+ * the sub-µs bits. We keep the large epoch component in BigInt and only
+ * multiply the small `performance.now()` value inside a Number — that
+ * preserves `performance.now()`'s native µs precision end-to-end.
+ */
+export function nowNs() {
+    return nowNsBigInt().toString();
+}
+/** BigInt variant for callers that need to subtract (span duration). */
+export function nowNsBigInt() {
+    const originMs = performance.timeOrigin;
+    const originWholeMs = Math.floor(originMs);
+    const originFracNs = Math.round((originMs - originWholeMs) * 1_000_000);
+    const originNs = BigInt(originWholeMs) * 1000000n + BigInt(originFracNs);
+    const offsetNs = BigInt(Math.round(performance.now() * 1_000_000));
+    return originNs + offsetNs;
+}
+/**
+ * Stringify any JS value into the canonical CH-row attribute encoding.
+ * Strings pass through; primitives map to their natural string form;
+ * objects/arrays are JSON-stringified. Returns `''` for null/undefined so
+ * callers can decide whether to emit the entry or skip it.
+ */
+export function toStringValue(v) {
+    if (v === null || v === undefined)
+        return "";
+    if (typeof v === "string")
+        return v;
+    if (typeof v === "boolean")
+        return v ? "true" : "false";
+    if (typeof v === "bigint")
+        return v.toString();
+    if (typeof v === "number")
+        return String(v);
+    try {
+        return JSON.stringify(v);
+    }
+    catch {
+        return String(v);
+    }
+}
+/**
+ * Convert a record of mixed values to a flat string-only attribute map.
+ * Entries whose value is `null` or `undefined` are skipped — CH schema
+ * defaults handle absence (per CH convention, empty-string > null > undefined).
+ */
+export function toStringMap(record) {
+    if (!record)
+        return {};
+    const out = {};
+    for (const [key, v] of Object.entries(record)) {
+        if (v === null || v === undefined)
+            continue;
+        out[key] = toStringValue(v);
+    }
+    return out;
+}
+/**
+ * Flatten a `Record<string, primitive>` into dot-namespaced string attrs.
+ * Primitives map to their natural string form; arrays and nested objects
+ * are JSON-stringified via `toStringValue` so nothing gets silently dropped.
+ */
+export function flatten(prefix, obj) {
+    if (!obj)
+        return {};
+    const out = {};
+    for (const [k, v] of Object.entries(obj)) {
+        if (v === null || v === undefined)
+            continue;
+        out[`${prefix}.${k}`] = toStringValue(v);
+    }
+    return out;
+}
+//# sourceMappingURL=encode.js.map

package/dist/otel/encode.js.map

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

package/dist/otel/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Public surface of the OTEL V2 recording module.
+ *
+ * Exports are limited to symbols consumed outside `src/otel/`. Transport,
+ * encode helpers, and registry stubs are intentionally not re-exported.
+ */
+export type { LogRow, OtelSeverity, OtelSpanKind, OtelStatusCode, SpanEvent, SpanRow, } from "./types.js";
+export { getCurrentSpan, getPositionId, otelContext, setCurrentSpan, setPositionId, } from "./context.js";
+export type { OtelContext } from "./context.js";
+export { flatten } from "./encode.js";
+export { OtelEmitter } from "./emitter.js";
+export type { LogEmitOpts, OtelEmitterOptions, OtelIdentity, OtelSpanHandle, SpanEndOpts, SpanStartOpts, } from "./emitter.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/otel/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,YAAY,EACV,MAAM,EACN,YAAY,EACZ,YAAY,EACZ,cAAc,EACd,SAAS,EACT,OAAO,GACR,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,cAAc,EACd,aAAa,EACb,WAAW,EACX,cAAc,EACd,aAAa,GACd,MAAM,cAAc,CAAC;AACtB,YAAY,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAEhD,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAEtC,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC3C,YAAY,EACV,WAAW,EACX,kBAAkB,EAClB,YAAY,EACZ,cAAc,EACd,WAAW,EACX,aAAa,GACd,MAAM,cAAc,CAAC"}

package/dist/otel/index.js

@@ -0,0 +1,10 @@
+/**
+ * Public surface of the OTEL V2 recording module.
+ *
+ * Exports are limited to symbols consumed outside `src/otel/`. Transport,
+ * encode helpers, and registry stubs are intentionally not re-exported.
+ */
+export { getCurrentSpan, getPositionId, otelContext, setCurrentSpan, setPositionId, } from "./context.js";
+export { flatten } from "./encode.js";
+export { OtelEmitter } from "./emitter.js";
+//# sourceMappingURL=index.js.map

package/dist/otel/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/otel/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAWH,OAAO,EACL,cAAc,EACd,aAAa,EACb,WAAW,EACX,cAAc,EACd,aAAa,GACd,MAAM,cAAc,CAAC;AAGtB,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAEtC,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC"}

package/dist/otel/transport.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Fire-and-forget HTTP transport with micro-batching.
+ *
+ * Records are buffered in memory and flushed to the consumer when either:
+ *   - the buffer reaches `maxBatch` records, OR
+ *   - `maxAgeMs` elapse since the first record landed (timer-driven).
+ *
+ * Each flush issues one POST containing `{ spans: [...] }` / `{ logs: [...] }`.
+ * The consumer already accepts an array; single-record posts (the prior
+ * behavior) were just N=1 batches. Trade-off: per-record latency up to
+ * `maxAgeMs` (default 250ms); SIGKILL loses the in-flight buffer. Graceful
+ * shutdown via `shutdown()` drains.
+ *
+ * Oversize guard: if the serialized batch exceeds `MAX_RECORD_BYTES`, splits
+ * the batch in halves and re-flushes recursively until each fragment fits.
+ * For singletons that still overflow, the blob-strip fallback kicks in
+ * (`gen_ai.message.body`, `senpi.order_response.body`, `decision.reasoning`,
+ * and log Body get cleared; row tagged `senpi.degraded=true`).
+ *
+ * Failure modes are fail-open: redactor throws → warn + emit un-redacted;
+ * fetch fails → warn + drop the batch; oversize singleton → warn + drop.
+ * Nothing in this layer blocks the trade path.
+ */
+import type { LogRow, SpanRow } from "./types.js";
+export type OtelTransportKind = "spans" | "logs";
+export interface OtelHttpTransportOptions {
+    url: string;
+    apiKey?: string;
+    kind: OtelTransportKind;
+    /** Records buffered before forcing a flush. Default 100. */
+    maxBatch?: number;
+    /** Max age in ms of the oldest buffered record before flushing. Default 250. */
+    maxAgeMs?: number;
+}
+export declare class OtelHttpTransport<T extends SpanRow | LogRow> {
+    private readonly url;
+    private readonly apiKey?;
+    private readonly kind;
+    private readonly maxBatch;
+    private readonly maxAgeMs;
+    private buf;
+    private flushTimer;
+    private inFlight;
+    constructor(opts: OtelHttpTransportOptions);
+    /**
+     * Enqueue a record for the next flush. Synchronous, never throws, never
+     * blocks. Triggers an immediate flush when the buffer reaches `maxBatch`.
+     */
+    emit(record: T): void;
+    /** Drain the buffer and await all in-flight POSTs. Idempotent. */
+    shutdown(): Promise<void>;
+    private flush;
+    private dispatch;
+    private dispatchSerialized;
+    private buildEnvelope;
+}
+//# sourceMappingURL=transport.d.ts.map

package/dist/otel/transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.d.ts","sourceRoot":"","sources":["../../src/otel/transport.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAIH,OAAO,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAQlD,MAAM,MAAM,iBAAiB,GAAG,OAAO,GAAG,MAAM,CAAC;AAEjD,MAAM,WAAW,wBAAwB;IACvC,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,iBAAiB,CAAC;IACxB,4DAA4D;IAC5D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,gFAAgF;IAChF,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,qBAAa,iBAAiB,CAAC,CAAC,SAAS,OAAO,GAAG,MAAM;IACvD,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAS;IAC7B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAoB;IACzC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAElC,OAAO,CAAC,GAAG,CAAW;IACtB,OAAO,CAAC,UAAU,CAA+B;IACjD,OAAO,CAAC,QAAQ,CAA4B;gBAEhC,IAAI,EAAE,wBAAwB;IAQ1C;;;OAGG;IACH,IAAI,CAAC,MAAM,EAAE,CAAC,GAAG,IAAI;IAarB,kEAAkE;IAC5D,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAO/B,OAAO,CAAC,KAAK;YAaC,QAAQ;YA0BR,kBAAkB;IA2DhC,OAAO,CAAC,aAAa;CAMtB"}