@a5c-ai/genty-platform 5.1.1-staging.0007199a1cb2

package/dist/harness/internal/createRun/planProcess/recovery.js

@@ -0,0 +1,205 @@
+"use strict";
+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.buildPhaseConversationSummary = buildPhaseConversationSummary;
+exports.applyRecoveredProcessDefinitionFromOutput = applyRecoveredProcessDefinitionFromOutput;
+exports.recoverReportedProcessDefinition = recoverReportedProcessDefinition;
+exports.writeVerboseProcessDefinitionRecovery = writeVerboseProcessDefinitionRecovery;
+const path = __importStar(require("node:path"));
+const node_fs_1 = require("node:fs");
+const utils_1 = require("../utils");
+const paths_1 = require("./paths");
+function normalizeProcessImports(source) {
+    return source
+        .replace(/from\s+['"]babysitter-sdk['"]/g, 'from "@a5c-ai/babysitter-sdk"')
+        .replace(/from\s+['"]babysitter-sdk\/([^'"]+)['"]/g, 'from "@a5c-ai/babysitter-sdk/$1"');
+}
+function looksLikeProcessDefinitionSource(source) {
+    const normalized = source.trim();
+    if (!normalized) {
+        return false;
+    }
+    return (normalized.includes("defineTask(") ||
+        /export\s+async\s+function\s+process\s*\(/.test(normalized) ||
+        /export\s+default\s+async\s+function/.test(normalized) ||
+        /export\s*\{\s*process\s*\}/.test(normalized));
+}
+function extractProcessDefinitionCodeBlock(text) {
+    const codeBlockPattern = /```(?:javascript|js|mjs|ts)?\s*([\s\S]*?)```/gi;
+    let match;
+    let fallback = null;
+    while ((match = codeBlockPattern.exec(text)) !== null) {
+        const candidate = match[1]?.trim();
+        if (!candidate) {
+            continue;
+        }
+        if (looksLikeProcessDefinitionSource(candidate)) {
+            return candidate;
+        }
+        fallback ??= candidate;
+    }
+    if (fallback !== null) {
+        process.stderr.write('[babysitter] process recovery: code blocks found but none look like a process definition, rejecting\n');
+    }
+    return null;
+}
+function extractProcessDefinitionHeredoc(text) {
+    const heredocPattern = /<<-?\s*['"]?([A-Za-z_][A-Za-z0-9_]*)['"]?\r?\n([\s\S]*?)\r?\n\1\b/g;
+    let match;
+    let fallback = null;
+    while ((match = heredocPattern.exec(text)) !== null) {
+        const candidate = match[2]?.trim();
+        if (!candidate) {
+            continue;
+        }
+        if (looksLikeProcessDefinitionSource(candidate)) {
+            return candidate;
+        }
+        fallback ??= candidate;
+    }
+    return fallback;
+}
+function looksLikeStandaloneProcessDefinitionSource(source) {
+    const normalized = source.trim();
+    if (!looksLikeProcessDefinitionSource(normalized)) {
+        return false;
+    }
+    const suspiciousTranscriptMarkers = [
+        "to=bash",
+        "to=read",
+        "to=write",
+        "to=edit",
+        "\"stdout\":",
+        "\"stderr\":",
+        "\"exitCode\":",
+        "[phase",
+    ];
+    if (suspiciousTranscriptMarkers.some((marker) => normalized.includes(marker))) {
+        return false;
+    }
+    return /^(?:#!.*\r?\n)?(?:\s*\/\*\*[\s\S]*?\*\/\s*)?(?:import\s|const\s+\w+\s*=\s*defineTask\(|export\s+async\s+function\s+process\b|async\s+function\s+process\b)/.test(normalized);
+}
+function extractRecoverableProcessDefinitionSource(output) {
+    const codeBlock = extractProcessDefinitionCodeBlock(output);
+    if (codeBlock && looksLikeProcessDefinitionSource(codeBlock)) {
+        return codeBlock;
+    }
+    const heredoc = extractProcessDefinitionHeredoc(output);
+    if (heredoc && looksLikeProcessDefinitionSource(heredoc)) {
+        return heredoc;
+    }
+    return looksLikeStandaloneProcessDefinitionSource(output) ? output.trim() : null;
+}
+function buildPhaseConversationSummary(outputs) {
+    const trimmedOutputs = outputs
+        .map((output) => output.replace(/\s+/g, " ").trim())
+        .filter((output) => output.length > 0);
+    if (trimmedOutputs.length === 0) {
+        return "";
+    }
+    const joined = trimmedOutputs.slice(-3).join("\n\n---\n\n");
+    return joined.length > 4_000 ? `${joined.slice(0, 3_997)}...` : joined;
+}
+async function recoverProcessDefinitionFromOutputs(args) {
+    const resolvedDir = path.resolve(args.outputDir);
+    for (const output of args.outputs) {
+        for (const candidatePath of (0, paths_1.extractMentionedProcessPaths)(output, args.workspace)) {
+            try {
+                await (0, paths_1.waitForProcessFile)(candidatePath, 1_000);
+                return {
+                    processPath: candidatePath,
+                    summary: "Recovered process-definition output by using a path mentioned by the agent.",
+                };
+            }
+            catch {
+                // keep trying
+            }
+        }
+    }
+    for (const output of args.outputs) {
+        const extracted = extractRecoverableProcessDefinitionSource(output);
+        if (!extracted) {
+            continue;
+        }
+        const recoveredName = `recovered-process-${Date.now()}.mjs`;
+        const recoveredPath = path.join(resolvedDir, recoveredName);
+        await node_fs_1.promises.mkdir(resolvedDir, { recursive: true });
+        // Ensure the processes directory has a package.json with type:module
+        // so .mjs files are loaded as ESM by Node's module system
+        const pkgJsonPath = path.join(resolvedDir, "package.json");
+        try {
+            await node_fs_1.promises.access(pkgJsonPath);
+        }
+        catch {
+            await node_fs_1.promises.writeFile(pkgJsonPath, '{"type":"module"}\n', "utf8");
+        }
+        await node_fs_1.promises.writeFile(recoveredPath, normalizeProcessImports(extracted), "utf8");
+        return {
+            processPath: recoveredPath,
+            summary: "Recovered process-definition output by writing recoverable JavaScript source returned by the agent.",
+        };
+    }
+    return null;
+}
+async function applyRecoveredProcessDefinitionFromOutput(args) {
+    const extracted = extractRecoverableProcessDefinitionSource(args.output);
+    if (!extracted) {
+        return false;
+    }
+    const resolvedPath = path.resolve(args.processPath);
+    await node_fs_1.promises.mkdir(path.dirname(resolvedPath), { recursive: true });
+    await node_fs_1.promises.writeFile(resolvedPath, normalizeProcessImports(extracted), "utf8");
+    return true;
+}
+async function recoverReportedProcessDefinition(args) {
+    if (args.state.report?.processPath) {
+        return args.state.report;
+    }
+    const recovered = await recoverProcessDefinitionFromOutputs({
+        outputDir: args.outputDir,
+        workspace: args.workspace,
+        outputs: args.outputs,
+    });
+    if (recovered) {
+        args.state.report = recovered;
+        (0, utils_1.writeVerboseBlock)(args.verbose, args.json, "phasePlanProcess recovered report", recovered);
+    }
+    return recovered ?? undefined;
+}
+function writeVerboseProcessDefinitionRecovery(json) {
+    if (!json) {
+        process.stderr.write(`${utils_1.DIM}PhasePlanProcess recovery: the agent did not report the process file, retrying with an explicit write-and-report instruction...${utils_1.RESET}\n`);
+    }
+}

package/dist/harness/internal/createRun/planProcess/runState.d.ts

@@ -0,0 +1,40 @@
+import { type OrchestrationState, type SessionBindResult, AgentCoreSessionHandle } from "../utils";
+type EnsureRunAndMaybeBindArgs = {
+    processPath: string;
+    prompt: string;
+    workspace?: string;
+    runsDir: string;
+    selectedHarnessName: string;
+    maxIterations: number;
+    interactive: boolean;
+    verbose: boolean;
+    json: boolean;
+    phaseSession?: AgentCoreSessionHandle | null;
+    state?: OrchestrationState;
+    requireBoundSession?: boolean;
+};
+export declare function ensureRunAndMaybeBindFromProcessDefinition(args: EnsureRunAndMaybeBindArgs): Promise<{
+    runId: string;
+    runDir: string;
+    sessionBound?: SessionBindResult;
+    createdRun: boolean;
+    boundSession: boolean;
+}>;
+export declare function createRunAndMaybeBindFromProcessDefinition(args: {
+    processPath: string;
+    prompt: string;
+    workspace?: string;
+    runsDir: string;
+    selectedHarnessName: string;
+    maxIterations: number;
+    interactive: boolean;
+    verbose: boolean;
+    json: boolean;
+    phaseSession: AgentCoreSessionHandle | null;
+}): Promise<{
+    runId: string;
+    runDir: string;
+    sessionBound?: SessionBindResult;
+}>;
+export {};
+//# sourceMappingURL=runState.d.ts.map

package/dist/harness/internal/createRun/planProcess/runState.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runState.d.ts","sourceRoot":"","sources":["../../../../../src/harness/internal/createRun/planProcess/runState.ts"],"names":[],"mappings":"AAQA,OAAO,EAGL,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,EACtB,sBAAsB,EACvB,MAAM,UAAU,CAAC;AAGlB,KAAK,yBAAyB,GAAG;IAC/B,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,OAAO,CAAC;IACrB,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,OAAO,CAAC;IACd,YAAY,CAAC,EAAE,sBAAsB,GAAG,IAAI,CAAC;IAC7C,KAAK,CAAC,EAAE,kBAAkB,CAAC;IAC3B,mBAAmB,CAAC,EAAE,OAAO,CAAC;CAC/B,CAAC;AAoDF,wBAAsB,0CAA0C,CAC9D,IAAI,EAAE,yBAAyB,GAC9B,OAAO,CAAC;IACT,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,iBAAiB,CAAC;IACjC,UAAU,EAAE,OAAO,CAAC;IACpB,YAAY,EAAE,OAAO,CAAC;CACvB,CAAC,CA+FD;AAED,wBAAsB,0CAA0C,CAAC,IAAI,EAAE;IACrE,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,OAAO,CAAC;IACrB,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,OAAO,CAAC;IACd,YAAY,EAAE,sBAAsB,GAAG,IAAI,CAAC;CAC7C,GAAG,OAAO,CAAC;IACV,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,iBAAiB,CAAC;CAClC,CAAC,CAGD"}

package/dist/harness/internal/createRun/planProcess/runState.js

@@ -0,0 +1,179 @@
+"use strict";
+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.ensureRunAndMaybeBindFromProcessDefinition = ensureRunAndMaybeBindFromProcessDefinition;
+exports.createRunAndMaybeBindFromProcessDefinition = createRunAndMaybeBindFromProcessDefinition;
+const path = __importStar(require("node:path"));
+const node_fs_1 = require("node:fs");
+const comm_adapter_1 = require("@a5c-ai/comm-adapter");
+const __1 = require("../../../");
+// SDK-owned: session marker I/O is SDK runtime state management
+const babysitter_sdk_1 = require("@a5c-ai/babysitter-sdk");
+const global_1 = require("../../../../orchestration/global");
+const context_1 = require("../../../../session/context");
+const utils_1 = require("../utils");
+const builtInHarness_1 = require("../../../builtInHarness");
+function resolveWorktreeRepoAlias(context) {
+    const repoPath = context?.repo?.sourcePath ?? context?.repo?.targetPath;
+    if (repoPath) {
+        const basename = path.basename(repoPath);
+        if (basename) {
+            return basename;
+        }
+    }
+    return context?.repo?.alias;
+}
+async function resolveSessionWorktreeContext(workspace) {
+    const currentPath = path.resolve(workspace);
+    const fallback = {
+        workspacePath: currentPath,
+        currentPath,
+    };
+    try {
+        const context = await new comm_adapter_1.WorkspaceService().resolveSessionContext({ cwd: currentPath });
+        if (!context) {
+            return fallback;
+        }
+        return {
+            workspacePath: context.repo?.targetPath ?? context.workspaceDefaultCwd ?? context.workspaceRootPath,
+            currentPath: context.currentPath ?? currentPath,
+            mode: context.repo?.mode ?? context.workspaceMode,
+            repoAlias: resolveWorktreeRepoAlias(context),
+            branch: context.repo?.branch,
+        };
+    }
+    catch {
+        return fallback;
+    }
+}
+function resolveCurrentSessionContextId(harness, boundSessionId) {
+    const harnessPid = Number.parseInt(process.env.BABYSITTER_HARNESS_PID ?? "", 10);
+    if (Number.isFinite(harnessPid) && harnessPid > 0) {
+        const markerPath = (0, babysitter_sdk_1.getSessionMarkerPath)(harness, harnessPid);
+        if ((0, node_fs_1.existsSync)(markerPath)) {
+            const markerSessionId = (0, node_fs_1.readFileSync)(markerPath, "utf8").trim();
+            if (markerSessionId) {
+                return markerSessionId;
+            }
+        }
+    }
+    return (0, babysitter_sdk_1.readSessionMarker)(harness) ?? boundSessionId;
+}
+async function ensureRunAndMaybeBindFromProcessDefinition(args) {
+    const processId = path.basename(args.processPath, path.extname(args.processPath));
+    let runId = args.state?.runId;
+    let runDir = args.state?.runDir;
+    let createdRun = false;
+    const selectedHarnessName = (0, builtInHarness_1.normalizeBuiltInHarnessName)(args.selectedHarnessName);
+    if (!runId || !runDir) {
+        const created = await (0, global_1.getGlobalRegistry)().getOrchestration().createRun({
+            processId,
+            entrypoint: path.resolve(args.processPath),
+            prompt: args.prompt,
+            harness: selectedHarnessName,
+            inputs: args.prompt ? { prompt: args.prompt } : undefined,
+            runsDir: args.runsDir,
+            nonInteractive: args.interactive === false ? true : undefined,
+        });
+        runId = created.runId;
+        runDir = created.runDir;
+        createdRun = true;
+        if (args.state) {
+            args.state.runId = created.runId;
+            args.state.runDir = created.runDir;
+        }
+    }
+    const adapter = (0, __1.getAdapterByName)(selectedHarnessName);
+    if (!adapter) {
+        return { runId, runDir, sessionBound: args.state?.sessionBound, createdRun, boundSession: false };
+    }
+    if (args.state?.sessionBound) {
+        return {
+            runId,
+            runDir,
+            sessionBound: args.state.sessionBound,
+            createdRun,
+            boundSession: false,
+        };
+    }
+    let sessionId = adapter.resolveSessionId({});
+    if (!sessionId && selectedHarnessName === "agent-core") {
+        sessionId = args.phaseSession?.sessionId;
+    }
+    if (!sessionId && args.requireBoundSession) {
+        throw new utils_1.BabysitterRuntimeError("MissingHarnessSessionId", `Cannot resolve a session ID for harness ${selectedHarnessName}.`, { category: utils_1.ErrorCategory.Configuration });
+    }
+    if (!sessionId) {
+        return { runId, runDir, sessionBound: args.state?.sessionBound, createdRun, boundSession: false };
+    }
+    const pluginRoot = adapter.resolvePluginRoot({});
+    const stateDir = adapter.resolveStateDir({ pluginRoot });
+    const sessionBound = await adapter.bindSession({
+        sessionId,
+        runId,
+        runDir,
+        pluginRoot,
+        stateDir,
+        runsDir: args.runsDir,
+        maxIterations: args.maxIterations,
+        prompt: args.prompt,
+        verbose: args.verbose,
+        json: args.json,
+    });
+    if (sessionBound.fatal) {
+        throw new utils_1.BabysitterRuntimeError("SessionBindFatal", sessionBound.error ?? "Session binding failed fatally.", { category: utils_1.ErrorCategory.External });
+    }
+    if (args.state) {
+        args.state.sessionBound = sessionBound;
+    }
+    if (stateDir && args.workspace) {
+        const worktree = await resolveSessionWorktreeContext(args.workspace);
+        const sessionContextId = resolveCurrentSessionContextId(selectedHarnessName, sessionId);
+        await (0, context_1.updateSessionContext)(stateDir, sessionContextId, {
+            worktree,
+        });
+    }
+    return {
+        runId,
+        runDir,
+        sessionBound,
+        createdRun,
+        boundSession: true,
+    };
+}
+async function createRunAndMaybeBindFromProcessDefinition(args) {
+    const { runId, runDir, sessionBound } = await ensureRunAndMaybeBindFromProcessDefinition(args);
+    return { runId, runDir, sessionBound };
+}

package/dist/harness/internal/createRun/planProcess/understandIntent.d.ts

@@ -0,0 +1,22 @@
+import type { AgentCoreSessionHandle } from "../utils";
+export declare function buildUnderstandIntentPrompt(args: {
+    prompt: string;
+    interactive: boolean;
+    workspaceAssessment: {
+        kind: "empty" | "non-empty";
+        entries: string[];
+    };
+}): string;
+export declare function appendIntentHandoffToPlanPrompt(planPrompt: string, intentOutput: string): string;
+export declare function runUnderstandIntentPhase(args: {
+    session: AgentCoreSessionHandle;
+    promptMessage: string;
+    writeVerbose: (message: string) => void;
+    writeVerboseData: (label: string, value: unknown, maxChars?: number) => void;
+    timeout: number;
+}): Promise<{
+    success: boolean;
+    output: string;
+    handoffSummary: string;
+}>;
+//# sourceMappingURL=understandIntent.d.ts.map

package/dist/harness/internal/createRun/planProcess/understandIntent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"understandIntent.d.ts","sourceRoot":"","sources":["../../../../../src/harness/internal/createRun/planProcess/understandIntent.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,UAAU,CAAC;AAEvD,wBAAgB,2BAA2B,CAAC,IAAI,EAAE;IAChD,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,OAAO,CAAC;IACrB,mBAAmB,EAAE;QACnB,IAAI,EAAE,OAAO,GAAG,WAAW,CAAC;QAC5B,OAAO,EAAE,MAAM,EAAE,CAAC;KACnB,CAAC;CACH,GAAG,MAAM,CAyBT;AAaD,wBAAgB,+BAA+B,CAC7C,UAAU,EAAE,MAAM,EAClB,YAAY,EAAE,MAAM,GACnB,MAAM,CAQR;AAED,wBAAsB,wBAAwB,CAAC,IAAI,EAAE;IACnD,OAAO,EAAE,sBAAsB,CAAC;IAChC,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACxC,gBAAgB,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7E,OAAO,EAAE,MAAM,CAAC;CACjB,GAAG,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,cAAc,EAAE,MAAM,CAAA;CAAE,CAAC,CAcxE"}

package/dist/harness/internal/createRun/planProcess/understandIntent.js

@@ -0,0 +1,65 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildUnderstandIntentPrompt = buildUnderstandIntentPrompt;
+exports.appendIntentHandoffToPlanPrompt = appendIntentHandoffToPlanPrompt;
+exports.runUnderstandIntentPhase = runUnderstandIntentPhase;
+const phaseHelpers_1 = require("./phaseHelpers");
+function buildUnderstandIntentPrompt(args) {
+    const workspaceEntries = args.workspaceAssessment.entries.length > 0
+        ? args.workspaceAssessment.entries.join(", ")
+        : "(no files)";
+    return [
+        "PhaseUnderstandIntent.",
+        "Inspect the workspace and clarify the user's intent before authoring the process.",
+        "Do not write the process file yet and do not call babysitter_report_process_definition in this step.",
+        args.interactive
+            ? "If material requirements are missing, call AskUserQuestion and converge on a concise working brief."
+            : "Non-interactive mode: infer missing details from the request and workspace, then produce the best working brief you can.",
+        "",
+        `Workspace assessment: ${args.workspaceAssessment.kind}.`,
+        `Workspace entries: ${workspaceEntries}`,
+        "",
+        "Reply with a concise intent brief that covers:",
+        "- Goal: the concrete outcome the user wants",
+        "- Constraints: important limits, requirements, or non-goals",
+        "- Workspace context: the relevant repo/workspace facts you found",
+        "- Assumptions: only the assumptions still in play after inspection",
+        "- Execution posture: the shape of the process that should be authored next",
+        "",
+        `User request: ${args.prompt}`,
+    ].join("\n");
+}
+function buildIntentHandoffSummary(intentOutput) {
+    const normalized = intentOutput.trim();
+    if (!normalized) {
+        return "No additional intent analysis was captured.";
+    }
+    const maxChars = 4_000;
+    return normalized.length <= maxChars
+        ? normalized
+        : `${normalized.slice(0, maxChars)}\n... [truncated ${normalized.length - maxChars} chars]`;
+}
+function appendIntentHandoffToPlanPrompt(planPrompt, intentOutput) {
+    return [
+        planPrompt,
+        "",
+        "PhaseUnderstandIntent handoff:",
+        "Use this brief as the current contract unless later tool evidence clearly contradicts it.",
+        buildIntentHandoffSummary(intentOutput),
+    ].join("\n");
+}
+async function runUnderstandIntentPhase(args) {
+    const result = await (0, phaseHelpers_1.promptPhaseSession)({
+        session: args.session,
+        message: args.promptMessage,
+        timeout: args.timeout,
+        label: "phaseUnderstandIntent",
+        writeVerbose: args.writeVerbose,
+        writeVerboseData: args.writeVerboseData,
+    });
+    return {
+        success: result.success,
+        output: result.output,
+        handoffSummary: buildIntentHandoffSummary(result.output),
+    };
+}

package/dist/harness/internal/createRun/planProcess/validation.d.ts

@@ -0,0 +1,10 @@
+type DiscoverExternalAgentsFn = (opts: {
+    cwd?: string;
+    timeout?: number;
+}) => Promise<{
+    available: boolean;
+}>;
+export declare function validateProcessExport(filePath: string): Promise<void>;
+export declare function _setDiscoverExternalAgentsForValidationTesting(fn?: DiscoverExternalAgentsFn): void;
+export {};
+//# sourceMappingURL=validation.d.ts.map

package/dist/harness/internal/createRun/planProcess/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../../../../src/harness/internal/createRun/planProcess/validation.ts"],"names":[],"mappings":"AA6BA,KAAK,wBAAwB,GAAG,CAAC,IAAI,EAAE;IAAE,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,KAAK,OAAO,CAAC;IAAE,SAAS,EAAE,OAAO,CAAA;CAAE,CAAC,CAAC;AA2C9G,wBAAsB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CA4P3E;AAED,wBAAgB,8CAA8C,CAC5D,EAAE,CAAC,EAAE,wBAAwB,GAC5B,IAAI,CAEN"}