@mikeargento/bitgraph-mcp 0.6.0 → 0.7.1

package/src/server.ts

@@ -19,24 +19,17 @@ import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import type { RequestHandlerExtra } from "@modelcontextprotocol/sdk/shared/protocol.js";
 import type { ServerNotification, ServerRequest } from "@modelcontextprotocol/sdk/types.js";
 import { z } from "zod";
-import { readFile } from "node:fs/promises";
-import { FuseError, MAX_SET_MEMBERS, builderFor, fuse, fuseSet, fusedNamesFor, type FuseSetMember, type FuseSetProgress } from "@mikeargento/bitgraph";
+import { FuseError, MAX_SET_MEMBERS, type FuseSetProgress } from "@mikeargento/bitgraph";
 import {
-  ApiError,
-  batchCheck,
-  configFromEnv,
-  getProofDetail,
-  indexSetMembers,
-  search,
-  type ApiConfig,
-} from "./api.js";
-import {
-  fromUrlSafeB64,
-  looksLikeDigest,
-  mapConcurrent,
-  sha256FileB64,
-  toUrlSafeB64,
-} from "./encoding.js";
+  ApiError, batchCheck, configFromEnv, getProofDetail, indexSetMembers, search, type ApiConfig,
+  fromUrlSafeB64, looksLikeDigest, mapConcurrent, sha256FileB64, toUrlSafeB64,
+  expandPaths, scanFile, type ScannedFile,
+  type CarrierWindowView,
+  classifyPath, fuseFilePipeline, fuseSetPipeline, MAX_LOADED_BYTES,
+  type CarrierRow, type FuseFileFn, type FuseSetFn, type FusedSummary, type SetSummary,
+  SLOT_TTL_SECONDS, beginTask, decodeTaskToken, sealTask, writeProofBeside,
+  type BitGraphProof, type ProofDetailResponse,
+} from "@mikeargento/bitgraph-sdk";
 import {
   capJson,
   positionOf,
@@ -48,13 +41,11 @@ import {
   type RecordOutcome,
   type SetOutcome,
 } from "./format.js";
-import { expandPaths, fusedDigestFor, scanFile, sniffC2paBytes, type ScannedFile } from "./scan.js";
-import { readCarrierFile, sniffCarrierTail, type CarrierWindowView } from "./carrier-io.js";
-import { stat } from "node:fs/promises";
-import { SLOT_TTL_SECONDS, TASK_INSTRUCTIONS, beginTask, decodeTaskToken, sealTask, writeProofBeside } from "./task.js";
-import type { BitGraphProof, ProofDetailResponse } from "./types.js";
+import { TASK_INSTRUCTIONS } from "./instructions.js";
+
+export type { FuseFileFn, FuseSetFn, FusedSummary, SetSummary } from "@mikeargento/bitgraph-sdk";
 
-export const SERVER_VERSION = "0.6.0";
+export const SERVER_VERSION = "0.7.1";
 
 const SCAN_CONCURRENCY = 4;
 /** Paths per call; a directory counts once and expands to its files. */
@@ -64,7 +55,6 @@ export const MAX_MEMBERS = 100_000;
 /** Files one check may cover after directories expand. */
 const MAX_CHECK_FILES = 10_000;
 /** A file whose length changed while it was read is fused from its bytes instead; above this it is left out rather than held in memory. */
-const MAX_LOADED_BYTES = 256 * 1024 * 1024;
 /** A single file up to this size is fused on its own, in memory, with its Frame; a larger one is a set of one, never held. */
 const MAX_SOLO_BYTES = 256 * 1024 * 1024;
 /** Rows the structured result lists in full; every fused row shares the set's position. */
@@ -73,42 +63,6 @@ export const ROW_CAP = 500;
 export const SET_INDEX_CHUNK = 2500;
 
 /** What one set yields, in the shape the tool reports; tests inject a stand-in. */
-export interface SetSummary {
-  set: "set/1" | "set/2";
-  proof: BitGraphProof;
-  /** Standard base64: the committed artifact's digest. */
-  artifactDigestB64: string;
-  count: number;
-  manifestEchoed: boolean;
-  recovered: boolean;
-  /** In the order the files were given. */
-  members: Array<{
-    index: number;
-    /** The row's ordinal in the committed artifact. */
-    manifestIndex: number;
-    placement: string;
-    originDigestB64: string;
-    artifactDigestB64: string;
-    /** set/2 only: the member's evidence, for the site's index. */
-    memberProof?: unknown;
-  }>;
-}
-export type FuseSetFn = (
-  files: readonly ScannedFile[],
-  config: ApiConfig,
-  opts: { set: "set/1" | "set/2"; onProgress?: (p: FuseSetProgress) => void }
-) => Promise<SetSummary>;
-
-/** What fusing one file on its own yields. */
-export interface FusedSummary {
-  proof: BitGraphProof;
-  frame: unknown;
-  placement: string;
-  artifactDigestB64: string;
-  originDigestB64: string;
-}
-export type FuseFileFn = (file: ScannedFile, config: ApiConfig) => Promise<FusedSummary>;
-
 export interface ServerDeps {
   /** The set pipeline; tests inject a stand-in. Default: the core package's fuseSet() against the configured site. */
   fuseSet?: FuseSetFn;
@@ -116,121 +70,6 @@ export interface ServerDeps {
   fuseFile?: FuseFileFn;
 }
 
-/**
- * A single file, the way a single drop on the site goes: the bytes in hand,
- * the placement chosen from them, one slot, the fused bytes built in memory
- * and hashed, committed under that exact slot, verified against the bytes,
- * and a Frame returned. The fused bytes are not kept.
- */
-async function fuseFileDefault(file: ScannedFile, config: ApiConfig): Promise<FusedSummary> {
-  const bytes = new Uint8Array(await readFile(file.path));
-  const placement = file.placement;
-  const { fusedName } = fusedNamesFor(file.name, placement);
-  const r = await fuse(builderFor(placement, bytes), {
-    placement,
-    original: bytes,
-    fusedFile: fusedName,
-    keepFused: false,
-    transport: { baseUrl: config.baseUrl, ...(config.apiKey ? { apiKey: config.apiKey } : {}) },
-  });
-  return {
-    proof: r.proof as unknown as BitGraphProof,
-    frame: r.frame,
-    placement,
-    artifactDigestB64: r.artifactDigestB64,
-    originDigestB64: r.originDigestB64 ?? file.digestB64,
-  };
-}
-
-/**
- * The default pipeline, the one the site's drop runs: one slot for the set,
- * every member a hashed member whose fused digest is finished from the
- * scan's open hasher with its placement's suffix for that slot, the set's
- * manifest (or, for a set/2, its root document) committed under the same
- * slot, and the returned proof verified against the committed artifact with
- * every member bound to it by digest. A file whose length changed during the
- * scan is a loaded member: read again when it is its turn, checked against
- * the scan's digest, fused in memory, hashed and released.
- */
-async function fuseSetDefault(
-  files: readonly ScannedFile[],
-  config: ApiConfig,
-  opts: { set: "set/1" | "set/2"; onProgress?: (p: FuseSetProgress) => void }
-): Promise<SetSummary> {
-  const members: FuseSetMember[] = files.map((f) =>
-    f.state !== null
-      ? { originDigest: f.originDigest, placement: f.placement, name: f.name, fusedDigest: ({ commitment }) => fusedDigestFor(f, commitment) }
-      : { load: async () => new Uint8Array(await readFile(f.path)), originDigest: f.originDigest, placement: f.placement, name: f.name }
-  );
-  const r = await fuseSet(members, {
-    set: opts.set,
-    keepFused: false,
-    ...(opts.onProgress !== undefined ? { onProgress: opts.onProgress } : {}),
-    transport: { baseUrl: config.baseUrl, ...(config.apiKey ? { apiKey: config.apiKey } : {}) },
-  });
-  return {
-    set: r.set,
-    proof: r.proof as unknown as BitGraphProof,
-    artifactDigestB64: r.artifactDigestB64,
-    count: r.members.length,
-    manifestEchoed: r.manifestEchoed,
-    recovered: r.recovered,
-    members: r.members.map((m) => ({
-      index: m.index,
-      manifestIndex: m.manifestIndex,
-      placement: m.placement,
-      originDigestB64: m.originDigestB64,
-      artifactDigestB64: m.artifactDigestB64,
-      ...(m.memberProof !== undefined ? { memberProof: m.memberProof } : {}),
-    })),
-  };
-}
-
-/**
- * A path is either plain bytes to scan or a BitGraphed file (bitgraph-carrier/1),
- * decided by one 8-byte tail read. A BitGraphed file is judged OFFLINE from the
- * proof it carries, its lookups use the digest of the committed bytes inside,
- * and it is never minted: the envelope is not the recorded thing, the bytes
- * inside are. That is the same structural guarantee the site's drop box gives.
- */
-interface CarrierRow {
-  kind: "carrier";
-  path: string;
-  status: "ok" | "corrupt" | "too-large";
-  /** Standard base64 SHA-256 of the committed bytes inside (status "ok"). */
-  innerDigestB64: string | null;
-  view: CarrierWindowView | null;
-  /** The carried bitgraph/1 proof, for offline answers when the ledger has no row. */
-  proof: unknown | null;
-  c2pa: boolean;
-  reason: string | null;
-}
-type ClassifiedPath = { kind: "plain"; file: ScannedFile } | CarrierRow;
-
-async function classifyPath(p: string): Promise<ClassifiedPath> {
-  const info = await stat(p);
-  if (info.isFile() && (await sniffCarrierTail(p, info.size))) {
-    if (info.size > MAX_LOADED_BYTES) {
-      return {
-        kind: "carrier", path: p, status: "too-large", innerDigestB64: null, view: null, proof: null, c2pa: false,
-        reason: `a BitGraphed file larger than this tool loads (${Math.round(MAX_LOADED_BYTES / (1024 * 1024))} MiB); judge it offline with: npx @mikeargento/bitgraph-audit "${p}"`,
-      };
-    }
-    const r = await readCarrierFile(p);
-    if (r.status === "corrupt" || r.innerDigestB64 === null) {
-      return {
-        kind: "carrier", path: p, status: "corrupt", innerDigestB64: null, view: null, proof: null, c2pa: false,
-        reason: `a carrier block was found at the end of the file but is unreadable: ${r.corruptReason ?? "unspecified"}. A corrupted block, not a forgery; nothing was minted for it.`,
-      };
-    }
-    return {
-      kind: "carrier", path: p, status: "ok", innerDigestB64: r.innerDigestB64, view: r.view,
-      proof: r.result?.payload?.proof ?? null, c2pa: r.inner !== null && sniffC2paBytes(r.inner), reason: null,
-    };
-  }
-  return { kind: "plain", file: await scanFile(p) };
-}
-
 /** Hash the given paths (bounded concurrency). Throws before any network call. */
 async function hashPaths(paths: readonly string[]): Promise<string[]> {
   const failures: string[] = [];
@@ -370,8 +209,8 @@ async function flushIndex(config: ApiConfig, report: Report): Promise<{ written:
 }
 
 export function buildServer(deps: ServerDeps = {}): McpServer {
-  const fuseSetPipeline = deps.fuseSet ?? fuseSetDefault;
-  const fuseFilePipeline = deps.fuseFile ?? fuseFileDefault;
+  const runFuseSet = deps.fuseSet ?? fuseSetPipeline;
+  const runFuseFile = deps.fuseFile ?? fuseFilePipeline;
   const server = new McpServer(
     {
       name: "bitgraph-mcp-server",
@@ -379,7 +218,7 @@ export function buildServer(deps: ServerDeps = {}): McpServer {
     },
     {
       instructions:
-        "BitGraph gives a file's bytes a causal position in a public sequence bracketed by Ethereum anchors. bitgraph_record makes ONE BitGraph of everything in a call, files and folders alike: a single file is fused on its own; two or more become one set under one slot, one position, every file's new fused bytes listed by digest in the committed artifact. " +
+        "BitGraph gives a file's bytes a causal position in a public sequence bracketed by Ethereum anchors. bitgraph_record makes ONE BitGraph of everything in a call, files and folders alike: a single file is fused on its own; two or more become one set under one position, every file's new fused bytes listed by digest in the committed artifact. " +
         "Files are read on this machine and never uploaded or modified; the new bytes are virtual and never written. Recordings are permanent: only make BitGraphs of files the user asked for, and never generate content just to record it. bitgraph_check and bitgraph_get_proof are read-only. " +
         "A BitGraphed file (one that carries its own proof, bitgraph-carrier/1) is recognized by its structure: bitgraph_check judges it offline from the proof inside and states the window, and bitgraph_record never re-mints it, because the envelope is not the recorded thing, the bytes inside are. " +
         "To do work INSIDE a BitGraph, call bitgraph_open BEFORE starting: it returns a position and its commitment; put the commitment string into the task, seal the task with bitgraph_commit within 120 seconds, then record the outputs with bitgraph_record. The task then could not have existed before the position's floor block, and the outputs sit after it.",
@@ -391,9 +230,9 @@ export function buildServer(deps: ServerDeps = {}): McpServer {
     {
       title: "Make a BitGraph",
       description:
-        "Make a BitGraph of files or folders. Everything in one call becomes ONE BitGraph, the way a drop on the site works: a single file is fused on its own slot; two or more files become a set under a single slot on BitGraph (bitgraph.ing), one position for all of them. " +
-        "On this machine each file is read once for its SHA-256 (the origin) and a hasher state; an unused slot is allocated before any new file exists; every file's new fused bytes (the original plus a registered placement carrying the slot's commitment: a 48-byte trailer for JPEG, PNG, GIF, TIFF and TIFF-based raws, BMP, WebP, WAV and AVI, a small tar container with the original first for everything else) are hashed from that state without being written or held; and for a set the canonical list of those digests (above 2,000 files, a Merkle root over it) is committed under the same slot. " +
-        "Files are never modified and never uploaded: only digests, the committed artifact and slot records leave the machine. " +
+        "Make a BitGraph of files or folders. Everything in one call becomes ONE BitGraph, the way a drop on the site works: a single file is fused on its own position; two or more files become a set under a single position on BitGraph (bitgraph.ing). " +
+        "On this machine each file is read once for its SHA-256 (the origin) and a hasher state; an unused position is allocated before any new file exists; every file's new fused bytes (the original plus a registered placement carrying the position commitment: a 48-byte trailer for JPEG, PNG, GIF, TIFF and TIFF-based raws, BMP, WebP, WAV and AVI, a small tar container with the original first for everything else) are hashed from that state without being written or held; and for a set the canonical list of those digests (above 2,000 files, a Merkle root over it) is committed under the same position. " +
+        "Files are never modified and never uploaded: only digests, the committed artifact and position records leave the machine. " +
         "Give file paths, directory paths, or both (absolute paths preferred): a directory is every regular file under it, recursively, with hidden entries and symbolic links left out. " +
         "Files already on record are NOT made again by default; they come back as 'on record' with their earliest position. A file can also hold a BitGraph its holder keeps, which no lookup sees. Pass again=true to make a new BitGraph regardless. " +
         "A BitGraphed file (bitgraph-carrier/1, a file that carries its own proof) is never minted, with or without again: its carried proof is judged offline and reported, because the envelope is not the recorded thing, the bytes inside are. " +
@@ -501,14 +340,14 @@ export function buildServer(deps: ServerDeps = {}): McpServer {
           // One file, as a single drop on the site goes: its own slot, its own Frame.
           report(0, 1, "fusing");
           try {
-            solo = { ...(await fuseFilePipeline(one, config)), file: one };
+            solo = { ...(await runFuseFile(one, config)), file: one };
           } catch (err) {
             failure = setFailureText(err);
           }
         } else if (toMint.length > 0) {
           const kind: "set/1" | "set/2" = toMint.length > MAX_SET_MEMBERS ? "set/2" : "set/1";
           try {
-            made = await fuseSetPipeline(toMint, config, {
+            made = await runFuseSet(toMint, config, {
               set: kind,
               onProgress: (p) => report(p.done, p.total, `${PHASES[p.phase]} ${p.done} of ${p.total}`),
             });
@@ -687,7 +526,7 @@ export function buildServer(deps: ServerDeps = {}): McpServer {
     {
       title: "Open a position before the work",
       description:
-        "Ask for a BitGraph position BEFORE starting a task, so the task can be done inside the BitGraph. Returns a fuse_token, the position, its floor block, and the slot's commitment as a string. " +
+        "Ask for a BitGraph position BEFORE starting a task, so the task can be done inside the BitGraph. Returns a fuse_token, the position, its floor block, and its position commitment as a string. " +
         "Put the commitment string into the task before running it (the prompt or request you send, a seed, a line in the document, text that must appear in the output), then call bitgraph_commit with the fuse_token and the task file's path within " + SLOT_TTL_SECONDS + " seconds. " +
         "What that gives a stranger: the task could not have existed before the floor block (the commitment did not exist before the position did), and the outputs, recorded afterwards with bitgraph_record, sit at later positions. " +
         "Nothing about the task is sent here; only its digest is, at commit. Positions are permanent: open one only when a task is about to run.",
@@ -720,7 +559,7 @@ export function buildServer(deps: ServerDeps = {}): McpServer {
       title: "Seal the task under its position",
       description:
         "Step two of doing work inside a BitGraph: seal the task bytes that carry the commitment under the position bitgraph_open returned. Give the fuse_token and the path of the task file (the exact request, prompt or document that contains the commitment string), or its SHA-256 (base64) when the bytes are elsewhere. " +
-        "With a path, the file is read on this machine, the commitment string is looked for inside it BEFORE anything is sent (a task that does not carry it is refused and the slot stays held), and only the digest travels. " +
+        "With a path, the file is read on this machine, the commitment string is looked for inside it BEFORE anything is sent (a task that does not carry it is refused and the position stays held), and only the digest travels. " +
         "Returns the proof: keep it beside the task bytes. Then record the outputs with bitgraph_record. Must be called within " + SLOT_TTL_SECONDS + " seconds of bitgraph_open.",
       inputSchema: {
         fuse_token: z.string().min(1).max(8000).describe("The fuse_token bitgraph_open returned."),
@@ -758,7 +597,7 @@ export function buildServer(deps: ServerDeps = {}): McpServer {
         const structured = { outcome: "sealed", slot_counter: state.slot.counter, counter, epoch: epoch ? toUrlSafeB64(epoch) : null, floor_block: floor, artifact_digest: toUrlSafeB64(sealed.artifactDigestB64), commitment_offsets: sealed.offsets, proof_path: proofPath, instructions: proofNote.trim(), proof: sealed.proof };
         if (response_format === "json") return ok(JSON.stringify(structured, null, 2), structured);
         return ok(
-          `Sealed the task at position ${counter ?? "?"} (slot ${state.slot.counter}).${floor !== null ? ` Not before block ${floor}.` : ""} ` +
+          `Sealed the task at position ${counter ?? "?"} (reserved at ${state.slot.counter}).${floor !== null ? ` Not before block ${floor}.` : ""} ` +
             (sealed.offsets !== null ? `The commitment string was found in the sealed bytes at offset ${sealed.offsets[0]}. ` : "The bytes were not read here; a verifier looks for the commitment string in them. ") +
             proofNote +
             "Record the outputs with bitgraph_record when they exist." +

package/dist/__tests__/encoding.test.d.ts

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

package/dist/__tests__/encoding.test.d.ts.map

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

package/dist/__tests__/encoding.test.js

@@ -1,51 +0,0 @@
-// Copyright (c) 2024-2026 Argento Computing Inc. Licensed under the MIT License. See LICENSE.
-import { test } from "node:test";
-import { strict as assert } from "node:assert";
-import { createHash } from "node:crypto";
-import { writeFile, mkdtemp } from "node:fs/promises";
-import { tmpdir } from "node:os";
-import { join } from "node:path";
-import { fromUrlSafeB64, looksLikeDigest, mapConcurrent, sha256FileB64, toUrlSafeB64, } from "../encoding.js";
-// A real 32-byte digest with + and / to exercise both substitutions.
-const STANDARD = createHash("sha256").update("bitgraph").digest("base64");
-test("url-safe round trip preserves the digest", () => {
-    const safe = toUrlSafeB64(STANDARD);
-    assert.ok(!safe.includes("+") && !safe.includes("/") && !safe.includes("="));
-    assert.equal(fromUrlSafeB64(safe), STANDARD);
-});
-test("fromUrlSafeB64 is a no-op on standard base64", () => {
-    assert.equal(fromUrlSafeB64(STANDARD), STANDARD);
-});
-test("looksLikeDigest accepts both forms, rejects junk", () => {
-    assert.ok(looksLikeDigest(STANDARD));
-    assert.ok(looksLikeDigest(toUrlSafeB64(STANDARD)));
-    assert.ok(!looksLikeDigest("not-a-digest"));
-    assert.ok(!looksLikeDigest(""));
-    assert.ok(!looksLikeDigest(Buffer.alloc(16).toString("base64"))); // 16 bytes, not 32
-});
-test("sha256FileB64 matches crypto over the same bytes", async () => {
-    const dir = await mkdtemp(join(tmpdir(), "bitgraph-mcp-"));
-    const file = join(dir, "sample.bin");
-    const bytes = Buffer.from("BitGraph proves causal ordering.\n");
-    await writeFile(file, bytes);
-    const expected = createHash("sha256").update(bytes).digest("base64");
-    assert.equal(await sha256FileB64(file), expected);
-});
-test("sha256FileB64 rejects directories and missing files", async () => {
-    await assert.rejects(() => sha256FileB64(tmpdir()), /Not a regular file/);
-    await assert.rejects(() => sha256FileB64(join(tmpdir(), "definitely-missing-9x7")));
-});
-test("mapConcurrent preserves order and honors the limit", async () => {
-    let inFlight = 0;
-    let peak = 0;
-    const out = await mapConcurrent([1, 2, 3, 4, 5, 6, 7, 8], 3, async (n) => {
-        inFlight += 1;
-        peak = Math.max(peak, inFlight);
-        await new Promise((r) => setTimeout(r, 5));
-        inFlight -= 1;
-        return n * 2;
-    });
-    assert.deepEqual(out, [2, 4, 6, 8, 10, 12, 14, 16]);
-    assert.ok(peak <= 3, `peak concurrency ${peak} exceeded 3`);
-});
-//# sourceMappingURL=encoding.test.js.map

package/dist/__tests__/encoding.test.js.map

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

package/dist/__tests__/scan.test.d.ts

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

package/dist/__tests__/scan.test.d.ts.map

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

package/dist/__tests__/scan.test.js

@@ -1,73 +0,0 @@
-// Copyright (c) 2024-2026 Argento Computing Inc. Licensed under the MIT License. See LICENSE.
-/**
- * The scan's two promises: the digest is the file's own, and a state
- * finished with the placement's suffix for a slot is the hash of the
- * placement's own build for that slot. Both are pinned across sizes on both
- * sides of every boundary that matters (the 64-byte sniff, the tar block,
- * the 64 KB stream chunk) for both placements the scan makes.
- */
-import { test, before } from "node:test";
-import { strict as assert } from "node:assert";
-import { createHash, randomBytes } from "node:crypto";
-import { mkdtemp, mkdir, symlink, writeFile } from "node:fs/promises";
-import { tmpdir } from "node:os";
-import { join } from "node:path";
-import { placementForBytes } from "@mikeargento/bitgraph";
-import { getPlacement } from "@mikeargento/bitgraph-verify";
-import { expandPaths, fusedDigestFor, scanFile } from "../scan.js";
-let root = "";
-before(async () => {
-    root = await mkdtemp(join(tmpdir(), "bitgraph-mcp-scan-"));
-});
-const PNG = Buffer.from([0x89, 0x50, 0x4e, 0x47, 0x0d, 0x0a, 0x1a, 0x0a]);
-const SIZES = [0, 1, 8, 63, 64, 65, 511, 512, 513, 1024, 65_535, 65_536, 65_537, 200_000];
-test("a scan's digest is the file's own and its state finishes to the placement's own build", async () => {
-    let checked = 0;
-    for (const size of SIZES) {
-        for (const kind of ["png", "txt"]) {
-            const lead = kind === "png" ? PNG : Buffer.from("txt:");
-            const bytes = Buffer.concat([lead, randomBytes(Math.max(0, size - lead.length))]).subarray(0, size);
-            const path = join(root, `${kind}-${size}.bin`);
-            await writeFile(path, bytes);
-            const s = await scanFile(path);
-            assert.equal(s.size, size);
-            assert.equal(s.digestB64, createHash("sha256").update(bytes).digest("base64"), `${kind} ${size}: digest`);
-            assert.equal(s.placement, placementForBytes(new Uint8Array(bytes)), `${kind} ${size}: the core's own placement choice`);
-            assert.ok(s.state !== null, "a file that did not change keeps its state");
-            const placement = getPlacement(s.placement);
-            if (placement === undefined)
-                throw new Error("placement missing");
-            // Two slots, both finished from the same saved state: the copy leaves the state intact.
-            for (const commitment of [randomBytes(32), randomBytes(32)]) {
-                const built = placement.build({ original: new Uint8Array(bytes), originDigest: s.originDigest, commitment: new Uint8Array(commitment) });
-                const expected = createHash("sha256").update(built).digest();
-                assert.deepEqual(Buffer.from(fusedDigestFor(s, new Uint8Array(commitment))), expected, `${kind} ${size}: state finished == sha256(build)`);
-                checked += 1;
-            }
-        }
-    }
-    assert.equal(checked, SIZES.length * 4);
-});
-test("expandPaths: files, directories, hidden entries, links, duplicates, limits, missing paths", async () => {
-    const lone = join(root, "lone.txt");
-    await writeFile(lone, "lone");
-    const dir = join(root, "tree");
-    await mkdir(join(dir, "sub", ".secret"), { recursive: true });
-    await writeFile(join(dir, "a.txt"), "a");
-    await writeFile(join(dir, ".DS_Store"), "junk");
-    await writeFile(join(dir, "sub", "b.txt"), "b");
-    await writeFile(join(dir, "sub", ".secret", "c.txt"), "c");
-    await symlink(join(dir, "a.txt"), join(dir, "link.txt"));
-    const e = await expandPaths([lone, dir], 100);
-    assert.deepEqual(e.files, [lone, join(dir, "a.txt"), join(dir, "sub", "b.txt")]);
-    assert.equal(e.directories, 1);
-    const twice = await expandPaths([lone, lone, dir, join(dir, "a.txt")], 100);
-    assert.deepEqual(twice.files, [lone, join(dir, "a.txt"), join(dir, "sub", "b.txt")], "the same file twice is one file");
-    await assert.rejects(expandPaths([dir], 1), /more than 1 files/);
-    await assert.rejects(expandPaths([lone, join(root, "missing.txt")], 100), (err) => {
-        assert.ok(err.message.includes("nothing was BitGraphed"));
-        assert.ok(err.message.includes(join(root, "missing.txt")));
-        return true;
-    });
-});
-//# sourceMappingURL=scan.test.js.map

package/dist/__tests__/scan.test.js.map

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

package/dist/api.d.ts

@@ -1,42 +0,0 @@
-import type { BatchCheckResponse, ProofDetailResponse, SearchResponse, SetIndexResponse } from "./types.js";
-export interface ApiConfig {
-    baseUrl: string;
-    apiKey?: string;
-}
-/** Read configuration from the environment at call time (testable via env). */
-export declare function configFromEnv(): ApiConfig;
-/** Matches the batch endpoint's MAX_DIGESTS. */
-export declare const BATCH_CHECK_LIMIT = 500;
-export declare class ApiError extends Error {
-    readonly status: number;
-    readonly retryAfterSec: number | null;
-    constructor(status: number, message: string, retryAfterSec?: number | null);
-}
-/**
- * Look up which digests are on record. Input digests must be URL-safe base64;
- * the response is keyed by the exact strings sent. Pages of up to 500, a few
- * in flight at once.
- */
-export declare function batchCheck(config: ApiConfig, urlSafeDigests: readonly string[]): Promise<BatchCheckResponse>;
-/** One request's worth of a set/2's member evidence, for the site to index. */
-export interface SetIndexRequest {
-    /** The set proof's artifact digest, URL-safe base64. */
-    setDigest: string;
-    /** The set proof's epoch id, URL-safe base64. */
-    epoch: string;
-    /** The set proof's commit counter. */
-    counter: string;
-    members: unknown[];
-}
-/**
- * Index members of a set/2 from their evidence. The site reads the set proof
- * from its own position, binds the root document, and checks every member's
- * path before writing a key; a row that does not bind is rejected, never
- * written.
- */
-export declare function indexSetMembers(config: ApiConfig, body: SetIndexRequest): Promise<SetIndexResponse>;
-/** Full detail for one digest: proof, all causal positions, anchor window. */
-export declare function getProofDetail(config: ApiConfig, urlSafeDigest: string, counter?: string, urlSafeEpoch?: string): Promise<ProofDetailResponse>;
-/** Resolve a BitGraph number (or digest string) to a digest via /api/search. */
-export declare function search(config: ApiConfig, q: string): Promise<SearchResponse>;
-//# sourceMappingURL=api.d.ts.map

package/dist/api.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../src/api.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAE5G,MAAM,WAAW,SAAS;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,+EAA+E;AAC/E,wBAAgB,aAAa,IAAI,SAAS,CAIzC;AAED,gDAAgD;AAChD,eAAO,MAAM,iBAAiB,MAAM,CAAC;AAOrC,qBAAa,QAAS,SAAQ,KAAK;IACjC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;gBAE1B,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,aAAa,GAAE,MAAM,GAAG,IAAW;CAKjF;AA0DD;;;;GAIG;AACH,wBAAsB,UAAU,CAC9B,MAAM,EAAE,SAAS,EACjB,cAAc,EAAE,SAAS,MAAM,EAAE,GAChC,OAAO,CAAC,kBAAkB,CAAC,CAW7B;AAED,+EAA+E;AAC/E,MAAM,WAAW,eAAe;IAC9B,wDAAwD;IACxD,SAAS,EAAE,MAAM,CAAC;IAClB,iDAAiD;IACjD,KAAK,EAAE,MAAM,CAAC;IACd,sCAAsC;IACtC,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,OAAO,EAAE,CAAC;CACpB;AAED;;;;;GAKG;AACH,wBAAsB,eAAe,CAAC,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAEzG;AAED,8EAA8E;AAC9E,wBAAsB,cAAc,CAClC,MAAM,EAAE,SAAS,EACjB,aAAa,EAAE,MAAM,EACrB,OAAO,CAAC,EAAE,MAAM,EAChB,YAAY,CAAC,EAAE,MAAM,GACpB,OAAO,CAAC,mBAAmB,CAAC,CAU9B;AAED,gFAAgF;AAChF,wBAAsB,MAAM,CAAC,MAAM,EAAE,SAAS,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CAMlF"}

package/dist/api.js

@@ -1,121 +0,0 @@
-// Copyright (c) 2024-2026 Argento Computing Inc. Licensed under the MIT License. See LICENSE.
-/**
- * @mikeargento/bitgraph-mcp: HTTP client for the hosted BitGraph API.
- *
- * The reads: the batch lookup, the proof detail, the number search. Making a
- * BitGraph goes through the core package's own transport against the same
- * site (its /api/fuse routes), which is what maintains the per-position
- * by-digest index that makes every member of a set discoverable afterward;
- * the one write here is a set/2's member evidence, indexed after the commit.
- */
-import { mapConcurrent } from "./encoding.js";
-/** 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 batch endpoint's MAX_DIGESTS. */
-export const BATCH_CHECK_LIMIT = 500;
-/** Batch lookups in flight at once: a large folder is many pages. */
-const BATCH_CHECK_CONCURRENCY = 4;
-const CHECK_TIMEOUT_MS = 30_000;
-const SET_INDEX_TIMEOUT_MS = 60_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. Pages of up to 500, a few
- * in flight at once.
- */
-export async function batchCheck(config, urlSafeDigests) {
-    const chunks = [];
-    for (let offset = 0; offset < urlSafeDigests.length; offset += BATCH_CHECK_LIMIT) {
-        chunks.push(urlSafeDigests.slice(offset, offset + BATCH_CHECK_LIMIT));
-    }
-    const pages = await mapConcurrent(chunks, BATCH_CHECK_CONCURRENCY, (chunk) => postJson(config, "/api/proofs/batch", { digests: chunk }, CHECK_TIMEOUT_MS, false));
-    const merged = { results: {} };
-    for (const page of pages)
-        Object.assign(merged.results, page.results);
-    return merged;
-}
-/**
- * Index members of a set/2 from their evidence. The site reads the set proof
- * from its own position, binds the root document, and checks every member's
- * path before writing a key; a row that does not bind is rejected, never
- * written.
- */
-export async function indexSetMembers(config, body) {
-    return postJson(config, "/api/fuse/set-index", body, SET_INDEX_TIMEOUT_MS, false);
-}
-/** 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

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