feat(ui): a Claude-Desktop-style home for every workspace

/workspace?lane=<id> opens on the workspace's home (WorkspaceHome): a prompt box whose Start opens a new session in the first free pane slot, Recents (a live session attaches its pane, any other opens its transcript, nothing resumes), and Instructions / Memory / Context / Folder. Instructions live in lanes.instructions, extra folders and uploaded files in the new lane_sources table (copies under <data dir>/workspace-context/<lane id>/); spawnRun reads them from the lane's rows and hands Claude --add-dir + an appended system prompt file, Codex --add-dir + developer_instructions. Memory is read-only. Every dashboard pane carries AGENTHUB_RUN_ID; hooks forward it and the run records which session the pane holds (a Claude pane follows /clear and /resume but not a nested claude -p), so the sidebar and notifications open the right pane (&run=). Settings loses its Projects group; Worktrees now decides which worktrees Add folder suggests.
2026-10-02 01:10:58 +07:00
parent 2e051e23b6
commit d0535af626
44 changed files with 2515 additions and 466 deletions
@@ -0,0 +1,143 @@
+/**
+ * @file Tests that a dashboard pane learns which session it holds: every pane
+ * is started with `AGENTHUB_RUN_ID` in its tmux env, and a hook carrying that
+ * `run_id` binds the hook's session to the run (`dashboard_runs.session_id`),
+ * following `/clear` to a new session; a `run_id` that is not a dashboard pane
+ * name, or names no run, changes nothing.
+ * @author Nguyễn Ngọc Trí Vĩ <vinnt@smartgift.vn>
+ */
+
+const { describe, it, before, after } = require("node:test");
+const assert = require("node:assert/strict");
+const fs = require("node:fs");
+const os = require("node:os");
+const path = require("node:path");
+const http = require("node:http");
+
+const ROOT = fs.realpathSync(fs.mkdtempSync(path.join(os.tmpdir(), "run-bind-")));
+process.env.DASHBOARD_DB_PATH = path.join(ROOT, "t.db");
+process.env.CLAUDE_HOME = path.join(ROOT, "claude");
+process.env.DASHBOARD_DATA_DIR = path.join(ROOT, "data");
+process.env.DASHBOARD_REMOTE_SYNC_MS = "0";
+process.env.DASHBOARD_LIVENESS_PROBE = "0";
+
+const { createApp } = require("../index");
+const dashboardRuns = require("../lib/dashboard-runs");
+const tmux = require("../lib/tmux");
+const pty = require("../lib/pty-run");
+
+let server;
+let base;
+
+function postHook(body) {
+  return new Promise((resolve, reject) => {
+    const data = Buffer.from(JSON.stringify(body));
+    const req = http.request(
+      `${base}/api/hooks/event`,
+      { method: "POST", headers: { "content-type": "application/json" } },
+      (res) => {
+        res.resume();
+        res.on("end", () => resolve(res.statusCode));
+      }
+    );
+    req.on("error", reject);
+    req.end(data);
+  });
+}
+
+before(async () => {
+  fs.mkdirSync(process.env.CLAUDE_HOME, { recursive: true });
+  server = http.createServer(createApp());
+  await new Promise((r) => server.listen(0, "127.0.0.1", r));
+  base = `http://127.0.0.1:${server.address().port}`;
+});
+
+after(() => {
+  server?.close();
+  fs.rmSync(ROOT, { recursive: true, force: true });
+});
+
+describe("run ↔ session binding", () => {
+  it("starts every pane with AGENTHUB_RUN_ID naming that pane", () => {
+    let argv = null;
+    tmux.__setExecImpl((args) => {
+      if (args[0] === "has-session") throw Object.assign(new Error("gone"), { status: 1 });
+      if (args[0] === "new-session") argv = args;
+      return "";
+    });
+    pty.spawnRun({ laneId: 77, slot: 2, cwd: ROOT });
+    tmux.__reset();
+    const env = argv.filter((a, i) => argv[i - 1] === "-e");
+    assert.ok(env.includes("AGENTHUB_RUN_ID=agenthub-lane-77-2"), env.join(" "));
+  });
+
+  it("binds a hook's session to the run it names, and follows a new session", async () => {
+    dashboardRuns.recordRun({
+      id: "agenthub-lane-5-1",
+      mode: "interactive",
+      cwd: ROOT,
+      status: "running",
+      startedAt: Date.now(),
+    });
+    const hook = (session_id, run_id) =>
+      postHook({ hook_type: "SessionStart", data: { session_id, cwd: ROOT }, run_id });
+    assert.equal(await hook("sess-aaaa-1111", "agenthub-lane-5-1"), 200);
+    assert.equal(dashboardRuns.getRun("agenthub-lane-5-1").session_id, "sess-aaaa-1111");
+    // `/clear` in the pane: a new session that is the pane's now.
+    await postHook({
+      hook_type: "SessionStart",
+      data: { session_id: "sess-bbbb-2222", cwd: ROOT, source: "clear" },
+      run_id: "agenthub-lane-5-1",
+    });
+    assert.equal(dashboardRuns.getRun("agenthub-lane-5-1").session_id, "sess-bbbb-2222");
+  });
+
+  it("keeps the pane's session when a nested CLI inside it starts its own", async () => {
+    // A `claude -p` the agent runs through Bash inherits AGENTHUB_RUN_ID.
+    for (const hook_type of ["SessionStart", "UserPromptSubmit", "Stop"]) {
+      await postHook({
+        hook_type,
+        data: { session_id: "sess-nest-9999", cwd: ROOT, source: "startup" },
+        run_id: "agenthub-lane-5-1",
+      });
+    }
+    assert.equal(dashboardRuns.getRun("agenthub-lane-5-1").session_id, "sess-bbbb-2222");
+  });
+
+  it("follows any new session on a non-claude pane, whose hooks carry no reliable source", async () => {
+    dashboardRuns.recordRun({
+      id: "agenthub-lane-6-1",
+      mode: "interactive",
+      cwd: ROOT,
+      status: "running",
+      startedAt: Date.now(),
+    });
+    const hook = (session_id) =>
+      postHook({
+        hook_type: "UserPromptSubmit",
+        tool: "codex",
+        data: { session_id, cwd: ROOT, prompt: "hi" },
+        run_id: "agenthub-lane-6-1",
+      });
+    await hook("codex-thread-aaaa");
+    assert.equal(dashboardRuns.getRun("agenthub-lane-6-1").session_id, "codex-thread-aaaa");
+    await hook("codex-thread-bbbb");
+    assert.equal(dashboardRuns.getRun("agenthub-lane-6-1").session_id, "codex-thread-bbbb");
+  });
+
+  it("ignores a run_id that is not a dashboard pane, or names no run", async () => {
+    await postHook({
+      hook_type: "SessionStart",
+      data: { session_id: "sess-cccc-3333", cwd: ROOT },
+      run_id: "main",
+    });
+    await postHook({
+      hook_type: "SessionStart",
+      data: { session_id: "sess-cccc-3333", cwd: ROOT },
+      run_id: "agenthub-lane-999",
+    });
+    assert.equal(dashboardRuns.getRun("main"), null);
+    assert.equal(dashboardRuns.getRun("agenthub-lane-999"), null);
+    assert.equal(dashboardRuns.getRun("agenthub-lane-5-1").session_id, "sess-bbbb-2222");
+  });
+});