@oobe-protocol-labs/sap-mcp-server 0.9.16 → 0.9.20

package/dist/premium/webhook-engine.js

@@ -0,0 +1,382 @@
+/**
+ * @name premium/webhook-engine
+ * @description Signed webhook delivery engine for premium event callbacks.
+ *
+ * After a session is activated, the webhook engine registers a buyer-owned
+ * HTTPS endpoint, subscribes to the provider for matching events, signs each
+ * delivery with HMAC-SHA256, and dispatches it via HTTP POST.
+ *
+ * The engine enforces:
+ *   - Event filtering: only delivers event ids listed in the subscription.
+ *   - URL validation: rejects localhost, private networks, and non-HTTPS URLs.
+ *   - Signing: HMAC-SHA256 over `{deliveryId, deliveredAt, payload}` using
+ *     the `SAP_MCP_PREMIUM_WEBHOOK_SIGNER` env var.
+ *   - Retry: up to 3 attempts with exponential backoff for non-2xx responses.
+ *   - Unit quota: decrements after each successful delivery.
+ *   - Idempotency: deduplicates via `eventId` in the event store.
+ *
+ * @flow
+ *   1. Buyer calls `POST /premium/webhook/register` with targetUrl + events.
+ *   2. → `registerWebhook()` validates URL, creates subscription.
+ *   3. Engine subscribes to provider, receives events matching the subscription.
+ *   4. For each matching event: sign, POST to targetUrl, record delivery.
+ *   5. Buyer can check delivery status via `getWebhookDeliveryStatus()`.
+ *
+ * @module premium/webhook-engine
+ */
+import { createHmac, randomUUID } from 'node:crypto';
+import { request } from 'node:https';
+import { request as httpRequest } from 'node:http';
+import { URL } from 'node:url';
+import { getPremiumSession, decrementSessionQuota, closeSession } from './session-manager.js';
+import { subscribeToProvider } from './provider-bridge.js';
+import { appendEvent } from './event-store.js';
+/**
+ * @description Registry of active webhook subscriptions keyed by subscription id.
+ */
+const webhookSubscriptions = new Map();
+/**
+ * @description Delivery attempt records keyed by delivery id.
+ */
+const deliveryRecords = new Map();
+/**
+ * @description Hard cap on stored delivery records.
+ *
+ * Default: 100_000 (tuned for a 312GB RAM production server).
+ * Each record is ~512B, so 100K records ≈ 50MB.
+ * Override via `SAP_MCP_PREMIUM_MAX_DELIVERIES` env var.
+ */
+const MAX_DELIVERY_RECORDS = (() => {
+    const raw = process.env.SAP_MCP_PREMIUM_MAX_DELIVERIES;
+    const parsed = Number(raw);
+    return Number.isFinite(parsed) && parsed > 0 ? Math.trunc(parsed) : 100_000;
+})();
+/**
+ * @description Maximum retry attempts per delivery.
+ */
+const MAX_RETRIES = 3;
+/**
+ * @description Base delay for exponential backoff in milliseconds.
+ */
+const RETRY_BASE_DELAY_MS = 500;
+/**
+ * @name validateWebhookUrl
+ * @description Validate that a webhook target URL is safe for delivery.
+ *
+ * Rejects:
+ *   - Non-HTTPS URLs in production (allow HTTP for localhost testing).
+ *   - localhost, 127.0.0.1, 0.0.0.0, private network ranges (10.x, 172.16-31.x, 192.168.x).
+ *
+ * @param targetUrl - The URL to validate.
+ * @returns True if the URL is safe for webhook delivery.
+ *
+ * @internal
+ */
+function validateWebhookUrl(targetUrl) {
+    let parsed;
+    try {
+        parsed = new URL(targetUrl);
+    }
+    catch {
+        return false;
+    }
+    // Must be HTTPS in production. Allow HTTP only for localhost testing.
+    const isLocalhost = parsed.hostname === 'localhost' || parsed.hostname === '127.0.0.1';
+    if (parsed.protocol !== 'https:' && !isLocalhost)
+        return false;
+    // Block private network ranges (SSRF prevention).
+    const host = parsed.hostname;
+    if (host.startsWith('10.') ||
+        host.startsWith('172.16.') || host.startsWith('172.17.') || host.startsWith('172.18.') ||
+        host.startsWith('172.19.') || host.startsWith('172.20.') || host.startsWith('172.21.') ||
+        host.startsWith('172.22.') || host.startsWith('172.23.') || host.startsWith('172.24.') ||
+        host.startsWith('172.25.') || host.startsWith('172.26.') || host.startsWith('172.27.') ||
+        host.startsWith('172.28.') || host.startsWith('172.29.') || host.startsWith('172.30.') ||
+        host.startsWith('172.31.') ||
+        host.startsWith('192.168.') ||
+        host === '0.0.0.0' ||
+        host === '::1' ||
+        host.startsWith('fe80:')) {
+        return false;
+    }
+    return true;
+}
+/**
+ * @name signDelivery
+ * @description Sign a webhook delivery payload with HMAC-SHA256.
+ *
+ * The signature is computed over the string `${deliveryId}.${deliveredAt}.${JSON.stringify(payload)}`
+ * using the `SAP_MCP_PREMIUM_WEBHOOK_SIGNER` env var as the key.
+ *
+ * @param deliveryId   - The unique delivery id.
+ * @param deliveredAt  - ISO timestamp of the delivery.
+ * @param payload      - The event payload to sign.
+ * @returns Hex-encoded HMAC-SHA256 signature.
+ *
+ * @internal
+ */
+function signDelivery(deliveryId, deliveredAt, payload) {
+    const key = process.env.SAP_MCP_PREMIUM_WEBHOOK_SIGNER;
+    if (!key) {
+        throw new Error('SAP_MCP_PREMIUM_WEBHOOK_SIGNER is not set — webhook delivery requires a configured signing key');
+    }
+    const message = `${deliveryId}.${deliveredAt}.${JSON.stringify(payload)}`;
+    return createHmac('sha256', key).update(message).digest('hex');
+}
+/**
+ * @name deliverWebhook
+ * @description Deliver a single event to a webhook target URL with retries.
+ *
+ * @param subscription - The webhook subscription.
+ * @param event        - The provider event to deliver.
+ * @returns The `PremiumWebhookDelivery` record for this attempt.
+ *
+ * @internal
+ */
+async function deliverWebhook(subscription, event) {
+    const deliveryId = `wh-delivery-${randomUUID()}`;
+    const deliveredAt = new Date().toISOString();
+    const signature = signDelivery(deliveryId, deliveredAt, event.payload);
+    const body = JSON.stringify({
+        deliveryId,
+        eventType: event.eventType,
+        deliveredAt,
+        signature,
+        payload: event.payload,
+    });
+    let httpStatus = null;
+    let success = false;
+    let responseBody;
+    let retryCount = 0;
+    const parsedUrl = new URL(subscription.targetUrl);
+    const isHttps = parsedUrl.protocol === 'https:';
+    const reqFn = isHttps ? request : httpRequest;
+    for (let attempt = 0; attempt <= MAX_RETRIES; attempt++) {
+        retryCount = attempt;
+        try {
+            const response = await new Promise((resolve, reject) => {
+                const req = reqFn({
+                    hostname: parsedUrl.hostname,
+                    port: parsedUrl.port || (isHttps ? 443 : 80),
+                    path: `${parsedUrl.pathname}${parsedUrl.search}`,
+                    method: 'POST',
+                    headers: {
+                        'Content-Type': 'application/json',
+                        'Content-Length': Buffer.byteLength(body),
+                        'X-SAP-Premium-Delivery-Id': deliveryId,
+                        'X-SAP-Premium-Signature': signature,
+                    },
+                    timeout: 10_000,
+                }, (res) => {
+                    let data = '';
+                    res.on('data', (chunk) => { data += chunk.toString(); });
+                    res.on('end', () => resolve({ status: res.statusCode ?? 0, body: data }));
+                });
+                req.on('error', reject);
+                req.on('timeout', () => { req.destroy(); reject(new Error('Webhook delivery timeout.')); });
+                req.write(body);
+                req.end();
+            });
+            httpStatus = response.status;
+            responseBody = response.body.slice(0, 512);
+            success = response.status >= 200 && response.status < 300;
+            if (success)
+                break;
+        }
+        catch (error) {
+            responseBody = error instanceof Error ? error.message : 'Unknown delivery error.';
+        }
+        if (attempt < MAX_RETRIES) {
+            await new Promise(resolve => setTimeout(resolve, RETRY_BASE_DELAY_MS * 2 ** attempt));
+        }
+    }
+    const delivery = {
+        deliveryId,
+        subscriptionId: subscription.subscriptionId,
+        eventId: event.eventId,
+        eventType: event.eventType,
+        deliveredAt,
+        signature,
+        httpStatus,
+        success,
+        responseBody,
+        retryCount,
+    };
+    // Store delivery record with cap.
+    deliveryRecords.set(deliveryId, delivery);
+    if (deliveryRecords.size > MAX_DELIVERY_RECORDS) {
+        const oldestKey = deliveryRecords.keys().next().value;
+        if (oldestKey)
+            deliveryRecords.delete(oldestKey);
+    }
+    // Update subscription stats.
+    subscription.deliveriesAttempted++;
+    if (success)
+        subscription.deliveriesSucceeded++;
+    subscription.lastDeliveryAt = deliveredAt;
+    subscription.lastDeliveryStatus = httpStatus;
+    return delivery;
+}
+/**
+ * @name registerWebhook
+ * @description Register a webhook subscription for an active premium session.
+ *
+ * @param sessionId       - The activated premium session id.
+ * @param targetUrl       - HTTPS endpoint owned by the buyer.
+ * @param events          - Exact event ids to deliver.
+ * @param signingPublicKey - Optional buyer public key for signature verification.
+ * @returns The `PremiumWebhookSubscription`, or `null` if the session is not
+ *   active or the URL is invalid.
+ *
+ * @usedBy `premium-tools.ts` → MCP tool `sap_premium_webhook_register`,
+ *   `remote/server.ts` → `POST /premium/webhook/register`
+ */
+export async function registerWebhook(sessionId, targetUrl, events, signingPublicKey) {
+    const session = getPremiumSession(sessionId);
+    if (!session || session.status !== 'active')
+        return null;
+    if (!validateWebhookUrl(targetUrl))
+        return null;
+    if (events.length === 0)
+        return null;
+    const subscription = {
+        subscriptionId: `wh-sub-${randomUUID()}`,
+        sessionId,
+        pluginId: session.pluginId,
+        capabilityId: session.capabilityId,
+        targetUrl,
+        events,
+        signingPublicKey,
+        createdAt: new Date().toISOString(),
+        deliveriesAttempted: 0,
+        deliveriesSucceeded: 0,
+        lastDeliveryAt: null,
+        lastDeliveryStatus: null,
+        active: true,
+    };
+    webhookSubscriptions.set(subscription.subscriptionId, subscription);
+    return subscription;
+}
+/**
+ * @name startWebhookDelivery
+ * @description Start the webhook delivery loop for a subscription.
+ *
+ * Subscribes to the provider, receives events, filters by the subscription's
+ * event list, signs and delivers each matching event, and decrements the
+ * session quota. Stops when the quota reaches zero or the subscription is
+ * deactivated.
+ *
+ * @param subscription - The webhook subscription to deliver for.
+ *
+ * @usedBy `remote/server.ts` → webhook delivery worker
+ */
+export async function startWebhookDelivery(subscription) {
+    const iterable = await subscribeToProvider(subscription.pluginId, subscription.capabilityId, {});
+    if (!iterable)
+        return;
+    for await (const event of iterable) {
+        if (!subscription.active)
+            break;
+        // Filter: only deliver events listed in the subscription.
+        if (!subscription.events.includes(event.eventType))
+            continue;
+        // Store the event for replay/idempotency.
+        appendEvent({
+            eventId: event.eventId,
+            sessionId: subscription.sessionId,
+            pluginId: subscription.pluginId,
+            capabilityId: subscription.capabilityId,
+            eventType: event.eventType,
+            observedAt: event.observedAt,
+            payload: event.payload,
+            deliveredAt: new Date().toISOString(),
+        });
+        // Deliver via HTTP POST with retries.
+        await deliverWebhook(subscription, event);
+        // Decrement quota and auto-close at zero.
+        const remaining = decrementSessionQuota(subscription.sessionId);
+        if (remaining <= 0) {
+            subscription.active = false;
+            closeSession(subscription.sessionId, 'Webhook unit quota exhausted.');
+            break;
+        }
+    }
+}
+/**
+ * @name unregisterWebhook
+ * @description Deactivate and remove a webhook subscription.
+ *
+ * @param subscriptionId - The webhook subscription id.
+ * @returns True if the subscription was found and removed.
+ *
+ * @usedBy `premium-tools.ts` → MCP tool `sap_premium_webhook_unregister`
+ */
+export function unregisterWebhook(subscriptionId) {
+    const subscription = webhookSubscriptions.get(subscriptionId);
+    if (!subscription)
+        return false;
+    subscription.active = false;
+    webhookSubscriptions.delete(subscriptionId);
+    return true;
+}
+/**
+ * @name getWebhookSubscription
+ * @description Retrieve a webhook subscription by id.
+ *
+ * @param subscriptionId - The webhook subscription id.
+ * @returns The subscription, or `null` if not found.
+ *
+ * @usedBy `premium-tools.ts` → MCP tool `sap_premium_webhook_status`
+ */
+export function getWebhookSubscription(subscriptionId) {
+    const sub = webhookSubscriptions.get(subscriptionId);
+    return sub ? { ...sub } : null;
+}
+/**
+ * @name getWebhookDeliveries
+ * @description Retrieve delivery records for a subscription.
+ *
+ * @param subscriptionId - The webhook subscription id.
+ * @param limit          - Maximum records to return (default 50).
+ * @returns Array of `PremiumWebhookDelivery` records.
+ *
+ * @usedBy `premium-tools.ts` → MCP tool `sap_premium_webhook_status`
+ */
+export function getWebhookDeliveries(subscriptionId, limit = 50) {
+    const results = [];
+    for (const delivery of deliveryRecords.values()) {
+        if (delivery.subscriptionId === subscriptionId) {
+            results.push(delivery);
+            if (results.length >= limit)
+                break;
+        }
+    }
+    return results;
+}
+/**
+ * @name getActiveWebhookCount
+ * @description Return the number of currently active webhook subscriptions.
+ *
+ * @usedBy `metrics.ts`
+ */
+export function getActiveWebhookCount() {
+    let count = 0;
+    for (const sub of webhookSubscriptions.values()) {
+        if (sub.active)
+            count++;
+    }
+    return count;
+}
+/**
+ * @name stopAllWebhooks
+ * @description Deactivate all webhook subscriptions. Called during graceful shutdown.
+ *
+ * @usedBy `remote/server.ts` shutdown handler
+ */
+export function stopAllWebhooks() {
+    for (const sub of webhookSubscriptions.values()) {
+        sub.active = false;
+    }
+    webhookSubscriptions.clear();
+}
+//# sourceMappingURL=webhook-engine.js.map

package/dist/premium/webhook-engine.js.map

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

package/dist/prompts/context/sap-agent-context.prompt.d.ts

@@ -1,3 +1,8 @@
+/**
+ * @name prompts/context/sap-agent-context
+ * @description Prompt providing complete SAP MCP agent context, configuration, and capabilities
+ * @module prompts/context/sap-agent-context
+ */
 /**
  * SAP MCP Agent Context Prompt
  *

package/dist/prompts/context/sap-agent-context.prompt.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sap-agent-context.prompt.d.ts","sourceRoot":"","sources":["../../../src/prompts/context/sap-agent-context.prompt.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AAGnE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAwBzD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgDG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,aAAa,GAAG,IAAI,CAoGnF"}
+{"version":3,"file":"sap-agent-context.prompt.d.ts","sourceRoot":"","sources":["../../../src/prompts/context/sap-agent-context.prompt.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AAGnE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAwBzD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgDG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,aAAa,GAAG,IAAI,CAoGnF"}

package/dist/prompts/context/sap-agent-context.prompt.js

@@ -1,12 +1,6 @@
 /**
- * SAP MCP Agent Context Prompt
- *
- * Provides complete context about the current SAP MCP configuration,
- * active profile, wallet, and available capabilities.
- *
- * Agents should call this prompt before executing any SAP-related operations
- * to understand their operating context and constraints.
- *
+ * @name prompts/context/sap-agent-context
+ * @description Prompt providing complete SAP MCP agent context, configuration, and capabilities
  * @module prompts/context/sap-agent-context
  */
 import { registerPrompt } from '../../adapters/mcp/sdk-compat.js';

package/dist/prompts/context/sap-agent-context.prompt.js.map

@@ -1 +1 @@
-{"version":3,"file":"sap-agent-context.prompt.js","sourceRoot":"","sources":["../../../src/prompts/context/sap-agent-context.prompt.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,EAAE,cAAc,EAAE,MAAM,kCAAkC,CAAC;AAClE,OAAO,EAAE,MAAM,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAErE,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,YAAY,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAC1I,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAE9D,MAAM,cAAc,GAAG,qCAAqC,CAAC;AAC7D,MAAM,qBAAqB,GAAG,iEAAiE,CAAC;AAChG,MAAM,yBAAyB,GAAG,mDAAmD,CAAC;AACtF,MAAM,kBAAkB,GAAG,sFAAsF,CAAC;AAiBlH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgDG;AACH,MAAM,UAAU,qBAAqB,CAAC,MAAc,EAAE,QAAuB;IAC3E,cAAc,CACZ,MAAM,EACN,mBAAmB,EACnB,EAAE,EACF;QACM,WAAW,EAAE,uKAAuK;QACxL,SAAS,EAAE;YACT;gBACE,IAAI,EAAE,eAAe;gBACrB,WAAW,EAAE,iGAAiG;gBAC9G,QAAQ,EAAE,KAAK;aAChB;YACD;gBACE,IAAI,EAAE,iBAAiB;gBACvB,WAAW,EAAE,wDAAwD;gBACrE,QAAQ,EAAE,KAAK;aAChB;SACF;KACF,EACD,KAAK,EAAE,IAAgB,EAAE,EAAE;QACzB,IAAI,CAAC;YACH,MAAM,UAAU,GAAI,IAAyB,IAAI,EAAE,CAAC;YACpD,MAAM,aAAa,GAAG,UAAU,CAAC,aAAa,KAAK,MAAM,CAAC;YAC1D,MAAM,eAAe,GAAG,UAAU,CAAC,eAAe,KAAK,OAAO,CAAC;YAE/D,MAAM,aAAa,GAAG,gBAAgB,EAAE,CAAC;YACzC,MAAM,MAAM,GAAG,iBAAiB,CAAC,aAAa,CAAC,CAAC;YAChD,MAAM,WAAW,GAAG,qBAAqB,EAAE,CAAC;YAC5C,MAAM,SAAS,GAAG,qBAAqB,EAAE,CAAC;YAC1C,MAAM,WAAW,GAAG,eAAe,CAAC,CAAC,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAE1D,+BAA+B;YAC/B,IAAI,CAAC,MAAM,EAAE,CAAC;gBACZ,MAAM,CAAC,IAAI,CAAC,8CAA8C,EAAE,EAAE,OAAO,EAAE,aAAa,EAAE,CAAC,CAAC;gBAExF,OAAO;oBACL,WAAW,EAAE,iCAAiC;oBAC9C,QAAQ,EAAE;wBACR;4BACE,IAAI,EAAE,MAAe;4BACrB,OAAO,EAAE;gCACP,IAAI,EAAE,MAAe;gCACrB,IAAI,EAAE,yBAAyB,CAAC,aAAa,EAAE,SAAS,CAAC;6BAC1D;yBACF;qBACF;iBACF,CAAC;YACJ,CAAC;YAED,sCAAsC;YACtC,MAAM,WAAW,GAAG,mBAAmB,CAAC;gBACtC,aAAa;gBACb,MAAM,EAAE,MAAoC;gBAC5C,WAAW;gBACX,SAAS;gBACT,aAAa;gBACb,eAAe;gBACf,WAAW;aACZ,CAAC,CAAC;YAEH,MAAM,CAAC,KAAK,CAAC,gCAAgC,EAAE;gBAC7C,OAAO,EAAE,aAAa;gBACtB,aAAa;gBACb,eAAe;gBACf,YAAY,EAAE,WAAW,CAAC,MAAM;aACjC,CAAC,CAAC;YAEH,OAAO;gBACL,WAAW,EAAE,gCAAgC;gBAC7C,QAAQ,EAAE;oBACR;wBACE,IAAI,EAAE,MAAe;wBACrB,OAAO,EAAE;4BACP,IAAI,EAAE,MAAe;4BACrB,IAAI,EAAE,WAAW;yBAClB;qBACF;iBACF;aACF,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,KAAK,CAAC,yCAAyC,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;YAEnE,OAAO;gBACL,WAAW,EAAE,gCAAgC;gBAC7C,QAAQ,EAAE;oBACR;wBACE,IAAI,EAAE,MAAe;wBACrB,OAAO,EAAE;4BACP,IAAI,EAAE,MAAe;4BACrB,IAAI,EAAE,iBAAiB,CAAC,KAAK,CAAC;yBAC/B;qBACF;iBACF;aACF,CAAC;QACJ,CAAC;IACH,CAAC,CACF,CAAC;IAEF,MAAM,CAAC,KAAK,CAAC,iCAAiC,CAAC,CAAC;AAClD,CAAC;AAED;;GAEG;AACH,SAAS,mBAAmB,CAAC,OAQ5B;IACC,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,aAAa,EAAE,eAAe,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC;IAEvF,IAAI,WAAW,GAAG;;;gBAGJ,aAAa;uBACN,oBAAoB,CAAC,aAAa,CAAC;wBAClC,MAAM,CAAC,WAAW,IAAI,gBAAgB;;;;;;;;gBAQ9C,MAAM,CAAC,IAAI;mBACR,qBAAqB,CAAC,MAAM,CAAC,MAAM,CAAC;sBACjC,MAAM,CAAC,UAAU;sBACjB,MAAM,CAAC,SAAS;;CAErC,CAAC;IAEA,IAAI,aAAa,EAAE,CAAC;QAClB,WAAW,IAAI;4BACS,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI;cAC9C,MAAM,CAAC,IAAI,KAAK,mBAAmB,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI;;;;CAI/E,CAAC;IACA,CAAC;IAED,WAAW,IAAI;sBACK,MAAM,CAAC,aAAa;qBACrB,MAAM,CAAC,aAAa;iCACR,MAAM,CAAC,uBAAuB;qBAC1C,MAAM,CAAC,MAAM,EAAE,IAAI,IAAI,YAAY;;;+BAGzB,OAAO,CAAC,SAAS;0DACU,qBAAqB,WAAW,yBAAyB;sBAC7F,cAAc;sBACd,kBAAkB;;;;0BAId,cAAc;;;;;;;;;;;;;;;;;;;;;kBAqBtB,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,iBAAiB,MAAM,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,KAAK,YAAY,CAAC,CAAC,CAAC,kBAAkB,cAAc,GAAG,CAAC,CAAC,CAAC,UAAU;iBAC1I,MAAM,CAAC,aAAa,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,UAAU;qBACzC,MAAM,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,UAAU;iBAClD,MAAM,CAAC,QAAQ,KAAK,MAAM,CAAC,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA2DpD,CAAC;IAEA,IAAI,eAAe,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC9C,WAAW,IAAI;;;CAGlB,CAAC;QACE,KAAK,MAAM,OAAO,IAAI,WAAW,EAAE,CAAC;YAClC,MAAM,YAAY,GAAG,OAAO,CAAC,IAAI,KAAK,aAAa,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC;YAChE,WAAW,IAAI,KAAK,YAAY,IAAI,OAAO,CAAC,IAAI,MAAM,OAAO,CAAC,IAAI,KAAK,aAAa,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,MAAM,OAAO,CAAC,IAAI,IAAI,SAAS,MAAM,OAAO,CAAC,WAAW,IAAI,KAAK;CACzK,CAAC;QACE,CAAC;QAED,WAAW,IAAI;;;;;;;;;;;;;;;;CAgBlB,CAAC;IACA,CAAC;IAED,WAAW,IAAI;;;;;;;;;;;;yBAYQ,cAAc;;;;;CAKtC,CAAC;IAEA,OAAO,WAAW,CAAC;AACrB,CAAC;AAED;;GAEG;AACH,SAAS,yBAAyB,CAAC,aAAqB,EAAE,SAAiB;IACzE,OAAO;;iCAEwB,aAAa;;;;EAI5C,kBAAkB;;;;gBAIJ,qBAAqB;oBACjB,yBAAyB;oBACzB,cAAc;;;;;;;;;;;uBAWX,aAAa;wBACZ,SAAS;CAChC,CAAC;AACF,CAAC;AAED;;GAEG;AACH,SAAS,iBAAiB,CAAC,KAAc;IACvC,MAAM,YAAY,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,CAAC;IAE9E,OAAO;;EAEP,YAAY;;;;;gCAKkB,kBAAkB;oDACE,qBAAqB,WAAW,yBAAyB;CAC5G,CAAC;AACF,CAAC"}
+{"version":3,"file":"sap-agent-context.prompt.js","sourceRoot":"","sources":["../../../src/prompts/context/sap-agent-context.prompt.ts"],"names":[],"mappings":"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"}

package/dist/prompts/context/sap-agent-intent-router.prompt.d.ts

@@ -0,0 +1,14 @@
+/**
+ * SAP MCP Agent Intent Router Prompt
+ *
+ * Gives agent runtimes a compact decision tree for choosing hosted reads,
+ * paid hosted calls, local user signing, unsigned builders, or repair flows.
+ */
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import type { SapMcpContext } from '../../core/types.js';
+/**
+ * @name sapAgentIntentRouterPrompt
+ * @description Registers the compact SAP MCP intent routing prompt.
+ */
+export declare function sapAgentIntentRouterPrompt(server: Server, context: SapMcpContext): void;
+//# sourceMappingURL=sap-agent-intent-router.prompt.d.ts.map

package/dist/prompts/context/sap-agent-intent-router.prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sap-agent-intent-router.prompt.d.ts","sourceRoot":"","sources":["../../../src/prompts/context/sap-agent-intent-router.prompt.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AAGnE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAUzD;;;GAGG;AACH,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,GAAG,IAAI,CAqDvF"}

package/dist/prompts/context/sap-agent-intent-router.prompt.js

@@ -0,0 +1,155 @@
+/**
+ * SAP MCP Agent Intent Router Prompt
+ *
+ * Gives agent runtimes a compact decision tree for choosing hosted reads,
+ * paid hosted calls, local user signing, unsigned builders, or repair flows.
+ */
+import { registerPrompt } from '../../adapters/mcp/sdk-compat.js';
+import { logger } from '../../core/logger.js';
+/**
+ * @name sapAgentIntentRouterPrompt
+ * @description Registers the compact SAP MCP intent routing prompt.
+ */
+export function sapAgentIntentRouterPrompt(server, context) {
+    registerPrompt(server, 'sap-agent-intent-router', {}, {
+        description: 'Route a user SAP MCP request to the correct hosted/read, paid-call, local-signing, unsigned-builder, or repair flow. Use before paid/write operations and after routing errors.',
+        arguments: [
+            {
+                name: 'userIntent',
+                description: 'Plain-language user goal, e.g. "check balance", "register my agent", "update metadata image", "swap SOL to USDC", "create escrow", or "is SAP connected?".',
+                required: false,
+            },
+            {
+                name: 'targetTool',
+                description: 'Optional exact MCP tool name being considered. Use exact names from tools/list; do not rewrite hyphenated names.',
+                required: false,
+            },
+            {
+                name: 'lastError',
+                description: 'Optional last error string or JSON-RPC error data. The router maps common SAP/x402/MCP errors to the next safe tool.',
+                required: false,
+            },
+        ],
+    }, async (args) => {
+        const parsed = parseIntentRouterArgs(args);
+        logger.debug('SAP agent intent router prompt generated', {
+            mode: context.config.mode,
+            userIntent: parsed.userIntent,
+            targetTool: parsed.targetTool,
+        });
+        return {
+            description: 'SAP MCP intent routing instructions',
+            messages: [
+                {
+                    role: 'user',
+                    content: {
+                        type: 'text',
+                        text: buildIntentRouterPrompt(context, parsed),
+                    },
+                },
+            ],
+        };
+    });
+    logger.debug('SAP agent intent router prompt registered');
+}
+function parseIntentRouterArgs(args) {
+    const record = (args ?? {});
+    return {
+        userIntent: typeof record.userIntent === 'string' ? record.userIntent : undefined,
+        targetTool: typeof record.targetTool === 'string' ? record.targetTool : undefined,
+        lastError: typeof record.lastError === 'string' ? record.lastError : undefined,
+    };
+}
+function buildIntentRouterPrompt(context, args) {
+    return `# SAP MCP Intent Router
+
+Use this router to choose the next SAP MCP action with the least friction and no unsafe shortcuts.
+
+## Current Request
+- User intent: ${args.userIntent ? `\`${args.userIntent}\`` : 'not supplied'}
+- Target tool: ${args.targetTool ? `\`${args.targetTool}\`` : 'not supplied'}
+- Last error: ${args.lastError ? `\`${args.lastError}\`` : 'none'}
+- Server mode visible to this prompt: \`${context.config.mode}\`
+
+## Decision Tree
+
+### 1. Connection/status only
+If the user asks "are you connected?", "is SAP ready?", or similar:
+1. Call \`sap_agent_start\`.
+2. Call \`sap_agent_runtime_status\` with \`{"intent":"connection"}\`.
+3. Answer briefly: endpoint, mode, hosted non-custodial status, local \`sap_payments\` readiness only if checked, and one next action.
+Do not dump the full tool catalog.
+
+### 2. Exact/base reads
+For exact agent, wallet, balance, global-state, or compact directory orientation:
+- Prefer free exact/base tools first:
+  \`sap_agent_context\`, \`sap_get_agent\`, \`sap_get_agent_profile\`,
+  \`sap_get_agent_stats\`, \`sap_get_global_state\`, \`sap_is_agent_active\`,
+  \`sap_list_agents\` with \`limit <= 20\` and \`view: "compact"\`,
+  \`sol_get_balance\`, \`spl-token_getBalance\`, \`spl-token_getTokenAccounts\`,
+  or \`magicblock_balance\`.
+- Use broad/enriched paid discovery only when the user asked for search, ranking,
+  enrichment, analytics, or larger pages.
+
+### 3. Paid hosted tools
+Before a paid hosted read/builder/value tool:
+1. Call \`sap_estimate_tool_cost\` for the target tool.
+2. Verify the local payer has SOL for fees and USDC for x402 when balance tools are available.
+3. Use \`sap_payments_call_paid_tool\` when the runtime cannot replay x402 natively.
+4. Treat x402/pay.sh 402 responses as a payment challenge, not as a failure.
+5. If the challenge price exceeds \`maxPriceUsd\`, stop and ask the user before increasing the cap.
+
+### 4. Registry writes
+For SAP agent registration or update:
+- Do not use hosted \`sap_register_agent\` or hosted \`sap_update_agent\` when they return \`hosted_local_signer_required\`.
+- Use local \`sap_payments_register_agent\` for registration and local \`sap_payments_update_agent\` for profile/metadata updates.
+- Use \`confirm: true\` only after the user approves the preview.
+- Report the agent PDA, owner, transaction signature, and protocol-fee verification status.
+- Do not call the lifecycle complete if the agent account or protocol-fee audit is missing.
+- If a profile update returns Anchor 3012, \`AccountNotInitialized\`, or
+  \`pricing_menu\`, do not repair the runtime and do not retry the same write.
+  Use \`sap_agent_next_action\` and \`sap_protocol_invariants\`; the failure is
+  an SAP registry account lifecycle issue.
+
+### 5. Unsigned builders and transaction finalization
+If a hosted tool returns \`transactionBase64\`, \`transaction\`, or an unsigned transaction object:
+1. Call \`sap_payments_finalize_transaction\`.
+2. Preview first.
+3. Sign locally through the SAP profile or external signer.
+4. Submit only when the user approved \`submit: true\`.
+5. Prefer the hosted submit relay for already-signed bytes unless the user chose local RPC.
+Never create temporary signing scripts, never read keypair JSON, and never export secret bytes.
+
+### 6. Escrow V2
+- Use V2 only.
+- Default \`settlementSecurity\` is \`DisputeWindow (2)\`; never default to \`SelfReport (0)\`.
+- Amounts are smallest units: lamports for SOL, micro-USDC for USDC.
+- Hosted mode should use \`sap_escrow_build_*_transaction\` then
+  \`sap_payments_finalize_transaction\`.
+
+### 7. Repair and missing bridge
+If \`sap_payments\` is missing, startup closes before initialization, or the runtime
+does not expose local tools after config repair:
+- Say the hosted SAP MCP is connected but the local payment/signing bridge is not visible in this runtime.
+- Ask the user to run \`npm exec --yes --package @oobe-protocol-labs/sap-mcp-server -- sap-mcp-config repair\`.
+- Ask them to fully restart the agent runtime.
+- Do not claim the hosted server can see local wallet paths.
+
+### 8. Error routing
+- \`hosted_local_signer_required\`: no x402 fee should be charged; switch to local \`sap_payments_*\` or unsigned builder finalization.
+- \`payment_required\` or HTTP 402: normal x402 challenge; use local paid-call bridge.
+- \`BlockhashNotFound\`, \`node is behind\`, \`minimum context slot\`, \`fetch failed\`, \`transaction_simulation_failed\`: retry with a fresh challenge or fresh transaction; do not reuse stale signed payment payloads.
+- \`mcp_session_required\`: call \`initialize\` first and reuse the returned \`mcp-session-id\`; do not invent client UUIDs.
+- \`session_not_found\`: reinitialize the MCP session and retry once.
+- Schema mismatch: call \`tools/list\` or inspect the exact input schema; do not guess aliases.
+
+## Final Answer Style
+Be concise and action-oriented:
+- what was checked
+- which profile/wallet was used, redacted when needed
+- what was paid, if anything
+- what was signed/submitted, if anything
+- one safe next action
+`;
+}
+//# sourceMappingURL=sap-agent-intent-router.prompt.js.map

package/dist/prompts/context/sap-agent-intent-router.prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sap-agent-intent-router.prompt.js","sourceRoot":"","sources":["../../../src/prompts/context/sap-agent-intent-router.prompt.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,cAAc,EAAE,MAAM,kCAAkC,CAAC;AAClE,OAAO,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAW9C;;;GAGG;AACH,MAAM,UAAU,0BAA0B,CAAC,MAAc,EAAE,OAAsB;IAC/E,cAAc,CACZ,MAAM,EACN,yBAAyB,EACzB,EAAE,EACF;QACE,WAAW,EACT,iLAAiL;QACnL,SAAS,EAAE;YACT;gBACE,IAAI,EAAE,YAAY;gBAClB,WAAW,EACT,4JAA4J;gBAC9J,QAAQ,EAAE,KAAK;aAChB;YACD;gBACE,IAAI,EAAE,YAAY;gBAClB,WAAW,EACT,kHAAkH;gBACpH,QAAQ,EAAE,KAAK;aAChB;YACD;gBACE,IAAI,EAAE,WAAW;gBACjB,WAAW,EACT,sHAAsH;gBACxH,QAAQ,EAAE,KAAK;aAChB;SACF;KACF,EACD,KAAK,EAAE,IAAgB,EAAE,EAAE;QACzB,MAAM,MAAM,GAAG,qBAAqB,CAAC,IAAI,CAAC,CAAC;QAC3C,MAAM,CAAC,KAAK,CAAC,0CAA0C,EAAE;YACvD,IAAI,EAAE,OAAO,CAAC,MAAM,CAAC,IAAI;YACzB,UAAU,EAAE,MAAM,CAAC,UAAU;YAC7B,UAAU,EAAE,MAAM,CAAC,UAAU;SAC9B,CAAC,CAAC;QAEH,OAAO;YACL,WAAW,EAAE,qCAAqC;YAClD,QAAQ,EAAE;gBACR;oBACE,IAAI,EAAE,MAAe;oBACrB,OAAO,EAAE;wBACP,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,uBAAuB,CAAC,OAAO,EAAE,MAAM,CAAC;qBAC/C;iBACF;aACF;SACF,CAAC;IACJ,CAAC,CACF,CAAC;IAEF,MAAM,CAAC,KAAK,CAAC,2CAA2C,CAAC,CAAC;AAC5D,CAAC;AAED,SAAS,qBAAqB,CAAC,IAAgB;IAC7C,MAAM,MAAM,GAAG,CAAC,IAAI,IAAI,EAAE,CAA4B,CAAC;IACvD,OAAO;QACL,UAAU,EAAE,OAAO,MAAM,CAAC,UAAU,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS;QACjF,UAAU,EAAE,OAAO,MAAM,CAAC,UAAU,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS;QACjF,SAAS,EAAE,OAAO,MAAM,CAAC,SAAS,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS;KAC/E,CAAC;AACJ,CAAC;AAED,SAAS,uBAAuB,CAAC,OAAsB,EAAE,IAAsB;IAC7E,OAAO;;;;;iBAKQ,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,UAAU,IAAI,CAAC,CAAC,CAAC,cAAc;iBAC3D,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,UAAU,IAAI,CAAC,CAAC,CAAC,cAAc;gBAC5D,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,SAAS,IAAI,CAAC,CAAC,CAAC,MAAM;0CACvB,OAAO,CAAC,MAAM,CAAC,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAiF5D,CAAC;AACF,CAAC"}

package/dist/prompts/context/sap-agent-start.prompt.js

@@ -81,6 +81,7 @@ Do not infer that tools are callable from startup logs alone. A tool is callable
 - If a hosted paid/write tool returns \`transactionBase64\`, \`transaction\`, or an unsigned transaction object, finalize it through local \`sap_payments_finalize_transaction\`.
 - If hosted \`sap_register_agent\` returns \`hosted_local_signer_required\`, no x402 payment was charged. Do not retry hosted \`sap_register_agent\`; call local \`sap_payments_register_agent\` with the same registration fields and \`confirm: true\`.
 - If hosted \`sap_update_agent\` returns \`hosted_local_signer_required\`, no x402 payment was charged. Do not retry hosted \`sap_update_agent\`; call local \`sap_payments_update_agent\` with the intended replacement fields and \`confirm: true\`.
+- If \`sap_payments_update_agent\` returns Anchor 3012, \`AccountNotInitialized\`, or \`pricing_menu\`, do not run repair and do not retry the same write. The local bridge worked; this is an SAP registry account lifecycle issue. Call \`sap_agent_next_action\` and \`sap_protocol_invariants\` before deciding the next safe initializer or upgrade path.
 - For Escrow V2 hosted flows, use \`sap_escrow_build_create_transaction\`, \`sap_escrow_build_deposit_transaction\`, \`sap_escrow_build_settle_transaction\`, \`sap_escrow_build_finalize_transaction\`, \`sap_escrow_build_withdraw_transaction\`, or \`sap_escrow_build_close_transaction\`, then finalize locally with \`sap_payments_finalize_transaction\`.
 - If another hosted write returns \`hosted_local_signer_required\`, no x402 payment was charged. Switch to the local SAP MCP profile or a hosted unsigned builder plus \`sap_payments_finalize_transaction\` when one exists.
 - Never create temporary signing scripts, read keypair JSON, export keypair bytes, or call hosted \`sap_sign_transaction\` for user-owned signing.

package/dist/prompts/context/sap-agent-start.prompt.js.map

@@ -1 +1 @@
-{"version":3,"file":"sap-agent-start.prompt.js","sourceRoot":"","sources":["../../../src/prompts/context/sap-agent-start.prompt.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,cAAc,EAAE,MAAM,kCAAkC,CAAC;AAClE,OAAO,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAG9C,MAAM,cAAc,GAAG,qCAAqC,CAAC;AAC7D,MAAM,cAAc,GAAG,sFAAsF,CAAC;AAQ9G;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CAAC,MAAc,EAAE,OAAsB;IACxE,cAAc,CACZ,MAAM,EACN,iBAAiB,EACjB,EAAE,EACF;QACE,WAAW,EAAE,uIAAuI;QACpJ,SAAS,EAAE;YACT;gBACE,IAAI,EAAE,MAAM;gBACZ,WAAW,EAAE,+GAA+G;gBAC5H,QAAQ,EAAE,KAAK;aAChB;SACF;KACF,EACD,KAAK,EAAE,IAAgB,EAAE,EAAE;QACzB,MAAM,IAAI,GAAG,OAAQ,IAAmC,EAAE,IAAI,KAAK,QAAQ;YACzE,CAAC,CAAG,IAAuB,CAAC,IAAe;YAC3C,CAAC,CAAC,SAAS,CAAC;QAEd,MAAM,CAAC,KAAK,CAAC,kCAAkC,EAAE,EAAE,IAAI,EAAE,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;QAEtF,OAAO;YACL,WAAW,EAAE,8BAA8B;YAC3C,QAAQ,EAAE;gBACR;oBACE,IAAI,EAAE,MAAe;oBACrB,OAAO,EAAE;wBACP,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,gBAAgB,CAAC,OAAO,EAAE,IAAI,CAAC;qBACtC;iBACF;aACF;SACF,CAAC;IACJ,CAAC,CACF,CAAC;IAEF,MAAM,CAAC,KAAK,CAAC,mCAAmC,CAAC,CAAC;AACpD,CAAC;AAED,SAAS,gBAAgB,CAAC,OAAsB,EAAE,IAAwB;IACxE,OAAO;;;;;EAKP,IAAI,CAAC,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,CAAC,6FAA6F;;;4BAGxF,cAAc;kDACQ,OAAO,CAAC,MAAM,CAAC,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;sBAuC/C,cAAc;;;;;;CAMnC,CAAC;AACF,CAAC"}
+{"version":3,"file":"sap-agent-start.prompt.js","sourceRoot":"","sources":["../../../src/prompts/context/sap-agent-start.prompt.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,cAAc,EAAE,MAAM,kCAAkC,CAAC;AAClE,OAAO,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAG9C,MAAM,cAAc,GAAG,qCAAqC,CAAC;AAC7D,MAAM,cAAc,GAAG,sFAAsF,CAAC;AAQ9G;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CAAC,MAAc,EAAE,OAAsB;IACxE,cAAc,CACZ,MAAM,EACN,iBAAiB,EACjB,EAAE,EACF;QACE,WAAW,EAAE,uIAAuI;QACpJ,SAAS,EAAE;YACT;gBACE,IAAI,EAAE,MAAM;gBACZ,WAAW,EAAE,+GAA+G;gBAC5H,QAAQ,EAAE,KAAK;aAChB;SACF;KACF,EACD,KAAK,EAAE,IAAgB,EAAE,EAAE;QACzB,MAAM,IAAI,GAAG,OAAQ,IAAmC,EAAE,IAAI,KAAK,QAAQ;YACzE,CAAC,CAAG,IAAuB,CAAC,IAAe;YAC3C,CAAC,CAAC,SAAS,CAAC;QAEd,MAAM,CAAC,KAAK,CAAC,kCAAkC,EAAE,EAAE,IAAI,EAAE,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;QAEtF,OAAO;YACL,WAAW,EAAE,8BAA8B;YAC3C,QAAQ,EAAE;gBACR;oBACE,IAAI,EAAE,MAAe;oBACrB,OAAO,EAAE;wBACP,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,gBAAgB,CAAC,OAAO,EAAE,IAAI,CAAC;qBACtC;iBACF;aACF;SACF,CAAC;IACJ,CAAC,CACF,CAAC;IAEF,MAAM,CAAC,KAAK,CAAC,mCAAmC,CAAC,CAAC;AACpD,CAAC;AAED,SAAS,gBAAgB,CAAC,OAAsB,EAAE,IAAwB;IACxE,OAAO;;;;;EAKP,IAAI,CAAC,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,CAAC,6FAA6F;;;4BAGxF,cAAc;kDACQ,OAAO,CAAC,MAAM,CAAC,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;sBAwC/C,cAAc;;;;;;CAMnC,CAAC;AACF,CAAC"}