@agimon-ai/doompi-log 0.0.1-alpha.8 → 0.0.1-alpha.81

package/README.md

@@ -1,40 +1,87 @@
 # @agimon-ai/doompi-log
 
-Pi log-sink telemetry extension with session-local metrics and a Log Metrics overlay.
+Session metrics, findings, sink status, and a Log Metrics overlay for Pi.
 
-Session-local metrics and a log metrics overlay, backed by log-sink telemetry.
+Part of the [DoomPi distribution](https://www.npmjs.com/package/@agimon-ai/doompi).
 
-Part of [Doompi](https://www.npmjs.com/package/@agimon-ai/doompi), a coding agent that loads
-only the skills and tools you name. This package is composed by Doompi and is not usually
-installed on its own.
+The extension aggregates telemetry it observes in-process and can query historical data from
+`@agimon-ai/log-sink-mcp`.
+
+> **Alpha:** metric attribution and UI contracts may change between releases.
+
+## Requirements
+
+- Node.js 22.19.0 or newer
+- Pi 0.85.0 and Pi TUI 0.85.0
 
 ## Install
 
+`doompi init` and `dpi init` include Log in `default.packages` in `.doom/modes.yaml`. Remove it
+or move it to a named layer to change which major modes load it. Pi discovers its sole extension
+entry through `package.json.pi.extensions`. For standalone Pi:
+
 ```bash
-npm install @agimon-ai/doompi-log
+pi install npm:@agimon-ai/doompi-log
 ```
 
-## How it loads
+Use `SPC h l` to open the current session's Log Metrics overlay.
+
+## What is collected
+
+The in-process aggregator tracks operational records such as turn token totals, cache use, tool
+calls and failures, operation durations, recent errors, and event counts. It derives findings from
+those records without requiring an external sink.
+
+Historical panels resolve a sink over HTTP first and then use the Log Sink CLI fallback. Without a
+reachable sink, current-session headline metrics, findings, errors, and tool metrics still work;
+historical top-consumer and burn-rate views are unavailable. Sink failures are reported in status
+rather than failing the Pi session.
+
+Turn cost attribution is contextual: when a turn invokes several tools, the emitted turn total can
+be associated with each participating tool. The overlay uses that value for ranking, not as a
+precise per-tool share.
+
+Keys: `r` refreshes, `g` changes dimension, `p` changes period, `?` opens details, and Escape closes.
 
-Doompi loads this unconditionally. It is core, not a layer, so it does not appear in
-`.doom/modes.yaml`: making it optional would only create broken configurations.
+## Telemetry controls
 
-Extension entry: `@agimon-ai/doompi-log/extensions/pi`
+| Variable                   | Effect                                                 |
+| -------------------------- | ------------------------------------------------------ |
+| `AGENT_TELEMETRY_DISABLED` | Disables the extension's telemetry export              |
+| `OTEL_SDK_DISABLED`        | Disables OpenTelemetry SDK export                      |
+| `AGENT_OTEL_TRACES`        | Enables/disables trace export; logs can remain enabled |
 
-## Leader
+File fallback is opt-in through host options. The absence of a configured or reachable endpoint
+does not prevent in-process aggregation. Exceptions and caller-supplied attributes can still be
+sensitive; do not assume "metadata" is harmless.
 
-`SPC h l` opens log metrics, once the extension is loaded.
+The overlay requires a TUI. The aggregator, findings, and metrics-source APIs can be embedded in
+headless hosts.
 
-## Entry points
+## Public API
+
+```ts
+import { deriveFindings, LogMetricsAggregator, openLogMetricsOverlay } from '@agimon-ai/doompi-log';
+```
+
+Normal Pi activation uses `extensions/pi`. Composition hosts await `doomLogExtension.install(context, pi)`
+from that entry. The helper owns registrations and cleanup. Session shutdown flushes final telemetry
+before `onDispose` releases the telemetry handle. Optional UI services follow provider replacement.
+
+`src/extensions/` declares the Pi, server, and web plugins. Controllers handle events and HTTP requests,
+services own aggregation and sink queries, and `src/tui/` owns terminal presentation. Flat `src/exports/`
+modules expose reusable APIs. The overlay component is available through `metrics-overlay`.
+
+## Development
+
+```bash
+pnpm build
+pnpm typecheck
+pnpm test
+pnpm lint
+```
 
-| Import                                     |
-| ------------------------------------------ |
-| `@agimon-ai/doompi-log`                    |
-| `@agimon-ai/doompi-log/extension`          |
-| `@agimon-ai/doompi-log/extensions/pi`      |
-| `@agimon-ai/doompi-log/metrics`            |
-| `@agimon-ai/doompi-log/metricsSource`      |
-| `@agimon-ai/doompi-log/tui/metricsOverlay` |
+Maintained by [Agimon](https://agimon.ai/about).
 
 ## License
 

package/dist/apiContracts.cjs

@@ -0,0 +1,145 @@
+Object.defineProperties(exports, {
+	__esModule: { value: true },
+	[Symbol.toStringTag]: { value: "Module" }
+});
+let _agimon_ai_doompi_core_apiContracts = require("@agimon-ai/doompi-core/apiContracts");
+let typebox = require("typebox");
+//#region src/schemas/apiContracts.ts
+const S = typebox.Type.String();
+const N = typebox.Type.Number();
+const B = typebox.Type.Boolean();
+const O = typebox.Type.Optional;
+const literals = (values) => typebox.Type.Union(values.map((value) => typebox.Type.Literal(value)));
+const Dimension = literals([
+	"session",
+	"agent",
+	"model",
+	"provider"
+]);
+const Period = literals([
+	"day",
+	"week",
+	"month",
+	"all"
+]);
+const Unavailable = typebox.Type.Object({
+	unavailable: literals([
+		"no-sink",
+		"no-data",
+		"no-api"
+	]),
+	detail: S
+});
+const Tokens = {
+	totalTokens: N,
+	inputTokens: N,
+	outputTokens: N
+};
+const MetricsResponseSchema = typebox.Type.Union([Unavailable, typebox.Type.Object({
+	generatedAt: S,
+	dimension: Dimension,
+	period: Period,
+	bucketUnit: S,
+	focus: O(S),
+	transport: O(literals(["http", "cli"])),
+	totals: typebox.Type.Object({
+		...Tokens,
+		cachedTokens: N,
+		reasoningTokens: N,
+		groupCount: N,
+		failedGroups: N,
+		issueCount: N
+	}),
+	timeline: typebox.Type.Array(typebox.Type.Object({
+		label: S,
+		...Tokens
+	})),
+	groups: typebox.Type.Array(typebox.Type.Object({
+		key: S,
+		...Tokens,
+		issueCount: N,
+		failed: B
+	})),
+	tools: typebox.Type.Array(typebox.Type.Object({
+		name: S,
+		calls: N,
+		p90TotalTokens: N
+	}))
+})]);
+const Nullable = typebox.Type.Union([S, typebox.Type.Null()]);
+const IssuesResponseSchema = typebox.Type.Union([Unavailable, typebox.Type.Object({
+	totalIssues: N,
+	uniqueIncidents: N,
+	byCategory: typebox.Type.Record(S, N),
+	byTool: typebox.Type.Record(S, N),
+	byErrorType: typebox.Type.Record(S, N),
+	samples: typebox.Type.Array(typebox.Type.Object({
+		fingerprint: S,
+		occurrenceCount: N,
+		category: S,
+		timestamp: S,
+		level: S,
+		message: S,
+		detail: S,
+		tool: Nullable,
+		errorType: Nullable,
+		agentName: Nullable,
+		model: Nullable,
+		statusCode: Nullable
+	}))
+})]);
+const apiContracts = (0, _agimon_ai_doompi_core_apiContracts.defineApiContract)({
+	version: 1,
+	sockets: [],
+	dynamic: [],
+	http: ["global", "workspace"].flatMap((scope) => [{
+		id: "log.metrics",
+		scope,
+		basePath: "log",
+		path: "/metrics",
+		method: "GET",
+		authentication: "owner",
+		description: "Read usage metrics from the configured log sink.",
+		parameters: [
+			{
+				name: "dimension",
+				in: "query",
+				required: false,
+				schema: Dimension
+			},
+			{
+				name: "period",
+				in: "query",
+				required: false,
+				schema: Period
+			},
+			{
+				name: "focus",
+				in: "query",
+				required: false,
+				schema: S
+			}
+		],
+		responses: (0, _agimon_ai_doompi_core_apiContracts.jsonApiResponses)(MetricsResponseSchema)
+	}, {
+		id: "log.issues",
+		scope,
+		basePath: "log",
+		path: "/issues",
+		method: "GET",
+		authentication: "owner",
+		description: "Read log issue details.",
+		parameters: [{
+			name: "focus",
+			in: "query",
+			required: false,
+			schema: S
+		}],
+		responses: (0, _agimon_ai_doompi_core_apiContracts.jsonApiResponses)(IssuesResponseSchema)
+	}])
+});
+//#endregion
+exports.apiContracts = apiContracts;
+exports.default = apiContracts;
+
+//# sourceMappingURL=apiContracts.cjs.map

package/dist/apiContracts.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"apiContracts.cjs","names":["Type","defineApiContract","jsonApiResponses"],"sources":["../src/schemas/apiContracts.ts"],"sourcesContent":["import { defineApiContract, jsonApiResponses } from '@agimon-ai/doompi-core/apiContracts';\nimport { Type } from 'typebox';\n\nconst S = Type.String();\nconst N = Type.Number();\nconst B = Type.Boolean();\nconst O = Type.Optional;\nconst literals = <T extends string>(values: T[]) => Type.Union(values.map((value) => Type.Literal(value)));\nconst Dimension = literals(['session', 'agent', 'model', 'provider']);\nconst Period = literals(['day', 'week', 'month', 'all']);\nconst Unavailable = Type.Object({ unavailable: literals(['no-sink', 'no-data', 'no-api']), detail: S });\nconst Tokens = { totalTokens: N, inputTokens: N, outputTokens: N };\nexport const MetricsResponseSchema = Type.Union([\n  Unavailable,\n  Type.Object({\n    generatedAt: S,\n    dimension: Dimension,\n    period: Period,\n    bucketUnit: S,\n    focus: O(S),\n    transport: O(literals(['http', 'cli'])),\n    totals: Type.Object({\n      ...Tokens,\n      cachedTokens: N,\n      reasoningTokens: N,\n      groupCount: N,\n      failedGroups: N,\n      issueCount: N,\n    }),\n    timeline: Type.Array(Type.Object({ label: S, ...Tokens })),\n    groups: Type.Array(Type.Object({ key: S, ...Tokens, issueCount: N, failed: B })),\n    tools: Type.Array(Type.Object({ name: S, calls: N, p90TotalTokens: N })),\n  }),\n]);\nconst Nullable = Type.Union([S, Type.Null()]);\nexport const IssuesResponseSchema = Type.Union([\n  Unavailable,\n  Type.Object({\n    totalIssues: N,\n    uniqueIncidents: N,\n    byCategory: Type.Record(S, N),\n    byTool: Type.Record(S, N),\n    byErrorType: Type.Record(S, N),\n    samples: Type.Array(\n      Type.Object({\n        fingerprint: S,\n        occurrenceCount: N,\n        category: S,\n        timestamp: S,\n        level: S,\n        message: S,\n        detail: S,\n        tool: Nullable,\n        errorType: Nullable,\n        agentName: Nullable,\n        model: Nullable,\n        statusCode: Nullable,\n      }),\n    ),\n  }),\n]);\nexport const apiContracts = defineApiContract({\n  version: 1,\n  sockets: [],\n  dynamic: [],\n  http: (['global', 'workspace'] as const).flatMap((scope) => [\n    {\n      id: 'log.metrics',\n      scope,\n      basePath: 'log',\n      path: '/metrics',\n      method: 'GET',\n      authentication: 'owner',\n      description: 'Read usage metrics from the configured log sink.',\n      parameters: [\n        { name: 'dimension', in: 'query', required: false, schema: Dimension },\n        { name: 'period', in: 'query', required: false, schema: Period },\n        { name: 'focus', in: 'query', required: false, schema: S },\n      ],\n      responses: jsonApiResponses(MetricsResponseSchema),\n    },\n    {\n      id: 'log.issues',\n      scope,\n      basePath: 'log',\n      path: '/issues',\n      method: 'GET',\n      authentication: 'owner',\n      description: 'Read log issue details.',\n      parameters: [{ name: 'focus', in: 'query', required: false, schema: S }],\n      responses: jsonApiResponses(IssuesResponseSchema),\n    },\n  ]),\n});\nexport default apiContracts;\n"],"mappings":"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"}

package/dist/apiContracts.d.mts

@@ -0,0 +1,53 @@
+import { Type } from "typebox";
+//#region src/schemas/apiContracts.d.ts
+export declare const apiContracts: {
+  version: 1;
+  protocols?: Record<string, string> | undefined;
+  schemas?: Record<string, boolean | object> | undefined;
+  http: {
+    id: string;
+    scope: "global" | "session" | "workspace";
+    basePath?: string | undefined;
+    path: string;
+    method: "DELETE" | "GET" | "HEAD" | "OPTIONS" | "PATCH" | "POST" | "PUT";
+    description: string;
+    availability?: string | undefined;
+    authentication: "device" | "none" | "owner";
+    parameters?: {
+      name: string;
+      in: "header" | "path" | "query";
+      required: boolean;
+      schema: boolean | object;
+    }[] | undefined;
+    body?: {
+      contentType: string;
+      contentTypes?: string[] | undefined;
+      required: boolean;
+      schema: boolean | object;
+    } | undefined;
+    responses: Record<string, {
+      description: string;
+      contentType?: string | undefined;
+      schema?: boolean | object | undefined;
+      events?: Record<string, boolean | object> | undefined;
+    }>;
+  }[];
+  sockets: {
+    id: string;
+    scope: "global" | "session" | "workspace";
+    description: string;
+    availability?: string | undefined;
+    service: string;
+    member: string;
+    direction: "client-to-server" | "server-to-client";
+    kind: "channel" | "method" | "state";
+    input: boolean | object;
+    output?: boolean | object | undefined;
+    errors?: boolean | object | undefined;
+  }[];
+  dynamic: string[];
+  gaps?: string[] | undefined;
+};
+//#endregion
+export { apiContracts as default };
+//# sourceMappingURL=apiContracts.d.mts.map

package/dist/apiContracts.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"apiContracts.d.mts","names":[],"sources":["../src/schemas/apiContracts.ts"],"mappings":";;qBA6Da"}

package/dist/apiContracts.mjs

@@ -0,0 +1,140 @@
+import { defineApiContract, jsonApiResponses } from "@agimon-ai/doompi-core/apiContracts";
+import { Type } from "typebox";
+//#region src/schemas/apiContracts.ts
+const S = Type.String();
+const N = Type.Number();
+const B = Type.Boolean();
+const O = Type.Optional;
+const literals = (values) => Type.Union(values.map((value) => Type.Literal(value)));
+const Dimension = literals([
+	"session",
+	"agent",
+	"model",
+	"provider"
+]);
+const Period = literals([
+	"day",
+	"week",
+	"month",
+	"all"
+]);
+const Unavailable = Type.Object({
+	unavailable: literals([
+		"no-sink",
+		"no-data",
+		"no-api"
+	]),
+	detail: S
+});
+const Tokens = {
+	totalTokens: N,
+	inputTokens: N,
+	outputTokens: N
+};
+const MetricsResponseSchema = Type.Union([Unavailable, Type.Object({
+	generatedAt: S,
+	dimension: Dimension,
+	period: Period,
+	bucketUnit: S,
+	focus: O(S),
+	transport: O(literals(["http", "cli"])),
+	totals: Type.Object({
+		...Tokens,
+		cachedTokens: N,
+		reasoningTokens: N,
+		groupCount: N,
+		failedGroups: N,
+		issueCount: N
+	}),
+	timeline: Type.Array(Type.Object({
+		label: S,
+		...Tokens
+	})),
+	groups: Type.Array(Type.Object({
+		key: S,
+		...Tokens,
+		issueCount: N,
+		failed: B
+	})),
+	tools: Type.Array(Type.Object({
+		name: S,
+		calls: N,
+		p90TotalTokens: N
+	}))
+})]);
+const Nullable = Type.Union([S, Type.Null()]);
+const IssuesResponseSchema = Type.Union([Unavailable, Type.Object({
+	totalIssues: N,
+	uniqueIncidents: N,
+	byCategory: Type.Record(S, N),
+	byTool: Type.Record(S, N),
+	byErrorType: Type.Record(S, N),
+	samples: Type.Array(Type.Object({
+		fingerprint: S,
+		occurrenceCount: N,
+		category: S,
+		timestamp: S,
+		level: S,
+		message: S,
+		detail: S,
+		tool: Nullable,
+		errorType: Nullable,
+		agentName: Nullable,
+		model: Nullable,
+		statusCode: Nullable
+	}))
+})]);
+const apiContracts = defineApiContract({
+	version: 1,
+	sockets: [],
+	dynamic: [],
+	http: ["global", "workspace"].flatMap((scope) => [{
+		id: "log.metrics",
+		scope,
+		basePath: "log",
+		path: "/metrics",
+		method: "GET",
+		authentication: "owner",
+		description: "Read usage metrics from the configured log sink.",
+		parameters: [
+			{
+				name: "dimension",
+				in: "query",
+				required: false,
+				schema: Dimension
+			},
+			{
+				name: "period",
+				in: "query",
+				required: false,
+				schema: Period
+			},
+			{
+				name: "focus",
+				in: "query",
+				required: false,
+				schema: S
+			}
+		],
+		responses: jsonApiResponses(MetricsResponseSchema)
+	}, {
+		id: "log.issues",
+		scope,
+		basePath: "log",
+		path: "/issues",
+		method: "GET",
+		authentication: "owner",
+		description: "Read log issue details.",
+		parameters: [{
+			name: "focus",
+			in: "query",
+			required: false,
+			schema: S
+		}],
+		responses: jsonApiResponses(IssuesResponseSchema)
+	}])
+});
+//#endregion
+export { apiContracts, apiContracts as default };
+
+//# sourceMappingURL=apiContracts.mjs.map

package/dist/apiContracts.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"apiContracts.mjs","names":[],"sources":["../src/schemas/apiContracts.ts"],"sourcesContent":["import { defineApiContract, jsonApiResponses } from '@agimon-ai/doompi-core/apiContracts';\nimport { Type } from 'typebox';\n\nconst S = Type.String();\nconst N = Type.Number();\nconst B = Type.Boolean();\nconst O = Type.Optional;\nconst literals = <T extends string>(values: T[]) => Type.Union(values.map((value) => Type.Literal(value)));\nconst Dimension = literals(['session', 'agent', 'model', 'provider']);\nconst Period = literals(['day', 'week', 'month', 'all']);\nconst Unavailable = Type.Object({ unavailable: literals(['no-sink', 'no-data', 'no-api']), detail: S });\nconst Tokens = { totalTokens: N, inputTokens: N, outputTokens: N };\nexport const MetricsResponseSchema = Type.Union([\n  Unavailable,\n  Type.Object({\n    generatedAt: S,\n    dimension: Dimension,\n    period: Period,\n    bucketUnit: S,\n    focus: O(S),\n    transport: O(literals(['http', 'cli'])),\n    totals: Type.Object({\n      ...Tokens,\n      cachedTokens: N,\n      reasoningTokens: N,\n      groupCount: N,\n      failedGroups: N,\n      issueCount: N,\n    }),\n    timeline: Type.Array(Type.Object({ label: S, ...Tokens })),\n    groups: Type.Array(Type.Object({ key: S, ...Tokens, issueCount: N, failed: B })),\n    tools: Type.Array(Type.Object({ name: S, calls: N, p90TotalTokens: N })),\n  }),\n]);\nconst Nullable = Type.Union([S, Type.Null()]);\nexport const IssuesResponseSchema = Type.Union([\n  Unavailable,\n  Type.Object({\n    totalIssues: N,\n    uniqueIncidents: N,\n    byCategory: Type.Record(S, N),\n    byTool: Type.Record(S, N),\n    byErrorType: Type.Record(S, N),\n    samples: Type.Array(\n      Type.Object({\n        fingerprint: S,\n        occurrenceCount: N,\n        category: S,\n        timestamp: S,\n        level: S,\n        message: S,\n        detail: S,\n        tool: Nullable,\n        errorType: Nullable,\n        agentName: Nullable,\n        model: Nullable,\n        statusCode: Nullable,\n      }),\n    ),\n  }),\n]);\nexport const apiContracts = defineApiContract({\n  version: 1,\n  sockets: [],\n  dynamic: [],\n  http: (['global', 'workspace'] as const).flatMap((scope) => [\n    {\n      id: 'log.metrics',\n      scope,\n      basePath: 'log',\n      path: '/metrics',\n      method: 'GET',\n      authentication: 'owner',\n      description: 'Read usage metrics from the configured log sink.',\n      parameters: [\n        { name: 'dimension', in: 'query', required: false, schema: Dimension },\n        { name: 'period', in: 'query', required: false, schema: Period },\n        { name: 'focus', in: 'query', required: false, schema: S },\n      ],\n      responses: jsonApiResponses(MetricsResponseSchema),\n    },\n    {\n      id: 'log.issues',\n      scope,\n      basePath: 'log',\n      path: '/issues',\n      method: 'GET',\n      authentication: 'owner',\n      description: 'Read log issue details.',\n      parameters: [{ name: 'focus', in: 'query', required: false, schema: S }],\n      responses: jsonApiResponses(IssuesResponseSchema),\n    },\n  ]),\n});\nexport default apiContracts;\n"],"mappings":";;;AAGA,MAAM,IAAI,KAAK,OAAO;AACtB,MAAM,IAAI,KAAK,OAAO;AACtB,MAAM,IAAI,KAAK,QAAQ;AACvB,MAAM,IAAI,KAAK;AACf,MAAM,YAA8B,WAAgB,KAAK,MAAM,OAAO,KAAK,UAAU,KAAK,QAAQ,KAAK,CAAC,CAAC;AACzG,MAAM,YAAY,SAAS;CAAC;CAAW;CAAS;CAAS;AAAU,CAAC;AACpE,MAAM,SAAS,SAAS;CAAC;CAAO;CAAQ;CAAS;AAAK,CAAC;AACvD,MAAM,cAAc,KAAK,OAAO;CAAE,aAAa,SAAS;EAAC;EAAW;EAAW;CAAQ,CAAC;CAAG,QAAQ;AAAE,CAAC;AACtG,MAAM,SAAS;CAAE,aAAa;CAAG,aAAa;CAAG,cAAc;AAAE;AACjE,MAAa,wBAAwB,KAAK,MAAM,CAC9C,aACA,KAAK,OAAO;CACV,aAAa;CACb,WAAW;CACX,QAAQ;CACR,YAAY;CACZ,OAAO,EAAE,CAAC;CACV,WAAW,EAAE,SAAS,CAAC,QAAQ,KAAK,CAAC,CAAC;CACtC,QAAQ,KAAK,OAAO;EAClB,GAAG;EACH,cAAc;EACd,iBAAiB;EACjB,YAAY;EACZ,cAAc;EACd,YAAY;CACd,CAAC;CACD,UAAU,KAAK,MAAM,KAAK,OAAO;EAAE,OAAO;EAAG,GAAG;CAAO,CAAC,CAAC;CACzD,QAAQ,KAAK,MAAM,KAAK,OAAO;EAAE,KAAK;EAAG,GAAG;EAAQ,YAAY;EAAG,QAAQ;CAAE,CAAC,CAAC;CAC/E,OAAO,KAAK,MAAM,KAAK,OAAO;EAAE,MAAM;EAAG,OAAO;EAAG,gBAAgB;CAAE,CAAC,CAAC;AACzE,CAAC,CACH,CAAC;AACD,MAAM,WAAW,KAAK,MAAM,CAAC,GAAG,KAAK,KAAK,CAAC,CAAC;AAC5C,MAAa,uBAAuB,KAAK,MAAM,CAC7C,aACA,KAAK,OAAO;CACV,aAAa;CACb,iBAAiB;CACjB,YAAY,KAAK,OAAO,GAAG,CAAC;CAC5B,QAAQ,KAAK,OAAO,GAAG,CAAC;CACxB,aAAa,KAAK,OAAO,GAAG,CAAC;CAC7B,SAAS,KAAK,MACZ,KAAK,OAAO;EACV,aAAa;EACb,iBAAiB;EACjB,UAAU;EACV,WAAW;EACX,OAAO;EACP,SAAS;EACT,QAAQ;EACR,MAAM;EACN,WAAW;EACX,WAAW;EACX,OAAO;EACP,YAAY;CACd,CAAC,CACH;AACF,CAAC,CACH,CAAC;AACD,MAAa,eAAe,kBAAkB;CAC5C,SAAS;CACT,SAAS,CAAC;CACV,SAAS,CAAC;CACV,MAAO,CAAC,UAAU,WAAW,CAAC,CAAW,SAAS,UAAU,CAC1D;EACE,IAAI;EACJ;EACA,UAAU;EACV,MAAM;EACN,QAAQ;EACR,gBAAgB;EAChB,aAAa;EACb,YAAY;GACV;IAAE,MAAM;IAAa,IAAI;IAAS,UAAU;IAAO,QAAQ;GAAU;GACrE;IAAE,MAAM;IAAU,IAAI;IAAS,UAAU;IAAO,QAAQ;GAAO;GAC/D;IAAE,MAAM;IAAS,IAAI;IAAS,UAAU;IAAO,QAAQ;GAAE;EAC3D;EACA,WAAW,iBAAiB,qBAAqB;CACnD,GACA;EACE,IAAI;EACJ;EACA,UAAU;EACV,MAAM;EACN,QAAQ;EACR,gBAAgB;EAChB,aAAa;EACb,YAAY,CAAC;GAAE,MAAM;GAAS,IAAI;GAAS,UAAU;GAAO,QAAQ;EAAE,CAAC;EACvE,WAAW,iBAAiB,oBAAoB;CAClD,CACF,CAAC;AACH,CAAC"}