@otskit/mcp 0.5.0 → 0.6.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 OTSkit
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -10,6 +10,8 @@
 [![TypeScript](https://img.shields.io/badge/TypeScript-6-blue.svg)](https://www.typescriptlang.org/)
 [![Node ≥20](https://img.shields.io/badge/node-%3E%3D20-brightgreen)](https://nodejs.org)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
+[![Glama](https://glama.ai/mcp/servers/OTSkit/OTSkit-MCP/badges/score.svg)](https://glama.ai/mcp/servers/OTSkit/OTSkit-MCP)
+[![OTSkit-MCP MCP server](https://glama.ai/mcp/servers/OTSkit/OTSkit-MCP/badges/card.svg)](https://glama.ai/mcp/servers/OTSkit/OTSkit-MCP)
 
 OpenTimestamps MCP server — stamp, upgrade, and verify Bitcoin timestamps via AI agents.
 
@@ -58,6 +60,8 @@ Each command writes the MCP entry into the agent's config file, makes a `.bak` b
 | `inspect_timestamp` | Inspect a stored proof file without network calls |
 | `list_pending` | List stamps with status, retry count, and filters |
 | `watch` | Open a terminal window monitoring pending stamps in real-time |
+| `hash_file` | Compute the SHA-256 of a local file and return it as a 64-char hex string (no network calls) |
+| `stamp_file` | Compute SHA-256 of a local file and stamp it on Bitcoin in one step |
 
 ## Data directory
 
@@ -103,4 +107,4 @@ npm test         # run tests
 - [`@otskit/core`](https://github.com/AlexAlves87/otskit-core) — OpenTimestamps core logic
 - [`@otskit/client`](https://github.com/AlexAlves87/otskit-client) — OTS calendar client
 - [`@modelcontextprotocol/sdk`](https://github.com/modelcontextprotocol/typescript-sdk) — MCP SDK
-- `better-sqlite3` — local database
+- `node-sqlite3-wasm` — local database (pure WASM, no native compilation)

package/dist/{chunk-OMNHFTJW.js → chunk-EJNN5HXO.js}

@@ -1,6 +1,6 @@
 import {
   getDataDir
-} from "./chunk-4ZDPWS7C.js";
+} from "./chunk-R2HGDQWP.js";
 import {
   writeAtomic
 } from "./chunk-YFSUDT24.js";
@@ -14,14 +14,15 @@ import { OpenTimestampsClient } from "@otskit/client";
 // src/db/stamps.ts
 function insertStamp(db, params) {
   const now = (/* @__PURE__ */ new Date()).toISOString();
-  db.prepare(`
-    INSERT INTO stamps (id, hash, status, created_at, proof_path, archive_path, attempt_count, metadata)
-    VALUES (?, ?, 'pending', ?, ?, ?, 0, ?)
-  `).run(params.id, params.hash, now, params.proof_path, params.archive_path ?? null, params.metadata ?? null);
+  db.run(
+    `INSERT INTO stamps (id, hash, status, created_at, proof_path, archive_path, attempt_count, metadata)
+     VALUES (?, ?, 'pending', ?, ?, ?, 0, ?)`,
+    [params.id, params.hash, now, params.proof_path, params.archive_path ?? null, params.metadata ?? null]
+  );
   return getStamp(db, params.id);
 }
 function getStamp(db, id) {
-  return db.prepare("SELECT * FROM stamps WHERE id = ?").get(id) ?? null;
+  return db.get("SELECT * FROM stamps WHERE id = ?", [id]) ?? null;
 }
 function updateStampStatus(db, id, params) {
   const fields = [];
@@ -40,7 +41,7 @@ function updateStampStatus(db, id, params) {
   if (params.next_retry_at !== void 0) add("next_retry_at", params.next_retry_at);
   if (fields.length === 0) return;
   values.push(id);
-  db.prepare(`UPDATE stamps SET ${fields.join(", ")} WHERE id = ?`).run(...values);
+  db.run(`UPDATE stamps SET ${fields.join(", ")} WHERE id = ?`, values);
 }
 function listStamps(db, params) {
   const conds = [];
@@ -59,26 +60,29 @@ function listStamps(db, params) {
     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(
-    `SELECT * FROM stamps ${where} ORDER BY created_at DESC LIMIT ? OFFSET ?`
-  ).all(...vals, params.limit, params.offset);
+  const countParams = vals.length ? vals : void 0;
+  const total = db.get(`SELECT COUNT(*) as n FROM stamps ${where}`, countParams).n;
+  const items = db.all(
+    `SELECT * FROM stamps ${where} ORDER BY created_at DESC LIMIT ? OFFSET ?`,
+    [...vals, params.limit, params.offset]
+  );
   return { items, total };
 }
 
 // src/db/operations-log.ts
 function logOperation(db, params) {
-  db.prepare(`
-    INSERT INTO operations_log (stamp_id, action, result, error_msg, calendar_uri, response_time_ms, created_at)
-    VALUES (?, ?, ?, ?, ?, ?, ?)
-  `).run(
-    params.stamp_id,
-    params.action,
-    params.result,
-    params.error_msg ?? null,
-    params.calendar_uri ?? null,
-    params.response_time_ms ?? null,
-    (/* @__PURE__ */ new Date()).toISOString()
+  db.run(
+    `INSERT INTO operations_log (stamp_id, action, result, error_msg, calendar_uri, response_time_ms, created_at)
+     VALUES (?, ?, ?, ?, ?, ?, ?)`,
+    [
+      params.stamp_id,
+      params.action,
+      params.result,
+      params.error_msg ?? null,
+      params.calendar_uri ?? null,
+      params.response_time_ms ?? null,
+      (/* @__PURE__ */ new Date()).toISOString()
+    ]
   );
 }
 

package/dist/{chunk-4ZDPWS7C.js → chunk-R2HGDQWP.js}

@@ -34,23 +34,23 @@ function loadConfig() {
 }
 
 // src/db/index.ts
-import DatabaseConstructor from "better-sqlite3";
+import { createRequire } from "module";
 import { join as join2 } from "path";
 import { mkdirSync as mkdirSync2, statSync } from "fs";
 
 // src/db/schema.ts
 function initDb(db) {
-  db.pragma("journal_mode = WAL");
-  db.pragma("busy_timeout = 5000");
-  db.pragma("foreign_keys = ON");
+  db.exec("PRAGMA busy_timeout = 5000");
+  db.exec("PRAGMA foreign_keys = ON");
   runMigrations(db);
 }
 function runMigrations(db) {
-  const version = db.pragma("user_version", { simple: true });
-  if (version < 1) migrateTo1(db);
+  const row = db.get("PRAGMA user_version");
+  if (row.user_version < 1) migrateTo1(db);
 }
 function migrateTo1(db) {
-  db.transaction(() => {
+  db.exec("BEGIN");
+  try {
     db.exec(`
       CREATE TABLE IF NOT EXISTS stamps (
         id              TEXT PRIMARY KEY,
@@ -84,33 +84,43 @@ function migrateTo1(db) {
       CREATE INDEX IF NOT EXISTS idx_oplog_stamp_id ON operations_log(stamp_id);
       CREATE INDEX IF NOT EXISTS idx_oplog_created  ON operations_log(created_at);
     `);
-    db.pragma("user_version = 1");
-  })();
+    db.exec("PRAGMA user_version = 1");
+    db.exec("COMMIT");
+  } catch (e) {
+    db.exec("ROLLBACK");
+    throw e;
+  }
 }
 
 // src/db/index.ts
+var _require = createRequire(import.meta.url);
+var { Database } = _require("node-sqlite3-wasm");
 var _db = null;
 function getDb() {
   if (_db) return _db;
   const dir = getDataDir();
   mkdirSync2(dir, { recursive: true });
-  _db = new DatabaseConstructor(join2(dir, "db.sqlite"));
+  _db = new Database(join2(dir, "db.sqlite"));
   initDb(_db);
   reconcileOrphans(_db);
   return _db;
 }
 function backupDb(destPath) {
-  getDb().backup(destPath);
+  const escaped = destPath.replace(/'/g, "''");
+  getDb().exec(`VACUUM INTO '${escaped}'`);
 }
 function reconcileOrphans(db) {
-  const pending = db.prepare(
+  const pending = db.all(
     `SELECT id, proof_path FROM stamps WHERE status = 'pending' AND proof_path IS NOT NULL`
-  ).all();
+  );
   for (const row of pending) {
     try {
       statSync(row.proof_path);
     } catch {
-      db.prepare(`UPDATE stamps SET status = 'failed', last_error = ? WHERE id = ?`).run("proof file missing on disk", row.id);
+      db.run(
+        `UPDATE stamps SET status = 'failed', last_error = ? WHERE id = ?`,
+        ["proof file missing on disk", row.id]
+      );
     }
   }
 }

package/dist/{cli-D7G2H6UT.js → cli-4QMQ3NIC.js}

@@ -3,12 +3,12 @@ import {
   listPending,
   upgradeTimestamp,
   verifyTimestamp
-} from "./chunk-OMNHFTJW.js";
+} from "./chunk-EJNN5HXO.js";
 import {
   backupDb,
   getDb,
   loadConfig
-} from "./chunk-4ZDPWS7C.js";
+} from "./chunk-R2HGDQWP.js";
 import "./chunk-YFSUDT24.js";
 
 // src/cli.ts

package/dist/index.js

@@ -20,7 +20,7 @@ Commands:
 }
 switch (command) {
   case "serve": {
-    const { runServer } = await import("./server-6QAYMGCK.js");
+    const { runServer } = await import("./server-ATWAFTPU.js");
     await runServer();
     break;
   }
@@ -49,7 +49,7 @@ switch (command) {
     break;
   }
   case "watch": {
-    const { watchPending } = await import("./watch-7NPUWR6I.js");
+    const { watchPending } = await import("./watch-JD5XLLTV.js");
     const parsed = args[0] ? parseInt(args[0], 10) : NaN;
     const interval = isNaN(parsed) || parsed < 1 ? 5 : parsed;
     if (args[0] && (isNaN(parsed) || parsed < 1))
@@ -65,7 +65,7 @@ switch (command) {
   case "check-pending":
   case "backup":
   case "scheduler": {
-    const { runCli } = await import("./cli-D7G2H6UT.js");
+    const { runCli } = await import("./cli-4QMQ3NIC.js");
     await runCli(command, args);
     break;
   }

package/dist/{server-6QAYMGCK.js → server-ATWAFTPU.js}

@@ -4,11 +4,11 @@ import {
   listPending,
   upgradeTimestamp,
   verifyTimestamp
-} from "./chunk-OMNHFTJW.js";
+} from "./chunk-EJNN5HXO.js";
 import {
   getDb,
   loadConfig
-} from "./chunk-4ZDPWS7C.js";
+} from "./chunk-R2HGDQWP.js";
 import "./chunk-YFSUDT24.js";
 
 // src/server.ts
@@ -80,6 +80,20 @@ async function stampFile(input, db, config) {
   return createTimestamp({ hash }, db, config);
 }
 
+// src/tools/hash-file.ts
+import { hashFile } from "@otskit/client";
+async function hashFileTool(input) {
+  try {
+    const buf = await hashFile(input.path);
+    return { hash: buf.toString("hex") };
+  } catch (e) {
+    if (e?.code === "ENOENT") {
+      return { error: "file_not_found", details: `File not found: ${input.path}` };
+    }
+    throw e;
+  }
+}
+
 // src/tool-definitions.ts
 var TOOL_DEFINITIONS = [
   {
@@ -161,6 +175,21 @@ var TOOL_DEFINITIONS = [
       openWorldHint: false
     }
   },
+  {
+    name: "hash_file",
+    description: "Computes the SHA-256 hash of a local file and returns it as a 64-character hex string. No network calls \u2014 pure local operation.",
+    inputSchema: {
+      type: "object",
+      properties: { path: { type: "string", description: "Absolute path to the file" } },
+      required: ["path"]
+    },
+    annotations: {
+      readOnlyHint: true,
+      destructiveHint: false,
+      idempotentHint: true,
+      openWorldHint: false
+    }
+  },
   {
     name: "stamp_file",
     description: "Stamps a file against public OpenTimestamps calendars. Computes SHA-256 of the file and stamps it on Bitcoin. IMPORTANT: the digest is sent to external calendar servers (alice.btc, bob.btc, finney, catallaxy).",
@@ -225,6 +254,9 @@ async function runServer() {
         case "list_pending":
           result = listPending(args, db, config);
           break;
+        case "hash_file":
+          result = await hashFileTool(args);
+          break;
         case "stamp_file":
           result = await stampFile(args, db, config);
           break;
@@ -240,6 +272,13 @@ async function runServer() {
       return { content: [{ type: "text", text: JSON.stringify({ error: "internal_error", details: String(e) }) }], isError: true };
     }
   });
+  const exit = () => {
+    db.close();
+    process.exit(0);
+  };
+  process.stdin.on("close", exit);
+  process.on("SIGTERM", exit);
+  process.on("SIGINT", exit);
   const transport = new StdioServerTransport();
   await server.connect(transport);
 }

package/dist/{watch-7NPUWR6I.js → watch-JD5XLLTV.js}

@@ -1,20 +1,20 @@
 import {
   getDb,
   loadConfig
-} from "./chunk-4ZDPWS7C.js";
+} from "./chunk-R2HGDQWP.js";
 
 // src/tools/watch.ts
 async function watchPending(intervalMinutes = 5) {
   const config = loadConfig();
-  const db = getDb(config);
+  const db = getDb();
   process.stdout.write(`Watching pending stamps every ${intervalMinutes} min. Ctrl+C to stop.
 
 `);
   function tick() {
-    const rows = db.prepare(
+    const rows = db.all(
       `SELECT id, hash, status, attempt_count, bitcoin_block, confirmed_at FROM stamps WHERE status != 'confirmed' ORDER BY created_at DESC`
-    ).all();
-    const confirmed = db.prepare(`SELECT COUNT(*) as n FROM stamps WHERE status = 'confirmed'`).get();
+    );
+    const confirmed = db.get(`SELECT COUNT(*) as n FROM stamps WHERE status = 'confirmed'`);
     process.stdout.write(`${now()} \u2014 ${rows.length} pendientes, ${confirmed.n} confirmados
 `);
     for (const row of rows) {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@otskit/mcp",
   "mcpName": "io.github.AlexAlves87/otskit-mcp",
-  "version": "0.5.0",
+  "version": "0.6.1",
   "license": "MIT",
   "description": "OpenTimestamps MCP server — stamp, upgrade, verify via AI agents",
   "repository": {
@@ -21,20 +21,19 @@
     "dist"
   ],
   "scripts": {
-    "build": "tsup src/index.ts --format esm --clean",
+    "build": "tsup src/index.ts --format esm --clean --external node-sqlite3-wasm",
     "dev": "tsup src/index.ts --format esm --watch",
     "test": "vitest run",
     "test:watch": "vitest"
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.29.0",
-    "@otskit/client": "^0.1.1",
+    "@otskit/client": "^0.2.0",
     "@otskit/core": "^0.1.0",
-    "better-sqlite3": "^12.10.0"
+    "node-sqlite3-wasm": "0.8.57"
   },
   "pnpm": {
     "onlyBuiltDependencies": [
-      "better-sqlite3",
       "esbuild"
     ]
   },
@@ -46,7 +45,6 @@
     "@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": "^25.9.1",
     "semantic-release": "^25.0.3",
     "tsup": "^8.3.5",