@pasko70/pibo 1.1.0 → 1.2.0

package/dist/debug/events.js

@@ -1,13 +1,16 @@
+import { formatTruncationFooter, sliceTextByBytes } from "./detail-format.js";
+import { formatNextCommands } from "./next-commands.js";
+import { compactOneLine, eventPayload, rawEventObject, resolveEventField, sourceRef, stringifyPayloadValue } from "./payloads.js";
 import { normalizeLimit, openReadOnlyDebugDatabase, withStorePath } from "./sql.js";
 export function inspectDebugEvents(piboSessionId, store, options = {}) {
     if (!store.exists)
-        throw new Error(`Debug store "chat" not found at ${store.defaultPath}`);
+        throw new Error(`Debug store "chat" not found at ${store.path}`);
     const limit = normalizeLimit(options.limit);
     const db = openReadOnlyDebugDatabase(store);
     try {
-        if (!tableExists(db, "web_chat_events"))
+        if (!tableExists(db, "event_log"))
             return { piboSessionId, events: [], limited: false };
-        const clauses = ["pibo_session_id = ?"];
+        const clauses = ["session_id = ?"];
         const values = [piboSessionId];
         if (options.type) {
             clauses.push("type = ?");
@@ -15,18 +18,20 @@ export function inspectDebugEvents(piboSessionId, store, options = {}) {
         }
         const rows = db
             .prepare(`
-					SELECT id, event_id, type, created_at, payload_json
-					FROM web_chat_events
+					SELECT stream_id, session_id, session_sequence, event_id, type, created_at, preview_text, attributes_json
+					FROM event_log
 					WHERE ${clauses.join(" AND ")}
-					ORDER BY rowid DESC
+					ORDER BY stream_id DESC
 					LIMIT ?
 				`)
             .all(...values, limit + 1);
         const limited = rows.length > limit;
+        const events = rows.slice(0, limit).map((row) => formatEventRow(row, options.fields ?? []));
         return {
             piboSessionId,
-            events: rows.slice(0, limit).map((row) => formatEventRow(row, options.fields ?? [])),
+            events,
             limited,
+            nextCommands: buildListNextCommands(piboSessionId, rows.slice(0, limit)),
         };
     }
     catch (error) {
@@ -36,53 +41,168 @@ export function inspectDebugEvents(piboSessionId, store, options = {}) {
         db.close();
     }
 }
+export function inspectDebugEventShow(piboSessionId, store, selector, options = {}) {
+    if (!store.exists)
+        throw new Error(`Debug store "chat" not found at ${store.path}`);
+    const db = openReadOnlyDebugDatabase(store);
+    try {
+        if (!tableExists(db, "event_log"))
+            return { piboSessionId, resultType: "debug.events.show", selector, nextCommands: [] };
+        const row = findEventRow(db, piboSessionId, selector);
+        if (!row)
+            return { piboSessionId, resultType: "debug.events.show", selector, nextCommands: [`pibo debug events ${piboSessionId} list`] };
+        const payload = eventPayload(row);
+        const raw = rawEventObject(row);
+        const shown = options.raw ? raw : payload;
+        const source = sourceRef(row, options.field, options.raw ? "raw" : "event");
+        const result = {
+            piboSessionId,
+            resultType: "debug.events.show",
+            selector,
+            event: formatEventRow(row, []),
+            payload: shown,
+            source,
+            nextCommands: buildShowNextCommands(piboSessionId, row),
+        };
+        if (options.field) {
+            const resolved = resolveEventField(row, options.field);
+            result.field = options.field;
+            result.fieldValue = resolved.value;
+            result.source = sourceRef(row, resolved.source === "raw" ? options.field : options.field, "event");
+            if (resolved.value === undefined)
+                return result;
+            const text = stringifyPayloadValue(resolved.value);
+            result.truncation = sliceTextByBytes(text, options, 8 * 1024);
+            result.text = result.truncation.text;
+            return result;
+        }
+        if (options.payload || options.raw) {
+            const text = stringifyPayloadValue(shown);
+            result.truncation = sliceTextByBytes(text, options, 8 * 1024);
+            result.text = result.truncation.text;
+            return result;
+        }
+        const inline = stringifyPayloadValue(payload.inlinePayload ?? payload.text ?? row.preview_text ?? "");
+        result.truncation = sliceTextByBytes(inline, options, 2 * 1024);
+        result.text = result.truncation.text;
+        return result;
+    }
+    catch (error) {
+        throw withStorePath(error, store);
+    }
+    finally {
+        db.close();
+    }
+}
 export function formatDebugEvents(result) {
     if (result.events.length === 0)
-        return "events: 0";
+        return ["events: 0", ...formatNextCommands(result.nextCommands ?? [])].join("\n");
     const columns = Object.keys(result.events[0] ?? {});
     const lines = [columns.join("\t")];
     for (const event of result.events) {
         lines.push(columns.map((column) => formatValue(event[column])).join("\t"));
     }
     lines.push(`events: ${result.events.length}${result.limited ? " (limited)" : ""}`);
+    lines.push(...formatNextCommands(result.nextCommands ?? []));
+    return lines.join("\n");
+}
+export function formatDebugEventShow(result) {
+    if (!result.event)
+        return [`event: not found`, ...formatNextCommands(result.nextCommands)].join("\n");
+    if (result.field && result.fieldValue === undefined) {
+        return [
+            `stream_id: ${result.event.stream_id}`,
+            `type: ${result.event.type}`,
+            `field: ${result.field}`,
+            "value: <missing>",
+            "Hint: run with --json --raw to inspect available fields.",
+            ...formatNextCommands([`pibo debug events ${result.piboSessionId} show ${result.event.stream_id} --json --raw`]),
+        ].join("\n");
+    }
+    if (result.field) {
+        const lines = [result.text ?? ""];
+        if (result.truncation)
+            lines.push(...formatTruncationFooter(result.truncation, {
+                nextChunk: result.truncation.truncatedAfter ? `pibo debug events ${result.piboSessionId} show ${result.event.stream_id} --field ${result.field} --from ${result.truncation.from + result.truncation.bytesShown} --bytes ${Math.max(result.truncation.bytesShown, 1)}` : undefined,
+                full: `pibo debug events ${result.piboSessionId} show ${result.event.stream_id} --field ${result.field} --no-truncate`,
+            }));
+        return lines.join("\n");
+    }
+    const lines = [];
+    lines.push(`stream_id: ${result.event.stream_id}`);
+    lines.push(`type: ${result.event.type}`);
+    lines.push(`created_at: ${result.event.created_at}`);
+    if (result.event.event_id)
+        lines.push(`event_id: ${result.event.event_id}`);
+    if (result.event.preview_text)
+        lines.push(`preview: ${compactOneLine(result.event.preview_text)}`);
+    if (result.text) {
+        lines.push("");
+        lines.push("Payload preview:");
+        lines.push(result.text);
+        if (result.truncation)
+            lines.push(...formatTruncationFooter(result.truncation, {
+                nextChunk: result.truncation.truncatedAfter ? `pibo debug events ${result.piboSessionId} show ${result.event.stream_id} --payload --from ${result.truncation.from + result.truncation.bytesShown} --bytes ${Math.max(result.truncation.bytesShown, 1)}` : undefined,
+                full: `pibo debug events ${result.piboSessionId} show ${result.event.stream_id} --payload --no-truncate`,
+            }));
+    }
+    lines.push(...formatNextCommands(result.nextCommands));
     return lines.join("\n");
 }
 function formatEventRow(row, fields) {
-    const payload = parseObject(row.payload_json);
+    const payload = eventPayload(row);
     const result = {
         created_at: row.created_at,
         type: row.type,
         event_id: row.event_id,
+        stream_id: row.stream_id,
     };
+    if (row.preview_text)
+        result.preview_text = row.preview_text;
     for (const field of fields) {
-        result[field] = getPath(payload, field);
+        result[field] = resolveEventField(row, field).value;
     }
-    return result;
+    return fields.length ? result : { created_at: row.created_at, type: row.type, event_id: row.event_id, stream_id: row.stream_id, preview_text: row.preview_text };
 }
-function getPath(value, path) {
-    let current = value;
-    for (const part of path.split(".").filter(Boolean)) {
-        if (!current || typeof current !== "object" || Array.isArray(current))
-            return undefined;
-        current = current[part];
+function findEventRow(db, piboSessionId, selector) {
+    const numeric = Number(selector);
+    if (Number.isInteger(numeric)) {
+        const row = db.prepare(`
+			SELECT stream_id, session_id, session_sequence, event_id, type, created_at, preview_text, attributes_json
+			FROM event_log WHERE session_id = ? AND stream_id = ?
+		`).get(piboSessionId, numeric);
+        if (row)
+            return row;
     }
-    return current;
+    return db.prepare(`
+		SELECT stream_id, session_id, session_sequence, event_id, type, created_at, preview_text, attributes_json
+		FROM event_log WHERE session_id = ? AND event_id = ? ORDER BY stream_id DESC LIMIT 1
+	`).get(piboSessionId, selector);
+}
+function buildListNextCommands(piboSessionId, rows) {
+    const latest = rows[0];
+    const latestAssistant = rows.find((row) => row.type === "assistant_message");
+    return [
+        latest ? `pibo debug events ${piboSessionId} show ${latest.stream_id}` : undefined,
+        latestAssistant ? `pibo debug messages ${piboSessionId} show stream:${latestAssistant.stream_id} --full` : undefined,
+        `pibo debug messages ${piboSessionId} list`,
+    ].filter((command) => Boolean(command));
+}
+function buildShowNextCommands(piboSessionId, row) {
+    return [
+        `pibo debug events ${piboSessionId} show ${row.stream_id} --payload --no-truncate`,
+        row.type.includes("message") ? `pibo debug messages ${piboSessionId} show stream:${row.stream_id} --full` : undefined,
+        row.type.startsWith("tool_") ? `pibo debug tool ${piboSessionId} ${toolCallIdFromRow(row) ?? "<tool-call-id>"}` : undefined,
+    ].filter((command) => Boolean(command));
+}
+function toolCallIdFromRow(row) {
+    const payload = eventPayload(row);
+    return typeof payload.toolCallId === "string" ? payload.toolCallId : undefined;
 }
 function tableExists(db, table) {
     const row = db.prepare("SELECT name FROM sqlite_schema WHERE type = 'table' AND name = ?").get(table);
     return row !== undefined;
 }
-function parseObject(value) {
-    try {
-        const parsed = JSON.parse(value);
-        if (!parsed || typeof parsed !== "object" || Array.isArray(parsed))
-            return {};
-        return parsed;
-    }
-    catch {
-        return {};
-    }
-}
 function formatValue(value) {
     if (value === null || value === undefined)
         return "";

package/dist/debug/failures.js

@@ -0,0 +1,162 @@
+import { formatNextCommands } from "./next-commands.js";
+import { compactOneLine, eventPayload } from "./payloads.js";
+import { normalizeLimit, openReadOnlyDebugDatabase, withStorePath } from "./sql.js";
+import { inspectDebugTrace } from "./trace.js";
+export async function inspectDebugFailures(piboSessionId, stores, options = {}) {
+    const limit = normalizeLimit(options.limit);
+    const failures = [];
+    failures.push(...readToolFailures(piboSessionId, stores.chat, limit));
+    try {
+        const trace = await inspectDebugTrace(piboSessionId, stores, {});
+        for (const node of trace.nodes.filter((item) => item.status === "error"))
+            failures.push(traceFailure(piboSessionId, node));
+    }
+    catch {
+        // Trace reconstruction is best-effort for failure summaries.
+    }
+    failures.push(...readSessionFailures(piboSessionId, stores.sessions));
+    const limited = failures.length > limit;
+    const visible = failures.slice(0, limit);
+    return {
+        piboSessionId,
+        resultType: "debug.failures",
+        failures: visible,
+        limited,
+        nextCommands: [
+            visible[0]?.inspect,
+            `pibo debug trace ${piboSessionId} --check`,
+            `pibo debug events ${piboSessionId} --type tool_execution_finished --limit 20`,
+        ].filter((command) => Boolean(command)),
+    };
+}
+export function formatDebugFailures(result) {
+    const lines = [`failures: ${result.failures.length}${result.limited ? " (limited)" : ""}`];
+    result.failures.forEach((failure, index) => {
+        lines.push("");
+        if (failure.kind === "tool") {
+            lines.push(`${index + 1}. stream_id=${failure.streamId} tool=${failure.toolName ?? ""} status=${failure.status ?? "error"}`);
+            if (failure.reason)
+                lines.push(`   reason: ${failure.reason}`);
+            if (failure.preview)
+                lines.push(`   preview: ${failure.preview}`);
+            lines.push(`   inspect: ${failure.inspect}`);
+            return;
+        }
+        if (failure.kind === "trace") {
+            lines.push(`${index + 1}. trace node ${failure.nodeId} status=${failure.status}`);
+            if (failure.title)
+                lines.push(`   title: ${failure.title}`);
+            lines.push(`   inspect: ${failure.inspect}`);
+            return;
+        }
+        lines.push(`${index + 1}. session status=${failure.status}`);
+        if (failure.reason)
+            lines.push(`   reason: ${failure.reason}`);
+        lines.push(`   inspect: ${failure.inspect}`);
+    });
+    lines.push(...formatNextCommands(result.nextCommands));
+    return lines.join("\n");
+}
+function readToolFailures(piboSessionId, store, limit) {
+    if (!store.exists)
+        return [];
+    const db = openReadOnlyDebugDatabase(store);
+    try {
+        if (!tableExists(db, "event_log"))
+            return [];
+        const rows = db.prepare(`
+			SELECT stream_id, session_id, session_sequence, event_id, type, created_at, preview_text, attributes_json
+			FROM event_log
+			WHERE session_id = ? AND type = 'tool_execution_finished'
+			ORDER BY stream_id DESC
+			LIMIT ?
+		`).all(piboSessionId, limit + 1);
+        return rows.flatMap((row) => {
+            const payload = eventPayload(row);
+            const status = statusFromPayload(payload);
+            const isError = payload.isError === true || ["error", "failed", "failure"].includes(status ?? "");
+            if (!isError)
+                return [];
+            const toolCallId = typeof payload.toolCallId === "string" ? payload.toolCallId : row.event_id ?? undefined;
+            const toolName = typeof payload.toolName === "string" ? payload.toolName : row.preview_text ?? undefined;
+            const reason = failureReason(payload);
+            return [{
+                    kind: "tool",
+                    streamId: row.stream_id,
+                    type: row.type,
+                    toolCallId,
+                    toolName,
+                    status: status ?? "error",
+                    reason,
+                    preview: compactOneLine(row.preview_text ?? reason ?? ""),
+                    inspect: `pibo debug tool ${piboSessionId} ${toolCallId ?? row.stream_id} --output`,
+                }];
+        });
+    }
+    catch (error) {
+        throw withStorePath(error, store);
+    }
+    finally {
+        db.close();
+    }
+}
+function readSessionFailures(piboSessionId, store) {
+    if (!store.exists)
+        return [];
+    const db = openReadOnlyDebugDatabase(store);
+    try {
+        if (!tableExists(db, "sessions"))
+            return [];
+        const row = db.prepare("SELECT status, metadata_json FROM sessions WHERE id = ?").get(piboSessionId);
+        if (!row || row.status !== "error")
+            return [];
+        return [{ kind: "session", status: row.status, reason: row.metadata_json ?? undefined, inspect: `pibo debug session ${piboSessionId} --json` }];
+    }
+    finally {
+        db.close();
+    }
+}
+function traceFailure(piboSessionId, node) {
+    return {
+        kind: "trace",
+        nodeId: node.id,
+        status: node.status,
+        title: node.title,
+        toolCallId: node.toolCallId,
+        inspect: node.toolCallId ? `pibo debug tool ${piboSessionId} ${node.toolCallId}` : `pibo debug trace ${piboSessionId} show ${node.id}`,
+    };
+}
+function statusFromPayload(payload) {
+    const result = payload.result;
+    if (result && typeof result === "object" && !Array.isArray(result)) {
+        const record = result;
+        if (typeof record.status === "string")
+            return record.status;
+        const details = record.details;
+        if (details && typeof details === "object" && !Array.isArray(details) && typeof details.status === "string")
+            return String(details.status);
+    }
+    return payload.isError === true ? "error" : undefined;
+}
+function failureReason(payload) {
+    if (typeof payload.error === "string")
+        return payload.error;
+    const result = payload.result;
+    if (typeof result === "string")
+        return result;
+    if (result && typeof result === "object" && !Array.isArray(result)) {
+        const record = result;
+        if (typeof record.error === "string")
+            return record.error;
+        if (typeof record.message === "string")
+            return record.message;
+        const details = record.details;
+        if (details && typeof details === "object" && !Array.isArray(details) && typeof details.status === "string")
+            return String(details.status);
+    }
+    return undefined;
+}
+function tableExists(db, table) {
+    const row = db.prepare("SELECT name FROM sqlite_schema WHERE type = 'table' AND name = ?").get(table);
+    return row !== undefined;
+}