@aiwayds/dsh-mcp-adapter 0.5.0 → 0.6.0

package/lib/usage.js

@@ -0,0 +1,362 @@
+/**
+ * Per-tool usage statistics and the keep-suggestion document (seam A — the
+ * self-evolution core).
+ *
+ * WHAT THIS MODULE OWNS: the durable facts only.
+ *  - `usage.json` — `{ tools: { <name>: { calls, errors, firstUsedAt,
+ *    lastUsedAt } } }`, one document in the plugin's own gate directory
+ *    (beside gate.json / decisions.jsonl / suggestions.json);
+ *  - `suggestions.json` — the last jev keep-suggestion batch.
+ *
+ * WHAT IT DELIBERATELY DOES NOT OWN: any jev call. The batch that fills
+ * suggestions.json lives in `jev/seams.ts`; this module only knows the shape
+ * of its result (so the command surface can render it without importing the
+ * client). Keeping the decision out of here is what makes the record path
+ * synchronous and remote-free: `record()` updates memory and schedules a
+ * write, and returns. Red line ① (no jev on the hot path) holds structurally
+ * because this file cannot call out at all.
+ *
+ * FAIL-OPEN (red line ②): a corrupt or unreadable document is warned about
+ * once and degrades to zero statistics — never to a crash and never to a
+ * wedged dispatch. Suggestions that cannot be read degrade to "no
+ * suggestions yet", which is exactly what an empty file means.
+ *
+ * @module usage
+ */
+import { mkdir, readFile, rename, writeFile } from 'node:fs/promises';
+import { existsSync, readFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { RANK_CANDIDATE_LIMIT } from "./rank.js";
+/** The usage document file name inside the plugin's gate directory. */
+export const USAGE_FILE_NAME = 'usage.json';
+/** The keep-suggestion document file name inside the plugin's gate directory. */
+export const SUGGESTIONS_FILE_NAME = 'suggestions.json';
+/** Absolute usage.json path for one gate directory. */
+export function usageFile(dir) {
+    return join(dir, USAGE_FILE_NAME);
+}
+/** Absolute suggestions.json path for one gate directory. */
+export function suggestionsFile(dir) {
+    return join(dir, SUGGESTIONS_FILE_NAME);
+}
+/** Fresh-install zero state. */
+export const EMPTY_USAGE = { tools: {} };
+/** Coerce one counter to a non-negative integer; anything else is zero. */
+function counter(value) {
+    return typeof value === 'number' && Number.isFinite(value) && value > 0
+        ? Math.floor(value)
+        : 0;
+}
+/** Keep only string timestamps (hand-edited documents can hold anything). */
+function timestamp(value) {
+    return typeof value === 'string' ? value : '';
+}
+/**
+ * Sanitize any parsed usage document. Entry-by-entry: a corrupt counter
+ * becomes zero, a corrupt timestamp becomes `''`, and a non-object document
+ * becomes the empty one. Hand-edited or half-written files therefore cost
+ * precision, never correctness.
+ *
+ * @param raw - the parsed JSON (or anything at all).
+ * @returns a fresh document; the input is never retained.
+ */
+export function normalizeUsage(raw) {
+    if (typeof raw !== 'object' || raw === null)
+        return { tools: {} };
+    const rawTools = raw.tools;
+    if (typeof rawTools !== 'object' || rawTools === null || Array.isArray(rawTools))
+        return { tools: {} };
+    const tools = {};
+    for (const [name, value] of Object.entries(rawTools)) {
+        if (name === '' || typeof value !== 'object' || value === null)
+            continue;
+        const entry = value;
+        const stats = {
+            calls: counter(entry.calls),
+            errors: Math.min(counter(entry.errors), counter(entry.calls)),
+            firstUsedAt: timestamp(entry.firstUsedAt),
+            lastUsedAt: timestamp(entry.lastUsedAt),
+        };
+        tools[name] = stats;
+    }
+    return { tools };
+}
+/**
+ * Fold one dispatch into a document and return the NEXT document (pure — the
+ * input object and its stats are never mutated, so a caller holding a snapshot
+ * keeps it). `firstUsedAt` is stamped on the tool's first call only, so it
+ * stays a true "when did this tool start being used" answer.
+ *
+ * @param doc - the current document.
+ * @param tool - the dispatched tool name.
+ * @param failed - whether the dispatch came back as a structured error.
+ * @param now - ISO timestamp to stamp (default: now).
+ * @returns the next document.
+ */
+export function recordUsageCall(doc, tool, failed, now = new Date().toISOString()) {
+    if (tool === '')
+        return doc;
+    const previous = doc.tools[tool];
+    const tools = { ...doc.tools };
+    tools[tool] = {
+        calls: (previous?.calls ?? 0) + 1,
+        errors: (previous?.errors ?? 0) + (failed ? 1 : 0),
+        firstUsedAt: previous?.firstUsedAt !== undefined && previous.firstUsedAt !== ''
+            ? previous.firstUsedAt
+            : (previous === undefined ? now : previous.firstUsedAt),
+        lastUsedAt: now,
+    };
+    return { tools };
+}
+/** Total dispatches recorded across every tool. */
+export function usageTotalCalls(doc) {
+    let total = 0;
+    for (const stats of Object.values(doc.tools))
+        total += stats.calls;
+    return total;
+}
+/** Number of tools carrying at least one recorded call. */
+export function usageToolCount(doc) {
+    let total = 0;
+    for (const stats of Object.values(doc.tools))
+        if (stats.calls > 0)
+            total += 1;
+    return total;
+}
+/**
+ * How many total calls pass before a suggestion batch may fire.
+ * Deliberately coarse: the batch is a remote round trip whose answers are
+ * about prompt economics, not correctness, so it runs on a slow cadence
+ * instead of per call.
+ */
+export const SUGGEST_BATCH_EVERY = 20;
+/**
+ * Whether crossing into `totalCalls` opens a new suggestion batch. True only
+ * on the call that MAKES a multiple (20, 40, …), so N calls trigger exactly
+ * floor(N/20) batches and never more — the threshold predicate is a pure
+ * function precisely so the hot path can ask it without any jev work.
+ *
+ * @param totalCalls - total calls AFTER the just-recorded one.
+ * @param every - batch cadence (default {@link SUGGEST_BATCH_EVERY}).
+ * @returns whether a batch should be started.
+ */
+export function shouldRunSuggestBatch(totalCalls, every = SUGGEST_BATCH_EVERY) {
+    // `totalCalls < every` also rules out zero/negative totals, which would
+    // otherwise look like a crossing (0 is a multiple of every).
+    if (every < 1 || totalCalls < every)
+        return false;
+    return Math.floor(totalCalls / every) > Math.floor((totalCalls - 1) / every);
+}
+/**
+ * Build the usage store over one gate directory. The initial read is
+ * synchronous (boot-time, once, mirroring the gate store); writes land
+ * atomically (tmp file + rename) so a crash mid-write can never leave a torn
+ * document.
+ *
+ * @param dir - the plugin's gate directory (`resolveGateDir(...)`).
+ * @param warn - warning seam for a corrupt document / failed write.
+ * @returns the store handle.
+ */
+export function createUsageStore(dir, warn) {
+    const file = usageFile(dir);
+    let mirror = loadInitialUsage(file, warn);
+    let writing = null;
+    let dirty = false;
+    let writeWarned = false;
+    async function writeNow() {
+        try {
+            await mkdir(dir, { recursive: true });
+            const payload = JSON.stringify({ tools: { ...mirror.tools } }, null, 2) + '\n';
+            const tmp = `${file}.${process.pid}.${Date.now()}.tmp`;
+            await writeFile(tmp, payload, 'utf8');
+            await rename(tmp, file);
+        }
+        catch (error) {
+            // One warning per process, not per call: an unwritable directory would
+            // otherwise turn every dispatch into a log line. Statistics are
+            // best-effort by construction (fail-open extends to the stats).
+            if (!writeWarned) {
+                writeWarned = true;
+                warn(`mcp-adapter: the usage statistics at ${file} could not be written `
+                    + `(${error instanceof Error ? error.message : String(error)}) — tracking continues in memory only`);
+            }
+        }
+    }
+    function schedule() {
+        dirty = true;
+        if (writing !== null)
+            return;
+        const run = (async () => {
+            try {
+                while (dirty) {
+                    dirty = false;
+                    await writeNow();
+                }
+            }
+            finally {
+                writing = null;
+            }
+        })();
+        writing = run;
+        void run.catch(() => undefined);
+    }
+    return {
+        get: () => mirror,
+        total: () => usageTotalCalls(mirror),
+        record(tool, failed) {
+            mirror = recordUsageCall(mirror, tool, failed);
+            schedule();
+            return usageTotalCalls(mirror);
+        },
+        async flush() {
+            while (writing !== null)
+                await writing.catch(() => undefined);
+        },
+    };
+}
+/**
+ * Boot-time read. A missing file is the fresh-install zero state (silent); an
+ * unreadable or unparseable one is warned about ONCE here and degrades to
+ * zero statistics, so the only visible effect of a corrupt file is that
+ * suggestions start collecting from scratch again.
+ */
+function loadInitialUsage(file, warn) {
+    if (!existsSync(file))
+        return { tools: {} };
+    try {
+        return normalizeUsage(JSON.parse(readFileSync(file, 'utf8')));
+    }
+    catch (error) {
+        warn(`mcp-adapter: the usage statistics at ${file} are unreadable `
+            + `(${error instanceof Error ? error.message : String(error)}) — starting from zero statistics`);
+        return { tools: {} };
+    }
+}
+/** A probability is usable only when it is a finite 0..1 number. */
+function probability(value) {
+    return typeof value === 'number' && Number.isFinite(value) && value >= 0 && value <= 1
+        ? value : undefined;
+}
+/**
+ * Sanitize a parsed suggestions document into rows that are safe to render.
+ * Rows without a name or a usable probability are dropped rather than shown as
+ * "0%" — a fabricated number is worse than a missing row.
+ *
+ * @param raw - the parsed JSON (an array of rows, or anything at all).
+ * @returns the renderable rows, in document order.
+ */
+export function normalizeSuggestions(raw) {
+    if (!Array.isArray(raw))
+        return [];
+    const out = [];
+    for (const entry of raw) {
+        if (typeof entry !== 'object' || entry === null)
+            continue;
+        const row = entry;
+        const p = probability(row.probability);
+        if (typeof row.tool !== 'string' || row.tool === '' || p === undefined)
+            continue;
+        out.push({
+            tool: row.tool,
+            probability: p,
+            band: row.band === 'adopt' || row.band === 'record' || row.band === 'fallback' ? row.band : 'record',
+            basis: typeof row.basis === 'string' ? row.basis : '',
+            _at: typeof row._at === 'string' ? row._at : '',
+        });
+    }
+    return out;
+}
+/**
+ * Replace the whole suggestion document with one batch (atomic tmp+rename;
+ * a crash leaves either the previous batch or the new one, never a mix).
+ * Throws on failure — the caller is the fire-and-forget seam, which contains
+ * it; a failed write means "this round's suggestions are lost", never a broken
+ * caller.
+ *
+ * @param dir - the plugin's gate directory.
+ * @param records - the batch rows.
+ */
+export async function writeSuggestions(dir, records) {
+    const file = suggestionsFile(dir);
+    const payload = JSON.stringify(records, null, 2) + '\n';
+    await mkdir(dir, { recursive: true });
+    const tmp = `${file}.${process.pid}.${Date.now()}.tmp`;
+    await writeFile(tmp, payload, 'utf8');
+    await rename(tmp, file);
+}
+/**
+ * Read the current suggestions (empty when there are none, unreadable, or
+ * corrupt — the display layer's "no suggestions yet" is the same shape as
+ * "the file was lost", so the operator is never shown a half-truth).
+ *
+ * @param dir - the plugin's gate directory.
+ * @param warn - optional warning seam for an unreadable document.
+ * @returns the renderable rows.
+ */
+export async function readSuggestions(dir, warn) {
+    try {
+        return normalizeSuggestions(JSON.parse(await readFile(suggestionsFile(dir), 'utf8')));
+    }
+    catch (error) {
+        if (warn !== undefined && error?.code !== 'ENOENT') {
+            warn(`mcp-adapter: the keep suggestions at ${suggestionsFile(dir)} are unreadable `
+                + `(${error instanceof Error ? error.message : String(error)}) — showing none`);
+        }
+        return [];
+    }
+}
+/** How much of a tool's description travels into the jev state text. */
+export const SUGGEST_DESCRIPTION_CHARS = 200;
+/**
+ * The candidate set for one keep-suggestion batch: the tools that are
+ * CURRENTLY FOLDED OUT of the prompt (the fold predicate is injected, so this
+ * function stays free of config plumbing) AND have at least one recorded call.
+ *
+ * A folded tool nobody ever called is deliberately excluded: it has no usage
+ * evidence to build a "keep this in every prompt" claim on, and burning a
+ * remote question on it would put the least informative tools first. Ordered
+ * by calls descending (the tools that already earn their place come first),
+ * name ascending as the tie-break, capped at {@link RANK_CANDIDATE_LIMIT}.
+ *
+ * @param doc - the usage mirror.
+ * @param schemas - visible schemas (production: `ctx.tools.schemas()`).
+ * @param isFolded - the live fold predicate for one name.
+ * @param limit - max candidates (default {@link RANK_CANDIDATE_LIMIT}).
+ * @returns the candidates, most-used first.
+ */
+export function usageSuggestCandidates(doc, schemas, isFolded, limit = RANK_CANDIDATE_LIMIT) {
+    const byName = new Map(schemas.map(schema => [schema.name, schema]));
+    const out = [];
+    for (const [tool, stats] of Object.entries(doc.tools)) {
+        if (stats.calls <= 0)
+            continue;
+        if (!isFolded(tool))
+            continue;
+        const schema = byName.get(tool);
+        out.push({
+            tool,
+            calls: stats.calls,
+            errors: stats.errors,
+            lastUsedAt: stats.lastUsedAt,
+            description: (schema?.description ?? '').slice(0, SUGGEST_DESCRIPTION_CHARS),
+        });
+    }
+    out.sort((left, right) => (right.calls - left.calls) || left.tool.localeCompare(right.tool));
+    return out.slice(0, limit === Number.POSITIVE_INFINITY ? undefined : limit);
+}
+/** The usage evidence rendered next to a suggestion, in one line. */
+export function suggestionBasis(candidate) {
+    const when = candidate.lastUsedAt === '' ? 'unknown' : candidate.lastUsedAt.slice(0, 10);
+    return `${candidate.calls} call(s), ${candidate.errors} error(s), last used ${when}`;
+}
+/**
+ * The exact `keep` config fragment a suggestion would translate to. Rendered
+ * as TEXT for the operator — nothing writes it (red line ③).
+ *
+ * @param tool - the suggested tool name.
+ * @returns a copy-pasteable keep-pattern line.
+ */
+export function keepSuggestionFragment(tool) {
+    return `keep: ["${tool}"]`;
+}
+//# sourceMappingURL=usage.js.map

package/lib/usage.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aiwayds/dsh-mcp-adapter",
-  "version": "0.5.0",
+  "version": "0.6.0",
   "description": "dsh plugin: token-efficient prompt-side shim for the official MCP client — folds mcp__* tool schemas out of every assembled prompt and exposes two constant meta-tools (mcp_list / mcp_call) instead",
   "keywords": [
     "dsh",