@a5c-ai/babysitter-sdk 5.0.0 → 5.0.1-staging.04a3db697

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

@@ -0,0 +1,74 @@
+/**
+ * health command - Verify SDK installation and environment health
+ *
+ * This command performs diagnostic checks to verify:
+ * - SDK CLI is properly installed and version is accessible
+ * - .a5c directory exists and is writable
+ * - Node.js version is compatible (>=18)
+ * - Package.json has babysitter-sdk dependency if in project context
+ * - Environment variables are set correctly
+ */
+/**
+ * Status of an individual health check
+ */
+export type CheckStatus = "pass" | "fail" | "warn";
+/**
+ * Result of a single health check
+ */
+export interface HealthCheck {
+    /** Name of the check */
+    name: string;
+    /** Human-readable description of what was checked */
+    description: string;
+    /** Status of the check */
+    status: CheckStatus;
+    /** Detailed message about the result */
+    message: string;
+    /** Suggested next steps if the check failed or warned */
+    nextSteps?: string[];
+    /** Additional diagnostic details */
+    details?: Record<string, unknown>;
+}
+/**
+ * Options for running health checks
+ */
+export interface HealthCheckOptions {
+    /** Output in JSON format for machine consumption */
+    json?: boolean;
+    /** Include verbose diagnostic information */
+    verbose?: boolean;
+    /** Working directory to check (defaults to cwd) */
+    cwd?: string;
+}
+/**
+ * Overall health check result
+ */
+export interface HealthCheckResult {
+    /** Overall health status */
+    status: "healthy" | "degraded" | "unhealthy";
+    /** Timestamp of the health check */
+    timestamp: string;
+    /** Individual check results */
+    checks: HealthCheck[];
+    /** Summary counts */
+    summary: {
+        total: number;
+        passed: number;
+        failed: number;
+        warnings: number;
+    };
+    /** Aggregated next steps from all failing checks */
+    nextSteps: string[];
+}
+/**
+ * Runs all health checks and returns aggregated results
+ */
+export declare function runHealthCheck(options: HealthCheckOptions): Promise<HealthCheckResult>;
+/**
+ * CLI entry point for the health command
+ *
+ * @param options - Parsed CLI options
+ * @returns Exit code (0 for healthy, 1 for unhealthy)
+ */
+export declare function handleHealthCommand(options: HealthCheckOptions): Promise<number>;
+//# sourceMappingURL=health.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"health.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/health.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAeH;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;AAEnD;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,wBAAwB;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,qDAAqD;IACrD,WAAW,EAAE,MAAM,CAAC;IACpB,0BAA0B;IAC1B,MAAM,EAAE,WAAW,CAAC;IACpB,wCAAwC;IACxC,OAAO,EAAE,MAAM,CAAC;IAChB,yDAAyD;IACzD,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,oCAAoC;IACpC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,oDAAoD;IACpD,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,6CAA6C;IAC7C,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,mDAAmD;IACnD,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,4BAA4B;IAC5B,MAAM,EAAE,SAAS,GAAG,UAAU,GAAG,WAAW,CAAC;IAC7C,oCAAoC;IACpC,SAAS,EAAE,MAAM,CAAC;IAClB,+BAA+B;IAC/B,MAAM,EAAE,WAAW,EAAE,CAAC;IACtB,qBAAqB;IACrB,OAAO,EAAE;QACP,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,CAAC;QACf,MAAM,EAAE,MAAM,CAAC;QACf,QAAQ,EAAE,MAAM,CAAC;KAClB,CAAC;IACF,oDAAoD;IACpD,SAAS,EAAE,MAAM,EAAE,CAAC;CACrB;AAMD;;GAEG;AACH,wBAAsB,cAAc,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAkD5F;AAED;;;;;GAKG;AACH,wBAAsB,mBAAmB,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,MAAM,CAAC,CAkBtF"}

package/dist/cli/commands/health.js

@@ -0,0 +1,92 @@
+"use strict";
+/**
+ * health command - Verify SDK installation and environment health
+ *
+ * This command performs diagnostic checks to verify:
+ * - SDK CLI is properly installed and version is accessible
+ * - .a5c directory exists and is writable
+ * - Node.js version is compatible (>=18)
+ * - Package.json has babysitter-sdk dependency if in project context
+ * - Environment variables are set correctly
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runHealthCheck = runHealthCheck;
+exports.handleHealthCommand = handleHealthCommand;
+const output_1 = require("./health/output");
+const environment_1 = require("./health/environment");
+const checks_1 = require("./health/checks");
+// ============================================================================
+// Main Health Check Runner
+// ============================================================================
+/**
+ * Runs all health checks and returns aggregated results
+ */
+async function runHealthCheck(options) {
+    const cwd = options.cwd ?? process.cwd();
+    const timestamp = new Date().toISOString();
+    // Run all checks
+    const checks = await Promise.all([
+        (0, checks_1.checkSdkVersion)(),
+        (0, checks_1.checkNodeVersion)(),
+        (0, checks_1.checkA5cDirectory)(cwd),
+        (0, checks_1.checkPackageDependency)(cwd),
+        (0, environment_1.checkEnvironmentVariables)(),
+    ]);
+    // Calculate summary
+    const summary = {
+        total: checks.length,
+        passed: checks.filter((c) => c.status === "pass").length,
+        failed: checks.filter((c) => c.status === "fail").length,
+        warnings: checks.filter((c) => c.status === "warn").length,
+    };
+    // Determine overall status
+    let status;
+    if (summary.failed > 0) {
+        status = "unhealthy";
+    }
+    else if (summary.warnings > 0) {
+        status = "degraded";
+    }
+    else {
+        status = "healthy";
+    }
+    // Aggregate next steps from failing and warning checks
+    const nextSteps = checks
+        .filter((c) => c.status === "fail" || c.status === "warn")
+        .flatMap((c) => c.nextSteps ?? []);
+    const result = {
+        status,
+        timestamp,
+        checks,
+        summary,
+        nextSteps,
+    };
+    // Output results
+    if (!options.json) {
+        (0, output_1.outputTextResult)(result, options);
+    }
+    return result;
+}
+/**
+ * CLI entry point for the health command
+ *
+ * @param options - Parsed CLI options
+ * @returns Exit code (0 for healthy, 1 for unhealthy)
+ */
+async function handleHealthCommand(options) {
+    const result = await runHealthCheck(options);
+    if (options.json) {
+        console.log(JSON.stringify(result, null, 2));
+    }
+    // Return exit code based on status
+    switch (result.status) {
+        case "healthy":
+            return 0;
+        case "degraded":
+            return 0; // Warnings don't cause failure
+        case "unhealthy":
+            return 1;
+        default:
+            return 1;
+    }
+}

package/dist/cli/commands/hooks/log.d.ts

@@ -0,0 +1,15 @@
+/**
+ * hook:log CLI command.
+ *
+ * Reads a hook payload from stdin, extracts the relevant fields for the
+ * given hook type, formats a structured log line, and appends it to the
+ * specified log file.  This consolidates the field-extraction logic that
+ * was previously duplicated across 13 logger.sh shell scripts.
+ */
+export interface HookLogCommandArgs {
+    hookType: string;
+    logFile: string;
+    json: boolean;
+}
+export declare function handleHookLog(args: HookLogCommandArgs): Promise<number>;
+//# sourceMappingURL=log.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"log.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/hooks/log.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAYH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,OAAO,CAAC;CACf;AA8LD,wBAAsB,aAAa,CAAC,IAAI,EAAE,kBAAkB,GAAG,OAAO,CAAC,MAAM,CAAC,CAwG7E"}

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

@@ -0,0 +1,298 @@
+"use strict";
+/**
+ * hook:log CLI command.
+ *
+ * Reads a hook payload from stdin, extracts the relevant fields for the
+ * given hook type, formats a structured log line, and appends it to the
+ * specified log file.  This consolidates the field-extraction logic that
+ * was previously duplicated across 13 logger.sh shell scripts.
+ */
+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.handleHookLog = handleHookLog;
+const node_fs_1 = require("node:fs");
+const path = __importStar(require("node:path"));
+const resolveInputPath_1 = require("../../resolveInputPath");
+const sdkVersion_1 = require("../../../sdkVersion");
+// ---------------------------------------------------------------------------
+// Event label mapping (matches the label used in the original logger.sh)
+// ---------------------------------------------------------------------------
+const HOOK_EVENT_LABELS = {
+    "on-run-start": "RUN_START",
+    "on-run-complete": "RUN_COMPLETE",
+    "on-run-fail": "RUN_FAIL",
+    "on-task-start": "TASK_START",
+    "on-task-complete": "TASK_COMPLETE",
+    "on-step-dispatch": "STEP_DISPATCH",
+    "on-iteration-start": "ITERATION_START",
+    "on-iteration-end": "ITERATION_END",
+    "on-breakpoint": "BREAKPOINT",
+    "on-permission-denied": "PERMISSION_DENIED",
+    "pre-commit": "PRE_COMMIT",
+    "pre-branch": "PRE_BRANCH",
+    "post-planning": "POST_PLANNING",
+    "on-score": "SCORE",
+};
+const KNOWN_HOOK_TYPES = new Set(Object.keys(HOOK_EVENT_LABELS));
+// ---------------------------------------------------------------------------
+// Payload helpers
+// ---------------------------------------------------------------------------
+/** Safely read a string field from a parsed JSON object. */
+function str(payload, key, fallback = "unknown") {
+    const value = payload[key];
+    if (typeof value === "string")
+        return value;
+    if (typeof value === "number" || typeof value === "boolean")
+        return String(value);
+    return fallback;
+}
+/** Safely read a nested string field (e.g. ".context.runId"). */
+function nestedStr(payload, outerKey, innerKey, fallback = "unknown") {
+    const outer = payload[outerKey];
+    if (outer && typeof outer === "object" && !Array.isArray(outer)) {
+        const inner = outer[innerKey];
+        if (typeof inner === "string")
+            return inner;
+    }
+    return fallback;
+}
+/** Safely read the length of an array field. */
+function arrayLength(payload, key) {
+    const value = payload[key];
+    if (Array.isArray(value))
+        return String(value.length);
+    return "unknown";
+}
+const FIELD_EXTRACTORS = {
+    "on-run-start": (p) => [
+        ["runId", str(p, "runId")],
+        ["processId", str(p, "processId")],
+        ["entry", str(p, "entry")],
+    ],
+    "on-run-complete": (p) => [
+        ["runId", str(p, "runId")],
+        ["status", str(p, "status")],
+        ["duration", str(p, "duration")],
+    ],
+    "on-run-fail": (p) => [
+        ["runId", str(p, "runId")],
+        ["error", str(p, "error")],
+        ["duration", str(p, "duration")],
+    ],
+    "on-task-start": (p) => [
+        ["runId", str(p, "runId")],
+        ["effectId", str(p, "effectId")],
+        ["taskId", str(p, "taskId")],
+        ["kind", str(p, "kind")],
+    ],
+    "on-task-complete": (p) => [
+        ["runId", str(p, "runId")],
+        ["effectId", str(p, "effectId")],
+        ["taskId", str(p, "taskId")],
+        ["status", str(p, "status")],
+        ["duration", str(p, "duration")],
+    ],
+    "on-step-dispatch": (p) => [
+        ["runId", str(p, "runId")],
+        ["stepId", str(p, "stepId")],
+        ["action", str(p, "action")],
+    ],
+    "on-iteration-start": (p) => [
+        ["runId", str(p, "runId")],
+        ["iteration", str(p, "iteration")],
+    ],
+    "on-iteration-end": (p) => [
+        ["runId", str(p, "runId")],
+        ["iteration", str(p, "iteration")],
+        ["status", str(p, "status")],
+    ],
+    "on-breakpoint": (p) => [
+        // The original logger.sh uses: .runId // .context.runId // "unknown"
+        ["runId", typeof p.runId === "string" ? p.runId : nestedStr(p, "context", "runId")],
+        ["question", str(p, "question", "N/A")],
+        ["reason", str(p, "reason", "N/A")],
+    ],
+    "on-permission-denied": (p) => [
+        ["breakpointId", str(p, "breakpointId")],
+        ["kind", str(p, "kind")],
+        ["runId", str(p, "runId", "N/A")],
+        ["respondedBy", str(p, "respondedBy", "N/A")],
+    ],
+    "pre-commit": (p) => [
+        ["runId", str(p, "runId")],
+        ["files", arrayLength(p, "files")],
+        ["message", str(p, "message")],
+    ],
+    "pre-branch": (p) => [
+        ["runId", str(p, "runId")],
+        ["branch", str(p, "branch")],
+        ["base", str(p, "base")],
+    ],
+    "post-planning": (p) => [
+        ["runId", str(p, "runId")],
+        ["planFile", str(p, "planFile")],
+    ],
+    "on-score": (p) => [
+        ["runId", str(p, "runId")],
+        ["target", str(p, "target")],
+        ["score", str(p, "score")],
+    ],
+};
+// ---------------------------------------------------------------------------
+// Log line formatting
+// ---------------------------------------------------------------------------
+function formatLogLine(hookType, eventLabel, fields) {
+    const timestamp = new Date().toISOString();
+    const kvPairs = [...fields, ["sdkVersion", sdkVersion_1.BABYSITTER_SDK_VERSION]]
+        .map(([k, v]) => `${k}=${v}`)
+        .join(" ");
+    return `[${timestamp}] [${eventLabel}] hook=${hookType} ${kvPairs}`;
+}
+// ---------------------------------------------------------------------------
+// Stdin reader (reusable)
+// ---------------------------------------------------------------------------
+function readStdinUtf8() {
+    return new Promise((resolve, reject) => {
+        const chunks = [];
+        process.stdin.on("data", (chunk) => chunks.push(Buffer.from(chunk)));
+        process.stdin.on("end", () => resolve(Buffer.concat(chunks).toString("utf8")));
+        process.stdin.on("error", reject);
+    });
+}
+// ---------------------------------------------------------------------------
+// Main handler
+// ---------------------------------------------------------------------------
+async function handleHookLog(args) {
+    const { hookType, logFile, json } = args;
+    // Validate --hook-type
+    if (!hookType) {
+        const error = { error: "MISSING_HOOK_TYPE", message: "--hook-type is required" };
+        if (json) {
+            console.error(JSON.stringify(error, null, 2));
+        }
+        else {
+            console.error("Error: --hook-type is required for hook:log");
+        }
+        return 1;
+    }
+    // Validate --log-file
+    if (!logFile) {
+        const error = { error: "MISSING_LOG_FILE", message: "--log-file is required" };
+        if (json) {
+            console.error(JSON.stringify(error, null, 2));
+        }
+        else {
+            console.error("Error: --log-file is required for hook:log");
+        }
+        return 1;
+    }
+    // Read payload from stdin
+    let rawPayload;
+    try {
+        rawPayload = await readStdinUtf8();
+    }
+    catch (e) {
+        const msg = e instanceof Error ? e.message : String(e);
+        const error = { error: "STDIN_READ_ERROR", message: msg };
+        if (json) {
+            console.error(JSON.stringify(error, null, 2));
+        }
+        else {
+            console.error(`Error: Failed to read stdin: ${msg}`);
+        }
+        return 1;
+    }
+    // Parse JSON payload
+    let payload;
+    try {
+        const parsed = JSON.parse(rawPayload.trim() || "{}");
+        if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) {
+            throw new Error("Payload must be a JSON object");
+        }
+        payload = parsed;
+    }
+    catch (e) {
+        const msg = e instanceof Error ? e.message : String(e);
+        const error = { error: "INVALID_PAYLOAD", message: msg };
+        if (json) {
+            console.error(JSON.stringify(error, null, 2));
+        }
+        else {
+            console.error(`Error: Failed to parse JSON payload: ${msg}`);
+        }
+        return 1;
+    }
+    // Determine event label and field extractor
+    const isKnown = KNOWN_HOOK_TYPES.has(hookType);
+    const eventLabel = isKnown
+        ? HOOK_EVENT_LABELS[hookType]
+        : hookType.toUpperCase().replace(/-/g, "_");
+    const fields = isKnown
+        ? FIELD_EXTRACTORS[hookType](payload)
+        : [["runId", str(payload, "runId")]];
+    // Format log line
+    const logLine = formatLogLine(hookType, eventLabel, fields);
+    // Ensure log directory exists and append
+    try {
+        const resolvedLogFile = (0, resolveInputPath_1.resolveInputPath)(logFile);
+        const logDir = path.dirname(resolvedLogFile);
+        await node_fs_1.promises.mkdir(logDir, { recursive: true });
+        await node_fs_1.promises.appendFile(resolvedLogFile, logLine + "\n", "utf8");
+    }
+    catch (e) {
+        const msg = e instanceof Error ? e.message : String(e);
+        const error = { error: "LOG_WRITE_ERROR", message: msg };
+        if (json) {
+            console.error(JSON.stringify(error, null, 2));
+        }
+        else {
+            console.error(`Error: Failed to write to log file: ${msg}`);
+        }
+        return 1;
+    }
+    // Output confirmation
+    if (json) {
+        console.log(JSON.stringify({
+            hookType,
+            eventLabel,
+            logFile: (0, resolveInputPath_1.resolveInputPath)(logFile),
+            logLine,
+        }));
+    }
+    else {
+        console.log(logLine);
+    }
+    return 0;
+}

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

@@ -0,0 +1,25 @@
+/**
+ * hook:run CLI command.
+ *
+ * Dispatches hook handling to the appropriate harness adapter.
+ * Each harness (e.g. "claude-code") implements its own stop and
+ * session-start handlers via the HarnessAdapter interface.
+ *
+ * The "user-prompt-submit" hook type is harness-agnostic: it reads the
+ * Claude Code UserPromptSubmit JSON payload from stdin, applies density-filter
+ * compression if the prompt exceeds the configured token threshold, and writes
+ * the (possibly compressed) payload to stdout.
+ */
+export interface HookRunCommandArgs {
+    hookType: string;
+    /** Which host tool is invoking the hook. Auto-detected from caller env, falls back to "claude-code". */
+    harness: string;
+    /** @deprecated Resolved from environment automatically (CLAUDE_PLUGIN_ROOT, CODEX_PLUGIN_ROOT, etc.). Accepted for backward compatibility. */
+    pluginRoot?: string;
+    stateDir?: string;
+    runsDir?: string;
+    json: boolean;
+    verbose?: boolean;
+}
+export declare function handleHookRun(args: HookRunCommandArgs): Promise<number>;
+//# sourceMappingURL=run.d.ts.map

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

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