crewly 1.20.181 → 1.20.183

package/dist/backend/backend/src/services/runtime-terms/fake-agy-tui.fixture.js

@@ -0,0 +1,218 @@
+/**
+ * Tests-only fake of Antigravity CLI's first-run TUI (agy 1.2.14): a
+ * scripted terminal that takes the raw bytes a PTY would get, renders the
+ * screens the real binary paints (same text, same focus markers) and
+ * records every key, so a test can check exactly what was pressed and the
+ * resulting checkbox state.
+ *
+ * Behaviour copied from the real binary:
+ * - colour list: ↑/↓ move (wrapping inside the list), Enter chooses (`* name`);
+ *   without Gemini CLI extensions Enter goes straight to the Terms screen,
+ *   with them the focus moves to "Import extensions…" (↑ from there returns
+ *   to the bottom of the list and un-chooses the scheme), then Next;
+ * - Terms: the data item starts checked; Enter / Space toggle it; ↓ moves to
+ *   the buttons ([Previous] first), ←/→ between them, ↑ back to the item;
+ *   Enter on Previous goes back, Enter on Done accepts and shows the prompt.
+ *
+ * @module services/runtime-terms/fake-agy-tui.fixture
+ */
+const SCHEMES = ['terminal', 'light', 'solarized light', 'colorblind-friendly light', 'dark', 'solarized dark', 'colorblind-friendly dark', 'tokyo night'];
+const BYTES = {
+    '\x1b[A': 'Up',
+    '\x1b[B': 'Down',
+    '\x1b[C': 'Right',
+    '\x1b[D': 'Left',
+    '\r': 'Enter',
+    ' ': 'Space',
+    '\x03': 'CtrlC',
+};
+/** The fake. */
+export class FakeAgyTui {
+    opts;
+    /** Every key received, in order */
+    keys = [];
+    screenName = 'color';
+    focusZone = 'list';
+    focusIdx = 0;
+    chosen = null;
+    importChecked = false;
+    termsFocus = 'data';
+    dataChecked = true;
+    /** What Done accepted, once pressed */
+    accepted = null;
+    /** Times Done was pressed */
+    doneCount = 0;
+    /**
+     * @param opts - Scenario
+     */
+    constructor(opts = {}) {
+        this.opts = opts;
+        if (opts.alreadyAccepted)
+            this.screenName = 'main';
+        if (opts.accountLogin)
+            this.screenName = 'login';
+        if (opts.startScheme)
+            this.focusIdx = Math.max(0, SCHEMES.indexOf(opts.startScheme));
+    }
+    /**
+     * Receive bytes as a PTY would.
+     *
+     * @param data - Raw bytes
+     */
+    write(data) {
+        let rest = data;
+        while (rest.length > 0) {
+            const seq = Object.keys(BYTES).find((b) => rest.startsWith(b));
+            const key = seq ? BYTES[seq] : 'Other';
+            rest = rest.slice(seq ? seq.length : 1);
+            this.keys.push(key);
+            this.press(key);
+        }
+    }
+    press(key) {
+        if (key === 'CtrlC') {
+            this.screenName = 'exited';
+            return;
+        }
+        if (this.screenName === 'color')
+            this.pressColor(key);
+        else if (this.screenName === 'terms')
+            this.pressTerms(key);
+    }
+    pressColor(key) {
+        const migration = Boolean(this.opts.migration);
+        if (this.focusZone === 'list') {
+            if (key === 'Up')
+                this.focusIdx = (this.focusIdx + SCHEMES.length - 1) % SCHEMES.length;
+            else if (key === 'Down')
+                this.focusIdx = (this.focusIdx + 1) % SCHEMES.length;
+            else if (key === 'Enter') {
+                this.chosen = SCHEMES[this.focusIdx];
+                if (migration)
+                    this.focusZone = 'import';
+                else
+                    this.screenName = 'terms';
+            }
+            return;
+        }
+        if (this.focusZone === 'import') {
+            if (key === 'Enter' || key === 'Space')
+                this.importChecked = !this.importChecked;
+            else if (key === 'Down')
+                this.focusZone = 'next';
+            else if (key === 'Up') {
+                this.focusZone = 'list';
+                this.focusIdx = SCHEMES.length - 1;
+                this.chosen = null;
+            }
+            return;
+        }
+        if (key === 'Up')
+            this.focusZone = 'import';
+        else if (key === 'Enter')
+            this.screenName = 'terms';
+    }
+    pressTerms(key) {
+        if (this.termsFocus === 'data') {
+            if ((key === 'Enter' || key === 'Space') && !this.opts.stuckCheckbox)
+                this.dataChecked = !this.dataChecked;
+            else if (key === 'Down')
+                this.termsFocus = 'previous';
+            return;
+        }
+        if (key === 'Up')
+            this.termsFocus = 'data';
+        else if (key === 'Right')
+            this.termsFocus = 'done';
+        else if (key === 'Left')
+            this.termsFocus = 'previous';
+        else if (key === 'Enter') {
+            if (this.termsFocus === 'previous') {
+                this.screenName = 'color';
+                this.focusZone = 'list';
+                return;
+            }
+            this.doneCount += 1;
+            this.accepted = { scheme: this.chosen, importExtensions: this.importChecked, dataSharing: this.dataChecked };
+            this.screenName = 'main';
+        }
+    }
+    /** @returns The screen as text */
+    capture() {
+        switch (this.screenName) {
+            case 'main':
+                return [
+                    '  Antigravity CLI 1.2.14',
+                    '  Gemini API key',
+                    '─'.repeat(60),
+                    '> Accept-edits mode: file edits auto-approved (shift+tab to cycle)',
+                    '─'.repeat(60),
+                    '? for shortcuts            accept-edits · Gemini 3.1 Pro · low',
+                ].join('\n');
+            case 'exited':
+                return '$ ';
+            case 'login':
+                return ' Welcome to the Antigravity CLI. You are currently not signed in.\n\n Select login method:\n > 1. Google OAuth\n   2. Use a Google Cloud project';
+            case 'terms':
+                return this.renderTerms();
+            default:
+                return this.renderColor();
+        }
+    }
+    renderColor() {
+        const box = '│ > you: add a greeting function                              │';
+        const lines = ['    ▄▀▀▄', '', 'Welcome to Antigravity CLI!', '', 'Choose your color scheme:        ╭──────────────────────────╮'];
+        SCHEMES.forEach((name, i) => {
+            const focused = this.focusZone === 'list' && i === this.focusIdx;
+            const marker = focused ? '>' : this.chosen === name ? '*' : ' ';
+            lines.push(`  ${marker} ${name}`.padEnd(33) + box);
+        });
+        lines.push('                                 ╰──────────────────────────╯', '');
+        if (this.opts.migration) {
+            lines.push('Migration options:');
+            const f = this.focusZone === 'import' ? '>' : ' ';
+            lines.push(`  ${f} [${this.importChecked ? 'x' : ' '}] Import extensions from Gemini CLI (1 found: google-workspace)`, '');
+            lines.push(this.focusZone === 'next' ? '  >  Next' : '    [Next]');
+        }
+        else {
+            lines.push('    [Next]');
+        }
+        lines.push('', `  ↑/↓ Navigate · enter ${this.focusZone === 'import' ? 'Toggle' : 'Confirm'}`);
+        return lines.join('\n');
+    }
+    renderTerms() {
+        const title = 'Terms of Service & Data Use';
+        const item = this.opts.changedTerms
+            ? 'Allow Google to use my Interactions data to improve its products.'
+            : 'Yes, I agree to help improve Antigravity CLI by allowing';
+        const f = this.termsFocus === 'data' ? '>' : ' ';
+        const buttons = this.termsFocus === 'previous' ? '  >  Previous       [Done]' : this.termsFocus === 'done' ? '    [Previous]    >  Done' : '    [Previous]      [Done]';
+        return [
+            '    ▄▀▀▄',
+            '',
+            title,
+            '',
+            'AI coding agents are known to have certain security risks, including autonomous code execution, data exfiltration,',
+            'prompt injection and supply chain risks. Ensure that you monitor and verify all actions taken by the agent.',
+            '',
+            '-'.repeat(120),
+            '',
+            `  ${f} [${this.dataChecked ? 'x' : ' '}] ${item}`,
+            '      Google to collect and use my Interactions data,',
+            '      subject to the Google Antigravity CLI Terms of Service',
+            '      and Google Privacy Policy. I understand I can',
+            '      choose to opt out later whenever I want via my',
+            '      settings.',
+            '',
+            '      Links:',
+            '      - Terms of Service: https://antigravity.google/terms',
+            '      - Privacy Policy: https://policies.google.com/privacy',
+            '',
+            buttons,
+            '',
+            '',
+            '  ↑/↓ Navigate · enter Toggle',
+        ].join('\n');
+    }
+}
+//# sourceMappingURL=fake-agy-tui.fixture.js.map

package/dist/backend/backend/src/services/runtime-terms/fake-agy-tui.fixture.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fake-agy-tui.fixture.js","sourceRoot":"","sources":["../../../../../../backend/src/services/runtime-terms/fake-agy-tui.fixture.ts"],"names":[],"mappings":"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"}

package/dist/backend/backend/src/services/runtime-terms/runtime-terms-consent.service.d.ts

@@ -0,0 +1,245 @@
+/**
+ * Owner consent for a runtime's first-run Terms of Service.
+ *
+ * The harness never accepts third-party terms on its own. When a runtime's
+ * Terms screen is seen (on launch, by the smoke test, or on a probe), ONE
+ * decision card per runtime per machine goes to the owner's DM with this
+ * machine's orc bot: "Agree, no data sharing" / "Agree + share data" /
+ * "Don't agree", 24 h, default Don't agree. On the answer:
+ *
+ * - agree: launch the runtime in a dedicated PTY session, drive its setup
+ *   screens to the choice (data box verified on screen before Done), check
+ *   the prompt appears, close the session, run the runtime smoke test and
+ *   report both in the card's thread;
+ * - don't agree (or no answer): mark the runtime "terms not accepted" so the
+ *   fallback order skips it (reason shown in Settings → Runtimes); asked
+ *   again only when the owner presses Test, re-adds it, or Accept terms….
+ *
+ * specs/2026-10-01-runtime-terms-consent.md
+ *
+ * @module services/runtime-terms/runtime-terms-consent.service
+ */
+import type { OwnerDecision } from '../../types/decision.types.js';
+import { type ComponentLogger } from '../core/logger.service.js';
+import type { SystemAskInput } from '../decisions/decision.service.js';
+import type { SmokeTestResult } from '../runtime-fallback/runtime-smoke-test.service.js';
+import type { TermsDriveResult, TermsTerminal } from './antigravity-terms-driver.js';
+import type { RuntimeTermsRecord, RuntimeTermsStore } from './runtime-terms.store.js';
+/** The owner's three answers. */
+export type TermsChoice = 'agree_no_data' | 'agree_share_data' | 'decline';
+/** Card text of a runtime. */
+export interface TermsCardText {
+    title: string;
+    question: string;
+    body: string[];
+}
+/** What Settings shows next to the inline choices. */
+export interface TermsInfo {
+    /** One plain-English sentence on what is asked */
+    summary: string;
+    /** The pre-checked data-sharing item, verbatim */
+    dataItem: string;
+    links: Array<{
+        label: string;
+        url: string;
+    }>;
+}
+/** What the service knows about one runtime's Terms screens. */
+export interface RuntimeTermsProfile {
+    runtime: string;
+    label: string;
+    info: TermsInfo;
+    /** Card text for this machine */
+    card(machine: string): TermsCardText;
+    /** Drive the setup screens of a freshly launched runtime */
+    drive(term: TermsTerminal, shareData: boolean): Promise<TermsDriveResult>;
+    /** What a screen shows: the Terms / setup screens, the ready prompt, a refusal, or not yet known */
+    classify(screen: string): 'terms' | 'ready' | 'blocked' | 'unknown';
+}
+/** Result of {@link RuntimeTermsConsentService.probe}. */
+export interface TermsProbeResult {
+    outcome: 'terms' | 'ready' | 'blocked' | 'unknown';
+    record: RuntimeTermsRecord | null;
+    /** Screen text at the end (secrets redacted) */
+    screen: string;
+}
+/** A launched dedicated session. */
+export interface TermsSession {
+    terminal: TermsTerminal;
+    /** Leave the runtime and kill the session (always called) */
+    close(): Promise<void>;
+}
+/** The decision-card calls used. */
+export interface TermsDecisionApi {
+    askSystem(input: SystemAskInput): Promise<OwnerDecision>;
+    get(id: string): Promise<OwnerDecision | null>;
+    chooseFromDashboard(id: string, optionKey: string): Promise<OwnerDecision>;
+    replyInThread(id: string, text: string): Promise<boolean>;
+}
+/** Dependencies. */
+export interface RuntimeTermsDeps {
+    store: RuntimeTermsStore;
+    decisions: () => TermsDecisionApi | null;
+    profiles: Record<string, RuntimeTermsProfile>;
+    /** Launch the runtime in the harness's dedicated session */
+    launch: (runtime: string) => Promise<TermsSession>;
+    /** Kill the dedicated session if it is running (Don't agree) */
+    closeSession?: (runtime: string) => Promise<void>;
+    runSmokeTest: (runtime: string) => Promise<SmokeTestResult>;
+    machineName: () => string;
+    /** A runtime's consent changed (availability caches) */
+    onChange?: (runtime: string) => void;
+    now?: () => Date;
+    sleep?: (ms: number) => Promise<void>;
+    /** How long a probe waits for a recognisable screen */
+    probeTimeoutMs?: number;
+    logger?: ComponentLogger;
+}
+/** How a report was triggered. */
+export interface TermsReport {
+    /** launch | smoke_test | probe | settings | chain */
+    source: string;
+    /** The owner asked (Test, Accept terms…, re-added): re-ask even after Don't agree */
+    ownerInitiated?: boolean;
+}
+/** A runtime's Terms state as the API shows it. */
+export interface RuntimeTermsView extends Omit<RuntimeTermsRecord, 'status' | 'updatedAt'> {
+    /** `none` = never seen a Terms screen on this machine */
+    status: RuntimeTermsRecord['status'] | 'none';
+    updatedAt?: string;
+    label: string;
+    info: TermsInfo;
+    /** Why the runtime is skipped, when it is */
+    blockedReason: string | null;
+    /** Choices the inline Settings action offers */
+    choices: Array<{
+        choice: TermsChoice;
+        label: string;
+    }>;
+}
+/** Choice ↔ button label. */
+export declare const TERMS_CHOICE_LABELS: Readonly<Record<TermsChoice, string>>;
+/**
+ * The choice an option label means.
+ *
+ * @param label - Button label
+ * @returns Choice, or null
+ */
+export declare function choiceOfLabel(label: string | undefined): TermsChoice | null;
+/**
+ * Screen text for a Slack code block: secrets redacted, last lines only, no
+ * fence breakers.
+ *
+ * @param screen - Screen text
+ * @returns Block text
+ */
+export declare function screenForThread(screen: string): string;
+/** The service. */
+export declare class RuntimeTermsConsentService {
+    private readonly deps;
+    private readonly logger;
+    private readonly now;
+    /** Serialises asks per runtime (launch + smoke test can report at once) */
+    private readonly asking;
+    /** Running accept / decline per runtime */
+    private readonly running;
+    /**
+     * @param deps - Dependencies
+     */
+    constructor(deps: RuntimeTermsDeps);
+    /**
+     * Whether the service handles a runtime.
+     *
+     * @param runtime - Runtime id
+     * @returns True when it has a profile
+     */
+    supports(runtime: string): boolean;
+    /**
+     * A runtime's Terms screen was seen: ask the owner, once.
+     *
+     * No new card while one is open or the harness is accepting; none after
+     * Don't agree / a failed attempt unless the owner asked
+     * (`ownerInitiated`).
+     *
+     * @param runtime - Runtime id
+     * @param report - Source
+     * @returns The record, or null for a runtime without a profile
+     */
+    reportTermsScreen(runtime: string, report: TermsReport): Promise<RuntimeTermsRecord | null>;
+    /**
+     * Settings → Runtimes → Accept terms…: post the card (or return the open one).
+     *
+     * @param runtime - Runtime id
+     * @returns The record
+     * @throws Error for a runtime without Terms handling
+     */
+    requestConsent(runtime: string): Promise<RuntimeTermsRecord>;
+    /**
+     * Probe: launch the runtime in the dedicated session, read (never press
+     * anything) until the screen is recognisable, close it. A Terms screen
+     * asks the owner (the owner asked for the check); a ready prompt means
+     * the Terms were accepted here already (e.g. in a terminal).
+     *
+     * @param runtime - Runtime id
+     * @returns What was on screen and the record after
+     * @throws Error while an answer is being applied, or for a runtime without a profile
+     */
+    probe(runtime: string): Promise<TermsProbeResult>;
+    /**
+     * Answer inline from Settings: through the open card when there is one
+     * (so the card updates), else directly.
+     *
+     * @param runtime - Runtime id
+     * @param choice - Owner's choice
+     * @returns The record after the answer was taken (driving continues in the background)
+     */
+    answer(runtime: string, choice: TermsChoice): Promise<RuntimeTermsRecord>;
+    /**
+     * The `runtime_terms` decision-kind handler
+     * (`DecisionService.registerKindHandler`): acts on the answer. No agent
+     * asked, so there is no note for one.
+     *
+     * @param d - Settled decision
+     * @returns null (nothing to deliver)
+     */
+    onSettled(d: OwnerDecision): Promise<null>;
+    /**
+     * A decision was settled: act on runtime-terms ones.
+     *
+     * @param d - Settled decision
+     */
+    handleSettled(d: OwnerDecision): void;
+    /**
+     * Why a runtime cannot be used because of its Terms (null = it can).
+     *
+     * @param runtime - Runtime id
+     * @returns Owner-facing reason, or null
+     */
+    blockedReason(runtime: string): string | null;
+    /** @returns Every runtime with a Terms flow, with its record */
+    list(): RuntimeTermsView[];
+    /**
+     * Wait for a running accept / decline (tests, the API's `?wait=1`).
+     *
+     * @param runtime - Runtime id
+     */
+    whenIdle(runtime: string): Promise<void>;
+    private askOnce;
+    private start;
+    private decline;
+    private accept;
+    private reply;
+    private save;
+}
+/** @returns The backend's instance, or null before wiring (and in tests) */
+export declare function getRuntimeTermsConsentService(): RuntimeTermsConsentService | null;
+/** @param service - Instance to install (null clears) */
+export declare function setRuntimeTermsConsentService(service: RuntimeTermsConsentService | null): void;
+/**
+ * Report a Terms screen to the backend's service, when wired (fire and forget).
+ *
+ * @param runtime - Runtime id
+ * @param report - Source
+ */
+export declare function reportRuntimeTermsScreen(runtime: string, report: TermsReport): void;
+//# sourceMappingURL=runtime-terms-consent.service.d.ts.map

package/dist/backend/backend/src/services/runtime-terms/runtime-terms-consent.service.d.ts.map

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