@mikeargento/bitgraph-mcp 0.7.0 → 0.8.0

package/dist/scan.js

@@ -1,201 +0,0 @@
-// Copyright (c) 2024-2026 Argento Computing Inc. Licensed under the MIT License. See LICENSE.
-/**
- * @mikeargento/bitgraph-mcp: the scan.
- *
- * One pass over each file yields its SHA-256 (the member's origin) and a
- * hasher left open after the placement's prefix and the file's last byte, so
- * the member's fused digest can be finished later, for whatever slot the set
- * is made under, without reading the file again. A placement is prefix,
- * original, suffix (its frame): trailer/1 has no prefix and container/2's is
- * the original's tar header, which depends on the size alone; the suffix
- * carries the commitment and is hashed at BitGraph time. Node's SHA-256 is
- * the platform's own, and a Hash can be copied mid-stream, which is the whole
- * trick: the copy takes the suffix, so no file is read twice or held in
- * memory, and the original is never touched.
- */
-import { createHash } from "node:crypto";
-import { createReadStream } from "node:fs";
-import { readdir, stat } from "node:fs/promises";
-import { basename, join } from "node:path";
-import { placementForBytes } from "@mikeargento/bitgraph";
-import { getPlacement } from "@mikeargento/bitgraph-verify";
-/**
- * Content Credentials detection, structural and cheap: a C2PA manifest lives
- * in a JUMBF box whose description ("jumd") is followed within a few bytes by
- * the store label "c2pa", in every container (JPEG APP11, PNG caBX, ISO BMFF).
- * Requiring the pair in order and near each other keeps a stray "c2pa" in
- * prose from counting. Detection, not judgment: the proof page parses and
- * displays the manifest itself.
- */
-const JUMD = Buffer.from("jumd", "ascii");
-const C2PA_LABEL = Buffer.from("c2pa", "ascii");
-const C2PA_NEAR = 96;
-function windowHasC2pa(buf) {
-    for (let i = buf.indexOf(JUMD); i !== -1; i = buf.indexOf(JUMD, i + 1)) {
-        const from = i + JUMD.length;
-        const to = Math.min(buf.length, i + C2PA_NEAR);
-        if (buf.subarray(from, to).indexOf(C2PA_LABEL) !== -1)
-            return true;
-    }
-    return false;
-}
-class C2paSniffer {
-    found = false;
-    /** The last C2PA_NEAR + 4 bytes of the previous chunk, so a pair split across chunks is seen whole. */
-    carry = Buffer.alloc(0);
-    update(chunk) {
-        if (this.found)
-            return;
-        const buf = this.carry.length > 0 ? Buffer.concat([this.carry, chunk]) : chunk;
-        if (windowHasC2pa(buf)) {
-            this.found = true;
-            return;
-        }
-        const keep = Math.min(buf.length, C2PA_NEAR + JUMD.length);
-        this.carry = Buffer.from(buf.subarray(buf.length - keep));
-    }
-}
-/** One-shot form for bytes already in memory (a carrier's committed bytes). */
-export function sniffC2paBytes(bytes) {
-    return windowHasC2pa(Buffer.from(bytes.buffer, bytes.byteOffset, bytes.byteLength));
-}
-/** Bytes the placement decision reads: every magic number sits in the first 16. */
-const SNIFF = 64;
-/** Hash one file in a single pass. Throws, before any network call, when the path is not a regular file. */
-export async function scanFile(path) {
-    const info = await stat(path);
-    if (!info.isFile())
-        throw new Error(`Not a regular file: ${path}`);
-    const size = info.size;
-    const origin = createHash("sha256");
-    // Held in one object: the closures below assign to it.
-    const run = { fused: null, placement: null };
-    let head = null;
-    let bytes = 0;
-    const start = (p) => {
-        run.placement = p;
-        // A second hasher runs over prefix and bytes when the prefix is not
-        // empty; with an empty prefix the origin hasher's own state is the fused state.
-        const prefix = getPlacement(p)?.scanPrefix?.(size) ?? null;
-        if (prefix !== null && prefix.length > 0)
-            run.fused = createHash("sha256").update(prefix);
-    };
-    const sniffer = new C2paSniffer();
-    const feed = (chunk) => {
-        origin.update(chunk);
-        if (run.fused !== null)
-            run.fused.update(chunk);
-        sniffer.update(chunk);
-    };
-    for await (const raw of createReadStream(path)) {
-        const chunk = raw;
-        if (run.placement === null) {
-            head = head === null ? chunk : Buffer.concat([head, chunk]);
-            if (head.length >= SNIFF) {
-                start(placementForBytes(new Uint8Array(head.subarray(0, SNIFF))));
-                feed(head);
-                head = null;
-            }
-        }
-        else {
-            feed(chunk);
-        }
-        bytes += chunk.length;
-    }
-    if (run.placement === null) {
-        // A short file: decide from what there is, then hash it.
-        start(placementForBytes(new Uint8Array(head ?? Buffer.alloc(0))));
-        if (head !== null)
-            feed(head);
-    }
-    const placement = run.placement;
-    const state = bytes !== size ? null : (run.fused ?? origin);
-    // When the origin hasher is the state its digest is taken from a copy, so it stays open.
-    const digest = state === origin ? origin.copy().digest() : origin.digest();
-    return {
-        path,
-        name: basename(path),
-        size,
-        digestB64: digest.toString("base64"),
-        originDigest: Uint8Array.from(digest),
-        placement,
-        state,
-        c2pa: sniffer.found,
-    };
-}
-/**
- * A member's fused digest for a slot: the open hasher, copied, finished with
- * the placement's suffix for that slot's commitment. The hash of prefix,
- * original, suffix is exactly the hash of the placement's own build, which
- * a test pins.
- */
-export function fusedDigestFor(file, commitment) {
-    if (file.state === null)
-        throw new Error(`${file.path}: the file changed while it was read`);
-    const placement = getPlacement(file.placement);
-    if (placement?.frame === undefined)
-        throw new Error(`placement ${file.placement} has no frame`);
-    const { suffix } = placement.frame({ originalSize: file.size, originDigest: file.originDigest, commitment });
-    return Uint8Array.from(file.state.copy().update(suffix).digest());
-}
-/**
- * Paths to files: a regular file is itself; a directory is every regular
- * file under it, recursively, with hidden entries (names starting with a
- * dot) and symbolic links left out. The same file twice is one file. A path
- * that is missing or neither kind, or more than `limit` files in all, throws
- * before any network call; the message names every path that failed.
- */
-export async function expandPaths(paths, limit) {
-    const files = [];
-    const seen = new Set();
-    const failures = [];
-    let directories = 0;
-    const push = (p) => {
-        if (seen.has(p))
-            return;
-        seen.add(p);
-        files.push(p);
-        if (files.length > limit)
-            throw new Error(`more than ${limit} files; BitGraph fewer at a time`);
-    };
-    const walk = async (dir) => {
-        const entries = (await readdir(dir, { withFileTypes: true }))
-            .filter((e) => !e.name.startsWith("."))
-            .sort((a, b) => (a.name < b.name ? -1 : a.name > b.name ? 1 : 0));
-        for (const e of entries) {
-            const full = join(dir, e.name);
-            if (e.isSymbolicLink())
-                continue;
-            if (e.isDirectory())
-                await walk(full);
-            else if (e.isFile())
-                push(full);
-        }
-    };
-    for (const p of paths) {
-        try {
-            const info = await stat(p);
-            if (info.isDirectory()) {
-                directories += 1;
-                await walk(p);
-            }
-            else if (info.isFile()) {
-                push(p);
-            }
-            else {
-                throw new Error("not a regular file or a directory");
-            }
-        }
-        catch (err) {
-            const message = err instanceof Error ? err.message : String(err);
-            if (message.startsWith("more than "))
-                throw err;
-            failures.push(`${p}: ${message}`);
-        }
-    }
-    if (failures.length > 0) {
-        throw new Error(`Could not read ${failures.length} path(s); nothing was BitGraphed.\n${failures.join("\n")}\nUse absolute paths to existing regular files or directories.`);
-    }
-    return { files, directories };
-}
-//# sourceMappingURL=scan.js.map

package/dist/scan.js.map

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

package/dist/task.d.ts

@@ -1,55 +0,0 @@
-import type { BitGraphProof, SlotAllocation } from "@mikeargento/bitgraph-verify";
-import { type ApiConfig } from "./api.js";
-export declare const SLOT_TTL_SECONDS = 120;
-export interface TaskState {
-    v: 1;
-    task: true;
-    slot: SlotAllocation;
-}
-export declare function encodeTaskToken(state: TaskState): string;
-export declare function decodeTaskToken(token: string): TaskState | null;
-export interface Begun {
-    token: string;
-    /** Unpadded base64url: the string to put into the task. */
-    commitment: string;
-    commitmentB64: string;
-    slotCounter: string;
-    epoch: string;
-    floor: {
-        block: number;
-    } | null;
-}
-/** Step one of the task form: a held slot and its commitment, before any work exists. */
-export declare function beginTask(config: ApiConfig): Promise<Begun>;
-export interface SealedTask {
-    proof: BitGraphProof;
-    artifactDigestB64: string;
-    /** Byte offsets of the commitment string inside the task bytes, when the bytes were given. */
-    offsets: number[] | null;
-}
-/**
- * Step two: the task bytes (a path, or the bytes themselves) sealed under
- * the held slot with the inline marker. When the bytes are in hand the
- * commitment is looked for BEFORE the commit, so a task that does not carry
- * it is refused without spending the slot.
- */
-export declare function sealTask(config: ApiConfig, state: TaskState, task: {
-    path: string;
-} | {
-    bytes: Uint8Array;
-} | {
-    digestB64: string;
-}): Promise<SealedTask>;
-export declare const TASK_INSTRUCTIONS: string;
-/**
- * Write a sealed task's proof beside the file it is about, whole, and say
- * where. `make_task.txt` gets `make_task.proof.json`; a name already taken
- * gets the position's counter in it rather than being overwritten.
- *
- * ⚠️ THE SERVER WRITES IT, NOT THE AGENT. Handed the JSON to save, an agent
- * tidied it and dropped slotAllocation and environment, and the signature
- * had no body left to be checked against (Grok, 2026-09-13). A file this
- * process writes is the proof exactly as the boundary returned it.
- */
-export declare function writeProofBeside(sealedPath: string, proof: BitGraphProof): Promise<string>;
-//# sourceMappingURL=task.d.ts.map

package/dist/task.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"task.d.ts","sourceRoot":"","sources":["../src/task.ts"],"names":[],"mappings":"AAqBA,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAClF,OAAO,EAAY,KAAK,SAAS,EAAE,MAAM,UAAU,CAAC;AAGpD,eAAO,MAAM,gBAAgB,MAAM,CAAC;AAKpC,MAAM,WAAW,SAAS;IACxB,CAAC,EAAE,CAAC,CAAC;IACL,IAAI,EAAE,IAAI,CAAC;IACX,IAAI,EAAE,cAAc,CAAC;CACtB;AASD,wBAAgB,eAAe,CAAC,KAAK,EAAE,SAAS,GAAG,MAAM,CAExD;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAO/D;AAkBD,MAAM,WAAW,KAAK;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,2DAA2D;IAC3D,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;CACjC;AAED,yFAAyF;AACzF,wBAAsB,SAAS,CAAC,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC,KAAK,CAAC,CAcjE;AAED,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,aAAa,CAAC;IACrB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,8FAA8F;IAC9F,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;CAC1B;AAED;;;;;GAKG;AACH,wBAAsB,QAAQ,CAAC,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,KAAK,EAAE,UAAU,CAAA;CAAE,GAAG;IAAE,SAAS,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,UAAU,CAAC,CA4B/J;AAkBD,eAAO,MAAM,iBAAiB,QAK0J,CAAC;AAEzL;;;;;;;;;GASG;AACH,wBAAsB,gBAAgB,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,MAAM,CAAC,CAWhG"}

package/dist/task.js

@@ -1,182 +0,0 @@
-// Copyright (c) 2024-2026 Argento Computing Inc. Licensed under the MIT License. See LICENSE.
-/**
- * A position BEFORE the work: the task form of the stdio server.
- *
- * bitgraph_open with no files asks the site's own /api/fuse/allocate for a
- * slot and returns its commitment, and nothing else. The caller puts the
- * commitment into the task it is about to run (the prompt, the request, a
- * seed, a line in the document) and, within the slot's life, commits the
- * digest of those task bytes under the slot with the inline marker
- * (bitgraph-fuse/1, title base64url): a verifier recomputes the commitment
- * from the slot record and finds its base64url text inside the bytes.
- * Outputs are recorded afterwards with bitgraph_record and sit later.
- *
- * The slot allocation and the commit go through the same two site routes
- * the core package's fuse() uses; the recovery rule is the core's (read back
- * by digest, refuse a proof under any other slot).
- */
-import { readFile } from "node:fs/promises";
-import { createHash } from "node:crypto";
-import { bytesToBase64, computeSlotCommitment, findCommitment, inlineAttribution, verifyProofIntegrity, ENCODING_BASE64URL } from "@mikeargento/bitgraph-verify";
-import { ApiError } from "./api.js";
-import { toUrlSafeB64 } from "./encoding.js";
-export const SLOT_TTL_SECONDS = 120;
-const CHAIN = "bitgraph:main";
-const B64_32 = /^[A-Za-z0-9+/]{43}=$/;
-const B64_64 = /^[A-Za-z0-9+/]{86}==$/;
-function isSlotRecord(x) {
-    if (x === null || typeof x !== "object" || Array.isArray(x))
-        return false;
-    const s = x;
-    return s.version === "bitgraph/slot/1" && typeof s.nonceB64 === "string" && B64_32.test(s.nonceB64) && typeof s.counter === "string" && /^(0|[1-9][0-9]*)$/.test(s.counter)
-        && typeof s.epochId === "string" && typeof s.publicKeyB64 === "string" && typeof s.signatureB64 === "string" && B64_64.test(s.signatureB64) && s.chainId === CHAIN;
-}
-export function encodeTaskToken(state) {
-    return Buffer.from(JSON.stringify(state), "utf8").toString("base64url");
-}
-export function decodeTaskToken(token) {
-    let parsed;
-    try {
-        parsed = JSON.parse(Buffer.from(token, "base64url").toString("utf8"));
-    }
-    catch {
-        return null;
-    }
-    if (typeof parsed !== "object" || parsed === null)
-        return null;
-    const s = parsed;
-    if (s.v !== 1 || s.task !== true || !isSlotRecord(s.slot))
-        return null;
-    return { v: 1, task: true, slot: s.slot };
-}
-async function post(config, path, body, timeoutMs) {
-    const headers = { "content-type": "application/json", accept: "application/json" };
-    if (config.apiKey)
-        headers["authorization"] = `Bearer ${config.apiKey}`;
-    const res = await fetch(`${config.baseUrl}${path}`, { method: "POST", headers, body: JSON.stringify(body), signal: AbortSignal.timeout(timeoutMs) });
-    let json = null;
-    try {
-        json = await res.json();
-    }
-    catch { /* non-JSON */ }
-    const raw = res.headers.get("retry-after");
-    const retry = raw !== null ? Number.parseInt(raw, 10) : NaN;
-    return { status: res.status, json, retryAfterSec: Number.isFinite(retry) ? retry : null };
-}
-const messageOf = (json, fallback) => {
-    const e = json?.error;
-    return typeof e === "string" ? e : fallback;
-};
-/** Step one of the task form: a held slot and its commitment, before any work exists. */
-export async function beginTask(config) {
-    const r = await post(config, "/api/fuse/allocate", {}, 20_000);
-    if (r.status !== 200)
-        throw new ApiError(r.status, messageOf(r.json, `allocation refused (${r.status})`), r.retryAfterSec);
-    const slot = r.json?.slot;
-    if (!isSlotRecord(slot))
-        throw new ApiError(502, "the allocation response is not a slot record on bitgraph:main");
-    const commitmentB64 = bytesToBase64(computeSlotCommitment(slot));
-    let floor = null;
-    try {
-        const res = await fetch(`${config.baseUrl}/api/proofs/anchors?counter=${encodeURIComponent(slot.counter)}&epoch=${encodeURIComponent(slot.epochId)}&before=1`, { headers: { accept: "application/json" }, signal: AbortSignal.timeout(10_000) });
-        const data = res.status === 200 ? (await res.json()) : null;
-        const b = data?.anchors?.[0]?.commit?.anchor?.blockNumber;
-        if (typeof b === "number")
-            floor = { block: b };
-    }
-    catch {
-        floor = null;
-    }
-    return { token: encodeTaskToken({ v: 1, task: true, slot }), commitment: toUrlSafeB64(commitmentB64), commitmentB64, slotCounter: slot.counter, epoch: toUrlSafeB64(slot.epochId), floor };
-}
-/**
- * Step two: the task bytes (a path, or the bytes themselves) sealed under
- * the held slot with the inline marker. When the bytes are in hand the
- * commitment is looked for BEFORE the commit, so a task that does not carry
- * it is refused without spending the slot.
- */
-export async function sealTask(config, state, task) {
-    const { slot } = state;
-    const commitment = computeSlotCommitment(slot);
-    let bytes = null;
-    let artifactDigestB64;
-    if ("digestB64" in task) {
-        if (!B64_32.test(task.digestB64))
-            throw new ApiError(400, "artifact digest must be a base64 SHA-256");
-        artifactDigestB64 = task.digestB64;
-    }
-    else {
-        bytes = "path" in task ? new Uint8Array(await readFile(task.path)) : task.bytes;
-        artifactDigestB64 = createHash("sha256").update(bytes).digest("base64");
-    }
-    const offsets = bytes === null ? null : findCommitment(bytes, commitment, ENCODING_BASE64URL);
-    if (offsets !== null && offsets.length === 0) {
-        throw new ApiError(400, `the task bytes do not contain the commitment string ${toUrlSafeB64(bytesToBase64(commitment))}; put it in before sealing. Nothing was committed and the slot is still held.`);
-    }
-    const attribution = inlineAttribution();
-    const r = await post(config, "/api/fuse/commit", { digests: [{ digestB64: artifactDigestB64, hashAlg: "sha256" }], slotId: slot.nonceB64, slot, chainId: CHAIN, attribution }, 40_000);
-    let proof = null;
-    if (r.status === 200)
-        proof = (r.json?.proof ?? null);
-    else if (r.status === 409 || r.status === 503)
-        proof = await recover(config, artifactDigestB64, slot);
-    if (proof === null)
-        throw new ApiError(r.status, messageOf(r.json, `commit refused (${r.status})`), r.retryAfterSec);
-    if (proof.artifact?.digestB64 !== artifactDigestB64 || proof.commit?.nonceB64 !== slot.nonceB64 || proof.slotAllocation?.nonceB64 !== slot.nonceB64)
-        throw new ApiError(502, "the boundary returned a proof under a different slot; nothing is labelled sealed");
-    const a = proof.attribution;
-    if (a?.name !== attribution.name || a?.title !== attribution.title || a?.message !== undefined)
-        throw new ApiError(502, "the returned proof does not carry the inline marker that was sent; nothing is labelled sealed");
-    const integrity = await verifyProofIntegrity({ proof });
-    if (!integrity.valid)
-        throw new ApiError(502, `the returned proof does not verify: ${integrity.reason ?? "unknown reason"}`);
-    return { proof, artifactDigestB64, offsets };
-}
-async function recover(config, artifactDigestB64, slot) {
-    for (let attempt = 0; attempt < 4; attempt++) {
-        if (attempt > 0)
-            await new Promise((r) => setTimeout(r, 1500));
-        try {
-            const res = await fetch(`${config.baseUrl}/api/proofs/${encodeURIComponent(toUrlSafeB64(artifactDigestB64))}`, { headers: { accept: "application/json" }, signal: AbortSignal.timeout(15_000) });
-            if (res.status !== 200)
-                continue;
-            const j = (await res.json());
-            for (const e of j?.proofs ?? []) {
-                const p = e.proof;
-                if (p && p.artifact?.digestB64 === artifactDigestB64 && p.commit?.nonceB64 === slot.nonceB64)
-                    return p;
-            }
-        }
-        catch { /* try again */ }
-    }
-    return null;
-}
-export const TASK_INSTRUCTIONS = "You hold a position and its commitment, and no work exists yet. Put the commitment string INSIDE THE OUTPUT you are about to make whenever its format can hold text (SVG, HTML, code, JSON, Markdown, CSV, a document): as a comment, a field, a line that stays in the file. " +
-    `When the output exists, call bitgraph_commit with this fuse_token and the output file's path, within ${SLOT_TTL_SECONDS} seconds of opening: the output itself is sealed under the position, and the proof is written beside it. ` +
-    "If the output cannot hold text (a PNG, audio, video) or will take longer than that to make, put the commitment into a task file instead (the exact prompt or request you send), seal that file the same way, and when the output exists record it with bitgraph_record: the task is sealed before the output existed, and the output is recorded after. " +
-    "Keep the exact bytes that were sealed unchanged: a verifier recomputes the commitment from the proof and looks for the string inside them. " +
-    "Leave the proof file as written, whole, every field, environment.attestation.reportB64 included: a proof missing slotAllocation, environment, or the attestation cannot be verified.";
-/**
- * Write a sealed task's proof beside the file it is about, whole, and say
- * where. `make_task.txt` gets `make_task.proof.json`; a name already taken
- * gets the position's counter in it rather than being overwritten.
- *
- * ⚠️ THE SERVER WRITES IT, NOT THE AGENT. Handed the JSON to save, an agent
- * tidied it and dropped slotAllocation and environment, and the signature
- * had no body left to be checked against (Grok, 2026-09-13). A file this
- * process writes is the proof exactly as the boundary returned it.
- */
-export async function writeProofBeside(sealedPath, proof) {
-    const { writeFile, access } = await import("node:fs/promises");
-    const { basename, dirname, extname, join } = await import("node:path");
-    const dir = dirname(sealedPath);
-    const base = basename(sealedPath);
-    const stem = extname(base) === "" ? base : base.slice(0, -extname(base).length);
-    const counter = proof.commit?.counter ?? "0";
-    let target = join(dir, `${stem}.proof.json`);
-    if (await access(target).then(() => true).catch(() => false))
-        target = join(dir, `${stem}.proof.${counter}.json`);
-    await writeFile(target, JSON.stringify(proof, null, 2) + "\n", { flag: "wx" });
-    return target;
-}
-//# sourceMappingURL=task.js.map

package/dist/task.js.map

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

package/dist/types.d.ts

@@ -1,108 +0,0 @@
-/**
- * @mikeargento/bitgraph-mcp: wire types.
- *
- * Minimal views of the bitgraph/1 schema and the bitgraph.ing API responses.
- * The canonical, fully documented schema lives in @mikeargento/bitgraph-verify.
- * Fields not needed for display are kept as unknown; proofs are passed through
- * verbatim when the caller asks for JSON.
- */
-export interface ProofCommit {
-    counter?: string;
-    epochId?: string;
-    time?: number;
-    slotCounter?: string;
-    [k: string]: unknown;
-}
-export interface BitGraphProof {
-    version?: string;
-    artifact?: {
-        hashAlg?: string;
-        digestB64?: string;
-    };
-    commit?: ProofCommit;
-    signer?: {
-        publicKeyB64?: string;
-        signatureB64?: string;
-    };
-    environment?: {
-        enforcement?: string;
-        measurement?: string;
-        attestation?: {
-            format?: string;
-            reportB64?: string;
-        };
-    };
-    attribution?: {
-        name?: string;
-        title?: string;
-        message?: string;
-    };
-    metadata?: unknown;
-    proofHash?: string;
-    [k: string]: unknown;
-}
-/** A set member's row as the site reports it: which row of N these bytes are, and whether as the original or the new file. */
-export interface SetMemberView {
-    index: number;
-    count: number;
-    role?: "origin" | "fused";
-}
-/** POST /api/proofs/batch response. Keyed by the digest exactly as sent (URL-safe). */
-export interface BatchCheckResponse {
-    results: Record<string, {
-        proofs: Array<{
-            proof: BitGraphProof;
-            kind?: "recorded" | "fused";
-            member?: SetMemberView;
-            setDigest?: string;
-        }>;
-    }>;
-}
-/** POST /api/fuse/set-index response: how many members' evidence the site wrote. */
-export interface SetIndexResponse {
-    count?: number;
-    written: number;
-    failed: number;
-    rejected: number;
-}
-export interface AnchorView {
-    counter?: string;
-    attrName?: string;
-    blockNumber?: number | null;
-    blockHash?: string | null;
-    etherscanUrl?: string | null;
-    blockTime?: string | null;
-}
-export interface PositionView {
-    counter: string | null;
-    epoch: string | null;
-    lowerTime: string | null;
-    upperTime: string | null;
-    kind?: "recorded" | "fused";
-    placement?: string | null;
-    member?: SetMemberView;
-}
-/**
- * GET /api/proofs/digest/{digest} response.
- * causalWindow naming note: anchorBefore is the EARLIER Ethereum block (the
- * proof was BitGraphed after it, the lower time bound); anchorAfter is the
- * LATER block (the upper bound). Present time as "between lower and upper".
- */
-export interface ProofDetailResponse {
-    proofs: Array<{
-        proof: BitGraphProof;
-    }>;
-    positions?: PositionView[];
-    causalWindow?: {
-        anchorBefore: AnchorView | null;
-        anchorAfter: AnchorView | null;
-    } | null;
-    anchorBlock?: AnchorView | null;
-}
-/** GET /api/search response. */
-export interface SearchResponse {
-    found: boolean;
-    digest?: string;
-    counter?: string | null;
-}
-//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -1,3 +0,0 @@
-// Copyright (c) 2024-2026 Argento Computing Inc. Licensed under the MIT License. See LICENSE.
-export {};
-//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,8FAA8F"}