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

package/dist/harness/internal/createRun/orchestration/hookDecisionEffects.d.ts

@@ -0,0 +1,32 @@
+import type { ResolveEffectResult } from "../utils";
+export type HookDecisionVerb = "deny" | "block" | "retry" | "ask" | "allow" | "defer" | "continue" | "noop";
+export interface HookDecisionResult {
+    decision?: HookDecisionVerb;
+    reason?: string;
+    continueSession?: boolean;
+    stopReason?: string;
+    toolMutation?: {
+        mode: "replace" | "patch";
+        value: unknown;
+    };
+    updatedInput?: unknown;
+    metadata?: Record<string, unknown>;
+}
+export interface HookDecisionResolutionOptions {
+    attempt?: number;
+    maxRetries?: number;
+}
+interface HookDecisionAction {
+    kind: string;
+    effectId?: string;
+    taskId?: string;
+    taskDef?: {
+        title?: string;
+        metadata?: Record<string, unknown>;
+        hookResult?: unknown;
+    } & Record<string, unknown>;
+}
+export declare function getHookDecisionResult(action: HookDecisionAction): HookDecisionResult | null;
+export declare function resolveHookDecisionResult(action: HookDecisionAction, hookResult: HookDecisionResult, options?: HookDecisionResolutionOptions): ResolveEffectResult | null;
+export {};
+//# sourceMappingURL=hookDecisionEffects.d.ts.map

package/dist/harness/internal/createRun/orchestration/hookDecisionEffects.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hookDecisionEffects.d.ts","sourceRoot":"","sources":["../../../../../src/harness/internal/createRun/orchestration/hookDecisionEffects.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAEpD,MAAM,MAAM,gBAAgB,GAAG,MAAM,GAAG,OAAO,GAAG,OAAO,GAAG,KAAK,GAAG,OAAO,GAAG,OAAO,GAAG,UAAU,GAAG,MAAM,CAAC;AAE5G,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,EAAE,gBAAgB,CAAC;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE;QAAE,IAAI,EAAE,SAAS,GAAG,OAAO,CAAC;QAAC,KAAK,EAAE,OAAO,CAAA;KAAE,CAAC;IAC7D,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED,MAAM,WAAW,6BAA6B;IAC5C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,UAAU,kBAAkB;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE;QACR,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACnC,UAAU,CAAC,EAAE,OAAO,CAAC;KACtB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC7B;AAED,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,kBAAkB,GAAG,kBAAkB,GAAG,IAAI,CAS3F;AAED,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,kBAAkB,EAC1B,UAAU,EAAE,kBAAkB,EAC9B,OAAO,GAAE,6BAAkC,GAC1C,mBAAmB,GAAG,IAAI,CAgE5B"}

package/dist/harness/internal/createRun/orchestration/hookDecisionEffects.js

@@ -0,0 +1,76 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getHookDecisionResult = getHookDecisionResult;
+exports.resolveHookDecisionResult = resolveHookDecisionResult;
+const permissionEvents_1 = require("../../../../governance/permissionEvents");
+function getHookDecisionResult(action) {
+    const taskDef = action.taskDef;
+    const metadata = taskDef?.metadata;
+    const candidate = metadata?.hookResult ?? taskDef?.hookResult;
+    if (!candidate || typeof candidate !== "object" || Array.isArray(candidate)) {
+        return null;
+    }
+    const result = candidate;
+    return typeof result.decision === "string" || result.continueSession === false ? result : null;
+}
+function resolveHookDecisionResult(action, hookResult, options = {}) {
+    const reason = hookResult.reason ?? hookResult.stopReason ?? "Hook decision";
+    const operation = {
+        kind: action.kind,
+        target: action.taskDef?.title ?? action.taskId ?? action.effectId ?? "effect",
+        effectId: action.effectId,
+        taskId: action.taskId,
+    };
+    if (hookResult.decision === "block" || hookResult.decision === "deny") {
+        const auditEvent = (0, permissionEvents_1.createPermissionEvent)({
+            kind: "hook-decision",
+            operation,
+            decision: {
+                action: "block",
+                reason,
+                hookDecision: hookResult.decision,
+            },
+            source: "harness",
+        });
+        return {
+            status: "error",
+            error: new Error(reason),
+            value: { blocked: true, reason, auditEvent },
+            stderr: reason,
+        };
+    }
+    if (hookResult.decision === "retry") {
+        const attempt = options.attempt ?? 0;
+        const maxRetries = options.maxRetries ?? 0;
+        const exhausted = attempt >= maxRetries;
+        const auditEvent = (0, permissionEvents_1.createPermissionEvent)({
+            kind: "hook-decision",
+            operation,
+            decision: {
+                action: "retry",
+                reason,
+                hookDecision: "retry",
+                attempt,
+                maxRetries,
+                exhausted,
+            },
+            source: "harness",
+        });
+        return {
+            status: exhausted ? "error" : "ok",
+            value: { retry: !exhausted, exhausted, reason, attempt, maxRetries, auditEvent },
+            error: exhausted ? new Error(reason) : undefined,
+            stderr: exhausted ? reason : undefined,
+        };
+    }
+    if (hookResult.continueSession === false) {
+        const stopReason = hookResult.stopReason ?? reason;
+        return {
+            status: "error",
+            error: new Error(stopReason),
+            value: { aborted: true, stopReason },
+            stderr: stopReason,
+        };
+    }
+    return null;
+}

package/dist/harness/internal/createRun/orchestration/index.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Compatibility surface for PhaseOrchestration helpers.
+ *
+ * The implementation lives under ./orchestration/ so the command stays
+ * split by responsibility instead of accreting more top-level helper files.
+ */
+export { MAX_CONSECUTIVE_PROCESS_ERROR_STALLS, MAX_CONSECUTIVE_STALLS, MAX_CONSECUTIVE_TIMEOUTS, MAX_PROCESS_ERROR_RECOVERIES, } from "./constants";
+export { orchestrateIterationWithProcessLoadRetry, readProcessFileFingerprint, resolveEffect, resolveEffectWithRetry, resolveHarnessSessionIdForBinding, } from "./effects";
+export { runExternalOrchestrationPhase } from "./externalPhase";
+export { runInternalOrchestrationPhase } from "./internalPhase";
+export { subscribeVerbosePiEvents } from "./verbose";
+import type { RunOrchestrationPhaseArgs } from "./types";
+export declare function runOrchestrationPhase(args: RunOrchestrationPhaseArgs): Promise<number>;
+export declare function resolveAndPostEffect(action: {
+    effectId: string;
+    kind: string;
+    taskDef?: {
+        agent?: {
+            prompt?: string | {
+                instructions?: string[];
+            };
+        } & Record<string, unknown>;
+        shell?: {
+            command?: string;
+        };
+        title?: string;
+    } & Record<string, unknown>;
+}, runDir: string, workspace: string, model?: string, babysitterBin?: string): Promise<void>;
+//# sourceMappingURL=index.d.ts.map

package/dist/harness/internal/createRun/orchestration/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/harness/internal/createRun/orchestration/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,oCAAoC,EACpC,sBAAsB,EACtB,wBAAwB,EACxB,4BAA4B,GAC7B,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,wCAAwC,EACxC,0BAA0B,EAC1B,aAAa,EACb,sBAAsB,EACtB,iCAAiC,GAClC,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,6BAA6B,EAAE,MAAM,iBAAiB,CAAC;AAChE,OAAO,EAAE,6BAA6B,EAAE,MAAM,iBAAiB,CAAC;AAChE,OAAO,EAAE,wBAAwB,EAAE,MAAM,WAAW,CAAC;AAErD,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,SAAS,CAAC;AAYzD,wBAAsB,qBAAqB,CACzC,IAAI,EAAE,yBAAyB,GAC9B,OAAO,CAAC,MAAM,CAAC,CAOjB;AAgID,wBAAsB,oBAAoB,CACxC,MAAM,EAAE;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE;YAAE,MAAM,CAAC,EAAE,MAAM,GAAG;gBAAE,YAAY,CAAC,EAAE,MAAM,EAAE,CAAA;aAAE,CAAA;SAAE,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAAC,KAAK,CAAC,EAAE;YAAE,OAAO,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,EACrN,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,EACjB,KAAK,CAAC,EAAE,MAAM,EACd,aAAa,SAAe,GAC3B,OAAO,CAAC,IAAI,CAAC,CA2Df"}

package/dist/harness/internal/createRun/orchestration/index.js

@@ -0,0 +1,370 @@
+"use strict";
+/**
+ * Compatibility surface for PhaseOrchestration helpers.
+ *
+ * The implementation lives under ./orchestration/ so the command stays
+ * split by responsibility instead of accreting more top-level helper files.
+ */
+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.subscribeVerbosePiEvents = exports.runInternalOrchestrationPhase = exports.runExternalOrchestrationPhase = exports.resolveHarnessSessionIdForBinding = exports.resolveEffectWithRetry = exports.resolveEffect = exports.readProcessFileFingerprint = exports.orchestrateIterationWithProcessLoadRetry = exports.MAX_PROCESS_ERROR_RECOVERIES = exports.MAX_CONSECUTIVE_TIMEOUTS = exports.MAX_CONSECUTIVE_STALLS = exports.MAX_CONSECUTIVE_PROCESS_ERROR_STALLS = void 0;
+exports.runOrchestrationPhase = runOrchestrationPhase;
+exports.resolveAndPostEffect = resolveAndPostEffect;
+var constants_1 = require("./constants");
+Object.defineProperty(exports, "MAX_CONSECUTIVE_PROCESS_ERROR_STALLS", { enumerable: true, get: function () { return constants_1.MAX_CONSECUTIVE_PROCESS_ERROR_STALLS; } });
+Object.defineProperty(exports, "MAX_CONSECUTIVE_STALLS", { enumerable: true, get: function () { return constants_1.MAX_CONSECUTIVE_STALLS; } });
+Object.defineProperty(exports, "MAX_CONSECUTIVE_TIMEOUTS", { enumerable: true, get: function () { return constants_1.MAX_CONSECUTIVE_TIMEOUTS; } });
+Object.defineProperty(exports, "MAX_PROCESS_ERROR_RECOVERIES", { enumerable: true, get: function () { return constants_1.MAX_PROCESS_ERROR_RECOVERIES; } });
+var effects_1 = require("./effects");
+Object.defineProperty(exports, "orchestrateIterationWithProcessLoadRetry", { enumerable: true, get: function () { return effects_1.orchestrateIterationWithProcessLoadRetry; } });
+Object.defineProperty(exports, "readProcessFileFingerprint", { enumerable: true, get: function () { return effects_1.readProcessFileFingerprint; } });
+Object.defineProperty(exports, "resolveEffect", { enumerable: true, get: function () { return effects_1.resolveEffect; } });
+Object.defineProperty(exports, "resolveEffectWithRetry", { enumerable: true, get: function () { return effects_1.resolveEffectWithRetry; } });
+Object.defineProperty(exports, "resolveHarnessSessionIdForBinding", { enumerable: true, get: function () { return effects_1.resolveHarnessSessionIdForBinding; } });
+var externalPhase_1 = require("./externalPhase");
+Object.defineProperty(exports, "runExternalOrchestrationPhase", { enumerable: true, get: function () { return externalPhase_1.runExternalOrchestrationPhase; } });
+var internalPhase_1 = require("./internalPhase");
+Object.defineProperty(exports, "runInternalOrchestrationPhase", { enumerable: true, get: function () { return internalPhase_1.runInternalOrchestrationPhase; } });
+var verbose_1 = require("./verbose");
+Object.defineProperty(exports, "subscribeVerbosePiEvents", { enumerable: true, get: function () { return verbose_1.subscribeVerbosePiEvents; } });
+const externalPhase_2 = require("./externalPhase");
+const internalPhase_2 = require("./internalPhase");
+const utils_1 = require("../utils");
+async function importOptionalModule(specifier) {
+    return Promise.resolve(`${specifier}`).then(s => __importStar(require(s)));
+}
+async function runOrchestrationPhase(args) {
+    const externalExitCode = await (0, externalPhase_2.runExternalOrchestrationPhase)(args);
+    if (externalExitCode !== undefined) {
+        return externalExitCode;
+    }
+    return (0, internalPhase_2.runInternalOrchestrationPhase)(args);
+}
+async function runCliOrchestration(args) {
+    const { execFileSync } = await Promise.resolve().then(() => __importStar(require("node:child_process")));
+    const path = await Promise.resolve().then(() => __importStar(require("node:path")));
+    const processPath = args.processPath;
+    const workspace = args.workspace ?? process.cwd();
+    const runsDir = args.runsDir;
+    const prompt = args.prompt ?? "";
+    const model = args.model;
+    // Resolve babysitter CLI: prefer the SDK's dist/cli/main.js over global binary
+    let babysitterBin = "babysitter";
+    try {
+        const sdkCliPath = require.resolve("@a5c-ai/babysitter-sdk/dist/cli/main.js");
+        babysitterBin = `${process.execPath} ${sdkCliPath}`;
+    }
+    catch {
+        // Fall back to global babysitter binary
+    }
+    // Create run via CLI — pass prompt both as metadata and as process inputs
+    const fsPromises = await Promise.resolve().then(() => __importStar(require("node:fs/promises")));
+    const inputsFile = path.join(workspace, `.a5c-genty-inputs-${Date.now()}.json`);
+    await fsPromises.writeFile(inputsFile, JSON.stringify({ prompt, request: prompt }));
+    const createArgs = [
+        "run:create",
+        "--entry", `${path.resolve(processPath)}#process`,
+        "--process-id", path.basename(processPath, path.extname(processPath)),
+        "--prompt", prompt,
+        "--inputs", inputsFile,
+        "--harness", "agent-core",
+        "--json",
+    ];
+    if (runsDir)
+        createArgs.push("--runs-dir", runsDir);
+    let runDir;
+    const babysitterBinParts = babysitterBin.split(" ");
+    const babysitterCmd = babysitterBinParts[0];
+    const babysitterPrefix = babysitterBinParts.slice(1);
+    try {
+        const createResult = execFileSync(babysitterCmd, [...babysitterPrefix, ...createArgs], {
+            cwd: workspace,
+            encoding: "utf8",
+            timeout: 30_000,
+            env: { ...process.env },
+        });
+        const parsed = JSON.parse(createResult);
+        runDir = parsed.runDir;
+        await fsPromises.unlink(inputsFile).catch(() => { });
+        if (!args.json) {
+            process.stderr.write(`\x1b[32mRun created:\x1b[0m ${runDir}\n`);
+        }
+    }
+    catch (err) {
+        await fsPromises.unlink(inputsFile).catch(() => { });
+        const msg = err instanceof Error ? err.message : String(err);
+        if (!args.json) {
+            process.stderr.write(`\x1b[31mFailed to create run:\x1b[0m ${msg}\n`);
+        }
+        return 1;
+    }
+    // Iterate loop — cap at 20 for CLI orchestration regardless of caller
+    const maxIterations = Math.min(args.maxIterations ?? 20, 20);
+    let consecutiveNoEffects = 0;
+    for (let i = 1; i <= maxIterations; i++) {
+        process.stderr.write(`[genty-orchestration] iteration ${i}/${maxIterations} starting\n`);
+        try {
+            const iterArgs = [...babysitterPrefix, "run:iterate", runDir, "--json", "--iteration", String(i)];
+            process.stderr.write(`[genty-orchestration] exec: ${babysitterCmd} ${iterArgs.join(" ")}\n`);
+            const iterResult = execFileSync(babysitterCmd, iterArgs, {
+                cwd: workspace,
+                encoding: "utf8",
+                timeout: 120_000,
+                env: { ...process.env },
+            });
+            const parsed = JSON.parse(iterResult);
+            process.stderr.write(`[genty-orchestration] iterate result: status=${parsed.status} actions=${parsed.nextActions?.length ?? 0} reason=${parsed.reason ?? 'n/a'}\n`);
+            if (parsed.status === "completed") {
+                if (!args.json) {
+                    process.stderr.write(`\x1b[32mRun completed.\x1b[0m\n`);
+                }
+                return 0;
+            }
+            if (parsed.status === "failed") {
+                if (!args.json) {
+                    process.stderr.write(`\x1b[31mRun failed:\x1b[0m ${parsed.reason ?? "unknown"}\n`);
+                }
+                return 1;
+            }
+            // Handle pending effects
+            if (parsed.nextActions?.length) {
+                consecutiveNoEffects = 0;
+                process.stderr.write(`[genty-orchestration] iteration ${i}: ${parsed.nextActions.length} pending effects to resolve\n`);
+                for (const action of parsed.nextActions) {
+                    process.stderr.write(`[genty-orchestration] resolving effect ${action.effectId} (${action.kind})\n`);
+                    await resolveAndPostEffect(action, runDir, workspace, model, babysitterBin);
+                    process.stderr.write(`[genty-orchestration] effect ${action.effectId} resolved\n`);
+                }
+            }
+            else if (parsed.status === "none") {
+                consecutiveNoEffects++;
+                if (consecutiveNoEffects >= 3) {
+                    if (!args.json) {
+                        process.stderr.write(`\x1b[31mNo pending effects for ${consecutiveNoEffects} consecutive iterations — process may not be dispatching tasks.\x1b[0m\n`);
+                    }
+                    return 1;
+                }
+                if (!args.json) {
+                    process.stderr.write(`\x1b[33mNo pending effects at iteration ${i}\x1b[0m\n`);
+                }
+            }
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            if (!args.json) {
+                process.stderr.write(`\x1b[31mIteration ${i} error:\x1b[0m ${msg}\n`);
+            }
+            return 1;
+        }
+    }
+    if (!args.json) {
+        process.stderr.write(`\x1b[31mMax iterations (${maxIterations}) reached.\x1b[0m\n`);
+    }
+    return 1;
+}
+async function resolveAndPostEffect(action, runDir, workspace, model, babysitterBin = "babysitter") {
+    const { execFileSync, execSync } = await Promise.resolve().then(() => __importStar(require("node:child_process")));
+    const { createAgentCoreSession } = await Promise.resolve().then(() => __importStar(require("../utils")));
+    const babysitterParts = babysitterBin.split(" ");
+    const bCmd = babysitterParts[0];
+    const bPrefix = babysitterParts.slice(1);
+    let value;
+    const tasksMuxValue = await resolveViaTasksMuxForCli(action, workspace, model);
+    if (tasksMuxValue !== undefined) {
+        value = tasksMuxValue;
+    }
+    else if (action.kind === "agent" || action.kind === "skill") {
+        const agentPrompt = action.taskDef?.agent?.prompt;
+        const prompt = typeof agentPrompt === "string"
+            ? agentPrompt
+            : agentPrompt?.instructions?.join("\n")
+                ?? action.taskDef?.title
+                ?? "Execute this task";
+        const session = createAgentCoreSession({
+            workspace,
+            model,
+            ephemeral: true,
+        });
+        try {
+            const result = await session.prompt(prompt);
+            value = JSON.stringify(result.output ?? "");
+        }
+        finally {
+            session.dispose();
+        }
+    }
+    else if (action.kind === "shell") {
+        const command = action.taskDef?.shell?.command ?? "echo ok";
+        try {
+            const output = execSync(command, { cwd: workspace, encoding: "utf8", timeout: 120_000 });
+            value = JSON.stringify(output);
+        }
+        catch (err) {
+            const stderr = err.stderr ?? "";
+            value = JSON.stringify(stderr || "shell command failed");
+        }
+    }
+    else if (action.kind === "breakpoint") {
+        value = JSON.stringify("approved");
+    }
+    else {
+        value = JSON.stringify("ok");
+    }
+    // Post result
+    try {
+        const fs = await Promise.resolve().then(() => __importStar(require("node:fs/promises")));
+        const path = await Promise.resolve().then(() => __importStar(require("node:path")));
+        const taskDir = path.join(runDir, "tasks", action.effectId);
+        await fs.mkdir(taskDir, { recursive: true });
+        await fs.writeFile(path.join(taskDir, "output.json"), value);
+        execFileSync(bCmd, [...bPrefix, "task:post", runDir, action.effectId, "--status", "ok", "--value", `tasks/${action.effectId}/output.json`, "--json"], {
+            cwd: workspace, encoding: "utf8", timeout: 30_000, env: { ...process.env },
+        });
+    }
+    catch {
+        // Best effort
+    }
+}
+async function resolveViaTasksMuxForCli(action, workspace, model) {
+    if (action.kind !== "agent" && action.kind !== "breakpoint") {
+        return undefined;
+    }
+    let adapter;
+    try {
+        adapter = await importOptionalModule("@a5c-ai/tasks-adapter");
+    }
+    catch {
+        return undefined;
+    }
+    if (typeof adapter.routeTask !== "function") {
+        return undefined;
+    }
+    const decision = adapter.routeTask(action.taskDef);
+    if (decision.responderType === "internal" || decision.responderType === "human") {
+        if (decision.responderType === "human") {
+            return JSON.stringify(buildCliBreakpointValue(action));
+        }
+        return undefined;
+    }
+    if (decision.responderType === "tracker") {
+        if (!decision.unavailable)
+            return undefined;
+        return JSON.stringify({
+            success: false,
+            routedThrough: "tasks-adapter",
+            responderType: "tracker",
+            error: decision.reason ?? "ExternalTrackerBackend unavailable",
+        });
+    }
+    if (decision.responderType !== "agent") {
+        return undefined;
+    }
+    const fallbackToInternal = shouldFallbackExternalAgentToInternal(action.taskDef);
+    if (typeof adapter.AgentMuxResponderBackend !== "function") {
+        if (fallbackToInternal)
+            return undefined;
+        throw new Error("tasks-adapter AgentMuxResponderBackend is unavailable");
+    }
+    const prompt = buildCliAgentPrompt(action.taskDef);
+    let breakpoint;
+    try {
+        const backend = new adapter.AgentMuxResponderBackend({
+            adapter: decision.responder?.adapter ?? decision.responder?.id,
+            model: decision.responder?.model ?? model,
+            cwd: workspace,
+        });
+        breakpoint = await backend.submitBreakpoint({
+            text: prompt,
+            context: {
+                description: action.taskDef?.title ?? action.taskId ?? action.effectId,
+                codeSnippets: [],
+                fileReferences: [],
+                tags: action.labels ?? [],
+            },
+            routing: {
+                strategy: "single",
+                targetResponders: decision.responder?.id ? [decision.responder.id] : [],
+                timeoutMs: readExternalAgentTimeoutMs(action.taskDef) ?? 300_000,
+                presentToUser: false,
+                responderType: "agent",
+                adapter: decision.responder?.adapter ?? decision.responder?.id,
+                model: decision.responder?.model ?? model,
+            },
+        });
+    }
+    catch (err) {
+        if (fallbackToInternal)
+            return undefined;
+        throw err;
+    }
+    return JSON.stringify(breakpoint.answers[0]?.text ?? "");
+}
+function buildCliBreakpointValue(action) {
+    const question = action.taskDef?.question
+        ?? action.taskDef?.title
+        ?? action.taskId
+        ?? action.effectId;
+    const approvalPrompt = (0, utils_1.createApprovalAskUserQuestion)(question);
+    const approvalKey = approvalPrompt.questions[0]?.header ?? "Decision";
+    const response = (0, utils_1.createAskUserQuestionResponse)(approvalPrompt, { [approvalKey]: "Approve" });
+    return {
+        approved: true,
+        option: "Approve",
+        askUserQuestion: response,
+    };
+}
+function buildCliAgentPrompt(taskDef) {
+    const agentPrompt = taskDef?.agent?.prompt;
+    return typeof agentPrompt === "string"
+        ? agentPrompt
+        : agentPrompt?.instructions?.join("\n")
+            ?? taskDef?.title
+            ?? "Execute this task";
+}
+function shouldFallbackExternalAgentToInternal(taskDef) {
+    const agent = isPlainRecord(taskDef?.agent) ? taskDef.agent : {};
+    const metadata = isPlainRecord(taskDef?.metadata) ? taskDef.metadata : {};
+    return agent.fallbackToInternal === true
+        || metadata.fallbackToInternal === true
+        || agent.fallbackType === "internal"
+        || metadata.fallbackType === "internal";
+}
+function readExternalAgentTimeoutMs(taskDef) {
+    const agent = isPlainRecord(taskDef?.agent) ? taskDef.agent : {};
+    return typeof agent.timeoutMs === "number" ? agent.timeoutMs : undefined;
+}
+function isPlainRecord(value) {
+    return Boolean(value) && typeof value === "object" && !Array.isArray(value);
+}

package/dist/harness/internal/createRun/orchestration/internalPhase.d.ts

@@ -0,0 +1,3 @@
+import type { RunOrchestrationPhaseArgs } from "./types";
+export declare function runInternalOrchestrationPhase(args: RunOrchestrationPhaseArgs): Promise<number>;
+//# sourceMappingURL=internalPhase.d.ts.map

package/dist/harness/internal/createRun/orchestration/internalPhase.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"internalPhase.d.ts","sourceRoot":"","sources":["../../../../../src/harness/internal/createRun/orchestration/internalPhase.ts"],"names":[],"mappings":"AAoCA,OAAO,KAAK,EAAiC,yBAAyB,EAAE,MAAM,SAAS,CAAC;AAQxF,wBAAsB,6BAA6B,CACjD,IAAI,EAAE,yBAAyB,GAC9B,OAAO,CAAC,MAAM,CAAC,CA+pBjB"}