@aligndottech/cli 0.47.1 → 0.49.0

package/dist/lib/launch/droid-state.js

@@ -0,0 +1,74 @@
+import { existsSync, lstatSync } from 'node:fs';
+import path from 'node:path';
+import { ALIGN_NUDGE_START } from '../agent-rules.js';
+import { ancestors, optionValue, readText } from './layer-files.js';
+import { foldLayers, isCanonicalLocalEntry, parseJsonc } from './strict-entry.js';
+/** Droid's guideline file names and the dirs it looks in beside each directory (droid 0.237.0). */
+const GUIDELINES = ['CLAUDE.md', 'Claude.md', 'AGENTS.md', 'Agents.md', 'agents.md'];
+const CONTEXT_DIRS = ['.factory', '.agents', '.agent'];
+/** The nearest directory at or above `start` holding `.git` (a dir, or a worktree's file). */
+function gitRoot(start) {
+    return ancestors(start).find((d) => existsSync(path.join(d, '.git')));
+}
+/** Droid's walk: `start` up to the git root, or `start` alone when there is none. */
+function projectDirs(start) {
+    const root = gitRoot(start);
+    if (!root)
+        return [start];
+    const all = ancestors(start);
+    return all.slice(0, all.indexOf(root) + 1);
+}
+/** A regular file, not a link (Droid's lstat check ignores links), holding the block. */
+function guidelineHasBlock(dir, name) {
+    const file = path.join(dir, name);
+    try {
+        if (!lstatSync(file).isFile())
+            return false;
+    }
+    catch {
+        return false;
+    }
+    return readText(file)?.includes(ALIGN_NUDGE_START) ?? false;
+}
+function isRealDir(dir) {
+    try {
+        return lstatSync(dir).isDirectory();
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * What Factory Droid (droid 0.237.0) would already load for align. The project is `--cwd` when
+ * the user passes one (relative to the cwd), else the cwd; "home" is FACTORY_HOME_OVERRIDE when
+ * set (Droid's own home resolution).
+ *  - MCP: $home/.factory/mcp.json, and a `.factory/mcp.json` from the project up to the git root
+ *    (to the filesystem root with no git root). The per-process runtime settings win a same-named
+ *    server (verified with `droid --settings f mcp list`), so a non-canonical align-local is
+ *    overridden. Only the user's own canonical `align` stands in for us.
+ *  - Instructions: Droid's own guideline discovery (agentsMdGuidelines): the project up to the
+ *    git root, or only the project with none, each dir plus its .factory/.agents/.agent, plus
+ *    $home/.factory, .agents and .agent; CLAUDE.md, AGENTS.md and case variants; a linked file or
+ *    directory is ignored, as Droid's lstat checks ignore it.
+ */
+export function readDroidState(cwd, home, opts, env, platform, passthrough) {
+    const userCwd = optionValue(passthrough, '--cwd');
+    const start = path.resolve(cwd, userCwd ?? '.');
+    const droidHome = env['FACTORY_HOME_OVERRIDE'] ? path.resolve(env['FACTORY_HOME_OVERRIDE']) : home;
+    const userFile = path.join(droidHome, '.factory', 'mcp.json');
+    const layer = (file) => ({ file, servers: parseJsonc(readText(file))?.['mcpServers'] });
+    const user = layer(userFile);
+    const root = gitRoot(start);
+    const mcpDirs = root ? projectDirs(start) : ancestors(start);
+    const layers = [user, ...mcpDirs.map((d) => layer(path.join(d, '.factory', 'mcp.json'))).filter((l) => l.file !== userFile)];
+    const o = { ...opts, platform, host: 'droid' };
+    const { overridden } = foldLayers(layers, o, () => true);
+    const present = isCanonicalLocalEntry(user.servers?.['align'], o);
+    const own = optionValue(passthrough, '--settings') ?? (env['FACTORY_RUNTIME_SETTINGS_PATH'] ? env['FACTORY_RUNTIME_SETTINGS_PATH'] : undefined);
+    const personal = CONTEXT_DIRS.map((d) => path.join(droidHome, d));
+    const dirs = projectDirs(start).filter((d) => d !== droidHome).flatMap((d) => [d, ...CONTEXT_DIRS.map((c) => path.join(d, c))]).filter((d) => !personal.includes(d));
+    // Droid looks only in a real directory (not a link) at a regular file (not a link): lstat both.
+    const projectHasBlock = [...dirs, ...personal].some((dir) => isRealDir(dir) && GUIDELINES.some((name) => guidelineHasBlock(dir, name)));
+    return { present, overridden, ...(own !== undefined ? { ownSettings: own } : {}), projectHasBlock };
+}
+//# sourceMappingURL=droid-state.js.map

package/dist/lib/launch/droid-state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"droid-state.js","sourceRoot":"","sources":["../../../src/lib/launch/droid-state.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAChD,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AACpE,OAAO,EAAwB,UAAU,EAAE,qBAAqB,EAAc,UAAU,EAAE,MAAM,mBAAmB,CAAC;AASpH,mGAAmG;AACnG,MAAM,UAAU,GAAG,CAAC,WAAW,EAAE,WAAW,EAAE,WAAW,EAAE,WAAW,EAAE,WAAW,CAAC,CAAC;AACrF,MAAM,YAAY,GAAG,CAAC,UAAU,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC;AAEvD,8FAA8F;AAC9F,SAAS,OAAO,CAAC,KAAa;IAC5B,OAAO,SAAS,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC;AACxE,CAAC;AAED,qFAAqF;AACrF,SAAS,WAAW,CAAC,KAAa;IAChC,MAAM,IAAI,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC;IAC5B,IAAI,CAAC,IAAI;QAAE,OAAO,CAAC,KAAK,CAAC,CAAC;IAC1B,MAAM,GAAG,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC;IAC7B,OAAO,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAC7C,CAAC;AAED,yFAAyF;AACzF,SAAS,iBAAiB,CAAC,GAAW,EAAE,IAAY;IAClD,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IAClC,IAAI,CAAC;QACH,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE;YAAE,OAAO,KAAK,CAAC;IAC9C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;IACD,OAAO,QAAQ,CAAC,IAAI,CAAC,EAAE,QAAQ,CAAC,iBAAiB,CAAC,IAAI,KAAK,CAAC;AAC9D,CAAC;AAED,SAAS,SAAS,CAAC,GAAW;IAC5B,IAAI,CAAC;QACH,OAAO,SAAS,CAAC,GAAG,CAAC,CAAC,WAAW,EAAE,CAAC;IACtC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,cAAc,CAC5B,GAAW,EACX,IAAY,EACZ,IAAiC,EACjC,GAAuC,EACvC,QAAgB,EAChB,WAAqB;IAErB,MAAM,OAAO,GAAG,WAAW,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;IAClD,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,OAAO,IAAI,GAAG,CAAC,CAAC;IAChD,MAAM,SAAS,GAAG,GAAG,CAAC,uBAAuB,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,uBAAuB,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IACnG,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,UAAU,EAAE,UAAU,CAAC,CAAC;IAC9D,MAAM,KAAK,GAAG,CAAC,IAAY,EAAS,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,UAAU,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC;IACvG,MAAM,IAAI,GAAG,KAAK,CAAC,QAAQ,CAAC,CAAC;IAC7B,MAAM,IAAI,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC;IAC5B,MAAM,OAAO,GAAG,IAAI,CAAC,CAAC,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IAC7D,MAAM,MAAM,GAAG,CAAC,IAAI,EAAE,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,EAAE,UAAU,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC;IAC7H,MAAM,CAAC,GAAG,EAAE,GAAG,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAgB,EAAE,CAAC;IACxD,MAAM,EAAE,UAAU,EAAE,GAAG,UAAU,CAAC,MAAM,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC;IACzD,MAAM,OAAO,GAAG,qBAAqB,CAAE,IAAI,CAAC,OAA+C,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC;IAC3G,MAAM,GAAG,GAAG,WAAW,CAAC,WAAW,EAAE,YAAY,CAAC,IAAI,CAAC,GAAG,CAAC,+BAA+B,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,+BAA+B,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;IAEhJ,MAAM,QAAQ,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,CAAC;IAClE,MAAM,IAAI,GAAG,WAAW,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,SAAS,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;IACrK,gGAAgG;IAChG,MAAM,eAAe,GAAG,CAAC,GAAG,IAAI,EAAE,GAAG,QAAQ,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,UAAU,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,iBAAiB,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC;IACxI,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,GAAG,CAAC,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,eAAe,EAAE,CAAC;AACtG,CAAC"}

package/dist/lib/launch/gemini-state.d.ts

@@ -0,0 +1,32 @@
+import { type GeminiTrust } from './gemini-trust.js';
+import { type AlignLocalState } from './strict-entry.js';
+/** The system settings file Gemini would read with no help from align, and what it holds. */
+export interface GeminiSystemSettings {
+    path: string;
+    /** Its text; null when it does not exist (or is unreadable). */
+    text: string | null;
+    /** It exists but could not be read (a directory, no permission). */
+    unreadable: boolean;
+}
+export interface GeminiProjectState extends AlignLocalState {
+    systemSettings: GeminiSystemSettings;
+    trust: GeminiTrust;
+}
+/**
+ * The launch-cache name of the merged copy of one system settings file. One name per SOURCE,
+ * so two concurrent launches that read different system files never write the same copy.
+ */
+export declare const COPY_PREFIX = "gemini-system-settings-";
+export declare function geminiCopyName(source: string): string;
+/**
+ * What Gemini CLI would already load here, in its merge order (gemini 0.58.0 mergeSettings:
+ * system-defaults, user, workspace, system): system-defaults, ~/.gemini (or $GEMINI_CLI_HOME)
+ * settings, the project's .gemini/settings.json ONLY when the folder is trusted (Gemini drops
+ * the workspace layer otherwise), and the system file. Files are JSONC, as Gemini reads them.
+ * mcpServers merges shallowly with the system tier last, so the injected system copy replaces
+ * any align-local whole: a non-canonical one is overridden, never a conflict.
+ */
+export declare function readGeminiState(cwd: string, home: string, opts: {
+    localIsDefault: boolean;
+}, env: Record<string, string | undefined>, platform: string): GeminiProjectState;
+//# sourceMappingURL=gemini-state.d.ts.map

package/dist/lib/launch/gemini-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gemini-state.d.ts","sourceRoot":"","sources":["../../../src/lib/launch/gemini-state.ts"],"names":[],"mappings":"AAGA,OAAO,EAAoF,KAAK,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACvI,OAAO,EAAE,KAAK,eAAe,EAA6D,MAAM,mBAAmB,CAAC;AAEpH,6FAA6F;AAC7F,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,gEAAgE;IAChE,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,oEAAoE;IACpE,UAAU,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,kBAAmB,SAAQ,eAAe;IACzD,cAAc,EAAE,oBAAoB,CAAC;IACrC,KAAK,EAAE,WAAW,CAAC;CACpB;AAED;;;GAGG;AACH,eAAO,MAAM,WAAW,4BAA4B,CAAC;AAErD,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAErD;AAoBD;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAC7B,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE;IAAE,cAAc,EAAE,OAAO,CAAA;CAAE,EACjC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,EACvC,QAAQ,EAAE,MAAM,GACf,kBAAkB,CAmBpB"}

package/dist/lib/launch/gemini-state.js

@@ -0,0 +1,59 @@
+import { createHash } from 'node:crypto';
+import { readFileSync } from 'node:fs';
+import path from 'node:path';
+import { geminiDir, geminiFolderTrust, geminiSystemDefaultsPath, geminiSystemSettingsPath } from './gemini-trust.js';
+import { foldLayers, isCanonicalLocalEntry, parseJsonc } from './strict-entry.js';
+/**
+ * The launch-cache name of the merged copy of one system settings file. One name per SOURCE,
+ * so two concurrent launches that read different system files never write the same copy.
+ */
+export const COPY_PREFIX = 'gemini-system-settings-';
+export function geminiCopyName(source) {
+    return `${COPY_PREFIX}${createHash('sha256').update(path.resolve(source)).digest('hex').slice(0, 12)}.json`;
+}
+function readSystem(file) {
+    try {
+        return { path: file, text: readFileSync(file, 'utf8'), unreadable: false };
+    }
+    catch (e) {
+        return { path: file, text: null, unreadable: e.code !== 'ENOENT' };
+    }
+}
+function readText(file) {
+    try {
+        return readFileSync(file, 'utf8');
+    }
+    catch {
+        return null;
+    }
+}
+const layer = (file, text) => ({ file, servers: parseJsonc(text)?.['mcpServers'] });
+/**
+ * What Gemini CLI would already load here, in its merge order (gemini 0.58.0 mergeSettings:
+ * system-defaults, user, workspace, system): system-defaults, ~/.gemini (or $GEMINI_CLI_HOME)
+ * settings, the project's .gemini/settings.json ONLY when the folder is trusted (Gemini drops
+ * the workspace layer otherwise), and the system file. Files are JSONC, as Gemini reads them.
+ * mcpServers merges shallowly with the system tier last, so the injected system copy replaces
+ * any align-local whole: a non-canonical one is overridden, never a conflict.
+ */
+export function readGeminiState(cwd, home, opts, env, platform) {
+    const system = readSystem(geminiSystemSettingsPath(env, platform));
+    const trust = geminiFolderTrust(cwd, home, env, platform);
+    const defaultsPath = env['GEMINI_CLI_SYSTEM_DEFAULTS_PATH'] ? env['GEMINI_CLI_SYSTEM_DEFAULTS_PATH'] : geminiSystemDefaultsPath(system.path, platform);
+    const userPath = path.join(geminiDir(home, env), 'settings.json');
+    const workspacePath = path.join(cwd, '.gemini', 'settings.json');
+    const layers = [
+        layer(defaultsPath, readText(defaultsPath)),
+        layer(userPath, readText(userPath)),
+        ...(trust === 'trusted' || trust === 'off' ? [layer(workspacePath, readText(workspacePath))] : []),
+        layer(system.path, system.text),
+    ];
+    const o = { ...opts, platform, host: 'mcpServers' };
+    const { overridden } = foldLayers(layers, o, () => true);
+    // Only the user's own `align` stands in for us. A canonical align-local does not: the system
+    // copy replaces it whole anyway, and skipping would let a workspace align-local trusted later
+    // take its place.
+    const present = layers.some((l) => isCanonicalLocalEntry(l.servers?.['align'], o));
+    return { present, overridden, systemSettings: system, trust };
+}
+//# sourceMappingURL=gemini-state.js.map

package/dist/lib/launch/gemini-state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gemini-state.js","sourceRoot":"","sources":["../../../src/lib/launch/gemini-state.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,SAAS,EAAE,iBAAiB,EAAE,wBAAwB,EAAE,wBAAwB,EAAoB,MAAM,mBAAmB,CAAC;AACvI,OAAO,EAAwB,UAAU,EAAE,qBAAqB,EAAc,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAgBpH;;;GAGG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,yBAAyB,CAAC;AAErD,MAAM,UAAU,cAAc,CAAC,MAAc;IAC3C,OAAO,GAAG,WAAW,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC;AAC9G,CAAC;AAED,SAAS,UAAU,CAAC,IAAY;IAC9B,IAAI,CAAC;QACH,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC;IAC7E,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,UAAU,EAAG,CAAuB,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;IAC5F,CAAC;AACH,CAAC;AAED,SAAS,QAAQ,CAAC,IAAY;IAC5B,IAAI,CAAC;QACH,OAAO,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACpC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,MAAM,KAAK,GAAG,CAAC,IAAY,EAAE,IAAmB,EAAS,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC;AAElH;;;;;;;GAOG;AACH,MAAM,UAAU,eAAe,CAC7B,GAAW,EACX,IAAY,EACZ,IAAiC,EACjC,GAAuC,EACvC,QAAgB;IAEhB,MAAM,MAAM,GAAG,UAAU,CAAC,wBAAwB,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC,CAAC;IACnE,MAAM,KAAK,GAAG,iBAAiB,CAAC,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE,QAAQ,CAAC,CAAC;IAC1D,MAAM,YAAY,GAAG,GAAG,CAAC,iCAAiC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,iCAAiC,CAAC,CAAC,CAAC,CAAC,wBAAwB,CAAC,MAAM,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IACvJ,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,GAAG,CAAC,EAAE,eAAe,CAAC,CAAC;IAClE,MAAM,aAAa,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,SAAS,EAAE,eAAe,CAAC,CAAC;IACjE,MAAM,MAAM,GAAY;QACtB,KAAK,CAAC,YAAY,EAAE,QAAQ,CAAC,YAAY,CAAC,CAAC;QAC3C,KAAK,CAAC,QAAQ,EAAE,QAAQ,CAAC,QAAQ,CAAC,CAAC;QACnC,GAAG,CAAC,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,aAAa,EAAE,QAAQ,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QAClG,KAAK,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC;KAChC,CAAC;IACF,MAAM,CAAC,GAAG,EAAE,GAAG,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,YAAqB,EAAE,CAAC;IAC7D,MAAM,EAAE,UAAU,EAAE,GAAG,UAAU,CAAC,MAAM,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC;IACzD,6FAA6F;IAC7F,8FAA8F;IAC9F,kBAAkB;IAClB,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,qBAAqB,CAAE,CAAC,CAAC,OAA+C,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IAC5H,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;AAChE,CAAC"}

package/dist/lib/launch/gemini-trust.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Whether Gemini CLI will run MCP servers in this folder. Gemini turns off EVERY MCP server,
+ * the injected align-local included, in a folder it does not trust.
+ *  - trusted / untrusted: what Gemini will decide.
+ *  - off: folder trust is turned off in the user's settings, so nothing is disabled.
+ *  - unknown: trustedFolders.json is unreadable or invalid (Gemini itself refuses to start then).
+ */
+export type GeminiTrust = 'trusted' | 'untrusted' | 'off' | 'unknown';
+/** Gemini's own default system settings file, used when GEMINI_CLI_SYSTEM_SETTINGS_PATH is unset. */
+export declare function geminiSystemSettingsPath(env: Record<string, string | undefined>, platform: string): string;
+/** GEMINI_CLI_SYSTEM_DEFAULTS_PATH, else `system-defaults.json` beside the system settings file. */
+export declare function geminiSystemDefaultsPath(systemSettingsPath: string, platform: string): string;
+/** ~/.gemini, or $GEMINI_CLI_HOME/.gemini when set. */
+export declare function geminiDir(home: string, env: Record<string, string | undefined>): string;
+/**
+ * Gemini CLI 0.58.0's folder-trust verdict for `cwd`, read from its own files and never written
+ * (packages/core/src/utils/trust.ts, cli/src/config/trustedFolders.ts):
+ *  - GEMINI_CLI_TRUST_WORKSPACE=true|false decides outright;
+ *  - folder trust turned off in settings means nothing is disabled;
+ *  - else the LONGEST matching rule in trustedFolders.json decides, where TRUST_PARENT matches
+ *    the rule's parent directory, and no matching rule is untrusted.
+ * Gemini also accepts a trust decision from a connected IDE; align cannot see that, so in an IDE
+ * terminal this can say untrusted for a folder Gemini will treat as trusted (one extra line).
+ */
+export declare function geminiFolderTrust(cwd: string, home: string, env: Record<string, string | undefined>, platform: string): GeminiTrust;
+//# sourceMappingURL=gemini-trust.d.ts.map

package/dist/lib/launch/gemini-trust.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gemini-trust.d.ts","sourceRoot":"","sources":["../../../src/lib/launch/gemini-trust.ts"],"names":[],"mappings":"AAIA;;;;;;GAMG;AACH,MAAM,MAAM,WAAW,GAAG,SAAS,GAAG,WAAW,GAAG,KAAK,GAAG,SAAS,CAAC;AAgBtE,qGAAqG;AACrG,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAK1G;AAED,oGAAoG;AACpG,wBAAgB,wBAAwB,CAAC,kBAAkB,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAG7F;AAED,uDAAuD;AACvD,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,GAAG,MAAM,CAEvF;AAqCD;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,EAAE,QAAQ,EAAE,MAAM,GAAG,WAAW,CAuBnI"}

package/dist/lib/launch/gemini-trust.js

@@ -0,0 +1,103 @@
+import { existsSync, readFileSync, realpathSync } from 'node:fs';
+import path from 'node:path';
+import { parseJsonc } from './strict-entry.js';
+const LEVELS = new Set(['TRUST_FOLDER', 'TRUST_PARENT', 'DO_NOT_TRUST']);
+/** Gemini reads these files through strip-json-comments, so comments are allowed. */
+function readJson(file) {
+    try {
+        return parseJsonc(readFileSync(file, 'utf8'));
+    }
+    catch {
+        return null;
+    }
+}
+const pathFor = (platform) => (platform === 'win32' ? path.win32 : path.posix);
+/** Gemini's own default system settings file, used when GEMINI_CLI_SYSTEM_SETTINGS_PATH is unset. */
+export function geminiSystemSettingsPath(env, platform) {
+    if (env['GEMINI_CLI_SYSTEM_SETTINGS_PATH'])
+        return env['GEMINI_CLI_SYSTEM_SETTINGS_PATH'];
+    if (platform === 'darwin')
+        return '/Library/Application Support/GeminiCli/settings.json';
+    if (platform === 'win32')
+        return 'C:\\ProgramData\\gemini-cli\\settings.json';
+    return '/etc/gemini-cli/settings.json';
+}
+/** GEMINI_CLI_SYSTEM_DEFAULTS_PATH, else `system-defaults.json` beside the system settings file. */
+export function geminiSystemDefaultsPath(systemSettingsPath, platform) {
+    const p = pathFor(platform);
+    return p.join(p.dirname(systemSettingsPath), 'system-defaults.json');
+}
+/** ~/.gemini, or $GEMINI_CLI_HOME/.gemini when set. */
+export function geminiDir(home, env) {
+    return path.join(env['GEMINI_CLI_HOME'] ? env['GEMINI_CLI_HOME'] : home, '.gemini');
+}
+const folderTrustSetting = (s) => s?.['security']?.['folderTrust']?.['enabled'];
+/** security.folderTrust.enabled, merged system-defaults < user < system as Gemini does; default on. */
+function folderTrustEnabled(home, env, platform) {
+    const system = geminiSystemSettingsPath(env, platform);
+    const defaults = env['GEMINI_CLI_SYSTEM_DEFAULTS_PATH'] ? env['GEMINI_CLI_SYSTEM_DEFAULTS_PATH'] : geminiSystemDefaultsPath(system, platform);
+    let enabled = true;
+    for (const file of [defaults, path.join(geminiDir(home, env), 'settings.json'), system]) {
+        const v = folderTrustSetting(readJson(file));
+        if (typeof v === 'boolean')
+            enabled = v;
+    }
+    return enabled;
+}
+function realPath(p) {
+    try {
+        return existsSync(p) ? realpathSync(p) : p;
+    }
+    catch {
+        return p;
+    }
+}
+/** Gemini's normalizePath: absolute, and lower-cased where the filesystem is case-insensitive. */
+function normalize(p, platform) {
+    const abs = pathFor(platform).resolve(p);
+    return platform === 'win32' || platform === 'darwin' ? abs.toLowerCase() : abs;
+}
+/** Gemini's isSubpath: `child` is `parent` or below it. A shared string prefix is not enough. */
+function isSubpath(parent, child, platform) {
+    const p = pathFor(platform);
+    const rel = p.relative(parent, child);
+    return !rel.startsWith(`..${p.sep}`) && rel !== '..' && !p.isAbsolute(rel);
+}
+/**
+ * Gemini CLI 0.58.0's folder-trust verdict for `cwd`, read from its own files and never written
+ * (packages/core/src/utils/trust.ts, cli/src/config/trustedFolders.ts):
+ *  - GEMINI_CLI_TRUST_WORKSPACE=true|false decides outright;
+ *  - folder trust turned off in settings means nothing is disabled;
+ *  - else the LONGEST matching rule in trustedFolders.json decides, where TRUST_PARENT matches
+ *    the rule's parent directory, and no matching rule is untrusted.
+ * Gemini also accepts a trust decision from a connected IDE; align cannot see that, so in an IDE
+ * terminal this can say untrusted for a folder Gemini will treat as trusted (one extra line).
+ */
+export function geminiFolderTrust(cwd, home, env, platform) {
+    if (env['GEMINI_CLI_TRUST_WORKSPACE'] === 'true')
+        return 'trusted';
+    if (env['GEMINI_CLI_TRUST_WORKSPACE'] === 'false')
+        return 'untrusted';
+    if (!folderTrustEnabled(home, env, platform))
+        return 'off';
+    const file = env['GEMINI_CLI_TRUSTED_FOLDERS_PATH'] ? env['GEMINI_CLI_TRUSTED_FOLDERS_PATH'] : path.join(geminiDir(home, env), 'trustedFolders.json');
+    if (!existsSync(file))
+        return 'untrusted';
+    const rules = readJson(file);
+    if (!rules || !Object.values(rules).every((v) => typeof v === 'string' && LEVELS.has(v)))
+        return 'unknown';
+    const p = pathFor(platform);
+    const location = normalize(realPath(cwd), platform);
+    let longest = -1;
+    let verdict;
+    for (const [raw, level] of Object.entries(rules)) {
+        const rule = normalize(raw, platform);
+        const effective = normalize(realPath(level === 'TRUST_PARENT' ? p.dirname(rule) : rule), platform);
+        if (isSubpath(effective, location, platform) && rule.length > longest) {
+            longest = rule.length;
+            verdict = level;
+        }
+    }
+    return verdict === 'TRUST_FOLDER' || verdict === 'TRUST_PARENT' ? 'trusted' : 'untrusted';
+}
+//# sourceMappingURL=gemini-trust.js.map

package/dist/lib/launch/gemini-trust.js.map

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

package/dist/lib/launch/grok-state.d.ts

@@ -0,0 +1,42 @@
+import { type AlignLocalState } from './strict-entry.js';
+export interface GrokProjectState extends AlignLocalState {
+    /** $GROK_HOME/config.toml (else ~/.grok/config.toml): the file align adds to. */
+    configFile: string;
+}
+/**
+ * $GROK_HOME verbatim when non-empty, else `<home>/.grok` with the home's symlinks resolved, as
+ * Grok Build's own installer and `grok_home()` do (xai-org/grok-build xai-dirs, npm postinstall.js).
+ */
+export declare function grokHome(env: Record<string, string | undefined>, platform: string, home?: string): string;
+export interface BinFs {
+    realpath(p: string): string;
+    exists(p: string): boolean;
+}
+/**
+ * `grok` is a generic name, so a `grok` on PATH is Grok Build only when its realpath sits where
+ * Grok Build's own installers put it:
+ *  - the install script (x.ai/cli/install.sh): `$GROK_HOME/downloads/grok-<platform>`, linked from
+ *    `$GROK_HOME/bin/grok` (and from `$GROK_BIN_DIR` or ~/.local/bin, which resolve to the same);
+ *  - its Windows script: a copy at `%USERPROFILE%\.grok\bin\grok.exe`;
+ *  - the npm package `@xai-official/grok`: its postinstall installs into `$GROK_HOME/bin`, and the
+ *    npm entry itself lives in `node_modules/@xai-official/grok[-<platform>]/`. On Windows npm's
+ *    `grok.cmd` shim sits beside `node_modules`, so it counts when that package is next to it.
+ * Anything else (another tool's `grok`) is not Grok Build, and counts as not installed.
+ */
+export declare function isGrokBuildBin(found: string, env: Record<string, string | undefined>, platform: string, fsx?: BinFs): boolean;
+/**
+ * What Grok Build (grok 1.0.50) would already load for align, measured with `grok mcp list` and
+ * `grok inspect` in a sandbox:
+ *  - `$GROK_HOME/config.toml` `[mcp_servers.*]`: the user file align writes to;
+ *  - a project `.grok/config.toml` (repo root down to the cwd; every ancestor is read here):
+ *    "A project file entirely replaces a same-named server from the user config", so a
+ *    non-canonical align-local there would replace ours: a conflict, nothing is written;
+ *  - ~/.claude.json and ~/.cursor/mcp.json (Grok imports them): a same-named server there LOSES
+ *    to config.toml (verified), so it is no conflict; a canonical local `align` there is present.
+ * A project `.mcp.json` is repo input and never counts as present. The project is `--cwd` when
+ * the user passes one.
+ */
+export declare function readGrokState(cwd: string, home: string, opts: {
+    localIsDefault: boolean;
+}, env: Record<string, string | undefined>, platform: string, passthrough?: string[]): GrokProjectState;
+//# sourceMappingURL=grok-state.d.ts.map

package/dist/lib/launch/grok-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"grok-state.d.ts","sourceRoot":"","sources":["../../../src/lib/launch/grok-state.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,KAAK,eAAe,EAAqC,MAAM,mBAAmB,CAAC;AAE5F,MAAM,WAAW,gBAAiB,SAAQ,eAAe;IACvD,iFAAiF;IACjF,UAAU,EAAE,MAAM,CAAC;CACpB;AAqBD;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,SAAwB,GAAG,MAAM,CAGxH;AASD,MAAM,WAAW,KAAK;IACpB,QAAQ,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC5B,MAAM,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;CAC5B;AAGD;;;;;;;;;;GAUG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,GAAE,KAAc,GAAG,OAAO,CAkBrI;AAaD;;;;;;;;;;;GAWG;AACH,wBAAgB,aAAa,CAC3B,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE;IAAE,cAAc,EAAE,OAAO,CAAA;CAAE,EACjC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,EACvC,QAAQ,EAAE,MAAM,EAChB,WAAW,GAAE,MAAM,EAAO,GACzB,gBAAgB,CA0BlB"}

package/dist/lib/launch/grok-state.js

@@ -0,0 +1,128 @@
+import { existsSync, realpathSync } from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+import { parse } from 'smol-toml';
+import { ancestors, optionValue, readText } from './layer-files.js';
+import { isCanonicalLocalEntry, parseJsonc } from './strict-entry.js';
+const isObject = (v) => typeof v === 'object' && v !== null && !Array.isArray(v);
+const pathFor = (platform) => (platform === 'win32' ? path.win32 : path.posix);
+function real(p) {
+    try {
+        return realpathSync(p);
+    }
+    catch {
+        return p;
+    }
+}
+/** The user's home as Grok Build resolves it: $HOME (USERPROFILE on Windows), else the OS's. */
+function homeOf(env, platform) {
+    const h = platform === 'win32' ? env['USERPROFILE'] || env['HOME'] : env['HOME'];
+    return h ? h : os.homedir();
+}
+/**
+ * $GROK_HOME verbatim when non-empty, else `<home>/.grok` with the home's symlinks resolved, as
+ * Grok Build's own installer and `grok_home()` do (xai-org/grok-build xai-dirs, npm postinstall.js).
+ */
+export function grokHome(env, platform, home = homeOf(env, platform)) {
+    if (env['GROK_HOME'])
+        return pathFor(platform).resolve(env['GROK_HOME']);
+    return pathFor(platform).join(platform === 'win32' ? home : real(home), '.grok');
+}
+const inside = (child, parent, platform) => {
+    const p = pathFor(platform);
+    const norm = (x) => (platform === 'win32' ? p.resolve(x).toLowerCase() : p.resolve(x));
+    const rel = p.relative(norm(parent), norm(child));
+    return rel !== '' && !rel.startsWith(`..${p.sep}`) && rel !== '..' && !p.isAbsolute(rel);
+};
+const realFs = { realpath: (p) => realpathSync(p), exists: (p) => existsSync(p) };
+/**
+ * `grok` is a generic name, so a `grok` on PATH is Grok Build only when its realpath sits where
+ * Grok Build's own installers put it:
+ *  - the install script (x.ai/cli/install.sh): `$GROK_HOME/downloads/grok-<platform>`, linked from
+ *    `$GROK_HOME/bin/grok` (and from `$GROK_BIN_DIR` or ~/.local/bin, which resolve to the same);
+ *  - its Windows script: a copy at `%USERPROFILE%\.grok\bin\grok.exe`;
+ *  - the npm package `@xai-official/grok`: its postinstall installs into `$GROK_HOME/bin`, and the
+ *    npm entry itself lives in `node_modules/@xai-official/grok[-<platform>]/`. On Windows npm's
+ *    `grok.cmd` shim sits beside `node_modules`, so it counts when that package is next to it.
+ * Anything else (another tool's `grok`) is not Grok Build, and counts as not installed.
+ */
+export function isGrokBuildBin(found, env, platform, fsx = realFs) {
+    let resolved;
+    try {
+        resolved = fsx.realpath(found);
+    }
+    catch {
+        return false;
+    }
+    const g = grokHome(env, platform);
+    const p = pathFor(platform);
+    if (inside(resolved, p.join(g, 'bin'), platform) || inside(resolved, p.join(g, 'downloads'), platform))
+        return true;
+    const parts = resolved.split(/[\\/]/);
+    for (let i = 0; i + 2 < parts.length; i++) {
+        if (parts[i] === 'node_modules' && parts[i + 1] === '@xai-official' && /^grok(-[a-z0-9]+-[a-z0-9]+)?$/.test(parts[i + 2]))
+            return true;
+    }
+    if (platform === 'win32' && /^grok\.cmd$/i.test(p.basename(resolved))) {
+        return fsx.exists(p.join(p.dirname(resolved), 'node_modules', '@xai-official', 'grok', 'package.json'));
+    }
+    return false;
+}
+function readToml(file) {
+    const text = readText(file);
+    if (text === null)
+        return null;
+    try {
+        const parsed = parse(text);
+        return isObject(parsed) ? parsed : null;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * What Grok Build (grok 1.0.50) would already load for align, measured with `grok mcp list` and
+ * `grok inspect` in a sandbox:
+ *  - `$GROK_HOME/config.toml` `[mcp_servers.*]`: the user file align writes to;
+ *  - a project `.grok/config.toml` (repo root down to the cwd; every ancestor is read here):
+ *    "A project file entirely replaces a same-named server from the user config", so a
+ *    non-canonical align-local there would replace ours: a conflict, nothing is written;
+ *  - ~/.claude.json and ~/.cursor/mcp.json (Grok imports them): a same-named server there LOSES
+ *    to config.toml (verified), so it is no conflict; a canonical local `align` there is present.
+ * A project `.mcp.json` is repo input and never counts as present. The project is `--cwd` when
+ * the user passes one.
+ */
+export function readGrokState(cwd, home, opts, env, platform, passthrough = []) {
+    // `grok --cwd <dir>` moves the project Grok loads; relative to the cwd, as a shell gives it.
+    const project = path.resolve(cwd, optionValue(passthrough, '--cwd') ?? '.');
+    const o = { ...opts, platform, host: 'mcpServers' };
+    // A path on this machine's own filesystem: built with the host's path rules (in production the
+    // platform is the host's anyway). grokHome uses `platform`'s rules for the binary gate.
+    const configFile = path.join(env['GROK_HOME'] ? path.resolve(env['GROK_HOME']) : path.join(home, '.grok'), 'config.toml');
+    const userServers = readToml(configFile)?.['mcp_servers'];
+    const state = { present: false, overridden: [], configFile };
+    const canonical = (s) => isObject(s) && (isCanonicalLocalEntry(s['align'], o) || isCanonicalLocalEntry(s['align-local'], o));
+    if (canonical(userServers))
+        state.present = true;
+    else if (isObject(userServers) && 'align-local' in userServers)
+        state.conflict = configFile;
+    for (const dir of ancestors(project)) {
+        const file = path.join(dir, '.grok', 'config.toml');
+        if (file === configFile)
+            continue;
+        const servers = readToml(file)?.['mcp_servers'];
+        if (isObject(servers) && 'align-local' in servers && !isCanonicalLocalEntry(servers['align-local'], o))
+            state.conflict ??= file;
+    }
+    // `[compat.claude] mcps = false` / `[compat.cursor] mcps = false` turn those imports off.
+    const compat = (readToml(configFile)?.['compat'] ?? {});
+    const imported = (tool) => !(isObject(compat[tool]) && compat[tool]['mcps'] === false);
+    const claude = parseJsonc(readText(path.join(home, '.claude.json')))?.['mcpServers'];
+    const cursor = parseJsonc(readText(path.join(home, '.cursor', 'mcp.json')))?.['mcpServers'];
+    if (imported('claude') && isObject(claude) && isCanonicalLocalEntry(claude['align'], o))
+        state.present = true;
+    if (imported('cursor') && isObject(cursor) && isCanonicalLocalEntry(cursor['align'], o))
+        state.present = true;
+    return state;
+}
+//# sourceMappingURL=grok-state.js.map

package/dist/lib/launch/grok-state.js.map

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

package/dist/lib/launch/install.d.ts

@@ -0,0 +1,33 @@
+import type { ChildProcess, SpawnOptions } from 'node:child_process';
+import type { AgentSpec } from './registry/types.js';
+/**
+ * How an agent is installed (plan Decision 4). `npm`: one package-manager argv, which Align may
+ * run after the user says yes. `docs`: a script or URL installer; piping a remote script into a
+ * shell is the user's decision, so Align only ever prints it.
+ */
+export type AgentInstall = {
+    kind: 'npm';
+    argv: readonly string[];
+} | {
+    kind: 'docs';
+    url: string;
+    text?: string;
+};
+/** `cancelled`: Ctrl-C at the question, which leaves the picker; `declined`: a plain No. */
+export type InstallOutcome = 'installed' | 'declined' | 'cancelled' | 'manual' | 'failed';
+export interface InstallOfferDeps {
+    isTTY: boolean;
+    platform: string;
+    /** true only on an explicit yes, false on No (the default), null on Ctrl-C. */
+    confirm(message: string): Promise<boolean | null>;
+    spawn(command: string, args: string[], options: SpawnOptions): ChildProcess;
+    onPath(bin: string): string | null;
+    say(line: string): void;
+}
+export declare function installText(i: AgentInstall): string;
+/**
+ * Offer to install an agent the user picked. Never runs anything without a TTY and a yes, and
+ * never runs a script or URL installer. The argv runs with no shell, output visible.
+ */
+export declare function offerInstall(spec: Pick<AgentSpec, 'label' | 'install'>, d: InstallOfferDeps): Promise<InstallOutcome>;
+//# sourceMappingURL=install.d.ts.map

package/dist/lib/launch/install.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"install.d.ts","sourceRoot":"","sources":["../../../src/lib/launch/install.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACrE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAGrD;;;;GAIG;AACH,MAAM,MAAM,YAAY,GAAG;IAAE,IAAI,EAAE,KAAK,CAAC;IAAC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AACnH,4FAA4F;AAC5F,MAAM,MAAM,cAAc,GAAG,WAAW,GAAG,UAAU,GAAG,WAAW,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAE1F,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,OAAO,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,+EAA+E;IAC/E,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC;IAClD,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,YAAY,GAAG,YAAY,CAAC;IAC5E,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IACnC,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB;AAED,wBAAgB,WAAW,CAAC,CAAC,EAAE,YAAY,GAAG,MAAM,CAEnD;AAED;;;GAGG;AACH,wBAAsB,YAAY,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,EAAE,OAAO,GAAG,SAAS,CAAC,EAAE,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,cAAc,CAAC,CAmC3H"}

package/dist/lib/launch/install.js

@@ -0,0 +1,48 @@
+import { winShimCommand } from './run-agent.js';
+export function installText(i) {
+    return i.kind === 'npm' ? i.argv.join(' ') : (i.text ?? i.url);
+}
+/**
+ * Offer to install an agent the user picked. Never runs anything without a TTY and a yes, and
+ * never runs a script or URL installer. The argv runs with no shell, output visible.
+ */
+export async function offerInstall(spec, d) {
+    const text = installText(spec.install);
+    const manager = spec.install.kind === 'npm' ? d.onPath(spec.install.argv[0]) : null;
+    if (spec.install.kind !== 'npm' || !d.isTTY || !manager) {
+        d.say(`${spec.label} is not installed. Install it with: ${text}`);
+        return 'manual';
+    }
+    const answer = await d.confirm(`Install ${spec.label} now? (runs: ${text})`);
+    if (answer === null)
+        return 'cancelled';
+    if (answer !== true)
+        return 'declined';
+    const args = spec.install.argv.slice(1);
+    let code;
+    try {
+        // Run the npm the PATH scan found, by its path: the one the question just named. npm on
+        // Windows is npm.cmd, which cannot be spawned without a shell, so it goes through the same
+        // quoted cmd.exe line the agent launch uses (which refuses a path cmd.exe would reinterpret).
+        const shim = d.platform === 'win32' && /\.(cmd|bat)$/i.test(manager);
+        const cmd = shim ? winShimCommand({ bin: manager, args }) : { command: manager, args };
+        const options = { shell: false, stdio: 'inherit' };
+        if (shim)
+            options.windowsVerbatimArguments = true;
+        code = await new Promise((resolve, reject) => {
+            const child = d.spawn(cmd.command, cmd.args, options);
+            child.on('error', reject);
+            child.on('exit', (c) => resolve(c ?? 1));
+        });
+    }
+    catch (e) {
+        d.say(`Could not run ${text} (${e.message}). ${spec.label} is not installed.`);
+        return 'failed';
+    }
+    if (code !== 0) {
+        d.say(`${spec.install.argv[0]} exited ${code}. ${spec.label} is not installed.`);
+        return 'failed';
+    }
+    return 'installed';
+}
+//# sourceMappingURL=install.js.map

package/dist/lib/launch/install.js.map

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