ai-task-board-bridge 1.0.0 → 1.1.0

package/README.md

@@ -2,15 +2,18 @@
 
 `ai-task-board-bridge` is the single public npm package for AI Task Board's
 device companions. Its interactive installer asks whether to install Codex
-Bridge, Kimi Bridge, or both. The two runtimes remain separate processes with
-separate Board Connections, tokens, working-directory allowlists, and systemd
-services.
+Bridge, Kimi Bridge, Antigravity Bridge, or a combination. The three runtimes
+remain separate processes with separate Board Connections, tokens,
+working-directory allowlists, and systemd services.
 
 Codex Bridge starts the local `codex app-server` over stdio, discovers
 non-archived top-level Codex threads, maps each thread to a Board Session,
 receives reserved work, and streams supported progress back to the Board. Kimi
 Bridge starts the logged-in Kimi Code ACP server and manages real Kimi Sessions;
-it does not expose Kimi as a fake Codex model.
+it does not expose Kimi as a fake Codex model. Antigravity Bridge drives the
+logged-in Google Antigravity CLI (`agy`) through its official headless
+`stream-json` interface and keeps per-Thread conversation continuity; it never
+reads Google's private conversation databases.
 
 The Bridge uses the Board REST API and authenticated SSE directly. The Board
 MCP server is optional and is not required for Bridge operation.
@@ -21,22 +24,25 @@ Node.js 18 or newer is required. Run setup as the same OS user that owns the
 selected agent login and workspaces:
 
 ```bash
-npx --yes ai-task-board-bridge@1.0.0 setup
+npx --yes ai-task-board-bridge@1.1.0 setup
 ```
 
-The first prompt offers `Codex Bridge`, `Kimi Bridge`, and `both`. Automation or
-repeat installs can bypass that first prompt:
+The first prompt offers `Codex Bridge`, `Kimi Bridge`, `Antigravity Bridge`,
+`both`, and `all`. Automation or repeat installs can bypass that first prompt:
 
 ```bash
-npx --yes ai-task-board-bridge@1.0.0 setup codex
-npx --yes ai-task-board-bridge@1.0.0 setup kimi
-npx --yes ai-task-board-bridge@1.0.0 setup both
+npx --yes ai-task-board-bridge@1.1.0 setup codex
+npx --yes ai-task-board-bridge@1.1.0 setup kimi
+npx --yes ai-task-board-bridge@1.1.0 setup antigravity
+npx --yes ai-task-board-bridge@1.1.0 setup both
+npx --yes ai-task-board-bridge@1.1.0 setup all
 ```
 
-Installing both runs the two setup flows in sequence. Create a separate Board
-Connection with the matching platform for each runtime; a Codex token must not
-be reused for Kimi or vice versa. The public tarball embeds the private Kimi ACP
-runtime, so no second npm package needs to be published or installed.
+Installing a combination runs the selected setup flows in sequence. Create a
+separate Board Connection with the matching platform for each runtime; a token
+for one runtime must not be reused for another. The public tarball embeds the
+private Kimi and Antigravity runtimes, so no second npm package needs to be
+published or installed.
 
 ### Codex setup
 
@@ -75,7 +81,7 @@ install a service:
 AI_TASK_BOARD_URL='https://board.example.com' \
 AI_TASK_BOARD_CONNECTION_TOKEN='atb_REPLACE_ME' \
 CODEX_WORKING_DIRECTORY='/path/to/a/safe/start-directory' \
-npx --yes ai-task-board-bridge@1.0.0 run codex
+npx --yes ai-task-board-bridge@1.1.0 run codex
 ```
 
 > **High-risk foreground defaults:** when these values are omitted, the Bridge uses
@@ -93,7 +99,7 @@ scope with one exact existing-thread compatibility filter:
 
 ```bash
 CODEX_THREAD_ID='REPLACE_WITH_LOCAL_THREAD_ID' \
-npx --yes ai-task-board-bridge@1.0.0
+npx --yes ai-task-board-bridge@1.1.0
 ```
 
 Bridge 0.7 and later can manage several exact working directories in one process:
@@ -101,7 +107,7 @@ Bridge 0.7 and later can manage several exact working directories in one process
 ```bash
 CODEX_WORKING_DIRECTORIES='[{"key":"main","name":"Main App","path":"/srv/main"},{"key":"docs","name":"Docs","path":"/srv/docs"}]' \
 CODEX_THREAD_SCOPE='cwd' \
-npx --yes ai-task-board-bridge@1.0.0
+npx --yes ai-task-board-bridge@1.1.0
 ```
 
 The JSON array accepts 1 to 100 unique `{key,name?,path}` entries. Its first
@@ -266,12 +272,12 @@ strong token-isolation boundary. Use a separate UID and/or a token proxy when
 strong isolation is required. Board schema and `/api/ai/sessions/sync` must be
 upgraded before starting 0.8; there is no 404 fallback to the old registration
 API. On Linux, use `setup` for a pinned local runtime and systemd user service.
-On other platforms, pin version `1.0.0` in launchd or another process manager.
+On other platforms, pin version `1.0.1` in launchd or another process manager.
 Run only one Bridge for the same device/Connection, and
 do not let another TUI, IDE, or automation writer submit turns to a managed
 thread at the same time.
 
-Use `npx --yes ai-task-board-bridge@1.0.0 --help` for the complete
+Use `npx --yes ai-task-board-bridge@1.1.0 --help` for the complete
 environment-variable list.
 
 ## Kimi Bridge
@@ -290,7 +296,7 @@ AI_TASK_BOARD_CONNECTION_TOKEN='atb_REPLACE_ME' \
 KIMI_WORKING_DIRECTORY='/absolute/path/to/project' \
 KIMI_BRIDGE_MODE='auto' \
 KIMI_BRIDGE_APPROVAL_MODE='accept' \
-npx --yes ai-task-board-bridge@1.0.0 run kimi
+npx --yes ai-task-board-bridge@1.1.0 run kimi
 ```
 
 `KIMI_WORKING_DIRECTORIES` accepts 1 to 100 unique exact
@@ -302,3 +308,36 @@ environment, and only final replies plus bounded completion metadata are
 uploaded. Interactive setup defaults to declining extra ACP permissions;
 `KIMI_BRIDGE_MODE=yolo` and `KIMI_BRIDGE_APPROVAL_MODE=accept` are explicit
 high-risk opt-ins.
+
+## Antigravity Bridge
+
+Antigravity Bridge requires Google Antigravity CLI 1.1.8 or newer with an active
+login (`agy update` upgrades; the interactive installer verifies the version) and
+a dedicated Board Connection whose platform is `Antigravity`. Interactive setup
+installs the separate `ai-task-board-antigravity-bridge.service`, stores its
+token in a `0600` environment file, and stages the embedded Antigravity runtime
+under the current user's XDG data directory.
+
+Foreground or non-systemd operation uses the same public npm package:
+
+```bash
+AI_TASK_BOARD_URL='https://board.example.com' \
+AI_TASK_BOARD_CONNECTION_TOKEN='atb_REPLACE_ME' \
+ANTIGRAVITY_WORKING_DIRECTORY='/absolute/path/to/project' \
+ANTIGRAVITY_BRIDGE_MODE='auto' \
+ANTIGRAVITY_BRIDGE_APPROVAL_MODE='accept' \
+npx --yes ai-task-board-bridge@1.1.0 run antigravity
+```
+
+`ANTIGRAVITY_WORKING_DIRECTORIES` accepts 1 to 100 unique exact
+`{key,name?,path}` entries. The Bridge dynamically reports the `agy models`
+catalog with `low`/`medium`/`high` reasoning efforts. Each Web Thread is a
+stable local binding; the first claimed task creates the real agy conversation
+and later turns resume it with `--conversation`. Web creation and deletion are
+supported, rename stays hidden (no public headless rename API), and deleting a
+Thread removes only the Bridge binding so local history is preserved. The Board
+token is removed from the `agy` child environment, and only final replies plus
+bounded completion metadata are uploaded.
+`ANTIGRAVITY_BRIDGE_APPROVAL_MODE=accept` adds
+`--dangerously-skip-permissions` and is a high-risk opt-in;
+`ANTIGRAVITY_BRIDGE_SANDBOX=true` enables agy's terminal sandbox.

package/dist/antigravity-runtime/agy-client.d.ts

@@ -0,0 +1,117 @@
+import type { AntigravityBridgeConfiguration } from "./config.js";
+export declare const ANTIGRAVITY_MINIMUM_VERSION = "1.1.8";
+export declare const AGY_STREAM_PROTOCOL = "agy-stream-json/v1";
+export type InventoryModel = {
+    id: string;
+    model: string;
+    display_name: string;
+    description: string | null;
+    default_reasoning_effort: string | null;
+    supported_reasoning_efforts: Array<{
+        reasoning_effort: string;
+        description: string | null;
+    }>;
+    input_modalities: string[];
+    is_default: boolean;
+};
+export declare const ANTIGRAVITY_FALLBACK_MODEL_CATALOG: readonly InventoryModel[];
+export type AgyUsage = {
+    input_tokens?: number;
+    output_tokens?: number;
+    thinking_tokens?: number;
+    cache_read_tokens?: number;
+    total_tokens?: number;
+};
+export type AgyInitEvent = {
+    conversation_id?: string;
+    cwd?: string;
+    tools?: string[];
+    permission_mode?: string;
+    model?: string;
+    agent?: string;
+};
+export type AgyStepUpdateEvent = {
+    conversation_id?: string;
+    step_index?: number;
+    state?: string;
+    step_type?: string;
+    text_delta?: string;
+    tool_name?: string;
+    duration_seconds?: number;
+    usage?: AgyUsage;
+    tool_info?: {
+        name?: string;
+        error?: unknown;
+    } | null;
+};
+export type AgyResultEvent = {
+    conversation_id?: string;
+    status?: string;
+    response?: string;
+    error?: string;
+    duration_seconds?: number;
+    num_turns?: number;
+    usage?: AgyUsage;
+};
+export type AgyPromptResult = {
+    conversationId: string | null;
+    response: string;
+    status: string;
+    model: string | null;
+    usage: AgyUsage | null;
+    durationSeconds: number | null;
+    numTurns: number | null;
+    toolCallCount: number;
+    failedToolCallCount: number;
+    checkpointCount: number;
+};
+export type AgyPromptOptions = {
+    cwd: string;
+    prompt: string;
+    conversationId?: string | null;
+    model?: string | null;
+    reasoningEffort?: string | null;
+    signal: AbortSignal;
+    onTextDelta?: (text: string) => void;
+    onConversationId?: (conversationId: string) => void;
+};
+export type AgyStreamState = {
+    conversationId: string | null;
+    initModel: string | null;
+    response: string;
+    status: string;
+    usage: AgyUsage | null;
+    durationSeconds: number | null;
+    numTurns: number | null;
+    toolCallCount: number;
+    failedToolCallCount: number;
+    checkpointCount: number;
+    sawResult: boolean;
+};
+export declare function initialAgyStreamState(conversationId: string | null): AgyStreamState;
+/**
+ * Pure NDJSON event reducer for agy's documented stream-json output. Kept
+ * separate from the spawn plumbing so parsing stays unit-testable.
+ */
+export declare function reduceAgyStreamEvent(state: AgyStreamState, event: Record<string, unknown>, hooks?: {
+    onTextDelta?: (text: string) => void;
+    onConversationId?: (conversationId: string) => void;
+}): void;
+type ModelListItem = {
+    id: string;
+    name: string;
+    isDefault?: boolean;
+};
+export declare function parseModelListText(raw: string): ModelListItem[];
+export declare function inventoryModelFromListItem(item: ModelListItem, index: number): InventoryModel;
+export declare class AgyClient {
+    private readonly configuration;
+    private versionValue;
+    constructor(configuration: Pick<AntigravityBridgeConfiguration, "agyBinary" | "agentMode" | "approvalMode" | "sandbox" | "printTimeoutMs">);
+    version(): Promise<string>;
+    ensureSupportedVersion(): Promise<void>;
+    modelCatalog(): Promise<InventoryModel[]>;
+    prompt(options: AgyPromptOptions): Promise<AgyPromptResult>;
+}
+export {};
+//# sourceMappingURL=agy-client.d.ts.map

package/dist/antigravity-runtime/agy-client.d.ts.map

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