@a5c-ai/babysitter-sdk 0.0.182-staging.d2efc4ae → 0.0.183-staging.0c58dfe8

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

@@ -0,0 +1,16 @@
+export interface ProcessLibraryCommandArgs {
+    subcommand: "clone" | "update" | "use" | "active";
+    repo?: string;
+    dir?: string;
+    ref?: string;
+    runId?: string;
+    sessionId?: string;
+    stateDir?: string;
+    json: boolean;
+}
+export declare function handleProcessLibraryClone(args: ProcessLibraryCommandArgs): Promise<number>;
+export declare function handleProcessLibraryUpdate(args: ProcessLibraryCommandArgs): Promise<number>;
+export declare function handleProcessLibraryUse(args: ProcessLibraryCommandArgs): Promise<number>;
+export declare function handleProcessLibraryActive(args: ProcessLibraryCommandArgs): Promise<number>;
+export declare function handleProcessLibraryCommand(args: ProcessLibraryCommandArgs): Promise<number>;
+//# sourceMappingURL=processLibrary.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"processLibrary.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/processLibrary.ts"],"names":[],"mappings":"AAOA,MAAM,WAAW,yBAAyB;IACxC,UAAU,EAAE,OAAO,GAAG,QAAQ,GAAG,KAAK,GAAG,QAAQ,CAAC;IAClD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,OAAO,CAAC;CACf;AAoBD,wBAAsB,yBAAyB,CAC7C,IAAI,EAAE,yBAAyB,GAC9B,OAAO,CAAC,MAAM,CAAC,CAyBjB;AAED,wBAAsB,0BAA0B,CAC9C,IAAI,EAAE,yBAAyB,GAC9B,OAAO,CAAC,MAAM,CAAC,CAuBjB;AAED,wBAAsB,uBAAuB,CAC3C,IAAI,EAAE,yBAAyB,GAC9B,OAAO,CAAC,MAAM,CAAC,CA6BjB;AAED,wBAAsB,0BAA0B,CAC9C,IAAI,EAAE,yBAAyB,GAC9B,OAAO,CAAC,MAAM,CAAC,CA0BjB;AAED,wBAAsB,2BAA2B,CAC/C,IAAI,EAAE,yBAAyB,GAC9B,OAAO,CAAC,MAAM,CAAC,CAiBjB"}

package/dist/cli/commands/processLibrary.js

@@ -0,0 +1,152 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.handleProcessLibraryClone = handleProcessLibraryClone;
+exports.handleProcessLibraryUpdate = handleProcessLibraryUpdate;
+exports.handleProcessLibraryUse = handleProcessLibraryUse;
+exports.handleProcessLibraryActive = handleProcessLibraryActive;
+exports.handleProcessLibraryCommand = handleProcessLibraryCommand;
+const active_1 = require("../../processLibrary/active");
+function requireArg(value, name, command, json) {
+    if (!value) {
+        const message = `[${command}] ${name} is required`;
+        if (json) {
+            console.log(JSON.stringify({ error: "missing_argument", message }));
+        }
+        else {
+            console.error(message);
+        }
+        return null;
+    }
+    return value;
+}
+async function handleProcessLibraryClone(args) {
+    const repo = requireArg(args.repo, "--repo", "process-library:clone", args.json);
+    if (!repo)
+        return 1;
+    const dir = requireArg(args.dir, "--dir", "process-library:clone", args.json);
+    if (!dir)
+        return 1;
+    try {
+        const result = await (0, active_1.cloneProcessLibrary)({ repo, dir, ref: args.ref });
+        if (args.json) {
+            console.log(JSON.stringify({ success: true, ...result }, null, 2));
+        }
+        else {
+            console.log(`Process library cloned.\n  Repo: ${result.repo}\n  Dir: ${result.dir}\n  Revision: ${result.revision}`);
+        }
+        return 0;
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        if (args.json) {
+            console.log(JSON.stringify({ error: "clone_failed", message }));
+        }
+        else {
+            console.error(`[process-library:clone] ${message}`);
+        }
+        return 1;
+    }
+}
+async function handleProcessLibraryUpdate(args) {
+    const dir = requireArg(args.dir, "--dir", "process-library:update", args.json);
+    if (!dir)
+        return 1;
+    try {
+        const result = await (0, active_1.updateProcessLibrary)({ dir, ref: args.ref });
+        if (args.json) {
+            console.log(JSON.stringify({ success: true, ...result }, null, 2));
+        }
+        else {
+            console.log(`Process library updated.\n  Dir: ${result.dir}\n  Revision: ${result.revision}`);
+        }
+        return 0;
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        if (args.json) {
+            console.log(JSON.stringify({ error: "update_failed", message }));
+        }
+        else {
+            console.error(`[process-library:update] ${message}`);
+        }
+        return 1;
+    }
+}
+async function handleProcessLibraryUse(args) {
+    const dir = requireArg(args.dir, "--dir", "process-library:use", args.json);
+    if (!dir)
+        return 1;
+    try {
+        const result = await (0, active_1.bindActiveProcessLibrary)({
+            dir,
+            stateDir: args.stateDir,
+            runId: args.runId,
+            sessionId: args.sessionId,
+            ref: args.ref,
+        });
+        if (args.json) {
+            console.log(JSON.stringify({ success: true, ...result }, null, 2));
+        }
+        else {
+            console.log(`Active process library updated.\n  Scope: ${result.bindingScope}\n  Dir: ${result.binding.dir}\n  State: ${result.stateFile}`);
+        }
+        return 0;
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        if (args.json) {
+            console.log(JSON.stringify({ error: "bind_failed", message }));
+        }
+        else {
+            console.error(`[process-library:use] ${message}`);
+        }
+        return 1;
+    }
+}
+async function handleProcessLibraryActive(args) {
+    try {
+        const result = await (0, active_1.resolveActiveProcessLibrary)({
+            stateDir: args.stateDir,
+            runId: args.runId,
+            sessionId: args.sessionId,
+        });
+        if (args.json) {
+            console.log(JSON.stringify(result, null, 2));
+        }
+        else if (!result.binding) {
+            console.log(`No active process-library binding found.\n  State: ${result.stateFile}`);
+        }
+        else {
+            console.log(`Active process library.\n  Scope: ${result.bindingScope}\n  Dir: ${result.binding.dir}\n  Revision: ${result.binding.revision ?? "unknown"}`);
+        }
+        return 0;
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        if (args.json) {
+            console.log(JSON.stringify({ error: "active_failed", message }));
+        }
+        else {
+            console.error(`[process-library:active] ${message}`);
+        }
+        return 1;
+    }
+}
+async function handleProcessLibraryCommand(args) {
+    switch (args.subcommand) {
+        case "clone":
+            return handleProcessLibraryClone(args);
+        case "update":
+            return handleProcessLibraryUpdate(args);
+        case "use":
+            return handleProcessLibraryUse(args);
+        case "active":
+            return handleProcessLibraryActive(args);
+        default: {
+            const _exhaustive = args.subcommand;
+            void _exhaustive;
+            console.error("[process-library] Unknown subcommand");
+            return 1;
+        }
+    }
+}

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;AAklB/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;AAo/C7D,OAAO,EAAE,aAAa,IAAI,cAAc,EAAE,sBAAsB,IAAI,uBAAuB,EAAE,CAAC;AAE9F,wBAAgB,mBAAmB;eAEf,MAAM,EAAE,GAA2B,OAAO,CAAC,MAAM,CAAC;kBA+TpD,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;AAwmB/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;AA2/C7D,OAAO,EAAE,aAAa,IAAI,cAAc,EAAE,sBAAsB,IAAI,uBAAuB,EAAE,CAAC;AAE9F,wBAAgB,mBAAmB;eAEf,MAAM,EAAE,GAA2B,OAAO,CAAC,MAAM,CAAC;kBA8UpD,MAAM;EAIvB"}

package/dist/cli/main.js

@@ -60,6 +60,7 @@ const mcpServe_1 = require("./commands/mcpServe");
 const hookLog_1 = require("./commands/hookLog");
 const hookRun_1 = require("./commands/hookRun");
 const profile_1 = require("./commands/profile");
+const processLibrary_1 = require("./commands/processLibrary");
 const plugin_1 = require("./commands/plugin");
 const tokensStats_1 = require("./commands/tokensStats");
 const compressionStatus_1 = require("./commands/compressionStatus");
@@ -95,6 +96,10 @@ const USAGE = `Usage:
   babysitter hook:run --hook-type <stop|session-start|user-prompt-submit|pre-tool-use> [--harness <claude-code|gemini-cli>] [--plugin-root <dir>] [--state-dir <dir>] [--runs-dir <dir>] [--json] [--verbose]
   babysitter compress-output <command and args...>
   babysitter skill:fetch-remote --source-type <github|well-known> --url <url> [--json]
+  babysitter process-library:clone --repo <url> --dir <path> [--ref <ref>] [--json]
+  babysitter process-library:update --dir <path> [--ref <ref>] [--json]
+  babysitter process-library:use --dir <path> [--run-id <id>] [--session-id <id>] [--state-dir <dir>] [--ref <ref>] [--json]
+  babysitter process-library:active [--run-id <id>] [--session-id <id>] [--state-dir <dir>] [--json]
   babysitter profile:read --user|--project [--dir <dir>] [--json]
   babysitter profile:write --user|--project --input <file> [--dir <dir>] [--json]
   babysitter profile:merge --user|--project --input <file> [--dir <dir>] [--json]
@@ -372,6 +377,14 @@ function parseArgs(argv) {
             parsed.url = expectFlagValue(rest, ++i, "--url");
             continue;
         }
+        if (arg === "--repo") {
+            parsed.processLibraryRepo = expectFlagValue(rest, ++i, "--repo");
+            continue;
+        }
+        if (arg === "--ref") {
+            parsed.processLibraryRef = expectFlagValue(rest, ++i, "--ref");
+            continue;
+        }
         if (arg === "--include-remote") {
             parsed.includeRemote = true;
             continue;
@@ -399,7 +412,9 @@ function parseArgs(argv) {
             continue;
         }
         if (arg === "--dir") {
-            parsed.profileDir = expectFlagValue(rest, ++i, "--dir");
+            const dir = expectFlagValue(rest, ++i, "--dir");
+            parsed.profileDir = dir;
+            parsed.processLibraryDir = dir;
             continue;
         }
         // Plugin command flags
@@ -883,11 +898,12 @@ async function handleRunCreate(parsed) {
     });
     const entrySpec = formatEntrypointSpecifier(result.metadata.entrypoint);
     // --- Harness-specific session binding ---
-    // When --harness is explicitly specified, use that adapter directly.
-    // Otherwise auto-detect from env vars (CLAUDE_SESSION_ID, CLAUDE_ENV_FILE).
+    // Bind only when the caller is explicit about harness/session context.
+    // Ambient harness env inside editor/test hosts should not silently mutate
+    // generic CLI runs.
     const adapter = parsed.harness
         ? (0, harness_1.getAdapterByName)(parsed.harness)
-        : (0, harness_1.getAdapter)();
+        : (parsed.sessionId ? (0, harness_1.getAdapter)() : undefined);
     let sessionBound;
     if (adapter) {
         const sessionId = adapter.resolveSessionId(parsed);
@@ -927,7 +943,8 @@ async function handleRunCreate(parsed) {
     // Try process-driven discovery first (reads @skill/@agent markers from process file)
     let discoveredSkills;
     let discoveredAgents;
-    const discoverPluginRoot = adapter?.resolvePluginRoot(parsed) ?? (0, harness_1.getAdapter)().resolvePluginRoot(parsed);
+    const discoverPluginRoot = parsed.pluginRoot ??
+        adapter?.resolvePluginRoot(parsed);
     if (discoverPluginRoot) {
         try {
             const processDiscovery = (0, skill_1.discoverFromProcessFile)({
@@ -1852,6 +1869,10 @@ const VALID_COMMANDS = [
     "hook:run",
     "skill:discover",
     "skill:fetch-remote",
+    "process-library:clone",
+    "process-library:update",
+    "process-library:use",
+    "process-library:active",
     "profile:read",
     "profile:write",
     "profile:merge",
@@ -2120,6 +2141,21 @@ function createBabysitterCli() {
                         json: parsed.json,
                     });
                 }
+                // Process-library commands
+                if (parsed.command?.startsWith("process-library:")) {
+                    const subcommand = parsed.command.split(":")[1];
+                    const processLibraryArgs = {
+                        subcommand: subcommand,
+                        repo: parsed.processLibraryRepo,
+                        dir: parsed.processLibraryDir,
+                        ref: parsed.processLibraryRef,
+                        runId: parsed.runIdOverride,
+                        sessionId: parsed.sessionId,
+                        stateDir: parsed.stateDir,
+                        json: parsed.json,
+                    };
+                    return await (0, processLibrary_1.handleProcessLibraryCommand)(processLibraryArgs);
+                }
                 // Profile commands
                 if (parsed.command === "profile:read" ||
                     parsed.command === "profile:write" ||

package/dist/harness/index.d.ts

@@ -1,4 +1,5 @@
-export type { HarnessAdapter, SessionBindOptions, SessionBindResult, HookHandlerArgs, } from "./types";
+export type { HarnessAdapter, SessionBindOptions, SessionBindResult, HookHandlerArgs, HarnessDiscoveryResult, HarnessInvokeOptions, HarnessInvokeResult, PiSessionOptions, PiPromptResult, } from "./types";
+export { HarnessCapability } from "./types";
 export { createClaudeCodeAdapter } from "./claudeCode";
 export { createCodexAdapter } from "./codex";
 export { createGeminiCliAdapter } from "./geminiCli";

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/harness/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,cAAc,EACd,kBAAkB,EAClB,iBAAiB,EACjB,eAAe,GAChB,MAAM,SAAS,CAAC;AAEjB,OAAO,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAC;AACvD,OAAO,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAC7C,OAAO,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AACrD,OAAO,EAAE,eAAe,EAAE,MAAM,MAAM,CAAC;AACvC,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,EACL,aAAa,EACb,gBAAgB,EAChB,sBAAsB,EACtB,UAAU,EACV,UAAU,EACV,YAAY,GACb,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/harness/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,cAAc,EACd,kBAAkB,EAClB,iBAAiB,EACjB,eAAe,EACf,sBAAsB,EACtB,oBAAoB,EACpB,mBAAmB,EACnB,gBAAgB,EAChB,cAAc,GACf,MAAM,SAAS,CAAC;AAEjB,OAAO,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAE5C,OAAO,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAC;AACvD,OAAO,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAC7C,OAAO,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AACrD,OAAO,EAAE,eAAe,EAAE,MAAM,MAAM,CAAC;AACvC,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,EACL,aAAa,EACb,gBAAgB,EAChB,sBAAsB,EACtB,UAAU,EACV,UAAU,EACV,YAAY,GACb,MAAM,YAAY,CAAC"}

package/dist/harness/index.js

@@ -1,6 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.resetAdapter = exports.setAdapter = exports.getAdapter = exports.listSupportedHarnesses = exports.getAdapterByName = exports.detectAdapter = exports.createNullAdapter = exports.createPiAdapter = exports.createGeminiCliAdapter = exports.createCodexAdapter = exports.createClaudeCodeAdapter = void 0;
+exports.resetAdapter = exports.setAdapter = exports.getAdapter = exports.listSupportedHarnesses = exports.getAdapterByName = exports.detectAdapter = exports.createNullAdapter = exports.createPiAdapter = exports.createGeminiCliAdapter = exports.createCodexAdapter = exports.createClaudeCodeAdapter = exports.HarnessCapability = void 0;
+var types_1 = require("./types");
+Object.defineProperty(exports, "HarnessCapability", { enumerable: true, get: function () { return types_1.HarnessCapability; } });
 var claudeCode_1 = require("./claudeCode");
 Object.defineProperty(exports, "createClaudeCodeAdapter", { enumerable: true, get: function () { return claudeCode_1.createClaudeCodeAdapter; } });
 var codex_1 = require("./codex");

package/dist/harness/types.d.ts

@@ -6,6 +6,92 @@
  * hook input/output formats. The adapter interface abstracts these differences
  * so the SDK core remains harness-agnostic.
  */
+/** Capabilities that a harness adapter may support. */
+export declare enum HarnessCapability {
+    /** Harness supports programmatic (non-interactive) invocation. */
+    Programmatic = "programmatic",
+    /** Harness can bind a babysitter run to a host session. */
+    SessionBinding = "session-binding",
+    /** Harness implements the stop-hook lifecycle event. */
+    StopHook = "stop-hook",
+    /** Harness exposes an MCP (Model Context Protocol) server. */
+    Mcp = "mcp",
+    /** Harness can accept a prompt without a TTY (headless mode). */
+    HeadlessPrompt = "headless-prompt"
+}
+/** Result of probing the local environment for a specific harness CLI. */
+export interface HarnessDiscoveryResult {
+    /** Harness identifier (matches HarnessAdapter.name). */
+    name: string;
+    /** Whether the CLI binary was found on the system. */
+    installed: boolean;
+    /** Semantic version reported by the CLI, if obtainable. */
+    version?: string;
+    /** Absolute path to the CLI binary, if resolved. */
+    cliPath?: string;
+    /** Shell command used to invoke the CLI. */
+    cliCommand: string;
+    /** Whether the harness currently has an active session. */
+    activeSession: boolean;
+    /** Whether harness-specific configuration was found on disk. */
+    configFound: boolean;
+    /** Capabilities advertised by this harness. */
+    capabilities: HarnessCapability[];
+    /** Platform identifier (e.g. "win32", "linux", "darwin"). */
+    platform: string;
+}
+/** Options for programmatically invoking a harness CLI. */
+export interface HarnessInvokeOptions {
+    /** The prompt to send to the harness. */
+    prompt: string;
+    /** Working directory for the invocation. */
+    workspace?: string;
+    /** Model override (harness-specific). */
+    model?: string;
+    /** Maximum execution time in milliseconds. */
+    timeout?: number;
+    /** Whether to use RPC/structured-output mode. */
+    rpc?: boolean;
+    /** Additional environment variables passed to the child process. */
+    env?: Record<string, string>;
+}
+/** Result returned after a harness CLI invocation completes. */
+export interface HarnessInvokeResult {
+    /** Whether the invocation completed without error. */
+    success: boolean;
+    /** Combined stdout/stderr output from the CLI. */
+    output: string;
+    /** Process exit code. */
+    exitCode: number;
+    /** Wall-clock duration of the invocation in milliseconds. */
+    duration: number;
+    /** Name of the harness that was invoked. */
+    harness: string;
+}
+/** Options for creating a Pi harness session. */
+export interface PiSessionOptions {
+    /** Working directory for the session. */
+    workspace?: string;
+    /** Model override. */
+    model?: string;
+    /** Maximum execution time in milliseconds. */
+    timeout?: number;
+    /** Additional environment variables. */
+    env?: Record<string, string>;
+    /** Explicit path to the Pi CLI binary. */
+    cliPath?: string;
+}
+/** Result of sending a prompt through a Pi session. */
+export interface PiPromptResult {
+    /** Raw output from the Pi CLI. */
+    output: string;
+    /** Process exit code. */
+    exitCode: number;
+    /** Wall-clock duration in milliseconds. */
+    duration: number;
+    /** Whether the prompt completed without error. */
+    success: boolean;
+}
 export interface SessionBindOptions {
     sessionId: string;
     runId: string;
@@ -65,5 +151,15 @@ export interface HarnessAdapter {
     handleSessionStartHook(args: HookHandlerArgs): Promise<number>;
     /** Find hook dispatcher path (for shell hook execution) */
     findHookDispatcherPath(startCwd: string): string | null;
+    /** Check whether the harness CLI binary is installed and reachable. */
+    isCliInstalled?(): Promise<boolean>;
+    /** Return CLI metadata (command name, version, resolved path). */
+    getCliInfo?(): Promise<{
+        command: string;
+        version?: string;
+        path?: string;
+    }>;
+    /** List capabilities supported by this harness adapter. */
+    getCapabilities?(): HarnessCapability[];
 }
 //# sourceMappingURL=types.d.ts.map

package/dist/harness/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/harness/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAMH,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,OAAO,CAAC;CACf;AAED,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,yEAAyE;IACzE,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAMD,MAAM,WAAW,eAAe;IAC9B,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;AAMD,MAAM,WAAW,cAAc;IAC7B,8CAA8C;IAC9C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB,iEAAiE;IACjE,QAAQ,IAAI,OAAO,CAAC;IAEpB,6DAA6D;IAC7D,gBAAgB,CAAC,MAAM,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,MAAM,GAAG,SAAS,CAAC;IAErE,8CAA8C;IAC9C,eAAe,CAAC,IAAI,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,MAAM,GAAG,SAAS,CAAC;IAEtF,0CAA0C;IAC1C,iBAAiB,CAAC,IAAI,EAAE;QAAE,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,MAAM,GAAG,SAAS,CAAC;IAErE,iFAAiF;IACjF,uBAAuB,CAAC,IAAI,MAAM,CAAC;IAEnC,4EAA4E;IAC5E,gBAAgB,CAAC,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;IAE7C,kFAAkF;IAClF,yBAAyB,CAAC,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAC;IAErD,2DAA2D;IAC3D,WAAW,CAAC,IAAI,EAAE,kBAAkB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;IAElE,qDAAqD;IACrD,cAAc,CAAC,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAEvD,kEAAkE;IAClE,sBAAsB,CAAC,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAE/D,2DAA2D;IAC3D,sBAAsB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;CACzD"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/harness/types.ts"],"names":[],"mappings":"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"}

package/dist/harness/types.js

@@ -8,3 +8,21 @@
  * so the SDK core remains harness-agnostic.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.HarnessCapability = void 0;
+// ---------------------------------------------------------------------------
+// Harness capability enum
+// ---------------------------------------------------------------------------
+/** Capabilities that a harness adapter may support. */
+var HarnessCapability;
+(function (HarnessCapability) {
+    /** Harness supports programmatic (non-interactive) invocation. */
+    HarnessCapability["Programmatic"] = "programmatic";
+    /** Harness can bind a babysitter run to a host session. */
+    HarnessCapability["SessionBinding"] = "session-binding";
+    /** Harness implements the stop-hook lifecycle event. */
+    HarnessCapability["StopHook"] = "stop-hook";
+    /** Harness exposes an MCP (Model Context Protocol) server. */
+    HarnessCapability["Mcp"] = "mcp";
+    /** Harness can accept a prompt without a TTY (headless mode). */
+    HarnessCapability["HeadlessPrompt"] = "headless-prompt";
+})(HarnessCapability || (exports.HarnessCapability = HarnessCapability = {}));

package/dist/processLibrary/active.d.ts

@@ -0,0 +1,65 @@
+export interface ProcessLibraryBinding {
+    dir: string;
+    repoUrl?: string;
+    ref?: string;
+    revision?: string;
+    boundAt: string;
+}
+export interface ProcessLibraryState {
+    version: 1;
+    updatedAt: string;
+    defaultBinding?: ProcessLibraryBinding;
+    runBindings?: Record<string, ProcessLibraryBinding>;
+    sessionBindings?: Record<string, ProcessLibraryBinding>;
+}
+export interface CloneProcessLibraryOptions {
+    repo: string;
+    dir: string;
+    ref?: string;
+}
+export interface CloneProcessLibraryResult {
+    dir: string;
+    repo: string;
+    ref?: string;
+    revision: string;
+}
+export interface UpdateProcessLibraryOptions {
+    dir: string;
+    ref?: string;
+}
+export interface UpdateProcessLibraryResult {
+    dir: string;
+    repo?: string;
+    ref?: string;
+    revision: string;
+}
+export interface BindProcessLibraryOptions {
+    stateDir?: string;
+    dir: string;
+    runId?: string;
+    sessionId?: string;
+    ref?: string;
+}
+export interface BindProcessLibraryResult {
+    stateFile: string;
+    bindingScope: "default" | "run" | "session" | "run+session";
+    bindingKey?: string;
+    binding: ProcessLibraryBinding;
+}
+export interface ResolveActiveProcessLibraryOptions {
+    stateDir?: string;
+    runId?: string;
+    sessionId?: string;
+}
+export interface ResolveActiveProcessLibraryResult {
+    stateFile: string;
+    bindingScope: "default" | "run" | "session" | null;
+    bindingKey?: string;
+    binding: ProcessLibraryBinding | null;
+}
+export declare function getActiveProcessLibraryStatePath(stateDir?: string): string;
+export declare function cloneProcessLibrary(options: CloneProcessLibraryOptions): Promise<CloneProcessLibraryResult>;
+export declare function updateProcessLibrary(options: UpdateProcessLibraryOptions): Promise<UpdateProcessLibraryResult>;
+export declare function bindActiveProcessLibrary(options: BindProcessLibraryOptions): Promise<BindProcessLibraryResult>;
+export declare function resolveActiveProcessLibrary(options?: ResolveActiveProcessLibraryOptions): Promise<ResolveActiveProcessLibraryResult>;
+//# sourceMappingURL=active.d.ts.map

package/dist/processLibrary/active.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"active.d.ts","sourceRoot":"","sources":["../../src/processLibrary/active.ts"],"names":[],"mappings":"AAQA,MAAM,WAAW,qBAAqB;IACpC,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,CAAC,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,CAAC,EAAE,qBAAqB,CAAC;IACvC,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,qBAAqB,CAAC,CAAC;IACpD,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,qBAAqB,CAAC,CAAC;CACzD;AAED,MAAM,WAAW,0BAA0B;IACzC,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,yBAAyB;IACxC,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,2BAA2B;IAC1C,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,0BAA0B;IACzC,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,wBAAwB;IACvC,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,SAAS,GAAG,KAAK,GAAG,SAAS,GAAG,aAAa,CAAC;IAC5D,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,qBAAqB,CAAC;CAChC;AAED,MAAM,WAAW,kCAAkC;IACjD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,iCAAiC;IAChD,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,SAAS,GAAG,KAAK,GAAG,SAAS,GAAG,IAAI,CAAC;IACnD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,qBAAqB,GAAG,IAAI,CAAC;CACvC;AASD,wBAAgB,gCAAgC,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAM1E;AA+FD,wBAAsB,mBAAmB,CACvC,OAAO,EAAE,0BAA0B,GAClC,OAAO,CAAC,yBAAyB,CAAC,CAmCpC;AAED,wBAAsB,oBAAoB,CACxC,OAAO,EAAE,2BAA2B,GACnC,OAAO,CAAC,0BAA0B,CAAC,CAkBrC;AAED,wBAAsB,wBAAwB,CAC5C,OAAO,EAAE,yBAAyB,GACjC,OAAO,CAAC,wBAAwB,CAAC,CA+BnC;AAED,wBAAsB,2BAA2B,CAC/C,OAAO,GAAE,kCAAuC,GAC/C,OAAO,CAAC,iCAAiC,CAAC,CA2B5C"}

package/dist/processLibrary/active.js

@@ -0,0 +1,205 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getActiveProcessLibraryStatePath = getActiveProcessLibraryStatePath;
+exports.cloneProcessLibrary = cloneProcessLibrary;
+exports.updateProcessLibrary = updateProcessLibrary;
+exports.bindActiveProcessLibrary = bindActiveProcessLibrary;
+exports.resolveActiveProcessLibrary = resolveActiveProcessLibrary;
+const node_fs_1 = require("node:fs");
+const node_path_1 = __importDefault(require("node:path"));
+const node_child_process_1 = require("node:child_process");
+const node_util_1 = require("node:util");
+const execFile = (0, node_util_1.promisify)(node_child_process_1.execFile);
+const ACTIVE_PROCESS_LIBRARY_FILENAME = "process-library.json";
+function resolveStateDir(stateDir) {
+    if (stateDir && stateDir.trim()) {
+        return node_path_1.default.resolve(stateDir);
+    }
+    return node_path_1.default.resolve(process.cwd(), ".a5c");
+}
+function getActiveProcessLibraryStatePath(stateDir) {
+    return node_path_1.default.join(resolveStateDir(stateDir), "active", ACTIVE_PROCESS_LIBRARY_FILENAME);
+}
+async function readState(stateDir) {
+    const stateFile = getActiveProcessLibraryStatePath(stateDir);
+    try {
+        const raw = await node_fs_1.promises.readFile(stateFile, "utf8");
+        return JSON.parse(raw);
+    }
+    catch (error) {
+        const code = error?.code;
+        if (code === "ENOENT") {
+            return {
+                version: 1,
+                updatedAt: new Date().toISOString(),
+                runBindings: {},
+                sessionBindings: {},
+            };
+        }
+        throw error;
+    }
+}
+async function writeState(stateDir, state) {
+    const stateFile = getActiveProcessLibraryStatePath(stateDir);
+    await node_fs_1.promises.mkdir(node_path_1.default.dirname(stateFile), { recursive: true });
+    await node_fs_1.promises.writeFile(stateFile, JSON.stringify(state, null, 2), "utf8");
+    return stateFile;
+}
+function normalizeBinding(dir, repoUrl, ref, revision) {
+    return {
+        dir: node_path_1.default.resolve(dir),
+        ...(repoUrl ? { repoUrl } : {}),
+        ...(ref ? { ref } : {}),
+        ...(revision ? { revision } : {}),
+        boundAt: new Date().toISOString(),
+    };
+}
+async function ensureDirectoryExists(dir) {
+    const resolved = node_path_1.default.resolve(dir);
+    try {
+        const stat = await node_fs_1.promises.stat(resolved);
+        if (!stat.isDirectory()) {
+            throw new Error(`Process-library path is not a directory: ${resolved}`);
+        }
+    }
+    catch (error) {
+        const code = error?.code;
+        if (code === "ENOENT") {
+            throw new Error(`Process-library directory not found: ${resolved}`);
+        }
+        throw error;
+    }
+    return resolved;
+}
+async function runGit(args, cwd) {
+    return execFile("git", args, {
+        ...(cwd ? { cwd } : {}),
+        encoding: "utf8",
+    });
+}
+async function getGitOutput(args, cwd) {
+    try {
+        const { stdout } = await runGit(args, cwd);
+        const value = stdout.trim();
+        return value || undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+async function readGitMetadata(dir) {
+    const repoUrl = await getGitOutput(["config", "--get", "remote.origin.url"], dir);
+    const revision = await getGitOutput(["rev-parse", "HEAD"], dir);
+    return { repoUrl, revision };
+}
+async function cloneProcessLibrary(options) {
+    const dir = node_path_1.default.resolve(options.dir);
+    await node_fs_1.promises.mkdir(node_path_1.default.dirname(dir), { recursive: true });
+    try {
+        await node_fs_1.promises.access(dir);
+    }
+    catch (error) {
+        const code = error?.code;
+        if (code === "ENOENT") {
+            // Directory does not exist yet.
+        }
+        else if (code) {
+            throw error;
+        }
+        else {
+            throw new Error(`Process-library directory already exists at ${dir}. Choose a new --dir or update it instead.`);
+        }
+    }
+    const cloneArgs = ["clone", "--depth", "1"];
+    if (options.ref) {
+        cloneArgs.push("--branch", options.ref);
+    }
+    cloneArgs.push(options.repo, dir);
+    await runGit(cloneArgs);
+    const { revision } = await readGitMetadata(dir);
+    if (!revision) {
+        throw new Error(`Unable to determine cloned revision for ${dir}`);
+    }
+    return {
+        dir,
+        repo: options.repo,
+        ...(options.ref ? { ref: options.ref } : {}),
+        revision,
+    };
+}
+async function updateProcessLibrary(options) {
+    const dir = await ensureDirectoryExists(options.dir);
+    if (options.ref) {
+        await runGit(["fetch", "--depth", "1", "origin", options.ref], dir);
+        await runGit(["checkout", "--force", "FETCH_HEAD"], dir);
+    }
+    else {
+        await runGit(["pull", "--ff-only"], dir);
+    }
+    const { repoUrl, revision } = await readGitMetadata(dir);
+    if (!revision) {
+        throw new Error(`Unable to determine updated revision for ${dir}`);
+    }
+    return {
+        dir,
+        ...(repoUrl ? { repo: repoUrl } : {}),
+        ...(options.ref ? { ref: options.ref } : {}),
+        revision,
+    };
+}
+async function bindActiveProcessLibrary(options) {
+    const dir = await ensureDirectoryExists(options.dir);
+    const state = await readState(options.stateDir);
+    const { repoUrl, revision } = await readGitMetadata(dir);
+    const binding = normalizeBinding(dir, repoUrl, options.ref, revision);
+    let bindingScope = "default";
+    let bindingKey;
+    if (options.runId) {
+        state.runBindings = state.runBindings ?? {};
+        state.runBindings[options.runId] = binding;
+        bindingScope = "run";
+        bindingKey = options.runId;
+    }
+    if (options.sessionId) {
+        state.sessionBindings = state.sessionBindings ?? {};
+        state.sessionBindings[options.sessionId] = binding;
+        bindingScope = options.runId ? "run+session" : "session";
+        bindingKey = options.runId
+            ? `${options.runId}:${options.sessionId}`
+            : options.sessionId;
+    }
+    if (!options.runId && !options.sessionId) {
+        state.defaultBinding = binding;
+    }
+    state.updatedAt = new Date().toISOString();
+    const stateFile = await writeState(options.stateDir, state);
+    return { stateFile, bindingScope, ...(bindingKey ? { bindingKey } : {}), binding };
+}
+async function resolveActiveProcessLibrary(options = {}) {
+    const stateFile = getActiveProcessLibraryStatePath(options.stateDir);
+    const state = await readState(options.stateDir);
+    if (options.runId && state.runBindings?.[options.runId]) {
+        return {
+            stateFile,
+            bindingScope: "run",
+            bindingKey: options.runId,
+            binding: state.runBindings[options.runId],
+        };
+    }
+    if (options.sessionId && state.sessionBindings?.[options.sessionId]) {
+        return {
+            stateFile,
+            bindingScope: "session",
+            bindingKey: options.sessionId,
+            binding: state.sessionBindings[options.sessionId],
+        };
+    }
+    return {
+        stateFile,
+        bindingScope: state.defaultBinding ? "default" : null,
+        binding: state.defaultBinding ?? null,
+    };
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@a5c-ai/babysitter-sdk",
-  "version": "0.0.182-staging.d2efc4ae",
+  "version": "0.0.183-staging.0c58dfe8",
   "description": "Storage and run-registry primitives for event-sourced babysitter workflows.",
   "license": "UNLICENSED",
   "type": "commonjs",
@@ -23,6 +23,7 @@
     "smoke:cli": "node scripts/smoke-cli.js --runs-dir packages/sdk/test-fixtures/cli/runs/smoke"
   },
   "dependencies": {
+    "@mariozechner/pi-coding-agent": "*",
     "@modelcontextprotocol/sdk": "^1.12.1",
     "fs-extra": "^11.2.0",
     "ulid": "^2.3.0"