@thingd/cli 0.31.0

package/dist/mcp.d.ts

@@ -0,0 +1,3 @@
+import { type CliContext } from "./index.js";
+export declare function runMcp(context: CliContext): Promise<void>;
+//# sourceMappingURL=mcp.d.ts.map

package/dist/mcp.d.ts.map

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

package/dist/mcp.js

@@ -0,0 +1,22 @@
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { createThingdMcpServer, readMcpHardeningOptionsFromEnv } from "@thingd/node";
+import { resolveConnection, withDb } from "./index.js";
+import { readMcpAuditOptionsFromEnv } from "./mcp/config.js";
+export async function runMcp(context) {
+    const connection = resolveConnection(context);
+    await withDb(context, async (db) => {
+        const server = createThingdMcpServer(db, {
+            audit: readMcpAuditOptionsFromEnv(context.env),
+            hardening: readMcpHardeningOptionsFromEnv(context.env),
+        });
+        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.
+        return new Promise(() => { });
+    });
+}

package/dist/paths.d.ts

@@ -0,0 +1,4 @@
+export declare function defaultThingdDir(): string;
+export declare function defaultThingdDbPath(): string;
+export declare function ensureThingdDir(): void;
+//# sourceMappingURL=paths.d.ts.map

package/dist/paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../src/paths.ts"],"names":[],"mappings":"AAOA,wBAAgB,gBAAgB,IAAI,MAAM,CAEzC;AAED,wBAAgB,mBAAmB,IAAI,MAAM,CAE5C;AAED,wBAAgB,eAAe,IAAI,IAAI,CAEtC"}

package/dist/paths.js

@@ -0,0 +1,14 @@
+import { mkdirSync } from "node:fs";
+import { homedir } from "node:os";
+import { join } from "node:path";
+const THINGD_DIR_NAME = ".thingd";
+const THINGD_DB_NAME = "data.db";
+export function defaultThingdDir() {
+    return join(homedir(), THINGD_DIR_NAME);
+}
+export function defaultThingdDbPath() {
+    return join(defaultThingdDir(), THINGD_DB_NAME);
+}
+export function ensureThingdDir() {
+    mkdirSync(defaultThingdDir(), { recursive: true });
+}

package/dist/rest/helpers.d.ts

@@ -0,0 +1,17 @@
+import type { IncomingMessage, ServerResponse } from "node:http";
+type SortField = "id" | "collection" | "created_at" | "updated_at" | "version";
+type SortDirection = "asc" | "desc";
+type LocalSortBy = {
+    field: SortField;
+    direction?: SortDirection;
+};
+export declare function readBody(req: IncomingMessage): Promise<string>;
+export declare function sendJson(res: ServerResponse, status: number, data: unknown): void;
+export declare function sendData(res: ServerResponse, data: unknown): void;
+export declare function sendDataList(res: ServerResponse, data: unknown[], total?: number): void;
+export declare function sendError(res: ServerResponse, status: number, code: string, message: string): void;
+export declare function parseSortBy(params: URLSearchParams): LocalSortBy | undefined;
+export declare function parseFilter(params: URLSearchParams): Record<string, unknown> | undefined;
+export declare function parseIntParam(value: string | null): number | undefined;
+export {};
+//# sourceMappingURL=helpers.d.ts.map

package/dist/rest/helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../src/rest/helpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAEjE,KAAK,SAAS,GAAG,IAAI,GAAG,YAAY,GAAG,YAAY,GAAG,YAAY,GAAG,SAAS,CAAC;AAC/E,KAAK,aAAa,GAAG,KAAK,GAAG,MAAM,CAAC;AAEpC,KAAK,WAAW,GAAG;IACjB,KAAK,EAAE,SAAS,CAAC;IACjB,SAAS,CAAC,EAAE,aAAa,CAAC;CAC3B,CAAC;AAEF,wBAAgB,QAAQ,CAAC,GAAG,EAAE,eAAe,GAAG,OAAO,CAAC,MAAM,CAAC,CAS9D;AAED,wBAAgB,QAAQ,CAAC,GAAG,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,IAAI,CAGjF;AAED,wBAAgB,QAAQ,CAAC,GAAG,EAAE,cAAc,EAAE,IAAI,EAAE,OAAO,GAAG,IAAI,CAEjE;AAED,wBAAgB,YAAY,CAAC,GAAG,EAAE,cAAc,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAEvF;AAED,wBAAgB,SAAS,CACvB,GAAG,EAAE,cAAc,EACnB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,GACd,IAAI,CAEN;AAED,wBAAgB,WAAW,CAAC,MAAM,EAAE,eAAe,GAAG,WAAW,GAAG,SAAS,CAY5E;AAED,wBAAgB,WAAW,CAAC,MAAM,EAAE,eAAe,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAWxF;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,GAAG,SAAS,CAMtE"}

package/dist/rest/helpers.js

@@ -0,0 +1,55 @@
+export function readBody(req) {
+    return new Promise((resolve, reject) => {
+        let body = "";
+        req.on("data", (chunk) => {
+            body += chunk.toString();
+        });
+        req.on("end", () => resolve(body));
+        req.on("error", reject);
+    });
+}
+export function sendJson(res, status, data) {
+    res.writeHead(status, { "Content-Type": "application/json" });
+    res.end(JSON.stringify(data));
+}
+export function sendData(res, data) {
+    sendJson(res, 200, { data });
+}
+export function sendDataList(res, data, total) {
+    sendJson(res, 200, { data, ...(total !== undefined ? { total } : {}) });
+}
+export function sendError(res, status, code, message) {
+    sendJson(res, status, { error: { code, message } });
+}
+export function parseSortBy(params) {
+    const sort = params.get("sortBy");
+    if (!sort) {
+        return undefined;
+    }
+    const parts = sort.split(":");
+    const field = parts[0];
+    const dir = parts[1] ?? "asc";
+    if (!field) {
+        return undefined;
+    }
+    return { field: field, direction: dir };
+}
+export function parseFilter(params) {
+    const filter = {};
+    let hasFilter = false;
+    params.forEach((value, key) => {
+        if (key.startsWith("filter.")) {
+            const field = key.slice(7);
+            filter[field] = value;
+            hasFilter = true;
+        }
+    });
+    return hasFilter ? filter : undefined;
+}
+export function parseIntParam(value) {
+    if (!value) {
+        return undefined;
+    }
+    const n = Number(value);
+    return Number.isNaN(n) ? undefined : n;
+}

package/dist/rest/server.d.ts

@@ -0,0 +1,4 @@
+import type { IncomingMessage, ServerResponse } from "node:http";
+import type { ThingD } from "thingd";
+export declare function handleRestRequest(db: ThingD, req: IncomingMessage, res: ServerResponse, pathname: string): Promise<void>;
+//# sourceMappingURL=server.d.ts.map

package/dist/rest/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/rest/server.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AACjE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAwCrC,wBAAsB,iBAAiB,CACrC,EAAE,EAAE,MAAM,EACV,GAAG,EAAE,eAAe,EACpB,GAAG,EAAE,cAAc,EACnB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,IAAI,CAAC,CA2Uf"}

package/dist/rest/server.js

@@ -0,0 +1,317 @@
+import { parseFilter, parseIntParam, parseSortBy, readBody, sendData, sendDataList, sendError, } from "./helpers.js";
+function matchRoute(pathname, pattern) {
+    const patternParts = pattern.split("/");
+    const pathParts = pathname.split("/");
+    if (patternParts.length !== pathParts.length) {
+        return null;
+    }
+    const match = {};
+    for (let i = 0; i < patternParts.length; i++) {
+        const pp = patternParts[i] ?? "";
+        const xp = pathParts[i] ?? "";
+        if (pp.startsWith(":")) {
+            const key = pp.slice(1);
+            match[key] = xp;
+        }
+        else if (pp !== xp) {
+            return null;
+        }
+    }
+    return match;
+}
+export async function handleRestRequest(db, req, res, pathname) {
+    const method = req.method ?? "GET";
+    const url = new URL(req.url || "/", `http://${req.headers.host || "localhost"}`);
+    try {
+        // ─── Health ──────────────────────────────────────────────────
+        if (pathname === "/v1/health" && method === "GET") {
+            const [objects, events, links, queues, collections, streams] = await Promise.all([
+                db.countObjects(),
+                db.countEvents(),
+                db.countLinks(),
+                db.listQueues(),
+                db.listCollections(),
+                db.listStreams(),
+            ]);
+            sendData(res, {
+                status: "ok",
+                version: "0.31.0",
+                counts: {
+                    objects,
+                    events,
+                    links,
+                    queues: queues.length,
+                    collections: collections.length,
+                    streams: streams.length,
+                },
+            });
+            return;
+        }
+        // ─── Counts ──────────────────────────────────────────────────
+        if (pathname === "/v1/counts/objects" && method === "GET") {
+            sendData(res, { count: await db.countObjects() });
+            return;
+        }
+        if (pathname === "/v1/counts/events" && method === "GET") {
+            sendData(res, { count: await db.countEvents() });
+            return;
+        }
+        if (pathname === "/v1/counts/links" && method === "GET") {
+            sendData(res, { count: await db.countLinks() });
+            return;
+        }
+        // ─── Collections / Streams / Queues ──────────────────────────
+        if (pathname === "/v1/collections" && method === "GET") {
+            sendDataList(res, await db.listCollections());
+            return;
+        }
+        if (pathname === "/v1/streams" && method === "GET") {
+            sendDataList(res, await db.listStreams());
+            return;
+        }
+        if (pathname === "/v1/queues" && method === "GET") {
+            sendDataList(res, await db.listQueues());
+            return;
+        }
+        // ─── Objects ─────────────────────────────────────────────────
+        // GET /v1/objects?collection=...&filter.x=...&sortBy=...&limit=...&offset=...
+        if (pathname === "/v1/objects" && method === "GET") {
+            const collection = url.searchParams.get("collection");
+            if (!collection) {
+                sendError(res, 400, "bad_request", "Query parameter 'collection' is required");
+                return;
+            }
+            const filter = parseFilter(url.searchParams);
+            const sortBy = parseSortBy(url.searchParams);
+            const limit = parseIntParam(url.searchParams.get("limit"));
+            const offset = parseIntParam(url.searchParams.get("offset"));
+            const objects = await db.listObjects(collection, { filter, sortBy, limit, offset });
+            sendDataList(res, objects);
+            return;
+        }
+        // PUT /v1/objects/:collection/:id
+        const objMatch = matchRoute(pathname, "/v1/objects/:collection/:id");
+        if (objMatch?.collection && objMatch?.id && method === "PUT") {
+            const body = JSON.parse(await readBody(req));
+            body.id = objMatch.id;
+            const result = await db.put(objMatch.collection, body);
+            sendData(res, result);
+            return;
+        }
+        // GET /v1/objects/:collection/:id
+        if (objMatch?.collection && objMatch?.id && method === "GET") {
+            const result = await db.get(objMatch.collection, objMatch.id);
+            if (!result) {
+                sendError(res, 404, "not_found", `Object '${objMatch.id}' not found in collection '${objMatch.collection}'`);
+                return;
+            }
+            sendData(res, result);
+            return;
+        }
+        // DELETE /v1/objects/:collection/:id
+        if (objMatch?.collection && objMatch?.id && method === "DELETE") {
+            const result = await db.delete(objMatch.collection, objMatch.id);
+            sendData(res, result);
+            return;
+        }
+        // PUT /v1/objects/batch?collection=...
+        if (pathname === "/v1/objects/batch" && method === "PUT") {
+            const collection = url.searchParams.get("collection");
+            if (!collection) {
+                sendError(res, 400, "bad_request", "Query parameter 'collection' is required");
+                return;
+            }
+            const body = JSON.parse(await readBody(req));
+            const objects = Array.isArray(body) ? body : body.objects;
+            if (!Array.isArray(objects)) {
+                sendError(res, 400, "bad_request", "Body must be an array or { objects: [...] }");
+                return;
+            }
+            const result = await db.putBatch(collection, objects);
+            sendData(res, result);
+            return;
+        }
+        // DELETE /v1/objects/batch?collection=...
+        if (pathname === "/v1/objects/batch" && method === "DELETE") {
+            const collection = url.searchParams.get("collection");
+            if (!collection) {
+                sendError(res, 400, "bad_request", "Query parameter 'collection' is required");
+                return;
+            }
+            const body = JSON.parse(await readBody(req));
+            const ids = Array.isArray(body) ? body : body.ids;
+            if (!Array.isArray(ids)) {
+                sendError(res, 400, "bad_request", "Body must be an array or { ids: [...] }");
+                return;
+            }
+            const count = await db.deleteBatch(collection, ids);
+            sendData(res, { deleted: count });
+            return;
+        }
+        // ─── Search ──────────────────────────────────────────────────
+        if (pathname === "/v1/search" && method === "POST") {
+            const body = JSON.parse(await readBody(req));
+            if (!body.query) {
+                sendError(res, 400, "bad_request", "Field 'query' is required");
+                return;
+            }
+            const results = await db.search(body.query, {
+                collections: body.collections,
+                limit: body.limit,
+                filter: body.filter,
+            });
+            sendData(res, results);
+            return;
+        }
+        // ─── Events ──────────────────────────────────────────────────
+        // POST /v1/events/:stream
+        const streamMatch = matchRoute(pathname, "/v1/events/:stream");
+        if (streamMatch?.stream && method === "POST") {
+            const body = JSON.parse(await readBody(req));
+            if (!body.type) {
+                sendError(res, 400, "bad_request", "Field 'type' is required");
+                return;
+            }
+            const event = await db.events.append(streamMatch.stream, body);
+            sendData(res, event);
+            return;
+        }
+        // GET /v1/events?stream=...&fromSequence=...&limit=...
+        if (pathname === "/v1/events" && method === "GET") {
+            const stream = url.searchParams.get("stream") ?? undefined;
+            const fromSequence = parseIntParam(url.searchParams.get("fromSequence"));
+            const limit = parseIntParam(url.searchParams.get("limit"));
+            const events = await db.events.list(stream, { fromSequence, limit });
+            sendDataList(res, events);
+            return;
+        }
+        // ─── Queues ──────────────────────────────────────────────────
+        // POST /v1/queues/:queue/push
+        const pushMatch = matchRoute(pathname, "/v1/queues/:queue/push");
+        if (pushMatch?.queue && method === "POST") {
+            const body = JSON.parse(await readBody(req));
+            const job = await db.queue(pushMatch.queue).push(body.payload ?? body, {
+                idempotencyKey: body.idempotencyKey,
+                maxAttempts: body.maxAttempts,
+                delayMs: body.delayMs,
+            });
+            sendData(res, job);
+            return;
+        }
+        // POST /v1/queues/:queue/claim
+        const claimMatch = matchRoute(pathname, "/v1/queues/:queue/claim");
+        if (claimMatch?.queue && method === "POST") {
+            const body = JSON.parse(await readBody(req));
+            const job = await db.queue(claimMatch.queue).claim({
+                leaseMs: body.leaseMs,
+            });
+            if (!job) {
+                sendData(res, null);
+                return;
+            }
+            sendData(res, job);
+            return;
+        }
+        // POST /v1/queues/:queue/ack
+        const ackMatch = matchRoute(pathname, "/v1/queues/:queue/ack");
+        if (ackMatch?.queue && method === "POST") {
+            const body = JSON.parse(await readBody(req));
+            const result = await db.queue(ackMatch.queue).ack(body.jobId);
+            if (!result.ok) {
+                sendError(res, 400, result.reason, `Ack failed: ${result.reason}`);
+                return;
+            }
+            sendData(res, result.job);
+            return;
+        }
+        // POST /v1/queues/:queue/nack
+        const nackMatch = matchRoute(pathname, "/v1/queues/:queue/nack");
+        if (nackMatch?.queue && method === "POST") {
+            const body = JSON.parse(await readBody(req));
+            const result = await db.queue(nackMatch.queue).nack(body.jobId, {
+                delayMs: body.delayMs,
+                error: body.error,
+            });
+            if (!result.ok) {
+                sendError(res, 400, result.reason, `Nack failed: ${result.reason}`);
+                return;
+            }
+            sendData(res, result.job);
+            return;
+        }
+        // GET /v1/queues/:queue/jobs
+        const jobsMatch = matchRoute(pathname, "/v1/queues/:queue/jobs");
+        if (jobsMatch?.queue && method === "GET") {
+            const jobs = await db.queue(jobsMatch.queue).list();
+            sendDataList(res, jobs);
+            return;
+        }
+        // GET /v1/queues/:queue/dead
+        const deadMatch = matchRoute(pathname, "/v1/queues/:queue/dead");
+        if (deadMatch?.queue && method === "GET") {
+            const jobs = await db.queue(deadMatch.queue).dead();
+            sendDataList(res, jobs);
+            return;
+        }
+        // ─── Links ───────────────────────────────────────────────────
+        // POST /v1/links
+        if (pathname === "/v1/links" && method === "POST") {
+            const body = JSON.parse(await readBody(req));
+            if (!body.fromRef || !body.linkType || !body.toRef) {
+                sendError(res, 400, "bad_request", "Fields 'fromRef', 'linkType', 'toRef' are required");
+                return;
+            }
+            const link = await db.links.create(body.fromRef, body.linkType, body.toRef, body.weight, body.metadataJson);
+            sendData(res, link);
+            return;
+        }
+        // GET /v1/links?id=...
+        if (pathname === "/v1/links" && method === "GET") {
+            const id = url.searchParams.get("id");
+            if (id) {
+                const link = await db.links.get(id);
+                if (!link) {
+                    sendError(res, 404, "not_found", `Link '${id}' not found`);
+                    return;
+                }
+                sendData(res, link);
+                return;
+            }
+            // Neighbors query
+            const reference = url.searchParams.get("reference");
+            if (reference) {
+                const direction = url.searchParams.get("direction") ?? "Both";
+                const linkType = url.searchParams.get("linkType") ?? undefined;
+                const limit = parseIntParam(url.searchParams.get("limit"));
+                const neighbors = await db.links.neighbors(reference, direction, { linkType, limit });
+                sendDataList(res, neighbors);
+                return;
+            }
+            sendError(res, 400, "bad_request", "Query parameter 'id' or 'reference' is required");
+            return;
+        }
+        // DELETE /v1/links/:id
+        const linkDeleteMatch = matchRoute(pathname, "/v1/links/:id");
+        if (linkDeleteMatch?.id && method === "DELETE") {
+            const deleted = await db.links.delete(linkDeleteMatch.id);
+            sendData(res, { deleted });
+            return;
+        }
+        // GET /v1/links/:id
+        if (linkDeleteMatch?.id && method === "GET") {
+            const link = await db.links.get(linkDeleteMatch.id);
+            if (!link) {
+                sendError(res, 404, "not_found", `Link '${linkDeleteMatch.id}' not found`);
+                return;
+            }
+            sendData(res, link);
+            return;
+        }
+        // ─── 404 ─────────────────────────────────────────────────────
+        sendError(res, 404, "not_found", `No route for ${method} ${pathname}`);
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        sendError(res, 500, "internal_error", message);
+    }
+}

package/package.json

@@ -0,0 +1,57 @@
+{
+  "name": "@thingd/cli",
+  "version": "0.31.0",
+  "description": "CLI, Interactive TUI Dashboard, and MCP server for thingd — a fast object-first data engine for applications and AI agents.",
+  "type": "module",
+  "author": "Sayan Mohsin",
+  "license": "Apache-2.0",
+  "keywords": [
+    "thingd",
+    "cli",
+    "mcp",
+    "mcp-server",
+    "ai-agents",
+    "dashboard",
+    "tui",
+    "data-engine",
+    "queue",
+    "local-first"
+  ],
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "bin": {
+    "thingd": "./dist/index.js"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/sayanmohsin/thingd.git"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "cli-table3": "^0.6.5",
+    "picocolors": "^1.1.1",
+    "zod": "^4.4.3",
+    "@thingd/node": "0.31.0"
+  },
+  "engines": {
+    "node": ">=24.0.0"
+  },
+  "scripts": {
+    "build": "pnpm --filter frontend build && tsc -p tsconfig.json && node -e \"fs.mkdirSync('dist/dashboard', { recursive: true }); fs.cpSync('src/dashboard/public', 'dist/dashboard/public', { recursive: true })\"",
+    "test": "pnpm build && node --test test/*.test.mjs"
+  }
+}