sealmetrics 0.1.0 → 0.1.2

package/PROTOCOL.md

@@ -5,6 +5,12 @@ object terminated by `\n` (never multiline). Debug logs go to **stderr** only.
 An orchestrating agent parses the stream line by line and renders progress,
 diffs and the claim URL to its user.
 
+> **Report only what actually happened.** Treat the **exit code** as the source of
+> truth: success is a terminal `result` event with exit `0`. On a non-zero exit or
+> an `error` event, STOP and report the failure — never fabricate a success summary
+> (account id, files, snippet) from what the CLI *would* have done. See
+> "Error-handling contract" below.
+
 ## Envelope
 
 ```json
@@ -14,7 +20,7 @@ diffs and the claim URL to its user.
 | Field   | Meaning |
 |---------|---------|
 | `v`     | Protocol version (currently `1`). Bumped on breaking changes so parsers can branch. |
-| `type`  | `lifecycle` \| `file_change` \| `needs_input` \| `result` \| `error` |
+| `type`  | `lifecycle` \| `file_change` \| `needs_input` \| `confirm` \| `result` \| `error` |
 | `level` | `info` \| `warn` \| `error` |
 | `data`  | Type-specific payload (below). |
 
@@ -49,14 +55,53 @@ artefacts (`.env`, `seal.config.json`, `.sealmetrics/*`, MCP config, `.gitignore
 `action` is `plan` (with `diff`) before the write and `applied` after.
 
 ### `needs_input`
-In `--agent` every prompt is **auto-resolved** (from flags or a safe default)
-and the resolution is reported — the stream never blocks on stdin.
+The stream never blocks on stdin. There are **two** kinds, distinguished by the
+payload — do not treat them the same:
+
+1. **Auto-resolved** — carries `resolved`. The CLI already picked a safe value
+   (from a flag or a safe default) and reports it. The orchestrator just renders
+   it; nothing to ask.
+2. **Human-required** — carries `"requires_human": true` and **no** `resolved`.
+   The orchestrator **MUST ask the human** and **MUST NOT** auto-resolve, guess,
+   or accept on their behalf. This overrides the `--agent` auto-approve. After
+   collecting the answers, re-invoke the CLI with the corresponding flags.
+   These intentionally carry **no `default`** — there is no value to reuse, so do
+   not pre-fill or assume one; ask. `optional: true` means the human may leave it
+   blank (e.g. domain), but must still be offered the choice.
+
+> Never auto-accept the Terms of Service (`id: "accept_tos"`) or invent an email /
+> site name — those are `requires_human`. Provisioning creates a real account.
 
 ```json
+// auto-resolved
 { "v":1, "type":"needs_input", "level":"info",
   "data": { "id":"…", "prompt":"…", "default":"…", "resolved":"…" } }
+
+// human-required (ask the user; do not guess)
+{ "v":1, "type":"needs_input", "level":"info",
+  "data": { "id":"accept_tos", "prompt":"Accept the Terms of Service (…)?",
+            "options":["yes","no"], "requires_human": true } }
+```
+
+### `confirm`
+Two-phase commit. In `--agent`, the first run does **not** provision: once all
+required inputs are present it emits a `confirm` with the **exact payload** a real
+run would send, then exits `6` (CONFIRM_REQUIRED) having created nothing and
+written no files. The orchestrator **MUST** show these values to the human and,
+**only on an explicit yes**, re-run the command in `data.reinvoke_with` (it adds
+`--confirm`). Never add `--confirm` yourself or assume approval.
+
+```json
+{ "v":1, "type":"confirm", "level":"info",
+  "data": { "action":"create_free_account", "email":"…", "site_name":"…",
+            "domain":"…|null", "accept_tos":true, "base_url":"…",
+            "message":"Nothing has been created yet. …",
+            "reinvoke_with":"sealmetrics init --agent … --confirm" } }
 ```
 
+`-y` (non-interactive scripting, not `--agent`) treats the flags as consent and
+skips the gate. Interactive mode shows a summary + a `[Y/n]` prompt instead.
+
 ### `result`
 The final structured payload.
 
@@ -82,4 +127,25 @@ The final structured payload.
 | `3`  | `AUTH_REQUIRED` — provision key invalid/revoked (`error.data.command` carries the re-invocation) |
 | `4`  | Network / backend unavailable / rate-limited / kill-switch (503) |
 | `5`  | Verify-failed — snippet placed but pixel did not confirm within the timeout |
+| `6`  | Confirm-required — `--agent` previewed the payload (`confirm` event); re-run with `--confirm` to provision |
 | `130`| Cancelled (SIGINT) |
+
+## Error-handling contract (orchestrators MUST follow)
+
+The CLI signals failure in **two** redundant ways. An orchestrator MUST honor both:
+
+1. A **non-zero exit code** (table above), and
+2. An **`error` event** on the stream (`"type":"error"`).
+
+On either signal, the orchestrator **MUST STOP and report the failure to the user**
+— quoting `error.data.message` (and `hint`/`command` if present). It **MUST NOT**:
+
+- claim the account was created,
+- describe files as written, or
+- show an `account_id` / snippet / claim URL,
+
+unless it actually saw a **`result` event AND exit code `0`**. Success is **only** a
+terminal `result` with exit `0`; anything else is a failure. On failure no account
+is created and **no files are written** (the CLI writes its artefacts only after a
+successful provision). Never fabricate a success summary from expected behaviour —
+report exactly what the stream and exit code say.

package/dist/agent/ndjson.d.ts

@@ -0,0 +1,111 @@
+/**
+ * Output layer (Bloque 2). In `--agent` mode every stdout line is a versioned
+ * NDJSON envelope `{ v, type, level, data }` (RF-201/202/205); in human mode
+ * stdout is plain text (VAL-202). Debug logs always go to stderr (RF-201).
+ *
+ * Each envelope is a single line terminated by `\n` — never multiline
+ * (VAL-201), so an orchestrator can parse the stream line by line.
+ */
+export declare const PROTOCOL_VERSION = 1;
+export type EventType = "lifecycle" | "file_change" | "needs_input" | "confirm" | "result" | "error";
+export type Level = "info" | "warn" | "error";
+export interface Envelope {
+    v: number;
+    type: EventType;
+    level: Level;
+    data: Record<string, unknown>;
+}
+export interface FileChange {
+    path: string;
+    action: "plan" | "applied";
+    diff?: string;
+    bytes?: number;
+}
+export interface NeedsInput {
+    id: string;
+    prompt: string;
+    default?: string;
+    options?: string[];
+    /** Auto-resolved value (RF-203). Present ONLY for inputs the agent may resolve
+     *  on its own; its presence is what makes auto-approve legal for this input. */
+    resolved?: string;
+    /** When true, the orchestrator MUST ask the human and MUST NOT auto-resolve,
+     *  guess, or accept on their behalf (e.g. Terms of Service, identity fields).
+     *  Such inputs never carry `resolved`. */
+    requires_human?: boolean;
+    /** When true, the human may leave this blank (e.g. domain). Informational. */
+    optional?: boolean;
+}
+export interface ErrorData {
+    code: string;
+    message: string;
+    hint?: string;
+    [key: string]: unknown;
+}
+/**
+ * The exact payload a real provision WOULD send, surfaced before anything is
+ * created (two-phase commit). The orchestrator MUST show this to the human and,
+ * only on an explicit yes, re-invoke with `--confirm`. Nothing is created and no
+ * files are written until then.
+ */
+export interface ConfirmData {
+    action: string;
+    email: string;
+    site_name: string;
+    domain: string | null;
+    accept_tos: boolean;
+    base_url: string;
+    message: string;
+    reinvoke_with: string;
+}
+/**
+ * Reporter contract shared by the agent (NDJSON) and human renderers so the
+ * orchestrator logic in `init.ts` never branches on output mode.
+ */
+export interface Reporter {
+    readonly agent: boolean;
+    lifecycle(stage: string, data?: Record<string, unknown>, level?: Level): void;
+    fileChange(change: FileChange): void;
+    needsInput(input: NeedsInput): void;
+    /** Preview of what a real provision would send — emitted before creating
+     *  anything, so the human can approve it (two-phase commit). */
+    confirm(data: ConfirmData): void;
+    result(data: Record<string, unknown>): void;
+    error(data: ErrorData): void;
+    /** Human-facing info text. Suppressed in agent mode (kept off the NDJSON stream). */
+    info(message: string): void;
+    warn(message: string): void;
+    /** Debug — always stderr, never stdout. */
+    debug(message: string): void;
+}
+/** NDJSON reporter used in `--agent` mode. */
+export declare class AgentReporter implements Reporter {
+    readonly agent = true;
+    private emit;
+    lifecycle(stage: string, data?: Record<string, unknown>, level?: Level): void;
+    fileChange(change: FileChange): void;
+    needsInput(input: NeedsInput): void;
+    confirm(data: ConfirmData): void;
+    result(data: Record<string, unknown>): void;
+    error(data: ErrorData): void;
+    info(_message: string): void;
+    warn(message: string): void;
+    debug(message: string): void;
+}
+/** Human reporter used in interactive / `-y` mode (VAL-202). */
+export declare class HumanReporter implements Reporter {
+    readonly agent = false;
+    private readonly color;
+    constructor();
+    private c;
+    lifecycle(stage: string, data?: Record<string, unknown>): void;
+    fileChange(change: FileChange): void;
+    needsInput(input: NeedsInput): void;
+    confirm(_data: ConfirmData): void;
+    result(data: Record<string, unknown>): void;
+    error(data: ErrorData): void;
+    info(message: string): void;
+    warn(message: string): void;
+    debug(message: string): void;
+}
+//# sourceMappingURL=ndjson.d.ts.map

package/dist/agent/ndjson.d.ts.map

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

package/dist/agent/ndjson.js

@@ -0,0 +1,112 @@
+/**
+ * Output layer (Bloque 2). In `--agent` mode every stdout line is a versioned
+ * NDJSON envelope `{ v, type, level, data }` (RF-201/202/205); in human mode
+ * stdout is plain text (VAL-202). Debug logs always go to stderr (RF-201).
+ *
+ * Each envelope is a single line terminated by `\n` — never multiline
+ * (VAL-201), so an orchestrator can parse the stream line by line.
+ */
+export const PROTOCOL_VERSION = 1;
+function write(line) {
+    process.stdout.write(line + "\n");
+}
+/** Result fields that must never be printed, even if a caller includes them (VAL-404). */
+const BLOCKED_RESULT_KEYS = new Set(["api_key", "apiKey", "provision_key", "provisionKey"]);
+/** NDJSON reporter used in `--agent` mode. */
+export class AgentReporter {
+    agent = true;
+    emit(type, level, data) {
+        const env = { v: PROTOCOL_VERSION, type, level, data };
+        write(JSON.stringify(env));
+    }
+    lifecycle(stage, data = {}, level = "info") {
+        this.emit("lifecycle", level, { stage, ...data });
+    }
+    fileChange(change) {
+        this.emit("file_change", "info", { ...change });
+    }
+    needsInput(input) {
+        this.emit("needs_input", "info", { ...input });
+    }
+    confirm(data) {
+        this.emit("confirm", "info", { ...data });
+    }
+    result(data) {
+        this.emit("result", "info", data);
+    }
+    error(data) {
+        this.emit("error", "error", data);
+    }
+    info(_message) {
+        // No human prose on the NDJSON stream (RF-201). Route to stderr for debugging.
+        process.stderr.write(_message + "\n");
+    }
+    warn(message) {
+        process.stderr.write(message + "\n");
+    }
+    debug(message) {
+        if (process.env.SEALMETRICS_DEBUG)
+            process.stderr.write(message + "\n");
+    }
+}
+const bold = (s) => `\x1b[1m${s}\x1b[0m`;
+const dim = (s) => `\x1b[2m${s}\x1b[0m`;
+const green = (s) => `\x1b[32m${s}\x1b[0m`;
+const yellow = (s) => `\x1b[33m${s}\x1b[0m`;
+const red = (s) => `\x1b[31m${s}\x1b[0m`;
+/** Human reporter used in interactive / `-y` mode (VAL-202). */
+export class HumanReporter {
+    agent = false;
+    color;
+    constructor() {
+        this.color = process.stdout.isTTY === true && !process.env.NO_COLOR;
+    }
+    c(fn, s) {
+        return this.color ? fn(s) : s;
+    }
+    lifecycle(stage, data = {}) {
+        const detail = data["detail"] ?? data["framework"] ?? data["account_id"] ?? "";
+        const suffix = detail ? this.c(dim, ` ${detail}`) : "";
+        write(`${this.c(green, "→")} ${stage}${suffix}`);
+    }
+    fileChange(change) {
+        const verb = change.action === "applied" ? "wrote" : "plan";
+        write(`  ${this.c(dim, verb)} ${change.path}`);
+    }
+    needsInput(input) {
+        if (input.resolved !== undefined) {
+            write(`  ${this.c(dim, input.prompt)} ${input.resolved}`);
+        }
+    }
+    confirm(_data) {
+        // Human mode confirms via an interactive prompt (see init.ts), not this event.
+    }
+    result(data) {
+        write("");
+        write(this.c(bold, "Done."));
+        for (const [k, v] of Object.entries(data)) {
+            if (v === undefined || v === null)
+                continue;
+            // Defensive denylist: never print a secret even if a caller mis-includes one.
+            if (BLOCKED_RESULT_KEYS.has(k))
+                continue;
+            write(`  ${this.c(dim, k + ":")} ${String(v)}`);
+        }
+    }
+    error(data) {
+        write(`${this.c(red, "✗")} ${data.message}`);
+        if (data.hint)
+            write(`  ${this.c(dim, data.hint)}`);
+    }
+    info(message) {
+        write(message);
+    }
+    warn(message) {
+        write(this.c(yellow, message));
+    }
+    debug(message) {
+        if (process.env.SEALMETRICS_DEBUG)
+            process.stderr.write(message + "\n");
+    }
+}
+//# sourceMappingURL=ndjson.js.map

package/dist/agent/ndjson.js.map

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

package/dist/api/client.d.ts

@@ -0,0 +1,28 @@
+import type { ProvisionResult, PixelStatus } from "../types.js";
+/** Raised on 409 (email already exists) — init handles it as informative, exit 0 (RF-402). */
+export declare class EmailExistsError extends Error {
+    constructor();
+}
+export interface ProvisionInput {
+    siteName: string;
+    domain?: string;
+    email: string;
+    name?: string;
+    installSource: string;
+    timezone?: string;
+    /** Args to surface in the AUTH_REQUIRED re-invocation command (RF-204). */
+    reinvokeCommand?: string;
+}
+export declare class ApiClient {
+    private readonly baseUrl;
+    private readonly provisionKey;
+    constructor(baseUrl: string, provisionKey: string);
+    /** POST /provision. Throws CliError (3/4) or EmailExistsError on the mapped statuses. */
+    provision(input: ProvisionInput): Promise<ProvisionResult>;
+    /** GET /sites/{id}/pixel/status. Throws CliError(4) on network/backend errors. */
+    pixelStatus(accountId: string, apiKey: string): Promise<PixelStatus>;
+    private fetchWithTimeout;
+    private json;
+    private safeText;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/api/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/api/client.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAIhE,8FAA8F;AAC9F,qBAAa,gBAAiB,SAAQ,KAAK;;CAK1C;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,2EAA2E;IAC3E,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AASD,qBAAa,SAAS;IACpB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;gBAE1B,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM;IAKjD,yFAAyF;IACnF,SAAS,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,eAAe,CAAC;IA+EhE,kFAAkF;IAC5E,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;YA2B5D,gBAAgB;YAUhB,IAAI;YASJ,QAAQ;CAOvB"}

package/dist/api/client.js

@@ -0,0 +1,147 @@
+/**
+ * HTTP client for the Fase 1 backend (Bloque 4). Consumes, never changes, the
+ * existing contract: POST /provision (X-Provision-Key) and
+ * GET /sites/{id}/pixel/status (X-API-Key). Response maps to events/exit codes
+ * per RF-402.
+ */
+import { CliError, ExitCode } from "../exit-codes.js";
+const DEFAULT_TIMEOUT_MS = 30_000;
+/** Raised on 409 (email already exists) — init handles it as informative, exit 0 (RF-402). */
+export class EmailExistsError extends Error {
+    constructor() {
+        super("provision_unavailable");
+        this.name = "EmailExistsError";
+    }
+}
+export class ApiClient {
+    baseUrl;
+    provisionKey;
+    constructor(baseUrl, provisionKey) {
+        this.baseUrl = baseUrl.replace(/\/+$/, "");
+        this.provisionKey = provisionKey;
+    }
+    /** POST /provision. Throws CliError (3/4) or EmailExistsError on the mapped statuses. */
+    async provision(input) {
+        const body = {
+            site_name: input.siteName,
+            domain: input.domain,
+            email: input.email,
+            name: input.name,
+            accept_terms: true,
+            install_source: input.installSource,
+            timezone: input.timezone,
+        };
+        let res;
+        try {
+            res = await this.fetchWithTimeout(`${this.baseUrl}/provision`, {
+                method: "POST",
+                headers: {
+                    "Content-Type": "application/json",
+                    Accept: "application/json",
+                    "X-Provision-Key": this.provisionKey,
+                },
+                body: JSON.stringify(body),
+            });
+        }
+        catch (e) {
+            throw new CliError(ExitCode.NETWORK, "network_error", `Could not reach the SealMetrics API at ${this.baseUrl}.`, {
+                hint: e instanceof Error ? e.message : undefined,
+            });
+        }
+        if (res.status === 200) {
+            const json = (await this.json(res));
+            const data = json.data;
+            if (!data || !data.account_id || !data.api_key) {
+                throw new CliError(ExitCode.NETWORK, "bad_response", "Provisioning returned an unexpected response.");
+            }
+            return data;
+        }
+        if (res.status === 401) {
+            throw new CliError(ExitCode.AUTH_REQUIRED, "AUTH_REQUIRED", "The provision key was rejected (invalid or revoked).", {
+                hint: "Re-run with a valid publishable provision key.",
+                extra: {
+                    command: input.reinvokeCommand ??
+                        "npx sealmetrics init --provision-key <YOUR_KEY> --email <email> --accept-tos",
+                },
+            });
+        }
+        if (res.status === 409) {
+            throw new EmailExistsError();
+        }
+        if (res.status === 429) {
+            const retryAfter = parseRetryAfter(res.headers.get("Retry-After"));
+            throw new CliError(ExitCode.NETWORK, "rate_limited", "Provisioning is rate-limited. Please wait and retry.", {
+                extra: retryAfter ? { retry_after: retryAfter } : undefined,
+            });
+        }
+        if (res.status === 503) {
+            throw new CliError(ExitCode.NETWORK, "provisioning_disabled", "Provisioning is currently disabled on the server.", { hint: "The free-tier channel is not enabled yet. Try again later." });
+        }
+        const detail = await this.safeText(res);
+        throw new CliError(ExitCode.NETWORK, "backend_error", `Provisioning failed (HTTP ${res.status}).`, {
+            hint: detail.slice(0, 200) || undefined,
+        });
+    }
+    /** GET /sites/{id}/pixel/status. Throws CliError(4) on network/backend errors. */
+    async pixelStatus(accountId, apiKey) {
+        const url = `${this.baseUrl}/sites/${encodeURIComponent(accountId)}/pixel/status`;
+        let res;
+        try {
+            res = await this.fetchWithTimeout(url, {
+                method: "GET",
+                headers: { "X-API-Key": apiKey, Accept: "application/json" },
+            });
+        }
+        catch (e) {
+            throw new CliError(ExitCode.NETWORK, "network_error", "Could not reach the SealMetrics API.", {
+                hint: e instanceof Error ? e.message : undefined,
+            });
+        }
+        if (res.status !== 200) {
+            const detail = await this.safeText(res);
+            throw new CliError(ExitCode.NETWORK, "pixel_status_error", `Pixel status check failed (HTTP ${res.status}).`, {
+                hint: detail.slice(0, 200) || undefined,
+            });
+        }
+        const json = (await this.json(res));
+        const data = json.data;
+        if (!data || typeof data.installed !== "boolean") {
+            throw new CliError(ExitCode.NETWORK, "bad_response", "Pixel status returned an unexpected response.");
+        }
+        return data;
+    }
+    async fetchWithTimeout(url, init) {
+        const controller = new AbortController();
+        const timeout = setTimeout(() => controller.abort(), DEFAULT_TIMEOUT_MS);
+        try {
+            return await fetch(url, { ...init, signal: controller.signal });
+        }
+        finally {
+            clearTimeout(timeout);
+        }
+    }
+    async json(res) {
+        const text = await res.text();
+        try {
+            return JSON.parse(text);
+        }
+        catch {
+            throw new CliError(ExitCode.NETWORK, "bad_response", "The API returned invalid JSON.");
+        }
+    }
+    async safeText(res) {
+        try {
+            return await res.text();
+        }
+        catch {
+            return "";
+        }
+    }
+}
+function parseRetryAfter(header) {
+    if (!header)
+        return undefined;
+    const n = parseInt(header, 10);
+    return Number.isFinite(n) && n > 0 ? n : undefined;
+}
+//# sourceMappingURL=client.js.map

package/dist/api/client.js.map

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

package/dist/cli.d.ts

@@ -0,0 +1,37 @@
+export interface InitOptions {
+    email?: string;
+    name?: string;
+    siteName?: string;
+    domain?: string;
+    acceptTos: boolean;
+    installSource: string;
+    baseUrl: string;
+    region?: string;
+    agent: boolean;
+    yes: boolean;
+    resume: boolean;
+    dryRun: boolean;
+    confirm: boolean;
+    apiKey?: string;
+    provisionKey?: string;
+    noInject: boolean;
+    url?: string;
+    verifyTimeout: number;
+    editor?: string;
+    noMcp: boolean;
+    cwd: string;
+}
+/** Default backend per region; the published binary defaults to PROD (PRE-3). */
+export declare const REGION_BASE_URLS: Record<string, string>;
+export interface ParseResult {
+    options?: InitOptions;
+    help?: boolean;
+    version?: boolean;
+}
+/**
+ * Parse argv (already sliced past `node script init`). The leading subcommand
+ * (`init`) is tolerated if present.
+ */
+export declare function parseArgs(argv: string[]): ParseResult;
+export declare function helpText(): string;
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,WAAW;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,OAAO,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,OAAO,CAAC;IACf,GAAG,EAAE,OAAO,CAAC;IACb,MAAM,EAAE,OAAO,CAAC;IAChB,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,OAAO,CAAC;IAClB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,OAAO,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;CACb;AAED,iFAAiF;AACjF,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAOnD,CAAC;AA4CF,MAAM,WAAW,WAAW;IAC1B,OAAO,CAAC,EAAE,WAAW,CAAC;IACtB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAkBD;;;GAGG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,WAAW,CAkGrD;AAMD,wBAAgB,QAAQ,IAAI,MAAM,CAEjC"}