onadit 0.0.1 → 1.0.0

package/dist/src/observability/tool-usage.js

@@ -0,0 +1,489 @@
+// rename:keep-tool-labels The tool names in this file are usage-log labels: stored data, kept as first written.
+/**
+ * MCP tool-usage logger — append-only JSONL.
+ *
+ * Logs every life_* MCP tool call with timing, args, and outcome.
+ * Designed to never interfere with tool execution: all logging
+ * errors are swallowed and reported to stderr.
+ */
+import fs from "node:fs";
+import path from "node:path";
+// --- Config ---
+const MAX_STRING_ARG_LENGTH = 512;
+const REDACTED_KEYS = new Set([
+    "token",
+    "secret",
+    "password",
+    "authorization",
+    "api_key",
+    "apikey",
+]);
+// --- Sanitisation ---
+export function sanitizeArgs(raw) {
+    const out = {};
+    for (const [key, value] of Object.entries(raw)) {
+        if (REDACTED_KEYS.has(key.toLowerCase())) {
+            out[key] = "[REDACTED]";
+        }
+        else if (typeof value === "string" && value.length > MAX_STRING_ARG_LENGTH) {
+            out[key] = value.slice(0, MAX_STRING_ARG_LENGTH) + `...[truncated ${value.length}]`;
+        }
+        else if (Array.isArray(value)) {
+            out[key] = value.map((v) => typeof v === "string" && v.length > MAX_STRING_ARG_LENGTH
+                ? v.slice(0, MAX_STRING_ARG_LENGTH) + `...[truncated ${v.length}]`
+                : v);
+        }
+        else {
+            out[key] = value;
+        }
+    }
+    return out;
+}
+// --- Result extraction ---
+/**
+ * Tools whose responses carry a retrieval-size signal we can count toward
+ * `context_hits`. Explicit whitelist (not a substring match on "search") so
+ * future non-retrieval tools that happen to return a `results` array don't
+ * pollute the metric.
+ */
+const RETRIEVAL_TOOLS = new Set([
+    "rift_search",
+    "rift_conversations_search",
+    "rift_context_pack",
+    "rift_open_evidence",
+]);
+/**
+ * Per-tool extractor for `(result_count, degraded)` derived from the MCP
+ * response. Search tools expose `results: []`; context_pack exposes four
+ * named buckets we sum. Anything else returns `undefined` for both.
+ */
+function extractRetrievalSignal(tool, mcpResult) {
+    if (!RETRIEVAL_TOOLS.has(tool))
+        return {};
+    const sc = mcpResult.structuredContent;
+    const parseText = () => {
+        try {
+            const text = mcpResult.content[0]?.text;
+            if (!text)
+                return undefined;
+            const parsed = JSON.parse(text);
+            return typeof parsed === "object" && parsed !== null
+                ? parsed
+                : undefined;
+        }
+        catch {
+            return undefined;
+        }
+    };
+    if (tool === "rift_context_pack") {
+        // context_pack always writes structuredContent (see tools/context-pack.ts).
+        // Skip the text-channel fallback — the text is human-readable markdown,
+        // not JSON, so attempting to parse it would always fail.
+        if (!sc)
+            return {};
+        const sum = (key) => {
+            const v = sc[key];
+            return Array.isArray(v) ? v.length : 0;
+        };
+        const count = sum("decisions") + sum("constraints") + sum("examples") + sum("rules");
+        const out = { count };
+        if (typeof sc["degraded"] === "boolean")
+            out.degraded = sc["degraded"];
+        return out;
+    }
+    if (tool === "rift_open_evidence") {
+        if (!sc)
+            return {};
+        const count = sc["result"] && typeof sc["result"] === "object" ? 1 : 0;
+        return { count };
+    }
+    // Search tools: prefer structuredContent, fall back to JSON-on-text for
+    // backwards compatibility with the pre-Slice-1 response shape.
+    const fromStructured = sc?.["results"];
+    if (Array.isArray(fromStructured)) {
+        const out = {
+            count: fromStructured.length,
+        };
+        if (typeof sc?.["degraded"] === "boolean")
+            out.degraded = sc["degraded"];
+        return out;
+    }
+    const parsed = parseText();
+    if (!parsed)
+        return {};
+    const out = {};
+    if (Array.isArray(parsed.results))
+        out.count = parsed.results.length;
+    if (typeof parsed.degraded === "boolean")
+        out.degraded = parsed.degraded;
+    return out;
+}
+/**
+ * Try to extract `result_count` from a retrieval-tool response. For search
+ * tools this is `results.length`; for `rift_context_pack` it is the sum of
+ * all four bucket sizes (decisions + constraints + examples + rules).
+ * Returns `undefined` for non-retrieval tools.
+ */
+export function extractResultCount(tool, mcpResult) {
+    return extractRetrievalSignal(tool, mcpResult).count;
+}
+/**
+ * Try to extract the `degraded` flag from a retrieval-tool response.
+ * Returns `undefined` for non-retrieval tools and for retrieval tools whose
+ * response did not carry the flag.
+ */
+export function extractDegraded(tool, mcpResult) {
+    return extractRetrievalSignal(tool, mcpResult).degraded;
+}
+// --- rift_search metadata extraction ---
+/**
+ * Derive search-mode metadata from the raw rift_search args. Mirrors the
+ * direct-lookup gate on `/search`: `id` + (`middle` | `full`) → exact_id;
+ * anything else is ranked retrieval, even if `id` is present alongside
+ * `detail="summary"` (which doesn't trigger the strict path).
+ */
+export function deriveSearchModeMeta(args) {
+    const detail = (args["detail"] === "middle" || args["detail"] === "full"
+        ? args["detail"]
+        : "summary");
+    const id_present = typeof args["id"] === "string" && args["id"].length > 0;
+    const tier_present = typeof args["tier"] === "string" && args["tier"].length > 0;
+    const source_table_present = typeof args["source_table"] === "string" &&
+        args["source_table"].length > 0;
+    const search_mode = id_present && (detail === "middle" || detail === "full")
+        ? "exact_id"
+        : "ranked";
+    return {
+        search_mode,
+        detail,
+        id_present,
+        tier_present,
+        source_table_present,
+    };
+}
+/**
+ * Derive result-side metadata for a successful rift_search call:
+ *   - has_truncated_content: any returned hit with content_truncated=true
+ *   - max_content_tokens_estimate: max content_tokens_estimate across hits
+ *
+ * Reads from `structuredContent.results` (the canonical compact DTO).
+ * Returns `{}` when the result shape is unknown — never throws.
+ */
+export function extractSearchResultMeta(mcpResult) {
+    const results = mcpResult.structuredContent?.["results"];
+    if (!Array.isArray(results))
+        return {};
+    let truncated = false;
+    let maxTokens;
+    for (const r of results) {
+        if (!r || typeof r !== "object")
+            continue;
+        const hit = r;
+        if (hit["content_truncated"] === true)
+            truncated = true;
+        const tokens = hit["content_tokens_estimate"];
+        if (typeof tokens === "number" && (maxTokens === undefined || tokens > maxTokens)) {
+            maxTokens = tokens;
+        }
+    }
+    const out = {};
+    if (truncated)
+        out.has_truncated_content = true;
+    if (maxTokens !== undefined)
+        out.max_content_tokens_estimate = maxTokens;
+    return out;
+}
+/**
+ * Sum the full-source-row token estimate across every returned hit, for any
+ * retrieval tool. Search and conversations-search expose hits on
+ * `structuredContent.results[]`; context_pack carries its sized rows on
+ * `examples[]` and `rules[]` (decisions/constraints/evidence are inline
+ * snippets with no backing-row size, so they contribute nothing). The size
+ * advisory (`content_tokens_estimate`) is already computed per hit by the
+ * compact DTO builder, so this is a cheap walk.
+ *
+ * Per hit we take the FULL-PARENT size advisory: `expand.params
+ * .content_tokens_estimate` when present, else the top-level
+ * `content_tokens_estimate`. They are equal for ordinary single-row hits, but
+ * for a stitched chunked `detail="middle"` hit the top-level value is only the
+ * returned window while `expand.params` advertises the full parent body the
+ * recall was drawn from (see compact.ts buildStitched*). Using the parent size
+ * keeps "reading saved" honest — it's the haystack a recall searched, not the
+ * slice it happened to return.
+ *
+ * Returns `undefined` — not `0` — for non-retrieval tools and for response
+ * shapes that carry no per-hit size at all, so the caller can omit the field
+ * rather than log a fabricated zero (mirroring how legacy rows stay absent).
+ */
+export function extractSourceTokens(tool, mcpResult) {
+    if (!RETRIEVAL_TOOLS.has(tool))
+        return undefined;
+    const sc = mcpResult.structuredContent;
+    if (!sc)
+        return undefined;
+    let total = 0;
+    let found = false;
+    const hitSourceTokens = (hit) => {
+        const expand = hit["expand"];
+        const params = expand && typeof expand === "object"
+            ? expand["params"]
+            : undefined;
+        const fromExpand = params && typeof params === "object"
+            ? params["content_tokens_estimate"]
+            : undefined;
+        if (typeof fromExpand === "number")
+            return fromExpand;
+        const topLevel = hit["content_tokens_estimate"];
+        return typeof topLevel === "number" ? topLevel : undefined;
+    };
+    const addFrom = (arr) => {
+        if (!Array.isArray(arr))
+            return;
+        for (const item of arr) {
+            if (!item || typeof item !== "object")
+                continue;
+            const tokens = hitSourceTokens(item);
+            if (typeof tokens === "number") {
+                total += tokens;
+                found = true;
+            }
+        }
+    };
+    if (tool === "rift_context_pack") {
+        addFrom(sc["examples"]);
+        addFrom(sc["rules"]);
+    }
+    else if (tool === "rift_open_evidence") {
+        const result = sc["result"];
+        if (result && typeof result === "object") {
+            const tokens = hitSourceTokens(result);
+            if (typeof tokens === "number") {
+                total += tokens;
+                found = true;
+            }
+        }
+    }
+    else {
+        addFrom(sc["results"]);
+    }
+    return found ? total : undefined;
+}
+/**
+ * Try to parse the typed error code (`id_not_found`, `ambiguous_id`, …)
+ * out of a failure response's text channel. `formatError` formats typed
+ * 404/409 bodies as `"<Prefix>: { "error": "id_not_found", … }"`, so we
+ * locate the first `{`, JSON.parse to end, and return the `error` field
+ * when it's a string. Returns `undefined` for transport-only failures
+ * (no body), untyped responses, or unparseable text.
+ */
+export function parseTypedError(text) {
+    if (!text)
+        return undefined;
+    const braceIdx = text.indexOf("{");
+    if (braceIdx < 0)
+        return undefined;
+    const jsonPart = text.slice(braceIdx);
+    try {
+        const parsed = JSON.parse(jsonPart);
+        const err = parsed["error"];
+        if (typeof err === "string" && err.length > 0)
+            return err;
+    }
+    catch {
+        // not a parseable JSON tail — likely a plain transport message
+    }
+    return undefined;
+}
+// --- Logger ---
+export class ToolUsageLogger {
+    clientName;
+    logPath;
+    constructor(dataDir, clientName) {
+        this.clientName = clientName;
+        const dir = path.join(dataDir, "observability");
+        this.logPath = path.join(dir, "agent-tool-usage.jsonl");
+    }
+    /** Append a single entry. Never throws. */
+    log(entry) {
+        try {
+            if (entry.client === undefined && this.clientName) {
+                const client = this.clientName();
+                if (client)
+                    entry.client = client.slice(0, 64);
+            }
+            fs.appendFileSync(this.logPath, JSON.stringify(entry) + "\n");
+        }
+        catch (err) {
+            // Logging must never break tool execution
+            process.stderr.write(`[tool-usage] write failed: ${err instanceof Error ? err.message : String(err)}\n`);
+        }
+    }
+    /**
+     * Wrap an MCP tool handler with usage logging.
+     * Returns the handler's original result — logging failures are invisible to callers.
+     */
+    wrap(tool, args, handler) {
+        const start = Date.now();
+        return handler().then((result) => {
+            const entry = {
+                timestamp: new Date().toISOString(),
+                type: "mcp_tool_call",
+                tool,
+                args: sanitizeArgs(args),
+                latency_ms: Date.now() - start,
+                success: !result.isError,
+            };
+            if (result.isError) {
+                const errText = result.content[0]?.text;
+                if (errText)
+                    entry.error = errText.slice(0, MAX_STRING_ARG_LENGTH);
+            }
+            const rc = extractResultCount(tool, result);
+            if (rc !== undefined)
+                entry.result_count = rc;
+            const deg = extractDegraded(tool, result);
+            if (deg !== undefined)
+                entry.degraded = deg;
+            if (!result.isError) {
+                let textBytes = 0;
+                for (const part of result.content ?? []) {
+                    if (typeof part?.text === "string") {
+                        textBytes += Buffer.byteLength(part.text, "utf8");
+                    }
+                }
+                entry.response_text_bytes = textBytes;
+                const sourceTokens = extractSourceTokens(tool, result);
+                if (sourceTokens !== undefined) {
+                    entry.source_tokens_estimate = sourceTokens;
+                }
+            }
+            if (tool === "rift_search") {
+                const meta = deriveSearchModeMeta(args);
+                entry.search_mode = meta.search_mode;
+                entry.detail = meta.detail;
+                entry.id_present = meta.id_present;
+                entry.tier_present = meta.tier_present;
+                entry.source_table_present = meta.source_table_present;
+                if (result.isError) {
+                    const typed = parseTypedError(result.content[0]?.text);
+                    if (typed)
+                        entry.typed_error = typed;
+                }
+                else {
+                    const resultMeta = extractSearchResultMeta(result);
+                    if (resultMeta.has_truncated_content !== undefined) {
+                        entry.has_truncated_content = resultMeta.has_truncated_content;
+                    }
+                    if (resultMeta.max_content_tokens_estimate !== undefined) {
+                        entry.max_content_tokens_estimate =
+                            resultMeta.max_content_tokens_estimate;
+                    }
+                }
+            }
+            this.log(entry);
+            return result;
+        }, (err) => {
+            // Handler threw — log failure, then re-throw so MCP layer handles it
+            const entry = {
+                timestamp: new Date().toISOString(),
+                type: "mcp_tool_call",
+                tool,
+                args: sanitizeArgs(args),
+                latency_ms: Date.now() - start,
+                success: false,
+                error: err instanceof Error ? err.message : String(err),
+            };
+            if (tool === "rift_search") {
+                const meta = deriveSearchModeMeta(args);
+                entry.search_mode = meta.search_mode;
+                entry.detail = meta.detail;
+                entry.id_present = meta.id_present;
+                entry.tier_present = meta.tier_present;
+                entry.source_table_present = meta.source_table_present;
+            }
+            this.log(entry);
+            throw err;
+        });
+    }
+    /** Read all entries (for testing). */
+    readAll() {
+        try {
+            const raw = fs.readFileSync(this.logPath, "utf-8");
+            return raw
+                .trim()
+                .split("\n")
+                .filter(Boolean)
+                .map((line) => JSON.parse(line));
+        }
+        catch {
+            return [];
+        }
+    }
+    get filePath() {
+        return this.logPath;
+    }
+}
+/**
+ * Tolerant JSONL reader for the agent-tool-usage log.
+ *
+ * Unlike `ToolUsageLogger.readAll`, which drops the entire file to `[]` on
+ * a single bad line, this helper parses each line in its own try/catch,
+ * keeps the valid ones, and silently skips the rest. Used by the
+ * /stats/mcp-usage route so one corrupt entry doesn't blank the dashboard.
+ */
+export function readToolUsageEntriesTolerant(filePath) {
+    let raw;
+    try {
+        raw = fs.readFileSync(filePath, "utf-8");
+    }
+    catch {
+        return [];
+    }
+    return parseToolUsageLines(raw);
+}
+/**
+ * Like {@link readToolUsageEntriesTolerant}, but only a missing log reads as
+ * empty. A log that exists and cannot be read, or that has content without a
+ * single parseable entry, throws, so a chart can say "unavailable" instead of
+ * drawing a broken log as zero usage. Stray bad lines are still skipped.
+ */
+export function readToolUsageEntriesIfPresent(filePath) {
+    let raw;
+    try {
+        raw = fs.readFileSync(filePath, "utf-8");
+    }
+    catch (err) {
+        if (err.code === "ENOENT")
+            return [];
+        throw err;
+    }
+    const entries = parseToolUsageLines(raw);
+    if (entries.length === 0 && raw.trim().length > 0) {
+        throw new Error("Tool usage log has content but no readable entries");
+    }
+    return entries;
+}
+function parseToolUsageLines(raw) {
+    const out = [];
+    for (const line of raw.split("\n")) {
+        if (!line)
+            continue;
+        let parsed;
+        try {
+            parsed = JSON.parse(line);
+        }
+        catch {
+            continue;
+        }
+        if (parsed === null ||
+            typeof parsed !== "object" ||
+            typeof parsed["timestamp"] !== "string" ||
+            typeof parsed["tool"] !== "string" ||
+            typeof parsed["success"] !== "boolean") {
+            continue;
+        }
+        out.push(parsed);
+    }
+    return out;
+}
+//# sourceMappingURL=tool-usage.js.map

package/dist/src/observability/tool-usage.js.map

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

package/dist/src/observability/version-check.d.ts

@@ -0,0 +1,75 @@
+export interface VersionCheckSnapshot {
+    /** Installed version (from getBuildInfo().version). */
+    installed: string;
+    /**
+     * Latest version on the `latest` dist-tag (the `beta` tag up to
+     * 0.1.0-beta.45), or null when the probe failed. The name is kept so older
+     * readers of the snapshot and of /status keep working.
+     */
+    latest_beta: string | null;
+    /** ISO timestamp of the probe attempt (success or failure). */
+    checked_at: string;
+    /** Compact error class on failure, or null on success. */
+    error: string | null;
+}
+export declare function versionCheckPath(dataDir: string): string;
+/**
+ * Write the snapshot atomically. Best-effort: a write failure logs to
+ * stderr but never throws — the update-check feature must not be able
+ * to break the daemon.
+ */
+export declare function writeVersionCheck(dataDir: string, snapshot: VersionCheckSnapshot): void;
+/**
+ * Read the snapshot. Returns null when the file is missing or unparseable
+ * (a missing file is the steady-state on a fresh install before the first
+ * probe runs).
+ */
+export declare function readVersionCheck(dataDir: string): VersionCheckSnapshot | null;
+/**
+ * Compare two `x.y.z-beta.N` versions. Returns:
+ *   negative if a < b
+ *   zero    if a === b
+ *   positive if a > b
+ *
+ * Anything we cannot parse is treated as equal — the status renderer
+ * uses this only to decide whether to *show* an update hint, so the
+ * conservative behavior on bad input is "don't nag."
+ *
+ * This is intentionally tiny and beta-aware rather than a full semver
+ * implementation. Releases are `x.y.z`; betas before 1.0.0 were `x.y.z-beta.N`.
+ */
+export declare function compareBetaVersions(a: string, b: string): number;
+export declare const NPM_REGISTRY_URL = "https://registry.npmjs.org/onadit";
+export declare const VERSION_CHECK_INTERVAL_MS: number;
+/**
+ * Hit the npm registry for the `latest` dist-tag. Metadata-only fetch —
+ * no auth, no headers beyond the default. Returns the resolved version
+ * or null on any failure (the caller writes the failure into the
+ * snapshot's `error` field).
+ *
+ * Test hook: `fetchFn` lets us mock the network without touching the
+ * global fetch.
+ */
+export declare function probeLatestBeta(opts?: {
+    fetchFn?: typeof fetch;
+    timeoutMs?: number;
+}): Promise<{
+    ok: true;
+    latest_beta: string;
+} | {
+    ok: false;
+    error: string;
+}>;
+/**
+ * Run one probe and persist the result. Pure orchestration: probe →
+ * write snapshot. On error, still writes a snapshot so the daemon's
+ * last attempt is observable.
+ */
+export declare function runVersionCheck(opts: {
+    dataDir: string;
+    installed: string;
+    fetchFn?: typeof fetch;
+    timeoutMs?: number;
+    now?: () => Date;
+}): Promise<VersionCheckSnapshot>;
+//# sourceMappingURL=version-check.d.ts.map

package/dist/src/observability/version-check.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version-check.d.ts","sourceRoot":"","sources":["../../../src/observability/version-check.ts"],"names":[],"mappings":"AAsBA,MAAM,WAAW,oBAAoB;IACnC,uDAAuD;IACvD,SAAS,EAAE,MAAM,CAAC;IAClB;;;;OAIG;IACH,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,+DAA+D;IAC/D,UAAU,EAAE,MAAM,CAAC;IACnB,0DAA0D;IAC1D,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAExD;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,oBAAoB,GAC7B,IAAI,CAYN;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,MAAM,GACd,oBAAoB,GAAG,IAAI,CAe7B;AAaD;;;;;;;;;;;;GAYG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAahE;AAsBD,eAAO,MAAM,gBAAgB,sCACQ,CAAC;AAEtC,eAAO,MAAM,yBAAyB,QAAiB,CAAC;AAExD;;;;;;;;GAQG;AACH,wBAAsB,eAAe,CAAC,IAAI,GAAE;IAC1C,OAAO,CAAC,EAAE,OAAO,KAAK,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;CACf,GAAG,OAAO,CACd;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CACjE,CA8BA;AAED;;;;GAIG;AACH,wBAAsB,eAAe,CAAC,IAAI,EAAE;IAC1C,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,OAAO,KAAK,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,GAAG,CAAC,EAAE,MAAM,IAAI,CAAC;CAClB,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAwBhC"}