aimeat 1.40.1 → 2.1.0

package/dist/src/services/exchange-market.js

@@ -0,0 +1,254 @@
+/**
+ * @file src/services/exchange-market.ts
+ * @description The two-sided EXCHANGE marketplace records (TARGET-045 Phase C) — the DEMAND + SUPPLY sides
+ *   that sit above the metered entitlement (the contract). Three public, memory-backed record types the
+ *   marketplace app + agents read/write; matching + negotiation live in the app/agent layer (this service
+ *   is the generic store + a simple capability match, per "node holds refined data, not orchestration"):
+ *     - OFFERING — a provider's public supply listing: a capability (ext/action) + pricing (base + plans) +
+ *       ODPS-style provenance. Discoverable by any consumer.
+ *     - NEED — a consumer/app's open demand: a wanted capability + budget + autonomy. Providers browse open
+ *       needs and BID.
+ *     - BID — a provider's offer against a NEED (links an OFFERING + proposed terms). The requester accepts
+ *       one → the acceptance flow mints the entitlement.
+ *   Keys: `exchange.offering.{id}` / `exchange.need.{id}` / `exchange.bid.{needId}.{id}` — public so the
+ *   marketplace is browsable; ownership is the record's provider/requester GHII (authorised by the routes).
+ * @structure Offering·Need·Bid types · UsageTerms·NeedSpec · put/get/list/delete for each · matchOfferings ·
+ *   offeringStats (reputation) · offeringConsumers (provider data-lineage)
+ * @usage import { putOffering, listOfferings, matchOfferings, putNeed, listOpenNeeds, putBid } from './exchange-market.js';
+ * @version-history
+ *   v1.5.0 — 2026-07-21 — Agent-work surface (Gap 2): Offering.kind gains 'agent-work' + AgentWorkSurface +
+ *     agentWorkCoordinate + Offering.taskSpec; resolveOfferingPricing covers agent-work (DATA/SERVICES/AGENT WORK).
+ *   v1.4.0 — 2026-07-21 — Demand side as an emergent interface request: NeedSpec gains input/outputSchema
+ *     (the shape the app sends/expects — a provider builds a matching app-tool). A need is app-bound.
+ *   v1.3.0 — 2026-07-21 — Needs app-context: Need.usageIntent + enrichNeeds (resolve the requesting app's
+ *     name/description so a provider can judge who they'd serve before offering).
+ *   v1.2.0 — 2026-07-21 — Cross-app selling (Gap 1): Offering.kind ('ext-action'|'app-tool') + AppToolSurface
+ *     (pinned interface); appToolCoordinate + offeringToCommercial + resolveOfferingPricing (shared mint path).
+ *   v1.1.0 — 2026-07-20 — Legibility layer: UsageTerms + NeedSpec on records; offeringStats (usage/reputation)
+ *     + offeringConsumers (provider lineage) derived from entitlements (no metrics table).
+ *   v1.0.0 — 2026-07-20 — Initial marketplace records (offering/need/bid) + capability matching (Phase C).
+ */
+import { randomUUID } from 'node:crypto';
+import { listEntitlementsByProvider } from './metered-entitlements.js';
+/**
+ * Resolve the AUTHORITATIVE unit + per-call price + (optional plan) pricing spec from a provider action's
+ * commercial block — the single source of truth shared by the acceptance route AND bid-accept, so a
+ * consumer can never undercut the provider. Money (payMoney) takes precedence over morsels.
+ */
+export function resolveActionPricing(comm, planId) {
+    const money = comm?.payMoney;
+    let unit;
+    let pricePerCall;
+    let currency = null;
+    if (money && typeof money.amount === 'number' && Number.isInteger(money.amount) && money.amount > 0) {
+        unit = 'money';
+        pricePerCall = money.amount;
+        currency = money.currency;
+    }
+    else if (typeof comm?.payMorsels === 'number' && Number.isInteger(comm.payMorsels) && comm.payMorsels > 0) {
+        unit = 'morsels';
+        pricePerCall = comm.payMorsels;
+    }
+    else {
+        return { ok: false, code: 'NOT_PRICED', message: 'Action has no price; only priced actions are contractable' };
+    }
+    let pricing = null;
+    if (planId) {
+        const plan = (comm?.plans ?? []).find(p => p.id === planId);
+        if (!plan)
+            return { ok: false, code: 'PLAN_NOT_FOUND', message: `No plan "${planId}" on this action` };
+        if (plan.model === 'bundle') {
+            pricing = { model: 'bundle', blockSize: plan.blockSize, blockPrice: plan.blockPrice, callsRemaining: 0 };
+        }
+        else if (plan.model === 'subscription') {
+            const epoch = new Date(0).toISOString();
+            pricing = { model: 'subscription', periodSeconds: plan.periodSeconds, periodPrice: plan.periodPrice, callsPerWindow: plan.callsPerWindow, windowSeconds: plan.windowSeconds, validUntil: epoch, windowStart: epoch, windowCount: 0 };
+        }
+    }
+    return { ok: true, unit, pricePerCall, currency, pricing };
+}
+/** The metered coordinate for an app-tool surface — the (ext, action) pair the entitlement + gate key on. */
+export function appToolCoordinate(ownerName, appId, tool) {
+    return { ext: `apptool:${ownerName}/${appId}`, action: tool };
+}
+/** The metered coordinate for an agent-work surface (a provider agent's task type; settled per delivered task). */
+export function agentWorkCoordinate(ownerName, agentName, taskType) {
+    return { ext: `agentwork:${ownerName}/${agentName}`, action: taskType };
+}
+/** Build an ActionCommercial from an offering's stored price/plans, so the shared pricing resolver
+ *  (resolveActionPricing) works for app-tool offerings too — the offering's listing IS the authoritative price. */
+export function offeringToCommercial(o) {
+    return {
+        payMorsels: o.unit === 'morsels' ? o.basePrice : undefined,
+        payMoney: o.unit === 'money' ? { amount: o.basePrice, currency: o.currency ?? 'EUR' } : undefined,
+        plans: o.plans,
+    };
+}
+/**
+ * Resolve the authoritative pricing + metered coordinate to mint a contract from an offering — shared by the
+ * REST and MCP accept flows, for BOTH kinds. For app-tool the price comes from the offering's own listing;
+ * for ext-action it comes LIVE from the provider's extension action (so the provider's current price wins).
+ */
+export async function resolveOfferingPricing(storage, o, planId) {
+    // app-tool + agent-work both price from the offering's own listing (the provider authored it).
+    if ((o.kind === 'app-tool' || o.kind === 'agent-work') && o.surface) {
+        const priced = resolveActionPricing(offeringToCommercial(o), planId);
+        if (!priced.ok)
+            return { ok: false, status: 400, code: priced.code, message: priced.message };
+        const label = o.surface.kind === 'app-tool'
+            ? `${o.surface.appId}/${o.surface.tool} v${o.surface.ifaceVersion}`
+            : `${o.surface.agentName}:${o.surface.taskType}`;
+        return {
+            ok: true, unit: priced.unit, pricePerCall: priced.pricePerCall, currency: priced.currency, pricing: priced.pricing,
+            providerGhii: o.providerGhii, ext: o.ext, action: o.action, capabilityLabel: label, surface: o.surface,
+        };
+    }
+    // ext-action: authoritative LIVE price from the provider's extension action.
+    const extRec = await storage.getExtension(o.ext);
+    const act = extRec?.actions.find(a => a.id === o.action);
+    if (!extRec || !act)
+        return { ok: false, status: 404, code: 'NOT_FOUND', message: 'Offering capability no longer exists' };
+    const priced = resolveActionPricing(act.commercial, planId);
+    if (!priced.ok)
+        return { ok: false, status: 400, code: priced.code, message: priced.message };
+    return {
+        ok: true, unit: priced.unit, pricePerCall: priced.pricePerCall, currency: priced.currency, pricing: priced.pricing,
+        providerGhii: o.providerGhii, ext: o.ext, action: o.action, capabilityLabel: `${o.ext}/${o.action}`, surface: null,
+    };
+}
+/**
+ * Attach app context to needs: when a need names a requesting app (`appId` = "owner/filename" or a bare
+ * filename under the requester), resolve that app's published name + description so a provider can judge the
+ * consumer before offering (per "do I even want to serve an app that misuses the data?"). Best-effort — a
+ * need without a resolvable app gets `appContext: null` and is grouped under its requester instead.
+ */
+export async function enrichNeeds(storage, needs) {
+    const cache = new Map();
+    const out = [];
+    for (const n of needs) {
+        let appContext = null;
+        if (n.appId) {
+            const ref = n.appId.includes('/') ? n.appId : `${n.requesterOwner}/${n.appId}`;
+            if (cache.has(ref)) {
+                appContext = cache.get(ref) ?? null;
+            }
+            else {
+                const [owner, filename] = ref.split('/');
+                let resolved = null;
+                try {
+                    const rec = owner && filename ? await storage.getAppByOwnerName(owner, filename) : null;
+                    const m = (rec?.manifest ?? {});
+                    if (rec)
+                        resolved = { app: ref, name: m.name || filename, description: m.description || '' };
+                }
+                catch { /* unresolved app → null context */ }
+                cache.set(ref, resolved);
+                appContext = resolved;
+            }
+        }
+        out.push({ ...n, appContext });
+    }
+    return out;
+}
+const OFFERING_PREFIX = 'exchange.offering.';
+const NEED_PREFIX = 'exchange.need.';
+const bidPrefix = (needId) => `exchange.bid.${needId}.`;
+async function putPublic(storage, ownerGhii, key, value, tag) {
+    const now = new Date().toISOString();
+    await storage.setMemory({ key, ownerGaii: ownerGhii, value, visibility: 'public', tags: [tag], ttlHours: null, version: 1, createdAt: now, updatedAt: now });
+}
+// ── OFFERING ────────────────────────────────────────────────────────────────
+export function newOfferingId() { return `off-${randomUUID().slice(0, 12)}`; }
+export async function putOffering(storage, o) {
+    await putPublic(storage, o.providerGhii, OFFERING_PREFIX + o.offeringId, o, 'exchange-offering');
+    return o;
+}
+export async function getOffering(storage, id) {
+    const { items } = await storage.listAllMemory({ prefix: OFFERING_PREFIX + id, limit: 2 });
+    const rec = items.find(r => r.key === OFFERING_PREFIX + id);
+    return rec ? rec.value : null;
+}
+export async function listOfferings(storage) {
+    const { items } = await storage.listAllMemory({ prefix: OFFERING_PREFIX, limit: 5000 });
+    return items.map(r => r.value).filter(v => v && v.offeringId && v.state === 'listed');
+}
+export async function deleteOffering(storage, id) {
+    const o = await getOffering(storage, id);
+    if (!o)
+        return false;
+    o.state = 'delisted';
+    o.updatedAt = new Date().toISOString();
+    await putOffering(storage, o);
+    return true;
+}
+/** Rank listed offerings that satisfy a capability. Match = exact (ext,action) when given, else a text
+ *  contains over title/description/tags. Cheapest base price first (a proxy; agents refine with plans/trust). */
+export async function matchOfferings(storage, q) {
+    const all = await listOfferings(storage);
+    const text = (q.text || '').trim().toLowerCase();
+    const hits = all.filter(o => {
+        if (q.ext && q.action)
+            return o.ext === q.ext && o.action === q.action;
+        if (!text)
+            return true;
+        return [o.title, o.description, o.ext, o.action, ...(o.tags || [])].join(' ').toLowerCase().includes(text);
+    });
+    return hits.sort((a, b) => a.basePrice - b.basePrice);
+}
+// ── NEED ────────────────────────────────────────────────────────────────────
+export function newNeedId() { return `need-${randomUUID().slice(0, 12)}`; }
+export async function putNeed(storage, n) {
+    await putPublic(storage, n.requesterGaii, NEED_PREFIX + n.needId, n, 'exchange-need');
+    return n;
+}
+export async function getNeed(storage, id) {
+    const { items } = await storage.listAllMemory({ prefix: NEED_PREFIX + id, limit: 2 });
+    const rec = items.find(r => r.key === NEED_PREFIX + id);
+    return rec ? rec.value : null;
+}
+export async function listNeeds(storage, opts) {
+    const { items } = await storage.listAllMemory({ prefix: NEED_PREFIX, limit: 5000 });
+    return items.map(r => r.value).filter(v => v && v.needId &&
+        (!opts?.openOnly || v.state === 'open') &&
+        (!opts?.owner || v.requesterOwner === opts.owner));
+}
+// ── BID ─────────────────────────────────────────────────────────────────────
+export function newBidId() { return `bid-${randomUUID().slice(0, 12)}`; }
+export async function putBid(storage, b) {
+    await putPublic(storage, b.bidderGhii, bidPrefix(b.needId) + b.bidId, b, 'exchange-bid');
+    return b;
+}
+export async function listBids(storage, needId) {
+    const { items } = await storage.listAllMemory({ prefix: bidPrefix(needId), limit: 2000 });
+    return items.map(r => r.value).filter(v => v && v.bidId);
+}
+export async function getBid(storage, needId, bidId) {
+    const rec = (await storage.listAllMemory({ prefix: bidPrefix(needId) + bidId, limit: 2 })).items.find(r => r.key === bidPrefix(needId) + bidId);
+    return rec ? rec.value : null;
+}
+/** Compute an offering's usage stats from the entitlements minted against its (provider, ext, action). */
+export async function offeringStats(storage, o) {
+    const ents = (await listEntitlementsByProvider(storage, o.providerGhii)).filter(e => e.ext === o.ext && e.action === o.action);
+    const consumers = new Set(ents.map(e => e.consumerGaii));
+    let totalCalls = 0, totalSettledUnits = 0, activeContracts = 0, lastUsedAt = null;
+    for (const e of ents) {
+        totalCalls += e.budget.calls;
+        totalSettledUnits += e.budget.spentUnits;
+        if (e.state === 'active')
+            activeContracts += 1;
+        if (e.budget.calls > 0 && (!lastUsedAt || e.updatedAt > lastUsedAt))
+            lastUsedAt = e.updatedAt;
+    }
+    return { activeContracts, totalContracts: ents.length, totalCalls, totalSettledUnits, consumers: consumers.size, listedAt: o.createdAt, lastUsedAt };
+}
+/** List the consumers holding contracts against an offering (provider lineage/consumption log). */
+export async function offeringConsumers(storage, o) {
+    const ents = (await listEntitlementsByProvider(storage, o.providerGhii)).filter(e => e.ext === o.ext && e.action === o.action);
+    return ents
+        .map(e => ({
+        consumerGaii: e.consumerGaii, appId: e.appId, contractRef: e.contractRef, unit: e.unit,
+        calls: e.budget.calls, settledUnits: e.budget.spentUnits, state: e.state, lastUsedAt: e.updatedAt,
+    }))
+        .sort((a, b) => b.calls - a.calls);
+}
+//# sourceMappingURL=exchange-market.js.map

package/dist/src/services/exchange-market.js.map

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

package/dist/src/services/exchange-proposals.d.ts

@@ -0,0 +1,47 @@
+import type { Storage } from '../storage/interface.js';
+import { type EntitlementUnit, type MeteredEntitlement } from './metered-entitlements.js';
+export declare const ownerOfGaii: (gaii: string) => string;
+/** A proposed change to a live contract, pending the counterparty's decision. */
+export interface ContractProposal {
+    proposalId: string;
+    /** The contract being renegotiated — its metered coordinate + parties. */
+    consumerGaii: string;
+    providerGhii: string;
+    ext: string;
+    action: string;
+    capabilityLabel: string;
+    /** Who initiated the change, and who must accept it. */
+    proposedByRole: 'provider' | 'consumer';
+    proposerGhii: string;
+    proposerOwner: string;
+    counterpartyGhii: string;
+    counterpartyOwner: string;
+    /** Proposed new terms — `null` means "leave unchanged". */
+    newPricePerCall: number | null;
+    newCapUnits: number | null;
+    note: string;
+    /** A snapshot of the current terms (for the diff shown to the counterparty + the history). */
+    currentTerms: {
+        unit: EntitlementUnit;
+        pricePerCall: number;
+        pricingModel: string;
+        capUnits: number | null;
+    };
+    status: 'pending' | 'accepted' | 'declined' | 'withdrawn';
+    createdAt: string;
+    resolvedAt: string | null;
+}
+export declare function newProposalId(): string;
+export declare function putProposal(storage: Storage, p: ContractProposal): Promise<ContractProposal>;
+export declare function getProposal(storage: Storage, id: string): Promise<ContractProposal | null>;
+/** Every proposal an owner is party to (as proposer OR counterparty, either role), newest first. */
+export declare function listProposalsForOwner(storage: Storage, owner: string): Promise<ContractProposal[]>;
+/**
+ * Apply an accepted proposal: archive the live entitlement to history (superseded), then mint a fresh one at
+ * the agreed terms under the SAME coordinate. Price change → the contract moves to a straightforward per-call
+ * model at the new price (plan renegotiation is a separate re-accept); an unchanged field keeps its value.
+ * The new contract starts a fresh meter (spend 0) — the old totals live on in the archived history entry.
+ * Returns the new entitlement, or null if the live contract vanished.
+ */
+export declare function supersedeWithProposal(storage: Storage, proposal: ContractProposal): Promise<MeteredEntitlement | null>;
+//# sourceMappingURL=exchange-proposals.d.ts.map

package/dist/src/services/exchange-proposals.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"exchange-proposals.d.ts","sourceRoot":"","sources":["../../../src/services/exchange-proposals.ts"],"names":[],"mappings":"AAmBA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,EAEL,KAAK,eAAe,EAAE,KAAK,kBAAkB,EAC9C,MAAM,2BAA2B,CAAC;AAKnC,eAAO,MAAM,WAAW,GAAI,MAAM,MAAM,KAAG,MAAqD,CAAC;AAEjG,iFAAiF;AACjF,MAAM,WAAW,gBAAgB;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,0EAA0E;IAC1E,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,eAAe,EAAE,MAAM,CAAC;IACxB,wDAAwD;IACxD,cAAc,EAAE,UAAU,GAAG,UAAU,CAAC;IACxC,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,gBAAgB,EAAE,MAAM,CAAC;IACzB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,2DAA2D;IAC3D,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,8FAA8F;IAC9F,YAAY,EAAE;QAAE,IAAI,EAAE,eAAe,CAAC;QAAC,YAAY,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC;IAC7G,MAAM,EAAE,SAAS,GAAG,UAAU,GAAG,UAAU,GAAG,WAAW,CAAC;IAC1D,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AAED,wBAAgB,aAAa,IAAI,MAAM,CAAgD;AAEvF,wBAAsB,WAAW,CAAC,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAQlG;AAED,wBAAsB,WAAW,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAGhG;AAED,oGAAoG;AACpG,wBAAsB,qBAAqB,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAKxG;AAED;;;;;;GAMG;AACH,wBAAsB,qBAAqB,CACzC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,gBAAgB,GAC3C,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC,CAiBpC"}

package/dist/src/services/exchange-proposals.js

@@ -0,0 +1,71 @@
+/**
+ * @file src/services/exchange-proposals.ts
+ * @description Contract RENEGOTIATION for EXCHANGE (TARGET-045). A live contract (metered entitlement) can be
+ *   renegotiated instead of blindly revoked + re-accepted: either party PROPOSES new terms (a new per-call
+ *   price and/or a new budget cap + a note — e.g. "the upstream API got pricier"), a message is delivered to
+ *   the counterparty (Profile > Messages), and when the counterparty ACCEPTS, the old contract is archived to
+ *   history (with its final spend + period) and a fresh one takes effect at the agreed terms. Mutual consent
+ *   is the authority: whoever proposes, the OTHER party's acceptance makes the new price legitimate (so a
+ *   consumer-proposed price only binds once the provider accepts, and vice-versa). Memory-backed (no new
+ *   table), stored under a system namespace, surfaced to the two parties by the authorised routes.
+ * @structure ContractProposal · newProposalId · putProposal · getProposal · listProposalsForOwner ·
+ *   supersedeWithProposal (archive old + mint new at the agreed terms)
+ * @usage
+ *   const p = await putProposal(storage, {...});
+ *   const ent = await supersedeWithProposal(storage, proposal, existingEntitlement);
+ * @version-history
+ *   v1.0.0 — 2026-07-21 — Initial renegotiation: propose / accept (supersede + archive) / decline / withdraw.
+ */
+import { randomUUID } from 'node:crypto';
+import { archiveEntitlement, createEntitlement, readEntitlementForCall, } from './metered-entitlements.js';
+const NS = 'exchange-proposal';
+const keyOf = (id) => `xprop.${id}`;
+export const ownerOfGaii = (gaii) => gaii.split('@')[0].split('#').pop() ?? gaii;
+export function newProposalId() { return `prop-${randomUUID().slice(0, 12)}`; }
+export async function putProposal(storage, p) {
+    const now = new Date().toISOString();
+    await storage.setMemory({
+        key: keyOf(p.proposalId), ownerGaii: NS, value: p,
+        visibility: 'private', tags: ['exchange-proposal'], ttlHours: null, version: 1,
+        createdAt: p.createdAt || now, updatedAt: now,
+    });
+    return p;
+}
+export async function getProposal(storage, id) {
+    const rec = await storage.getMemory(NS, keyOf(id));
+    return rec ? rec.value : null;
+}
+/** Every proposal an owner is party to (as proposer OR counterparty, either role), newest first. */
+export async function listProposalsForOwner(storage, owner) {
+    const { items } = await storage.listAllMemory({ prefix: 'xprop.', limit: 5000 });
+    return items.map(r => r.value)
+        .filter(v => v && v.proposalId && (v.proposerOwner === owner || v.counterpartyOwner === owner))
+        .sort((a, b) => (a.createdAt < b.createdAt ? 1 : -1));
+}
+/**
+ * Apply an accepted proposal: archive the live entitlement to history (superseded), then mint a fresh one at
+ * the agreed terms under the SAME coordinate. Price change → the contract moves to a straightforward per-call
+ * model at the new price (plan renegotiation is a separate re-accept); an unchanged field keeps its value.
+ * The new contract starts a fresh meter (spend 0) — the old totals live on in the archived history entry.
+ * Returns the new entitlement, or null if the live contract vanished.
+ */
+export async function supersedeWithProposal(storage, proposal) {
+    const existing = await readEntitlementForCall(storage, proposal.consumerGaii, proposal.ext, proposal.action);
+    if (!existing)
+        return null;
+    await archiveEntitlement(storage, existing, 'superseded', proposal.proposalId);
+    const newPrice = proposal.newPricePerCall ?? existing.pricePerCall;
+    const priceChanged = proposal.newPricePerCall != null && proposal.newPricePerCall !== existing.pricePerCall;
+    const newCap = proposal.newCapUnits != null ? proposal.newCapUnits : existing.budget.capUnits;
+    return createEntitlement(storage, {
+        consumerGaii: existing.consumerGaii, appId: existing.appId, providerGhii: existing.providerGhii,
+        ext: existing.ext, action: existing.action, capabilityLabel: existing.capabilityLabel,
+        unit: existing.unit, pricePerCall: newPrice, currency: existing.currency,
+        // A price change resets to a clean per-call model; otherwise keep the existing pricing state.
+        pricing: priceChanged ? { model: 'per_call' } : existing.pricing,
+        capUnits: newCap, rakePercent: existing.rakePercent, contractRef: `proposal:${proposal.proposalId}`,
+        surface: existing.surface, escrowParty: existing.escrowParty, createdBy: proposal.counterpartyOwner,
+        carrySpend: null, // renegotiation = a fresh meter; the old spend is preserved in the archive
+    });
+}
+//# sourceMappingURL=exchange-proposals.js.map

package/dist/src/services/exchange-proposals.js.map

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

package/dist/src/services/exchange-work.d.ts

@@ -0,0 +1,30 @@
+import type { Storage } from '../storage/interface.js';
+import type { EntitlementUnit } from './metered-entitlements.js';
+/** One unit of agent work under a contract: started by the consumer, delivered + settled by the provider. */
+export interface AgentWork {
+    workId: string;
+    offeringId: string;
+    consumerGaii: string;
+    consumerOwner: string;
+    providerGhii: string;
+    providerOwner: string;
+    agentGaii: string;
+    taskType: string;
+    ext: string;
+    action: string;
+    input: unknown;
+    output: unknown;
+    note: string;
+    state: 'open' | 'delivered' | 'cancelled';
+    unit: EntitlementUnit;
+    currency: string | null;
+    chargedUnits: number;
+    createdAt: string;
+    deliveredAt: string | null;
+}
+export declare function newWorkId(): string;
+export declare function putWork(storage: Storage, w: AgentWork): Promise<AgentWork>;
+export declare function getWork(storage: Storage, id: string): Promise<AgentWork | null>;
+export declare function listWorkByConsumer(storage: Storage, owner: string): Promise<AgentWork[]>;
+export declare function listWorkByProvider(storage: Storage, owner: string): Promise<AgentWork[]>;
+//# sourceMappingURL=exchange-work.d.ts.map

package/dist/src/services/exchange-work.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"exchange-work.d.ts","sourceRoot":"","sources":["../../../src/services/exchange-work.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAKjE,6GAA6G;AAC7G,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,OAAO,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,GAAG,WAAW,GAAG,WAAW,CAAC;IAC1C,IAAI,EAAE,eAAe,CAAC;IACtB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B;AAED,wBAAgB,SAAS,IAAI,MAAM,CAAgD;AAEnF,wBAAsB,OAAO,CAAC,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC,CAOhF;AAED,wBAAsB,OAAO,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC,CAGrF;AAED,wBAAsB,kBAAkB,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC,CAI9F;AAED,wBAAsB,kBAAkB,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC,CAI9F"}

package/dist/src/services/exchange-work.js

@@ -0,0 +1,43 @@
+/**
+ * @file src/services/exchange-work.ts
+ * @description AGENT WORK records for EXCHANGE (TARGET-045 Gap 2) — the async third sellable surface
+ *   (DATA / SERVICES / AGENT WORK). A consumer holding a metered contract for a provider agent's TASK TYPE
+ *   STARTS a work item (input); the provider agent DELIVERS (output); the per-task price is metered ON
+ *   DELIVERY — charge the consumer, credit the provider its cut, route the platform rake, decrement the
+ *   budget — through the SAME G1 entitlement + G2 settlement as a synchronous call (settlement-rail ⊥
+ *   pricing-model). Unlike data/app-tool calls (synchronous), the charge fires when the agent delivers, not
+ *   on a request. Memory-backed under a system namespace; surfaced to the two parties by the authorised routes.
+ * @structure AgentWork · newWorkId · putWork · getWork · listWorkByConsumer / ByProvider
+ * @usage
+ *   const w = await putWork(storage, { workId: newWorkId(), offeringId, consumerGaii, ... });
+ *   // on delivery the exchange route settles via settleMeteredCoordinate against the consumer.
+ * @version-history
+ *   v1.0.0 — 2026-07-21 — Initial agent-work records (start → deliver → settle on delivery); metered per task.
+ */
+import { randomUUID } from 'node:crypto';
+const NS = 'exchange-work';
+const keyOf = (id) => `xwork.${id}`;
+export function newWorkId() { return `work-${randomUUID().slice(0, 12)}`; }
+export async function putWork(storage, w) {
+    const now = new Date().toISOString();
+    await storage.setMemory({
+        key: keyOf(w.workId), ownerGaii: NS, value: w, visibility: 'private', tags: ['exchange-work'],
+        ttlHours: null, version: 1, createdAt: w.createdAt || now, updatedAt: now,
+    });
+    return w;
+}
+export async function getWork(storage, id) {
+    const rec = await storage.getMemory(NS, keyOf(id));
+    return rec ? rec.value : null;
+}
+export async function listWorkByConsumer(storage, owner) {
+    const { items } = await storage.listAllMemory({ prefix: 'xwork.', limit: 5000 });
+    return items.map(r => r.value).filter(v => v && v.workId && v.consumerOwner === owner)
+        .sort((a, b) => (a.createdAt < b.createdAt ? 1 : -1));
+}
+export async function listWorkByProvider(storage, owner) {
+    const { items } = await storage.listAllMemory({ prefix: 'xwork.', limit: 5000 });
+    return items.map(r => r.value).filter(v => v && v.workId && v.providerOwner === owner)
+        .sort((a, b) => (a.createdAt < b.createdAt ? 1 : -1));
+}
+//# sourceMappingURL=exchange-work.js.map

package/dist/src/services/exchange-work.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"exchange-work.js","sourceRoot":"","sources":["../../../src/services/exchange-work.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAIzC,MAAM,EAAE,GAAG,eAAe,CAAC;AAC3B,MAAM,KAAK,GAAG,CAAC,EAAU,EAAU,EAAE,CAAC,SAAS,EAAE,EAAE,CAAC;AAyBpD,MAAM,UAAU,SAAS,KAAa,OAAO,QAAQ,UAAU,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;AAEnF,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,OAAgB,EAAE,CAAY;IAC1D,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IACrC,MAAM,OAAO,CAAC,SAAS,CAAC;QACtB,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,UAAU,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,eAAe,CAAC;QAC7F,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,SAAS,IAAI,GAAG,EAAE,SAAS,EAAE,GAAG;KAC1E,CAAC,CAAC;IACH,OAAO,CAAC,CAAC;AACX,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,OAAgB,EAAE,EAAU;IACxD,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC,SAAS,CAAC,EAAE,EAAE,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC;IACnD,OAAO,GAAG,CAAC,CAAC,CAAE,GAAG,CAAC,KAAmB,CAAC,CAAC,CAAC,IAAI,CAAC;AAC/C,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,OAAgB,EAAE,KAAa;IACtE,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,OAAO,CAAC,aAAa,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IACjF,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAkB,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,aAAa,KAAK,KAAK,CAAC;SAChG,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,GAAG,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAC1D,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,OAAgB,EAAE,KAAa;IACtE,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,OAAO,CAAC,aAAa,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IACjF,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAkB,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,aAAa,KAAK,KAAK,CAAC;SAChG,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,GAAG,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAC1D,CAAC"}

package/dist/src/services/ext-pay-token.d.ts

@@ -0,0 +1,29 @@
+import type { Storage } from '../storage/interface.js';
+export declare const EXT_PAY_TOKEN_TTL_MS: number;
+/** What a token authorises: one call of `action` on `ext` by `buyerOwner`, paid `amount` `currency`. */
+export interface ExtPayGrant {
+    buyerOwner: string;
+    ext: string;
+    action: string;
+    currency: string;
+    amount: number;
+}
+/** Mint a single-use token for a settled money payment. Returns the token + its expiry. */
+export declare function mintExtPayToken(storage: Storage, grant: ExtPayGrant): Promise<{
+    token: string;
+    expiresAt: string;
+}>;
+/**
+ * Verify + CONSUME a token. Single-use: the record is deleted first and the delete result is the
+ * atomicity gate — a concurrent replay that loses the delete race is rejected. Also checks expiry
+ * and that the token was minted for exactly this buyer + ext + action.
+ */
+export declare function consumeExtPayToken(storage: Storage, token: string | undefined, expect: {
+    buyerOwner: string;
+    ext: string;
+    action: string;
+}): Promise<{
+    ok: boolean;
+    reason?: string;
+}>;
+//# sourceMappingURL=ext-pay-token.d.ts.map

package/dist/src/services/ext-pay-token.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ext-pay-token.d.ts","sourceRoot":"","sources":["../../../src/services/ext-pay-token.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AAIvD,eAAO,MAAM,oBAAoB,QAAgB,CAAC;AAElD,wGAAwG;AACxG,MAAM,WAAW,WAAW;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,2FAA2F;AAC3F,wBAAsB,eAAe,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAAC,CAgBzH;AAED;;;;GAIG;AACH,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,OAAO,EAChB,KAAK,EAAE,MAAM,GAAG,SAAS,EACzB,MAAM,EAAE;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAC1D,OAAO,CAAC;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAe3C"}

package/dist/src/services/ext-pay-token.js

@@ -0,0 +1,63 @@
+/**
+ * @file src/services/ext-pay-token.ts
+ * @description One-time invoke token for the priced-raw-call MONEY channel (design notes
+ *   doc-r6tyr3o, decisions D1/D3). After a buyer settles `commercial.payMoney` through a checkout
+ *   (kind 'ext-call'), the node mints a token bound to (buyerOwner, ext, action, currency, amount);
+ *   the buyer then RETRIES the raw call with `x-aimeat-pay-token: <token>` and the paywall verifies
+ *   + consumes it. Single-use (deleted on consume — the delete is the atomicity gate, so a replay
+ *   loses the race) with a 5-minute TTL (storage auto-expiry). Money settlement itself is the EE
+ *   payment rail; this generic token is the seam the paywall honours regardless of the rail.
+ * @structure ExtPayGrant · mintExtPayToken · consumeExtPayToken · EXT_PAY_TOKEN_TTL_MS
+ * @usage
+ *   const { token } = await mintExtPayToken(storage, { buyerOwner, ext, action, currency, amount });
+ *   const r = await consumeExtPayToken(storage, token, { buyerOwner, ext, action });
+ * @version-history
+ *   v1.0.0 — 2026-07-17 — Initial (Phase 3 — money-channel one-time token, D1/D3)
+ */
+import { randomUUID } from 'node:crypto';
+/** Token namespace (system-owned memory; server-side only, never client-readable). */
+const NS = 'ext-pay-token';
+export const EXT_PAY_TOKEN_TTL_MS = 5 * 60 * 1000;
+/** Mint a single-use token for a settled money payment. Returns the token + its expiry. */
+export async function mintExtPayToken(storage, grant) {
+    const token = randomUUID();
+    const now = new Date();
+    const expiresAt = new Date(now.getTime() + EXT_PAY_TOKEN_TTL_MS).toISOString();
+    await storage.setMemory({
+        key: token,
+        ownerGaii: NS,
+        value: { ...grant, expiresAt },
+        visibility: 'private',
+        tags: [],
+        ttlHours: EXT_PAY_TOKEN_TTL_MS / 3_600_000,
+        version: 1,
+        createdAt: now.toISOString(),
+        updatedAt: now.toISOString(),
+    });
+    return { token, expiresAt };
+}
+/**
+ * Verify + CONSUME a token. Single-use: the record is deleted first and the delete result is the
+ * atomicity gate — a concurrent replay that loses the delete race is rejected. Also checks expiry
+ * and that the token was minted for exactly this buyer + ext + action.
+ */
+export async function consumeExtPayToken(storage, token, expect) {
+    if (!token)
+        return { ok: false, reason: 'missing' };
+    const rec = await storage.getMemory(NS, token);
+    if (!rec)
+        return { ok: false, reason: 'invalid_or_used' };
+    // Single-use gate: whoever deletes it wins; a racing replay gets deleted=false.
+    const deleted = await storage.deleteMemory(NS, token);
+    if (!deleted)
+        return { ok: false, reason: 'replayed' };
+    const g = rec.value;
+    if (!g || typeof g.expiresAt !== 'string' || new Date(g.expiresAt).getTime() < Date.now()) {
+        return { ok: false, reason: 'expired' };
+    }
+    if (g.buyerOwner !== expect.buyerOwner || g.ext !== expect.ext || g.action !== expect.action) {
+        return { ok: false, reason: 'mismatch' };
+    }
+    return { ok: true };
+}
+//# sourceMappingURL=ext-pay-token.js.map

package/dist/src/services/ext-pay-token.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ext-pay-token.js","sourceRoot":"","sources":["../../../src/services/ext-pay-token.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAGzC,sFAAsF;AACtF,MAAM,EAAE,GAAG,eAAe,CAAC;AAC3B,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC;AAWlD,2FAA2F;AAC3F,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,OAAgB,EAAE,KAAkB;IACxE,MAAM,KAAK,GAAG,UAAU,EAAE,CAAC;IAC3B,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC;IACvB,MAAM,SAAS,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,GAAG,oBAAoB,CAAC,CAAC,WAAW,EAAE,CAAC;IAC/E,MAAM,OAAO,CAAC,SAAS,CAAC;QACtB,GAAG,EAAE,KAAK;QACV,SAAS,EAAE,EAAE;QACb,KAAK,EAAE,EAAE,GAAG,KAAK,EAAE,SAAS,EAAE;QAC9B,UAAU,EAAE,SAAS;QACrB,IAAI,EAAE,EAAE;QACR,QAAQ,EAAE,oBAAoB,GAAG,SAAS;QAC1C,OAAO,EAAE,CAAC;QACV,SAAS,EAAE,GAAG,CAAC,WAAW,EAAE;QAC5B,SAAS,EAAE,GAAG,CAAC,WAAW,EAAE;KAC7B,CAAC,CAAC;IACH,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC;AAC9B,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,OAAgB,EAChB,KAAyB,EACzB,MAA2D;IAE3D,IAAI,CAAC,KAAK;QAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;IACpD,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC,SAAS,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;IAC/C,IAAI,CAAC,GAAG;QAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,iBAAiB,EAAE,CAAC;IAC1D,gFAAgF;IAChF,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,YAAY,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;IACtD,IAAI,CAAC,OAAO;QAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC;IACvD,MAAM,CAAC,GAAG,GAAG,CAAC,KAA4C,CAAC;IAC3D,IAAI,CAAC,CAAC,IAAI,OAAO,CAAC,CAAC,SAAS,KAAK,QAAQ,IAAI,IAAI,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC;QAC1F,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;IAC1C,CAAC;IACD,IAAI,CAAC,CAAC,UAAU,KAAK,MAAM,CAAC,UAAU,IAAI,CAAC,CAAC,GAAG,KAAK,MAAM,CAAC,GAAG,IAAI,CAAC,CAAC,MAAM,KAAK,MAAM,CAAC,MAAM,EAAE,CAAC;QAC7F,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC;IAC3C,CAAC;IACD,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC;AACtB,CAAC"}

package/dist/src/services/extension-runtime.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"extension-runtime.d.ts","sourceRoot":"","sources":["../../../src/services/extension-runtime.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"extension-runtime.d.ts","sourceRoot":"","sources":["../../../src/services/extension-runtime.ts"],"names":[],"mappings":"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"}