thingd-cli 0.7.0 → 0.9.0

package/README.md

@@ -2,9 +2,9 @@
 
 [![npm version](https://badge.fury.io/js/thingd-cli.svg)](https://www.npmjs.com/package/thingd-cli)
 
-Admin and operator CLI for [thingd](https://www.npmjs.com/package/thingd).
+Command-line interface, Interactive TUI Dashboard, and Model Context Protocol (MCP) server for [thingd](https://www.npmjs.com/package/thingd).
 
-This package provides the `thingd` binary. It uses the public `thingd` SDK for store access and can connect to a local store or a remote sidecar through `THINGD_URL`.
+This package provides the unified `thingd` binary, which serves as a persistent stdio/HTTP MCP server for AI editors (Cursor, Claude Desktop), an interactive terminal UI dashboard for database operations, and a scriptable JSON utility to inspect and manage local or remote databases.
 
 ## Installation
 

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAKA,OAAO,EAOL,MAAM,EACN,KAAK,YAAY,EAClB,MAAM,QAAQ,CAAC;AAKhB,KAAK,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;AAEjD,KAAK,YAAY,GAAG;IAClB,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAC1B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,MAAM,CAAC,EAAE,YAAY,CAAC;CACvB,CAAC;AAEF,KAAK,UAAU,GAAG;IAChB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IAC7B,QAAQ,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;CACvB,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG;IACvB,MAAM,EAAE,UAAU,CAAC;IACnB,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,YAAY,CAAC;IACrB,MAAM,EAAE,YAAY,CAAC;IACrB,MAAM,EAAE,OAAO,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,OAAO,CAAC;CAChB,CAAC;AA0CF,wBAAsB,MAAM,CAC1B,IAAI,WAAwB,EAC5B,OAAO,GAAE,aAAkB,GAC1B,OAAO,CAAC,MAAM,CAAC,CAiCjB;AA+UD,wBAAsB,MAAM,CAC1B,OAAO,EAAE,UAAU,EACnB,QAAQ,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,GACtC,OAAO,CAAC,IAAI,CAAC,CAcf;AA4BD,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,UAAU,GAAG,iBAAiB,CAiBxE"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAOA,OAAO,EAOL,MAAM,EACN,KAAK,YAAY,EAClB,MAAM,QAAQ,CAAC;AAKhB,KAAK,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;AAEjD,KAAK,YAAY,GAAG;IAClB,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAC1B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,MAAM,CAAC,EAAE,YAAY,CAAC;CACvB,CAAC;AAEF,KAAK,UAAU,GAAG;IAChB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IAC7B,QAAQ,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;CACvB,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG;IACvB,MAAM,EAAE,UAAU,CAAC;IACnB,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,YAAY,CAAC;IACrB,MAAM,EAAE,YAAY,CAAC;IACrB,MAAM,EAAE,OAAO,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,OAAO,CAAC;CAChB,CAAC;AA0CF,wBAAsB,MAAM,CAC1B,IAAI,WAAwB,EAC5B,OAAO,GAAE,aAAkB,GAC1B,OAAO,CAAC,MAAM,CAAC,CAiEjB;AA+UD,wBAAsB,MAAM,CAC1B,OAAO,EAAE,UAAU,EACnB,QAAQ,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,GACtC,OAAO,CAAC,IAAI,CAAC,CAcf;AA4BD,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,UAAU,GAAG,iBAAiB,CA2BxE"}

package/dist/index.js

@@ -1,4 +1,6 @@
 #!/usr/bin/env node
+import { realpathSync } from "node:fs";
+import { resolve } from "node:path";
 import { pathToFileURL } from "node:url";
 import { Client } from "@modelcontextprotocol/sdk/client/index.js";
 import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp.js";
@@ -45,6 +47,31 @@ Options:
 `;
 const BOOLEAN_FLAGS = new Set(["h", "help", "json", "pretty", "allow-unauthenticated"]);
 export async function runCli(args = process.argv.slice(2), options = {}) {
+    // Auto-detect and set THINGD_NATIVE_PATH if not already set, to allow global execution
+    // to seamlessly locate the native compiled library in the workspace or global node_modules.
+    if (!process.env.THINGD_NATIVE_PATH) {
+        try {
+            const { existsSync } = await import("node:fs");
+            const { homedir } = await import("node:os");
+            const { join } = await import("node:path");
+            const cliDir = join(resolveCliPath(), "..", "..");
+            const candidates = [
+                join(cliDir, "node_modules", "thingd-native", "dist", "thingd_native.node"),
+                join(cliDir, "..", "thingd-native", "dist", "thingd_native.node"),
+                join(homedir(), "Space/Programming/personal/thingd/packages/thingd-native/dist/thingd_native.node"),
+                join(homedir(), "Space/Programming/personal/thingd-cloud/packages/thingd-native/dist/thingd_native.node"),
+            ];
+            for (const candidate of candidates) {
+                if (existsSync(candidate)) {
+                    process.env.THINGD_NATIVE_PATH = candidate;
+                    break;
+                }
+            }
+        }
+        catch {
+            // Ignore detection errors
+        }
+    }
     const parsed = parseArgs(args);
     const context = {
         parsed,
@@ -359,13 +386,24 @@ export function resolveConnection(context) {
     const url = stringFlag(context.parsed, "url") ?? context.env.THINGD_URL;
     const path = url ?? stringFlag(context.parsed, "path") ?? context.env.THINGD_PATH ?? defaultThingdDbPath();
     const cloud = isCloudPath(path);
-    const driver = parseDriver(stringFlag(context.parsed, "driver") ?? context.env.THINGD_DRIVER);
+    let driver = parseDriver(stringFlag(context.parsed, "driver") ?? context.env.THINGD_DRIVER);
+    if (!driver) {
+        if (cloud) {
+            driver = "cloud";
+        }
+        else if (path !== ":memory:") {
+            driver = "native";
+        }
+        else {
+            driver = "memory";
+        }
+    }
     if (!cloud && path === defaultThingdDbPath()) {
         ensureThingdDir();
     }
     return {
         path,
-        driver: driver ?? (cloud ? "cloud" : undefined),
+        driver,
         authToken: stringFlag(context.parsed, "auth-token") ?? context.env.THINGD_AUTH_TOKEN,
         cloud,
     };
@@ -506,6 +544,22 @@ function writeJson(target, data, pretty) {
 function writeText(target, text) {
     target.write(text.endsWith("\n") ? text : `${text}\n`);
 }
-if (process.argv[1] && import.meta.url === pathToFileURL(process.argv[1]).href) {
+function resolveCliPath() {
+    const scriptPath = process.argv[1];
+    if (!scriptPath) {
+        throw new Error("Could not detect thingd CLI path from process.argv[1].");
+    }
+    return resolve(scriptPath);
+}
+let isMain = false;
+if (process.argv[1]) {
+    try {
+        isMain = import.meta.url === pathToFileURL(realpathSync(process.argv[1])).href;
+    }
+    catch {
+        // Ignore realpath resolution errors.
+    }
+}
+if (isMain) {
     process.exitCode = await runCli();
 }

package/dist/mcp.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mcp.d.ts","sourceRoot":"","sources":["../src/mcp.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,UAAU,EAAU,MAAM,YAAY,CAAC;AAGrD,wBAAsB,MAAM,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAY/D"}
+{"version":3,"file":"mcp.d.ts","sourceRoot":"","sources":["../src/mcp.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,UAAU,EAA6B,MAAM,YAAY,CAAC;AAGxE,wBAAsB,MAAM,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAkB/D"}

package/dist/mcp.js

@@ -1,11 +1,16 @@
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
-import { withDb } from "./index.js";
+import { resolveConnection, withDb } from "./index.js";
 import { createThingdMcpServer } from "./mcp/index.js";
 export async function runMcp(context) {
+    const connection = resolveConnection(context);
     await withDb(context, async (db) => {
         // We pass empty options to createThingdMcpServer so it uses default audit behavior
         const server = createThingdMcpServer(db);
         const transport = new StdioServerTransport();
+        context.stderr.write(`\nthingd stdio MCP server started successfully.\n`);
+        context.stderr.write(`  ✓ Database: ${connection.path}\n`);
+        context.stderr.write(`  ✓ Driver:   ${connection.driver ?? "memory"}\n`);
+        context.stderr.write(`  ✓ Transport: Stdio (listening silently on stdin)\n\n`);
         await server.connect(transport);
         // Keep the process alive and the database connection open
         // so the MCP server can continue to receive messages over stdio.

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "thingd-cli",
-  "version": "0.7.0",
-  "description": "Admin and operator CLI for thingd.",
+  "version": "0.9.0",
+  "description": "Command-line interface, Interactive TUI Dashboard, and MCP server for thingd.",
   "type": "module",
   "author": "Sayan Mohsin",
   "license": "Apache-2.0",
@@ -33,7 +33,7 @@
     "cli-table3": "^0.6.5",
     "picocolors": "^1.1.1",
     "zod": "^4.4.3",
-    "thingd": "0.7.0"
+    "thingd": "0.9.0"
   },
   "engines": {
     "node": ">=20"