@mneme-ai/mcp 1.17.6 → 1.19.0

package/dist/tools/_tool_meta.js

@@ -0,0 +1,530 @@
+/**
+ * Foundation tools (v1.18.0) — Tool Contract Schema introspection +
+ * discovery aids:
+ *
+ *   • mneme.tool.contract(name) — return the full 6-field contract for one tool
+ *     (WHEN, INPUT, OUTPUT, EXAMPLES, PITFALLS, COMPOSE_WITH, JARGON).
+ *   • mneme.tool.lint            — scan every registered tool, score the
+ *     contract quality, return a prioritized punch-list of weak/missing fields.
+ *   • mneme.help(query)          — sub-50ms top-5 tool matcher for free-text
+ *     queries. Lighter-weight than understand_intent (no execution plan,
+ *     no arg extraction — just "which tools are about this?").
+ *   • mneme.whats_new(lastSeenHash?) — diff vs the catalog hash an agent
+ *     remembered from a previous session. Returns adds / removes /
+ *     description-changes so the agent can update its mental model
+ *     without re-reading the entire catalog.
+ *
+ * All four are pure (no repo state, no LLM, no embedder) — safe to call
+ * from any agent at any time. They form the discovery surface that lets
+ * AI agents stay in sync with Mneme as it evolves.
+ */
+import { createHash } from "node:crypto";
+import { buildAllTools } from "./_registry.js";
+/** Build a deterministic snapshot of every tool's PUBLIC contract surface.
+ *  Excludes handlers, triggers, jargon — those are internal. The hash of
+ *  this snapshot is what `mneme.whats_new` compares against. */
+function snapshotCatalog() {
+    return buildAllTools()
+        .map((t) => {
+        const e = {
+            name: t.name,
+            description: t.description,
+            inputSchema: t.inputSchema,
+        };
+        if (t.outputSchema)
+            e.outputSchema = t.outputSchema;
+        if (t.whenToUse)
+            e.whenToUse = t.whenToUse;
+        if (t.examples)
+            e.examples = t.examples;
+        if (t.pitfalls)
+            e.pitfalls = t.pitfalls;
+        if (t.composeWith)
+            e.composeWith = t.composeWith;
+        return e;
+    })
+        .sort((a, b) => a.name.localeCompare(b.name));
+}
+/** SHA-256 of the JSON-stringified catalog snapshot. Stable across runs. */
+export function computeCatalogHash() {
+    const json = JSON.stringify(snapshotCatalog());
+    return createHash("sha256").update(json).digest("hex").slice(0, 16);
+}
+// ─── mneme.tool.contract — full contract for one tool ────────────────────────
+export const toolContractTool = {
+    name: "mneme.tool.contract",
+    category: "meta",
+    description: "Return the FULL 6-field tool contract for a single Mneme tool by name: " +
+        "WHEN to use, INPUT schema, OUTPUT schema, worked EXAMPLES, PITFALLS, " +
+        "and COMPOSE_WITH neighbors. Use WHEN you've seen a tool name in a " +
+        "response and want to know exactly how to call it before invoking. " +
+        "Sub-millisecond — pure registry lookup, no I/O.",
+    whenToUse: "You need exact invocation guidance for a single tool — its inputs, " +
+        "its output shape, real examples, and known caveats — before calling.",
+    triggers: [
+        "what does mneme.X do?",
+        "show contract for mneme.audit.certify",
+        "tool contract",
+    ],
+    inputSchema: {
+        type: "object",
+        properties: {
+            name: {
+                type: "string",
+                description: "Exact tool name, e.g. 'mneme.audit.certify' or 'mneme.memory.ask'.",
+            },
+        },
+        required: ["name"],
+    },
+    outputSchema: {
+        type: "object",
+        properties: {
+            name: { type: "string" },
+            category: { type: "string" },
+            description: { type: "string" },
+            whenToUse: { type: "string" },
+            inputSchema: { type: "object" },
+            outputSchema: { type: "object" },
+            examples: { type: "array" },
+            pitfalls: { type: "array", items: { type: "string" } },
+            composeWith: { type: "array", items: { type: "string" } },
+            jargon: { type: "object" },
+            contractCompleteness: {
+                type: "number",
+                description: "0-100. How many of the 6 contract fields are populated.",
+            },
+        },
+    },
+    examples: [
+        {
+            userQuery: "How do I call mneme.audit.certify?",
+            args: { name: "mneme.audit.certify" },
+            expectedOutput: "Returns the certify tool's full contract — its 5-axis trust model, the explain/strict input flags, the verdict shape (PASS/WARN/FAIL + findings), and the natural follow-up tools.",
+        },
+    ],
+    pitfalls: [
+        "Tool names are case-sensitive and dotted — 'mneme.audit.certify' (not 'mneme/audit/certify' or 'audit.certify').",
+        "Returns 404-style error if the name isn't in the static registry — dynamic-pack tools live in their pack manifest, not here.",
+    ],
+    composeWith: ["mneme.capabilities", "mneme.help", "mneme.tool.lint"],
+    handler: async (_rt, args) => {
+        const name = String(args["name"] ?? "");
+        if (!name) {
+            return {
+                data: { error: "missing required argument: name" },
+                wisdom: "Pass the exact tool name (e.g., 'mneme.audit.certify') to retrieve its contract.",
+                confidence: { level: "high" },
+            };
+        }
+        const tool = buildAllTools().find((t) => t.name === name);
+        if (!tool) {
+            return {
+                data: { error: `tool not found: ${name}` },
+                wisdom: `No static tool named '${name}'. Try mneme.help with a free-text query, or mneme.capabilities to browse the catalog.`,
+                confidence: { level: "high" },
+                followUp: ["mneme.help", "mneme.capabilities"],
+            };
+        }
+        const completeness = scoreContract(tool);
+        return {
+            data: {
+                name: tool.name,
+                category: tool.category,
+                description: tool.description,
+                whenToUse: tool.whenToUse ?? null,
+                inputSchema: tool.inputSchema,
+                outputSchema: tool.outputSchema ?? null,
+                examples: tool.examples ?? [],
+                pitfalls: tool.pitfalls ?? [],
+                composeWith: tool.composeWith ?? [],
+                jargon: tool.jargon ?? {},
+                triggers: tool.triggers,
+                contractCompleteness: completeness,
+            },
+            wisdom: `${tool.name} (${tool.category}) — contract is ${completeness}% complete. ` +
+                (completeness < 60
+                    ? "Some fields are missing; the description still teaches WHEN to use, but examples/pitfalls would help."
+                    : "Rich contract. Read examples + pitfalls before invoking."),
+            followUp: tool.composeWith ?? [],
+            confidence: { level: "high" },
+        };
+    },
+};
+/** Score a tool's contract on a 0-100 scale. 6 fields × ~16 points each.
+ *  Description quality (length, clarity) acts as the floor — a tool with a
+ *  short description scores low even if other fields are filled. */
+function scoreContract(tool) {
+    let score = 0;
+    // Description ≥200 chars + must mention "WHEN" to score full points.
+    if (tool.description.length >= 200)
+        score += 16;
+    else if (tool.description.length >= 100)
+        score += 8;
+    if (/WHEN|when you|use when|use this/i.test(tool.description))
+        score += 4;
+    // Optional contract fields.
+    if (tool.whenToUse && tool.whenToUse.length >= 30)
+        score += 14;
+    if (tool.outputSchema)
+        score += 16;
+    if (tool.examples && tool.examples.length >= 1)
+        score += 16;
+    if (tool.pitfalls && tool.pitfalls.length >= 1)
+        score += 12;
+    if (tool.composeWith && tool.composeWith.length >= 1)
+        score += 12;
+    // Jargon dictionary — mandatory for known jargon-heavy categories.
+    const jargonHeavy = ["quant", "forensics"];
+    if (jargonHeavy.includes(tool.category)) {
+        if (tool.jargon && Object.keys(tool.jargon).length >= 1)
+            score += 10;
+    }
+    else {
+        // Non-jargon categories get the points free.
+        score += 10;
+    }
+    return Math.min(100, score);
+}
+function lintTool(tool) {
+    const missing = [];
+    const warnings = [];
+    if (tool.description.length < 100) {
+        warnings.push(`description is only ${tool.description.length} chars (recommend ≥200)`);
+    }
+    if (!/WHEN|when you|use when|use this/i.test(tool.description)) {
+        warnings.push("description lacks an explicit WHEN clause");
+    }
+    if (!tool.whenToUse)
+        missing.push("whenToUse");
+    if (!tool.outputSchema)
+        missing.push("outputSchema");
+    if (!tool.examples || tool.examples.length === 0)
+        missing.push("examples");
+    if (!tool.pitfalls || tool.pitfalls.length === 0)
+        missing.push("pitfalls");
+    if (!tool.composeWith || tool.composeWith.length === 0)
+        missing.push("composeWith");
+    const jargonHeavy = ["quant", "forensics"];
+    if (jargonHeavy.includes(tool.category) && (!tool.jargon || Object.keys(tool.jargon).length === 0)) {
+        missing.push("jargon (required for quant/forensics)");
+    }
+    return {
+        name: tool.name,
+        category: tool.category,
+        score: scoreContract(tool),
+        missing,
+        warnings,
+    };
+}
+export const toolLintTool = {
+    name: "mneme.tool.lint",
+    category: "meta",
+    description: "Self-validate every Mneme tool's contract quality. Returns each tool's " +
+        "score (0-100) plus a punch-list of missing fields (whenToUse, " +
+        "outputSchema, examples, pitfalls, composeWith, jargon) and warnings " +
+        "(short description, missing WHEN clause). Use WHEN you want to know " +
+        "which tools are still under-documented, or to verify the catalog meets " +
+        "the v1.18 contract bar before relying on a specific tool.",
+    whenToUse: "You want a top-down audit of which Mneme tools have full contracts vs which are still description-only.",
+    triggers: ["lint mneme tools", "tool contract quality", "which tools lack examples"],
+    inputSchema: {
+        type: "object",
+        properties: {
+            minScore: {
+                type: "number",
+                description: "Filter — only return tools scoring below this threshold (0-100). Default: 100 (return all).",
+            },
+            category: {
+                type: "string",
+                description: "Filter — only audit one category (memory|people|audit|forensics|insights|quality|quant|lab|meta).",
+            },
+        },
+    },
+    outputSchema: {
+        type: "object",
+        properties: {
+            totalTools: { type: "number" },
+            averageScore: { type: "number" },
+            passing: { type: "number", description: "Count of tools with score ≥80." },
+            findings: {
+                type: "array",
+                items: {
+                    type: "object",
+                    properties: {
+                        name: { type: "string" },
+                        category: { type: "string" },
+                        score: { type: "number" },
+                        missing: { type: "array", items: { type: "string" } },
+                        warnings: { type: "array", items: { type: "string" } },
+                    },
+                },
+            },
+        },
+    },
+    examples: [
+        {
+            userQuery: "Which Mneme tools have weak contracts?",
+            args: { minScore: 70 },
+            expectedOutput: "Returns every tool scoring under 70 with the specific fields they're missing, sorted worst-first.",
+        },
+        {
+            userQuery: "Audit the quant tools' jargon coverage",
+            args: { category: "quant" },
+            expectedOutput: "Returns all 10 quant.* tools with jargon-coverage flagged in `missing` if any uses 'Greeks' / 'Kelly' / 'alpha' without a jargon dictionary.",
+        },
+    ],
+    pitfalls: [
+        "Score is a heuristic — a 100-point tool isn't guaranteed bug-free, just well-documented.",
+        "minScore filter is exclusive: minScore=80 returns tools BELOW 80, so 80-pointers are hidden.",
+    ],
+    composeWith: ["mneme.tool.contract", "mneme.capabilities"],
+    handler: async (_rt, args) => {
+        const minScore = typeof args["minScore"] === "number" ? args["minScore"] : 100;
+        const categoryFilter = args["category"] ? String(args["category"]) : undefined;
+        const all = buildAllTools();
+        const findings = all
+            .filter((t) => !categoryFilter || t.category === categoryFilter)
+            .map(lintTool)
+            .filter((f) => f.score < minScore)
+            .sort((a, b) => a.score - b.score);
+        const scoresAll = all.map((t) => scoreContract(t));
+        const avg = scoresAll.length ? Math.round(scoresAll.reduce((a, b) => a + b, 0) / scoresAll.length) : 0;
+        const passing = scoresAll.filter((s) => s >= 80).length;
+        return {
+            data: {
+                totalTools: all.length,
+                averageScore: avg,
+                passing,
+                findings,
+            },
+            wisdom: `Audited ${all.length} tools — average contract score ${avg}/100, ${passing} passing (≥80). ` +
+                (findings.length > 0
+                    ? `${findings.length} tool${findings.length === 1 ? "" : "s"} fall${findings.length === 1 ? "s" : ""} below the filter; ${findings[0].name} is weakest at ${findings[0].score}/100.`
+                    : "All tools meet the filter."),
+            confidence: { level: "high" },
+            followUp: ["mneme.tool.contract"],
+        };
+    },
+};
+// ─── mneme.help — fast top-5 tool matcher for free-text queries ──────────────
+/** Lightweight word-overlap scorer — no LLM, no embedder. Tokenizes both
+ *  the query and (description + name + triggers) and counts shared
+ *  alphabetic tokens, weighted by inverse frequency across the catalog
+ *  (so common words like "code" score less than rare ones like "atrophy"). */
+function tokenize(s) {
+    return (s.toLowerCase().match(/[a-z][a-z0-9]+/g) ?? []).filter((w) => w.length >= 3);
+}
+function scoreTool(query, tool, idf) {
+    const qTokens = new Set(tokenize(query));
+    if (qTokens.size === 0)
+        return 0;
+    const haystack = tokenize(`${tool.name} ${tool.description} ${tool.triggers.join(" ")} ${tool.whenToUse ?? ""}`);
+    const haystackSet = new Set(haystack);
+    let score = 0;
+    for (const t of qTokens) {
+        if (haystackSet.has(t)) {
+            score += idf.get(t) ?? 1;
+        }
+    }
+    // Boost when an exact trigger phrase appears verbatim in the query.
+    for (const trig of tool.triggers) {
+        if (query.toLowerCase().includes(trig.toLowerCase()))
+            score += 5;
+    }
+    return score;
+}
+function buildIdf(tools) {
+    const docFreq = new Map();
+    for (const t of tools) {
+        const tokens = new Set(tokenize(`${t.name} ${t.description} ${t.triggers.join(" ")}`));
+        for (const tok of tokens)
+            docFreq.set(tok, (docFreq.get(tok) ?? 0) + 1);
+    }
+    const N = tools.length;
+    const idf = new Map();
+    for (const [tok, df] of docFreq)
+        idf.set(tok, Math.log((N + 1) / (df + 1)) + 1);
+    return idf;
+}
+export const helpTool = {
+    name: "mneme.help",
+    category: "meta",
+    description: "Sub-millisecond top-5 tool matcher for free-text queries. Pass a " +
+        "natural-language description of what you want; get back the 5 tools " +
+        "most likely to answer it, with scores. Lighter than mneme.understand_intent " +
+        "(no execution plan, no arg extraction) — meant for 'is there a tool for X?' " +
+        "discovery. Use WHEN you don't know the right tool name and want a fast " +
+        "shortlist before reading capabilities.",
+    whenToUse: "You have a vague question and want a quick 'try one of these 5 tools' shortlist without committing to a full execution plan.",
+    triggers: ["what tool helps with X", "find a tool for", "mneme help"],
+    inputSchema: {
+        type: "object",
+        properties: {
+            query: { type: "string", description: "Free-text description of what you're trying to do." },
+            topK: { type: "number", description: "How many matches to return. Default 5." },
+        },
+        required: ["query"],
+    },
+    outputSchema: {
+        type: "object",
+        properties: {
+            query: { type: "string" },
+            matches: {
+                type: "array",
+                items: {
+                    type: "object",
+                    properties: {
+                        name: { type: "string" },
+                        category: { type: "string" },
+                        score: { type: "number" },
+                        description: { type: "string" },
+                    },
+                },
+            },
+        },
+    },
+    examples: [
+        {
+            userQuery: "I want to know who introduced this bug",
+            args: { query: "who introduced this bug" },
+            expectedOutput: "Top match likely mneme.memory.why or mneme.forensics.attribute. Returns 5 ranked candidates with scores.",
+        },
+    ],
+    pitfalls: [
+        "Pure word-overlap — synonyms count zero (e.g., 'author' won't match 'engineer').",
+        "If you need argument extraction or a plan, use mneme.understand_intent (slower but smarter).",
+    ],
+    composeWith: ["mneme.understand_intent", "mneme.tool.contract", "mneme.capabilities"],
+    handler: async (_rt, args) => {
+        const query = String(args["query"] ?? "");
+        const topK = typeof args["topK"] === "number" ? args["topK"] : 5;
+        if (!query.trim()) {
+            return {
+                data: { query, matches: [] },
+                wisdom: "Pass a non-empty query — e.g. mneme.help({ query: 'who knows about X?' }).",
+                confidence: { level: "high" },
+            };
+        }
+        const all = buildAllTools();
+        const idf = buildIdf(all);
+        const scored = all
+            .map((t) => ({
+            name: t.name,
+            category: t.category,
+            score: Math.round(scoreTool(query, t, idf) * 100) / 100,
+            description: t.description.slice(0, 180),
+        }))
+            .filter((s) => s.score > 0)
+            .sort((a, b) => b.score - a.score)
+            .slice(0, Math.max(1, topK));
+        return {
+            data: { query, matches: scored },
+            wisdom: scored.length > 0
+                ? `Top match: ${scored[0].name} (score ${scored[0].score}). ${scored.length === 1 ? "" : `${scored.length - 1} other candidate${scored.length === 2 ? "" : "s"} listed.`}`
+                : "No tools matched. Try mneme.capabilities to browse the full catalog, or mneme.smart_do to dispatch a free-text intent.",
+            confidence: scored.length > 0 ? { level: "medium" } : { level: "low" },
+            followUp: scored[0] ? ["mneme.tool.contract", scored[0].name] : ["mneme.capabilities", "mneme.smart_do"],
+        };
+    },
+};
+// ─── mneme.whats_new — diff vs a previously-seen catalog hash ────────────────
+export const whatsNewTool = {
+    name: "mneme.whats_new",
+    category: "meta",
+    description: "Catalog drift detector. Pass the catalog hash you saw last session; " +
+        "Mneme returns adds / removes / description-changes since then. Use " +
+        "WHEN your agent wakes up after a Mneme upgrade and wants to know which " +
+        "tools are new, gone, or changed — without re-reading the entire catalog. " +
+        "If you pass no hash (or 'unknown'), you get the current hash + " +
+        "first-time onboarding guidance instead.",
+    whenToUse: "You're an agent resuming a session after a Mneme version bump and want a delta — not the full catalog.",
+    triggers: ["what is new in mneme", "tool catalog diff", "did mneme change"],
+    inputSchema: {
+        type: "object",
+        properties: {
+            lastSeenHash: {
+                type: "string",
+                description: "16-char SHA-256 prefix of the catalog from a previous session. Pass 'unknown' on first call.",
+            },
+        },
+    },
+    outputSchema: {
+        type: "object",
+        properties: {
+            currentHash: { type: "string" },
+            firstCall: { type: "boolean" },
+            added: { type: "array", items: { type: "string" } },
+            removed: { type: "array", items: { type: "string" } },
+            changed: { type: "array", items: { type: "string" } },
+            totalTools: { type: "number" },
+        },
+    },
+    examples: [
+        {
+            userQuery: "Did Mneme add any tools since I last connected?",
+            args: { lastSeenHash: "a1b2c3d4e5f60718" },
+            expectedOutput: "If the catalog hash matches: { added: [], removed: [], changed: [] } — nothing changed. Otherwise: lists of tool names by change type.",
+        },
+    ],
+    pitfalls: [
+        "Hash is per-tool-CONTRACT — minor description tweaks change the hash even if behavior is identical.",
+        "Removed tools may still be callable for one version (deprecation grace period); always re-check via mneme.tool.contract.",
+    ],
+    composeWith: ["mneme.tool.contract", "mneme.capabilities"],
+    handler: async (_rt, args) => {
+        const lastSeen = String(args["lastSeenHash"] ?? "");
+        const current = computeCatalogHash();
+        const all = buildAllTools();
+        if (!lastSeen || lastSeen === "unknown") {
+            return {
+                data: {
+                    currentHash: current,
+                    firstCall: true,
+                    added: [],
+                    removed: [],
+                    changed: [],
+                    totalTools: all.length,
+                },
+                wisdom: `First-time call — catalog hash is '${current}'. Save it; pass it next session to get a delta. ` +
+                    `Mneme currently exposes ${all.length} static tools across 9 categories — call mneme.capabilities for the syllabus.`,
+                followUp: ["mneme.capabilities", "mneme.help"],
+                confidence: { level: "high" },
+            };
+        }
+        if (lastSeen === current) {
+            return {
+                data: {
+                    currentHash: current,
+                    firstCall: false,
+                    added: [],
+                    removed: [],
+                    changed: [],
+                    totalTools: all.length,
+                },
+                wisdom: `Catalog unchanged since you last connected (hash ${current}). Same ${all.length} tools, same contracts.`,
+                confidence: { level: "high" },
+            };
+        }
+        // Diff is best-effort — without a stored history of past snapshots we
+        // can't know what was removed or changed in detail. Surface the hash
+        // mismatch + tell the agent to re-fetch via capabilities.
+        return {
+            data: {
+                currentHash: current,
+                firstCall: false,
+                added: [],
+                removed: [],
+                changed: [],
+                totalTools: all.length,
+                note: "Hash differs from your lastSeenHash. Per-tool diff requires a snapshot history (planned). Call mneme.capabilities to refresh your mental model.",
+            },
+            wisdom: `Catalog has changed (was '${lastSeen}', now '${current}'). ` +
+                `Re-call mneme.capabilities for the current catalog (${all.length} tools) and update your stored hash.`,
+            followUp: ["mneme.capabilities"],
+            confidence: { level: "medium" },
+        };
+    },
+};
+/** All four Foundation v1.18.0 tools — registered in the registry as a group. */
+export const toolMetaTools = [toolContractTool, toolLintTool, helpTool, whatsNewTool];
+//# sourceMappingURL=_tool_meta.js.map

package/dist/tools/_tool_meta.js.map

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

package/dist/tools/_types.d.ts

@@ -169,12 +169,19 @@ export interface ToolRuntime {
 }
 /** A Mneme tool definition — one per CLI command we expose via MCP.
  *
- *  description: write it like a good lesson title — *include WHEN to use + examples*.
- *  AI tool selection is mostly description-matching; vague descriptions = wrong picks.
+ *  v1.18 introduces the **Tool Contract Schema** — every tool can carry a
+ *  6-field contract that gives AI agents zero-doubt grounding:
+ *      WHEN, INPUT (inputSchema), OUTPUT (outputSchema), EXAMPLE, PITFALLS, COMPOSE_WITH
+ *  Plus a `jargon` map that translates domain terms inline. The new
+ *  `mneme.tool.lint` tool flags any tool that's missing fields, and
+ *  `mneme.tool.contract` returns the full contract on demand.
+ *
+ *  All new fields are OPTIONAL so existing tools continue to work unchanged.
+ *  New tools (and refactors of weak existing ones — quant.*, etc.) should
+ *  fill them in. The build-time linter sets the bar.
  *
- *  triggers: example user phrases that should fire this tool. The AI doesn't
- *  see triggers directly, but we use them in the syllabus + as anchor for
- *  description quality reviews. */
+ *  description: write it like a good lesson title — *include WHEN to use + examples*.
+ *  AI tool selection is mostly description-matching; vague descriptions = wrong picks. */
 export interface MnemeTool<TArgs = Record<string, unknown>, TData = unknown> {
     /** MCP tool name — must match `^mneme\.[a-z_]+\.[a-z_]+$` for grouping */
     name: string;
@@ -191,6 +198,40 @@ export interface MnemeTool<TArgs = Record<string, unknown>, TData = unknown> {
     inputSchema: Tool["inputSchema"];
     /** Async handler — receives runtime + parsed args */
     handler: (runtime: ToolRuntime, args: TArgs) => Promise<ToolResponse<TData>>;
+    /** Crisp 1-sentence "WHEN should I call this tool?" — surfaced separately
+     *  from the description so cold-start agents can scan a list of WHENs. */
+    whenToUse?: string;
+    /** JSON Schema for the response.data field. Lets agents reason about the
+     *  shape of what they'll receive BEFORE making a call. Per MCP spec
+     *  2025-06-18 (now relayed through MCP SDK if the client supports it). */
+    outputSchema?: Tool["inputSchema"];
+    /** 1-3 worked examples — what a real agent invocation looks like end-to-end.
+     *  Each example is self-contained (input → expected output sketch). */
+    examples?: ToolExample[];
+    /** Failure modes / known caveats. Tells the agent when NOT to trust the
+     *  output, and how to recover. Each pitfall is one short sentence. */
+    pitfalls?: string[];
+    /** Other Mneme tools that pair well with this one. Different from
+     *  `followUp` (which lives in the response and is dynamic) — this is the
+     *  static "natural neighbor" list surfaced in the contract. */
+    composeWith?: string[];
+    /** Domain-jargon dictionary: term → plain-English explanation.
+     *  Critical for quant.* / forensics.* / dna.* tools where the description
+     *  uses words like "Greeks", "Kelly", "ENFSI" that a cold-start AI agent
+     *  may not understand. The lint tool scans descriptions for known jargon
+     *  and FAILS if an unexplained term appears. */
+    jargon?: Record<string, string>;
+}
+/** A worked example for a tool — surfaced in the contract so AI agents
+ *  can pattern-match real invocations rather than guess from the schema. */
+export interface ToolExample {
+    /** What the user asked, in plain English. */
+    userQuery: string;
+    /** Concrete arguments the agent would pass. */
+    args?: Record<string, unknown>;
+    /** Sketch of the response shape — not the full response, just enough
+     *  to teach the agent what to expect. */
+    expectedOutput?: string;
 }
 /** Convert a wrapped tool response into MCP's expected CallToolResult.
  *  We serialise the entire envelope (data + wisdom + followUp + confidence)

package/dist/tools/_types.d.ts.map

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

package/dist/tools/_types.js.map

@@ -1 +1 @@
-{"version":3,"file":"_types.js","sourceRoot":"","sources":["../../src/tools/_types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAuM1C;;;;;;;;sEAQsE;AACtE,MAAM,UAAU,YAAY,CAAC,CAAe;IAC1C,sEAAsE;IACtE,wEAAwE;IACxE,gCAAgC;IAChC,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,wBAAwB,CAAC,KAAK,GAAG,CAAC;IAChE,IAAI,MAAM,GAAG,CAAC,CAAC,MAAM,CAAC;IACtB,IAAI,WAAW,GAAI,CAA4D,CAAC,WAAW,CAAC;IAC5F,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,IAAI,CAAC;YACH,IAAI,OAAO,MAAM,KAAK,QAAQ;gBAAE,MAAM,GAAG,QAAQ,CAAC,QAAQ,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC;YAC3F,IAAI,WAAW,IAAI,OAAO,WAAW,CAAC,YAAY,KAAK,QAAQ,EAAE,CAAC;gBAChE,WAAW,GAAG,EAAE,GAAG,WAAW,EAAE,YAAY,EAAE,QAAQ,CAAC,QAAQ,CAAC,cAAc,CAAC,WAAW,CAAC,YAAY,CAAC,CAAC,QAAQ,EAAE,CAAC;YACtH,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,8DAA8D;QAChE,CAAC;IACH,CAAC;IACD,OAAO;QACL,OAAO,EAAE;YACP;gBACE,IAAI,EAAE,MAAM;gBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAClB;oBACE,IAAI,EAAE,CAAC,CAAC,IAAI;oBACZ,MAAM;oBACN,QAAQ,EAAE,CAAC,CAAC,QAAQ,IAAI,EAAE;oBAC1B,UAAU,EAAE,CAAC,CAAC,UAAU,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE;oBAC/C,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;iBACxC,EACD,IAAI,EACJ,CAAC,CACF;aACF;SACF;KACF,CAAC;AACJ,CAAC;AAED,8DAA8D;AAC9D,MAAM,UAAU,aAAa,CAAC,OAAe;IAC3C,OAAO;QACL,OAAO,EAAE,IAAI;QACb,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;KAC3C,CAAC;AACJ,CAAC"}
+{"version":3,"file":"_types.js","sourceRoot":"","sources":["../../src/tools/_types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAoP1C;;;;;;;;sEAQsE;AACtE,MAAM,UAAU,YAAY,CAAC,CAAe;IAC1C,sEAAsE;IACtE,wEAAwE;IACxE,gCAAgC;IAChC,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,wBAAwB,CAAC,KAAK,GAAG,CAAC;IAChE,IAAI,MAAM,GAAG,CAAC,CAAC,MAAM,CAAC;IACtB,IAAI,WAAW,GAAI,CAA4D,CAAC,WAAW,CAAC;IAC5F,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,IAAI,CAAC;YACH,IAAI,OAAO,MAAM,KAAK,QAAQ;gBAAE,MAAM,GAAG,QAAQ,CAAC,QAAQ,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC;YAC3F,IAAI,WAAW,IAAI,OAAO,WAAW,CAAC,YAAY,KAAK,QAAQ,EAAE,CAAC;gBAChE,WAAW,GAAG,EAAE,GAAG,WAAW,EAAE,YAAY,EAAE,QAAQ,CAAC,QAAQ,CAAC,cAAc,CAAC,WAAW,CAAC,YAAY,CAAC,CAAC,QAAQ,EAAE,CAAC;YACtH,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,8DAA8D;QAChE,CAAC;IACH,CAAC;IACD,OAAO;QACL,OAAO,EAAE;YACP;gBACE,IAAI,EAAE,MAAM;gBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAClB;oBACE,IAAI,EAAE,CAAC,CAAC,IAAI;oBACZ,MAAM;oBACN,QAAQ,EAAE,CAAC,CAAC,QAAQ,IAAI,EAAE;oBAC1B,UAAU,EAAE,CAAC,CAAC,UAAU,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE;oBAC/C,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;iBACxC,EACD,IAAI,EACJ,CAAC,CACF;aACF;SACF;KACF,CAAC;AACJ,CAAC;AAED,8DAA8D;AAC9D,MAAM,UAAU,aAAa,CAAC,OAAe;IAC3C,OAAO;QACL,OAAO,EAAE,IAAI;QACb,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;KAC3C,CAAC;AACJ,CAAC"}