@joeytheman/gemini-mcp-tool 1.3.0 → 2.2.0

package/dist/tools/simple-tools.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"simple-tools.d.ts","sourceRoot":"","sources":["../../src/tools/simple-tools.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAO5C,eAAO,MAAM,QAAQ,EAAE,WAiBtB,CAAC;AAIF,eAAO,MAAM,QAAQ,EAAE,WAgBtB,CAAC"}
+{"version":3,"file":"simple-tools.d.ts","sourceRoot":"","sources":["../../src/tools/simple-tools.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAO5C,eAAO,MAAM,QAAQ,EAAE,WAmBtB,CAAC;AAIF,eAAO,MAAM,QAAQ,EAAE,WAgBtB,CAAC"}

package/dist/tools/simple-tools.js

@@ -18,7 +18,9 @@ export const pingTool = {
     },
     execute: async (args, onProgress) => {
         const message = args.prompt || args.message || "Pong!";
-        return executeCommand("echo", [message], onProgress);
+        const text = message;
+        onProgress?.(text);
+        return text;
     }
 };
 const helpArgsSchema = z.object({});
@@ -36,7 +38,7 @@ export const helpTool = {
         openWorldHint: true,
     },
     execute: async (args, onProgress) => {
-        return executeCommand("gemini", ["-help"], onProgress);
+        return executeCommand("agy", ["--help"], onProgress);
     }
 };
 //# sourceMappingURL=simple-tools.js.map

package/dist/tools/simple-tools.js.map

@@ -1 +1 @@
-{"version":3,"file":"simple-tools.js","sourceRoot":"","sources":["../../src/tools/simple-tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAE7D,MAAM,cAAc,GAAG,CAAC,CAAC,MAAM,CAAC;IAC9B,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,kBAAkB,CAAC;CAC5D,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,QAAQ,GAAgB;IACnC,IAAI,EAAE,MAAM;IACZ,WAAW,EAAE,MAAM;IACnB,SAAS,EAAE,cAAc;IACzB,MAAM,EAAE;QACN,WAAW,EAAE,6CAA6C;KAC3D;IACD,QAAQ,EAAE,QAAQ;IAClB,WAAW,EAAE;QACX,KAAK,EAAE,MAAM;QACb,YAAY,EAAE,IAAI;QAClB,cAAc,EAAE,IAAI;KACrB;IACD,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,UAAU,EAAE,EAAE;QAClC,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC;QACvD,OAAO,cAAc,CAAC,MAAM,EAAE,CAAC,OAAiB,CAAC,EAAE,UAAU,CAAC,CAAC;IACjE,CAAC;CACF,CAAC;AAEF,MAAM,cAAc,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;AAEpC,MAAM,CAAC,MAAM,QAAQ,GAAgB;IACnC,IAAI,EAAE,MAAM;IACZ,WAAW,EAAE,0BAA0B;IACvC,SAAS,EAAE,cAAc;IACzB,MAAM,EAAE;QACN,WAAW,EAAE,0BAA0B;KACxC;IACD,QAAQ,EAAE,QAAQ;IAClB,WAAW,EAAE;QACX,KAAK,EAAE,MAAM;QACb,YAAY,EAAE,IAAI;QAClB,aAAa,EAAE,IAAI;KACpB;IACD,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,UAAU,EAAE,EAAE;QAClC,OAAO,cAAc,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,EAAE,UAAU,CAAC,CAAC;IACzD,CAAC;CACF,CAAC"}
+{"version":3,"file":"simple-tools.js","sourceRoot":"","sources":["../../src/tools/simple-tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAE7D,MAAM,cAAc,GAAG,CAAC,CAAC,MAAM,CAAC;IAC9B,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,kBAAkB,CAAC;CAC5D,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,QAAQ,GAAgB;IACnC,IAAI,EAAE,MAAM;IACZ,WAAW,EAAE,MAAM;IACnB,SAAS,EAAE,cAAc;IACzB,MAAM,EAAE;QACN,WAAW,EAAE,6CAA6C;KAC3D;IACD,QAAQ,EAAE,QAAQ;IAClB,WAAW,EAAE;QACX,KAAK,EAAE,MAAM;QACb,YAAY,EAAE,IAAI;QAClB,cAAc,EAAE,IAAI;KACrB;IACD,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,UAAU,EAAE,EAAE;QAClC,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC;QACvD,MAAM,IAAI,GAAG,OAAiB,CAAC;QAC/B,UAAU,EAAE,CAAC,IAAI,CAAC,CAAC;QACnB,OAAO,IAAI,CAAC;IACd,CAAC;CACF,CAAC;AAEF,MAAM,cAAc,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;AAEpC,MAAM,CAAC,MAAM,QAAQ,GAAgB;IACnC,IAAI,EAAE,MAAM;IACZ,WAAW,EAAE,0BAA0B;IACvC,SAAS,EAAE,cAAc;IACzB,MAAM,EAAE;QACN,WAAW,EAAE,0BAA0B;KACxC;IACD,QAAQ,EAAE,QAAQ;IAClB,WAAW,EAAE;QACX,KAAK,EAAE,MAAM;QACb,YAAY,EAAE,IAAI;QAClB,aAAa,EAAE,IAAI;KACpB;IACD,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,UAAU,EAAE,EAAE;QAClC,OAAO,cAAc,CAAC,KAAK,EAAE,CAAC,QAAQ,CAAC,EAAE,UAAU,CAAC,CAAC;IACvD,CAAC;CACF,CAAC"}

package/dist/utils/agyExecutor.d.ts

@@ -0,0 +1,68 @@
+import { type ZodType } from 'zod';
+export interface AgyCLIOptions {
+    model?: string;
+    sandbox?: boolean;
+    changeMode?: boolean;
+    yolo?: boolean;
+    approvalMode?: string;
+    outputFormat?: string;
+    jsonSchema?: string;
+    effort?: string;
+    includeDirectories?: string | string[];
+    debug?: boolean;
+    printTimeout?: string;
+    promptInteractive?: string;
+    extensions?: string | string[];
+    resume?: boolean | string;
+    conversationId?: string;
+    noCache?: boolean;
+    cwd?: string;
+}
+export interface AgyUsage {
+    input_tokens?: number;
+    output_tokens?: number;
+    thinking_tokens?: number;
+    cache_read_tokens?: number;
+    total_tokens?: number;
+}
+export interface AgyDeniedAction {
+    action?: string;
+    display_name?: string;
+}
+/** One line of `agy --output-format json` output. */
+export interface AgyJsonEnvelope {
+    conversation_id?: string;
+    status?: string;
+    response?: string;
+    error?: string;
+    structured_output?: unknown;
+    num_turns?: number;
+    duration_seconds?: number;
+    usage?: AgyUsage;
+    denied_actions?: AgyDeniedAction[];
+}
+/**
+ * The conversation this call asked agy to resume, if any. `resume` with a bare
+ * ID maps to the same `--conversation` flag as `conversationId`, so both must be
+ * checked against what agy actually returned.
+ */
+export declare function requestedConversationId(opts: AgyCLIOptions): string | undefined;
+export declare function parseAgyJsonEnvelope(stdout: string): AgyJsonEnvelope;
+/** Human-readable "DisplayName (action)" list of the actions agy refused to run. */
+export declare function deniedActionsSummary(envelope: AgyJsonEnvelope): string;
+export declare function formatAgyUsageLine(envelope: AgyJsonEnvelope): string;
+/**
+ * Render an envelope for a human reader. A resumed turn replays the PREVIOUS
+ * turn's structured_output, so it is only trusted when this call passed a schema.
+ */
+export declare function renderAgyJsonEnvelope(envelope: AgyJsonEnvelope, opts?: {
+    hadSchema?: boolean;
+}): string;
+export declare function formatConversationLine(conversationId: string): string;
+/** A zod schema as the JSON Schema agy's `--json-schema` accepts (no `$schema` key). */
+export declare function toAgyJsonSchema(schema: ZodType): Record<string, unknown>;
+export declare function executeAgyCLI(prompt: string, options: AgyCLIOptions | string, onProgress?: (newOutput: string) => void): Promise<string>;
+/** Run agy in json mode and return the parsed envelope. */
+export declare function executeAgyJson(prompt: string, options?: AgyCLIOptions, onProgress?: (newOutput: string) => void): Promise<AgyJsonEnvelope>;
+export declare function processChangeModeOutput(rawResult: string, chunkIndex?: number, chunkCacheKey?: string, prompt?: string): Promise<string>;
+//# sourceMappingURL=agyExecutor.d.ts.map

package/dist/utils/agyExecutor.d.ts.map

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

package/dist/utils/agyExecutor.js

@@ -0,0 +1,443 @@
+import { z } from 'zod';
+import { executeCommand } from './commandExecutor.js';
+import { Logger } from './logger.js';
+import { ERROR_MESSAGES, MODELS, CLI, AGY_INTERNAL, LIVE_PASS } from '../constants.js';
+import { parseChangeModeOutput, validateChangeModeEdits } from './changeModeParser.js';
+import { formatChangeModeResponse, summarizeChangeModeEdits } from './changeModeTranslator.js';
+import { chunkChangeModeEdits } from './changeModeChunker.js';
+import { cacheChunks, getChunks } from './chunkCache.js';
+import { generateCacheKey, getCachedResponse, cacheResponse, isCacheEnabled } from './responseCache.js';
+import { normalizeList, resolveFileReferences, isFilesystemRoot } from './fileReferences.js';
+import { recoverFromTranscript, isRecoverableEmptyOutput } from './agyTranscriptRecovery.js';
+const AGY_STATUS_SUCCESS = 'SUCCESS';
+const AGY_STATUS_ERROR = 'ERROR';
+const PARSE_EXCERPT_CHARS = 200;
+function isYoloEnabled(opts) {
+    return Boolean(opts.yolo) || opts.approvalMode === CLI.DEFAULTS.APPROVAL_MODE_YOLO;
+}
+function isJsonMode(opts) {
+    return opts.outputFormat === CLI.DEFAULTS.OUTPUT_FORMAT_JSON;
+}
+function validateAgyOptions(opts) {
+    const unsupported = [];
+    if (opts.debug)
+        unsupported.push('debug');
+    if (opts.promptInteractive)
+        unsupported.push('promptInteractive');
+    if (opts.extensions)
+        unsupported.push('extensions');
+    if (opts.approvalMode && opts.approvalMode !== CLI.DEFAULTS.APPROVAL_MODE_YOLO) {
+        unsupported.push(`approvalMode:${opts.approvalMode}`);
+    }
+    if (unsupported.length > 0) {
+        throw new Error(`${ERROR_MESSAGES.UNSUPPORTED_AGY_OPTIONS}: ${unsupported.join(', ')}. ` +
+            `The Antigravity CLI headless path supports model, sandbox, yolo, includeDirectories, printTimeout, ` +
+            `resume, conversationId, outputFormat, jsonSchema, effort, and workingDirectory.`);
+    }
+    if (opts.outputFormat &&
+        opts.outputFormat !== CLI.DEFAULTS.OUTPUT_FORMAT_TEXT &&
+        opts.outputFormat !== CLI.DEFAULTS.OUTPUT_FORMAT_JSON) {
+        throw new Error(`${ERROR_MESSAGES.UNSUPPORTED_OUTPUT_FORMAT} Received '${opts.outputFormat}'.`);
+    }
+    if (opts.jsonSchema && !isJsonMode(opts)) {
+        throw new Error(ERROR_MESSAGES.JSON_SCHEMA_REQUIRES_JSON);
+    }
+    // Passthrough only: agy rejects --effort for tiered Gemini names and that
+    // error is surfaced verbatim. We only guard the shape.
+    if (opts.effort && !CLI.DEFAULTS.EFFORT_LEVELS.includes(opts.effort)) {
+        throw new Error(`${ERROR_MESSAGES.INVALID_EFFORT} Received '${opts.effort}'.`);
+    }
+    if (opts.changeMode && isJsonMode(opts)) {
+        throw new Error(`${ERROR_MESSAGES.UNSUPPORTED_AGY_OPTIONS}: changeMode with outputFormat 'json'. ` +
+            `changeMode returns OLD/NEW text, not a JSON envelope.`);
+    }
+    if (opts.conversationId !== undefined && !opts.conversationId.trim()) {
+        throw new Error(ERROR_MESSAGES.INVALID_CONVERSATION_ID);
+    }
+    // Refuse yolo (skip-permissions) from a filesystem root, which would grant agy
+    // unrestricted access to the whole drive. Check the effective cwd: when
+    // workingDirectory is omitted, agy inherits the server's process.cwd().
+    if (isYoloEnabled(opts) && isFilesystemRoot(opts.cwd || process.cwd())) {
+        throw new Error(ERROR_MESSAGES.UNSAFE_ROOT_YOLO);
+    }
+}
+function resolveResumeArgs(resume) {
+    if (resume === undefined || resume === false)
+        return [];
+    const normalized = String(resume).trim();
+    const lower = normalized.toLowerCase();
+    if (lower === CLI.DEFAULTS.BOOLEAN_FALSE)
+        return [];
+    if (normalized === '') {
+        throw new Error(ERROR_MESSAGES.INVALID_RESUME);
+    }
+    if (resume === true ||
+        lower === CLI.DEFAULTS.BOOLEAN_TRUE ||
+        lower === CLI.DEFAULTS.RESUME_LATEST ||
+        lower === CLI.DEFAULTS.RESUME_CONTINUE) {
+        return [CLI.FLAGS.CONTINUE];
+    }
+    return [CLI.FLAGS.CONVERSATION, normalized];
+}
+/**
+ * The conversation this call asked agy to resume, if any. `resume` with a bare
+ * ID maps to the same `--conversation` flag as `conversationId`, so both must be
+ * checked against what agy actually returned.
+ */
+export function requestedConversationId(opts) {
+    const explicit = opts.conversationId?.trim();
+    if (explicit)
+        return explicit;
+    const args = resolveResumeArgs(opts.resume);
+    return args[0] === CLI.FLAGS.CONVERSATION ? args[1] : undefined;
+}
+/** An explicit conversationId wins over `resume`. */
+function resolveConversationArgs(opts) {
+    const explicit = opts.conversationId?.trim();
+    if (explicit)
+        return [CLI.FLAGS.CONVERSATION, explicit];
+    return resolveResumeArgs(opts.resume);
+}
+function buildAgyArgs(opts, prompt, refDirs) {
+    const args = [];
+    const model = opts.model || MODELS.DEFAULT;
+    args.push(CLI.FLAGS.MODEL, model);
+    if (opts.effort) {
+        args.push(CLI.FLAGS.EFFORT, opts.effort);
+    }
+    if (opts.sandbox) {
+        args.push(CLI.FLAGS.SANDBOX);
+    }
+    if (isYoloEnabled(opts)) {
+        args.push(CLI.FLAGS.YOLO);
+    }
+    // Explicit includeDirectories plus the directories resolved from @file
+    // references, deduped.
+    for (const dir of new Set([...normalizeList(opts.includeDirectories), ...refDirs])) {
+        args.push(CLI.FLAGS.ADD_DIR, dir);
+    }
+    if (opts.printTimeout) {
+        args.push(CLI.FLAGS.PRINT_TIMEOUT, opts.printTimeout);
+    }
+    if (isJsonMode(opts)) {
+        args.push(CLI.FLAGS.OUTPUT_FORMAT, CLI.DEFAULTS.OUTPUT_FORMAT_JSON);
+        // The schema is passed inline (~2 KB); agy takes it as a flag value.
+        if (opts.jsonSchema) {
+            args.push(CLI.FLAGS.JSON_SCHEMA, opts.jsonSchema);
+        }
+    }
+    args.push(...resolveConversationArgs(opts));
+    args.push(CLI.FLAGS.PRINT, prompt);
+    return args;
+}
+const CONTROL_ESCAPES = { '\n': '\\n', '\r': '\\r', '\t': '\\t' };
+/** Escape raw newlines/tabs that appear INSIDE JSON string literals, which JSON.parse rejects. */
+function escapeControlCharsInStrings(raw) {
+    let out = '';
+    let inString = false;
+    let escaped = false;
+    for (const ch of raw) {
+        if (inString && escaped) {
+            out += ch;
+            escaped = false;
+            continue;
+        }
+        if (inString && ch === '\\') {
+            out += ch;
+            escaped = true;
+            continue;
+        }
+        if (ch === '"') {
+            inString = !inString;
+            out += ch;
+            continue;
+        }
+        out += (inString && CONTROL_ESCAPES[ch]) ? CONTROL_ESCAPES[ch] : ch;
+    }
+    return out;
+}
+/**
+ * Parse the JSON envelope out of `agy --output-format json` stdout. agy may
+ * print progress lines first, so the envelope is whatever starts at the last
+ * line beginning with `{`.
+ */
+/**
+ * An agy envelope, not merely any JSON object: `{}` must read as a parse
+ * failure rather than a verified, cacheable, empty success.
+ */
+function isAgyEnvelope(value) {
+    if (!value || typeof value !== 'object' || Array.isArray(value))
+        return false;
+    const candidate = value;
+    if (candidate.status === AGY_STATUS_ERROR)
+        return true;
+    // An ERROR can arrive before agy has a conversation, so only a SUCCESS is
+    // required to carry the id. Either way a bare `{}` is a parse failure, not an
+    // empty success.
+    return candidate.status === AGY_STATUS_SUCCESS && typeof candidate.conversation_id === 'string';
+}
+function tryParseEnvelope(candidate) {
+    for (const text of [candidate, escapeControlCharsInStrings(candidate)]) {
+        try {
+            const parsed = JSON.parse(text);
+            if (isAgyEnvelope(parsed))
+                return parsed;
+        }
+        catch {
+            // Try the next form.
+        }
+    }
+    return null;
+}
+export function parseAgyJsonEnvelope(stdout) {
+    const lines = stdout.split('\n');
+    // The envelope is the last JSON object agy printed, so start from the last
+    // `{` line and walk backwards: when that line turns out to sit INSIDE the
+    // envelope's own `response` (raw newlines plus quoted JSON), the earlier real
+    // start line still parses. Progress lines printed before it are never reached.
+    for (let index = lines.length - 1; index >= 0; index--) {
+        if (!lines[index].trimStart().startsWith('{'))
+            continue;
+        const envelope = tryParseEnvelope(lines.slice(index).join('\n').trim());
+        if (envelope)
+            return envelope;
+    }
+    throw new Error(`${ERROR_MESSAGES.AGY_JSON_PARSE}. Output began: ${stdout.trim().slice(0, PARSE_EXCERPT_CHARS)}`);
+}
+/** Human-readable "DisplayName (action)" list of the actions agy refused to run. */
+export function deniedActionsSummary(envelope) {
+    return (envelope.denied_actions ?? [])
+        .map(denied => `${denied.display_name || denied.action || 'unknown'} (${denied.action || 'unknown'})`)
+        .join(', ');
+}
+export function formatAgyUsageLine(envelope) {
+    const usage = envelope.usage ?? {};
+    return `Usage: ${envelope.num_turns ?? '?'} turns · ${envelope.duration_seconds ?? '?'}s · tokens in ` +
+        `${usage.input_tokens ?? 0} / out ${usage.output_tokens ?? 0} / thinking ${usage.thinking_tokens ?? 0} / ` +
+        `cache ${usage.cache_read_tokens ?? 0} / total ${usage.total_tokens ?? 0}`;
+}
+/**
+ * Render an envelope for a human reader. A resumed turn replays the PREVIOUS
+ * turn's structured_output, so it is only trusted when this call passed a schema.
+ */
+export function renderAgyJsonEnvelope(envelope, opts = {}) {
+    if (opts.hadSchema && envelope.structured_output !== undefined && envelope.structured_output !== null) {
+        return JSON.stringify(envelope.structured_output, null, 2);
+    }
+    return envelope.response ?? '';
+}
+export function formatConversationLine(conversationId) {
+    return `${LIVE_PASS.CONVERSATION_LINE_PREFIX}${conversationId}]`;
+}
+/** A zod schema as the JSON Schema agy's `--json-schema` accepts (no `$schema` key). */
+export function toAgyJsonSchema(schema) {
+    const { $schema, ...rest } = z.toJSONSchema(schema);
+    return rest;
+}
+/**
+ * Validate a json-mode run before it is cached or returned. Throws for every
+ * failure mode agy signals inside an exit-0 envelope.
+ */
+function verifyJsonEnvelope(stdout, opts) {
+    if (stdout.trim() === AGY_INTERNAL.TIMEOUT_SENTINEL) {
+        throw new Error(ERROR_MESSAGES.AGY_NO_OUTPUT);
+    }
+    const envelope = parseAgyJsonEnvelope(stdout);
+    if (envelope.status === AGY_STATUS_ERROR) {
+        throw new Error(`${ERROR_MESSAGES.AGY_STATUS_ERROR}: ${envelope.error || 'no error text'}`);
+    }
+    // A stale or unknown ID only warns on stderr and silently starts a NEW
+    // conversation with status SUCCESS, so compare what came back.
+    const requested = requestedConversationId(opts);
+    if (requested && envelope.conversation_id !== requested) {
+        throw new Error(`${ERROR_MESSAGES.CONVERSATION_NOT_RESUMED} ${requested}; it returned ` +
+            `${envelope.conversation_id || '(none)'}. The ID is unknown to this machine or workspace.`);
+    }
+    const hasContent = Boolean(envelope.response?.trim()) ||
+        (envelope.structured_output !== undefined && envelope.structured_output !== null);
+    const denied = deniedActionsSummary(envelope);
+    if (!hasContent && denied) {
+        throw new Error(`${ERROR_MESSAGES.AGY_DENIED_ACTIONS}: ${denied}`);
+    }
+}
+export async function executeAgyCLI(prompt, options, onProgress) {
+    const opts = typeof options === 'string'
+        ? { model: options }
+        : options || {};
+    validateAgyOptions(opts);
+    // Cache key (computed once) is only used when caching is enabled and the call
+    // is repeatable: changeMode, resumed turns and opt-outs are never cached
+    // because their answer depends on conversation state, not just the prompt.
+    const cacheable = isCacheEnabled() && !opts.changeMode && !opts.resume &&
+        !opts.conversationId && !opts.noCache;
+    const cacheKey = cacheable ? generateCacheKey(prompt, opts) : undefined;
+    if (cacheKey) {
+        const cached = getCachedResponse(cacheKey);
+        if (cached) {
+            Logger.debug('Returning cached response');
+            return cached;
+        }
+    }
+    // Normalize file references and register the directories of any reference
+    // that resolves to a real file under a trusted root, so agy can read them (a
+    // bare @file outside an added dir makes agy hang). Unresolved references are
+    // passed through untouched.
+    const { prompt: resolvedPrompt, addDirs: refDirs } = resolveFileReferences(prompt, { cwd: opts.cwd, includeDirectories: opts.includeDirectories });
+    let processedPrompt = resolvedPrompt;
+    if (opts.changeMode) {
+        const changeModeInstructions = `
+[CHANGEMODE INSTRUCTIONS]
+You are generating code modifications that will be processed by an automated system. The output format is critical because it enables programmatic application of changes without human intervention.
+
+INSTRUCTIONS:
+1. Analyze each provided file thoroughly
+2. Identify locations requiring changes based on the user request
+3. For each change, output in the exact format specified
+4. The OLD section must be EXACTLY what appears in the file (copy-paste exact match)
+5. Provide complete, directly replacing code blocks
+6. Verify line numbers are accurate
+
+CRITICAL REQUIREMENTS:
+1. Output edits in the EXACT format specified below - no deviations
+2. The OLD string MUST be findable with Ctrl+F - it must be a unique, exact match
+3. Include enough surrounding lines to make the OLD string unique
+4. If a string appears multiple times (like </div>), include enough context lines above and below to make it unique
+5. Copy the OLD content EXACTLY as it appears - including all whitespace, indentation, line breaks
+6. Never use partial lines - always include complete lines from start to finish
+
+OUTPUT FORMAT (follow exactly):
+**FILE: [filename]:[line_number]**
+\`\`\`
+OLD:
+[exact code to be replaced - must match file content precisely]
+NEW:
+[new code to insert - complete and functional]
+\`\`\`
+
+EXAMPLE 1 - Simple unique match:
+**FILE: src/utils/helper.js:100**
+\`\`\`
+OLD:
+function getMessage() {
+  return "Hello World";
+}
+NEW:
+function getMessage() {
+  return "Hello Universe!";
+}
+\`\`\`
+
+EXAMPLE 2 - Common tag needing context:
+**FILE: index.html:245**
+\`\`\`
+OLD:
+        </div>
+      </div>
+    </section>
+NEW:
+        </div>
+      </footer>
+    </section>
+\`\`\`
+
+IMPORTANT: The OLD section must be an EXACT copy from the file that can be found with Ctrl+F!
+
+USER REQUEST:
+${processedPrompt}
+`;
+        processedPrompt = changeModeInstructions;
+    }
+    const args = buildAgyArgs(opts, processedPrompt, refDirs);
+    const runStartMs = Date.now();
+    try {
+        const result = await executeCommand(CLI.COMMANDS.AGY, args, onProgress, opts.cwd);
+        // json mode carries its own failure signalling in the envelope, so it is
+        // verified here instead of going through transcript recovery.
+        if (isJsonMode(opts)) {
+            verifyJsonEnvelope(result, opts);
+            if (cacheKey)
+                cacheResponse(cacheKey, result);
+            return result;
+        }
+        // agy can exit 0 with empty/timeout stdout while the real answer is only in
+        // its transcript. Recover BEFORE caching or changeMode parsing.
+        let finalResult = result;
+        if (isRecoverableEmptyOutput(result)) {
+            Logger.debug('agy returned empty/timeout output; attempting transcript recovery');
+            const recovered = recoverFromTranscript({
+                cwd: opts.cwd,
+                conversationId: requestedConversationId(opts),
+                runStartMs,
+            });
+            if (recovered) {
+                finalResult = recovered;
+            }
+            else if (result.trim() === AGY_INTERNAL.TIMEOUT_SENTINEL) {
+                // The timeout sentinel is never a real answer; fail loud.
+                throw new Error(ERROR_MESSAGES.AGY_NO_OUTPUT);
+            }
+            else {
+                // Genuinely empty output (e.g. a changeMode request the model decided
+                // needs no edits). Preserve the legacy soft result rather than erroring.
+                finalResult = '';
+            }
+        }
+        // Never cache an empty result — it is not a useful answer and an empty
+        // string would crash the size-bounded LRU (size 0).
+        if (cacheKey && finalResult) {
+            cacheResponse(cacheKey, finalResult);
+        }
+        return finalResult;
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        if (errorMessage.includes('ENOENT') || errorMessage.includes('command not found')) {
+            throw new Error(ERROR_MESSAGES.AGY_NOT_FOUND);
+        }
+        throw error;
+    }
+}
+/** Run agy in json mode and return the parsed envelope. */
+export async function executeAgyJson(prompt, options = {}, onProgress) {
+    const raw = await executeAgyCLI(prompt, { ...options, outputFormat: CLI.DEFAULTS.OUTPUT_FORMAT_JSON }, onProgress);
+    return parseAgyJsonEnvelope(raw);
+}
+export async function processChangeModeOutput(rawResult, chunkIndex, chunkCacheKey, prompt) {
+    if (chunkIndex && chunkCacheKey) {
+        const cachedChunks = getChunks(chunkCacheKey);
+        if (cachedChunks && chunkIndex > 0 && chunkIndex <= cachedChunks.length) {
+            Logger.debug(`Using cached chunk ${chunkIndex} of ${cachedChunks.length}`);
+            const chunk = cachedChunks[chunkIndex - 1];
+            let result = formatChangeModeResponse(chunk.edits, { current: chunkIndex, total: cachedChunks.length, cacheKey: chunkCacheKey });
+            if (chunkIndex === 1 && chunk.edits.length > 5) {
+                const allEdits = cachedChunks.flatMap(c => c.edits);
+                result = summarizeChangeModeEdits(allEdits) + '\n\n' + result;
+            }
+            return result;
+        }
+        Logger.debug(`Cache miss or invalid chunk index, processing new result`);
+    }
+    const edits = parseChangeModeOutput(rawResult);
+    if (edits.length === 0) {
+        return `No edits found in Gemini's response. Please ensure Gemini uses the OLD/NEW format. \n\n+ ${rawResult}`;
+    }
+    const validation = validateChangeModeEdits(edits);
+    if (!validation.valid) {
+        return `Edit validation failed:\n${validation.errors.join('\n')}`;
+    }
+    const chunks = chunkChangeModeEdits(edits);
+    let cacheKey;
+    if (chunks.length > 1 && prompt) {
+        cacheKey = cacheChunks(prompt, chunks);
+        Logger.debug(`Cached ${chunks.length} chunks with key: ${cacheKey}`);
+    }
+    const returnChunkIndex = (chunkIndex && chunkIndex > 0 && chunkIndex <= chunks.length) ? chunkIndex : 1;
+    const returnChunk = chunks[returnChunkIndex - 1];
+    let result = formatChangeModeResponse(returnChunk.edits, chunks.length > 1 ? { current: returnChunkIndex, total: chunks.length, cacheKey } : undefined);
+    if (returnChunkIndex === 1 && edits.length > 5) {
+        result = summarizeChangeModeEdits(edits, chunks.length > 1) + '\n\n' + result;
+    }
+    Logger.debug(`ChangeMode: Parsed ${edits.length} edits, ${chunks.length} chunks, returning chunk ${returnChunkIndex}`);
+    return result;
+}
+//# sourceMappingURL=agyExecutor.js.map

package/dist/utils/agyExecutor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agyExecutor.js","sourceRoot":"","sources":["../../src/utils/agyExecutor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAgB,MAAM,KAAK,CAAC;AACtC,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EACL,cAAc,EACd,MAAM,EACN,GAAG,EACH,YAAY,EACZ,SAAS,EACV,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EAAE,qBAAqB,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AACvF,OAAO,EAAE,wBAAwB,EAAE,wBAAwB,EAAE,MAAM,2BAA2B,CAAC;AAC/F,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACzD,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACxG,OAAO,EAAE,aAAa,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAC7F,OAAO,EAAE,qBAAqB,EAAE,wBAAwB,EAAE,MAAM,4BAA4B,CAAC;AAgD7F,MAAM,kBAAkB,GAAG,SAAS,CAAC;AACrC,MAAM,gBAAgB,GAAG,OAAO,CAAC;AACjC,MAAM,mBAAmB,GAAG,GAAG,CAAC;AAEhC,SAAS,aAAa,CAAC,IAAmB;IACxC,OAAO,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,YAAY,KAAK,GAAG,CAAC,QAAQ,CAAC,kBAAkB,CAAC;AACrF,CAAC;AAED,SAAS,UAAU,CAAC,IAAmB;IACrC,OAAO,IAAI,CAAC,YAAY,KAAK,GAAG,CAAC,QAAQ,CAAC,kBAAkB,CAAC;AAC/D,CAAC;AAED,SAAS,kBAAkB,CAAC,IAAmB;IAC7C,MAAM,WAAW,GAAa,EAAE,CAAC;IAEjC,IAAI,IAAI,CAAC,KAAK;QAAE,WAAW,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC1C,IAAI,IAAI,CAAC,iBAAiB;QAAE,WAAW,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;IAClE,IAAI,IAAI,CAAC,UAAU;QAAE,WAAW,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IACpD,IAAI,IAAI,CAAC,YAAY,IAAI,IAAI,CAAC,YAAY,KAAK,GAAG,CAAC,QAAQ,CAAC,kBAAkB,EAAE,CAAC;QAC/E,WAAW,CAAC,IAAI,CAAC,gBAAgB,IAAI,CAAC,YAAY,EAAE,CAAC,CAAC;IACxD,CAAC;IAED,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC3B,MAAM,IAAI,KAAK,CACb,GAAG,cAAc,CAAC,uBAAuB,KAAK,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI;YACxE,qGAAqG;YACrG,iFAAiF,CAClF,CAAC;IACJ,CAAC;IAED,IAAI,IAAI,CAAC,YAAY;QACnB,IAAI,CAAC,YAAY,KAAK,GAAG,CAAC,QAAQ,CAAC,kBAAkB;QACrD,IAAI,CAAC,YAAY,KAAK,GAAG,CAAC,QAAQ,CAAC,kBAAkB,EAAE,CAAC;QACxD,MAAM,IAAI,KAAK,CAAC,GAAG,cAAc,CAAC,yBAAyB,cAAc,IAAI,CAAC,YAAY,IAAI,CAAC,CAAC;IAClG,CAAC;IAED,IAAI,IAAI,CAAC,UAAU,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QACzC,MAAM,IAAI,KAAK,CAAC,cAAc,CAAC,yBAAyB,CAAC,CAAC;IAC5D,CAAC;IAED,0EAA0E;IAC1E,uDAAuD;IACvD,IAAI,IAAI,CAAC,MAAM,IAAI,CAAE,GAAG,CAAC,QAAQ,CAAC,aAAmC,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;QAC5F,MAAM,IAAI,KAAK,CAAC,GAAG,cAAc,CAAC,cAAc,cAAc,IAAI,CAAC,MAAM,IAAI,CAAC,CAAC;IACjF,CAAC;IAED,IAAI,IAAI,CAAC,UAAU,IAAI,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QACxC,MAAM,IAAI,KAAK,CACb,GAAG,cAAc,CAAC,uBAAuB,yCAAyC;YAClF,uDAAuD,CACxD,CAAC;IACJ,CAAC;IAED,IAAI,IAAI,CAAC,cAAc,KAAK,SAAS,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,IAAI,EAAE,EAAE,CAAC;QACrE,MAAM,IAAI,KAAK,CAAC,cAAc,CAAC,uBAAuB,CAAC,CAAC;IAC1D,CAAC;IAED,+EAA+E;IAC/E,wEAAwE;IACxE,wEAAwE;IACxE,IAAI,aAAa,CAAC,IAAI,CAAC,IAAI,gBAAgB,CAAC,IAAI,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC;QACvE,MAAM,IAAI,KAAK,CAAC,cAAc,CAAC,gBAAgB,CAAC,CAAC;IACnD,CAAC;AACH,CAAC;AAED,SAAS,iBAAiB,CAAC,MAAyB;IAClD,IAAI,MAAM,KAAK,SAAS,IAAI,MAAM,KAAK,KAAK;QAAE,OAAO,EAAE,CAAC;IAExD,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC;IACzC,MAAM,KAAK,GAAG,UAAU,CAAC,WAAW,EAAE,CAAC;IAEvC,IAAI,KAAK,KAAK,GAAG,CAAC,QAAQ,CAAC,aAAa;QAAE,OAAO,EAAE,CAAC;IACpD,IAAI,UAAU,KAAK,EAAE,EAAE,CAAC;QACtB,MAAM,IAAI,KAAK,CAAC,cAAc,CAAC,cAAc,CAAC,CAAC;IACjD,CAAC;IAED,IAAI,MAAM,KAAK,IAAI;QACjB,KAAK,KAAK,GAAG,CAAC,QAAQ,CAAC,YAAY;QACnC,KAAK,KAAK,GAAG,CAAC,QAAQ,CAAC,aAAa;QACpC,KAAK,KAAK,GAAG,CAAC,QAAQ,CAAC,eAAe,EAAE,CAAC;QACzC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IAC9B,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,YAAY,EAAE,UAAU,CAAC,CAAC;AAC9C,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,uBAAuB,CAAC,IAAmB;IACzD,MAAM,QAAQ,GAAG,IAAI,CAAC,cAAc,EAAE,IAAI,EAAE,CAAC;IAC7C,IAAI,QAAQ;QAAE,OAAO,QAAQ,CAAC;IAC9B,MAAM,IAAI,GAAG,iBAAiB,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC5C,OAAO,IAAI,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AAClE,CAAC;AAED,qDAAqD;AACrD,SAAS,uBAAuB,CAAC,IAAmB;IAClD,MAAM,QAAQ,GAAG,IAAI,CAAC,cAAc,EAAE,IAAI,EAAE,CAAC;IAC7C,IAAI,QAAQ;QAAE,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,YAAY,EAAE,QAAQ,CAAC,CAAC;IACxD,OAAO,iBAAiB,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AACxC,CAAC;AAED,SAAS,YAAY,CAAC,IAAmB,EAAE,MAAc,EAAE,OAAiB;IAC1E,MAAM,IAAI,GAAa,EAAE,CAAC;IAC1B,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,IAAI,MAAM,CAAC,OAAO,CAAC;IAE3C,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;IAElC,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;QAChB,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;IAC3C,CAAC;IAED,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;QACjB,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAC/B,CAAC;IAED,IAAI,aAAa,CAAC,IAAI,CAAC,EAAE,CAAC;QACxB,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC5B,CAAC;IAED,uEAAuE;IACvE,uBAAuB;IACvB,KAAK,MAAM,GAAG,IAAI,IAAI,GAAG,CAAC,CAAC,GAAG,aAAa,CAAC,IAAI,CAAC,kBAAkB,CAAC,EAAE,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC;QACnF,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;IACpC,CAAC;IAED,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;QACtB,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,aAAa,EAAE,IAAI,CAAC,YAAY,CAAC,CAAC;IACxD,CAAC;IAED,IAAI,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QACrB,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,aAAa,EAAE,GAAG,CAAC,QAAQ,CAAC,kBAAkB,CAAC,CAAC;QACpE,qEAAqE;QACrE,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;YACpB,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,WAAW,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC;QACpD,CAAC;IACH,CAAC;IAED,IAAI,CAAC,IAAI,CAAC,GAAG,uBAAuB,CAAC,IAAI,CAAC,CAAC,CAAC;IAE5C,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;IAEnC,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,eAAe,GAA2B,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;AAE1F,kGAAkG;AAClG,SAAS,2BAA2B,CAAC,GAAW;IAC9C,IAAI,GAAG,GAAG,EAAE,CAAC;IACb,IAAI,QAAQ,GAAG,KAAK,CAAC;IACrB,IAAI,OAAO,GAAG,KAAK,CAAC;IACpB,KAAK,MAAM,EAAE,IAAI,GAAG,EAAE,CAAC;QACrB,IAAI,QAAQ,IAAI,OAAO,EAAE,CAAC;YAAC,GAAG,IAAI,EAAE,CAAC;YAAC,OAAO,GAAG,KAAK,CAAC;YAAC,SAAS;QAAC,CAAC;QAClE,IAAI,QAAQ,IAAI,EAAE,KAAK,IAAI,EAAE,CAAC;YAAC,GAAG,IAAI,EAAE,CAAC;YAAC,OAAO,GAAG,IAAI,CAAC;YAAC,SAAS;QAAC,CAAC;QACrE,IAAI,EAAE,KAAK,GAAG,EAAE,CAAC;YAAC,QAAQ,GAAG,CAAC,QAAQ,CAAC;YAAC,GAAG,IAAI,EAAE,CAAC;YAAC,SAAS;QAAC,CAAC;QAC9D,GAAG,IAAI,CAAC,QAAQ,IAAI,eAAe,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,eAAe,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IACtE,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;;;GAIG;AACH;;;GAGG;AACH,SAAS,aAAa,CAAC,KAAc;IACnC,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IAC9E,MAAM,SAAS,GAAG,KAAwB,CAAC;IAC3C,IAAI,SAAS,CAAC,MAAM,KAAK,gBAAgB;QAAE,OAAO,IAAI,CAAC;IACvD,0EAA0E;IAC1E,8EAA8E;IAC9E,iBAAiB;IACjB,OAAO,SAAS,CAAC,MAAM,KAAK,kBAAkB,IAAI,OAAO,SAAS,CAAC,eAAe,KAAK,QAAQ,CAAC;AAClG,CAAC;AAED,SAAS,gBAAgB,CAAC,SAAiB;IACzC,KAAK,MAAM,IAAI,IAAI,CAAC,SAAS,EAAE,2BAA2B,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC;QACvE,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAY,CAAC;YAC3C,IAAI,aAAa,CAAC,MAAM,CAAC;gBAAE,OAAO,MAAM,CAAC;QAC3C,CAAC;QAAC,MAAM,CAAC;YACP,qBAAqB;QACvB,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,MAAc;IACjD,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAEjC,2EAA2E;IAC3E,0EAA0E;IAC1E,8EAA8E;IAC9E,+EAA+E;IAC/E,KAAK,IAAI,KAAK,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,KAAK,IAAI,CAAC,EAAE,KAAK,EAAE,EAAE,CAAC;QACvD,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,SAAS,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC;YAAE,SAAS;QACxD,MAAM,QAAQ,GAAG,gBAAgB,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;QACxE,IAAI,QAAQ;YAAE,OAAO,QAAQ,CAAC;IAChC,CAAC;IAED,MAAM,IAAI,KAAK,CACb,GAAG,cAAc,CAAC,cAAc,mBAAmB,MAAM,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,mBAAmB,CAAC,EAAE,CACjG,CAAC;AACJ,CAAC;AAED,oFAAoF;AACpF,MAAM,UAAU,oBAAoB,CAAC,QAAyB;IAC5D,OAAO,CAAC,QAAQ,CAAC,cAAc,IAAI,EAAE,CAAC;SACnC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,YAAY,IAAI,MAAM,CAAC,MAAM,IAAI,SAAS,KAAK,MAAM,CAAC,MAAM,IAAI,SAAS,GAAG,CAAC;SACrG,IAAI,CAAC,IAAI,CAAC,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,QAAyB;IAC1D,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,IAAI,EAAE,CAAC;IACnC,OAAO,UAAU,QAAQ,CAAC,SAAS,IAAI,GAAG,YAAY,QAAQ,CAAC,gBAAgB,IAAI,GAAG,gBAAgB;QACpG,GAAG,KAAK,CAAC,YAAY,IAAI,CAAC,UAAU,KAAK,CAAC,aAAa,IAAI,CAAC,eAAe,KAAK,CAAC,eAAe,IAAI,CAAC,KAAK;QAC1G,SAAS,KAAK,CAAC,iBAAiB,IAAI,CAAC,YAAY,KAAK,CAAC,YAAY,IAAI,CAAC,EAAE,CAAC;AAC/E,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,qBAAqB,CAAC,QAAyB,EAAE,OAAgC,EAAE;IACjG,IAAI,IAAI,CAAC,SAAS,IAAI,QAAQ,CAAC,iBAAiB,KAAK,SAAS,IAAI,QAAQ,CAAC,iBAAiB,KAAK,IAAI,EAAE,CAAC;QACtG,OAAO,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,iBAAiB,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IAC7D,CAAC;IACD,OAAO,QAAQ,CAAC,QAAQ,IAAI,EAAE,CAAC;AACjC,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,cAAsB;IAC3D,OAAO,GAAG,SAAS,CAAC,wBAAwB,GAAG,cAAc,GAAG,CAAC;AACnE,CAAC;AAED,wFAAwF;AACxF,MAAM,UAAU,eAAe,CAAC,MAAe;IAC7C,MAAM,EAAE,OAAO,EAAE,GAAG,IAAI,EAAE,GAAG,CAAC,CAAC,YAAY,CAAC,MAAM,CAA4B,CAAC;IAC/E,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;GAGG;AACH,SAAS,kBAAkB,CAAC,MAAc,EAAE,IAAmB;IAC7D,IAAI,MAAM,CAAC,IAAI,EAAE,KAAK,YAAY,CAAC,gBAAgB,EAAE,CAAC;QACpD,MAAM,IAAI,KAAK,CAAC,cAAc,CAAC,aAAa,CAAC,CAAC;IAChD,CAAC;IAED,MAAM,QAAQ,GAAG,oBAAoB,CAAC,MAAM,CAAC,CAAC;IAE9C,IAAI,QAAQ,CAAC,MAAM,KAAK,gBAAgB,EAAE,CAAC;QACzC,MAAM,IAAI,KAAK,CAAC,GAAG,cAAc,CAAC,gBAAgB,KAAK,QAAQ,CAAC,KAAK,IAAI,eAAe,EAAE,CAAC,CAAC;IAC9F,CAAC;IAED,uEAAuE;IACvE,+DAA+D;IAC/D,MAAM,SAAS,GAAG,uBAAuB,CAAC,IAAI,CAAC,CAAC;IAChD,IAAI,SAAS,IAAI,QAAQ,CAAC,eAAe,KAAK,SAAS,EAAE,CAAC;QACxD,MAAM,IAAI,KAAK,CACb,GAAG,cAAc,CAAC,wBAAwB,IAAI,SAAS,gBAAgB;YACvE,GAAG,QAAQ,CAAC,eAAe,IAAI,QAAQ,mDAAmD,CAC3F,CAAC;IACJ,CAAC;IAED,MAAM,UAAU,GAAG,OAAO,CAAC,QAAQ,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC;QACnD,CAAC,QAAQ,CAAC,iBAAiB,KAAK,SAAS,IAAI,QAAQ,CAAC,iBAAiB,KAAK,IAAI,CAAC,CAAC;IACpF,MAAM,MAAM,GAAG,oBAAoB,CAAC,QAAQ,CAAC,CAAC;IAC9C,IAAI,CAAC,UAAU,IAAI,MAAM,EAAE,CAAC;QAC1B,MAAM,IAAI,KAAK,CAAC,GAAG,cAAc,CAAC,kBAAkB,KAAK,MAAM,EAAE,CAAC,CAAC;IACrE,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,MAAc,EACd,OAA+B,EAC/B,UAAwC;IAExC,MAAM,IAAI,GAAkB,OAAO,OAAO,KAAK,QAAQ;QACrD,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE;QACpB,CAAC,CAAC,OAAO,IAAI,EAAE,CAAC;IAElB,kBAAkB,CAAC,IAAI,CAAC,CAAC;IAEzB,8EAA8E;IAC9E,yEAAyE;IACzE,2EAA2E;IAC3E,MAAM,SAAS,GAAG,cAAc,EAAE,IAAI,CAAC,IAAI,CAAC,UAAU,IAAI,CAAC,IAAI,CAAC,MAAM;QACpE,CAAC,IAAI,CAAC,cAAc,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC;IACxC,MAAM,QAAQ,GAAG,SAAS,CAAC,CAAC,CAAC,gBAAgB,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IACxE,IAAI,QAAQ,EAAE,CAAC;QACb,MAAM,MAAM,GAAG,iBAAiB,CAAC,QAAQ,CAAC,CAAC;QAC3C,IAAI,MAAM,EAAE,CAAC;YACX,MAAM,CAAC,KAAK,CAAC,2BAA2B,CAAC,CAAC;YAC1C,OAAO,MAAM,CAAC;QAChB,CAAC;IACH,CAAC;IAED,0EAA0E;IAC1E,6EAA6E;IAC7E,6EAA6E;IAC7E,4BAA4B;IAC5B,MAAM,EAAE,MAAM,EAAE,cAAc,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,qBAAqB,CACxE,MAAM,EACN,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,kBAAkB,EAAE,IAAI,CAAC,kBAAkB,EAAE,CAC/D,CAAC;IACF,IAAI,eAAe,GAAG,cAAc,CAAC;IAErC,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;QACpB,MAAM,sBAAsB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA0DjC,eAAe;CAChB,CAAC;QACE,eAAe,GAAG,sBAAsB,CAAC;IAC3C,CAAC;IAED,MAAM,IAAI,GAAG,YAAY,CAAC,IAAI,EAAE,eAAe,EAAE,OAAO,CAAC,CAAC;IAE1D,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAC9B,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,cAAc,CAAC,GAAG,CAAC,QAAQ,CAAC,GAAG,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC;QAElF,yEAAyE;QACzE,8DAA8D;QAC9D,IAAI,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;YACrB,kBAAkB,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;YACjC,IAAI,QAAQ;gBAAE,aAAa,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;YAC9C,OAAO,MAAM,CAAC;QAChB,CAAC;QAED,4EAA4E;QAC5E,gEAAgE;QAChE,IAAI,WAAW,GAAG,MAAM,CAAC;QACzB,IAAI,wBAAwB,CAAC,MAAM,CAAC,EAAE,CAAC;YACrC,MAAM,CAAC,KAAK,CAAC,mEAAmE,CAAC,CAAC;YAClF,MAAM,SAAS,GAAG,qBAAqB,CAAC;gBACtC,GAAG,EAAE,IAAI,CAAC,GAAG;gBACb,cAAc,EAAE,uBAAuB,CAAC,IAAI,CAAC;gBAC7C,UAAU;aACX,CAAC,CAAC;YACH,IAAI,SAAS,EAAE,CAAC;gBACd,WAAW,GAAG,SAAS,CAAC;YAC1B,CAAC;iBAAM,IAAI,MAAM,CAAC,IAAI,EAAE,KAAK,YAAY,CAAC,gBAAgB,EAAE,CAAC;gBAC3D,0DAA0D;gBAC1D,MAAM,IAAI,KAAK,CAAC,cAAc,CAAC,aAAa,CAAC,CAAC;YAChD,CAAC;iBAAM,CAAC;gBACN,sEAAsE;gBACtE,yEAAyE;gBACzE,WAAW,GAAG,EAAE,CAAC;YACnB,CAAC;QACH,CAAC;QAED,uEAAuE;QACvE,oDAAoD;QACpD,IAAI,QAAQ,IAAI,WAAW,EAAE,CAAC;YAC5B,aAAa,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC;QACvC,CAAC;QAED,OAAO,WAAW,CAAC;IACrB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,YAAY,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAC5E,IAAI,YAAY,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,YAAY,CAAC,QAAQ,CAAC,mBAAmB,CAAC,EAAE,CAAC;YAClF,MAAM,IAAI,KAAK,CAAC,cAAc,CAAC,aAAa,CAAC,CAAC;QAChD,CAAC;QACD,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC;AAED,2DAA2D;AAC3D,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,MAAc,EACd,UAAyB,EAAE,EAC3B,UAAwC;IAExC,MAAM,GAAG,GAAG,MAAM,aAAa,CAC7B,MAAM,EACN,EAAE,GAAG,OAAO,EAAE,YAAY,EAAE,GAAG,CAAC,QAAQ,CAAC,kBAAkB,EAAE,EAC7D,UAAU,CACX,CAAC;IACF,OAAO,oBAAoB,CAAC,GAAG,CAAC,CAAC;AACnC,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC3C,SAAiB,EACjB,UAAmB,EACnB,aAAsB,EACtB,MAAe;IAEf,IAAI,UAAU,IAAI,aAAa,EAAE,CAAC;QAChC,MAAM,YAAY,GAAG,SAAS,CAAC,aAAa,CAAC,CAAC;QAC9C,IAAI,YAAY,IAAI,UAAU,GAAG,CAAC,IAAI,UAAU,IAAI,YAAY,CAAC,MAAM,EAAE,CAAC;YACxE,MAAM,CAAC,KAAK,CAAC,sBAAsB,UAAU,OAAO,YAAY,CAAC,MAAM,EAAE,CAAC,CAAC;YAC3E,MAAM,KAAK,GAAG,YAAY,CAAC,UAAU,GAAG,CAAC,CAAC,CAAC;YAC3C,IAAI,MAAM,GAAG,wBAAwB,CACnC,KAAK,CAAC,KAAK,EACX,EAAE,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,YAAY,CAAC,MAAM,EAAE,QAAQ,EAAE,aAAa,EAAE,CAC7E,CAAC;YAEF,IAAI,UAAU,KAAK,CAAC,IAAI,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC/C,MAAM,QAAQ,GAAG,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;gBACpD,MAAM,GAAG,wBAAwB,CAAC,QAAQ,CAAC,GAAG,MAAM,GAAG,MAAM,CAAC;YAChE,CAAC;YAED,OAAO,MAAM,CAAC;QAChB,CAAC;QACD,MAAM,CAAC,KAAK,CAAC,0DAA0D,CAAC,CAAC;IAC3E,CAAC;IAED,MAAM,KAAK,GAAG,qBAAqB,CAAC,SAAS,CAAC,CAAC;IAE/C,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,OAAO,4FAA4F,SAAS,EAAE,CAAC;IACjH,CAAC;IAED,MAAM,UAAU,GAAG,uBAAuB,CAAC,KAAK,CAAC,CAAC;IAClD,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC;QACtB,OAAO,4BAA4B,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;IACpE,CAAC;IAED,MAAM,MAAM,GAAG,oBAAoB,CAAC,KAAK,CAAC,CAAC;IAE3C,IAAI,QAA4B,CAAC;IACjC,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,IAAI,MAAM,EAAE,CAAC;QAChC,QAAQ,GAAG,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACvC,MAAM,CAAC,KAAK,CAAC,UAAU,MAAM,CAAC,MAAM,qBAAqB,QAAQ,EAAE,CAAC,CAAC;IACvE,CAAC;IAED,MAAM,gBAAgB,GAAG,CAAC,UAAU,IAAI,UAAU,GAAG,CAAC,IAAI,UAAU,IAAI,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC;IACxG,MAAM,WAAW,GAAG,MAAM,CAAC,gBAAgB,GAAG,CAAC,CAAC,CAAC;IAEjD,IAAI,MAAM,GAAG,wBAAwB,CACnC,WAAW,CAAC,KAAK,EACjB,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,gBAAgB,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,SAAS,CAC9F,CAAC;IAEF,IAAI,gBAAgB,KAAK,CAAC,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC/C,MAAM,GAAG,wBAAwB,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,GAAG,MAAM,GAAG,MAAM,CAAC;IAChF,CAAC;IAED,MAAM,CAAC,KAAK,CAAC,sBAAsB,KAAK,CAAC,MAAM,WAAW,MAAM,CAAC,MAAM,4BAA4B,gBAAgB,EAAE,CAAC,CAAC;IACvH,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/utils/agyReport.d.ts

@@ -0,0 +1,19 @@
+import { type AgyJsonEnvelope } from './agyExecutor.js';
+import type { WorkingTreeDiff } from './gitStatusGuard.js';
+export declare function bulletList(items: string[]): string;
+export declare function section(title: string, body: string): string;
+/**
+ * The uninvited-edit warning, or '' when the working tree did not change.
+ * Every path that hands Gemini a shell must render this, including the ones
+ * that bail out early.
+ */
+export declare function formatWorkingTreeSection(diff: WorkingTreeDiff): string;
+/**
+ * Rethrow an agy failure with any uninvited edits appended. A run that timed
+ * out or exited non-zero may still have used its shell first, and that warning
+ * must not be lost with the error.
+ */
+export declare function failWithWorkingTree(error: unknown, diff: WorkingTreeDiff): never;
+/** Report for an envelope whose structured_output did not match the tool's result schema. */
+export declare function renderUnparsableEnvelope(envelope: AgyJsonEnvelope, headline: string, issues: string[], subtitle?: string): string;
+//# sourceMappingURL=agyReport.d.ts.map

package/dist/utils/agyReport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agyReport.d.ts","sourceRoot":"","sources":["../../src/utils/agyReport.ts"],"names":[],"mappings":"AAAA,OAAO,EAA8C,KAAK,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACpG,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAS3D,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,CAElD;AAED,wBAAgB,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAE3D;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,eAAe,GAAG,MAAM,CAkBtE;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,eAAe,GAAG,KAAK,CAIhF;AAED,6FAA6F;AAC7F,wBAAgB,wBAAwB,CACtC,QAAQ,EAAE,eAAe,EACzB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EAAE,EAChB,QAAQ,CAAC,EAAE,MAAM,GAChB,MAAM,CAcR"}