@mneme-ai/core 3.101.0 → 3.103.0

package/dist/mediator/index.js

@@ -0,0 +1,152 @@
+const num = (v) => { const n = Number(v); return Number.isFinite(n) && n > 0 ? n : 0; };
+/** Re-checkable neutrality proof: recompute every fairness property from the parties' OWN valuations. */
+export function verifyFairness(parties, allocation) {
+    const ps = (parties ?? []).filter((p) => p && p.name);
+    const items = Object.keys(allocation ?? {});
+    const payoff = (p, who) => items.reduce((s, it) => s + num(p.vals?.[it]) * (allocation[it]?.[who] ?? 0), 0);
+    const payoffs = {};
+    const fairShare = {};
+    for (const p of ps) {
+        payoffs[p.name] = Math.round(payoff(p, p.name) * 1000) / 1000;
+        fairShare[p.name] = Math.round((Object.values(p.vals ?? {}).reduce((s, v) => s + num(v), 0) / Math.max(1, ps.length)) * 1000) / 1000;
+    }
+    let envyFree = true, proportional = true;
+    for (const p of ps) {
+        if (payoffs[p.name] + 1e-6 < fairShare[p.name])
+            proportional = false;
+        for (const q of ps)
+            if (q.name !== p.name && payoff(p, p.name) + 1e-6 < payoff(p, q.name))
+                envyFree = false;
+    }
+    const vals = ps.map((p) => payoffs[p.name]);
+    const equitable = vals.length >= 2 && Math.max(...vals) - Math.min(...vals) < 0.5;
+    const splitItems = items.filter((it) => Object.values(allocation[it] ?? {}).some((f) => f > 1e-6 && f < 1 - 1e-6));
+    return { envyFree, proportional, equitable, payoffs, fairShare, splitItems };
+}
+/** Adjusted Winner — envy-free + equitable + Pareto-optimal allocation for TWO parties. */
+export function adjustedWinner(a, b) {
+    const items = [...new Set([...Object.keys(a?.vals ?? {}), ...Object.keys(b?.vals ?? {})])];
+    const av = (i) => num(a.vals?.[i]), bv = (i) => num(b.vals?.[i]);
+    const frac = {}; // fraction of each item going to A
+    for (const i of items)
+        frac[i] = av(i) >= bv(i) ? 1 : 0; // phase 1: each item to its higher bidder
+    const payoffs = () => { let pa = 0, pb = 0; for (const i of items) {
+        pa += av(i) * frac[i];
+        pb += bv(i) * (1 - frac[i]);
+    } return [pa, pb]; };
+    let [pa, pb] = payoffs();
+    if (Math.abs(pa - pb) >= 1e-9) {
+        const richIsA = pa > pb;
+        // rich transfers its items, least-valued-relative-to-the-other first, until payoffs equalize (split the crossing item)
+        const pool = items.filter((i) => (richIsA ? frac[i] === 1 : frac[i] === 0))
+            .sort((x, y) => (richIsA ? av(x) / Math.max(bv(x), 1e-9) - av(y) / Math.max(bv(y), 1e-9) : bv(x) / Math.max(av(x), 1e-9) - bv(y) / Math.max(av(y), 1e-9)));
+        for (const i of pool) {
+            [pa, pb] = payoffs();
+            if (Math.abs(pa - pb) < 1e-9)
+                break;
+            if (richIsA ? pa <= pb : pb <= pa)
+                break;
+            const sum = av(i) + bv(i);
+            if (sum <= 0)
+                continue;
+            if (richIsA) {
+                const npa = pa - av(i), npb = pb + bv(i);
+                if (npa >= npb)
+                    frac[i] = 0; // full transfer keeps A ≥ B
+                else {
+                    frac[i] = Math.max(0, Math.min(1, 1 - (pa - pb) / sum));
+                    break;
+                } // split to equalize exactly
+            }
+            else {
+                const npb = pb - bv(i), npa = pa + av(i);
+                if (npb >= npa)
+                    frac[i] = 1;
+                else {
+                    frac[i] = Math.max(0, Math.min(1, (pb - pa) / sum));
+                    break;
+                }
+            }
+        }
+    }
+    const alloc = {};
+    for (const i of items)
+        alloc[i] = { [a.name]: Math.round(frac[i] * 1e6) / 1e6, [b.name]: Math.round((1 - frac[i]) * 1e6) / 1e6 };
+    return alloc;
+}
+/** Proportional sequential allocation for N parties (each ends with ≥ a 1/N share by their own values). */
+export function proportionalDivision(parties) {
+    const ps = (parties ?? []).filter((p) => p && p.name);
+    const items = [...new Set(ps.flatMap((p) => Object.keys(p.vals ?? {})))];
+    const alloc = {};
+    for (const i of items)
+        alloc[i] = Object.fromEntries(ps.map((p) => [p.name, 0]));
+    const remaining = new Set(items);
+    let turn = 0;
+    while (remaining.size) {
+        const p = ps[turn % ps.length];
+        let best = null, bestV = -Infinity;
+        for (const i of remaining) {
+            const v = num(p.vals?.[i]);
+            if (v > bestV) {
+                bestV = v;
+                best = i;
+            }
+        }
+        if (best == null)
+            break;
+        alloc[best] = Object.fromEntries(ps.map((q) => [q.name, q.name === p.name ? 1 : 0]));
+        remaining.delete(best);
+        turn++;
+    }
+    return alloc;
+}
+/** Mediate: Adjusted Winner for two parties (envy-free + equitable + Pareto), proportional for N>2. */
+export function mediate(parties) {
+    const ps = (parties ?? []).filter((p) => p && p.name && p.vals);
+    const items = [...new Set(ps.flatMap((p) => Object.keys(p.vals ?? {})))];
+    if (ps.length === 2) {
+        const allocation = adjustedWinner(ps[0], ps[1]);
+        const proof = verifyFairness(ps, allocation);
+        return { method: "adjusted-winner", allocation, proof, parties: ps.map((p) => p.name), items, note: "Adjusted Winner: envy-free + equitable + Pareto-optimal for two parties (at most one item split)." };
+    }
+    const allocation = proportionalDivision(ps);
+    const proof = verifyFairness(ps, allocation);
+    return { method: "proportional", allocation, proof, parties: ps.map((p) => p.name), items, note: `Proportional allocation for ${ps.length} parties (each ≥ a 1/${ps.length} fair share; envy-freeness is not guaranteed for N>2).` };
+}
+export function mediatorGauntlet() {
+    // classic 2-party split: A values house most; B values boat most; car contested.
+    const A = { name: "A", vals: { house: 50, car: 30, boat: 20 } };
+    const B = { name: "B", vals: { house: 30, car: 30, boat: 40 } };
+    const r = mediate([A, B]);
+    const houseToA = r.allocation["house"]["A"] === 1, boatToB = r.allocation["boat"]["B"] === 1;
+    const equalPayoff = Math.abs(r.proof.payoffs["A"] - r.proof.payoffs["B"]) < 0.5 && r.proof.payoffs["A"] >= 50;
+    const proven = r.proof.envyFree && r.proof.equitable && r.proof.proportional;
+    const oneSplit = r.proof.splitItems.length <= 1;
+    // tamper test: a biased allocation (give A everything) fails the neutrality re-check.
+    const biased = { house: { A: 1, B: 0 }, car: { A: 1, B: 0 }, boat: { A: 1, B: 0 } };
+    const tamperCaught = verifyFairness([A, B], biased).envyFree === false || verifyFairness([A, B], biased).proportional === false;
+    // N>2 proportional: each party gets ≥ its 1/3 fair share.
+    const three = mediate([{ name: "X", vals: { a: 60, b: 30, c: 10 } }, { name: "Y", vals: { a: 10, b: 60, c: 30 } }, { name: "Z", vals: { a: 30, b: 10, c: 60 } }]);
+    const propOK = three.method === "proportional" && three.proof.proportional;
+    const total = (() => { try {
+        mediate(null);
+        adjustedWinner(null, null);
+        verifyFairness(null, null);
+        proportionalDivision([]);
+        return true;
+    }
+    catch {
+        return false;
+    } })();
+    const checks = [
+        { name: "ADJUSTED-WINNER", pass: houseToA && boatToB, detail: "each item goes to the party that values it most (house→A, boat→B); the contested item is split to balance" },
+        { name: "EQUITABLE+PROPORTIONAL", pass: equalPayoff, detail: "both parties end with EQUAL perceived value, each ≥ their 50% fair share" },
+        { name: "PROVEN-FAIR", pass: proven && oneSplit, detail: "the result is envy-free + equitable + proportional, with at most one split item" },
+        { name: "NEUTRALITY-RECHECK-CATCHES-BIAS", pass: tamperCaught, detail: "verifyFairness re-checks from the parties' own values → a biased (give-A-everything) split fails envy-free/proportional" },
+        { name: "N-PARTY-PROPORTIONAL", pass: propOK, detail: "for 3 parties → proportional allocation, each ≥ a 1/3 fair share (envy-freeness honestly not claimed for N>2)" },
+        { name: "TOTAL", pass: total, detail: "null/garbage never throws" },
+    ];
+    return { score: checks.every((c) => c.pass) ? 100 : 0, checks };
+}
+//# sourceMappingURL=index.js.map

package/dist/mediator/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/mediator/index.ts"],"names":[],"mappings":"AA4BA,MAAM,GAAG,GAAG,CAAC,CAAU,EAAE,EAAE,GAAG,MAAM,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAEjG,yGAAyG;AACzG,MAAM,UAAU,cAAc,CAAC,OAA6B,EAAE,UAAsB;IAClF,MAAM,EAAE,GAAG,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC;IACtD,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,UAAU,IAAI,EAAE,CAAC,CAAC;IAC5C,MAAM,MAAM,GAAG,CAAC,CAAQ,EAAE,GAAW,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,CAAC,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAC3H,MAAM,OAAO,GAA2B,EAAE,CAAC;IAAC,MAAM,SAAS,GAA2B,EAAE,CAAC;IACzF,KAAK,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC;QAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC;QAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC;IAAC,CAAC;IAC5N,IAAI,QAAQ,GAAG,IAAI,EAAE,YAAY,GAAG,IAAI,CAAC;IACzC,KAAK,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC;QACnB,IAAI,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,IAAI,GAAG,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC;YAAE,YAAY,GAAG,KAAK,CAAC;QACrE,KAAK,MAAM,CAAC,IAAI,EAAE;YAAE,IAAI,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,IAAI,IAAI,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,IAAI,GAAG,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC;gBAAE,QAAQ,GAAG,KAAK,CAAC;IAC9G,CAAC;IACD,MAAM,IAAI,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;IAAC,MAAM,SAAS,GAAG,IAAI,CAAC,MAAM,IAAI,CAAC,IAAI,IAAI,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,GAAG,GAAG,CAAC;IAC/H,MAAM,UAAU,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC;IACnH,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,SAAS,EAAE,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,CAAC;AAC/E,CAAC;AAED,2FAA2F;AAC3F,MAAM,UAAU,cAAc,CAAC,CAAQ,EAAE,CAAQ;IAC/C,MAAM,KAAK,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,EAAE,IAAI,IAAI,EAAE,CAAC,EAAE,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,EAAE,IAAI,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IAC3F,MAAM,EAAE,GAAG,CAAC,CAAS,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,GAAG,CAAC,CAAS,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IACjF,MAAM,IAAI,GAA2B,EAAE,CAAC,CAA8B,mCAAmC;IACzG,KAAK,MAAM,CAAC,IAAI,KAAK;QAAE,IAAI,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAc,0CAA0C;IAChH,MAAM,OAAO,GAAG,GAAG,EAAE,GAAG,IAAI,EAAE,GAAG,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC,CAAC,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;QAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;IAAC,CAAC,CAAC,OAAO,CAAC,EAAE,EAAE,EAAE,CAAU,CAAC,CAAC,CAAC,CAAC;IACvJ,IAAI,CAAC,EAAE,EAAE,EAAE,CAAC,GAAG,OAAO,EAAE,CAAC;IACzB,IAAI,IAAI,CAAC,GAAG,CAAC,EAAE,GAAG,EAAE,CAAC,IAAI,IAAI,EAAE,CAAC;QAC9B,MAAM,OAAO,GAAG,EAAE,GAAG,EAAE,CAAC;QACxB,uHAAuH;QACvH,MAAM,IAAI,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC;aACxE,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC;QAC7J,KAAK,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC;YACrB,CAAC,EAAE,EAAE,EAAE,CAAC,GAAG,OAAO,EAAE,CAAC;YACrB,IAAI,IAAI,CAAC,GAAG,CAAC,EAAE,GAAG,EAAE,CAAC,GAAG,IAAI;gBAAE,MAAM;YACpC,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE;gBAAE,MAAM;YACzC,MAAM,GAAG,GAAG,EAAE,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC;YAAC,IAAI,GAAG,IAAI,CAAC;gBAAE,SAAS;YAClD,IAAI,OAAO,EAAE,CAAC;gBACZ,MAAM,GAAG,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC;gBACzC,IAAI,GAAG,IAAI,GAAG;oBAAE,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAoC,4BAA4B;qBACvF,CAAC;oBAAC,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,GAAG,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC;oBAAC,MAAM;gBAAC,CAAC,CAAG,4BAA4B;YACzG,CAAC;iBAAM,CAAC;gBACN,MAAM,GAAG,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC;gBACzC,IAAI,GAAG,IAAI,GAAG;oBAAE,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;qBACvB,CAAC;oBAAC,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC;oBAAC,MAAM;gBAAC,CAAC;YACtE,CAAC;QACH,CAAC;IACH,CAAC;IACD,MAAM,KAAK,GAAe,EAAE,CAAC;IAC7B,KAAK,MAAM,CAAC,IAAI,KAAK;QAAE,KAAK,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,GAAG,GAAG,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,GAAG,GAAG,EAAE,CAAC;IACjI,OAAO,KAAK,CAAC;AACf,CAAC;AAED,2GAA2G;AAC3G,MAAM,UAAU,oBAAoB,CAAC,OAA6B;IAChE,MAAM,EAAE,GAAG,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC;IACtD,MAAM,KAAK,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IACzE,MAAM,KAAK,GAAe,EAAE,CAAC;IAAC,KAAK,MAAM,CAAC,IAAI,KAAK;QAAE,KAAK,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,WAAW,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IAC/G,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC;IACjC,IAAI,IAAI,GAAG,CAAC,CAAC;IACb,OAAO,SAAS,CAAC,IAAI,EAAE,CAAC;QACtB,MAAM,CAAC,GAAG,EAAE,CAAC,IAAI,GAAG,EAAE,CAAC,MAAM,CAAC,CAAC;QAC/B,IAAI,IAAI,GAAkB,IAAI,EAAE,KAAK,GAAG,CAAC,QAAQ,CAAC;QAClD,KAAK,MAAM,CAAC,IAAI,SAAS,EAAE,CAAC;YAAC,MAAM,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;YAAC,IAAI,CAAC,GAAG,KAAK,EAAE,CAAC;gBAAC,KAAK,GAAG,CAAC,CAAC;gBAAC,IAAI,GAAG,CAAC,CAAC;YAAC,CAAC;QAAC,CAAC;QAClG,IAAI,IAAI,IAAI,IAAI;YAAE,MAAM;QACxB,KAAK,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,WAAW,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACrF,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAAC,IAAI,EAAE,CAAC;IACjC,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,uGAAuG;AACvG,MAAM,UAAU,OAAO,CAAC,OAA6B;IACnD,MAAM,EAAE,GAAG,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC;IAChE,MAAM,KAAK,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IACzE,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACpB,MAAM,UAAU,GAAG,cAAc,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;QAChD,MAAM,KAAK,GAAG,cAAc,CAAC,EAAE,EAAE,UAAU,CAAC,CAAC;QAC7C,OAAO,EAAE,MAAM,EAAE,iBAAiB,EAAE,UAAU,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,mGAAmG,EAAE,CAAC;IAC5M,CAAC;IACD,MAAM,UAAU,GAAG,oBAAoB,CAAC,EAAE,CAAC,CAAC;IAC5C,MAAM,KAAK,GAAG,cAAc,CAAC,EAAE,EAAE,UAAU,CAAC,CAAC;IAC7C,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,UAAU,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,+BAA+B,EAAE,CAAC,MAAM,wBAAwB,EAAE,CAAC,MAAM,wDAAwD,EAAE,CAAC;AACvO,CAAC;AAID,MAAM,UAAU,gBAAgB;IAC9B,iFAAiF;IACjF,MAAM,CAAC,GAAU,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,GAAG,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,EAAE,CAAC;IACvE,MAAM,CAAC,GAAU,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,GAAG,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,EAAE,CAAC;IACvE,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IAC1B,MAAM,QAAQ,GAAG,CAAC,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,OAAO,GAAG,CAAC,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IAC7F,MAAM,WAAW,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,GAAG,GAAG,IAAI,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC;IAC9G,MAAM,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,QAAQ,IAAI,CAAC,CAAC,KAAK,CAAC,SAAS,IAAI,CAAC,CAAC,KAAK,CAAC,YAAY,CAAC;IAC7E,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,UAAU,CAAC,MAAM,IAAI,CAAC,CAAC;IAChD,sFAAsF;IACtF,MAAM,MAAM,GAAe,EAAE,KAAK,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,GAAG,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,IAAI,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;IAChG,MAAM,YAAY,GAAG,cAAc,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,QAAQ,KAAK,KAAK,IAAI,cAAc,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,YAAY,KAAK,KAAK,CAAC;IAChI,0DAA0D;IAC1D,MAAM,KAAK,GAAG,OAAO,CAAC,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC;IAClK,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,KAAK,cAAc,IAAI,KAAK,CAAC,KAAK,CAAC,YAAY,CAAC;IAC3E,MAAM,KAAK,GAAG,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC;QAAC,OAAO,CAAC,IAAa,CAAC,CAAC;QAAC,cAAc,CAAC,IAAa,EAAE,IAAa,CAAC,CAAC;QAAC,cAAc,CAAC,IAAa,EAAE,IAAa,CAAC,CAAC;QAAC,oBAAoB,CAAC,EAAE,CAAC,CAAC;QAAC,OAAO,IAAI,CAAC;IAAC,CAAC;IAAC,MAAM,CAAC;QAAC,OAAO,KAAK,CAAC;IAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IACvN,MAAM,MAAM,GAAG;QACb,EAAE,IAAI,EAAE,iBAAiB,EAAE,IAAI,EAAE,QAAQ,IAAI,OAAO,EAAE,MAAM,EAAE,2GAA2G,EAAE;QAC3K,EAAE,IAAI,EAAE,wBAAwB,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,0EAA0E,EAAE;QACzI,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,IAAI,QAAQ,EAAE,MAAM,EAAE,iFAAiF,EAAE;QAC5I,EAAE,IAAI,EAAE,iCAAiC,EAAE,IAAI,EAAE,YAAY,EAAE,MAAM,EAAE,yHAAyH,EAAE;QAClM,EAAE,IAAI,EAAE,sBAAsB,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,+GAA+G,EAAE;QACvK,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,2BAA2B,EAAE;KACpE,CAAC;IACF,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC;AAClE,CAAC"}

package/dist/mediator/mediator.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=mediator.test.d.ts.map

package/dist/mediator/mediator.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mediator.test.d.ts","sourceRoot":"","sources":["../../src/mediator/mediator.test.ts"],"names":[],"mappings":""}

package/dist/mediator/mediator.test.js

@@ -0,0 +1,42 @@
+import { describe, it, expect } from "vitest";
+import { mediate, adjustedWinner, verifyFairness, proportionalDivision, mediatorGauntlet } from "./index.js";
+const A = { name: "A", vals: { house: 50, car: 30, boat: 20 } };
+const B = { name: "B", vals: { house: 30, car: 30, boat: 40 } };
+describe("mediator", () => {
+    it("gauntlet is 100", () => expect(mediatorGauntlet().score).toBe(100));
+    it("Adjusted Winner: high-bidder gets the item, contested item split, equal payoffs", () => {
+        const r = mediate([A, B]);
+        expect(r.method).toBe("adjusted-winner");
+        expect(r.allocation.house.A).toBe(1);
+        expect(r.allocation.boat.B).toBe(1);
+        expect(Math.abs(r.proof.payoffs.A - r.proof.payoffs.B)).toBeLessThan(0.5);
+        expect(r.proof.payoffs.A).toBeGreaterThanOrEqual(50);
+    });
+    it("the result is envy-free + equitable + proportional", () => {
+        const p = verifyFairness([A, B], adjustedWinner(A, B));
+        expect(p.envyFree).toBe(true);
+        expect(p.equitable).toBe(true);
+        expect(p.proportional).toBe(true);
+    });
+    it("neutrality re-check catches a biased allocation", () => {
+        const biased = { house: { A: 1, B: 0 }, car: { A: 1, B: 0 }, boat: { A: 1, B: 0 } };
+        const p = verifyFairness([A, B], biased);
+        expect(p.envyFree && p.proportional).toBe(false);
+    });
+    it("N>2 → proportional, each ≥ a 1/N fair share", () => {
+        const r = mediate([{ name: "X", vals: { a: 60, b: 30, c: 10 } }, { name: "Y", vals: { a: 10, b: 60, c: 30 } }, { name: "Z", vals: { a: 30, b: 10, c: 60 } }]);
+        expect(r.method).toBe("proportional");
+        expect(r.proof.proportional).toBe(true);
+    });
+    it("each item's shares sum to 1", () => {
+        const alloc = adjustedWinner(A, B);
+        for (const it of Object.keys(alloc))
+            expect(Object.values(alloc[it]).reduce((s, f) => s + f, 0)).toBeCloseTo(1, 4);
+    });
+    it("never throws on garbage", () => {
+        expect(() => mediate(null)).not.toThrow();
+        expect(() => adjustedWinner(null, null)).not.toThrow();
+        expect(() => proportionalDivision([])).not.toThrow();
+    });
+});
+//# sourceMappingURL=mediator.test.js.map

package/dist/mediator/mediator.test.js.map

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

package/dist/morph/index.d.ts

@@ -0,0 +1,107 @@
+/**
+ * v3.103.0 — MORPH: the polymorphic MCP tool (the "ferrofluid plug").
+ *
+ * THE PROBLEM IT SOLVES (the load-bearing adoption weakness): an AI agent that
+ * connects to Mneme — Cursor, Cline, Windsurf, Claude Code, anything — is faced
+ * with 600+ static MCP tools it has never seen. It cannot know which verb serves
+ * the moment, so most of Mneme sits installed-but-idle. Every other MCP server
+ * dumps its whole tool surface and hopes the agent guesses right.
+ *
+ * THE IDEA (the honest realization of the "schema-morphing plug"): expose ONE
+ * self-describing tool the agent learns once — `mneme.morph`. The agent states
+ * its intent in free natural language (any language, EN/Thai); MORPH "morphs"
+ * that intent into the RIGHT Mneme capability and hands back a typed CONTACT
+ * SURFACE — the exact MCP tool to call next, a runnable CLI invocation, and the
+ * args projected from the sentence — plus a CLARIFY when it is unsure. The agent
+ * never memorizes the catalog; it describes what it wants and gets the shaped
+ * next call. One plug that re-forms to fit whatever the caller needs.
+ *
+ * WHY IT IS NOVEL (and not just the Gateway again): the Intent Gateway resolves
+ * NL → a command STRING. MORPH adds the three things that make a single tool an
+ * agent's front door: (1) it resolves the concrete MCP TOOL name (not just the
+ * CLI verb), (2) it PROJECTS the detected entities into a ready-to-send args
+ * object — the "interface shaped to the request", and (3) the resolution is
+ * bound into an offline-verifiable signed morph-receipt at the MCP boundary, so
+ * the morph is auditable, not a black box. It composes the Gateway + the command
+ * manifest — refinement, not a new silo.
+ *
+ * DIAKRISIS — the honest ceiling: the "morphing" is DETERMINISTIC intent →
+ * capability resolution + entity projection (it reuses the measured Gateway
+ * router and the manifest), NOT runtime code generation and NOT model magic.
+ * MORPH never invents a capability the Gateway did not route to (the gauntlet
+ * proves faithfulness), it ABSTAINS (CLARIFY/UNKNOWN) rather than misfire, and
+ * the args projection is a best-effort starting point the agent maps onto the
+ * target tool's own schema — not a guarantee of every arg name. The CLI→MCP map
+ * is a curated, deterministic table (an unmapped command returns mcpTool=null and
+ * the agent uses the CLI invocation). Pure + deterministic + total.
+ */
+import { type GatewayResult } from "../intent_gateway/index.js";
+import { type ManifestCommand } from "../agent_manifest.js";
+/**
+ * Curated, deterministic CLI-command → MCP-tool-name map for the high-value
+ * capabilities (the same intents the Gateway concept-map curates). An agent over
+ * MCP wants the tool NAME, not the shell verb. Best-effort: a command absent here
+ * resolves to mcpTool=null and the agent falls back to the CLI invocation.
+ */
+export declare const COMMAND_TO_MCP: Readonly<Record<string, string>>;
+/** Resolve a CLI command to its MCP tool name (or null when unmapped). Total. */
+export declare function toMcpTool(command: string | null | undefined): string | null;
+export type MorphVerdict = "MORPHED" | "CLARIFY" | "UNKNOWN";
+export interface MorphCapability {
+    command: string;
+    mcpTool: string | null;
+    what: string;
+    when: string;
+    since: string;
+    group: string;
+}
+/** The typed contact surface — the "plug shaped to the request": the exact next
+ *  call the agent should make, with args projected from the sentence. */
+export interface MorphShape {
+    mcpTool: string | null;
+    cli: string | null;
+    /** Best-effort args projected from the detected entities + the raw intent.
+     *  The agent maps these onto the target tool's own input schema. */
+    args: Record<string, unknown>;
+}
+export interface MorphCandidate {
+    command: string;
+    mcpTool: string | null;
+    score: number;
+}
+export interface MorphResult {
+    verdict: MorphVerdict;
+    intent: string;
+    capability: MorphCapability | null;
+    confidence: number;
+    candidates: MorphCandidate[];
+    shape: MorphShape | null;
+    entities: GatewayResult["entities"];
+    note: string;
+}
+/**
+ * Morph a free-text intent into the right Mneme capability + a typed next-call
+ * surface. Composes the Gateway router (resolution + abstention + entities) with
+ * the manifest (the capability's what/when) and the CLI→MCP map. The verdict
+ * mirrors the Gateway: ROUTED→MORPHED, CLARIFY→CLARIFY, UNKNOWN→UNKNOWN — MORPH
+ * never routes to a capability the Gateway did not. Pure + deterministic + total.
+ */
+export declare function morph(intent: string, opts?: {
+    catalog?: ManifestCommand[];
+    minConfidence?: number;
+}): MorphResult;
+export interface MorphGauntlet {
+    morphsKnownIntents: boolean;
+    faithfulToGateway: boolean;
+    resolvesMcpTool: boolean;
+    projectsEntities: boolean;
+    shapeIsActionable: boolean;
+    bilingual: boolean;
+    abstainsOnGibberish: boolean;
+    mapWellFormed: boolean;
+    deterministic: boolean;
+    total: boolean;
+    score: 0 | 100;
+}
+export declare function morphGauntlet(): MorphGauntlet;
+//# sourceMappingURL=index.d.ts.map

package/dist/morph/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/morph/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AAEH,OAAO,EAAyB,KAAK,aAAa,EAAE,MAAM,4BAA4B,CAAC;AACvF,OAAO,EAAyB,KAAK,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAEnF;;;;;GAKG;AACH,eAAO,MAAM,cAAc,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAwB1D,CAAC;AAEH,iFAAiF;AACjF,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,GAAG,IAAI,CAI3E;AAED,MAAM,MAAM,YAAY,GAAG,SAAS,GAAG,SAAS,GAAG,SAAS,CAAC;AAE7D,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACf;AAED;yEACyE;AACzE,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB;wEACoE;IACpE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC/B;AAED,MAAM,WAAW,cAAc;IAAG,OAAO,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE;AAE1F,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,YAAY,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,eAAe,GAAG,IAAI,CAAC;IACnC,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,cAAc,EAAE,CAAC;IAC7B,KAAK,EAAE,UAAU,GAAG,IAAI,CAAC;IACzB,QAAQ,EAAE,aAAa,CAAC,UAAU,CAAC,CAAC;IACpC,IAAI,EAAE,MAAM,CAAC;CACd;AAwBD;;;;;;GAMG;AACH,wBAAgB,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;IAAE,OAAO,CAAC,EAAE,eAAe,EAAE,CAAC;IAAC,aAAa,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,WAAW,CA4BjH;AAGD,MAAM,WAAW,aAAa;IAC5B,kBAAkB,EAAE,OAAO,CAAC;IAC5B,iBAAiB,EAAE,OAAO,CAAC;IAC3B,eAAe,EAAE,OAAO,CAAC;IACzB,gBAAgB,EAAE,OAAO,CAAC;IAC1B,iBAAiB,EAAE,OAAO,CAAC;IAC3B,SAAS,EAAE,OAAO,CAAC;IACnB,mBAAmB,EAAE,OAAO,CAAC;IAC7B,aAAa,EAAE,OAAO,CAAC;IACvB,aAAa,EAAE,OAAO,CAAC;IACvB,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,EAAE,CAAC,GAAG,GAAG,CAAC;CAChB;AAED,wBAAgB,aAAa,IAAI,aAAa,CAiD7C"}

package/dist/morph/index.js

@@ -0,0 +1,183 @@
+/**
+ * v3.103.0 — MORPH: the polymorphic MCP tool (the "ferrofluid plug").
+ *
+ * THE PROBLEM IT SOLVES (the load-bearing adoption weakness): an AI agent that
+ * connects to Mneme — Cursor, Cline, Windsurf, Claude Code, anything — is faced
+ * with 600+ static MCP tools it has never seen. It cannot know which verb serves
+ * the moment, so most of Mneme sits installed-but-idle. Every other MCP server
+ * dumps its whole tool surface and hopes the agent guesses right.
+ *
+ * THE IDEA (the honest realization of the "schema-morphing plug"): expose ONE
+ * self-describing tool the agent learns once — `mneme.morph`. The agent states
+ * its intent in free natural language (any language, EN/Thai); MORPH "morphs"
+ * that intent into the RIGHT Mneme capability and hands back a typed CONTACT
+ * SURFACE — the exact MCP tool to call next, a runnable CLI invocation, and the
+ * args projected from the sentence — plus a CLARIFY when it is unsure. The agent
+ * never memorizes the catalog; it describes what it wants and gets the shaped
+ * next call. One plug that re-forms to fit whatever the caller needs.
+ *
+ * WHY IT IS NOVEL (and not just the Gateway again): the Intent Gateway resolves
+ * NL → a command STRING. MORPH adds the three things that make a single tool an
+ * agent's front door: (1) it resolves the concrete MCP TOOL name (not just the
+ * CLI verb), (2) it PROJECTS the detected entities into a ready-to-send args
+ * object — the "interface shaped to the request", and (3) the resolution is
+ * bound into an offline-verifiable signed morph-receipt at the MCP boundary, so
+ * the morph is auditable, not a black box. It composes the Gateway + the command
+ * manifest — refinement, not a new silo.
+ *
+ * DIAKRISIS — the honest ceiling: the "morphing" is DETERMINISTIC intent →
+ * capability resolution + entity projection (it reuses the measured Gateway
+ * router and the manifest), NOT runtime code generation and NOT model magic.
+ * MORPH never invents a capability the Gateway did not route to (the gauntlet
+ * proves faithfulness), it ABSTAINS (CLARIFY/UNKNOWN) rather than misfire, and
+ * the args projection is a best-effort starting point the agent maps onto the
+ * target tool's own schema — not a guarantee of every arg name. The CLI→MCP map
+ * is a curated, deterministic table (an unmapped command returns mcpTool=null and
+ * the agent uses the CLI invocation). Pure + deterministic + total.
+ */
+import { route as gatewayRoute } from "../intent_gateway/index.js";
+import { MNEME_COMMAND_CATALOG } from "../agent_manifest.js";
+/**
+ * Curated, deterministic CLI-command → MCP-tool-name map for the high-value
+ * capabilities (the same intents the Gateway concept-map curates). An agent over
+ * MCP wants the tool NAME, not the shell verb. Best-effort: a command absent here
+ * resolves to mcpTool=null and the agent falls back to the CLI invocation.
+ */
+export const COMMAND_TO_MCP = Object.freeze({
+    "mneme verify": "mneme.truth.check",
+    "mneme telos": "mneme.drift.analyze",
+    "mneme govern": "mneme.govern.decide",
+    "mneme crucible": "mneme.crucible.settle",
+    "mneme haunt": "mneme.haunt.investigate",
+    "mneme cortex": "mneme.cortex.recall",
+    "mneme firewall": "mneme.firewall.fortify",
+    "mneme egress": "mneme.egress.guard",
+    "mneme outline": "mneme.outline.file",
+    "mneme canon": "mneme.canon.emit",
+    "mneme regret": "mneme.regret.score",
+    "mneme elleipsis": "mneme.elleipsis.check",
+    "mneme pce": "mneme.pce.certify",
+    "mneme boot": "mneme.boot",
+    "mneme savings": "mneme.treasury.report",
+    "mneme rail": "mneme.rail.traverse",
+    "mneme blind": "mneme.blind.context",
+    "mneme membrane": "mneme.membrane.fuse",
+    "mneme stele": "mneme.stele.sync",
+    "mneme moat": "mneme.moat.score",
+    "mneme siege": "mneme.siege.run",
+    "mneme mycelium": "mneme.mycelium.bundle",
+    "mneme gateway": "mneme.gateway.route",
+});
+/** Resolve a CLI command to its MCP tool name (or null when unmapped). Total. */
+export function toMcpTool(command) {
+    if (typeof command !== "string")
+        return null;
+    const key = command.trim().split(/\s+/).slice(0, 2).join(" ");
+    return COMMAND_TO_MCP[key] ?? COMMAND_TO_MCP[command.trim()] ?? null;
+}
+const NOTE = "MORPH is a single polymorphic surface: state an intent, get the shaped next call (MCP tool + CLI + projected args), signed. Deterministic intent→capability resolution over the measured Gateway + the manifest — it abstains (CLARIFY/UNKNOWN) rather than misfire, and never invents a capability the Gateway did not route to.";
+function catalogEntry(command, catalog) {
+    // exact match first, then the 2-token CLI prefix (e.g. "mneme telos")
+    const exact = catalog.find((c) => c.command === command);
+    if (exact)
+        return exact;
+    const key = command.trim().split(/\s+/).slice(0, 2).join(" ");
+    return catalog.find((c) => c.command === key) ?? catalog.find((c) => c.command.startsWith(key)) ?? null;
+}
+/** Project the detected entities + the raw intent into a best-effort args object. */
+function projectArgs(intent, entities) {
+    const args = { intent: String(intent ?? "").slice(0, 500) };
+    try {
+        if (typeof entities?.budget === "number")
+            args["budget"] = entities.budget;
+        if (Array.isArray(entities?.forbidden) && entities.forbidden.length)
+            args["forbidden"] = entities.forbidden;
+        if (Array.isArray(entities?.scope) && entities.scope.length)
+            args["scope"] = entities.scope;
+    }
+    catch { /* */ }
+    return args;
+}
+/**
+ * Morph a free-text intent into the right Mneme capability + a typed next-call
+ * surface. Composes the Gateway router (resolution + abstention + entities) with
+ * the manifest (the capability's what/when) and the CLI→MCP map. The verdict
+ * mirrors the Gateway: ROUTED→MORPHED, CLARIFY→CLARIFY, UNKNOWN→UNKNOWN — MORPH
+ * never routes to a capability the Gateway did not. Pure + deterministic + total.
+ */
+export function morph(intent, opts) {
+    try {
+        const catalog = Array.isArray(opts?.catalog) ? opts.catalog : MNEME_COMMAND_CATALOG;
+        const r = gatewayRoute(intent, { catalog, ...(typeof opts?.minConfidence === "number" ? { minConfidence: opts.minConfidence } : {}) });
+        const intentStr = String(intent ?? "");
+        const candidates = (r.candidates ?? []).map((c) => ({ command: c.command, mcpTool: toMcpTool(c.command), score: c.score }));
+        if (r.verdict !== "ROUTED" || !r.command) {
+            return { verdict: r.verdict === "CLARIFY" ? "CLARIFY" : "UNKNOWN", intent: intentStr, capability: null, confidence: r.confidence, candidates, shape: null, entities: r.entities, note: NOTE };
+        }
+        const entry = catalogEntry(r.command, catalog);
+        const mcpTool = toMcpTool(r.command);
+        const capability = {
+            command: r.command,
+            mcpTool,
+            what: entry?.what ?? "",
+            when: entry?.when ?? "",
+            since: entry?.since ?? "",
+            group: entry?.group ?? "",
+        };
+        const shape = { mcpTool, cli: r.invocation ?? r.command, args: projectArgs(intentStr, r.entities) };
+        return { verdict: "MORPHED", intent: intentStr, capability, confidence: r.confidence, candidates, shape, entities: r.entities, note: NOTE };
+    }
+    catch {
+        return { verdict: "UNKNOWN", intent: String(intent ?? ""), capability: null, confidence: 0, candidates: [], shape: null, entities: {}, note: NOTE };
+    }
+}
+export function morphGauntlet() {
+    // 1) morphs known EN + Thai intents to the expected capability
+    const known = [
+        ["stop all the bots, something feels off", "mneme govern"],
+        ["who wrote this function last and why", "mneme haunt"],
+        ["ใครแก้ฟังก์ชันนี้ล่าสุดและทำไม", "mneme haunt"],
+        ["is this claim actually true", "mneme verify"],
+        ["check if our agents are drifting from their mission", "mneme telos"],
+    ];
+    const morphsKnownIntents = known.every(([q, exp]) => { const m = morph(q); return m.verdict === "MORPHED" && m.capability?.command === exp; });
+    // 2) faithful: for the same input, MORPH's command == the Gateway's routed command (no drift)
+    const faithfulToGateway = known.every(([q]) => {
+        const g = gatewayRoute(q);
+        const m = morph(q);
+        if (g.verdict !== "ROUTED")
+            return m.verdict !== "MORPHED";
+        return m.capability?.command === g.command;
+    });
+    // 3) resolves the concrete MCP tool name for a mapped capability
+    const truth = morph("is this claim actually true");
+    const resolvesMcpTool = truth.capability?.mcpTool === "mneme.truth.check" && truth.shape?.mcpTool === "mneme.truth.check";
+    // 4) projects entities into the shaped args
+    const gov = morph("ดูแลเรื่องงบ 50000 ห้ามโพสต์ด่าใคร");
+    const projectsEntities = gov.verdict === "MORPHED" && gov.capability?.command === "mneme govern" && (gov.shape?.args["budget"] === 50000) && Array.isArray(gov.shape?.args["forbidden"]) && gov.shape.args["forbidden"].length > 0;
+    // 5) a MORPHED result always hands back an actionable next call
+    const shapeIsActionable = known.every(([q]) => { const m = morph(q); return m.verdict !== "MORPHED" || !!(m.shape && (m.shape.mcpTool || m.shape.cli)); });
+    // 6) bilingual
+    const bilingual = morph("who wrote this function last and why").capability?.command === morph("ใครแก้ฟังก์ชันนี้ล่าสุดและทำไม").capability?.command;
+    // 7) abstains on gibberish
+    const gib = morph("asdfghjkl qwerty zzz");
+    const abstainsOnGibberish = gib.verdict !== "MORPHED";
+    // 8) the CLI→MCP map is well-formed (every value a valid mneme.* tool name)
+    const mapWellFormed = Object.values(COMMAND_TO_MCP).every((t) => /^mneme\.[a-z_]+(\.[a-z_]+)?$/.test(t)) && Object.keys(COMMAND_TO_MCP).every((k) => k.startsWith("mneme "));
+    // 9) deterministic
+    const deterministic = JSON.stringify(morph("stop all the bots")) === JSON.stringify(morph("stop all the bots"));
+    // 10) total — garbage never throws
+    let total = true;
+    try {
+        morph(null);
+        morph("");
+        morph(undefined);
+        toMcpTool(null);
+    }
+    catch {
+        total = false;
+    }
+    const all = morphsKnownIntents && faithfulToGateway && resolvesMcpTool && projectsEntities && shapeIsActionable && bilingual && abstainsOnGibberish && mapWellFormed && deterministic && total;
+    return { morphsKnownIntents, faithfulToGateway, resolvesMcpTool, projectsEntities, shapeIsActionable, bilingual, abstainsOnGibberish, mapWellFormed, deterministic, total, score: all ? 100 : 0 };
+}
+//# sourceMappingURL=index.js.map

package/dist/morph/index.js.map

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

package/dist/morph/morph.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=morph.test.d.ts.map

package/dist/morph/morph.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"morph.test.d.ts","sourceRoot":"","sources":["../../src/morph/morph.test.ts"],"names":[],"mappings":""}

package/dist/morph/morph.test.js

@@ -0,0 +1,48 @@
+import { describe, it, expect } from "vitest";
+import { morph, morphGauntlet, toMcpTool, COMMAND_TO_MCP } from "./index.js";
+describe("v3.103 · MORPH — the polymorphic MCP tool", () => {
+    it("gauntlet is 100", () => {
+        expect(morphGauntlet().score).toBe(100);
+    });
+    it("morphs a free-text intent into the right capability + MCP tool", () => {
+        const m = morph("is this claim actually true");
+        expect(m.verdict).toBe("MORPHED");
+        expect(m.capability?.command).toBe("mneme verify");
+        expect(m.capability?.mcpTool).toBe("mneme.truth.check");
+        expect(m.shape?.mcpTool).toBe("mneme.truth.check");
+    });
+    it("hands back an actionable, typed next call (the contact surface)", () => {
+        const m = morph("who wrote this function last and why");
+        expect(m.verdict).toBe("MORPHED");
+        expect(m.shape).toBeTruthy();
+        expect(m.shape.mcpTool || m.shape.cli).toBeTruthy();
+        expect(typeof m.shape.args["intent"]).toBe("string");
+    });
+    it("projects detected entities into the shaped args (EN+Thai)", () => {
+        const m = morph("ดูแลเรื่องงบ 50000 ห้ามโพสต์ด่าใคร");
+        expect(m.capability?.command).toBe("mneme govern");
+        expect(m.shape?.args["budget"]).toBe(50000);
+        expect((m.shape?.args["forbidden"]).length).toBeGreaterThan(0);
+    });
+    it("is faithful: never invents a capability the Gateway did not route to", () => {
+        // gibberish must not MORPH to anything
+        expect(morph("asdfghjkl qwerty zzz").verdict).not.toBe("MORPHED");
+    });
+    it("is bilingual: same intent EN/Thai → same capability", () => {
+        expect(morph("who wrote this function last and why").capability?.command)
+            .toBe(morph("ใครแก้ฟังก์ชันนี้ล่าสุดและทำไม").capability?.command);
+    });
+    it("toMcpTool resolves the 2-token prefix + the map is well-formed", () => {
+        expect(toMcpTool("mneme telos")).toBe("mneme.drift.analyze");
+        expect(toMcpTool("mneme.unknown.verb")).toBe(null);
+        expect(toMcpTool(null)).toBe(null);
+        for (const t of Object.values(COMMAND_TO_MCP))
+            expect(t).toMatch(/^mneme\.[a-z_]+(\.[a-z_]+)?$/);
+    });
+    it("is total — garbage never throws", () => {
+        expect(() => morph(null)).not.toThrow();
+        expect(() => morph("")).not.toThrow();
+        expect(morph("").verdict).not.toBe("MORPHED");
+    });
+});
+//# sourceMappingURL=morph.test.js.map

package/dist/morph/morph.test.js.map

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

package/dist/trust_service/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/trust_service/index.ts"],"names":[],"mappings":"AAgCA,MAAM,WAAW,YAAY;IAAG,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE;AAC7F,MAAM,WAAW,aAAa;IAAG,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE;AAEhF,eAAO,MAAM,eAAe;;;;GAO3B,CAAC;AAKF,uHAAuH;AACvH,wBAAgB,UAAU,CAAC,GAAG,EAAE,YAAY,EAAE,IAAI,CAAC,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,aAAa,CA4CtF;AAED,oGAAoG;AACpG,wBAAgB,WAAW,IAAI,MAAM,CAiDpC;AAGD,MAAM,WAAW,oBAAoB;IAAG,KAAK,EAAE,CAAC,GAAG,GAAG,CAAC;IAAC,MAAM,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAAE;AACxH,wBAAgB,oBAAoB,IAAI,oBAAoB,CAkC3D"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/trust_service/index.ts"],"names":[],"mappings":"AAiCA,MAAM,WAAW,YAAY;IAAG,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE;AAC7F,MAAM,WAAW,aAAa;IAAG,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE;AAEhF,eAAO,MAAM,eAAe;;;;GAQ3B,CAAC;AAKF,uHAAuH;AACvH,wBAAgB,UAAU,CAAC,GAAG,EAAE,YAAY,EAAE,IAAI,CAAC,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,aAAa,CAkDtF;AAED,oGAAoG;AACpG,wBAAgB,WAAW,IAAI,MAAM,CAiDpC;AAGD,MAAM,WAAW,oBAAoB;IAAG,KAAK,EAAE,CAAC,GAAG,GAAG,CAAC;IAAC,MAAM,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAAE;AACxH,wBAAgB,oBAAoB,IAAI,oBAAoB,CAkC3D"}