@mikeargento/bitgraph-mcp 0.1.1

package/dist/api.js

@@ -0,0 +1,144 @@
+// Copyright (c) 2024-2026 Mike Argento. Licensed under the MIT License. See LICENSE.
+/** Read configuration from the environment at call time (testable via env). */
+export function configFromEnv() {
+    const baseUrl = (process.env["BITGRAPH_API_URL"] ?? "https://bitgraph.ing").replace(/\/+$/, "");
+    const apiKey = process.env["BITGRAPH_API_KEY"];
+    return apiKey ? { baseUrl, apiKey } : { baseUrl };
+}
+/** Matches the website client: 50 digests per commit request (~1s of TEE work each). */
+export const COMMIT_CHUNK_SIZE = 50;
+/** Matches the batch endpoint's MAX_DIGESTS. */
+export const BATCH_CHECK_LIMIT = 500;
+const CHECK_TIMEOUT_MS = 30_000;
+const COMMIT_TIMEOUT_MS = 120_000;
+export class ApiError extends Error {
+    status;
+    retryAfterSec;
+    constructor(status, message, retryAfterSec = null) {
+        super(message);
+        this.status = status;
+        this.retryAfterSec = retryAfterSec;
+    }
+}
+async function parseError(res) {
+    let message = res.statusText || `HTTP ${res.status}`;
+    try {
+        const body = (await res.json());
+        if (typeof body.error === "string" && body.error.length > 0)
+            message = body.error;
+    }
+    catch {
+        /* non-JSON error body */
+    }
+    const retryAfterRaw = res.headers.get("retry-after");
+    const retryAfterSec = retryAfterRaw !== null ? Number.parseInt(retryAfterRaw, 10) : null;
+    return new ApiError(res.status, message, Number.isFinite(retryAfterSec) ? retryAfterSec : null);
+}
+/**
+ * Redirects are refused everywhere: an Authorization header must never follow
+ * one to a different host, and the canonical endpoint serves without them.
+ */
+function redirectHint(err) {
+    if (err instanceof TypeError && /redirect/i.test(err.message)) {
+        throw new Error("The BitGraph endpoint redirected. Set BITGRAPH_API_URL to the canonical https://bitgraph.ing (apex, no www).");
+    }
+    throw err;
+}
+async function getJson(config, path, timeoutMs) {
+    const res = await fetch(`${config.baseUrl}${path}`, {
+        method: "GET",
+        redirect: "error",
+        signal: AbortSignal.timeout(timeoutMs),
+    }).catch(redirectHint);
+    if (!res.ok)
+        throw await parseError(res);
+    return (await res.json());
+}
+async function postJson(config, path, body, timeoutMs, authenticated) {
+    const headers = { "Content-Type": "application/json" };
+    if (authenticated && config.apiKey)
+        headers["Authorization"] = `Bearer ${config.apiKey}`;
+    const res = await fetch(`${config.baseUrl}${path}`, {
+        method: "POST",
+        headers,
+        body: JSON.stringify(body),
+        redirect: "error",
+        signal: AbortSignal.timeout(timeoutMs),
+    }).catch(redirectHint);
+    if (!res.ok)
+        throw await parseError(res);
+    return (await res.json());
+}
+/**
+ * Look up which digests are on record. Input digests must be URL-safe base64;
+ * the response is keyed by the exact strings sent. Batches of up to 500.
+ */
+export async function batchCheck(config, urlSafeDigests) {
+    const merged = { results: {} };
+    for (let offset = 0; offset < urlSafeDigests.length; offset += BATCH_CHECK_LIMIT) {
+        const chunk = urlSafeDigests.slice(offset, offset + BATCH_CHECK_LIMIT);
+        const page = await postJson(config, "/api/proofs/batch", { digests: chunk }, CHECK_TIMEOUT_MS, false);
+        Object.assign(merged.results, page.results);
+    }
+    return merged;
+}
+/**
+ * Record digests at new causal positions. Input digests must be STANDARD
+ * base64 (as stored in proofs). Commits sequentially in chunks of 50, matching
+ * the website client; the TEE serializes commits anyway.
+ *
+ * On a mid-batch failure the error carries how many proofs were already
+ * minted (those are permanent); the caller must report partial results
+ * honestly rather than pretending all-or-nothing.
+ */
+export async function commitDigests(config, standardDigests, attribution) {
+    const proofs = [];
+    for (let offset = 0; offset < standardDigests.length; offset += COMMIT_CHUNK_SIZE) {
+        const chunk = standardDigests.slice(offset, offset + COMMIT_CHUNK_SIZE);
+        const body = {
+            digests: chunk.map((digestB64) => ({ digestB64, hashAlg: "sha256" })),
+            chainId: "bitgraph:main",
+        };
+        if (attribution)
+            body["attribution"] = attribution;
+        try {
+            const raw = await postJson(config, "/api/commit", body, COMMIT_TIMEOUT_MS, true);
+            proofs.push(...(Array.isArray(raw) ? raw : [raw]));
+        }
+        catch (err) {
+            throw new PartialCommitError(proofs, standardDigests.length, err);
+        }
+    }
+    return proofs;
+}
+/** A commit batch failed partway: `minted` proofs are already permanent. */
+export class PartialCommitError extends Error {
+    minted;
+    requested;
+    cause2;
+    constructor(minted, requested, cause) {
+        const reason = cause instanceof Error ? cause.message : String(cause);
+        super(`Recording stopped after ${minted.length} of ${requested} digests: ${reason}` +
+            (cause instanceof ApiError && cause.retryAfterSec !== null
+                ? ` (retry after ${cause.retryAfterSec}s)`
+                : ""));
+        this.minted = minted;
+        this.requested = requested;
+        this.cause2 = cause;
+    }
+}
+/** Full detail for one digest: proof, all causal positions, anchor window. */
+export async function getProofDetail(config, urlSafeDigest, counter, urlSafeEpoch) {
+    const params = new URLSearchParams();
+    if (counter !== undefined)
+        params.set("counter", counter);
+    if (urlSafeEpoch !== undefined)
+        params.set("epoch", urlSafeEpoch);
+    const query = params.size > 0 ? `?${params.toString()}` : "";
+    return getJson(config, `/api/proofs/digest/${encodeURIComponent(urlSafeDigest)}${query}`, CHECK_TIMEOUT_MS);
+}
+/** Resolve a BitGraph number (or digest string) to a digest via /api/search. */
+export async function search(config, q) {
+    return getJson(config, `/api/search?q=${encodeURIComponent(q)}`, CHECK_TIMEOUT_MS);
+}
+//# sourceMappingURL=api.js.map

package/dist/api.js.map

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

package/dist/encoding.d.ts

@@ -0,0 +1,19 @@
+/** Standard base64 → URL-safe unpadded base64. */
+export declare function toUrlSafeB64(b64: string): string;
+/**
+ * URL-safe base64 → standard base64 with padding.
+ * A no-op (apart from re-padding) when the input is already standard base64,
+ * so it is safe to call on either form.
+ */
+export declare function fromUrlSafeB64(urlSafe: string): string;
+/** True if the string plausibly encodes 32 bytes of SHA-256 in either base64 form. */
+export declare function looksLikeDigest(s: string): boolean;
+/**
+ * SHA-256 of a file's bytes as standard base64.
+ * Streams from disk, so file size is not a memory concern. Only this digest
+ * ever leaves the machine; file contents are never uploaded.
+ */
+export declare function sha256FileB64(path: string): Promise<string>;
+/** Run an async mapper over items with bounded concurrency, preserving order. */
+export declare function mapConcurrent<T, R>(items: readonly T[], concurrency: number, fn: (item: T, index: number) => Promise<R>): Promise<R[]>;
+//# sourceMappingURL=encoding.d.ts.map

package/dist/encoding.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"encoding.d.ts","sourceRoot":"","sources":["../src/encoding.ts"],"names":[],"mappings":"AAcA,kDAAkD;AAClD,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEhD;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAItD;AAED,sFAAsF;AACtF,wBAAgB,eAAe,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAIlD;AAED;;;;GAIG;AACH,wBAAsB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAUjE;AAED,iFAAiF;AACjF,wBAAsB,aAAa,CAAC,CAAC,EAAE,CAAC,EACtC,KAAK,EAAE,SAAS,CAAC,EAAE,EACnB,WAAW,EAAE,MAAM,EACnB,EAAE,EAAE,CAAC,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC,GACzC,OAAO,CAAC,CAAC,EAAE,CAAC,CAYd"}

package/dist/encoding.js

@@ -0,0 +1,64 @@
+// Copyright (c) 2024-2026 Mike Argento. Licensed under the MIT License. See LICENSE.
+/**
+ * @mikeargento/bitgraph-mcp: digest encoding and file hashing.
+ *
+ * BitGraph uses two base64 forms for the same SHA-256 digest:
+ * standard base64 with padding inside proof objects and commit requests,
+ * URL-safe unpadded base64 in API lookups, S3 keys, and proof page URLs.
+ */
+import { createHash } from "node:crypto";
+import { createReadStream } from "node:fs";
+import { stat } from "node:fs/promises";
+/** Standard base64 → URL-safe unpadded base64. */
+export function toUrlSafeB64(b64) {
+    return b64.replace(/\+/g, "-").replace(/\//g, "_").replace(/=+$/, "");
+}
+/**
+ * URL-safe base64 → standard base64 with padding.
+ * A no-op (apart from re-padding) when the input is already standard base64,
+ * so it is safe to call on either form.
+ */
+export function fromUrlSafeB64(urlSafe) {
+    let b64 = urlSafe.replace(/-/g, "+").replace(/_/g, "/");
+    while (b64.length % 4 !== 0)
+        b64 += "=";
+    return b64;
+}
+/** True if the string plausibly encodes 32 bytes of SHA-256 in either base64 form. */
+export function looksLikeDigest(s) {
+    const normalized = fromUrlSafeB64(s.trim());
+    if (!/^[A-Za-z0-9+/]{43}=$/.test(normalized))
+        return false;
+    return Buffer.from(normalized, "base64").length === 32;
+}
+/**
+ * SHA-256 of a file's bytes as standard base64.
+ * Streams from disk, so file size is not a memory concern. Only this digest
+ * ever leaves the machine; file contents are never uploaded.
+ */
+export async function sha256FileB64(path) {
+    const info = await stat(path);
+    if (!info.isFile()) {
+        throw new Error(`Not a regular file: ${path}`);
+    }
+    const hash = createHash("sha256");
+    for await (const chunk of createReadStream(path)) {
+        hash.update(chunk);
+    }
+    return hash.digest("base64");
+}
+/** Run an async mapper over items with bounded concurrency, preserving order. */
+export async function mapConcurrent(items, concurrency, fn) {
+    const results = new Array(items.length);
+    let next = 0;
+    async function worker() {
+        while (next < items.length) {
+            const index = next++;
+            results[index] = await fn(items[index], index);
+        }
+    }
+    const workers = Array.from({ length: Math.min(concurrency, items.length) }, () => worker());
+    await Promise.all(workers);
+    return results;
+}
+//# sourceMappingURL=encoding.js.map

package/dist/encoding.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"encoding.js","sourceRoot":"","sources":["../src/encoding.ts"],"names":[],"mappings":"AAAA,qFAAqF;AAErF;;;;;;GAMG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAC3C,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAExC,kDAAkD;AAClD,MAAM,UAAU,YAAY,CAAC,GAAW;IACtC,OAAO,GAAG,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;AACxE,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAAC,OAAe;IAC5C,IAAI,GAAG,GAAG,OAAO,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IACxD,OAAO,GAAG,CAAC,MAAM,GAAG,CAAC,KAAK,CAAC;QAAE,GAAG,IAAI,GAAG,CAAC;IACxC,OAAO,GAAG,CAAC;AACb,CAAC;AAED,sFAAsF;AACtF,MAAM,UAAU,eAAe,CAAC,CAAS;IACvC,MAAM,UAAU,GAAG,cAAc,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;IAC5C,IAAI,CAAC,sBAAsB,CAAC,IAAI,CAAC,UAAU,CAAC;QAAE,OAAO,KAAK,CAAC;IAC3D,OAAO,MAAM,CAAC,IAAI,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC,MAAM,KAAK,EAAE,CAAC;AACzD,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,IAAY;IAC9C,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,CAAC;IAC9B,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,CAAC;QACnB,MAAM,IAAI,KAAK,CAAC,uBAAuB,IAAI,EAAE,CAAC,CAAC;IACjD,CAAC;IACD,MAAM,IAAI,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC;IAClC,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,gBAAgB,CAAC,IAAI,CAAC,EAAE,CAAC;QACjD,IAAI,CAAC,MAAM,CAAC,KAAe,CAAC,CAAC;IAC/B,CAAC;IACD,OAAO,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;AAC/B,CAAC;AAED,iFAAiF;AACjF,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,KAAmB,EACnB,WAAmB,EACnB,EAA0C;IAE1C,MAAM,OAAO,GAAQ,IAAI,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAC7C,IAAI,IAAI,GAAG,CAAC,CAAC;IACb,KAAK,UAAU,MAAM;QACnB,OAAO,IAAI,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC;YAC3B,MAAM,KAAK,GAAG,IAAI,EAAE,CAAC;YACrB,OAAO,CAAC,KAAK,CAAC,GAAG,MAAM,EAAE,CAAC,KAAK,CAAC,KAAK,CAAM,EAAE,KAAK,CAAC,CAAC;QACtD,CAAC;IACH,CAAC;IACD,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,GAAG,CAAC,WAAW,EAAE,KAAK,CAAC,MAAM,CAAC,EAAE,EAAE,GAAG,EAAE,CAAC,MAAM,EAAE,CAAC,CAAC;IAC5F,MAAM,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IAC3B,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/format.d.ts

@@ -0,0 +1,44 @@
+import type { BitGraphProof, ProofDetailResponse } from "./types.js";
+export declare const CHARACTER_LIMIT = 25000;
+/** Public proof page URL for a digest, optionally pinned to one causal position. */
+export declare function proofUrl(baseUrl: string, standardDigest: string, counter?: string, standardEpochId?: string): string;
+/**
+ * One recording outcome, in the product's own vocabulary. "not recorded" is
+ * the honest label for a file lost to a partial commit failure: never claim
+ * "on record" for a digest that has no proof.
+ */
+export interface RecordOutcome {
+    path: string;
+    digest: string;
+    outcome: "recorded" | "on record" | "not recorded";
+    counter: string | null;
+    epoch: string | null;
+    total_positions: number;
+    proof_url: string | null;
+}
+export interface CheckOutcome {
+    input: string;
+    digest: string;
+    on_record: boolean;
+    positions: Array<{
+        counter: string | null;
+        epoch: string | null;
+    }>;
+    proof_url: string | null;
+}
+export declare function positionOf(proof: BitGraphProof): {
+    counter: string | null;
+    epoch: string | null;
+};
+export declare function renderRecordMarkdown(outcomes: readonly RecordOutcome[]): string;
+export declare function renderCheckMarkdown(outcomes: readonly CheckOutcome[]): string;
+export declare function renderProofMarkdown(detail: ProofDetailResponse, baseUrl: string): string;
+/**
+ * Cap a JSON payload at CHARACTER_LIMIT. Attestation reports are the usual
+ * culprit; elide them first, then fall back to hard truncation with a notice.
+ */
+export declare function capJson(value: unknown): {
+    text: string;
+    truncated: boolean;
+};
+//# sourceMappingURL=format.d.ts.map

package/dist/format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../src/format.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,aAAa,EAAgB,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAEnF,eAAO,MAAM,eAAe,QAAS,CAAC;AAEtC,oFAAoF;AACpF,wBAAgB,QAAQ,CACtB,OAAO,EAAE,MAAM,EACf,cAAc,EAAE,MAAM,EACtB,OAAO,CAAC,EAAE,MAAM,EAChB,eAAe,CAAC,EAAE,MAAM,GACvB,MAAM,CASR;AAED;;;;GAIG;AACH,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,UAAU,GAAG,WAAW,GAAG,cAAc,CAAC;IACnD,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,eAAe,EAAE,MAAM,CAAC;IACxB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,OAAO,CAAC;IACnB,SAAS,EAAE,KAAK,CAAC;QAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC,CAAC;IACnE,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,aAAa,GAAG;IAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,CAIjG;AAED,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,SAAS,aAAa,EAAE,GAAG,MAAM,CA+B/E;AAED,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,SAAS,YAAY,EAAE,GAAG,MAAM,CAa7E;AAiBD,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,mBAAmB,EAC3B,OAAO,EAAE,MAAM,GACd,MAAM,CAuCR;AAED;;;GAGG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,OAAO,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,OAAO,CAAA;CAAE,CAW5E"}

package/dist/format.js

@@ -0,0 +1,164 @@
+// Copyright (c) 2024-2026 Mike Argento. Licensed under the MIT License. See LICENSE.
+/**
+ * @mikeargento/bitgraph-mcp: output shaping.
+ *
+ * Markdown for human-facing summaries, JSON for complete structured data.
+ * Time statements come from the Ethereum anchor bracket ("BitGraphed between
+ * X and Y"), never from advisory clock fields.
+ */
+import { toUrlSafeB64 } from "./encoding.js";
+export const CHARACTER_LIMIT = 25_000;
+/** Public proof page URL for a digest, optionally pinned to one causal position. */
+export function proofUrl(baseUrl, standardDigest, counter, standardEpochId) {
+    let url = `${baseUrl}/proof/${encodeURIComponent(toUrlSafeB64(standardDigest))}`;
+    if (counter !== undefined) {
+        url += `?counter=${encodeURIComponent(counter)}`;
+        if (standardEpochId !== undefined) {
+            url += `&epoch=${encodeURIComponent(toUrlSafeB64(standardEpochId))}`;
+        }
+    }
+    return url;
+}
+export function positionOf(proof) {
+    const counter = proof.commit?.counter ?? null;
+    const epochId = proof.commit?.epochId;
+    return { counter, epoch: epochId !== undefined ? toUrlSafeB64(epochId) : null };
+}
+export function renderRecordMarkdown(outcomes) {
+    const recorded = outcomes.filter((o) => o.outcome === "recorded");
+    const onRecord = outcomes.filter((o) => o.outcome === "on record");
+    const notRecorded = outcomes.filter((o) => o.outcome === "not recorded");
+    const lines = [];
+    let headline = `${recorded.length} recorded, ${onRecord.length} already on record.`;
+    if (notRecorded.length > 0) {
+        headline = `${recorded.length} recorded, ${onRecord.length} already on record, ${notRecorded.length} NOT recorded.`;
+    }
+    lines.push(headline);
+    for (const o of outcomes) {
+        if (o.outcome === "not recorded") {
+            lines.push(`- not recorded (commit failed) · ${o.path}`);
+            continue;
+        }
+        const positionNote = o.outcome === "on record"
+            ? o.total_positions > 1
+                ? ` (${o.total_positions} causal positions, earliest shown)`
+                : ""
+            : "";
+        lines.push(`- ${o.outcome} · #${o.counter ?? "?"} · ${o.path}${positionNote}\n  ${o.proof_url}`);
+    }
+    if (onRecord.length > 0) {
+        lines.push(`\nAlready-recorded files were not re-recorded. To record one of them at a new causal position deliberately, call bitgraph_record with again=true.`);
+    }
+    return lines.join("\n");
+}
+export function renderCheckMarkdown(outcomes) {
+    const found = outcomes.filter((o) => o.on_record).length;
+    const lines = [`${found} of ${outcomes.length} on record.`];
+    for (const o of outcomes) {
+        if (o.on_record) {
+            const first = o.positions[0];
+            const extra = o.positions.length > 1 ? ` and ${o.positions.length - 1} more position(s)` : "";
+            lines.push(`- on record · #${first?.counter ?? "?"}${extra} · ${o.input}\n  ${o.proof_url}`);
+        }
+        else {
+            lines.push(`- not on record · ${o.input}`);
+        }
+    }
+    return lines.join("\n");
+}
+function renderWindow(detail) {
+    const w = detail.causalWindow;
+    if (!w)
+        return null;
+    const lower = w.anchorBefore?.blockTime ?? null; // earlier block: BitGraphed after it
+    const upper = w.anchorAfter?.blockTime ?? null; // later block: BitGraphed before it
+    const lowerBlock = w.anchorBefore?.blockNumber ?? null;
+    const upperBlock = w.anchorAfter?.blockNumber ?? null;
+    if (lower && upper) {
+        return `BitGraphed between ${lower} (Ethereum block ${lowerBlock ?? "?"}) and ${upper} (block ${upperBlock ?? "?"}).`;
+    }
+    if (upper)
+        return `BitGraphed before ${upper} (Ethereum block ${upperBlock ?? "?"}).`;
+    if (lower)
+        return `BitGraphed after ${lower} (Ethereum block ${lowerBlock ?? "?"}).`;
+    return null;
+}
+export function renderProofMarkdown(detail, baseUrl) {
+    const proof = detail.proofs[0]?.proof;
+    if (!proof)
+        return "No proof found for that digest.";
+    const digest = proof.artifact?.digestB64 ?? "";
+    const { counter, epoch } = positionOf(proof);
+    const lines = [];
+    lines.push(`# BitGraph #${counter ?? "?"}`);
+    lines.push("");
+    lines.push(`- Digest (SHA-256): ${toUrlSafeB64(digest)}`);
+    if (epoch)
+        lines.push(`- Position: counter ${counter ?? "?"} in epoch ${epoch.slice(0, 12)}…`);
+    const window = renderWindow(detail);
+    if (window)
+        lines.push(`- ${window}`);
+    const etherscan = detail.causalWindow?.anchorAfter?.etherscanUrl ??
+        detail.causalWindow?.anchorBefore?.etherscanUrl;
+    if (etherscan)
+        lines.push(`- Anchor block on Etherscan: ${etherscan}`);
+    if (proof.environment?.enforcement) {
+        lines.push(`- Enforcement: ${proof.environment.enforcement}`);
+    }
+    if (proof.attribution?.name || proof.attribution?.message) {
+        const note = [proof.attribution.name, proof.attribution.message]
+            .filter(Boolean)
+            .join(": ");
+        lines.push(`- Submitter's note (self-attributed, not verified): ${note}`);
+    }
+    const positions = detail.positions ?? [];
+    if (positions.length > 1) {
+        lines.push("");
+        lines.push(`## Causal positions (${positions.length})`);
+        positions.forEach((p, i) => {
+            const label = i === 0 ? " · original" : "";
+            const bracket = p.lowerTime && p.upperTime ? ` · between ${p.lowerTime} and ${p.upperTime}` : "";
+            lines.push(`- #${p.counter ?? "?"}${label}${bracket}`);
+        });
+    }
+    lines.push("");
+    lines.push(`Proof page: ${proofUrl(baseUrl, digest, counter ?? undefined, proof.commit?.epochId)}`);
+    return lines.join("\n");
+}
+/**
+ * Cap a JSON payload at CHARACTER_LIMIT. Attestation reports are the usual
+ * culprit; elide them first, then fall back to hard truncation with a notice.
+ */
+export function capJson(value) {
+    let text = JSON.stringify(value, null, 2);
+    if (text.length <= CHARACTER_LIMIT)
+        return { text, truncated: false };
+    const elided = JSON.parse(JSON.stringify(value));
+    elideReports(elided);
+    text = JSON.stringify(elided, null, 2);
+    if (text.length <= CHARACTER_LIMIT)
+        return { text, truncated: true };
+    return {
+        text: `${text.slice(0, CHARACTER_LIMIT)}\n… truncated at ${CHARACTER_LIMIT} characters. Request a single item or use markdown format for a summary.`,
+        truncated: true,
+    };
+}
+function elideReports(value) {
+    if (Array.isArray(value)) {
+        for (const item of value)
+            elideReports(item);
+        return;
+    }
+    if (value !== null && typeof value === "object") {
+        const obj = value;
+        for (const [key, v] of Object.entries(obj)) {
+            if (key === "reportB64" && typeof v === "string" && v.length > 256) {
+                obj[key] = `<elided ${v.length} base64 chars; fetch the proof page for the full attestation>`;
+            }
+            else {
+                elideReports(v);
+            }
+        }
+    }
+}
+//# sourceMappingURL=format.js.map

package/dist/format.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -0,0 +1,25 @@
+#!/usr/bin/env node
+// Copyright (c) 2024-2026 Mike Argento. Licensed under the MIT License. See LICENSE.
+/**
+ * @mikeargento/bitgraph-mcp: stdio entry point.
+ *
+ * Environment:
+ *   BITGRAPH_API_URL  optional, defaults to https://bitgraph.ing
+ *   BITGRAPH_API_KEY  optional; sent as a Bearer token on recordings
+ */
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { configFromEnv } from "./api.js";
+import { buildServer, SERVER_VERSION } from "./server.js";
+async function main() {
+    const config = configFromEnv();
+    const server = buildServer();
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    // stdio servers must never write to stdout; stderr only.
+    console.error(`bitgraph-mcp ${SERVER_VERSION} running (endpoint: ${config.baseUrl}, api key: ${config.apiKey ? "set" : "not set"})`);
+}
+main().catch((err) => {
+    console.error("bitgraph-mcp failed to start:", err);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA,qFAAqF;AAErF;;;;;;GAMG;AAEH,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAE1D,KAAK,UAAU,IAAI;IACjB,MAAM,MAAM,GAAG,aAAa,EAAE,CAAC;IAC/B,MAAM,MAAM,GAAG,WAAW,EAAE,CAAC;IAC7B,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAChC,yDAAyD;IACzD,OAAO,CAAC,KAAK,CACX,gBAAgB,cAAc,uBAAuB,MAAM,CAAC,OAAO,cAAc,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,GAAG,CACtH,CAAC;AACJ,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;IACnB,OAAO,CAAC,KAAK,CAAC,+BAA+B,EAAE,GAAG,CAAC,CAAC;IACpD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/server.d.ts

@@ -0,0 +1,11 @@
+/**
+ * @mikeargento/bitgraph-mcp: tool definitions.
+ *
+ * Three gestures, the same three the website has: record a file (take a
+ * BitGraph), check whether bytes are on record, fetch a proof. Only SHA-256
+ * digests ever leave the machine; file contents are never uploaded.
+ */
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare const SERVER_VERSION = "0.1.1";
+export declare function buildServer(): McpServer;
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAEA;;;;;;GAMG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AA8BpE,eAAO,MAAM,cAAc,UAAU,CAAC;AAqDtC,wBAAgB,WAAW,IAAI,SAAS,CAiXvC"}