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

package/dist/cli/main/runSupport.js

@@ -49,15 +49,18 @@ exports.resolveArtifactAbsolutePath = resolveArtifactAbsolutePath;
 exports.defaultResultRef = defaultResultRef;
 exports.formatEntrypointSpecifier = formatEntrypointSpecifier;
 exports.parseEntrypointSpecifier = parseEntrypointSpecifier;
+exports.ensureProcessLocalSdkDependency = ensureProcessLocalSdkDependency;
 exports.validateProcessEntrypoint = validateProcessEntrypoint;
 exports.readInputsFile = readInputsFile;
 exports.readStdinUtf8 = readStdinUtf8;
 exports.resolveCommandRunDir = resolveCommandRunDir;
 const node_fs_1 = require("node:fs");
+const node_module_1 = require("node:module");
 const path = __importStar(require("node:path"));
 const node_url_1 = require("node:url");
 const args_1 = require("./args");
 const resolveInputPath_1 = require("../resolveInputPath");
+const SDK_PACKAGE_SPECIFIER = "@a5c-ai/babysitter-sdk/package.json";
 const dynamicImportModule = (() => {
     if (process.env.VITEST) {
         return (specifier) => Promise.resolve(`${specifier}`).then(s => __importStar(require(s)));
@@ -233,7 +236,68 @@ function listModuleExports(mod) {
     const keys = Object.keys(mod);
     return keys.length > 0 ? keys.join(", ") : "(none)";
 }
-async function validateProcessEntrypoint(importPath, exportName) {
+function resolveSelfSdkPackageDir() {
+    let currentDir = __dirname;
+    let reachedRoot = false;
+    while (!reachedRoot) {
+        const packageJsonPath = path.join(currentDir, "package.json");
+        try {
+            const pkg = JSON.parse((0, node_fs_1.readFileSync)(packageJsonPath, "utf8"));
+            if (pkg.name === "@a5c-ai/babysitter-sdk") {
+                return currentDir;
+            }
+        }
+        catch {
+            // Keep walking upward.
+        }
+        const parentDir = path.dirname(currentDir);
+        reachedRoot = parentDir === currentDir;
+        if (!reachedRoot) {
+            currentDir = parentDir;
+        }
+    }
+    throw new Error("Unable to resolve the current @a5c-ai/babysitter-sdk package root");
+}
+function defaultResolveSdkPackageDir() {
+    try {
+        return path.dirname(require.resolve(SDK_PACKAGE_SPECIFIER));
+    }
+    catch {
+        return resolveSelfSdkPackageDir();
+    }
+}
+async function ensureProcessLocalSdkDependency(importPath, options = {}) {
+    const resolvedPath = path.isAbsolute(importPath) ? importPath : (0, resolveInputPath_1.resolveInputPath)(importPath);
+    const processDir = path.dirname(resolvedPath);
+    const processRequire = (options.createRequireFn ?? node_module_1.createRequire)(path.join(processDir, "__babysitter_process__.cjs"));
+    try {
+        processRequire.resolve(SDK_PACKAGE_SPECIFIER);
+        return;
+    }
+    catch {
+        // Fall through to a local fallback dependency.
+    }
+    const fsImpl = options.fsImpl ?? node_fs_1.promises;
+    const targetSdkDir = path.join(processDir, "node_modules", "@a5c-ai", "babysitter-sdk");
+    try {
+        await fsImpl.access(targetSdkDir);
+        return;
+    }
+    catch {
+        // Create below.
+    }
+    await fsImpl.mkdir(path.dirname(targetSdkDir), { recursive: true });
+    try {
+        await fsImpl.symlink((options.resolveSdkPackageDir ?? defaultResolveSdkPackageDir)(), targetSdkDir, process.platform === "win32" ? "junction" : "dir");
+    }
+    catch (error) {
+        const code = error?.code;
+        if (code !== "EEXIST") {
+            throw error;
+        }
+    }
+}
+async function validateProcessEntrypoint(importPath, exportName, options = {}) {
     const resolvedPath = path.isAbsolute(importPath) ? importPath : (0, resolveInputPath_1.resolveInputPath)(importPath);
     try {
         await node_fs_1.promises.access(resolvedPath);
@@ -242,6 +306,12 @@ async function validateProcessEntrypoint(importPath, exportName) {
         throw new Error(`Process entry file not found: ${resolvedPath}. ` +
             `Ensure the path is correct and points to a valid JS/TS module.`);
     }
+    try {
+        await ensureProcessLocalSdkDependency(resolvedPath, options);
+    }
+    catch (error) {
+        throw new Error(`Failed to prepare project-local SDK dependency for ${resolvedPath}: ${error instanceof Error ? error.message : String(error)}`);
+    }
     const moduleUrl = (0, node_url_1.pathToFileURL)(resolvedPath).href;
     let mod;
     try {

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;AAuI1D,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;AA2I1D,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

@@ -4,49 +4,49 @@ exports.USAGE = exports.HUMAN_USAGE = exports.AGENT_USAGE = void 0;
 exports.formatUsage = formatUsage;
 const program_1 = require("./program");
 function coreAgentUsage(commandName) {
-    return `  ${commandName} run:create --process-id <id> --entry <path#export> [--runs-dir <dir>] [--inputs <file>] [--run-id <id>] [--process-revision <rev>] [--request <id>] [--prompt <text>] [--harness <name>] [--session-id <id>] [--non-interactive] [--json] [--dry-run]
-  ${commandName} run:status <runDir> [--runs-dir <dir>] [--json]
-  ${commandName} run:events <runDir> [--runs-dir <dir>] [--json] [--limit <n>] [--reverse] [--filter-type <type>]
-  ${commandName} run:rebuild-state <runDir> [--runs-dir <dir>] [--json] [--dry-run]
-  ${commandName} run:repair-journal <runDir> [--runs-dir <dir>] [--json] [--dry-run]
-  ${commandName} run:iterate <runDir> [--runs-dir <dir>] [--json] [--verbose] [--iteration <n>]
-  ${commandName} task:post <runDir> <effectId> --status <ok|error> [--runs-dir <dir>] [--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> [--runs-dir <dir>] [--pending] [--kind <kind>] [--json]
-  ${commandName} task:show <runDir> <effectId> [--runs-dir <dir>] [--json]
-  ${commandName} skill:discover [--run-id <id>] [--cache-ttl <seconds>] [--runs-dir <dir>] [--include-remote] [--summary-only] [--process-path <path>] [--json]
+    return `  ${commandName} run:create --process-id <id> --entry <path#export> [--inputs <file>] [--run-id <id>] [--process-revision <rev>] [--request <id>] [--prompt <text>] [--harness <name>] [--session-id <id>] [--non-interactive] [--json] [--dry-run]
+  ${commandName} run:status <runDir> [--json]
+  ${commandName} run:events <runDir> [--json] [--limit <n>] [--reverse] [--filter-type <type>]
+  ${commandName} run:rebuild-state <runDir> [--json] [--dry-run]
+  ${commandName} run:repair-journal <runDir> [--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]
+  ${commandName} task:show <runDir> <effectId> [--json]
+  ${commandName} skill:discover [--run-id <id>] [--cache-ttl <seconds>] [--include-remote] [--summary-only] [--process-path <path>] [--json]
   ${commandName} session:init --session-id <id> --state-dir <dir> [--max-iterations <n>] [--run-id <id>] [--prompt <text>] [--json]
-  ${commandName} session:associate --session-id <id> --state-dir <dir> --run-id <id> [--force] [--runs-dir <dir>] [--json]
-  ${commandName} session:resume --session-id <id> [--state-dir <dir>] --run-id <id> [--max-iterations <n>] [--runs-dir <dir>] [--json]
+  ${commandName} session:associate --session-id <id> --state-dir <dir> --run-id <id> [--force] [--json]
+  ${commandName} session:resume --session-id <id> [--state-dir <dir>] --run-id <id> [--max-iterations <n>] [--json]
   ${commandName} session:state --session-id <id> --state-dir <dir> [--json]
   ${commandName} session:update --session-id <id> --state-dir <dir> [--iteration <n>] [--last-iteration-at <iso8601>] [--iteration-times <csv>] [--delete] [--json]
   ${commandName} session:check-iteration --session-id <id> --state-dir <dir> [--json]
   ${commandName} session:last-message --transcript-path <file> [--json]
-  ${commandName} session:iteration-message --iteration <n> [--run-id <id>] [--runs-dir <dir>] [--json]
+  ${commandName} session:iteration-message --iteration <n> [--run-id <id>] [--json]
   ${commandName} session:whoami [--harness <name>] [--json]
-  ${commandName} session:cleanup [--harness <name>] [--dry-run] [--runs-dir <dir>] [--json]
+  ${commandName} session:cleanup [--harness <name>] [--dry-run] [--json]
   ${commandName} process-library:active [--run-id <id>] [--session-id <id>] [--state-dir <dir>] [--json]
   ${commandName} profile:read --user|--project [--dir <dir>] [--json]
   ${commandName} profile:write --user|--project --input <file> [--dir <dir>] [--json]
   ${commandName} profile:merge --user|--project --input <file> [--dir <dir>] [--json]
   ${commandName} profile:render --user|--project [--dir <dir>] [--json]
-  ${commandName} instructions:babysit-skill --harness <name> [--interactive|--no-interactive] [--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]`;
 }
 function coreHumanUsage(commandName) {
     return `  ${commandName} log --type <process|hook|cli> --message <msg> [--run-id <id>] [--label <label>] [--level <level>] [--source <src>] [--json]
   ${commandName} hook:log --hook-type <type> --log-file <path> [--json]
-  ${commandName} hook:run --hook-type <stop|session-start|user-prompt-submit|pre-tool-use> [--harness <claude-code|gemini-cli>] [--state-dir <dir>] [--runs-dir <dir>] [--json] [--verbose]
+  ${commandName} hook:run --hook-type <stop|session-end|session-start|user-prompt-submit|pre-tool-use> [--harness <name>] [--state-dir <dir>] [--json] [--verbose]
   ${commandName} session:init --session-id <id> --state-dir <dir> [--max-iterations <n>] [--run-id <id>] [--prompt <text>] [--json]
-  ${commandName} session:associate --session-id <id> --state-dir <dir> --run-id <id> [--force] [--runs-dir <dir>] [--json]
-  ${commandName} session:resume --session-id <id> [--state-dir <dir>] --run-id <id> [--max-iterations <n>] [--runs-dir <dir>] [--json]
+  ${commandName} session:associate --session-id <id> --state-dir <dir> --run-id <id> [--force] [--json]
+  ${commandName} session:resume --session-id <id> [--state-dir <dir>] --run-id <id> [--max-iterations <n>] [--json]
   ${commandName} session:state --session-id <id> --state-dir <dir> [--json]
   ${commandName} session:update --session-id <id> --state-dir <dir> [--iteration <n>] [--last-iteration-at <iso8601>] [--iteration-times <csv>] [--delete] [--json]
   ${commandName} session:check-iteration --session-id <id> --state-dir <dir> [--json]
   ${commandName} session:last-message --transcript-path <file> [--json]
-  ${commandName} session:iteration-message --iteration <n> [--run-id <id>] [--runs-dir <dir>] [--json]
+  ${commandName} session:iteration-message --iteration <n> [--run-id <id>] [--json]
   ${commandName} session:whoami [--harness <name>] [--json]
-  ${commandName} session:cleanup [--harness <name>] [--dry-run] [--runs-dir <dir>] [--json]
+  ${commandName} session:cleanup [--harness <name>] [--dry-run] [--json]
   ${commandName} compress-output <command and args...>
   ${commandName} skill:fetch-remote --source-type <github|well-known> --url <url> [--json]
   ${commandName} process-library:clone [--repo <url>] [--dir <path>] [--ref <ref>] [--state-dir <dir>] [--json]
@@ -62,21 +62,21 @@ function coreHumanUsage(commandName) {
   ${commandName} plugin:update-marketplace --marketplace-name <name> [--marketplace-branch <ref>] [--global|--project] [--json] [--verbose]
   ${commandName} plugin:update-registry [<pluginName>] [--plugin-name <name>] [--plugin-version <ver>] [--global|--project] [--json] [--verbose]
   ${commandName} plugin:remove-from-registry [<pluginName>] [--plugin-name <name>] [--global|--project] [--json] [--verbose]
-  ${commandName} tokens:stats [runId] [--all] [--runs-dir <dir>] [--json]
+  ${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} 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]
+  ${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]
   ${commandName} breakpoint:approve-rule <pattern> [--action auto-approve|never-auto-approve] [--source <source>] [--note <note>] [--json]
   ${commandName} breakpoint:remove-rule <ruleId> [--json]
   ${commandName} breakpoint:list-rules [--json]
   ${commandName} breakpoint:should-auto-approve <breakpointId> [--tags <csv>] [--expert <expert>] [--json]
-  ${commandName} breakpoint:history [--breakpoint-id <id>] [--runs-dir <dir>] [--limit <n>] [--json]
+  ${commandName} breakpoint:history [--breakpoint-id <id>] [--limit <n>] [--json]
   ${commandName} health [--json] [--verbose]
   ${commandName} configure [show|validate|paths] [--json] [--defaults-only]
   ${commandName} version
@@ -86,32 +86,32 @@ Harness runtime commands are provided by the optional ${"@a5c-ai/babysitter-agen
   babysitter-harness start-server [--transport <stdio|websocket>]`;
 }
 function harnessAgentUsage(commandName) {
-    return `  ${commandName} create-run [--prompt <text>] [--harness <name>] [--process <path>] [--workspace <dir>] [--model <model>] [--max-iterations <n>] [--runs-dir <dir>] [--interactive|--no-interactive|--non-interactive] [--json] [--verbose]
-  ${commandName} resume-run [--run-id <id>] [--runs-dir <dir>] [--harness <name>] [--workspace <dir>] [--model <model>] [--max-iterations <n>] [--interactive|--no-interactive] [--json] [--verbose]
+    return `  ${commandName} create-run [--prompt <text>] [--harness <name>] [--process <path>] [--workspace <dir>] [--model <model>] [--max-iterations <n>] [--interactive|--no-interactive|--non-interactive] [--json] [--verbose]
+  ${commandName} resume-run [--run-id <id>] [--harness <name>] [--workspace <dir>] [--model <model>] [--max-iterations <n>] [--interactive|--no-interactive] [--json] [--verbose]
   ${commandName} invoke <name> --prompt <text> [--workspace <dir>] [--model <model>] [--timeout <ms>] [--json]
   ${commandName} observe [--workspace <dir>] [--tui]
   ${commandName} tui [--run-id <id>] [--verbosity minimal|normal|verbose] [--workspace <dir>] [--json]
   ${commandName} discover [--json]`;
 }
 function harnessHumanUsage(commandName) {
-    return `  ${commandName} create-run [--prompt <text>] [--harness <name>] [--process <path>] [--workspace <dir>] [--model <model>] [--max-iterations <n>] [--runs-dir <dir>] [--interactive|--no-interactive|--non-interactive] [--json] [--verbose]
+    return `  ${commandName} create-run [--prompt <text>] [--harness <name>] [--process <path>] [--workspace <dir>] [--model <model>] [--max-iterations <n>] [--interactive|--no-interactive|--non-interactive] [--json] [--verbose]
   ${commandName} call [...]                          (alias for create-run)
   ${commandName} yolo [...]                          (alias for create-run --non-interactive)
   ${commandName} plan [...]                          (alias for create-run, stops after PhasePlanProcess)
   ${commandName} forever [...]                       (alias for create-run, infinite loop process)
-  ${commandName} resume-run [--run-id <id>] [--runs-dir <dir>] [--harness <name>] [--workspace <dir>] [--model <model>] [--max-iterations <n>] [--interactive|--no-interactive] [--json] [--verbose]
+  ${commandName} resume-run [--run-id <id>] [--harness <name>] [--workspace <dir>] [--model <model>] [--max-iterations <n>] [--interactive|--no-interactive] [--json] [--verbose]
   ${commandName} resume [...]                        (alias for resume-run)
-  ${commandName} retrospect [--run-id <id>...] [--all] [--prompt <text>] [--harness <name>] [--workspace <dir>] [--model <model>] [--max-iterations <n>] [--runs-dir <dir>] [--json] [--verbose]
-  ${commandName} cleanup [--dry-run] [--keep-days <n>] [--prompt <text>] [--harness <name>] [--workspace <dir>] [--model <model>] [--runs-dir <dir>] [--json] [--verbose]
-  ${commandName} assimilate [--prompt <text>] [--harness <name>] [--workspace <dir>] [--model <model>] [--max-iterations <n>] [--runs-dir <dir>] [--json] [--verbose]
-  ${commandName} doctor [--run-id <id>] [--runs-dir <dir>] [--json] [--verbose]
-  ${commandName} contrib [--prompt <text>] [--harness <name>] [--workspace <dir>] [--model <model>] [--max-iterations <n>] [--runs-dir <dir>] [--json] [--verbose]
+  ${commandName} retrospect [--run-id <id>...] [--all] [--prompt <text>] [--harness <name>] [--workspace <dir>] [--model <model>] [--max-iterations <n>] [--json] [--verbose]
+  ${commandName} cleanup [--dry-run] [--keep-days <n>] [--prompt <text>] [--harness <name>] [--workspace <dir>] [--model <model>] [--json] [--verbose]
+  ${commandName} assimilate [--prompt <text>] [--harness <name>] [--workspace <dir>] [--model <model>] [--max-iterations <n>] [--json] [--verbose]
+  ${commandName} doctor [--run-id <id>] [--json] [--verbose]
+  ${commandName} contrib [--prompt <text>] [--harness <name>] [--workspace <dir>] [--model <model>] [--max-iterations <n>] [--json] [--verbose]
   ${commandName} anycli --service <name> [--scope <scopes>] [--mcp] [--auth-file <path>] [--transport <type>] [--prompt <text>] [--workspace <dir>] [--json] [--verbose]
   ${commandName} session-history --session-id <id> --state-dir <dir> [--run-id <id>] [--json]
   ${commandName} help [<topic>]
   ${commandName} observe [--workspace <dir>] [--tui]
-  ${commandName} user-install [--harness <name>] [--workspace <dir>] [--model <model>] [--runs-dir <dir>] [--json] [--verbose]
-  ${commandName} project-install [--harness <name>] [--workspace <dir>] [--model <model>] [--runs-dir <dir>] [--json] [--verbose]
+  ${commandName} user-install [--harness <name>] [--workspace <dir>] [--model <model>] [--json] [--verbose]
+  ${commandName} project-install [--harness <name>] [--workspace <dir>] [--model <model>] [--json] [--verbose]
   ${commandName} discover [--json]
   ${commandName} list [--json]
   ${commandName} invoke <name> --prompt <text> [--workspace <dir>] [--model <model>] [--timeout <ms>] [--json]
@@ -123,14 +123,18 @@ Install or update harness CLIs and plugins with the main babysitter CLI:
   babysitter harness:install-plugin <name>`;
 }
 const GLOBAL_FLAGS_USAGE = `Global flags:
-  --runs-dir <dir>   Override the runs directory (defaults to .a5c/runs).
+  --runs-dir <dir>   Override the runs directory (advanced compatibility flag).
   --json             Emit JSON output when supported by the command.
   --dry-run          Describe planned mutations without changing on-disk state.
   --verbose          Log resolved paths and options to stderr for debugging.
   --show-config      Show current configuration before executing command.
   --help, -h         Show agent-facing help text.
   --help-human       Show human-facing help text.
-  --version, -v      Show CLI version.`;
+  --version, -v      Show CLI version.
+
+Runs storage defaults:
+  global scope       ~/.a5c/runs
+  repo scope         <repo>/.a5c/runs (set BABYSITTER_RUNS_SCOPE=repo)`;
 function formatUsage(surface, program = program_1.CORE_PROGRAM) {
     const agentCommands = program.variant === "harness"
         ? harnessAgentUsage(program.commandName)

package/dist/config/configValidation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"configValidation.d.ts","sourceRoot":"","sources":["../../src/config/configValidation.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAuCrF;;GAEG;AACH,wBAAgB,SAAS,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC,gBAAgB,CAAC,GAAG,gBAAgB,CAqCjF;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,gBAAgB,GAAG,sBAAsB,CA+D/E;AAED;;GAEG;AACH,wBAAgB,WAAW,IAAI,QAAQ,CAAC,gBAAgB,CAAC,CAExD;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,QAAQ,CAEjE"}
+{"version":3,"file":"configValidation.d.ts","sourceRoot":"","sources":["../../src/config/configValidation.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAwCrF;;GAEG;AACH,wBAAgB,SAAS,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC,gBAAgB,CAAC,GAAG,gBAAgB,CAqCjF;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,gBAAgB,GAAG,sBAAsB,CA+D/E;AAED;;GAEG;AACH,wBAAgB,WAAW,IAAI,QAAQ,CAAC,gBAAgB,CAAC,CAExD;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,QAAQ,CAEjE"}

package/dist/config/configValidation.js

@@ -9,6 +9,7 @@ exports.validateConfig = validateConfig;
 exports.getDefaults = getDefaults;
 exports.isValidLogLevel = isValidLogLevel;
 const defaults_1 = require("./defaults");
+const runs_1 = require("./runs");
 /**
  * Valid log levels for validation
  */
@@ -51,7 +52,7 @@ function parseEnvLogLevel(value, fallback) {
 function getConfig(overrides) {
     const env = typeof process !== "undefined" ? process.env : {};
     return {
-        runsDir: overrides?.runsDir ?? env[defaults_1.CONFIG_ENV_VARS.RUNS_DIR] ?? defaults_1.DEFAULTS.runsDir,
+        runsDir: overrides?.runsDir ?? (0, runs_1.resolveRunsDir)(),
         maxIterations: overrides?.maxIterations ??
             parseEnvPositiveInt(env[defaults_1.CONFIG_ENV_VARS.MAX_ITERATIONS], defaults_1.DEFAULTS.maxIterations),
         qualityThreshold: overrides?.qualityThreshold ??

package/dist/config/defaults.d.ts

@@ -39,6 +39,7 @@ export interface ConfigValidationResult {
  */
 export declare const CONFIG_ENV_VARS: {
     readonly RUNS_DIR: "BABYSITTER_RUNS_DIR";
+    readonly RUNS_SCOPE: "BABYSITTER_RUNS_SCOPE";
     readonly MAX_ITERATIONS: "BABYSITTER_MAX_ITERATIONS";
     readonly QUALITY_THRESHOLD: "BABYSITTER_QUALITY_THRESHOLD";
     readonly TIMEOUT: "BABYSITTER_TIMEOUT";
@@ -49,6 +50,7 @@ export declare const CONFIG_ENV_VARS: {
 };
 /** Default SDK configuration values; env vars and explicit overrides can replace them. */
 export declare const DEFAULTS: Readonly<BabysitterConfig>;
+export declare function getConfiguredGlobalStateRoot(): string;
 /**
  * Normalizes a session-state directory path.
  */

package/dist/config/defaults.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"defaults.d.ts","sourceRoot":"","sources":["../../src/config/defaults.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH;;GAEG;AACH,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,QAAQ,CAAC;AAEtE;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,MAAM,CAAC;IACtB,gBAAgB,EAAE,MAAM,CAAC;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,QAAQ,CAAC;IACnB,eAAe,EAAE,OAAO,CAAC;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,uBAAuB,EAAE,MAAM,CAAC;CACjC;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED;;GAEG;AACH,eAAO,MAAM,eAAe;;;;;;;;;CASlB,CAAC;AAEX,0FAA0F;AAC1F,eAAO,MAAM,QAAQ,EAAE,QAAQ,CAAC,gBAAgB,CAatC,CAAC;AAeX;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAYlE;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,CAE1C;AAED;;GAEG;AACH,wBAAgB,eAAe,IAAI,MAAM,CAiBxC;AAGD,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC"}
+{"version":3,"file":"defaults.d.ts","sourceRoot":"","sources":["../../src/config/defaults.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH;;GAEG;AACH,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,QAAQ,CAAC;AAEtE;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,MAAM,CAAC;IACtB,gBAAgB,EAAE,MAAM,CAAC;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,QAAQ,CAAC;IACnB,eAAe,EAAE,OAAO,CAAC;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,uBAAuB,EAAE,MAAM,CAAC;CACjC;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED;;GAEG;AACH,eAAO,MAAM,eAAe;;;;;;;;;;CAUlB,CAAC;AAEX,0FAA0F;AAC1F,eAAO,MAAM,QAAQ,EAAE,QAAQ,CAAC,gBAAgB,CAatC,CAAC;AAEX,wBAAgB,4BAA4B,IAAI,MAAM,CAIrD;AASD;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAYlE;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,CAE1C;AAED;;GAEG;AACH,wBAAgB,eAAe,IAAI,MAAM,CAiBxC;AAGD,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/config/defaults.js

@@ -41,6 +41,7 @@ var __importStar = (this && this.__importStar) || (function () {
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.isValidLogLevel = exports.getDefaults = exports.validateConfig = exports.getConfig = exports.DEFAULTS = exports.CONFIG_ENV_VARS = void 0;
+exports.getConfiguredGlobalStateRoot = getConfiguredGlobalStateRoot;
 exports.normalizeSessionStateDir = normalizeSessionStateDir;
 exports.getGlobalStateDir = getGlobalStateDir;
 exports.getGlobalLogDir = getGlobalLogDir;
@@ -51,6 +52,7 @@ const os = __importStar(require("node:os"));
  */
 exports.CONFIG_ENV_VARS = {
     RUNS_DIR: "BABYSITTER_RUNS_DIR",
+    RUNS_SCOPE: "BABYSITTER_RUNS_SCOPE",
     MAX_ITERATIONS: "BABYSITTER_MAX_ITERATIONS",
     QUALITY_THRESHOLD: "BABYSITTER_QUALITY_THRESHOLD",
     TIMEOUT: "BABYSITTER_TIMEOUT",
@@ -61,7 +63,7 @@ exports.CONFIG_ENV_VARS = {
 };
 /** Default SDK configuration values; env vars and explicit overrides can replace them. */
 exports.DEFAULTS = {
-    runsDir: ".a5c/runs",
+    runsDir: path.join(getConfiguredGlobalStateRoot(), "runs"),
     maxIterations: 256,
     qualityThreshold: 80,
     timeout: 120000,

package/dist/config/index.d.ts

@@ -9,7 +9,7 @@
  * import { DEFAULTS, getConfig, validateConfig } from "@a5c-ai/babysitter-sdk/config";
  *
  * // Use defaults directly
- * console.log(DEFAULTS.runsDir); // ".a5c/runs"
+ * console.log(DEFAULTS.runsDir); // "/home/alice/.a5c/runs"
  *
  * // Get merged config with env overrides
  * const config = getConfig({ maxIterations: 500 });
@@ -21,5 +21,6 @@
  * }
  * ```
  */
-export { type LogLevel, type BabysitterConfig, type ConfigValidationResult, DEFAULTS, CONFIG_ENV_VARS, getConfig, getGlobalLogDir, getGlobalStateDir, normalizeSessionStateDir, validateConfig, getDefaults, isValidLogLevel, } from "./defaults";
+export { type LogLevel, type BabysitterConfig, type ConfigValidationResult, DEFAULTS, CONFIG_ENV_VARS, getConfig, getGlobalLogDir, getGlobalStateDir, getConfiguredGlobalStateRoot, normalizeSessionStateDir, validateConfig, getDefaults, isValidLogLevel, } from "./defaults";
+export { type RunsScope, findRepoRoot, getGlobalRunsDir, getReadableRunsDirs, getRepoRoot, getRepoRunsDir, getRunsScope, parseRunsScope, resolveExistingRunDir, resolveProjectRootForRun, resolveRunRootFromRunDir, resolveRunsDir, } from "./runs";
 //# sourceMappingURL=index.d.ts.map

package/dist/config/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,EAEL,KAAK,QAAQ,EACb,KAAK,gBAAgB,EACrB,KAAK,sBAAsB,EAG3B,QAAQ,EACR,eAAe,EAGf,SAAS,EACT,eAAe,EACf,iBAAiB,EACjB,wBAAwB,EACxB,cAAc,EACd,WAAW,EACX,eAAe,GAChB,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,EAEL,KAAK,QAAQ,EACb,KAAK,gBAAgB,EACrB,KAAK,sBAAsB,EAG3B,QAAQ,EACR,eAAe,EAGf,SAAS,EACT,eAAe,EACf,iBAAiB,EACjB,4BAA4B,EAC5B,wBAAwB,EACxB,cAAc,EACd,WAAW,EACX,eAAe,GAChB,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,KAAK,SAAS,EACd,YAAY,EACZ,gBAAgB,EAChB,mBAAmB,EACnB,WAAW,EACX,cAAc,EACd,YAAY,EACZ,cAAc,EACd,qBAAqB,EACrB,wBAAwB,EACxB,wBAAwB,EACxB,cAAc,GACf,MAAM,QAAQ,CAAC"}

package/dist/config/index.js

@@ -10,7 +10,7 @@
  * import { DEFAULTS, getConfig, validateConfig } from "@a5c-ai/babysitter-sdk/config";
  *
  * // Use defaults directly
- * console.log(DEFAULTS.runsDir); // ".a5c/runs"
+ * console.log(DEFAULTS.runsDir); // "/home/alice/.a5c/runs"
  *
  * // Get merged config with env overrides
  * const config = getConfig({ maxIterations: 500 });
@@ -23,7 +23,7 @@
  * ```
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.isValidLogLevel = exports.getDefaults = exports.validateConfig = exports.normalizeSessionStateDir = exports.getGlobalStateDir = exports.getGlobalLogDir = exports.getConfig = exports.CONFIG_ENV_VARS = exports.DEFAULTS = void 0;
+exports.resolveRunsDir = exports.resolveRunRootFromRunDir = exports.resolveProjectRootForRun = exports.resolveExistingRunDir = exports.parseRunsScope = exports.getRunsScope = exports.getRepoRunsDir = exports.getRepoRoot = exports.getReadableRunsDirs = exports.getGlobalRunsDir = exports.findRepoRoot = exports.isValidLogLevel = exports.getDefaults = exports.validateConfig = exports.normalizeSessionStateDir = exports.getConfiguredGlobalStateRoot = exports.getGlobalStateDir = exports.getGlobalLogDir = exports.getConfig = exports.CONFIG_ENV_VARS = exports.DEFAULTS = void 0;
 var defaults_1 = require("./defaults");
 // Constants
 Object.defineProperty(exports, "DEFAULTS", { enumerable: true, get: function () { return defaults_1.DEFAULTS; } });
@@ -32,7 +32,20 @@ Object.defineProperty(exports, "CONFIG_ENV_VARS", { enumerable: true, get: funct
 Object.defineProperty(exports, "getConfig", { enumerable: true, get: function () { return defaults_1.getConfig; } });
 Object.defineProperty(exports, "getGlobalLogDir", { enumerable: true, get: function () { return defaults_1.getGlobalLogDir; } });
 Object.defineProperty(exports, "getGlobalStateDir", { enumerable: true, get: function () { return defaults_1.getGlobalStateDir; } });
+Object.defineProperty(exports, "getConfiguredGlobalStateRoot", { enumerable: true, get: function () { return defaults_1.getConfiguredGlobalStateRoot; } });
 Object.defineProperty(exports, "normalizeSessionStateDir", { enumerable: true, get: function () { return defaults_1.normalizeSessionStateDir; } });
 Object.defineProperty(exports, "validateConfig", { enumerable: true, get: function () { return defaults_1.validateConfig; } });
 Object.defineProperty(exports, "getDefaults", { enumerable: true, get: function () { return defaults_1.getDefaults; } });
 Object.defineProperty(exports, "isValidLogLevel", { enumerable: true, get: function () { return defaults_1.isValidLogLevel; } });
+var runs_1 = require("./runs");
+Object.defineProperty(exports, "findRepoRoot", { enumerable: true, get: function () { return runs_1.findRepoRoot; } });
+Object.defineProperty(exports, "getGlobalRunsDir", { enumerable: true, get: function () { return runs_1.getGlobalRunsDir; } });
+Object.defineProperty(exports, "getReadableRunsDirs", { enumerable: true, get: function () { return runs_1.getReadableRunsDirs; } });
+Object.defineProperty(exports, "getRepoRoot", { enumerable: true, get: function () { return runs_1.getRepoRoot; } });
+Object.defineProperty(exports, "getRepoRunsDir", { enumerable: true, get: function () { return runs_1.getRepoRunsDir; } });
+Object.defineProperty(exports, "getRunsScope", { enumerable: true, get: function () { return runs_1.getRunsScope; } });
+Object.defineProperty(exports, "parseRunsScope", { enumerable: true, get: function () { return runs_1.parseRunsScope; } });
+Object.defineProperty(exports, "resolveExistingRunDir", { enumerable: true, get: function () { return runs_1.resolveExistingRunDir; } });
+Object.defineProperty(exports, "resolveProjectRootForRun", { enumerable: true, get: function () { return runs_1.resolveProjectRootForRun; } });
+Object.defineProperty(exports, "resolveRunRootFromRunDir", { enumerable: true, get: function () { return runs_1.resolveRunRootFromRunDir; } });
+Object.defineProperty(exports, "resolveRunsDir", { enumerable: true, get: function () { return runs_1.resolveRunsDir; } });

package/dist/config/runs.d.ts

@@ -0,0 +1,22 @@
+export type RunsScope = "global" | "repo";
+export declare function parseRunsScope(rawValue?: string): RunsScope;
+export declare function getRunsScope(): RunsScope;
+export declare function findRepoRoot(startDir?: string): string | undefined;
+export declare function getRepoRoot(startDir?: string): string;
+export declare function getRepoRunsDir(startDir?: string): string;
+export declare function getGlobalRunsDir(): string;
+export declare function resolveRunsDir(options?: {
+    cwd?: string;
+    override?: string;
+}): string;
+export declare function getReadableRunsDirs(options?: {
+    cwd?: string;
+    override?: string;
+}): string[];
+export declare function resolveExistingRunDir(runRef: string, options?: {
+    cwd?: string;
+    override?: string;
+}): string;
+export declare function resolveRunRootFromRunDir(runDir: string, cwd?: string): string;
+export declare function resolveProjectRootForRun(runDir: string, entryImportPath?: string, fallbackCwd?: string): string;
+//# sourceMappingURL=runs.d.ts.map

package/dist/config/runs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runs.d.ts","sourceRoot":"","sources":["../../src/config/runs.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,SAAS,GAAG,QAAQ,GAAG,MAAM,CAAC;AA6B1C,wBAAgB,cAAc,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAiB3D;AAED,wBAAgB,YAAY,IAAI,SAAS,CAExC;AAED,wBAAgB,YAAY,CAAC,QAAQ,SAAgB,GAAG,MAAM,GAAG,SAAS,CAgBzE;AAED,wBAAgB,WAAW,CAAC,QAAQ,SAAgB,GAAG,MAAM,CAE5D;AAED,wBAAgB,cAAc,CAAC,QAAQ,SAAgB,GAAG,MAAM,CAE/D;AAED,wBAAgB,gBAAgB,IAAI,MAAM,CAEzC;AAQD,wBAAgB,cAAc,CAAC,OAAO,CAAC,EAAE;IACvC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,GAAG,MAAM,CAYT;AAED,wBAAgB,mBAAmB,CAAC,OAAO,CAAC,EAAE;IAC5C,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,GAAG,MAAM,EAAE,CAKX;AAED,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE;IACR,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,GACA,MAAM,CA8BR;AAED,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,SAAgB,GAAG,MAAM,CASpF;AAED,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,MAAM,EACd,eAAe,CAAC,EAAE,MAAM,EACxB,WAAW,SAAgB,GAC1B,MAAM,CAeR"}

package/dist/config/runs.js

@@ -0,0 +1,192 @@
+"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.parseRunsScope = parseRunsScope;
+exports.getRunsScope = getRunsScope;
+exports.findRepoRoot = findRepoRoot;
+exports.getRepoRoot = getRepoRoot;
+exports.getRepoRunsDir = getRepoRunsDir;
+exports.getGlobalRunsDir = getGlobalRunsDir;
+exports.resolveRunsDir = resolveRunsDir;
+exports.getReadableRunsDirs = getReadableRunsDirs;
+exports.resolveExistingRunDir = resolveExistingRunDir;
+exports.resolveRunRootFromRunDir = resolveRunRootFromRunDir;
+exports.resolveProjectRootForRun = resolveProjectRootForRun;
+const fs = __importStar(require("node:fs"));
+const path = __importStar(require("node:path"));
+const defaults_1 = require("./defaults");
+function normalizeComparablePath(value) {
+    const normalized = path.normalize(path.resolve(value));
+    return process.platform === "win32" ? normalized.toLowerCase() : normalized;
+}
+function dedupePaths(values) {
+    const seen = new Set();
+    const result = [];
+    for (const value of values) {
+        const comparable = normalizeComparablePath(value);
+        if (seen.has(comparable)) {
+            continue;
+        }
+        seen.add(comparable);
+        result.push(path.resolve(value));
+    }
+    return result;
+}
+function isPresentPath(target) {
+    try {
+        return fs.existsSync(target);
+    }
+    catch {
+        return false;
+    }
+}
+function parseRunsScope(rawValue) {
+    const normalized = rawValue?.trim().toLowerCase();
+    switch (normalized) {
+        case "repo":
+        case "project":
+        case "root":
+        case "local":
+            return "repo";
+        case "global":
+        case "home":
+        case "user":
+        case undefined:
+        case "":
+            return "global";
+        default:
+            return "global";
+    }
+}
+function getRunsScope() {
+    return parseRunsScope(process.env[defaults_1.CONFIG_ENV_VARS.RUNS_SCOPE]);
+}
+function findRepoRoot(startDir = process.cwd()) {
+    let current = path.resolve(startDir);
+    let reachedRoot = false;
+    while (!reachedRoot) {
+        if (isPresentPath(path.join(current, ".git")) || isPresentPath(path.join(current, ".a5c"))) {
+            return current;
+        }
+        const parent = path.dirname(current);
+        if (parent === current) {
+            reachedRoot = true;
+            continue;
+        }
+        current = parent;
+    }
+    return undefined;
+}
+function getRepoRoot(startDir = process.cwd()) {
+    return findRepoRoot(startDir) ?? path.resolve(startDir);
+}
+function getRepoRunsDir(startDir = process.cwd()) {
+    return path.join(getRepoRoot(startDir), ".a5c", "runs");
+}
+function getGlobalRunsDir() {
+    return path.join((0, defaults_1.getConfiguredGlobalStateRoot)(), "runs");
+}
+function resolveRelativeRunsDir(value, cwd) {
+    const scope = getRunsScope();
+    const baseDir = scope === "repo" ? getRepoRoot(cwd) : (0, defaults_1.getConfiguredGlobalStateRoot)();
+    return path.resolve(baseDir, value);
+}
+function resolveRunsDir(options) {
+    const cwd = options?.cwd ?? process.cwd();
+    const explicit = options?.override?.trim() || process.env[defaults_1.CONFIG_ENV_VARS.RUNS_DIR]?.trim();
+    if (explicit) {
+        return path.isAbsolute(explicit)
+            ? path.resolve(explicit)
+            : resolveRelativeRunsDir(explicit, cwd);
+    }
+    return getRunsScope() === "repo"
+        ? getRepoRunsDir(cwd)
+        : getGlobalRunsDir();
+}
+function getReadableRunsDirs(options) {
+    const cwd = options?.cwd ?? process.cwd();
+    const primary = resolveRunsDir({ cwd, override: options?.override });
+    const legacyRepo = getRepoRunsDir(cwd);
+    return dedupePaths([primary, legacyRepo]);
+}
+function resolveExistingRunDir(runRef, options) {
+    const cwd = options?.cwd ?? process.cwd();
+    const readableRoots = getReadableRunsDirs({ cwd, override: options?.override });
+    const repoRoot = getRepoRoot(cwd);
+    if (path.isAbsolute(runRef)) {
+        return path.resolve(runRef);
+    }
+    const normalizedRef = runRef.replace(/\\/g, "/");
+    const looksLikePath = normalizedRef.includes("/") ||
+        normalizedRef.includes(".a5c/") ||
+        normalizedRef === "." ||
+        normalizedRef === "..";
+    const candidates = looksLikePath
+        ? dedupePaths([
+            path.resolve(cwd, runRef),
+            path.resolve(repoRoot, runRef),
+        ])
+        : readableRoots.map((root) => path.join(root, runRef));
+    for (const candidate of candidates) {
+        if (isPresentPath(path.join(candidate, "run.json"))) {
+            return candidate;
+        }
+    }
+    return candidates[0];
+}
+function resolveRunRootFromRunDir(runDir, cwd = process.cwd()) {
+    const absoluteRunDir = path.resolve(runDir);
+    for (const candidateRoot of getReadableRunsDirs({ cwd })) {
+        const relative = path.relative(candidateRoot, absoluteRunDir);
+        if (!relative.startsWith("..") && !path.isAbsolute(relative)) {
+            return candidateRoot;
+        }
+    }
+    return path.dirname(absoluteRunDir);
+}
+function resolveProjectRootForRun(runDir, entryImportPath, fallbackCwd = process.cwd()) {
+    if (entryImportPath?.trim()) {
+        const absoluteEntrypoint = path.resolve(runDir, entryImportPath);
+        const repoRoot = findRepoRoot(path.dirname(absoluteEntrypoint));
+        if (repoRoot) {
+            return repoRoot;
+        }
+    }
+    const cwdRepoRoot = findRepoRoot(fallbackCwd);
+    if (cwdRepoRoot) {
+        return cwdRepoRoot;
+    }
+    return path.dirname(resolveRunRootFromRunDir(runDir, fallbackCwd));
+}