crewly 1.20.142 → 1.20.143

package/dist/backend/backend/src/services/agent/antigravity-runtime.service.d.ts

@@ -0,0 +1,267 @@
+import { RuntimeAgentService } from './runtime-agent.service.abstract.js';
+import { RuntimeStartupBlockedError } from './runtime-startup-blocked.error.js';
+import { SessionCommandHelper } from '../session/index.js';
+import { type RuntimeType } from '../../constants.js';
+import { type AntigravityProviderResult } from '../../utils/antigravity-settings.utils.js';
+/** Injectable dependencies (tests). */
+export interface AntigravityRuntimeDeps {
+    /** The Gemini API key the session will run with, or null when there is none */
+    resolveApiKey?: () => Promise<string | null>;
+    /** Switch agy to the Gemini API key provider and trust the given folders */
+    ensureProvider?: (trustedPaths: string[]) => Promise<AntigravityProviderResult>;
+    /** Crewly home dir (prompt files and skills live there) */
+    crewlyHome?: () => string;
+    /** System temp dir (skills write screenshots and artifacts there) */
+    tmpDir?: () => string;
+}
+/**
+ * The Gemini API key an Antigravity session gets: the key saved for
+ * Antigravity in Settings → Harness, else a Gemini key from Crewly settings
+ * (global or an antigravity-cli override), else GEMINI_API_KEY in the
+ * backend's environment.
+ *
+ * @returns The key, or null when none is available
+ */
+export declare function resolveAntigravityApiKey(): Promise<string | null>;
+/**
+ * Whether a marker is on screen, also when the terminal wrapped it: agy's
+ * plain-text messages (printed before the TUI starts) wrap at the PTY width,
+ * so the marker is searched in the text as shown and with line breaks
+ * removed.
+ *
+ * @param screen - Captured screen (ANSI already stripped)
+ * @param marker - Text to find
+ * @returns True when found
+ */
+export declare function antigravityScreenIncludes(screen: string, marker: string): boolean;
+/**
+ * Classify a screen that agy cannot get past without the user, or that
+ * Crewly must refuse (an account sign-in).
+ *
+ * @param screen - Captured screen
+ * @returns The blocking error to throw, or null
+ */
+export declare function detectAntigravityStartupBlocker(screen: string): RuntimeStartupBlockedError | null;
+/**
+ * Whether agy started on something other than the Gemini API key: its
+ * banner (`Antigravity CLI 1.2.11`) is on screen but the `Gemini API key`
+ * line that replaces the account email is not. Only meaningful once the
+ * screen is fully painted (the idle footer is up): the two lines are drawn
+ * together, but a capture can land between them while agy boots.
+ *
+ * @param screen - Captured screen (ANSI stripped)
+ * @returns True for an account session
+ */
+export declare function isAntigravityAccountSession(screen: string): boolean;
+/**
+ * Whether agy's folder-trust screen is showing.
+ *
+ * @param screen - Captured screen
+ * @returns True when the "Do you trust the contents of this project?" screen is up
+ */
+export declare function isAntigravityTrustPrompt(screen: string): boolean;
+/**
+ * The text currently typed in agy's prompt box: the lines between the last
+ * two horizontal rules, without the `>` marker. The accept-edits
+ * placeholder counts as empty.
+ *
+ * ```
+ * ─────────────────────────────  ← top rule
+ * > Read the file at /x.md       ← input (may wrap onto more lines)
+ * ─────────────────────────────  ← bottom rule
+ * ? for shortcuts        …       ← footer
+ * ```
+ *
+ * @param screen - Captured screen
+ * @returns The typed text (whitespace-collapsed), '' when empty, or null when no prompt box is visible
+ */
+export declare function getAntigravityInputBoxText(screen: string): string | null;
+/**
+ * Whether a message is still sitting in agy's prompt box (typed, not
+ * submitted). Only the box counts: agy echoes every submitted message above
+ * it as `> text`, which must not read as "stuck".
+ *
+ * @param screen - Captured screen
+ * @param message - Message that was sent
+ * @returns True when its start is still in the prompt box
+ */
+export declare function isTextInAntigravityInputBox(screen: string, message: string): boolean;
+/**
+ * Google Antigravity CLI (`agy`) runtime service.
+ *
+ * Crewly drives agy's interactive TUI in a PTY, like the other harnesses.
+ * The one hard rule: agy runs **only on a Gemini API key**. Google does not
+ * allow third-party tools to use Antigravity (or Gemini CLI) product OAuth,
+ * so before every launch Crewly
+ *
+ * 1. refuses to launch without a Gemini API key (RuntimeStartupBlockedError
+ *    `api_key_required`), and
+ * 2. writes `"modelProvider": "gemini"` into agy's settings file (with the
+ *    agent's folder in `trustedWorkspaces`). The key reaches the session as
+ *    `GEMINI_API_KEY` in its spawn environment (harnessEnvForAgents).
+ *
+ * With that provider agy "never establishes an account session", even when
+ * the machine has an account login in its keyring. If agy nevertheless shows
+ * an account sign-in screen, or starts without the `Gemini API key` header,
+ * the launch is refused (`account_login_refused`) instead of letting the
+ * owner sign in.
+ *
+ * Launch: `agy --dangerously-skip-permissions --mode=accept-edits`, plus
+ * `--add-dir` for the Crewly home (the init prompt file lives there) and the
+ * temp dir (skill artifacts), `--model` / `--effort` for the member, and
+ * `--conversation=<id>` to resume. `AGY_CLI_DISABLE_AUTO_UPDATE=true` keeps
+ * the self-updater from replacing the binary mid-task.
+ *
+ * Screen anatomy (agy 1.2.11, captured in a PTY):
+ *
+ * ```
+ *   Antigravity CLI 1.2.11
+ *   Gemini API key                               ← provider header
+ *   Gemini 3.1 Pro (Low)
+ * ─────────────────────────────────────────────
+ * > Accept-edits mode: file edits auto-approved (shift+tab to cycle)
+ * ─────────────────────────────────────────────
+ * ? for shortcuts            accept-edits · Gemini 3.1 Pro · low   ← idle footer
+ *
+ * > say hello                                   ← echo of a submitted message
+ * ⣯  Generating...                              ← busy
+ * ────────────────  >  ────────────────
+ * esc to cancel              accept-edits · …   ← busy footer
+ * ```
+ *
+ * Detection is a passive screen scrape: Ctrl+C at the prompt arms "press
+ * ctrl+c again to exit" and `/` opens the command menu, so no key probes.
+ */
+export declare class AntigravityRuntimeService extends RuntimeAgentService {
+    private readonly resolveApiKey;
+    private readonly ensureProvider;
+    private readonly crewlyHome;
+    private readonly tmpDir;
+    /**
+     * @param sessionHelper - PTY session helper
+     * @param projectRoot - Crewly install dir
+     * @param deps - Injectable dependencies (tests)
+     */
+    constructor(sessionHelper: SessionCommandHelper, projectRoot: string, deps?: AntigravityRuntimeDeps);
+    protected getRuntimeType(): RuntimeType;
+    /**
+     * Folders agy gets with `--add-dir` at launch: the Crewly home (the init
+     * prompt file and skills) and the temp dir (skill artifacts). agy's file
+     * tools otherwise stay inside the workspace.
+     *
+     * @returns Absolute paths
+     */
+    getLaunchWorkspaceDirs(): string[];
+    /**
+     * Make sure agy can only start on the Gemini API key, then launch it.
+     *
+     * Claude-only launch arguments (`--agent`, a prompt file) are dropped:
+     * agy has its own, unrelated `--agent` flag.
+     *
+     * @param sessionName - PTY session name
+     * @param targetPath - Working directory for the session
+     * @param runtimeFlags - Model / effort / resume flags
+     * @param _promptFilePath - Ignored (Claude Code only)
+     * @param _agentName - Ignored (Claude Code only)
+     * @param resumeSessionId - Conversation being resumed (its flag is in runtimeFlags)
+     * @throws RuntimeStartupBlockedError when no key is available or agy's settings cannot be set
+     */
+    executeRuntimeInitScript(sessionName: string, targetPath?: string, runtimeFlags?: string[], _promptFilePath?: string, _agentName?: string, resumeSessionId?: string): Promise<void>;
+    /**
+     * Pre-launch guard: a Gemini API key must exist and agy's settings must
+     * select the Gemini provider (trusting the agent's folders).
+     *
+     * @param targetPath - The session's working directory
+     * @throws RuntimeStartupBlockedError `api_key_required` | `settings_unreadable`
+     */
+    prepareLaunch(targetPath?: string): Promise<void>;
+    /**
+     * Wait for agy's idle prompt.
+     *
+     * Screens only the user may resolve (first-run terms, a missing key) and
+     * screens Crewly must refuse (account sign-in) fail fast with a
+     * RuntimeStartupBlockedError; an account session is also exited so it
+     * does no work. The folder-trust screen is answered with its
+     * pre-selected "Yes, I trust this folder" (the folder is normally
+     * pre-trusted, so this is a fallback).
+     *
+     * @param sessionName - PTY session name
+     * @param timeout - Overall timeout (ms)
+     * @param checkInterval - Poll interval (ms)
+     * @returns True when ready, false on timeout or a startup error
+     * @throws RuntimeStartupBlockedError when start-up is blocked on the user
+     */
+    waitForRuntimeReady(sessionName: string, timeout: number, checkInterval?: number): Promise<boolean>;
+    /**
+     * Leave agy (Ctrl+C twice: the first arms "press ctrl+c again to exit").
+     *
+     * @param sessionName - PTY session name
+     */
+    private exitAntigravity;
+    /**
+     * Passive detection: agy's footer (idle or busy) is the last thing on
+     * screen, with no exit hint after it.
+     *
+     * @param sessionName - PTY session name
+     * @returns True when agy is running
+     */
+    protected detectRuntimeSpecific(sessionName: string): Promise<boolean>;
+    /**
+     * Text on screen once agy is up and taking input (or already busy, e.g.
+     * a resumed conversation): the idle footer, the empty accept-edits
+     * placeholder, or the busy footer.
+     *
+     * @returns Ready patterns
+     */
+    protected getRuntimeReadyPatterns(): string[];
+    /**
+     * Markers that veto readiness while the idle footer may still be painted.
+     *
+     * @returns Lower-case markers
+     */
+    protected getNotReadyMarkers(): readonly string[];
+    /**
+     * Exit patterns for RuntimeExitMonitorService (matched against the raw
+     * output stream, which is not wrapped). agy prints its resume hint on
+     * every clean exit, and refuses to start without the key.
+     *
+     * @returns Exit patterns
+     */
+    protected getRuntimeExitPatterns(): RegExp[];
+    /**
+     * Start-up error patterns (fail waitForRuntimeReady fast). Kept short so
+     * an 80-column wrap cannot split them.
+     *
+     * @returns Error patterns
+     */
+    protected getRuntimeErrorPatterns(): string[];
+    /**
+     * Add folders to a running agy's workspace with `/add-dir <path>` (the
+     * orchestrator's project folders). The Crewly home and temp dir were
+     * added at launch. Waits for the idle prompt around each command so the
+     * registration kickoff cannot land in the middle of one.
+     *
+     * @param sessionName - PTY session name
+     * @param targetProjectPath - The session's working directory (already the workspace)
+     * @param additionalAllowlistPaths - Extra folders to add
+     */
+    postInitialize(sessionName: string, targetProjectPath?: string, additionalAllowlistPaths?: string[]): Promise<void>;
+    /**
+     * Add one folder to a running agy's workspace, but only while it is idle
+     * at its prompt: a slash command typed during a turn would be queued as a
+     * message. Used when a project is added while the orchestrator runs.
+     *
+     * @param sessionName - PTY session name
+     * @param dir - Folder to add
+     * @returns True when the command was sent, false when agy was busy or the path is unusable
+     */
+    addWorkspaceDir(sessionName: string, dir: string): Promise<boolean>;
+    /**
+     * Wait (bounded) until agy shows its idle prompt.
+     *
+     * @param sessionName - PTY session name
+     * @returns True when idle, false on timeout
+     */
+    private waitForIdlePrompt;
+}
+//# sourceMappingURL=antigravity-runtime.service.d.ts.map

package/dist/backend/backend/src/services/agent/antigravity-runtime.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"antigravity-runtime.service.d.ts","sourceRoot":"","sources":["../../../../../../backend/src/services/agent/antigravity-runtime.service.ts"],"names":[],"mappings":"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"}