@ampersend_ai/ampersend-sdk 0.0.22 → 0.0.26

package/dist/cli/ampersend.js

@@ -1,20 +1,63 @@
 #!/usr/bin/env node
-import { Command } from "commander";
+import { Command, CommanderError } from "commander";
 import { VERSION } from "../version.js";
+import { registerAgentCommand } from "./commands/agent.js";
+import { registerCardCommand } from "./commands/card.js";
 import { registerConfigCommand } from "./commands/config.js";
 import { registerFetchCommand } from "./commands/fetch.js";
+import { registerFundCommand } from "./commands/fund.js";
 import { registerMarketplaceCommand } from "./commands/marketplace.js";
 import { registerSetupCommand } from "./commands/setup.js";
+import { registerVersionCommand } from "./commands/version.js";
+import { err } from "./envelope.js";
+// Map Commander's internal error codes to envelope codes. Anything not listed
+// here falls back to "CLI_USAGE_ERROR" so we never emit a raw stderr line that
+// breaks the documented JSON-only output contract.
+const COMMANDER_ERROR_CODES = {
+    "commander.unknownOption": "UNKNOWN_OPTION",
+    "commander.unknownCommand": "UNKNOWN_COMMAND",
+    "commander.missingArgument": "MISSING_ARGUMENT",
+    "commander.missingMandatoryOptionValue": "MISSING_OPTION",
+    "commander.optionMissingArgument": "MISSING_OPTION_ARGUMENT",
+    "commander.invalidArgument": "INVALID_ARGUMENT",
+    "commander.conflictingOption": "CONFLICTING_OPTION",
+    "commander.excessArguments": "EXCESS_ARGUMENTS",
+};
 async function main() {
     const program = new Command().name("ampersend").description("Command-line interface for ampersend").version(VERSION);
+    // Without exitOverride, Commander prints "error: unknown option '--foo'" to
+    // stderr and exits — bypassing our JSON envelope. Catch its CommanderError
+    // and re-throw so main()'s catch can format it. Help and version are not
+    // failures; let them exit cleanly. configureOutput silences Commander's
+    // own stderr line so the envelope is the only thing on the wire.
+    program.exitOverride((commanderErr) => {
+        if (commanderErr.code === "commander.helpDisplayed" || commanderErr.code === "commander.version") {
+            process.exit(commanderErr.exitCode);
+        }
+        throw commanderErr;
+    });
+    program.configureOutput({
+        outputError: () => { },
+    });
     registerConfigCommand(program);
     registerSetupCommand(program);
     registerFetchCommand(program);
+    registerAgentCommand(program);
+    registerCardCommand(program);
+    registerFundCommand(program);
     registerMarketplaceCommand(program);
+    registerVersionCommand(program);
     await program.parseAsync();
 }
 main().catch((error) => {
-    console.error(`Fatal: ${error instanceof Error ? error.message : String(error)}`);
+    if (error instanceof CommanderError) {
+        const code = COMMANDER_ERROR_CODES[error.code] ?? "CLI_USAGE_ERROR";
+        const message = error.message.replace(/^error:\s*/, "");
+        console.log(JSON.stringify(err(code, message), null, 2));
+        process.exit(error.exitCode || 1);
+    }
+    const message = error instanceof Error ? error.message : String(error);
+    console.log(JSON.stringify(err("CLI_FATAL", message), null, 2));
     process.exit(1);
 });
 //# sourceMappingURL=ampersend.js.map

package/dist/cli/ampersend.js.map

@@ -1 +1 @@
-{"version":3,"file":"ampersend.js","sourceRoot":"","sources":["../../src/cli/ampersend.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAEnC,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAA;AACvC,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAA;AAC5D,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAA;AAC1D,OAAO,EAAE,0BAA0B,EAAE,MAAM,2BAA2B,CAAA;AACtE,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAA;AAE1D,KAAK,UAAU,IAAI;IACjB,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,WAAW,CAAC,sCAAsC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,CAAA;IAEpH,qBAAqB,CAAC,OAAO,CAAC,CAAA;IAC9B,oBAAoB,CAAC,OAAO,CAAC,CAAA;IAC7B,oBAAoB,CAAC,OAAO,CAAC,CAAA;IAC7B,0BAA0B,CAAC,OAAO,CAAC,CAAA;IAEnC,MAAM,OAAO,CAAC,UAAU,EAAE,CAAA;AAC5B,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IACrB,OAAO,CAAC,KAAK,CAAC,UAAU,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAA;IACjF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;AACjB,CAAC,CAAC,CAAA"}
+{"version":3,"file":"ampersend.js","sourceRoot":"","sources":["../../src/cli/ampersend.ts"],"names":[],"mappings":"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"}

package/dist/cli/commands/agent.d.ts

@@ -0,0 +1,24 @@
+import type { Command } from "commander";
+import { AgentReadClient } from "../../ampersend/index.ts";
+import { type ContextSelector } from "../config.ts";
+interface BaseOptions {
+    raw: boolean;
+    context?: string;
+}
+/** Build an `AgentReadClient` from local config, or print an envelope-style error and exit. */
+export declare function buildClient(opts?: ContextSelector): AgentReadClient;
+/**
+ * Wrap a read call so success/failure both print the standard envelope.
+ * `--raw` mode prints the inner payload directly for scripting; the
+ * default JSON envelope is what the skill expects.
+ *
+ * BigInt is serialised as a decimal string — JSON has no native bigint
+ * and the DTOs decode wire strings into bigint values, so we have to
+ * project them back out when printing.
+ */
+export declare function emit(label: string, options: BaseOptions, run: () => Promise<unknown>): Promise<void>;
+export declare function parsePreset(value: string | undefined): "1d" | "30d" | "all" | undefined;
+export declare function parseIntFlag(name: string, value: string | undefined, max?: number): number | undefined;
+export declare function registerAgentCommand(program: Command): void;
+export {};
+//# sourceMappingURL=agent.d.ts.map

package/dist/cli/commands/agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/agent.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAExC,OAAO,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAA;AAC1D,OAAO,EAAoC,KAAK,eAAe,EAAE,MAAM,cAAc,CAAA;AAGrF,UAAU,WAAW;IACnB,GAAG,EAAE,OAAO,CAAA;IACZ,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAOD,+FAA+F;AAC/F,wBAAgB,WAAW,CAAC,IAAI,GAAE,eAAoB,GAAG,eAAe,CAYvE;AAED;;;;;;;;GAQG;AACH,wBAAsB,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,EAAE,GAAG,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAc1G;AAMD,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,GAAG,KAAK,GAAG,KAAK,GAAG,SAAS,CASvF;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,SAAS,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CActG;AAID,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA8F3D"}

package/dist/cli/commands/agent.js

@@ -0,0 +1,166 @@
+import { AgentReadClient } from "../../ampersend/index.js";
+import { DEFAULT_API_URL, loadCredentials } from "../config.js";
+import { err, ok } from "../envelope.js";
+const VALID_PRESETS = new Set(["1d", "30d", "all"]);
+/** `--context <name>` option, shared across the read subcommands. */
+const CONTEXT_DESCRIPTION = "Run against a specific context instead of the active one";
+/** Build an `AgentReadClient` from local config, or print an envelope-style error and exit. */
+export function buildClient(opts = {}) {
+    const result = loadCredentials(opts);
+    if (!result.ok) {
+        console.log(JSON.stringify(result.error, null, 2));
+        process.exit(1);
+    }
+    const { agentAccount, agentKey, apiUrl } = result.credentials;
+    return new AgentReadClient({
+        baseUrl: apiUrl ?? DEFAULT_API_URL,
+        agentAddress: agentAccount,
+        sessionKeyPrivateKey: agentKey,
+    });
+}
+/**
+ * Wrap a read call so success/failure both print the standard envelope.
+ * `--raw` mode prints the inner payload directly for scripting; the
+ * default JSON envelope is what the skill expects.
+ *
+ * BigInt is serialised as a decimal string — JSON has no native bigint
+ * and the DTOs decode wire strings into bigint values, so we have to
+ * project them back out when printing.
+ */
+export async function emit(label, options, run) {
+    try {
+        const data = await run();
+        const payload = options.raw ? data : ok(data);
+        console.log(JSON.stringify(payload, bigintReplacer, 2));
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        if (options.raw) {
+            console.error(`Error: ${message}`);
+        }
+        else {
+            console.log(JSON.stringify(err("AGENT_READ_ERROR", `${label}: ${message}`), null, 2));
+        }
+        process.exit(1);
+    }
+}
+function bigintReplacer(_key, value) {
+    return typeof value === "bigint" ? value.toString() : value;
+}
+export function parsePreset(value) {
+    if (value === undefined)
+        return undefined;
+    if (!VALID_PRESETS.has(value)) {
+        console.log(JSON.stringify(err("INVALID_PRESET", `Invalid --preset: ${value}. Must be one of: 1d, 30d, all`), null, 2));
+        process.exit(1);
+    }
+    return value;
+}
+export function parseIntFlag(name, value, max) {
+    if (value === undefined)
+        return undefined;
+    // Strict regex before parseInt: parseInt("1.5") === 1 silently drops the
+    // fraction, and parseInt(" 5 ") accepts whitespace.
+    if (!/^[1-9]\d*$/.test(value)) {
+        console.log(JSON.stringify(err("INVALID_FLAG", `--${name} must be a positive integer`), null, 2));
+        process.exit(1);
+    }
+    const n = Number.parseInt(value, 10);
+    if (max !== undefined && n > max) {
+        console.log(JSON.stringify(err("INVALID_FLAG", `--${name} must be ≤ ${max}`), null, 2));
+        process.exit(1);
+    }
+    return n;
+}
+const PRESET_DESCRIPTION = "Timerange: 1d (today), 30d (last 30 days), or all";
+export function registerAgentCommand(program) {
+    // `agent` is both a runnable command (getSelf) and a parent of subcommands.
+    // When a flag like `--context` is declared on both the parent and a
+    // subcommand, Commander binds a post-subcommand flag to the parent, leaving
+    // the subcommand's own opts without it. `optsWithGlobals()` merges the
+    // parent's options down so the selector resolves wherever it was passed.
+    const merged = (options, command) => ({ ...options, ...command.optsWithGlobals() });
+    const agent = program
+        .command("agent")
+        .description("Read the calling agent's own state (server-authoritative)")
+        .option("--raw", "Print only the inner data, no JSON envelope", false)
+        .option("--context <name>", CONTEXT_DESCRIPTION)
+        .action(async (options, command) => {
+        const opts = merged(options, command);
+        await emit("getSelf", opts, () => buildClient(opts).getSelf());
+    });
+    agent
+        .command("spend-config")
+        .description("Show spending policy (per-tx, daily, monthly limits, auto-topup)")
+        .option("--raw", "Print only the inner data, no JSON envelope", false)
+        .option("--context <name>", CONTEXT_DESCRIPTION)
+        .action(async (options, command) => {
+        const opts = merged(options, command);
+        await emit("spend-config", opts, () => buildClient(opts).getSpendConfig());
+    });
+    agent
+        .command("auto-collect-config")
+        .description("Show auto-collect (earnings sweep) configuration")
+        .option("--raw", "Print only the inner data, no JSON envelope", false)
+        .option("--context <name>", CONTEXT_DESCRIPTION)
+        .action(async (options, command) => {
+        const opts = merged(options, command);
+        await emit("auto-collect-config", opts, () => buildClient(opts).getAutoCollectConfig());
+    });
+    agent
+        .command("authorized-sellers")
+        .description("Show the seller allowlist this agent is permitted to pay")
+        .option("--raw", "Print only the inner data, no JSON envelope", false)
+        .option("--context <name>", CONTEXT_DESCRIPTION)
+        .action(async (options, command) => {
+        const opts = merged(options, command);
+        await emit("authorized-sellers", opts, () => buildClient(opts).getAuthorizedSellers());
+    });
+    agent
+        .command("payments")
+        .description("Show outgoing payments")
+        .option("--raw", "Print only the inner data, no JSON envelope", false)
+        .option("--preset <preset>", PRESET_DESCRIPTION)
+        .option("--context <name>", CONTEXT_DESCRIPTION)
+        .action(async (options, command) => {
+        const opts = merged(options, command);
+        await emit("payments", opts, () => {
+            const preset = parsePreset(opts.preset);
+            return buildClient(opts).getPayments(preset ? { preset } : {});
+        });
+    });
+    agent
+        .command("activity")
+        .description("Show unified spend + earn activity, paginated")
+        .option("--raw", "Print only the inner data, no JSON envelope", false)
+        .option("--preset <preset>", PRESET_DESCRIPTION)
+        .option("--limit <n>", "Items per page (max 200, default 20)")
+        .option("--page <n>", "Page number (1-indexed, default 1)")
+        .option("--context <name>", CONTEXT_DESCRIPTION)
+        .action(async (options, command) => {
+        const opts = merged(options, command);
+        await emit("activity", opts, () => {
+            const params = {};
+            const preset = parsePreset(opts.preset);
+            if (preset !== undefined)
+                params.preset = preset;
+            const limit = parseIntFlag("limit", opts.limit, 200);
+            if (limit !== undefined)
+                params.limit = limit;
+            const page = parseIntFlag("page", opts.page);
+            if (page !== undefined)
+                params.page = page;
+            return buildClient(opts).getActivity(params);
+        });
+    });
+    agent
+        .command("owner")
+        .description("Show the owner's narrow projection ({ user_id, wallet_address })")
+        .option("--raw", "Print only the inner data, no JSON envelope", false)
+        .option("--context <name>", CONTEXT_DESCRIPTION)
+        .action(async (options, command) => {
+        const opts = merged(options, command);
+        await emit("owner", opts, () => buildClient(opts).getOwner());
+    });
+}
+//# sourceMappingURL=agent.js.map

package/dist/cli/commands/agent.js.map

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

package/dist/cli/commands/card.d.ts

@@ -0,0 +1,128 @@
+import type { Command } from "commander";
+import { Schema } from "effect";
+import { type JsonEnvelope } from "../envelope.ts";
+/**
+ * One card as returned by `/get-card-data`. Secrets live under `card_details`
+ * and only once the card is ready; expiry is split into `exp_month`/`exp_year`.
+ * `available_balance` (vs `usd_amount`) tells you how much has been spent.
+ * Tolerant: we decode only the fields we surface and let Effect strip the rest.
+ */
+declare const LasoCardData: Schema.Struct<{
+    readonly card_id: Schema.String;
+    readonly status: Schema.String;
+    readonly usd_amount: Schema.optional<Schema.Number>;
+    readonly timestamp: Schema.optional<Schema.Number>;
+    readonly card_type: Schema.optional<Schema.String>;
+    readonly card_details: Schema.optional<Schema.Struct<{
+        readonly card_number: Schema.optional<Schema.String>;
+        readonly exp_month: Schema.optional<Schema.String>;
+        readonly exp_year: Schema.optional<Schema.String>;
+        readonly cvv: Schema.optional<Schema.String>;
+        readonly available_balance: Schema.optional<Schema.Number>;
+    }>>;
+    readonly transactions: Schema.optional<Schema.$Array<Schema.Struct<{
+        readonly amount: Schema.optional<Schema.Union<readonly [Schema.Number, Schema.String]>>;
+        readonly date: Schema.optional<Schema.Union<readonly [Schema.String, Schema.Number]>>;
+        readonly description: Schema.optional<Schema.String>;
+        readonly is_credit: Schema.optional<Schema.Boolean>;
+    }>>>;
+}>;
+/** A decoded Laso card record (raw Laso field names). */
+type LasoCard = typeof LasoCardData.Type;
+interface IssueOptions {
+    amount?: string;
+    raw: boolean;
+    context?: string;
+}
+interface DetailsOptions {
+    pay: boolean;
+    reveal: boolean;
+    raw: boolean;
+    context?: string;
+}
+interface ListOptions {
+    pay: boolean;
+    raw: boolean;
+    context?: string;
+}
+/**
+ * Validate and normalize the `--amount` flag. Returns the trimmed USD string
+ * (Laso wants it verbatim in the query) or an error envelope. Rejects
+ * non-numeric, non-positive, and out-of-range values up front so we never
+ * spend on a request Laso would bounce.
+ */
+declare function validateAmount(raw: string | undefined): JsonEnvelope<string>;
+/** A transaction as surfaced to the agent (load, spends, refunds). Not masked. */
+interface TransactionView {
+    amount?: number | string;
+    date?: string | number;
+    description?: string;
+    is_credit?: boolean;
+}
+/**
+ * A card as surfaced to the agent. A stable shape independent of Laso's wire
+ * format: `pan`/`cvv`/`expiry` regardless of how Laso nests them. Secrets are
+ * present only on a ready card, and masked unless `--reveal`.
+ *
+ * `amount` is the original load; `balance` is what's spendable now. Usage is
+ * read from the pair: unused when `balance === amount`, spent = `amount - balance`.
+ */
+interface CardView {
+    card_id: string;
+    status: string;
+    amount?: number;
+    balance?: number;
+    ordered_at?: string;
+    card_type?: string;
+    pan?: string;
+    cvv?: string;
+    expiry?: string;
+    transactions?: ReadonlyArray<TransactionView>;
+}
+/**
+ * Normalize a decoded Laso card into the agent-facing view. Flattens the
+ * `card_details` nesting, composes `expiry` from `exp_month`/`exp_year`
+ * (e.g. "09" + "26" → "09/26"), surfaces `balance` (available_balance) next to
+ * `amount`, and converts the order `timestamp` (Unix ms) to an ISO string.
+ *
+ * `includeTransactions` is false for `list` (keep it compact) and true for
+ * `details`. Balance/secrets/transactions appear only on ready cards.
+ */
+declare function toCardView(card: LasoCard, includeTransactions?: boolean): CardView;
+/**
+ * Mask a PAN to its last four digits in groups of four: e.g. `4242424242424242`
+ * → `•••• •••• •••• 4242`. Tolerates spaces/dashes in the input and short
+ * inputs (fewer than four digits are shown as-is behind a single dot group).
+ */
+declare function maskPan(pan: string): string;
+/**
+ * Apply masking to an agent-facing card view unless `reveal` is set. Only the
+ * two secrets — PAN and CVV — are masked; everything else (including `expiry`,
+ * which isn't a secret on its own) passes through. Returns a copy.
+ */
+declare function maskCard(card: CardView, reveal: boolean): CardView;
+/** Compute a token's expiry ISO string from `/auth`'s `expires_in` (seconds). */
+declare function tokenExpiry(expiresInSeconds: number | undefined): string;
+/**
+ * `card issue --amount <usd>`: order a card. This is the stated-amount spend,
+ * so there is no --pay flag. Returns `{ card_id, status, payment }`; the agent
+ * polls `details <id>` until `status: "ready"`.
+ */
+declare function executeIssue(options: IssueOptions): Promise<void>;
+/**
+ * `card details <id> [--pay] [--reveal]`: fetch one card's status and (once
+ * ready) its data. A still-provisioning card returns `ok:true` with
+ * `status: "pending"` and no card data — not an error.
+ */
+declare function executeDetails(id: string, options: DetailsOptions): Promise<void>;
+/**
+ * `card list [--pay]`: all issued cards (always masked). Same token rules as
+ * `details`.
+ */
+declare function executeList(options: ListOptions): Promise<void>;
+/**
+ * Register the `card` subcommand on a Commander program.
+ */
+export declare function registerCardCommand(program: Command): void;
+export { executeDetails, executeIssue, executeList, maskCard, maskPan, toCardView, tokenExpiry, validateAmount };
+//# sourceMappingURL=card.d.ts.map

package/dist/cli/commands/card.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"card.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/card.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AACxC,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAU/B,OAAO,EAAW,KAAK,YAAY,EAAE,MAAM,gBAAgB,CAAA;AAwE3D;;;;;GAKG;AACH,QAAA,MAAM,YAAY;;;;;;;;;;;;;;;;;;;EAgBhB,CAAA;AAYF,yDAAyD;AACzD,KAAK,QAAQ,GAAG,OAAO,YAAY,CAAC,IAAI,CAAA;AAKxC,UAAU,YAAY;IACpB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,GAAG,EAAE,OAAO,CAAA;IACZ,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAED,UAAU,cAAc;IACtB,GAAG,EAAE,OAAO,CAAA;IACZ,MAAM,EAAE,OAAO,CAAA;IACf,GAAG,EAAE,OAAO,CAAA;IACZ,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAED,UAAU,WAAW;IACnB,GAAG,EAAE,OAAO,CAAA;IACZ,GAAG,EAAE,OAAO,CAAA;IACZ,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAKD;;;;;GAKG;AACH,iBAAS,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,YAAY,CAAC,MAAM,CAAC,CAerE;AAED,kFAAkF;AAClF,UAAU,eAAe;IACvB,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;IACxB,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;IACtB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,SAAS,CAAC,EAAE,OAAO,CAAA;CACpB;AAED;;;;;;;GAOG;AACH,UAAU,QAAQ;IAChB,OAAO,EAAE,MAAM,CAAA;IACf,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,YAAY,CAAC,EAAE,aAAa,CAAC,eAAe,CAAC,CAAA;CAC9C;AAED;;;;;;;;GAQG;AACH,iBAAS,UAAU,CAAC,IAAI,EAAE,QAAQ,EAAE,mBAAmB,UAAQ,GAAG,QAAQ,CAuBzE;AAED;;;;GAIG;AACH,iBAAS,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAIpC;AAED;;;;GAIG;AACH,iBAAS,QAAQ,CAAC,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,GAAG,QAAQ,CAO3D;AAED,iFAAiF;AACjF,iBAAS,WAAW,CAAC,gBAAgB,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAGjE;AA6FD;;;;GAIG;AACH,iBAAe,YAAY,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAyChE;AAED;;;;GAIG;AACH,iBAAe,cAAc,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAwBhF;AAED;;;GAGG;AACH,iBAAe,WAAW,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAqB9D;AAgBD;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAkC1D;AAED,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,WAAW,EAAE,QAAQ,EAAE,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,cAAc,EAAE,CAAA"}