aoaoe 0.1.0

package/dist/executor.js

@@ -0,0 +1,138 @@
+import { exec, execQuiet } from "./shell.js";
+import { appendFileSync, mkdirSync } from "node:fs";
+import { join } from "node:path";
+import { homedir } from "node:os";
+const LOG_DIR = join(homedir(), ".aoaoe");
+const LOG_FILE = join(LOG_DIR, "actions.log");
+export class Executor {
+    config;
+    actionLog = [];
+    recentActions = new Map(); // session -> last action timestamp
+    constructor(config) {
+        this.config = config;
+        // ensure log dir exists
+        try {
+            mkdirSync(LOG_DIR, { recursive: true });
+        }
+        catch { }
+    }
+    async execute(actions, snapshots) {
+        const results = [];
+        for (const action of actions) {
+            // rate limit: don't hammer the same session
+            if ("session" in action && action.session) {
+                if (this.isRateLimited(action.session)) {
+                    const entry = this.logAction(action, false, "rate limited (too soon)");
+                    results.push(entry);
+                    continue;
+                }
+            }
+            const entry = await this.executeOne(action, snapshots);
+            results.push(entry);
+        }
+        return results;
+    }
+    async executeOne(action, snapshots) {
+        switch (action.action) {
+            case "send_input":
+                return this.sendInput(action.session, action.text, snapshots);
+            case "start_session":
+                return this.startSession(action.session);
+            case "stop_session":
+                return this.stopSession(action.session);
+            case "create_agent":
+                return this.createAgent(action.path, action.title, action.tool);
+            case "remove_agent":
+                return this.removeAgent(action.session);
+            case "wait":
+                return this.logAction(action, true, action.reason ?? "no action needed");
+            default:
+                return this.logAction(action, false, "unknown action type");
+        }
+    }
+    async sendInput(sessionId, text, snapshots) {
+        // resolve tmux session name from session ID
+        const tmuxName = this.resolveTmuxName(sessionId, snapshots);
+        if (!tmuxName) {
+            return this.logAction({ action: "send_input", session: sessionId, text }, false, `could not resolve tmux name for session ${sessionId}`);
+        }
+        // safety: refuse empty or whitespace-only input
+        if (!text.trim()) {
+            return this.logAction({ action: "send_input", session: sessionId, text }, false, "refusing to send empty input");
+        }
+        // tmux send-keys sends literal text then Enter
+        const ok = await execQuiet("tmux", ["send-keys", "-t", tmuxName, text, "Enter"]);
+        this.markAction(sessionId);
+        return this.logAction({ action: "send_input", session: sessionId, text }, ok, ok ? `sent to ${tmuxName}` : `send-keys failed for ${tmuxName}`);
+    }
+    async startSession(sessionId) {
+        const result = await exec("aoe", ["session", "start", sessionId]);
+        this.markAction(sessionId);
+        return this.logAction({ action: "start_session", session: sessionId }, result.exitCode === 0, result.exitCode === 0 ? "started" : result.stderr.trim());
+    }
+    async stopSession(sessionId) {
+        const result = await exec("aoe", ["session", "stop", sessionId]);
+        this.markAction(sessionId);
+        return this.logAction({ action: "stop_session", session: sessionId }, result.exitCode === 0, result.exitCode === 0 ? "stopped" : result.stderr.trim());
+    }
+    async createAgent(path, title, tool) {
+        const args = ["add", path, "-t", title, "-c", tool, "-y"]; // -y for yolo mode
+        const result = await exec("aoe", args);
+        return this.logAction({ action: "create_agent", path, title, tool }, result.exitCode === 0, result.exitCode === 0 ? "created" : result.stderr.trim());
+    }
+    async removeAgent(sessionId) {
+        const result = await exec("aoe", ["remove", sessionId, "-y"]);
+        this.markAction(sessionId);
+        return this.logAction({ action: "remove_agent", session: sessionId }, result.exitCode === 0, result.exitCode === 0 ? "removed" : result.stderr.trim());
+    }
+    resolveTmuxName(sessionId, snapshots) {
+        // try exact match first
+        const exact = snapshots.find((s) => s.session.id === sessionId);
+        if (exact?.session.tmux_name)
+            return exact.session.tmux_name;
+        // try prefix match (reasoner might return truncated IDs)
+        const prefix = snapshots.find((s) => s.session.id.startsWith(sessionId));
+        if (prefix?.session.tmux_name)
+            return prefix.session.tmux_name;
+        // try title match
+        const byTitle = snapshots.find((s) => s.session.title.toLowerCase() === sessionId.toLowerCase());
+        if (byTitle?.session.tmux_name)
+            return byTitle.session.tmux_name;
+        return null;
+    }
+    // rate limiting: don't act on the same session more than once per 30s
+    isRateLimited(sessionId) {
+        const last = this.recentActions.get(sessionId);
+        if (!last)
+            return false;
+        return Date.now() - last < 30_000;
+    }
+    markAction(sessionId) {
+        this.recentActions.set(sessionId, Date.now());
+    }
+    logAction(action, success, detail) {
+        const entry = {
+            timestamp: Date.now(),
+            action,
+            success,
+            detail,
+        };
+        this.actionLog.push(entry);
+        // keep in-memory log bounded
+        if (this.actionLog.length > 1000) {
+            this.actionLog = this.actionLog.slice(-500);
+        }
+        // persist to ~/.aoaoe/actions.log (JSONL, one entry per line)
+        if (action.action !== "wait") {
+            try {
+                appendFileSync(LOG_FILE, JSON.stringify(entry) + "\n");
+            }
+            catch { } // best-effort, don't crash the daemon
+        }
+        return entry;
+    }
+    getRecentLog(n = 20) {
+        return this.actionLog.slice(-n);
+    }
+}
+//# sourceMappingURL=executor.js.map

package/dist/executor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"executor.js","sourceRoot":"","sources":["../src/executor.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/dist/index.js

@@ -0,0 +1,153 @@
+#!/usr/bin/env node
+import { loadConfig, validateEnvironment, parseCliArgs, printHelp } from "./config.js";
+import { Poller } from "./poller.js";
+import { createReasoner } from "./reasoner/index.js";
+import { Executor } from "./executor.js";
+import { printDashboard } from "./dashboard.js";
+import { readFileSync } from "node:fs";
+import { resolve, dirname } from "node:path";
+import { fileURLToPath } from "node:url";
+const __dirname = dirname(fileURLToPath(import.meta.url));
+async function main() {
+    const { overrides, help, version } = parseCliArgs(process.argv);
+    if (help) {
+        printHelp();
+        process.exit(0);
+    }
+    if (version) {
+        try {
+            const pkg = JSON.parse(readFileSync(resolve(__dirname, "..", "package.json"), "utf-8"));
+            console.log(`aoaoe ${pkg.version}`);
+        }
+        catch {
+            console.log("aoaoe (version unknown)");
+        }
+        process.exit(0);
+    }
+    const config = loadConfig(overrides);
+    log("starting aoaoe supervisor");
+    log(`reasoner: ${config.reasoner}`);
+    log(`poll interval: ${config.pollIntervalMs}ms`);
+    if (config.dryRun)
+        log("DRY RUN -- will observe and reason but not execute");
+    // validate tools are installed
+    await validateEnvironment(config);
+    const poller = new Poller(config);
+    const reasoner = createReasoner(config);
+    const executor = new Executor(config);
+    // init reasoner (starts opencode serve, verifies claude, etc)
+    log("initializing reasoner...");
+    await reasoner.init();
+    log("reasoner ready");
+    // graceful shutdown
+    let running = true;
+    const shutdown = async () => {
+        if (!running)
+            return;
+        running = false;
+        log("shutting down...");
+        await reasoner.shutdown();
+        process.exit(0);
+    };
+    process.on("SIGINT", shutdown);
+    process.on("SIGTERM", shutdown);
+    // main loop
+    let pollCount = 0;
+    log("entering main loop (Ctrl+C to stop)\n");
+    while (running) {
+        pollCount++;
+        try {
+            await tick(config, poller, reasoner, executor, pollCount);
+        }
+        catch (err) {
+            console.error(`[error] tick ${pollCount} failed: ${err}`);
+        }
+        if (running) {
+            await sleep(config.pollIntervalMs);
+        }
+    }
+}
+async function tick(config, poller, reasoner, executor, pollCount) {
+    // 1. poll
+    const observation = await poller.poll();
+    const sessionCount = observation.sessions.length;
+    const changeCount = observation.changes.length;
+    if (sessionCount === 0) {
+        if (pollCount % 6 === 1) {
+            // log every ~60s when no sessions
+            log("no active aoe sessions found");
+        }
+        return;
+    }
+    // dashboard every 6 polls (~60s at default interval)
+    if (pollCount % 6 === 1) {
+        printDashboard(observation, executor.getRecentLog(), pollCount, config);
+    }
+    // status line
+    const statuses = summarizeStatuses(observation);
+    process.stdout.write(`\r[poll #${pollCount}] ${sessionCount} sessions (${statuses}) | ${changeCount} changed`);
+    // 2. if nothing changed, skip reasoning (save tokens)
+    if (changeCount === 0) {
+        if (config.verbose) {
+            process.stdout.write(" | no changes, skipping reasoner\n");
+        }
+        return;
+    }
+    process.stdout.write(" | reasoning...");
+    // 3. reason (with timeout to avoid blocking the loop)
+    const result = await withTimeout(reasoner.decide(observation), 90_000, // 90s max for a single reasoning call
+    { actions: [{ action: "wait", reason: "reasoner timeout" }] });
+    const actionSummary = result.actions.map((a) => a.action).join(", ");
+    process.stdout.write(` -> ${actionSummary}\n`);
+    if (result.reasoning && config.verbose) {
+        log(`reasoning: ${result.reasoning}`);
+    }
+    // 4. execute (skip if all actions are "wait")
+    const nonWaitActions = result.actions.filter((a) => a.action !== "wait");
+    if (nonWaitActions.length === 0) {
+        return;
+    }
+    // dry-run: log what would happen, don't actually execute
+    if (config.dryRun) {
+        for (const action of nonWaitActions) {
+            log(`[dry-run] would ${action.action}: ${JSON.stringify(action)}`);
+        }
+        return;
+    }
+    const entries = await executor.execute(result.actions, observation.sessions);
+    for (const entry of entries) {
+        if (entry.action.action === "wait")
+            continue;
+        const icon = entry.success ? "+" : "!";
+        log(`[${icon}] ${entry.action.action}: ${entry.detail}`);
+    }
+}
+function summarizeStatuses(obs) {
+    const counts = new Map();
+    for (const snap of obs.sessions) {
+        const s = snap.session.status;
+        counts.set(s, (counts.get(s) ?? 0) + 1);
+    }
+    return [...counts.entries()].map(([k, v]) => `${v} ${k}`).join(", ");
+}
+function log(msg) {
+    const ts = new Date().toLocaleTimeString();
+    console.error(`[${ts}] ${msg}`);
+}
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+function withTimeout(promise, ms, fallback) {
+    return Promise.race([
+        promise,
+        new Promise((resolve) => setTimeout(() => {
+            log(`reasoner timed out after ${ms}ms, using fallback`);
+            resolve(fallback);
+        }, ms)),
+    ]);
+}
+main().catch((err) => {
+    console.error(`fatal: ${err}`);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/poller.d.ts

@@ -0,0 +1,14 @@
+import type { AoaoeConfig, Observation } from "./types.js";
+export declare class Poller {
+    private config;
+    private previousSnapshots;
+    constructor(config: AoaoeConfig);
+    poll(): Promise<Observation>;
+    private listSessions;
+    private getSessionStatus;
+    private captureSession;
+    private captureTmuxPane;
+    private diffSnapshots;
+    private log;
+}
+//# sourceMappingURL=poller.d.ts.map

package/dist/poller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"poller.d.ts","sourceRoot":"","sources":["../src/poller.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,WAAW,EAIX,WAAW,EACZ,MAAM,YAAY,CAAC;AAEpB,qBAAa,MAAM;IACjB,OAAO,CAAC,MAAM,CAAc;IAC5B,OAAO,CAAC,iBAAiB,CAA2C;gBAExD,MAAM,EAAE,WAAW;IAIzB,IAAI,IAAI,OAAO,CAAC,WAAW,CAAC;YAsBpB,YAAY;YAwCZ,gBAAgB;YAWhB,cAAc;YAYd,eAAe;IAqB7B,OAAO,CAAC,aAAa;IA6BrB,OAAO,CAAC,GAAG;CAKZ"}

package/dist/poller.js

@@ -0,0 +1,167 @@
+import { createHash } from "node:crypto";
+import { exec } from "./shell.js";
+export class Poller {
+    config;
+    previousSnapshots = new Map();
+    constructor(config) {
+        this.config = config;
+    }
+    async poll() {
+        const sessions = await this.listSessions();
+        const snapshots = await Promise.all(sessions.map((s) => this.captureSession(s)));
+        const changes = this.diffSnapshots(snapshots);
+        const observation = {
+            timestamp: Date.now(),
+            sessions: snapshots,
+            changes,
+        };
+        // store current snapshots for next diff
+        this.previousSnapshots.clear();
+        for (const snap of snapshots) {
+            this.previousSnapshots.set(snap.session.id, snap);
+        }
+        return observation;
+    }
+    async listSessions() {
+        // aoe list --json returns array with id, title, path, tool, command, profile, created_at
+        // does NOT include status or tmux_name -- we derive both
+        const result = await exec("aoe", ["list", "--json"]);
+        if (result.exitCode !== 0) {
+            this.log(`aoe list failed: ${result.stderr}`);
+            return [];
+        }
+        let raw;
+        try {
+            const parsed = JSON.parse(result.stdout);
+            raw = Array.isArray(parsed) ? parsed : [];
+        }
+        catch (e) {
+            this.log(`failed to parse aoe list output: ${e}`);
+            return [];
+        }
+        // fetch per-session status in parallel
+        const sessions = await Promise.all(raw.map(async (s) => {
+            const id = String(s.id ?? "");
+            const title = String(s.title ?? "");
+            const status = await this.getSessionStatus(id);
+            return {
+                id,
+                title,
+                path: String(s.path ?? ""),
+                tool: String(s.tool ?? ""),
+                status,
+                tmux_name: computeTmuxName(id, title),
+                group: s.group ? String(s.group) : undefined,
+                created_at: s.created_at ? String(s.created_at) : undefined,
+            };
+        }));
+        return sessions;
+    }
+    async getSessionStatus(id) {
+        const result = await exec("aoe", ["session", "show", id, "--json"]);
+        if (result.exitCode !== 0)
+            return "unknown";
+        try {
+            const data = JSON.parse(result.stdout);
+            return String(data.status ?? "unknown");
+        }
+        catch {
+            return "unknown";
+        }
+    }
+    async captureSession(session) {
+        const output = await this.captureTmuxPane(session.tmux_name);
+        const outputHash = quickHash(output);
+        return {
+            session,
+            output,
+            outputHash,
+            capturedAt: Date.now(),
+        };
+    }
+    async captureTmuxPane(tmuxName) {
+        if (!tmuxName)
+            return "";
+        const result = await exec("tmux", [
+            "capture-pane",
+            "-t",
+            tmuxName,
+            "-p", // print to stdout
+            "-S",
+            `-${this.config.captureLinesCount}`, // last N lines
+        ]);
+        if (result.exitCode !== 0) {
+            // session might not exist in tmux (stopped, etc)
+            return "";
+        }
+        // trim trailing blank lines that tmux pads
+        return result.stdout.replace(/\n+$/, "");
+    }
+    diffSnapshots(current) {
+        const changes = [];
+        for (const snap of current) {
+            const prev = this.previousSnapshots.get(snap.session.id);
+            // no previous snapshot = first poll, skip to avoid spamming the reasoner
+            // with all existing output on startup
+            if (!prev)
+                continue;
+            // same hash = no change
+            if (snap.outputHash === prev.outputHash)
+                continue;
+            // find new lines by diffing output
+            const newLines = extractNewLines(prev.output, snap.output);
+            if (newLines.trim()) {
+                changes.push({
+                    sessionId: snap.session.id,
+                    title: snap.session.title,
+                    tool: snap.session.tool,
+                    status: snap.session.status,
+                    newLines,
+                });
+            }
+        }
+        return changes;
+    }
+    log(msg) {
+        if (this.config.verbose) {
+            console.error(`[poller] ${msg}`);
+        }
+    }
+}
+// replicate AoE tmux naming: aoe_<sanitized_title_max20>_<first8_of_id>
+// from agent-of-empires/src/tmux/session.rs:22-25
+function computeTmuxName(id, title) {
+    const safeTitle = sanitizeTmuxName(title);
+    const shortId = id.slice(0, 8);
+    return `aoe_${safeTitle}_${shortId}`;
+}
+// AoE sanitization: only [a-zA-Z0-9_-], max 20 chars, everything else -> _
+// from agent-of-empires/src/tmux/session.rs:220-231
+function sanitizeTmuxName(name) {
+    const sanitized = name.replace(/[^a-zA-Z0-9_-]/g, "_");
+    return sanitized.slice(0, 20);
+}
+function quickHash(s) {
+    return createHash("sha256").update(s).digest("hex").slice(0, 16);
+}
+// extract lines in `current` that weren't in `previous`
+function extractNewLines(previous, current) {
+    const prevLines = previous.split("\n");
+    const currLines = current.split("\n");
+    if (prevLines.length === 0)
+        return current;
+    // look for the last few non-empty lines of previous in current to find the overlap point
+    const anchorLines = prevLines.filter((l) => l.trim()).slice(-5);
+    if (anchorLines.length === 0)
+        return current;
+    const anchor = anchorLines.join("\n");
+    const currJoined = currLines.join("\n");
+    const anchorIdx = currJoined.lastIndexOf(anchor);
+    if (anchorIdx >= 0) {
+        const after = currJoined.slice(anchorIdx + anchor.length);
+        return after.replace(/^\n/, "");
+    }
+    // no overlap found (screen clear, etc) -- return last 20 lines
+    return currLines.slice(-20).join("\n");
+}
+//# sourceMappingURL=poller.js.map

package/dist/poller.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"poller.js","sourceRoot":"","sources":["../src/poller.ts"],"names":[],"mappings":"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"}

package/dist/reasoner/claude-code.d.ts

@@ -0,0 +1,15 @@
+import type { AoaoeConfig, Reasoner, Observation, ReasonerResult } from "../types.js";
+export declare class ClaudeCodeReasoner implements Reasoner {
+    private config;
+    private sessionId;
+    constructor(config: AoaoeConfig);
+    init(): Promise<void>;
+    decide(observation: Observation): Promise<ReasonerResult>;
+    shutdown(): Promise<void>;
+    private buildArgs;
+    private tryExtractSessionId;
+    private parseResponse;
+    private validateResult;
+    private log;
+}
+//# sourceMappingURL=claude-code.d.ts.map

package/dist/reasoner/claude-code.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-code.d.ts","sourceRoot":"","sources":["../../src/reasoner/claude-code.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,WAAW,EAAE,cAAc,EAAU,MAAM,aAAa,CAAC;AAM9F,qBAAa,kBAAmB,YAAW,QAAQ;IACjD,OAAO,CAAC,MAAM,CAAc;IAC5B,OAAO,CAAC,SAAS,CAAuB;gBAE5B,MAAM,EAAE,WAAW;IAIzB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IASrB,MAAM,CAAC,WAAW,EAAE,WAAW,GAAG,OAAO,CAAC,cAAc,CAAC;IAkBzD,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAI/B,OAAO,CAAC,SAAS;IA8BjB,OAAO,CAAC,mBAAmB;IAS3B,OAAO,CAAC,aAAa;IAkCrB,OAAO,CAAC,cAAc;IAsBtB,OAAO,CAAC,GAAG;CAGZ"}

package/dist/reasoner/claude-code.js

@@ -0,0 +1,119 @@
+import { exec } from "../shell.js";
+import { SYSTEM_PROMPT, formatObservation } from "./prompt.js";
+// Claude Code backend: uses `claude --print` subprocess for each decision.
+// Optionally stateful via `--resume`.
+export class ClaudeCodeReasoner {
+    config;
+    sessionId = null;
+    constructor(config) {
+        this.config = config;
+    }
+    async init() {
+        // verify claude is available
+        const result = await exec("claude", ["--version"]);
+        if (result.exitCode !== 0) {
+            throw new Error("claude CLI not found or not working");
+        }
+        this.log(`claude available: ${result.stdout.trim()}`);
+    }
+    async decide(observation) {
+        const prompt = formatObservation(observation);
+        const args = this.buildArgs(prompt);
+        const result = await exec("claude", args, 120_000);
+        if (result.exitCode !== 0) {
+            this.log(`claude failed: ${result.stderr}`);
+            return { actions: [{ action: "wait", reason: "reasoner error" }] };
+        }
+        // capture session ID from output for --resume on next call
+        if (this.config.claudeCode.resume) {
+            this.tryExtractSessionId(result.stderr + result.stdout);
+        }
+        return this.parseResponse(result.stdout);
+    }
+    async shutdown() {
+        // stateless subprocess, nothing to clean up
+    }
+    buildArgs(prompt) {
+        const args = ["--print"];
+        // output format
+        args.push("--output-format", "text");
+        // system prompt injection
+        args.push("--append-system-prompt", SYSTEM_PROMPT);
+        // model selection
+        if (this.config.claudeCode.model) {
+            args.push("--model", this.config.claudeCode.model);
+        }
+        // YOLO mode for unattended operation
+        if (this.config.claudeCode.yolo) {
+            args.push("--dangerously-skip-permissions");
+        }
+        // resume previous session for context continuity
+        if (this.config.claudeCode.resume && this.sessionId) {
+            args.push("--resume", this.sessionId);
+        }
+        // the actual prompt
+        args.push(prompt);
+        return args;
+    }
+    tryExtractSessionId(output) {
+        // claude prints session info to stderr, try to capture it
+        // format varies by version, look for common patterns
+        const match = output.match(/session[_\s]?(?:id)?[:\s]+([a-f0-9-]+)/i);
+        if (match) {
+            this.sessionId = match[1];
+        }
+    }
+    parseResponse(raw) {
+        const trimmed = raw.trim();
+        // try direct JSON parse
+        try {
+            return this.validateResult(JSON.parse(trimmed));
+        }
+        catch {
+            // not direct JSON
+        }
+        // extract from markdown code blocks
+        const jsonMatch = trimmed.match(/```(?:json)?\s*\n?([\s\S]*?)\n?```/);
+        if (jsonMatch) {
+            try {
+                return this.validateResult(JSON.parse(jsonMatch[1]));
+            }
+            catch {
+                // fall through
+            }
+        }
+        // find first { ... } block
+        const braceMatch = trimmed.match(/\{[\s\S]*\}/);
+        if (braceMatch) {
+            try {
+                return this.validateResult(JSON.parse(braceMatch[0]));
+            }
+            catch {
+                // give up
+            }
+        }
+        this.log(`failed to parse: ${trimmed.slice(0, 200)}`);
+        return { actions: [{ action: "wait", reason: "failed to parse reasoner response" }] };
+    }
+    validateResult(parsed) {
+        if (typeof parsed !== "object" || parsed === null) {
+            return { actions: [{ action: "wait", reason: "invalid response" }] };
+        }
+        const obj = parsed;
+        const actions = Array.isArray(obj.actions) ? obj.actions : [];
+        const validActions = actions
+            .filter((a) => typeof a === "object" && a !== null && "action" in a)
+            .map((a) => a);
+        if (validActions.length === 0) {
+            validActions.push({ action: "wait", reason: "no valid actions" });
+        }
+        return {
+            actions: validActions,
+            reasoning: typeof obj.reasoning === "string" ? obj.reasoning : undefined,
+        };
+    }
+    log(msg) {
+        console.error(`[reasoner:claude-code] ${msg}`);
+    }
+}
+//# sourceMappingURL=claude-code.js.map