@ouro.bot/cli 0.1.0-alpha.2 → 0.1.0-alpha.200

package/dist/heart/daemon/outlook-types.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OUTLOOK_DEFAULT_PORT = exports.OUTLOOK_DEFAULT_INNER_VISIBILITY = exports.OUTLOOK_RELEASE_INTERACTION_MODEL = exports.OUTLOOK_PRODUCT_NAME = void 0;
+exports.OUTLOOK_PRODUCT_NAME = "Ouro Outlook";
+exports.OUTLOOK_RELEASE_INTERACTION_MODEL = "read-only";
+exports.OUTLOOK_DEFAULT_INNER_VISIBILITY = "summary";
+exports.OUTLOOK_DEFAULT_PORT = 6876;

package/dist/heart/daemon/outlook-view.js

@@ -0,0 +1,194 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildOutlookMachineView = buildOutlookMachineView;
+exports.buildOutlookAgentView = buildOutlookAgentView;
+const runtime_1 = require("../../nerves/runtime");
+const outlook_types_1 = require("./outlook-types");
+function deriveAttention(agent) {
+    if (agent.degraded.status === "degraded") {
+        return { level: "degraded", label: "Degraded" };
+    }
+    if (agent.freshness.status === "stale") {
+        return { level: "stale", label: "Stale" };
+    }
+    if (agent.tasks.blockedCount > 0 || agent.coding.blockedCount > 0) {
+        return { level: "blocked", label: "Blocked" };
+    }
+    if (agent.tasks.liveCount > 0 || agent.coding.activeCount > 0 || agent.obligations.openCount > 0) {
+        return { level: "active", label: "Active" };
+    }
+    return { level: "idle", label: "Idle" };
+}
+function deriveAgentAttention(agent) {
+    return deriveAttention({
+        agentName: agent.agentName,
+        enabled: agent.enabled,
+        freshness: agent.freshness,
+        degraded: agent.degraded,
+        tasks: {
+            liveCount: agent.tasks.liveCount,
+            blockedCount: agent.tasks.blockedCount,
+        },
+        obligations: {
+            openCount: agent.obligations.openCount,
+        },
+        coding: {
+            activeCount: agent.coding.activeCount,
+            blockedCount: agent.coding.blockedCount,
+        },
+    });
+}
+function buildTotals(machine) {
+    return machine.agents.reduce((totals, agent) => ({
+        agents: totals.agents + 1,
+        enabledAgents: totals.enabledAgents + (agent.enabled ? 1 : 0),
+        degradedAgents: totals.degradedAgents + (agent.degraded.status === "degraded" ? 1 : 0),
+        staleAgents: totals.staleAgents + (agent.freshness.status === "stale" ? 1 : 0),
+        liveTasks: totals.liveTasks + agent.tasks.liveCount,
+        blockedTasks: totals.blockedTasks + agent.tasks.blockedCount,
+        openObligations: totals.openObligations + agent.obligations.openCount,
+        activeCodingAgents: totals.activeCodingAgents + (agent.coding.activeCount > 0 ? 1 : 0),
+        blockedCodingAgents: totals.blockedCodingAgents + (agent.coding.blockedCount > 0 ? 1 : 0),
+    }), {
+        agents: 0,
+        enabledAgents: 0,
+        degradedAgents: 0,
+        staleAgents: 0,
+        liveTasks: 0,
+        blockedTasks: 0,
+        openObligations: 0,
+        activeCodingAgents: 0,
+        blockedCodingAgents: 0,
+    });
+}
+function deriveMood(machine, daemon) {
+    if (machine.degraded.status === "degraded" || daemon.health === "warn") {
+        return "strained";
+    }
+    if (machine.freshness.status === "stale") {
+        return "watchful";
+    }
+    return "calm";
+}
+function buildOutlookMachineView(input) {
+    const totals = buildTotals(input.machine);
+    const agents = input.machine.agents
+        .map((agent) => ({
+        ...agent,
+        attention: deriveAttention(agent),
+    }))
+        .sort((left, right) => {
+        const leftAt = left.freshness.latestActivityAt ?? "";
+        const rightAt = right.freshness.latestActivityAt ?? "";
+        return rightAt.localeCompare(leftAt);
+    });
+    return {
+        overview: {
+            productName: outlook_types_1.OUTLOOK_PRODUCT_NAME,
+            observedAt: input.machine.observedAt,
+            primaryEntryPoint: input.daemon.outlookUrl,
+            daemon: input.daemon,
+            runtime: input.machine.runtime,
+            freshness: input.machine.freshness,
+            degraded: input.machine.degraded,
+            totals,
+            mood: deriveMood(input.machine, input.daemon),
+            entrypoints: [
+                { kind: "web", label: "Open Outlook", target: input.daemon.outlookUrl },
+                { kind: "cli", label: "CLI JSON", target: "ouro outlook --json" },
+            ],
+        },
+        agents,
+    };
+}
+function normalizeViewer(viewer) {
+    return {
+        kind: viewer?.kind ?? "human",
+        agentName: viewer?.agentName,
+        innerDetail: viewer?.innerDetail ?? "summary",
+    };
+}
+function buildInnerView(inner, viewer) {
+    if (viewer.innerDetail === "deep") {
+        return {
+            mode: "deep",
+            status: inner.status,
+            summary: inner.surfacedSummary,
+            hasPending: inner.hasPending,
+            origin: inner.origin,
+            obligationStatus: inner.obligationStatus,
+        };
+    }
+    return {
+        mode: "summary",
+        status: inner.status,
+        summary: inner.surfacedSummary,
+        hasPending: inner.hasPending,
+    };
+}
+function buildRecentActivity(agent) {
+    const items = [
+        ...agent.coding.items.map((item) => ({
+            kind: "coding",
+            at: item.lastActivityAt,
+            label: item.checkpoint ?? `${item.runner} ${item.status}`,
+            detail: item.workdir,
+        })),
+        ...agent.sessions.items.map((item) => ({
+            kind: "session",
+            at: item.lastActivityAt,
+            label: `${item.friendName} via ${item.channel}`,
+            detail: item.key,
+        })),
+        ...agent.obligations.items.map((item) => ({
+            kind: "obligation",
+            at: item.updatedAt,
+            label: item.content,
+            detail: item.nextAction ?? item.status,
+        })),
+    ];
+    if (agent.inner.latestActivityAt) {
+        items.push({
+            kind: "inner",
+            at: agent.inner.latestActivityAt,
+            label: agent.inner.surfacedSummary ?? agent.inner.status,
+            detail: agent.inner.hasPending ? "pending inner work" : agent.inner.obligationStatus ?? "no linked obligation",
+        });
+    }
+    return items
+        .filter((item) => Number.isFinite(Date.parse(item.at)))
+        .sort((left, right) => right.at.localeCompare(left.at))
+        .slice(0, 4);
+}
+function buildOutlookAgentView(input) {
+    /* v8 ignore next */
+    (0, runtime_1.emitNervesEvent)({ component: "daemon", event: "daemon.outlook_view_agent", message: `building outlook view for ${input.agent.agentName}`, meta: { agent: input.agent.agentName } });
+    const viewer = normalizeViewer(input.viewer);
+    return {
+        productName: outlook_types_1.OUTLOOK_PRODUCT_NAME,
+        interactionModel: outlook_types_1.OUTLOOK_RELEASE_INTERACTION_MODEL,
+        viewer,
+        agent: {
+            agentName: input.agent.agentName,
+            agentRoot: input.agent.agentRoot,
+            enabled: input.agent.enabled,
+            provider: input.agent.provider,
+            senses: input.agent.senses,
+            freshness: input.agent.freshness,
+            degraded: input.agent.degraded,
+            attention: deriveAgentAttention(input.agent),
+        },
+        work: {
+            tasks: input.agent.tasks,
+            obligations: input.agent.obligations,
+            sessions: input.agent.sessions,
+            coding: input.agent.coding,
+            bridges: input.agent.tasks.activeBridges,
+        },
+        inner: buildInnerView(input.agent.inner, viewer),
+        activity: {
+            freshness: input.agent.freshness,
+            recent: buildRecentActivity(input.agent),
+        },
+    };
+}

package/dist/heart/daemon/process-manager.js

@@ -51,15 +51,23 @@ class DaemonProcessManager {
     now;
     setTimeoutFn;
     clearTimeoutFn;
+    cooldownRecoveryMs;
+    maxCooldownRetries;
+    existsSyncFn;
+    configCheckFn;
     constructor(options) {
         this.maxRestartsPerHour = options.maxRestartsPerHour ?? 10;
         this.stabilityThresholdMs = options.stabilityThresholdMs ?? 60_000;
         this.initialBackoffMs = options.initialBackoffMs ?? 1_000;
         this.maxBackoffMs = options.maxBackoffMs ?? 60_000;
+        this.cooldownRecoveryMs = options.cooldownRecoveryMs ?? 5 * 60 * 1_000;
+        this.maxCooldownRetries = options.maxCooldownRetries ?? 3;
         this.spawnFn = options.spawn ?? ((command, args, spawnOptions) => (0, child_process_1.spawn)(command, args, spawnOptions));
         this.now = options.now ?? (() => Date.now());
         this.setTimeoutFn = options.setTimeoutFn ?? ((cb, delay) => setTimeout(cb, delay));
         this.clearTimeoutFn = options.clearTimeoutFn ?? ((timer) => clearTimeout(timer));
+        this.existsSyncFn = options.existsSync ?? null;
+        this.configCheckFn = options.configCheck ?? null;
         for (const agent of options.agents) {
             this.agents.set(agent.name, {
                 config: agent,
@@ -67,6 +75,8 @@ class DaemonProcessManager {
                 restartTimer: null,
                 crashTimestamps: [],
                 stopRequested: false,
+                cooldownTimer: null,
+                cooldownRetryCount: 0,
                 snapshot: {
                     name: agent.name,
                     channel: agent.channel,
@@ -76,6 +86,8 @@ class DaemonProcessManager {
                     startedAt: null,
                     lastCrashAt: null,
                     backoffMs: this.initialBackoffMs,
+                    lastExitCode: null,
+                    lastSignal: null,
                 },
             });
         }
@@ -94,9 +106,36 @@ class DaemonProcessManager {
         this.clearRestartTimer(state);
         state.stopRequested = false;
         state.snapshot.status = "starting";
+        if (this.configCheckFn) {
+            const result = this.configCheckFn(agent);
+            if (!result.ok) {
+                state.snapshot.status = "crashed";
+                (0, runtime_1.emitNervesEvent)({
+                    level: "error",
+                    component: "daemon",
+                    event: "daemon.agent_config_invalid",
+                    message: result.error ?? "agent config validation failed",
+                    meta: { agent, fix: result.fix ?? null },
+                });
+                process.stderr.write(`[daemon] ${agent}: ${result.error}\n` +
+                    (result.fix ? `  Fix: ${result.fix}\n` : ""));
+                return;
+            }
+        }
         const runCwd = (0, identity_1.getRepoRoot)();
         const entryScript = path.join((0, identity_1.getRepoRoot)(), "dist", state.config.entry);
-        const args = [entryScript, "--agent", agent, ...(state.config.args ?? [])];
+        if (this.existsSyncFn && !this.existsSyncFn(entryScript)) {
+            state.snapshot.status = "crashed";
+            (0, runtime_1.emitNervesEvent)({
+                level: "error",
+                component: "daemon",
+                event: "daemon.agent_entry_missing",
+                message: "agent entry script does not exist — cannot spawn. Run 'ouro daemon install' from the correct location.",
+                meta: { agent, entryScript },
+            });
+            return;
+        }
+        const args = [entryScript, "--agent", state.config.agentArg ?? agent, ...(state.config.args ?? [])];
         const child = this.spawnFn("node", args, {
             cwd: runCwd,
             env: state.config.env ? { ...process.env, ...state.config.env } : process.env,
@@ -112,6 +151,17 @@ class DaemonProcessManager {
             message: "daemon started managed agent process",
             meta: { agent, pid: child.pid ?? null, cwd: runCwd },
         });
+        /* v8 ignore start — child process error handler; requires real spawn to trigger */
+        child.on("error", (err) => {
+            (0, runtime_1.emitNervesEvent)({
+                level: "warn",
+                component: "daemon",
+                event: "daemon.agent_process_error",
+                message: "managed agent process emitted error",
+                meta: { agent, error: err.message },
+            });
+        });
+        /* v8 ignore stop */
         child.once("exit", (code, signal) => {
             this.onExit(state, code, signal);
         });
@@ -119,6 +169,7 @@ class DaemonProcessManager {
     async stopAgent(agent) {
         const state = this.requireAgent(agent);
         this.clearRestartTimer(state);
+        this.clearCooldownTimer(state);
         state.stopRequested = true;
         if (!state.process) {
             state.snapshot.status = "stopped";
@@ -179,6 +230,8 @@ class DaemonProcessManager {
             return;
         state.process = null;
         state.snapshot.pid = null;
+        state.snapshot.lastExitCode = code;
+        state.snapshot.lastSignal = signal;
         const crashed = !state.stopRequested && code !== 0;
         const now = this.now();
         const startedAt = state.snapshot.startedAt ? Date.parse(state.snapshot.startedAt) : now;
@@ -209,6 +262,7 @@ class DaemonProcessManager {
                 message: "managed agent exceeded restart limit and is marked crashed",
                 meta: { agent: state.config.name, maxRestartsPerHour: this.maxRestartsPerHour },
             });
+            this.scheduleCooldownRecovery(state);
             return;
         }
         state.snapshot.status = "starting";
@@ -226,6 +280,45 @@ class DaemonProcessManager {
         this.clearTimeoutFn(state.restartTimer);
         state.restartTimer = null;
     }
+    scheduleCooldownRecovery(state) {
+        if (state.cooldownRetryCount >= this.maxCooldownRetries) {
+            (0, runtime_1.emitNervesEvent)({
+                level: "error",
+                component: "daemon",
+                event: "daemon.agent_permanent_failure",
+                message: "managed agent exhausted all cooldown retries — permanently stopped",
+                meta: { agent: state.config.name, cooldownRetryCount: state.cooldownRetryCount, maxCooldownRetries: this.maxCooldownRetries },
+            });
+            return;
+        }
+        this.clearCooldownTimer(state);
+        state.cooldownTimer = this.setTimeoutFn(() => {
+            state.cooldownRetryCount += 1;
+            state.crashTimestamps = [];
+            state.snapshot.backoffMs = this.initialBackoffMs;
+            state.snapshot.status = "starting";
+            state.snapshot.restartCount += 1;
+            (0, runtime_1.emitNervesEvent)({
+                component: "daemon",
+                event: "daemon.agent_cooldown_recovery",
+                message: "attempting cooldown recovery for managed agent",
+                meta: { agent: state.config.name, cooldownRetryCount: state.cooldownRetryCount },
+            });
+            void this.startAgent(state.config.name);
+        }, this.cooldownRecoveryMs);
+        (0, runtime_1.emitNervesEvent)({
+            component: "daemon",
+            event: "daemon.agent_cooldown_scheduled",
+            message: `scheduled cooldown recovery in ${this.cooldownRecoveryMs}ms`,
+            meta: { agent: state.config.name, cooldownRecoveryMs: this.cooldownRecoveryMs, cooldownRetryCount: state.cooldownRetryCount },
+        });
+    }
+    clearCooldownTimer(state) {
+        if (state.cooldownTimer === null)
+            return;
+        this.clearTimeoutFn(state.cooldownTimer);
+        state.cooldownTimer = null;
+    }
     requireAgent(agent) {
         const state = this.agents.get(agent);
         if (!state) {

package/dist/heart/daemon/run-hooks.js

@@ -0,0 +1,39 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runHooks = runHooks;
+const runtime_1 = require("../../nerves/runtime");
+const bundle_meta_1 = require("./hooks/bundle-meta");
+const agent_config_v2_1 = require("./hooks/agent-config-v2");
+async function runHooks(deps) {
+    (0, runtime_1.emitNervesEvent)({
+        component: "daemon",
+        event: "daemon.run_hooks_start",
+        message: "running update hooks",
+        meta: { bundlesRoot: deps.bundlesRoot },
+    });
+    try {
+        deps.registerUpdateHook(bundle_meta_1.bundleMetaHook);
+        deps.registerUpdateHook(agent_config_v2_1.agentConfigV2Hook);
+        const currentVersion = deps.getPackageVersion();
+        await deps.applyPendingUpdates(deps.bundlesRoot, currentVersion);
+        (0, runtime_1.emitNervesEvent)({
+            component: "daemon",
+            event: "daemon.run_hooks_success",
+            message: "update hooks completed successfully",
+            meta: { bundlesRoot: deps.bundlesRoot },
+        });
+        return 0;
+    }
+    catch (err) {
+        (0, runtime_1.emitNervesEvent)({
+            component: "daemon",
+            event: "daemon.run_hooks_error",
+            message: "update hooks failed",
+            meta: {
+                bundlesRoot: deps.bundlesRoot,
+                error: err instanceof Error ? err.message : /* v8 ignore next -- defensive: non-Error catch branch @preserve */ String(err),
+            },
+        });
+        return 1;
+    }
+}

package/dist/heart/daemon/runtime-logging.js

@@ -35,48 +35,95 @@ var __importStar = (this && this.__importStar) || (function () {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.configureDaemonRuntimeLogger = configureDaemonRuntimeLogger;
 const fs = __importStar(require("fs"));
-const os = __importStar(require("os"));
 const path = __importStar(require("path"));
 const nerves_1 = require("../../nerves");
 const runtime_1 = require("../../nerves/runtime");
-const DEFAULT_RUNTIME_LOGGING = {
+const identity_1 = require("../identity");
+const LEGACY_SHARED_RUNTIME_LOGGING = {
     level: "info",
     sinks: ["terminal", "ndjson"],
 };
+function defaultLoggingForProcess(processName) {
+    if (processName === "ouro" || processName === "ouro-bot") {
+        return {
+            level: "info",
+            sinks: ["ndjson"],
+        };
+    }
+    if (processName === "bluebubbles") {
+        return {
+            level: "warn",
+            sinks: ["terminal", "ndjson"],
+        };
+    }
+    return { ...LEGACY_SHARED_RUNTIME_LOGGING };
+}
 function isLogLevel(value) {
     return value === "debug" || value === "info" || value === "warn" || value === "error";
 }
-function resolveRuntimeLoggingConfig(configPath) {
+function normalizeSinks(value, fallback) {
+    if (!Array.isArray(value)) {
+        return [...fallback];
+    }
+    const sinks = value.filter((entry) => entry === "terminal" || entry === "ndjson");
+    return sinks.length > 0 ? [...new Set(sinks)] : [...fallback];
+}
+function isLegacySharedDefaultConfig(candidate, normalizedLevel, normalizedSinks) {
+    return normalizedLevel === LEGACY_SHARED_RUNTIME_LOGGING.level
+        && normalizedSinks.length === LEGACY_SHARED_RUNTIME_LOGGING.sinks.length
+        && LEGACY_SHARED_RUNTIME_LOGGING.sinks.every((sink) => normalizedSinks.includes(sink))
+        && Object.keys(candidate).every((key) => key === "level" || key === "sinks");
+}
+function resolveRuntimeLoggingConfig(configPath, processName) {
+    const processDefault = defaultLoggingForProcess(processName);
     let parsed = null;
     try {
         const raw = fs.readFileSync(configPath, "utf-8");
         parsed = JSON.parse(raw);
     }
     catch {
-        return { ...DEFAULT_RUNTIME_LOGGING };
+        return { ...processDefault };
     }
     if (!parsed || typeof parsed !== "object") {
-        return { ...DEFAULT_RUNTIME_LOGGING };
+        return { ...processDefault };
     }
     const candidate = parsed;
-    const level = isLogLevel(candidate.level) ? candidate.level : DEFAULT_RUNTIME_LOGGING.level;
-    const sinks = Array.isArray(candidate.sinks)
-        ? candidate.sinks.filter((entry) => entry === "terminal" || entry === "ndjson")
-        : DEFAULT_RUNTIME_LOGGING.sinks;
+    const level = isLogLevel(candidate.level) ? candidate.level : processDefault.level;
+    const sinks = normalizeSinks(candidate.sinks, processDefault.sinks);
+    if ((processName === "ouro" || processName === "ouro-bot")
+        && isLegacySharedDefaultConfig(candidate, level, sinks)) {
+        return { ...processDefault };
+    }
     return {
         level,
-        sinks: sinks.length > 0 ? [...new Set(sinks)] : [...DEFAULT_RUNTIME_LOGGING.sinks],
+        sinks,
     };
 }
+function resolveAgentNameForPaths(explicit) {
+    if (explicit && explicit.trim().length > 0)
+        return explicit.trim();
+    try {
+        return (0, identity_1.getAgentName)();
+    }
+    catch {
+        return "slugger";
+    }
+}
 function configureDaemonRuntimeLogger(processName, options = {}) {
-    const homeDir = options.homeDir ?? os.homedir();
-    const configPath = options.configPath ?? path.join(homeDir, ".agentstate", "daemon", "logging.json");
-    const config = resolveRuntimeLoggingConfig(configPath);
+    const agentName = resolveAgentNameForPaths(options.agentName);
+    const configPath = options.configPath
+        ?? (options.homeDir
+            ? path.join(options.homeDir, "AgentBundles", `${agentName}.ouro`, "state", "daemon", "logging.json")
+            : (0, identity_1.getAgentDaemonLoggingConfigPath)(agentName));
+    const config = resolveRuntimeLoggingConfig(configPath, processName);
+    const logsDir = options.homeDir
+        ? path.join(options.homeDir, "AgentBundles", `${agentName}.ouro`, "state", "daemon", "logs")
+        : (0, identity_1.getAgentDaemonLogsDir)(agentName);
     const sinks = config.sinks.map((sinkName) => {
         if (sinkName === "terminal") {
             return (0, nerves_1.createTerminalSink)();
         }
-        const ndjsonPath = path.join(homeDir, ".agentstate", "daemon", "logs", `${processName}.ndjson`);
+        const ndjsonPath = path.join(logsDir, `${processName}.ndjson`);
         return (0, nerves_1.createNdjsonFileSink)(ndjsonPath);
     });
     const logger = (0, nerves_1.createLogger)({