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

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/breakpoints-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/babysitter-agent` 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/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/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 },
             };

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

@@ -1 +1 @@
-{"version":3,"file":"environment.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/health/environment.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAE7C,wBAAgB,yBAAyB,IAAI,WAAW,CAwFvD"}
+{"version":3,"file":"environment.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/health/environment.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAE7C,wBAAgB,yBAAyB,IAAI,WAAW,CAiGvD"}

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

@@ -2,16 +2,26 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.checkEnvironmentVariables = checkEnvironmentVariables;
 const defaults_1 = require("../../../config/defaults");
+const config_1 = require("../../../config");
 function checkEnvironmentVariables() {
     const envChecks = [];
     const runsDir = process.env[defaults_1.CONFIG_ENV_VARS.RUNS_DIR];
+    const runsScope = (0, config_1.getRunsScope)();
     envChecks.push({
         name: "BABYSITTER_RUNS_DIR",
         key: defaults_1.CONFIG_ENV_VARS.RUNS_DIR,
         value: runsDir,
         required: false,
         valid: true,
-        note: runsDir ? `Custom runs directory: ${runsDir}` : `Using default: ${defaults_1.DEFAULTS.runsDir}`,
+        note: runsDir ? `Custom runs directory: ${runsDir}` : `Using ${runsScope} scope default: ${(0, config_1.resolveRunsDir)()}`,
+    });
+    envChecks.push({
+        name: "BABYSITTER_RUNS_SCOPE",
+        key: defaults_1.CONFIG_ENV_VARS.RUNS_SCOPE,
+        value: process.env[defaults_1.CONFIG_ENV_VARS.RUNS_SCOPE],
+        required: false,
+        valid: true,
+        note: `Runs scope: ${runsScope}`,
     });
     const maxIterations = process.env[defaults_1.CONFIG_ENV_VARS.MAX_ITERATIONS];
     let maxIterValid = true;

package/dist/cli/commands/hooks/run.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/hooks/run.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAWH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,wGAAwG;IACxG,OAAO,EAAE,MAAM,CAAC;IAChB,8IAA8I;IAC9I,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,OAAO,CAAC;IACd,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAmJD,wBAAsB,aAAa,CAAC,IAAI,EAAE,kBAAkB,GAAG,OAAO,CAAC,MAAM,CAAC,CA0F7E"}
+{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/hooks/run.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAWH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,wGAAwG;IACxG,OAAO,EAAE,MAAM,CAAC;IAChB,8IAA8I;IAC9I,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,OAAO,CAAC;IACd,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAmJD,wBAAsB,aAAa,CAAC,IAAI,EAAE,kBAAkB,GAAG,OAAO,CAAC,MAAM,CAAC,CA2F7E"}

package/dist/cli/commands/hooks/run.js

@@ -208,6 +208,7 @@ async function handleHookRun(args) {
     let exitCode;
     switch (hookType) {
         case "stop":
+        case "session-end":
             exitCode = await adapter.handleStopHook(args);
             break;
         case "session-start":
@@ -216,14 +217,14 @@ async function handleHookRun(args) {
         default: {
             const error = {
                 error: "UNKNOWN_HOOK_TYPE",
-                message: `Unknown hook type: ${hookType}. Supported: stop, session-start, user-prompt-submit`,
+                message: `Unknown hook type: ${hookType}. Supported: stop, session-end, session-start, user-prompt-submit, pre-tool-use`,
             };
             logHookEvent(hookType, error.message, { error: error.error });
             if (json) {
                 process.stderr.write(JSON.stringify(error, null, 2) + "\n");
             }
             else {
-                process.stderr.write(`Error: Unknown hook type: ${hookType}. Supported: stop, session-start, user-prompt-submit\n`);
+                process.stderr.write(`Error: Unknown hook type: ${hookType}. Supported: stop, session-end, session-start, user-prompt-submit, pre-tool-use\n`);
             }
             return 1;
         }

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

@@ -8,7 +8,7 @@
  */
 export interface InstructionsCommandArgs {
     subcommand: "babysit-skill" | "process-create" | "orchestrate" | "breakpoint-handling";
-    harness: string;
+    harness?: string;
     interactive: boolean | undefined;
     json: boolean;
     showStrata?: boolean;

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

@@ -1 +1 @@
-{"version":3,"file":"instructions.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/instructions.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AA2BH,MAAM,WAAW,uBAAuB;IACtC,UAAU,EAAE,eAAe,GAAG,gBAAgB,GAAG,aAAa,GAAG,qBAAqB,CAAC;IACvF,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,OAAO,GAAG,SAAS,CAAC;IACjC,IAAI,EAAE,OAAO,CAAC;IACd,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AA2ID;;GAEG;AACH,wBAAsB,yBAAyB,CAC7C,IAAI,EAAE,uBAAuB,GAC5B,OAAO,CAAC,MAAM,CAAC,CA2HjB"}
+{"version":3,"file":"instructions.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/instructions.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAmCH,MAAM,WAAW,uBAAuB;IACtC,UAAU,EAAE,eAAe,GAAG,gBAAgB,GAAG,aAAa,GAAG,qBAAqB,CAAC;IACvF,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,OAAO,GAAG,SAAS,CAAC;IACjC,IAAI,EAAE,OAAO,CAAC;IACd,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAwND;;GAEG;AACH,wBAAsB,yBAAyB,CAC7C,IAAI,EAAE,uBAAuB,GAC5B,OAAO,CAAC,MAAM,CAAC,CAkIjB"}

package/dist/cli/commands/instructions.js

@@ -13,7 +13,9 @@ const node_fs_1 = require("node:fs");
 const prompts_1 = require("../../prompts");
 const active_1 = require("../../processLibrary/active");
 const registry_1 = require("../../harness/registry");
+const discovery_1 = require("../../harness/discovery");
 const parse_1 = require("../../session/parse");
+const contextShared_1 = require("../../prompts/contextShared");
 const COMPOSERS = {
     "babysit-skill": {
         fn: prompts_1.composeBabysitSkillPrompt,
@@ -78,6 +80,9 @@ const COMPOSERS = {
  * Resolve a PromptContext factory by harness name.
  */
 function resolveContextFactory(harness) {
+    if (harness === "custom") {
+        return (overrides) => createPessimisticPromptContext(overrides);
+    }
     if (!(0, registry_1.getAdapterByName)(harness)?.getPromptContext) {
         return undefined;
     }
@@ -89,6 +94,60 @@ function resolveContextFactory(harness) {
         return context;
     };
 }
+function createPessimisticPromptContext(overrides) {
+    return (0, contextShared_1.createPromptContext)({
+        harness: "custom",
+        harnessLabel: "Custom Harness",
+        capabilities: ["task-tool", "breakpoint-routing"],
+        pluginRootVar: "",
+        loopControlTerm: "in-turn",
+        sessionBindingFlags: "",
+        hookDriven: false,
+        interactiveToolName: "",
+        sessionEnvVars: "`--session-id`, `AGENT_SESSION_ID`, or the PID-scoped session marker fallback",
+        resumeFlags: "",
+        cliSetupSnippet: (0, contextShared_1.createDefaultCliSetupSnippet)(),
+        iterateFlags: "",
+        hasIntentFidelityChecks: false,
+        hasNonNegotiables: false,
+    }, overrides);
+}
+function resolveInstructionsHarness(harness) {
+    if (harness) {
+        return {
+            harness,
+            source: "explicit",
+            warnings: [],
+            evidence: [],
+        };
+    }
+    const caller = (0, discovery_1.detectCallerHarness)();
+    if (caller) {
+        return {
+            harness: caller.name,
+            source: "caller",
+            warnings: [],
+            evidence: caller.matchedEnvVars,
+        };
+    }
+    const hooksMuxCaller = (0, discovery_1.detectCallerHarnessViaHooksMux)();
+    if (hooksMuxCaller) {
+        return {
+            harness: hooksMuxCaller.name,
+            source: "hooks-mux",
+            warnings: [],
+            evidence: hooksMuxCaller.matchedEnvVars,
+        };
+    }
+    return {
+        harness: "custom",
+        source: "fallback",
+        warnings: [
+            "Host discovery failed for `instructions:*`; using the pessimistic custom-harness prompt context.",
+        ],
+        evidence: [],
+    };
+}
 /**
  * Try to resolve the active process-library root from the SDK directly.
  * Returns the library root and reference root if a binding exists,
@@ -139,17 +198,18 @@ function detectHooksActive(harness) {
  * Route and handle an `instructions:*` subcommand.
  */
 async function handleInstructionsCommand(args) {
-    const factory = resolveContextFactory(args.harness);
+    const resolvedHarness = resolveInstructionsHarness(args.harness);
+    const factory = resolveContextFactory(resolvedHarness.harness);
     if (!factory) {
         const known = registry_1.KNOWN_HARNESSES.map((spec) => spec.name).join(", ");
         if (args.json) {
             console.log(JSON.stringify({
                 error: "unknown_harness",
-                message: `Unknown harness "${args.harness}". Known harnesses: ${known}`,
+                message: `Unknown harness "${resolvedHarness.harness}". Known harnesses: ${known}`,
             }));
         }
         else {
-            console.error(`[instructions] Unknown harness "${args.harness}". Known harnesses: ${known}`);
+            console.error(`[instructions] Unknown harness "${resolvedHarness.harness}". Known harnesses: ${known}`);
         }
         return 1;
     }
@@ -172,7 +232,7 @@ async function handleInstructionsCommand(args) {
     // Detect whether hooks are actually active in this session.
     // If the session-start hook never ran (no breadcrumb file), override
     // hookDriven to false so the agent drives the loop in-turn.
-    const hooksActive = detectHooksActive(args.harness);
+    const hooksActive = detectHooksActive(resolvedHarness.harness);
     const hookOverride = {};
     if (!hooksActive) {
         hookOverride.hookDriven = false;
@@ -201,11 +261,14 @@ async function handleInstructionsCommand(args) {
     }
     if (args.json) {
         console.log(JSON.stringify({
-            harness: args.harness,
+            harness: resolvedHarness.harness,
+            harnessSource: resolvedHarness.source,
+            discoveryEvidence: resolvedHarness.evidence,
             interactive: args.interactive,
             promptType: composer.promptType,
             hookDriven: ctx.hookDriven,
             hooksDetected: hooksActive,
+            warnings: resolvedHarness.warnings,
             executionContext,
             capabilityFlags,
             suggestedProcesses: (0, prompts_1.processPathsForCapabilities)(capabilityFlags),
@@ -214,6 +277,9 @@ async function handleInstructionsCommand(args) {
         }, null, 2));
     }
     else {
+        for (const warning of resolvedHarness.warnings) {
+            console.error(`[instructions] Warning: ${warning}`);
+        }
         if (!hooksActive && ctx.hookDriven !== false) {
             // Context factory defaulted hookDriven to true, but we overrode it.
             // This is a no-op because the override already happened, but it

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,EAAE,MAAM,qBAAqB,CAAC;AAYxD,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,MAAM,CAAC;IACjE,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,+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;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,CAgKtF"}
+{"version":3,"file":"runIterate.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/runIterate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAKH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAaxD,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,MAAM,CAAC;IACjE,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,+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;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,CAgKtF"}