@agentproto/adapter-antigravity 0.2.0

package/ANTIGRAVITY.md

@@ -0,0 +1,66 @@
+---
+name: antigravity
+id: antigravity
+description: Google Antigravity's headless CLI (`agy`) as an AIP-45 print/headless agent.
+version: 0.1.0
+bin: agy
+install:
+  - method: curl
+    url: https://antigravity.google/cli/install.sh
+version_check:
+  cmd: agy --version
+  parse: '(\d+\.\d+\.\d+)'
+  range: ">=0.1.0"
+  timeout_ms: 15000
+auth:
+  ref: ./SECRETS.md
+sandbox: ./SANDBOX.md
+protocol: print
+tags: ["antigravity", "agy", "google", "print", "agent-runtime", "coding"]
+---
+
+# Google Antigravity adapter
+
+Wraps Google Antigravity's headless CLI, `agy`, as an AIP-45 agent CLI using
+its documented headless command surface:
+
+```sh
+agy -p "Fix the bug" --output-format stream-json
+```
+
+Antigravity has **no ACP mode** (open feature request
+`google-antigravity/antigravity-cli#31`), so this adapter is intentionally a
+`protocol: print` (headless) arm rather than ACP — the same posture as the
+`mastracode` adapter.
+
+## The event schema is NOT Claude's
+
+`agy`'s headless *flags* look just like Claude Code's (`-p`,
+`--output-format stream-json`, `--continue`), which is a trap. Its *wire
+events* are a different taxonomy — verified against the sample outputs at
+[antigravity.google/docs/cli/headless](https://antigravity.google/docs/cli/headless):
+
+```jsonc
+{"event":"init","conversation_id":"…","init":{"cwd":"…","tools":[…],"permission_mode":"request-review"}}
+{"event":"step_update","step_update":{"conversation_id":"…","step_index":3,"state":"DONE","step_type":"agent_response","text_delta":"…","usage":{…}}}
+{"event":"result","result":{"conversation_id":"…","status":"SUCCESS","response":"…","usage":{…}}}
+```
+
+Each line is discriminated by an `event` field (not Claude's `type`), the
+payload is nested under a matching key, the session id is a nested
+`conversation_id`, and assistant text streams as incremental
+`step_update.text_delta` fragments. Because none of that matches
+`claude-stream-json`, the print arm carries a dedicated
+`event_schema: "antigravity-stream-json"` mapper
+(`packages/driver/agent-cli/src/protocol/print-arm.ts`).
+
+## Auth
+
+Keyring + Google Sign-In only — see [SECRETS.md](./SECRETS.md). You must run
+`agy` interactively once to cache credentials before any headless run.
+
+## Models
+
+No fixed `models.allowed` is declared. `agy models` lists the current slugs
+(Gemini 3.x, Claude, GPT-OSS); pass any of them through the adapter's `model`
+option, which forwards to `agy --model <slug>`.

package/LICENSE

@@ -0,0 +1,202 @@
+
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/dist/index.d.ts

@@ -0,0 +1,54 @@
+import { AgentCliHandle, AgentCliRuntime } from '@agentproto/driver-agent-cli';
+export { AgentCliHandle, AgentCliRuntime } from '@agentproto/driver-agent-cli';
+import { CapabilityStrategy } from '@agentproto/provider-kit';
+
+/**
+ * @agentproto/adapter-antigravity — AIP-45 adapter for Google Antigravity.
+ *
+ * Antigravity ships a headless CLI, `agy`, but NO ACP mode (open feature
+ * request google-antigravity/antigravity-cli#31). So — exactly like the
+ * `mastracode` adapter — this is a `protocol: "print"` (headless) arm, not
+ * an ACP one. We spawn `agy -p "<prompt>" --output-format stream-json` per
+ * turn and map its NDJSON events.
+ *
+ *   import { antigravity, antigravityRuntime } from "@agentproto/adapter-antigravity"
+ *   const session = await antigravityRuntime().start()
+ *   for await (const evt of session.send({ role: "user", content: "..." })) {
+ *     console.log(evt)
+ *   }
+ *   await session.close()
+ *
+ * ## Why a bespoke event schema (`antigravity-stream-json`)
+ *
+ * `agy`'s headless FLAG surface visibly mirrors Claude Code's (`-p`,
+ * `--output-format stream-json`, `--continue`), which is a trap: the WIRE
+ * events do NOT match Claude's `{ type: "system" | "assistant" | "result",
+ * session_id }` taxonomy. Verified against the sample outputs at
+ * antigravity.google/docs/cli/headless, every `agy` stream-json line is:
+ *
+ *   {"event":"init","conversation_id":"…","init":{…}}
+ *   {"event":"step_update","step_update":{conversation_id,step_index,state,
+ *       step_type,text_delta?,tool_name?,tool_info?,…}}
+ *   {"event":"result","result":{conversation_id,status,response,error?,usage}}
+ *
+ * i.e. discriminated by `event` (not `type`), payload nested under a matching
+ * key, session id a nested `conversation_id`, text as incremental
+ * `text_delta` fragments. That is a genuinely different taxonomy, so the
+ * print arm carries a dedicated `event_schema: "antigravity-stream-json"`
+ * mapper (packages/driver/agent-cli/src/protocol/print-arm.ts) rather than
+ * reusing the Claude one.
+ */
+
+declare const antigravity: AgentCliHandle;
+declare function antigravityRuntime(): AgentCliRuntime;
+/**
+ * Antigravity exposes no per-provider api-key store to discover (auth is a
+ * keyring-backed Google login), so there are no providers to enrich — the
+ * capability report stays the manifest projection. The one honest override is
+ * the print arm's application contract: model/posture are baked into the spawn
+ * argv (`--model`, options), applied per fresh subprocess, so a live switch is
+ * `arg`-based and uncoupled — same as the `mastracode` print arm.
+ */
+declare const antigravityCapabilities: CapabilityStrategy;
+
+export { antigravity, antigravityCapabilities, antigravityRuntime };

package/dist/index.mjs

@@ -0,0 +1,157 @@
+import { defineAgentCli, createAgentCliRuntime } from '@agentproto/driver-agent-cli';
+import { deriveDeclaredCapabilities } from '@agentproto/provider-kit';
+
+/**
+ * @agentproto/adapter-antigravity v0.1.0-alpha
+ * AIP-45 adapter for Google Antigravity (`agy`) via its headless CLI mode.
+ */
+
+var antigravity = defineAgentCli({
+  name: "antigravity",
+  id: "antigravity",
+  description: "Google Antigravity's headless CLI (`agy`) \u2014 a multi-model coding agent (Gemini 3.x, Claude, GPT-OSS) run non-interactively via `agy -p --output-format stream-json`. No ACP mode yet (feature request google-antigravity/antigravity-cli#31), so this is a print/headless arm.",
+  version: "0.1.0",
+  bin: "agy",
+  // Not on npm — the only documented install is the official curl installer,
+  // which drops `agy` into ~/.local/bin (antigravity.google/docs/cli/headless).
+  install: [
+    { method: "curl", url: "https://antigravity.google/cli/install.sh" }
+  ],
+  // `agy --version` is the conventional probe; the exact stdout is UNVERIFIED
+  // (the headless flag table doesn't document a --version flag), so the range
+  // is deliberately permissive. Tighten once a real version string is known.
+  version_check: {
+    cmd: "agy --version",
+    parse: "(\\d+\\.\\d+\\.\\d+)",
+    range: ">=0.1.0",
+    timeout_ms: 15e3
+  },
+  // Antigravity authenticates through the OS keyring + a Google Sign-In
+  // browser flow ONLY — there is no documented API-key environment variable.
+  // Headless runs reuse the cached credentials, so the user must have run
+  // `agy` interactively once on this machine; a non-interactive run with no
+  // cached login exits with an "authentication required" error. Nothing to
+  // inject or scrub here — see ./SECRETS.md.
+  auth: {
+    ref: "./SECRETS.md"
+  },
+  sandbox: "./SANDBOX.md",
+  protocol: "print",
+  print: {
+    // `agy -p "<prompt>"` runs a single prompt non-interactively.
+    prompt_flag: "-p",
+    output_format: ["--output-format", "stream-json"],
+    // No Claude-style `--no-interactive`; `-p` already selects headless.
+    pre_prompt: [],
+    // `--conversation <id>` resumes a specific prior run by its
+    // `conversation_id`. (`--continue`/`-c` resumes the *most recent*, but a
+    // value-carrying flag is what the print arm wires from the captured id.)
+    resume: { flag: "--conversation", kind: "value" },
+    // See the file header + print-arm.ts: agy's events are `{event: …}`
+    // envelopes, NOT Claude's `{type: …}` — hence its own mapper.
+    event_schema: "antigravity-stream-json"
+  },
+  session: {
+    // The print arm spawns a fresh `agy` per turn; continuity comes from
+    // `--conversation <id>`, not a long-lived process.
+    mode: "ephemeral",
+    idle_timeout_ms: 18e5,
+    context_carryover: false
+  },
+  // No `models` block by design. The docs' `agy models` output shows real
+  // slugs (e.g. `gemini-3.5-flash-medium`, `claude-sonnet-4-6`), but the list
+  // is version-dependent and only partially documented, and every model is
+  // served through Antigravity's own backend under ONE Google identity — not
+  // a per-provider api-key route the catalog could bill. Declaring a fixed
+  // `models.allowed`/`provider` here would assert routing facts we haven't
+  // verified; the honest surface is the free-form `model` option below, which
+  // forwards any slug from `agy models` straight to `--model`.
+  capabilities: {
+    streaming: true,
+    tool_calls: true,
+    // agy runs subagents (`agy agents`, background tasks); step_updates carry
+    // `subagent_info`. We don't surface each subagent as its own StreamEvent,
+    // but the capability is real.
+    sub_agents: true,
+    file_io: true,
+    // Unverified — declared false rather than overclaiming.
+    multimodal: false,
+    // `agy --conversation <id>` genuinely resumes a prior conversation
+    // (docs: "Resume prior context with --continue … or --conversation with
+    // an ID from a previous run's conversation_id"). `print.resume` drives it.
+    resumable: true,
+    bidirectional: false
+  },
+  options: [
+    {
+      id: "model",
+      type: "string",
+      description: "Model slug for this run (see `agy models`), e.g. `gemini-3.5-flash-medium` or `claude-sonnet-4-6`. Forwarded to `--model`. Headless mode fails loudly on an unknown slug rather than silently falling back.",
+      bin_args_template: ["--model", "{value}"]
+    },
+    {
+      id: "effort",
+      type: "enum",
+      enum: ["low", "medium", "high"],
+      description: "Reasoning effort passed to `agy --effort`.",
+      bin_args_template: ["--effort", "{value}"]
+    },
+    {
+      id: "agent",
+      type: "string",
+      description: "Agent to run this prompt as (see `agy agents`). Forwarded to `--agent`.",
+      bin_args_template: ["--agent", "{value}"]
+    },
+    {
+      id: "print_timeout",
+      type: "string",
+      description: "Maximum time `agy` waits for a response, as a duration string (e.g. `15m`). Forwarded to `--print-timeout` (default 5m).",
+      bin_args_template: ["--print-timeout", "{value}"]
+    },
+    {
+      id: "dangerously_skip_permissions",
+      type: "boolean",
+      description: "Auto-approve EVERY tool call (file writes, command execution) for this run via `--dangerously-skip-permissions`. Off by default; prefer scoped `permissions.allow` rules in agy's settings.json.",
+      bin_args_append_when_true: ["--dangerously-skip-permissions"]
+    },
+    {
+      id: "terminal_sandbox",
+      type: "boolean",
+      description: "Run agy with its terminal sandbox restrictions enabled (`--sandbox`).",
+      bin_args_append_when_true: ["--sandbox"]
+    }
+  ],
+  continuation: {
+    default: "none",
+    supported: ["none", "transcript", "native-resume"]
+  },
+  metadata: {
+    acp: {
+      checked: "2026-08-06",
+      result: "Antigravity has no ACP mode. Tracked upstream as feature request google-antigravity/antigravity-cli#31; until it ships this adapter stays a print/headless arm."
+    },
+    models: {
+      checked: "2026-08-06",
+      result: "`agy models` (per antigravity.google/docs/models + the headless docs) lists slugs like gemini-3.6-flash-high, gemini-3.6-flash-medium, gemini-3.5-flash-medium, gemini-3.1-pro-high, claude-sonnet-4-6 \u2014 plus GPT-OSS variants. The full list is version-dependent and only partially documented, so no fixed `models.allowed` is declared; pass any slug through the `model` option."
+    },
+    auth: {
+      checked: "2026-08-06",
+      result: "OS keyring + Google Sign-In browser flow only; no documented API-key env var. Run `agy` interactively once to cache credentials before any headless run."
+    }
+  },
+  tags: ["antigravity", "agy", "google", "print", "agent-runtime", "coding"]
+});
+function antigravityRuntime() {
+  return createAgentCliRuntime(antigravity);
+}
+var antigravityCapabilities = async (def) => {
+  const base = deriveDeclaredCapabilities(def);
+  return {
+    ...base,
+    application: { modelApply: "arg", postureApply: "arg", coupled: false }
+  };
+};
+
+export { antigravity, antigravityCapabilities, antigravityRuntime };
+//# sourceMappingURL=index.mjs.map
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"names":[],"mappings":"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","file":"index.mjs","sourcesContent":["/**\n * @agentproto/adapter-antigravity — AIP-45 adapter for Google Antigravity.\n *\n * Antigravity ships a headless CLI, `agy`, but NO ACP mode (open feature\n * request google-antigravity/antigravity-cli#31). So — exactly like the\n * `mastracode` adapter — this is a `protocol: \"print\"` (headless) arm, not\n * an ACP one. We spawn `agy -p \"<prompt>\" --output-format stream-json` per\n * turn and map its NDJSON events.\n *\n *   import { antigravity, antigravityRuntime } from \"@agentproto/adapter-antigravity\"\n *   const session = await antigravityRuntime().start()\n *   for await (const evt of session.send({ role: \"user\", content: \"...\" })) {\n *     console.log(evt)\n *   }\n *   await session.close()\n *\n * ## Why a bespoke event schema (`antigravity-stream-json`)\n *\n * `agy`'s headless FLAG surface visibly mirrors Claude Code's (`-p`,\n * `--output-format stream-json`, `--continue`), which is a trap: the WIRE\n * events do NOT match Claude's `{ type: \"system\" | \"assistant\" | \"result\",\n * session_id }` taxonomy. Verified against the sample outputs at\n * antigravity.google/docs/cli/headless, every `agy` stream-json line is:\n *\n *   {\"event\":\"init\",\"conversation_id\":\"…\",\"init\":{…}}\n *   {\"event\":\"step_update\",\"step_update\":{conversation_id,step_index,state,\n *       step_type,text_delta?,tool_name?,tool_info?,…}}\n *   {\"event\":\"result\",\"result\":{conversation_id,status,response,error?,usage}}\n *\n * i.e. discriminated by `event` (not `type`), payload nested under a matching\n * key, session id a nested `conversation_id`, text as incremental\n * `text_delta` fragments. That is a genuinely different taxonomy, so the\n * print arm carries a dedicated `event_schema: \"antigravity-stream-json\"`\n * mapper (packages/driver/agent-cli/src/protocol/print-arm.ts) rather than\n * reusing the Claude one.\n */\n\nimport {\n  createAgentCliRuntime,\n  defineAgentCli,\n  type AgentCliHandle,\n  type AgentCliRuntime,\n} from \"@agentproto/driver-agent-cli\"\nimport {\n  deriveDeclaredCapabilities,\n  type CapabilityStrategy,\n} from \"@agentproto/provider-kit\"\n\nexport const antigravity: AgentCliHandle = defineAgentCli({\n  name: \"antigravity\",\n  id: \"antigravity\",\n  description:\n    \"Google Antigravity's headless CLI (`agy`) — a multi-model coding agent \" +\n    \"(Gemini 3.x, Claude, GPT-OSS) run non-interactively via `agy -p \" +\n    \"--output-format stream-json`. No ACP mode yet (feature request \" +\n    \"google-antigravity/antigravity-cli#31), so this is a print/headless arm.\",\n  version: \"0.1.0\",\n  bin: \"agy\",\n  // Not on npm — the only documented install is the official curl installer,\n  // which drops `agy` into ~/.local/bin (antigravity.google/docs/cli/headless).\n  install: [\n    { method: \"curl\", url: \"https://antigravity.google/cli/install.sh\" },\n  ],\n  // `agy --version` is the conventional probe; the exact stdout is UNVERIFIED\n  // (the headless flag table doesn't document a --version flag), so the range\n  // is deliberately permissive. Tighten once a real version string is known.\n  version_check: {\n    cmd: \"agy --version\",\n    parse: \"(\\\\d+\\\\.\\\\d+\\\\.\\\\d+)\",\n    range: \">=0.1.0\",\n    timeout_ms: 15_000,\n  },\n  // Antigravity authenticates through the OS keyring + a Google Sign-In\n  // browser flow ONLY — there is no documented API-key environment variable.\n  // Headless runs reuse the cached credentials, so the user must have run\n  // `agy` interactively once on this machine; a non-interactive run with no\n  // cached login exits with an \"authentication required\" error. Nothing to\n  // inject or scrub here — see ./SECRETS.md.\n  auth: {\n    ref: \"./SECRETS.md\",\n  },\n  sandbox: \"./SANDBOX.md\",\n  protocol: \"print\",\n  print: {\n    // `agy -p \"<prompt>\"` runs a single prompt non-interactively.\n    prompt_flag: \"-p\",\n    output_format: [\"--output-format\", \"stream-json\"],\n    // No Claude-style `--no-interactive`; `-p` already selects headless.\n    pre_prompt: [],\n    // `--conversation <id>` resumes a specific prior run by its\n    // `conversation_id`. (`--continue`/`-c` resumes the *most recent*, but a\n    // value-carrying flag is what the print arm wires from the captured id.)\n    resume: { flag: \"--conversation\", kind: \"value\" },\n    // See the file header + print-arm.ts: agy's events are `{event: …}`\n    // envelopes, NOT Claude's `{type: …}` — hence its own mapper.\n    event_schema: \"antigravity-stream-json\",\n  },\n  session: {\n    // The print arm spawns a fresh `agy` per turn; continuity comes from\n    // `--conversation <id>`, not a long-lived process.\n    mode: \"ephemeral\",\n    idle_timeout_ms: 1_800_000,\n    context_carryover: false,\n  },\n  // No `models` block by design. The docs' `agy models` output shows real\n  // slugs (e.g. `gemini-3.5-flash-medium`, `claude-sonnet-4-6`), but the list\n  // is version-dependent and only partially documented, and every model is\n  // served through Antigravity's own backend under ONE Google identity — not\n  // a per-provider api-key route the catalog could bill. Declaring a fixed\n  // `models.allowed`/`provider` here would assert routing facts we haven't\n  // verified; the honest surface is the free-form `model` option below, which\n  // forwards any slug from `agy models` straight to `--model`.\n  capabilities: {\n    streaming: true,\n    tool_calls: true,\n    // agy runs subagents (`agy agents`, background tasks); step_updates carry\n    // `subagent_info`. We don't surface each subagent as its own StreamEvent,\n    // but the capability is real.\n    sub_agents: true,\n    file_io: true,\n    // Unverified — declared false rather than overclaiming.\n    multimodal: false,\n    // `agy --conversation <id>` genuinely resumes a prior conversation\n    // (docs: \"Resume prior context with --continue … or --conversation with\n    // an ID from a previous run's conversation_id\"). `print.resume` drives it.\n    resumable: true,\n    bidirectional: false,\n  },\n  options: [\n    {\n      id: \"model\",\n      type: \"string\",\n      description:\n        \"Model slug for this run (see `agy models`), e.g. \" +\n        \"`gemini-3.5-flash-medium` or `claude-sonnet-4-6`. Forwarded to \" +\n        \"`--model`. Headless mode fails loudly on an unknown slug rather than \" +\n        \"silently falling back.\",\n      bin_args_template: [\"--model\", \"{value}\"],\n    },\n    {\n      id: \"effort\",\n      type: \"enum\",\n      enum: [\"low\", \"medium\", \"high\"],\n      description: \"Reasoning effort passed to `agy --effort`.\",\n      bin_args_template: [\"--effort\", \"{value}\"],\n    },\n    {\n      id: \"agent\",\n      type: \"string\",\n      description:\n        \"Agent to run this prompt as (see `agy agents`). Forwarded to `--agent`.\",\n      bin_args_template: [\"--agent\", \"{value}\"],\n    },\n    {\n      id: \"print_timeout\",\n      type: \"string\",\n      description:\n        \"Maximum time `agy` waits for a response, as a duration string \" +\n        \"(e.g. `15m`). Forwarded to `--print-timeout` (default 5m).\",\n      bin_args_template: [\"--print-timeout\", \"{value}\"],\n    },\n    {\n      id: \"dangerously_skip_permissions\",\n      type: \"boolean\",\n      description:\n        \"Auto-approve EVERY tool call (file writes, command execution) for \" +\n        \"this run via `--dangerously-skip-permissions`. Off by default; \" +\n        \"prefer scoped `permissions.allow` rules in agy's settings.json.\",\n      bin_args_append_when_true: [\"--dangerously-skip-permissions\"],\n    },\n    {\n      id: \"terminal_sandbox\",\n      type: \"boolean\",\n      description:\n        \"Run agy with its terminal sandbox restrictions enabled (`--sandbox`).\",\n      bin_args_append_when_true: [\"--sandbox\"],\n    },\n  ],\n  continuation: {\n    default: \"none\",\n    supported: [\"none\", \"transcript\", \"native-resume\"],\n  },\n  metadata: {\n    acp: {\n      checked: \"2026-08-06\",\n      result:\n        \"Antigravity has no ACP mode. Tracked upstream as feature request \" +\n        \"google-antigravity/antigravity-cli#31; until it ships this adapter \" +\n        \"stays a print/headless arm.\",\n    },\n    models: {\n      checked: \"2026-08-06\",\n      result:\n        \"`agy models` (per antigravity.google/docs/models + the headless docs) \" +\n        \"lists slugs like gemini-3.6-flash-high, gemini-3.6-flash-medium, \" +\n        \"gemini-3.5-flash-medium, gemini-3.1-pro-high, claude-sonnet-4-6 — \" +\n        \"plus GPT-OSS variants. The full list is version-dependent and only \" +\n        \"partially documented, so no fixed `models.allowed` is declared; pass \" +\n        \"any slug through the `model` option.\",\n    },\n    auth: {\n      checked: \"2026-08-06\",\n      result:\n        \"OS keyring + Google Sign-In browser flow only; no documented API-key \" +\n        \"env var. Run `agy` interactively once to cache credentials before any \" +\n        \"headless run.\",\n    },\n  },\n  tags: [\"antigravity\", \"agy\", \"google\", \"print\", \"agent-runtime\", \"coding\"],\n})\n\nexport function antigravityRuntime(): AgentCliRuntime {\n  return createAgentCliRuntime(antigravity)\n}\n\n/**\n * Antigravity exposes no per-provider api-key store to discover (auth is a\n * keyring-backed Google login), so there are no providers to enrich — the\n * capability report stays the manifest projection. The one honest override is\n * the print arm's application contract: model/posture are baked into the spawn\n * argv (`--model`, options), applied per fresh subprocess, so a live switch is\n * `arg`-based and uncoupled — same as the `mastracode` print arm.\n */\nexport const antigravityCapabilities: CapabilityStrategy = async (def) => {\n  const base = deriveDeclaredCapabilities(def)\n  return {\n    ...base,\n    application: { modelApply: \"arg\", postureApply: \"arg\", coupled: false },\n  }\n}\n\nexport type { AgentCliHandle, AgentCliRuntime }\n"]}

package/package.json

@@ -0,0 +1,63 @@
+{
+  "name": "@agentproto/adapter-antigravity",
+  "version": "0.2.0",
+  "description": "@agentproto/adapter-antigravity — AIP-45 AGENT-CLI adapter for Google Antigravity's headless CLI (`agy`). Spawns `agy -p --output-format stream-json`; Antigravity has no ACP mode yet (feature request google-antigravity/antigravity-cli#31).",
+  "keywords": [
+    "agentproto",
+    "aip-45",
+    "antigravity",
+    "agy",
+    "google",
+    "print",
+    "agent-cli",
+    "adapter"
+  ],
+  "homepage": "https://agentproto.sh/docs/aip-45",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/agentproto/ts",
+    "directory": "adapters/antigravity"
+  },
+  "license": "Apache-2.0",
+  "type": "module",
+  "main": "dist/index.mjs",
+  "module": "dist/index.mjs",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "default": "./dist/index.mjs"
+    },
+    "./ANTIGRAVITY.md": "./ANTIGRAVITY.md",
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "ANTIGRAVITY.md",
+    "README.md",
+    "LICENSE"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@agentproto/driver-agent-cli": "2.2.0",
+    "@agentproto/provider-kit": "0.4.1"
+  },
+  "devDependencies": {
+    "@types/node": "^25.6.2",
+    "tsup": "^8.5.1",
+    "typescript": "^5.9.3",
+    "vitest": "^3.2.4",
+    "@agentproto/tooling": "0.1.0-alpha.0"
+  },
+  "scripts": {
+    "dev": "tsup --watch",
+    "build": "tsup",
+    "clean": "rm -rf dist",
+    "check-types": "tsc --noEmit",
+    "test": "vitest run --passWithNoTests",
+    "test:watch": "vitest"
+  }
+}