@agtd/agent 0.1.1 → 0.1.2

package/dist/__tests__/codexAdapterFindFile.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=codexAdapterFindFile.test.d.ts.map

package/dist/__tests__/codexAdapterFindFile.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codexAdapterFindFile.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/codexAdapterFindFile.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/codexAdapterFindFile.test.js

@@ -0,0 +1,298 @@
+/**
+ * Integration tests for codexAdapter.findFile() — the three-tier lookup:
+ *
+ *   Tier 1: stored codexThreadId  → exact match, unique per session
+ *   Tier 2: tmux session creation time  → used when codexThreadId absent
+ *   Tier 3: latest thread by cwd  → last resort, may collide if cwd shared
+ *
+ * node:child_process is mocked so these tests run without sqlite3 CLI or tmux.
+ */
+import { describe, it, expect, beforeAll, afterAll, beforeEach, vi } from "vitest";
+import { writeFileSync, mkdirSync, rmSync } from "node:fs";
+import { join } from "node:path";
+import { tmpdir } from "node:os";
+vi.mock("node:child_process", () => ({
+    execSync: vi.fn(),
+}));
+// Import AFTER vi.mock so the adapter picks up the mocked execSync
+import { codexAdapter } from "../transcriptAdapters/codex.js";
+import { execSync } from "node:child_process";
+const mockExecSync = vi.mocked(execSync);
+// ---------------------------------------------------------------------------
+// Fixture setup
+// ---------------------------------------------------------------------------
+const THREAD_ID_1 = "01234567-0000-7000-0000-000000000001";
+const THREAD_ID_2 = "01234567-0000-7000-0000-000000000002";
+const SHARED_CWD = "/projects/shared-project";
+const TMUX_SESSION_1 = "aidash-sess_aaa11111";
+const TMUX_SESSION_2 = "aidash-sess_bbb22222";
+const TMUX_CREATED_1 = "1700000000"; // earlier session
+const TMUX_CREATED_2 = "1700000300"; // later session (5 min later)
+let tmpDir;
+let jsonlPath1; // rollout file for thread 1
+let jsonlPath2; // rollout file for thread 2
+beforeAll(() => {
+    tmpDir = join(tmpdir(), "agtd-codex-findfile-" + Date.now());
+    mkdirSync(join(tmpDir, ".codex"), { recursive: true });
+    // A zero-byte file is enough — existsSync(dbPath) just needs to pass
+    writeFileSync(join(tmpDir, ".codex", "state_5.sqlite"), "");
+    // Create real JSONL files so existsSync(rolloutPath) passes
+    jsonlPath1 = join(tmpDir, "rollout-thread1.jsonl");
+    jsonlPath2 = join(tmpDir, "rollout-thread2.jsonl");
+    writeFileSync(jsonlPath1, JSON.stringify({
+        type: "response_item",
+        timestamp: "2026-01-01T00:00:00Z",
+        payload: {
+            type: "message",
+            role: "user",
+            content: [{ type: "text", text: "session 1 message" }],
+        },
+    }) + "\n");
+    writeFileSync(jsonlPath2, JSON.stringify({
+        type: "response_item",
+        timestamp: "2026-01-02T00:00:00Z",
+        payload: {
+            type: "message",
+            role: "user",
+            content: [{ type: "text", text: "session 2 message" }],
+        },
+    }) + "\n");
+});
+afterAll(() => {
+    rmSync(tmpDir, { recursive: true, force: true });
+});
+beforeEach(() => {
+    mockExecSync.mockReset();
+});
+// ---------------------------------------------------------------------------
+// Tier 1 tests — codexThreadId direct lookup
+// ---------------------------------------------------------------------------
+describe("Tier 1: codexThreadId lookup", () => {
+    it("returns the rollout file matching the stored codexThreadId", () => {
+        mockExecSync.mockReturnValueOnce((jsonlPath1 + "\n"));
+        const session = {
+            id: "sess_1",
+            cwd: SHARED_CWD,
+            agentType: "codex",
+            codexThreadId: THREAD_ID_1,
+            tmuxSession: TMUX_SESSION_1,
+        };
+        const result = codexAdapter.findFile(session, tmpDir);
+        expect(result).toBe(jsonlPath1);
+        // Must query by thread ID, not by cwd
+        expect(mockExecSync).toHaveBeenCalledWith(expect.stringContaining(THREAD_ID_1), expect.any(Object));
+    });
+    it("two sessions with the SAME cwd get DIFFERENT transcripts via codexThreadId", () => {
+        // Session 1 lookup
+        mockExecSync.mockReturnValueOnce((jsonlPath1 + "\n"));
+        const session1 = {
+            id: "sess_1",
+            cwd: SHARED_CWD,
+            codexThreadId: THREAD_ID_1,
+        };
+        const file1 = codexAdapter.findFile(session1, tmpDir);
+        mockExecSync.mockReset();
+        // Session 2 lookup
+        mockExecSync.mockReturnValueOnce((jsonlPath2 + "\n"));
+        const session2 = {
+            id: "sess_2",
+            cwd: SHARED_CWD,
+            codexThreadId: THREAD_ID_2,
+        };
+        const file2 = codexAdapter.findFile(session2, tmpDir);
+        expect(file1).toBe(jsonlPath1);
+        expect(file2).toBe(jsonlPath2);
+        // KEY regression assertion: same cwd must not produce same transcript
+        expect(file1).not.toBe(file2);
+    });
+    it("falls through to Tier 2 when Tier 1 returns a non-existent path", () => {
+        // Tier 1: returns a path that does not exist on disk
+        mockExecSync
+            .mockReturnValueOnce(("/nonexistent/rollout.jsonl\n")) // Tier 1 sqlite3
+            .mockReturnValueOnce((TMUX_CREATED_1 + "\n")) // Tier 2: tmux display-message
+            .mockReturnValueOnce((jsonlPath1 + "\n")); // Tier 2: sqlite3 by timestamp
+        const session = {
+            id: "sess_1",
+            cwd: SHARED_CWD,
+            codexThreadId: THREAD_ID_1,
+            tmuxSession: TMUX_SESSION_1,
+        };
+        const result = codexAdapter.findFile(session, tmpDir);
+        expect(result).toBe(jsonlPath1);
+    });
+    it("falls through to Tier 3 when codexThreadId returns empty string", () => {
+        // Tier 1: sqlite3 returns empty (thread not found)
+        // Tier 2: no tmuxSession → skipped
+        // Tier 3: returns latest by cwd
+        mockExecSync
+            .mockReturnValueOnce(("")) // Tier 1: empty
+            .mockReturnValueOnce((jsonlPath2 + "\n")); // Tier 3: latest by cwd
+        const session = {
+            id: "sess_x",
+            cwd: SHARED_CWD,
+            codexThreadId: THREAD_ID_1,
+            tmuxSession: null, // no tmux → skip Tier 2
+        };
+        const result = codexAdapter.findFile(session, tmpDir);
+        expect(result).toBe(jsonlPath2);
+        expect(mockExecSync).toHaveBeenCalledWith(expect.stringContaining("ORDER BY updated_at DESC"), expect.any(Object));
+    });
+});
+// ---------------------------------------------------------------------------
+// Tier 2 tests — tmux session creation time
+// ---------------------------------------------------------------------------
+describe("Tier 2: tmux session creation time lookup", () => {
+    it("uses tmux creation time when codexThreadId is null", () => {
+        mockExecSync
+            .mockReturnValueOnce((TMUX_CREATED_1 + "\n")) // tmux display-message
+            .mockReturnValueOnce((jsonlPath1 + "\n")); // sqlite3 WHERE created_at >=
+        const session = {
+            id: "sess_3",
+            cwd: SHARED_CWD,
+            codexThreadId: null,
+            tmuxSession: TMUX_SESSION_1,
+        };
+        const result = codexAdapter.findFile(session, tmpDir);
+        expect(result).toBe(jsonlPath1);
+        expect(mockExecSync).toHaveBeenCalledWith(expect.stringContaining(`tmux display-message -t '${TMUX_SESSION_1}'`), expect.any(Object));
+        expect(mockExecSync).toHaveBeenCalledWith(expect.stringContaining(`created_at >= ${TMUX_CREATED_1}`), expect.any(Object));
+    });
+    it("two sessions sharing cwd get correct files via different tmux creation times", () => {
+        // Session 1: earlier tmux time → finds thread 1
+        mockExecSync
+            .mockReturnValueOnce((TMUX_CREATED_1 + "\n"))
+            .mockReturnValueOnce((jsonlPath1 + "\n"));
+        const session1 = {
+            id: "sess_3",
+            cwd: SHARED_CWD,
+            codexThreadId: null,
+            tmuxSession: TMUX_SESSION_1,
+        };
+        const file1 = codexAdapter.findFile(session1, tmpDir);
+        expect(file1).toBe(jsonlPath1);
+        mockExecSync.mockReset();
+        // Session 2: later tmux time → finds thread 2
+        mockExecSync
+            .mockReturnValueOnce((TMUX_CREATED_2 + "\n"))
+            .mockReturnValueOnce((jsonlPath2 + "\n"));
+        const session2 = {
+            id: "sess_4",
+            cwd: SHARED_CWD,
+            codexThreadId: null,
+            tmuxSession: TMUX_SESSION_2,
+        };
+        const file2 = codexAdapter.findFile(session2, tmpDir);
+        expect(file2).toBe(jsonlPath2);
+        expect(file1).not.toBe(file2);
+    });
+    it("falls through to Tier 3 when tmux command fails", () => {
+        mockExecSync
+            .mockImplementationOnce(() => {
+            throw new Error("no server running on /tmp/tmux/default");
+        })
+            .mockReturnValueOnce((jsonlPath2 + "\n")); // Tier 3 fallback
+        const session = {
+            id: "sess_5",
+            cwd: SHARED_CWD,
+            codexThreadId: null,
+            tmuxSession: TMUX_SESSION_1,
+        };
+        const result = codexAdapter.findFile(session, tmpDir);
+        expect(result).toBe(jsonlPath2);
+        expect(mockExecSync).toHaveBeenCalledWith(expect.stringContaining("ORDER BY updated_at DESC"), expect.any(Object));
+    });
+    it("falls through to Tier 3 when tmux returns non-numeric output", () => {
+        mockExecSync
+            .mockReturnValueOnce(("not-a-number\n")) // tmux returns garbage
+            .mockReturnValueOnce((jsonlPath2 + "\n")); // Tier 3
+        const session = {
+            id: "sess_6",
+            cwd: SHARED_CWD,
+            codexThreadId: null,
+            tmuxSession: TMUX_SESSION_1,
+        };
+        const result = codexAdapter.findFile(session, tmpDir);
+        expect(result).toBe(jsonlPath2);
+    });
+});
+// ---------------------------------------------------------------------------
+// Tier 3 tests — latest thread by cwd (last resort)
+// ---------------------------------------------------------------------------
+describe("Tier 3: latest thread by cwd (last resort)", () => {
+    it("returns latest updated thread when no codexThreadId and no tmuxSession", () => {
+        mockExecSync.mockReturnValueOnce((jsonlPath2 + "\n"));
+        const session = {
+            id: "sess_7",
+            cwd: SHARED_CWD,
+            codexThreadId: null,
+            tmuxSession: null,
+        };
+        const result = codexAdapter.findFile(session, tmpDir);
+        expect(result).toBe(jsonlPath2);
+        expect(mockExecSync).toHaveBeenCalledWith(expect.stringContaining("ORDER BY updated_at DESC LIMIT 1"), expect.any(Object));
+    });
+    it("WARNING: returns same file for two sessions with same cwd (Tier 3 limitation)", () => {
+        // This test documents the known limitation of Tier 3 — it cannot disambiguate
+        // sessions sharing the same cwd without codexThreadId or tmuxSession.
+        // Tier 1 and Tier 2 exist to avoid hitting this case.
+        const session1 = { id: "sess_8", cwd: SHARED_CWD, codexThreadId: null, tmuxSession: null };
+        const session2 = { id: "sess_9", cwd: SHARED_CWD, codexThreadId: null, tmuxSession: null };
+        mockExecSync.mockReturnValueOnce((jsonlPath2 + "\n"));
+        const file1 = codexAdapter.findFile(session1, tmpDir);
+        mockExecSync.mockReset();
+        mockExecSync.mockReturnValueOnce((jsonlPath2 + "\n"));
+        const file2 = codexAdapter.findFile(session2, tmpDir);
+        // Both get the same (latest) file — this is the documented limitation
+        expect(file1).toBe(jsonlPath2);
+        expect(file2).toBe(jsonlPath2);
+        expect(file1).toBe(file2); // expected collision — document this behavior
+    });
+    it("returns null when cwd is empty", () => {
+        // No SQLite DB fallback and no sessions dir
+        const session = {
+            id: "sess_10",
+            cwd: "",
+            codexThreadId: null,
+            tmuxSession: null,
+        };
+        const result = codexAdapter.findFile(session, join(tmpDir, "no-sessions-dir"));
+        expect(result).toBeNull();
+    });
+});
+// ---------------------------------------------------------------------------
+// SQL injection / quoting edge cases
+// ---------------------------------------------------------------------------
+describe("shell quoting — paths with special characters", () => {
+    it("handles cwd containing single quotes in SQLite query", () => {
+        // This is the exact bug that broke Tier 2 before the fix:
+        // using single-quote outer wrapping with a cwd like /Users/foo/it's-project
+        // broke because the shell interpreter saw the inner ' as ending the argument.
+        mockExecSync.mockReturnValueOnce((jsonlPath1 + "\n"));
+        const session = {
+            id: "sess_sq",
+            cwd: "/projects/it's-project",
+            codexThreadId: THREAD_ID_1,
+            tmuxSession: null,
+        };
+        // Should not throw; the quoting logic must handle single quotes in paths
+        expect(() => codexAdapter.findFile(session, tmpDir)).not.toThrow();
+    });
+    it("Tier 3 CWD query uses double-quote outer wrapping (regression: near '/' syntax error)", () => {
+        // The original bug: sqlite3 'db' 'WHERE cwd='/Users/...' was broken because
+        // the shell split on / in the path. Fixed by using "double-quote wrapping".
+        // Verify the query string passed to execSync uses the correct quoting.
+        mockExecSync.mockReturnValueOnce((jsonlPath1 + "\n"));
+        const session = {
+            id: "sess_dq",
+            cwd: "/Users/robyparapat/workspace/repo/payment-connectors-service",
+            codexThreadId: null,
+            tmuxSession: null,
+        };
+        codexAdapter.findFile(session, tmpDir);
+        // The execSync call must use double quotes as outer wrapper for the SQL argument
+        // so the cwd single quotes are treated as literal characters, not shell delimiters
+        const call = mockExecSync.mock.calls[0][0];
+        expect(call).toMatch(/sqlite3 '.*' "SELECT rollout_path/);
+    });
+});
+//# sourceMappingURL=codexAdapterFindFile.test.js.map

package/dist/__tests__/codexAdapterFindFile.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"codexAdapterFindFile.test.js","sourceRoot":"","sources":["../../src/__tests__/codexAdapterFindFile.test.ts"],"names":[],"mappings":"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"}

package/dist/__tests__/enrichers.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=enrichers.test.d.ts.map

package/dist/__tests__/enrichers.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"enrichers.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/enrichers.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/enrichers.test.js

@@ -0,0 +1,47 @@
+import { describe, it, expect } from "vitest";
+import { derivePrUrl } from "../enrichers/pr.js";
+import { parseTranscript } from "../enrichers/transcript.js";
+describe("PR URL enricher", () => {
+    it("derives GitHub PR search URL from HTTPS remote", () => {
+        const url = derivePrUrl("https://github.com/user/repo.git", "feat/my-branch");
+        expect(url).toContain("github.com/user/repo/pulls");
+        expect(url).toContain("head:feat%2Fmy-branch");
+    });
+    it("handles SSH remote URLs", () => {
+        const url = derivePrUrl("git@github.com:user/repo.git", "fix/bug");
+        expect(url).toContain("github.com/user/repo/pulls");
+        expect(url).toContain("fix%2Fbug");
+    });
+    it("returns null for non-GitHub remotes", () => {
+        expect(derivePrUrl("https://gitlab.com/user/repo.git", "main")).toBeNull();
+    });
+    it("returns null for empty inputs", () => {
+        expect(derivePrUrl("", "main")).toBeNull();
+        expect(derivePrUrl("https://github.com/u/r", "")).toBeNull();
+    });
+});
+describe("Transcript parser", () => {
+    it("extracts model name", () => {
+        const result = parseTranscript("Using model: claude-sonnet-4-5");
+        expect(result.model).toBe("claude-sonnet-4-5");
+    });
+    it("extracts context percentage", () => {
+        const result = parseTranscript("context: 61%");
+        expect(result.contextPercent).toBe(61);
+    });
+    it("extracts MCP servers", () => {
+        const result = parseTranscript("mcp: [github, filesystem]");
+        expect(result.mcpServers).toEqual(["github", "filesystem"]);
+    });
+    it("returns nulls for empty input", () => {
+        const result = parseTranscript("");
+        expect(result.model).toBeNull();
+        expect(result.contextPercent).toBeNull();
+        expect(result.mcpServers).toBeNull();
+    });
+    it("handles GPT model names", () => {
+        const result = parseTranscript("model: gpt-4o-mini");
+        expect(result.model).toBe("gpt-4o-mini");
+    });
+});
+//# sourceMappingURL=enrichers.test.js.map

package/dist/__tests__/enrichers.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"enrichers.test.js","sourceRoot":"","sources":["../../src/__tests__/enrichers.test.ts"],"names":[],"mappings":"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"}

package/dist/__tests__/tmux.integration.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=tmux.integration.test.d.ts.map

package/dist/__tests__/tmux.integration.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tmux.integration.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/tmux.integration.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/tmux.integration.test.js

@@ -0,0 +1,112 @@
+/**
+ * Integration tests for tmux key-sending approaches.
+ *
+ * Key findings from empirical testing:
+ * - Both hex mode (buildSendKeysCmd) and plain send-keys (buildSendMessageCmd) deliver
+ *   the SAME bytes to the running program. For 'hello world' + Enter, both deliver
+ *   the string as a single data event with bytes [68 65 6c 6c 6f 20 77 6f 72 6c 64 0d].
+ * - readline.emitKeypressEvents (used by Ink/Codex internally) correctly parses a
+ *   batched data event into individual keypress events: h, e, l, l, o, ..., return.
+ * - However, Ink TUIs may be mid-render when input arrives; sending chars one at a
+ *   time (with 20ms delays) is more reliable for interactive TUIs.
+ *
+ * Skipped automatically if tmux is not available.
+ */
+import { describe, it, expect, afterEach } from "vitest";
+import { execSync } from "node:child_process";
+import * as fs from "node:fs";
+import * as os from "node:os";
+import * as path from "node:path";
+import { isTmuxAvailable, tmuxExec, buildSendKeysCmd, buildSendMessageCmd, buildCapturePaneCmd, sanitizeShellArg, } from "../tmux.js";
+const AVAILABLE = isTmuxAvailable();
+const PREFIX = `agtd-itest-${Date.now()}`;
+function killSession(name) {
+    try {
+        execSync(`tmux kill-session -t '${sanitizeShellArg(name)}'`, {
+            stdio: "pipe",
+        });
+    }
+    catch { }
+}
+function newSession(name) {
+    tmuxExec(`tmux new-session -d -s '${sanitizeShellArg(name)}'`);
+}
+/** Poll capture-pane every 100 ms until pattern matches or timeout. */
+async function waitFor(session, pattern, timeoutMs = 5000) {
+    const deadline = Date.now() + timeoutMs;
+    while (Date.now() < deadline) {
+        const out = tmuxExec(buildCapturePaneCmd(session));
+        if (pattern.test(out))
+            return out;
+        await new Promise((r) => setTimeout(r, 100));
+    }
+    return tmuxExec(buildCapturePaneCmd(session));
+}
+function writeTmpScript(code) {
+    const dir = fs.mkdtempSync(path.join(os.tmpdir(), "agtd-test-"));
+    const file = path.join(dir, "script.mjs");
+    fs.writeFileSync(file, code);
+    return file;
+}
+// ── Verify byte delivery ──────────────────────────────────────────────────
+describe.skipIf(!AVAILABLE)("tmux byte delivery — both send approaches", () => {
+    const session = `${PREFIX}-bytes`;
+    afterEach(() => killSession(session));
+    // Raw-mode Node.js script that logs each keypress (uses readline.emitKeypressEvents
+    // internally, same as Ink/Codex)
+    const SCRIPT = writeTmpScript(`
+import readline from 'readline';
+readline.emitKeypressEvents(process.stdin);
+if (process.stdin.isTTY) process.stdin.setRawMode(true);
+process.stdin.resume();
+process.stdin.setEncoding('utf8');
+let buf = '';
+process.stdin.on('keypress', (ch, key) => {
+  if (key?.name === 'return') {
+    process.stdout.write('GOT:' + buf + '\\n');
+    buf = '';
+    return;
+  }
+  if (key?.ctrl && key?.name === 'c') process.exit(0);
+  if (ch) buf += ch;
+});
+process.stdout.write('READY\\n');
+`);
+    async function setup() {
+        killSession(session);
+        newSession(session);
+        tmuxExec(`tmux send-keys -t '${sanitizeShellArg(session)}' 'node ${SCRIPT}' Enter`);
+        await waitFor(session, /READY/, 3000);
+        await new Promise((r) => setTimeout(r, 300));
+    }
+    it("buildSendMessageCmd ('text' Enter) delivers chars via emitKeypressEvents", async () => {
+        await setup();
+        tmuxExec(buildSendMessageCmd(session, "hello world"));
+        const out = await waitFor(session, /GOT:/, 3000);
+        expect(out).toContain("GOT:hello world");
+    });
+    it("char-by-char hex mode (user-message approach) delivers chars correctly", async () => {
+        await setup();
+        // Simulate what the user-message handler now does: send each char, then CR
+        for (const char of "hello chars") {
+            tmuxExec(buildSendKeysCmd(session, char));
+            await new Promise((r) => setTimeout(r, 20));
+        }
+        tmuxExec(buildSendKeysCmd(session, "\r"));
+        const out = await waitFor(session, /GOT:/, 3000);
+        expect(out).toContain("GOT:hello chars");
+    });
+    it("messages with special characters (quotes, backticks) are delivered", async () => {
+        await setup();
+        const msg = "fix it's bug";
+        // char-by-char (agent approach)
+        for (const char of msg) {
+            tmuxExec(buildSendKeysCmd(session, char));
+            await new Promise((r) => setTimeout(r, 20));
+        }
+        tmuxExec(buildSendKeysCmd(session, "\r"));
+        const out = await waitFor(session, /GOT:/, 3000);
+        expect(out).toContain(`GOT:${msg}`);
+    });
+}, { timeout: 30000 });
+//# sourceMappingURL=tmux.integration.test.js.map

package/dist/__tests__/tmux.integration.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tmux.integration.test.js","sourceRoot":"","sources":["../../src/__tests__/tmux.integration.test.ts"],"names":[],"mappings":"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"}

package/dist/__tests__/tmux.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=tmux.test.d.ts.map

package/dist/__tests__/tmux.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tmux.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/tmux.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/tmux.test.js

@@ -0,0 +1,26 @@
+import { describe, it, expect } from "vitest";
+import { buildCreateSessionCmd, buildCreateWindowCmd, buildSendKeysCmd, buildCapturePaneCmd, } from "../tmux.js";
+describe("tmux command builders", () => {
+    it("builds create session command", () => {
+        const cmd = buildCreateSessionCmd("aidash-s1", "/code/proj");
+        expect(cmd).toBe("tmux new-session -d -s 'aidash-s1' -c '/code/proj'");
+    });
+    it("builds create window command", () => {
+        const cmd = buildCreateWindowCmd("aidash-s1", "my-window", "/code/proj");
+        expect(cmd).toBe("tmux new-window -t 'aidash-s1' -n 'my-window' -c '/code/proj'");
+    });
+    it("builds send-keys command with hex-encoded bytes", () => {
+        const cmd = buildSendKeysCmd("aidash-s1", "hi");
+        // "hi" = 0x68 0x69
+        expect(cmd).toBe("tmux send-keys -t 'aidash-s1' -H 68 69");
+    });
+    it("sends Enter key as hex 0d (carriage return)", () => {
+        const cmd = buildSendKeysCmd("aidash-s1", "\r");
+        expect(cmd).toBe("tmux send-keys -t 'aidash-s1' -H 0d");
+    });
+    it("builds capture-pane command with ANSI escape preservation", () => {
+        const cmd = buildCapturePaneCmd("aidash-s1");
+        expect(cmd).toBe("tmux capture-pane -t 'aidash-s1' -p -e -S -");
+    });
+});
+//# sourceMappingURL=tmux.test.js.map

package/dist/__tests__/tmux.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tmux.test.js","sourceRoot":"","sources":["../../src/__tests__/tmux.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EACL,qBAAqB,EACrB,oBAAoB,EACpB,gBAAgB,EAChB,mBAAmB,GACpB,MAAM,YAAY,CAAC;AAEpB,QAAQ,CAAC,uBAAuB,EAAE,GAAG,EAAE;IACrC,EAAE,CAAC,+BAA+B,EAAE,GAAG,EAAE;QACvC,MAAM,GAAG,GAAG,qBAAqB,CAAC,WAAW,EAAE,YAAY,CAAC,CAAC;QAC7D,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,oDAAoD,CAAC,CAAC;IACzE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,8BAA8B,EAAE,GAAG,EAAE;QACtC,MAAM,GAAG,GAAG,oBAAoB,CAAC,WAAW,EAAE,WAAW,EAAE,YAAY,CAAC,CAAC;QACzE,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CACd,+DAA+D,CAChE,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,iDAAiD,EAAE,GAAG,EAAE;QACzD,MAAM,GAAG,GAAG,gBAAgB,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC;QAChD,mBAAmB;QACnB,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,wCAAwC,CAAC,CAAC;IAC7D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6CAA6C,EAAE,GAAG,EAAE;QACrD,MAAM,GAAG,GAAG,gBAAgB,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC;QAChD,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,qCAAqC,CAAC,CAAC;IAC1D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,2DAA2D,EAAE,GAAG,EAAE;QACnE,MAAM,GAAG,GAAG,mBAAmB,CAAC,WAAW,CAAC,CAAC;QAC7C,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,6CAA6C,CAAC,CAAC;IAClE,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/__tests__/transcriptAdapters.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=transcriptAdapters.test.d.ts.map

package/dist/__tests__/transcriptAdapters.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transcriptAdapters.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/transcriptAdapters.test.ts"],"names":[],"mappings":""}