mirror of
https://github.com/software-mansion/argent.git
synced 2026-09-14 19:27:14 +08:00
Ignacy Łątka
a92c859d07
## What Adds `argent lens` — open Argent Lens bound to a fresh `claude` session. ## Why The Lens preview window and the agent communicate through a shared, process-wide tool-server that carries **no per-agent identity** (only a coarse telemetry header). So when the user requests changes in the window, there's no reliable way to route them to the *specific* agent that opened it. `argent lens` sidesteps the problem by inverting ownership: the human launches Lens, and Lens spawns (and therefore owns) exactly one `claude` terminal. The binding is 1:1 by construction — no identity plumbing required. ## How it works 1. `argent lens` ensures a tool-server and **begins a CLI Lens session**, which opens the preview window up front (no `await_user_selection` needed) and keeps it open across rounds. 2. It spawns a tracked `claude` terminal in the current directory — a TypeScript port of the macOS applet's `osascript` spawn/track mechanism — seeded to propose variants without blocking. 3. A watcher polls `GET /preview/outcome`; on each submitted round it types a one-line feedback summary into that terminal, queuing it to the agent as its next prompt. Requesting changes therefore "talks back" to the bound agent instead of closing the window. macOS only (drives Terminal/iTerm via `osascript`); off-darwin it exits with a clear message. ## Changes - **CLI** `lens-terminal.ts` — `osascript` spawn/track + a new write-into-running-session path (the "outputting" channel; injects input into the running TUI, which a tty write cannot do). - **CLI** `lens.ts` — the command + feedback formatter. - **tool-server** — a `cliSession` flag in the variant store (opens the window, suppresses auto-close on submit); `POST /preview/cli-session` and `GET /preview/outcome` routes. - **UI** — relabels the submit action to "Request changes" while a CLI session is active. Behind the existing `argent-lens` feature flag. ## Verification - Build + typecheck across the workspace; ESLint (`--max-warnings 0`) + Prettier clean. - 34 new unit tests; full `@argent/cli` suite **118 passing**, tool-server variant/preview suites **46 passing**. - **E2E (observed on this machine):** - **tool-server HTTP** — `cli-session` toggles `cliSession` true/false; submitted feedback round-trips through `/preview/outcome`. - **terminal injection** — spawned a window running `cat`, confirmed `writeToSession` lands text in the running program's **stdin** (both iTerm and Terminal), with embedded newlines flattened. - **full relay** — the real `watchAndRelay` loop against a real tool-server typed two distinct submission rounds' feedback into a stand-in agent terminal (dedup on `completedAt` verified). - `argent lens --help` and the feature-flag gate (exit 1 with guidance, no spawn). Note: a real end-to-end with a live `claude` agent was not run (it would drive a paid interactive session); the agent-facing channel is proven by injecting into a stand-in process's stdin via the exact same code path. --------- Co-authored-by: Filip131311 <contact@filipkaminski.com>
60 lines
2.2 KiB
TypeScript
60 lines
2.2 KiB
TypeScript
import { describe, expect, it } from "vitest";
|
|
import {
|
|
AGENTS,
|
|
findAgentById,
|
|
agentIds,
|
|
isAgentInstalled,
|
|
detectInstalledAgents,
|
|
} from "../src/lens-agents.js";
|
|
|
|
describe("AGENTS registry", () => {
|
|
it("lists the supported CLIs with distinct ids and bins", () => {
|
|
expect(agentIds()).toEqual(["claude", "codex", "gemini", "opencode", "cursor"]);
|
|
const bins = AGENTS.map((a) => a.bin);
|
|
expect(new Set(bins).size).toBe(bins.length);
|
|
// Cursor's CLI binary is `cursor-agent`, not `cursor`.
|
|
expect(bins).toContain("cursor-agent");
|
|
});
|
|
|
|
it("arg-mode agents embed the seed file via $(cat …)", () => {
|
|
const claude = findAgentById("claude")!;
|
|
const cmd = claude.launch("'/work dir'", "'/seed.txt'");
|
|
expect(cmd).toContain("cd '/work dir'");
|
|
expect(cmd).toContain(`claude "$(cat '/seed.txt')"`);
|
|
expect(claude.injectSeed).toBeFalsy();
|
|
|
|
expect(findAgentById("codex")!.launch("'/w'", "'/s'")).toContain(`codex "$(cat '/s')"`);
|
|
expect(findAgentById("gemini")!.launch("'/w'", "'/s'")).toContain(`gemini -i "$(cat '/s')"`);
|
|
expect(findAgentById("cursor")!.launch("'/w'", "'/s'")).toContain(`cursor-agent "$(cat '/s')"`);
|
|
});
|
|
|
|
it("inject-mode agents take no seed arg", () => {
|
|
const opencode = findAgentById("opencode")!;
|
|
expect(opencode.injectSeed).toBe(true);
|
|
const cmd = opencode.launch("'/w'", "'/s'");
|
|
expect(cmd).toContain("opencode");
|
|
expect(cmd).not.toContain("$(cat");
|
|
});
|
|
|
|
it("findAgentById returns undefined for an unknown id", () => {
|
|
expect(findAgentById("nope")).toBeUndefined();
|
|
});
|
|
});
|
|
|
|
describe("agent detection", () => {
|
|
it("uses the injected PATH probe", () => {
|
|
const onPath = (bin: string): boolean => bin === "claude" || bin === "cursor-agent";
|
|
expect(isAgentInstalled(findAgentById("claude")!, onPath)).toBe(true);
|
|
expect(isAgentInstalled(findAgentById("codex")!, onPath)).toBe(false);
|
|
expect(detectInstalledAgents(onPath).map((a) => a.id)).toEqual(["claude", "cursor"]);
|
|
});
|
|
|
|
it("detects none when nothing is on PATH", () => {
|
|
expect(detectInstalledAgents(() => false)).toEqual([]);
|
|
});
|
|
|
|
it("preserves registry (preference) order in detection", () => {
|
|
expect(detectInstalledAgents(() => true).map((a) => a.id)).toEqual(agentIds());
|
|
});
|
|
});
|