@a5c-ai/agent-platform 5.0.1-staging.b436b3b3e611

package/dist/harness/invoker.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Harness invoker module.
+ *
+ * External harnesses are routed through agent-mux exclusively.
+ * Only Pi and the "agent-core" programmatic harness use direct invocation
+ * (Pi via CLI subprocess, agent-core in-process).
+ */
+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 agent-mux 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 agent-mux (if @agent-mux/core
+ * is installed and the harness has an amux adapter mapping). When agent-mux
+ * is unavailable, it falls back to direct child-process invocation.
+ *
+ * Pi / agent-core harnesses always use agent-core directly and are never
+ * routed through agent-mux.
+ *
+ * @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;;;;;;GAMG;AAQH,OAAO,KAAK,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAEzE,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,210 @@
+"use strict";
+/**
+ * Harness invoker module.
+ *
+ * External harnesses are routed through agent-mux exclusively.
+ * Only Pi and the "agent-core" programmatic harness use direct invocation
+ * (Pi via CLI subprocess, agent-core in-process).
+ */
+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 agent_core_1 = require("@a5c-ai/agent-core");
+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 amuxClientFactory_1 = require("./amux/amuxClientFactory");
+const amuxHarnessMap_1 = require("./amux/amuxHarnessMap");
+const amuxBridge_1 = require("./amux/amuxBridge");
+const builtInHarness_1 = require("./builtInHarness");
+// ---------------------------------------------------------------------------
+// CLI mapping — Pi only (external harnesses use agent-mux 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 agent-mux 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 agent-mux (if @agent-mux/core
+ * is installed and the harness has an amux adapter mapping). When agent-mux
+ * is unavailable, it falls back to direct child-process invocation.
+ *
+ * Pi / agent-core harnesses always use agent-core directly and are never
+ * routed through agent-mux.
+ *
+ * @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 / agent-core always use agent-core directly
+    if (harnessName === "pi" || harnessName === "agent-core") {
+        return invokeHarnessDirect(harnessName, options);
+    }
+    // External harnesses go through agent-mux
+    if (!(0, amuxHarnessMap_1.hasAmuxAdapter)(harnessName)) {
+        throw new babysitter_sdk_1.BabysitterRuntimeError("UnknownHarnessError", `No agent-mux adapter for harness "${name}". External harnesses must have an agent-mux mapping.`, { category: babysitter_sdk_1.ErrorCategory.Configuration });
+    }
+    const amuxClient = await (0, amuxClientFactory_1.getAmuxClient)();
+    return (0, amuxBridge_1.invokeViaAgentMux)(amuxClient, harnessName, options);
+}
+/**
+ * Direct child-process invocation for Pi and agent-core harnesses.
+ *
+ * "agent-core" uses agent-core (in-process). Pi uses CLI subprocess via
+ * `child_process.execFile`. External harnesses should never reach this
+ * function -- they are routed through agent-mux 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") {
+        const session = (0, agent_core_1.createAgentCoreSession)({
+            workspace: options.workspace,
+            model: options.model,
+            timeout: options.timeout,
+            ephemeral: true,
+        });
+        try {
+            const result = await session.prompt(options.prompt, options.timeout);
+            return {
+                ...result,
+                harness: "agent-core",
+            };
+        }
+        finally {
+            session.dispose();
+        }
+    }
+    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();
+    return new Promise((resolve, reject) => {
+        const childEnv = options.env
+            ? { ...process.env, ...options.env }
+            : process.env;
+        let trackedPid;
+        try {
+            const child = (0, node_child_process_1.execFile)(launch.command, launch.args, {
+                cwd: options.workspace,
+                timeout: timeoutMs,
+                windowsHide: true,
+                maxBuffer: 50 * 1024 * 1024, // 50 MiB
+                env: childEnv,
+                shell: launch.shell,
+            }, (error, stdout, stderr) => {
+                (0, processControl_1.untrackChild)(trackedPid);
+                const duration = Date.now() - startTime;
+                const stderrStr = String(stderr);
+                const output = stderrStr.length > 0
+                    ? `${String(stdout)}\n${stderrStr}`.trim()
+                    : String(stdout).trim();
+                if (error) {
+                    const execError = error;
+                    const killed = execError.killed === true;
+                    const exitCode = typeof execError.status === "number" ? execError.status : 1;
+                    resolve({
+                        success: false,
+                        output: killed
+                            ? `Process timed out after ${timeoutMs}ms\n${output}`.trim()
+                            : output,
+                        exitCode,
+                        duration,
+                        harness: name,
+                    });
+                    return;
+                }
+                resolve({
+                    success: true,
+                    output,
+                    exitCode: 0,
+                    duration,
+                    harness: name,
+                });
+            });
+            trackedPid = child.pid;
+            (0, processControl_1.trackChild)(child);
+        }
+        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 }));
+        }
+    });
+}

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"}

package/dist/harness/modeSelector.js

@@ -0,0 +1,124 @@
+"use strict";
+/**
+ * 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.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getActiveMode = getActiveMode;
+exports.getActiveModeConfig = getActiveModeConfig;
+exports.switchMode = switchMode;
+exports.getModeConfig = getModeConfig;
+exports.getAvailableModes = getAvailableModes;
+exports.resetMode = resetMode;
+exports.shouldAutoApprove = shouldAutoApprove;
+exports.shouldShowPlan = shouldShowPlan;
+exports.isParallelEnabled = isParallelEnabled;
+exports.formatModeInfo = formatModeInfo;
+// ---------------------------------------------------------------------------
+// Mode definitions
+// ---------------------------------------------------------------------------
+const MODE_CONFIGS = {
+    interactive: {
+        mode: "interactive",
+        label: "Interactive",
+        description: "Full human-in-the-loop. All breakpoints prompt for approval. Shows plan before execution.",
+        breakpointApproval: "always",
+        showPlan: true,
+        parallelism: false,
+        verbosity: "verbose",
+    },
+    autonomous: {
+        mode: "autonomous",
+        label: "Autonomous",
+        description: "Minimal human intervention. Auto-approves most breakpoints. Maximum parallelism.",
+        breakpointApproval: "auto",
+        showPlan: false,
+        parallelism: true,
+        verbosity: "minimal",
+    },
+    plan: {
+        mode: "plan",
+        label: "Plan Only",
+        description: "Generates and presents a plan, then stops. No execution until explicitly approved.",
+        breakpointApproval: "always",
+        showPlan: true,
+        parallelism: false,
+        verbosity: "normal",
+    },
+    fast: {
+        mode: "fast",
+        label: "Fast",
+        description: "Prioritizes speed. Auto-approves safe breakpoints. Parallel execution. Minimal output.",
+        breakpointApproval: "auto",
+        showPlan: false,
+        parallelism: true,
+        verbosity: "minimal",
+    },
+};
+// ---------------------------------------------------------------------------
+// Mode state
+// ---------------------------------------------------------------------------
+/**
+ * Active mode state — module-level mutable singleton for in-session switching.
+ *
+ * This is intentionally module-scoped rather than instance-based because the
+ * babysitter CLI runs as a single-session process. Not safe for concurrent
+ * multi-session use within a single process. Use {@link resetMode} for test
+ * isolation between test cases.
+ */
+let _activeMode = "interactive";
+/** Get the current active mode. */
+function getActiveMode() {
+    return _activeMode;
+}
+/** Get the configuration for the active mode. */
+function getActiveModeConfig() {
+    return MODE_CONFIGS[_activeMode];
+}
+/** Switch to a different orchestration mode. Returns the new mode config. */
+function switchMode(mode) {
+    _activeMode = mode;
+    return MODE_CONFIGS[mode];
+}
+/** Get the configuration for a specific mode. */
+function getModeConfig(mode) {
+    return MODE_CONFIGS[mode];
+}
+/** Get all available modes. */
+function getAvailableModes() {
+    return Object.values(MODE_CONFIGS);
+}
+/** Reset mode to default (interactive). Exported for test isolation. */
+function resetMode() {
+    _activeMode = "interactive";
+}
+/**
+ * Check if the current mode skips interactive breakpoint prompts.
+ * Returns true for "auto" (auto-approve based on rules) but NOT for "always" (always prompt).
+ */
+function shouldAutoApprove() {
+    return MODE_CONFIGS[_activeMode].breakpointApproval === "auto";
+}
+/** Check if the current mode wants to show plans before execution. */
+function shouldShowPlan() {
+    return MODE_CONFIGS[_activeMode].showPlan;
+}
+/** Check if parallel execution is enabled in the current mode. */
+function isParallelEnabled() {
+    return MODE_CONFIGS[_activeMode].parallelism;
+}
+/** Format mode information for display. */
+function formatModeInfo(mode) {
+    const config = mode ? MODE_CONFIGS[mode] : MODE_CONFIGS[_activeMode];
+    return [
+        `Mode: ${config.label} (${config.mode})`,
+        config.description,
+        `  Breakpoints: ${config.breakpointApproval}`,
+        `  Plan: ${config.showPlan ? "shown" : "hidden"}`,
+        `  Parallelism: ${config.parallelism ? "enabled" : "disabled"}`,
+        `  Verbosity: ${config.verbosity}`,
+    ].join("\n");
+}

package/dist/harness/modelSelection.d.ts

@@ -0,0 +1,37 @@
+/**
+ * GAP-HADAPT-002: Model Selection Per Task.
+ *
+ * Bridges task-level model preferences with harness capability routing.
+ * Uses selectHarness from capabilityRouter to find the best harness
+ * for a task's model requirement.
+ */
+import { type HarnessCandidate } from "./capabilityRouter";
+/** Minimal task definition shape for model selection. */
+export interface TaskDefInput {
+    kind?: string;
+    execution?: {
+        harness?: string;
+        model?: string;
+        permissions?: string[];
+        [key: string]: unknown;
+    };
+    [key: string]: unknown;
+}
+export interface ModelSelectionResult {
+    /** Name of the selected harness, or null if none available. */
+    selectedHarness: string | null;
+    /** Model that will be used (from task preference or harness default). */
+    selectedModel: string | undefined;
+    /** Whether a fallback harness was selected (model not matched exactly). */
+    fallback: boolean;
+    /** Human-readable reason for the selection. */
+    reason: string;
+}
+/**
+ * Resolve which harness and model to use for a given task definition.
+ *
+ * Delegates to selectHarness for scoring, then interprets the result
+ * to determine if the model was matched or a fallback was used.
+ */
+export declare function resolveModelForTask(taskDef: TaskDefInput, candidates: HarnessCandidate[]): ModelSelectionResult;
+//# sourceMappingURL=modelSelection.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"modelSelection.d.ts","sourceRoot":"","sources":["../../src/harness/modelSelection.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAGL,KAAK,gBAAgB,EACtB,MAAM,oBAAoB,CAAC;AAM5B,yDAAyD;AACzD,MAAM,WAAW,YAAY;IAC3B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE;QACV,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;QACvB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;KACxB,CAAC;IACF,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,oBAAoB;IACnC,+DAA+D;IAC/D,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,yEAAyE;IACzE,aAAa,EAAE,MAAM,GAAG,SAAS,CAAC;IAClC,2EAA2E;IAC3E,QAAQ,EAAE,OAAO,CAAC;IAClB,+CAA+C;IAC/C,MAAM,EAAE,MAAM,CAAC;CAChB;AAMD;;;;;GAKG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,YAAY,EACrB,UAAU,EAAE,gBAAgB,EAAE,GAC7B,oBAAoB,CAwDtB"}

package/dist/harness/modelSelection.js

@@ -0,0 +1,81 @@
+"use strict";
+/**
+ * GAP-HADAPT-002: Model Selection Per Task.
+ *
+ * Bridges task-level model preferences with harness capability routing.
+ * Uses selectHarness from capabilityRouter to find the best harness
+ * for a task's model requirement.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveModelForTask = resolveModelForTask;
+const capabilityRouter_1 = require("./capabilityRouter");
+// ---------------------------------------------------------------------------
+// Core
+// ---------------------------------------------------------------------------
+/**
+ * Resolve which harness and model to use for a given task definition.
+ *
+ * Delegates to selectHarness for scoring, then interprets the result
+ * to determine if the model was matched or a fallback was used.
+ */
+function resolveModelForTask(taskDef, candidates) {
+    if (candidates.length === 0) {
+        return {
+            selectedHarness: null,
+            selectedModel: undefined,
+            fallback: false,
+            reason: "No harness candidates available",
+        };
+    }
+    const requirements = (0, capabilityRouter_1.buildTaskRequirements)(taskDef);
+    const routingResult = (0, capabilityRouter_1.selectHarness)(requirements, candidates);
+    if (!routingResult) {
+        return {
+            selectedHarness: null,
+            selectedModel: undefined,
+            fallback: false,
+            reason: "No harness met minimum score threshold",
+        };
+    }
+    const preferredModel = requirements.preferredModel;
+    const selectedCandidate = routingResult.selected;
+    // Check if the selected harness actually has the preferred model
+    const hasExactModel = preferredModel
+        ? selectedCandidate?.supportedModels?.includes(preferredModel) ?? false
+        : false;
+    const hasFamilyMatch = preferredModel && !hasExactModel
+        ? selectedCandidate?.supportedModels?.some((m) => modelFamilyMatch(m, preferredModel)) ?? false
+        : false;
+    const modelMatched = hasExactModel || hasFamilyMatch;
+    const isFallback = typeof preferredModel === "string" && !modelMatched;
+    let reason;
+    if (!preferredModel) {
+        reason = `Selected ${routingResult.selected.name} (no model preference)`;
+    }
+    else if (hasExactModel) {
+        reason = `Selected ${routingResult.selected.name} — exact model match for ${preferredModel}`;
+    }
+    else if (hasFamilyMatch) {
+        reason = `Selected ${routingResult.selected.name} — model family match for ${preferredModel}`;
+    }
+    else {
+        reason = `Selected ${routingResult.selected.name} as fallback — preferred model ${preferredModel} not available`;
+    }
+    return {
+        selectedHarness: routingResult.selected.name,
+        selectedModel: preferredModel,
+        fallback: isFallback,
+        reason,
+    };
+}
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+/**
+ * Check if two model names share the same family (e.g., "claude-sonnet-4" and "claude-sonnet-4-latest").
+ */
+function modelFamilyMatch(available, preferred) {
+    const familyA = available.split("-").slice(0, -1).join("-");
+    const familyB = preferred.split("-").slice(0, -1).join("-");
+    return familyA.length > 0 && familyA === familyB;
+}

package/dist/harness/operatorCommands.d.ts

@@ -0,0 +1,38 @@
+/**
+ * GAP-USER-001: Operator Command Layer
+ *
+ * Surfaces key babysitter CLI commands as in-session actions during
+ * breakpoint interactions. Enables operators to inspect and manage
+ * orchestration without leaving the flow.
+ */
+export interface OperatorCommand {
+    /** Short command name for selection. */
+    name: string;
+    /** Human-readable label. */
+    label: string;
+    /** Brief description shown during breakpoint interaction. */
+    description: string;
+    /** The CLI command template. Placeholders: {{runDir}}, {{runId}}, {{effectId}}. */
+    commandTemplate: string;
+    /** Category for grouping in UI. */
+    category: OperatorCommandCategory;
+}
+export type OperatorCommandCategory = "inspect" | "manage" | "debug" | "tokens";
+export declare const OPERATOR_COMMANDS: OperatorCommand[];
+/** Render operator command template with run context. */
+export declare function renderOperatorCommand(template: string, context: {
+    runDir?: string;
+    runId?: string;
+    effectId?: string;
+}): string;
+/** Get operator commands filtered by category. */
+export declare function getCommandsByCategory(category: OperatorCommandCategory): OperatorCommand[];
+/** Get all categories with their commands. */
+export declare function getGroupedCommands(): Record<OperatorCommandCategory, OperatorCommand[]>;
+/** Format commands for display in a breakpoint prompt. */
+export declare function formatCommandsForPrompt(context: {
+    runDir?: string;
+    runId?: string;
+    effectId?: string;
+}): string;
+//# sourceMappingURL=operatorCommands.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"operatorCommands.d.ts","sourceRoot":"","sources":["../../src/harness/operatorCommands.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAMH,MAAM,WAAW,eAAe;IAC9B,wCAAwC;IACxC,IAAI,EAAE,MAAM,CAAC;IACb,4BAA4B;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,6DAA6D;IAC7D,WAAW,EAAE,MAAM,CAAC;IACpB,mFAAmF;IACnF,eAAe,EAAE,MAAM,CAAC;IACxB,mCAAmC;IACnC,QAAQ,EAAE,uBAAuB,CAAC;CACnC;AAED,MAAM,MAAM,uBAAuB,GAAG,SAAS,GAAG,QAAQ,GAAG,OAAO,GAAG,QAAQ,CAAC;AAMhF,eAAO,MAAM,iBAAiB,EAAE,eAAe,EAyD9C,CAAC;AAMF,yDAAyD;AACzD,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,GAC9D,MAAM,CAKR;AAED,kDAAkD;AAClD,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,uBAAuB,GAAG,eAAe,EAAE,CAE1F;AAED,8CAA8C;AAC9C,wBAAgB,kBAAkB,IAAI,MAAM,CAAC,uBAAuB,EAAE,eAAe,EAAE,CAAC,CAWvF;AAED,0DAA0D;AAC1D,wBAAgB,uBAAuB,CACrC,OAAO,EAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,GAC9D,MAAM,CAeR"}