@a5c-ai/babysitter-sdk 0.0.188-staging.e72bed21 → 0.0.188-staging.ee1aa82e

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

@@ -1 +1 @@
-{"version":3,"file":"harnessPhase1.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/harnessPhase1.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,QAAQ,MAAM,eAAe,CAAC;AAa1C,OAAO,EAIL,KAAK,2BAA2B,EAEhC,KAAK,iBAAiB,EAGtB,KAAK,oBAAoB,IAAI,0BAA0B,EAyBxD,MAAM,gBAAgB,CAAC;AAkBxB,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAE3D;AAED,kDAAkD;AAClD,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAE/D;AA0HD,wBAAgB,eAAe,CAC7B,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EAAE,EACd,GAAG,CAAC,EAAE,MAAM,GACX,OAAO,CAAC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC,CAyB/D;AA85BD,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAmDzE;AAED,wBAAgB,sCAAsC,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,EAAE,CAU/F;AAED,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAgBrE;AAED,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAwBhG;AAiHD,wBAAgB,oCAAoC,CAAC,IAAI,EAAE;IACzD,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,0BAA0B,CAAC;IAC1C,mBAAmB,EAAE,2BAA2B,CAAC;CAClD,GAAG,MAAM,CA+ET;AAED,wBAAgB,qCAAqC,CAAC,IAAI,EAAE;IAC1D,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;CAChB,GAAG,MAAM,CA4BT;AAsND,wBAAsB,yBAAyB,CAAC,IAAI,EAAE;IACpD,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,OAAO,CAAC;IACrB,EAAE,EAAE,QAAQ,CAAC,SAAS,GAAG,IAAI,CAAC;IAC9B,IAAI,EAAE,OAAO,CAAC;IACd,OAAO,EAAE,OAAO,CAAC;IACjB,iBAAiB,EAAE,iBAAiB,GAAG,IAAI,CAAC;IAC5C,aAAa,EAAE,0BAA0B,CAAC;IAC1C,mBAAmB,EAAE,MAAM,CAAC;IAC5B,UAAU,CAAC,EAAE,OAAO,gBAAgB,EAAE,UAAU,CAAC;CAClD,GAAG,OAAO,CAAC,MAAM,CAAC,CAujBlB"}
+{"version":3,"file":"harnessPhase1.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/harnessPhase1.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,QAAQ,MAAM,eAAe,CAAC;AAa1C,OAAO,EAIL,KAAK,2BAA2B,EAEhC,KAAK,iBAAiB,EAGtB,KAAK,oBAAoB,IAAI,0BAA0B,EAwBxD,MAAM,gBAAgB,CAAC;AAkBxB,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAE3D;AAED,kDAAkD;AAClD,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAE/D;AA0HD,wBAAgB,eAAe,CAC7B,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EAAE,EACd,GAAG,CAAC,EAAE,MAAM,GACX,OAAO,CAAC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC,CAyB/D;AAmzBD,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAmDzE;AAED,wBAAgB,sCAAsC,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,EAAE,CAU/F;AAED,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAgBrE;AAED,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAwBhG;AAiHD,wBAAgB,oCAAoC,CAAC,IAAI,EAAE;IACzD,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,0BAA0B,CAAC;IAC1C,mBAAmB,EAAE,2BAA2B,CAAC;CAClD,GAAG,MAAM,CA+ET;AAED,wBAAgB,qCAAqC,CAAC,IAAI,EAAE;IAC1D,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;CAChB,GAAG,MAAM,CA4BT;AAsND,wBAAsB,yBAAyB,CAAC,IAAI,EAAE;IACpD,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,OAAO,CAAC;IACrB,EAAE,EAAE,QAAQ,CAAC,SAAS,GAAG,IAAI,CAAC;IAC9B,IAAI,EAAE,OAAO,CAAC;IACd,OAAO,EAAE,OAAO,CAAC;IACjB,iBAAiB,EAAE,iBAAiB,GAAG,IAAI,CAAC;IAC5C,aAAa,EAAE,0BAA0B,CAAC;IAC1C,mBAAmB,EAAE,MAAM,CAAC;IAC5B,UAAU,CAAC,EAAE,OAAO,gBAAgB,EAAE,UAAU,CAAC;CAClD,GAAG,OAAO,CAAC,MAAM,CAAC,CAsjBlB"}

package/dist/cli/commands/harnessPhase1.js

@@ -817,100 +817,17 @@ async function resolvePhase1ProcessLibraryRoot(scope = "binding") {
         active,
     };
 }
-function parseRipgrepMatchLine(line, root) {
-    const match = line.match(/^(.*):([0-9]+):(.*)$/);
-    if (!match) {
-        return null;
-    }
-    const absolutePath = path.resolve(match[1] ?? "");
-    if (!isPathWithinRoot(root, absolutePath)) {
-        return null;
-    }
-    return {
-        path: path.relative(root, absolutePath) || path.basename(absolutePath),
-        line: Number(match[2] ?? "0"),
-        excerpt: (match[3] ?? "").trim(),
-    };
-}
-async function searchProcessLibrary(query, scope = "binding", limit = harnessUtils_1.PROCESS_LIBRARY_SEARCH_DEFAULT_LIMIT) {
+async function searchProcessLibrary(query, scope = "binding") {
     const trimmedQuery = query.trim();
-    if (!trimmedQuery) {
-        throw new harnessUtils_1.BabysitterRuntimeError("ProcessLibrarySearchQueryMissing", "Process-library search query must not be empty.", { category: harnessUtils_1.ErrorCategory.Validation });
-    }
-    const normalizedLimit = Math.max(1, Math.min(limit, 40));
     const { root } = await resolvePhase1ProcessLibraryRoot(scope);
-    const matches = [];
-    const seen = new Set();
-    const contentResult = await execShellEffect("rg", [
-        "-n",
-        "--no-heading",
-        "--color",
-        "never",
-        "--max-count",
-        "2",
-        "--max-filesize",
-        "256K",
-        "-S",
-        trimmedQuery,
-        root,
-    ], root);
-    if (contentResult.exitCode === 0 || contentResult.exitCode === 1) {
-        for (const line of contentResult.stdout.split(/\r?\n/)) {
-            if (!line.trim()) {
-                continue;
-            }
-            const parsed = parseRipgrepMatchLine(line, root);
-            if (!parsed) {
-                continue;
-            }
-            const key = `content:${parsed.path}:${parsed.line}`;
-            if (seen.has(key)) {
-                continue;
-            }
-            seen.add(key);
-            matches.push({
-                kind: "content",
-                path: parsed.path,
-                line: parsed.line,
-                excerpt: parsed.excerpt,
-            });
-            if (matches.length >= normalizedLimit) {
-                break;
-            }
-        }
-    }
-    if (matches.length < normalizedLimit) {
-        const filesResult = await execShellEffect("rg", ["--files", root], root);
-        if (filesResult.exitCode === 0 || filesResult.exitCode === 1) {
-            const loweredQuery = trimmedQuery.toLowerCase();
-            for (const entry of filesResult.stdout.split(/\r?\n/)) {
-                const relativePath = entry.trim();
-                if (!relativePath) {
-                    continue;
-                }
-                if (!relativePath.toLowerCase().includes(loweredQuery)) {
-                    continue;
-                }
-                const key = `path:${relativePath}`;
-                if (seen.has(key)) {
-                    continue;
-                }
-                seen.add(key);
-                matches.push({
-                    kind: "path",
-                    path: relativePath,
-                });
-                if (matches.length >= normalizedLimit) {
-                    break;
-                }
-            }
-        }
-    }
+    const libraryRoot = path.join(root, "library");
     return {
         scope,
         root,
+        libraryRoot,
         query: trimmedQuery,
-        matches,
+        matches: [],
+        instructions: `To search the process library, please use your run_shell_command tool to run 'rg' (ripgrep) inside the library directory: ${libraryRoot.replace(/\\/g, '\\\\')}. For example: run_shell_command({ command: "rg 'your-pattern'", dir_path: "${libraryRoot.replace(/\\/g, '\\\\')}" })`,
     };
 }
 async function readProcessLibraryFile(relativePath, scope = "binding") {
@@ -1431,7 +1348,7 @@ async function runProcessDefinitionPhase(args) {
         {
             name: "babysitter_search_process_library",
             label: "Search Process Library",
-            description: "Search the active shared process library by content and path before authoring a process.",
+            description: "Retrieve the active shared process library root path and instructions on how to search it. Use this before authoring a process.",
             parameters: typebox_1.Type.Object({
                 query: typebox_1.Type.String(),
                 scope: typebox_1.Type.Optional(typebox_1.Type.Union([
@@ -1443,7 +1360,7 @@ async function runProcessDefinitionPhase(args) {
             }),
             execute: async (_toolCallId, params) => {
                 writeVerboseData("phase1 tool babysitter_search_process_library request", params);
-                const result = await searchProcessLibrary(params.query, params.scope ?? "binding", params.limit);
+                const result = await searchProcessLibrary(params.query, params.scope ?? "binding");
                 writeVerboseData("phase1 tool babysitter_search_process_library result", result, 2000);
                 return (0, harnessUtils_1.formatToolResult)(result, "Process-library search completed.");
             },

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

@@ -1 +1 @@
-{"version":3,"file":"harnessPhase2.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/harnessPhase2.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,QAAQ,MAAM,eAAe,CAAC;AAoB1C,OAAO,EAOL,KAAK,mBAAmB,EACxB,KAAK,iBAAiB,EACtB,KAAK,sBAAsB,EAI3B,KAAK,oBAAoB,IAAI,0BAA0B,EACvD,KAAK,YAAY,EAkCjB,eAAe,EAIhB,MAAM,gBAAgB,CAAC;AAQxB;;;;GAIG;AACH,eAAO,MAAM,wBAAwB,IAAI,CAAC;AAC1C,eAAO,MAAM,sBAAsB,IAAI,CAAC;AAExC;;;;;GAKG;AACH,eAAO,MAAM,4BAA4B,IAAI,CAAC;AAiH9C,wBAAsB,aAAa,CACjC,MAAM,EAAE,YAAY,EACpB,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE;IACP,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,iBAAiB,CAAC,EAAE,iBAAiB,GAAG,IAAI,CAAC;IAC7C,SAAS,CAAC,EAAE,OAAO,qBAAqB,EAAE,sBAAsB,CAAC;CAClE,EACD,SAAS,CAAC,EAAE,eAAe,GAAG,IAAI,EAClC,UAAU,CAAC,EAAE,sBAAsB,EAAE,EACrC,EAAE,CAAC,EAAE,QAAQ,CAAC,SAAS,GAAG,IAAI,EAC9B,IAAI,CAAC,EAAE,OAAO,EACd,sBAAsB,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,OAAO,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC,GAAG,IAAI,GACtE,OAAO,CAAC,mBAAmB,CAAC,CA2O9B;AAyOD,wBAAsB,qBAAqB,CAAC,IAAI,EAAE;IAChD,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,MAAM,CAAC;IACtB,IAAI,EAAE,OAAO,CAAC;IACd,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,EAAE,OAAO,CAAC;IACrB,EAAE,EAAE,QAAQ,CAAC,SAAS,GAAG,IAAI,CAAC;IAC9B,mBAAmB,EAAE,MAAM,CAAC;IAC5B,UAAU,EAAE,sBAAsB,EAAE,CAAC;IACrC,iBAAiB,EAAE,iBAAiB,GAAG,IAAI,CAAC;IAC5C,aAAa,EAAE,0BAA0B,CAAC;IAC1C,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,UAAU,CAAC,EAAE,OAAO,gBAAgB,EAAE,UAAU,CAAC;CAClD,GAAG,OAAO,CAAC,MAAM,CAAC,CA8vDlB"}
+{"version":3,"file":"harnessPhase2.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/harnessPhase2.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,QAAQ,MAAM,eAAe,CAAC;AAoB1C,OAAO,EAOL,KAAK,mBAAmB,EACxB,KAAK,iBAAiB,EACtB,KAAK,sBAAsB,EAI3B,KAAK,oBAAoB,IAAI,0BAA0B,EACvD,KAAK,YAAY,EAkCjB,eAAe,EAIhB,MAAM,gBAAgB,CAAC;AAQxB;;;;GAIG;AACH,eAAO,MAAM,wBAAwB,IAAI,CAAC;AAC1C,eAAO,MAAM,sBAAsB,IAAI,CAAC;AAExC;;;;;GAKG;AACH,eAAO,MAAM,4BAA4B,IAAI,CAAC;AA4I9C,wBAAsB,aAAa,CACjC,MAAM,EAAE,YAAY,EACpB,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE;IACP,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,iBAAiB,CAAC,EAAE,iBAAiB,GAAG,IAAI,CAAC;IAC7C,SAAS,CAAC,EAAE,OAAO,qBAAqB,EAAE,sBAAsB,CAAC;CAClE,EACD,SAAS,CAAC,EAAE,eAAe,GAAG,IAAI,EAClC,UAAU,CAAC,EAAE,sBAAsB,EAAE,EACrC,EAAE,CAAC,EAAE,QAAQ,CAAC,SAAS,GAAG,IAAI,EAC9B,IAAI,CAAC,EAAE,OAAO,EACd,sBAAsB,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,OAAO,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC,GAAG,IAAI,GACtE,OAAO,CAAC,mBAAmB,CAAC,CA2O9B;AAyOD,wBAAsB,qBAAqB,CAAC,IAAI,EAAE;IAChD,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,MAAM,CAAC;IACtB,IAAI,EAAE,OAAO,CAAC;IACd,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,EAAE,OAAO,CAAC;IACrB,EAAE,EAAE,QAAQ,CAAC,SAAS,GAAG,IAAI,CAAC;IAC9B,mBAAmB,EAAE,MAAM,CAAC;IAC5B,UAAU,EAAE,sBAAsB,EAAE,CAAC;IACrC,iBAAiB,EAAE,iBAAiB,GAAG,IAAI,CAAC;IAC5C,aAAa,EAAE,0BAA0B,CAAC;IAC1C,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,UAAU,CAAC,EAAE,OAAO,gBAAgB,EAAE,UAAU,CAAC;CAClD,GAAG,OAAO,CAAC,MAAM,CAAC,CAqwDlB"}

package/dist/cli/commands/harnessPhase2.js

@@ -183,6 +183,24 @@ function subscribeVerbosePiEvents(session, label, opts) {
         return null;
     }
 }
+function resolveHarnessSessionIdForBinding(args, adapter, orchestrationSession) {
+    if ((0, harnessUtils_1.isInternalHarness)(args.selectedHarnessName) &&
+        orchestrationSession?.sessionId) {
+        process.env.PI_SESSION_ID = process.env.PI_SESSION_ID || orchestrationSession.sessionId;
+        process.env.OMP_SESSION_ID = process.env.OMP_SESSION_ID || orchestrationSession.sessionId;
+    }
+    const resolved = adapter.resolveSessionId({});
+    if (resolved) {
+        return resolved;
+    }
+    if (args.selectedHarnessName === "codex") {
+        return process.env.CODEX_THREAD_ID || process.env.CODEX_SESSION_ID;
+    }
+    if ((0, harnessUtils_1.isInternalHarness)(args.selectedHarnessName)) {
+        return orchestrationSession?.sessionId;
+    }
+    return undefined;
+}
 // ── Effect Resolution ────────────────────────────────────────────────
 async function resolveEffect(action, harnessName, options, piSession, discovered, rl, json, askUserQuestionHandler) {
     const kind = action.kind;
@@ -642,16 +660,18 @@ async function runOrchestrationPhase(args) {
             if (!adapter) {
                 throw new harnessUtils_1.BabysitterRuntimeError("HarnessAdapterMissing", `No harness adapter is registered for ${args.selectedHarnessName}.`, { category: harnessUtils_1.ErrorCategory.Configuration });
             }
-            const sessionId = adapter.resolveSessionId({}) || process.env.CODEX_THREAD_ID || process.env.CODEX_SESSION_ID;
+            const sessionId = resolveHarnessSessionIdForBinding(args, adapter);
             if (!sessionId) {
                 throw new harnessUtils_1.BabysitterRuntimeError("MissingHarnessSessionId", `Cannot resolve a session ID for harness ${args.selectedHarnessName}.`, { category: harnessUtils_1.ErrorCategory.Configuration });
             }
+            const pluginRoot = adapter.resolvePluginRoot({});
+            const stateDir = adapter.resolveStateDir({ pluginRoot });
             state.sessionBound = await adapter.bindSession({
                 sessionId,
                 runId: state.runId,
                 runDir: state.runDir,
-                pluginRoot: adapter.resolvePluginRoot({}),
-                stateDir: path.resolve(args.workspace ?? process.cwd(), ".a5c"),
+                pluginRoot,
+                stateDir,
                 runsDir: args.runsDir,
                 maxIterations: args.maxIterations,
                 prompt: args.prompt ?? "",
@@ -1029,21 +1049,18 @@ async function runOrchestrationPhase(args) {
                     if (!adapter) {
                         throw new harnessUtils_1.BabysitterRuntimeError("HarnessAdapterMissing", `No harness adapter is registered for ${args.selectedHarnessName}.`, { category: harnessUtils_1.ErrorCategory.Configuration });
                     }
-                    if ((0, harnessUtils_1.isInternalHarness)(args.selectedHarnessName) &&
-                        orchestrationSession?.sessionId) {
-                        process.env.PI_SESSION_ID = process.env.PI_SESSION_ID || orchestrationSession.sessionId;
-                        process.env.OMP_SESSION_ID = process.env.OMP_SESSION_ID || orchestrationSession.sessionId;
-                    }
-                    const sessionId = adapter.resolveSessionId({}) || orchestrationSession?.sessionId;
+                    const sessionId = resolveHarnessSessionIdForBinding(args, adapter, orchestrationSession);
                     if (!sessionId) {
                         throw new harnessUtils_1.BabysitterRuntimeError("MissingHarnessSessionId", `Cannot resolve a session ID for harness ${args.selectedHarnessName}.`, { category: harnessUtils_1.ErrorCategory.Configuration });
                     }
+                    const pluginRoot = adapter.resolvePluginRoot({});
+                    const stateDir = adapter.resolveStateDir({ pluginRoot });
                     state.sessionBound = await adapter.bindSession({
                         sessionId,
                         runId: state.runId,
                         runDir: state.runDir,
-                        pluginRoot: adapter.resolvePluginRoot({}),
-                        stateDir: path.resolve(args.workspace ?? process.cwd(), ".a5c"),
+                        pluginRoot,
+                        stateDir,
                         runsDir: args.runsDir,
                         maxIterations: args.maxIterations,
                         prompt: args.prompt ?? "",
@@ -1646,6 +1663,10 @@ async function runOrchestrationPhase(args) {
                 if (!orchestrationStateAdvanced(progressSnapshot)) {
                     throw new harnessUtils_1.BabysitterRuntimeError("OrchestrationAgentFailed", result.output, { category: harnessUtils_1.ErrorCategory.External });
                 }
+                if (state.lastIterationResult?.status === "process-error") {
+                    writeVerbose(`[phase2 recovery] continuing after a late orchestration prompt failure because babysitter_run_iterate already returned a recoverable process-error: ${result.output}`);
+                    return;
+                }
                 if (!(0, harnessUtils_1.isIgnorablePiPromptFailure)(result.output)) {
                     throw new harnessUtils_1.BabysitterRuntimeError("OrchestrationAgentFailed", result.output, { category: harnessUtils_1.ErrorCategory.External });
                 }

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;AAsBH,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;AA+JD;;GAEG;AACH,wBAAsB,yBAAyB,CAC7C,IAAI,EAAE,uBAAuB,GAC5B,OAAO,CAAC,MAAM,CAAC,CA6FjB"}
+{"version":3,"file":"instructions.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/instructions.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AA0BH,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;AA+JD;;GAEG;AACH,wBAAsB,yBAAyB,CAC7C,IAAI,EAAE,uBAAuB,GAC5B,OAAO,CAAC,MAAM,CAAC,CA2HjB"}

package/dist/cli/commands/instructions.js

@@ -195,6 +195,12 @@ async function handleInstructionsCommand(args) {
     if (!hooksActive) {
         hookOverride.hookDriven = false;
     }
+    // Detect execution context (CI, trigger, branch, actor) and derive
+    // capability flags so the babysit skill can select context-appropriate
+    // library processes when dispatching (e.g. GitHub collaboration,
+    // scheduled reporting, local-dev relaxations).
+    const executionContext = (0, prompts_1.detectExecutionContext)();
+    const capabilityFlags = (0, prompts_1.deriveCapabilityFlags)(executionContext);
     const ctx = factory({
         interactive: args.interactive,
         ...libraryInfo,
@@ -218,6 +224,9 @@ async function handleInstructionsCommand(args) {
             promptType: composer.promptType,
             hookDriven: ctx.hookDriven,
             hooksDetected: hooksActive,
+            executionContext,
+            capabilityFlags,
+            suggestedProcesses: (0, prompts_1.processPathsForCapabilities)(capabilityFlags),
             content,
             partsIncluded: composer.partsIncluded,
         }, null, 2));
@@ -229,7 +238,27 @@ async function handleInstructionsCommand(args) {
             // clarifies the JSON output. The text output is self-explanatory
             // from the generated instructions.
         }
-        console.log(content);
+        const activeCapabilities = Object.entries(capabilityFlags)
+            .filter(([, v]) => v === true)
+            .map(([k]) => k);
+        const contextHeader = [
+            '## Execution Context',
+            '',
+            `- CI: \`${executionContext.ci}\``,
+            `- Trigger: \`${executionContext.trigger}\``,
+            executionContext.branch.ref ? `- Branch: \`${executionContext.branch.ref}\`` : undefined,
+            executionContext.repo ? `- Repo: \`${executionContext.repo.owner}/${executionContext.repo.name}\`` : undefined,
+            executionContext.actor ? `- Actor: \`${executionContext.actor.login}\`${executionContext.actor.isBot ? ' (bot)' : ''}` : undefined,
+            '',
+            `Active context capabilities: ${activeCapabilities.length > 0 ? activeCapabilities.map(c => `\`${c}\``).join(', ') : '_(none)_'}`,
+            '',
+            'When selecting library processes to dispatch, prefer those whose triggers match the active capabilities above.',
+            '',
+            '---',
+            '',
+        ].filter((l) => l !== undefined).join('\n');
+        const processGuide = (0, prompts_1.renderCapabilityProcessGuide)(capabilityFlags);
+        console.log(contextHeader + processGuide + content);
     }
     return 0;
 }

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

@@ -1 +1 @@
-{"version":3,"file":"sessionWhoami.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/sessionWhoami.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAeH,MAAM,WAAW,iBAAiB;IAChC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,YAAY,EAAE,YAAY,GAAG,UAAU,GAAG,SAAS,GAAG,UAAU,GAAG,MAAM,CAAC;IAC1E,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,aAAa,EAAE,OAAO,GAAG,IAAI,CAAC;IAC9B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,aAAa,EAAE,OAAO,CAAC;IACvB,aAAa,EAAE,OAAO,GAAG,IAAI,CAAC;CAC/B;AA6ED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,iBAAiB,GAAG,mBAAmB,CAI7E;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,iBAAiB,GAAG,MAAM,CAgBnE"}
+{"version":3,"file":"sessionWhoami.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/sessionWhoami.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAgBH,MAAM,WAAW,iBAAiB;IAChC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,YAAY,EAAE,YAAY,GAAG,UAAU,GAAG,SAAS,GAAG,UAAU,GAAG,MAAM,CAAC;IAC1E,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,aAAa,EAAE,OAAO,GAAG,IAAI,CAAC;IAC9B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,aAAa,EAAE,OAAO,CAAC;IACvB,aAAa,EAAE,OAAO,GAAG,IAAI,CAAC;CAC/B;AAsFD,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,iBAAiB,GAAG,mBAAmB,CAI7E;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,iBAAiB,GAAG,MAAM,CAgBnE"}

package/dist/cli/commands/sessionWhoami.js

@@ -8,9 +8,10 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.runSessionWhoami = runSessionWhoami;
 exports.handleSessionWhoami = handleSessionWhoami;
 const claudeCode_1 = require("../../harness/claudeCode");
-const sessionMarker_1 = require("../../harness/sessionMarker");
+const sessionMarker_1 = require("../../utils/sessionMarker");
 const processLiveness_1 = require("../../utils/processLiveness");
 const harness_1 = require("../../harness");
+const discovery_1 = require("../../session/discovery");
 function resolveClaudeCode() {
     const details = (0, claudeCode_1.resolveSessionIdDetailed)();
     const markerPath = details.ancestorPid !== null
@@ -54,19 +55,29 @@ function resolveGenericHarness(harness) {
     const ancestorAlive = ancestorPid !== null ? (0, processLiveness_1.isProcessAlive)(ancestorPid) : null;
     const markerSessionId = (0, sessionMarker_1.readSessionMarker)(harness);
     const markerPath = ancestorPid !== null ? (0, sessionMarker_1.getSessionMarkerPath)(harness, ancestorPid) : null;
+    const harnessEnvSessionId = (discovery_1.HARNESS_ENV_VARS[harness] || [])
+        .map((key) => process.env[key])
+        .find((value) => Boolean(value));
+    const babysitterEnvSessionId = process.env.BABYSITTER_SESSION_ID;
     let resolvedFrom = "none";
     let finalSessionId = sessionId ?? markerSessionId;
-    if (markerSessionId && (!sessionId || sessionId === markerSessionId)) {
-        resolvedFrom = "pid-marker";
-        finalSessionId = markerSessionId;
+    if (sessionId && harnessEnvSessionId && sessionId === harnessEnvSessionId) {
+        resolvedFrom = "env-var";
+        finalSessionId = sessionId;
     }
-    else if (sessionId && process.env.BABYSITTER_SESSION_ID === sessionId) {
+    else if (sessionId && babysitterEnvSessionId && sessionId === babysitterEnvSessionId) {
         resolvedFrom = "env-var";
+        finalSessionId = sessionId;
+    }
+    else if (markerSessionId && (!sessionId || sessionId === markerSessionId)) {
+        resolvedFrom = "pid-marker";
+        finalSessionId = markerSessionId;
     }
     else if (sessionId) {
         resolvedFrom = "env-var";
+        finalSessionId = sessionId;
     }
-    const envVar = process.env.BABYSITTER_SESSION_ID;
+    const envVar = babysitterEnvSessionId;
     const envVarPresent = Boolean(envVar);
     let envVarMatches;
     if (!envVarPresent)

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

@@ -1 +1 @@
-{"version":3,"file":"main.d.ts","sourceRoot":"","sources":["../../src/cli/main.ts"],"names":[],"mappings":";AAKA,OAAO,EAAE,sBAAsB,IAAI,6BAA6B,EAAoB,MAAM,oBAAoB,CAAC;AAw6B/G;;;;;;;;;GASG;AACH,iBAAS,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CA8BlE;AAOD,2EAA2E;AAC3E,QAAA,MAAM,sBAAsB,sCAAgC,CAAC;AAy1D7D,OAAO,EAAE,aAAa,IAAI,cAAc,EAAE,sBAAsB,IAAI,uBAAuB,EAAE,CAAC;AAE9F,wBAAgB,mBAAmB;eAEf,MAAM,EAAE,GAA2B,OAAO,CAAC,MAAM,CAAC;kBAswBpD,MAAM;EAIvB"}
+{"version":3,"file":"main.d.ts","sourceRoot":"","sources":["../../src/cli/main.ts"],"names":[],"mappings":";AAKA,OAAO,EAAE,sBAAsB,IAAI,6BAA6B,EAAoB,MAAM,oBAAoB,CAAC;AAw6B/G;;;;;;;;;GASG;AACH,iBAAS,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CA8BlE;AAOD,2EAA2E;AAC3E,QAAA,MAAM,sBAAsB,sCAAgC,CAAC;AAy4D7D,OAAO,EAAE,aAAa,IAAI,cAAc,EAAE,sBAAsB,IAAI,uBAAuB,EAAE,CAAC;AAE9F,wBAAgB,mBAAmB;eAEf,MAAM,EAAE,GAA2B,OAAO,CAAC,MAAM,CAAC;kBAswBpD,MAAM;EAIvB"}

package/dist/cli/main.js

@@ -1740,10 +1740,16 @@ async function handleTaskPost(parsed) {
                 };
     }
     const invocationKey = parsed.invocationKey ?? record.invocationKey;
+    const normalizedShellFailure = parsed.taskStatus === "error" && record.kind === "shell";
+    const committedStatus = normalizedShellFailure ? "ok" : parsed.taskStatus;
+    const committedValue = normalizedShellFailure
+        ? coerceShellFailureResult(errorPayload, stdout, stderr)
+        : value;
     const plan = {
         runDir: toRunRelativePosix(runDir, runDir) ?? runDir,
         effectId: parsed.effectId,
-        status: parsed.taskStatus,
+        status: committedStatus,
+        normalizedShellFailure,
         valueProvided: parsed.valuePath || parsed.valueInline ? true : false,
         errorProvided: parsed.errorPath ? true : false,
         stdoutRef: parsed.stdoutRef ?? null,
@@ -1765,10 +1771,10 @@ async function handleTaskPost(parsed) {
         runDir,
         effectId: parsed.effectId,
         invocationKey,
-        result: parsed.taskStatus === "ok"
+        result: committedStatus === "ok"
             ? {
                 status: "ok",
-                value,
+                value: committedValue,
                 stdout,
                 stderr,
                 stdoutRef: parsed.stdoutRef,
@@ -1794,7 +1800,8 @@ async function handleTaskPost(parsed) {
     const resultRef = normalizeArtifactRef(runDir, committed.resultRef) ?? null;
     if (parsed.json) {
         console.log(JSON.stringify({
-            status: parsed.taskStatus,
+            status: committedStatus,
+            normalizedShellFailure,
             committed,
             stdoutRef,
             stderrRef,
@@ -1802,7 +1809,9 @@ async function handleTaskPost(parsed) {
         }));
     }
     else {
-        const parts = [`[task:post] status=${parsed.taskStatus}`];
+        const parts = [`[task:post] status=${committedStatus}`];
+        if (normalizedShellFailure)
+            parts.push("normalizedShellFailure=true");
         if (stdoutRef)
             parts.push(`stdoutRef=${stdoutRef}`);
         if (stderrRef)
@@ -1811,7 +1820,33 @@ async function handleTaskPost(parsed) {
             parts.push(`resultRef=${resultRef}`);
         console.log(parts.join(" "));
     }
-    return parsed.taskStatus === "ok" ? 0 : 1;
+    return committedStatus === "ok" ? 0 : 1;
+}
+function coerceShellFailureResult(errorPayload, stdout, stderr) {
+    const payloadData = isJsonRecord(errorPayload)
+        ? (isJsonRecord(errorPayload.data) ? errorPayload.data : errorPayload)
+        : undefined;
+    const exitCode = readNumericField(payloadData, "exitCode") ?? 1;
+    const normalizedStdout = stdout ?? readStringField(payloadData, "stdout") ?? "";
+    const normalizedStderr = stderr ?? readStringField(payloadData, "stderr") ?? "";
+    const errorMessage = readStringField(payloadData, "error")
+        ?? readStringField(payloadData, "message")
+        ?? `Shell command exited with code ${exitCode}`;
+    return {
+        success: false,
+        exitCode,
+        stdout: normalizedStdout,
+        stderr: normalizedStderr,
+        error: errorMessage,
+    };
+}
+function readStringField(value, key) {
+    const candidate = value?.[key];
+    return typeof candidate === "string" ? candidate : undefined;
+}
+function readNumericField(value, key) {
+    const candidate = value?.[key];
+    return typeof candidate === "number" && Number.isFinite(candidate) ? candidate : undefined;
 }
 async function handleTaskCancel(parsed) {
     if (!parsed.runDirArg || !parsed.effectId) {

package/dist/config/defaults.d.ts

@@ -111,6 +111,15 @@ export declare const CONFIG_ENV_VARS: {
  * They can be overridden via environment variables or explicit config.
  */
 export declare const DEFAULTS: Readonly<BabysitterConfig>;
+/**
+ * Normalizes a session-state directory path.
+ *
+ * The canonical session-state location is `<global-root>/state`. Older
+ * callers sometimes pass `<global-root>` itself (for example `~/.a5c`).
+ * Normalize that legacy/root-style input to the real session-state directory
+ * so hooks can still find `<sessionId>.md`.
+ */
+export declare function normalizeSessionStateDir(stateDir?: string): string;
 /**
  * Returns the global babysitter state directory (~/.a5c/state/).
  *

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;;;OAGG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB;;;OAGG;IACH,aAAa,EAAE,MAAM,CAAC;IAEtB;;;OAGG;IACH,gBAAgB,EAAE,MAAM,CAAC;IAEzB;;;OAGG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB;;;OAGG;IACH,QAAQ,EAAE,QAAQ,CAAC;IAEnB;;;OAGG;IACH,eAAe,EAAE,OAAO,CAAC;IAEzB;;;OAGG;IACH,WAAW,EAAE,MAAM,CAAC;IAEpB;;;OAGG;IACH,eAAe,EAAE,MAAM,CAAC;IAExB;;;OAGG;IACH,WAAW,EAAE,MAAM,CAAC;IAEpB;;;OAGG;IACH,YAAY,EAAE,MAAM,CAAC;IAErB;;;OAGG;IACH,aAAa,EAAE,MAAM,CAAC;IAEtB;;;OAGG;IACH,uBAAuB,EAAE,MAAM,CAAC;CACjC;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC;;OAEG;IACH,KAAK,EAAE,OAAO,CAAC;IAEf;;OAEG;IACH,MAAM,EAAE,MAAM,EAAE,CAAC;IAEjB;;OAEG;IACH,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED;;GAEG;AACH,eAAO,MAAM,eAAe;;;;;;;;;CASlB,CAAC;AAEX;;;;;GAKG;AACH,eAAO,MAAM,QAAQ,EAAE,QAAQ,CAAC,gBAAgB,CAwEtC,CAAC;AAEX;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,CAQ1C;AAED;;;;;;;;GAQG;AACH,wBAAgB,eAAe,IAAI,MAAM,CAQxC;AAiDD;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,SAAS,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC,gBAAgB,CAAC,GAAG,gBAAgB,CAqCjF;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,gBAAgB,GAAG,sBAAsB,CA2E/E;AAED;;;;GAIG;AACH,wBAAgB,WAAW,IAAI,QAAQ,CAAC,gBAAgB,CAAC,CAExD;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,QAAQ,CAEjE"}
+{"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;;;OAGG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB;;;OAGG;IACH,aAAa,EAAE,MAAM,CAAC;IAEtB;;;OAGG;IACH,gBAAgB,EAAE,MAAM,CAAC;IAEzB;;;OAGG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB;;;OAGG;IACH,QAAQ,EAAE,QAAQ,CAAC;IAEnB;;;OAGG;IACH,eAAe,EAAE,OAAO,CAAC;IAEzB;;;OAGG;IACH,WAAW,EAAE,MAAM,CAAC;IAEpB;;;OAGG;IACH,eAAe,EAAE,MAAM,CAAC;IAExB;;;OAGG;IACH,WAAW,EAAE,MAAM,CAAC;IAEpB;;;OAGG;IACH,YAAY,EAAE,MAAM,CAAC;IAErB;;;OAGG;IACH,aAAa,EAAE,MAAM,CAAC;IAEtB;;;OAGG;IACH,uBAAuB,EAAE,MAAM,CAAC;CACjC;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC;;OAEG;IACH,KAAK,EAAE,OAAO,CAAC;IAEf;;OAEG;IACH,MAAM,EAAE,MAAM,EAAE,CAAC;IAEjB;;OAEG;IACH,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED;;GAEG;AACH,eAAO,MAAM,eAAe;;;;;;;;;CASlB,CAAC;AAEX;;;;;GAKG;AACH,eAAO,MAAM,QAAQ,EAAE,QAAQ,CAAC,gBAAgB,CAwEtC,CAAC;AAeX;;;;;;;GAOG;AACH,wBAAgB,wBAAwB,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAYlE;AAED;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,CAE1C;AAED;;;;;;;;GAQG;AACH,wBAAgB,eAAe,IAAI,MAAM,CAiBxC;AAiDD;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,SAAS,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC,gBAAgB,CAAC,GAAG,gBAAgB,CAqCjF;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,gBAAgB,GAAG,sBAAsB,CA2E/E;AAED;;;;GAIG;AACH,wBAAgB,WAAW,IAAI,QAAQ,CAAC,gBAAgB,CAAC,CAExD;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,QAAQ,CAEjE"}

package/dist/config/defaults.js

@@ -41,6 +41,7 @@ var __importStar = (this && this.__importStar) || (function () {
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.DEFAULTS = exports.CONFIG_ENV_VARS = void 0;
+exports.normalizeSessionStateDir = normalizeSessionStateDir;
 exports.getGlobalStateDir = getGlobalStateDir;
 exports.getGlobalLogDir = getGlobalLogDir;
 exports.getConfig = getConfig;
@@ -130,6 +131,36 @@ exports.DEFAULTS = {
      */
     largeResultPreviewLimit: 1024 * 1024,
 };
+function getConfiguredGlobalStateRoot() {
+    return process.env.BABYSITTER_GLOBAL_STATE_DIR?.trim()
+        ? path.resolve(process.env.BABYSITTER_GLOBAL_STATE_DIR)
+        : path.join(os.homedir(), ".a5c");
+}
+function normalizeComparablePath(value) {
+    const normalized = path.normalize(path.resolve(value));
+    return process.platform === "win32"
+        ? normalized.toLowerCase()
+        : normalized;
+}
+/**
+ * Normalizes a session-state directory path.
+ *
+ * The canonical session-state location is `<global-root>/state`. Older
+ * callers sometimes pass `<global-root>` itself (for example `~/.a5c`).
+ * Normalize that legacy/root-style input to the real session-state directory
+ * so hooks can still find `<sessionId>.md`.
+ */
+function normalizeSessionStateDir(stateDir) {
+    const globalRoot = getConfiguredGlobalStateRoot();
+    if (!stateDir?.trim()) {
+        return path.join(globalRoot, "state");
+    }
+    const resolved = path.resolve(stateDir);
+    if (normalizeComparablePath(resolved) === normalizeComparablePath(globalRoot)) {
+        return path.join(globalRoot, "state");
+    }
+    return resolved;
+}
 /**
  * Returns the global babysitter state directory (~/.a5c/state/).
  *
@@ -141,13 +172,7 @@ exports.DEFAULTS = {
  * Override: set BABYSITTER_STATE_DIR to use a different path.
  */
 function getGlobalStateDir() {
-    if (process.env.BABYSITTER_STATE_DIR) {
-        return path.resolve(process.env.BABYSITTER_STATE_DIR);
-    }
-    const globalRoot = process.env.BABYSITTER_GLOBAL_STATE_DIR?.trim()
-        ? path.resolve(process.env.BABYSITTER_GLOBAL_STATE_DIR)
-        : path.join(os.homedir(), ".a5c");
-    return path.join(globalRoot, "state");
+    return normalizeSessionStateDir(process.env.BABYSITTER_STATE_DIR);
 }
 /**
  * Returns the global babysitter log directory (~/.a5c/logs/).
@@ -159,12 +184,17 @@ function getGlobalStateDir() {
  * Override: set BABYSITTER_LOG_DIR to use a different path.
  */
 function getGlobalLogDir() {
-    if (process.env.BABYSITTER_LOG_DIR) {
-        return path.resolve(process.env.BABYSITTER_LOG_DIR);
+    const override = process.env.BABYSITTER_LOG_DIR?.trim();
+    if (override) {
+        if (!path.isAbsolute(override)) {
+            const rebased = path.join(os.homedir(), ".a5c", "logs");
+            // eslint-disable-next-line no-console
+            console.warn(`[babysitter] BABYSITTER_LOG_DIR must be an absolute path; got ${JSON.stringify(override)}. Falling back to ${rebased}. Set an absolute path to silence this warning.`);
+            return rebased;
+        }
+        return path.resolve(override);
     }
-    const globalRoot = process.env.BABYSITTER_GLOBAL_STATE_DIR?.trim()
-        ? path.resolve(process.env.BABYSITTER_GLOBAL_STATE_DIR)
-        : path.join(os.homedir(), ".a5c");
+    const globalRoot = getConfiguredGlobalStateRoot();
     return path.join(globalRoot, "logs");
 }
 /**

package/dist/config/index.d.ts

@@ -21,5 +21,5 @@
  * }
  * ```
  */
-export { type LogLevel, type BabysitterConfig, type ConfigValidationResult, DEFAULTS, CONFIG_ENV_VARS, getConfig, getGlobalLogDir, getGlobalStateDir, validateConfig, getDefaults, isValidLogLevel, } from "./defaults";
+export { type LogLevel, type BabysitterConfig, type ConfigValidationResult, DEFAULTS, CONFIG_ENV_VARS, getConfig, getGlobalLogDir, getGlobalStateDir, normalizeSessionStateDir, validateConfig, getDefaults, isValidLogLevel, } from "./defaults";
 //# 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,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,wBAAwB,EACxB,cAAc,EACd,WAAW,EACX,eAAe,GAChB,MAAM,YAAY,CAAC"}

package/dist/config/index.js

@@ -23,7 +23,7 @@
  * ```
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.isValidLogLevel = exports.getDefaults = exports.validateConfig = exports.getGlobalStateDir = exports.getGlobalLogDir = exports.getConfig = exports.CONFIG_ENV_VARS = exports.DEFAULTS = void 0;
+exports.isValidLogLevel = exports.getDefaults = exports.validateConfig = exports.normalizeSessionStateDir = 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,6 +32,7 @@ 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, "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; } });

package/dist/governance/authority.d.ts

@@ -0,0 +1,68 @@
+/**
+ * GAP-SEC: Authority Chain system.
+ *
+ * Models delegation chains from human principals through agent principals,
+ * with monotonically narrowing scope at each hop.
+ */
+import type { MandateScope } from './mandate';
+/** A principal (human or agent) in the authority chain. */
+export interface AuthorityPrincipal {
+    kind: 'human' | 'agent';
+    id: string;
+    displayName: string;
+}
+/** A single grant of authority from one principal to another. */
+export interface AuthorityGrant {
+    from: AuthorityPrincipal;
+    to: AuthorityPrincipal;
+    scope: MandateScope;
+    grantedAt: string;
+    revokedAt?: string;
+    expiresAt?: string;
+}
+/** A link in the authority chain (wrapping a grant). */
+export interface AuthorityChainLink {
+    grant: AuthorityGrant;
+    index: number;
+}
+/** A full authority chain from root to leaf. */
+export interface AuthorityChain {
+    grants: AuthorityGrant[];
+    rootPrincipal: AuthorityPrincipal;
+    effectiveScope: MandateScope;
+}
+/** Result of chain validation. */
+export interface AuthorityChainValidationResult {
+    valid: boolean;
+    reason?: string;
+}
+/** Result of tracing authority to a human root. */
+export interface AuthorityTrace {
+    humanPrincipal: AuthorityPrincipal;
+    hopCount: number;
+    principalPath: string[];
+}
+/**
+ * Create an authority chain from an ordered list of grants.
+ * Computes the effective scope as the intersection of all grant scopes.
+ */
+export declare function createAuthorityChain(grants: AuthorityGrant[]): AuthorityChain;
+/**
+ * Validate an authority chain. Checks:
+ * 1. Root must be a human principal.
+ * 2. No revoked links.
+ * 3. No expired links.
+ * 4. Scopes monotonically narrow (no expansion).
+ */
+export declare function validateAuthorityChain(chain: AuthorityChain): AuthorityChainValidationResult;
+/**
+ * Attenuate (intersect) two scopes. The result is never wider than either input.
+ * Pure function.
+ */
+export declare function attenuateScope(parent: MandateScope, child: MandateScope): MandateScope;
+/**
+ * Trace authority back to the human root, returning the human principal,
+ * hop count, and full principal path.
+ */
+export declare function traceAuthorityToHuman(chain: AuthorityChain): AuthorityTrace;
+//# sourceMappingURL=authority.d.ts.map