@a5c-ai/babysitter-sdk 5.1.1-staging.fee05906043b → 6.0.0

package/dist/cli/commands/detectExistingRun.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"detectExistingRun.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/detectExistingRun.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,OAAO,CAAC;IACnB,UAAU,EAAE;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACxD,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,eAAe,GAAG,SAAS,CAAC,CA0B9E;AAED,wBAAgB,sBAAsB,CAAC,WAAW,EAAE,eAAe,GAAG,MAAM,CAiB3E"}
+{"version":3,"file":"detectExistingRun.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/detectExistingRun.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,OAAO,CAAC;IACnB,UAAU,EAAE;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACxD,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AASD,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,eAAe,GAAG,SAAS,CAAC,CAsC9E;AAED,wBAAgB,sBAAsB,CAAC,WAAW,EAAE,eAAe,GAAG,MAAM,CAiB3E"}

package/dist/cli/commands/detectExistingRun.js

@@ -38,32 +38,49 @@ exports.formatExistingRunBlock = formatExistingRunBlock;
 const node_fs_1 = require("node:fs");
 const path = __importStar(require("node:path"));
 const config_1 = require("../../config");
+/**
+ * How many of the most-recent runs to inspect. Because we now skip completed
+ * and cross-project runs, the first parseable match may not be the very latest
+ * directory, so we scan a window rather than only the top entry.
+ */
+const SCAN_WINDOW = 25;
 async function detectExistingRun() {
     try {
         const runsDir = (0, config_1.resolveRunsDir)();
+        const currentCwd = path.resolve(process.cwd());
         const entries = await node_fs_1.promises.readdir(runsDir, { withFileTypes: true });
         const dirs = entries.filter((e) => e.isDirectory()).map((e) => e.name).sort().reverse();
-        for (const runId of dirs.slice(0, 5)) {
+        for (const runId of dirs.slice(0, SCAN_WINDOW)) {
             const runFile = path.join(runsDir, runId, "run.json");
+            let meta;
             try {
-                const raw = await node_fs_1.promises.readFile(runFile, "utf8");
-                const meta = JSON.parse(raw);
-                const entrypoint = meta["entrypoint"];
-                const processId = meta["processId"] ?? "";
-                const isBareRun = entrypoint?.importPath === "bare-run";
-                return {
-                    runId,
-                    runDir: path.join(runsDir, runId),
-                    processId,
-                    isBareRun,
-                    entrypoint: { importPath: entrypoint?.importPath ?? "", exportName: entrypoint?.exportName },
-                    completionProof: meta["completionProof"]
-                        ?? meta["metadata"]?.["completionProof"],
-                };
+                meta = JSON.parse(await node_fs_1.promises.readFile(runFile, "utf8"));
             }
             catch {
                 continue;
             }
+            // A run that already carries a completion proof is finished — it is never
+            // an "existing run to resume", so it must not be surfaced as overlap state.
+            const completionProof = meta["completionProof"]
+                ?? meta["metadata"]?.["completionProof"];
+            if (completionProof)
+                continue;
+            // Project scoping: when the run recorded the cwd it was created in, only
+            // surface it if that matches the current working directory. Runs from
+            // other projects/worktrees share the global runs dir and must not leak in.
+            const recordedCwd = meta["cwd"];
+            if (recordedCwd && path.resolve(recordedCwd) !== currentCwd)
+                continue;
+            const entrypoint = meta["entrypoint"];
+            const processId = meta["processId"] ?? "";
+            const isBareRun = entrypoint?.importPath === "bare-run";
+            return {
+                runId,
+                runDir: path.join(runsDir, runId),
+                processId,
+                isBareRun,
+                entrypoint: { importPath: entrypoint?.importPath ?? "", exportName: entrypoint?.exportName },
+            };
         }
     }
     catch { /* no runs dir */ }

package/dist/cli/commands/plugin/marketplaceCommands.js

@@ -86,14 +86,14 @@ async function handlePluginUpdateMarketplace(args) {
 async function handlePluginListPlugins(args) {
     const { scope, json } = args;
     let { marketplaceName } = args;
-    if (!(0, shared_1.requireScope)(scope, 'plugin:list-plugins', json)) {
+    if (!(0, shared_1.requireScope)(scope, 'plugin:list-blueprints', json)) {
         return 1;
     }
     const projectDir = (0, shared_1.getProjectDir)(scope);
     if (!marketplaceName) {
         marketplaceName = await (0, shared_1.autoResolveMarketplace)(scope, projectDir) ?? undefined;
     }
-    const name = (0, shared_1.requireArg)(marketplaceName, '--marketplace-name', 'plugin:list-plugins', json);
+    const name = (0, shared_1.requireArg)(marketplaceName, '--marketplace-name', 'plugin:list-blueprints', json);
     if (!name) {
         return 1;
     }
@@ -109,6 +109,6 @@ async function handlePluginListPlugins(args) {
     }
     catch (error) {
         const message = error instanceof Error ? error.message : String(error);
-        return emitError('plugin:list-plugins', json, 'list_failed', message);
+        return emitError('plugin:list-blueprints', json, 'list_failed', message);
     }
 }

package/dist/cli/commands/runIterate.d.ts

@@ -10,6 +10,18 @@
  * The command does NOT loop - it handles exactly one iteration.
  */
 import type { EffectAction } from "../../runtime/types";
+/**
+ * Pin the active harness adapter to the harness recorded in run.json so that
+ * run:iterate honors the run's recorded harness instead of re-detecting it from
+ * the ambient environment (issue #949). Re-detection is unreliable: a run
+ * created with `--harness claude-code` could otherwise resolve a different
+ * harness (e.g. one whose caller env vars happen to be set), then hard-fail on
+ * adapter resolution. Falls through to the existing env-based detection when no
+ * harness is recorded or the recorded harness is unknown to the registry.
+ *
+ * @returns true when the active adapter was pinned to the recorded harness.
+ */
+export declare function pinActiveAdapterToRecordedHarness(harness: string | undefined): boolean;
 export interface RunIterateOptions {
     runDir: string;
     iteration?: number;

package/dist/cli/commands/runIterate.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"runIterate.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/runIterate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAMH,OAAO,KAAK,EAAE,YAAY,EAAyB,MAAM,qBAAqB,CAAC;AAe/E,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf;;;;OAIG;IACH,mBAAmB,CAAC,EAAE,MAAM,EAAE,CAAC;CAChC;AAED,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,UAAU,GAAG,SAAS,GAAG,WAAW,GAAG,QAAQ,GAAG,QAAQ,GAAG,MAAM,CAAC;IAC5E,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,YAAY,EAAE,CAAC;IAC7B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,+FAA+F;IAC/F,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,EAAE,CAAC,CAAC;IAChD,8FAA8F;IAC9F,wBAAwB,CAAC,EAAE;QACzB,QAAQ,EAAE,YAAY,EAAE,CAAC;QACzB,UAAU,EAAE,YAAY,EAAE,CAAC;KAC5B,CAAC;IACF,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,QAAQ,CAAC,EAAE;QACT,KAAK,EAAE,MAAM,CAAC;QACd,SAAS,EAAE,MAAM,CAAC;QAClB,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB,CAAC;CACH;AAED,wBAAsB,UAAU,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAkQtF"}
+{"version":3,"file":"runIterate.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/runIterate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAMH,OAAO,KAAK,EAAE,YAAY,EAAyB,MAAM,qBAAqB,CAAC;AAgB/E;;;;;;;;;;GAUG;AACH,wBAAgB,iCAAiC,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAMtF;AAED,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf;;;;OAIG;IACH,mBAAmB,CAAC,EAAE,MAAM,EAAE,CAAC;CAChC;AAED,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,UAAU,GAAG,SAAS,GAAG,WAAW,GAAG,QAAQ,GAAG,QAAQ,GAAG,MAAM,CAAC;IAC5E,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,YAAY,EAAE,CAAC;IAC7B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,+FAA+F;IAC/F,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,EAAE,CAAC,CAAC;IAChD,8FAA8F;IAC9F,wBAAwB,CAAC,EAAE;QACzB,QAAQ,EAAE,YAAY,EAAE,CAAC;QACzB,UAAU,EAAE,YAAY,EAAE,CAAC;KAC5B,CAAC;IACF,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,QAAQ,CAAC,EAAE;QACT,KAAK,EAAE,MAAM,CAAC;QACd,SAAS,EAAE,MAAM,CAAC;QAClB,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB,CAAC;CACH;AAED,wBAAsB,UAAU,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAuQtF"}

package/dist/cli/commands/runIterate.js

@@ -11,6 +11,7 @@
  * The command does NOT loop - it handles exactly one iteration.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.pinActiveAdapterToRecordedHarness = pinActiveAdapterToRecordedHarness;
 exports.runIterate = runIterate;
 const runFiles_1 = require("../../storage/runFiles");
 const journal_1 = require("../../storage/journal");
@@ -23,11 +24,36 @@ const config_1 = require("../../config");
 const processCodeHash_1 = require("../../runtime/processCodeHash");
 const runIterateHelpers_1 = require("./runIterateHelpers");
 const externalAgentEffect_1 = require("../../harness/hooks/externalAgentEffect");
+const harness_1 = require("../../harness");
+/**
+ * Pin the active harness adapter to the harness recorded in run.json so that
+ * run:iterate honors the run's recorded harness instead of re-detecting it from
+ * the ambient environment (issue #949). Re-detection is unreliable: a run
+ * created with `--harness claude-code` could otherwise resolve a different
+ * harness (e.g. one whose caller env vars happen to be set), then hard-fail on
+ * adapter resolution. Falls through to the existing env-based detection when no
+ * harness is recorded or the recorded harness is unknown to the registry.
+ *
+ * @returns true when the active adapter was pinned to the recorded harness.
+ */
+function pinActiveAdapterToRecordedHarness(harness) {
+    if (!harness)
+        return false;
+    const adapter = (0, harness_1.getAdapterByName)(harness);
+    if (!adapter)
+        return false;
+    (0, harness_1.setAdapter)(adapter);
+    return true;
+}
 async function runIterate(options) {
     const { runDir, verbose } = options;
     // Read run metadata
     const metadata = await (0, runFiles_1.readRunMetadata)(runDir);
     const runId = metadata.runId;
+    // Honor the harness recorded at run-creation time over ambient env detection
+    // (issue #949). Without this, orchestrateIteration's lazy getAdapter() could
+    // resolve a different harness from the environment and hard-fail.
+    pinActiveAdapterToRecordedHarness(metadata.harness);
     // Determine iteration number from state cache or journal
     const iterationCount = await (0, runIterateHelpers_1.detectIterationCount)(runDir);
     const iteration = options.iteration ?? (iterationCount + 1);
@@ -60,7 +86,7 @@ async function runIterate(options) {
         runDir,
         ...(subprocessSupport ? { subprocessSupport } : {}),
     });
-    if (iterationResult.status === "waiting") {
+    if (iterationResult.status === "waiting" && (0, config_1.crossSubagentsEnabled)()) {
         const externalResolution = await (0, externalAgentEffect_1.resolveExternalAgentEffectsForRun)({
             runDir,
             workspace: projectRoot,

package/dist/cli/main/argFlagParsers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"argFlagParsers.d.ts","sourceRoot":"","sources":["../../../src/cli/main/argFlagParsers.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAG1C,KAAK,UAAU,GAAG,CAAC,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC;AA6ChF,eAAO,MAAM,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAoTnD,CAAC"}
+{"version":3,"file":"argFlagParsers.d.ts","sourceRoot":"","sources":["../../../src/cli/main/argFlagParsers.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAG1C,KAAK,UAAU,GAAG,CAAC,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC;AA6ChF,eAAO,MAAM,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAmUnD,CAAC"}

package/dist/cli/main/argFlagParsers.js

@@ -68,6 +68,14 @@ exports.FLAG_PARSERS = {
         parsed.patchEffect = expectFlagValue(args, index + 1, "--patch-effect");
         return index + 1;
     },
+    "--final-status": (parsed, args, index) => {
+        const value = expectFlagValue(args, index + 1, "--final-status").toLowerCase();
+        if (value !== "completed" && value !== "failed") {
+            throw new Error(`--final-status must be "completed" or "failed" (received: ${value})`);
+        }
+        parsed.haltFinalStatus = value;
+        return index + 1;
+    },
     "--status": (parsed, args, index) => {
         parsed.taskStatus = parseStatus(expectFlagValue(args, index + 1, "--status"));
         return index + 1;
@@ -163,6 +171,10 @@ exports.FLAG_PARSERS = {
         parsed.workspace = expectFlagValue(args, index + 1, "--workspace");
         return index + 1;
     },
+    "--tag": (parsed, args, index) => {
+        parsed.tag = expectFlagValue(args, index + 1, "--tag");
+        return index + 1;
+    },
     "--daemon-dir": (parsed, args, index) => {
         parsed.daemonDir = expectFlagValue(args, index + 1, "--daemon-dir");
         return index + 1;
@@ -324,7 +336,10 @@ exports.FLAG_PARSERS = {
         return index + 1;
     },
     "--reason": (parsed, args, index) => {
-        parsed.cancelReason = expectFlagValue(args, index + 1, "--reason");
+        const value = expectFlagValue(args, index + 1, "--reason");
+        // Shared by task:cancel (cancelReason) and run:halt (haltReason).
+        parsed.cancelReason = value;
+        parsed.haltReason = value;
         return index + 1;
     },
     "--action": (parsed, args, index) => {

package/dist/cli/main/argPositionals.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"argPositionals.d.ts","sourceRoot":"","sources":["../../../src/cli/main/argPositionals.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAE1C,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,EAAE,QAkG5E"}
+{"version":3,"file":"argPositionals.d.ts","sourceRoot":"","sources":["../../../src/cli/main/argPositionals.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAE1C,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,EAAE,QAmG5E"}

package/dist/cli/main/argPositionals.js

@@ -21,6 +21,7 @@ function applyPositionalArgs(parsed, positionals) {
         case "run:rebuild-state":
         case "run:repair-journal":
         case "run:recover-process-error":
+        case "run:halt":
             [parsed.runDirArg] = positionals;
             return;
         case "configure":

package/dist/cli/main/dispatchHarness.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dispatchHarness.d.ts","sourceRoot":"","sources":["../../../src/cli/main/dispatchHarness.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAe1C,wBAAsB,0BAA0B,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CA0DhG"}
+{"version":3,"file":"dispatchHarness.d.ts","sourceRoot":"","sources":["../../../src/cli/main/dispatchHarness.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAe1C,wBAAsB,0BAA0B,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CA2DhG"}

package/dist/cli/main/dispatchHarness.js

@@ -63,6 +63,7 @@ async function executeHarnessInfraCommand(parsed) {
             return await (0, install_1.handleHarnessInstallPlugin)({
                 harnessName: parsed.positional?.[0],
                 workspace: parsed.workspace,
+                tag: parsed.tag,
                 json: parsed.json,
                 dryRun: parsed.dryRun,
                 verbose: parsed.verbose,

package/dist/cli/main/dispatchRunSession.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dispatchRunSession.d.ts","sourceRoot":"","sources":["../../../src/cli/main/dispatchRunSession.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAqD1C,wBAAsB,wBAAwB,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAM9F"}
+{"version":3,"file":"dispatchRunSession.d.ts","sourceRoot":"","sources":["../../../src/cli/main/dispatchRunSession.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAsD1C,wBAAsB,wBAAwB,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAM9F"}

package/dist/cli/main/dispatchRunSession.js

@@ -74,6 +74,8 @@ async function executeRunTaskCommand(parsed) {
             return await (0, runCommands_1.handleRunRepairJournal)(parsed);
         case "run:recover-process-error":
             return await (0, runCommands_1.handleRunRecoverProcessError)(parsed);
+        case "run:halt":
+            return await (0, runCommands_1.handleRunHalt)(parsed);
         case "run:status":
             return await (0, runCommands_1.handleRunStatus)(parsed);
         case "run:iterate":
@@ -301,7 +303,7 @@ async function executeSupportCommand(parsed) {
                 return await (0, plugin_1.handlePluginAddMarketplace)(args);
             case "plugin:update-marketplace":
                 return await (0, plugin_1.handlePluginUpdateMarketplace)(args);
-            case "plugin:list-plugins":
+            case "plugin:list-blueprints":
                 return await (0, plugin_1.handlePluginListPlugins)(args);
             case "plugin:install":
                 return await (0, plugin_1.handlePluginInstall)(args);
@@ -325,7 +327,7 @@ function normalizeBlueprintCommand(command) {
     switch (command) {
         case "blueprints:list":
         case "blueprints:marketplace":
-            return "plugin:list-plugins";
+            return "plugin:list-blueprints";
         case "blueprints:add-marketplace":
             return "plugin:add-marketplace";
         case "blueprints:update-marketplace":
@@ -345,7 +347,7 @@ function normalizeBlueprintCommand(command) {
 }
 function toBlueprintCommand(command) {
     switch (command) {
-        case "plugin:list-plugins":
+        case "plugin:list-blueprints":
             return "blueprints:list";
         case "plugin:add-marketplace":
             return "blueprints:add-marketplace";

package/dist/cli/main/program.js

@@ -51,7 +51,7 @@ exports.HARNESS_INSTALL_COMMANDS = [
     "harness:install-plugin",
 ];
 const SHARED_VALID_COMMANDS = [
-    "run:create", "run:assign-process", "run:status", "run:iterate", "run:events", "run:rebuild-state", "run:repair-journal", "run:recover-process-error",
+    "run:create", "run:assign-process", "run:status", "run:iterate", "run:events", "run:rebuild-state", "run:repair-journal", "run:recover-process-error", "run:halt",
     "task:post", "task:cancel", "task:list", "task:show",
     "log", "hook:log", "hook:run", "skill:discover", "skill:fetch-remote",
     "process-library:clone", "process-library:update", "process-library:use", "process-library:active",
@@ -60,7 +60,7 @@ const SHARED_VALID_COMMANDS = [
     "blueprints:list-installed", "blueprints:marketplace", "blueprints:add-marketplace", "blueprints:update-marketplace",
     "blueprints:update-registry", "blueprints:remove-from-registry",
     "plugin:install", "plugin:uninstall", "plugin:update", "plugin:configure", "plugin:list-installed",
-    "plugin:list-plugins", "plugin:add-marketplace", "plugin:update-marketplace", "plugin:update-registry",
+    "plugin:list-blueprints", "plugin:add-marketplace", "plugin:update-marketplace", "plugin:update-registry",
     "plugin:remove-from-registry", "instructions:babysit-skill", "instructions:process-create", "instructions:orchestrate",
     "instructions:breakpoint-handling", "health", "configure", "tokens:stats", "compression:status", "compression:toggle",
     "compression:set", "compression:reset", "compress-output", "breakpoint:approve-rule", "breakpoint:remove-rule",

package/dist/cli/main/runCommands.d.ts

@@ -1,4 +1,4 @@
-export { handleRunCreate, handleRunRebuildState, handleRunRecoverProcessError, handleRunRepairJournal, } from "./runCreate";
+export { handleRunCreate, handleRunRebuildState, handleRunRecoverProcessError, handleRunRepairJournal, handleRunHalt, } from "./runCreate";
 export { handleRunAssignProcess } from "./runAssignProcess";
 export { handleRunEvents, handleRunIterate, handleRunStatus } from "./runInspection";
 //# sourceMappingURL=runCommands.d.ts.map

package/dist/cli/main/runCommands.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"runCommands.d.ts","sourceRoot":"","sources":["../../../src/cli/main/runCommands.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,eAAe,EACf,qBAAqB,EACrB,4BAA4B,EAC5B,sBAAsB,GACvB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAC5D,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC"}
+{"version":3,"file":"runCommands.d.ts","sourceRoot":"","sources":["../../../src/cli/main/runCommands.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,eAAe,EACf,qBAAqB,EACrB,4BAA4B,EAC5B,sBAAsB,EACtB,aAAa,GACd,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAC5D,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/cli/main/runCommands.js

@@ -1,11 +1,12 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.handleRunStatus = exports.handleRunIterate = exports.handleRunEvents = exports.handleRunAssignProcess = exports.handleRunRepairJournal = exports.handleRunRecoverProcessError = exports.handleRunRebuildState = exports.handleRunCreate = void 0;
+exports.handleRunStatus = exports.handleRunIterate = exports.handleRunEvents = exports.handleRunAssignProcess = exports.handleRunHalt = exports.handleRunRepairJournal = exports.handleRunRecoverProcessError = exports.handleRunRebuildState = exports.handleRunCreate = void 0;
 var runCreate_1 = require("./runCreate");
 Object.defineProperty(exports, "handleRunCreate", { enumerable: true, get: function () { return runCreate_1.handleRunCreate; } });
 Object.defineProperty(exports, "handleRunRebuildState", { enumerable: true, get: function () { return runCreate_1.handleRunRebuildState; } });
 Object.defineProperty(exports, "handleRunRecoverProcessError", { enumerable: true, get: function () { return runCreate_1.handleRunRecoverProcessError; } });
 Object.defineProperty(exports, "handleRunRepairJournal", { enumerable: true, get: function () { return runCreate_1.handleRunRepairJournal; } });
+Object.defineProperty(exports, "handleRunHalt", { enumerable: true, get: function () { return runCreate_1.handleRunHalt; } });
 var runAssignProcess_1 = require("./runAssignProcess");
 Object.defineProperty(exports, "handleRunAssignProcess", { enumerable: true, get: function () { return runAssignProcess_1.handleRunAssignProcess; } });
 var runInspection_1 = require("./runInspection");

package/dist/cli/main/runCreate.d.ts

@@ -3,4 +3,14 @@ export declare function handleRunCreate(parsed: ParsedArgs): Promise<number>;
 export declare function handleRunRebuildState(parsed: ParsedArgs): Promise<number>;
 export declare function handleRunRepairJournal(parsed: ParsedArgs): Promise<number>;
 export declare function handleRunRecoverProcessError(parsed: ParsedArgs): Promise<number>;
+/**
+ * run:halt — operator-driven seal of a divergent run.
+ *
+ * Writes a synthetic terminal event (RUN_COMPLETED or RUN_FAILED) with the
+ * correct seq + ulid, copies the completionProof from run.json, records the
+ * --reason for audit (manual_seal_reason), and rebuilds the state cache so the
+ * run reaches a clean terminal state without hand-crafting journal files.
+ * See issue #880.
+ */
+export declare function handleRunHalt(parsed: ParsedArgs): Promise<number>;
 //# sourceMappingURL=runCreate.d.ts.map

package/dist/cli/main/runCreate.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"runCreate.d.ts","sourceRoot":"","sources":["../../../src/cli/main/runCreate.ts"],"names":[],"mappings":"AA+BA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAG1C,wBAAsB,eAAe,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,CA0NzE;AA2BD,wBAAsB,qBAAqB,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,CAmC/E;AAED,wBAAsB,sBAAsB,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,CAiGhF;AAED,wBAAsB,4BAA4B,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,CAiFtF"}
+{"version":3,"file":"runCreate.d.ts","sourceRoot":"","sources":["../../../src/cli/main/runCreate.ts"],"names":[],"mappings":"AA+BA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAG1C,wBAAsB,eAAe,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,CA0NzE;AA2BD,wBAAsB,qBAAqB,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,CAmC/E;AAED,wBAAsB,sBAAsB,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,CAiGhF;AAED,wBAAsB,4BAA4B,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,CAiFtF;AAID;;;;;;;;GAQG;AACH,wBAAsB,aAAa,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,CAgFvE"}

package/dist/cli/main/runCreate.js

@@ -37,6 +37,7 @@ exports.handleRunCreate = handleRunCreate;
 exports.handleRunRebuildState = handleRunRebuildState;
 exports.handleRunRepairJournal = handleRunRepairJournal;
 exports.handleRunRecoverProcessError = handleRunRecoverProcessError;
+exports.handleRunHalt = handleRunHalt;
 const crypto = __importStar(require("node:crypto"));
 const node_fs_1 = require("node:fs");
 const path = __importStar(require("node:path"));
@@ -496,6 +497,98 @@ async function handleRunRecoverProcessError(parsed) {
     }
     return 0;
 }
+const TERMINAL_EVENT_TYPES = new Set(["RUN_COMPLETED", "RUN_FAILED", "RUN_HALTED"]);
+/**
+ * run:halt — operator-driven seal of a divergent run.
+ *
+ * Writes a synthetic terminal event (RUN_COMPLETED or RUN_FAILED) with the
+ * correct seq + ulid, copies the completionProof from run.json, records the
+ * --reason for audit (manual_seal_reason), and rebuilds the state cache so the
+ * run reaches a clean terminal state without hand-crafting journal files.
+ * See issue #880.
+ */
+async function handleRunHalt(parsed) {
+    if (!parsed.runDirArg) {
+        console.error(usage_1.USAGE);
+        return 1;
+    }
+    const runDir = (0, args_1.resolveRunDir)(parsed.runsDir, parsed.runDirArg);
+    const reason = parsed.haltReason ?? "manual_halt";
+    const finalStatus = parsed.haltFinalStatus ?? "completed";
+    const eventType = finalStatus === "completed" ? "RUN_COMPLETED" : "RUN_FAILED";
+    (0, runSupport_1.logVerbose)("run:halt", parsed, { runDir, reason, finalStatus, dryRun: parsed.dryRun, json: parsed.json });
+    const metadata = await (0, runState_1.readRunMetadataSafe)(runDir, "run:halt");
+    if (!metadata)
+        return 1;
+    const completionProof = typeof metadata.completionProof === "string" ? metadata.completionProof : null;
+    // Detect whether the run is already sealed (audit only — halting is a
+    // deliberate operator override, so an existing terminal event does not block).
+    let alreadyTerminal = null;
+    try {
+        const events = await (0, journal_1.loadJournal)(runDir);
+        for (let i = events.length - 1; i >= 0; i -= 1) {
+            if (TERMINAL_EVENT_TYPES.has(events[i].type)) {
+                alreadyTerminal = events[i].type;
+                break;
+            }
+        }
+    }
+    catch {
+        // No/again-unreadable journal — proceed; appendEvent will create it.
+    }
+    if (parsed.dryRun) {
+        const plan = { dryRun: true, runDir, plan: "halt_run", eventType, finalStatus, reason, completionProof, alreadyTerminal };
+        if (parsed.json) {
+            console.log(JSON.stringify(plan, null, 2));
+        }
+        else {
+            console.log(`[run:halt] dry-run runDir=${runDir} eventType=${eventType} reason=${reason}` + (alreadyTerminal ? ` (already ${alreadyTerminal})` : ""));
+        }
+        return 0;
+    }
+    try {
+        const eventData = { manual_seal_reason: reason, completionProof };
+        if (finalStatus === "failed") {
+            eventData.error = { name: "ManualHalt", message: reason };
+        }
+        const appended = await (0, journal_1.appendEvent)({ runDir, eventType, event: eventData });
+        const snapshot = await (0, stateCache_1.rebuildStateCache)(runDir, { reason: "manual_halt" });
+        const metadataOut = {
+            pendingEffectsByKind: snapshot.pendingEffectsByKind,
+            stateVersion: snapshot.stateVersion,
+            journalHead: snapshot.journalHead ?? null,
+            stateRebuilt: true,
+            stateRebuildReason: snapshot.rebuildReason ?? undefined,
+        };
+        const formatted = (0, runState_1.formatIterationMetadata)(metadataOut);
+        const summary = {
+            runDir,
+            halted: true,
+            finalStatus,
+            reason,
+            completionProof,
+            alreadyTerminal,
+            event: { seq: appended.seq, ulid: appended.ulid, type: eventType, recordedAt: appended.recordedAt },
+            metadata: formatted.jsonMetadata ?? null,
+        };
+        if (parsed.json) {
+            console.log(JSON.stringify(summary, null, 2));
+        }
+        else {
+            const suffix = formatted.textParts.length ? ` ${formatted.textParts.join(" ")}` : "";
+            console.log(`[run:halt] halted runDir=${runDir} finalStatus=${finalStatus} seq=${appended.seq} reason=${reason}${suffix}`);
+        }
+        return 0;
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        console.error(`[run:halt] ${message}`);
+        if (parsed.json) {
+            console.log(JSON.stringify({ error: "HALT_FAILED", message }, null, 2));
+        }
+        return 1;
+    }
+}
 function findLatestProcessRuntimeError(events) {
     for (let index = events.length - 1; index >= 0; index -= 1) {
         if (events[index].type === "PROCESS_RUNTIME_ERROR")

package/dist/cli/main/taskCommands.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"taskCommands.d.ts","sourceRoot":"","sources":["../../../src/cli/main/taskCommands.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAqF1C,wBAAsB,cAAc,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,CAwIxE;AAED,wBAAsB,gBAAgB,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,CA4B1E;AAED,wBAAsB,cAAc,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,CAiCxE;AAED,wBAAsB,cAAc,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,CAoDxE"}
+{"version":3,"file":"taskCommands.d.ts","sourceRoot":"","sources":["../../../src/cli/main/taskCommands.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAqH1C,wBAAsB,cAAc,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,CAwIxE;AAED,wBAAsB,gBAAgB,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,CA4B1E;AAED,wBAAsB,cAAc,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,CAiCxE;AAED,wBAAsB,cAAc,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,CAoDxE"}

package/dist/cli/main/taskCommands.js

@@ -95,6 +95,40 @@ async function readJsonFile(runDir, filename) {
     const trimmed = raw.trim();
     return trimmed.length ? JSON.parse(trimmed) : undefined;
 }
+/**
+ * Read the `--error` file for `task:post --status error`.
+ *
+ * #936: callers (notably genty's in-process DefaultOrchestrationProvider) may
+ * write a bare, NON-JSON error string (e.g. `Error: Effect failed`) into this
+ * file. JSON.parsing it unguarded produced the cryptic
+ *   `Unexpected token 'E', "Error: Effect failed" is not valid JSON`
+ * SyntaxError categorized as an internal "please report as a bug" failure, and
+ * — because the post then exited non-zero — spun the orchestration loop to its
+ * 80-minute timeout. Here we tolerate a plain-text error: if the file is not
+ * valid JSON, wrap it as a structured `{ name, message }` error payload so the
+ * failure surfaces the real message and the run can fail promptly. Valid JSON
+ * (a structured error) still round-trips unchanged.
+ */
+async function readErrorFile(runDir, filename) {
+    if (!filename)
+        return undefined;
+    const raw = filename === "-"
+        ? await (0, runSupport_1.readStdinUtf8)()
+        : await node_fs_1.promises.readFile(resolveMaybeRunRelative(runDir, filename), "utf8");
+    const trimmed = raw.trim();
+    if (!trimmed.length)
+        return undefined;
+    try {
+        return JSON.parse(trimmed);
+    }
+    catch {
+        // Not JSON — treat the file contents as the error message itself. Strip a
+        // leading "Error: " prefix (the result of String(new Error(message))) so
+        // the surfaced message is the underlying failure, not doubled.
+        const message = trimmed.replace(/^Error:\s*/, "");
+        return { name: "Error", message };
+    }
+}
 function readInlineJson(raw) {
     if (!raw)
         return undefined;
@@ -164,7 +198,7 @@ async function handleTaskPost(parsed) {
     const stdout = parsed.stdoutFile ? await readTextFile(runDir, parsed.stdoutFile) : undefined;
     const stderr = parsed.stderrFile ? await readTextFile(runDir, parsed.stderrFile) : undefined;
     const errorPayload = parsed.taskStatus === "error"
-        ? (await readJsonFile(runDir, parsed.errorPath)) ?? { name: "Error", message: "Task reported failure" }
+        ? (await readErrorFile(runDir, parsed.errorPath)) ?? { name: "Error", message: "Task reported failure" }
         : undefined;
     const value = parsed.taskStatus === "ok"
         ? parsed.valueInline

package/dist/cli/main/types.d.ts

@@ -89,6 +89,7 @@ export interface ParsedArgs {
     costRunId?: string;
     positional?: string[];
     workspace?: string;
+    tag?: string;
     model?: string;
     interactive?: boolean;
     retrospectAll?: boolean;
@@ -104,6 +105,8 @@ export interface ParsedArgs {
     breakpointExpert?: string;
     cancelReason?: string;
     patchEffect?: string;
+    haltReason?: string;
+    haltFinalStatus?: "completed" | "failed";
     verbosity?: string;
     tuiFlag?: boolean;
     daemonDir?: string;

package/dist/cli/main/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/cli/main/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/cli/main/types.ts"],"names":[],"mappings":"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"}

package/dist/cli/main/usage.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"usage.d.ts","sourceRoot":"","sources":["../../../src/cli/main/usage.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAC3C,OAAO,EAAgB,KAAK,UAAU,EAAE,MAAM,WAAW,CAAC;AA8I1D,wBAAgB,WAAW,CAAC,OAAO,EAAE,WAAW,EAAE,OAAO,GAAE,UAAyB,GAAG,MAAM,CAa5F;AAED,eAAO,MAAM,WAAW,QAAqC,CAAC;AAC9D,eAAO,MAAM,WAAW,QAAqC,CAAC;AAC9D,eAAO,MAAM,KAAK,QAAc,CAAC"}
+{"version":3,"file":"usage.d.ts","sourceRoot":"","sources":["../../../src/cli/main/usage.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAC3C,OAAO,EAAgB,KAAK,UAAU,EAAE,MAAM,WAAW,CAAC;AA+I1D,wBAAgB,WAAW,CAAC,OAAO,EAAE,WAAW,EAAE,OAAO,GAAE,UAAyB,GAAG,MAAM,CAa5F;AAED,eAAO,MAAM,WAAW,QAAqC,CAAC;AAC9D,eAAO,MAAM,WAAW,QAAqC,CAAC;AAC9D,eAAO,MAAM,KAAK,QAAc,CAAC"}

package/dist/cli/main/usage.js

@@ -11,6 +11,7 @@ function coreAgentUsage(commandName) {
   ${commandName} run:rebuild-state <runDir> [--json] [--dry-run]
   ${commandName} run:repair-journal <runDir> [--json] [--dry-run]
   ${commandName} run:recover-process-error <runDir> [--patch-effect <effectId>:<jsonPath>=<json>] [--json] [--dry-run]
+  ${commandName} run:halt <runDir> [--reason <text>] [--final-status completed|failed] [--json] [--dry-run]
   ${commandName} run:iterate <runDir> [--json] [--verbose] [--iteration <n>]
   ${commandName} task:post <runDir> <effectId> --status <ok|error> [--json] [--dry-run] [--value <file>] [--value-inline <json>] [--error <file>] [--stdout-ref <ref>] [--stderr-ref <ref>] [--stdout-file <file>] [--stderr-file <file>] [--started-at <iso8601>] [--finished-at <iso8601>] [--metadata <file>] [--invocation-key <key>]
   ${commandName} task:list <runDir> [--pending] [--kind <kind>] [--json]
@@ -33,7 +34,7 @@ function coreAgentUsage(commandName) {
   ${commandName} profile:render --user|--project [--dir <dir>] [--json]
   ${commandName} instructions:babysit-skill [--harness <name>] [--interactive|--no-interactive] [--json]
   ${commandName} harness:install <name> [--workspace <dir>] [--json] [--dry-run] [--verbose]
-  ${commandName} harness:install-plugin <name> [--workspace <dir>] [--json] [--dry-run] [--verbose]`;
+  ${commandName} harness:install-plugin <name> [--workspace <dir>] [--tag <dist-tag>] [--json] [--dry-run] [--verbose]`;
 }
 function coreHumanUsage(commandName) {
     return `  ${commandName} log --type <process|hook|cli> --message <msg> [--run-id <id>] [--label <label>] [--level <level>] [--source <src>] [--json]
@@ -64,14 +65,14 @@ function coreHumanUsage(commandName) {
   ${commandName} blueprints:update-marketplace --marketplace-name <name> [--marketplace-branch <ref>] [--global|--project] [--json] [--verbose]
   ${commandName} blueprints:update-registry [<name>] [--plugin-name <name>] [--plugin-version <ver>] [--global|--project] [--json] [--verbose]
   ${commandName} blueprints:remove-from-registry [<name>] [--plugin-name <name>] [--global|--project] [--json] [--verbose]
-  Deprecated aliases: plugin:install, plugin:uninstall, plugin:update, plugin:configure, plugin:list-installed, plugin:list-plugins, plugin:add-marketplace, plugin:update-marketplace, plugin:update-registry, plugin:remove-from-registry.
+  Deprecated aliases: plugin:install, plugin:uninstall, plugin:update, plugin:configure, plugin:list-installed, plugin:list-blueprints, plugin:add-marketplace, plugin:update-marketplace, plugin:update-registry, plugin:remove-from-registry.
   ${commandName} tokens:stats [runId] [--all] [--json]
   ${commandName} compression:status [--json]
   ${commandName} compression:toggle <layer> <on|off> [--json]
   ${commandName} compression:set <layer.key> <value> [--json]
   ${commandName} compression:reset [--json]
   ${commandName} harness:install <name> [--workspace <dir>] [--json] [--dry-run] [--verbose]
-  ${commandName} harness:install-plugin <name> [--workspace <dir>] [--json] [--dry-run] [--verbose]
+  ${commandName} harness:install-plugin <name> [--workspace <dir>] [--tag <dist-tag>] [--json] [--dry-run] [--verbose]
   ${commandName} instructions:process-create [--harness <name>] [--interactive|--no-interactive] [--json]
   ${commandName} instructions:orchestrate [--harness <name>] [--interactive|--no-interactive] [--json]
   ${commandName} instructions:breakpoint-handling [--harness <name>] [--interactive|--no-interactive] [--json]

package/dist/config/envContract.d.ts

@@ -61,6 +61,18 @@ export declare const ENV_VAR_CONTRACTS: {
             readonly scope: "external-input";
             readonly description: "Overrides node task timeout at process startup.";
         };
+        readonly crossSubagents: {
+            readonly name: "BABYSITTER_CROSS_SUBAGENTS";
+            readonly valueType: "boolean";
+            readonly scope: "external-input";
+            readonly description: "Enables cross-harness agent/skill auto-dispatch (default OFF).";
+        };
+        readonly executeTasks: {
+            readonly name: "BABYSITTER_EXECUTE_TASKS";
+            readonly valueType: "boolean";
+            readonly scope: "external-input";
+            readonly description: "Enables shell/node task auto-execution (default OFF).";
+        };
     };
     readonly azureOpenAi: {
         readonly apiKey: {