aoaoe 0.52.0 → 0.54.0

package/README.md

@@ -238,6 +238,10 @@ aoaoe [command] [options]
 commands:
   (none)         start the supervisor daemon (interactive TUI)
   init           detect tools + sessions, import history, generate config
+  status         quick daemon health check (is it running? what's it doing?)
+  config         show the effective resolved config (defaults + file)
+  config --validate  validate config + check tool availability
+  notify-test    send a test notification to configured webhooks
   task           manage tasks and sessions (list, start, stop, new, rm, edit)
   tasks          show task progress (from aoaoe.tasks.json)
   history        review recent actions (from ~/.aoaoe/actions.log)
@@ -297,7 +301,12 @@ Config lives at `~/.aoaoe/aoaoe.config.json` (canonical, written by `aoaoe init`
     "adventure": "github/adventure",
     "cloudchamber": "cc/cloudchamber"
   },
-  "contextFiles": []
+  "contextFiles": [],
+  "notifications": {
+    "webhookUrl": "https://example.com/webhook",
+    "slackWebhookUrl": "https://hooks.slack.com/services/T.../B.../xxx",
+    "events": ["session_error", "session_done", "daemon_started", "daemon_stopped"]
+  }
 }
 ```
 
@@ -321,6 +330,9 @@ Config lives at `~/.aoaoe/aoaoe.config.json` (canonical, written by `aoaoe init`
 | `sessionDirs` | Map session titles to project directories (relative to cwd or absolute). Bypasses heuristic directory search. | `{}` |
 | `contextFiles` | Extra AI instruction file paths to load from each project root | `[]` |
 | `captureLinesCount` | Number of tmux lines to capture per session (`-S` flag) | `100` |
+| `notifications.webhookUrl` | Generic webhook URL (POST JSON) | (none) |
+| `notifications.slackWebhookUrl` | Slack incoming webhook URL (block kit format) | (none) |
+| `notifications.events` | Filter which events fire (omit to send all). Valid: `session_error`, `session_done`, `action_executed`, `action_failed`, `daemon_started`, `daemon_stopped` | (all) |
 
 Also reads `.aoaoe.json` as an alternative config filename.
 
@@ -342,7 +354,25 @@ For non-standard layouts or when the session title doesn't match the directory n
 
 Paths can be relative (resolved from the directory where you run `aoaoe`) or absolute. Case-insensitive matching is used for session title lookup. If a mapped path doesn't exist on disk, aoaoe falls back to heuristic search.
 
-Use `aoaoe test-context` to verify resolution:
+Use `aoaoe test-context` to verify resolution.
+
+### `notifications` — webhook alerts for daemon events
+
+aoaoe can send webhook notifications when significant events occur (session errors, task completions, daemon start/stop). Supports generic JSON webhooks and Slack incoming webhooks with block kit formatting.
+
+```json
+{
+  "notifications": {
+    "webhookUrl": "https://example.com/webhook",
+    "slackWebhookUrl": "https://hooks.slack.com/services/T.../B.../xxx",
+    "events": ["session_error", "session_done", "daemon_started", "daemon_stopped"]
+  }
+}
+```
+
+Both webhook URLs are optional — configure one or both. The `events` array filters which event types fire (omit it to receive all events). Notifications are fire-and-forget with a 5s timeout and 60s rate limiting per event+session combo to prevent spam.
+
+Run `aoaoe notify-test` to verify your webhook configuration.
 
 ## How It Works
 
@@ -460,6 +490,7 @@ src/
   tui.ts            # in-place terminal UI (alternate screen, scroll regions)
   input.ts          # stdin readline listener with inject() for post-interrupt
   init.ts           # `aoaoe init`: auto-discover tools, sessions, generate config
+  notify.ts         # webhook + Slack notification dispatcher for daemon events
   colors.ts         # shared ANSI color/style constants
   context.ts        # discoverContextFiles, resolveProjectDir, loadSessionContext
   activity.ts       # detect human keystrokes in tmux sessions

package/dist/config.d.ts

@@ -20,6 +20,8 @@ export declare function parseCliArgs(argv: string[]): {
     showHistory: boolean;
     showStatus: boolean;
     showConfig: boolean;
+    configValidate: boolean;
+    notifyTest: boolean;
     runInit: boolean;
     initForce: boolean;
     runTaskCli: boolean;

package/dist/config.js

@@ -274,7 +274,7 @@ export function parseCliArgs(argv) {
     let initForce = false;
     let runTaskCli = false;
     let registerTitle;
-    const defaults = { overrides, help: false, version: false, register: false, testContext: false, runTest: false, showTasks: false, showHistory: false, showStatus: false, showConfig: false, runInit: false, initForce: false, runTaskCli: false };
+    const defaults = { overrides, help: false, version: false, register: false, testContext: false, runTest: false, showTasks: false, showHistory: false, showStatus: false, showConfig: false, configValidate: false, notifyTest: false, runInit: false, initForce: false, runTaskCli: false };
     // check for subcommand as first non-flag arg
     if (argv[2] === "test-context") {
         return { ...defaults, testContext: true };
@@ -295,7 +295,11 @@ export function parseCliArgs(argv) {
         return { ...defaults, showStatus: true };
     }
     if (argv[2] === "config") {
-        return { ...defaults, showConfig: true };
+        const validate = argv.includes("--validate") || argv.includes("-V");
+        return { ...defaults, showConfig: true, configValidate: validate };
+    }
+    if (argv[2] === "notify-test") {
+        return { ...defaults, notifyTest: true };
     }
     if (argv[2] === "init") {
         const force = argv.includes("--force") || argv.includes("-f");
@@ -386,7 +390,7 @@ export function parseCliArgs(argv) {
                 break;
         }
     }
-    return { overrides, help, version, register: false, testContext: false, runTest: false, showTasks: false, showHistory: false, showStatus: false, showConfig: false, runInit: false, initForce: false, runTaskCli: false };
+    return { overrides, help, version, register: false, testContext: false, runTest: false, showTasks: false, showHistory: false, showStatus: false, showConfig: false, configValidate: false, notifyTest: false, runInit: false, initForce: false, runTaskCli: false };
 }
 export function printHelp() {
     console.log(`aoaoe - autonomous supervisor for agent-of-empires sessions
@@ -404,6 +408,8 @@ commands:
   (none)         start the supervisor daemon (interactive TUI)
   status         quick daemon health check (is it running? what's it doing?)
   config         show the effective resolved config (defaults + file)
+  config --validate  validate config file + check tool availability
+  notify-test    send a test notification to configured webhooks
   task           manage tasks and sessions (list, start, stop, new, rm, edit)
   tasks          show task progress (from aoaoe.tasks.json)
   history        review recent actions (from ~/.aoaoe/actions.log)
@@ -446,6 +452,11 @@ example config:
     "sessionDirs": {
       "my-project": "/path/to/my-project",
       "other-repo": "/path/to/other-repo"
+    },
+    "notifications": {
+      "webhookUrl": "https://example.com/webhook",
+      "slackWebhookUrl": "https://hooks.slack.com/services/T.../B.../xxx",
+      "events": ["session_error", "session_done", "daemon_started", "daemon_stopped"]
     }
   }
 
@@ -453,6 +464,10 @@ example config:
   aoaoe loads AGENTS.md, claude.md, and other AI instruction files
   from each project directory to give the reasoner per-session context.
 
+  notifications sends webhook alerts for daemon events. Both webhookUrl
+  and slackWebhookUrl are optional. events filters which events fire
+  (omit to send all). Run 'aoaoe notify-test' to verify delivery.
+
 interactive commands (while daemon is running):
   /help          show available commands
   /explain       ask the AI to explain what's happening in plain English

package/dist/index.js

@@ -17,8 +17,8 @@ import { TaskManager, loadTaskDefinitions, loadTaskState, formatTaskTable } from
 import { runTaskCli, handleTaskSlashCommand } from "./task-cli.js";
 import { TUI } from "./tui.js";
 import { isDaemonRunningFromState } from "./chat.js";
-import { sendNotification } from "./notify.js";
-import { actionSession, actionDetail } from "./types.js";
+import { sendNotification, sendTestNotification } from "./notify.js";
+import { actionSession, actionDetail, toActionLogEntry } from "./types.js";
 import { YELLOW, GREEN, DIM, BOLD, RED, RESET } from "./colors.js";
 import { readFileSync, existsSync, statSync, mkdirSync, writeFileSync, chmodSync } from "node:fs";
 import { resolve, dirname, join } from "node:path";
@@ -28,7 +28,7 @@ const __dirname = dirname(fileURLToPath(import.meta.url));
 const AOAOE_DIR = join(homedir(), ".aoaoe"); // watch dir for wakeable sleep
 const INPUT_FILE = join(AOAOE_DIR, "pending-input.txt"); // file IPC from chat.ts
 async function main() {
-    const { overrides, help, version, register, testContext: isTestContext, runTest, showTasks, showHistory, showStatus, showConfig, runInit, initForce, runTaskCli: isTaskCli, registerTitle } = parseCliArgs(process.argv);
+    const { overrides, help, version, register, testContext: isTestContext, runTest, showTasks, showHistory, showStatus, showConfig, configValidate, notifyTest, runInit, initForce, runTaskCli: isTaskCli, registerTitle } = parseCliArgs(process.argv);
     if (help) {
         printHelp();
         process.exit(0);
@@ -73,9 +73,19 @@ async function main() {
         showDaemonStatus();
         return;
     }
-    // `aoaoe config` -- show effective resolved config
+    // `aoaoe config` -- show effective resolved config (with optional --validate)
     if (showConfig) {
-        showEffectiveConfig();
+        if (configValidate) {
+            await runConfigValidation();
+        }
+        else {
+            showEffectiveConfig();
+        }
+        return;
+    }
+    // `aoaoe notify-test` -- send a test notification to configured webhooks
+    if (notifyTest) {
+        await runNotifyTest();
         return;
     }
     // `aoaoe task` -- task management CLI
@@ -1041,6 +1051,43 @@ async function registerAsAoeSession(title) {
     console.log();
     console.log(`or start + enter immediately: aoe session start ${sessionTitle} && aoe`);
 }
+// `aoaoe notify-test` -- send a test notification to all configured webhooks and report results
+async function runNotifyTest() {
+    const config = loadConfig();
+    if (!config.notifications) {
+        console.log("");
+        console.log("  no notifications configured.");
+        console.log("");
+        console.log("  add to your config (~/.aoaoe/aoaoe.config.json):");
+        console.log('    "notifications": {');
+        console.log('      "webhookUrl": "https://example.com/webhook",');
+        console.log('      "slackWebhookUrl": "https://hooks.slack.com/services/...",');
+        console.log('      "events": ["session_error", "session_done", "daemon_started", "daemon_stopped"]');
+        console.log("    }");
+        console.log("");
+        return;
+    }
+    if (!config.notifications.webhookUrl && !config.notifications.slackWebhookUrl) {
+        console.log("");
+        console.log("  notifications block exists but no webhook URLs configured.");
+        console.log("  add webhookUrl and/or slackWebhookUrl to your notifications config.");
+        console.log("");
+        return;
+    }
+    console.log("");
+    console.log("  sending test notification...");
+    const result = await sendTestNotification(config);
+    console.log("");
+    if (result.webhookOk !== undefined) {
+        const icon = result.webhookOk ? `${GREEN}✓${RESET}` : `${RED}✗${RESET}`;
+        console.log(`  ${icon} generic webhook: ${result.webhookOk ? "ok" : result.webhookError ?? "failed"}`);
+    }
+    if (result.slackOk !== undefined) {
+        const icon = result.slackOk ? `${GREEN}✓${RESET}` : `${RED}✗${RESET}`;
+        console.log(`  ${icon} slack webhook:   ${result.slackOk ? "ok" : result.slackError ?? "failed"}`);
+    }
+    console.log("");
+}
 function readPkgVersion() {
     try {
         const pkg = JSON.parse(readFileSync(resolve(__dirname, "..", "package.json"), "utf-8"));
@@ -1094,7 +1141,9 @@ async function showActionHistory() {
     console.log(`  ${"─".repeat(70)}`);
     for (const line of recent) {
         try {
-            const entry = JSON.parse(line);
+            const entry = toActionLogEntry(JSON.parse(line));
+            if (!entry)
+                continue; // skip malformed lines
             const time = new Date(entry.timestamp).toLocaleTimeString();
             const date = new Date(entry.timestamp).toLocaleDateString();
             const icon = entry.success ? `${GREEN}+${RESET}` : `${RED}!${RESET}`;
@@ -1104,7 +1153,7 @@ async function showActionHistory() {
             console.log(`  ${icon} ${DIM}${date} ${time}${RESET}  ${YELLOW}${actionName.padEnd(16)}${RESET} ${session.padEnd(10)} ${detail}`);
         }
         catch {
-            // skip malformed lines
+            // skip unparseable JSON lines
         }
     }
     console.log(`  ${"─".repeat(70)}`);
@@ -1113,14 +1162,18 @@ async function showActionHistory() {
     const actionCounts = new Map();
     for (const line of lines) {
         try {
-            const e = JSON.parse(line);
+            const e = toActionLogEntry(JSON.parse(line));
+            if (!e)
+                continue;
             if (e.success)
                 successes++;
             else
                 failures++;
             actionCounts.set(e.action.action, (actionCounts.get(e.action.action) ?? 0) + 1);
         }
-        catch { }
+        catch {
+            // skip unparseable JSON lines
+        }
     }
     const breakdown = [...actionCounts.entries()].sort((a, b) => b[1] - a[1]).map(([k, v]) => `${k}: ${v}`).join(", ");
     console.log(`  total: ${lines.length} actions (${GREEN}${successes} ok${RESET}, ${RED}${failures} failed${RESET})`);
@@ -1192,6 +1245,124 @@ function showDaemonStatus() {
     }
     console.log("");
 }
+// `aoaoe config --validate` -- validate config file, field values, and tool availability
+async function runConfigValidation() {
+    const configPath = findConfigFile();
+    let checks = 0;
+    let passed = 0;
+    let warnings = 0;
+    console.log("");
+    console.log("  aoaoe — config validation");
+    console.log(`  ${"─".repeat(50)}`);
+    // 1. config file exists
+    checks++;
+    if (configPath) {
+        console.log(`  ${GREEN}✓${RESET} config file found: ${configPath}`);
+        passed++;
+    }
+    else {
+        console.log(`  ${YELLOW}!${RESET} no config file found (using defaults)`);
+        console.log(`    ${DIM}run 'aoaoe init' to create one${RESET}`);
+        warnings++;
+    }
+    // 2. config parses + validates
+    checks++;
+    let config;
+    try {
+        const configResult = loadConfig();
+        config = configResult;
+        console.log(`  ${GREEN}✓${RESET} config valid (all field values OK)`);
+        passed++;
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        console.log(`  ${RED}✗${RESET} config validation failed:`);
+        for (const line of msg.split("\n")) {
+            console.log(`    ${line}`);
+        }
+        console.log("");
+        console.log(`  ${passed}/${checks} checks passed, fix config errors and retry`);
+        console.log("");
+        process.exit(1);
+        return; // unreachable, but satisfies TypeScript
+    }
+    // 3. required tools on PATH
+    const tools = [
+        { name: "aoe", label: "agent-of-empires CLI" },
+        { name: "tmux", label: "terminal multiplexer" },
+    ];
+    if (config.reasoner === "opencode") {
+        tools.push({ name: "opencode", label: "OpenCode CLI" });
+    }
+    else if (config.reasoner === "claude-code") {
+        tools.push({ name: "claude", label: "Claude Code CLI" });
+    }
+    for (const tool of tools) {
+        checks++;
+        try {
+            const { execFile: execFileCb } = await import("node:child_process");
+            const { promisify } = await import("node:util");
+            const execFileAsync = promisify(execFileCb);
+            await execFileAsync("which", [tool.name]);
+            console.log(`  ${GREEN}✓${RESET} ${tool.name} found on PATH (${tool.label})`);
+            passed++;
+        }
+        catch {
+            console.log(`  ${RED}✗${RESET} ${tool.name} not found on PATH (${tool.label})`);
+        }
+    }
+    // 4. notifications config check
+    checks++;
+    if (config.notifications) {
+        const hasWebhook = !!config.notifications.webhookUrl;
+        const hasSlack = !!config.notifications.slackWebhookUrl;
+        if (hasWebhook || hasSlack) {
+            const targets = [hasWebhook && "webhook", hasSlack && "Slack"].filter(Boolean).join(" + ");
+            console.log(`  ${GREEN}✓${RESET} notifications configured (${targets})`);
+            console.log(`    ${DIM}run 'aoaoe notify-test' to verify delivery${RESET}`);
+            passed++;
+        }
+        else {
+            console.log(`  ${YELLOW}!${RESET} notifications block exists but no webhook URLs configured`);
+            warnings++;
+        }
+    }
+    else {
+        console.log(`  ${DIM}○${RESET} notifications not configured (optional)`);
+        passed++; // not configured is fine — it's optional
+    }
+    // 5. sessionDirs validation — check that mapped dirs exist
+    if (config.sessionDirs && Object.keys(config.sessionDirs).length > 0) {
+        const basePath = process.cwd();
+        for (const [title, dir] of Object.entries(config.sessionDirs)) {
+            checks++;
+            const resolved = dir.startsWith("/") ? dir : resolve(basePath, dir);
+            if (existsSync(resolved)) {
+                console.log(`  ${GREEN}✓${RESET} sessionDirs.${title} → ${resolved}`);
+                passed++;
+            }
+            else {
+                console.log(`  ${YELLOW}!${RESET} sessionDirs.${title} → ${resolved} (not found)`);
+                warnings++;
+            }
+        }
+    }
+    // summary
+    const failed = checks - passed - warnings;
+    console.log("");
+    if (failed === 0 && warnings === 0) {
+        console.log(`  ${GREEN}${BOLD}all ${checks} checks passed${RESET}`);
+    }
+    else if (failed === 0) {
+        console.log(`  ${passed}/${checks} passed, ${YELLOW}${warnings} warning(s)${RESET}`);
+    }
+    else {
+        console.log(`  ${passed}/${checks} passed, ${RED}${failed} failed${RESET}${warnings > 0 ? `, ${YELLOW}${warnings} warning(s)${RESET}` : ""}`);
+    }
+    console.log("");
+    if (failed > 0)
+        process.exit(1);
+}
 // `aoaoe config` -- show the effective resolved config (defaults + file + any notes)
 function showEffectiveConfig() {
     const configPath = findConfigFile();

package/dist/init.js

@@ -291,6 +291,7 @@ export async function runInit(forceOverwrite = false) {
         console.log(`     ${CYAN}aoaoe${RESET}`);
     }
     console.log(`\n  ${DIM}tip: run ${BOLD}aoaoe test-context${RESET}${DIM} to verify session discovery without starting the daemon${RESET}`);
+    console.log(`  ${DIM}tip: add a "notifications" block to your config for webhook alerts (see ${BOLD}aoaoe --help${RESET}${DIM})${RESET}`);
     console.log();
     return { tools, sessions, reasoner, opencodePort, opencodeRunning, configPath, wrote: true };
 }

package/dist/notify.d.ts

@@ -5,7 +5,15 @@ export interface NotificationPayload {
     session?: string;
     detail?: string;
 }
+export declare function isRateLimited(payload: NotificationPayload, now?: number): boolean;
+export declare function resetRateLimiter(): void;
 export declare function sendNotification(config: AoaoeConfig, payload: NotificationPayload): Promise<void>;
+export declare function sendTestNotification(config: AoaoeConfig): Promise<{
+    webhookOk?: boolean;
+    slackOk?: boolean;
+    webhookError?: string;
+    slackError?: string;
+}>;
 export declare function formatSlackPayload(payload: NotificationPayload): {
     text: string;
     blocks: object[];

package/dist/notify.js

@@ -1,5 +1,39 @@
+// ── rate limiting ───────────────────────────────────────────────────────────
+// dedup key: "event:session" — prevents spam when sessions rapidly error/recover.
+// default window: 60s per unique event+session combo.
+const RATE_LIMIT_MS = 60_000;
+const recentNotifications = new Map(); // key → last-sent timestamp
+function rateLimitKey(payload) {
+    return `${payload.event}:${payload.session ?? ""}`;
+}
+// exported for testing
+export function isRateLimited(payload, now) {
+    const key = rateLimitKey(payload);
+    const lastSent = recentNotifications.get(key);
+    const ts = now ?? Date.now();
+    if (lastSent !== undefined && ts - lastSent < RATE_LIMIT_MS)
+        return true;
+    return false;
+}
+function recordSent(payload, now) {
+    const key = rateLimitKey(payload);
+    recentNotifications.set(key, now ?? Date.now());
+    // prune old entries to prevent unbounded growth (keep last 200)
+    if (recentNotifications.size > 200) {
+        const cutoff = (now ?? Date.now()) - RATE_LIMIT_MS;
+        for (const [k, v] of recentNotifications) {
+            if (v < cutoff)
+                recentNotifications.delete(k);
+        }
+    }
+}
+// exported for testing — reset rate limiter state between tests
+export function resetRateLimiter() {
+    recentNotifications.clear();
+}
 // send a notification to all configured webhooks.
 // fire-and-forget: never throws, never blocks the daemon.
+// rate-limited: suppresses duplicate event+session combos within 60s.
 export async function sendNotification(config, payload) {
     const n = config.notifications;
     if (!n)
@@ -7,6 +41,10 @@ export async function sendNotification(config, payload) {
     // filter: only send if event is in the configured list (or no filter = send all)
     if (n.events && n.events.length > 0 && !n.events.includes(payload.event))
         return;
+    // rate limit: skip if we sent the same event+session recently
+    if (isRateLimited(payload))
+        return;
+    recordSent(payload);
     const promises = [];
     if (n.webhookUrl) {
         promises.push(sendGenericWebhook(n.webhookUrl, payload));
@@ -17,6 +55,55 @@ export async function sendNotification(config, payload) {
     // fire-and-forget — swallow all errors so the daemon never crashes on notification failure
     await Promise.allSettled(promises);
 }
+// send a test notification and return whether delivery succeeded.
+// unlike sendNotification, this is NOT fire-and-forget — it reports errors.
+export async function sendTestNotification(config) {
+    const n = config.notifications;
+    if (!n)
+        return {};
+    const payload = {
+        event: "daemon_started",
+        timestamp: Date.now(),
+        detail: "test notification from aoaoe notify-test",
+    };
+    const result = {};
+    if (n.webhookUrl) {
+        try {
+            const resp = await fetch(n.webhookUrl, {
+                method: "POST",
+                headers: { "Content-Type": "application/json" },
+                body: JSON.stringify({ event: payload.event, timestamp: payload.timestamp, detail: payload.detail }),
+                signal: AbortSignal.timeout(10_000),
+            });
+            result.webhookOk = resp.ok;
+            if (!resp.ok)
+                result.webhookError = `HTTP ${resp.status} ${resp.statusText}`;
+        }
+        catch (err) {
+            result.webhookOk = false;
+            result.webhookError = String(err);
+        }
+    }
+    if (n.slackWebhookUrl) {
+        try {
+            const body = formatSlackPayload(payload);
+            const resp = await fetch(n.slackWebhookUrl, {
+                method: "POST",
+                headers: { "Content-Type": "application/json" },
+                body: JSON.stringify(body),
+                signal: AbortSignal.timeout(10_000),
+            });
+            result.slackOk = resp.ok;
+            if (!resp.ok)
+                result.slackError = `HTTP ${resp.status} ${resp.statusText}`;
+        }
+        catch (err) {
+            result.slackOk = false;
+            result.slackError = String(err);
+        }
+    }
+    return result;
+}
 // POST JSON payload to a generic webhook URL
 async function sendGenericWebhook(url, payload) {
     try {

package/dist/types.d.ts

@@ -175,4 +175,16 @@ export declare function toAoeSessionList(raw: unknown): Array<{
     title: string;
 }>;
 export declare function toReasonerBackend(raw: string): ReasonerBackend;
+export interface ActionLogEntry {
+    timestamp: number;
+    action: {
+        action: string;
+        session?: string;
+        text?: string;
+        title?: string;
+    };
+    success: boolean;
+    detail: string;
+}
+export declare function toActionLogEntry(raw: unknown): ActionLogEntry | null;
 //# sourceMappingURL=types.d.ts.map

package/dist/types.js

@@ -112,4 +112,31 @@ export function toReasonerBackend(raw) {
         return raw;
     throw new Error(`--reasoner must be "opencode" or "claude-code", got "${raw}"`);
 }
+export function toActionLogEntry(raw) {
+    if (!raw || typeof raw !== "object")
+        return null;
+    const obj = raw;
+    if (typeof obj.timestamp !== "number")
+        return null;
+    if (typeof obj.success !== "boolean")
+        return null;
+    if (typeof obj.detail !== "string")
+        obj.detail = "";
+    if (!obj.action || typeof obj.action !== "object")
+        return null;
+    const action = obj.action;
+    if (typeof action.action !== "string")
+        return null;
+    return {
+        timestamp: obj.timestamp,
+        action: {
+            action: action.action,
+            session: typeof action.session === "string" ? action.session : undefined,
+            text: typeof action.text === "string" ? action.text : undefined,
+            title: typeof action.title === "string" ? action.title : undefined,
+        },
+        success: obj.success,
+        detail: typeof obj.detail === "string" ? obj.detail : "",
+    };
+}
 //# sourceMappingURL=types.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "aoaoe",
-  "version": "0.52.0",
+  "version": "0.54.0",
   "description": "Autonomous supervisor for agent-of-empires sessions using OpenCode or Claude Code",
   "type": "module",
   "main": "dist/index.js",