doc-detective 4.0.2 → 4.1.1

package/dist/agents/adapters/codex.js

@@ -0,0 +1,299 @@
+import path from "node:path";
+import os from "node:os";
+import fs from "node:fs";
+import axios from "axios";
+import YAML from "yaml";
+import { safeSpawn } from "../spawn-helper.js";
+import { fetchAgentToolsZip } from "../fetcher.js";
+const CANONICAL_SKILL = "doc-detective-init";
+const LATEST_SKILL_URL = "https://raw.githubusercontent.com/doc-detective/agent-tools/main/skills/doc-detective-init/SKILL.md";
+export function defaultCodexDeps() {
+    return {
+        run: (cmd, args) => safeSpawn(cmd, args),
+        existsSync: fs.existsSync,
+        readFileSync: (p, enc = "utf8") => fs.readFileSync(p, enc),
+        readdirSync: (p) => fs.readdirSync(p),
+        mkdirSync: (p, opts) => { fs.mkdirSync(p, opts); },
+        writeFileSync: (p, data) => fs.writeFileSync(p, typeof data === "string" ? data : Buffer.from(data)),
+        rmSync: (p, opts) => { fs.rmSync(p, opts); },
+        homedir: os.homedir,
+        cwd: () => process.cwd(),
+        fetchLatestVersion: async () => {
+            const response = await axios.get(LATEST_SKILL_URL, {
+                timeout: 5000,
+                responseType: "text",
+            });
+            return parseMetadataVersion(String(response?.data ?? ""));
+        },
+        fetchZip: (ref) => fetchAgentToolsZip(ref),
+    };
+}
+export class CodexAdapter {
+    id = "codex";
+    displayName = "Codex";
+    deps;
+    constructor(deps = defaultCodexDeps()) {
+        this.deps = deps;
+    }
+    supportsScopes() {
+        return ["global", "project"];
+    }
+    async detect() {
+        const codexHome = path.join(this.deps.homedir(), ".codex");
+        const projectAgents = path.join(this.deps.cwd(), ".agents");
+        let onPath = false;
+        let version;
+        try {
+            const result = await this.deps.run("codex", ["--version"]);
+            if (result.exitCode === 0 && result.stdout.trim()) {
+                onPath = true;
+                version = result.stdout.trim();
+            }
+        }
+        catch {
+            // Binary absent — silent.
+        }
+        const configPaths = {};
+        if (this.deps.existsSync(codexHome))
+            configPaths.global = codexHome;
+        if (this.deps.existsSync(projectAgents))
+            configPaths.project = projectAgents;
+        const present = onPath || !!configPaths.global || !!configPaths.project;
+        const notes = [];
+        if (!onPath && (configPaths.global || configPaths.project)) {
+            notes.push("`codex` not on PATH; skills will be written to .agents/skills/ and auto-discovered on next Codex launch.");
+        }
+        return {
+            present,
+            onPath,
+            version,
+            configPaths,
+            notes: notes.length ? notes : undefined,
+        };
+    }
+    async getInstallState(scope) {
+        const base = this.queryLocalInstallState(scope);
+        if (!base.installed)
+            return base;
+        return this.enrichWithLatest(base);
+    }
+    skillsRoot(scope) {
+        const root = scope === "global" ? this.deps.homedir() : this.deps.cwd();
+        return path.join(root, ".agents", "skills");
+    }
+    canonicalSkillPath(scope) {
+        return path.join(this.skillsRoot(scope), CANONICAL_SKILL, "SKILL.md");
+    }
+    queryLocalInstallState(scope) {
+        const canonical = this.canonicalSkillPath(scope);
+        if (!this.deps.existsSync(canonical))
+            return { installed: false };
+        try {
+            const raw = this.deps.readFileSync(canonical, "utf8");
+            const version = parseMetadataVersion(raw);
+            return { installed: true, installedVersion: version };
+        }
+        catch {
+            return { installed: false };
+        }
+    }
+    async enrichWithLatest(state) {
+        let latestVersion;
+        try {
+            latestVersion = await this.deps.fetchLatestVersion();
+        }
+        catch {
+            latestVersion = undefined;
+        }
+        if (!latestVersion) {
+            return { ...state, latestVersion: undefined, upToDate: undefined };
+        }
+        const upToDate = state.installedVersion !== undefined
+            ? state.installedVersion === latestVersion
+            : undefined;
+        return { ...state, latestVersion, upToDate };
+    }
+    // Public (readonly) accessor on `deps` so tests can swap dependencies after
+    // construction if needed (e.g., force fetchZip to fail mid-test).
+    get depsRef() {
+        return this.deps;
+    }
+    async install(opts) {
+        const local = this.queryLocalInstallState(opts.scope);
+        const enriched = local.installed ? await this.enrichWithLatest(local) : local;
+        const isInstalled = enriched.installed;
+        const isUpToDate = enriched.upToDate === true;
+        // `upToDate === undefined` means the network probe for the latest
+        // version failed (offline, DNS hiccup, GitHub rate limit). Treat that
+        // as "keep what's on disk" rather than forcing a re-fetch every run —
+        // otherwise every offline re-run downloads the zip and overwrites
+        // files. `--force` still works for explicit refresh.
+        const latestUnknown = isInstalled && enriched.upToDate === undefined;
+        if (isInstalled && !opts.force && (isUpToDate || latestUnknown)) {
+            if (latestUnknown) {
+                opts.logger("Unable to determine the latest Codex skills version; keeping the existing installation. Re-run with --force to refresh explicitly.", "info");
+            }
+            return {
+                adapterId: this.id,
+                scope: opts.scope,
+                action: "already-up-to-date",
+                installedVersion: enriched.installedVersion,
+            };
+        }
+        const target = this.skillsRoot(opts.scope);
+        if (opts.dryRun) {
+            opts.logger(`[dry-run] would fetch doc-detective/agent-tools and copy doc-detective-* skills into ${target}`, "info");
+            return {
+                adapterId: this.id,
+                scope: opts.scope,
+                action: "dry-run",
+                installedVersion: enriched.installedVersion,
+            };
+        }
+        const fetched = await this.deps.fetchZip("main");
+        try {
+            const sourceSkills = path.join(fetched.tempDir, "skills");
+            if (!this.deps.existsSync(sourceSkills)) {
+                throw new Error(`Fetched agent-tools archive has no skills/ directory at ${sourceSkills}.`);
+            }
+            const sourceNames = (this.deps.readdirSync?.(sourceSkills) ?? []).filter((n) => n.startsWith("doc-detective-"));
+            if (sourceNames.length === 0) {
+                throw new Error("Fetched agent-tools archive has no doc-detective-* skills to install.");
+            }
+            // Fall back to the module-level `fs.rmSync` when no rmSync is injected
+            // — required, not optional, because `fs.renameSync` below fails with
+            // EEXIST if the old `dst` is still in place on cross-platform systems.
+            const rmSync = this.deps.rmSync ??
+                ((p, opts) => fs.rmSync(p, opts));
+            this.mkdirp(target);
+            for (const name of sourceNames) {
+                const src = path.join(sourceSkills, name);
+                const dst = path.join(target, name);
+                // Atomic-ish overwrite: copy into a sibling tmp dir, then remove the
+                // old dst and rename tmp into place. If copyDir fails (bad archive
+                // entry, disk full, permissions), the existing skill is untouched.
+                const tmpDst = `${dst}.install.tmp.${process.pid}.${Date.now()}`;
+                if (this.deps.existsSync(tmpDst)) {
+                    rmSync(tmpDst, { recursive: true, force: true });
+                }
+                try {
+                    this.copyDir(src, tmpDst);
+                }
+                catch (err) {
+                    try {
+                        rmSync(tmpDst, { recursive: true, force: true });
+                    }
+                    catch { }
+                    throw err;
+                }
+                if (this.deps.existsSync(dst)) {
+                    rmSync(dst, { recursive: true, force: true });
+                }
+                fs.renameSync(tmpDst, dst);
+                opts.logger(`Copied skill: ${name}`, "debug");
+            }
+            // Read back the newly-installed version from the canonical skill.
+            const installedVersion = this.queryLocalInstallState(opts.scope).installedVersion ??
+                enriched.latestVersion;
+            let action;
+            if (opts.force && isInstalled && isUpToDate)
+                action = "forced";
+            else if (isInstalled)
+                action = "updated";
+            else
+                action = "installed";
+            return {
+                adapterId: this.id,
+                scope: opts.scope,
+                action,
+                installedVersion,
+            };
+        }
+        catch (err) {
+            const reason = err instanceof Error ? err.message : String(err);
+            throw new Error(`Failed to install Codex skills from GitHub: ${reason}`);
+        }
+        finally {
+            // Only clean up the fetched tempDir when the fetcher reports ownership.
+            // Tests that point at a pre-populated source tree set `owned: false` so
+            // their fixtures aren't wiped out of from under them.
+            if (fetched.owned) {
+                // Fall back to the real `fs.rmSync` when deps didn't inject one.
+                // Without this, an undefined `deps.rmSync` would silently leak the
+                // fetched temp archive — the `?.` would short-circuit and drop it.
+                const rm = this.deps.rmSync ??
+                    ((p, opts) => fs.rmSync(p, opts));
+                try {
+                    rm(fetched.tempDir, { recursive: true, force: true });
+                }
+                catch { }
+            }
+        }
+    }
+    mkdirp(p) {
+        if (this.deps.mkdirSync) {
+            this.deps.mkdirSync(p, { recursive: true });
+        }
+        else {
+            fs.mkdirSync(p, { recursive: true });
+        }
+    }
+    /**
+     * Recursive directory copy. Uses `this.deps.readdirSync` and
+     * `this.deps.writeFileSync` where the injected signatures match, but falls
+     * back to `fs.statSync` and buffer-returning `fs.readFileSync` directly —
+     * the `CodexDeps.readFileSync` signature returns a string (UTF-8), so we
+     * can't use it here without losing binary content (images, shell scripts
+     * with executable bits, etc.). Fully-injected recursion would require
+     * widening the deps interface with buffer/stat variants; for the narrow
+     * use case of copying extracted skills the direct fs calls are fine.
+     */
+    copyDir(src, dst) {
+        this.mkdirp(dst);
+        const entries = this.deps.readdirSync?.(src) ?? [];
+        for (const entry of entries) {
+            const from = path.join(src, entry);
+            const to = path.join(dst, entry);
+            const stat = fs.statSync(from);
+            if (stat.isDirectory()) {
+                this.copyDir(from, to);
+            }
+            else {
+                const buf = fs.readFileSync(from);
+                if (this.deps.writeFileSync) {
+                    this.deps.writeFileSync(to, buf);
+                }
+                else {
+                    fs.writeFileSync(to, buf);
+                }
+                // Preserve executable bits (and other mode bits) from the source.
+                // Writing a Buffer doesn't carry these through — shell scripts in
+                // `hooks/scripts/` and similar need this or they won't execute.
+                try {
+                    fs.chmodSync(to, stat.mode);
+                }
+                catch { }
+            }
+        }
+    }
+}
+/**
+ * Parse YAML frontmatter from a SKILL.md body and return metadata.version.
+ * Returns undefined if the front matter is missing, malformed, or lacks the
+ * metadata.version key. Never throws — Codex skills can vary.
+ */
+export function parseMetadataVersion(body) {
+    const match = body.match(/^---\r?\n([\s\S]*?)\r?\n---/);
+    if (!match)
+        return undefined;
+    try {
+        const frontmatter = YAML.parse(match[1]);
+        const v = frontmatter?.metadata?.version;
+        return typeof v === "string" ? v : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+export const codexAdapter = new CodexAdapter();
+//# sourceMappingURL=codex.js.map

package/dist/agents/adapters/codex.js.map

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

package/dist/agents/adapters/copilot-cli.d.ts

@@ -0,0 +1,29 @@
+import type { AgentAdapter, DetectionResult, InstallOptions, InstallReport, InstallState, Scope } from "../types.js";
+export interface RunResult {
+    stdout: string;
+    stderr: string;
+    exitCode: number;
+}
+export interface CopilotCliDeps {
+    run: (cmd: string, args: string[]) => Promise<RunResult>;
+    existsSync: (p: string) => boolean;
+    readFileSync: (p: string, encoding?: BufferEncoding) => string;
+    homedir: () => string;
+    fetchLatestVersion: () => Promise<string | undefined>;
+}
+export declare function defaultCopilotCliDeps(): CopilotCliDeps;
+export declare class CopilotCliAdapter implements AgentAdapter {
+    readonly id = "copilot";
+    readonly displayName = "GitHub Copilot CLI";
+    private deps;
+    constructor(deps?: CopilotCliDeps);
+    supportsScopes(): Scope[];
+    detect(): Promise<DetectionResult>;
+    getInstallState(_scope: Scope): Promise<InstallState>;
+    private pluginJsonPath;
+    private queryLocalInstallState;
+    private enrichWithLatest;
+    install(opts: InstallOptions): Promise<InstallReport>;
+}
+export declare const copilotCliAdapter: AgentAdapter;
+//# sourceMappingURL=copilot-cli.d.ts.map

package/dist/agents/adapters/copilot-cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"copilot-cli.d.ts","sourceRoot":"","sources":["../../../src/agents/adapters/copilot-cli.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,YAAY,EACZ,eAAe,EACf,cAAc,EACd,aAAa,EACb,YAAY,EACZ,KAAK,EACN,MAAM,aAAa,CAAC;AAGrB,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,cAAc;IAC7B,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,OAAO,CAAC,SAAS,CAAC,CAAC;IACzD,UAAU,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC;IACnC,YAAY,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,cAAc,KAAK,MAAM,CAAC;IAC/D,OAAO,EAAE,MAAM,MAAM,CAAC;IACtB,kBAAkB,EAAE,MAAM,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;CACvD;AAQD,wBAAgB,qBAAqB,IAAI,cAAc,CAetD;AAED,qBAAa,iBAAkB,YAAW,YAAY;IACpD,QAAQ,CAAC,EAAE,aAAa;IACxB,QAAQ,CAAC,WAAW,wBAAwB;IAC5C,OAAO,CAAC,IAAI,CAAiB;gBAEjB,IAAI,GAAE,cAAwC;IAI1D,cAAc,IAAI,KAAK,EAAE;IAKnB,MAAM,IAAI,OAAO,CAAC,eAAe,CAAC;IAkClC,eAAe,CAAC,MAAM,EAAE,KAAK,GAAG,OAAO,CAAC,YAAY,CAAC;IAM3D,OAAO,CAAC,cAAc;YAeR,sBAAsB;YAetB,gBAAgB;IAiBxB,OAAO,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC;CA6F5D;AAED,eAAO,MAAM,iBAAiB,EAAE,YAAsC,CAAC"}

package/dist/agents/adapters/copilot-cli.js

@@ -0,0 +1,195 @@
+import path from "node:path";
+import os from "node:os";
+import fs from "node:fs";
+import axios from "axios";
+import { safeSpawn } from "../spawn-helper.js";
+const MARKETPLACE_NAME = "doc-detective";
+const PLUGIN_NAME = "doc-detective";
+const PLUGIN_KEY = `${PLUGIN_NAME}@${MARKETPLACE_NAME}`;
+const LATEST_PLUGIN_JSON_URL = "https://raw.githubusercontent.com/doc-detective/agent-tools/main/plugins/doc-detective/.claude-plugin/plugin.json";
+export function defaultCopilotCliDeps() {
+    return {
+        run: (cmd, args) => safeSpawn(cmd, args),
+        existsSync: fs.existsSync,
+        readFileSync: (p, enc = "utf8") => fs.readFileSync(p, enc),
+        homedir: os.homedir,
+        fetchLatestVersion: async () => {
+            const response = await axios.get(LATEST_PLUGIN_JSON_URL, {
+                timeout: 5000,
+                responseType: "json",
+            });
+            const version = response?.data?.version;
+            return typeof version === "string" ? version : undefined;
+        },
+    };
+}
+export class CopilotCliAdapter {
+    id = "copilot";
+    displayName = "GitHub Copilot CLI";
+    deps;
+    constructor(deps = defaultCopilotCliDeps()) {
+        this.deps = deps;
+    }
+    supportsScopes() {
+        // Copilot CLI's `plugin install` has no --scope flag — always user-global.
+        return ["global"];
+    }
+    async detect() {
+        const copilotHome = path.join(this.deps.homedir(), ".copilot");
+        let onPath = false;
+        let version;
+        try {
+            const result = await this.deps.run("copilot", ["--version"]);
+            if (result.exitCode === 0 && result.stdout.trim()) {
+                onPath = true;
+                version = result.stdout.trim();
+            }
+        }
+        catch {
+            // Binary absent — fall through.
+        }
+        const configPaths = {};
+        if (this.deps.existsSync(copilotHome))
+            configPaths.global = copilotHome;
+        const present = onPath || !!configPaths.global;
+        const notes = [];
+        if (!onPath && configPaths.global) {
+            notes.push("`copilot` not on PATH but ~/.copilot exists; install requires the binary — run `npm install -g @github/copilot`.");
+        }
+        return {
+            present,
+            onPath,
+            version,
+            configPaths,
+            notes: notes.length ? notes : undefined,
+        };
+    }
+    async getInstallState(_scope) {
+        const base = await this.queryLocalInstallState();
+        if (!base.installed)
+            return base;
+        return this.enrichWithLatest(base);
+    }
+    pluginJsonPath() {
+        // Copilot CLI nests the plugin manifest under `.claude-plugin/` inside
+        // the installed plugin directory (verified on disk; the Claude-plugin
+        // format requires a `.claude-plugin/plugin.json` manifest).
+        return path.join(this.deps.homedir(), ".copilot", "installed-plugins", MARKETPLACE_NAME, PLUGIN_NAME, ".claude-plugin", "plugin.json");
+    }
+    async queryLocalInstallState() {
+        const manifestPath = this.pluginJsonPath();
+        if (!this.deps.existsSync(manifestPath))
+            return { installed: false };
+        try {
+            const raw = this.deps.readFileSync(manifestPath, "utf8");
+            const parsed = JSON.parse(raw);
+            if (typeof parsed?.version === "string") {
+                return { installed: true, installedVersion: parsed.version };
+            }
+            return { installed: true };
+        }
+        catch {
+            return { installed: false };
+        }
+    }
+    async enrichWithLatest(state) {
+        let latestVersion;
+        try {
+            latestVersion = await this.deps.fetchLatestVersion();
+        }
+        catch {
+            latestVersion = undefined;
+        }
+        if (!latestVersion) {
+            return { ...state, latestVersion: undefined, upToDate: undefined };
+        }
+        const upToDate = state.installedVersion !== undefined
+            ? state.installedVersion === latestVersion
+            : undefined;
+        return { ...state, latestVersion, upToDate };
+    }
+    async install(opts) {
+        const base = await this.queryLocalInstallState();
+        const enriched = base.installed ? await this.enrichWithLatest(base) : base;
+        const isInstalled = enriched.installed;
+        const isUpToDate = enriched.upToDate === true;
+        if (isInstalled && isUpToDate && !opts.force) {
+            return {
+                adapterId: this.id,
+                scope: opts.scope,
+                action: "already-up-to-date",
+                installedVersion: enriched.installedVersion,
+            };
+        }
+        const commands = isInstalled
+            ? [["copilot", "plugin", "update", PLUGIN_KEY]]
+            : [
+                ["copilot", "plugin", "marketplace", "add", "doc-detective/agent-tools"],
+                ["copilot", "plugin", "install", PLUGIN_KEY],
+            ];
+        if (opts.dryRun) {
+            for (const cmd of commands) {
+                opts.logger(`[dry-run] would run: ${cmd.join(" ")}`, "info");
+            }
+            return {
+                adapterId: this.id,
+                scope: opts.scope,
+                action: "dry-run",
+                installedVersion: enriched.installedVersion,
+            };
+        }
+        for (const [cmd, ...args] of commands) {
+            opts.logger(`Running: ${cmd} ${args.join(" ")}`, "debug");
+            let result;
+            try {
+                result = await this.deps.run(cmd, args);
+            }
+            catch (err) {
+                // ENOENT from safeSpawn = binary missing. Surface an actionable
+                // install hint rather than the raw spawn error.
+                const code = err?.code;
+                if (code === "ENOENT") {
+                    throw new Error("GitHub Copilot CLI is not installed or not on PATH. Run `npm install -g @github/copilot` (then `copilot login`) and re-run install-agents.");
+                }
+                throw err;
+            }
+            if (result.stdout)
+                opts.logger(result.stdout, "debug");
+            if (result.exitCode !== 0) {
+                // Copilot sometimes prints auth/login hints to stdout with empty
+                // stderr, so classify on the combined output — otherwise the
+                // actionable `copilot login` hint gets swallowed and the user sees
+                // a generic "exited with code 1" instead.
+                const output = [result.stderr, result.stdout].filter(Boolean).join("\n");
+                const msg = output || `exit code ${result.exitCode}`;
+                if (/auth|login|token|unauthori[sz]ed/i.test(msg)) {
+                    throw new Error(`GitHub Copilot CLI is not authenticated. Run \`copilot login\` and re-run install-agents. (copilot said: ${msg})`);
+                }
+                throw new Error(`\`${cmd} ${args.join(" ")}\` exited with code ${result.exitCode}: ${msg}`);
+            }
+        }
+        // Prefer the network-fetched latest (authoritative post-install); fall
+        // back to a fresh read of ~/.copilot/installed-plugins/…/plugin.json,
+        // then to the pre-install state. Same pattern as the Qwen adapter — keeps
+        // the install report accurate when `fetchLatestVersion()` failed.
+        const postInstall = await this.queryLocalInstallState();
+        const installedVersion = enriched.latestVersion ??
+            postInstall.installedVersion ??
+            enriched.installedVersion;
+        let action;
+        if (opts.force && isInstalled && isUpToDate)
+            action = "forced";
+        else if (isInstalled)
+            action = "updated";
+        else
+            action = "installed";
+        return {
+            adapterId: this.id,
+            scope: opts.scope,
+            action,
+            installedVersion,
+        };
+    }
+}
+export const copilotCliAdapter = new CopilotCliAdapter();
+//# sourceMappingURL=copilot-cli.js.map

package/dist/agents/adapters/copilot-cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"copilot-cli.js","sourceRoot":"","sources":["../../../src/agents/adapters/copilot-cli.ts"],"names":[],"mappings":"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"}

package/dist/agents/adapters/gemini-cli.d.ts

@@ -0,0 +1,29 @@
+import type { AgentAdapter, DetectionResult, InstallOptions, InstallReport, InstallState, Scope } from "../types.js";
+export interface RunResult {
+    stdout: string;
+    stderr: string;
+    exitCode: number;
+}
+export interface GeminiCliDeps {
+    run: (cmd: string, args: string[]) => Promise<RunResult>;
+    existsSync: (p: string) => boolean;
+    readFileSync: (p: string, encoding?: BufferEncoding) => string;
+    homedir: () => string;
+    fetchLatestVersion: () => Promise<string | undefined>;
+}
+export declare function defaultGeminiCliDeps(): GeminiCliDeps;
+export declare class GeminiCliAdapter implements AgentAdapter {
+    readonly id = "gemini";
+    readonly displayName = "Gemini CLI";
+    private deps;
+    constructor(deps?: GeminiCliDeps);
+    supportsScopes(): Scope[];
+    detect(): Promise<DetectionResult>;
+    getInstallState(_scope: Scope): Promise<InstallState>;
+    private manifestPath;
+    private queryLocalInstallState;
+    private enrichWithLatest;
+    install(opts: InstallOptions): Promise<InstallReport>;
+}
+export declare const geminiCliAdapter: AgentAdapter;
+//# sourceMappingURL=gemini-cli.d.ts.map

package/dist/agents/adapters/gemini-cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gemini-cli.d.ts","sourceRoot":"","sources":["../../../src/agents/adapters/gemini-cli.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,YAAY,EACZ,eAAe,EACf,cAAc,EACd,aAAa,EACb,YAAY,EACZ,KAAK,EACN,MAAM,aAAa,CAAC;AAGrB,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,aAAa;IAC5B,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,OAAO,CAAC,SAAS,CAAC,CAAC;IACzD,UAAU,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC;IACnC,YAAY,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,cAAc,KAAK,MAAM,CAAC;IAC/D,OAAO,EAAE,MAAM,MAAM,CAAC;IACtB,kBAAkB,EAAE,MAAM,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;CACvD;AAOD,wBAAgB,oBAAoB,IAAI,aAAa,CAepD;AAED,qBAAa,gBAAiB,YAAW,YAAY;IACnD,QAAQ,CAAC,EAAE,YAAY;IACvB,QAAQ,CAAC,WAAW,gBAAgB;IACpC,OAAO,CAAC,IAAI,CAAgB;gBAEhB,IAAI,GAAE,aAAsC;IAIxD,cAAc,IAAI,KAAK,EAAE;IAKnB,MAAM,IAAI,OAAO,CAAC,eAAe,CAAC;IAgClC,eAAe,CAAC,MAAM,EAAE,KAAK,GAAG,OAAO,CAAC,YAAY,CAAC;IAM3D,OAAO,CAAC,YAAY;YAIN,sBAAsB;YAsCtB,gBAAgB;IAiBxB,OAAO,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC;CAmF5D;AAED,eAAO,MAAM,gBAAgB,EAAE,YAAqC,CAAC"}