@a5c-ai/genty-platform 5.1.1-staging.00ceebd28cf2

package/dist/harness/invoker/processControl.js

@@ -0,0 +1,50 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.trackChild = trackChild;
+exports.untrackChild = untrackChild;
+exports.cancelRunningProcess = cancelRunningProcess;
+const activeChildren = new Map();
+function trackChild(child) {
+    if (child.pid != null) {
+        activeChildren.set(child.pid, child);
+    }
+}
+function untrackChild(pid) {
+    if (pid != null) {
+        activeChildren.delete(pid);
+    }
+}
+function cancelRunningProcess(pid, options) {
+    const gracePeriodMs = options?.gracePeriodMs ?? 5000;
+    const child = activeChildren.get(pid);
+    if (!child) {
+        try {
+            process.kill(pid, "SIGTERM");
+        }
+        catch {
+            return Promise.resolve(false);
+        }
+        setTimeout(() => {
+            try {
+                process.kill(pid, "SIGKILL");
+            }
+            catch {
+                // Process already exited.
+            }
+        }, gracePeriodMs);
+        return Promise.resolve(true);
+    }
+    const result = child.kill("SIGTERM");
+    if (!result) {
+        return Promise.resolve(false);
+    }
+    setTimeout(() => {
+        try {
+            child.kill("SIGKILL");
+        }
+        catch {
+            // Process already exited.
+        }
+    }, gracePeriodMs);
+    return Promise.resolve(true);
+}

package/dist/harness/invoker.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Harness invoker module.
+ *
+ * External harnesses are routed through adapters exclusively.
+ * Pi uses direct CLI subprocess invocation. The "agent-core" programmatic
+ * harness routes through agent-platform create-run orchestration so the full
+ * internal tool stack is available.
+ */
+import type { HarnessInvokeOptions, HarnessInvokeResult } from "./types";
+import { buildLaunchSpec, type HarnessCliSpec } from "./invoker/launch";
+import { cancelRunningProcess } from "./invoker/processControl";
+/**
+ * Mapping from harness identifier to CLI command and flag details.
+ *
+ * Only Pi retains a direct CLI mapping. All other (external) harnesses are
+ * routed through adapters adapters via {@link invokeViaAgentMux}.
+ */
+export declare const HARNESS_CLI_MAP: Readonly<Record<string, HarnessCliSpec>>;
+export { buildLaunchSpec, cancelRunningProcess };
+/**
+ * Builds CLI argument array for a given harness and invocation options.
+ *
+ * This is a pure function with no side-effects, suitable for unit testing the
+ * flag mapping logic in isolation. Only used for harnesses in
+ * {@link HARNESS_CLI_MAP} (currently Pi).
+ *
+ * @throws {BabysitterRuntimeError} if `name` is not a known harness.
+ */
+export declare function buildHarnessArgs(name: string, options: HarnessInvokeOptions): string[];
+/**
+ * Invokes a harness CLI and returns the result.
+ *
+ * The function first attempts to route through adapters (if @adapters/core
+ * is installed and the harness has an adapters adapter mapping). When adapters
+ * is unavailable, it falls back to direct child-process invocation.
+ *
+ * Pi uses direct invocation and agent-core uses create-run orchestration;
+ * neither is routed through adapters.
+ *
+ * @throws {BabysitterRuntimeError} if the harness is unknown or the CLI is
+ *   not installed.
+ */
+export declare function invokeHarness(name: string, options: HarnessInvokeOptions): Promise<HarnessInvokeResult>;
+//# sourceMappingURL=invoker.d.ts.map

package/dist/harness/invoker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"invoker.d.ts","sourceRoot":"","sources":["../../src/harness/invoker.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAQH,OAAO,KAAK,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AACzE,OAAO,EACL,eAAe,EACf,KAAK,cAAc,EACpB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,oBAAoB,EAGrB,MAAM,0BAA0B,CAAC;AAUlC;;;;;GAKG;AACH,eAAO,MAAM,eAAe,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAE3D,CAAC;AAOX,OAAO,EAAE,eAAe,EAAE,oBAAoB,EAAE,CAAC;AAMjD;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,oBAAoB,GAC5B,MAAM,EAAE,CA+BV;AASD;;;;;;;;;;;;GAYG;AACH,wBAAsB,aAAa,CACjC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,mBAAmB,CAAC,CAkB9B"}

package/dist/harness/invoker.js

@@ -0,0 +1,341 @@
+"use strict";
+/**
+ * Harness invoker module.
+ *
+ * External harnesses are routed through adapters exclusively.
+ * Pi uses direct CLI subprocess invocation. The "agent-core" programmatic
+ * harness routes through agent-platform create-run orchestration so the full
+ * internal tool stack is available.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.cancelRunningProcess = exports.buildLaunchSpec = exports.HARNESS_CLI_MAP = void 0;
+exports.buildHarnessArgs = buildHarnessArgs;
+exports.invokeHarness = invokeHarness;
+const node_child_process_1 = require("node:child_process");
+const babysitter_sdk_1 = require("@a5c-ai/babysitter-sdk");
+const launch_1 = require("./invoker/launch");
+Object.defineProperty(exports, "buildLaunchSpec", { enumerable: true, get: function () { return launch_1.buildLaunchSpec; } });
+const processControl_1 = require("./invoker/processControl");
+Object.defineProperty(exports, "cancelRunningProcess", { enumerable: true, get: function () { return processControl_1.cancelRunningProcess; } });
+const adapterClientFactory_1 = require("./adapters/adapterClientFactory");
+const adapterHarnessMap_1 = require("./adapters/adapterHarnessMap");
+const adapterBridge_1 = require("./adapters/adapterBridge");
+const builtInHarness_1 = require("./builtInHarness");
+// ---------------------------------------------------------------------------
+// CLI mapping — Pi only (external harnesses use adapters adapters)
+// ---------------------------------------------------------------------------
+/**
+ * Mapping from harness identifier to CLI command and flag details.
+ *
+ * Only Pi retains a direct CLI mapping. All other (external) harnesses are
+ * routed through adapters adapters via {@link invokeViaAgentMux}.
+ */
+exports.HARNESS_CLI_MAP = {
+    pi: { cli: "pi", workspaceFlag: "--workspace", supportsModel: true, promptStyle: "flag" },
+};
+const PROGRAMMATIC_ONLY_HARNESSES = ["agent-core"];
+const SUPPORTED_HARNESS_NAMES = [
+    ...PROGRAMMATIC_ONLY_HARNESSES,
+    ...Object.keys(exports.HARNESS_CLI_MAP),
+];
+// ---------------------------------------------------------------------------
+// Arg builder (pure function) — Pi / direct-invoke path only
+// ---------------------------------------------------------------------------
+/**
+ * Builds CLI argument array for a given harness and invocation options.
+ *
+ * This is a pure function with no side-effects, suitable for unit testing the
+ * flag mapping logic in isolation. Only used for harnesses in
+ * {@link HARNESS_CLI_MAP} (currently Pi).
+ *
+ * @throws {BabysitterRuntimeError} if `name` is not a known harness.
+ */
+function buildHarnessArgs(name, options) {
+    const spec = exports.HARNESS_CLI_MAP[name];
+    if (!spec) {
+        throw new babysitter_sdk_1.BabysitterRuntimeError("UnknownHarnessError", `Unknown harness: "${name}". Supported harnesses: ${SUPPORTED_HARNESS_NAMES.join(", ")}`, {
+            category: babysitter_sdk_1.ErrorCategory.Validation,
+            suggestions: [`Did you mean one of: ${SUPPORTED_HARNESS_NAMES.join(", ")}?`],
+            nextSteps: ["Use a supported harness name"],
+        });
+    }
+    const args = [...(spec.baseArgs ?? [])];
+    if ((spec.promptStyle ?? "flag") === "positional") {
+        args.push(options.prompt);
+    }
+    else {
+        args.push("--prompt", options.prompt);
+    }
+    if (options.model && spec.supportsModel) {
+        args.push("--model", options.model);
+    }
+    if (options.workspace && spec.workspaceFlag) {
+        args.push(spec.workspaceFlag, options.workspace);
+    }
+    return args;
+}
+// ---------------------------------------------------------------------------
+// Invoker
+// ---------------------------------------------------------------------------
+/** Default timeout for harness invocations (15 minutes). */
+const DEFAULT_TIMEOUT_MS = 900_000;
+/**
+ * Invokes a harness CLI and returns the result.
+ *
+ * The function first attempts to route through adapters (if @adapters/core
+ * is installed and the harness has an adapters adapter mapping). When adapters
+ * is unavailable, it falls back to direct child-process invocation.
+ *
+ * Pi uses direct invocation and agent-core uses create-run orchestration;
+ * neither is routed through adapters.
+ *
+ * @throws {BabysitterRuntimeError} if the harness is unknown or the CLI is
+ *   not installed.
+ */
+async function invokeHarness(name, options) {
+    const harnessName = (0, builtInHarness_1.normalizeBuiltInHarnessName)(name);
+    // Pi remains a direct subprocess; agent-core routes through internal orchestration.
+    if (harnessName === "pi" || harnessName === "agent-core") {
+        return invokeHarnessDirect(harnessName, options);
+    }
+    // External harnesses go through adapters
+    if (!(0, adapterHarnessMap_1.hasAmuxAdapter)(harnessName)) {
+        throw new babysitter_sdk_1.BabysitterRuntimeError("UnknownHarnessError", `No adapters adapter for harness "${name}". External harnesses must have an adapters mapping.`, { category: babysitter_sdk_1.ErrorCategory.Configuration });
+    }
+    const agentMuxClient = await (0, adapterClientFactory_1.getAgentMuxClient)();
+    return (0, adapterBridge_1.invokeViaAgentMux)(agentMuxClient, harnessName, options);
+}
+/**
+ * Direct invocation for Pi plus the internal agent-core orchestration path.
+ *
+ * Pi uses CLI subprocess via `child_process.execFile`. "agent-core" delegates
+ * to create-run orchestration rather than a bare session. External harnesses
+ * should never reach this function -- they are routed through adapters in
+ * {@link invokeHarness}.
+ *
+ * @throws {BabysitterRuntimeError} if the harness is unknown or the CLI is
+ *   not installed.
+ */
+async function invokeHarnessDirect(name, options) {
+    if (name === "agent-core") {
+        return invokeAgentCoreThroughOrchestration(options);
+    }
+    const spec = exports.HARNESS_CLI_MAP[name];
+    if (!spec) {
+        throw new babysitter_sdk_1.BabysitterRuntimeError("UnknownHarnessError", `Unknown harness: "${name}". Supported harnesses: ${SUPPORTED_HARNESS_NAMES.join(", ")}`, {
+            category: babysitter_sdk_1.ErrorCategory.Validation,
+            suggestions: [`Did you mean one of: ${SUPPORTED_HARNESS_NAMES.join(", ")}?`],
+            nextSteps: ["Use a supported harness name"],
+        });
+    }
+    // Verify CLI availability.
+    const cliCheck = await (0, babysitter_sdk_1.checkCliAvailable)(spec.cli);
+    if (!cliCheck.available) {
+        throw new babysitter_sdk_1.BabysitterRuntimeError("HarnessCliNotInstalledError", `Harness CLI "${spec.cli}" is not installed or not found on PATH`, {
+            category: babysitter_sdk_1.ErrorCategory.External,
+            nextSteps: [
+                `Install the "${spec.cli}" CLI and ensure it is on your PATH`,
+                `Verify installation by running: ${spec.cli} --version`,
+            ],
+        });
+    }
+    const args = buildHarnessArgs(name, options);
+    const timeoutMs = options.timeout ?? DEFAULT_TIMEOUT_MS;
+    const launch = (0, launch_1.buildLaunchSpec)(name, spec, cliCheck.path, args);
+    const startTime = Date.now();
+    const streaming = options.streaming;
+    return new Promise((resolve, reject) => {
+        let childEnv;
+        if (options.isolated) {
+            const minimal = {};
+            for (const key of ['PATH', 'HOME', 'NODE_PATH', 'SYSTEMROOT', 'COMSPEC']) {
+                if (process.env[key])
+                    minimal[key] = process.env[key];
+            }
+            childEnv = options.env ? { ...minimal, ...options.env } : minimal;
+        }
+        else {
+            childEnv = options.env ? { ...process.env, ...options.env } : process.env;
+        }
+        let trackedPid;
+        try {
+            const child = (0, node_child_process_1.spawn)(launch.command, launch.args, {
+                cwd: options.workspace,
+                windowsHide: true,
+                env: childEnv,
+                shell: launch.shell,
+                stdio: ["pipe", "pipe", "pipe"],
+            });
+            trackedPid = child.pid;
+            (0, processControl_1.trackChild)(child);
+            let stdoutBuf = "";
+            let stderrBuf = "";
+            let streamChunkCount = 0;
+            let stdoutLineBuf = "";
+            let stderrLineBuf = "";
+            child.stdout?.on("data", (chunk) => {
+                const text = chunk.toString("utf8");
+                stdoutBuf += text;
+                streamChunkCount++;
+                streaming?.onStdout?.(text);
+                if (streaming?.onLine) {
+                    stdoutLineBuf += text;
+                    const lines = stdoutLineBuf.split("\n");
+                    stdoutLineBuf = lines.pop() ?? "";
+                    for (const line of lines)
+                        streaming.onLine(line, "stdout");
+                }
+            });
+            child.stderr?.on("data", (chunk) => {
+                const text = chunk.toString("utf8");
+                stderrBuf += text;
+                streamChunkCount++;
+                streaming?.onStderr?.(text);
+                if (streaming?.onLine) {
+                    stderrLineBuf += text;
+                    const lines = stderrLineBuf.split("\n");
+                    stderrLineBuf = lines.pop() ?? "";
+                    for (const line of lines)
+                        streaming.onLine(line, "stderr");
+                }
+            });
+            const timer = setTimeout(() => {
+                child.kill("SIGTERM");
+            }, timeoutMs);
+            if (options.signal) {
+                options.signal.addEventListener("abort", () => {
+                    child.kill("SIGTERM");
+                }, { once: true });
+            }
+            child.on("close", (code, signal) => {
+                clearTimeout(timer);
+                (0, processControl_1.untrackChild)(trackedPid);
+                const duration = Date.now() - startTime;
+                // Flush remaining line buffers
+                if (streaming?.onLine) {
+                    if (stdoutLineBuf)
+                        streaming.onLine(stdoutLineBuf, "stdout");
+                    if (stderrLineBuf)
+                        streaming.onLine(stderrLineBuf, "stderr");
+                }
+                const output = stderrBuf.length > 0
+                    ? `${stdoutBuf}\n${stderrBuf}`.trim()
+                    : stdoutBuf.trim();
+                const killed = signal === "SIGTERM";
+                const exitCode = code ?? 1;
+                resolve({
+                    success: exitCode === 0,
+                    output: killed
+                        ? `Process timed out after ${timeoutMs}ms\n${output}`.trim()
+                        : output,
+                    exitCode,
+                    duration,
+                    harness: name,
+                    streamed: streamChunkCount > 0,
+                    streamChunkCount,
+                });
+            });
+            child.on("error", (err) => {
+                clearTimeout(timer);
+                (0, processControl_1.untrackChild)(trackedPid);
+                reject(new babysitter_sdk_1.BabysitterRuntimeError("HarnessSpawnError", `Failed to spawn ${spec.cli}: ${err.message}`, { category: babysitter_sdk_1.ErrorCategory.External }));
+            });
+        }
+        catch (err) {
+            reject(new babysitter_sdk_1.BabysitterRuntimeError("HarnessSpawnError", `Failed to spawn ${spec.cli}: ${err instanceof Error ? err.message : String(err)}`, { category: babysitter_sdk_1.ErrorCategory.External }));
+        }
+    });
+}
+async function invokeAgentCoreThroughOrchestration(options) {
+    const startTime = Date.now();
+    const streaming = options.streaming;
+    const { handleHarnessCreateRun } = await Promise.resolve().then(() => __importStar(require("./internal/createRun")));
+    let streamChunkCount = 0;
+    const { result: exitCode, output } = await captureProcessOutput(() => handleHarnessCreateRun({
+        invocationCommand: "invoke",
+        prompt: options.prompt,
+        harness: "agent-core",
+        workspace: options.workspace,
+        model: options.model,
+        json: false,
+        verbose: false,
+        interactive: false,
+    }), streaming ? (chunk, source) => {
+        streamChunkCount++;
+        if (source === "stdout")
+            streaming.onStdout?.(chunk);
+        else
+            streaming.onStderr?.(chunk);
+        streaming.onLine?.(chunk.trimEnd(), source);
+    } : undefined);
+    return {
+        success: exitCode === 0,
+        output: output.trim(),
+        exitCode,
+        duration: Date.now() - startTime,
+        harness: "agent-core",
+        streamed: streamChunkCount > 0,
+        streamChunkCount,
+    };
+}
+async function captureProcessOutput(run, onChunk) {
+    const originalStdoutWrite = process.stdout.write.bind(process.stdout);
+    const originalStderrWrite = process.stderr.write.bind(process.stderr);
+    let output = "";
+    const makeCaptureWrite = (source) => (chunk, encodingOrCallback, callback) => {
+        const text = Buffer.isBuffer(chunk)
+            ? chunk.toString(typeof encodingOrCallback === "string" ? encodingOrCallback : "utf8")
+            : String(chunk);
+        output += text;
+        onChunk?.(text, source);
+        if (typeof encodingOrCallback === "function") {
+            encodingOrCallback();
+        }
+        else if (typeof callback === "function") {
+            callback();
+        }
+        return true;
+    };
+    process.stdout.write = makeCaptureWrite("stdout");
+    process.stderr.write = makeCaptureWrite("stderr");
+    try {
+        return { result: await run(), output };
+    }
+    finally {
+        process.stdout.write = originalStdoutWrite;
+        process.stderr.write = originalStderrWrite;
+    }
+}

package/dist/harness/lspIntegration.d.ts

@@ -0,0 +1,48 @@
+/**
+ * GAP-TOOLS-012: LSP Integration for Code-Aware Routing.
+ *
+ * Provides types and utilities for resolving language-server symbols
+ * and injecting them as context into prompts for model routing.
+ */
+export interface LspServerConfig {
+    /** Language identifier (e.g. "typescript", "python"). */
+    languageId: string;
+    /** Command to spawn the LSP server. */
+    command: string;
+    /** Arguments passed to the command. */
+    args: string[];
+    /** Root URI of the workspace (file:// scheme). */
+    rootUri: string;
+}
+export type LspSymbolKind = 'function' | 'class' | 'variable' | 'type';
+export interface LspSymbolInfo {
+    /** Symbol name. */
+    name: string;
+    /** Symbol kind. */
+    kind: LspSymbolKind;
+    /** Source location. */
+    location: {
+        file: string;
+        line: number;
+        col: number;
+    };
+}
+export interface LspRouteHint {
+    /** The symbol this hint relates to. */
+    symbol: LspSymbolInfo;
+    /** Files that are relevant to this symbol. */
+    relevantFiles: string[];
+    /** Optional model suggestion for routing. */
+    suggestedModel?: string;
+}
+/**
+ * Match prompt keywords against known symbols.
+ * Returns symbols whose name appears as a word boundary match in the prompt.
+ */
+export declare function resolveSymbolsForPrompt(symbols: LspSymbolInfo[], prompt: string): LspSymbolInfo[];
+/**
+ * Render symbol information as a human-readable context block
+ * suitable for injection into a system or user prompt.
+ */
+export declare function formatSymbolContext(symbols: LspSymbolInfo[]): string;
+//# sourceMappingURL=lspIntegration.d.ts.map

package/dist/harness/lspIntegration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lspIntegration.d.ts","sourceRoot":"","sources":["../../src/harness/lspIntegration.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,MAAM,WAAW,eAAe;IAC9B,yDAAyD;IACzD,UAAU,EAAE,MAAM,CAAC;IACnB,uCAAuC;IACvC,OAAO,EAAE,MAAM,CAAC;IAChB,uCAAuC;IACvC,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,kDAAkD;IAClD,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,MAAM,aAAa,GAAG,UAAU,GAAG,OAAO,GAAG,UAAU,GAAG,MAAM,CAAC;AAEvE,MAAM,WAAW,aAAa;IAC5B,mBAAmB;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,mBAAmB;IACnB,IAAI,EAAE,aAAa,CAAC;IACpB,uBAAuB;IACvB,QAAQ,EAAE;QACR,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,GAAG,EAAE,MAAM,CAAC;KACb,CAAC;CACH;AAED,MAAM,WAAW,YAAY;IAC3B,uCAAuC;IACvC,MAAM,EAAE,aAAa,CAAC;IACtB,8CAA8C;IAC9C,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,6CAA6C;IAC7C,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAMD;;;GAGG;AACH,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,aAAa,EAAE,EACxB,MAAM,EAAE,MAAM,GACb,aAAa,EAAE,CAOjB;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,aAAa,EAAE,GAAG,MAAM,CASpE"}

package/dist/harness/lspIntegration.js

@@ -0,0 +1,45 @@
+"use strict";
+/**
+ * GAP-TOOLS-012: LSP Integration for Code-Aware Routing.
+ *
+ * Provides types and utilities for resolving language-server symbols
+ * and injecting them as context into prompts for model routing.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveSymbolsForPrompt = resolveSymbolsForPrompt;
+exports.formatSymbolContext = formatSymbolContext;
+// ---------------------------------------------------------------------------
+// Functions
+// ---------------------------------------------------------------------------
+/**
+ * Match prompt keywords against known symbols.
+ * Returns symbols whose name appears as a word boundary match in the prompt.
+ */
+function resolveSymbolsForPrompt(symbols, prompt) {
+    if (!prompt.trim())
+        return [];
+    const lowerPrompt = prompt.toLowerCase();
+    return symbols.filter((sym) => {
+        const pattern = new RegExp(`\\b${escapeRegExp(sym.name)}\\b`, 'i');
+        return pattern.test(lowerPrompt);
+    });
+}
+/**
+ * Render symbol information as a human-readable context block
+ * suitable for injection into a system or user prompt.
+ */
+function formatSymbolContext(symbols) {
+    if (symbols.length === 0)
+        return '';
+    const lines = symbols.map((sym) => {
+        const loc = `${sym.location.file}:${sym.location.line}:${sym.location.col}`;
+        return `- ${sym.kind} \`${sym.name}\` at ${loc}`;
+    });
+    return `## Relevant Symbols\n\n${lines.join('\n')}`;
+}
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+function escapeRegExp(str) {
+    return str.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+}

package/dist/harness/modeSelector.d.ts

@@ -0,0 +1,50 @@
+/**
+ * GAP-UX-014: Operator Mode Selection
+ *
+ * In-session mode switching between orchestration modes without
+ * restarting the run. Affects prompt personality, breakpoint
+ * frequency, and parallelism configuration.
+ */
+/** Available orchestration modes. */
+export type OrchestrationMode = "interactive" | "autonomous" | "plan" | "fast";
+/** Mode configuration that affects runtime behavior. */
+export interface ModeConfig {
+    /** Mode identifier. */
+    mode: OrchestrationMode;
+    /** Human-readable label. */
+    label: string;
+    /** Description of this mode's behavior. */
+    description: string;
+    /** Whether breakpoints require human approval. */
+    breakpointApproval: "always" | "auto" | "never";
+    /** Whether to show plan before execution. */
+    showPlan: boolean;
+    /** Whether to parallelize independent effects. */
+    parallelism: boolean;
+    /** Output verbosity level. */
+    verbosity: "minimal" | "normal" | "verbose";
+}
+/** Get the current active mode. */
+export declare function getActiveMode(): OrchestrationMode;
+/** Get the configuration for the active mode. */
+export declare function getActiveModeConfig(): ModeConfig;
+/** Switch to a different orchestration mode. Returns the new mode config. */
+export declare function switchMode(mode: OrchestrationMode): ModeConfig;
+/** Get the configuration for a specific mode. */
+export declare function getModeConfig(mode: OrchestrationMode): ModeConfig;
+/** Get all available modes. */
+export declare function getAvailableModes(): ModeConfig[];
+/** Reset mode to default (interactive). Exported for test isolation. */
+export declare function resetMode(): void;
+/**
+ * Check if the current mode skips interactive breakpoint prompts.
+ * Returns true for "auto" (auto-approve based on rules) but NOT for "always" (always prompt).
+ */
+export declare function shouldAutoApprove(): boolean;
+/** Check if the current mode wants to show plans before execution. */
+export declare function shouldShowPlan(): boolean;
+/** Check if parallel execution is enabled in the current mode. */
+export declare function isParallelEnabled(): boolean;
+/** Format mode information for display. */
+export declare function formatModeInfo(mode?: OrchestrationMode): string;
+//# sourceMappingURL=modeSelector.d.ts.map

package/dist/harness/modeSelector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"modeSelector.d.ts","sourceRoot":"","sources":["../../src/harness/modeSelector.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAMH,qCAAqC;AACrC,MAAM,MAAM,iBAAiB,GAAG,aAAa,GAAG,YAAY,GAAG,MAAM,GAAG,MAAM,CAAC;AAE/E,wDAAwD;AACxD,MAAM,WAAW,UAAU;IACzB,uBAAuB;IACvB,IAAI,EAAE,iBAAiB,CAAC;IACxB,4BAA4B;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,2CAA2C;IAC3C,WAAW,EAAE,MAAM,CAAC;IACpB,kDAAkD;IAClD,kBAAkB,EAAE,QAAQ,GAAG,MAAM,GAAG,OAAO,CAAC;IAChD,6CAA6C;IAC7C,QAAQ,EAAE,OAAO,CAAC;IAClB,kDAAkD;IAClD,WAAW,EAAE,OAAO,CAAC;IACrB,8BAA8B;IAC9B,SAAS,EAAE,SAAS,GAAG,QAAQ,GAAG,SAAS,CAAC;CAC7C;AA2DD,mCAAmC;AACnC,wBAAgB,aAAa,IAAI,iBAAiB,CAEjD;AAED,iDAAiD;AACjD,wBAAgB,mBAAmB,IAAI,UAAU,CAEhD;AAED,6EAA6E;AAC7E,wBAAgB,UAAU,CAAC,IAAI,EAAE,iBAAiB,GAAG,UAAU,CAG9D;AAED,iDAAiD;AACjD,wBAAgB,aAAa,CAAC,IAAI,EAAE,iBAAiB,GAAG,UAAU,CAEjE;AAED,+BAA+B;AAC/B,wBAAgB,iBAAiB,IAAI,UAAU,EAAE,CAEhD;AAED,wEAAwE;AACxE,wBAAgB,SAAS,IAAI,IAAI,CAEhC;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,IAAI,OAAO,CAE3C;AAED,sEAAsE;AACtE,wBAAgB,cAAc,IAAI,OAAO,CAExC;AAED,kEAAkE;AAClE,wBAAgB,iBAAiB,IAAI,OAAO,CAE3C;AAED,2CAA2C;AAC3C,wBAAgB,cAAc,CAAC,IAAI,CAAC,EAAE,iBAAiB,GAAG,MAAM,CAU/D"}