aimeat 1.40.1 → 2.1.0

package/dist/src/routes/exchange.js

@@ -0,0 +1,395 @@
+/**
+ * @file src/routes/exchange.ts
+ * @description EXCHANGE contract-acceptance surface (TARGET-045) — the WRITE side of the G1 metered
+ *   entitlement. When a negotiation concludes (a human in an MCP chat, or a closed negotiation agent),
+ *   the CONSUMER's owner accepts the contract here, which mints the durable entitlement the G2 gateway
+ *   then honours on every call. Safety by construction: the consumer chooses only the BUDGET (their own
+ *   spend cap) and the contract ref — the per-call PRICE is read authoritatively from the provider's
+ *   extension action (`commercial.payMorsels`), so a consumer can neither undercut the provider nor be
+ *   charged a price they did not accept. The entitlement's consumer is always the caller's own owner
+ *   (strictly cross-owner via resolveIdentity), so accepting a contract authorises only one's own spend.
+ *
+ *   Slice-1 covers the `morsels` unit (fully in-repo); the money unit rides the same acceptance flow once
+ *   the Stripe/EE drawdown is wired. Dynamic agent-negotiated pricing (a signed price quote that differs
+ *   from the list price) is a later addition — slice-1 accepts the provider's listed price + a budget.
+ * @structure exchangeRouter — POST /v1/exchange/entitlements · GET /v1/exchange/entitlements ·
+ *   POST /v1/exchange/entitlements/off
+ * @usage
+ *   import { exchangeRouter } from './routes/exchange.js';
+ *   app.use(exchangeRouter(config, storage));
+ * @version-history
+ *   v1.3.0 — 2026-07-21 — Agent work (Gap 2): POST /work (start) + /work/:id/deliver (settle on delivery) +
+ *     GET /work — the async third sellable surface, metered per delivered task via the shared settlement.
+ *   v1.2.0 — 2026-07-21 — Renegotiation + history: POST/GET /proposals (+ accept/decline/withdraw) with a
+ *     Profile>Messages notification; GET /entitlements/history + /provider/history (superseded contracts).
+ *   v1.1.0 — 2026-07-21 — Accept by `offering_id` (works for ext-action AND app-tool kinds; app-tool contract
+ *     pins the offering's interface version) via the shared resolveOfferingPricing; legacy ext+action retained.
+ *   v1.0.0 — 2026-07-20 — Initial acceptance surface: mint (authoritative price) / list mine / pause+revoke.
+ */
+import { Router } from 'express';
+import { requireAuth } from '../auth/middleware.js';
+import { success, error } from '../middleware/envelope.js';
+import { resolveIdentity } from '../utils/gaii.js';
+import { commerceFeePercent } from '../services/marketplace-fee.js';
+import { percentFee } from '../commerce/money.js';
+import { createEntitlement, readEntitlementForCall, listEntitlementsByConsumer, pauseEntitlement, revokeEntitlement, listEntitlementHistoryByConsumer, listEntitlementHistoryByProvider, } from '../services/metered-entitlements.js';
+import { resolveActionPricing, resolveOfferingPricing, getOffering } from '../services/exchange-market.js';
+import { newProposalId, putProposal, getProposal, listProposalsForOwner, supersedeWithProposal, ownerOfGaii, } from '../services/exchange-proposals.js';
+import { sendDirectMessage } from '../services/message-send.js';
+import { settleMeteredCoordinate } from './extensions/entitlement-gate.js';
+import { newWorkId, putWork, getWork, listWorkByConsumer, listWorkByProvider, } from '../services/exchange-work.js';
+function ownerOf(gaii) {
+    return gaii.split('@')[0].split('#').pop() ?? gaii;
+}
+function view(config, e) {
+    const rakePct = e.rakePercent ?? commerceFeePercent(config);
+    return {
+        entitlement_id: e.entitlementId,
+        consumer_gaii: e.consumerGaii,
+        app_id: e.appId,
+        provider: e.providerGhii,
+        ext: e.ext,
+        action: e.action,
+        surface: e.surface ?? null,
+        capability: e.capabilityLabel,
+        unit: e.unit,
+        currency: e.currency,
+        price_per_call: e.pricePerCall,
+        pricing: e.pricing ?? { model: 'per_call' },
+        rake_percent: rakePct,
+        rake_per_call: percentFee(e.pricePerCall, rakePct),
+        contract_ref: e.contractRef,
+        escrow_party: e.escrowParty,
+        state: e.state,
+        budget: {
+            cap_units: e.budget.capUnits,
+            spent_units: e.budget.spentUnits,
+            remaining_units: e.budget.capUnits === null ? null : Math.max(0, e.budget.capUnits - e.budget.spentUnits),
+            calls: e.budget.calls,
+        },
+    };
+}
+export function exchangeRouter(config, storage) {
+    const router = Router();
+    /**
+     * POST /v1/exchange/entitlements — accept a contract → mint a durable entitlement for the caller's
+     * owner. Body: { ext, action, contract_ref, cap_units?, app_id?, escrow_party? }. The per-call price
+     * is taken from the provider's ext action (authoritative), never the request.
+     */
+    router.post('/v1/exchange/entitlements', requireAuth(), async (req, res) => {
+        const consumerGaii = resolveIdentity(req.auth, config.nodeId);
+        const owner = req.auth.owner;
+        const b = (req.body ?? {});
+        const capUnits = typeof b.cap_units === 'number' && Number.isFinite(b.cap_units) && b.cap_units >= 0
+            ? Math.floor(b.cap_units) : null;
+        const appId = typeof b.app_id === 'string' && b.app_id ? b.app_id : null;
+        const escrowParty = b.escrow_party === 'consumer' || b.escrow_party === 'provider' ? b.escrow_party : null;
+        const planId = typeof b.plan_id === 'string' && b.plan_id ? b.plan_id : null;
+        // ── Preferred path: accept an OFFERING by id (works for BOTH ext-action and app-tool kinds). The
+        // offering pins the metered coordinate (+ the app-tool interface version); pricing is authoritative. ──
+        if (typeof b.offering_id === 'string' && b.offering_id) {
+            const contractRef = typeof b.contract_ref === 'string' && b.contract_ref ? b.contract_ref : `offering:${b.offering_id}`;
+            const o = await getOffering(storage, b.offering_id);
+            if (!o || o.state !== 'listed')
+                return res.status(404).json(error(config.nodeId, 'NOT_FOUND', 'No such listed offering'));
+            const priced = await resolveOfferingPricing(storage, o, planId);
+            if (!priced.ok)
+                return res.status(priced.status).json(error(config.nodeId, priced.code, priced.message));
+            const minCharge = priced.pricing?.model === 'bundle' ? priced.pricing.blockPrice : priced.pricing?.model === 'subscription' ? priced.pricing.periodPrice : priced.pricePerCall;
+            if (capUnits !== null && capUnits < minCharge) {
+                return res.status(400).json(error(config.nodeId, 'BUDGET_TOO_LOW', `Budget cap (${capUnits}) is below the ${minCharge}-${priced.unit === 'money' ? priced.currency : 'morsel'} minimum charge`));
+            }
+            const existing = await readEntitlementForCall(storage, consumerGaii, priced.ext, priced.action);
+            const ent = await createEntitlement(storage, {
+                consumerGaii, appId, providerGhii: priced.providerGhii, ext: priced.ext, action: priced.action,
+                capabilityLabel: priced.capabilityLabel, unit: priced.unit, pricePerCall: priced.pricePerCall,
+                currency: priced.currency, pricing: priced.pricing, capUnits, contractRef, surface: priced.surface,
+                escrowParty, createdBy: owner, carrySpend: existing,
+            });
+            return res.status(201).json(success(config.nodeId, { entitlement: view(config, ent) }, [
+                { description: 'This app’s cost & contracts', method: 'GET', url: appId ? `/v1/apps/cost?app_id=${encodeURIComponent(appId)}` : '/v1/exchange/entitlements' },
+            ]));
+        }
+        // ── Legacy path: accept a raw ext-action directly by (ext, action). ──
+        const ext = typeof b.ext === 'string' ? b.ext : '';
+        const action = typeof b.action === 'string' ? b.action : '';
+        const contractRef = typeof b.contract_ref === 'string' ? b.contract_ref : '';
+        if (!ext || !action || !contractRef) {
+            return res.status(400).json(error(config.nodeId, 'BAD_REQUEST', 'ext, action and contract_ref are required (or pass offering_id)'));
+        }
+        // Resolve the provider + AUTHORITATIVE price from the extension action.
+        const extRec = await storage.getExtension(ext);
+        if (!extRec)
+            return res.status(404).json(error(config.nodeId, 'NOT_FOUND', `Extension "${ext}" not found`));
+        const act = extRec.actions.find(a => a.id === action);
+        if (!act)
+            return res.status(404).json(error(config.nodeId, 'NOT_FOUND', `Action "${action}" not found on "${ext}"`));
+        // AUTHORITATIVE price + unit + (optional plan) pricing — shared resolver, so a consumer can never
+        // undercut the provider. `plan_id` picks a provider-declared bundle/subscription plan; none → per_call.
+        const priced = resolveActionPricing(act.commercial, planId);
+        if (!priced.ok)
+            return res.status(priced.code === 'NOT_PRICED' ? 400 : 404).json(error(config.nodeId, priced.code, `Action "${ext}/${action}": ${priced.message}`));
+        const { unit, pricePerCall, currency, pricing } = priced;
+        // Budget floor: the cap must cover a single charge (per-call price, or a bundle block / subscription period).
+        const minCharge = pricing?.model === 'bundle' ? pricing.blockPrice : pricing?.model === 'subscription' ? pricing.periodPrice : pricePerCall;
+        if (capUnits !== null && capUnits < minCharge) {
+            return res.status(400).json(error(config.nodeId, 'BUDGET_TOO_LOW', `Budget cap (${capUnits}) is below the ${minCharge}-${unit === 'money' ? currency : 'morsel'} minimum charge`));
+        }
+        const providerGhii = `${extRec.installedBy}@${config.nodeId}`;
+        // Carry spend forward on re-acceptance (renegotiation) so a new contract does not reset the meter.
+        const existing = await readEntitlementForCall(storage, consumerGaii, ext, action);
+        const ent = await createEntitlement(storage, {
+            consumerGaii, appId, providerGhii, ext, action, capabilityLabel: `${ext}/${action}`,
+            unit, pricePerCall, currency, pricing, capUnits, contractRef, escrowParty, createdBy: owner,
+            carrySpend: existing,
+        });
+        return res.status(201).json(success(config.nodeId, { entitlement: view(config, ent) }, [
+            { description: 'This app’s cost & contracts', method: 'GET', url: appId ? `/v1/apps/cost?app_id=${encodeURIComponent(appId)}` : '/v1/exchange/entitlements' },
+        ]));
+    });
+    /** GET /v1/exchange/entitlements — every entitlement the caller's owner holds (as consumer). */
+    router.get('/v1/exchange/entitlements', requireAuth(), async (req, res) => {
+        const consumerGaii = resolveIdentity(req.auth, config.nodeId);
+        const mine = await listEntitlementsByConsumer(storage, consumerGaii);
+        return res.json(success(config.nodeId, { entitlements: mine.map(e => view(config, e)) }));
+    });
+    /**
+     * POST /v1/exchange/entitlements/off — the consumer's off-switch. Body: { ext, action, mode }
+     * with mode `pause` (reversible) or `revoke` (terminal). Only the entitlement's own consumer may.
+     */
+    router.post('/v1/exchange/entitlements/off', requireAuth(), async (req, res) => {
+        const consumerGaii = resolveIdentity(req.auth, config.nodeId);
+        const owner = req.auth.owner;
+        const b = (req.body ?? {});
+        const ext = typeof b.ext === 'string' ? b.ext : '';
+        const action = typeof b.action === 'string' ? b.action : '';
+        const mode = b.mode === 'revoke' ? 'revoke' : 'pause';
+        if (!ext || !action)
+            return res.status(400).json(error(config.nodeId, 'BAD_REQUEST', 'ext and action are required'));
+        const ent = await readEntitlementForCall(storage, consumerGaii, ext, action);
+        if (!ent || ownerOf(ent.consumerGaii) !== owner) {
+            return res.status(404).json(error(config.nodeId, 'NOT_FOUND', 'No entitlement of yours for that capability'));
+        }
+        const ok = mode === 'revoke'
+            ? await revokeEntitlement(storage, consumerGaii, ext, action)
+            : await pauseEntitlement(storage, consumerGaii, ext, action);
+        return res.json(success(config.nodeId, { ext, action, mode, applied: ok }));
+    });
+    // ── RENEGOTIATION (proposals) + HISTORY ─────────────────────────────────────
+    const gh = (owner) => `${owner}@${config.nodeId}`;
+    /** Deliver a same-node inbox message (Profile > Messages) to notify a party of a proposal event. */
+    async function notify(senderOwner, recipientOwner, subject, body) {
+        try {
+            await sendDirectMessage({ config, storage, peers: new Map() }, {
+                senderGhii: gh(senderOwner), recipientGhii: gh(recipientOwner), body, subject, respondable: false, skipContactGate: true,
+            });
+        }
+        catch { /* a notification failure must not fail the proposal itself */ }
+    }
+    function proposalView(p) {
+        return {
+            proposal_id: p.proposalId, consumer_gaii: p.consumerGaii, provider: p.providerGhii,
+            ext: p.ext, action: p.action, capability: p.capabilityLabel,
+            proposed_by: p.proposedByRole, proposer_owner: p.proposerOwner, counterparty_owner: p.counterpartyOwner,
+            new_price_per_call: p.newPricePerCall, new_cap_units: p.newCapUnits, note: p.note,
+            current_terms: p.currentTerms, status: p.status, created_at: p.createdAt, resolved_at: p.resolvedAt,
+        };
+    }
+    function historyView(config2, e) {
+        return { ...view(config2, e), archived_at: e.archivedAt, archive_reason: e.archiveReason, superseded_by_proposal: e.supersededByProposal };
+    }
+    /**
+     * POST /v1/exchange/proposals — propose new terms for a live contract (renegotiation). Either party may:
+     * a consumer renegotiates their own contract; a provider renegotiates a specific consumer's contract
+     * (pass `consumer_gaii`). Body: `{ ext, action, consumer_gaii?, new_price_per_call?, new_cap_units?, note? }`.
+     * A message is delivered to the counterparty; they accept/decline. Nothing changes until accepted.
+     */
+    router.post('/v1/exchange/proposals', requireAuth(), async (req, res) => {
+        const owner = req.auth.owner;
+        const b = (req.body ?? {});
+        const ext = typeof b.ext === 'string' ? b.ext : '';
+        const action = typeof b.action === 'string' ? b.action : '';
+        if (!ext || !action)
+            return res.status(400).json(error(config.nodeId, 'BAD_REQUEST', 'ext and action are required'));
+        const targetConsumer = typeof b.consumer_gaii === 'string' && b.consumer_gaii ? b.consumer_gaii : resolveIdentity(req.auth, config.nodeId);
+        const ent = await readEntitlementForCall(storage, targetConsumer, ext, action);
+        if (!ent)
+            return res.status(404).json(error(config.nodeId, 'NOT_FOUND', 'No such contract'));
+        const isConsumer = ownerOfGaii(ent.consumerGaii) === owner;
+        const isProvider = ownerOfGaii(ent.providerGhii) === owner;
+        if (!isConsumer && !isProvider)
+            return res.status(403).json(error(config.nodeId, 'FORBIDDEN', 'You are not a party to this contract'));
+        const proposedByRole = isConsumer ? 'consumer' : 'provider';
+        const proposerGhii = proposedByRole === 'consumer' ? ent.consumerGaii : ent.providerGhii;
+        const counterpartyGhii = proposedByRole === 'consumer' ? ent.providerGhii : ent.consumerGaii;
+        const newPrice = typeof b.new_price_per_call === 'number' && Number.isFinite(b.new_price_per_call) && b.new_price_per_call >= 0 ? Math.floor(b.new_price_per_call) : null;
+        const newCap = typeof b.new_cap_units === 'number' && Number.isFinite(b.new_cap_units) && b.new_cap_units >= 0 ? Math.floor(b.new_cap_units) : null;
+        if (newPrice === null && newCap === null)
+            return res.status(400).json(error(config.nodeId, 'BAD_REQUEST', 'Propose at least a new_price_per_call or new_cap_units'));
+        const now = new Date().toISOString();
+        const proposal = {
+            proposalId: newProposalId(), consumerGaii: ent.consumerGaii, providerGhii: ent.providerGhii,
+            ext, action, capabilityLabel: ent.capabilityLabel, proposedByRole,
+            proposerGhii, proposerOwner: owner, counterpartyGhii, counterpartyOwner: ownerOfGaii(counterpartyGhii),
+            newPricePerCall: newPrice, newCapUnits: newCap, note: typeof b.note === 'string' ? b.note.slice(0, 2000) : '',
+            currentTerms: { unit: ent.unit, pricePerCall: ent.pricePerCall, pricingModel: (ent.pricing?.model ?? 'per_call'), capUnits: ent.budget.capUnits },
+            status: 'pending', createdAt: now, resolvedAt: null,
+        };
+        await putProposal(storage, proposal);
+        const priceLine = newPrice !== null ? `price → ${newPrice} ${ent.unit === 'money' ? (ent.currency ?? '') : 'morsels'}/call` : '';
+        const capLine = newCap !== null ? `budget cap → ${newCap}` : '';
+        await notify(owner, proposal.counterpartyOwner, 'EXCHANGE — contract change proposed', `${owner} proposed a change to your contract for ${ent.capabilityLabel}: ${[priceLine, capLine].filter(Boolean).join(', ')}. ${proposal.note ? `Note: ${proposal.note}. ` : ''}Review it in the EXCHANGE app (Proposals) to accept or decline.`);
+        return res.status(201).json(success(config.nodeId, { proposal: proposalView(proposal) }));
+    });
+    /** GET /v1/exchange/proposals — every proposal the caller is party to (incoming + outgoing). */
+    router.get('/v1/exchange/proposals', requireAuth(), async (req, res) => {
+        const list = await listProposalsForOwner(storage, req.auth.owner);
+        return res.json(success(config.nodeId, { proposals: list.map(proposalView), count: list.length }));
+    });
+    /** POST /v1/exchange/proposals/:id/accept — the COUNTERPARTY accepts → supersede (archive old + mint new). */
+    router.post('/v1/exchange/proposals/:id/accept', requireAuth(), async (req, res) => {
+        const owner = req.auth.owner;
+        const p = await getProposal(storage, typeof req.params.id === 'string' ? req.params.id : '');
+        if (!p || p.status !== 'pending')
+            return res.status(404).json(error(config.nodeId, 'NOT_FOUND', 'No such pending proposal'));
+        if (p.counterpartyOwner !== owner)
+            return res.status(403).json(error(config.nodeId, 'FORBIDDEN', 'Only the counterparty may accept this proposal'));
+        const ent = await supersedeWithProposal(storage, p);
+        if (!ent)
+            return res.status(409).json(error(config.nodeId, 'CONTRACT_GONE', 'The contract no longer exists'));
+        p.status = 'accepted';
+        p.resolvedAt = new Date().toISOString();
+        await putProposal(storage, p);
+        await notify(owner, p.proposerOwner, 'EXCHANGE — contract change accepted', `${owner} accepted your proposed change to ${p.capabilityLabel}. The new contract is in effect; the previous one is in your contract history.`);
+        return res.status(200).json(success(config.nodeId, { proposal: proposalView(p), entitlement: view(config, ent) }));
+    });
+    /** POST /v1/exchange/proposals/:id/decline — the counterparty declines (no change). */
+    router.post('/v1/exchange/proposals/:id/decline', requireAuth(), async (req, res) => {
+        const owner = req.auth.owner;
+        const p = await getProposal(storage, typeof req.params.id === 'string' ? req.params.id : '');
+        if (!p || p.status !== 'pending')
+            return res.status(404).json(error(config.nodeId, 'NOT_FOUND', 'No such pending proposal'));
+        if (p.counterpartyOwner !== owner)
+            return res.status(403).json(error(config.nodeId, 'FORBIDDEN', 'Only the counterparty may decline this proposal'));
+        p.status = 'declined';
+        p.resolvedAt = new Date().toISOString();
+        await putProposal(storage, p);
+        await notify(owner, p.proposerOwner, 'EXCHANGE — contract change declined', `${owner} declined your proposed change to ${p.capabilityLabel}. The contract is unchanged.`);
+        return res.json(success(config.nodeId, { proposal: proposalView(p) }));
+    });
+    /** POST /v1/exchange/proposals/:id/withdraw — the PROPOSER withdraws their own pending proposal. */
+    router.post('/v1/exchange/proposals/:id/withdraw', requireAuth(), async (req, res) => {
+        const owner = req.auth.owner;
+        const p = await getProposal(storage, typeof req.params.id === 'string' ? req.params.id : '');
+        if (!p || p.status !== 'pending')
+            return res.status(404).json(error(config.nodeId, 'NOT_FOUND', 'No such pending proposal'));
+        if (p.proposerOwner !== owner)
+            return res.status(403).json(error(config.nodeId, 'FORBIDDEN', 'Only the proposer may withdraw'));
+        p.status = 'withdrawn';
+        p.resolvedAt = new Date().toISOString();
+        await putProposal(storage, p);
+        return res.json(success(config.nodeId, { proposal: proposalView(p) }));
+    });
+    /** GET /v1/exchange/entitlements/history — the caller-owner's PAST (archived/superseded) contracts as consumer. */
+    router.get('/v1/exchange/entitlements/history', requireAuth(), async (req, res) => {
+        const consumerGaii = resolveIdentity(req.auth, config.nodeId);
+        const past = await listEntitlementHistoryByConsumer(storage, consumerGaii);
+        return res.json(success(config.nodeId, { history: past.map(e => historyView(config, e)), count: past.length }));
+    });
+    /** GET /v1/exchange/provider/history — the caller-owner's PAST (archived/superseded) contracts as provider. */
+    router.get('/v1/exchange/provider/history', requireAuth(), async (req, res) => {
+        const providerGhii = resolveIdentity(req.auth, config.nodeId);
+        const past = await listEntitlementHistoryByProvider(storage, providerGhii);
+        return res.json(success(config.nodeId, { history: past.map(e => historyView(config, e)), count: past.length }));
+    });
+    // ── AGENT WORK (async surface — settled per delivered task, Gap 2) ───────────
+    function workView(w) {
+        return {
+            work_id: w.workId, offering_id: w.offeringId, consumer: w.consumerGaii, provider: w.providerGhii,
+            agent: w.agentGaii, task_type: w.taskType, ext: w.ext, action: w.action, input: w.input, output: w.output,
+            note: w.note, state: w.state, unit: w.unit, currency: w.currency, charged_units: w.chargedUnits,
+            created_at: w.createdAt, delivered_at: w.deliveredAt,
+        };
+    }
+    /**
+     * POST /v1/exchange/work — the CONSUMER starts a task under an agent-work contract. Body:
+     * `{ offering_id, input, note? }`. Requires an active metered entitlement for the offering's coordinate
+     * (contract first). Nothing is charged yet — the per-task price is metered when the provider DELIVERS.
+     */
+    router.post('/v1/exchange/work', requireAuth(), async (req, res) => {
+        const consumerGaii = resolveIdentity(req.auth, config.nodeId);
+        const owner = req.auth.owner;
+        const b = (req.body ?? {});
+        const offeringId = typeof b.offering_id === 'string' ? b.offering_id : '';
+        if (!offeringId)
+            return res.status(400).json(error(config.nodeId, 'BAD_REQUEST', 'offering_id is required'));
+        const o = await getOffering(storage, offeringId);
+        if (!o || o.state !== 'listed' || o.kind !== 'agent-work' || !o.surface || o.surface.kind !== 'agent-work') {
+            return res.status(404).json(error(config.nodeId, 'NOT_FOUND', 'No such listed agent-work offering'));
+        }
+        const ent = await readEntitlementForCall(storage, consumerGaii, o.ext, o.action);
+        if (!ent || ent.state !== 'active') {
+            return res.status(402).json(error(config.nodeId, 'NO_CONTRACT', 'Accept a contract for this agent-work offering before starting a task'));
+        }
+        const s = o.surface;
+        const now = new Date().toISOString();
+        const work = {
+            workId: newWorkId(), offeringId, consumerGaii, consumerOwner: owner,
+            providerGhii: o.providerGhii, providerOwner: o.providerOwner,
+            agentGaii: `${s.agentName}#${o.providerOwner}@${config.nodeId}`, taskType: s.taskType,
+            ext: o.ext, action: o.action, input: b.input ?? {}, output: null,
+            note: typeof b.note === 'string' ? b.note.slice(0, 2000) : '',
+            state: 'open', unit: ent.unit, currency: ent.currency, chargedUnits: 0, createdAt: now, deliveredAt: null,
+        };
+        await putWork(storage, work);
+        await notify(owner, o.providerOwner, 'EXCHANGE — new agent work started', `${owner} started a "${s.taskType}" task for your agent ${s.agentName} (work ${work.workId}). Deliver it in the EXCHANGE app to get paid.`);
+        return res.status(201).json(success(config.nodeId, { work: workView(work) }));
+    });
+    /**
+     * POST /v1/exchange/work/:id/deliver — the PROVIDER delivers a task → settle ON DELIVERY (charge the
+     * consumer the per-task price, credit the provider, route the rake, decrement the budget). Body:
+     * `{ output, note? }`. A 402/429 (budget/rate) leaves the work open and unpaid.
+     */
+    router.post('/v1/exchange/work/:id/deliver', requireAuth(), async (req, res) => {
+        const owner = req.auth.owner;
+        const w = await getWork(storage, typeof req.params.id === 'string' ? req.params.id : '');
+        if (!w || w.providerOwner !== owner)
+            return res.status(404).json(error(config.nodeId, 'NOT_FOUND', 'No such work of yours to deliver'));
+        if (w.state !== 'open')
+            return res.status(409).json(error(config.nodeId, 'WORK_NOT_OPEN', `Work is ${w.state}`));
+        const b = (req.body ?? {});
+        // Settle the per-task price against the CONSUMER's contract (the consumer pays; the provider is credited).
+        const before = await readEntitlementForCall(storage, w.consumerGaii, w.ext, w.action);
+        if (!before || before.state !== 'active') {
+            return res.status(402).json(error(config.nodeId, 'CONTRACT_INACTIVE', 'The consumer contract is no longer active — cannot settle this delivery'));
+        }
+        const outcome = await settleMeteredCoordinate({
+            config, storage, coordExt: w.ext, coordAction: w.action, label: `${w.agentGaii}:${w.taskType}`,
+            callerGaii: w.consumerGaii, res,
+        });
+        if (!outcome)
+            return res.status(402).json(error(config.nodeId, 'NO_CONTRACT', 'No active contract to settle against'));
+        if (!outcome.ok)
+            return; // 402/429 already sent (budget/rate) — work stays open
+        const after = await readEntitlementForCall(storage, w.consumerGaii, w.ext, w.action);
+        const charged = after && before ? Math.max(0, (after.budget.spentUnits) - (before.budget.spentUnits)) : 0;
+        w.state = 'delivered';
+        w.output = b.output ?? null;
+        w.chargedUnits = charged;
+        w.deliveredAt = new Date().toISOString();
+        if (typeof b.note === 'string' && b.note)
+            w.note = b.note.slice(0, 2000);
+        await putWork(storage, w);
+        await notify(owner, w.consumerOwner, 'EXCHANGE — your agent work was delivered', `Your "${w.taskType}" task (work ${w.workId}) was delivered by ${owner} and charged to your contract. See it in the EXCHANGE app.`);
+        return res.json(success(config.nodeId, { work: workView(w) }));
+    });
+    /** GET /v1/exchange/work?role=consumer|provider — the caller-owner's agent-work items (default: consumer). */
+    router.get('/v1/exchange/work', requireAuth(), async (req, res) => {
+        const owner = req.auth.owner;
+        const role = req.query.role === 'provider' ? 'provider' : 'consumer';
+        const items = role === 'provider' ? await listWorkByProvider(storage, owner) : await listWorkByConsumer(storage, owner);
+        return res.json(success(config.nodeId, { work: items.map(workView), count: items.length, role }));
+    });
+    return router;
+}
+//# sourceMappingURL=exchange.js.map

package/dist/src/routes/exchange.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"exchange.js","sourceRoot":"","sources":["../../../src/routes/exchange.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAIjC,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACpD,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,2BAA2B,CAAC;AAC3D,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AACpE,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAClD,OAAO,EACL,iBAAiB,EAAE,sBAAsB,EAAE,0BAA0B,EACrE,gBAAgB,EAAE,iBAAiB,EACnC,gCAAgC,EAAE,gCAAgC,GAEnE,MAAM,qCAAqC,CAAC;AAC7C,OAAO,EAAE,oBAAoB,EAAE,sBAAsB,EAAE,WAAW,EAAyB,MAAM,gCAAgC,CAAC;AAClI,OAAO,EACkB,aAAa,EAAE,WAAW,EAAE,WAAW,EAAE,qBAAqB,EACrF,qBAAqB,EAAE,WAAW,GACnC,MAAM,mCAAmC,CAAC;AAC3C,OAAO,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAEhE,OAAO,EAAE,uBAAuB,EAAE,MAAM,kCAAkC,CAAC;AAC3E,OAAO,EACW,SAAS,EAAE,OAAO,EAAE,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,GACpF,MAAM,8BAA8B,CAAC;AAEtC,SAAS,OAAO,CAAC,IAAY;IAC3B,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,IAAI,IAAI,CAAC;AACrD,CAAC;AAED,SAAS,IAAI,CAAC,MAAoB,EAAE,CAAqB;IACvD,MAAM,OAAO,GAAG,CAAC,CAAC,WAAW,IAAI,kBAAkB,CAAC,MAAM,CAAC,CAAC;IAC5D,OAAO;QACL,cAAc,EAAE,CAAC,CAAC,aAAa;QAC/B,aAAa,EAAE,CAAC,CAAC,YAAY;QAC7B,MAAM,EAAE,CAAC,CAAC,KAAK;QACf,QAAQ,EAAE,CAAC,CAAC,YAAY;QACxB,GAAG,EAAE,CAAC,CAAC,GAAG;QACV,MAAM,EAAE,CAAC,CAAC,MAAM;QAChB,OAAO,EAAE,CAAC,CAAC,OAAO,IAAI,IAAI;QAC1B,UAAU,EAAE,CAAC,CAAC,eAAe;QAC7B,IAAI,EAAE,CAAC,CAAC,IAAI;QACZ,QAAQ,EAAE,CAAC,CAAC,QAAQ;QACpB,cAAc,EAAE,CAAC,CAAC,YAAY;QAC9B,OAAO,EAAE,CAAC,CAAC,OAAO,IAAI,EAAE,KAAK,EAAE,UAAU,EAAE;QAC3C,YAAY,EAAE,OAAO;QACrB,aAAa,EAAE,UAAU,CAAC,CAAC,CAAC,YAAY,EAAE,OAAO,CAAC;QAClD,YAAY,EAAE,CAAC,CAAC,WAAW;QAC3B,YAAY,EAAE,CAAC,CAAC,WAAW;QAC3B,KAAK,EAAE,CAAC,CAAC,KAAK;QACd,MAAM,EAAE;YACN,SAAS,EAAE,CAAC,CAAC,MAAM,CAAC,QAAQ;YAC5B,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC,UAAU;YAChC,eAAe,EAAE,CAAC,CAAC,MAAM,CAAC,QAAQ,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC,QAAQ,GAAG,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC;YACzG,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC,KAAK;SACtB;KACF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,MAAoB,EAAE,OAAgB;IACnE,MAAM,MAAM,GAAG,MAAM,EAAE,CAAC;IAExB;;;;OAIG;IACH,MAAM,CAAC,IAAI,CAAC,2BAA2B,EAAE,WAAW,EAAE,EAAE,KAAK,EAAE,GAAY,EAAE,GAAa,EAAE,EAAE;QAC5F,MAAM,YAAY,GAAG,eAAe,CAAC,GAAG,CAAC,IAAK,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;QAC/D,MAAM,KAAK,GAAG,GAAG,CAAC,IAAK,CAAC,KAAK,CAAC;QAC9B,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,IAAI,EAAE,CAA4B,CAAC;QACtD,MAAM,QAAQ,GAAG,OAAO,CAAC,CAAC,SAAS,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,SAAS,IAAI,CAAC;YAClG,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QACnC,MAAM,KAAK,GAAG,OAAO,CAAC,CAAC,MAAM,KAAK,QAAQ,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC;QACzE,MAAM,WAAW,GAAG,CAAC,CAAC,YAAY,KAAK,UAAU,IAAI,CAAC,CAAC,YAAY,KAAK,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,IAAI,CAAC;QAC3G,MAAM,MAAM,GAAG,OAAO,CAAC,CAAC,OAAO,KAAK,QAAQ,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC;QAE7E,kGAAkG;QAClG,wGAAwG;QACxG,IAAI,OAAO,CAAC,CAAC,WAAW,KAAK,QAAQ,IAAI,CAAC,CAAC,WAAW,EAAE,CAAC;YACvD,MAAM,WAAW,GAAG,OAAO,CAAC,CAAC,YAAY,KAAK,QAAQ,IAAI,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,WAAW,EAAE,CAAC;YACxH,MAAM,CAAC,GAAG,MAAM,WAAW,CAAC,OAAO,EAAE,CAAC,CAAC,WAAW,CAAC,CAAC;YACpD,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,KAAK,QAAQ;gBAAE,OAAO,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,WAAW,EAAE,yBAAyB,CAAC,CAAC,CAAC;YAC1H,MAAM,MAAM,GAAG,MAAM,sBAAsB,CAAC,OAAO,EAAE,CAAC,EAAE,MAAM,CAAC,CAAC;YAChE,IAAI,CAAC,MAAM,CAAC,EAAE;gBAAE,OAAO,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC;YACzG,MAAM,SAAS,GAAG,MAAM,CAAC,OAAO,EAAE,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,EAAE,KAAK,KAAK,cAAc,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC,YAAY,CAAC;YAC/K,IAAI,QAAQ,KAAK,IAAI,IAAI,QAAQ,GAAG,SAAS,EAAE,CAAC;gBAC9C,OAAO,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,gBAAgB,EAC/D,eAAe,QAAQ,kBAAkB,SAAS,IAAI,MAAM,CAAC,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,iBAAiB,CAAC,CAAC,CAAC;YAClI,CAAC;YACD,MAAM,QAAQ,GAAG,MAAM,sBAAsB,CAAC,OAAO,EAAE,YAAY,EAAE,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;YAChG,MAAM,GAAG,GAAG,MAAM,iBAAiB,CAAC,OAAO,EAAE;gBAC3C,YAAY,EAAE,KAAK,EAAE,YAAY,EAAE,MAAM,CAAC,YAAY,EAAE,GAAG,EAAE,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM;gBAC9F,eAAe,EAAE,MAAM,CAAC,eAAe,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,YAAY,EAAE,MAAM,CAAC,YAAY;gBAC7F,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO;gBAClG,WAAW,EAAE,SAAS,EAAE,KAAK,EAAE,UAAU,EAAE,QAAQ;aACpD,CAAC,CAAC;YACH,OAAO,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,EAAE,WAAW,EAAE,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,EAAE;gBACrF,EAAE,WAAW,EAAE,6BAA6B,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC,wBAAwB,kBAAkB,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,2BAA2B,EAAE;aAC9J,CAAC,CAAC,CAAC;QACN,CAAC;QAED,wEAAwE;QACxE,MAAM,GAAG,GAAG,OAAO,CAAC,CAAC,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;QACnD,MAAM,MAAM,GAAG,OAAO,CAAC,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;QAC5D,MAAM,WAAW,GAAG,OAAO,CAAC,CAAC,YAAY,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,CAAC;QAC7E,IAAI,CAAC,GAAG,IAAI,CAAC,MAAM,IAAI,CAAC,WAAW,EAAE,CAAC;YACpC,OAAO,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,aAAa,EAAE,iEAAiE,CAAC,CAAC,CAAC;QACtI,CAAC;QAED,wEAAwE;QACxE,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC;QAC/C,IAAI,CAAC,MAAM;YAAE,OAAO,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,WAAW,EAAE,cAAc,GAAG,aAAa,CAAC,CAAC,CAAC;QAC5G,MAAM,GAAG,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,MAAM,CAAC,CAAC;QACtD,IAAI,CAAC,GAAG;YAAE,OAAO,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,WAAW,EAAE,WAAW,MAAM,mBAAmB,GAAG,GAAG,CAAC,CAAC,CAAC;QAErH,kGAAkG;QAClG,wGAAwG;QACxG,MAAM,MAAM,GAAG,oBAAoB,CAAC,GAAG,CAAC,UAA0C,EAAE,MAAM,CAAC,CAAC;QAC5F,IAAI,CAAC,MAAM,CAAC,EAAE;YAAE,OAAO,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,KAAK,YAAY,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,IAAI,EAAE,WAAW,GAAG,IAAI,MAAM,MAAM,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;QACpK,MAAM,EAAE,IAAI,EAAE,YAAY,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,MAAM,CAAC;QACzD,8GAA8G;QAC9G,MAAM,SAAS,GAAG,OAAO,EAAE,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,OAAO,EAAE,KAAK,KAAK,cAAc,CAAC,CAAC,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,YAAY,CAAC;QAC5I,IAAI,QAAQ,KAAK,IAAI,IAAI,QAAQ,GAAG,SAAS,EAAE,CAAC;YAC9C,OAAO,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,gBAAgB,EAC/D,eAAe,QAAQ,kBAAkB,SAAS,IAAI,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,iBAAiB,CAAC,CAAC,CAAC;QACpH,CAAC;QACD,MAAM,YAAY,GAAG,GAAG,MAAM,CAAC,WAAW,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;QAE9D,mGAAmG;QACnG,MAAM,QAAQ,GAAG,MAAM,sBAAsB,CAAC,OAAO,EAAE,YAAY,EAAE,GAAG,EAAE,MAAM,CAAC,CAAC;QAClF,MAAM,GAAG,GAAG,MAAM,iBAAiB,CAAC,OAAO,EAAE;YAC3C,YAAY,EAAE,KAAK,EAAE,YAAY,EAAE,GAAG,EAAE,MAAM,EAAE,eAAe,EAAE,GAAG,GAAG,IAAI,MAAM,EAAE;YACnF,IAAI,EAAE,YAAY,EAAE,QAAQ,EAAE,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,WAAW,EAAE,SAAS,EAAE,KAAK;YAC3F,UAAU,EAAE,QAAQ;SACrB,CAAC,CAAC;QACH,OAAO,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,EAAE,WAAW,EAAE,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,EAAE;YACrF,EAAE,WAAW,EAAE,6BAA6B,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC,wBAAwB,kBAAkB,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,2BAA2B,EAAE;SAC9J,CAAC,CAAC,CAAC;IACN,CAAC,CAAC,CAAC;IAEH,gGAAgG;IAChG,MAAM,CAAC,GAAG,CAAC,2BAA2B,EAAE,WAAW,EAAE,EAAE,KAAK,EAAE,GAAY,EAAE,GAAa,EAAE,EAAE;QAC3F,MAAM,YAAY,GAAG,eAAe,CAAC,GAAG,CAAC,IAAK,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;QAC/D,MAAM,IAAI,GAAG,MAAM,0BAA0B,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC;QACrE,OAAO,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,EAAE,YAAY,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAC5F,CAAC,CAAC,CAAC;IAEH;;;OAGG;IACH,MAAM,CAAC,IAAI,CAAC,+BAA+B,EAAE,WAAW,EAAE,EAAE,KAAK,EAAE,GAAY,EAAE,GAAa,EAAE,EAAE;QAChG,MAAM,YAAY,GAAG,eAAe,CAAC,GAAG,CAAC,IAAK,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;QAC/D,MAAM,KAAK,GAAG,GAAG,CAAC,IAAK,CAAC,KAAK,CAAC;QAC9B,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,IAAI,EAAE,CAA4B,CAAC;QACtD,MAAM,GAAG,GAAG,OAAO,CAAC,CAAC,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;QACnD,MAAM,MAAM,GAAG,OAAO,CAAC,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;QAC5D,MAAM,IAAI,GAAG,CAAC,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC;QACtD,IAAI,CAAC,GAAG,IAAI,CAAC,MAAM;YAAE,OAAO,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,aAAa,EAAE,6BAA6B,CAAC,CAAC,CAAC;QAErH,MAAM,GAAG,GAAG,MAAM,sBAAsB,CAAC,OAAO,EAAE,YAAY,EAAE,GAAG,EAAE,MAAM,CAAC,CAAC;QAC7E,IAAI,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,KAAK,KAAK,EAAE,CAAC;YAChD,OAAO,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,WAAW,EAAE,6CAA6C,CAAC,CAAC,CAAC;QAChH,CAAC;QACD,MAAM,EAAE,GAAG,IAAI,KAAK,QAAQ;YAC1B,CAAC,CAAC,MAAM,iBAAiB,CAAC,OAAO,EAAE,YAAY,EAAE,GAAG,EAAE,MAAM,CAAC;YAC7D,CAAC,CAAC,MAAM,gBAAgB,CAAC,OAAO,EAAE,YAAY,EAAE,GAAG,EAAE,MAAM,CAAC,CAAC;QAC/D,OAAO,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC;IAC9E,CAAC,CAAC,CAAC;IAEH,+EAA+E;IAC/E,MAAM,EAAE,GAAG,CAAC,KAAa,EAAE,EAAE,CAAC,GAAG,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;IAC1D,oGAAoG;IACpG,KAAK,UAAU,MAAM,CAAC,WAAmB,EAAE,cAAsB,EAAE,OAAe,EAAE,IAAY;QAC9F,IAAI,CAAC;YACH,MAAM,iBAAiB,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,GAAG,EAAoB,EAAE,EAAE;gBAC/E,UAAU,EAAE,EAAE,CAAC,WAAW,CAAC,EAAE,aAAa,EAAE,EAAE,CAAC,cAAc,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,WAAW,EAAE,KAAK,EAAE,eAAe,EAAE,IAAI;aACzH,CAAC,CAAC;QACL,CAAC;QAAC,MAAM,CAAC,CAAC,8DAA8D,CAAC,CAAC;IAC5E,CAAC;IACD,SAAS,YAAY,CAAC,CAAmB;QACvC,OAAO;YACL,WAAW,EAAE,CAAC,CAAC,UAAU,EAAE,aAAa,EAAE,CAAC,CAAC,YAAY,EAAE,QAAQ,EAAE,CAAC,CAAC,YAAY;YAClF,GAAG,EAAE,CAAC,CAAC,GAAG,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,UAAU,EAAE,CAAC,CAAC,eAAe;YAC3D,WAAW,EAAE,CAAC,CAAC,cAAc,EAAE,cAAc,EAAE,CAAC,CAAC,aAAa,EAAE,kBAAkB,EAAE,CAAC,CAAC,iBAAiB;YACvG,kBAAkB,EAAE,CAAC,CAAC,eAAe,EAAE,aAAa,EAAE,CAAC,CAAC,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI;YACjF,aAAa,EAAE,CAAC,CAAC,YAAY,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,UAAU,EAAE,CAAC,CAAC,SAAS,EAAE,WAAW,EAAE,CAAC,CAAC,UAAU;SACpG,CAAC;IACJ,CAAC;IACD,SAAS,WAAW,CAAC,OAAqB,EAAE,CAA0B;QACpE,OAAO,EAAE,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC,CAAC,UAAU,EAAE,cAAc,EAAE,CAAC,CAAC,aAAa,EAAE,sBAAsB,EAAE,CAAC,CAAC,oBAAoB,EAAE,CAAC;IAC7I,CAAC;IAED;;;;;OAKG;IACH,MAAM,CAAC,IAAI,CAAC,wBAAwB,EAAE,WAAW,EAAE,EAAE,KAAK,EAAE,GAAY,EAAE,GAAa,EAAE,EAAE;QACzF,MAAM,KAAK,GAAG,GAAG,CAAC,IAAK,CAAC,KAAK,CAAC;QAC9B,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,IAAI,EAAE,CAA4B,CAAC;QACtD,MAAM,GAAG,GAAG,OAAO,CAAC,CAAC,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;QACnD,MAAM,MAAM,GAAG,OAAO,CAAC,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;QAC5D,IAAI,CAAC,GAAG,IAAI,CAAC,MAAM;YAAE,OAAO,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,aAAa,EAAE,6BAA6B,CAAC,CAAC,CAAC;QACrH,MAAM,cAAc,GAAG,OAAO,CAAC,CAAC,aAAa,KAAK,QAAQ,IAAI,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,eAAe,CAAC,GAAG,CAAC,IAAK,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;QAC5I,MAAM,GAAG,GAAG,MAAM,sBAAsB,CAAC,OAAO,EAAE,cAAc,EAAE,GAAG,EAAE,MAAM,CAAC,CAAC;QAC/E,IAAI,CAAC,GAAG;YAAE,OAAO,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,WAAW,EAAE,kBAAkB,CAAC,CAAC,CAAC;QAC7F,MAAM,UAAU,GAAG,WAAW,CAAC,GAAG,CAAC,YAAY,CAAC,KAAK,KAAK,CAAC;QAC3D,MAAM,UAAU,GAAG,WAAW,CAAC,GAAG,CAAC,YAAY,CAAC,KAAK,KAAK,CAAC;QAC3D,IAAI,CAAC,UAAU,IAAI,CAAC,UAAU;YAAE,OAAO,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,WAAW,EAAE,sCAAsC,CAAC,CAAC,CAAC;QACvI,MAAM,cAAc,GAA4B,UAAU,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,UAAU,CAAC;QACrF,MAAM,YAAY,GAAG,cAAc,KAAK,UAAU,CAAC,CAAC,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC,CAAC,GAAG,CAAC,YAAY,CAAC;QACzF,MAAM,gBAAgB,GAAG,cAAc,KAAK,UAAU,CAAC,CAAC,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC,CAAC,GAAG,CAAC,YAAY,CAAC;QAC7F,MAAM,QAAQ,GAAG,OAAO,CAAC,CAAC,kBAAkB,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,kBAAkB,CAAC,IAAI,CAAC,CAAC,kBAAkB,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QAC1K,MAAM,MAAM,GAAG,OAAO,CAAC,CAAC,aAAa,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,aAAa,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QACpJ,IAAI,QAAQ,KAAK,IAAI,IAAI,MAAM,KAAK,IAAI;YAAE,OAAO,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,aAAa,EAAE,wDAAwD,CAAC,CAAC,CAAC;QACrK,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QACrC,MAAM,QAAQ,GAAqB;YACjC,UAAU,EAAE,aAAa,EAAE,EAAE,YAAY,EAAE,GAAG,CAAC,YAAY,EAAE,YAAY,EAAE,GAAG,CAAC,YAAY;YAC3F,GAAG,EAAE,MAAM,EAAE,eAAe,EAAE,GAAG,CAAC,eAAe,EAAE,cAAc;YACjE,YAAY,EAAE,aAAa,EAAE,KAAK,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,WAAW,CAAC,gBAAgB,CAAC;YACtG,eAAe,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE;YAC7G,YAAY,EAAE,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,YAAY,EAAE,GAAG,CAAC,YAAY,EAAE,YAAY,EAAE,CAAC,GAAG,CAAC,OAAO,EAAE,KAAK,IAAI,UAAU,CAAC,EAAE,QAAQ,EAAE,GAAG,CAAC,MAAM,CAAC,QAAQ,EAAE;YACjJ,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,GAAG,EAAE,UAAU,EAAE,IAAI;SACpD,CAAC;QACF,MAAM,WAAW,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;QACrC,MAAM,SAAS,GAAG,QAAQ,KAAK,IAAI,CAAC,CAAC,CAAC,WAAW,QAAQ,IAAI,GAAG,CAAC,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;QACjI,MAAM,OAAO,GAAG,MAAM,KAAK,IAAI,CAAC,CAAC,CAAC,gBAAgB,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAChE,MAAM,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,iBAAiB,EAAE,qCAAqC,EACnF,GAAG,KAAK,2CAA2C,GAAG,CAAC,eAAe,KAAK,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,QAAQ,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,iEAAiE,CAAC,CAAC;QACnP,OAAO,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,EAAE,QAAQ,EAAE,YAAY,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC;IAC5F,CAAC,CAAC,CAAC;IAEH,gGAAgG;IAChG,MAAM,CAAC,GAAG,CAAC,wBAAwB,EAAE,WAAW,EAAE,EAAE,KAAK,EAAE,GAAY,EAAE,GAAa,EAAE,EAAE;QACxF,MAAM,IAAI,GAAG,MAAM,qBAAqB,CAAC,OAAO,EAAE,GAAG,CAAC,IAAK,CAAC,KAAK,CAAC,CAAC;QACnE,OAAO,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,CAAC,GAAG,CAAC,YAAY,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;IACrG,CAAC,CAAC,CAAC;IAEH,8GAA8G;IAC9G,MAAM,CAAC,IAAI,CAAC,mCAAmC,EAAE,WAAW,EAAE,EAAE,KAAK,EAAE,GAAY,EAAE,GAAa,EAAE,EAAE;QACpG,MAAM,KAAK,GAAG,GAAG,CAAC,IAAK,CAAC,KAAK,CAAC;QAC9B,MAAM,CAAC,GAAG,MAAM,WAAW,CAAC,OAAO,EAAE,OAAO,GAAG,CAAC,MAAM,CAAC,EAAE,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QAC7F,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,KAAK,SAAS;YAAE,OAAO,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,WAAW,EAAE,0BAA0B,CAAC,CAAC,CAAC;QAC7H,IAAI,CAAC,CAAC,iBAAiB,KAAK,KAAK;YAAE,OAAO,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,WAAW,EAAE,gDAAgD,CAAC,CAAC,CAAC;QACpJ,MAAM,GAAG,GAAG,MAAM,qBAAqB,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;QACpD,IAAI,CAAC,GAAG;YAAE,OAAO,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,eAAe,EAAE,+BAA+B,CAAC,CAAC,CAAC;QAC9G,CAAC,CAAC,MAAM,GAAG,UAAU,CAAC;QAAC,CAAC,CAAC,UAAU,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QAAC,MAAM,WAAW,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;QAC9F,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,aAAa,EAAE,qCAAqC,EACxE,GAAG,KAAK,qCAAqC,CAAC,CAAC,eAAe,gFAAgF,CAAC,CAAC;QAClJ,OAAO,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,EAAE,QAAQ,EAAE,YAAY,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;IACrH,CAAC,CAAC,CAAC;IAEH,uFAAuF;IACvF,MAAM,CAAC,IAAI,CAAC,oCAAoC,EAAE,WAAW,EAAE,EAAE,KAAK,EAAE,GAAY,EAAE,GAAa,EAAE,EAAE;QACrG,MAAM,KAAK,GAAG,GAAG,CAAC,IAAK,CAAC,KAAK,CAAC;QAC9B,MAAM,CAAC,GAAG,MAAM,WAAW,CAAC,OAAO,EAAE,OAAO,GAAG,CAAC,MAAM,CAAC,EAAE,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QAC7F,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,KAAK,SAAS;YAAE,OAAO,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,WAAW,EAAE,0BAA0B,CAAC,CAAC,CAAC;QAC7H,IAAI,CAAC,CAAC,iBAAiB,KAAK,KAAK;YAAE,OAAO,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,WAAW,EAAE,iDAAiD,CAAC,CAAC,CAAC;QACrJ,CAAC,CAAC,MAAM,GAAG,UAAU,CAAC;QAAC,CAAC,CAAC,UAAU,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QAAC,MAAM,WAAW,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;QAC9F,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,aAAa,EAAE,qCAAqC,EAAE,GAAG,KAAK,qCAAqC,CAAC,CAAC,eAAe,8BAA8B,CAAC,CAAC;QAC1K,OAAO,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,EAAE,QAAQ,EAAE,YAAY,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IACzE,CAAC,CAAC,CAAC;IAEH,oGAAoG;IACpG,MAAM,CAAC,IAAI,CAAC,qCAAqC,EAAE,WAAW,EAAE,EAAE,KAAK,EAAE,GAAY,EAAE,GAAa,EAAE,EAAE;QACtG,MAAM,KAAK,GAAG,GAAG,CAAC,IAAK,CAAC,KAAK,CAAC;QAC9B,MAAM,CAAC,GAAG,MAAM,WAAW,CAAC,OAAO,EAAE,OAAO,GAAG,CAAC,MAAM,CAAC,EAAE,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QAC7F,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,KAAK,SAAS;YAAE,OAAO,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,WAAW,EAAE,0BAA0B,CAAC,CAAC,CAAC;QAC7H,IAAI,CAAC,CAAC,aAAa,KAAK,KAAK;YAAE,OAAO,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,WAAW,EAAE,gCAAgC,CAAC,CAAC,CAAC;QAChI,CAAC,CAAC,MAAM,GAAG,WAAW,CAAC;QAAC,CAAC,CAAC,UAAU,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QAAC,MAAM,WAAW,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;QAC/F,OAAO,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,EAAE,QAAQ,EAAE,YAAY,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IACzE,CAAC,CAAC,CAAC;IAEH,mHAAmH;IACnH,MAAM,CAAC,GAAG,CAAC,mCAAmC,EAAE,WAAW,EAAE,EAAE,KAAK,EAAE,GAAY,EAAE,GAAa,EAAE,EAAE;QACnG,MAAM,YAAY,GAAG,eAAe,CAAC,GAAG,CAAC,IAAK,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;QAC/D,MAAM,IAAI,GAAG,MAAM,gCAAgC,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC;QAC3E,OAAO,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,EAAE,OAAO,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,WAAW,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;IAClH,CAAC,CAAC,CAAC;IAEH,+GAA+G;IAC/G,MAAM,CAAC,GAAG,CAAC,+BAA+B,EAAE,WAAW,EAAE,EAAE,KAAK,EAAE,GAAY,EAAE,GAAa,EAAE,EAAE;QAC/F,MAAM,YAAY,GAAG,eAAe,CAAC,GAAG,CAAC,IAAK,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;QAC/D,MAAM,IAAI,GAAG,MAAM,gCAAgC,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC;QAC3E,OAAO,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,EAAE,OAAO,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,WAAW,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;IAClH,CAAC,CAAC,CAAC;IAEH,gFAAgF;IAChF,SAAS,QAAQ,CAAC,CAAY;QAC5B,OAAO;YACL,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,WAAW,EAAE,CAAC,CAAC,UAAU,EAAE,QAAQ,EAAE,CAAC,CAAC,YAAY,EAAE,QAAQ,EAAE,CAAC,CAAC,YAAY;YAChG,KAAK,EAAE,CAAC,CAAC,SAAS,EAAE,SAAS,EAAE,CAAC,CAAC,QAAQ,EAAE,GAAG,EAAE,CAAC,CAAC,GAAG,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM;YACzG,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC,QAAQ,EAAE,aAAa,EAAE,CAAC,CAAC,YAAY;YAC/F,UAAU,EAAE,CAAC,CAAC,SAAS,EAAE,YAAY,EAAE,CAAC,CAAC,WAAW;SACrD,CAAC;IACJ,CAAC;IAED;;;;OAIG;IACH,MAAM,CAAC,IAAI,CAAC,mBAAmB,EAAE,WAAW,EAAE,EAAE,KAAK,EAAE,GAAY,EAAE,GAAa,EAAE,EAAE;QACpF,MAAM,YAAY,GAAG,eAAe,CAAC,GAAG,CAAC,IAAK,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;QAC/D,MAAM,KAAK,GAAG,GAAG,CAAC,IAAK,CAAC,KAAK,CAAC;QAC9B,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,IAAI,EAAE,CAA4B,CAAC;QACtD,MAAM,UAAU,GAAG,OAAO,CAAC,CAAC,WAAW,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,CAAC;QAC1E,IAAI,CAAC,UAAU;YAAE,OAAO,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,aAAa,EAAE,yBAAyB,CAAC,CAAC,CAAC;QAC7G,MAAM,CAAC,GAAG,MAAM,WAAW,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;QACjD,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,KAAK,QAAQ,IAAI,CAAC,CAAC,IAAI,KAAK,YAAY,IAAI,CAAC,CAAC,CAAC,OAAO,IAAI,CAAC,CAAC,OAAO,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;YAC3G,OAAO,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,WAAW,EAAE,oCAAoC,CAAC,CAAC,CAAC;QACvG,CAAC;QACD,MAAM,GAAG,GAAG,MAAM,sBAAsB,CAAC,OAAO,EAAE,YAAY,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC;QACjF,IAAI,CAAC,GAAG,IAAI,GAAG,CAAC,KAAK,KAAK,QAAQ,EAAE,CAAC;YACnC,OAAO,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,aAAa,EAAE,uEAAuE,CAAC,CAAC,CAAC;QAC5I,CAAC;QACD,MAAM,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC;QACpB,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QACrC,MAAM,IAAI,GAAc;YACtB,MAAM,EAAE,SAAS,EAAE,EAAE,UAAU,EAAE,YAAY,EAAE,aAAa,EAAE,KAAK;YACnE,YAAY,EAAE,CAAC,CAAC,YAAY,EAAE,aAAa,EAAE,CAAC,CAAC,aAAa;YAC5D,SAAS,EAAE,GAAG,CAAC,CAAC,SAAS,IAAI,CAAC,CAAC,aAAa,IAAI,MAAM,CAAC,MAAM,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC,QAAQ;YACrF,GAAG,EAAE,CAAC,CAAC,GAAG,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,IAAI,EAAE,EAAE,MAAM,EAAE,IAAI;YAChE,IAAI,EAAE,OAAO,CAAC,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE;YAC7D,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,QAAQ,EAAE,GAAG,CAAC,QAAQ,EAAE,YAAY,EAAE,CAAC,EAAE,SAAS,EAAE,GAAG,EAAE,WAAW,EAAE,IAAI;SAC1G,CAAC;QACF,MAAM,OAAO,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;QAC7B,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,aAAa,EAAE,mCAAmC,EACtE,GAAG,KAAK,eAAe,CAAC,CAAC,QAAQ,yBAAyB,CAAC,CAAC,SAAS,UAAU,IAAI,CAAC,MAAM,gDAAgD,CAAC,CAAC;QAC9I,OAAO,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;IAChF,CAAC,CAAC,CAAC;IAEH;;;;OAIG;IACH,MAAM,CAAC,IAAI,CAAC,+BAA+B,EAAE,WAAW,EAAE,EAAE,KAAK,EAAE,GAAY,EAAE,GAAa,EAAE,EAAE;QAChG,MAAM,KAAK,GAAG,GAAG,CAAC,IAAK,CAAC,KAAK,CAAC;QAC9B,MAAM,CAAC,GAAG,MAAM,OAAO,CAAC,OAAO,EAAE,OAAO,GAAG,CAAC,MAAM,CAAC,EAAE,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QACzF,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,aAAa,KAAK,KAAK;YAAE,OAAO,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,WAAW,EAAE,kCAAkC,CAAC,CAAC,CAAC;QACxI,IAAI,CAAC,CAAC,KAAK,KAAK,MAAM;YAAE,OAAO,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,eAAe,EAAE,WAAW,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;QACjH,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,IAAI,EAAE,CAA4B,CAAC;QACtD,2GAA2G;QAC3G,MAAM,MAAM,GAAG,MAAM,sBAAsB,CAAC,OAAO,EAAE,CAAC,CAAC,YAAY,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC;QACtF,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC,KAAK,KAAK,QAAQ,EAAE,CAAC;YACzC,OAAO,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,mBAAmB,EAAE,yEAAyE,CAAC,CAAC,CAAC;QACpJ,CAAC;QACD,MAAM,OAAO,GAAG,MAAM,uBAAuB,CAAC;YAC5C,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,CAAC,GAAG,EAAE,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,KAAK,EAAE,GAAG,CAAC,CAAC,SAAS,IAAI,CAAC,CAAC,QAAQ,EAAE;YAC9F,UAAU,EAAE,CAAC,CAAC,YAAY,EAAE,GAAG;SAChC,CAAC,CAAC;QACH,IAAI,CAAC,OAAO;YAAE,OAAO,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,aAAa,EAAE,sCAAsC,CAAC,CAAC,CAAC;QACvH,IAAI,CAAC,OAAO,CAAC,EAAE;YAAE,OAAO,CAAC,uDAAuD;QAChF,MAAM,KAAK,GAAG,MAAM,sBAAsB,CAAC,OAAO,EAAE,CAAC,CAAC,YAAY,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC;QACrF,MAAM,OAAO,GAAG,KAAK,IAAI,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,UAAU,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAC1G,CAAC,CAAC,KAAK,GAAG,WAAW,CAAC;QAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,MAAM,IAAI,IAAI,CAAC;QAAC,CAAC,CAAC,YAAY,GAAG,OAAO,CAAC;QAAC,CAAC,CAAC,WAAW,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QACvH,IAAI,OAAO,CAAC,CAAC,IAAI,KAAK,QAAQ,IAAI,CAAC,CAAC,IAAI;YAAE,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;QACzE,MAAM,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;QAC1B,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,aAAa,EAAE,0CAA0C,EAC7E,SAAS,CAAC,CAAC,QAAQ,gBAAgB,CAAC,CAAC,MAAM,sBAAsB,KAAK,4DAA4D,CAAC,CAAC;QACtI,OAAO,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IACjE,CAAC,CAAC,CAAC;IAEH,8GAA8G;IAC9G,MAAM,CAAC,GAAG,CAAC,mBAAmB,EAAE,WAAW,EAAE,EAAE,KAAK,EAAE,GAAY,EAAE,GAAa,EAAE,EAAE;QACnF,MAAM,KAAK,GAAG,GAAG,CAAC,IAAK,CAAC,KAAK,CAAC;QAC9B,MAAM,IAAI,GAAG,GAAG,CAAC,KAAK,CAAC,IAAI,KAAK,UAAU,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,UAAU,CAAC;QACrE,MAAM,KAAK,GAAG,IAAI,KAAK,UAAU,CAAC,CAAC,CAAC,MAAM,kBAAkB,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,kBAAkB,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;QACxH,OAAO,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IACpG,CAAC,CAAC,CAAC;IAEH,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/src/routes/extensions/actions.d.ts

@@ -6,6 +6,9 @@
  *   satisfy max-file-lines.
  * @version-history
  *   v1.0.0 — 2026-07-13 — Extracted from src/routes/extensions.ts (max-file-lines)
+ *   v1.1.0 — 2026-07-16 — ctx.memory.getPublic owner-agent fallback batches into one listMemoryForOwners
+ *   v1.2.0 — 2026-07-17 — Per-call paywall (enforcePaywall) before execute in both handlers +
+ *     refund-on-throw wrap (priced raw calls; design notes doc-r6tyr3o)
  */
 import { Router } from 'express';
 import type { AimeatConfig } from '../../config.js';

package/dist/src/routes/extensions/actions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"actions.d.ts","sourceRoot":"","sources":["../../../../src/routes/extensions/actions.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAEjC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,4BAA4B,CAAC;AAa1D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAE5D,wBAAgB,6BAA6B,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,OAAO,EAAE,OAAO,EAAE,YAAY,CAAC,EAAE,YAAY,GAAG,IAAI,CA6gBvI"}
+{"version":3,"file":"actions.d.ts","sourceRoot":"","sources":["../../../../src/routes/extensions/actions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAEjC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,4BAA4B,CAAC;AAc1D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAE5D,wBAAgB,6BAA6B,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,OAAO,EAAE,OAAO,EAAE,YAAY,CAAC,EAAE,YAAY,GAAG,IAAI,CAyiBvI"}

package/dist/src/routes/extensions/actions.js

@@ -6,6 +6,7 @@ import { notify } from '../../services/notify.js';
 import { executeExtensionAction } from '../../services/extension-runtime.js';
 import { logger } from '../../utils/logger.js';
 import { resolveIdentity } from '../../utils/gaii.js';
+import { enforcePaywall } from './paywall.js';
 import { safeFetch } from '../../utils/url-validator.js';
 import { enforceExtensionMemoryLimits } from '../../services/quota.js';
 import { getEncryptionKey } from '../../services/encryption.js';
@@ -51,6 +52,10 @@ export function registerExtensionActionRoutes(router, config, storage, emailServ
                 res.status(405).json(error(config.nodeId, 'METHOD_NOT_ALLOWED', `Action "${actionId}" requires ${action.method}, got ${req.method}`));
                 return;
             }
+            // Per-call paywall: owner-free / anti-abuse toll / priced payment (design: paywall.ts).
+            const pay = await enforcePaywall({ config, storage, ext, action, callerGaii, res, payToken: req.header('x-aimeat-pay-token') ?? undefined });
+            if (!pay.ok)
+                return;
             // Build the ExtensionCtx with instance-scoped memory namespace
             // Extension namespace is always ext:{name}.{instanceId} — no owner scoping,
             // because ext:{name} is already unique and owner-scoping breaks client reads
@@ -90,10 +95,16 @@ export function registerExtensionActionRoutes(router, config, storage, emailServ
                         // resolve to the owner's default agent GAII and retry
                         if (!record && !namespace.includes('@') && !namespace.includes('#') && !namespace.startsWith('ext:')) {
                             const agents = await storage.getAgentsByOwner(namespace);
+                            // One IN query for `key` across the owner's agents (was getMemory per agent). Pick the
+                            // first agent (original order) that has the key — visibility is checked after.
+                            const rows = await storage.listMemoryForOwners(agents.map(a => a.gaii), { prefix: key });
+                            const byGaii = new Map(rows.filter(r => r.key === key).map(r => [r.ownerGaii, r]));
                             for (const agent of agents) {
-                                record = await storage.getMemory(agent.gaii, key);
-                                if (record)
+                                const r = byGaii.get(agent.gaii);
+                                if (r) {
+                                    record = r;
                                     break;
+                                }
                             }
                         }
                         return (record && record.visibility === 'public') ? record.value : null;
@@ -250,7 +261,15 @@ export function registerExtensionActionRoutes(router, config, storage, emailServ
                 timeoutMs: Math.min(Math.max(ext.limits.timeoutMs, 1000), config.extensionTimeoutMs),
                 maxApiCalls: Math.min(Math.max(ext.limits.maxApiCalls, 10), config.extensionMaxApiCalls),
             };
-            const result = await executeExtensionAction(action.scriptContent, ctx, req.body, limits);
+            let result;
+            try {
+                result = await executeExtensionAction(action.scriptContent, ctx, req.body, limits);
+            }
+            catch (execErr) {
+                if (pay.refund)
+                    await pay.refund(); // never keep payment for a call that didn't deliver
+                throw execErr;
+            }
             res.json(success(config.nodeId, result, [
                 { description: 'View extension', method: 'GET', url: `/v1/extensions/${extName}` },
             ]));
@@ -298,6 +317,10 @@ export function registerExtensionActionRoutes(router, config, storage, emailServ
                 res.status(405).json(error(config.nodeId, 'METHOD_NOT_ALLOWED', `Action "${actionId}" requires ${action.method}, got ${req.method}`));
                 return;
             }
+            // Per-call paywall: owner-free / anti-abuse toll / priced payment (design: paywall.ts).
+            const pay = await enforcePaywall({ config, storage, ext, action, callerGaii, res, payToken: req.header('x-aimeat-pay-token') ?? undefined });
+            if (!pay.ok)
+                return;
             // Build the ExtensionCtx
             // Extension memory uses a flat namespace (ext:{name}) so apps can
             // read data via getPublic('ext:{name}', key) without knowing the owner.
@@ -337,10 +360,16 @@ export function registerExtensionActionRoutes(router, config, storage, emailServ
                         // resolve to the owner's default agent GAII and retry
                         if (!record && !namespace.includes('@') && !namespace.includes('#') && !namespace.startsWith('ext:')) {
                             const agents = await storage.getAgentsByOwner(namespace);
+                            // One IN query for `key` across the owner's agents (was getMemory per agent). Pick the
+                            // first agent (original order) that has the key — visibility is checked after.
+                            const rows = await storage.listMemoryForOwners(agents.map(a => a.gaii), { prefix: key });
+                            const byGaii = new Map(rows.filter(r => r.key === key).map(r => [r.ownerGaii, r]));
                             for (const agent of agents) {
-                                record = await storage.getMemory(agent.gaii, key);
-                                if (record)
+                                const r = byGaii.get(agent.gaii);
+                                if (r) {
+                                    record = r;
                                     break;
+                                }
                             }
                         }
                         return (record && record.visibility === 'public') ? record.value : null;
@@ -500,7 +529,15 @@ export function registerExtensionActionRoutes(router, config, storage, emailServ
                 timeoutMs: Math.min(Math.max(ext.limits.timeoutMs, 1000), config.extensionTimeoutMs),
                 maxApiCalls: Math.min(Math.max(ext.limits.maxApiCalls, 10), config.extensionMaxApiCalls),
             };
-            const result = await executeExtensionAction(action.scriptContent, ctx, req.body, limits);
+            let result;
+            try {
+                result = await executeExtensionAction(action.scriptContent, ctx, req.body, limits);
+            }
+            catch (execErr) {
+                if (pay.refund)
+                    await pay.refund(); // never keep payment for a call that didn't deliver
+                throw execErr;
+            }
             res.json(success(config.nodeId, result, [
                 { description: 'View extension', method: 'GET', url: `/v1/extensions/${extName}` },
             ]));