opencode-agora 0.4.2 → 0.4.3

package/dist/stack/manifest.js

@@ -0,0 +1,342 @@
+import { readFileSync, existsSync } from 'node:fs';
+import { join, resolve } from 'node:path';
+import { atomicWriteFile } from '../atomic-write.js';
+// ── Path helper ───────────────────────────────────────────────────────────────
+export function manifestPath(env) {
+    const override = env.env?.AGORA_STACK_FILE;
+    if (override)
+        return override;
+    const cwd = env.cwd ?? process.cwd();
+    return join(cwd, 'agora.toml');
+}
+export function opencodeEntryToManifest(entry) {
+    const result = {};
+    if (entry.type === 'local') {
+        result.command = entry.command;
+        if (entry.environment && Object.keys(entry.environment).length > 0) {
+            result.env = entry.environment;
+        }
+    }
+    else {
+        result.url = entry.url;
+    }
+    if (entry.enabled === false) {
+        result.enabled = false;
+    }
+    return result;
+}
+// ── serverToEntry ─────────────────────────────────────────────────────────────
+export function serverToEntry(server) {
+    const entry = {};
+    if (server.transport === 'local' && server.command) {
+        entry.command = server.command;
+    }
+    else if (server.transport === 'remote' && server.url) {
+        entry.url = server.url;
+    }
+    if (server.env && Object.keys(server.env).length > 0) {
+        entry.env = server.env;
+    }
+    if (server.enabled === false) {
+        entry.enabled = false;
+    }
+    return entry;
+}
+// ── TOML serializer ───────────────────────────────────────────────────────────
+function needsQuoting(seg) {
+    return !/^[A-Za-z0-9_-]+$/.test(seg);
+}
+function tomlSegment(seg) {
+    if (needsQuoting(seg)) {
+        return `"${escapeString(seg)}"`;
+    }
+    return seg;
+}
+function escapeString(s) {
+    return s.replace(/\\/g, '\\\\').replace(/"/g, '\\"');
+}
+function serializeStringArray(arr) {
+    return '[' + arr.map((s) => `"${escapeString(s)}"`).join(', ') + ']';
+}
+function serializeSection(section, entries, lines) {
+    const names = Object.keys(entries).sort();
+    for (const name of names) {
+        const entry = entries[name];
+        const seg = tomlSegment(name);
+        lines.push(`[${section}.${seg}]`);
+        if (entry.command !== undefined) {
+            lines.push(`command = ${serializeStringArray(entry.command)}`);
+        }
+        if (entry.url !== undefined) {
+            lines.push(`url = "${escapeString(entry.url)}"`);
+        }
+        if (entry.enabled === false) {
+            lines.push(`enabled = false`);
+        }
+        if (entry.env && Object.keys(entry.env).length > 0) {
+            lines.push(`[${section}.${seg}.env]`);
+            for (const key of Object.keys(entry.env).sort()) {
+                lines.push(`${key} = "${escapeString(entry.env[key])}"`);
+            }
+        }
+        lines.push('');
+    }
+}
+export function serializeManifest(m) {
+    const lines = ['# agora stack manifest', ''];
+    if (m.mcp && Object.keys(m.mcp).length > 0) {
+        serializeSection('mcp', m.mcp, lines);
+    }
+    if (m.skills && Object.keys(m.skills).length > 0) {
+        serializeSection('skills', m.skills, lines);
+    }
+    if (m.workflows && Object.keys(m.workflows).length > 0) {
+        serializeSection('workflows', m.workflows, lines);
+    }
+    // Remove trailing blank line to get a clean file
+    while (lines.length > 0 && lines[lines.length - 1] === '') {
+        lines.pop();
+    }
+    return lines.join('\n') + '\n';
+}
+// ── TOML parser ───────────────────────────────────────────────────────────────
+const KNOWN_SECTIONS = new Set(['mcp', 'skills', 'workflows']);
+const KNOWN_ENTRY_KEYS = new Set(['command', 'url', 'enabled']);
+function parseTomlString(raw, lineNum) {
+    if (!raw.startsWith('"') || !raw.endsWith('"') || raw.length < 2) {
+        throw new Error(`Line ${lineNum}: expected a double-quoted string, got: ${raw}`);
+    }
+    const inner = raw.slice(1, -1);
+    // Unescape \" and \\ (minimal)
+    let result = '';
+    for (let i = 0; i < inner.length; i++) {
+        if (inner[i] === '\\') {
+            i++;
+            if (inner[i] === '"')
+                result += '"';
+            else if (inner[i] === '\\')
+                result += '\\';
+            else
+                throw new Error(`Line ${lineNum}: unknown escape \\${inner[i]}`);
+        }
+        else {
+            result += inner[i];
+        }
+    }
+    return result;
+}
+function parseStringArray(raw, lineNum) {
+    const trimmed = raw.trim();
+    if (!trimmed.startsWith('[') || !trimmed.endsWith(']')) {
+        throw new Error(`Line ${lineNum}: expected a string array [...], got: ${raw}`);
+    }
+    const inner = trimmed.slice(1, -1).trim();
+    if (inner === '')
+        return [];
+    const items = [];
+    let i = 0;
+    while (i < inner.length) {
+        // skip whitespace and commas
+        while (i < inner.length && (inner[i] === ',' || inner[i] === ' ' || inner[i] === '\t'))
+            i++;
+        if (i >= inner.length)
+            break;
+        if (inner[i] !== '"') {
+            throw new Error(`Line ${lineNum}: expected quoted string in array, got: ${inner[i]}`);
+        }
+        // find closing quote, respecting escapes
+        let j = i + 1;
+        while (j < inner.length && !(inner[j] === '"' && inner[j - 1] !== '\\'))
+            j++;
+        if (j >= inner.length) {
+            throw new Error(`Line ${lineNum}: unterminated string in array`);
+        }
+        items.push(parseTomlString(inner.slice(i, j + 1), lineNum));
+        i = j + 1;
+    }
+    return items;
+}
+function parseTableHeader(line, lineNum) {
+    // Strip [ and ]
+    const inner = line.slice(1, -1).trim();
+    // Parse segments: bare or double-quoted
+    const segments = [];
+    let i = 0;
+    while (i < inner.length) {
+        if (inner[i] === '.') {
+            i++;
+            continue;
+        }
+        if (inner[i] === '"') {
+            // quoted segment
+            let j = i + 1;
+            while (j < inner.length && !(inner[j] === '"' && inner[j - 1] !== '\\'))
+                j++;
+            if (j >= inner.length) {
+                throw new Error(`Line ${lineNum}: unterminated quoted segment in table header`);
+            }
+            segments.push(parseTomlString(inner.slice(i, j + 1), lineNum));
+            i = j + 1;
+        }
+        else {
+            // bare segment
+            let j = i;
+            while (j < inner.length && inner[j] !== '.')
+                j++;
+            const seg = inner.slice(i, j);
+            if (!/^[A-Za-z0-9_-]+$/.test(seg)) {
+                throw new Error(`Line ${lineNum}: invalid bare key segment: ${seg}`);
+            }
+            segments.push(seg);
+            i = j;
+        }
+    }
+    if (segments.length < 2) {
+        throw new Error(`Line ${lineNum}: table header must have at least 2 segments: ${line}`);
+    }
+    const section = segments[0];
+    if (!KNOWN_SECTIONS.has(section)) {
+        throw new Error(`Line ${lineNum}: unknown section "${section}" in: ${line}`);
+    }
+    if (segments.length === 3 && segments[2] === 'env') {
+        return { section, name: segments[1], isEnv: true };
+    }
+    if (segments.length === 2) {
+        return { section, name: segments[1], isEnv: false };
+    }
+    throw new Error(`Line ${lineNum}: unexpected table header depth: ${line}`);
+}
+export function parseManifest(text) {
+    const manifest = { mcp: {} };
+    let currentSection = null;
+    let currentName = null;
+    let inEnv = false;
+    const lines = text.split('\n');
+    for (let idx = 0; idx < lines.length; idx++) {
+        const lineNum = idx + 1;
+        const line = lines[idx].trim();
+        // Skip blank and comment lines
+        if (line === '' || line.startsWith('#'))
+            continue;
+        // Table header
+        if (line.startsWith('[')) {
+            if (!line.endsWith(']')) {
+                throw new Error(`Line ${lineNum}: malformed table header: ${line}`);
+            }
+            const { section, name, isEnv } = parseTableHeader(line, lineNum);
+            currentSection = section;
+            currentName = name;
+            inEnv = isEnv;
+            // Ensure the section map exists
+            if (section === 'mcp') {
+                manifest.mcp = manifest.mcp ?? {};
+                if (!manifest.mcp[name])
+                    manifest.mcp[name] = {};
+            }
+            else if (section === 'skills') {
+                manifest.skills = manifest.skills ?? {};
+                if (!manifest.skills[name])
+                    manifest.skills[name] = {};
+            }
+            else if (section === 'workflows') {
+                manifest.workflows = manifest.workflows ?? {};
+                if (!manifest.workflows[name])
+                    manifest.workflows[name] = {};
+            }
+            continue;
+        }
+        // Key = value
+        const eqIdx = line.indexOf('=');
+        if (eqIdx === -1) {
+            throw new Error(`Line ${lineNum}: expected key = value, got: ${line}`);
+        }
+        const key = line.slice(0, eqIdx).trim();
+        const rawVal = line.slice(eqIdx + 1).trim();
+        if (currentSection === null || currentName === null) {
+            throw new Error(`Line ${lineNum}: key/value before any table header: ${line}`);
+        }
+        // Get current entry
+        const sectionMap = currentSection === 'mcp'
+            ? manifest.mcp
+            : currentSection === 'skills'
+                ? (manifest.skills ??= {})
+                : (manifest.workflows ??= {});
+        const entry = (sectionMap[currentName] ??= {});
+        if (inEnv) {
+            // Any key, string value
+            const strVal = parseTomlString(rawVal, lineNum);
+            entry.env = entry.env ?? {};
+            entry.env[key] = strVal;
+        }
+        else {
+            // Known entry keys only
+            if (!KNOWN_ENTRY_KEYS.has(key)) {
+                throw new Error(`Line ${lineNum}: unknown key "${key}" in entry table`);
+            }
+            if (key === 'command') {
+                entry.command = parseStringArray(rawVal, lineNum);
+            }
+            else if (key === 'url') {
+                entry.url = parseTomlString(rawVal, lineNum);
+            }
+            else if (key === 'enabled') {
+                if (rawVal === 'true')
+                    entry.enabled = true;
+                else if (rawVal === 'false')
+                    entry.enabled = false;
+                else
+                    throw new Error(`Line ${lineNum}: enabled must be true or false, got: ${rawVal}`);
+            }
+        }
+    }
+    return manifest;
+}
+// ── File I/O ──────────────────────────────────────────────────────────────────
+export function readManifest(path) {
+    if (!existsSync(path))
+        return null;
+    const text = readFileSync(path, 'utf8');
+    return parseManifest(text);
+}
+export function writeManifest(path, m) {
+    atomicWriteFile(path, serializeManifest(m), 0o644);
+}
+// ── Remote/file loader ────────────────────────────────────────────────────────
+/**
+ * Load a StackManifest from a URL or file path.
+ * Throws a descriptive Error on fetch failure, missing file, or parse error.
+ * The caller is responsible for mapping thrown errors to usageError output.
+ */
+export async function loadManifestFromSource(source, opts) {
+    let text;
+    if (/^https?:\/\//i.test(source)) {
+        // URL source
+        const fetcher = opts.fetcher ?? globalThis.fetch;
+        let res;
+        try {
+            res = await fetcher(source);
+        }
+        catch (e) {
+            throw new Error(`Could not fetch manifest from ${source}: ${e instanceof Error ? e.message : String(e)}`, { cause: e });
+        }
+        if (!res.ok) {
+            throw new Error(`Could not fetch manifest from ${source}: HTTP ${res.status}`);
+        }
+        text = await res.text();
+    }
+    else {
+        // File path source
+        const absPath = resolve(opts.cwd ?? process.cwd(), source);
+        if (!existsSync(absPath)) {
+            throw new Error(`Could not read manifest from ${source}: file not found`);
+        }
+        text = readFileSync(absPath, 'utf8');
+    }
+    try {
+        return parseManifest(text);
+    }
+    catch (e) {
+        throw new Error(`Invalid manifest from ${source}: ${e instanceof Error ? e.message : String(e)}`, { cause: e });
+    }
+}
+//# sourceMappingURL=manifest.js.map

package/dist/stack/manifest.js.map

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

package/dist/stack/mcp-probe.d.ts

@@ -0,0 +1,23 @@
+export interface McpTool {
+    name: string;
+    description?: string;
+}
+export interface McpProbeResult {
+    ok: boolean;
+    serverInfo?: {
+        name?: string;
+        version?: string;
+    };
+    capabilities?: unknown;
+    tools?: McpTool[];
+    error?: string;
+    stderr?: string;
+    exitCode?: number | null;
+    durationMs?: number;
+}
+export declare function probeMcpServer(command: string[], opts?: {
+    env?: Record<string, string | undefined>;
+    cwd?: string;
+    timeoutMs?: number;
+}): Promise<McpProbeResult>;
+//# sourceMappingURL=mcp-probe.d.ts.map

package/dist/stack/mcp-probe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-probe.d.ts","sourceRoot":"","sources":["../../src/stack/mcp-probe.ts"],"names":[],"mappings":"AAiBA,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,OAAO,CAAC;IACZ,UAAU,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACjD,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,KAAK,CAAC,EAAE,OAAO,EAAE,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAmBD,wBAAsB,cAAc,CAClC,OAAO,EAAE,MAAM,EAAE,EACjB,IAAI,CAAC,EAAE;IACL,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;IACzC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,GACA,OAAO,CAAC,cAAc,CAAC,CAyNzB"}

package/dist/stack/mcp-probe.js

@@ -0,0 +1,230 @@
+import { spawn } from 'node:child_process';
+import { readFileSync } from 'node:fs';
+let _pkgVersion;
+function getPkgVersion() {
+    if (_pkgVersion !== undefined)
+        return _pkgVersion;
+    try {
+        const pkg = JSON.parse(readFileSync(new URL('../../package.json', import.meta.url), 'utf8'));
+        _pkgVersion = pkg.version ?? '0';
+    }
+    catch {
+        _pkgVersion = '0';
+    }
+    return _pkgVersion;
+}
+const STDERR_CAP = 4000;
+function appendStderr(buf, chunk) {
+    const combined = buf + chunk;
+    if (combined.length <= STDERR_CAP)
+        return combined;
+    // Keep the tail
+    return combined.slice(combined.length - STDERR_CAP);
+}
+function stderrSnippet(buf) {
+    const trimmed = buf.trimEnd();
+    if (!trimmed)
+        return '';
+    // Last ~200 chars, collapsed to a single line
+    const tail = trimmed.length > 200 ? trimmed.slice(trimmed.length - 200) : trimmed;
+    return tail.replace(/\r?\n/g, ' ').trim();
+}
+export async function probeMcpServer(command, opts) {
+    const timeoutMs = opts?.timeoutMs ?? 15000;
+    const startMs = Date.now();
+    const mergedEnv = {};
+    for (const [k, v] of Object.entries(process.env)) {
+        if (v !== undefined)
+            mergedEnv[k] = v;
+    }
+    if (opts?.env) {
+        for (const [k, v] of Object.entries(opts.env)) {
+            if (v !== undefined)
+                mergedEnv[k] = v;
+        }
+    }
+    return new Promise((resolveOuter) => {
+        let settled = false;
+        let timer = null;
+        let currentStage = 'initialize';
+        const child = spawn(command[0], command.slice(1), {
+            stdio: ['pipe', 'pipe', 'pipe'],
+            shell: false,
+            env: mergedEnv,
+            cwd: opts?.cwd
+        });
+        // Pending RPC handlers keyed by message id
+        const pending = new Map();
+        // Partial line buffer for stdout
+        let lineBuffer = '';
+        // Bounded stderr capture (tail up to STDERR_CAP chars)
+        let stderrBuf = '';
+        function durationMs() {
+            return Date.now() - startMs;
+        }
+        function cleanup() {
+            if (timer !== null) {
+                clearTimeout(timer);
+                timer = null;
+            }
+            try {
+                child.kill('SIGTERM');
+                // Give it a short grace period then SIGKILL
+                setTimeout(() => {
+                    try {
+                        child.kill('SIGKILL');
+                    }
+                    catch {
+                        // already dead
+                    }
+                }, 300);
+            }
+            catch {
+                // already dead
+            }
+        }
+        function resolve(result) {
+            if (settled)
+                return;
+            settled = true;
+            cleanup();
+            const capturedStderr = stderrBuf.trimEnd();
+            const withStderr = {
+                ...result,
+                durationMs: durationMs(),
+                ...(capturedStderr ? { stderr: capturedStderr } : {})
+            };
+            resolveOuter(withStderr);
+        }
+        // Capture stderr (bounded)
+        child.stderr.on('data', (chunk) => {
+            stderrBuf = appendStderr(stderrBuf, chunk.toString('utf8'));
+        });
+        // Set overall timeout
+        timer = setTimeout(() => {
+            const snippet = stderrSnippet(stderrBuf);
+            const base = `timed out waiting for ${currentStage}`;
+            resolve({ ok: false, error: snippet ? `${base} — stderr: ${snippet}` : base });
+        }, timeoutMs);
+        child.on('error', (err) => {
+            const snippet = stderrSnippet(stderrBuf);
+            resolve({ ok: false, error: snippet ? `${err.message} — stderr: ${snippet}` : err.message });
+        });
+        child.on('close', (code) => {
+            if (!settled) {
+                const snippet = stderrSnippet(stderrBuf);
+                const base = 'server exited';
+                resolve({
+                    ok: false,
+                    error: snippet ? `${base} — stderr: ${snippet}` : base,
+                    exitCode: code
+                });
+            }
+        });
+        // Parse stdout as newline-delimited JSON
+        child.stdout.on('data', (chunk) => {
+            lineBuffer += chunk.toString('utf8');
+            const lines = lineBuffer.split('\n');
+            // Keep the last (potentially incomplete) segment
+            lineBuffer = lines.pop() ?? '';
+            for (const line of lines) {
+                const trimmed = line.trim();
+                if (!trimmed)
+                    continue;
+                let msg;
+                try {
+                    msg = JSON.parse(trimmed);
+                }
+                catch {
+                    // Not JSON (e.g. server debug output) — ignore
+                    continue;
+                }
+                if (typeof msg !== 'object' || msg === null)
+                    continue;
+                const record = msg;
+                const id = record.id;
+                if (typeof id === 'number' && pending.has(id)) {
+                    const handler = pending.get(id);
+                    pending.delete(id);
+                    handler(msg);
+                }
+            }
+        });
+        function writeMsg(msg) {
+            const line = JSON.stringify(msg) + '\n';
+            child.stdin.write(line);
+        }
+        // ── Handshake ────────────────────────────────────────────────────────────
+        function awaitResponse(id) {
+            return new Promise((res) => {
+                pending.set(id, (msg) => res(msg));
+            });
+        }
+        async function handshake() {
+            // 1. Send initialize
+            currentStage = 'initialize';
+            writeMsg({
+                jsonrpc: '2.0',
+                id: 1,
+                method: 'initialize',
+                params: {
+                    protocolVersion: '2024-11-05',
+                    capabilities: {},
+                    clientInfo: { name: 'agora', version: getPkgVersion() }
+                }
+            });
+            const initResp = await awaitResponse(1);
+            if (settled)
+                return;
+            if (initResp.error) {
+                const rpcErr = initResp.error;
+                const errMsg = typeof rpcErr === 'object' && rpcErr !== null
+                    ? (rpcErr.message ?? JSON.stringify(rpcErr))
+                    : String(rpcErr);
+                resolve({ ok: false, error: errMsg });
+                return;
+            }
+            const result = (initResp.result ?? {});
+            const serverInfo = result.serverInfo;
+            const capabilities = result.capabilities;
+            // 2. Send initialized notification (no id)
+            currentStage = 'initialized notification';
+            writeMsg({ jsonrpc: '2.0', method: 'notifications/initialized' });
+            // 3. Request tools/list
+            currentStage = 'tools/list';
+            writeMsg({ jsonrpc: '2.0', id: 2, method: 'tools/list', params: {} });
+            const toolsResp = await awaitResponse(2);
+            if (settled)
+                return;
+            if (toolsResp.error) {
+                // Initialize succeeded; tools/list failed — server is still usable
+                const rpcErr = toolsResp.error;
+                const errMsg = typeof rpcErr === 'object' && rpcErr !== null
+                    ? (rpcErr.message ?? JSON.stringify(rpcErr))
+                    : String(rpcErr);
+                resolve({ ok: true, serverInfo, capabilities, tools: [], error: errMsg });
+                return;
+            }
+            const toolsResult = (toolsResp.result ?? {});
+            const rawTools = Array.isArray(toolsResult.tools) ? toolsResult.tools : [];
+            const tools = rawTools.map((t) => {
+                const tool = t;
+                return {
+                    name: typeof tool.name === 'string' ? tool.name : '(unknown)',
+                    ...(typeof tool.description === 'string' ? { description: tool.description } : {})
+                };
+            });
+            resolve({ ok: true, serverInfo, capabilities, tools });
+        }
+        // Start handshake; any thrown error becomes a failure
+        handshake().catch((err) => {
+            if (!settled) {
+                resolve({
+                    ok: false,
+                    error: err instanceof Error ? err.message : String(err)
+                });
+            }
+        });
+    });
+}
+//# sourceMappingURL=mcp-probe.js.map

package/dist/stack/mcp-probe.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-probe.js","sourceRoot":"","sources":["../../src/stack/mcp-probe.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAC3C,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAEvC,IAAI,WAA+B,CAAC;AACpC,SAAS,aAAa;IACpB,IAAI,WAAW,KAAK,SAAS;QAAE,OAAO,WAAW,CAAC;IAClD,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CACpB,YAAY,CAAC,IAAI,GAAG,CAAC,oBAAoB,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,CAC7C,CAAC;QAC1B,WAAW,GAAG,GAAG,CAAC,OAAO,IAAI,GAAG,CAAC;IACnC,CAAC;IAAC,MAAM,CAAC;QACP,WAAW,GAAG,GAAG,CAAC;IACpB,CAAC;IACD,OAAO,WAAW,CAAC;AACrB,CAAC;AAkBD,MAAM,UAAU,GAAG,IAAI,CAAC;AAExB,SAAS,YAAY,CAAC,GAAW,EAAE,KAAa;IAC9C,MAAM,QAAQ,GAAG,GAAG,GAAG,KAAK,CAAC;IAC7B,IAAI,QAAQ,CAAC,MAAM,IAAI,UAAU;QAAE,OAAO,QAAQ,CAAC;IACnD,gBAAgB;IAChB,OAAO,QAAQ,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,GAAG,UAAU,CAAC,CAAC;AACtD,CAAC;AAED,SAAS,aAAa,CAAC,GAAW;IAChC,MAAM,OAAO,GAAG,GAAG,CAAC,OAAO,EAAE,CAAC;IAC9B,IAAI,CAAC,OAAO;QAAE,OAAO,EAAE,CAAC;IACxB,8CAA8C;IAC9C,MAAM,IAAI,GAAG,OAAO,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;IAClF,OAAO,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;AAC5C,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,OAAiB,EACjB,IAIC;IAED,MAAM,SAAS,GAAG,IAAI,EAAE,SAAS,IAAI,KAAK,CAAC;IAC3C,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAE3B,MAAM,SAAS,GAA2B,EAAE,CAAC;IAC7C,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QACjD,IAAI,CAAC,KAAK,SAAS;YAAE,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IACxC,CAAC;IACD,IAAI,IAAI,EAAE,GAAG,EAAE,CAAC;QACd,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;YAC9C,IAAI,CAAC,KAAK,SAAS;gBAAE,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;QACxC,CAAC;IACH,CAAC;IAED,OAAO,IAAI,OAAO,CAAiB,CAAC,YAAY,EAAE,EAAE;QAClD,IAAI,OAAO,GAAG,KAAK,CAAC;QACpB,IAAI,KAAK,GAAyC,IAAI,CAAC;QACvD,IAAI,YAAY,GAAG,YAAY,CAAC;QAEhC,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC,CAAE,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE;YACjD,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC;YAC/B,KAAK,EAAE,KAAK;YACZ,GAAG,EAAE,SAAS;YACd,GAAG,EAAE,IAAI,EAAE,GAAG;SACf,CAAC,CAAC;QAEH,2CAA2C;QAC3C,MAAM,OAAO,GAAG,IAAI,GAAG,EAAkC,CAAC;QAC1D,iCAAiC;QACjC,IAAI,UAAU,GAAG,EAAE,CAAC;QACpB,uDAAuD;QACvD,IAAI,SAAS,GAAG,EAAE,CAAC;QAEnB,SAAS,UAAU;YACjB,OAAO,IAAI,CAAC,GAAG,EAAE,GAAG,OAAO,CAAC;QAC9B,CAAC;QAED,SAAS,OAAO;YACd,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;gBACnB,YAAY,CAAC,KAAK,CAAC,CAAC;gBACpB,KAAK,GAAG,IAAI,CAAC;YACf,CAAC;YACD,IAAI,CAAC;gBACH,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;gBACtB,4CAA4C;gBAC5C,UAAU,CAAC,GAAG,EAAE;oBACd,IAAI,CAAC;wBACH,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;oBACxB,CAAC;oBAAC,MAAM,CAAC;wBACP,eAAe;oBACjB,CAAC;gBACH,CAAC,EAAE,GAAG,CAAC,CAAC;YACV,CAAC;YAAC,MAAM,CAAC;gBACP,eAAe;YACjB,CAAC;QACH,CAAC;QAED,SAAS,OAAO,CAAC,MAAsB;YACrC,IAAI,OAAO;gBAAE,OAAO;YACpB,OAAO,GAAG,IAAI,CAAC;YACf,OAAO,EAAE,CAAC;YACV,MAAM,cAAc,GAAG,SAAS,CAAC,OAAO,EAAE,CAAC;YAC3C,MAAM,UAAU,GAAmB;gBACjC,GAAG,MAAM;gBACT,UAAU,EAAE,UAAU,EAAE;gBACxB,GAAG,CAAC,cAAc,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,cAAc,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aACtD,CAAC;YACF,YAAY,CAAC,UAAU,CAAC,CAAC;QAC3B,CAAC;QAED,2BAA2B;QAC3B,KAAK,CAAC,MAAO,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAa,EAAE,EAAE;YACzC,SAAS,GAAG,YAAY,CAAC,SAAS,EAAE,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC;QAC9D,CAAC,CAAC,CAAC;QAEH,sBAAsB;QACtB,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;YACtB,MAAM,OAAO,GAAG,aAAa,CAAC,SAAS,CAAC,CAAC;YACzC,MAAM,IAAI,GAAG,yBAAyB,YAAY,EAAE,CAAC;YACrD,OAAO,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,IAAI,cAAc,OAAO,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;QACjF,CAAC,EAAE,SAAS,CAAC,CAAC;QAEd,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE;YACxB,MAAM,OAAO,GAAG,aAAa,CAAC,SAAS,CAAC,CAAC;YACzC,OAAO,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,OAAO,cAAc,OAAO,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;QAC/F,CAAC,CAAC,CAAC;QAEH,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE;YACzB,IAAI,CAAC,OAAO,EAAE,CAAC;gBACb,MAAM,OAAO,GAAG,aAAa,CAAC,SAAS,CAAC,CAAC;gBACzC,MAAM,IAAI,GAAG,eAAe,CAAC;gBAC7B,OAAO,CAAC;oBACN,EAAE,EAAE,KAAK;oBACT,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,IAAI,cAAc,OAAO,EAAE,CAAC,CAAC,CAAC,IAAI;oBACtD,QAAQ,EAAE,IAAI;iBACf,CAAC,CAAC;YACL,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,yCAAyC;QACzC,KAAK,CAAC,MAAO,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAa,EAAE,EAAE;YACzC,UAAU,IAAI,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;YACrC,MAAM,KAAK,GAAG,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YACrC,iDAAiD;YACjD,UAAU,GAAG,KAAK,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC;YAC/B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;gBACzB,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;gBAC5B,IAAI,CAAC,OAAO;oBAAE,SAAS;gBACvB,IAAI,GAAY,CAAC;gBACjB,IAAI,CAAC;oBACH,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;gBAC5B,CAAC;gBAAC,MAAM,CAAC;oBACP,+CAA+C;oBAC/C,SAAS;gBACX,CAAC;gBACD,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,IAAI;oBAAE,SAAS;gBACtD,MAAM,MAAM,GAAG,GAA8B,CAAC;gBAC9C,MAAM,EAAE,GAAG,MAAM,CAAC,EAAE,CAAC;gBACrB,IAAI,OAAO,EAAE,KAAK,QAAQ,IAAI,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC;oBAC9C,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,EAAE,CAAE,CAAC;oBACjC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;oBACnB,OAAO,CAAC,GAAG,CAAC,CAAC;gBACf,CAAC;YACH,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,SAAS,QAAQ,CAAC,GAAY;YAC5B,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC;YACxC,KAAK,CAAC,KAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC3B,CAAC;QAED,4EAA4E;QAE5E,SAAS,aAAa,CAAC,EAAU;YAC/B,OAAO,IAAI,OAAO,CAAC,CAAC,GAAG,EAAE,EAAE;gBACzB,OAAO,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,GAA8B,CAAC,CAAC,CAAC;YAChE,CAAC,CAAC,CAAC;QACL,CAAC;QAED,KAAK,UAAU,SAAS;YACtB,qBAAqB;YACrB,YAAY,GAAG,YAAY,CAAC;YAC5B,QAAQ,CAAC;gBACP,OAAO,EAAE,KAAK;gBACd,EAAE,EAAE,CAAC;gBACL,MAAM,EAAE,YAAY;gBACpB,MAAM,EAAE;oBACN,eAAe,EAAE,YAAY;oBAC7B,YAAY,EAAE,EAAE;oBAChB,UAAU,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,EAAE;iBACxD;aACF,CAAC,CAAC;YAEH,MAAM,QAAQ,GAAG,MAAM,aAAa,CAAC,CAAC,CAAC,CAAC;YAExC,IAAI,OAAO;gBAAE,OAAO;YAEpB,IAAI,QAAQ,CAAC,KAAK,EAAE,CAAC;gBACnB,MAAM,MAAM,GAAG,QAAQ,CAAC,KAAsC,CAAC;gBAC/D,MAAM,MAAM,GACV,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,IAAI;oBAC3C,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,IAAI,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;oBAC5C,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;gBACrB,OAAO,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC;gBACtC,OAAO;YACT,CAAC;YAED,MAAM,MAAM,GAAG,CAAC,QAAQ,CAAC,MAAM,IAAI,EAAE,CAA4B,CAAC;YAClE,MAAM,UAAU,GAAG,MAAM,CAAC,UAA6D,CAAC;YACxF,MAAM,YAAY,GAAG,MAAM,CAAC,YAAY,CAAC;YAEzC,2CAA2C;YAC3C,YAAY,GAAG,0BAA0B,CAAC;YAC1C,QAAQ,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,2BAA2B,EAAE,CAAC,CAAC;YAElE,wBAAwB;YACxB,YAAY,GAAG,YAAY,CAAC;YAC5B,QAAQ,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,CAAC;YAEtE,MAAM,SAAS,GAAG,MAAM,aAAa,CAAC,CAAC,CAAC,CAAC;YAEzC,IAAI,OAAO;gBAAE,OAAO;YAEpB,IAAI,SAAS,CAAC,KAAK,EAAE,CAAC;gBACpB,mEAAmE;gBACnE,MAAM,MAAM,GAAG,SAAS,CAAC,KAAsC,CAAC;gBAChE,MAAM,MAAM,GACV,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,IAAI;oBAC3C,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,IAAI,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;oBAC5C,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;gBACrB,OAAO,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,YAAY,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC;gBAC1E,OAAO;YACT,CAAC;YAED,MAAM,WAAW,GAAG,CAAC,SAAS,CAAC,MAAM,IAAI,EAAE,CAA0B,CAAC;YACtE,MAAM,QAAQ,GAAG,KAAK,CAAC,OAAO,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;YAC3E,MAAM,KAAK,GAAc,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;gBAC1C,MAAM,IAAI,GAAG,CAA4C,CAAC;gBAC1D,OAAO;oBACL,IAAI,EAAE,OAAO,IAAI,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,WAAW;oBAC7D,GAAG,CAAC,OAAO,IAAI,CAAC,WAAW,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;iBACnF,CAAC;YACJ,CAAC,CAAC,CAAC;YAEH,OAAO,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,YAAY,EAAE,KAAK,EAAE,CAAC,CAAC;QACzD,CAAC;QAED,sDAAsD;QACtD,SAAS,EAAE,CAAC,KAAK,CAAC,CAAC,GAAY,EAAE,EAAE;YACjC,IAAI,CAAC,OAAO,EAAE,CAAC;gBACb,OAAO,CAAC;oBACN,EAAE,EAAE,KAAK;oBACT,KAAK,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;iBACxD,CAAC,CAAC;YACL,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/stack/path-resolve.d.ts

@@ -0,0 +1,7 @@
+export declare const KNOWN_RUNNERS: Set<string>;
+/**
+ * Returns the absolute path of `command` if found by scanning PATH dirs,
+ * else null. Respects PATHEXT on win32. Reads env.PATH or process.env.PATH.
+ */
+export declare function resolveOnPath(command: string, env?: Record<string, string | undefined>): string | null;
+//# sourceMappingURL=path-resolve.d.ts.map

package/dist/stack/path-resolve.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"path-resolve.d.ts","sourceRoot":"","sources":["../../src/stack/path-resolve.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,aAAa,aASxB,CAAC;AAEH;;;GAGG;AACH,wBAAgB,aAAa,CAC3B,OAAO,EAAE,MAAM,EACf,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,GACvC,MAAM,GAAG,IAAI,CAwBf"}