@crouton-kit/humanloop 0.3.39 → 0.4.1

package/dist/conversation/reader.js

@@ -1,348 +0,0 @@
-import { execFileSync, execSync } from 'node:child_process';
-import { existsSync, readFileSync } from 'node:fs';
-import { homedir } from 'node:os';
-import { join } from 'node:path';
-export class ConversationReadError extends Error {
-    code;
-    constructor(code) {
-        super(code);
-        this.code = code;
-        this.name = 'ConversationReadError';
-    }
-}
-const CLAUDE_DB_PATH = join(homedir(), '.claude', '__store.db');
-const MAX_SESSION_ID_LENGTH = 256;
-const piSessionIndex = new Map();
-/** Read messages from Claude's local conversation store. */
-export function readConversation(sessionId, options = {}) {
-    const claudeDbPath = options.claudeDbPath ?? CLAUDE_DB_PATH;
-    if (!existsSync(claudeDbPath))
-        throw new Error('Claude conversation store unavailable');
-    const query = `
-    SELECT bm.message_type,
-           COALESCE(um.message, am.message) AS content
-    FROM base_messages bm
-    LEFT JOIN user_messages um ON bm.uuid = um.uuid
-    LEFT JOIN assistant_messages am ON bm.uuid = am.uuid
-    WHERE bm.session_id = '${escapeSqlString(sessionId)}'
-    ORDER BY bm.timestamp ASC;
-  `;
-    const raw = runSqlite(claudeDbPath, query);
-    if (!raw.trim())
-        return [];
-    const rows = JSON.parse(raw);
-    return rows.flatMap((row) => row.content && (row.message_type === 'user' || row.message_type === 'assistant')
-        ? [{ role: row.message_type, content: row.content }]
-        : []);
-}
-/** Resolve a pi session by exact header id and return its active useful context. */
-export async function readPiConversationText(sessionId) {
-    if (sessionId.length === 0 || sessionId.length > MAX_SESSION_ID_LENGTH)
-        throw new ConversationReadError('session_not_found');
-    const pi = await import('@earendil-works/pi-coding-agent').catch(() => {
-        throw new ConversationReadError('session_unreadable');
-    });
-    const paths = await resolvePiSessionPaths(pi.SessionManager, sessionId);
-    if (paths.length === 0)
-        throw new ConversationReadError('session_not_found');
-    if (paths.length !== 1)
-        throw new ConversationReadError('session_ambiguous');
-    let entries;
-    try {
-        // parseSessionEntries is the package-root parser. Reading only the SDK-discovered
-        // path keeps an untrusted deck id from becoming a filesystem locator.
-        const raw = readFileSync(paths[0], 'utf8');
-        rejectMalformedCompleteJsonlRecords(raw);
-        entries = pi.parseSessionEntries(raw);
-    }
-    catch {
-        throw new ConversationReadError('session_unreadable');
-    }
-    const header = entries[0];
-    if (!isMatchingHeader(header, sessionId))
-        throw new ConversationReadError('session_id_mismatch');
-    if (entries.length < 2)
-        throw new ConversationReadError('conversation_empty');
-    try {
-        pi.migrateSessionEntries(entries);
-        const sessionEntries = entries.slice(1).filter((entry) => entry.type !== 'session');
-        const context = pi.buildSessionContext(sessionEntries);
-        const text = context.messages.map(serializePiMessage).filter((part) => part !== '').join('\n\n').trim();
-        if (text === '')
-            throw new ConversationReadError('conversation_empty');
-        return text;
-    }
-    catch (error) {
-        if (error instanceof ConversationReadError)
-            throw error;
-        throw new ConversationReadError('session_unreadable');
-    }
-}
-async function resolvePiSessionPaths(SessionManager, sessionId) {
-    const root = process.env.PI_CODING_AGENT_DIR ?? join(homedir(), '.pi', 'agent');
-    let index = piSessionIndex.get(root);
-    if (index === undefined) {
-        index = await buildPiSessionIndex(SessionManager);
-        piSessionIndex.set(root, index);
-    }
-    let paths = index.get(sessionId) ?? [];
-    // A popup can outlive session creation. Refresh once on a miss, then keep the
-    // process-local cache for subsequent visuals instead of rescanning every transcript.
-    if (paths.length === 0) {
-        index = await buildPiSessionIndex(SessionManager);
-        piSessionIndex.set(root, index);
-        paths = index.get(sessionId) ?? [];
-    }
-    return paths;
-}
-async function buildPiSessionIndex(SessionManager) {
-    let sessions;
-    try {
-        sessions = await SessionManager.listAll();
-    }
-    catch {
-        throw new ConversationReadError('session_unreadable');
-    }
-    const index = new Map();
-    for (const session of sessions) {
-        const paths = index.get(session.id);
-        if (paths === undefined)
-            index.set(session.id, [session.path]);
-        else
-            paths.push(session.path);
-    }
-    return index;
-}
-/** Resolve by exact membership across provider stores, never by session-id shape. */
-export async function readConversationText(sessionId, options = {}) {
-    if (sessionId.length === 0 || sessionId.length > MAX_SESSION_ID_LENGTH)
-        throw new ConversationReadError('session_not_found');
-    const claudeDbPath = options.claudeDbPath ?? CLAUDE_DB_PATH;
-    const pi = await import('@earendil-works/pi-coding-agent').catch(() => {
-        throw new ConversationReadError('session_unreadable');
-    });
-    const piPaths = await resolvePiSessionPaths(pi.SessionManager, sessionId);
-    const claudeMatches = findClaudeSessionMembership(sessionId, claudeDbPath);
-    const matches = (piPaths.length === 1 ? 1 : 0) + (claudeMatches ? 1 : 0);
-    if (piPaths.length > 1 || matches > 1)
-        throw new ConversationReadError('session_ambiguous');
-    if (matches === 0)
-        throw new ConversationReadError('session_not_found');
-    if (claudeMatches) {
-        try {
-            const text = readConversation(sessionId, { claudeDbPath }).map((message) => `${message.role}: ${message.content}`).join('\n\n').trim();
-            if (text === '')
-                throw new ConversationReadError('conversation_empty');
-            return text;
-        }
-        catch (error) {
-            if (error instanceof ConversationReadError)
-                throw error;
-            throw new ConversationReadError('session_unreadable');
-        }
-    }
-    return readPiConversationText(sessionId);
-}
-function findClaudeSessionMembership(sessionId, claudeDbPath) {
-    if (!existsSync(claudeDbPath))
-        return false;
-    try {
-        return runSqlite(claudeDbPath, `SELECT 1 AS found FROM base_messages WHERE session_id = '${escapeSqlString(sessionId)}' LIMIT 1;`).trim() !== '';
-    }
-    catch {
-        throw new ConversationReadError('session_unreadable');
-    }
-}
-function runSqlite(dbPath, query) {
-    return execFileSync('sqlite3', ['-json', dbPath, query], { encoding: 'utf8', maxBuffer: 50 * 1024 * 1024 });
-}
-function escapeSqlString(value) { return value.replace(/'/g, "''"); }
-/** Reject corrupt records while allowing only an unterminated JSON-object prefix being concurrently written. */
-function rejectMalformedCompleteJsonlRecords(raw) {
-    const lines = raw.split('\n');
-    for (const line of lines.slice(0, -1)) {
-        if (line.trim() === '')
-            continue;
-        JSON.parse(line);
-    }
-    const tail = lines.at(-1);
-    if (!raw.endsWith('\n') && tail !== '' && !isIncompleteJsonObjectPrefix(tail))
-        JSON.parse(tail);
-}
-function isIncompleteJsonObjectPrefix(source) {
-    let offset = 0;
-    const whitespace = () => { while (/\s/.test(source[offset] ?? ''))
-        offset += 1; };
-    const string = () => {
-        if (source[offset++] !== '"')
-            return 'malformed';
-        while (offset < source.length) {
-            const character = source[offset++];
-            if (character === '"')
-                return 'complete';
-            if (character < ' ')
-                return 'malformed';
-            if (character === '\\') {
-                if (offset === source.length)
-                    return 'incomplete';
-                const escape = source[offset++];
-                if (!'"\\/bfnrtu'.includes(escape))
-                    return 'malformed';
-                if (escape === 'u') {
-                    for (let count = 0; count < 4; count += 1) {
-                        if (offset === source.length)
-                            return 'incomplete';
-                        if (!/[0-9a-f]/i.test(source[offset++]))
-                            return 'malformed';
-                    }
-                }
-            }
-        }
-        return 'incomplete';
-    };
-    const value = () => {
-        whitespace();
-        const character = source[offset];
-        if (character === undefined)
-            return 'incomplete';
-        if (character === '"')
-            return string();
-        if (character === '{')
-            return object();
-        if (character === '[')
-            return array();
-        for (const literal of ['true', 'false', 'null']) {
-            if (source.slice(offset, offset + literal.length) === literal) {
-                offset += literal.length;
-                return 'complete';
-            }
-            if (literal.startsWith(source.slice(offset)))
-                return 'incomplete';
-        }
-        if (character === '-' || /[0-9]/.test(character)) {
-            const match = source.slice(offset).match(/^-?(?:0|[1-9]\d*)(?:\.\d+)?(?:[eE][+-]?\d+)?/);
-            if (match === null)
-                return character === '-' ? 'incomplete' : 'malformed';
-            offset += match[0].length;
-            return 'complete';
-        }
-        return 'malformed';
-    };
-    const object = () => {
-        offset += 1;
-        whitespace();
-        if (source[offset] === '}') {
-            offset += 1;
-            return 'complete';
-        }
-        while (true) {
-            if (offset === source.length)
-                return 'incomplete';
-            const key = string();
-            if (key !== 'complete')
-                return key;
-            whitespace();
-            if (offset === source.length)
-                return 'incomplete';
-            if (source[offset++] !== ':')
-                return 'malformed';
-            const item = value();
-            if (item !== 'complete')
-                return item;
-            whitespace();
-            if (offset === source.length)
-                return 'incomplete';
-            const separator = source[offset++];
-            if (separator === '}')
-                return 'complete';
-            if (separator !== ',')
-                return 'malformed';
-            whitespace();
-        }
-    };
-    const array = () => {
-        offset += 1;
-        whitespace();
-        if (source[offset] === ']') {
-            offset += 1;
-            return 'complete';
-        }
-        while (true) {
-            const item = value();
-            if (item !== 'complete')
-                return item;
-            whitespace();
-            if (offset === source.length)
-                return 'incomplete';
-            const separator = source[offset++];
-            if (separator === ']')
-                return 'complete';
-            if (separator !== ',')
-                return 'malformed';
-            whitespace();
-        }
-    };
-    const result = value();
-    whitespace();
-    return result === 'incomplete' && offset === source.length && source.trimStart().startsWith('{');
-}
-function isMatchingHeader(entry, sessionId) {
-    return entry?.type === 'session' && entry.id === sessionId;
-}
-function serializePiMessage(message) {
-    switch (message.role) {
-        case 'user': return labeledText('user', message.content);
-        case 'assistant': {
-            const blocks = Array.isArray(message.content) ? message.content : [];
-            const text = blocks.flatMap((block) => {
-                if (!isRecord(block))
-                    return [];
-                if (block.type === 'text' && typeof block.text === 'string')
-                    return [block.text];
-                if (block.type === 'toolCall' && typeof block.name === 'string')
-                    return [`tool call ${block.name}: ${safeJson(block.arguments)}`];
-                return [];
-            }).filter((part) => part.trim() !== '');
-            return text.length === 0 ? '' : `assistant: ${text.join('\n')}`;
-        }
-        case 'toolResult': return labeledText(`tool result${typeof message.toolName === 'string' ? ` ${message.toolName}` : ''}`, message.content);
-        case 'compactionSummary': return typeof message.summary === 'string' && message.summary.trim() !== '' ? `compaction summary: ${message.summary}` : '';
-        case 'branchSummary': return typeof message.summary === 'string' && message.summary.trim() !== '' ? `branch summary: ${message.summary}` : '';
-        default: return '';
-    }
-}
-function labeledText(label, content) {
-    const text = textFromContent(content);
-    return text === '' ? '' : `${label}: ${text}`;
-}
-function textFromContent(content) {
-    if (typeof content === 'string')
-        return content.trim();
-    if (!Array.isArray(content))
-        return '';
-    return content.flatMap((block) => isRecord(block) && block.type === 'text' && typeof block.text === 'string' ? [block.text] : []).join('\n').trim();
-}
-function safeJson(value) {
-    try {
-        return JSON.stringify(value);
-    }
-    catch {
-        return '[unserializable arguments]';
-    }
-}
-function isRecord(value) { return typeof value === 'object' && value !== null; }
-export function findRecentSessionId(cwd) {
-    if (!existsSync(CLAUDE_DB_PATH))
-        return null;
-    const whereClause = cwd ? `WHERE cwd = '${cwd.replace(/'/g, "''")}'` : '';
-    const query = `SELECT DISTINCT session_id FROM base_messages ${whereClause} ORDER BY timestamp DESC LIMIT 1;`;
-    try {
-        const raw = execSync(`sqlite3 -json "${CLAUDE_DB_PATH}" "${query.replace(/"/g, '\\"')}"`, { encoding: 'utf8' });
-        if (!raw.trim())
-            return null;
-        return JSON.parse(raw)[0]?.session_id ?? null;
-    }
-    catch {
-        return null;
-    }
-}

package/dist/visuals/conversation.d.ts

@@ -1,7 +0,0 @@
-import type { GenerateVisual, Interaction } from '../types.js';
-import { defaultGenerateVisual } from './generate.js';
-type VisualGenerator = (interaction: Interaction, conversationContext: string, cols?: number) => ReturnType<typeof defaultGenerateVisual>;
-type ConversationTextReader = (sessionId: string) => Promise<string>;
-/** Build the standard visual generator from explicit originating-session metadata. */
-export declare function visualGeneratorForConversationSession(sessionId: string, generateVisual?: VisualGenerator, readContext?: ConversationTextReader): GenerateVisual;
-export {};

package/dist/visuals/conversation.js

@@ -1,16 +0,0 @@
-import { readConversationText } from '../conversation/reader.js';
-import { defaultGenerateVisual } from './generate.js';
-/** Build the standard visual generator from explicit originating-session metadata. */
-export function visualGeneratorForConversationSession(sessionId, generateVisual = defaultGenerateVisual, readContext = readConversationText) {
-    // One lookup feeds every interaction and resize regeneration in this mounted panel.
-    // A failed lookup remains a failed visual rather than falling through to a generic prompt.
-    const context = readContext(sessionId);
-    return async (interaction, cols) => {
-        try {
-            return await generateVisual(interaction, await context, cols);
-        }
-        catch {
-            return { ok: false, error: 'visual context unavailable' };
-        }
-    };
-}

package/dist/visuals/generate.d.ts

@@ -1,11 +0,0 @@
-import type { Interaction } from '../types.js';
-/** Width shared by model-time and local resize-time visual rendering. */
-export declare function visualRenderWidth(cols: number): number;
-export declare function defaultGenerateVisual(interaction: Interaction, conversationContext: string, cols?: number): Promise<{
-    ok: true;
-    ansi: string;
-    markdown: string;
-} | {
-    ok: false;
-    error: string;
-}>;

package/dist/visuals/generate.js

@@ -1,81 +0,0 @@
-import { query } from '@r-cli/sdk';
-import { renderMarkdown } from '../render/termrender.js';
-const VISUAL_SYSTEM_PROMPT = `You are re-grounding a decision-maker in the moment before they answer the question below. They were deep in this problem but got pulled away; in the next 20 seconds they need to remember *what is actually in play* — the current state, the files, the constraint this decision lives inside — so the question stops feeling cold and they can answer with confidence.
-
-Write from the conversation history you're given. Lead with what *is*: the real files, functions, data, and constraints that ground this decision, named concretely (as \`path/to/file.ts:123\` so they can jump straight there). Reconstruct just enough of how they arrived here to make the question legible — no more.
-
-Keep it tight: usually a short paragraph or a few bullets, 30 lines hard cap. Say less when less is true. Choose whatever shape carries the meaning fastest — prose by default, a list when enumerating, a table only to compare several things across the same dimensions, a small diagram when the structure itself is the point. You're trusted to pick; don't force a format.
-
-The one rule that matters: **only reference files, identifiers, and facts that actually appear in the conversation.** Never invent a plausible-looking path or name. If the conversation is thin, write a short honest briefing about what little is grounded — that beats confident fabrication every time.
-
-And stay in your lane: don't restate the question, don't recommend an option or tell them how to decide, don't lay out tradeoffs or sketch alternatives. They own the decision; you only reconstruct the ground it stands on.
-
-Formatting: plain markdown renders (**bold**, *italic*, \`code\`, bullets, and GFM tables). These termrender directives are available if one genuinely helps — anything you draw with box-drawing/ASCII must sit inside a :::panel or it will be reflowed and destroyed:
-  :::panel{title="T" color="cyan"}                bordered box (red|green|yellow|blue|magenta|cyan|white|gray)
-  :::tree{color="c"}                              indented hierarchy (2-space indent = nesting)
-  :::callout{type="info|warning|error|success"}   status callout
-  ::::columns / :::col{width="50%"}               side-by-side (outer fence needs strictly more colons)
-Never wrap the whole output in a code fence.`;
-async function callHaiku(prompt, systemPrompt) {
-    try {
-        const session = await query({
-            prompt,
-            options: {
-                model: 'haiku',
-                maxTurns: 1,
-                systemPrompt,
-            },
-        });
-        let text = '';
-        for await (const msg of session) {
-            if (msg.type === 'assistant' && msg.message?.content) {
-                for (const block of msg.message.content) {
-                    if (block.type === 'text')
-                        text += block.text;
-                }
-            }
-        }
-        return text.trim() || null;
-    }
-    catch (err) {
-        process.stderr.write(`[hl] Haiku call failed: ${err instanceof Error ? err.message : err}\n`);
-        return null;
-    }
-}
-// The mounting surface supplies its actual render width; generated ANSI must
-// fit an embedded panel just as it fits a standalone terminal.
-// Cap on how much conversation we hand the generator. Recency is what grounds
-// the decision in front of the human, so when history is long we keep the tail
-// (most recent messages) rather than the head.
-const MAX_CONTEXT_CHARS = 24000;
-/** Width shared by model-time and local resize-time visual rendering. */
-export function visualRenderWidth(cols) {
-    return Math.max(1, Math.min(cols - 4, 76));
-}
-export async function defaultGenerateVisual(interaction, conversationContext, cols = (process.stdout.columns || 80)) {
-    const width = visualRenderWidth(cols);
-    const optionsSummary = interaction.options.length > 0
-        ? `\nOptions: ${interaction.options.map((o) => o.label).join(' | ')}`
-        : '';
-    const subtitleLine = interaction.subtitle ? `\nContext: ${interaction.subtitle}` : '';
-    // The body is the richest statement of what's being asked — hand it to the
-    // generator so the briefing grounds in the actual question, not just its title.
-    const bodyLine = interaction.body ? `\nDetail:\n${interaction.body}` : '';
-    const questionText = `Title: "${interaction.title}"${subtitleLine}${bodyLine}${optionsSummary}`;
-    const trimmedContext = conversationContext.length > MAX_CONTEXT_CHARS
-        ? `…(earlier conversation trimmed)…\n\n${conversationContext.slice(-MAX_CONTEXT_CHARS)}`
-        : conversationContext;
-    const prompt = trimmedContext
-        ? `Here is the conversation so far:\n\n${trimmedContext}\n\n---\n\nThe human is about to answer this decision. Re-ground them in what's in play:\n\n${questionText}`
-        : `The human is about to answer this decision. Re-ground them in what's in play:\n\n${questionText}`;
-    const result = await callHaiku(prompt, VISUAL_SYSTEM_PROMPT);
-    if (result) {
-        const markdown = result
-            .replace(/^```[\w]*\n?/gm, '')
-            .replace(/^```\s*$/gm, '')
-            .trim();
-        const ansi = renderMarkdown(markdown, width).join('\n');
-        return { ok: true, ansi, markdown };
-    }
-    return { ok: false, error: 'haiku returned no output' };
-}