@ouro.bot/cli 0.1.0-alpha.35 → 0.1.0-alpha.350

package/dist/senses/commands.js

@@ -3,7 +3,11 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.createCommandRegistry = createCommandRegistry;
 exports.getToolChoiceRequired = getToolChoiceRequired;
 exports.resetToolChoiceRequired = resetToolChoiceRequired;
+exports.getDebugMode = getDebugMode;
+exports.resetDebugMode = resetDebugMode;
 exports.registerDefaultCommands = registerDefaultCommands;
+exports.getSharedCommandRegistry = getSharedCommandRegistry;
+exports.resetSharedCommandRegistry = resetSharedCommandRegistry;
 exports.parseSlashCommand = parseSlashCommand;
 const identity_1 = require("../heart/identity");
 const runtime_1 = require("../nerves/runtime");
@@ -35,6 +39,14 @@ function getToolChoiceRequired() {
 function resetToolChoiceRequired() {
     _toolChoiceRequired = false;
 }
+// Module-level toggle for debug mode
+let _debugMode = false;
+function getDebugMode() {
+    return _debugMode;
+}
+function resetDebugMode() {
+    _debugMode = false;
+}
 function registerDefaultCommands(registry) {
     (0, runtime_1.emitNervesEvent)({
         event: "repertoire.load_start",
@@ -60,10 +72,37 @@ function registerDefaultCommands(registry) {
         channels: ["cli", "teams"],
         handler: (ctx) => {
             const cmds = registry.list(ctx.channel);
-            const lines = cmds.map((c) => `/${c.name} - ${c.description}`);
+            const lines = cmds.map((c) => `/${c.name} \u2014 ${c.description}`);
             return { action: "response", message: lines.join("\n") };
         },
     });
+    registry.register({
+        name: "help",
+        description: "show keyboard shortcuts and tips",
+        channels: ["cli"],
+        /* v8 ignore start -- integration: /help command tested via E2E @preserve */
+        handler: () => ({
+            action: "response",
+            message: [
+                "Keyboard shortcuts:",
+                "  Ctrl-C        abort current generation / clear input / exit (twice within 2s)",
+                "  Escape        clear input",
+                "  ↑ / ↓         browse input history (includes previous sessions)",
+                "  Option+← / →  jump between words",
+                "  Ctrl+A / E    jump to start / end of line",
+                "  Option+Delete  delete word backward",
+                "  Option+D      delete word forward",
+                "  Alt+Enter     insert newline (multi-line input)",
+                "",
+                "Commands:",
+                "  /help         this help",
+                "  /commands     list all commands",
+                "  /new          start a new conversation",
+                "  /exit         quit",
+            ].join("\n"),
+        }),
+        /* v8 ignore stop */
+    });
     registry.register({
         name: "tool-required",
         description: "toggle tool_choice required mode (forces tool calls)",
@@ -73,6 +112,20 @@ function registerDefaultCommands(registry) {
             return { action: "response", message: `tool-required mode: ${_toolChoiceRequired ? "ON" : "OFF"}` };
         },
     });
+    registry.register({
+        name: "debug",
+        description: "toggle debug mode — see more detail about what I'm doing",
+        channels: ["cli", "teams", "bluebubbles", "mcp"],
+        handler: () => {
+            _debugMode = !_debugMode;
+            return {
+                action: "response",
+                message: _debugMode
+                    ? "debug mode on — you'll see more detail about what I'm doing"
+                    : "debug mode off — back to clean output",
+            };
+        },
+    });
     (0, runtime_1.emitNervesEvent)({
         event: "repertoire.load_end",
         component: "repertoire",
@@ -80,6 +133,17 @@ function registerDefaultCommands(registry) {
         meta: {},
     });
 }
+let _sharedRegistry = null;
+function getSharedCommandRegistry() {
+    if (!_sharedRegistry) {
+        _sharedRegistry = createCommandRegistry();
+        registerDefaultCommands(_sharedRegistry);
+    }
+    return _sharedRegistry;
+}
+function resetSharedCommandRegistry() {
+    _sharedRegistry = null;
+}
 function parseSlashCommand(input) {
     const trimmed = input.trim();
     if (!trimmed.startsWith("/"))

package/dist/senses/continuity.js

@@ -0,0 +1,94 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.normalizeContinuityClauses = normalizeContinuityClauses;
+exports.resolveMustResolveBeforeHandoff = resolveMustResolveBeforeHandoff;
+exports.classifySteeringFollowUpEffect = classifySteeringFollowUpEffect;
+const runtime_1 = require("../nerves/runtime");
+const NO_HANDOFF_CLAUSES = new Set([
+    "dont return control until complete or blocked",
+    "do not return control until complete or blocked",
+    "dont hand back control until complete or blocked",
+    "do not hand back control until complete or blocked",
+    "keep going until youre done",
+    "keep going until you are done",
+    "keep working until youre done",
+    "keep working until you are done",
+    "dont stop until youre done",
+    "do not stop until youre done",
+    "only come back if blocked",
+    "only return if blocked",
+    "only respond if blocked",
+    "work autonomously on this",
+    "work on this autonomously",
+    "handle this autonomously",
+]);
+const CANCEL_SUPERSEDE_CLAUSES = new Set([
+    "stop",
+    "cancel that",
+    "cancel this",
+    "never mind",
+    "nevermind",
+    "forget it",
+    "ignore that",
+    "ignore this",
+    "hold off",
+    "ill take it from here",
+    "i will take it from here",
+    "lets do something else",
+    "stop working on that",
+    "stop working on this",
+    "dont do that",
+    "do not do that",
+]);
+function normalizeContinuityClauses(text) {
+    return text
+        .toLowerCase()
+        .split(/[\n.!?;]+/)
+        .map((clause) => clause.replace(/[^a-z\s]/g, "").replace(/\s+/g, " ").trim())
+        .filter(Boolean);
+}
+function resolveMustResolveBeforeHandoff(initialValue, ingressTexts) {
+    let current = initialValue;
+    for (const text of ingressTexts ?? []) {
+        for (const clause of normalizeContinuityClauses(text)) {
+            if (CANCEL_SUPERSEDE_CLAUSES.has(clause)) {
+                current = false;
+                continue;
+            }
+            if (NO_HANDOFF_CLAUSES.has(clause)) {
+                current = true;
+            }
+        }
+    }
+    (0, runtime_1.emitNervesEvent)({
+        component: "senses",
+        event: "senses.continuity_state_resolved",
+        message: "resolved continuity handoff state from ingress text",
+        meta: {
+            initialValue,
+            finalValue: current,
+            ingressCount: ingressTexts?.length ?? 0,
+        },
+    });
+    return current;
+}
+function classifySteeringFollowUpEffect(text) {
+    const clauses = normalizeContinuityClauses(text);
+    let effect = "none";
+    if (clauses.some((clause) => CANCEL_SUPERSEDE_CLAUSES.has(clause))) {
+        effect = "clear_and_supersede";
+    }
+    else if (clauses.some((clause) => NO_HANDOFF_CLAUSES.has(clause))) {
+        effect = "set_no_handoff";
+    }
+    (0, runtime_1.emitNervesEvent)({
+        component: "senses",
+        event: "senses.continuity_follow_up_classified",
+        message: "classified steering follow-up continuity effect",
+        meta: {
+            effect,
+            clauseCount: clauses.length,
+        },
+    });
+    return effect;
+}

package/dist/senses/habit-turn-message.js

@@ -0,0 +1,108 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildHabitTurnMessage = buildHabitTurnMessage;
+const runtime_1 = require("../nerves/runtime");
+function formatElapsed(ms) {
+    const minutes = Math.floor(ms / 60000);
+    if (minutes < 60) {
+        return `${minutes} ${minutes === 1 ? "minute" : "minutes"}`;
+    }
+    const hours = Math.floor(minutes / 60);
+    return `${hours} ${hours === 1 ? "hour" : "hours"}`;
+}
+function buildHabitTurnMessage(options) {
+    const { habitName, habitTitle, habitBody, lastRun, checkpoint, alsoDue, staleObligations, parseErrors, degradedComponents, now, } = options;
+    const hasBody = habitBody !== undefined && habitBody !== "";
+    // First beat: lastRun is null
+    if (lastRun === null) {
+        // Cold start: no checkpoint, no body — bare awareness
+        if (!checkpoint && !hasBody) {
+            (0, runtime_1.emitNervesEvent)({
+                component: "senses",
+                event: "senses.habit_turn_message_built",
+                message: "habit turn message built (cold start)",
+                meta: { habitName, coldStart: true },
+            });
+            return "...time passing. anything stirring?";
+        }
+        if (!hasBody) {
+            // First beat with no body: nudge
+            const sections = [
+                `your ${habitTitle} fired but has no instructions \u2014 add a body to \`habits/${habitName}.md\``,
+            ];
+            appendTrailingExtras(sections, alsoDue, staleObligations, parseErrors, degradedComponents);
+            (0, runtime_1.emitNervesEvent)({
+                component: "senses",
+                event: "senses.habit_turn_message_built",
+                message: "habit turn message built (first beat, no body)",
+                meta: { habitName, firstBeat: true, hasBody: false },
+            });
+            return sections.join("\n\n");
+        }
+        const sections = [
+            `your ${habitTitle} is alive. this is its first breath.`,
+            habitBody,
+        ];
+        appendTrailingExtras(sections, alsoDue, staleObligations, parseErrors, degradedComponents);
+        (0, runtime_1.emitNervesEvent)({
+            component: "senses",
+            event: "senses.habit_turn_message_built",
+            message: "habit turn message built (first beat)",
+            meta: { habitName, firstBeat: true },
+        });
+        return sections.join("\n\n");
+    }
+    // Normal turn
+    const sections = [];
+    // 1. Checkpoint
+    if (checkpoint) {
+        sections.push(`you were thinking about ${checkpoint}.`);
+    }
+    // 2. Elapsed time
+    const nowMs = now().getTime();
+    const lastRunMs = new Date(lastRun).getTime();
+    const elapsed = nowMs - lastRunMs;
+    sections.push(`${formatElapsed(elapsed)} have passed.`);
+    // 3. Body or no-body nudge
+    if (hasBody) {
+        sections.push(habitBody);
+    }
+    else {
+        sections.push(`your ${habitTitle} fired but has no instructions \u2014 add a body to \`habits/${habitName}.md\``);
+    }
+    // 4-7. Trailing extras
+    appendTrailingExtras(sections, alsoDue, staleObligations, parseErrors, degradedComponents);
+    (0, runtime_1.emitNervesEvent)({
+        component: "senses",
+        event: "senses.habit_turn_message_built",
+        message: "habit turn message built",
+        meta: {
+            habitName,
+            hasCheckpoint: !!checkpoint,
+            hasBody: hasBody,
+            staleObligationCount: staleObligations.length,
+        },
+    });
+    return sections.join("\n\n");
+}
+function appendTrailingExtras(sections, alsoDue, staleObligations, parseErrors, degradedComponents) {
+    // 4. Also-due
+    if (alsoDue) {
+        sections.push(alsoDue);
+    }
+    // 5. Stale obligations
+    if (staleObligations.length > 0) {
+        const lines = staleObligations.map((o) => `something for ${o.friendName} has been sitting for ${formatElapsed(o.stalenessMs)}`);
+        sections.push(lines.join("\n"));
+    }
+    // 6. Parse errors
+    if (parseErrors.length > 0) {
+        const lines = parseErrors.map((e) => `I noticed my habit file \`${e.file}\` has invalid frontmatter \u2014 I should fix it. (${e.error})`);
+        sections.push(lines.join("\n"));
+    }
+    // 7. Degraded state
+    if (degradedComponents.length > 0) {
+        const reasons = degradedComponents.map((d) => `${d.component}: ${d.reason}`).join("; ");
+        sections.push(`[note: my scheduling is degraded: ${reasons}]`);
+    }
+}

package/dist/senses/inner-dialog-worker.js

@@ -1,29 +1,114 @@
 "use strict";
+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.createInnerDialogWorker = createInnerDialogWorker;
 exports.startInnerDialogWorker = startInnerDialogWorker;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
 const inner_dialog_1 = require("./inner-dialog");
 const runtime_1 = require("../nerves/runtime");
-function createInnerDialogWorker(runTurn = (options) => (0, inner_dialog_1.runInnerDialogTurn)(options)) {
+const identity_1 = require("../heart/identity");
+const pending_1 = require("../mind/pending");
+const habit_parser_1 = require("../heart/habits/habit-parser");
+function createInnerDialogWorker(runTurn = (options) => (0, inner_dialog_1.runInnerDialogTurn)(options), hasPendingWork = () => (0, pending_1.hasPendingMessages)((0, pending_1.getInnerDialogPendingDir)((0, identity_1.getAgentName)()))) {
     let running = false;
-    async function run(reason) {
-        if (running)
+    const queue = [];
+    async function run(reason, taskId, habitName) {
+        if (running) {
+            queue.push({ reason, taskId, habitName });
             return;
+        }
         running = true;
         try {
-            await runTurn({ reason });
-        }
-        catch (error) {
-            (0, runtime_1.emitNervesEvent)({
-                level: "error",
-                component: "senses",
-                event: "senses.inner_dialog_worker_error",
-                message: "inner dialog worker turn failed",
-                meta: {
-                    reason,
-                    error: error instanceof Error ? error.message : String(error),
-                },
-            });
+            let nextReason = reason;
+            let nextTaskId = taskId;
+            let nextHabitName = habitName;
+            do {
+                try {
+                    await runTurn({ reason: nextReason, taskId: nextTaskId, habitName: nextHabitName });
+                }
+                catch (error) {
+                    (0, runtime_1.emitNervesEvent)({
+                        level: "error",
+                        component: "senses",
+                        event: "senses.inner_dialog_worker_error",
+                        message: "inner dialog worker turn failed",
+                        meta: {
+                            reason: nextReason,
+                            error: error instanceof Error ? error.message : String(error),
+                        },
+                    });
+                }
+                // Update lastRun in habit frontmatter after a habit turn
+                if (nextReason === "habit" && nextHabitName) {
+                    try {
+                        const agentRoot = (0, identity_1.getAgentRoot)();
+                        const habitFilePath = path.join(agentRoot, "habits", `${nextHabitName}.md`);
+                        const content = fs.readFileSync(habitFilePath, "utf-8");
+                        const parsed = (0, habit_parser_1.parseHabitFile)(content, habitFilePath);
+                        const frontmatter = {
+                            title: parsed.title,
+                            cadence: parsed.cadence,
+                            status: parsed.status,
+                            lastRun: new Date().toISOString(),
+                            created: parsed.created,
+                        };
+                        const rendered = (0, habit_parser_1.renderHabitFile)(frontmatter, parsed.body);
+                        fs.writeFileSync(habitFilePath, rendered, "utf-8");
+                    }
+                    catch {
+                        // Habit file may have been deleted during the turn — skip gracefully
+                    }
+                }
+                // Drain queue first
+                if (queue.length > 0) {
+                    const next = queue.shift();
+                    nextReason = next.reason;
+                    nextTaskId = next.taskId;
+                    nextHabitName = next.habitName;
+                    continue;
+                }
+                // Then check hasPendingWork fallback
+                if (hasPendingWork()) {
+                    nextReason = "instinct";
+                    nextTaskId = undefined;
+                    nextHabitName = undefined;
+                    continue;
+                }
+                break;
+            } while (true);
         }
         finally {
             running = false;
@@ -33,12 +118,20 @@ function createInnerDialogWorker(runTurn = (options) => (0, inner_dialog_1.runIn
         if (!message || typeof message !== "object")
             return;
         const maybeMessage = message;
+        if (maybeMessage.type === "habit") {
+            await run("habit", undefined, maybeMessage.habitName);
+            return;
+        }
         if (maybeMessage.type === "heartbeat") {
-            await run("heartbeat");
+            // Backward compatibility: heartbeat -> habit/heartbeat
+            await run("habit", undefined, "heartbeat");
+            return;
+        }
+        if (maybeMessage.type === "poke") {
+            await run("instinct", maybeMessage.taskId);
             return;
         }
-        if (maybeMessage.type === "poke" ||
-            maybeMessage.type === "chat" ||
+        if (maybeMessage.type === "chat" ||
             maybeMessage.type === "message") {
             await run("instinct");
             return;