agy-paperclip-adapter 1.0.0

package/README.md

@@ -0,0 +1,43 @@
+# Antigravity Paperclip Adapter (`agy-paperclip-adapter`)
+
+An external adapter plugin for [Paperclip](https://github.com/paperclipai/paperclip) that integrates the Google Antigravity (`agy`) local CLI agent runtime.
+
+## Features
+
+- **Full Model Selection**: Supports all Antigravity models (`gemini-3.8-flash-high`, `gemini-3.7-flash-high`, `gemini-3.6-flash-high`, `gemini-3.1-pro-high`, `claude-sonnet-4-6`, `claude-opus-4-6-thinking`, `gpt-oss-120b-medium`, `auto`).
+- **Adapter Icon**: Includes native SVG branding icon for Paperclip's UI.
+- **Paperclip Skills to AGY Sync**: Automatically materializes skills assigned in Paperclip into `${workspace}/.agents/skills/<skill-name>/SKILL.md` for AGY agent discovery.
+- **Multi-Agent Isolation**: Allows hiring multiple agents with distinct roles, instructions, and skills on a single local `agy` runtime via isolated conversation sessions (`--conversation`) and working directories.
+- **UI Transcript Parser**: Self-contained streaming parser for tool calls, thinking steps, system logs, and assistant markdown output.
+- **Package Import Ready (`npm run pack`)**: Easily build and package into `dist/agy-paperclip-adapter-1.0.0.tgz` for importing via Paperclip UI or CLI.
+
+## Quick Start & Packing
+
+To build and generate the importable tarball in `dist/`:
+
+```bash
+npm run pack
+# Output: dist/agy-paperclip-adapter-1.0.0.tgz
+```
+
+## Installation into Paperclip
+
+### Option 1: Via UI (Custom Adapter Import)
+Upload `dist/agy-paperclip-adapter-1.0.0.tgz` in the Paperclip UI under **Settings → Adapters → Install Custom Adapter**.
+
+### Option 2: Via Paperclip CLI
+```bash
+paperclipai adapter install --payload-json "{\"packageName\":\"$PWD/dist/agy-paperclip-adapter-1.0.0.tgz\"}"
+```
+
+### Option 3: Local Symlink Development
+```bash
+curl -X POST http://localhost:3100/api/adapters \
+  -H "Authorization: Bearer <PAPERCLIP_API_KEY>" \
+  -H "Content-Type: application/json" \
+  -d "{\"localPath\":\"$PWD\"}"
+```
+
+## License
+
+MIT

package/dist/icon.d.ts

@@ -0,0 +1,2 @@
+export declare const iconSvg = "<svg xmlns=\"http://www.w3.org/2000/svg\" viewBox=\"0 0 24 24\" width=\"24\" height=\"24\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.75\" stroke-linecap=\"round\" stroke-linejoin=\"round\">\n  <path d=\"M12 2L2 19h20L12 2z\" stroke=\"#4285F4\" stroke-width=\"2\"/>\n  <ellipse cx=\"12\" cy=\"14\" rx=\"8\" ry=\"3\" stroke=\"#A142F4\" stroke-width=\"1.5\" stroke-dasharray=\"3 2\"/>\n  <circle cx=\"12\" cy=\"10\" r=\"2\" fill=\"#4285F4\"/>\n</svg>";
+export declare const icon = "<svg xmlns=\"http://www.w3.org/2000/svg\" viewBox=\"0 0 24 24\" width=\"24\" height=\"24\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.75\" stroke-linecap=\"round\" stroke-linejoin=\"round\">\n  <path d=\"M12 2L2 19h20L12 2z\" stroke=\"#4285F4\" stroke-width=\"2\"/>\n  <ellipse cx=\"12\" cy=\"14\" rx=\"8\" ry=\"3\" stroke=\"#A142F4\" stroke-width=\"1.5\" stroke-dasharray=\"3 2\"/>\n  <circle cx=\"12\" cy=\"10\" r=\"2\" fill=\"#4285F4\"/>\n</svg>";

package/dist/icon.js

@@ -0,0 +1,6 @@
+export const iconSvg = `<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" width="24" height="24" fill="none" stroke="currentColor" stroke-width="1.75" stroke-linecap="round" stroke-linejoin="round">
+  <path d="M12 2L2 19h20L12 2z" stroke="#4285F4" stroke-width="2"/>
+  <ellipse cx="12" cy="14" rx="8" ry="3" stroke="#A142F4" stroke-width="1.5" stroke-dasharray="3 2"/>
+  <circle cx="12" cy="10" r="2" fill="#4285F4"/>
+</svg>`;
+export const icon = iconSvg;

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+export declare const type = "antigravity";
+export declare const label = "Antigravity";
+export { icon, iconSvg } from "./icon.js";
+export { models, DEFAULT_ANTIGRAVITY_MODEL } from "./models.js";
+export { parseStdoutLine } from "./ui-parser.js";
+export { agentConfigurationDoc, createServerAdapter, sessionCodec, getConfigSchema, } from "./server/index.js";

package/dist/index.js

@@ -0,0 +1,6 @@
+export const type = "antigravity";
+export const label = "Antigravity";
+export { icon, iconSvg } from "./icon.js";
+export { models, DEFAULT_ANTIGRAVITY_MODEL } from "./models.js";
+export { parseStdoutLine } from "./ui-parser.js";
+export { agentConfigurationDoc, createServerAdapter, sessionCodec, getConfigSchema, } from "./server/index.js";

package/dist/models.d.ts

@@ -0,0 +1,5 @@
+export declare const DEFAULT_ANTIGRAVITY_MODEL = "gemini-3.8-flash-high";
+export declare const models: {
+    id: string;
+    label: string;
+}[];

package/dist/models.js

@@ -0,0 +1,18 @@
+export const DEFAULT_ANTIGRAVITY_MODEL = "gemini-3.8-flash-high";
+export const models = [
+    { id: "gemini-3.8-flash-high", label: "Gemini 3.8 Flash (High)" },
+    { id: "gemini-3.8-flash-medium", label: "Gemini 3.8 Flash (Medium)" },
+    { id: "gemini-3.8-flash-low", label: "Gemini 3.8 Flash (Low)" },
+    { id: "gemini-3.7-flash-high", label: "Gemini 3.7 Flash (High)" },
+    { id: "gemini-3.7-flash-medium", label: "Gemini 3.7 Flash (Medium)" },
+    { id: "gemini-3.7-flash-low", label: "Gemini 3.7 Flash (Low)" },
+    { id: "gemini-3.6-flash-high", label: "Gemini 3.6 Flash (High)" },
+    { id: "gemini-3.6-flash-medium", label: "Gemini 3.6 Flash (Medium)" },
+    { id: "gemini-3.6-flash-low", label: "Gemini 3.6 Flash (Low)" },
+    { id: "gemini-3.1-pro-high", label: "Gemini 3.1 Pro (High)" },
+    { id: "gemini-3.1-pro-low", label: "Gemini 3.1 Pro (Low)" },
+    { id: "claude-sonnet-4-6", label: "Claude Sonnet 4.6 (Thinking)" },
+    { id: "claude-opus-4-6-thinking", label: "Claude Opus 4.6 (Thinking)" },
+    { id: "gpt-oss-120b-medium", label: "GPT-OSS 120B (Medium)" },
+    { id: "auto", label: "Auto" },
+];

package/dist/server/execute.d.ts

@@ -0,0 +1,2 @@
+import type { AdapterExecutionContext, AdapterExecutionResult } from "@paperclipai/adapter-utils";
+export declare function execute(ctx: AdapterExecutionContext): Promise<AdapterExecutionResult>;

package/dist/server/execute.js

@@ -0,0 +1,238 @@
+import fs from "node:fs/promises";
+import crypto from "node:crypto";
+import { runChildProcess, buildPaperclipEnv, applyPaperclipWorkspaceEnv, renderPaperclipWakePrompt, renderTemplate, joinPromptSections, stringifyPaperclipWakePayload, parseObject, asString, DEFAULT_PAPERCLIP_AGENT_PROMPT_TEMPLATE, } from "@paperclipai/adapter-utils/server-utils";
+import { DEFAULT_ANTIGRAVITY_MODEL } from "../models.js";
+import { syncSkillsToWorkspace } from "./skills-sync.js";
+function parseSkills(raw) {
+    if (!Array.isArray(raw))
+        return [];
+    const items = [];
+    for (const item of raw) {
+        if (typeof item === "object" && item !== null) {
+            const obj = item;
+            if (typeof obj.name === "string" && obj.name.trim().length > 0) {
+                const files = [];
+                if (Array.isArray(obj.files)) {
+                    for (const f of obj.files) {
+                        if (typeof f === "object" && f !== null) {
+                            const fileObj = f;
+                            if (typeof fileObj.path === "string" && fileObj.path.trim().length > 0) {
+                                files.push({
+                                    path: fileObj.path,
+                                    content: typeof fileObj.content === "string" ? fileObj.content : "",
+                                });
+                            }
+                        }
+                    }
+                }
+                items.push({
+                    id: typeof obj.id === "string" ? obj.id : undefined,
+                    name: obj.name,
+                    description: typeof obj.description === "string" ? obj.description : undefined,
+                    instructions: typeof obj.instructions === "string" ? obj.instructions : undefined,
+                    content: typeof obj.content === "string" ? obj.content : undefined,
+                    files: files.length > 0 ? files : undefined,
+                });
+            }
+        }
+    }
+    return items;
+}
+function buildPrompt(ctx) {
+    const { config, agent, context } = ctx;
+    const wakePrompt = renderPaperclipWakePrompt(context.paperclipWake, {
+        conversationMode: context.conversationMode === true,
+        resumedSession: Boolean(ctx.runtime.sessionId),
+        suppressIssueDescription: false,
+    });
+    const template = typeof config.promptTemplate === "string" && config.promptTemplate.trim().length > 0
+        ? config.promptTemplate
+        : DEFAULT_PAPERCLIP_AGENT_PROMPT_TEMPLATE;
+    const data = {
+        agentId: agent.id,
+        agentName: agent.name,
+        companyId: agent.companyId,
+        runId: ctx.runId,
+        taskId: asString(context.taskId, ""),
+        taskTitle: asString(context.taskTitle, ""),
+        wakeReason: asString(context.wakeReason, ""),
+    };
+    const renderedTemplate = renderTemplate(template, data);
+    const sections = [];
+    const agentInstructions = asString(context.agentInstructions, "");
+    if (agentInstructions.trim().length > 0) {
+        sections.push(`## Agent Role & Instructions\n${agentInstructions.trim()}`);
+    }
+    if (wakePrompt && wakePrompt.trim().length > 0) {
+        sections.push(wakePrompt);
+    }
+    sections.push(renderedTemplate);
+    const taskDescription = asString(context.taskDescription, "");
+    if (taskDescription.trim().length > 0) {
+        sections.push(`## Task Details\n${taskDescription.trim()}`);
+    }
+    return joinPromptSections(sections);
+}
+export async function execute(ctx) {
+    const { config, agent, runId, onLog, context } = ctx;
+    const command = String(config.command ?? "agy");
+    const model = String(config.model ?? DEFAULT_ANTIGRAVITY_MODEL);
+    const effort = config.effort ? String(config.effort) : null;
+    const mode = config.mode ? String(config.mode) : null;
+    const timeoutSec = Number(config.timeoutSec ?? 600);
+    const graceSec = Number(config.graceSec ?? 15);
+    const prevConversationId = typeof ctx.runtime.sessionParams?.conversationId === "string"
+        ? ctx.runtime.sessionParams.conversationId
+        : typeof ctx.runtime.sessionId === "string"
+            ? ctx.runtime.sessionId
+            : null;
+    const conversationId = prevConversationId ?? `${agent.id}-${crypto.randomUUID()}`;
+    const workspaceContext = parseObject(context.paperclipWorkspace);
+    const workspaceCwd = asString(workspaceContext.cwd, "");
+    const effectiveCwd = workspaceCwd || String(config.cwd ?? process.cwd());
+    try {
+        await fs.mkdir(effectiveCwd, { recursive: true });
+    }
+    catch {
+        // Ignore directory creation error
+    }
+    const skillsList = parseSkills(context.skills);
+    const syncedSkills = await syncSkillsToWorkspace(effectiveCwd, skillsList);
+    const paperclipEnv = buildPaperclipEnv(agent);
+    const env = {
+        ...process.env,
+        ...paperclipEnv,
+        HOME: process.env.HOME || "/root",
+        PATH: `/root/.local/bin:${process.env.PATH ?? ""}`,
+        PAPERCLIP_RUN_ID: runId,
+    };
+    if (ctx.authToken) {
+        env.PAPERCLIP_API_KEY = ctx.authToken;
+    }
+    const wakeTaskId = asString(context.taskId, "") || asString(context.issueId, "");
+    if (wakeTaskId.trim().length > 0) {
+        env.PAPERCLIP_TASK_ID = wakeTaskId.trim();
+    }
+    const wakeReason = asString(context.wakeReason, "");
+    if (wakeReason.trim().length > 0) {
+        env.PAPERCLIP_WAKE_REASON = wakeReason.trim();
+    }
+    const wakeCommentId = asString(context.wakeCommentId, "") || asString(context.commentId, "");
+    if (wakeCommentId.trim().length > 0) {
+        env.PAPERCLIP_WAKE_COMMENT_ID = wakeCommentId.trim();
+    }
+    const approvalId = asString(context.approvalId, "");
+    if (approvalId.trim().length > 0) {
+        env.PAPERCLIP_APPROVAL_ID = approvalId.trim();
+    }
+    const approvalStatus = asString(context.approvalStatus, "");
+    if (approvalStatus.trim().length > 0) {
+        env.PAPERCLIP_APPROVAL_STATUS = approvalStatus.trim();
+    }
+    const linkedIssueIds = [];
+    if (Array.isArray(context.issueIds)) {
+        for (const item of context.issueIds) {
+            if (typeof item === "string" && item.trim().length > 0) {
+                linkedIssueIds.push(item.trim());
+            }
+        }
+    }
+    if (linkedIssueIds.length > 0) {
+        env.PAPERCLIP_LINKED_ISSUE_IDS = linkedIssueIds.join(",");
+    }
+    const wakePayloadJson = stringifyPaperclipWakePayload(context.paperclipWake);
+    if (wakePayloadJson) {
+        env.PAPERCLIP_WAKE_PAYLOAD_JSON = wakePayloadJson;
+    }
+    applyPaperclipWorkspaceEnv(env, {
+        workspaceCwd: effectiveCwd,
+        workspaceSource: asString(workspaceContext.source, ""),
+        workspaceStrategy: asString(workspaceContext.strategy, ""),
+        workspaceId: asString(workspaceContext.workspaceId, "") || null,
+        workspaceRepoUrl: asString(workspaceContext.repoUrl, "") || null,
+        workspaceRepoRef: asString(workspaceContext.repoRef, "") || null,
+        workspaceBranch: asString(workspaceContext.branchName, "") || null,
+        workspaceWorktreePath: asString(workspaceContext.worktreePath, "") || null,
+        agentHome: asString(workspaceContext.agentHome, "") || null,
+    });
+    if (typeof config.env === "object" && config.env !== null) {
+        for (const [k, v] of Object.entries(config.env)) {
+            if (typeof v === "string")
+                env[k] = v;
+        }
+    }
+    let promptText = buildPrompt(ctx);
+    const instructionsPath = config.instructionsFilePath
+        ? String(config.instructionsFilePath)
+        : null;
+    if (instructionsPath) {
+        try {
+            const instructions = await fs.readFile(instructionsPath, "utf-8");
+            promptText = `${instructions}\n\n---\n\n${promptText}`;
+        }
+        catch {
+            // Ignore missing instructions file
+        }
+    }
+    if (syncedSkills.length > 0) {
+        await onLog("stdout", `[antigravity] Synchronized ${syncedSkills.length} skill(s) for agent "${agent.name}": ${syncedSkills.join(", ")}\n`);
+    }
+    const args = ["--dangerously-skip-permissions"];
+    if (model && model !== "auto") {
+        args.push(`--model=${model}`);
+    }
+    if (effort) {
+        args.push(`--effort=${effort}`);
+    }
+    if (mode) {
+        args.push(`--mode=${mode}`);
+    }
+    if (prevConversationId) {
+        args.push(`--conversation=${prevConversationId}`);
+    }
+    args.push(`--print=${promptText}`);
+    await onLog("stdout", `[antigravity] Starting agy session (agent: ${agent.name}, model: ${model}, conversation: ${conversationId})...\n`);
+    try {
+        const processResult = await runChildProcess(runId, command, args, {
+            cwd: effectiveCwd,
+            env,
+            timeoutSec,
+            graceSec,
+            onLog: async (stream, chunk) => {
+                await onLog(stream, chunk);
+            },
+            onSpawn: ctx.onSpawn,
+        });
+        const isSuccess = processResult.exitCode === 0;
+        return {
+            exitCode: processResult.exitCode,
+            signal: processResult.signal,
+            timedOut: processResult.timedOut,
+            provider: "antigravity",
+            model,
+            sessionId: conversationId,
+            sessionDisplayId: conversationId.slice(0, 8),
+            sessionParams: {
+                conversationId,
+                cwd: effectiveCwd,
+                model,
+                agentId: agent.id,
+            },
+            errorMessage: isSuccess ? null : `agy exited with code ${processResult.exitCode}`,
+            summary: isSuccess ? "Completed Antigravity run" : `Run failed with exit code ${processResult.exitCode}`,
+        };
+    }
+    catch (err) {
+        const errorMsg = err instanceof Error ? err.message : String(err);
+        await onLog("stderr", `[antigravity] Error executing agy: ${errorMsg}\n`);
+        return {
+            exitCode: 1,
+            signal: null,
+            timedOut: false,
+            provider: "antigravity",
+            model,
+            errorMessage: errorMsg,
+            summary: `Antigravity execution failed: ${errorMsg}`,
+        };
+    }
+}

package/dist/server/index.d.ts

@@ -0,0 +1,35 @@
+import type { ServerAdapterModule, AdapterSessionCodec } from "@paperclipai/adapter-utils";
+import { icon, iconSvg } from "../icon.js";
+export declare const type = "antigravity";
+export declare const label = "Antigravity";
+export { icon, iconSvg };
+export declare const sessionCodec: AdapterSessionCodec;
+export declare const agentConfigurationDoc = "# Antigravity Agent Configuration\n\nAdapter: antigravity\n\nUse when:\n- You want Paperclip to orchestrate Google Antigravity (agy) local CLI agents.\n- You want model selection across Gemini 3.8 Flash, Gemini 3.7 Flash, Gemini 3.6 Flash, Gemini 3.1 Pro, Claude Sonnet/Opus, or GPT-OSS models.\n- You want to hire multiple local agents with individual instructions and Paperclip skills.\n- You want persistent conversation session state across heartbeats.\n\nCore fields:\n- model (string): Antigravity model ID (e.g. gemini-3.8-flash-high, gemini-3.7-flash-high, claude-sonnet-4-6).\n- effort (string, optional): Reasoning effort (low, medium, high, max).\n- mode (string, optional): accept-edits or plan.\n- command (string, optional): agy binary command path (defaults to \"agy\").\n- cwd (string, optional): Working directory fallback.\n- instructionsFilePath (string, optional): Path to instructions markdown file (e.g. AGENTS.md).\n- timeoutSec (number, optional): Execution timeout in seconds (default: 600).\n";
+export declare function getConfigSchema(): {
+    fields: ({
+        key: string;
+        label: string;
+        type: "select";
+        default: string;
+        options: {
+            value: string;
+            label: string;
+        }[];
+        hint: string;
+    } | {
+        key: string;
+        label: string;
+        type: "text";
+        default: string;
+        hint: string;
+        options?: undefined;
+    } | {
+        key: string;
+        label: string;
+        type: "number";
+        default: number;
+        hint: string;
+        options?: undefined;
+    })[];
+};
+export declare function createServerAdapter(): ServerAdapterModule;

package/dist/server/index.js

@@ -0,0 +1,111 @@
+import { models, DEFAULT_ANTIGRAVITY_MODEL } from "../models.js";
+import { icon, iconSvg } from "../icon.js";
+import { execute } from "./execute.js";
+import { testEnvironment } from "./test.js";
+export const type = "antigravity";
+export const label = "Antigravity";
+export { icon, iconSvg };
+export const sessionCodec = {
+    deserialize(raw) {
+        if (typeof raw !== "object" || raw === null || Array.isArray(raw))
+            return null;
+        const r = raw;
+        const conversationId = r.conversationId ?? r.sessionId;
+        return conversationId ? { conversationId: String(conversationId) } : null;
+    },
+    serialize(params) {
+        if (!params?.conversationId && !params?.sessionId)
+            return null;
+        return { conversationId: String(params.conversationId ?? params.sessionId) };
+    },
+    getDisplayId(params) {
+        const id = params?.conversationId ?? params?.sessionId;
+        return id ? String(id).slice(0, 8) : null;
+    },
+};
+export const agentConfigurationDoc = `# Antigravity Agent Configuration
+
+Adapter: antigravity
+
+Use when:
+- You want Paperclip to orchestrate Google Antigravity (agy) local CLI agents.
+- You want model selection across Gemini 3.8 Flash, Gemini 3.7 Flash, Gemini 3.6 Flash, Gemini 3.1 Pro, Claude Sonnet/Opus, or GPT-OSS models.
+- You want to hire multiple local agents with individual instructions and Paperclip skills.
+- You want persistent conversation session state across heartbeats.
+
+Core fields:
+- model (string): Antigravity model ID (e.g. gemini-3.8-flash-high, gemini-3.7-flash-high, claude-sonnet-4-6).
+- effort (string, optional): Reasoning effort (low, medium, high, max).
+- mode (string, optional): accept-edits or plan.
+- command (string, optional): agy binary command path (defaults to "agy").
+- cwd (string, optional): Working directory fallback.
+- instructionsFilePath (string, optional): Path to instructions markdown file (e.g. AGENTS.md).
+- timeoutSec (number, optional): Execution timeout in seconds (default: 600).
+`;
+export function getConfigSchema() {
+    return {
+        fields: [
+            {
+                key: "model",
+                label: "Model",
+                type: "select",
+                default: DEFAULT_ANTIGRAVITY_MODEL,
+                options: models.map((m) => ({ value: m.id, label: m.label })),
+                hint: "Select the AI model for this Antigravity agent.",
+            },
+            {
+                key: "effort",
+                label: "Reasoning Effort",
+                type: "select",
+                default: "high",
+                options: [
+                    { value: "low", label: "Low" },
+                    { value: "medium", label: "Medium" },
+                    { value: "high", label: "High" },
+                    { value: "max", label: "Max" },
+                ],
+                hint: "Reasoning effort level for thinking models.",
+            },
+            {
+                key: "mode",
+                label: "Execution Mode",
+                type: "select",
+                default: "accept-edits",
+                options: [
+                    { value: "accept-edits", label: "Accept Edits" },
+                    { value: "plan", label: "Plan" },
+                ],
+                hint: "Execution mode for the Antigravity session.",
+            },
+            {
+                key: "command",
+                label: "CLI Command",
+                type: "text",
+                default: "agy",
+                hint: "Override command or binary path for Antigravity CLI.",
+            },
+            {
+                key: "timeoutSec",
+                label: "Timeout (seconds)",
+                type: "number",
+                default: 600,
+                hint: "Execution timeout in seconds.",
+            },
+        ],
+    };
+}
+export function createServerAdapter() {
+    return {
+        type,
+        execute,
+        testEnvironment,
+        sessionCodec,
+        models,
+        agentConfigurationDoc,
+        getConfigSchema,
+        supportsSkills: true,
+        supportsInstructionsBundle: true,
+        instructionsPathKey: "instructionsFilePath",
+        supportsLocalAgentJwt: true,
+    };
+}

package/dist/server/skills-sync.d.ts

@@ -0,0 +1,13 @@
+export interface SkillFile {
+    path: string;
+    content: string;
+}
+export interface SkillItem {
+    id?: string;
+    name: string;
+    description?: string;
+    instructions?: string;
+    content?: string;
+    files?: SkillFile[];
+}
+export declare function syncSkillsToWorkspace(effectiveCwd: string, skills?: SkillItem[]): Promise<string[]>;

package/dist/server/skills-sync.js

@@ -0,0 +1,39 @@
+import fs from "node:fs/promises";
+import path from "node:path";
+export async function syncSkillsToWorkspace(effectiveCwd, skills) {
+    if (!Array.isArray(skills) || skills.length === 0) {
+        return [];
+    }
+    const baseSkillsDir = path.join(effectiveCwd, ".agents", "skills");
+    await fs.mkdir(baseSkillsDir, { recursive: true });
+    const syncedSkillNames = [];
+    for (const skill of skills) {
+        if (!skill || !skill.name)
+            continue;
+        const skillName = skill.name.trim().toLowerCase().replace(/[^a-z0-9_-]/g, "-");
+        const skillDir = path.join(baseSkillsDir, skillName);
+        await fs.mkdir(skillDir, { recursive: true });
+        const description = skill.description ? skill.description.trim() : `Skill: ${skill.name}`;
+        const body = skill.instructions ?? skill.content ?? "";
+        const skillMdContent = `---
+name: ${skillName}
+description: ${description.replace(/\n/g, " ")}
+---
+
+${body}
+`;
+        const skillMdPath = path.join(skillDir, "SKILL.md");
+        await fs.writeFile(skillMdPath, skillMdContent, "utf-8");
+        if (Array.isArray(skill.files)) {
+            for (const file of skill.files) {
+                if (!file || !file.path)
+                    continue;
+                const filePath = path.join(skillDir, file.path);
+                await fs.mkdir(path.dirname(filePath), { recursive: true });
+                await fs.writeFile(filePath, file.content ?? "", "utf-8");
+            }
+        }
+        syncedSkillNames.push(skillName);
+    }
+    return syncedSkillNames;
+}

package/dist/server/test.d.ts

@@ -0,0 +1,2 @@
+import type { AdapterEnvironmentTestContext, AdapterEnvironmentTestResult } from "@paperclipai/adapter-utils";
+export declare function testEnvironment(ctx: AdapterEnvironmentTestContext): Promise<AdapterEnvironmentTestResult>;

package/dist/server/test.js

@@ -0,0 +1,42 @@
+import { execFile } from "node:child_process";
+import { promisify } from "node:util";
+const execFileAsync = promisify(execFile);
+export async function testEnvironment(ctx) {
+    const checks = [];
+    const command = String(ctx.config.command ?? "agy");
+    try {
+        const { stdout } = await execFileAsync(command, ["--version"], {
+            timeout: 5000,
+        });
+        const version = stdout.trim();
+        checks.push({
+            level: "info",
+            message: `Antigravity CLI detected: ${version}`,
+            code: "agy_cli_detected",
+        });
+    }
+    catch (err) {
+        checks.push({
+            level: "error",
+            message: `Failed to execute Antigravity CLI command "${command}": ${err instanceof Error ? err.message : String(err)}`,
+            hint: "Ensure 'agy' is installed in PATH (e.g. /root/.local/bin/agy) or specify adapterConfig.command.",
+            code: "agy_cli_missing",
+        });
+    }
+    const cwd = ctx.config.cwd ? String(ctx.config.cwd) : null;
+    if (cwd && !cwd.startsWith("/")) {
+        checks.push({
+            level: "error",
+            message: `Working directory must be an absolute path: "${cwd}"`,
+            hint: "Specify an absolute path such as /root or a workspace directory.",
+            code: "invalid_cwd",
+        });
+    }
+    const hasError = checks.some((c) => c.level === "error");
+    return {
+        adapterType: ctx.adapterType,
+        status: hasError ? "fail" : "pass",
+        checks,
+        testedAt: new Date().toISOString(),
+    };
+}

package/dist/ui-parser.d.ts

@@ -0,0 +1,11 @@
+export interface TranscriptEntry {
+    kind: "assistant" | "thinking" | "system" | "tool_call" | "tool_result" | "stderr" | "stdout";
+    ts: string;
+    text?: string;
+    name?: string;
+    input?: unknown;
+    toolUseId?: string;
+    content?: string;
+    isError?: boolean;
+}
+export declare function parseStdoutLine(line: string, ts: string): TranscriptEntry[];

package/dist/ui-parser.js

@@ -0,0 +1,42 @@
+// Self-contained UI transcript parser for Antigravity (zero runtime imports)
+export function parseStdoutLine(line, ts) {
+    const trimmed = line.trim();
+    if (!trimmed)
+        return [];
+    // Antigravity adapter log messages
+    if (trimmed.startsWith("[antigravity]")) {
+        return [{ kind: "system", ts, text: trimmed }];
+    }
+    // Spinner / progress indicators from CLI
+    if (/^[⠋⠙⠹⠸⠼⠴⠦⠧⠇⠏]/.test(trimmed)) {
+        return [{ kind: "thinking", ts, text: trimmed.replace(/^[⠋⠙⠹⠸⠼⠴⠦⠧⠇⠏]\s*/, "") }];
+    }
+    // Thinking markers
+    if (trimmed.startsWith("Thinking:") || trimmed.startsWith("Thought:")) {
+        return [{ kind: "thinking", ts, text: trimmed }];
+    }
+    // Tool calls (e.g. [tool] call: name)
+    const toolMatch = trimmed.match(/^\[(?:tool|call)\]\s+([a-zA-Z0-9_-]+)(?:\s+(.*))?$/);
+    if (toolMatch) {
+        const name = toolMatch[1];
+        let input = {};
+        if (toolMatch[2]) {
+            try {
+                input = JSON.parse(toolMatch[2]);
+            }
+            catch {
+                input = { raw: toolMatch[2] };
+            }
+        }
+        return [
+            {
+                kind: "tool_call",
+                ts,
+                name,
+                input,
+            },
+        ];
+    }
+    // Default to assistant output
+    return [{ kind: "assistant", ts, text: line }];
+}

package/package.json

@@ -0,0 +1,56 @@
+{
+  "name": "agy-paperclip-adapter",
+  "version": "1.0.0",
+  "description": "Google Antigravity (agy) local agent adapter for Paperclip",
+  "type": "module",
+  "license": "MIT",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "keywords": [
+    "paperclip",
+    "paperclip-adapter",
+    "antigravity",
+    "agy",
+    "ai-agent",
+    "gemini"
+  ],
+  "paperclip": {
+    "adapterUiParser": "1.0.0"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./server": {
+      "types": "./dist/server/index.d.ts",
+      "import": "./dist/server/index.js",
+      "default": "./dist/server/index.js"
+    },
+    "./ui-parser": {
+      "types": "./dist/ui-parser.d.ts",
+      "import": "./dist/ui-parser.js",
+      "default": "./dist/ui-parser.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "clean": "rm -rf dist *.tgz",
+    "pack": "npm run clean && npm run build && npm pack --pack-destination=dist",
+    "prepublishOnly": "npm run clean && npm run build"
+  },
+  "dependencies": {
+    "@paperclipai/adapter-utils": "^2026.325.0",
+    "picocolors": "^1.1.1"
+  },
+  "devDependencies": {
+    "@types/node": "^24.0.0",
+    "typescript": "^5.7.0"
+  }
+}