@otskit/mcp 0.1.5 → 0.1.6

package/README.md

@@ -1,5 +1,5 @@
 <p align="center">
-  <img src="docs/header.png" alt="OTSkit.ts MCP" width="480" />
+  <img src="https://raw.githubusercontent.com/OTSkit/OTSkit-MCP/master/docs/header.png" alt="OTSkit.ts MCP" width="480" />
 </p>
 
 # @otskit/mcp
@@ -8,6 +8,8 @@ OpenTimestamps MCP server — stamp, upgrade, and verify Bitcoin timestamps via
 
 Exposes a set of tools to any MCP-compatible agent so it can timestamp documents, monitor confirmation status, and verify proofs against the Bitcoin blockchain — all from a conversation.
 
+> **Note on confirmation times:** After stamping, a proof is `pending` until Bitcoin confirms it. This typically takes **10–60 minutes** but can take **several hours** during network congestion. Use `ots-mcp watch` or `upgrade_timestamp` to monitor. A pending status is not an error.
+
 ## Install
 
 ```bash
@@ -38,7 +40,7 @@ Each command writes the MCP entry into the agent's config file, makes a `.bak` b
 | `ots-mcp backup [dest]` | Backup the SQLite database |
 | `ots-mcp setup <claude\|codex>` | Configure MCP for an agent |
 
-## MCP tools exposed to Claude
+## MCP tools exposed to agents
 
 | Tool | Description |
 |---|---|
@@ -67,10 +69,6 @@ Create `~/.ots-mcp/config.json` to override defaults:
 ```json
 {
   "stamp_enabled": true,
-  "preserve_enabled": true,
-  "preserve_whitelist": ["/path/to/allowed/dir"],
-  "preserve_max_bytes": 104857600,
-  "preserve_max_files": 10000,
   "scheduler_interval_minutes": 30,
   "retry_max_attempts": 20,
   "calendar_timeout_ms": 10000,

package/dist/{chunk-55NLVWDQ.js → chunk-VHQD7HZD.js}

@@ -54,6 +54,10 @@ function listStamps(db, params) {
     conds.push("created_at < ?");
     vals.push(cutoff);
   }
+  if (params.due_now) {
+    conds.push("(next_retry_at IS NULL OR next_retry_at <= ?)");
+    vals.push((/* @__PURE__ */ new Date()).toISOString());
+  }
   const where = conds.length ? `WHERE ${conds.join(" AND ")}` : "";
   const total = db.prepare(`SELECT COUNT(*) as n FROM stamps ${where}`).get(...vals).n;
   const items = db.prepare(
@@ -121,17 +125,23 @@ async function createTimestamp(input, db, config) {
 // src/tools/upgrade-timestamp.ts
 import { readFileSync } from "fs";
 import { OpenTimestampsClient as OpenTimestampsClient2, UpgradeError } from "@otskit/client";
-import { DetachedTimestampFile } from "@otskit/core";
+import { DetachedTimestampFile, StreamDeserializationContext } from "@otskit/core";
+function collectAttestations(ts) {
+  const atts = [...ts.attestations];
+  for (const branch of ts.branches) {
+    atts.push(...collectAttestations(branch.stamp));
+  }
+  return atts;
+}
 function checkBitcoinConfirmation(bytes) {
   try {
-    const proof = DetachedTimestampFile.deserialize(new Uint8Array(bytes));
-    const attestations = proof.timestamp.getAttestations();
-    const bitcoin = attestations.filter((a) => a.kind === "bitcoin");
-    if (bitcoin.length > 0) {
-      const block = Math.min(...bitcoin.map((a) => a.height));
-      return { confirmed: true, block };
-    }
-    return { confirmed: false };
+    const ctx = new StreamDeserializationContext(new Uint8Array(bytes));
+    const dtf = DetachedTimestampFile.deserialize(ctx);
+    const attestations = collectAttestations(dtf.timestamp);
+    const bitcoinAtts = attestations.filter((a) => a.kind === "bitcoin");
+    if (bitcoinAtts.length === 0) return { confirmed: false };
+    const block = Math.min(...bitcoinAtts.map((a) => a.height));
+    return { confirmed: true, block };
   } catch {
     return { confirmed: false };
   }
@@ -237,7 +247,8 @@ function listPending(input, db, _config) {
     status: input.status ?? "pending",
     limit: Math.min(input.limit ?? 50, 200),
     offset: input.offset ?? 0,
-    older_than_hours: input.older_than_hours
+    older_than_hours: input.older_than_hours,
+    due_now: input.due_now
   });
 }
 

package/dist/{cli-ZD2OP45N.js → cli-TF5PYS3T.js}

@@ -3,7 +3,7 @@ import {
   listPending,
   upgradeTimestamp,
   verifyTimestamp
-} from "./chunk-55NLVWDQ.js";
+} from "./chunk-VHQD7HZD.js";
 import {
   backupDb,
   getDb,
@@ -68,7 +68,7 @@ async function runCli(command, args) {
       break;
     }
     case "check-pending": {
-      const { items } = listPending({ status: "pending", limit: 200 }, db, config);
+      const { items } = listPending({ status: "pending", limit: 200, due_now: true }, db, config);
       process.stderr.write(`Processing ${items.length} pending stamps...
 `);
       for (const record of items) {

package/dist/index.js

@@ -20,7 +20,7 @@ Commands:
 }
 switch (command) {
   case "serve": {
-    const { runServer } = await import("./server-Q7XYIZRY.js");
+    const { runServer } = await import("./server-D5YXBC55.js");
     await runServer();
     break;
   }
@@ -62,7 +62,7 @@ switch (command) {
   case "check-pending":
   case "backup":
   case "scheduler": {
-    const { runCli } = await import("./cli-ZD2OP45N.js");
+    const { runCli } = await import("./cli-TF5PYS3T.js");
     await runCli(command, args);
     break;
   }

package/dist/{server-Q7XYIZRY.js → server-D5YXBC55.js}

@@ -4,7 +4,7 @@ import {
   listPending,
   upgradeTimestamp,
   verifyTimestamp
-} from "./chunk-55NLVWDQ.js";
+} from "./chunk-VHQD7HZD.js";
 import {
   getDb,
   loadConfig
@@ -31,15 +31,15 @@ function inspectTimestamp(input, db, _config) {
   } catch {
     return { error: "proof_missing", details: `Cannot read proof: ${record.proof_path}` };
   }
-  let attestationCount = 0;
-  let hasBitcoin = false;
+  let calendarAttestations = 0;
+  let bitcoinAttestations = 0;
   let bitcoinBlock = null;
   try {
     const proof = DetachedTimestampFile.deserialize(new Uint8Array(proofBytes));
     const attestations = proof.timestamp.getAttestations();
-    attestationCount = attestations.length;
-    hasBitcoin = attestations.some((a) => a.kind === "bitcoin");
-    if (hasBitcoin) {
+    bitcoinAttestations = attestations.filter((a) => a.kind === "bitcoin").length;
+    calendarAttestations = attestations.filter((a) => a.kind !== "bitcoin").length;
+    if (bitcoinAttestations > 0) {
       const blocks = attestations.filter((a) => a.kind === "bitcoin").map((a) => a.height);
       bitcoinBlock = blocks.length > 0 ? Math.min(...blocks) : null;
     }
@@ -52,8 +52,9 @@ function inspectTimestamp(input, db, _config) {
     created_at: record.created_at,
     proof_path: record.proof_path,
     proof_size_bytes: proofSize,
-    attestation_count: attestationCount,
-    has_bitcoin_confirmation: hasBitcoin,
+    calendar_attestations: calendarAttestations,
+    bitcoin_attestations: bitcoinAttestations,
+    bitcoin_confirmed: bitcoinAttestations > 0,
     bitcoin_block: bitcoinBlock
   };
 }
@@ -119,7 +120,7 @@ var TOOL_DEFINITIONS = [
   },
   {
     name: "inspect_timestamp",
-    description: "Shows the contents of a stored proof file without making any network calls. Useful for debugging: returns size, parsed attestations, and confirmation status from the proof itself.",
+    description: "Inspects a stored proof file without network calls. Returns calendar_attestations (promises from OTS servers, NOT Bitcoin confirmation) and bitcoin_attestations (actual Bitcoin blocks). A stamp is only truly confirmed when bitcoin_attestations > 0 and bitcoin_confirmed is true.",
     inputSchema: {
       type: "object",
       properties: { id: { type: "string", description: "UUID from the stamp record" } },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@otskit/mcp",
-  "version": "0.1.5",
+  "version": "0.1.6",
   "description": "OpenTimestamps MCP server — stamp, upgrade, verify via AI agents",
   "type": "module",
   "engines": {
@@ -20,9 +20,9 @@
     "test:watch": "vitest"
   },
   "dependencies": {
-    "@otskit/core": "^0.1.0",
-    "@otskit/client": "^0.1.1",
     "@modelcontextprotocol/sdk": "^1.29.0",
+    "@otskit/client": "^0.1.1",
+    "@otskit/core": "^0.1.0",
     "better-sqlite3": "^12.10.0"
   },
   "pnpm": {
@@ -32,8 +32,15 @@
     ]
   },
   "devDependencies": {
+    "@semantic-release/changelog": "^6",
+    "@semantic-release/commit-analyzer": "^13.0.0",
+    "@semantic-release/git": "^10",
+    "@semantic-release/github": "^12.0.8",
+    "@semantic-release/npm": "^13.1.5",
+    "@semantic-release/release-notes-generator": "^14.0.0",
     "@types/better-sqlite3": "^7.6.13",
     "@types/node": "^22.0.0",
+    "semantic-release": "^25.0.3",
     "tsup": "^8.3.5",
     "typescript": "^5.6.3",
     "vitest": "^2.1.4"