@thingd/cli 0.53.2 → 0.55.0

package/dist/interactive.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"interactive.d.ts","sourceRoot":"","sources":["../src/interactive.ts"],"names":[],"mappings":"AAylEA,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC,CA0FvD"}
+{"version":3,"file":"interactive.d.ts","sourceRoot":"","sources":["../src/interactive.ts"],"names":[],"mappings":"AA+/EA,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC,CA0FvD"}

package/dist/interactive.js

@@ -80,6 +80,8 @@ let totalActiveJobsCount = 0;
 let totalDeadJobsCount = 0;
 let totalLinksCount = 0;
 let cloudError = null;
+const eventsByStream = new Map();
+const jobsByQueue = new Map();
 let objectsHistory = [];
 let eventsHistory = [];
 let activeJobsHistory = [];
@@ -89,6 +91,7 @@ let objectWriteRateHistory = [];
 let eventAppendRateHistory = [];
 let viewerLines = ["Select an item to view details."];
 let viewerScroll = 0;
+let lastNeighborsRef = "";
 let loadedItemId = "";
 let loadTimer = null;
 let pollTimer = null;
@@ -293,6 +296,29 @@ async function fetchResources() {
             objectsByCollection.set(col, []);
         }
     }
+    // Populate events per stream
+    eventsByStream.clear();
+    await Promise.all(streams.map(async (s) => {
+        try {
+            const evts = await db.events.list(s, { limit: 20 });
+            eventsByStream.set(s, evts);
+        }
+        catch {
+            eventsByStream.set(s, []);
+        }
+    }));
+    // Populate jobs per queue
+    jobsByQueue.clear();
+    await Promise.all(queues.map(async (q) => {
+        try {
+            const active = await db.queue(q).list();
+            const dead = await db.queue(q).dead();
+            jobsByQueue.set(q, { active, dead });
+        }
+        catch {
+            jobsByQueue.set(q, { active: [], dead: [] });
+        }
+    }));
     // Calculate Deltas for Operations Throughput Rates
     const prevObjects = objectsHistory.length > 0
         ? (objectsHistory[objectsHistory.length - 1] ?? totalObjects)
@@ -509,15 +535,40 @@ function buildTree() {
             });
         }
         for (const stream of streams) {
+            const sOpen = expandedSet.has(`stream:${stream}`);
             nodes.push({
                 id: `stream:${stream}`,
                 parentId: "cat:streams",
                 type: "stream",
-                label: `${pc.green("●")} ${pc.green(stream)}`,
+                label: `${sOpen ? pc.cyan("▾") : pc.dim("▸")} ${pc.green(stream)}`,
                 depth: 1,
-                expandable: false,
+                expandable: true,
                 ref: { name: stream },
             });
+            if (sOpen) {
+                const evts = eventsByStream.get(stream) ?? [];
+                if (evts.length === 0) {
+                    nodes.push({
+                        id: `empty:evt:${stream}`,
+                        parentId: `stream:${stream}`,
+                        type: "status",
+                        label: pc.dim("(no events)"),
+                        depth: 2,
+                        expandable: false,
+                    });
+                }
+                for (const evt of evts) {
+                    nodes.push({
+                        id: `evt:${stream}:${evt.id}`,
+                        parentId: `stream:${stream}`,
+                        type: "event",
+                        label: `${pc.dim("·")} ${pc.dim(evt.type || "unknown")}`,
+                        depth: 2,
+                        expandable: false,
+                        ref: { stream: stream, eventId: evt.id, eventData: evt },
+                    });
+                }
+            }
         }
     }
     // Queues
@@ -540,17 +591,97 @@ function buildTree() {
             });
         }
         for (const q of queues) {
+            const qOpen = expandedSet.has(`queue:${q}`);
             nodes.push({
                 id: `queue:${q}`,
                 parentId: "cat:queues",
                 type: "queue",
-                label: `${pc.magenta("◇")} ${pc.magenta(q)}`,
+                label: `${qOpen ? pc.cyan("▾") : pc.dim("▸")} ${pc.magenta(q)}`,
                 depth: 1,
-                expandable: false,
+                expandable: true,
                 ref: { name: q },
             });
+            if (qOpen) {
+                const jobData = jobsByQueue.get(q);
+                const activeJobs = jobData?.active ?? [];
+                const deadJobs = jobData?.dead ?? [];
+                // Active jobs subcategory
+                const activeOpen = expandedSet.has(`queue:${q}:active`);
+                nodes.push({
+                    id: `queue:${q}:active`,
+                    parentId: `queue:${q}`,
+                    type: "category",
+                    label: `${activeOpen ? pc.cyan("▾") : pc.dim("▸")} ${pc.bold("Active")}  ${pc.dim(`(${activeJobs.length})`)}`,
+                    depth: 2,
+                    expandable: true,
+                });
+                if (activeOpen) {
+                    if (activeJobs.length === 0) {
+                        nodes.push({
+                            id: `empty:active:${q}`,
+                            parentId: `queue:${q}:active`,
+                            type: "status",
+                            label: pc.dim("(no active jobs)"),
+                            depth: 3,
+                            expandable: false,
+                        });
+                    }
+                    for (const job of activeJobs) {
+                        nodes.push({
+                            id: `job:${q}:active:${job.id}`,
+                            parentId: `queue:${q}:active`,
+                            type: "job",
+                            label: `${pc.cyan("●")} ${pc.dim(job.id.slice(0, 12))}`,
+                            depth: 3,
+                            expandable: false,
+                            ref: { queue: q, jobId: job.id, status: "active", jobData: job },
+                        });
+                    }
+                }
+                // Dead jobs subcategory
+                const deadOpen = expandedSet.has(`queue:${q}:dead`);
+                nodes.push({
+                    id: `queue:${q}:dead`,
+                    parentId: `queue:${q}`,
+                    type: "category",
+                    label: `${deadOpen ? pc.cyan("▾") : pc.dim("▸")} ${pc.bold("Dead")}  ${pc.dim(`(${deadJobs.length})`)}`,
+                    depth: 2,
+                    expandable: true,
+                });
+                if (deadOpen) {
+                    if (deadJobs.length === 0) {
+                        nodes.push({
+                            id: `empty:dead:${q}`,
+                            parentId: `queue:${q}:dead`,
+                            type: "status",
+                            label: pc.dim("(no dead jobs)"),
+                            depth: 3,
+                            expandable: false,
+                        });
+                    }
+                    for (const job of deadJobs) {
+                        nodes.push({
+                            id: `job:${q}:dead:${job.id}`,
+                            parentId: `queue:${q}:dead`,
+                            type: "job",
+                            label: `${pc.red("○")} ${pc.dim(job.id.slice(0, 12))}`,
+                            depth: 3,
+                            expandable: false,
+                            ref: { queue: q, jobId: job.id, status: "dead", jobData: job },
+                        });
+                    }
+                }
+            }
         }
     }
+    // Links
+    nodes.push({
+        id: "node:links",
+        type: "link",
+        label: `${pc.blue("◈")} ${pc.dim("Links")}  ${pc.dim(`(${totalLinksCount})`)}`,
+        depth: 0,
+        expandable: false,
+    });
     // Metrics
     nodes.push({
         id: "node:status",
@@ -638,43 +769,59 @@ async function loadContent(node) {
         }
         else if (node.type === "stream" && node.ref) {
             const ref = node.ref;
-            const events = await db.events.list(ref.name);
-            let res = `${pc.bold(ref.name)} ${pc.dim(`(${events.length} events)`)}\n\n`;
-            if (events.length === 0) {
-                res += pc.dim("No events in this stream.");
+            const evts = eventsByStream.get(ref.name) ?? [];
+            let res = `${pc.bold(ref.name)} ${pc.dim(`(${evts.length} events shown)`)}\n\n`;
+            res += pc.dim("Expand to browse individual events, or press [c] to append.\n");
+            content = res;
+        }
+        else if (node.type === "event" && node.ref) {
+            const ref = node.ref;
+            const evt = ref.eventData;
+            let res = `${pc.bold(evt.type || "unknown")} ${pc.dim(evt.id)}\n`;
+            res += ` ${pc.dim("Stream:")} ${pc.green(ref.stream)}\n`;
+            res += ` ${pc.dim("Created:")} ${pc.dim(evt.createdAt || "—")}\n\n`;
+            const display = { ...evt };
+            for (const k of ["id", "stream", "sequence", "createdAt", "idempotencyKey"]) {
+                delete display[k];
+            }
+            if (Object.keys(display).length > 0) {
+                res += highlightJson(display);
             }
             else {
-                const lines = events.map((e) => {
-                    const ts = e.createdAt ? pc.dim(String(e.createdAt)) : "";
-                    const type = pc.magenta(e.type || "unknown");
-                    return ` ${ts} ${type}`;
-                });
-                res += lines.join("\n");
+                res += pc.dim("No payload.");
             }
             content = res;
         }
         else if (node.type === "queue" && node.ref) {
             const ref = node.ref;
-            const queue = db.queue(ref.name);
-            const [active, dead] = await Promise.all([queue.list(), queue.dead()]);
+            const jobData = jobsByQueue.get(ref.name);
+            const active = jobData?.active ?? [];
+            const dead = jobData?.dead ?? [];
             let res = `${pc.bold(ref.name)}\n\n`;
             res += `${pc.cyan("Active")} ${pc.dim(`(${active.length})`)}\n`;
-            if (active.length === 0) {
-                res += pc.dim(" No jobs\n");
+            res += `${pc.red("Dead")} ${pc.dim(`(${dead.length})`)}\n\n`;
+            res += pc.dim("Expand Active or Dead to browse jobs, [c] to push new job.");
+            content = res;
+        }
+        else if (node.type === "job" && node.ref) {
+            const ref = node.ref;
+            const job = ref.jobData;
+            let res = `${pc.bold(job.id)}  ${pc.yellow(job.status || ref.status)}\n`;
+            res += ` ${pc.dim("Queue:")} ${pc.magenta(ref.queue)}\n`;
+            res += ` ${pc.dim("Attempts:")} ${job.attempts}/${job.maxAttempts}\n`;
+            res += ` ${pc.dim("Created:")} ${pc.dim(job.createdAt || "—")}\n`;
+            if (job.lastError) {
+                res += ` ${pc.dim("Error:")} ${pc.red(job.lastError)}\n`;
+            }
+            res += "\n";
+            if (job.payload && Object.keys(job.payload).length > 0) {
+                res += highlightJson(job.payload);
             }
             else {
-                for (const j of active) {
-                    res += ` ${pc.cyan("●")} ${j.id} ${pc.yellow(j.status)} ${pc.dim(`${j.attempts}/${j.maxAttempts}`)}\n`;
-                }
-            }
-            res += `${pc.red("Dead")} ${pc.dim(`(${dead.length})`)}\n`;
-            if (dead.length === 0) {
-                res += pc.dim(" No dead jobs\n");
+                res += pc.dim("No payload.");
             }
-            else {
-                for (const j of dead) {
-                    res += ` ${pc.red("○")} ${j.id} ${pc.dim(`${j.attempts}/${j.maxAttempts}`)}\n`;
-                }
+            if (ref.status === "dead") {
+                res += `\n\n${pc.dim("[e] Retry (ack)  [d] Nack (remove from dead letter)")}`;
             }
             content = res;
         }
@@ -742,6 +889,19 @@ async function loadContent(node) {
                 content += `\n ${pc.yellow("⚠")} ${pc.dim(cloudError)}\n`;
             }
         }
+        else if (node.type === "link") {
+            content = [
+                ` ${pc.bold("Links")}  ${pc.dim(`(${totalLinksCount} total`)}${lastNeighborsRef ? pc.dim(`, last browsed: ${lastNeighborsRef}`) : ""})`,
+                "",
+                totalLinksCount === 0
+                    ? ` ${pc.dim("No links yet.")}`
+                    : ` ${pc.dim("Select an object and press")} ${pc.bold("n")} ${pc.dim("to browse its neighbors.")}`,
+                "",
+                ` ${pc.bold("Operations")}`,
+                ` ${pc.bold("[c]")} Create a new link`,
+                ` ${pc.bold("[d]")} Delete a link by ID`,
+            ].join("\n");
+        }
         else if (node.type === "category") {
             content = pc.dim("Expand to browse items.");
         }
@@ -881,7 +1041,7 @@ function draw() {
         help = ` ${pc.dim("↑↓")} nav  ${pc.dim("enter")} connect  ${pc.dim("q")} quit `;
     }
     else {
-        help = ` ${pc.dim("↑↓")} nav  ${pc.dim("←→")} toggle  ${pc.dim("c")} create  ${pc.dim("e")} edit  ${pc.dim("d")} delete  ${pc.dim("/")} search  ${pc.dim("i")} info  ${pc.dim("r")} refresh  ${pc.dim("s")} switch  ${pc.dim("l")} logout  ${pc.dim("q")} quit `;
+        help = ` ${pc.dim("↑↓")} nav  ${pc.dim("←→")} toggle  ${pc.dim("c")} create  ${pc.dim("e")} edit  ${pc.dim("d")} delete  ${pc.dim("/")} search  ${pc.dim("n")} neighbors  ${pc.dim("i")} info  ${pc.dim("r")} refresh  ${pc.dim("s")} switch  ${pc.dim("l")} logout  ${pc.dim("q")} quit `;
     }
     buf += `${pc.dim("─".repeat(W))}\n`;
     buf += padToWidth(help, W);
@@ -1058,23 +1218,33 @@ async function handleCreate(selected) {
     openForm("Create Resource", [
         {
             id: "kind",
-            label: "Kind (object, event, queue)",
-            value: defaultStream ? "event" : defaultQueue ? "queue" : "object",
-            options: ["object", "event", "queue"],
+            label: "Kind (object, event, queue, link)",
+            value: defaultStream
+                ? "event"
+                : defaultQueue
+                    ? "queue"
+                    : selected?.type === "link"
+                        ? "link"
+                        : "object",
+            options: ["object", "event", "queue", "link"],
         },
         {
             id: "target",
-            label: "Target (Collection, Stream, or Queue Name)",
+            label: "Target (Collection, Stream, Queue, or From Reference)",
             value: defaultCol || defaultStream || defaultQueue,
             options: Array.from(new Set([...collections, ...streams, ...queues])).sort(),
             allowCustom: true,
         },
         {
             id: "objId",
-            label: "Object ID (only for objects, auto if blank)",
+            label: "Object / To Reference ID (auto if blank for objects)",
             placeholder: "Leave blank to auto-generate",
         },
-        { id: "payload", label: "Data (JSON or key=value)", placeholder: 'e.g. name="John" age=30' },
+        {
+            id: "payload",
+            label: "Data, Link Type, or JSON Fields",
+            placeholder: 'e.g. name="John" age=30 or {"linkType":"follows","weight":1}',
+        },
     ], async (vals) => {
         const kind = (vals.kind || "").toLowerCase();
         const target = (vals.target || "").trim();
@@ -1111,8 +1281,34 @@ async function handleCreate(selected) {
             await db.queue(target).push(data);
             expandedSet.add("cat:queues");
         }
+        else if (kind === "link") {
+            const toRef = (vals.objId || "").trim();
+            if (!toRef) {
+                throw new Error("To Reference is required (use Object ID field).");
+            }
+            let linkType = "related";
+            let weight;
+            let metadataJson;
+            try {
+                const parsed = JSON.parse(vals.payload || "{}");
+                linkType = parsed.linkType || parsed.link_type || "related";
+                if (parsed.weight !== undefined) {
+                    weight = Number(parsed.weight);
+                }
+                if (parsed.metadata || parsed.metadataJson) {
+                    metadataJson =
+                        typeof parsed.metadata === "string"
+                            ? parsed.metadata
+                            : JSON.stringify(parsed.metadata);
+                }
+            }
+            catch {
+                linkType = (vals.payload || "").trim() || "related";
+            }
+            await db.links.create(target, linkType, toRef, weight, metadataJson);
+        }
         else {
-            throw new Error("Kind must be 'object', 'event', or 'queue'.");
+            throw new Error("Kind must be 'object', 'event', 'queue', or 'link'.");
         }
     });
 }
@@ -1162,6 +1358,41 @@ async function handleEdit(selected) {
             }
         });
     }
+    else if (selected.type === "job" && selected.ref) {
+        const ref = selected.ref;
+        if (ref.status === "dead") {
+            openForm(`Retry Dead Job: ${ref.jobId.slice(0, 12)}`, [
+                {
+                    id: "action",
+                    label: "Action",
+                    value: "ack",
+                    options: ["ack", "nack"],
+                },
+                {
+                    id: "error",
+                    label: "Error message (for nack)",
+                    placeholder: "Optional error",
+                },
+            ], async (vals) => {
+                const action = vals.action || "";
+                if (action === "ack") {
+                    await db.queue(ref.queue).ack(ref.jobId);
+                }
+                else if (action === "nack") {
+                    await db.queue(ref.queue).nack(ref.jobId, { error: vals.error || "Rejected" });
+                }
+                else {
+                    throw new Error("Action must be 'ack' or 'nack'.");
+                }
+            });
+        }
+        else {
+            // Active job — nack to fail it back to ready
+            openForm(`Nack Job: ${ref.jobId.slice(0, 12)}`, [{ id: "error", label: "Error message", placeholder: "Optional" }], async (vals) => {
+                await db.queue(ref.queue).nack(ref.jobId, { error: vals.error || "Nacked" });
+            });
+        }
+    }
     else {
         openForm("Edit Not Supported", [{ id: "msg", label: "Error", value: "Editing is only available for Objects and Queues." }], async () => { });
     }
@@ -1204,8 +1435,63 @@ async function handleDelete(selected) {
             }
         });
     }
+    else if (selected.type === "link" || loadedItemId === "neighbors_result") {
+        openForm("Delete Link", [
+            {
+                id: "linkId",
+                label: "Link ID",
+                placeholder: "Paste the link ID from the neighbors view",
+            },
+            { id: "confirm", label: 'Type "yes" to confirm deletion', placeholder: "yes" },
+        ], async (vals) => {
+            const linkId = (vals.linkId || "").trim();
+            if (!linkId) {
+                throw new Error("Link ID is required.");
+            }
+            if ((vals.confirm || "").toLowerCase() !== "yes") {
+                throw new Error("Canceled");
+            }
+            const ok = await db.links.delete(linkId);
+            if (!ok) {
+                throw new Error(`Link '${linkId}' not found.`);
+            }
+        });
+    }
+    else if (selected.type === "job" && selected.ref) {
+        const ref = selected.ref;
+        if (ref.status === "dead") {
+            openForm(`Remove Dead Job: ${ref.jobId.slice(0, 12)}`, [
+                {
+                    id: "action",
+                    label: "Action",
+                    value: "nack",
+                    options: ["ack", "nack"],
+                },
+                { id: "confirm", label: 'Type "yes" to confirm', placeholder: "yes" },
+            ], async (vals) => {
+                if ((vals.confirm || "").toLowerCase() !== "yes") {
+                    throw new Error("Canceled");
+                }
+                if (vals.action === "ack") {
+                    await db.queue(ref.queue).ack(ref.jobId);
+                }
+                else {
+                    await db.queue(ref.queue).nack(ref.jobId, { error: "Removed from dead letter" });
+                }
+            });
+        }
+        else {
+            openForm("Delete Not For Active Jobs", [{ id: "msg", label: "Info", value: "Use [e] to nack an active job back to ready state." }], async () => { });
+        }
+    }
     else {
-        openForm("Delete Not Supported", [{ id: "msg", label: "Error", value: "Deletion is only available for Objects and Queues." }], async () => { });
+        openForm("Delete Not Supported", [
+            {
+                id: "msg",
+                label: "Error",
+                value: "Deletion is only available for Objects, Links, and Queues.",
+            },
+        ], async () => { });
     }
 }
 async function handleSearch() {
@@ -1318,6 +1604,63 @@ async function handleInfo() {
     viewerLines = lines;
     loadedItemId = "info_status";
 }
+async function handleNeighbors(selected) {
+    if (selected?.type !== "object" || !selected.ref) {
+        viewerLines = [
+            ` ${pc.yellow("Neighbors")}`,
+            "",
+            ` ${pc.dim("Select an object first, then press")} ${pc.bold("n")} ${pc.dim("to browse its links.")}`,
+        ];
+        loadedItemId = "neighbors_info";
+        draw();
+        return;
+    }
+    const ref = selected.ref;
+    const fromRef = `${ref.collection}/${ref.id}`;
+    openForm(`Neighbors of ${fromRef}`, [
+        {
+            id: "direction",
+            label: "Direction",
+            value: "Both",
+            options: ["Both", "Outgoing", "Incoming"],
+        },
+        {
+            id: "linkType",
+            label: "Link Type (optional, leave blank for all)",
+            placeholder: "e.g. follows, owns",
+        },
+        {
+            id: "limit",
+            label: "Max Results (optional)",
+            placeholder: "50",
+        },
+    ], async (vals) => {
+        const direction = (vals.direction || "Both");
+        const linkType = (vals.linkType || "").trim() || undefined;
+        const limitStr = vals.limit || "";
+        const limit = limitStr ? parseInt(limitStr, 10) || undefined : undefined;
+        const links = await db.links.neighbors(fromRef, direction, { linkType, limit });
+        lastNeighborsRef = fromRef;
+        viewerLines = [
+            ` ${pc.bold("Neighbors of")} ${pc.cyan(fromRef)}`,
+            ` ${pc.dim(`(${links.length} link${links.length !== 1 ? "s" : ""}${direction !== "Both" ? `, ${direction.toLowerCase()}` : ""}${linkType ? `, type: ${linkType}` : ""})`)}`,
+            "",
+            ...(links.length === 0 ? [` ${pc.dim("No links found.")}`] : []),
+            ...links.flatMap((link) => [
+                ` ${pc.blue("◈")} ${pc.dim(link.id)}`,
+                `   ${link.fromRef} ${pc.cyan(link.linkType)} ${link.toRef}`,
+                link.weight !== undefined ? `   ${pc.dim(`weight: ${link.weight}`)}` : "",
+                link.metadataJson && link.metadataJson !== "{}"
+                    ? `   ${pc.dim(`metadata: ${link.metadataJson}`)}`
+                    : "",
+                "",
+            ]),
+            pc.dim("[d] Delete a link by ID  [c] Create a new link"),
+        ];
+        loadedItemId = "neighbors_result";
+        draw();
+    });
+}
 async function handleMaintenance() {
     // Cycle through maintenance operations with each press of 'm'
     const operations = ["health", "checkpoint", "backup"];
@@ -1613,6 +1956,9 @@ function setupKeypress() {
             else if (str === "i" || str === "I") {
                 await handleInfo();
             }
+            else if (str === "n" || str === "N") {
+                await handleNeighbors(tree[cursorIndex]);
+            }
             else if (str === "m" || str === "M") {
                 await handleMaintenance();
             }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thingd/cli",
-  "version": "0.53.2",
+  "version": "0.55.0",
   "description": "CLI, Interactive TUI Dashboard, and MCP server for thingd — a fast object-first data engine for applications and AI agents.",
   "type": "module",
   "homepage": "https://engine.thingd.cloud",
@@ -45,7 +45,7 @@
     "cli-table3": "^0.6.5",
     "picocolors": "^1.1.1",
     "zod": "^4.4.3",
-    "@thingd/sdk": "0.53.2"
+    "@thingd/sdk": "0.55.0"
   },
   "engines": {
     "node": ">=24.0.0"