@ouro.bot/cli 0.1.0-alpha.666 → 0.1.0-alpha.668

package/dist/heart/mailbox/mailbox-http-routes.js

@@ -36,6 +36,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.createMailboxHttpRequestHandler = createMailboxHttpRequestHandler;
 const fs = __importStar(require("fs"));
 const path = __importStar(require("path"));
+const mailbox_http_hooks_1 = require("./mailbox-http-hooks");
 const mailbox_http_response_1 = require("./mailbox-http-response");
 const mailbox_http_static_1 = require("./mailbox-http-static");
 function decodePathSegment(value) {
@@ -46,6 +47,16 @@ function decodePathSegment(value) {
         return null;
     }
 }
+function rawRequestTargetsUnsafeAgent(urlValue = "/") {
+    const rawTarget = urlValue.split(/[?#]/, 1)[0];
+    const rawPath = rawTarget.replace(/\/+$/, "") || "/";
+    const pathname = (0, mailbox_http_static_1.normalizeLegacyMailboxApiPath)(rawPath);
+    const rawAgentMatch = /^\/api\/agents\/([^/]+)(?:\/|$)/.exec(pathname);
+    if (!rawAgentMatch)
+        return false;
+    const agent = decodePathSegment(rawAgentMatch[1]);
+    return !agent || !(0, mailbox_http_hooks_1.isSafeMailboxAgentName)(agent);
+}
 function parseHabitRunLimit(urlValue) {
     const rawLimit = new URL(urlValue, "http://127.0.0.1").searchParams.get("limit");
     if (rawLimit === null)
@@ -55,9 +66,47 @@ function parseHabitRunLimit(urlValue) {
     const limit = Number.parseInt(rawLimit, 10);
     return limit >= 1 && limit <= 100 ? limit : null;
 }
+const VALID_HABIT_SUMMARY_WHICH = new Set(["latest", "previous", "latest-success", "latest-failure"]);
+function firstQueryValue(params, names) {
+    for (const name of names) {
+        const value = params.get(name);
+        if (value !== null && value.trim().length > 0)
+            return value;
+    }
+    return undefined;
+}
+function parseHabitSummarySelector(urlValue) {
+    const params = new URL(urlValue, "http://127.0.0.1").searchParams;
+    const runId = firstQueryValue(params, ["runId", "run-id"]);
+    const habitName = firstQueryValue(params, ["habitName", "habit"]);
+    const operationId = firstQueryValue(params, ["operationId", "operation-id"]);
+    const which = firstQueryValue(params, ["which"]);
+    if (runId !== undefined && (habitName !== undefined || operationId !== undefined || which !== undefined)) {
+        return { ok: false, error: "--run-id cannot be combined with --habit, --operation-id, or --which" };
+    }
+    if (runId === undefined && habitName === undefined && operationId === undefined) {
+        return { ok: false, error: "provide runId, habitName, or operationId" };
+    }
+    if (which !== undefined && !VALID_HABIT_SUMMARY_WHICH.has(which)) {
+        return { ok: false, error: "which must be latest, previous, latest-success, or latest-failure" };
+    }
+    return {
+        ok: true,
+        selector: {
+            ...(runId ? { runId } : {}),
+            ...(habitName ? { habitName } : {}),
+            ...(operationId ? { operationId } : {}),
+            ...(which ? { which } : {}),
+        },
+    };
+}
 function createMailboxHttpRequestHandler(options) {
     const staticFiles = options.staticFiles ?? { resolveSpaDistDir: mailbox_http_static_1.resolveSpaDistDir, serveStaticFile: mailbox_http_static_1.serveStaticFile };
     return (request, response) => {
+        if (rawRequestTargetsUnsafeAgent(request.url)) {
+            (0, mailbox_http_response_1.writeJson)(response, 400, { ok: false, error: "agent name must be a safe bundle name" });
+            return;
+        }
         let pathname = (0, mailbox_http_static_1.normalizeMailboxRequestPath)(request.url);
         const origin = `http://${options.host}:${options.getPort()}`;
         if (pathname.startsWith("/assets/")) {
@@ -99,8 +148,14 @@ function createMailboxHttpRequestHandler(options) {
         }
         const agentMatch = /^\/api\/agents\/([^/]+)(?:\/(.+))?$/.exec(pathname);
         if (agentMatch) {
+            const agent = decodePathSegment(agentMatch[1]);
+            /* v8 ignore next -- rawRequestTargetsUnsafeAgent rejects unsafe/malformed agent segments before normalization @preserve */
+            if (!agent || !(0, mailbox_http_hooks_1.isSafeMailboxAgentName)(agent)) {
+                (0, mailbox_http_response_1.writeJson)(response, 400, { ok: false, error: "agent name must be a safe bundle name" });
+                return;
+            }
             void handleAgentRoute(request, response, {
-                agent: decodeURIComponent(agentMatch[1]),
+                agent,
                 surface: agentMatch[2] ?? null,
                 options,
             }).catch((error) => {
@@ -229,6 +284,32 @@ async function handleAgentRoute(request, response, context) {
         (0, mailbox_http_response_1.writeJson)(response, 200, view);
         return;
     }
+    if (surface === "habit-run-summaries") {
+        const limit = parseHabitRunLimit(request.url);
+        if (limit === null) {
+            (0, mailbox_http_response_1.writeJson)(response, 400, { ok: false, error: "limit must be an integer between 1 and 100" });
+            return;
+        }
+        const view = limit === undefined
+            ? options.hooks.readAgentHabitRunSummaries(agent)
+            : options.hooks.readAgentHabitRunSummaries(agent, { limit });
+        (0, mailbox_http_response_1.writeJson)(response, 200, view);
+        return;
+    }
+    if (surface === "habit-run-summary") {
+        const parsed = parseHabitSummarySelector(request.url);
+        if (!parsed.ok) {
+            (0, mailbox_http_response_1.writeJson)(response, 400, { ok: false, error: parsed.error });
+            return;
+        }
+        const summary = options.hooks.readAgentHabitRunSummary(agent, parsed.selector);
+        if (!summary) {
+            (0, mailbox_http_response_1.writeJson)(response, 404, { ok: false, error: "habit summary not found" });
+            return;
+        }
+        (0, mailbox_http_response_1.writeJson)(response, 200, summary);
+        return;
+    }
     if (surface.startsWith("habit-runs/")) {
         const rawRunId = surface.slice("habit-runs/".length);
         const runId = decodePathSegment(rawRunId);

package/dist/heart/mailbox/mailbox-read.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.readSelfFixView = exports.readMailboxContinuity = exports.readOrientationView = exports.readObligationDetailView = exports.readNoteDecisionView = exports.readSentinelView = exports.readContextLossGauntletView = exports.readChangesView = exports.readNeedsMeView = exports.readNotesView = exports.readLogView = exports.readHabitView = exports.readHabitRunView = exports.readHabitRunReceiptView = exports.readFriendView = exports.readDeskPrefs = exports.readDaemonHealthDeep = exports.readCodingDeep = exports.readBridgeInventory = exports.readAttentionView = exports.readMailView = exports.readMailMessageView = exports.readSessionTranscript = exports.readSessionInventory = exports.readMailboxMachineState = exports.readMailboxAgentState = exports.readObligationSummary = void 0;
+exports.readSelfFixView = exports.readMailboxContinuity = exports.readOrientationView = exports.readObligationDetailView = exports.readNoteDecisionView = exports.readSentinelView = exports.readContextLossGauntletView = exports.readChangesView = exports.readNeedsMeView = exports.readNotesView = exports.readLogView = exports.readHabitView = exports.readHabitRunView = exports.readHabitRunReceiptView = exports.readHabitSessionSummaryView = exports.readHabitSessionSummaryListView = exports.readFriendView = exports.readDeskPrefs = exports.readDaemonHealthDeep = exports.readCodingDeep = exports.readBridgeInventory = exports.readAttentionView = exports.readMailView = exports.readMailMessageView = exports.readSessionTranscript = exports.readSessionInventory = exports.readMailboxMachineState = exports.readMailboxAgentState = exports.readObligationSummary = void 0;
 var agent_machine_1 = require("./readers/agent-machine");
 Object.defineProperty(exports, "readObligationSummary", { enumerable: true, get: function () { return agent_machine_1.readObligationSummary; } });
 Object.defineProperty(exports, "readMailboxAgentState", { enumerable: true, get: function () { return agent_machine_1.readMailboxAgentState; } });
@@ -18,6 +18,8 @@ Object.defineProperty(exports, "readCodingDeep", { enumerable: true, get: functi
 Object.defineProperty(exports, "readDaemonHealthDeep", { enumerable: true, get: function () { return runtime_readers_1.readDaemonHealthDeep; } });
 Object.defineProperty(exports, "readDeskPrefs", { enumerable: true, get: function () { return runtime_readers_1.readDeskPrefs; } });
 Object.defineProperty(exports, "readFriendView", { enumerable: true, get: function () { return runtime_readers_1.readFriendView; } });
+Object.defineProperty(exports, "readHabitSessionSummaryListView", { enumerable: true, get: function () { return runtime_readers_1.readHabitSessionSummaryListView; } });
+Object.defineProperty(exports, "readHabitSessionSummaryView", { enumerable: true, get: function () { return runtime_readers_1.readHabitSessionSummaryView; } });
 Object.defineProperty(exports, "readHabitRunReceiptView", { enumerable: true, get: function () { return runtime_readers_1.readHabitRunReceiptView; } });
 Object.defineProperty(exports, "readHabitRunView", { enumerable: true, get: function () { return runtime_readers_1.readHabitRunView; } });
 Object.defineProperty(exports, "readHabitView", { enumerable: true, get: function () { return runtime_readers_1.readHabitView; } });

package/dist/heart/mailbox/readers/agent-machine.js

@@ -127,14 +127,24 @@ function normalizeObligationCurrentSurface(currentSurface, updatedAt, liveCoding
         && (Date.now() - updatedAtMs) <= STALE_CODING_SURFACE_WINDOW_MS;
     return recentlyTouched ? currentSurface : null;
 }
+function legacyObligationTimestamp(obligation) {
+    if (typeof obligation.updatedAt === "string")
+        return obligation.updatedAt;
+    if (typeof obligation.createdAt === "string")
+        return obligation.createdAt;
+    return "";
+}
+function legacyObligationStatus(obligation) {
+    return typeof obligation.status === "string" ? obligation.status : "pending";
+}
 function readObligationSummary(agentRoot) {
     const liveCodingSurfaceLabels = buildLiveCodingSurfaceLabels(agentRoot);
     const items = (0, obligations_1.readPendingObligations)(agentRoot)
         .map((obligation) => {
-        const updatedAt = obligation.updatedAt ?? obligation.createdAt;
+        const updatedAt = legacyObligationTimestamp(obligation);
         return {
             id: obligation.id,
-            status: obligation.status,
+            status: legacyObligationStatus(obligation),
             content: obligation.content,
             updatedAt,
             nextAction: obligation.nextAction ?? null,

package/dist/heart/mailbox/readers/runtime-readers.js

@@ -43,6 +43,8 @@ exports.readLogView = readLogView;
 exports.readHabitView = readHabitView;
 exports.readHabitRunView = readHabitRunView;
 exports.readHabitRunReceiptView = readHabitRunReceiptView;
+exports.readHabitSessionSummaryListView = readHabitSessionSummaryListView;
+exports.readHabitSessionSummaryView = readHabitSessionSummaryView;
 exports.readNeedsMeView = readNeedsMeView;
 exports.readDeskPrefs = readDeskPrefs;
 const fs = __importStar(require("fs"));
@@ -50,6 +52,7 @@ const path = __importStar(require("path"));
 const runtime_1 = require("../../../nerves/runtime");
 const habit_parser_1 = require("../../habits/habit-parser");
 const habit_runtime_state_1 = require("../../habits/habit-runtime-state");
+const habit_session_summary_1 = require("../../habits/habit-session-summary");
 const identity_1 = require("../../identity");
 const daemon_health_1 = require("../../daemon/daemon-health");
 const flight_recorder_1 = require("../../../arc/flight-recorder");
@@ -656,6 +659,34 @@ function readHabitRunReceiptView(agentRoot, runId) {
     });
     return receipt ? { receipt } : null;
 }
+function readHabitSessionSummaryListView(agentRoot, options = {}) {
+    const limit = normalizeHabitRunLimit(options.limit);
+    const receipts = (0, flight_recorder_1.listHabitRunReceipts)(agentRoot);
+    const items = receipts.slice(0, limit)
+        .map((receipt) => (0, habit_session_summary_1.readHabitSessionSummary)(agentRoot, { runId: receipt.runId }))
+        .filter((summary) => summary !== null);
+    (0, runtime_1.emitNervesEvent)({
+        component: "heart",
+        event: "heart.mailbox_habit_run_summaries_read",
+        message: "reading mailbox habit run summaries",
+        meta: { agentRoot, totalCount: receipts.length, limit, itemCount: items.length },
+    });
+    return {
+        totalCount: receipts.length,
+        limit,
+        items,
+    };
+}
+function readHabitSessionSummaryView(agentRoot, selector) {
+    const summary = (0, habit_session_summary_1.readHabitSessionSummary)(agentRoot, selector);
+    (0, runtime_1.emitNervesEvent)({
+        component: "heart",
+        event: "heart.mailbox_habit_run_summary_read",
+        message: "reading mailbox habit run summary",
+        meta: { agentRoot, runId: summary?.runId ?? null, habitName: summary?.habitName ?? selector.habitName ?? null, found: summary !== null },
+    });
+    return summary;
+}
 function readNeedsMeView(agentName, options = {}) {
     const bundlesRoot = options.bundlesRoot ?? (0, identity_1.getAgentBundlesRoot)();
     const now = options.now?.() ?? new Date();

package/dist/heart/work-card.js

@@ -134,14 +134,18 @@ function scanArcSourceIssues(agentRoot) {
 }
 function obligationItem(obligation) {
     const freshness = obligation.meaning?.stalenessClass === "at-risk" ? "stale_risky" : "current";
+    const status = typeof obligation.status === "string" ? obligation.status : "pending";
+    const updatedAt = typeof obligation.updatedAt === "string"
+        ? obligation.updatedAt
+        : typeof obligation.createdAt === "string" ? obligation.createdAt : undefined;
     return {
         id: obligation.id,
         title: obligation.content,
-        status: obligation.status,
+        status,
         source: source("obligation", obligationLocator(obligation.id), freshness),
         ...(obligation.latestNote ? { summary: obligation.latestNote } : {}),
         ...(obligation.nextAction ? { nextAction: obligation.nextAction } : {}),
-        updatedAt: obligation.updatedAt ?? obligation.createdAt,
+        ...(updatedAt ? { updatedAt } : {}),
     };
 }
 function returnObligationItem(obligation) {

package/dist/repertoire/tools-session.js

@@ -51,11 +51,13 @@ const coding_1 = require("./coding");
 const pending_1 = require("../mind/pending");
 const obligations_1 = require("../arc/obligations");
 const progress_story_1 = require("../heart/progress-story");
+const habit_session_summary_1 = require("../heart/habits/habit-session-summary");
 const cross_chat_delivery_1 = require("../heart/cross-chat-delivery");
 const mail_import_discovery_1 = require("../heart/mail-import-discovery");
 const outbound_1 = require("../senses/voice/outbound");
 const NO_SESSION_FOUND_MESSAGE = "no session found for that friend/channel/key combination.";
 const EMPTY_SESSION_MESSAGE = "session exists but has no non-system messages.";
+const VALID_HABIT_SUMMARY_WHICH = new Set(["latest", "previous", "latest-success", "latest-failure"]);
 async function summarizeSessionTailSafely(options) {
     try {
         return await (0, session_transcript_1.summarizeSessionTail)(options);
@@ -99,6 +101,79 @@ function normalizeProgressOutcome(text) {
     }
     return trimmed;
 }
+function optionalArg(args, key) {
+    const value = args[key];
+    if (value === undefined || value === null)
+        return undefined;
+    if (typeof value !== "string")
+        return null;
+    const trimmed = value.trim();
+    return trimmed ? trimmed : undefined;
+}
+function validateSessionSummarySelector(args) {
+    const runId = optionalArg(args, "runId");
+    const habitName = optionalArg(args, "habitName");
+    const operationId = optionalArg(args, "operationId");
+    const which = optionalArg(args, "which");
+    if (runId === null || habitName === null || operationId === null || which === null) {
+        return {
+            ok: false,
+            code: which === null ? "invalid_which" : "selector_required",
+            message: which === null
+                ? "which must be latest, previous, latest-success, or latest-failure"
+                : "selector fields must be strings",
+        };
+    }
+    if (runId !== undefined) {
+        if (habitName !== undefined || operationId !== undefined || which !== undefined) {
+            return {
+                ok: false,
+                code: "run_id_exclusive",
+                message: "runId cannot be combined with habitName, operationId, or which",
+            };
+        }
+        return { ok: true, selector: { runId } };
+    }
+    if (habitName === undefined && operationId === undefined) {
+        return {
+            ok: false,
+            code: "selector_required",
+            message: "provide runId, habitName, or operationId",
+        };
+    }
+    if (which !== undefined && !VALID_HABIT_SUMMARY_WHICH.has(which)) {
+        return {
+            ok: false,
+            code: "invalid_which",
+            message: "which must be latest, previous, latest-success, or latest-failure",
+        };
+    }
+    return {
+        ok: true,
+        selector: {
+            ...(habitName !== undefined ? { habitName } : {}),
+            ...(operationId !== undefined ? { operationId } : {}),
+            ...(which !== undefined ? { which } : {}),
+        },
+    };
+}
+function renderSessionSummaryText(summary) {
+    const lines = [
+        `habit ${summary.habitName} run ${summary.runId} finished with ${summary.status}.`,
+        summary.operationId ? `operation: ${summary.operationId}` : null,
+        summary.summary,
+        summary.nextLikelyStep ? `next: ${summary.nextLikelyStep}` : null,
+        summary.decisions.length > 0 ? `decisions: ${summary.decisions.join("; ")}` : null,
+        summary.pending.count > 0 ? `pending: ${summary.pending.count} file(s) (${summary.pending.files.join(", ")})` : "pending: none",
+        summary.messagesSent.length > 0 ? `messages: ${summary.messagesSent.length}` : "messages: none",
+        summary.toolsUsed.length > 0 ? `tools: ${summary.toolsUsed.join(", ")}` : "tools: none",
+        summary.errors.length > 0 ? `errors: ${summary.errors.join("; ")}` : null,
+        summary.warnings.length > 0 ? `warnings: ${summary.warnings.join("; ")}` : null,
+        `receipt: ${summary.sources.receipt}`,
+        `session: ${summary.sources.session}`,
+    ];
+    return lines.filter((line) => Boolean(line)).join("\n");
+}
 function writePendingEnvelope(queueDir, message) {
     fs.mkdirSync(queueDir, { recursive: true });
     const fileName = `${message.timestamp}-${Math.random().toString(36).slice(2, 10)}.json`;
@@ -369,6 +444,57 @@ exports.sessionToolDefinitions = [
             return `this is my current top-level live world-state.\nanswer whole-self status questions from this before drilling into individual sessions.\n\n${(0, active_work_1.formatActiveWorkFrame)(frame)}`;
         },
     },
+    {
+        tool: {
+            type: "function",
+            function: {
+                name: "session_summary",
+                description: "read-only orientation for habit runs. returns a structured live summary from habit receipts, session files, pending dirs, and runtime cursors without writing state.",
+                parameters: {
+                    type: "object",
+                    properties: {
+                        runId: { type: "string", description: "exact habit run id; cannot be combined with habitName, operationId, or which" },
+                        habitName: { type: "string", description: "habit name to select from" },
+                        operationId: { type: "string", description: "operation id for stateful habit run groups, such as habit:heartbeat" },
+                        which: {
+                            type: "string",
+                            enum: ["latest", "previous", "latest-success", "latest-failure"],
+                            description: "which matching run to read; defaults to latest",
+                        },
+                    },
+                },
+            },
+        },
+        handler: (args) => {
+            const validation = validateSessionSummarySelector(args);
+            if (!validation.ok) {
+                return JSON.stringify({
+                    kind: "invalid_selector",
+                    code: validation.code,
+                    message: validation.message,
+                }, null, 2);
+            }
+            const summary = (0, habit_session_summary_1.readHabitSessionSummary)((0, identity_1.getAgentRoot)(), validation.selector);
+            if (!summary) {
+                return JSON.stringify({
+                    kind: "not_found",
+                    message: "no habit run matched selector",
+                    selector: validation.selector,
+                }, null, 2);
+            }
+            return JSON.stringify({
+                kind: "habit_session_summary",
+                text: renderSessionSummaryText(summary),
+                summary,
+            }, null, 2);
+        },
+        riskProfile: {
+            mutates: "none",
+            risk: "low",
+            reason: "reads habit run summaries from local receipts and session artifacts",
+        },
+        summaryKeys: ["runId", "habitName", "operationId", "which"],
+    },
     {
         tool: {
             type: "function",

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

@@ -2,6 +2,8 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.buildHabitTurnMessage = buildHabitTurnMessage;
 const runtime_1 = require("../nerves/runtime");
+const PRIOR_SESSION_SUMMARY_LIMIT = 1600;
+const PRIOR_SESSION_TRUNCATION_SUFFIX = "\n[truncated]";
 function formatElapsed(ms) {
     const minutes = Math.floor(ms / 60000);
     if (minutes < 60) {
@@ -11,9 +13,9 @@ function formatElapsed(ms) {
     return `${hours} ${hours === 1 ? "hour" : "hours"}`;
 }
 function buildHabitTurnMessage(options) {
-    const { habitName, habitTitle, habitBody, lastRun, checkpoint, alsoDue, staleObligations, parseErrors, degradedComponents, arcResume, deskOrientation, surfacePolicy, now, } = options;
+    const { habitName, habitTitle, habitBody, lastRun, checkpoint, alsoDue, staleObligations, parseErrors, degradedComponents, arcResume, deskOrientation, surfacePolicy, priorSessionSummary, now, } = options;
     const hasBody = habitBody !== undefined && habitBody !== "";
-    const leadingSections = buildLeadingSections(arcResume, deskOrientation, surfacePolicy);
+    const leadingSections = buildLeadingSections(arcResume, deskOrientation, surfacePolicy, priorSessionSummary);
     // First beat: lastRun is null
     if (lastRun === null) {
         // Cold start: no checkpoint, no body — bare awareness
@@ -86,7 +88,7 @@ function buildHabitTurnMessage(options) {
     });
     return joinSections(leadingSections, sections);
 }
-function buildLeadingSections(arcResume, deskOrientation, surfacePolicy) {
+function buildLeadingSections(arcResume, deskOrientation, surfacePolicy, priorSessionSummary) {
     const sections = [];
     if (arcResume?.trim())
         sections.push(arcResume.trim());
@@ -94,11 +96,47 @@ function buildLeadingSections(arcResume, deskOrientation, surfacePolicy) {
         sections.push(deskOrientation.trim());
     if (surfacePolicy?.trim())
         sections.push(surfacePolicy.trim());
+    const priorSummary = buildPriorSessionSummarySection(priorSessionSummary);
+    if (priorSummary)
+        sections.push(priorSummary);
     return sections;
 }
 function joinSections(leadingSections, sections) {
     return [...leadingSections, ...sections].filter((section) => section.trim().length > 0).join("\n\n");
 }
+function truncatePriorSummary(summary) {
+    if (summary.length <= PRIOR_SESSION_SUMMARY_LIMIT)
+        return summary;
+    return `${summary.slice(0, PRIOR_SESSION_SUMMARY_LIMIT - PRIOR_SESSION_TRUNCATION_SUFFIX.length)}${PRIOR_SESSION_TRUNCATION_SUFFIX}`;
+}
+function buildPriorSessionSummarySection(priorSessionSummary) {
+    if (!priorSessionSummary || priorSessionSummary.mode !== "stateful")
+        return null;
+    const lines = ["## Prior habit session summary"];
+    const summary = priorSessionSummary.summary?.trim();
+    if (summary) {
+        lines.push(truncatePriorSummary(summary));
+    }
+    else {
+        lines.push("No prior stateful habit summary found for this operation.");
+    }
+    const sourceLines = ["receipt", "session", "pending", "runtimeState"]
+        .flatMap((key) => {
+        const value = cleanSourceLocator(priorSessionSummary.sources[key]);
+        return value ? [`${key}: ${value}`] : [];
+    });
+    if (sourceLines.length > 0)
+        lines.push(...sourceLines);
+    if (priorSessionSummary.warnings.length > 0)
+        lines.push(`warnings: ${priorSessionSummary.warnings.join("; ")}`);
+    return lines.join("\n");
+}
+function cleanSourceLocator(value) {
+    if (typeof value !== "string")
+        return null;
+    const trimmed = value.trim();
+    return trimmed.length > 0 ? trimmed : null;
+}
 function appendTrailingExtras(sections, alsoDue, staleObligations, parseErrors, degradedComponents) {
     // 4. Also-due
     if (alsoDue) {

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

@@ -43,8 +43,10 @@ const runtime_1 = require("../nerves/runtime");
 const identity_1 = require("../heart/identity");
 const pending_1 = require("../mind/pending");
 const habit_parser_1 = require("../heart/habits/habit-parser");
+const habit_runtime_state_1 = require("../heart/habits/habit-runtime-state");
 const habit_session_1 = require("../heart/habits/habit-session");
 const flight_recorder_1 = require("../arc/flight-recorder");
+const habit_session_summary_1 = require("../heart/habits/habit-session-summary");
 const store_file_1 = require("../mind/friends/store-file");
 const tools_base_1 = require("../repertoire/tools-base");
 const tools_surface_1 = require("../repertoire/tools-surface");
@@ -89,6 +91,79 @@ function isHeartbeatOkRestResult(result) {
     const maybeResult = result;
     return maybeResult.turnOutcome === "rested" && maybeResult.restStatus === "HEARTBEAT_OK";
 }
+function isRecord(value) {
+    return !!value && typeof value === "object" && !Array.isArray(value);
+}
+function contentToText(content) {
+    if (typeof content === "string")
+        return content.trim();
+    if (!Array.isArray(content))
+        return "";
+    return content
+        .map((part) => isRecord(part) && typeof part.text === "string" ? part.text : "")
+        .filter((text) => text.trim().length > 0)
+        .join("\n")
+        .trim();
+}
+function resultMessages(result) {
+    if (Array.isArray(result))
+        return result.flatMap((entry) => resultMessages(entry));
+    return isRecord(result) && Array.isArray(result.messages) ? result.messages : [];
+}
+function latestAssistantText(results) {
+    for (let resultIndex = results.length - 1; resultIndex >= 0; resultIndex--) {
+        const messages = resultMessages(results[resultIndex]);
+        for (let messageIndex = messages.length - 1; messageIndex >= 0; messageIndex--) {
+            const message = messages[messageIndex];
+            if (!isRecord(message) || message.role !== "assistant")
+                continue;
+            const text = contentToText(message.content);
+            if (text.length > 0)
+                return text.replace(/^checkpoint\s*:\s*/i, "").trim() || text;
+        }
+    }
+    return null;
+}
+function deriveHabitSummarySnapshot(habitRun) {
+    const assistant = latestAssistantText(habitRun.results);
+    if (assistant)
+        return { summary: assistant, decisions: [], nextLikelyStep: null };
+    if (habitRun.errors.length > 0) {
+        return {
+            summary: `Habit ${habitRun.habit.name} finished with errors: ${habitRun.errors.join("; ")}`,
+            decisions: [],
+            nextLikelyStep: null,
+        };
+    }
+    const surfaced = habitRun.surfaceAttempts.find((attempt) => attempt.result !== "blocked" && attempt.result !== "failed" && attempt.result !== "unavailable");
+    if (surfaced) {
+        return {
+            summary: `Habit ${habitRun.habit.name} surfaced via ${surfaced.recipient}/${surfaced.channel}.`,
+            decisions: [],
+            nextLikelyStep: null,
+        };
+    }
+    const produced = habitRun.producedRefs.find((ref) => ref.kind !== "none");
+    if (produced) {
+        return {
+            summary: `Habit ${habitRun.habit.name} produced ${produced.kind}: ${produced.locator}.`,
+            decisions: [],
+            nextLikelyStep: null,
+        };
+    }
+    if (habitRun.results.some(isHeartbeatOkRestResult)) {
+        return {
+            summary: `Habit ${habitRun.habit.name} rested with HEARTBEAT_OK.`,
+            decisions: [],
+            nextLikelyStep: null,
+        };
+    }
+    return {
+        summary: `Habit ${habitRun.habit.name} completed without additional surfaced output.`,
+        decisions: [],
+        nextLikelyStep: null,
+    };
+}
 function fallbackHabitFile(habitName) {
     return {
         name: habitName,
@@ -100,6 +175,7 @@ function fallbackHabitFile(habitName) {
         tools: [],
         origin: null,
         surface: { family: false, originator: false, extra: [] },
+        continuity: { mode: "fresh" },
         body: "",
     };
 }
@@ -124,8 +200,10 @@ function readHabitForRun(agentRoot, habitName, errors) {
 async function prepareHabitRun(habitName, trigger, startedAt) {
     const agentRoot = (0, identity_1.getAgentRoot)();
     const errors = [];
-    const habit = readHabitForRun(agentRoot, habitName, errors);
+    const habit = (0, habit_runtime_state_1.applyHabitRuntimeState)(agentRoot, readHabitForRun(agentRoot, habitName, errors));
     const runId = (0, flight_recorder_1.createHabitRunId)(habitName, new Date(startedAt));
+    const operationId = habit.continuity.mode === "stateful" ? `habit:${habit.name}` : null;
+    const priorSessionSummary = readPriorSessionSummary(agentRoot, operationId);
     const paths = (0, habit_session_1.createHabitSessionPaths)(agentRoot, runId, habit.name);
     const friendStore = new store_file_1.FileFriendStore(path.join(agentRoot, "friends"));
     const permissionEnvelope = await (0, habit_session_1.normalizeHabitPermissionEnvelope)(habit, { agentRoot, friendStore });
@@ -134,8 +212,10 @@ async function prepareHabitRun(habitName, trigger, startedAt) {
         agentRoot,
         habit,
         runId,
+        operationId,
         trigger,
         startedAt,
+        priorSessionSummary,
         paths,
         permissionEnvelope,
         toolPolicy,
@@ -150,6 +230,29 @@ function riskProfileForHabitPolicy(definition, name) {
     const probeArgs = name === "shell" ? { command: "touch /tmp/habit-policy-probe" } : {};
     return (0, tools_1.riskProfileForTool)(definition, name, probeArgs);
 }
+function readPriorSessionSummary(agentRoot, operationId) {
+    if (operationId === null)
+        return undefined;
+    try {
+        const summary = (0, habit_session_summary_1.readHabitSessionSummary)(agentRoot, { operationId, which: "latest" });
+        if (!summary)
+            return { mode: "stateful", summary: null, sources: {}, warnings: [] };
+        return {
+            mode: "stateful",
+            summary: summary.summary,
+            sources: summary.sources,
+            warnings: summary.warnings,
+        };
+    }
+    catch (error) {
+        return {
+            mode: "stateful",
+            summary: null,
+            sources: {},
+            warnings: [`prior summary read failed: ${String(error)}`],
+        };
+    }
+}
 function createInnerDialogWorker(runTurn = (options) => (0, inner_dialog_1.runInnerDialogTurn)(options), hasPendingWork = (pendingDir) => (0, pending_1.hasPendingMessages)(pendingDir ?? (0, pending_1.getInnerDialogPendingDir)((0, identity_1.getAgentName)())), nowSource = () => Date.now()) {
     let running = false;
     const queue = [];
@@ -164,11 +267,13 @@ function createInnerDialogWorker(runTurn = (options) => (0, inner_dialog_1.runIn
             trigger: habitRun.trigger,
             startedAt: habitRun.startedAt,
             endedAt,
+            operationId: habitRun.operationId,
             permissionEnvelope: habitRun.permissionEnvelope,
             toolPolicy: habitRun.toolPolicy,
             producedRefs: habitRun.producedRefs,
             surfaceAttempts: habitRun.surfaceAttempts,
             errors: habitRun.errors,
+            summarySnapshot: deriveHabitSummarySnapshot(habitRun),
         });
     }
     function clearHeartbeatRestShield() {
@@ -286,6 +391,13 @@ function createInnerDialogWorker(runTurn = (options) => (0, inner_dialog_1.runIn
                         ...(currentHabitRun
                             ? {
                                 trigger: currentHabitRun.trigger,
+                                preparedHabit: {
+                                    runId: currentHabitRun.runId,
+                                    trigger: currentHabitRun.trigger,
+                                    operationId: currentHabitRun.operationId,
+                                    habit: currentHabitRun.habit,
+                                    priorSessionSummary: currentHabitRun.priorSessionSummary,
+                                },
                                 habitSession: {
                                     runId: currentHabitRun.runId,
                                     sessionPath: currentHabitRun.paths.sessionPath,