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

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 agent_comm_mux_1 = require("@a5c-ai/agent-comm-mux");
+const __1 = require("../../../");
+const babysitter_sdk_1 = require("@a5c-ai/babysitter-sdk");
+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 agent_comm_mux_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, babysitter_sdk_1.createRun)({
+            runsDir: args.runsDir,
+            harness: selectedHarnessName,
+            process: {
+                processId,
+                importPath: path.resolve(args.processPath),
+            },
+            prompt: args.prompt,
+            inputs: args.prompt ? { prompt: args.prompt } : undefined,
+            ...(args.interactive === false ? { metadata: { nonInteractive: true } } : {}),
+        });
+        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,2 @@
+export declare function validateProcessExport(filePath: string): Promise<void>;
+//# 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":"AAsDA,wBAAsB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CA0L3E"}

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

@@ -0,0 +1,212 @@
+"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.validateProcessExport = validateProcessExport;
+const path = __importStar(require("node:path"));
+const node_fs_1 = require("node:fs");
+const node_url_1 = require("node:url");
+const babysitter_sdk_1 = require("@a5c-ai/babysitter-sdk");
+const utils_1 = require("../utils");
+const delegation_1 = require("./delegation");
+const validationText_1 = require("./validationText");
+const validationSource_1 = require("./validationSource");
+let processValidationImportNonce = 0;
+const dynamicImportModule = (() => {
+    if (process.env.VITEST) {
+        return (specifier) => Promise.resolve(`${specifier}`).then(s => __importStar(require(s)));
+    }
+    // eslint-disable-next-line @typescript-eslint/no-implied-eval
+    return new Function("specifier", "return import(specifier);");
+})();
+async function ensureSdkResolvable(workspaceDir) {
+    const sdkPkg = path.dirname(require.resolve("@a5c-ai/babysitter-sdk/package.json"));
+    const targetNodeModules = path.join(workspaceDir, "node_modules");
+    const targetSdkDir = path.join(targetNodeModules, "@a5c-ai", "babysitter-sdk");
+    try {
+        await node_fs_1.promises.access(targetSdkDir);
+        return;
+    }
+    catch {
+        // create below
+    }
+    try {
+        await node_fs_1.promises.mkdir(path.join(targetNodeModules, "@a5c-ai"), { recursive: true });
+        const linkType = process.platform === "win32" ? "junction" : "dir";
+        await node_fs_1.promises.symlink(sdkPkg, targetSdkDir, linkType);
+    }
+    catch {
+        // best effort
+    }
+}
+async function validateProcessExport(filePath) {
+    const source = await node_fs_1.promises.readFile(path.resolve(filePath), "utf8");
+    const syntaxCheck = await (0, delegation_1.execShellEffect)(process.execPath, ["--check", path.resolve(filePath)]);
+    if (syntaxCheck.exitCode !== 0) {
+        const diagnostic = [syntaxCheck.stdout, syntaxCheck.stderr]
+            .map((value) => value.trim())
+            .filter(Boolean)
+            .join("\n");
+        throw new utils_1.BabysitterRuntimeError("InvalidProcessSyntaxError", diagnostic
+            ? `Process file at ${filePath} failed \`node --check\`.\n${diagnostic}`
+            : `Process file at ${filePath} failed \`node --check\`.`, {
+            category: utils_1.ErrorCategory.Validation,
+            nextSteps: [
+                "Rewrite the file so it is syntactically valid ESM before runtime import",
+                "If the process writes HTML/CSS/JS assets, do not embed raw nested template literals inside outer template literals",
+                "Prefer String.raw, arrays joined with \"\\n\", or escaped inner backticks and \\${...} sequences when embedding source files",
+            ],
+        });
+    }
+    if ((0, validationText_1.hasNamedProcessGlobalReferenceConflict)(source)) {
+        throw new utils_1.BabysitterRuntimeError("InvalidProcessSourceError", `Process file at ${filePath} references \`process.\` inside the named 'process' export, which shadows Node's global process object`, {
+            category: utils_1.ErrorCategory.Validation,
+            nextSteps: [
+                "If the process needs the workspace root, resolve it from the module location with import.meta.url",
+                "If you need Node's global process object, use globalThis.process or import it under another name such as nodeProcess",
+            ],
+        });
+    }
+    if ((0, validationText_1.assumesRuntimeWorkspacePathWithoutModuleFallback)(source)) {
+        throw new utils_1.BabysitterRuntimeError("InvalidProcessSourceError", `Process file at ${filePath} assumes ctx.workspaceDir or ctx.cwd exists, but the runtime process context does not provide workspace paths`, {
+            category: utils_1.ErrorCategory.Validation,
+            nextSteps: [
+                "When the process needs the workspace root, derive it from the module location with import.meta.url",
+                "For a generated process in the workspace root, use path.dirname(fileURLToPath(import.meta.url)) or an equivalent import.meta.url-based approach",
+            ],
+        });
+    }
+    const unresolvedPlaceholders = (0, validationSource_1.getUnresolvedTemplatePlaceholders)(source);
+    if (unresolvedPlaceholders.length > 0) {
+        throw new utils_1.BabysitterRuntimeError("InvalidProcessSourceError", `Process file at ${filePath} contains unresolved template placeholders: ${unresolvedPlaceholders.join(", ")}`, {
+            category: utils_1.ErrorCategory.Validation,
+            nextSteps: [
+                "Do not leave {{workspaceDir}}, {{gameRequest}}, or similar template placeholders in task prompts, shell commands, or node args",
+                "Build concrete prompt text and shell commands from defineTask(args, taskCtx) inputs when returning each TaskDef",
+                "If a task needs workspaceDir or request text, interpolate the actual args value into the returned TaskDef before runtime",
+            ],
+        });
+    }
+    await ensureSdkResolvable(path.dirname(path.resolve(filePath)));
+    const moduleUrl = `${(0, node_url_1.pathToFileURL)(path.resolve(filePath)).href}?t=${Date.now()}-${++processValidationImportNonce}`;
+    (0, babysitter_sdk_1.resetGlobalTaskRegistry)();
+    let mod;
+    try {
+        mod = await dynamicImportModule(moduleUrl);
+    }
+    finally {
+        (0, babysitter_sdk_1.resetGlobalTaskRegistry)();
+    }
+    const fn = mod.process;
+    if (typeof fn !== "function") {
+        throw new utils_1.BabysitterRuntimeError("InvalidProcessExportError", `Process file at ${filePath} does not export a function named 'process'`, {
+            category: utils_1.ErrorCategory.Validation,
+            nextSteps: [
+                "Ensure the file exports: async function process(inputs, ctx) { ... }",
+            ],
+        });
+    }
+    if (!(0, validationSource_1.hasDefineTaskBlocks)(source)) {
+        throw new utils_1.BabysitterRuntimeError("InvalidProcessSourceError", `Process file at ${filePath} does not define any babysitter tasks via defineTask(...)`, {
+            category: utils_1.ErrorCategory.Validation,
+            nextSteps: [
+                "Create at least one task with const taskName = defineTask(\"task-id\", (args, taskCtx) => ({ ... }))",
+                "Move the main implementation and verification work into those tasks instead of doing it directly in process(inputs, ctx)",
+                "Have process(inputs, ctx) orchestrate the work by awaiting ctx.task(taskName, args)",
+            ],
+        });
+    }
+    const taskIdsMissingKind = (0, validationSource_1.getDefineTaskIdsMissingKind)(source);
+    if (taskIdsMissingKind.length > 0) {
+        throw new utils_1.BabysitterRuntimeError("InvalidProcessSourceError", `Process file at ${filePath} defines task(s) without a top-level kind: ${taskIdsMissingKind.join(", ")}`, {
+            category: utils_1.ErrorCategory.Validation,
+            nextSteps: [
+                "Every TaskDef returned from defineTask(...) must include a top-level kind string",
+                "Use kind: \"agent\" with agent: { ... }, kind: \"shell\" with shell: { command: ... }, or another supported effect kind that the agent will execute and post manually",
+            ],
+        });
+    }
+    if (!(0, validationSource_1.hasCtxTaskInvocation)(source)) {
+        throw new utils_1.BabysitterRuntimeError("InvalidProcessSourceError", `Process file at ${filePath} does not invoke any babysitter tasks through ctx.task(...)`, {
+            category: utils_1.ErrorCategory.Validation,
+            nextSteps: [
+                "After defining tasks with defineTask(...), run them from process(inputs, ctx) via await ctx.task(taskName, args)",
+                "Do not perform the main implementation directly in process(inputs, ctx)",
+            ],
+        });
+    }
+    const taskKindShapeMismatches = (0, validationSource_1.getDefineTaskKindShapeMismatches)(source);
+    if (taskKindShapeMismatches.length > 0) {
+        throw new utils_1.BabysitterRuntimeError("InvalidProcessSourceError", `Process file at ${filePath} has task definition kind mismatches: ${taskKindShapeMismatches
+            .map((mismatch) => `${mismatch.id} should use kind "${mismatch.expectedKind}"`)
+            .join(", ")}`, {
+            category: utils_1.ErrorCategory.Validation,
+            nextSteps: [
+                "Match each task's kind to its body shape",
+                "Agent tasks must use kind: \"agent\" and shell tasks must use kind: \"shell\". Do not generate node task definitions in authored processes",
+            ],
+        });
+    }
+    const agentTaskIds = (0, validationSource_1.getDefineTaskIdsByKind)(source, "agent");
+    if (agentTaskIds.length === 0) {
+        throw new utils_1.BabysitterRuntimeError("InvalidProcessSourceError", `Process file at ${filePath} does not define any agent tasks`, {
+            category: utils_1.ErrorCategory.Validation,
+            nextSteps: [
+                "Define at least one agent task with kind: \"agent\" for the main planning, implementation, or refinement work",
+                "Use shell tasks only for concrete runnable commands such as tests, builds, package installs, or linters",
+            ],
+        });
+    }
+    const nodeTaskIds = (0, validationSource_1.getDefineTaskIdsByKind)(source, "node");
+    if (nodeTaskIds.length > 0) {
+        throw new utils_1.BabysitterRuntimeError("InvalidProcessSourceError", `Process file at ${filePath} defines forbidden node tasks: ${nodeTaskIds.join(", ")}`, {
+            category: utils_1.ErrorCategory.Validation,
+            nextSteps: [
+                "Replace each node task with an agent or skill task",
+                "If the work is a concrete existing CLI command, use a shell task and have the orchestrating agent execute it and post the result",
+            ],
+        });
+    }
+    const invalidCtxTaskTargets = (0, validationSource_1.getInvalidCtxTaskTargets)(source);
+    if (invalidCtxTaskTargets.length > 0) {
+        throw new utils_1.BabysitterRuntimeError("InvalidProcessSourceError", `Process file at ${filePath} calls ctx.task(...) with values that are not DefinedTask bindings created via defineTask(...): ${invalidCtxTaskTargets.join(", ")}`, {
+            category: utils_1.ErrorCategory.Validation,
+            nextSteps: [
+                "Define each task with const taskName = defineTask(\"task-id\", (args, taskCtx) => ({ ... }))",
+                "Pass only those DefinedTask bindings to await ctx.task(taskName, args)",
+                "Do not pass plain object task definitions, inline literals, or ad-hoc task objects to ctx.task(...)",
+            ],
+        });
+    }
+}

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

@@ -0,0 +1,11 @@
+export declare function hasDefineTaskBlocks(source: string): boolean;
+export declare function getDefineTaskIdsMissingKind(source: string): string[];
+export declare function getDefineTaskKindShapeMismatches(source: string): Array<{
+    id: string;
+    expectedKind: string;
+}>;
+export declare function getInvalidCtxTaskTargets(source: string): string[];
+export declare function hasCtxTaskInvocation(source: string): boolean;
+export declare function getUnresolvedTemplatePlaceholders(source: string): string[];
+export declare function getDefineTaskIdsByKind(source: string, kind: "agent" | "shell" | "node"): string[];
+//# sourceMappingURL=validationSource.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"validationSource.d.ts","sourceRoot":"","sources":["../../../../../src/harness/internal/createRun/planProcess/validationSource.ts"],"names":[],"mappings":"AAeA,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAE3D;AAyQD,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAIpE;AAED,wBAAgB,gCAAgC,CAAC,MAAM,EAAE,MAAM,GAAG,KAAK,CAAC;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE,CAAC,CAgB5G;AAED,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAwBjE;AAED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAE5D;AAED,wBAAgB,iCAAiC,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAQ1E;AAED,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,EAAE,CAOjG"}