@ouro.bot/cli 0.1.0-alpha.50 → 0.1.0-alpha.501

package/dist/heart/session-playback-cli-main.js

@@ -0,0 +1,5 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const session_playback_cli_1 = require("./session-playback-cli");
+const code = (0, session_playback_cli_1.runSessionPlaybackCli)(process.argv.slice(2));
+process.exit(code);

package/dist/heart/session-playback-cli.js

@@ -0,0 +1,36 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runSessionPlaybackCli = runSessionPlaybackCli;
+const session_playback_1 = require("./session-playback");
+function printHelp() {
+    // eslint-disable-next-line no-console -- meta-tooling
+    console.log([
+        "usage: ouro session-playback <session.json> [--json]",
+        "",
+        "Loads a saved session.json, runs it through the same sanitize pipeline that fires before",
+        "every replay, and prints a report of what would be dropped, content-modified, or",
+        "synthetically inserted. Read-only; the file on disk is never written.",
+        "",
+        "Useful when an agent is stuck in a replay loop and you want to see what the harness",
+        "thinks is wrong with the session before deciding whether to clear or repair.",
+    ].join("\n"));
+}
+function runSessionPlaybackCli(argv) {
+    const positional = argv.filter((token) => !token.startsWith("--"));
+    const flags = new Set(argv.filter((token) => token.startsWith("--")));
+    if (flags.has("--help") || flags.has("-h") || positional.length === 0) {
+        printHelp();
+        return positional.length === 0 ? 2 : 0;
+    }
+    const sessionPath = positional[0];
+    const report = (0, session_playback_1.runSessionPlayback)({ sessionPath });
+    if (flags.has("--json")) {
+        // eslint-disable-next-line no-console -- meta-tooling
+        console.log(JSON.stringify(report, null, 2));
+    }
+    else {
+        // eslint-disable-next-line no-console -- meta-tooling
+        console.log((0, session_playback_1.formatPlaybackReport)(report));
+    }
+    return 0;
+}

package/dist/heart/session-playback.js

@@ -0,0 +1,231 @@
+"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.runSessionPlayback = runSessionPlayback;
+exports.formatPlaybackReport = formatPlaybackReport;
+const fs = __importStar(require("node:fs"));
+const session_events_1 = require("./session-events");
+const PREVIEW_MAX_CHARS = 120;
+function shortPreview(value) {
+    if (value == null)
+        return "";
+    if (typeof value === "string") {
+        const trimmed = value.replace(/\s+/g, " ").trim();
+        /* v8 ignore next -- branch: PREVIEW_MAX_CHARS truncation only triggers on long inline content @preserve */
+        return trimmed.length > PREVIEW_MAX_CHARS ? `${trimmed.slice(0, PREVIEW_MAX_CHARS - 3)}...` : trimmed;
+    }
+    /* v8 ignore next -- defensive: content is always string or array in practice @preserve */
+    return shortPreview(JSON.stringify(value));
+}
+function getRole(message) {
+    /* v8 ignore next -- defensive fallback: provider messages always carry a role @preserve */
+    return message.role ?? "unknown";
+}
+function getToolCallId(message) {
+    const value = message.tool_call_id;
+    /* v8 ignore next -- defensive: tool messages always carry a string tool_call_id @preserve */
+    return typeof value === "string" ? value : undefined;
+}
+function getContentString(message) {
+    const value = message.content;
+    if (typeof value === "string")
+        return value;
+    /* v8 ignore start -- defensive: array content (multipart) and missing content branches not exercised by replay test fixtures @preserve */
+    if (Array.isArray(value)) {
+        return value
+            .map((part) => (part && typeof part === "object" && "text" in part ? String(part.text ?? "") : ""))
+            .join("");
+    }
+    return "";
+    /* v8 ignore stop */
+}
+function detectEnvelopeShape(raw) {
+    if (!raw || typeof raw !== "object")
+        return "unknown";
+    const record = raw;
+    if (record.version === 2 && Array.isArray(record.events))
+        return "v2";
+    if (record.version === 1 || ("messages" in record && Array.isArray(record.messages)))
+        return "legacy";
+    return "unknown";
+}
+function rawLegacyMessages(raw) {
+    /* v8 ignore next -- defensive: caller already detected legacy shape via Array.isArray(messages) @preserve */
+    if (!raw || typeof raw !== "object")
+        return [];
+    const record = raw;
+    if (Array.isArray(record.messages)) {
+        return record.messages.filter((m) => m != null && typeof m === "object");
+    }
+    /* v8 ignore next -- unreachable in practice: detectEnvelopeShape gates this on Array.isArray(messages) @preserve */
+    return [];
+}
+function inputMessagesForShape(shape, raw, envelope) {
+    if (shape === "legacy")
+        return rawLegacyMessages(raw);
+    if (shape === "v2" && envelope)
+        return (0, session_events_1.projectProviderMessages)(envelope);
+    return [];
+}
+function diffMessages(input, sanitized) {
+    const changes = [];
+    const sanitizedByToolCallId = new Map();
+    for (let i = 0; i < sanitized.length; i++) {
+        const id = getToolCallId(sanitized[i]);
+        if (id)
+            sanitizedByToolCallId.set(id, i);
+    }
+    const inputToolCallIds = new Set();
+    for (let i = 0; i < input.length; i++) {
+        const message = input[i];
+        const role = getRole(message);
+        const toolCallId = getToolCallId(message);
+        if (role === "tool" && toolCallId)
+            inputToolCallIds.add(toolCallId);
+        if (role === "tool" && toolCallId && !sanitizedByToolCallId.has(toolCallId)) {
+            changes.push({
+                index: i,
+                role,
+                action: "dropped",
+                toolCallId,
+                reason: "tool result orphan dropped (no preceding assistant tool_call with this id)",
+                preview: shortPreview(getContentString(message)),
+            });
+        }
+    }
+    for (let i = 0; i < input.length; i++) {
+        const message = input[i];
+        const role = getRole(message);
+        if (role !== "assistant")
+            continue;
+        const inputContent = getContentString(message);
+        if (!inputContent)
+            continue;
+        const stripped = inputContent.replace(/<think>[\s\S]*?<\/think>/gi, "").replace(/<think>[\s\S]*$/i, "").trim();
+        if (stripped !== inputContent.trim()) {
+            changes.push({
+                index: i,
+                role,
+                action: "modified-content",
+                reason: "inline <think> reasoning would be stripped before replay",
+                preview: shortPreview(inputContent),
+            });
+        }
+    }
+    const inputAssistantToolCallIds = new Set();
+    for (const message of input) {
+        if (getRole(message) !== "assistant")
+            continue;
+        const toolCalls = message.tool_calls;
+        if (!Array.isArray(toolCalls))
+            continue;
+        for (const call of toolCalls) {
+            if (typeof call?.id === "string")
+                inputAssistantToolCallIds.add(call.id);
+        }
+    }
+    /* v8 ignore start -- synthetic-add detection: the sanitize pipeline only synthesizes results for unbalanced tool_calls; replay test fixtures don't exercise this branch combination @preserve */
+    for (let i = 0; i < sanitized.length; i++) {
+        const message = sanitized[i];
+        if (getRole(message) !== "tool")
+            continue;
+        const toolCallId = getToolCallId(message);
+        if (!toolCallId)
+            continue;
+        if (!inputToolCallIds.has(toolCallId) && inputAssistantToolCallIds.has(toolCallId)) {
+            changes.push({
+                index: i,
+                role: "tool",
+                action: "synthetic-added",
+                toolCallId,
+                reason: "synthetic tool result inserted to satisfy provider tool_call/tool_result pairing",
+                preview: shortPreview(getContentString(message)),
+            });
+        }
+    }
+    /* v8 ignore stop */
+    return changes.sort((left, right) => left.index - right.index);
+}
+function runSessionPlayback(options) {
+    let raw = options.raw;
+    if (raw === undefined) {
+        const text = fs.readFileSync(options.sessionPath, "utf-8");
+        raw = JSON.parse(text);
+    }
+    const shape = detectEnvelopeShape(raw);
+    /* v8 ignore next -- v2 envelope branch: not exercised by current replay test fixtures (all legacy v1) @preserve */
+    const envelope = shape === "v2" ? (0, session_events_1.parseSessionEnvelope)(raw) : null;
+    const input = inputMessagesForShape(shape, raw, envelope);
+    const sanitized = (0, session_events_1.sanitizeProviderMessages)(input);
+    const changes = diffMessages(input, sanitized);
+    return {
+        sessionPath: options.sessionPath,
+        envelopeShape: shape,
+        inputMessageCount: input.length,
+        sanitizedMessageCount: sanitized.length,
+        totals: {
+            dropped: changes.filter((change) => change.action === "dropped").length,
+            modifiedContent: changes.filter((change) => change.action === "modified-content").length,
+            syntheticAdded: changes.filter((change) => change.action === "synthetic-added").length,
+        },
+        changes,
+    };
+}
+function formatPlaybackReport(report) {
+    const lines = [];
+    lines.push(`Session playback: ${report.sessionPath}`);
+    lines.push(`  envelope shape:   ${report.envelopeShape}`);
+    lines.push(`  input messages:   ${report.inputMessageCount}`);
+    lines.push(`  sanitized count:  ${report.sanitizedMessageCount}`);
+    lines.push(`  dropped:          ${report.totals.dropped}`);
+    lines.push(`  modified content: ${report.totals.modifiedContent}`);
+    lines.push(`  synthetic added:  ${report.totals.syntheticAdded}`);
+    if (report.changes.length === 0) {
+        lines.push("");
+        lines.push("no repairs would apply.");
+        return lines.join("\n");
+    }
+    lines.push("");
+    lines.push("changes (oldest first):");
+    /* v8 ignore start -- per-change formatting branches: toolCallId-present and preview-absent variants depend on the specific change shape and aren't exercised by the legacy fixtures @preserve */
+    for (const change of report.changes) {
+        lines.push(`  [${String(change.index).padStart(4, "0")}] ${change.action.padEnd(18)} ${change.role}${change.toolCallId ? ` tool_call_id=${change.toolCallId}` : ""}`);
+        lines.push(`         reason: ${change.reason}`);
+        if (change.preview)
+            lines.push(`         preview: ${change.preview}`);
+    }
+    /* v8 ignore stop */
+    return lines.join("\n");
+}

package/dist/heart/session-transcript.js

@@ -0,0 +1,167 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.summarizeSessionTail = summarizeSessionTail;
+exports.searchSessionTranscript = searchSessionTranscript;
+const runtime_1 = require("../nerves/runtime");
+const session_events_1 = require("./session-events");
+function normalizeSessionMessages(events) {
+    return events
+        .map((event) => ({
+        id: event.id,
+        role: event.role,
+        content: (0, session_events_1.extractEventText)(event),
+        timestamp: (0, session_events_1.formatSessionEventTimestamp)(event),
+    }))
+        .filter((message) => message.role !== "system" && message.content.length > 0);
+}
+function buildSummaryInstruction(friendId, channel, trustLevel) {
+    if (friendId === "self" && channel === "inner") {
+        return "summarize this session transcript fully and transparently. this is my own inner dialog — include all details, decisions, and reasoning.";
+    }
+    return `summarize this session transcript. the person asking has trust level: ${trustLevel}. family=full transparency, friend=share work and general topics but protect other people's identities, acquaintance=very guarded minimal disclosure.`;
+}
+function clip(text, limit = 160) {
+    const compact = text.replace(/\s+/g, " ").trim();
+    return compact.length > limit ? compact.slice(0, limit - 1) + "…" : compact;
+}
+function buildSnapshot(summary, tailMessages) {
+    const lines = [`recent focus: ${clip(summary, 240)}`];
+    const latestUser = [...tailMessages].reverse().find((message) => message.role === "user")?.content;
+    const latestAssistant = [...tailMessages].reverse().find((message) => message.role === "assistant")?.content;
+    if (latestUser) {
+        lines.push(`latest user: ${clip(latestUser)}`);
+    }
+    if (latestAssistant) {
+        lines.push(`latest assistant: ${clip(latestAssistant)}`);
+    }
+    return lines.join("\n");
+}
+function buildSearchSnapshot(query, messages, includeLatestTurn = true) {
+    const lines = [`history query: "${clip(query, 120)}"`];
+    if (!includeLatestTurn) {
+        return lines.join("\n");
+    }
+    const latestUser = [...messages].reverse().find((message) => message.role === "user")?.content;
+    const latestAssistant = [...messages].reverse().find((message) => message.role === "assistant")?.content;
+    if (latestUser) {
+        lines.push(`latest user: ${clip(latestUser)}`);
+    }
+    if (latestAssistant) {
+        lines.push(`latest assistant: ${clip(latestAssistant)}`);
+    }
+    return lines.join("\n");
+}
+function buildSearchExcerpts(messages, query, maxMatches) {
+    const normalizedQuery = query.trim().toLowerCase();
+    if (!normalizedQuery)
+        return [];
+    const candidates = [];
+    let lastMatchIndex = -2;
+    for (let i = 0; i < messages.length; i++) {
+        if (!messages[i].content.toLowerCase().includes(normalizedQuery))
+            continue;
+        if (i <= lastMatchIndex + 1)
+            continue;
+        lastMatchIndex = i;
+        const start = Math.max(0, i - 1);
+        const end = Math.min(messages.length, i + 2);
+        const excerpt = messages
+            .slice(start, end)
+            .map((message) => `[${message.timestamp} | ${message.role} | ${message.id}] ${clip(message.content, 200)}`)
+            .join("\n");
+        const signature = messages
+            .slice(start, end)
+            .map((message) => `[${message.role}] ${clip(message.content, 200)}`)
+            .join("\n");
+        const score = messages
+            .slice(start, end)
+            .filter((message) => message.content.toLowerCase().includes(normalizedQuery))
+            .length;
+        candidates.push({ excerpt, signature, score, index: i });
+    }
+    const seen = new Set();
+    return candidates
+        .sort((a, b) => b.score - a.score || a.index - b.index)
+        .filter((candidate) => {
+        if (seen.has(candidate.signature))
+            return false;
+        seen.add(candidate.signature);
+        return true;
+    })
+        .slice(0, maxMatches)
+        .map((candidate) => candidate.excerpt);
+}
+async function summarizeSessionTail(options) {
+    (0, runtime_1.emitNervesEvent)({
+        component: "daemon",
+        event: "daemon.session_tail_summary",
+        message: "summarizing session transcript tail",
+        meta: {
+            friendId: options.friendId,
+            channel: options.channel,
+            key: options.key,
+            messageCount: options.messageCount,
+        },
+    });
+    const envelope = (0, session_events_1.loadSessionEnvelopeFile)(options.sessionPath);
+    if (!envelope)
+        return { kind: "missing" };
+    const tailMessages = normalizeSessionMessages(envelope.events).slice(-options.messageCount);
+    if (tailMessages.length === 0) {
+        return { kind: "empty" };
+    }
+    const transcript = tailMessages
+        .map((message) => `[${message.timestamp} | ${message.role} | ${message.id}] ${message.content}`)
+        .join("\n");
+    const summary = options.summarize
+        ? await options.summarize(transcript, buildSummaryInstruction(options.friendId, options.channel, options.trustLevel ?? "family"))
+        : transcript;
+    return {
+        kind: "ok",
+        transcript,
+        summary,
+        snapshot: buildSnapshot(summary, tailMessages),
+        tailMessages,
+    };
+}
+async function searchSessionTranscript(options) {
+    (0, runtime_1.emitNervesEvent)({
+        component: "daemon",
+        event: "daemon.session_search",
+        message: "searching session transcript",
+        meta: {
+            friendId: options.friendId,
+            channel: options.channel,
+            key: options.key,
+            query: options.query,
+            maxMatches: options.maxMatches ?? 5,
+        },
+    });
+    // Use full event history (envelope + archive) for search to find older messages
+    const allEvents = (0, session_events_1.loadFullEventHistory)(options.sessionPath);
+    if (allEvents.length === 0) {
+        const envelope = (0, session_events_1.loadSessionEnvelopeFile)(options.sessionPath);
+        if (!envelope)
+            return { kind: "missing" };
+        return { kind: "empty" };
+    }
+    const messages = normalizeSessionMessages(allEvents);
+    if (messages.length === 0) {
+        return { kind: "empty" };
+    }
+    const query = options.query.trim();
+    const matches = buildSearchExcerpts(messages, query, options.maxMatches ?? 5);
+    if (matches.length === 0) {
+        return {
+            kind: "no_match",
+            query,
+            snapshot: buildSearchSnapshot(query, messages),
+        };
+    }
+    return {
+        kind: "ok",
+        query,
+        snapshot: buildSearchSnapshot(query, messages, false),
+        matches,
+    };
+}