@a5c-ai/babysitter-sdk 5.0.1-staging.ff2c19f9 → 5.0.1-staging.ffad3b46492e

package/README.md

@@ -0,0 +1,68 @@
+# @a5c-ai/babysitter-sdk
+
+Core runtime, storage, task, plugin, MCP, and CLI primitives for Babysitter.
+
+## Install
+
+```bash
+npm install @a5c-ai/babysitter-sdk
+```
+
+Optional breakpoint routing support:
+
+```bash
+npm install @a5c-ai/tasks-mux
+```
+
+This package ships the built runtime in `dist/`, bundled command/skill templates in `skills/`, and this package README for npm auditability.
+
+## CLI Surface
+
+The package exposes three binaries:
+
+```bash
+npx @a5c-ai/babysitter-sdk babysitter --help
+npx @a5c-ai/babysitter-sdk babysitter-sdk --help
+npx @a5c-ai/babysitter-sdk babysitter-mcp-server --help
+```
+
+`babysitter` and `babysitter-sdk` point at the same CLI entrypoint. The public command groups currently include:
+
+- `run:*`, `task:*`, and `session:*` for run orchestration and task result posting
+- `skill:*`, `harness:*`, and `plugin:*` for discovery, installation, and registry flows
+- `process-library:*`, `profile:*`, and `instructions:*` for library/profile management and generated guidance
+- `tokens:*`, `compression:*`, `log`, `hook:*`, `health`, `configure`, and `version` for operator workflows
+
+The optional interactive runtime commands such as `create-run`, `resume-run`, `plan`, `yolo`, `observe`, and `tui` live in the separate `@a5c-ai/agent-platform` package.
+
+## API Surface
+
+```ts
+import {
+  createRun,
+  defineTask,
+  createBabysitterMcpServer,
+} from "@a5c-ai/babysitter-sdk";
+```
+
+The root export surface currently re-exports these modules:
+
+- runtime, runtime types, storage, storage types, tasks, testing
+- CLI arg parsing helpers and command entrypoint helpers
+- hooks, harness, breakpoints, MCP, plugins, prompts, logging, cost, config, profiles
+- session helpers, process-library helpers, and compression utilities
+
+## Validation
+
+```bash
+npm run lint --workspace=@a5c-ai/babysitter-sdk
+npm run build --workspace=@a5c-ai/babysitter-sdk
+npm run test --workspace=@a5c-ai/babysitter-sdk
+npm run smoke:cli --workspace=@a5c-ai/babysitter-sdk
+npm run verify:metadata
+npm pack --json --dry-run --workspace=@a5c-ai/babysitter-sdk
+```
+
+## Release Expectations
+
+`@a5c-ai/babysitter-sdk` is a centrally released public package. Keep this README aligned with the actual CLI/API surface, keep `package.json#files` aligned with what ships, and verify the dry-run tarball before changing release-facing behavior.

package/dist/breakpoints/evaluator.js

@@ -15,7 +15,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.evaluateAutoApproval = evaluateAutoApproval;
 const patterns_1 = require("./patterns");
 // ---------------------------------------------------------------------------
-// Inlined posture helpers (canonical implementation moved to babysitter-harness)
+// Inlined posture helpers (canonical implementation moved to agent-platform)
 // ---------------------------------------------------------------------------
 const DEFAULT_POSTURES = {
     read: { name: 'permissive', allowAutoApprove: true, minConsecutiveApprovalsForAutoN: 0, requireExplicitRule: false, requiredApproverLevel: 'any' },

package/dist/breakpoints/proven-verification.d.ts

@@ -1,8 +1,8 @@
 /**
- * Optional integration with @a5c-ai/breakpoints-mux proven subsystem.
+ * Optional integration with @a5c-ai/tasks-mux proven subsystem.
  *
  * Provides cryptographic verification of breakpoint answers when the
- * breakpoints-mux package is available as an optional peer dependency.
+ * tasks-mux package is available as an optional peer dependency.
  * Never throws -- always returns a graceful result.
  */
 /**
@@ -11,7 +11,7 @@
 export interface BreakpointVerificationConfig {
     /** Whether verification is enabled. When false, verification is skipped. */
     enabled: boolean;
-    /** Directory containing trusted public keys. Passed to breakpoints-mux verifyAnswer. */
+    /** Directory containing trusted public keys. Passed to tasks-mux verifyAnswer. */
     trustedKeysDir?: string;
 }
 /**
@@ -20,7 +20,7 @@ export interface BreakpointVerificationConfig {
 export interface BreakpointVerificationResult {
     /** Whether the answer was successfully verified as authentic. */
     verified: boolean;
-    /** Detailed verification result from breakpoints-mux (when available). */
+    /** Detailed verification result from tasks-mux (when available). */
     verificationResult?: {
         valid: boolean;
         publicKeyFingerprint?: string;
@@ -38,9 +38,9 @@ export interface BreakpointVerificationResult {
 export declare function hasSignatureFields(result: Record<string, unknown>): boolean;
 /**
  * Verify a breakpoint result's cryptographic signature using the
- * breakpoints-mux proven subsystem.
+ * tasks-mux proven subsystem.
  *
- * This function never throws. If breakpoints-mux is not installed,
+ * This function never throws. If tasks-mux is not installed,
  * verification is disabled, or the result is unsigned, it returns
  * a graceful { verified: false } result with an explanatory reason.
  *

package/dist/breakpoints/proven-verification.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"proven-verification.d.ts","sourceRoot":"","sources":["../../src/breakpoints/proven-verification.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;GAEG;AACH,MAAM,WAAW,4BAA4B;IAC3C,4EAA4E;IAC5E,OAAO,EAAE,OAAO,CAAC;IACjB,wFAAwF;IACxF,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,4BAA4B;IAC3C,iEAAiE;IACjE,QAAQ,EAAE,OAAO,CAAC;IAClB,0EAA0E;IAC1E,kBAAkB,CAAC,EAAE;QACnB,KAAK,EAAE,OAAO,CAAC;QACf,oBAAoB,CAAC,EAAE,MAAM,CAAC;QAC9B,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC;IACF,0EAA0E;IAC1E,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAaD;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAI3E;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,sBAAsB,CAC1C,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,MAAM,CAAC,EAAE,4BAA4B,GACpC,OAAO,CAAC,4BAA4B,CAAC,CAuEvC"}
+{"version":3,"file":"proven-verification.d.ts","sourceRoot":"","sources":["../../src/breakpoints/proven-verification.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;GAEG;AACH,MAAM,WAAW,4BAA4B;IAC3C,4EAA4E;IAC5E,OAAO,EAAE,OAAO,CAAC;IACjB,kFAAkF;IAClF,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,4BAA4B;IAC3C,iEAAiE;IACjE,QAAQ,EAAE,OAAO,CAAC;IAClB,oEAAoE;IACpE,kBAAkB,CAAC,EAAE;QACnB,KAAK,EAAE,OAAO,CAAC;QACf,oBAAoB,CAAC,EAAE,MAAM,CAAC;QAC9B,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC;IACF,0EAA0E;IAC1E,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAaD;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAI3E;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,sBAAsB,CAC1C,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,MAAM,CAAC,EAAE,4BAA4B,GACpC,OAAO,CAAC,4BAA4B,CAAC,CAuEvC"}

package/dist/breakpoints/proven-verification.js

@@ -1,9 +1,9 @@
 "use strict";
 /**
- * Optional integration with @a5c-ai/breakpoints-mux proven subsystem.
+ * Optional integration with @a5c-ai/tasks-mux proven subsystem.
  *
  * Provides cryptographic verification of breakpoint answers when the
- * breakpoints-mux package is available as an optional peer dependency.
+ * tasks-mux package is available as an optional peer dependency.
  * Never throws -- always returns a graceful result.
  */
 var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
@@ -61,9 +61,9 @@ function hasSignatureFields(result) {
 }
 /**
  * Verify a breakpoint result's cryptographic signature using the
- * breakpoints-mux proven subsystem.
+ * tasks-mux proven subsystem.
  *
- * This function never throws. If breakpoints-mux is not installed,
+ * This function never throws. If tasks-mux is not installed,
  * verification is disabled, or the result is unsigned, it returns
  * a graceful { verified: false } result with an explanatory reason.
  *
@@ -80,18 +80,18 @@ async function verifyBreakpointResult(result, config) {
     if (!hasSignatureFields(result)) {
         return { verified: false, reason: "result is not signed" };
     }
-    // Attempt to dynamically import breakpoints-mux proven subsystem.
+    // Attempt to dynamically import tasks-mux proven subsystem.
     // The module is an optional peer dependency -- the import may fail at runtime.
     // We use a string variable to prevent TypeScript from statically resolving the import.
     try {
-        const modulePath = "@a5c-ai/breakpoints-mux/proven";
+        const modulePath = "@a5c-ai/tasks-mux/proven";
         // eslint-disable-next-line @typescript-eslint/no-var-requires
         const proven = await Promise.resolve(`${modulePath}`).then(s => __importStar(require(s)));
         const { verifyAnswer } = proven;
         if (typeof verifyAnswer !== "function") {
             return {
                 verified: false,
-                reason: "breakpoints-mux/proven does not export verifyAnswer",
+                reason: "tasks-mux/proven does not export verifyAnswer",
             };
         }
         const verificationResult = await verifyAnswer(result, effectiveConfig.trustedKeysDir);
@@ -101,7 +101,7 @@ async function verifyBreakpointResult(result, config) {
         };
     }
     catch (err) {
-        // Dynamic import failed -- breakpoints-mux is not installed or broken
+        // Dynamic import failed -- tasks-mux is not installed or broken
         const message = err instanceof Error ? err.message : String(err);
         if (message.includes("Cannot find module") ||
             message.includes("MODULE_NOT_FOUND") ||
@@ -109,7 +109,7 @@ async function verifyBreakpointResult(result, config) {
             message.includes("Could not resolve")) {
             return {
                 verified: false,
-                reason: "breakpoints-mux not installed",
+                reason: "tasks-mux not installed",
             };
         }
         return {

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

@@ -1 +1 @@
-{"version":3,"file":"breakpointRules.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/breakpointRules.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAOH,MAAM,WAAW,qBAAqB;IACpC,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,OAAO,CAAC;CACf;AAED,wBAAsB,uBAAuB,CAAC,IAAI,EAAE,qBAAqB,GAAG,OAAO,CAAC,MAAM,CAAC,CAgB1F"}
+{"version":3,"file":"breakpointRules.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/breakpointRules.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAQH,MAAM,WAAW,qBAAqB;IACpC,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,OAAO,CAAC;CACf;AAED,wBAAsB,uBAAuB,CAAC,IAAI,EAAE,qBAAqB,GAAG,OAAO,CAAC,MAAM,CAAC,CAgB1F"}

package/dist/cli/commands/breakpointRules.js

@@ -45,6 +45,7 @@ var __importStar = (this && this.__importStar) || (function () {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.handleBreakpointCommand = handleBreakpointCommand;
 const crypto = __importStar(require("node:crypto"));
+const config_1 = require("../../config");
 const rules_1 = require("../../breakpoints/rules");
 const evaluator_1 = require("../../breakpoints/evaluator");
 async function handleBreakpointCommand(args) {
@@ -159,41 +160,43 @@ async function handleHistory(args) {
     // Scan journal directories for breakpoint EFFECT_RESOLVED events
     const { promises: fs } = await Promise.resolve().then(() => __importStar(require("node:fs")));
     const path = await Promise.resolve().then(() => __importStar(require("node:path")));
-    const runsDir = args.runsDir ?? ".a5c/runs";
+    const runsDir = args.runsDir ?? (0, config_1.resolveRunsDir)();
     const limit = args.limit ?? 50;
     const entries = [];
     try {
-        const runDirs = await fs.readdir(runsDir);
-        for (const runId of runDirs.slice(-limit * 2)) {
-            const journalDir = path.join(runsDir, runId, "journal");
-            let journalFiles;
-            try {
-                journalFiles = await fs.readdir(journalDir);
-            }
-            catch {
-                continue;
-            }
-            for (const jf of journalFiles) {
+        for (const candidateRunsDir of (0, config_1.getReadableRunsDirs)({ override: runsDir })) {
+            const runDirs = await fs.readdir(candidateRunsDir).catch(() => []);
+            for (const runId of runDirs.slice(-limit * 2)) {
+                const journalDir = path.join(candidateRunsDir, runId, "journal");
+                let journalFiles;
                 try {
-                    const raw = await fs.readFile(path.join(journalDir, jf), "utf-8");
-                    const event = JSON.parse(raw);
-                    const data = event.data;
-                    if (event.type === "EFFECT_RESOLVED" && data?.breakpointId) {
-                        const bpId = data.breakpointId;
-                        if (args.breakpointId && bpId !== args.breakpointId)
-                            continue;
-                        entries.push({
-                            runId,
-                            breakpointId: bpId,
-                            effectId: data.effectId,
-                            status: data.status,
-                            resolvedAt: event.recordedAt,
-                        });
-                    }
+                    journalFiles = await fs.readdir(journalDir);
                 }
                 catch {
                     continue;
                 }
+                for (const jf of journalFiles) {
+                    try {
+                        const raw = await fs.readFile(path.join(journalDir, jf), "utf-8");
+                        const event = JSON.parse(raw);
+                        const data = event.data;
+                        if (event.type === "EFFECT_RESOLVED" && data?.breakpointId) {
+                            const bpId = data.breakpointId;
+                            if (args.breakpointId && bpId !== args.breakpointId)
+                                continue;
+                            entries.push({
+                                runId,
+                                breakpointId: bpId,
+                                effectId: data.effectId,
+                                status: data.status,
+                                resolvedAt: event.recordedAt,
+                            });
+                        }
+                    }
+                    catch {
+                        continue;
+                    }
+                }
             }
         }
     }

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

@@ -1 +1 @@
-{"version":3,"file":"compressOutputHelpers.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/compressOutputHelpers.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,MAAM,MAAM,aAAa,GAAG,KAAK,GAAG,IAAI,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;AAChF,MAAM,MAAM,aAAa,GACrB,MAAM,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,KAAK,GAAG,QAAQ,GACrD,MAAM,GAAG,MAAM,GAAG,QAAQ,GAAG,OAAO,GAAG,OAAO,GAAG,UAAU,GAAG,SAAS,CAAC;AAU5E,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,aAAa,CAQlE;AAMD,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,aAAa,CASlE;AAoED,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,aAAa,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAWzE;AAmBD,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAmCpD;AAMD,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,SAAK,EAAE,UAAU,SAAM,GAAG,MAAM,CAkC1G;AAMD,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CA2BjD;AAmDD,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAGvE;AAMD,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,SAAM,GAAG,MAAM,CAI5D"}
+{"version":3,"file":"compressOutputHelpers.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/compressOutputHelpers.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,MAAM,MAAM,aAAa,GAAG,KAAK,GAAG,IAAI,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;AAChF,MAAM,MAAM,aAAa,GACrB,MAAM,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,KAAK,GAAG,QAAQ,GACrD,MAAM,GAAG,MAAM,GAAG,QAAQ,GAAG,OAAO,GAAG,OAAO,GAAG,UAAU,GAAG,SAAS,CAAC;AAU5E,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,aAAa,CAQlE;AAMD,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,aAAa,CASlE;AAmFD,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,aAAa,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAWzE;AAmBD,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAmCpD;AAMD,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,SAAK,EAAE,UAAU,SAAM,GAAG,MAAM,CAkC1G;AAMD,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CA2BjD;AAmDD,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAGvE;AAMD,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,SAAM,GAAG,MAAM,CAI5D"}

package/dist/cli/commands/compressOutputHelpers.js

@@ -93,17 +93,33 @@ function compactStatus(status) {
     const staged = [];
     const unstaged = [];
     const untracked = [];
+    let section = null;
     for (const line of lines) {
         if (!line.trim() || line.startsWith("On branch") || line.startsWith("HEAD"))
             continue;
+        if (line.startsWith("Changes to be committed")) {
+            section = "staged";
+            continue;
+        }
+        if (line.startsWith("Changes not staged for commit")) {
+            section = "unstaged";
+            continue;
+        }
+        if (line.startsWith("Untracked files")) {
+            section = "untracked";
+            continue;
+        }
         if (line.startsWith("\t")) {
             const name = line.trim();
-            if (line.includes("new file:") || line.includes("modified:") || line.includes("deleted:")) {
+            if (section === "staged") {
                 staged.push(name);
             }
-            else {
+            else if (section === "unstaged") {
                 unstaged.push(name);
             }
+            else if (section === "untracked") {
+                untracked.push(name);
+            }
         }
         else if (line.startsWith("?? ")) {
             untracked.push(line.slice(3));

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

@@ -1 +1 @@
-{"version":3,"file":"costStats.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/costStats.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAOH,OAAO,KAAK,EACV,gBAAgB,EAKjB,MAAM,kBAAkB,CAAC;AAwP1B,wBAAsB,eAAe,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,MAAM,CAAC,CAwChF"}
+{"version":3,"file":"costStats.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/costStats.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAOH,OAAO,KAAK,EACV,gBAAgB,EAKjB,MAAM,kBAAkB,CAAC;AAmQ1B,wBAAsB,eAAe,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,MAAM,CAAC,CAuChF"}

package/dist/cli/commands/costStats.js

@@ -46,7 +46,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.handleCostStats = handleCostStats;
 const node_fs_1 = require("node:fs");
 const path = __importStar(require("node:path"));
-const defaults_1 = require("../../config/defaults");
+const config_1 = require("../../config");
 const storage_1 = require("../../storage");
 const journal_1 = require("../../cost/journal");
 // ============================================================================
@@ -74,8 +74,8 @@ function col(text, color, useColors) {
 // ============================================================================
 // Single Run
 // ============================================================================
-async function costStatsForRun(runsDir, runId) {
-    const runDir = path.join(runsDir, runId);
+async function costStatsForRun(runId, runsDirOverride) {
+    const runDir = (0, config_1.resolveExistingRunDir)(runId, { override: runsDirOverride });
     let stat;
     try {
         stat = await node_fs_1.promises.stat(runDir);
@@ -91,30 +91,39 @@ async function costStatsForRun(runsDir, runId) {
 // ============================================================================
 // All Runs
 // ============================================================================
-async function costStatsForAllRuns(runsDir) {
-    let entries;
-    try {
-        entries = await node_fs_1.promises.readdir(runsDir);
-    }
-    catch {
-        entries = [];
-    }
+async function costStatsForAllRuns(readableRunsDirs) {
     const runs = [];
-    for (const entry of entries) {
-        const runDir = path.join(runsDir, entry);
+    const seenRunDirs = new Set();
+    for (const runsDir of readableRunsDirs) {
+        let entries;
         try {
-            const s = await node_fs_1.promises.stat(runDir);
-            if (!s.isDirectory())
-                continue;
+            entries = await node_fs_1.promises.readdir(runsDir);
         }
         catch {
-            continue;
+            entries = [];
+        }
+        for (const entry of entries) {
+            const runDir = path.join(runsDir, entry);
+            let normalizedRunDir;
+            try {
+                const s = await node_fs_1.promises.stat(runDir);
+                if (!s.isDirectory())
+                    continue;
+                normalizedRunDir = path.resolve(runDir);
+            }
+            catch {
+                continue;
+            }
+            if (seenRunDirs.has(normalizedRunDir)) {
+                continue;
+            }
+            seenRunDirs.add(normalizedRunDir);
+            const events = await (0, storage_1.loadJournal)(runDir);
+            const stats = (0, journal_1.computeRunCostStats)(entry, events);
+            if (stats.eventCount === 0)
+                continue;
+            runs.push(stats);
         }
-        const events = await (0, storage_1.loadJournal)(runDir);
-        const stats = (0, journal_1.computeRunCostStats)(entry, events);
-        if (stats.eventCount === 0)
-            continue;
-        runs.push(stats);
     }
     let totalInputTokens = 0;
     let totalOutputTokens = 0;
@@ -277,11 +286,10 @@ function printAggregateTable(agg, useColors) {
 // Main Handler
 // ============================================================================
 async function handleCostStats(options) {
-    const runsDir = options.runsDir ?? process.env[defaults_1.CONFIG_ENV_VARS.RUNS_DIR] ?? defaults_1.DEFAULTS.runsDir;
-    const resolvedRunsDir = path.resolve(runsDir);
+    const readableRunsDirs = (0, config_1.getReadableRunsDirs)({ override: options.runsDir });
     const useColors = supportsColors();
     if (options.all) {
-        const agg = await costStatsForAllRuns(resolvedRunsDir);
+        const agg = await costStatsForAllRuns(readableRunsDirs);
         if (options.json) {
             console.log(JSON.stringify(agg, null, 2));
         }
@@ -291,9 +299,9 @@ async function handleCostStats(options) {
         return 0;
     }
     if (options.runId) {
-        const stats = await costStatsForRun(resolvedRunsDir, options.runId);
+        const stats = await costStatsForRun(options.runId, options.runsDir);
         if (!stats) {
-            const msg = `Run not found: ${options.runId} (looked in ${resolvedRunsDir})`;
+            const msg = `Run not found: ${options.runId} (looked in ${readableRunsDirs.join(", ")})`;
             if (options.json) {
                 console.error(JSON.stringify({ error: msg }));
             }

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

@@ -0,0 +1,14 @@
+export interface ExistingRunInfo {
+    runId: string;
+    runDir: string;
+    processId: string;
+    isBareRun: boolean;
+    entrypoint: {
+        importPath: string;
+        exportName?: string;
+    };
+    completionProof?: string;
+}
+export declare function detectExistingRun(): Promise<ExistingRunInfo | undefined>;
+export declare function formatExistingRunBlock(existingRun: ExistingRunInfo): string;
+//# sourceMappingURL=detectExistingRun.d.ts.map

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

@@ -0,0 +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"}

package/dist/cli/commands/detectExistingRun.js

@@ -0,0 +1,89 @@
+"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.detectExistingRun = detectExistingRun;
+exports.formatExistingRunBlock = formatExistingRunBlock;
+const node_fs_1 = require("node:fs");
+const path = __importStar(require("node:path"));
+const config_1 = require("../../config");
+async function detectExistingRun() {
+    try {
+        const runsDir = (0, config_1.resolveRunsDir)();
+        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)) {
+            const runFile = path.join(runsDir, runId, "run.json");
+            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"],
+                };
+            }
+            catch {
+                continue;
+            }
+        }
+    }
+    catch { /* no runs dir */ }
+    return undefined;
+}
+function formatExistingRunBlock(existingRun) {
+    return [
+        '## Existing Run State',
+        '',
+        `- Run ID: \`${existingRun.runId}\``,
+        `- Run Dir: \`${existingRun.runDir}\``,
+        `- Process ID: \`${existingRun.processId}\``,
+        `- Bare Run: \`${existingRun.isBareRun}\``,
+        `- Entrypoint: \`${existingRun.entrypoint.importPath}${existingRun.entrypoint.exportName ? '#' + existingRun.entrypoint.exportName : ''}\``,
+        '',
+        existingRun.isBareRun
+            ? `**This is a bare run.** Use \`run:assign-process ${existingRun.runDir} --entry <path>#<export>\` to assign a process before iterating.`
+            : `This run already has a process assigned. Use \`run:iterate ${existingRun.runDir} --json\` to continue.`,
+        '',
+        '---',
+        '',
+    ].join('\n');
+}

package/dist/cli/commands/harness/install.d.ts

@@ -10,9 +10,8 @@ export declare function handleHarnessInstall(args: HarnessInstallCommandArgs): P
  * Install a babysitter plugin for a harness.
  *
  * Plugin installation remains harness-specific since it involves babysitter's
- * own plugin packaging, not general CLI installation. This delegates to the
- * babysitter plugin system rather than per-adapter install logic.
+ * own plugin packaging. This uses the published per-harness plugin installer.
  */
-export declare function handleHarnessInstallPlugin(args: HarnessInstallCommandArgs): number;
+export declare function handleHarnessInstallPlugin(args: HarnessInstallCommandArgs): Promise<number>;
 export declare function formatHarnessInstallError(error: unknown, json: boolean): number;
 //# sourceMappingURL=install.d.ts.map

package/dist/cli/commands/harness/install.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"install.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/harness/install.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,qBAAqB,EAEtB,MAAM,kBAAkB,CAAC;AAS1B,MAAM,WAAW,yBAA0B,SAAQ,qBAAqB;IACtE,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAgDD;;GAEG;AACH,wBAAsB,oBAAoB,CAAC,IAAI,EAAE,yBAAyB,GAAG,OAAO,CAAC,MAAM,CAAC,CAK3F;AAED;;;;;;GAMG;AACH,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,yBAAyB,GAAG,MAAM,CASlF;AAED,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,GAAG,MAAM,CAW/E"}
+{"version":3,"file":"install.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/harness/install.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,qBAAqB,EAEtB,MAAM,kBAAkB,CAAC;AAS1B,MAAM,WAAW,yBAA0B,SAAQ,qBAAqB;IACtE,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAsDD;;GAEG;AACH,wBAAsB,oBAAoB,CAAC,IAAI,EAAE,yBAAyB,GAAG,OAAO,CAAC,MAAM,CAAC,CAK3F;AAED;;;;;GAKG;AACH,wBAAsB,0BAA0B,CAAC,IAAI,EAAE,yBAAyB,GAAG,OAAO,CAAC,MAAM,CAAC,CAKjG;AAED,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,GAAG,MAAM,CAW/E"}

package/dist/cli/commands/harness/install.js

@@ -17,12 +17,18 @@ function formatInstallResult(payload, json) {
         console.log(JSON.stringify(payload, null, 2));
         return;
     }
+    if (payload.status) {
+        console.log(`Status: ${payload.status}`);
+    }
     if (payload.warning) {
         console.log(`Warning: ${payload.warning}`);
     }
     if (payload.summary) {
         console.log(payload.summary);
     }
+    if (payload.error) {
+        console.log(`Error: ${payload.error}`);
+    }
     if (payload.command) {
         console.log(`Command: ${payload.command}`);
     }
@@ -49,24 +55,19 @@ async function handleHarnessInstall(args) {
     const harnessName = requireHarnessName(args.harnessName, "harness:install");
     const result = await (0, install_1.installHarnessViaAmux)(harnessName, args);
     formatInstallResult(result, args.json);
-    return 0;
+    return result.success === false ? 1 : 0;
 }
 /**
  * Install a babysitter plugin for a harness.
  *
  * Plugin installation remains harness-specific since it involves babysitter's
- * own plugin packaging, not general CLI installation. This delegates to the
- * babysitter plugin system rather than per-adapter install logic.
+ * own plugin packaging. This uses the published per-harness plugin installer.
  */
-function handleHarnessInstallPlugin(args) {
+async function handleHarnessInstallPlugin(args) {
     const harnessName = requireHarnessName(args.harnessName, "harness:install-plugin");
-    const result = {
-        harness: harnessName,
-        summary: `Use "babysitter plugin:install" to install babysitter plugins for ${harnessName}. ` +
-            `Direct harness plugin installation has been consolidated into the plugin system.`,
-    };
+    const result = await (0, install_1.installHarnessPlugin)(harnessName, args);
     formatInstallResult(result, args.json);
-    return 0;
+    return result.success === false ? 1 : 0;
 }
 function formatHarnessInstallError(error, json) {
     const err = error instanceof Error

package/dist/cli/commands/health/checks.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"checks.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/health/checks.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAqC7C,wBAAsB,eAAe,IAAI,OAAO,CAAC,WAAW,CAAC,CAuB5D;AAED,wBAAgB,gBAAgB,IAAI,WAAW,CAsC9C;AAED,wBAAsB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CA8EzE;AAED,wBAAsB,sBAAsB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CA4D9E"}
+{"version":3,"file":"checks.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/health/checks.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAsC7C,wBAAsB,eAAe,IAAI,OAAO,CAAC,WAAW,CAAC,CAuB5D;AAED,wBAAgB,gBAAgB,IAAI,WAAW,CAsC9C;AAED,wBAAsB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CA8EzE;AAED,wBAAsB,sBAAsB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CA4D9E"}

package/dist/cli/commands/health/checks.js

@@ -43,6 +43,7 @@ exports.checkA5cDirectory = checkA5cDirectory;
 exports.checkPackageDependency = checkPackageDependency;
 const node_fs_1 = require("node:fs");
 const path = __importStar(require("node:path"));
+const config_1 = require("../../../config");
 // ============================================================================
 // Version Utilities
 // ============================================================================
@@ -136,7 +137,7 @@ function checkNodeVersion() {
 }
 async function checkA5cDirectory(cwd) {
     const a5cDir = path.join(cwd, ".a5c");
-    const runsDir = path.join(a5cDir, "runs");
+    const runsDir = (0, config_1.resolveRunsDir)({ cwd });
     try {
         const stats = await node_fs_1.promises.stat(a5cDir);
         if (!stats.isDirectory()) {
@@ -147,7 +148,7 @@ async function checkA5cDirectory(cwd) {
                 message: `.a5c exists but is not a directory at ${a5cDir}`,
                 nextSteps: [
                     "Remove the .a5c file and let the SDK create the directory",
-                    "Or run: rm .a5c && mkdir -p .a5c/runs",
+                    "Or run: rm .a5c && mkdir -p .a5c",
                 ],
                 details: { path: a5cDir, isDirectory: false },
             };
@@ -196,7 +197,7 @@ async function checkA5cDirectory(cwd) {
                 message: `.a5c directory does not exist at ${a5cDir}`,
                 nextSteps: [
                     "The directory will be created automatically when running babysitter commands",
-                    "Or create it manually: mkdir -p .a5c/runs",
+                    "Or create it manually: mkdir -p .a5c",
                 ],
                 details: { path: a5cDir, exists: false },
             };