Skip to content

armgit / alook

Public Imported from GitHub
0

Multi-Agent Collaboration for Team and Friends

fix(daemon): support official Antigravity CLI 1.3.4 as agy backend (#961)

Gustavo Ye77571bd4ecc0
diff --git a/.github/workflows/windows-runtime.yml b/.github/workflows/windows-runtime.yml
index 2f3f690d6..4f0ba3543 100644
--- a/.github/workflows/windows-runtime.yml
+++ b/.github/workflows/windows-runtime.yml
@@ -89,6 +89,26 @@ jobs:
Invoke-WebRequest 'https://dl.google.com/agy-extensions/releases/windows/agy-acp-server-1.3.0-windows-x86_64.zip' -OutFile $agyZip
Expand-Archive $agyZip -DestinationPath $env:ALOOK_NATIVE_NPM_PREFIX -Force
if (-not (Test-Path (Join-Path $env:ALOOK_NATIVE_NPM_PREFIX 'agy_acp_server.exe'))) { throw 'Missing Antigravity ACP entry' }
+ - name: Fetch the official Antigravity CLI 1.3.4
+ shell: pwsh
+ run: |
+ $nativeAgy = Join-Path $env:RUNNER_TEMP 'agy-1.3.4.exe'
+ $url = 'https://storage.googleapis.com/antigravity-public/antigravity-cli/1.3.4-5524158944247808/windows-x64/cli_windows_x64.exe'
+ $expected = '21ac62deb74acce6e7ce3f5fd32411ddaf5e860319cc80857a85ddce1563d08d6a5042aa913d7211175fbcde8e4ee5d527ed3f84dcd2b7f0ac3a4c4e8d2008eb'
+ Invoke-WebRequest $url -OutFile $nativeAgy
+ $actual = (Get-FileHash $nativeAgy -Algorithm SHA512).Hash.ToLower()
+ if ($actual -ne $expected) { throw 'Antigravity CLI SHA512 mismatch' }
+ "ALOOK_NATIVE_AGY_PATH=$nativeAgy" | Out-File -FilePath $env:GITHUB_ENV -Encoding utf8 -Append
+ Write-Output "Antigravity CLI 1.3.4 SHA512: $actual"
+ - name: Verify actual Windows Antigravity CLI discovery
+ shell: pwsh
+ run: |
+ $evidenceDir = Join-Path $env:RUNNER_TEMP 'Alook runtime evidence'
+ New-Item -ItemType Directory -Force $evidenceDir | Out-Null
+ pnpm --filter @alook/agent-driver exec vitest run src/adapters/agy/probe.test.ts src/adapters/agy/native.windows.test.ts --no-file-parallelism 2>&1 | Tee-Object -FilePath (Join-Path $evidenceDir 'agy-discovery.log')
+ $suiteExit = $LASTEXITCODE
+ @{ exitCode = $suiteExit; checkout = $env:GITHUB_SHA; runId = $env:GITHUB_RUN_ID; attempt = $env:GITHUB_RUN_ATTEMPT } | ConvertTo-Json | Set-Content -Path (Join-Path $evidenceDir 'agy-discovery-terminal.json') -Encoding utf8
+ exit $suiteExit
- name: Exercise real detection, persistent startup and cleanup
shell: pwsh
run: |
diff --git a/src/daemon/agent-driver/README.md b/src/daemon/agent-driver/README.md
index cc260c526..b70b64f16 100644
--- a/src/daemon/agent-driver/README.md
+++ b/src/daemon/agent-driver/README.md
@@ -1,7 +1,7 @@
# @alook/agent-driver
Repository-private logical-session drivers for Claude, Codex, Cursor, Grok,
-OpenCode, Pi, and Antigravity.
+OpenCode, Pi, Antigravity ACP, and Antigravity CLI (`agy`).
The package's exported contract owns backend lifecycle, message admission,
buffering, queueing, interrupts, stop deadlines, and normalized events. The
@@ -110,6 +110,7 @@ There is no per-turn built-in fallback.
| Cursor | session | `stdio_rpc` / `cursor.acp.v1` | `steer` | `transport_request` |
| OpenCode | session | `http_sse` / `opencode.v2.service` | `steer` | `transport_request` |
| Pi | session | `in_process_sdk` / `pi_sdk` | `steer` | `prompt_invocation` |
+| Antigravity CLI (`agy`) | session | `stdio_stream` / `agy.stream-json.v1` | `next_turn_queue` | `vendor_message` |
For Claude and Codex, `safe_boundary_queue` waits for at most the next valid
tool-output event. A tool start closes the boundary for messages that arrive
@@ -216,6 +217,39 @@ Do not fall back to `cursor-agent --print` or `opencode run`. Verify the
unaffected backends and the capability probe before resuming rollout.
+## Antigravity CLI (`agy`)
+
+The `agy` backend supports Google's official Antigravity CLI, independently of
+the `antigravity` ACP backend below. Install and sign in with the
+[official CLI instructions](https://antigravity.google/docs/cli/install/).
+Discovery and launch share the same executable lookup: an explicit `command`,
+`agy` on PATH, then `~/.local/bin/agy` on macOS/Linux or
+`%LOCALAPPDATA%/agy/bin/agy.exe` on Windows (the default user-local directory
+is used only when `LOCALAPPDATA` is absent). Run the selected CLI executable in a terminal and finish
+Google sign-in before starting a bot; ACP authentication is separate.
+
+The CLI must advertise native `--input-format stream-json`,
+`--output-format stream-json` and `--conversation` support. Alook keeps one
+process across turns and queues busy input until the current result completes.
+It passes selected model and effort through `--model` and `--effort`, delivers
+standing instructions with the first input, and uses the injected Alook CLI
+through the existing host environment. Sign-in is local to the native CLI;
+discovery compatibility does not prove an authenticated model request.
+
+Resume passes the exact saved conversation ID to `--conversation`. A missing
+or substituted ID fails; no new conversation is silently accepted. The CLI
+does not support ACP or Claude control messages. This backend declares
+`interrupt: false`; stop and reset retain the existing process cleanup boundary.
+
+Token usage comes from live completed step events, deduplicated with native
+conversation/step identity. Cumulative result usage is not added again. Unknown
+counts remain unknown. Provider quota is unsupported until a CLI-specific
+source is established; ACP credentials and quota are not reused.
+
+Version 1.3.4 was checked for executable discovery, advertised protocol and
+unauthenticated startup cleanup. Authenticated multi-turn and resume acceptance
+are separate checks and must not be inferred from protocol fixtures.
+
## Antigravity (native ACP)
The `antigravity` backend uses Google's native `agy_acp_server.par` (`agy_acp_server.exe`
diff --git a/src/daemon/agent-driver/src/adapters/agy/index.test.ts b/src/daemon/agent-driver/src/adapters/agy/index.test.ts
new file mode 100644
index 000000000..327975bb7
--- /dev/null
+++ b/src/daemon/agent-driver/src/adapters/agy/index.test.ts
@@ -0,0 +1,213 @@
+import { existsSync, mkdtempSync, writeFileSync, readFileSync, rmSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { once } from "node:events";
+import { afterEach, describe, expect, it, vi } from "vitest";
+import { AgyDriver } from "./index.js";
+import { createBuiltinAgentDriverSdk, type AgentEvent, type BuiltinBackendSpecs } from "../../host.js";
+import { createFakeAgentDriverHost } from "../../testing/fake-host.js";
+import { fakeLaunchContext } from "../../testing/adapter-fixture.js";
+import { isAlive, killProcessTree } from "../../internal/killTree.js";
+
+const directories: string[] = [];
+afterEach(() => { for (const directory of directories.splice(0)) rmSync(directory, { recursive: true, force: true }); });
+const line = (value: unknown) => JSON.stringify(value);
+const step = (index: number, extra: object = {}, id = "native") => line({ event: "step_update", step_update: {
+ conversation_id: id, step_index: index, state: "DONE", step_type: "agent_response", ...extra,
+} });
+const result = (turns: number, extra: object = {}, id = "native") => line({ event: "result", result: {
+ conversation_id: id, status: "SUCCESS", response: "complete", num_turns: turns, ...extra,
+} });
+function begin(driver: AgyDriver, index = 0, id = "native") {
+ driver.encodeMessage("prompt");
+ return driver.normalizeLine(step(index, { step_type: "user_input" }, id));
+}
+
+describe("agy native stream ownership", () => {
+ it("uses native input identity, ignores other sessions and stale/duplicate terminals", () => {
+ const driver = new AgyDriver();
+ driver.encodeMessage("first");
+ expect(driver.normalizeLine(line({ event: "init", conversation_id: "native" }))).toEqual([{ kind: "session_init", sessionId: "native" }]);
+ expect(driver.normalizeLine(step(0, { step_type: "user_input" }))).toMatchObject([{ kind: "turn_owner", receipt: "agy:native:0" }]);
+ expect(driver.normalizeLine(result(1, {}, "child"))).toEqual([]);
+ expect(driver.normalizeLine(result(1))).toMatchObject([{ kind: "assistant_message_completed" }, { kind: "turn_end" }]);
+ expect(driver.normalizeLine(result(1))).toEqual([]);
+ expect(begin(driver, 3)).toMatchObject([{ kind: "turn_owner", receipt: "agy:native:3" }]);
+ expect(driver.normalizeLine(step(0, { step_type: "user_input" }))).toEqual([]);
+ expect(driver.normalizeLine(result(1))).toEqual([]);
+ expect(driver.normalizeLine(result(2))).toHaveLength(2);
+ expect(driver.encodeMessage("busy", null, { mode: "busy" })).toBeNull();
+ });
+ it("counts only live completed steps once and ignores cumulative result/history after resume", () => {
+ const driver = new AgyDriver();
+ driver.normalizeLine(line({ event: "init", conversation_id: "native" }));
+ driver.encodeMessage("resume");
+ const usage = { input_tokens: 7, output_tokens: 4, cache_read_tokens: 10, thinking_tokens: 3 };
+ expect(driver.normalizeLine(step(2, { usage }))).toEqual([]);
+ begin(driver, 9);
+ expect(driver.normalizeLine(step(8, { usage }))).toEqual([]);
+ const done = step(10, { usage });
+ const events = driver.normalizeLine(done);
+ expect(events).toMatchObject([{ kind: "telemetry", name: "token_usage", usage: { input: 7, output: 4, cache: 10 }, identity: { index: 10 } }]);
+ expect(driver.normalizeLine(done)).toEqual([]);
+ expect(driver.normalizeLine(result(4, { usage: { input_tokens: 99999 } })).filter((event) => event.kind === "telemetry")).toEqual([]);
+ begin(driver, 12);
+ expect(driver.normalizeLine(step(10, { usage }))).toEqual([]);
+ expect(driver.normalizeLine(step(13, { usage: { output_tokens: 0 } }))).toMatchObject([{ usage: { input: null, output: 0, cache: null } }]);
+ });
+ it("keeps a tool live until its matching completed step without ending the root turn", () => {
+ const driver = new AgyDriver();
+ driver.normalizeLine(line({ event: "init", conversation_id: "native" }));
+ begin(driver);
+ expect(driver.normalizeLine(step(1, { step_type: "tool", state: "ACTIVE", tool_name: "bash", tool_info: { parameters: "ls" } }))).toEqual([{ kind: "tool_call", callId: "native:1", name: "bash", input: "ls" }]);
+ expect(driver.normalizeLine(step(1, { step_type: "tool", state: "DONE", tool_name: "bash" }, "child"))).toEqual([]);
+ expect(driver.normalizeLine(step(1, { step_type: "tool", tool_name: "bash" }))).toEqual([{ kind: "tool_output", callId: "native:1", name: "bash" }]);
+ expect(driver.normalizeLine(result(1))).toMatchObject([{ kind: "assistant_message_completed" }, { kind: "turn_end" }]);
+ });
+ it.each(["ERROR", "CANCELLED", "TIMEOUT"])("discards partial content on %s and never treats it as success", (status) => {
+ const driver = new AgyDriver();
+ driver.normalizeLine(line({ event: "init", conversation_id: "native" }));
+ begin(driver);
+ driver.normalizeLine(step(1, { text_delta: "partial" }));
+ expect(driver.normalizeLine(result(1, { status, error: "native failure" }))).toEqual([
+ { kind: "error", message: "native failure" }, { kind: "turn_end", sessionId: "native", pendingContent: "discard" },
+ ]);
+ });
+ it("rejects malformed streams, invalid input identity and unowned results", async () => {
+ const invalid = new AgyDriver();
+ expect(invalid.normalizeLine("broken")).toMatchObject([{ kind: "error" }]);
+ expect(invalid.encodeMessage("after failure")).toBeNull();
+ const driver = new AgyDriver();
+ driver.normalizeLine(line({ event: "init", conversation_id: "native" }));
+ driver.encodeMessage("prompt");
+ expect(driver.normalizeLine(result(1))).toMatchObject([{ kind: "error" }]);
+ expect(await driver.interrupt()).toBe(false);
+ const badIndex = new AgyDriver();
+ badIndex.normalizeLine(line({ event: "init", conversation_id: "native" }));
+ badIndex.encodeMessage("prompt");
+ expect(badIndex.normalizeLine(step(-1))).toMatchObject([{ kind: "error" }]);
+ });
+});
+
+function fixture(mode = "normal") {
+ const directory = mkdtempSync(join(tmpdir(), "alook-agy-sdk-"));
+ directories.push(directory);
+ const executable = join(directory, "cli-fixture");
+ writeFileSync(executable, `#!${process.execPath}
+const fs=require('node:fs');
+if(process.argv.includes('--version')){console.log('1.3.4');process.exit(0)}
+if(process.argv.includes('--help')){console.error('--input-format --output-format stream-json --conversation');process.exit(0)}
+fs.writeFileSync('argv.json',JSON.stringify(process.argv.slice(2)));
+const emit=x=>console.log(JSON.stringify(x));
+const requested=process.argv[process.argv.indexOf('--conversation')+1];
+const resumed=process.argv.includes('--conversation');
+const id=${JSON.stringify(mode)}==='mismatch'?'substitute':resumed?requested:'native';
+if(${JSON.stringify(mode)}==='auth'){emit({event:'result',result:{conversation_id:'',status:'ERROR',error:'authentication required',num_turns:0}});process.exit(1)}
+emit({event:'init',conversation_id:id});
+let turn=resumed?3:0;let index=resumed?9:0;
+require('node:readline').createInterface({input:process.stdin}).on('line',line=>{
+ const input=JSON.parse(line);fs.appendFileSync('inputs.jsonl',JSON.stringify(input)+'\\n');turn++;
+ emit({event:'step_update',step_update:{conversation_id:id,step_index:index,state:'DONE',step_type:'user_input'}});
+ const done=()=>{
+ const update={event:'step_update',step_update:{conversation_id:id,step_index:index+1,state:'DONE',step_type:'agent_response',text_delta:'reply '+turn,usage:{input_tokens:7,output_tokens:4,cache_read_tokens:10}}};
+ emit(update);emit(update);
+ const result={event:'result',result:{conversation_id:id,status:'SUCCESS',response:'reply '+turn,num_turns:turn,usage:{input_tokens:99999}}};
+ emit(result);emit(result);index+=3;
+ };
+ if(!resumed&&turn===1){const timer=setInterval(()=>{if(fs.existsSync('release')){clearInterval(timer);done()}},5)}else done();
+});
+`, { mode: 0o755 });
+ return { directory, executable };
+}
+
+describe.skipIf(process.platform === "win32")("agy registered SDK with a real fixture process", () => {
+ it("reports a failed initial input write, fences further input and releases its process", async () => {
+ const f = fixture();
+ const driver = new AgyDriver();
+ expect(await driver.probe(f.executable)).toEqual({ status: "healthy", version: "1.3.4" });
+ const ctx = fakeLaunchContext("agy", f.directory);
+ const { process: child } = await driver.spawn({ ...ctx, backend: "agy", config: { ...ctx.config, runtimeConfig: { model: { kind: "default" }, command: f.executable } } });
+ const closed = once(child, "close");
+ const write = vi.spyOn(child.stdin!, "write").mockImplementation(() => { throw new Error("closed input"); });
+ try {
+ expect(driver.normalizeLine(line({ event: "init", conversation_id: "native" }))).toEqual([{ kind: "error", message: "Antigravity CLI input is unavailable" }]);
+ expect(driver.encodeMessage("must not send")).toBeNull();
+ await closed;
+ expect(isAlive(child.pid!)).toBe(false);
+ } finally { write.mockRestore(); if (child.pid && isAlive(child.pid)) await killProcessTree(child.pid, { graceMs: 10 }); }
+ });
+ it("drains ten busy inputs exactly once in order through one persistent process", async () => {
+ const f = fixture();
+ const opened = await createBuiltinAgentDriverSdk({ host: createFakeAgentDriverHost() }).open({ backend: "agy",
+ config: { model: { kind: "default" }, command: f.executable },
+ launch: { workingDirectory: f.directory, instructions: { format: "markdown", content: "" }, launchId: "agy-burst" },
+ });
+ if (!opened.ok) throw new Error(opened.error.message);
+ const session = opened.session;
+ const events: AgentEvent<BuiltinBackendSpecs, "agy">[] = [];
+ const collecting = (async () => { for await (const event of session.events) events.push(event); })();
+ try {
+ await session.start({ id: "0", kind: "user", text: "0" });
+ const receipts = await Promise.all(Array.from({ length: 9 }, (_, i) => session.send({ id: String(i + 1), kind: "user", text: String(i + 1) })));
+ expect(receipts.every((receipt) => receipt.status === "queued")).toBe(true);
+ writeFileSync(join(f.directory, "release"), "go");
+ await vi.waitFor(() => expect(events.filter((event) => event.type === "turn_completed")).toHaveLength(10));
+ expect(events.filter((event) => event.type === "command_accepted").map((event) => event.commandId)).toEqual(Array.from({ length: 10 }, (_, i) => String(i)));
+ expect(events.filter((event) => event.type === "assistant_message_completed").map((event) => event.text)).toEqual(Array.from({ length: 10 }, (_, i) => `reply ${i + 1}`));
+ expect(events.filter((event) => event.type === "token_usage")).toHaveLength(10);
+ expect(session.snapshot().diagnostics.metrics.physicalOpenCount).toBe(1);
+ } finally { await session.stop({ reason: "shutdown", forceAfterMs: 10 }); await session.closed; await collecting; }
+ });
+ it("queues a busy input, reuses one process, preserves text/usage, and stops through existing authority", async () => {
+ const f = fixture();
+ const host = createFakeAgentDriverHost();
+ const opened = await createBuiltinAgentDriverSdk({ host }).open({ backend: "agy",
+ config: { model: { kind: "named", name: "chosen-model" }, reasoningEffort: "high", command: f.executable },
+ launch: { workingDirectory: f.directory, instructions: { format: "markdown", content: "standing" }, launchId: "agy-sdk" },
+ });
+ if (!opened.ok) throw new Error(opened.error.message);
+ const session = opened.session;
+ const events: AgentEvent<BuiltinBackendSpecs, "agy">[] = [];
+ const collecting = (async () => { for await (const event of session.events) events.push(event); })();
+ try {
+ expect(await session.start({ id: "first", kind: "user", text: "first" })).toMatchObject({ status: "accepted" });
+ expect(await session.send({ id: "second", kind: "user", text: "second" })).toMatchObject({ status: "queued" });
+ expect(await session.interrupt({ requestId: "unsupported", reason: "test" })).toMatchObject({ status: "not_running" });
+ writeFileSync(join(f.directory, "release"), "go");
+ await vi.waitFor(() => expect(events.filter((event) => event.type === "turn_completed")).toHaveLength(2));
+ expect(events.filter((event) => event.type === "assistant_message_completed").map((event) => event.text)).toEqual(["reply 1", "reply 2"]);
+ expect(events.filter((event) => event.type === "token_usage").map((event) => event.usage)).toEqual([{ input: 7, output: 4, cache: 10 }, { input: 7, output: 4, cache: 10 }]);
+ const inputs = readFileSync(join(f.directory, "inputs.jsonl"), "utf8").trim().split("\n").map((row) => JSON.parse(row));
+ expect(inputs[0].message.content).toContain("standing");
+ expect(inputs[1]).toEqual({ event: "user", message: { content: "second" } });
+ expect(session.snapshot().diagnostics.metrics.physicalOpenCount).toBe(1);
+ expect(JSON.parse(readFileSync(join(f.directory, "argv.json"), "utf8"))).toEqual(expect.arrayContaining(["--input-format", "stream-json", "--output-format", "--model", "chosen-model", "--effort", "high"]));
+ } finally { await session.stop({ reason: "shutdown", forceAfterMs: 10 }); await session.closed; await collecting; }
+ expect(host.releases).toHaveLength(1);
+ });
+ it.each(["resume", "mismatch", "auth"])("handles %s without replacing a saved conversation", async (mode) => {
+ const f = fixture(mode);
+ const opened = await createBuiltinAgentDriverSdk({ host: createFakeAgentDriverHost() }).open({ backend: "agy",
+ config: { model: { kind: "default" }, command: f.executable },
+ launch: { workingDirectory: f.directory, instructions: { format: "markdown", content: "" }, launchId: mode, resumeSessionId: "saved-native" },
+ });
+ if (!opened.ok) throw new Error(opened.error.message);
+ const session = opened.session;
+ const events: AgentEvent<BuiltinBackendSpecs, "agy">[] = [];
+ const collecting = (async () => { for await (const event of session.events) events.push(event); })();
+ try {
+ const receipt = await session.start({ id: "resume", kind: "user", text: "resume" });
+ expect(receipt.status).toBe(mode === "resume" ? "accepted" : "rejected");
+ if (mode === "resume") {
+ await vi.waitFor(() => expect(events.some((event) => event.type === "turn_completed")).toBe(true));
+ expect(session.snapshot().backendSessionId).toBe("saved-native");
+ expect(events.filter((event) => event.type === "token_usage")).toMatchObject([{ usage: { input: 7, output: 4, cache: 10 }, identity: { index: 10 } }]);
+ } else {
+ expect(events.some((event) => event.type === "assistant_message_completed")).toBe(false);
+ expect(existsSync(join(f.directory, "inputs.jsonl"))).toBe(false);
+ if (mode === "auth") expect(receipt).toMatchObject({ error: { message: expect.stringContaining("Run the configured Antigravity CLI in a terminal, complete sign-in, then retry") } });
+ }
+ expect(JSON.parse(readFileSync(join(f.directory, "argv.json"), "utf8"))).toEqual(expect.arrayContaining(["--conversation", "saved-native"]));
+ } finally { await session.stop({ reason: "shutdown", forceAfterMs: 10 }); await session.closed; await collecting; }
+ });
+});
diff --git a/src/daemon/agent-driver/src/adapters/agy/index.ts b/src/daemon/agent-driver/src/adapters/agy/index.ts
new file mode 100644
index 000000000..f6b8f7b31
--- /dev/null
+++ b/src/daemon/agent-driver/src/adapters/agy/index.ts
@@ -0,0 +1,158 @@
+import { createHash } from "node:crypto";
+import { homedir } from "node:os";
+import type { AdapterEvent, AdapterLaunchContext, BackendAdapter, SpawnedProcessHandle } from "../../internal/adapter.js";
+import { createProcessLane } from "../../controller/process-host.js";
+import { prepareCliTransport } from "../../internal/cliTransport.js";
+import { resolveLaunchFieldsOrDefault } from "../../internal/config.js";
+import { killProcessTree, spawnAgentProcess } from "../../internal/killTree.js";
+import { asRecord } from "../../internal/utils.js";
+import { probeAgy, agySpawnSpec } from "./probe.js";
+import { SettledUsageProjector } from "../../internal/token-usage.js";
+
+const STREAM_ARGS = ["--input-format", "stream-json", "--output-format", "stream-json", "--dangerously-skip-permissions"];
+
+function nativeId(value: unknown): string | undefined {
+ return typeof value === "string" && /^[A-Za-z0-9_-]{1,100}$/.test(value) ? value : undefined;
+}
+
+export class AgyDriver implements BackendAdapter<"agy"> {
+ readonly id = "agy";
+ readonly instructionDelivery = { kind: "native" } as const;
+ readonly execution = {
+ lifetime: "session", transport: { kind: "stdio_stream", protocol: "agy.stream-json.v1" },
+ wakeStart: "immediate", terminalOwnership: "vendor_message",
+ } as const;
+ private process?: SpawnedProcessHandle;
+ private initialInput?: string;
+ private sessionId: string | null = null;
+ private requestedId?: string;
+ private pending = false;
+ private failed = false;
+ private inputIndex?: number;
+ private lastInputIndex = -1;
+ private previousTurns?: number;
+ private inputAt = "";
+ private usageSource = "";
+ private readonly usage = new SettledUsageProjector();
+
+ constructor(private readonly launchSpec?: ReturnType<typeof agySpawnSpec>) {}
+
+ probe(command?: string) { return probeAgy(command); }
+
+ async openLane(ctx: AdapterLaunchContext<"agy">, options?: { onRawStdoutLine?: (line: string) => void }) {
+ const spec = agySpawnSpec(resolveLaunchFieldsOrDefault(ctx.config.runtimeConfig).command);
+ const probe = await probeAgy(spec.command);
+ if (probe.status !== "healthy") throw new Error(probe.lastError);
+ return createProcessLane(new AgyDriver(spec), ctx, options);
+ }
+
+ get currentSessionId() { return this.sessionId; }
+
+ async spawn(ctx: AdapterLaunchContext<"agy">) {
+ this.sessionId = null;
+ this.failed = false;
+ this.previousTurns = undefined;
+ this.lastInputIndex = -1;
+ const { spawnEnv } = await prepareCliTransport(ctx);
+ const fields = resolveLaunchFieldsOrDefault(ctx.config.runtimeConfig);
+ const saved = ctx.config.sessionId;
+ this.requestedId = saved ? nativeId(saved) : undefined;
+ if (saved && !this.requestedId) throw new Error("Invalid Antigravity CLI resume identity; reset explicitly");
+ const args = [...STREAM_ARGS,
+ ...(this.requestedId ? ["--conversation", this.requestedId] : []),
+ ...(fields.model ? ["--model", fields.model] : []),
+ ...(fields.reasoningEffort ? ["--effort", fields.reasoningEffort] : []),
+ ];
+ this.usageSource = `antigravity-cli:${createHash("sha256").update(homedir()).digest("hex").slice(0, 16)}`;
+ const spec = this.launchSpec ?? agySpawnSpec(fields.command);
+ this.initialInput = this.encodeMessage([ctx.standingPrompt, ctx.prompt].filter(Boolean).join("\n\n")) ?? undefined;
+ const process = spawnAgentProcess(spec.command, args, { cwd: ctx.workingDirectory, env: spawnEnv, shell: spec.shell });
+ this.process = process;
+ return { process };
+ }
+
+ encodeMessage(text: string, _sessionId?: string | null, options?: { mode?: "busy" | "idle" }): string | null {
+ if (this.failed || options?.mode === "busy") return null;
+ this.pending = true;
+ this.inputIndex = undefined;
+ this.usage.reset();
+ return JSON.stringify({ event: "user", message: { content: text } });
+ }
+
+ normalizeLine(line: string): AdapterEvent[] {
+ let event: Record<string, unknown> | null;
+ try { event = asRecord(JSON.parse(line)); } catch { return this.fail("Antigravity CLI emitted invalid JSON"); }
+ if (this.failed) return [];
+ if (event?.event === "init") {
+ const id = nativeId(event.conversation_id);
+ if (!id || this.sessionId || (this.requestedId && id !== this.requestedId)) return this.fail("Antigravity CLI did not restore the requested conversation; reset explicitly");
+ this.sessionId = id;
+ const initial = this.initialInput;
+ this.initialInput = undefined;
+ try { if (initial) this.process?.stdin?.write(initial + "\n"); }
+ catch { return this.fail("Antigravity CLI input is unavailable"); }
+ return [{ kind: "session_init", sessionId: this.currentSessionId! }];
+ }
+ if (event?.event === "step_update") {
+ const step = asRecord(event.step_update);
+ if (!this.pending || !this.sessionId || step?.conversation_id !== this.sessionId) return [];
+ const index = step.step_index;
+ if (!Number.isSafeInteger(index) || (index as number) < 0) return this.fail("Antigravity CLI emitted an invalid step identity");
+ if (step.step_type === "user_input" && step.state === "DONE" && this.inputIndex === undefined && (index as number) > this.lastInputIndex) {
+ this.inputIndex = index as number;
+ this.inputAt = new Date().toISOString();
+ this.lastInputIndex = index as number;
+ return [{ kind: "turn_owner", receipt: `agy:${this.sessionId}:${index}`, nativeTurnId: String(index) }];
+ }
+ if (this.inputIndex === undefined || (index as number) <= this.inputIndex) return [];
+ const result: AdapterEvent[] = [];
+ if (step.step_type === "agent_response" && typeof step.text_delta === "string") result.push({ kind: "assistant_message_delta", text: step.text_delta });
+ if (step.step_type === "tool") {
+ const tool = asRecord(step.tool_info);
+ const name = typeof step.tool_name === "string" ? step.tool_name : "tool";
+ const callId = `${this.sessionId}:${index}`;
+ if (step.state === "ACTIVE") result.push({ kind: "tool_call", callId, name, input: tool?.parameters });
+ if (step.state === "DONE") result.push({ kind: "tool_output", callId, name });
+ }
+ const usage = asRecord(step.usage);
+ if (step.state === "DONE" && usage) {
+ const projected = this.usage.project({ runtime: "antigravity-cli", backendSessionId: this.sessionId,
+ providerRecordId: String(index), source: "antigravity.stream", input: usage.input_tokens,
+ output: usage.output_tokens, cacheRead: usage.cache_read_tokens,
+ inputIncludesCache: false, outputIncludesReasoning: true,
+ });
+ if (projected?.kind === "telemetry" && projected.name === "token_usage") result.push({ ...projected,
+ identity: { source: `${this.usageSource}:${this.sessionId}`, index: index as number, occurredAt: this.inputAt },
+ });
+ }
+ return result;
+ }
+ if (event?.event !== "result") return [];
+ const result = asRecord(event.result);
+ if (result?.status === "ERROR" && !this.sessionId) return this.fail(typeof result.error === "string" ? result.error : "Antigravity CLI initialization failed");
+ if (!this.pending || result?.conversation_id !== this.sessionId) return [];
+ const turns = result.num_turns;
+ if (!Number.isSafeInteger(turns) || (turns as number) < 1) return this.fail("Antigravity CLI emitted an invalid turn counter");
+ if (this.previousTurns !== undefined && (turns as number) <= this.previousTurns) return [];
+ if (this.inputIndex === undefined || (this.previousTurns !== undefined && turns !== this.previousTurns + 1)) return this.fail("Antigravity CLI result has no matching current input");
+ this.previousTurns = turns as number;
+ this.pending = false;
+ const events: AdapterEvent[] = [];
+ if (result.status === "SUCCESS") {
+ if (typeof result.response !== "string") return this.fail("Antigravity CLI result is missing response text");
+ events.push({ kind: "assistant_message_completed", text: result.response });
+ } else events.push({ kind: "error", message: typeof result.error === "string" ? result.error : `Antigravity CLI status: ${String(result.status)}` });
+ events.push({ kind: "turn_end", sessionId: this.currentSessionId!, ...(result.status !== "SUCCESS" ? { pendingContent: "discard" as const } : {}) });
+ return events;
+ }
+
+ private fail(message: string): AdapterEvent[] {
+ this.failed = true;
+ if (this.process?.pid) void killProcessTree(this.process.pid, { graceMs: 100 }).catch(() => {});
+ return [{ kind: "error", message: /authentication (required|failed)/i.test(message)
+ ? "Antigravity CLI authentication is unavailable. Run the configured Antigravity CLI in a terminal, complete sign-in, then retry."
+ : message }];
+ }
+
+ async interrupt(): Promise<boolean> { return false; }
+}
diff --git a/src/daemon/agent-driver/src/adapters/agy/native.windows.test.ts b/src/daemon/agent-driver/src/adapters/agy/native.windows.test.ts
new file mode 100644
index 000000000..47c3f3a64
--- /dev/null
+++ b/src/daemon/agent-driver/src/adapters/agy/native.windows.test.ts
@@ -0,0 +1,46 @@
+import { createHash } from "node:crypto";
+import { copyFileSync, mkdirSync, mkdtempSync, readFileSync, rmSync, statSync } from "node:fs";
+import { release, tmpdir } from "node:os";
+import { delimiter, dirname, join } from "node:path";
+import { afterEach, describe, expect, it, vi } from "vitest";
+import { createAgentDriverSdk } from "../../index.js";
+import { resolveCommandOnPath } from "../../internal/probe.js";
+import { agySpawnSpec } from "./probe.js";
+
+const roots: string[] = [];
+const native = process.env.ALOOK_NATIVE_AGY_PATH;
+afterEach(() => {
+ vi.unstubAllEnvs();
+ for (const root of roots.splice(0)) rmSync(root, { recursive: true, force: true, maxRetries: 20, retryDelay: 100 });
+});
+
+describe.skipIf(process.platform !== "win32" || !native)("official Windows agy 1.3.4", () => {
+ it.each(["PATH", "standard", "redirected", "explicit"])("discovers the real binary through %s", async (mode) => {
+ const root = mkdtempSync(join(tmpdir(), "Alook agy native QA "));
+ roots.push(root);
+ const home = join(root, "profile");
+ const local = mode === "redirected" ? join(root, "redirected local data") : join(home, "AppData", "Local");
+ const entry = mode === "explicit" ? join(root, "custom install", "agy.exe") : join(local, "agy", "bin", "agy.exe");
+ mkdirSync(dirname(entry), { recursive: true });
+ mkdirSync(home, { recursive: true });
+ copyFileSync(native!, entry);
+ vi.stubEnv("HOME", home);
+ vi.stubEnv("USERPROFILE", home);
+ vi.stubEnv("LOCALAPPDATA", local);
+ vi.stubEnv("CI", "1");
+ vi.stubEnv("GEMINI_API_KEY", undefined);
+ vi.stubEnv("GOOGLE_API_KEY", undefined);
+ const system = process.env.SystemRoot!;
+ vi.stubEnv("PATH", [...(mode === "PATH" ? [dirname(entry)] : []), join(system, "System32"), join(system, "System32", "WindowsPowerShell", "v1.0"), dirname(process.execPath)].join(delimiter));
+ const found = resolveCommandOnPath("agy");
+ const { dev, ino } = statSync(entry);
+ if (mode === "PATH") expect(statSync(found!)).toMatchObject({ dev, ino });
+ else expect(found).toBeNull();
+ const command = mode === "explicit" ? entry : undefined;
+ expect(statSync(agySpawnSpec(command).command)).toMatchObject({ dev, ino });
+ const sdk = createAgentDriverSdk();
+ expect(await sdk.probe({ backend: "agy", ...(command ? { command } : {}) })).toMatchObject({ status: "healthy", version: "1.3.4" });
+ console.log(JSON.stringify({ backend: "agy", mode, os: release(), node: process.version,
+ sha512: createHash("sha512").update(readFileSync(entry)).digest("hex"), version: "1.3.4", probe: "healthy" }));
+ }, 60_000);
+});
diff --git a/src/daemon/agent-driver/src/adapters/agy/probe.test.ts b/src/daemon/agent-driver/src/adapters/agy/probe.test.ts
new file mode 100644
index 000000000..ca85fbb7e
--- /dev/null
+++ b/src/daemon/agent-driver/src/adapters/agy/probe.test.ts
@@ -0,0 +1,51 @@
+import { mkdtempSync, mkdirSync, writeFileSync, rmSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { afterEach, describe, expect, it, vi } from "vitest";
+import { agySpawnSpec, probeAgy } from "./probe.js";
+
+const directories: string[] = [];
+afterEach(() => { vi.unstubAllEnvs(); for (const directory of directories.splice(0)) rmSync(directory, { recursive: true, force: true }); });
+function directory() { const path = mkdtempSync(join(tmpdir(), "alook-agy-probe-")); directories.push(path); return path; }
+
+describe("official agy entry", () => {
+ it("respects explicit commands and prefers PATH over the official installation", () => {
+ const home = directory();
+ const bin = join(home, ".local", "bin");
+ mkdirSync(bin, { recursive: true });
+ writeFileSync(join(bin, "agy"), "installed");
+ const deps = { homeDir: home, which: () => "/path/agy" };
+ expect(agySpawnSpec("/custom/cli", deps, "darwin")).toMatchObject({ command: "/custom/cli", shell: false });
+ expect(agySpawnSpec(undefined, deps, "darwin")).toMatchObject({ command: "/path/agy" });
+ expect(agySpawnSpec(undefined, { homeDir: home, which: () => null }, "darwin")).toMatchObject({ command: join(bin, "agy") });
+ });
+ it("finds the Windows native installation and supports explicit shim paths", () => {
+ const home = directory();
+ const bin = join(home, "AppData", "Local", "agy", "bin");
+ mkdirSync(bin, { recursive: true });
+ writeFileSync(join(bin, "agy.exe"), "installed");
+ vi.stubEnv("LOCALAPPDATA", undefined);
+ expect(agySpawnSpec(undefined, { homeDir: home, which: () => null }, "win32")).toMatchObject({ command: join(bin, "agy.exe"), shell: false });
+ const redirected = join(directory(), "redirected local data");
+ const entry = join(redirected, "agy", "bin", "agy.exe");
+ mkdirSync(join(redirected, "agy", "bin"), { recursive: true });
+ writeFileSync(entry, "redirected installation");
+ vi.stubEnv("LOCALAPPDATA", redirected);
+ expect(agySpawnSpec(undefined, { homeDir: home, which: () => null }, "win32")).toMatchObject({ command: entry, shell: false });
+ expect(agySpawnSpec(undefined, { homeDir: home, which: () => "C:\\path\\agy.exe" }, "win32")).toMatchObject({ command: "C:\\path\\agy.exe" });
+ expect(agySpawnSpec("C:\\custom cli\\agy.cmd", {}, "win32")).toMatchObject({ shell: true });
+ });
+ it.skipIf(process.platform === "win32")("requires actual stream flags and captures native stderr help", async () => {
+ const file = join(directory(), "agy");
+ const script = (help: string, hang = false) => `#!${process.execPath}\nif(process.argv.includes('--version')){console.log('1.3.4')}else{process.stderr.write(${JSON.stringify(help)});${hang ? "setInterval(()=>{},1000);" : ""}}\n`;
+ writeFileSync(file, script("--input-format --output-format stream-json --conversation"), { mode: 0o755 });
+ expect(await probeAgy(file)).toEqual({ status: "healthy", version: "1.3.4" });
+ writeFileSync(file, script("ordinary CLI"), { mode: 0o755 });
+ expect(await probeAgy(file)).toMatchObject({ status: "unhealthy", lastError: "agy_stream_incompatible" });
+ writeFileSync(file, script("x".repeat(65537)), { mode: 0o755 });
+ expect(await probeAgy(file)).toMatchObject({ status: "unhealthy", lastError: "agy_stream_probe_failed" });
+ writeFileSync(file, script("", true), { mode: 0o755 });
+ expect(await probeAgy(file)).toMatchObject({ status: "unhealthy", lastError: "agy_stream_probe_failed" });
+ expect(await probeAgy(join(directory(), "missing"))).toMatchObject({ status: "unhealthy" });
+ });
+});
diff --git a/src/daemon/agent-driver/src/adapters/agy/probe.ts b/src/daemon/agent-driver/src/adapters/agy/probe.ts
new file mode 100644
index 000000000..cdaf0e8be
--- /dev/null
+++ b/src/daemon/agent-driver/src/adapters/agy/probe.ts
@@ -0,0 +1,41 @@
+import { existsSync } from "node:fs";
+import { homedir } from "node:os";
+import { join } from "node:path";
+import type { ProbeResult } from "../../internal/adapter.js";
+import { killProcessTree, spawnAgentProcess } from "../../internal/killTree.js";
+import { probeCommandVersion, resolveCommandOnPath, resolveSpawnSpec, type ProbeDeps } from "../../internal/probe.js";
+
+export function agySpawnSpec(command?: string, deps: ProbeDeps = {}, platform = process.platform): { command: string; args: string[]; shell: boolean } {
+ const explicit = command?.trim();
+ if (explicit) return resolveSpawnSpec("agy", [], explicit, deps, platform);
+ const home = deps.homeDir ?? homedir();
+ const installed = platform === "win32" ? join(process.env.LOCALAPPDATA?.trim() || join(home, "AppData", "Local"), "agy", "bin", "agy.exe") : join(home, ".local", "bin", "agy");
+ const selected = resolveCommandOnPath("agy", deps) ?? (existsSync(installed) ? installed : "agy");
+ return resolveSpawnSpec("agy", [], selected, deps, platform);
+}
+
+export async function probeAgy(command?: string): Promise<ProbeResult> {
+ const spec = agySpawnSpec(command);
+ const version = probeCommandVersion(spec.command);
+ if (!version.ok) return { status: "unhealthy", lastError: version.error };
+ const child = spawnAgentProcess(spec.command, ["--help"], { cwd: process.cwd(), env: { ...process.env, CI: "1" }, shell: spec.shell, stdin: "ignore" });
+ try {
+ const help = await new Promise<string>((resolve, reject) => {
+ let output = "";
+ const timer = setTimeout(() => reject(new Error("timeout")), 3_000);
+ const fail = () => { clearTimeout(timer); reject(new Error("help failed")); };
+ const collect = (chunk: { toString(): string }) => {
+ output += chunk.toString();
+ if (Buffer.byteLength(output) > 64 * 1024) fail();
+ };
+ child.stdout?.on("data", collect);
+ child.stderr?.on("data", collect);
+ child.on("error", fail);
+ child.on("close", (code) => { clearTimeout(timer); if (code === 0) resolve(output); else fail(); });
+ });
+ return ["--input-format", "--output-format", "stream-json", "--conversation"].every((flag) => help.includes(flag))
+ ? { status: "healthy", version: version.version }
+ : { status: "unhealthy", version: version.version, lastError: "agy_stream_incompatible" };
+ } catch { return { status: "unhealthy", version: version.version, lastError: "agy_stream_probe_failed" }; }
+ finally { if (child.pid) await killProcessTree(child.pid, { graceMs: 100 }); }
+}
diff --git a/src/daemon/agent-driver/src/builtin-config.test.ts b/src/daemon/agent-driver/src/builtin-config.test.ts
index 532c2eec9..0293b974c 100644
--- a/src/daemon/agent-driver/src/builtin-config.test.ts
+++ b/src/daemon/agent-driver/src/builtin-config.test.ts
@@ -32,7 +32,7 @@ describe("builtin config boundary", () => {
});
});
- it.each(["codex", "cursor", "grok", "opencode", "pi"])("maps %s without daemon-side switches", (runtime) => {
+ it.each(["codex", "cursor", "grok", "opencode", "pi", "agy"])("maps %s without daemon-side switches", (runtime) => {
expect(toBuiltinBackendSelection(config(runtime))).toMatchObject({ backend: runtime });
});
diff --git a/src/daemon/agent-driver/src/builtin-config.ts b/src/daemon/agent-driver/src/builtin-config.ts
index b8b1dfc7a..1f033f0be 100644
--- a/src/daemon/agent-driver/src/builtin-config.ts
+++ b/src/daemon/agent-driver/src/builtin-config.ts
@@ -48,6 +48,8 @@ export function toBuiltinBackendSelection(config: BuiltinRuntimeConfigInput): Bu
backend: "codex",
config: { ...base, reasoningEffort: config.reasoningEffort, mode: config.mode.kind },
};
+ case "agy":
+ return { backend: "agy", config: { ...base, reasoningEffort: config.reasoningEffort } };
case "antigravity":
return { backend: "antigravity", config: { ...base, reasoningEffort: config.reasoningEffort } };
case "cursor":
diff --git a/src/daemon/agent-driver/src/contract.ts b/src/daemon/agent-driver/src/contract.ts
index d10d2af90..f9f19c95c 100644
--- a/src/daemon/agent-driver/src/contract.ts
+++ b/src/daemon/agent-driver/src/contract.ts
@@ -2,7 +2,7 @@ export type JsonPrimitive = string | number | boolean | null;
export type JsonValue = JsonPrimitive | JsonObject | readonly JsonValue[];
export type JsonObject = { readonly [key: string]: JsonValue };
-export type BuiltinBackendId = "claude" | "codex" | "cursor" | "grok" | "opencode" | "pi" | "antigravity";
+export type BuiltinBackendId = "claude" | "codex" | "cursor" | "grok" | "opencode" | "pi" | "antigravity" | "agy";
export type ReasoningEffort =
| "minimal"
| "low"
@@ -79,6 +79,7 @@ export interface ModelBackendConfig extends BaseBackendConfig {
export interface AntigravityConfig extends ModelBackendConfig {
readonly reasoningEffort?: ReasoningEffort;
}
+export type AgyConfig = AntigravityConfig;
export type CursorConfig = ModelBackendConfig;
export interface GrokConfig extends ModelBackendConfig {
readonly reasoningEffort?: ReasoningEffort;
@@ -126,6 +127,7 @@ export type FixedCapabilities<
};
export type AntigravityCapabilities = FixedCapabilities<false, true, false, false, true, "next_turn_queue", "persistent">;
+export type AgyCapabilities = Omit<AntigravityCapabilities, "interrupt"> & { readonly interrupt: false };
export type ClaudeCapabilities = FixedCapabilities<true, true, true, true, true, "safe_boundary_queue", "persistent">;
export type CodexCapabilities = FixedCapabilities<false, true, true, false, true, "safe_boundary_queue", "persistent">;
export type CursorCapabilities = FixedCapabilities<false, false, false, false, true, "steer", "persistent">;
@@ -147,6 +149,7 @@ export interface BackendTypeSpec<Config, Capabilities, Extensions, ExtraEvent> {
export interface BuiltinBackendSpecs {
readonly antigravity: BackendTypeSpec<AntigravityConfig, AntigravityCapabilities, {}, never>;
+ readonly agy: BackendTypeSpec<AgyConfig, AgyCapabilities, {}, never>;
readonly claude: BackendTypeSpec<ClaudeConfig, ClaudeCapabilities, {}, never>;
readonly codex: BackendTypeSpec<CodexConfig, CodexCapabilities, {}, never>;
readonly cursor: BackendTypeSpec<CursorConfig, CursorCapabilities, {}, never>;
diff --git a/src/daemon/agent-driver/src/controller/logical-session.test.ts b/src/daemon/agent-driver/src/controller/logical-session.test.ts
index e213223a4..93f3a75ec 100644
--- a/src/daemon/agent-driver/src/controller/logical-session.test.ts
+++ b/src/daemon/agent-driver/src/controller/logical-session.test.ts
@@ -32,6 +32,7 @@ const configs: Record<BuiltinBackendId, unknown> = {
claude: { model: { kind: "default" }, provider: { kind: "default" }, mode: "default" },
codex: { model: { kind: "default" }, mode: "default" },
cursor: { model: { kind: "default" } },
+ agy: { model: { kind: "default" } },
antigravity: { model: { kind: "default" } },
grok: { model: { kind: "default" } },
opencode: { model: { kind: "default" } },
diff --git a/src/daemon/agent-driver/src/public-contract.ts b/src/daemon/agent-driver/src/public-contract.ts
index 67684f648..326d374d9 100644
--- a/src/daemon/agent-driver/src/public-contract.ts
+++ b/src/daemon/agent-driver/src/public-contract.ts
@@ -6,7 +6,7 @@ export const SESSION_FILE_DISCOVERY_CAPABILITIES = sessionFileDiscoveryCapabilit
export type {
JsonPrimitive, JsonValue, JsonObject, BuiltinBackendId, ReasoningEffort, RuntimeReasoningCatalog,
RuntimeSettingsUpdate, RuntimeSettingsUpdateResult, ModelSelection, DefaultProvider,
- AntigravityConfig, AntigravityCapabilities, ClaudeProvider, PiProvider, BaseBackendConfig, ClaudeConfig, CodexConfig, ModelBackendConfig, CursorConfig,
+ AntigravityConfig, AntigravityCapabilities, AgyConfig, AgyCapabilities, ClaudeProvider, PiProvider, BaseBackendConfig, ClaudeConfig, CodexConfig, ModelBackendConfig, CursorConfig,
GrokConfig, OpenCodeConfig, PiConfig, BackendCapabilities, ClaudeCapabilities, CodexCapabilities, CursorCapabilities,
GrokCapabilities, OpenCodeCapabilities, PiCapabilities, BackendExtensionSpec, BackendTypeSpec, BuiltinBackendSpecs, BackendId,
FixedCapabilities, ConfigOf, CapabilitiesOf, ExtensionsOf, ExtraEventOf, AgentInstructions, AgentLaunchContext, AgentMessage,
diff --git a/src/daemon/agent-driver/src/registry.test.ts b/src/daemon/agent-driver/src/registry.test.ts
index b6ca98651..1f3d3000e 100644
--- a/src/daemon/agent-driver/src/registry.test.ts
+++ b/src/daemon/agent-driver/src/registry.test.ts
@@ -13,6 +13,7 @@ import { ADAPTER_AUTHOR_CONTRACT_VERSION } from "./adapter-author.js";
* without updating `capabilities`) trips CI.
*/
const EXPECTED: Record<BuiltinBackendId, BackendCapabilities> = {
+ agy: { modelSelection: "launchable", providerConfiguration: false, reasoningEffort: true, fastMode: false, disallowedTools: false, commandOverride: true, resume: "by_id", sessionLifetime: "persistent", midTurnDelivery: "next_turn_queue", interrupt: false },
antigravity: { modelSelection: "launchable", providerConfiguration: false, reasoningEffort: true, fastMode: false, disallowedTools: false, commandOverride: true, resume: "by_id", sessionLifetime: "persistent", midTurnDelivery: "next_turn_queue", interrupt: true },
claude: { modelSelection: "launchable", providerConfiguration: true, reasoningEffort: true, fastMode: true, disallowedTools: true, commandOverride: true, resume: "by_id", sessionLifetime: "persistent", midTurnDelivery: "safe_boundary_queue", interrupt: true },
codex: { modelSelection: "launchable", providerConfiguration: false, reasoningEffort: true, fastMode: true, disallowedTools: false, commandOverride: true, resume: "by_id", sessionLifetime: "persistent", midTurnDelivery: "safe_boundary_queue", interrupt: true },
@@ -31,6 +32,7 @@ describe("driver.capabilities", () => {
expect(ADAPTER_AUTHOR_CONTRACT_VERSION).toBe(1);
const registry = createBuiltinAgentDriverRegistry();
const expected = {
+ agy: { lifetime: "session", transport: { kind: "stdio_stream", protocol: "agy.stream-json.v1" }, wakeStart: "immediate", terminalOwnership: "vendor_message" },
antigravity: { lifetime: "session", transport: { kind: "stdio_rpc", protocol: "antigravity.acp.v1" }, wakeStart: "immediate", terminalOwnership: "transport_request" },
claude: {
lifetime: "session",
diff --git a/src/daemon/agent-driver/src/registry.ts b/src/daemon/agent-driver/src/registry.ts
index 63e821277..59a888b52 100644
--- a/src/daemon/agent-driver/src/registry.ts
+++ b/src/daemon/agent-driver/src/registry.ts
@@ -6,6 +6,7 @@ import type {
CapabilitiesOf,
ConfigOf,
} from "./contract.js";
+import { AgyDriver } from "./adapters/agy/index.js";
import { AntigravityDriver } from "./adapters/antigravity/index.js";
import { ClaudeDriver } from "./adapters/claude/index.js";
import { CodexDriver } from "./adapters/codex/index.js";
@@ -184,9 +185,13 @@ export function assertAdapterCompatibility(
}
}
-export const BUILTIN_BACKEND_IDS = ["claude", "codex", "cursor", "grok", "opencode", "pi", "antigravity"] as const;
+export const BUILTIN_BACKEND_IDS = ["claude", "codex", "cursor", "grok", "opencode", "pi", "antigravity", "agy"] as const;
const capabilities = {
+ agy: {
+ modelSelection: "launchable", providerConfiguration: false, reasoningEffort: true, fastMode: false,
+ disallowedTools: false, commandOverride: true, resume: "by_id", sessionLifetime: "persistent", midTurnDelivery: "next_turn_queue", interrupt: false,
+ },
antigravity: {
modelSelection: "launchable", providerConfiguration: false, reasoningEffort: true, fastMode: false,
disallowedTools: false, commandOverride: true, resume: "by_id", sessionLifetime: "persistent", midTurnDelivery: "next_turn_queue", interrupt: true,
@@ -226,6 +231,7 @@ export function createBuiltinAgentDriverRegistry(): AgentDriverRegistry<BuiltinB
{ id: "opencode", contractVersion: 1, capabilities: capabilities.opencode, createAdapter: () => new OpenCodeDriver() },
{ id: "pi", contractVersion: 1, capabilities: capabilities.pi, createAdapter: () => new PiDriver() },
{ id: "antigravity", contractVersion: 1, capabilities: capabilities.antigravity, createAdapter: () => new AntigravityDriver() },
+ { id: "agy", contractVersion: 1, capabilities: capabilities.agy, createAdapter: () => new AgyDriver() },
]);
}
diff --git a/src/daemon/agent-driver/src/sdk.test.ts b/src/daemon/agent-driver/src/sdk.test.ts
index e660a0d0e..c6a92a52c 100644
--- a/src/daemon/agent-driver/src/sdk.test.ts
+++ b/src/daemon/agent-driver/src/sdk.test.ts
@@ -58,7 +58,7 @@ function sdkTestLane(receipt = "fresh-receipt") {
describe("createAgentDriverSdk", () => {
it("exposes the built-ins with default options", () => {
- expect(createAgentDriverSdk().backendIds).toEqual(["claude", "codex", "cursor", "grok", "opencode", "pi", "antigravity"]);
+ expect(createAgentDriverSdk().backendIds).toEqual(["claude", "codex", "cursor", "grok", "opencode", "pi", "antigravity", "agy"]);
expect(SESSION_FILE_DISCOVERY_CAPABILITIES).toEqual(["supported", "unavailable"]);
});
@@ -112,7 +112,7 @@ describe("createAgentDriverSdk", () => {
});
it("public SDK factory delegates to the built-in logical SDK", () => {
- expect(createPublicAgentDriverSdk().backendIds).toEqual(["claude", "codex", "cursor", "grok", "opencode", "pi", "antigravity"]);
+ expect(createPublicAgentDriverSdk().backendIds).toEqual(["claude", "codex", "cursor", "grok", "opencode", "pi", "antigravity", "agy"]);
});
it.each(["claude", "codex", "cursor", "grok", "opencode", "pi"] as const)(
diff --git a/src/daemon/agent-driver/src/testing/builtin-adapter-conformance.test.ts b/src/daemon/agent-driver/src/testing/builtin-adapter-conformance.test.ts
index aee5762fd..79e729ef9 100644
--- a/src/daemon/agent-driver/src/testing/builtin-adapter-conformance.test.ts
+++ b/src/daemon/agent-driver/src/testing/builtin-adapter-conformance.test.ts
@@ -3,6 +3,7 @@ import type { AdapterEvent } from "../internal/adapter.js";
import { createBuiltinAgentDriverRegistry } from "../registry.js";
import { mapPiSdkEvent } from "../adapters/pi/index.js";
import { runAgentBackendAdapterConformance } from "./conformance.js";
+import { AgyDriver } from "../adapters/agy/index.js";
const line = (value: unknown): string => JSON.stringify(value);
@@ -14,6 +15,7 @@ describe("builtin adapter protocol conformance", () => {
claude: ["session", "stdio_stream", "claude.stream-json.v1", "safe_boundary_queue", "vendor_message"],
codex: ["session", "stdio_rpc", "codex.app-server.v1", "safe_boundary_queue", "transport_request"],
cursor: ["session", "stdio_rpc", "cursor.acp.v1", "steer", "transport_request"],
+ agy: ["session", "stdio_stream", "agy.stream-json.v1", "next_turn_queue", "vendor_message"],
antigravity: ["session", "stdio_rpc", "antigravity.acp.v1", "next_turn_queue", "transport_request"],
grok: ["session", "stdio_rpc", "grok.acp.v1", "safe_boundary_queue", "transport_request"],
opencode: ["session", "http_sse", "opencode.v2.service", "steer", "transport_request"],
@@ -65,6 +67,24 @@ describe("builtin adapter protocol conformance", () => {
expect(events.at(-1)).toMatchObject({ kind: "turn_end", sessionId: "claude-root", turnOwner: expect.stringMatching(/^claude:/) });
});
+ it("runs the agy adapter through the shared root, tool, text and terminal contract", () => {
+ runAgentBackendAdapterConformance(registry.get("agy"), {
+ exercise(adapter) {
+ (adapter as AgyDriver).encodeMessage("prompt");
+ const update = (index: number, extra: object) => line({ event: "step_update", step_update: { conversation_id: "root", step_index: index, ...extra } });
+ return [
+ ...adapter.normalizeLine(line({ event: "init", conversation_id: "root" })),
+ ...adapter.normalizeLine(update(0, { step_type: "user_input", state: "DONE" })),
+ ...adapter.normalizeLine(update(1, { step_type: "tool", tool_name: "run_command", state: "ACTIVE", tool_info: { parameters: { command: "test" } } })),
+ ...adapter.normalizeLine(update(1, { step_type: "tool", tool_name: "run_command", state: "DONE" })),
+ ...adapter.normalizeLine(update(2, { step_type: "agent_response", state: "DONE", text_delta: "done" })),
+ ...adapter.normalizeLine(line({ event: "result", result: { conversation_id: "root", num_turns: 1, status: "SUCCESS", response: "done" } })),
+ ];
+ },
+ expectedEventKinds: ["session_init", "turn_owner", "tool_call", "tool_output", "assistant_message_delta", "assistant_message_completed", "turn_end"],
+ });
+ });
+
it("runs the real Codex adapter and rejects child completion/output in the shared contract", () => {
const events = runAgentBackendAdapterConformance(registry.get("codex"), {
exercise(adapter) {
diff --git a/src/daemon/agent-driver/src/testing/builtin-session-conformance.test.ts b/src/daemon/agent-driver/src/testing/builtin-session-conformance.test.ts
index 230c0c87d..2f1b7cdef 100644
--- a/src/daemon/agent-driver/src/testing/builtin-session-conformance.test.ts
+++ b/src/daemon/agent-driver/src/testing/builtin-session-conformance.test.ts
@@ -27,6 +27,7 @@ import { ClaudeDriver } from "../adapters/claude/index.js";
import { CodexDriver } from "../adapters/codex/index.js";
import { CursorDriver } from "../adapters/cursor/index.js";
import { AntigravityAcpLane } from "../adapters/antigravity/acp-lane.js";
+import { AgyDriver } from "../adapters/agy/index.js";
import { AntigravityDriver } from "../adapters/antigravity/index.js";
import { GrokDriver } from "../adapters/grok/index.js";
import { CursorAcpLane } from "../adapters/cursor/acp-lane.js";
@@ -43,6 +44,7 @@ const configs: { [Id in BuiltinBackendId]: ConfigOf<BuiltinBackendSpecs, Id> } =
claude: { model: { kind: "default" }, provider: { kind: "default" }, mode: "default" },
codex: { model: { kind: "default" }, mode: "default" },
cursor: { model: { kind: "default" } },
+ agy: { model: { kind: "default" } },
antigravity: { model: { kind: "default" } },
grok: { model: { kind: "default" } },
opencode: { model: { kind: "default" } },
@@ -171,7 +173,7 @@ function installVendorHarness(backend: BuiltinBackendId): VendorHarness {
return lane;
});
} else {
- const classes = { claude: ClaudeDriver, codex: CodexDriver, cursor: CursorDriver, grok: GrokDriver, antigravity: AntigravityDriver };
+ const classes = { agy: AgyDriver, claude: ClaudeDriver, codex: CodexDriver, cursor: CursorDriver, grok: GrokDriver, antigravity: AntigravityDriver };
if (backend === "claude") {
const beginTurn = ClaudeDriver.prototype.beginTurn;
vi.spyOn(ClaudeDriver.prototype, "beginTurn").mockImplementation(function (this: ClaudeDriver) {
@@ -193,7 +195,7 @@ function installVendorHarness(backend: BuiltinBackendId): VendorHarness {
return encoded;
});
}
- vi.spyOn(classes[backend].prototype, "spawn").mockImplementation(async (ctx) => {
+ vi.spyOn(classes[backend].prototype, "spawn").mockImplementation(async (ctx: AdapterLaunchContext) => {
contexts.push(ctx as AdapterLaunchContext);
const process = fakeProcess();
let stdinBuffer = "";
diff --git a/src/daemon/src/daemon/createDaemon.test.ts b/src/daemon/src/daemon/createDaemon.test.ts
index 8a1c29f4e..1b1cb9470 100644
--- a/src/daemon/src/daemon/createDaemon.test.ts
+++ b/src/daemon/src/daemon/createDaemon.test.ts
@@ -653,7 +653,7 @@ describe("createDaemon", () => {
}
});
- it("uploads persisted Pi token usage when the bot becomes idle", async () => {
+ it.each(["pi", "agy"] as const)("uploads persisted %s token usage when the bot becomes idle", async (backendId) => {
const sockets: FakeSocket[] = [];
const sessions: DaemonFakeSession[] = [];
const workingDirectoryBase = mkdtempSync(join(tmpdir(), "daemon-pi-telemetry-"));
@@ -672,8 +672,8 @@ describe("createDaemon", () => {
serverUrl: "http://server.invalid",
serverWsUrl: "ws://x",
webSocketFactory: factory(sockets) as never,
- runtimeReport: [{ id: "pi" }],
- driverFor: () => fullFakeDriver("pi"),
+ runtimeReport: [{ id: backendId }],
+ driverFor: () => fullFakeDriver(backendId),
sessionFactory: () => {
const session = daemonFakeSession();
sessions.push(session);
@@ -688,7 +688,7 @@ describe("createDaemon", () => {
sockets[0]!.emit("message", JSON.stringify({
type: "agent:wake",
agentId: "bot_1",
- config: { version: 1, runtime: "pi", model: { kind: "default" }, mode: { kind: "default" } },
+ config: { version: 1, runtime: backendId, model: { kind: "default" }, mode: { kind: "default" } },
launchId: "launch_pi",
unreadNotice: { kind: "unread_notice", channel: "/demo#1234/general", latestSeq: 1 },
}));
@@ -696,13 +696,15 @@ describe("createDaemon", () => {
await sessions[0]!.fire("agent_event", {
type: "token_usage",
turnId: "daemon-test-turn",
- source: "pi_message_end",
+ source: `${backendId}_step_usage`,
+ ...(backendId === "agy" ? { identity: { source: "agy:native", index: 2, occurredAt: new Date().toISOString() } } : {}),
usage: {
input: 13,
output: 5,
cache: 7,
},
});
+ if (backendId === "agy") await sessions[0]!.fire("agent_event", { type: "token_usage", source: "replay", usage: { input: 13, output: 5, cache: 7 }, identity: { source: "agy:native", index: 2, occurredAt: new Date().toISOString() } });
await sessions[0]!.fire("runtime_event", { kind: "turn_end", sessionId: "test-session" });
const frames = () => sockets[0]!.sent.map((frame) => JSON.parse(frame) as any);
@@ -716,6 +718,7 @@ describe("createDaemon", () => {
&& frame.dailyUsage?.[0]?.metrics.output === 5
&& frame.dailyUsage?.[0]?.metrics.cache === 7
)).toBe(true));
+ expect(frames().filter((frame) => frame.type === "agent_activity" && frame.state === "idle").at(-1)?.quota).toBeUndefined();
expect(JSON.parse(readFileSync(
join(workingDirectoryBase, ".telemetry", "daily-token-usage.json"),
"utf8",
diff --git a/src/daemon/src/daemon/createDaemon.ts b/src/daemon/src/daemon/createDaemon.ts
index 32289a586..ca329e091 100644
--- a/src/daemon/src/daemon/createDaemon.ts
+++ b/src/daemon/src/daemon/createDaemon.ts
@@ -70,7 +70,7 @@ const RUNTIME_RAW_TRACE_MAX_BYTES = 8 * 1024 * 1024;
export const RUNTIME_RAW_TRACE_AGENT_IDS_ENV = "ALOOK_RUNTIME_RAW_TRACE_AGENT_IDS";
/** How often the daemon rewrites the `daemon status` snapshot file (batch E2). */
const STATUS_WRITE_INTERVAL_MS = 5_000;
-const TOKEN_USAGE_BACKENDS = new Set<BuiltinBackendId>(["claude", "codex", "grok", "opencode", "pi", "antigravity"]);
+const TOKEN_USAGE_BACKENDS = new Set<BuiltinBackendId>(["claude", "codex", "grok", "opencode", "pi", "antigravity", "agy"]);
export function parseRuntimeRawTraceAgentIds(value: string | undefined): ReadonlySet<string> {
return new Set(
diff --git a/src/daemon/src/discovery.test.ts b/src/daemon/src/discovery.test.ts
index d4f295e45..db0a1a4b2 100644
--- a/src/daemon/src/discovery.test.ts
+++ b/src/daemon/src/discovery.test.ts
@@ -12,7 +12,7 @@ import {
} from "./discovery";
import * as drivers from "./drivers/index";
-const EXPECTED_RUNTIMES = ["claude", "codex", "cursor", "grok", "opencode", "pi", "antigravity"];
+const EXPECTED_RUNTIMES = ["claude", "codex", "cursor", "grok", "opencode", "pi", "antigravity", "agy"];
const tmpDirs: string[] = [];
function mkTmp(): string {
diff --git a/src/web/src/app/api/community/bots/route.test.ts b/src/web/src/app/api/community/bots/route.test.ts
index 7491fea9c..5c208a6fa 100644
--- a/src/web/src/app/api/community/bots/route.test.ts
+++ b/src/web/src/app/api/community/bots/route.test.ts
@@ -138,6 +138,14 @@ describe("POST /api/community/bots — model", () => {
)
})
+ it("creates the separately reported agy backend with its own default model", async () => {
+ mockGetMachineForOwner.mockResolvedValue({ id: "mac1", availableRuntimes: [{ id: "agy", status: "healthy" }] })
+ const res = await POST(postReq(base(undefined, "agy")), ctx)
+ expect(res.status).toBe(201)
+ expect(mockCreateBot).toHaveBeenCalledWith(expect.anything(), expect.objectContaining({ runtime: "agy", modelName: null }))
+ expect((await res.json()).bot.runtime).toBe("agy")
+ })
+
it("omitting model leaves modelName null", async () => {
const res = await POST(postReq(base()), ctx)
expect(res.status).toBe(201)
@@ -361,6 +369,7 @@ describe("GET /api/community/bots — heatmap activity", () => {
{ id: "bot_codex", runtime: "codex" },
{ id: "bot_cursor", runtime: "cursor" },
{ id: "bot_antigravity", runtime: "antigravity" },
+ { id: "bot_agy", runtime: "agy" },
{ id: "bot_grok", runtime: "grok" },
{ id: "bot_opencode", runtime: "opencode" },
{ id: "bot_pi", runtime: "pi" },
@@ -404,6 +413,7 @@ describe("GET /api/community/bots — heatmap activity", () => {
bot_codex: "supported",
bot_cursor: "unsupported",
bot_antigravity: "supported",
+ bot_agy: "supported",
bot_grok: "supported",
bot_opencode: "supported",
bot_pi: "supported",
diff --git a/src/web/src/app/api/community/bots/route.ts b/src/web/src/app/api/community/bots/route.ts
index 7140d900f..3125d0a87 100644
--- a/src/web/src/app/api/community/bots/route.ts
+++ b/src/web/src/app/api/community/bots/route.ts
@@ -60,7 +60,7 @@ export const GET = withAuth(async (_req, ctx) => {
image: canonicalUserImage(bot.id, bot.image, bot.avatarVersion),
dailyActivity: activityByBot.get(bot.id) ?? [],
usage: {
- capability: (["claude", "codex", "grok", "opencode", "pi", "antigravity"] as string[]).includes(bot.runtime)
+ capability: (["claude", "codex", "grok", "opencode", "pi", "antigravity", "agy"] as string[]).includes(bot.runtime)
? "supported" as const
: ["cursor"].includes(bot.runtime)
? "unsupported" as const
diff --git a/src/web/src/app/api/community/machines/route.test.ts b/src/web/src/app/api/community/machines/route.test.ts
index 859f3ae78..c623b3e36 100644
--- a/src/web/src/app/api/community/machines/route.test.ts
+++ b/src/web/src/app/api/community/machines/route.test.ts
@@ -76,6 +76,16 @@ describe("GET /api/community/machines — provider quota", () => {
expect(JSON.stringify(body)).not.toContain("retryable")
})
+ it("keeps CLI quota unsupported and the existing ACP quota separate", async () => {
+ mockListMachinesForUser.mockResolvedValue([{ id: "machine", status: "online", availableRuntimes: [{ id: "agy", status: "healthy" }, { id: "antigravity", status: "healthy" }] }])
+ mockListMachineBackendQuotasForUser.mockResolvedValue(new Map())
+ const response = await GET(new NextRequest("http://localhost/api/community/machines"))
+ const body = await response.json()
+ expect(body.machines[0].quota.map((entry: any) => ({ backend: entry.scope.agentBackendId, capability: entry.capability }))).toEqual([
+ { backend: "agy", capability: "unsupported" }, { backend: "antigravity", capability: "supported" },
+ ])
+ })
+
it("keeps same-runtime catalogs isolated between machine rows", async () => {
const runtime = (modelId: string) => ({
id: "codex",
diff --git a/src/web/src/app/api/community/machines/route.ts b/src/web/src/app/api/community/machines/route.ts
index 222e37492..98ec8f208 100644
--- a/src/web/src/app/api/community/machines/route.ts
+++ b/src/web/src/app/api/community/machines/route.ts
@@ -24,7 +24,7 @@ export const GET = withAuth(async (_req, ctx) => {
const quota = machine.availableRuntimes.map((runtime) => {
const capability = runtime.id === "claude" || runtime.id === "codex" || runtime.id === "grok" || runtime.id === "antigravity"
? "supported" as const
- : runtime.id === "cursor" || runtime.id === "opencode" || runtime.id === "pi"
+ : runtime.id === "cursor" || runtime.id === "opencode" || runtime.id === "pi" || runtime.id === "agy"
? "unsupported" as const
: "unknown" as const
const runtimeState = machine.status === "offline"
diff --git a/src/web/src/components/community/bots/bot-list-machine-group.tsx b/src/web/src/components/community/bots/bot-list-machine-group.tsx
index 1e695827d..675499da8 100644
--- a/src/web/src/components/community/bots/bot-list-machine-group.tsx
+++ b/src/web/src/components/community/bots/bot-list-machine-group.tsx
@@ -12,6 +12,7 @@ import {
} from "@/components/ui/dropdown-menu"
import { formatAwakeDuration } from "@/lib/community/format-time"
import { tid } from "@/lib/community/testids"
+import { runtimeLabel } from "@/lib/community/runtime-label"
import { MachineQuotaSummary } from "./bot-quota-summary"
import { BotTokenUsageHeatmap } from "./bot-token-usage-chart"
import type { BotListController, BotMachineGroup } from "./bot-list-types"
@@ -132,7 +133,7 @@ export function renderBotMachineGroup(
<span className="flex flex-wrap items-center gap-x-1.5 gap-y-0.5 text-xs text-muted-foreground">
<span className="flex items-center gap-1.5">
<ProviderLogo provider={bot.runtime} className="size-3.5 shrink-0" />
- <span>{bot.runtime}</span>
+ <span>{runtimeLabel(bot.runtime)}</span>
</span>
<span aria-hidden className="shrink-0">·</span>
{formatModelLabel(bot.runtime, bot.modelName) ? (
diff --git a/src/web/src/components/community/bots/bot-runtime-fields.dom.test.ts b/src/web/src/components/community/bots/bot-runtime-fields.dom.test.ts
index 4033ad2fe..c5c2a85e9 100644
--- a/src/web/src/components/community/bots/bot-runtime-fields.dom.test.ts
+++ b/src/web/src/components/community/bots/bot-runtime-fields.dom.test.ts
@@ -81,6 +81,18 @@ describe("BotRuntimeFields", () => {
expect(onModelChange).not.toHaveBeenCalled()
})
+ it("selects the CLI separately from ACP and clears the prior model and effort", () => {
+ const { renderer, onRuntimeChange, onModelChange, onReasoningEffortChange } = renderFields({
+ options: [{ id: "antigravity", unhealthy: false }, { id: "agy", unhealthy: false }],
+ runtime: "antigravity",
+ })
+ fireEvent.click(renderer.getByRole("radio", { name: "Antigravity CLI (agy)" }))
+ expect(onRuntimeChange).toHaveBeenCalledWith("agy")
+ expect(onModelChange).toHaveBeenCalledWith(null)
+ expect(onReasoningEffortChange).toHaveBeenCalledWith(null)
+ expect(renderer.getByRole("radio", { name: "antigravity", exact: true })).toHaveAttribute("value", "antigravity")
+ })
+
it("exposes optional motion targets without changing the form contract", () => {
const { renderer } = renderFields({
motionTargetPrefix: "runtime",
diff --git a/src/web/src/components/community/bots/bot-runtime-fields.tsx b/src/web/src/components/community/bots/bot-runtime-fields.tsx
index 3e9ecddba..cfd91c33b 100644
--- a/src/web/src/components/community/bots/bot-runtime-fields.tsx
+++ b/src/web/src/components/community/bots/bot-runtime-fields.tsx
@@ -3,6 +3,7 @@
import { ProviderLogo } from "@/components/provider-logo"
import { Label } from "@/components/ui/label"
import { cn } from "@/lib/utils"
+import { runtimeLabel } from "@/lib/community/runtime-label"
import { ModelField } from "./model-field"
import { ReasoningEffortField } from "./reasoning-effort-field"
import type {
@@ -103,7 +104,7 @@ export function BotRuntimeFields({
className="accent-primary size-3.5"
/>
<ProviderLogo provider={option.id} className="size-4 shrink-0" />
- <span className="text-sm">{option.id}</span>
+ <span className="text-sm">{runtimeLabel(option.id)}</span>
{option.unhealthy && (
<span className="ml-auto text-xs text-muted-foreground">unavailable</span>
)}
diff --git a/src/web/src/components/community/bots/create-bot-sheet.dom.test.ts b/src/web/src/components/community/bots/create-bot-sheet.dom.test.ts
index 68b95b6c2..ff803b6c0 100644
--- a/src/web/src/components/community/bots/create-bot-sheet.dom.test.ts
+++ b/src/web/src/components/community/bots/create-bot-sheet.dom.test.ts
@@ -408,9 +408,9 @@ describe("CreateBotSheet — auto-select defaults", () => {
}))
})
- it("creates Antigravity Default without inventing a catalog or effort override", async () => {
+ it.each(["antigravity", "agy"])("creates %s Default without inventing a catalog or effort override", async (runtime) => {
useMachinesMock.mockReturnValue({ machines: [machine({
- id: "mac", availableRuntimes: [{ id: "antigravity", status: "healthy" }],
+ id: "mac", availableRuntimes: [{ id: runtime, status: "healthy" }],
})] })
const renderer = render()
await act(async () => {
@@ -418,7 +418,7 @@ describe("CreateBotSheet — auto-select defaults", () => {
await Promise.resolve()
})
expect(createMutateAsync).toHaveBeenCalledWith(expect.objectContaining({
- machineId: "mac", runtime: "antigravity", model: null, reasoningEffort: null,
+ machineId: "mac", runtime, model: null, reasoningEffort: null,
}))
})
diff --git a/src/web/src/components/community/bots/create-bot-sheet.tsx b/src/web/src/components/community/bots/create-bot-sheet.tsx
index b4eee7e99..c0d5bc49f 100644
--- a/src/web/src/components/community/bots/create-bot-sheet.tsx
+++ b/src/web/src/components/community/bots/create-bot-sheet.tsx
@@ -16,6 +16,7 @@ import {
type ReasoningEffort,
} from "@alook/shared"
import { machineName } from "@/lib/community/machine-name"
+import { runtimeLabel } from "@/lib/community/runtime-label"
import { CommunitySheet } from "@/components/community/shell/community-sheet"
import { Button } from "@/components/ui/button"
import { Label } from "@/components/ui/label"
@@ -260,7 +261,7 @@ export function CreateBotSheet({
<ProviderLogo provider={runtime} className="size-5 shrink-0" />
<div className="min-w-0 flex-1">
<p className="truncate text-sm font-medium">Ready on {selectedMachine ? machineName(selectedMachine) : "your machine"}</p>
- <p className="text-xs text-muted-foreground">{runtime} · Default model</p>
+ <p className="text-xs text-muted-foreground">{runtimeLabel(runtime)} · Default model</p>
</div>
<Button variant="ghost" size="sm" onClick={() => setTechnicalExpanded(true)}>Change</Button>
</div>
diff --git a/src/web/src/components/community/bots/edit-bot-sheet.dom.test.ts b/src/web/src/components/community/bots/edit-bot-sheet.dom.test.ts
index 59029566e..8124c49c3 100644
--- a/src/web/src/components/community/bots/edit-bot-sheet.dom.test.ts
+++ b/src/web/src/components/community/bots/edit-bot-sheet.dom.test.ts
@@ -414,10 +414,13 @@ describe("EditBotSheet — provider switch AlertDialog + toast", () => {
expect(toastSuccess).not.toHaveBeenCalled()
})
- it("confirm → PATCH with runtime + cleared model, then dispatched toast", async () => {
- updateMutateAsync.mockResolvedValue({ bot: { ...BOT, runtime: "codex", modelName: null } })
+ it.each(["codex", "agy"])("confirm → PATCH with %s + cleared model, then dispatched toast", async (runtime) => {
+ useMachinesMock.mockReturnValue({ machines: [{
+ id: "mac1", availableRuntimes: [{ id: "claude", status: "healthy" }, { id: runtime, status: "healthy" }],
+ }] })
+ updateMutateAsync.mockResolvedValue({ bot: { ...BOT, runtime, modelName: null } })
const renderer = renderSheet({ ...BOT, modelName: "claude-sonnet-4-6" })
- pickRuntime(renderer, "codex")
+ pickRuntime(renderer, runtime)
act(() => {
fireEvent.click(saveButton(renderer))
})
@@ -426,11 +429,11 @@ describe("EditBotSheet — provider switch AlertDialog + toast", () => {
expect(updateMutateAsync).toHaveBeenCalledWith(
expect.objectContaining({
id: "b1",
- runtime: "codex",
+ runtime,
model: null,
}),
)
- expect(toastSuccess).toHaveBeenCalledWith("Provider switch to codex dispatched")
+ expect(toastSuccess).toHaveBeenCalledWith(`Provider switch to ${runtime === "agy" ? "Antigravity CLI (agy)" : runtime} dispatched`)
expect(toastSuccess.mock.calls.join(" ")).not.toMatch(/offline|next wake|applies when/i)
})
diff --git a/src/web/src/components/community/bots/edit-bot-sheet.tsx b/src/web/src/components/community/bots/edit-bot-sheet.tsx
index c140109e8..ea6a41294 100644
--- a/src/web/src/components/community/bots/edit-bot-sheet.tsx
+++ b/src/web/src/components/community/bots/edit-bot-sheet.tsx
@@ -4,6 +4,7 @@ import { createStore, useAtom, useCreateAtom } from "@tanstack/react-store";
import { useQueryClient } from "@tanstack/react-query"
import { communityKeys } from "@/lib/query-keys"
import { isAbortError } from "@/lib/errors"
+import { runtimeLabel } from "@/lib/community/runtime-label"
import { useEffect, useMemo } from "react"
import { useCommunityViewSource } from "@/hooks/community/use-community-view-source"
@@ -158,7 +159,7 @@ const [avatarDraft, setAvatarDraft] = useAtom(useCreateAtom<AvatarDraft>(((): Av
if ((runtimeChanged || modelChanged) && result.application === "saved_not_applied") {
toast.success("Runtime settings saved for next start.")
} else if (runtimeChanged) {
- toast.success(`Provider switch to ${runtime} dispatched`)
+ toast.success(`Provider switch to ${runtimeLabel(runtime)} dispatched`)
} else if (modelChanged) {
const label = model ?? "the runtime default"
toast.success(`Model switch to ${label} dispatched`)
@@ -245,7 +246,7 @@ const [avatarDraft, setAvatarDraft] = useAtom(useCreateAtom<AvatarDraft>(((): Av
<AlertDialogHeader>
<AlertDialogTitle>Switch provider and reset this session?</AlertDialogTitle>
<AlertDialogDescription>
- Switching from {bot?.runtime} to {runtime} starts a fresh session. The bot cannot resume its current provider session.
+ Switching from {runtimeLabel(bot?.runtime ?? "")} to {runtimeLabel(runtime)} starts a fresh session. The bot cannot resume its current provider session.
</AlertDialogDescription>
</AlertDialogHeader>
<AlertDialogFooter>
diff --git a/src/web/src/components/community/bots/model-field.tsx b/src/web/src/components/community/bots/model-field.tsx
index 38a3075b8..85178e0ab 100644
--- a/src/web/src/components/community/bots/model-field.tsx
+++ b/src/web/src/components/community/bots/model-field.tsx
@@ -19,6 +19,7 @@ import {
SelectSeparator,
} from "@/components/ui/select"
import { BotSelectMenuContent, BotSelectMenuItem } from "./bot-select-menu"
+import { runtimeLabel } from "@/lib/community/runtime-label"
/**
* The picker keeps its OWN Select/custom-text state rather than deriving purely
@@ -70,7 +71,7 @@ export function ModelField({
}, [seed, runtime, value, localChange, setCustomName, setFilterQuery, setSelectValue])
const isCustom = selectValue === MODEL_SELECT_CUSTOM
- const defaultLabel = runtime ? `Default (${runtime.id}'s own default)` : "Default"
+ const defaultLabel = runtime ? `Default (${runtimeLabel(runtime.id)}'s own default)` : "Default"
const placeholder = required ? "Select a model" : defaultLabel
const normalizedFilter = filterQuery.trim().toLowerCase()
const filteredModels = normalizedFilter
diff --git a/src/web/src/components/community/machines/machine-runtimes.tsx b/src/web/src/components/community/machines/machine-runtimes.tsx
index 8e1e7e5f0..e9c477739 100644
--- a/src/web/src/components/community/machines/machine-runtimes.tsx
+++ b/src/web/src/components/community/machines/machine-runtimes.tsx
@@ -5,6 +5,7 @@ import { CircleAlert } from "lucide-react"
import { ProviderLogo } from "@/components/provider-logo"
import { Tooltip, TooltipTrigger, TooltipContent } from "@/components/ui/tooltip"
import { cn } from "@/lib/utils"
+import { runtimeLabel } from "@/lib/community/runtime-label"
const chipBase =
"inline-flex max-w-[160px] items-center gap-2 rounded-md border border-border bg-card px-2 py-1 text-[11px]"
@@ -46,7 +47,7 @@ function RuntimeChip({ runtime }: { runtime: CommunityMachineRuntime }) {
) : (
<ProviderLogo provider={runtime.id} className="size-3.5 shrink-0" />
)}
- <span className="truncate font-medium text-foreground">{runtime.id}</span>
+ <span className="truncate font-medium text-foreground">{runtimeLabel(runtime.id)}</span>
</>
)
@@ -61,7 +62,7 @@ function RuntimeChip({ runtime }: { runtime: CommunityMachineRuntime }) {
render={
<button
type="button"
- aria-label={unhealthy ? `${runtime.id} unavailable` : `${runtime.id} ${runtime.version}`}
+ aria-label={unhealthy ? `${runtimeLabel(runtime.id)} unavailable` : `${runtimeLabel(runtime.id)} ${runtime.version}`}
className={cn(
chipBase,
unhealthy && "opacity-40 cursor-not-allowed",
diff --git a/src/web/src/components/community/social/profile-card-surface.dom.test.ts b/src/web/src/components/community/social/profile-card-surface.dom.test.ts
index adb09209f..f1e4321c2 100644
--- a/src/web/src/components/community/social/profile-card-surface.dom.test.ts
+++ b/src/web/src/components/community/social/profile-card-surface.dom.test.ts
@@ -63,6 +63,10 @@ vi.mock("@/hooks/community/use-running-owned-bots", () => ({
}),
}))
+vi.mock("@/hooks/community/use-bots", () => ({
+ useBots: () => ({ bots: [{ id: "user_1", runtime: "claude" }] }),
+}))
+
import { ProfileCard } from "./profile-card"
const ownedBotIdentity: Profile["identity"] = {
diff --git a/src/web/src/components/community/social/profile-card.dom.test.ts b/src/web/src/components/community/social/profile-card.dom.test.ts
index f8cefef65..6ab53c958 100644
--- a/src/web/src/components/community/social/profile-card.dom.test.ts
+++ b/src/web/src/components/community/social/profile-card.dom.test.ts
@@ -22,6 +22,12 @@ const mocks = vi.hoisted(() => ({
statusText?: string | null
} | undefined,
interruptAgent: vi.fn(),
+ bots: [{ id: "agent_1", runtime: "claude" }, { id: "user_1", runtime: "claude" }],
+ stop: undefined as (() => void) | undefined,
+}))
+
+vi.mock("@/hooks/community/use-bots", () => ({
+ useBots: () => ({ bots: mocks.bots }),
}))
vi.mock("@/lib/community-db/projections", async (importOriginal) => ({ ...await importOriginal<typeof import("@/lib/community-db/projections")>(),
@@ -49,7 +55,9 @@ vi.mock("./bot-mark-sticker", () => ({
showStop: boolean
stopPending: boolean
onStop: () => void
- }) => createElement(
+ }) => {
+ mocks.stop = onStop
+ return createElement(
"section",
{ "data-testid": "community-bot-mark-sticker" },
showStop
@@ -62,7 +70,8 @@ vi.mock("./bot-mark-sticker", () => ({
: "Stop current agent turn",
}, stopPending ? "Stopping…" : "Stop")
: null,
- ),
+ )
+ },
}))
vi.mock("./profile-running-bots-card", () => ({
@@ -77,6 +86,8 @@ afterEach(() => {
vi.useRealTimers()
mocks.interruptAgent.mockReset()
mocks.profile = undefined
+ mocks.stop = undefined
+ mocks.bots = [{ id: "agent_1", runtime: "claude" }, { id: "user_1", runtime: "claude" }]
})
function renderProfile(
@@ -117,6 +128,7 @@ function renderProfile(
function interactiveProfile(
queryClient: QueryClient,
activityStatus: { emoji: string; text: string },
+ bp: "mobile" | "desktop" = "desktop",
) {
mocks.profile = {
statusEmoji: activityStatus.emoji,
@@ -141,7 +153,7 @@ function interactiveProfile(
},
x: 0,
y: 0,
- bp: "desktop",
+ bp,
onClose: () => undefined,
}),
)
@@ -271,6 +283,41 @@ describe("ProfileCard contextual metadata", () => {
expect(nonowner).not.toContain(">Stop</button>")
})
+ it("keeps an entered message when asynchronous bot ownership arrives", () => {
+ const client = new QueryClient({ defaultOptions: { queries: { retry: false } } })
+ const data: Profile = { name: "Ren", userId: "agent_1" }
+ const card = (identity?: Profile["identity"]) => createElement(CommunityTestProvider, { client }, createElement(ProfileCard, {
+ data: { ...data, identity }, embedded: true, canMessage: true, onMessage: vi.fn(),
+ x: 0, y: 0, bp: "desktop", onClose: vi.fn(),
+ }))
+ const renderer = render(card())
+ fireEvent.change(renderer.getByRole("textbox"), { target: { value: "Keep this draft" } })
+ renderer.rerender(card({ kind: "bot", ownerProfile: { id: "owner_1", handle: "Owner#0042" }, ownedByViewer: true }))
+ expect(renderer.getByRole("textbox")).toHaveValue("Keep this draft")
+ })
+
+ it.each(["desktop", "mobile"] as const)("waits for owner runtime and omits unsupported agy Stop on %s", async (bp) => {
+ const queryClient = new QueryClient({ defaultOptions: { queries: { retry: false } } })
+ const status = { emoji: "⚡", text: "Working on it" }
+ mocks.bots = []
+ const renderer = render(interactiveProfile(queryClient, status, bp))
+ expect(findInterruptButton(renderer.container)).toBeNull()
+ await act(async () => mocks.stop?.())
+ mocks.bots = [{ id: "agent_1", runtime: "agy" }]
+ renderer.rerender(interactiveProfile(queryClient, status, bp))
+ expect(findInterruptButton(renderer.container)).toBeNull()
+ await act(async () => mocks.stop?.())
+ expect(renderer.container.textContent).not.toContain("Stopping…")
+ expect(mocks.interruptAgent).not.toHaveBeenCalled()
+ mocks.bots = [{ id: "agent_1", runtime: "antigravity" }]
+ renderer.rerender(interactiveProfile(queryClient, status, bp))
+ await act(async () => findInterruptButton(renderer.container)?.click())
+ expect(mocks.interruptAgent).toHaveBeenCalledTimes(1)
+ mocks.bots = [{ id: "agent_1", runtime: "agy" }]
+ renderer.rerender(interactiveProfile(queryClient, status, bp))
+ expect(findInterruptButton(renderer.container)).toBeNull()
+ })
+
it("sends once and enters a disabled loading state until exact Idle arrives", async () => {
vi.useFakeTimers()
vi.setSystemTime(new Date("2026-09-01T00:00:00.000Z"))
diff --git a/src/web/src/components/community/social/profile-card.tsx b/src/web/src/components/community/social/profile-card.tsx
index 6a14e4da3..18810405b 100644
--- a/src/web/src/components/community/social/profile-card.tsx
+++ b/src/web/src/components/community/social/profile-card.tsx
@@ -1,7 +1,7 @@
"use client"
import { useAtom, useCreateAtom } from "@tanstack/react-store";
-import { useEffect } from "react"
+import { useEffect, type ComponentProps } from "react"
import { Bot, MessagesSquare, Shield, UserRound } from "lucide-react"
import { BOT_ACTIVITY_PRESETS } from "@alook/shared"
import { Popover, PopoverTrigger, PopoverContent } from "@/components/ui/popover"
@@ -27,6 +27,7 @@ import {
import { BotMarkSticker } from "./bot-mark-sticker"
import { ProfileRunningBotsCard } from "./profile-running-bots-card"
import { useRunningOwnedBots } from "@/hooks/community/use-running-owned-bots"
+import { useBots } from "@/hooks/community/use-bots"
import {
resolveAuditPreviewPlacement,
useProfileSecondaryPosition,
@@ -96,6 +97,15 @@ export function ProfileCard(props: ProfileCardProps) {
return <ProfileCardContent {...props} hasSelfRunningBots={false} />
}
+function OwnedBotMarkSticker(props: ComponentProps<typeof BotMarkSticker>) {
+ const { bots } = useBots()
+ const bot = bots.find((bot) => bot.id === props.botId)
+ const canInterrupt = Boolean(bot && bot.runtime !== "agy")
+ return <BotMarkSticker {...props} showStop={canInterrupt && props.showStop} onStop={() => {
+ if (canInterrupt) props.onStop()
+ }} />
+}
+
function SelfProfileCard(props: ProfileCardProps) {
const { runningBots } = useRunningOwnedBots()
return <ProfileCardContent {...props} hasSelfRunningBots={runningBots.length > 0} />
@@ -341,7 +351,7 @@ function ProfileCardContent({ data, x, y, bp, onClose, onMessage, canMessage = f
onOpenBotAudit={onOpenBotAudit}
/>
) : showOwnedBotCard && data.userId ? (
- <BotMarkSticker
+ <OwnedBotMarkSticker
botId={data.userId}
active={isBotActivityActive(activityStatus.emoji, activityStatus.text)}
showStop={isBotActivityRunning(activityStatus.emoji, activityStatus.text)
diff --git a/src/web/src/components/provider-logo.tsx b/src/web/src/components/provider-logo.tsx
index 734413d09..d107415cb 100644
--- a/src/web/src/components/provider-logo.tsx
+++ b/src/web/src/components/provider-logo.tsx
@@ -192,6 +192,7 @@ export function ProviderLogo({
case "gemini":
return <GeminiLogo className={className} />;
case "antigravity":
+ case "agy":
return <AntigravityLogo className={className} />;
case "kimi":
return <KimiLogo className={className} />;
diff --git a/src/web/src/lib/community/runtime-label.ts b/src/web/src/lib/community/runtime-label.ts
new file mode 100644
index 000000000..e4e66463c
--- /dev/null
+++ b/src/web/src/lib/community/runtime-label.ts
@@ -0,0 +1,3 @@
+export function runtimeLabel(runtime: string): string {
+ return runtime === "agy" ? "Antigravity CLI (agy)" : runtime
+}