aimeat 2.0.0 → 2.2.0

package/dist/src/mcp/exchange-run.js

@@ -0,0 +1,226 @@
+import { z } from 'zod';
+import { parseGaiiLoose } from '../utils/gaii.js';
+import { annotationsFor } from './annotations.js';
+import { descriptionFor } from './catalog/shape.js';
+import { readEntitlementForCall } from '../services/metered-entitlements.js';
+import { getOffering } from '../services/exchange-market.js';
+import { newWorkId, putWork, getWork, listWorkByConsumer, listWorkByProvider, } from '../services/exchange-work.js';
+import { getProposal, listProposalsForOwner, supersedeWithProposal, putProposal, } from '../services/exchange-proposals.js';
+import { settleMeteredCoordinate } from '../routes/extensions/entitlement-gate.js';
+import { appToolsKey, AppToolsDocSchema } from '../models/app-tool-schemas.js';
+import { getInterfaceVersion } from '../services/app-tool-interfaces.js';
+import { sendDirectMessage } from '../services/message-send.js';
+/** A capture-only mock Express Response: settleMeteredCoordinate writes its 402/429/500 body here on
+ *  failure (it only ever calls res.status(code).json(body)); success never touches res. */
+function captureRes() {
+    let cap = null;
+    const res = {
+        status(status) {
+            return { json(body) { cap = { status, body }; return res; } };
+        },
+    };
+    return { res, taken: () => cap };
+}
+/** Pull a human message out of a captured error envelope. */
+function capMessage(cap, fallback) {
+    const b = cap?.body;
+    return b?.error?.message ? `${b.error.code ?? 'ERROR'}: ${b.error.message}` : fallback;
+}
+export function registerExchangeRunTools(mcp, storage, config, getAgentGaii, getToken) {
+    const agentGaii = getAgentGaii();
+    const owner = parseGaiiLoose(agentGaii).owner;
+    const callerGaii = agentGaii;
+    const ok = (data) => ({ content: [{ type: 'text', text: JSON.stringify(data, null, 2) }] });
+    const fail = (msg) => ({ content: [{ type: 'text', text: msg }], isError: true });
+    const gh = (o) => `${o}@${config.nodeId}`;
+    async function notify(recipientOwner, subject, body) {
+        try {
+            await sendDirectMessage({ config, storage, peers: new Map() }, {
+                senderGhii: gh(owner), recipientGhii: gh(recipientOwner), body, subject, respondable: false, skipContactGate: true,
+            });
+        }
+        catch { /* notification failure must never fail the action */ }
+    }
+    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,
+        };
+    }
+    // ── aimeat_app_tool_invoke — call an app's offered tool through your metered contract ──────────────
+    mcp.tool('aimeat_app_tool_invoke', descriptionFor('aimeat_app_tool_invoke'), {
+        owner: z.string().min(1).max(120),
+        app: z.string().min(1).max(120),
+        tool: z.string().min(1).max(120),
+        input: z.record(z.string(), z.unknown()).optional(),
+    }, annotationsFor('aimeat_app_tool_invoke'), async ({ owner: appOwner, app, tool, input }) => {
+        const ownerName = appOwner.split('@')[0];
+        const manifestRec = await storage.getMemory(`${ownerName}@${config.nodeId}`, appToolsKey(app));
+        if (!manifestRec)
+            return fail(`APP_TOOLS_NOT_FOUND: app "${ownerName}/${app}" declares no tool manifest`);
+        const parsed = AppToolsDocSchema.safeParse(manifestRec.value);
+        if (!parsed.success)
+            return fail(`INVALID_TOOL_MANIFEST: app "${ownerName}/${app}" tool manifest is malformed`);
+        const toolDef = parsed.data.tools.find(t => t.name === tool);
+        if (!toolDef)
+            return fail(`TOOL_NOT_FOUND: no tool "${tool}" on app "${ownerName}/${app}"`);
+        const coordExt = `apptool:${ownerName}/${app}`;
+        const ent = await readEntitlementForCall(storage, callerGaii, coordExt, tool);
+        if (!ent)
+            return fail(`NO_CONTRACT: accept a contract for "${ownerName}/${app}/${tool}" first (aimeat_exchange_accept with its offering_id)`);
+        // Resolve the binding from the PINNED interface snapshot (the freeze), else the tool's current binding.
+        const pinnedVersion = ent.surface && ent.surface.kind === 'app-tool' ? ent.surface.ifaceVersion : undefined;
+        const iface = pinnedVersion ? await getInterfaceVersion(storage, ent.providerGhii, app, tool, pinnedVersion) : null;
+        const binding = iface?.binding ?? toolDef.action_id ?? null;
+        if (!binding)
+            return fail('TOOL_NOT_INVOKABLE: this tool has no capability binding to invoke');
+        const cap = await storage.getCapability(binding);
+        if (!cap)
+            return fail(`CAPABILITY_NOT_FOUND: backing capability not found (${binding})`);
+        // Settle the metered call (budget + rake) through the SAME gateway as the REST WebMCP path.
+        const { res, taken } = captureRes();
+        const outcome = await settleMeteredCoordinate({
+            config, storage, coordExt, coordAction: tool,
+            label: `${app}/${tool}${pinnedVersion ? ` v${pinnedVersion}` : ''}`, callerGaii, res,
+        });
+        if (!outcome)
+            return fail('NO_CONTRACT: no active contract to settle against');
+        if (!outcome.ok)
+            return fail(capMessage(taken(), 'PAYMENT_REQUIRED: the metered call could not settle'));
+        // Settled → invoke; refund on throw (never leave a phantom charge).
+        try {
+            const { invokeCapability } = await import('../services/capability-invoke.js');
+            const invoked = await invokeCapability(config, storage, cap, (input ?? {}), callerGaii, getToken() ?? '', 'normal');
+            return ok({ app: `${ownerName}/${app}`, tool, iface_version: pinnedVersion ?? null, metered: true, result: invoked.result });
+        }
+        catch (err) {
+            if (outcome.refund)
+                await outcome.refund();
+            const e = err;
+            return fail(`${e.code ?? 'TOOL_INVOKE_FAILED'}: ${e.message ?? 'tool invocation failed (you were refunded)'}`);
+        }
+    });
+    // ── aimeat_exchange_work — start a task under an agent-work contract (consumer) ────────────────────
+    mcp.tool('aimeat_exchange_work', descriptionFor('aimeat_exchange_work'), {
+        offering_id: z.string().min(1).max(120),
+        input: z.record(z.string(), z.unknown()).optional(),
+        note: z.string().max(2000).optional(),
+    }, annotationsFor('aimeat_exchange_work'), async ({ offering_id, input, note }) => {
+        const o = await getOffering(storage, offering_id);
+        if (!o || o.state !== 'listed' || o.kind !== 'agent-work' || !o.surface || o.surface.kind !== 'agent-work') {
+            return fail('NOT_FOUND: no such listed agent-work offering');
+        }
+        const ent = await readEntitlementForCall(storage, callerGaii, o.ext, o.action);
+        if (!ent || ent.state !== 'active') {
+            return fail('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: offering_id, consumerGaii: callerGaii, 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: input ?? {}, output: null,
+            note: note ?? '', state: 'open', unit: ent.unit, currency: ent.currency,
+            chargedUnits: 0, createdAt: now, deliveredAt: null,
+        };
+        await putWork(storage, work);
+        await notify(o.providerOwner, 'EXCHANGE — new agent work started', `${owner} started a "${s.taskType}" task for your agent ${s.agentName} (work ${work.workId}). Deliver it to get paid.`);
+        return ok({ work: workView(work) });
+    });
+    // ── aimeat_exchange_work_deliver — provider delivers → settle on delivery ──────────────────────────
+    mcp.tool('aimeat_exchange_work_deliver', descriptionFor('aimeat_exchange_work_deliver'), {
+        work_id: z.string().min(1).max(120),
+        output: z.unknown().optional(),
+        note: z.string().max(2000).optional(),
+    }, annotationsFor('aimeat_exchange_work_deliver'), async ({ work_id, output, note }) => {
+        const w = await getWork(storage, work_id);
+        if (!w || w.providerOwner !== owner)
+            return fail('NOT_FOUND: no such work of yours to deliver');
+        if (w.state !== 'open')
+            return fail(`WORK_NOT_OPEN: work is ${w.state}`);
+        const before = await readEntitlementForCall(storage, w.consumerGaii, w.ext, w.action);
+        if (!before || before.state !== 'active')
+            return fail('CONTRACT_INACTIVE: the consumer contract is no longer active — cannot settle this delivery');
+        const { res, taken } = captureRes();
+        const outcome = await settleMeteredCoordinate({
+            config, storage, coordExt: w.ext, coordAction: w.action, label: `${w.agentGaii}:${w.taskType}`,
+            callerGaii: w.consumerGaii, res,
+        });
+        if (!outcome)
+            return fail('NO_CONTRACT: no active contract to settle against');
+        if (!outcome.ok)
+            return fail(capMessage(taken(), 'PAYMENT_REQUIRED: delivery could not settle (budget/rate)'));
+        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 = output ?? null;
+        w.chargedUnits = charged;
+        w.deliveredAt = new Date().toISOString();
+        if (note)
+            w.note = note.slice(0, 2000);
+        await putWork(storage, w);
+        await notify(w.consumerOwner, 'EXCHANGE — your agent work was delivered', `Your "${w.taskType}" task (work ${w.workId}) was delivered by ${owner} and charged to your contract.`);
+        return ok({ work: workView(w) });
+    });
+    // ── aimeat_exchange_work_list — your agent-work items (consumer default, or provider) ──────────────
+    mcp.tool('aimeat_exchange_work_list', descriptionFor('aimeat_exchange_work_list'), {
+        role: z.enum(['consumer', 'provider']).optional(),
+    }, annotationsFor('aimeat_exchange_work_list'), async ({ role }) => {
+        const items = role === 'provider' ? await listWorkByProvider(storage, owner) : await listWorkByConsumer(storage, owner);
+        return ok({ work: items.map(workView), count: items.length, role: role ?? 'consumer' });
+    });
+    // ── aimeat_exchange_proposals — renegotiation proposals you are party to ───────────────────────────
+    mcp.tool('aimeat_exchange_proposals', descriptionFor('aimeat_exchange_proposals'), {}, annotationsFor('aimeat_exchange_proposals'), async () => {
+        const list = await listProposalsForOwner(storage, owner);
+        const view = list.map(p => ({
+            proposal_id: p.proposalId, capability: p.capabilityLabel, ext: p.ext, action: p.action,
+            consumer_gaii: p.consumerGaii, provider: p.providerGhii,
+            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,
+        }));
+        return ok({ proposals: view, count: view.length });
+    });
+    // ── aimeat_exchange_proposal_decide — accept (supersede) / decline / withdraw a proposal ───────────
+    mcp.tool('aimeat_exchange_proposal_decide', descriptionFor('aimeat_exchange_proposal_decide'), {
+        proposal_id: z.string().min(1).max(120),
+        decision: z.enum(['accept', 'decline', 'withdraw']),
+    }, annotationsFor('aimeat_exchange_proposal_decide'), async ({ proposal_id, decision }) => {
+        const p = await getProposal(storage, proposal_id);
+        if (!p || p.status !== 'pending')
+            return fail('NOT_FOUND: no such pending proposal');
+        if (decision === 'withdraw') {
+            if (p.proposerOwner !== owner)
+                return fail('FORBIDDEN: only the proposer may withdraw');
+            p.status = 'withdrawn';
+            p.resolvedAt = new Date().toISOString();
+            await putProposal(storage, p);
+            return ok({ proposal_id: p.proposalId, status: p.status });
+        }
+        // accept / decline are the COUNTERPARTY's calls.
+        if (p.counterpartyOwner !== owner)
+            return fail(`FORBIDDEN: only the counterparty (${p.counterpartyOwner}) may ${decision} this proposal`);
+        if (decision === 'decline') {
+            p.status = 'declined';
+            p.resolvedAt = new Date().toISOString();
+            await putProposal(storage, p);
+            await notify(p.proposerOwner, 'EXCHANGE — contract change declined', `${owner} declined your proposed change to ${p.capabilityLabel}. The contract is unchanged.`);
+            return ok({ proposal_id: p.proposalId, status: p.status });
+        }
+        const ent = await supersedeWithProposal(storage, p);
+        if (!ent)
+            return fail('CONTRACT_GONE: the contract no longer exists');
+        p.status = 'accepted';
+        p.resolvedAt = new Date().toISOString();
+        await putProposal(storage, p);
+        await notify(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 ok({
+            proposal_id: p.proposalId, status: p.status,
+            entitlement: { ext: ent.ext, action: ent.action, price_per_call: ent.pricePerCall, unit: ent.unit, state: ent.state, cap_units: ent.budget.capUnits },
+        });
+    });
+}
+//# sourceMappingURL=exchange-run.js.map

package/dist/src/mcp/exchange-run.js.map

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

package/dist/src/mcp/exchange.d.ts

@@ -0,0 +1,5 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { AimeatConfig } from '../config.js';
+import type { Storage } from '../storage/interface.js';
+export declare function registerExchangeTools(mcp: McpServer, storage: Storage, config: AimeatConfig, getAgentGaii: () => string): void;
+//# sourceMappingURL=exchange.d.ts.map

package/dist/src/mcp/exchange.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"exchange.d.ts","sourceRoot":"","sources":["../../../src/mcp/exchange.ts"],"names":[],"mappings":"AAyBA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AAoEvD,wBAAgB,qBAAqB,CACjC,GAAG,EAAE,SAAS,EACd,OAAO,EAAE,OAAO,EAChB,MAAM,EAAE,YAAY,EACpB,YAAY,EAAE,MAAM,MAAM,GAC3B,IAAI,CAoUN"}

package/dist/src/mcp/exchange.js

@@ -0,0 +1,352 @@
+/**
+ * @file src/mcp/exchange.ts
+ * @description MCP EXCHANGE marketplace tools (TARGET-045 over MCP): the agent-facing surface for the
+ *   two-sided data-service market. Consumer side — browse OFFERINGs, read one in full (I/O schema +
+ *   call-recipe + stats), ACCEPT a contract (mint a metered entitlement for the CALLER), list the
+ *   caller's own contracts, pause/revoke one, post + browse NEEDs, and accept a bid. Provider side —
+ *   bid on a need with an action the caller's extension owns, and see who holds contracts against an
+ *   offering. Every tool mirrors the REST handlers in src/routes/exchange.ts + exchange-market.ts,
+ *   calling the SAME services (exchange-market.ts, metered-entitlements.ts) — no new business logic.
+ *   Pricing is ALWAYS authoritative from the provider action (resolveActionPricing), so a consumer can
+ *   never undercut the provider. The consumer/requester identity is the caller's resolved GAII (never
+ *   from input). Scope gates (exchange:read / exchange:write) are enforced by the per-session
+ *   registration filter (catalog/scopes.ts) — stricter than the requireAuth-only REST routes on purpose.
+ * @structure registerExchangeTools() — registers 10 tools on an McpServer instance
+ * @usage
+ *   import { registerExchangeTools } from './exchange.js';
+ *   registerExchangeTools(mcp, storage, config, () => agentGaii);
+ * @version-history
+ *   v1.2.0 — 2026-07-21 — need_post carries usage_intent; needs listings enriched with the requesting app's
+ *     name/description (enrichNeeds) so a provider can judge who they'd serve.
+ *   v1.1.0 — 2026-07-21 — accept by `offering_id` (ext-action AND app-tool kinds, via resolveOfferingPricing);
+ *     offering_get surfaces the pinned app-tool interface schema + WebMCP call recipe (Gap 1 cross-app selling).
+ *   v1.0.0 — 2026-07-20 — Initial EXCHANGE MCP surface (offerings/accept/contracts/off/needs/bid/consumers)
+ */
+import { randomUUID } from 'node:crypto';
+import { z } from 'zod';
+import { parseGaiiLoose } from '../utils/gaii.js';
+import { annotationsFor } from './annotations.js';
+import { descriptionFor } from './catalog/shape.js';
+import { commerceFeePercent } from '../services/marketplace-fee.js';
+import { percentFee } from '../commerce/money.js';
+import { createEntitlement, readEntitlementForCall, listEntitlementsByConsumer, pauseEntitlement, revokeEntitlement, } from '../services/metered-entitlements.js';
+import { resolveActionPricing, resolveOfferingPricing, newNeedId, newBidId, getOffering, listOfferings, matchOfferings, putNeed, getNeed, listNeeds, putBid, getBid, offeringStats, offeringConsumers, enrichNeeds, } from '../services/exchange-market.js';
+import { getInterfaceVersion } from '../services/app-tool-interfaces.js';
+function ownerOf(gaii) {
+    return gaii.split('@')[0].split('#').pop() ?? gaii;
+}
+/** Shape a metered entitlement for the consumer-facing view (mirrors src/routes/exchange.ts `view`). */
+function entitlementView(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,
+        },
+    };
+}
+/** Parse a need's minimum-spec from a loose input object (mirrors exchange-market.ts route parseNeedSpec). */
+function parseNeedSpec(v) {
+    if (!v || typeof v !== 'object')
+        return null;
+    const o = v;
+    const isObj = (x) => !!x && typeof x === 'object' && !Array.isArray(x);
+    const requiredFields = Array.isArray(o.requiredFields) ? o.requiredFields.filter(f => typeof f === 'string') : [];
+    const spec = { requiredFields };
+    if (typeof o.format === 'string')
+        spec.format = o.format;
+    if (typeof o.sample === 'string')
+        spec.sample = o.sample;
+    if (typeof o.notes === 'string')
+        spec.notes = o.notes;
+    if (isObj(o.inputSchema))
+        spec.inputSchema = o.inputSchema;
+    if (isObj(o.outputSchema))
+        spec.outputSchema = o.outputSchema;
+    return (requiredFields.length || spec.format || spec.sample || spec.notes || spec.inputSchema || spec.outputSchema) ? spec : null;
+}
+export function registerExchangeTools(mcp, storage, config, getAgentGaii) {
+    const agentGaii = getAgentGaii();
+    const owner = parseGaiiLoose(agentGaii).owner;
+    // The consumer/requester identity is the CALLER's own resolved GAII (never from input), so a caller
+    // can only accept/post/off/bid on their own behalf — the same guarantee resolveIdentity gives REST.
+    const consumerGaii = agentGaii;
+    const ok = (data) => ({ content: [{ type: 'text', text: JSON.stringify(data, null, 2) }] });
+    const fail = (msg) => ({ content: [{ type: 'text', text: msg }], isError: true });
+    // ── Browse offerings (supply) ──────────────────────────────────────────────
+    mcp.tool('aimeat_exchange_offerings', descriptionFor('aimeat_exchange_offerings'), {
+        q: z.string().max(400).optional(),
+        ext: z.string().max(120).optional(),
+        action: z.string().max(120).optional(),
+        stats: z.boolean().optional(),
+    }, annotationsFor('aimeat_exchange_offerings'), async ({ q, ext, action, stats }) => {
+        const offerings = (ext && action) || q
+            ? await matchOfferings(storage, { ext: ext || null, action: action || null, text: q || null })
+            : await listOfferings(storage);
+        if (stats) {
+            const withStats = await Promise.all(offerings.map(async (o) => ({ ...o, stats: await offeringStats(storage, o) })));
+            return ok({ offerings: withStats, count: withStats.length });
+        }
+        return ok({ offerings, count: offerings.length });
+    });
+    // ── One offering in full (detail + I/O schema + call-recipe + stats) ────────
+    mcp.tool('aimeat_exchange_offering_get', descriptionFor('aimeat_exchange_offering_get'), {
+        offering_id: z.string().min(1).max(120),
+    }, annotationsFor('aimeat_exchange_offering_get'), async ({ offering_id }) => {
+        const o = await getOffering(storage, offering_id);
+        if (!o)
+            return fail(`NOT_FOUND: no such offering "${offering_id}"`);
+        const stats = await offeringStats(storage, o);
+        if (o.kind === 'app-tool' && o.surface && o.surface.kind === 'app-tool') {
+            const s = o.surface;
+            const iface = await getInterfaceVersion(storage, o.providerGhii, s.appId, s.tool, s.ifaceVersion);
+            return ok({
+                offering: o,
+                capability: iface ? {
+                    kind: 'app-tool', app: `${s.ownerName}/${s.appId}`, tool: s.tool, iface_version: s.ifaceVersion,
+                    input_schema: iface.inputSchema, output_schema: iface.outputSchema,
+                } : null,
+                call_recipe: {
+                    method: 'POST',
+                    url: `/v1/apps/${encodeURIComponent(s.ownerName)}/${encodeURIComponent(s.appId)}/webmcp/tools/${encodeURIComponent(s.tool)}`,
+                    auth: 'Your own AIMEAT token — the accepted contract (metered entitlement) authorises the call; no separate API key is issued.',
+                    note: `Metered + charged to your budget. Pinned to interface v${s.ifaceVersion}; the provider may ship newer app versions without breaking your integration.`,
+                    body: '{ "input": { … } }',
+                },
+                stats,
+            });
+        }
+        const extRec = await storage.getExtension(o.ext);
+        const act = extRec?.actions.find(a => a.id === o.action);
+        return ok({
+            offering: o,
+            capability: act ? {
+                input_schema: act.inputSchema ?? {},
+                output_schema: act.outputSchema ?? {},
+                toll_morsels: act.tollMorsels ?? 0,
+            } : null,
+            call_recipe: {
+                method: 'POST',
+                url: `/v1/ext/${o.ext}/${o.action}`,
+                auth: 'Your own AIMEAT token — the accepted contract (metered entitlement) authorises the call; no separate API key is issued.',
+                note: 'Each call is metered + charged to your budget at the provider price; the provider’s own upstream keys stay server-side.',
+                mcp: `aimeat_extension_invoke { "name": "${o.ext}", "action": "${o.action}", "input": { … } }`,
+            },
+            stats,
+        });
+    });
+    // ── Accept a contract → mint a metered entitlement for the caller ───────────
+    mcp.tool('aimeat_exchange_accept', descriptionFor('aimeat_exchange_accept'), {
+        offering_id: z.string().min(1).max(120).optional(),
+        ext: z.string().min(1).max(120).optional(),
+        action: z.string().min(1).max(120).optional(),
+        contract_ref: z.string().min(1).max(200).optional(),
+        cap_units: z.number().int().nonnegative().optional(),
+        plan_id: z.string().min(1).max(120).optional(),
+        app_id: z.string().min(1).max(300).optional(),
+    }, annotationsFor('aimeat_exchange_accept'), async ({ offering_id, ext, action, contract_ref, cap_units, plan_id, app_id }) => {
+        const capUnits = cap_units !== undefined ? Math.floor(cap_units) : null;
+        // Preferred: accept an OFFERING by id (works for ext-action AND app-tool kinds).
+        if (offering_id) {
+            const o = await getOffering(storage, offering_id);
+            if (!o || o.state !== 'listed')
+                return fail('NOT_FOUND: no such listed offering');
+            const priced = await resolveOfferingPricing(storage, o, plan_id ?? null);
+            if (!priced.ok)
+                return fail(`${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 fail(`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: app_id ?? null, 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: contract_ref || `offering:${offering_id}`,
+                surface: priced.surface, tollMorsels: priced.tollMorsels, createdBy: owner, carrySpend: existing,
+            });
+            return ok({ entitlement: entitlementView(config, ent) });
+        }
+        // Legacy: accept a raw ext-action directly.
+        if (!ext || !action)
+            return fail('BAD_REQUEST: pass offering_id, or both ext and action');
+        const contractRef = contract_ref || `mcp:${randomUUID()}`;
+        const extRec = await storage.getExtension(ext);
+        if (!extRec)
+            return fail(`NOT_FOUND: extension "${ext}" not found`);
+        const act = extRec.actions.find(a => a.id === action);
+        if (!act)
+            return fail(`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 plan; none → per_call.
+        const priced = resolveActionPricing(act.commercial, plan_id ?? null);
+        if (!priced.ok)
+            return fail(`${priced.code}: action "${ext}/${action}": ${priced.message}`);
+        const { unit, pricePerCall, currency, pricing } = priced;
+        const minCharge = pricing?.model === 'bundle' ? pricing.blockPrice : pricing?.model === 'subscription' ? pricing.periodPrice : pricePerCall;
+        if (capUnits !== null && capUnits < minCharge) {
+            return fail(`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: app_id ?? null, providerGhii, ext, action, capabilityLabel: `${ext}/${action}`,
+            unit, pricePerCall, currency, pricing, capUnits, contractRef, tollMorsels: act.tollMorsels ?? null,
+            createdBy: owner, carrySpend: existing,
+        });
+        return ok({ entitlement: entitlementView(config, ent) });
+    });
+    // ── List the caller's own contracts (consumer side) ────────────────────────
+    mcp.tool('aimeat_exchange_contracts', descriptionFor('aimeat_exchange_contracts'), {}, annotationsFor('aimeat_exchange_contracts'), async () => {
+        const mine = await listEntitlementsByConsumer(storage, consumerGaii);
+        return ok({ entitlements: mine.map(e => entitlementView(config, e)), count: mine.length });
+    });
+    // ── Pause / revoke one of the caller's own contracts ───────────────────────
+    mcp.tool('aimeat_exchange_contract_off', descriptionFor('aimeat_exchange_contract_off'), {
+        ext: z.string().min(1).max(120),
+        action: z.string().min(1).max(120),
+        mode: z.enum(['pause', 'revoke']),
+    }, annotationsFor('aimeat_exchange_contract_off'), async ({ ext, action, mode }) => {
+        const ent = await readEntitlementForCall(storage, consumerGaii, ext, action);
+        if (!ent || ownerOf(ent.consumerGaii) !== owner) {
+            return fail('NOT_FOUND: no entitlement of yours for that capability');
+        }
+        const applied = mode === 'revoke'
+            ? await revokeEntitlement(storage, consumerGaii, ext, action)
+            : await pauseEntitlement(storage, consumerGaii, ext, action);
+        return ok({ ext, action, mode, applied });
+    });
+    // ── Browse needs (demand) ──────────────────────────────────────────────────
+    mcp.tool('aimeat_exchange_needs', descriptionFor('aimeat_exchange_needs'), {
+        open: z.boolean().optional(),
+        mine: z.boolean().optional(),
+    }, annotationsFor('aimeat_exchange_needs'), async ({ open, mine }) => {
+        const needs = await enrichNeeds(storage, await listNeeds(storage, { openOnly: !!open, owner: mine ? owner : undefined }));
+        return ok({ needs, count: needs.length });
+    });
+    // ── Post a need ────────────────────────────────────────────────────────────
+    mcp.tool('aimeat_exchange_need_post', descriptionFor('aimeat_exchange_need_post'), {
+        description: z.string().min(1).max(4000),
+        app_id: z.string().min(1).max(300),
+        ext: z.string().max(120).optional(),
+        action: z.string().max(120).optional(),
+        spec: z.record(z.string(), z.unknown()).optional(),
+        usage_intent: z.string().max(2000).optional(),
+        budget_unit: z.enum(['morsels', 'money']).optional(),
+        budget_cap: z.number().int().nonnegative().optional(),
+        autonomy: z.enum(['supervised', 'auto']).optional(),
+    }, annotationsFor('aimeat_exchange_need_post'), async ({ description, app_id, ext, action, spec, usage_intent, budget_unit, budget_cap, autonomy }) => {
+        const now = new Date().toISOString();
+        const need = {
+            needId: newNeedId(),
+            requesterGaii: consumerGaii,
+            requesterOwner: owner,
+            appId: app_id,
+            ext: ext || null, action: action || null,
+            description,
+            spec: parseNeedSpec(spec),
+            usageIntent: usage_intent || null,
+            budgetUnit: budget_unit ?? null, budgetCap: budget_cap !== undefined ? Math.floor(budget_cap) : null,
+            autonomy: autonomy === 'auto' ? 'auto' : 'supervised',
+            state: 'open', createdAt: now, updatedAt: now,
+        };
+        await putNeed(storage, need);
+        // Surface offerings that already satisfy it (accept directly, no bid needed).
+        const matches = await matchOfferings(storage, { ext: need.ext, action: need.action, text: need.description });
+        return ok({ need, matches: matches.slice(0, 10) });
+    });
+    // ── Bid on a need (provider) ───────────────────────────────────────────────
+    mcp.tool('aimeat_exchange_bid', descriptionFor('aimeat_exchange_bid'), {
+        need_id: z.string().min(1).max(120),
+        ext: z.string().min(1).max(120),
+        action: z.string().min(1).max(120),
+        plan_id: z.string().max(120).optional(),
+        note: z.string().max(2000).optional(),
+        offering_id: z.string().max(120).optional(),
+    }, annotationsFor('aimeat_exchange_bid'), async ({ need_id, ext, action, plan_id, note, offering_id }) => {
+        const n = await getNeed(storage, need_id);
+        if (!n)
+            return fail(`NOT_FOUND: no such need "${need_id}"`);
+        if (n.state !== 'open')
+            return fail(`NEED_CLOSED: need is ${n.state}`);
+        const extRec = await storage.getExtension(ext);
+        if (!extRec || extRec.installedBy !== owner)
+            return fail('FORBIDDEN: bid only with an action your extension owns');
+        if (!extRec.actions.find(a => a.id === action))
+            return fail(`NOT_FOUND: action "${action}" not found on "${ext}"`);
+        const bid = {
+            bidId: newBidId(), needId: n.needId,
+            bidderGhii: consumerGaii, bidderOwner: owner,
+            offeringId: offering_id || null, ext, action,
+            planId: plan_id || null, note: note ?? '',
+            state: 'open', createdAt: new Date().toISOString(),
+        };
+        await putBid(storage, bid);
+        return ok({ bid });
+    });
+    // ── Accept a bid → mint the entitlement (requester side) ───────────────────
+    mcp.tool('aimeat_exchange_bid_accept', descriptionFor('aimeat_exchange_bid_accept'), {
+        need_id: z.string().min(1).max(120),
+        bid_id: z.string().min(1).max(120),
+        cap_units: z.number().int().nonnegative().optional(),
+    }, annotationsFor('aimeat_exchange_bid_accept'), async ({ need_id, bid_id, cap_units }) => {
+        const n = await getNeed(storage, need_id);
+        if (!n || n.requesterOwner !== owner)
+            return fail('NOT_FOUND: no such need of yours');
+        const bid = await getBid(storage, n.needId, bid_id);
+        if (!bid || bid.state !== 'open')
+            return fail('NOT_FOUND: no such open bid');
+        const extRec = await storage.getExtension(bid.ext);
+        const act = extRec?.actions.find(a => a.id === bid.action);
+        if (!extRec || !act)
+            return fail('NOT_FOUND: bid capability no longer exists');
+        const priced = resolveActionPricing(act.commercial, bid.planId);
+        if (!priced.ok)
+            return fail(`${priced.code}: ${priced.message}`);
+        const capCap = cap_units !== undefined ? Math.floor(cap_units) : n.budgetCap;
+        const existing = await readEntitlementForCall(storage, consumerGaii, bid.ext, bid.action);
+        const ent = await createEntitlement(storage, {
+            consumerGaii, appId: n.appId, providerGhii: `${extRec.installedBy}@${config.nodeId}`,
+            ext: bid.ext, action: bid.action, capabilityLabel: `${bid.ext}/${bid.action}`,
+            unit: priced.unit, pricePerCall: priced.pricePerCall, currency: priced.currency, pricing: priced.pricing,
+            capUnits: capCap, contractRef: `bid:${bid.bidId}`, createdBy: owner, carrySpend: existing,
+        });
+        bid.state = 'accepted';
+        await putBid(storage, bid);
+        n.state = 'matched';
+        n.updatedAt = new Date().toISOString();
+        await putNeed(storage, n);
+        return ok({ entitlement_id: ent.entitlementId, ext: ent.ext, action: ent.action, unit: ent.unit, pricing: ent.pricing });
+    });
+    // ── Provider lineage: who holds contracts against my offering ──────────────
+    mcp.tool('aimeat_exchange_consumers', descriptionFor('aimeat_exchange_consumers'), {
+        offering_id: z.string().min(1).max(120),
+    }, annotationsFor('aimeat_exchange_consumers'), async ({ offering_id }) => {
+        const o = await getOffering(storage, offering_id);
+        if (!o || o.providerOwner !== owner)
+            return fail('NOT_FOUND: no such offering of yours');
+        const consumers = await offeringConsumers(storage, o);
+        return ok({ offeringId: o.offeringId, consumers, count: consumers.length });
+    });
+}
+//# sourceMappingURL=exchange.js.map