import { describe, it, expect, vi, beforeEach } from "vitest"; import type { Session, RuntimeHandle, AgentLaunchConfig } from "@composio/ao-core"; const mockExecFileAsync = vi.fn(); vi.mock("node:child_process", () => ({ execFile: (...args: unknown[]) => { const callback = args[args.length - 1]; if (typeof callback === "function") { const result = mockExecFileAsync(...args.slice(0, -1)); if (result && typeof result.then === "function") { result .then((r: { stdout: string; stderr: string }) => callback(null, r)) .catch((e: Error) => callback(e)); } } }, })); import { create, manifest, default as defaultExport } from "./index.js"; function makeSession(overrides: Partial = {}): Session { return { id: "test-1", projectId: "test-project", status: "working", activity: "active", branch: "feat/test", issueId: null, pr: null, workspacePath: "/workspace/test", runtimeHandle: null, agentInfo: null, createdAt: new Date(), lastActivityAt: new Date(), metadata: {}, ...overrides, }; } function makeTmuxHandle(id = "test-session"): RuntimeHandle { return { id, runtimeName: "tmux", data: {} }; } function makeProcessHandle(pid?: number | string): RuntimeHandle { return { id: "proc-1", runtimeName: "process", data: pid !== undefined ? { pid } : {} }; } function makeLaunchConfig(overrides: Partial = {}): AgentLaunchConfig { return { sessionId: "sess-1", projectConfig: { name: "my-project", repo: "owner/repo", path: "/workspace/repo", defaultBranch: "main", sessionPrefix: "my", }, ...overrides, }; } function mockTmuxWithProcess(processName: string, found = true) { mockExecFileAsync.mockImplementation((cmd: string) => { if (cmd === "tmux") return Promise.resolve({ stdout: "/dev/ttys003\n", stderr: "" }); if (cmd === "ps") { const line = found ? ` 789 ttys003 ${processName}` : " 789 ttys003 bash"; return Promise.resolve({ stdout: ` PID TT ARGS\n${line}\n`, stderr: "", }); } return Promise.reject(new Error("unexpected")); }); } beforeEach(() => { vi.clearAllMocks(); }); describe("plugin manifest & exports", () => { it("has correct manifest", () => { expect(manifest).toEqual({ name: "opencode", slot: "agent", description: "Agent plugin: OpenCode", version: "0.1.0", }); }); it("create() returns agent with correct name and processName", () => { const agent = create(); expect(agent.name).toBe("opencode"); expect(agent.processName).toBe("opencode"); }); it("default export is a valid PluginModule", () => { expect(defaultExport.manifest).toBe(manifest); expect(typeof defaultExport.create).toBe("function"); }); }); describe("getLaunchCommand", () => { const agent = create(); it("generates base command without prompt", () => { const cmd = agent.getLaunchCommand(makeLaunchConfig()); expect(cmd).toContain("opencode run --format json --title 'AO:sess-1' --command true"); expect(cmd).toContain('exec opencode --session "$SES_ID"'); expect(cmd).toContain("opencode session list --format json"); expect(cmd).toContain("AO:sess-1"); }); it("uses --prompt with shell-escaped prompt", () => { const cmd = agent.getLaunchCommand(makeLaunchConfig({ prompt: "Fix it" })); expect(cmd).toContain("opencode run --format json --title 'AO:sess-1' 'Fix it'"); expect(cmd).toContain('exec opencode --session "$SES_ID"'); }); it("includes --model with shell-escaped value", () => { const cmd = agent.getLaunchCommand(makeLaunchConfig({ model: "claude-sonnet-4-5-20250929" })); expect(cmd).toContain("--model 'claude-sonnet-4-5-20250929'"); }); it("combines prompt and model", () => { const cmd = agent.getLaunchCommand( makeLaunchConfig({ prompt: "Go", model: "claude-sonnet-4-5-20250929" }), ); expect(cmd).toContain( "opencode run --format json --title 'AO:sess-1' --model 'claude-sonnet-4-5-20250929' 'Go'", ); expect(cmd).toContain('exec opencode --session "$SES_ID"'); expect(cmd).toContain("--model 'claude-sonnet-4-5-20250929'"); }); it("escapes single quotes in prompt (POSIX shell escaping)", () => { const cmd = agent.getLaunchCommand(makeLaunchConfig({ prompt: "it's broken" })); expect(cmd).toContain("opencode run --format json --title 'AO:sess-1' 'it'\\''s broken'"); expect(cmd).toContain('exec opencode --session "$SES_ID"'); }); it("omits optional flags when not provided", () => { const cmd = agent.getLaunchCommand(makeLaunchConfig()); expect(cmd).not.toContain("--model"); expect(cmd).not.toContain("--agent"); }); it("includes --agent flag when subagent is provided", () => { const cmd = agent.getLaunchCommand(makeLaunchConfig({ subagent: "sisyphus" })); expect(cmd).toContain("--agent 'sisyphus'"); }); it("generates command with agent and prompt", () => { const cmd = agent.getLaunchCommand( makeLaunchConfig({ subagent: "sisyphus", prompt: "fix bug" }), ); expect(cmd).toContain( "opencode run --format json --title 'AO:sess-1' --agent 'sisyphus' 'fix bug'", ); expect(cmd).toContain('exec opencode --session "$SES_ID"'); expect(cmd).toContain("--agent 'sisyphus'"); }); it("generates command with agent, model, and prompt", () => { const cmd = agent.getLaunchCommand( makeLaunchConfig({ subagent: "sisyphus", model: "claude-sonnet-4-5-20250929", prompt: "fix the bug", }), ); expect(cmd).toContain( "opencode run --format json --title 'AO:sess-1' --agent 'sisyphus' --model 'claude-sonnet-4-5-20250929' 'fix the bug'", ); expect(cmd).toContain('exec opencode --session "$SES_ID"'); expect(cmd).toContain("--agent 'sisyphus"); expect(cmd).toContain("--model 'claude-sonnet-4-5-20250929"); }); it("shell-escapes sessionId in the discovery failure message", () => { const cmd = agent.getLaunchCommand(makeLaunchConfig({ sessionId: "sess-1; rm -rf /" })); expect(cmd).toContain( "echo 'failed to discover OpenCode session ID for AO:sess-1; rm -rf /' >&2", ); }); it("keeps the fallback if-block shell-valid on one line", () => { const cmd = agent.getLaunchCommand(makeLaunchConfig()); expect(cmd).toContain('if [ -z "$SES_ID" ]; then SES_ID=$(opencode session list --format json'); expect(cmd).not.toContain("then;"); }); it("works with different agent names: oracle", () => { const cmd = agent.getLaunchCommand( makeLaunchConfig({ subagent: "oracle", prompt: "review code" }), ); expect(cmd).toContain("--agent 'oracle'"); expect(cmd).toContain("'review code'"); }); it("works with different agent names: librarian", () => { const cmd = agent.getLaunchCommand( makeLaunchConfig({ subagent: "librarian", prompt: "find usages" }), ); expect(cmd).toContain("--agent 'librarian"); expect(cmd).toContain("'find usages'"); }); it("backward compatible: no agent flag when subagent not provided", () => { const cmd = agent.getLaunchCommand(makeLaunchConfig({ prompt: "fix it" })); expect(cmd).not.toContain("--agent"); expect(cmd).toContain("opencode run --format json --title 'AO:sess-1' 'fix it'"); expect(cmd).toContain('exec opencode --session "$SES_ID"'); }); it("combines model and prompt without agent (backward compatible)", () => { const cmd = agent.getLaunchCommand( makeLaunchConfig({ prompt: "Go", model: "claude-sonnet-4-5-20250929" }), ); expect(cmd).not.toContain("--agent"); expect(cmd).toContain( "opencode run --format json --title 'AO:sess-1' --model 'claude-sonnet-4-5-20250929' 'Go'", ); expect(cmd).toContain('exec opencode --session "$SES_ID"'); expect(cmd).toContain("--model 'claude-sonnet-4-5-20250929"); }); it("uses run bootstrap when systemPrompt is provided", () => { const cmd = agent.getLaunchCommand( makeLaunchConfig({ systemPrompt: "You are an orchestrator" }), ); expect(cmd).toContain("opencode run --format json --title 'AO:sess-1'"); expect(cmd).toContain("'You are an orchestrator"); }); it("generates command with systemPrompt and task prompt", () => { const cmd = agent.getLaunchCommand( makeLaunchConfig({ systemPrompt: "You are an orchestrator", prompt: "do the task" }), ); expect(cmd).toContain("opencode run --format json --title 'AO:sess-1'"); expect(cmd).not.toContain("--prompt 'You are an orchestrator"); expect(cmd).toContain("do the task"); }); it("escapes single quotes in systemPrompt", () => { const cmd = agent.getLaunchCommand(makeLaunchConfig({ systemPrompt: "it's important" })); expect(cmd).toContain("'it'\\''s important'"); }); it("handles very long systemPrompt", () => { const longPrompt = "A".repeat(500); const cmd = agent.getLaunchCommand(makeLaunchConfig({ systemPrompt: longPrompt })); expect(cmd).toContain("opencode run --format json --title 'AO:sess-1'"); expect(cmd.length).toBeGreaterThan(500); }); it("generates command with systemPromptFile via shell substitution", () => { const cmd = agent.getLaunchCommand(makeLaunchConfig({ systemPromptFile: "/tmp/prompt.md" })); expect(cmd).toContain( "opencode run --format json --title 'AO:sess-1' \"$(cat '/tmp/prompt.md')\"", ); expect(cmd).toContain('exec opencode --session "$SES_ID"'); }); it("escapes path in systemPromptFile", () => { const cmd = agent.getLaunchCommand( makeLaunchConfig({ systemPromptFile: "/tmp/it's-prompt.md" }), ); expect(cmd).toContain( "opencode run --format json --title 'AO:sess-1' \"$(cat '/tmp/it'\\''s-prompt.md')\"", ); expect(cmd).toContain('exec opencode --session "$SES_ID"'); }); it("systemPromptFile takes precedence over systemPrompt", () => { const cmd = agent.getLaunchCommand( makeLaunchConfig({ systemPrompt: "direct prompt", systemPromptFile: "/tmp/file-prompt.md", }), ); expect(cmd).toContain( "opencode run --format json --title 'AO:sess-1' \"$(cat '/tmp/file-prompt.md')\"", ); expect(cmd).toContain("exec opencode --session"); expect(cmd).not.toContain("direct prompt"); }); it("combines systemPromptFile with subagent and prompt", () => { const cmd = agent.getLaunchCommand( makeLaunchConfig({ systemPromptFile: "/tmp/orchestrator.md", subagent: "sisyphus", prompt: "fix the bug", }), ); expect(cmd).toContain( "opencode run --format json --title 'AO:sess-1' --agent 'sisyphus' \"$(cat '/tmp/orchestrator.md'; printf '\\n\\n'; printf %s 'fix the bug')\"", ); expect(cmd).toContain("exec opencode --session"); expect(cmd).toContain("--agent 'sisyphus"); expect(cmd).not.toContain("--prompt"); expect(cmd).toContain( "$(cat '/tmp/orchestrator.md'; printf '\\n\\n'; printf %s 'fix the bug')", ); }); it("generates orchestrator-style systemPromptFile launch", () => { const cmd = agent.getLaunchCommand( makeLaunchConfig({ sessionId: "my-orchestrator", permissions: "permissionless", systemPromptFile: "/tmp/orchestrator.md", }), ); expect(cmd).toContain( "opencode run --format json --title 'AO:my-orchestrator' \"$(cat '/tmp/orchestrator.md')\"", ); expect(cmd).toContain("exec opencode --session"); }); it("combines systemPromptFile with subagent and prompt - shell escape", () => { const cmd = agent.getLaunchCommand( makeLaunchConfig({ systemPromptFile: "/tmp/orchestrator.md", subagent: "sisyphus", prompt: "fix the bug", }), ); expect(cmd).toContain( "opencode run --format json --title 'AO:sess-1' --agent 'sisyphus' \"$(cat '/tmp/orchestrator.md'; printf '\\n\\n'; printf %s 'fix the bug')\"", ); expect(cmd).not.toContain("--prompt"); expect(cmd).toContain( "$(cat '/tmp/orchestrator.md'; printf '\\n\\n'; printf %s 'fix the bug')", ); }); it("handles prompt with special characters", () => { const cmd = agent.getLaunchCommand( makeLaunchConfig({ prompt: "fix $PATH/to/file and `rm -rf /unquoted/path`" }), ); expect(cmd).toContain("'fix $PATH/to/file and `rm -rf /unquoted/path`"); }); it("handles prompt with newlines", () => { const cmd = agent.getLaunchCommand(makeLaunchConfig({ prompt: "line1\nline2\nline3" })); expect(cmd).toContain("opencode run --format json --title 'AO:sess-1'"); expect(cmd).toContain("'line1"); }); it("handles prompt with backticks", () => { const cmd = agent.getLaunchCommand(makeLaunchConfig({ prompt: "use `backticks` and $vars`" })); expect(cmd).toContain("'use `backticks` and $vars`"); }); it("handles prompt with dollar signs", () => { const cmd = agent.getLaunchCommand(makeLaunchConfig({ prompt: "cost is $100" })); expect(cmd).toContain("'cost is $100'"); }); it("handles prompt with double quotes", () => { const cmd = agent.getLaunchCommand(makeLaunchConfig({ prompt: 'say "hello" and "goodbye"' })); expect(cmd).toContain('\'say "hello" and "goodbye"\''); }); it("handles prompt with unicode characters", () => { const cmd = agent.getLaunchCommand(makeLaunchConfig({ prompt: "fix bug in café.js file" })); expect(cmd).toContain("'fix bug in café.js file'"); }); it("handles prompt with semicolons", () => { const cmd = agent.getLaunchCommand(makeLaunchConfig({ prompt: "line1; line2; line3" })); expect(cmd).toContain("'line1; line2; line3"); }); it("handles empty prompt", () => { const cmd = agent.getLaunchCommand(makeLaunchConfig({ prompt: "" })); expect(cmd).toContain("opencode run --format json --title 'AO:sess-1' --command true"); expect(cmd).toContain('exec opencode --session "$SES_ID"'); expect(cmd).toContain("opencode session list --format json"); expect(cmd).toContain("AO:sess-1"); }); it("uses existing session id", () => { const cmd = agent.getLaunchCommand( makeLaunchConfig({ projectConfig: { name: "my-project", repo: "owner/repo", path: "/workspace/repo", defaultBranch: "main", sessionPrefix: "my", agentConfig: { opencodeSessionId: "ses_abc123" }, }, prompt: "continue", }), ); expect(cmd).toBe("opencode --session 'ses_abc123' --prompt 'continue'"); }); it("uses existing session id with --title fallback", () => { const cmd = agent.getLaunchCommand(makeLaunchConfig()); expect(cmd).toContain("opencode run --format json --title 'AO:sess-1'"); expect(cmd).toContain('exec opencode --session "$SES_ID"'); }); }); describe("getEnvironment", () => { const agent = create(); it("sets AO_SESSION_ID but not AO_PROJECT_ID (caller's responsibility)", () => { const env = agent.getEnvironment(makeLaunchConfig()); expect(env["AO_SESSION_ID"]).toBe("sess-1"); expect(env["AO_PROJECT_ID"]).toBeUndefined(); }); it("sets AO_ISSUE_ID when provided", () => { const env = agent.getEnvironment(makeLaunchConfig({ issueId: "GH-42" })); expect(env["AO_ISSUE_ID"]).toBe("GH-42"); }); it("omits AO_ISSUE_ID when not provided", () => { const env = agent.getEnvironment(makeLaunchConfig()); expect(env["AO_ISSUE_ID"]).toBeUndefined(); }); }); describe("isProcessRunning", () => { const agent = create(); it("returns true when opencode found on tmux pane TTY", async () => { mockTmuxWithProcess("opencode"); expect(await agent.isProcessRunning(makeTmuxHandle())).toBe(true); }); it("returns false when opencode not on tmux pane TTY", async () => { mockTmuxWithProcess("opencode", false); expect(await agent.isProcessRunning(makeTmuxHandle())).toBe(false); }); it("returns true for process handle with alive PID", async () => { const killSpy = vi.spyOn(process, "kill").mockImplementation(() => true); expect(await agent.isProcessRunning(makeProcessHandle(123))).toBe(true); expect(killSpy).toHaveBeenCalledWith(123, 0); killSpy.mockRestore(); }); it("returns false for process handle with dead PID", async () => { const killSpy = vi.spyOn(process, "kill").mockImplementation(() => { throw new Error("ESRCH"); }); expect(await agent.isProcessRunning(makeProcessHandle(123))).toBe(false); killSpy.mockRestore(); }); it("returns false for unknown runtime without PID", async () => { const handle: RuntimeHandle = { id: "x", runtimeName: "other", data: {} }; expect(await agent.isProcessRunning(handle)).toBe(false); }); it("returns false on tmux command failure", async () => { mockExecFileAsync.mockRejectedValue(new Error("tmux not running")); expect(await agent.isProcessRunning(makeTmuxHandle())).toBe(false); }); it("returns true when PID exists but throws EPERM", async () => { const epermErr = Object.assign(new Error("EPERM"), { code: "EPERM" }); const killSpy = vi.spyOn(process, "kill").mockImplementation(() => { throw epermErr; }); expect(await agent.isProcessRunning(makeProcessHandle(789))).toBe(true); killSpy.mockRestore(); }); it("finds opencode on any pane in multi-pane session", async () => { mockExecFileAsync.mockImplementation((cmd: string) => { if (cmd === "tmux") { return Promise.resolve({ stdout: "/dev/ttys001\n/dev/ttys002\n", stderr: "" }); } if (cmd === "ps") { return Promise.resolve({ stdout: " PID TT ARGS\n 100 ttys001 bash\n 200 ttys002 opencode run hello\n", stderr: "", }); } return Promise.reject(new Error("unexpected")); }); expect(await agent.isProcessRunning(makeTmuxHandle())).toBe(true); }); }); describe("detectActivity — terminal output classification", () => { const agent = create(); it("returns idle for empty terminal output", () => { expect(agent.detectActivity("")).toBe("idle"); }); it("returns idle for whitespace-only terminal output", () => { expect(agent.detectActivity(" \n ")).toBe("idle"); }); it("returns active for non-empty terminal output", () => { expect(agent.detectActivity("opencode is working\n")).toBe("active"); }); }); describe("getActivityState", () => { const agent = create(); it("returns null when opencode session list output is malformed JSON", async () => { mockExecFileAsync.mockImplementation((cmd: string) => { if (cmd === "tmux") return Promise.resolve({ stdout: "/dev/ttys003\n", stderr: "" }); if (cmd === "ps") { return Promise.resolve({ stdout: " PID TT ARGS\n 789 ttys003 opencode\n", stderr: "", }); } if (cmd === "opencode") return Promise.resolve({ stdout: "not json", stderr: "" }); return Promise.reject(new Error("unexpected")); }); const state = await agent.getActivityState( makeSession({ runtimeHandle: makeTmuxHandle(), metadata: { opencodeSessionId: "ses_abc123" }, }), ); expect(state).toBeNull(); }); }); describe("getSessionInfo", () => { const agent = create(); it("always returns null (not implemented)", async () => { expect(await agent.getSessionInfo(makeSession())).toBeNull(); expect(await agent.getSessionInfo(makeSession({ workspacePath: "/some/path" }))).toBeNull(); }); }); describe("session ID capture from JSON stream", () => { it("validates session_id format with ses_ prefix", () => { const agent = create(); const cmd = agent.getLaunchCommand(makeLaunchConfig()); expect(cmd).toContain("session_id"); expect(cmd).toContain("/^ses_[A-Za-z0-9_-]+$/"); }); it("parses JSON lines and extracts session_id field", () => { const agent = create(); const cmd = agent.getLaunchCommand(makeLaunchConfig()); expect(cmd).toContain("JSON.parse(trimmed)"); expect(cmd).toContain("obj.session_id"); }); it("handles buffer accumulation for partial lines", () => { const agent = create(); const cmd = agent.getLaunchCommand(makeLaunchConfig()); expect(cmd).toContain("buffer.split"); expect(cmd).toContain("buffer = lines.pop()"); }); }); describe("title-based fallback sorting with newest-first", () => { it("sorts by updated timestamp (newest first) when multiple sessions have the same title", () => { const agent = create(); const cmd = agent.getLaunchCommand(makeLaunchConfig()); expect(cmd).toContain("opencode session list --format json"); expect(cmd).toContain("sort((a, b) =>"); expect(cmd).toContain("tb - ta"); }); it("validates session IDs with ses_ prefix pattern", () => { const agent = create(); const cmd = agent.getLaunchCommand(makeLaunchConfig()); expect(cmd).toContain("isValidId"); expect(cmd).toContain("/^ses_[A-Za-z0-9_-]+$/"); }); it("handles numeric and string timestamps in sorting", () => { const agent = create(); const cmd = agent.getLaunchCommand(makeLaunchConfig()); expect(cmd).toContain("typeof value ==="); expect(cmd).toContain("Number.isFinite"); expect(cmd).toContain("Date.parse(value)"); }); }); describe("invalid session ID rejection", () => { it("does not include --session for invalid opencodeSessionId in launch command", () => { const agent = create(); const invalidIds = ["invalid", "SES_uppercase", "ses_", "ses spaces here", "", "ses-123"]; for (const invalidId of invalidIds) { const cmd = agent.getLaunchCommand( makeLaunchConfig({ projectConfig: { name: "my-project", repo: "owner/repo", path: "/workspace/repo", defaultBranch: "main", sessionPrefix: "my", agentConfig: { opencodeSessionId: invalidId }, }, prompt: "continue", }), ); expect(cmd).not.toContain(`--session '${invalidId}'`); expect(cmd).toContain("opencode run --format json --title 'AO:sess-1'"); } }); it("only accepts valid ses_ prefix session IDs", () => { const agent = create(); const validIds = ["ses_abc123", "ses_test-session", "ses_12345"]; for (const validId of validIds) { const cmd = agent.getLaunchCommand( makeLaunchConfig({ projectConfig: { name: "my-project", repo: "owner/repo", path: "/workspace/repo", defaultBranch: "main", sessionPrefix: "my", agentConfig: { opencodeSessionId: validId }, }, prompt: "continue", }), ); expect(cmd).toContain(`--session '${validId}'`); } }); });