@a5c-ai/babysitter-sdk 0.0.29 → 0.0.30

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

@@ -0,0 +1,32 @@
+/**
+ * run:iterate command - Execute one orchestration iteration
+ *
+ * This command:
+ * 1. Calls on-iteration-start hooks to get orchestration decisions
+ * 2. Returns effects to stdout as JSON
+ * 3. External orchestrator (skill) performs the effects
+ * 4. Calls on-iteration-end hooks for finalization
+ *
+ * The command does NOT loop - it handles exactly one iteration.
+ */
+export interface RunIterateOptions {
+    runDir: string;
+    iteration?: number;
+    verbose?: boolean;
+    json?: boolean;
+}
+export interface RunIterateResult {
+    iteration: number;
+    status: "executed" | "waiting" | "completed" | "failed" | "none";
+    action?: string;
+    reason?: string;
+    count?: number;
+    until?: number;
+    metadata?: {
+        runId: string;
+        processId: string;
+        hookStatus?: string;
+    };
+}
+export declare function runIterate(options: RunIterateOptions): Promise<RunIterateResult>;
+//# sourceMappingURL=runIterate.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"runIterate.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/runIterate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAMH,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,UAAU,GAAG,SAAS,GAAG,WAAW,GAAG,QAAQ,GAAG,MAAM,CAAC;IACjE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE;QACT,KAAK,EAAE,MAAM,CAAC;QACd,SAAS,EAAE,MAAM,CAAC;QAClB,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB,CAAC;CACH;AAED,wBAAsB,UAAU,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CA8GtF"}

package/dist/cli/commands/runIterate.js

@@ -0,0 +1,143 @@
+"use strict";
+/**
+ * run:iterate command - Execute one orchestration iteration
+ *
+ * This command:
+ * 1. Calls on-iteration-start hooks to get orchestration decisions
+ * 2. Returns effects to stdout as JSON
+ * 3. External orchestrator (skill) performs the effects
+ * 4. Calls on-iteration-end hooks for finalization
+ *
+ * The command does NOT loop - it handles exactly one iteration.
+ */
+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.runIterate = runIterate;
+const path = __importStar(require("path"));
+const runFiles_1 = require("../../storage/runFiles");
+const runtime_1 = require("../../runtime/hooks/runtime");
+async function runIterate(options) {
+    const { runDir, verbose } = options;
+    // Read run metadata
+    const metadata = await (0, runFiles_1.readRunMetadata)(runDir);
+    const runId = metadata.runId;
+    // Determine iteration number
+    // TODO: Read from state.json or journal
+    const iteration = options.iteration ?? 1;
+    const projectRoot = path.dirname(path.dirname(path.dirname(runDir)));
+    if (verbose) {
+        console.error(`[run:iterate] Starting iteration ${iteration} for run ${runId}`);
+    }
+    // === Call on-iteration-start hook ===
+    // Hook analyzes state and returns orchestration decisions
+    const iterationStartPayload = {
+        runId,
+        iteration,
+        timestamp: new Date().toISOString(),
+    };
+    const hookResult = await (0, runtime_1.callRuntimeHook)("on-iteration-start", iterationStartPayload, {
+        cwd: projectRoot,
+        logger: verbose ? ((msg) => console.error(msg)) : undefined,
+    });
+    // Parse hook output
+    let hookDecision = {};
+    if (hookResult.output) {
+        try {
+            hookDecision = typeof hookResult.output === "string"
+                ? JSON.parse(hookResult.output)
+                : hookResult.output;
+        }
+        catch (e) {
+            if (verbose) {
+                console.error(`[run:iterate] Warning: Could not parse hook output:`, hookResult.output);
+            }
+        }
+    }
+    const action = hookDecision.action || "none";
+    const reason = hookDecision.reason || "unknown";
+    const count = hookDecision.count;
+    const until = hookDecision.until;
+    if (verbose) {
+        console.error(`[run:iterate] Hook action: ${action}, reason: ${reason}${count ? `, count: ${count}` : ""}`);
+    }
+    // Determine result status based on hook action
+    let status;
+    // Check for terminal state first
+    if (reason === "terminal-state") {
+        status = hookDecision.status === "failed" ? "failed" : "completed";
+    }
+    else if (action === "executed-tasks") {
+        status = "executed";
+    }
+    else if (action === "waiting") {
+        status = "waiting";
+    }
+    else if (action === "none") {
+        status = "none";
+    }
+    else {
+        // Default to none for unknown actions
+        status = "none";
+    }
+    // === Call on-iteration-end hook ===
+    const iterationEndPayload = {
+        runId,
+        iteration,
+        action,
+        status,
+        reason,
+        count,
+        timestamp: new Date().toISOString(),
+    };
+    await (0, runtime_1.callRuntimeHook)("on-iteration-end", iterationEndPayload, {
+        cwd: projectRoot,
+        logger: verbose ? ((msg) => console.error(msg)) : undefined,
+    });
+    // Return result
+    const result = {
+        iteration,
+        status,
+        action,
+        reason,
+        count,
+        until,
+        metadata: {
+            runId,
+            processId: metadata.processId,
+            hookStatus: hookResult.executedHooks?.length > 0 ? "executed" : "none",
+        },
+    };
+    return result;
+}

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

@@ -1 +1 @@
-{"version":3,"file":"main.d.ts","sourceRoot":"","sources":["../../src/cli/main.ts"],"names":[],"mappings":";AA+rDA,wBAAgB,mBAAmB;eAEf,MAAM,EAAE,GAA2B,OAAO,CAAC,MAAM,CAAC;kBA4CpD,MAAM;EAIvB"}
+{"version":3,"file":"main.d.ts","sourceRoot":"","sources":["../../src/cli/main.ts"],"names":[],"mappings":";AA4sCA,wBAAgB,mBAAmB;eAEf,MAAM,EAAE,GAA2B,OAAO,CAAC,MAAM,CAAC;kBAyCpD,MAAM;EAIvB"}