@agirails/sdk 4.4.8 → 4.5.2

package/dist/cli/commands/test.js

@@ -18,13 +18,39 @@
  *
  * @module cli/commands/test
  */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.runTest = exports.createTestCommand = void 0;
+exports.offerShareOnX = exports.safeLocalReflection = exports.isSentinelProvider = exports.runTest = exports.createTestCommand = void 0;
 const commander_1 = require("commander");
 const output_1 = require("../utils/output");
 const client_1 = require("../utils/client");
 const resolveAgent_1 = require("../lib/resolveAgent");
 const runRequest_1 = require("../lib/runRequest");
+const sentinelReflections_1 = require("../lib/sentinelReflections");
+const receipt_1 = require("./receipt");
+const share_1 = require("../utils/share");
 // ============================================================================
 // Command Definition
 // ============================================================================
@@ -138,7 +164,24 @@ async function runTest(output) {
     //    Sentinel returns { reflection, service, timestamp }; if it's wrapped
     //    in a delivery-proof envelope (`{ type: 'delivery.proof', result: {...} }`),
     //    unwrap once. Fall back to printing the raw payload otherwise.
-    const reflection = extractReflection(result.payload);
+    const channelReflection = extractReflection(result.payload);
+    // 4b. Local fallback path. If the channel produced nothing (envelope
+    //     missing, decrypt failed, wrong shape) AND we know this is the
+    //     Sentinel provider, render the day's reflection from the vendored
+    //     local table. The determinism contract means buyers who later
+    //     retry will see the same quote Sentinel would have streamed.
+    //
+    //     Strictly additive: when `channelReflection` is set, we use it
+    //     verbatim and never look at the local table. The local path only
+    //     activates when the channel is dormant — there is no race here.
+    const isSentinel = isSentinelProvider(sentinel.address);
+    const fallback = channelReflection === undefined && isSentinel ? safeLocalReflection() : undefined;
+    const reflection = channelReflection ?? fallback?.text;
+    const reflectionSource = channelReflection
+        ? 'channel'
+        : fallback
+            ? 'local-fallback'
+            : 'none';
     output.print('');
     output.result({
         txId: result.txId,
@@ -146,9 +189,17 @@ async function runTest(output) {
         elapsedMs: result.elapsedMs,
         settled: result.settled,
         reflection,
+        reflectionSource,
         payload: result.payload,
         receiptUrl: result.receiptUrl,
     }, { quietKey: 'reflection' });
+    // Caveat indicator — shown only in human mode and only when we filled
+    // in the reflection from the local table. JSON consumers learn the same
+    // thing via the `reflectionSource` field above, so we don't need to
+    // duplicate it through `output.warning` for them.
+    if (reflectionSource === 'local-fallback') {
+        output.info('Reflection rendered from local cache while channel delivery activates.');
+    }
     // Footer wording is conditional on what actually happened. The
     // structured JSON output above always reports `settled`, but human-mode
     // consumers see only the line emitted here — so a settle failure that
@@ -168,13 +219,46 @@ async function runTest(output) {
         output.blank();
         output.success(`Settled in ${result.elapsedMs} ms`);
     }
+    // FIX-5: Ceremonial framed receipt (renderReceiptV3) — the wow-path
+    // visual artifact for the buyer. Human mode only: JSON / quiet consumers
+    // already received their structured payload from `output.result(...)`
+    // above. Calling V3 in those modes would emit a duplicate JSON line or
+    // a duplicate "$9.90 USDC" line.
+    if (output.mode === 'human') {
+        output.blank();
+        (0, receipt_1.renderReceiptV3)({
+            agent: 'your-agent',
+            counterparty: 'Sentinel',
+            service: 'onboarding',
+            amountWei: 10000000n,
+            network: 'base-sepolia',
+            txId: result.txId,
+            timing: { totalMs: result.elapsedMs, escrowLockMs: 0, settlementMs: 0 },
+            reflection: reflection ?? undefined,
+            receiptUrl: result.receiptUrl,
+            requester: sentinel.address,
+        }, output);
+    }
     // Receipt URL — the wow artifact. Only present when the buyer-side V2
     // push succeeded (real on-chain network + signer). Silent when null:
     // either mock, or the push failed (indexer cron is the backstop).
+    //
+    // We keep the standalone "Receipt: <url>" line even though the V3 frame
+    // above already renders the URL inside its own block: the single-line
+    // form is the copy-paste-friendly anchor that downstream tests / scripts
+    // grep for (`captured.log.find(l => l.startsWith('Receipt: '))`).
     if (result.receiptUrl) {
         output.blank();
         output.print(`Receipt: ${result.receiptUrl}`);
     }
+    // 5. Tweet offer — the Purple Cow moment. Non-TTY skips silently so
+    //    CI / piped consumers never block. Failures (browser open, clipboard)
+    //    degrade gracefully to printing the raw URL.
+    await offerShareOnX({
+        txId: result.txId,
+        receiptUrl: result.receiptUrl,
+        settled: result.settled,
+    }, output);
 }
 exports.runTest = runTest;
 function extractReflection(payload) {
@@ -192,4 +276,182 @@ function extractReflection(payload) {
     }
     return undefined;
 }
+/**
+ * Return the day's local-fallback reflection text + id. Defensively wrapped
+ * so any future failure inside `todaysReflection` (corrupted table import,
+ * invalid Date) can never abort the `actp test` flow — the buyer still
+ * gets their receipt, just without a quote.
+ */
+function safeLocalReflection() {
+    try {
+        const r = (0, sentinelReflections_1.todaysReflection)();
+        if (!r || typeof r.text !== 'string' || r.text.length === 0)
+            return undefined;
+        return { id: r.id, text: r.text };
+    }
+    catch {
+        return undefined;
+    }
+}
+exports.safeLocalReflection = safeLocalReflection;
+/**
+ * Does `providerAddress` match a known Sentinel deployment? We compare
+ * against the resolved Sentinel address for Base Sepolia (env override or
+ * constant table), case-insensitively because EIP-55 checksum casing is
+ * not stable across components in the pipeline.
+ *
+ * Defensive: any failure to resolve Sentinel (missing table entry,
+ * invalid env var) returns false — the local-fallback path is opt-in
+ * only when we are confident the provider is Sentinel. Mis-rendering a
+ * Sentinel reflection on someone else's transaction would be worse than
+ * silently omitting it.
+ */
+function isSentinelProvider(providerAddress) {
+    try {
+        const sentinel = (0, resolveAgent_1.resolveAgent)('sentinel', 'base-sepolia');
+        return sentinel.address.toLowerCase() === providerAddress.toLowerCase();
+    }
+    catch {
+        return false;
+    }
+}
+exports.isSentinelProvider = isSentinelProvider;
+/**
+ * Default dependency bundle that wires to the real readline / share.ts
+ * implementations. Tests override these via the second arg.
+ */
+function defaultShareDeps() {
+    return {
+        prompt: async (question) => {
+            const readline = await Promise.resolve().then(() => __importStar(require('readline')));
+            const rl = readline.createInterface({
+                input: process.stdin,
+                output: process.stdout,
+            });
+            try {
+                return await new Promise((resolve) => {
+                    rl.question(question, resolve);
+                });
+            }
+            finally {
+                rl.close();
+            }
+        },
+        openUrl: share_1.openUrl,
+        copyToClipboard: share_1.copyToClipboardOSC52,
+        isTty: () => Boolean(process.stdout.isTTY),
+    };
+}
+/**
+ * After a successful test transaction, ask the user whether they want to
+ * share it on X (formerly Twitter). The whole flow is fail-soft:
+ *
+ *   - human mode only — json / quiet never see this UX
+ *   - non-TTY → skip entirely (no blocking prompt in CI)
+ *   - declined → no browser open, no clipboard touch
+ *   - accepted → openUrl; if openUrl returns false, fall back to printing
+ *     the URL and copying it to the clipboard so the user can paste it
+ *   - 'c' option → copy URL to clipboard only (no browser)
+ *
+ * The function returns the chosen action so the caller / tests can assert
+ * which path was taken without having to scrape console output.
+ *
+ * Visible only in `human` mode; returns `'skipped'` for json / quiet.
+ *
+ * @param result - Subset of the runRequest result needed to build the tweet.
+ * @param output - Output instance (controls human / json / quiet mode).
+ * @param deps - Injected dependencies (defaults to readline + share.ts).
+ * @returns The action taken: 'tweet', 'copy', 'declined', 'skipped', or 'failed'.
+ */
+async function offerShareOnX(result, output, deps = defaultShareDeps()) {
+    // Never prompt in json / quiet — those modes are for scripts.
+    if (output.mode !== 'human')
+        return 'skipped';
+    // Non-TTY skips silently. CI / piped consumers must never block.
+    if (!deps.isTty())
+        return 'skipped';
+    // Build tweet variants. We don't have a settle eth-tx-hash in the
+    // RunRequestResult, but the ACTP txId is the canonical reference and
+    // round-trips back to the receipt page. When the receipt URL is
+    // present, we splice it in — that's the strongest single artifact.
+    // Net amount: the runTest amount is fixed at $10, and the fee floor is
+    // max($10 * 1%, $0.05) = $0.10, so net = $9.90. We don't recompute it
+    // from the result because (a) the result currently doesn't expose the
+    // fee breakdown and (b) keeping it stable keeps the tweet template
+    // testable.
+    const NET_AMOUNT_USD = '9.90';
+    let tweetText;
+    if (result.receiptUrl) {
+        // Testnet template + receipt URL takes precedence over the txId
+        // fragment — the receipt URL is the prettier, click-throughable
+        // artifact.
+        const base = (0, share_1.buildTestnetTweet)(NET_AMOUNT_USD, result.txId);
+        tweetText = `${base}\n\nReceipt: ${result.receiptUrl}`;
+    }
+    else if (result.settled) {
+        // Settled but no receipt URL (push failed / not pushed). Use the
+        // testnet template with just the txId — basescan link still works.
+        tweetText = (0, share_1.buildTestnetTweet)(NET_AMOUNT_USD, result.txId);
+    }
+    else {
+        // Mock or unsettled: use the generic earn template.
+        tweetText = (0, share_1.buildMockTweet)(NET_AMOUNT_USD);
+    }
+    // Twitter's hard limit is 280; URL-encoding can balloon the actual
+    // request URL but the displayed tweet text is what counts. If we're
+    // over budget, fall back to the mock template which is short.
+    if (tweetText.length > 280) {
+        tweetText = (0, share_1.buildMockTweet)(NET_AMOUNT_USD);
+    }
+    const intentUrl = (0, share_1.buildTwitterIntentUrl)(tweetText);
+    // Prompt. Y = open browser, c = copy URL, anything else = decline.
+    output.blank();
+    output.print('Share your first AGIRAILS transaction on X?');
+    output.print('  [Y] open in browser   [c] copy link only   [n] skip');
+    let answer;
+    try {
+        answer = await deps.prompt('Choice (Y/c/n): ');
+    }
+    catch {
+        // Prompt failed (stdin closed mid-flight). Treat as decline.
+        return 'declined';
+    }
+    const trimmed = answer.trim().toLowerCase();
+    // Copy-only branch.
+    if (trimmed === 'c' || trimmed === 'copy') {
+        const copied = deps.copyToClipboard(intentUrl);
+        if (copied) {
+            output.info('Tweet URL copied to clipboard — paste it anywhere to share.');
+        }
+        else {
+            // OSC 52 unsupported. Print the URL so the user can copy manually.
+            output.print('Tweet URL (copy manually):');
+            output.print(`  ${intentUrl}`);
+        }
+        return 'copy';
+    }
+    // Decline branch: any explicit "no" answer.
+    if (trimmed === 'n' || trimmed === 'no') {
+        return 'declined';
+    }
+    // Accept branch: empty (Enter), y, yes. Open browser.
+    const opened = deps.openUrl(intentUrl);
+    if (opened) {
+        output.info('Opening X in your browser…');
+        return 'tweet';
+    }
+    // Browser open failed (unsupported platform, spawn error). Fall back
+    // to clipboard + visible URL so the user still has a path forward.
+    output.warning('Could not open browser automatically.');
+    const copied = deps.copyToClipboard(intentUrl);
+    if (copied) {
+        output.info('Tweet URL copied to clipboard instead — paste it in your browser.');
+    }
+    else {
+        output.print('Open this URL to tweet:');
+        output.print(`  ${intentUrl}`);
+    }
+    return 'failed';
+}
+exports.offerShareOnX = offerShareOnX;
 //# sourceMappingURL=test.js.map

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

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

package/dist/cli/lib/runRequest.d.ts

@@ -40,6 +40,7 @@
  * @module cli/lib/runRequest
  */
 import { TransactionState } from '../../runtime/types/MockState';
+import { type DeliveryChannel, type DeliveryError, type DeliveryPrivacy } from '../../delivery';
 export type RequestNetwork = 'mock' | 'testnet' | 'mainnet';
 export interface RunRequestOptions {
     /** Provider — checksummed or lowercase Ethereum address. */
@@ -70,6 +71,81 @@ export interface RunRequestOptions {
     stateDirectory?: string;
     /** Called for every state transition the requester observes. */
     onTransition?: (state: TransactionState, txId: string, ts: Date) => void;
+    /**
+     * Delivery channel for AIP-16 setup POST + envelope subscription.
+     *
+     * When omitted, runRequest behaves exactly as before — no setup is posted,
+     * no envelope subscription runs, and `payload` falls back to the legacy
+     * `tx.deliveryProof` parsing path. Tests and pre-AIP-16 deployments are
+     * unaffected.
+     *
+     * When provided AND `expectedKernelAddress` + `expectedChainId` are also
+     * supplied, runRequest:
+     *  1. signs and POSTs a `DeliverySetupWireV1` between createTransaction
+     *     and linkEscrow,
+     *  2. subscribes to envelopes in parallel with state polling,
+     *  3. populates `RunRequestResult.payload` from the decrypted (or parsed)
+     *     envelope body once one arrives.
+     */
+    deliveryChannel?: DeliveryChannel;
+    /**
+     * Trusted ACTP kernel address for EIP-712 setup/envelope binding.
+     *
+     * Required (alongside `deliveryChannel` + `expectedChainId`) to enable
+     * the AIP-16 delivery flow. Used as the EIP-712 `verifyingContract`
+     * domain anchor and as the envelope-verifier allowlist anchor.
+     */
+    expectedKernelAddress?: string;
+    /**
+     * Trusted EVM chain id for the AIP-16 delivery binding (e.g. 84532 for
+     * Base Sepolia, 8453 for Base mainnet).
+     *
+     * Required (alongside `deliveryChannel` + `expectedKernelAddress`) to
+     * enable the AIP-16 delivery flow.
+     */
+    expectedChainId?: number;
+    /**
+     * Grace period (in milliseconds) to keep the envelope subscription open
+     * AFTER the transaction reaches DELIVERED. Default 30_000 (30s).
+     *
+     * Settlement is NEVER blocked by the wait — if the envelope arrives
+     * before DELIVERED, `payload` is populated and the subscription closes
+     * early. If the grace period elapses with no envelope, runRequest
+     * proceeds with `payload = undefined` and `deliveryError.code =
+     * 'envelope_missing'` set (informational; not fatal).
+     */
+    envelopeWaitMs?: number;
+    /**
+     * Privacy posture requested in the buyer setup. Default `"public"`.
+     *
+     * `"public"`: setup carries `buyerEphemeralPubkey = CANONICAL_EMPTY_BYTES32`;
+     *   envelope body is plaintext UTF-8 JSON (`public-v1` scheme); no
+     *   ephemeral keypair is generated.
+     *
+     * `"encrypted"`: an ephemeral X25519 keypair is generated for this
+     *   call; the public key is embedded in the signed setup; the private
+     *   key is held in this closure ONLY (never persisted, never returned)
+     *   and used to decrypt the envelope body once it arrives.
+     */
+    deliveryPrivacy?: DeliveryPrivacy;
+    /**
+     * CoinbaseSmartWallet factory nonce used to derive the buyer's
+     * `requesterAddress` from the EOA `signerAddress`. Default `0` (the
+     * first wallet per owner).
+     *
+     * H4 fix (AIP-16 Phase 3 HIGH) — high-level surface. Buyers whose
+     * Smart Wallet was deployed at a non-zero factory nonce MUST pass that
+     * nonce here so the AIP-16 server-side derivation lands on the correct
+     * address. Omitting it (or passing `0`) reproduces the legacy behavior
+     * and yields byte-identical signing for the vast majority of callers
+     * (auto-wallet deploys at nonce=0).
+     *
+     * Threaded into {@link DeliverySetupBuilder.build}. Negative or
+     * non-integer values are rejected by the builder with
+     * `BUILDER_INVALID_SMART_WALLET_NONCE` (surfaces as `setup_post_failed`
+     * `deliveryError` here — settlement still proceeds).
+     */
+    smartWalletNonce?: number;
 }
 export declare class QuoteTimeoutError extends Error {
     readonly txId: string;
@@ -105,6 +181,20 @@ export interface RunRequestResult {
      *   - network is 'mock' (no real chain ⇒ no real receipt to publish)
      */
     receiptUrl: string | null;
+    /**
+     * Structured non-fatal delivery error if any AIP-16 step failed.
+     *
+     * Set when:
+     *  - the setup POST timed out or failed (`setup_post_failed`),
+     *  - the envelope grace period elapsed with no envelope (`envelope_missing`),
+     *  - envelope decryption / parsing failed (`envelope_decrypt_failed`).
+     *
+     * NEVER set when the delivery channel was not provided (AIP-16 was off).
+     * Settlement is never blocked by these failures — the channel is a
+     * convenience layer, not a fund-flow gate. Callers MAY surface this
+     * error in CLI output to help users diagnose channel/relay issues.
+     */
+    deliveryError?: DeliveryError;
 }
 /**
  * Execute a Level 1 negotiated request end-to-end.

package/dist/cli/lib/runRequest.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"runRequest.d.ts","sourceRoot":"","sources":["../../../src/cli/lib/runRequest.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AAKH,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAGjE,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,SAAS,GAAG,SAAS,CAAC;AAE5D,MAAM,WAAW,iBAAiB;IAChC,4DAA4D;IAC5D,QAAQ,EAAE,MAAM,CAAC;IACjB,oDAAoD;IACpD,MAAM,EAAE,MAAM,CAAC;IACf,oEAAoE;IACpE,OAAO,EAAE,MAAM,CAAC;IAChB,sEAAsE;IACtE,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC3B,yCAAyC;IACzC,OAAO,CAAC,EAAE,cAAc,CAAC;IACzB,sEAAsE;IACtE,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,sEAAsE;IACtE,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B;;;;OAIG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,qFAAqF;IACrF,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,4DAA4D;IAC5D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,4CAA4C;IAC5C,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,gEAAgE;IAChE,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,gBAAgB,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,IAAI,KAAK,IAAI,CAAC;CAC1E;AAED,qBAAa,iBAAkB,SAAQ,KAAK;aACd,IAAI,EAAE,MAAM;aAAkB,SAAS,EAAE,MAAM;gBAA/C,IAAI,EAAE,MAAM,EAAkB,SAAS,EAAE,MAAM;CAQ5E;AAED,qBAAa,oBAAqB,SAAQ,KAAK;aAE3B,IAAI,EAAE,MAAM;aACZ,SAAS,EAAE,MAAM;aACjB,SAAS,EAAE,gBAAgB;gBAF3B,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,gBAAgB;CAQ9C;AAED,MAAM,WAAW,gBAAgB;IAC/B,6CAA6C;IAC7C,IAAI,EAAE,MAAM,CAAC;IACb,uDAAuD;IACvD,UAAU,EAAE,gBAAgB,CAAC;IAC7B,iEAAiE;IACjE,SAAS,EAAE,MAAM,CAAC;IAClB,gDAAgD;IAChD,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,iEAAiE;IACjE,OAAO,EAAE,OAAO,CAAC;IACjB;;;;;;;;;;OAUG;IACH,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AAKD;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,UAAU,CAAC,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CA+OnF"}
+{"version":3,"file":"runRequest.d.ts","sourceRoot":"","sources":["../../../src/cli/lib/runRequest.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AAKH,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAEjE,OAAO,EAKL,KAAK,eAAe,EACpB,KAAK,aAAa,EAElB,KAAK,eAAe,EAErB,MAAM,gBAAgB,CAAC;AAExB,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,SAAS,GAAG,SAAS,CAAC;AA0B5D,MAAM,WAAW,iBAAiB;IAChC,4DAA4D;IAC5D,QAAQ,EAAE,MAAM,CAAC;IACjB,oDAAoD;IACpD,MAAM,EAAE,MAAM,CAAC;IACf,oEAAoE;IACpE,OAAO,EAAE,MAAM,CAAC;IAChB,sEAAsE;IACtE,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC3B,yCAAyC;IACzC,OAAO,CAAC,EAAE,cAAc,CAAC;IACzB,sEAAsE;IACtE,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,sEAAsE;IACtE,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B;;;;OAIG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,qFAAqF;IACrF,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,4DAA4D;IAC5D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,4CAA4C;IAC5C,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,gEAAgE;IAChE,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,gBAAgB,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,IAAI,KAAK,IAAI,CAAC;IAMzE;;;;;;;;;;;;;;;OAeG;IACH,eAAe,CAAC,EAAE,eAAe,CAAC;IAElC;;;;;;OAMG;IACH,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAE/B;;;;;;OAMG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IAEzB;;;;;;;;;OASG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB;;;;;;;;;;;OAWG;IACH,eAAe,CAAC,EAAE,eAAe,CAAC;IAElC;;;;;;;;;;;;;;;;OAgBG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,qBAAa,iBAAkB,SAAQ,KAAK;aACd,IAAI,EAAE,MAAM;aAAkB,SAAS,EAAE,MAAM;gBAA/C,IAAI,EAAE,MAAM,EAAkB,SAAS,EAAE,MAAM;CAQ5E;AAED,qBAAa,oBAAqB,SAAQ,KAAK;aAE3B,IAAI,EAAE,MAAM;aACZ,SAAS,EAAE,MAAM;aACjB,SAAS,EAAE,gBAAgB;gBAF3B,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,gBAAgB;CAQ9C;AAED,MAAM,WAAW,gBAAgB;IAC/B,6CAA6C;IAC7C,IAAI,EAAE,MAAM,CAAC;IACb,uDAAuD;IACvD,UAAU,EAAE,gBAAgB,CAAC;IAC7B,iEAAiE;IACjE,SAAS,EAAE,MAAM,CAAC;IAClB,gDAAgD;IAChD,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,iEAAiE;IACjE,OAAO,EAAE,OAAO,CAAC;IACjB;;;;;;;;;;OAUG;IACH,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAE1B;;;;;;;;;;;;OAYG;IACH,aAAa,CAAC,EAAE,aAAa,CAAC;CAC/B;AAKD;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,UAAU,CAAC,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAmgBnF"}