@edwardlee5423/magi 0.1.0-alpha.0

package/dist/routing/model-router.d.ts

@@ -0,0 +1,55 @@
+import { MagiConfig } from "../config.js";
+import { ResolvedModel } from "./model-alias.js";
+/**
+ * Task classification for intelligent model routing.
+ * When alias is "auto", the router picks the best model based on prompt characteristics.
+ */
+export type RouteKind = "quick" | "coding" | "reasoning" | "vision" | "long_context" | "review" | "planning" | "extraction" | "tool_heavy" | "agent";
+export interface ModelCapabilities {
+    family: string;
+    role?: "haiku" | "sonnet" | "opus" | "main";
+    contextWindow: number;
+    supportsVision: boolean;
+    specialty?: "coding" | "reasoning" | "vision" | "general";
+    priority?: number;
+}
+export interface RouterCandidate {
+    providerName: string;
+    model: string;
+    capabilities: ModelCapabilities;
+}
+export interface RouterConfig {
+    candidates: Record<string, ModelCapabilities>;
+}
+/**
+ * Optional context that influences routing decisions beyond the prompt itself.
+ */
+export interface RouteContext {
+    hasImage?: boolean;
+    /** True when EnterPlanMode is active. Routes prefer Opus/strongest models. */
+    isPlanMode?: boolean;
+    /** Estimated total context size (history + prompt) in tokens. Forces long_context route when above threshold. */
+    estimatedContextTokens?: number;
+    /** Threshold above which to force long_context (default 200k). */
+    longContextThreshold?: number;
+}
+/** Telemetry record for a routing decision. */
+export interface RouteDecision {
+    routeKind: RouteKind;
+    chosenAlias: string;
+    chosenScore: number;
+    resolved: ResolvedModel;
+    candidates: Array<{
+        alias: string;
+        score: number;
+    }>;
+    context: RouteContext;
+}
+export declare function classifyTask(prompt: string, context?: RouteContext | boolean): RouteKind;
+export declare function scoreCandidate(capabilities: ModelCapabilities, routeKind: RouteKind): number;
+export declare function routeAuto(config: MagiConfig, prompt: string, context?: RouteContext | boolean): ResolvedModel | undefined;
+/**
+ * Like routeAuto but returns a full decision record (task kind, candidate scores, etc.)
+ * for telemetry and debugging.
+ */
+export declare function routeAutoDetailed(config: MagiConfig, prompt: string, context?: RouteContext | boolean): RouteDecision | undefined;

package/dist/routing/model-router.js

@@ -0,0 +1,233 @@
+import { resolveModelAlias } from "./model-alias.js";
+const CODE_KEYWORDS = /\b(function|class|import|export|const|let|var|def|fn|struct|impl|interface|enum|module|package|async|await|yield|instanceof|extends|implements|typeof|void|int|string|bool|float|double|null|undefined|nil|None|True|False|self|super|static|private|protected|pub)\b/;
+const REASONING_KEYWORDS = /\b(why|how|explain|analyze|compare|evaluate|reason|think|consider|argue|debate|prove|derive|deduce|infer|conclude|hypothesis|theory|because|therefore|consequently|furthermore|moreover|however|nevertheless|although|whereas|implications?|trade-?offs?|pros?\s+and\s+cons?)\b/i;
+const REVIEW_KEYWORDS = /\b(review|refactor|improve|optimize|clean\s*up|simplify|restructure|rewrite|audit|check|lint|fix\s+style|code\s+quality|best\s+practice|technical\s+debt)\b/i;
+const PLANNING_KEYWORDS = /\b(plan|design|architect|strategy|approach|roadmap|breakdown|decompose|structure|organize|outline|proposal|rfc|spec|specification)\b/i;
+const EXTRACTION_KEYWORDS = /\b(extract|parse|convert|transform|summarize|summarise|list\s+all|find\s+all|collect|gather|enumerate|catalog)\b/i;
+const AGENT_KEYWORDS = /\b(implement|build|create|add\s+feature|set\s+up|configure|deploy|migrate|upgrade|install|scaffold|bootstrap|integrate)\b/i;
+const TOOL_HEAVY_KEYWORDS = /\b(refactor.*(?:files|codebase|repo)|search.*and.*replace|across.*(?:files|repo)|repo-?wide|all.*\.(?:ts|js|tsx|jsx|go|py|rs|java)\b|mass\s+(?:rename|update)|migrate.*(?:codebase|imports?)|run.*(?:tests?|build|lint).*and|setup.*(?:project|repo)|scaffold|bootstrap|find.*(?:and|then).*(?:fix|edit|update).*(?:all|every))\b/i;
+export function classifyTask(prompt, context = {}) {
+    // Backwards compat: second arg used to be `hasImage` boolean
+    const ctx = typeof context === "boolean" ? { hasImage: context } : context;
+    const longContextThreshold = ctx.longContextThreshold ?? 200_000;
+    // 1. Forced long-context — total context exceeds threshold
+    if (ctx.estimatedContextTokens !== undefined && ctx.estimatedContextTokens >= longContextThreshold) {
+        return "long_context";
+    }
+    // 2. Plan mode — always favor planning route
+    if (ctx.isPlanMode) {
+        return "planning";
+    }
+    // 3. Vision
+    if (ctx.hasImage) {
+        return "vision";
+    }
+    // 4. Long-context based on prompt size alone
+    if (estimateTokens(prompt) > 50_000) {
+        return "long_context";
+    }
+    // 5. Keyword-based classification — review/planning take precedence over tool_heavy
+    if (PLANNING_KEYWORDS.test(prompt) && prompt.length > 100) {
+        return "planning";
+    }
+    if (REVIEW_KEYWORDS.test(prompt)) {
+        return "review";
+    }
+    // 6. Heavy tool usage — only if not already classified
+    if (TOOL_HEAVY_KEYWORDS.test(prompt)) {
+        return "tool_heavy";
+    }
+    if (AGENT_KEYWORDS.test(prompt) && prompt.length > 60) {
+        return "agent";
+    }
+    // Extraction takes precedence even if code keywords appear, when the prompt
+    // pattern clearly says "extract/list/find all X from Y"
+    if (/\b(?:extract|list|find|enumerate)\s+(?:all|every|the)\b/i.test(prompt)) {
+        return "extraction";
+    }
+    if (EXTRACTION_KEYWORDS.test(prompt) && !CODE_KEYWORDS.test(prompt)) {
+        return "extraction";
+    }
+    if (REASONING_KEYWORDS.test(prompt) && !CODE_KEYWORDS.test(prompt)) {
+        return "reasoning";
+    }
+    if (CODE_KEYWORDS.test(prompt)) {
+        return "coding";
+    }
+    const length = prompt.length;
+    if (length < 280) {
+        return "quick";
+    }
+    return "coding";
+}
+export function scoreCandidate(capabilities, routeKind) {
+    let score = capabilities.priority ?? 0;
+    // Model family × task type scoring
+    switch (routeKind) {
+        case "coding":
+            if (capabilities.family === "claude")
+                score += 28;
+            else if (capabilities.family === "deepseek")
+                score += 24;
+            else if (capabilities.family === "gpt")
+                score += 20;
+            if (capabilities.specialty === "coding")
+                score += 22;
+            break;
+        case "reasoning":
+            if (capabilities.family === "deepseek")
+                score += 30;
+            else if (capabilities.family === "claude")
+                score += 22;
+            else if (capabilities.family === "gpt")
+                score += 18;
+            if (capabilities.specialty === "reasoning")
+                score += 14;
+            break;
+        case "planning":
+            if (capabilities.role === "opus")
+                score += 30;
+            else if (capabilities.family === "claude")
+                score += 24;
+            else if (capabilities.family === "deepseek")
+                score += 20;
+            break;
+        case "agent":
+            if (capabilities.role === "opus")
+                score += 30;
+            else if (capabilities.family === "claude")
+                score += 26;
+            else if (capabilities.family === "deepseek")
+                score += 18;
+            else if (capabilities.family === "gpt")
+                score += 20;
+            if (capabilities.specialty === "coding")
+                score += 18;
+            break;
+        case "extraction":
+            if (capabilities.role === "haiku")
+                score += 20;
+            else if (capabilities.role === "sonnet")
+                score += 16;
+            else if (capabilities.family === "gpt")
+                score += 14;
+            break;
+        case "tool_heavy":
+            if (capabilities.family === "claude")
+                score += 28;
+            else if (capabilities.family === "gpt")
+                score += 22;
+            else if (capabilities.family === "deepseek")
+                score += 16;
+            if (capabilities.specialty === "coding")
+                score += 18;
+            break;
+        case "quick":
+            if (capabilities.role === "haiku")
+                score += 18;
+            else if (capabilities.role === "sonnet")
+                score += 10;
+            break;
+        case "long_context":
+            if (capabilities.contextWindow >= 1_000_000)
+                score += 24;
+            else if (capabilities.contextWindow >= 200_000)
+                score += 16;
+            break;
+        case "vision":
+            if (capabilities.supportsVision)
+                score += 20;
+            if (capabilities.specialty === "vision")
+                score += 14;
+            break;
+        case "review":
+            if (capabilities.family === "claude")
+                score += 24;
+            else if (capabilities.family === "gpt")
+                score += 20;
+            if (capabilities.specialty === "coding")
+                score += 16;
+            break;
+    }
+    // Context window bonus (always relevant)
+    if (capabilities.contextWindow >= 1_000_000)
+        score += 24;
+    else if (capabilities.contextWindow >= 250_000)
+        score += 16;
+    else if (capabilities.contextWindow >= 128_000)
+        score += 8;
+    // Role bonus is task-specific. Opus only wins for genuinely complex/strategic
+    // tasks. For everyday coding/reasoning, prefer sonnet (cost/speed sweet spot).
+    if (routeKind === "planning" || routeKind === "agent") {
+        // Strategic tasks favor opus
+        if (capabilities.role === "opus")
+            score += 10;
+        else if (capabilities.role === "sonnet" || capabilities.role === "main")
+            score += 4;
+    }
+    else if (routeKind === "quick" || routeKind === "extraction") {
+        // Cheap tasks favor haiku
+        if (capabilities.role === "haiku")
+            score += 6;
+        else if (capabilities.role === "sonnet" || capabilities.role === "main")
+            score += 2;
+        // Opus gets nothing for trivial tasks — too expensive
+    }
+    else {
+        // Default tasks (coding/reasoning/review/tool_heavy/long_context/vision):
+        // Sonnet is the sweet spot. Opus gets a smaller bonus (not dominant).
+        if (capabilities.role === "sonnet" || capabilities.role === "main")
+            score += 6;
+        else if (capabilities.role === "opus")
+            score += 3;
+        else if (capabilities.role === "haiku")
+            score += 1;
+    }
+    return score;
+}
+export function routeAuto(config, prompt, context = {}) {
+    const decision = routeAutoDetailed(config, prompt, context);
+    return decision?.resolved;
+}
+/**
+ * Like routeAuto but returns a full decision record (task kind, candidate scores, etc.)
+ * for telemetry and debugging.
+ */
+export function routeAutoDetailed(config, prompt, context = {}) {
+    const ctx = typeof context === "boolean" ? { hasImage: context } : context;
+    const routerConfig = config.models.router;
+    if (!routerConfig || Object.keys(routerConfig).length === 0) {
+        return undefined;
+    }
+    const routeKind = classifyTask(prompt, ctx);
+    const candidates = [];
+    let bestScore = -1;
+    let bestAlias;
+    for (const [alias, capabilities] of Object.entries(routerConfig)) {
+        const score = scoreCandidate(capabilities, routeKind);
+        candidates.push({ alias, score });
+        if (score > bestScore) {
+            bestScore = score;
+            bestAlias = alias;
+        }
+    }
+    if (!bestAlias) {
+        return undefined;
+    }
+    const resolved = resolveModelAlias(config, bestAlias);
+    return {
+        routeKind,
+        chosenAlias: bestAlias,
+        chosenScore: bestScore,
+        resolved,
+        candidates: candidates.sort((a, b) => b.score - a.score),
+        context: ctx
+    };
+}
+function estimateTokens(text) {
+    // Rough estimate: ~4 chars per token for English, ~2 for CJK
+    const cjkCount = (text.match(/[\u4e00-\u9fff\u3040-\u309f\u30a0-\u30ff]/g) ?? []).length;
+    const nonCjkLength = text.length - cjkCount;
+    return Math.ceil(nonCjkLength / 4) + Math.ceil(cjkCount / 2);
+}
+//# sourceMappingURL=model-router.js.map

package/dist/routing/model-router.js.map

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

package/dist/routing/router.d.ts

@@ -0,0 +1,26 @@
+import { MagiConfig } from "../config.js";
+import { ProviderRegistry } from "../providers/registry.js";
+import { MagiMessage, MagiToolDefinition, ProviderResponse } from "../providers/ir.js";
+export interface RouteAttempt {
+    providerName: string;
+    model: string;
+    ok: boolean;
+    errorKind?: string;
+}
+export interface RoutedResponse {
+    response: ProviderResponse;
+    providerName: string;
+    model: string;
+    attempts: RouteAttempt[];
+}
+export declare function routeProviderRequest(input: {
+    config: MagiConfig;
+    registry: ProviderRegistry;
+    alias: string;
+    messages: MagiMessage[];
+    tools?: MagiToolDefinition[];
+    temperature?: number;
+    maxOutputTokens?: number;
+    signal?: AbortSignal;
+}): Promise<RoutedResponse>;
+export declare function hasProviderRoute(config: MagiConfig, alias: string): boolean;

package/dist/routing/router.js

@@ -0,0 +1,63 @@
+import { MagiConfigError } from "../errors.js";
+import { ProviderError } from "../providers/errors.js";
+import { resolveFallbackChain } from "./model-alias.js";
+export async function routeProviderRequest(input) {
+    const candidates = resolveFallbackChain(input.config, input.alias);
+    const attempts = [];
+    let lastError;
+    for (const candidate of candidates) {
+        const adapter = input.registry.get(candidate.providerName);
+        if (!adapter) {
+            throw new MagiConfigError(`Provider ${candidate.providerName} is not configured`);
+        }
+        try {
+            const response = await adapter.complete(toProviderRequest(candidate, input.messages, input));
+            attempts.push({ providerName: candidate.providerName, model: candidate.model, ok: true });
+            return {
+                response,
+                providerName: candidate.providerName,
+                model: candidate.model,
+                attempts
+            };
+        }
+        catch (error) {
+            lastError = error;
+            if (error instanceof ProviderError) {
+                attempts.push({
+                    providerName: candidate.providerName,
+                    model: candidate.model,
+                    ok: false,
+                    errorKind: error.kind
+                });
+                if (error.retryable) {
+                    continue;
+                }
+            }
+            throw error;
+        }
+    }
+    if (lastError) {
+        throw lastError;
+    }
+    throw new MagiConfigError(`No route candidates available for ${input.alias}`);
+}
+export function hasProviderRoute(config, alias) {
+    try {
+        const [primary] = resolveFallbackChain(config, alias);
+        return config.providers[primary.providerName] !== undefined;
+    }
+    catch {
+        return false;
+    }
+}
+function toProviderRequest(candidate, messages, input) {
+    return {
+        model: candidate.model,
+        messages,
+        tools: input.tools,
+        temperature: input.temperature,
+        maxOutputTokens: input.maxOutputTokens,
+        signal: input.signal
+    };
+}
+//# sourceMappingURL=router.js.map

package/dist/routing/router.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"router.js","sourceRoot":"","sources":["../../src/routing/router.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAGvD,OAAO,EAAiB,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAgBvE,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,KAS1C;IACC,MAAM,UAAU,GAAG,oBAAoB,CAAC,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC;IACnE,MAAM,QAAQ,GAAmB,EAAE,CAAC;IACpC,IAAI,SAAkB,CAAC;IAEvB,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;QACnC,MAAM,OAAO,GAAG,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,YAAY,CAAC,CAAC;QAC3D,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,MAAM,IAAI,eAAe,CAAC,YAAY,SAAS,CAAC,YAAY,oBAAoB,CAAC,CAAC;QACpF,CAAC;QAED,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAC,SAAS,EAAE,KAAK,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC,CAAC;YAC7F,QAAQ,CAAC,IAAI,CAAC,EAAE,YAAY,EAAE,SAAS,CAAC,YAAY,EAAE,KAAK,EAAE,SAAS,CAAC,KAAK,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;YAC1F,OAAO;gBACL,QAAQ;gBACR,YAAY,EAAE,SAAS,CAAC,YAAY;gBACpC,KAAK,EAAE,SAAS,CAAC,KAAK;gBACtB,QAAQ;aACT,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,SAAS,GAAG,KAAK,CAAC;YAClB,IAAI,KAAK,YAAY,aAAa,EAAE,CAAC;gBACnC,QAAQ,CAAC,IAAI,CAAC;oBACZ,YAAY,EAAE,SAAS,CAAC,YAAY;oBACpC,KAAK,EAAE,SAAS,CAAC,KAAK;oBACtB,EAAE,EAAE,KAAK;oBACT,SAAS,EAAE,KAAK,CAAC,IAAI;iBACtB,CAAC,CAAC;gBACH,IAAI,KAAK,CAAC,SAAS,EAAE,CAAC;oBACpB,SAAS;gBACX,CAAC;YACH,CAAC;YACD,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;IAED,IAAI,SAAS,EAAE,CAAC;QACd,MAAM,SAAS,CAAC;IAClB,CAAC;IACD,MAAM,IAAI,eAAe,CAAC,qCAAqC,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC;AAChF,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,MAAkB,EAAE,KAAa;IAChE,IAAI,CAAC;QACH,MAAM,CAAC,OAAO,CAAC,GAAG,oBAAoB,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;QACtD,OAAO,MAAM,CAAC,SAAS,CAAC,OAAO,CAAC,YAAY,CAAC,KAAK,SAAS,CAAC;IAC9D,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,SAAS,iBAAiB,CACxB,SAAwB,EACxB,QAAuB,EACvB,KAA6G;IAE7G,OAAO;QACL,KAAK,EAAE,SAAS,CAAC,KAAK;QACtB,QAAQ;QACR,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,WAAW,EAAE,KAAK,CAAC,WAAW;QAC9B,eAAe,EAAE,KAAK,CAAC,eAAe;QACtC,MAAM,EAAE,KAAK,CAAC,MAAM;KACrB,CAAC;AACJ,CAAC"}

package/dist/rules/agents-loader.d.ts

@@ -0,0 +1,12 @@
+export interface AgentInstructionFile {
+    path: string;
+    directory: string;
+    content: string;
+}
+export declare function loadAgentInstructions(cwd: string, stopAt?: string): AgentInstructionFile[];
+export declare function formatAgentInstructions(files: AgentInstructionFile[]): string;
+export declare function loadAgentInstructionsWithHooks(input: {
+    cwd: string;
+    hooks?: import("../config.js").HookDefinition[];
+    sessionId?: string;
+}): Promise<AgentInstructionFile[]>;

package/dist/rules/agents-loader.js

@@ -0,0 +1,61 @@
+import { existsSync, readFileSync } from "node:fs";
+import path from "node:path";
+export function loadAgentInstructions(cwd, stopAt = path.parse(cwd).root) {
+    const dirs = directoriesFromRoot(cwd, stopAt);
+    const files = [];
+    for (const dir of dirs) {
+        const file = path.join(dir, "AGENTS.md");
+        if (existsSync(file)) {
+            files.push({
+                path: file,
+                directory: dir,
+                content: readFileSync(file, "utf8")
+            });
+        }
+    }
+    return files;
+}
+export function formatAgentInstructions(files) {
+    if (files.length === 0) {
+        return "No AGENTS.md instructions found\n";
+    }
+    return `${files.map((file) => [
+        `# ${file.path}`,
+        file.content.trimEnd()
+    ].join("\n")).join("\n\n")}\n`;
+}
+function directoriesFromRoot(cwd, stopAt) {
+    const absoluteCwd = path.resolve(cwd);
+    const absoluteStop = path.resolve(stopAt);
+    const dirs = [];
+    let current = absoluteCwd;
+    while (true) {
+        dirs.unshift(current);
+        if (current === absoluteStop || current === path.dirname(current)) {
+            break;
+        }
+        current = path.dirname(current);
+    }
+    if (absoluteStop === path.parse(absoluteStop).root) {
+        return dirs;
+    }
+    return dirs.filter((dir) => dir === absoluteStop || dir.startsWith(`${absoluteStop}${path.sep}`));
+}
+export async function loadAgentInstructionsWithHooks(input) {
+    const files = loadAgentInstructions(input.cwd);
+    if (input.hooks && files.length > 0) {
+        const { triggerHook } = await import("../hooks/trigger.js");
+        void triggerHook({
+            event: "instructions_loaded",
+            hooks: input.hooks,
+            context: {
+                sessionId: input.sessionId,
+                cwd: input.cwd,
+                filePath: files.map(f => f.path).join(", "),
+                action: "load"
+            }
+        });
+    }
+    return files;
+}
+//# sourceMappingURL=agents-loader.js.map

package/dist/rules/agents-loader.js.map

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

package/dist/runner/client.d.ts

@@ -0,0 +1,67 @@
+export interface RunnerCommand {
+    command: string;
+    args: string[];
+}
+export interface RunnerInitializeResult {
+    runner: string;
+    version: string;
+    capabilities: string[];
+}
+export interface RunnerPingResult {
+    ok: boolean;
+}
+export interface RunnerProcessResult {
+    command: string;
+    cwd: string;
+    exitCode: number | null;
+    stdout: string;
+    stderr: string;
+    timedOut: boolean;
+}
+export interface RunnerPtySmokeResult {
+    ok: boolean;
+    stdout: string;
+    stderr: string;
+}
+export interface RunnerAuditEvent {
+    action: string;
+    target?: string;
+    metadata?: Record<string, unknown>;
+}
+export interface RunnerApplyPatchResult {
+    path: string;
+    diff: string;
+    approved: boolean;
+    auditEvent: RunnerAuditEvent;
+}
+export declare class RunnerClient {
+    private readonly input;
+    private readonly child;
+    private readonly lines;
+    private nextId;
+    private readonly pending;
+    constructor(input: {
+        command: RunnerCommand;
+        env?: NodeJS.ProcessEnv;
+    });
+    initialize(): Promise<RunnerInitializeResult>;
+    ping(): Promise<RunnerPingResult>;
+    echo(text: string): Promise<string>;
+    runProcess(input: {
+        command: string;
+        cwd: string;
+        timeoutMs?: number;
+    }): Promise<RunnerProcessResult>;
+    ptySmoke(): Promise<RunnerPtySmokeResult>;
+    applyPatch(input: {
+        cwd: string;
+        filePath: string;
+        content: string;
+        approved: boolean;
+    }): Promise<RunnerApplyPatchResult>;
+    close(): void;
+    private request;
+    private handleLine;
+    private rejectAll;
+}
+export declare function resolveRunnerCommand(env?: NodeJS.ProcessEnv): RunnerCommand;