@secondcontext/btx-cli 0.0.2 → 0.0.5

package/dist/messages.js

@@ -0,0 +1,112 @@
+import { projectApiGet, projectApiPost } from './api.js';
+function normalizeMatchValue(value) {
+    return value?.trim().toLowerCase() ?? '';
+}
+function formatMember(member) {
+    const name = member.name?.trim();
+    const email = member.email?.trim();
+    if (name && email)
+        return `${name} <${email}> [${member.userId}]`;
+    if (name)
+        return `${name} [${member.userId}]`;
+    if (email)
+        return `${email} [${member.userId}]`;
+    return member.userId;
+}
+function formatConversation(conversation) {
+    return `${conversation.name} [${conversation.id}]`;
+}
+function resolveUniqueMatch(query, items, selectors, render, itemLabel, listCommand) {
+    const normalizedQuery = normalizeMatchValue(query);
+    if (!normalizedQuery) {
+        throw new Error(`Provide a ${itemLabel} value.`);
+    }
+    const exactMatches = items.filter((item) => selectors.some((selector) => normalizeMatchValue(selector(item)) === normalizedQuery));
+    if (exactMatches.length === 1)
+        return exactMatches[0];
+    if (exactMatches.length > 1) {
+        throw new Error(`Multiple ${itemLabel}s match "${query}". Narrow the query or inspect ${listCommand}:\n${exactMatches
+            .map((item) => `  ${render(item)}`)
+            .join('\n')}`);
+    }
+    const partialMatches = items.filter((item) => selectors.some((selector) => normalizeMatchValue(selector(item)).includes(normalizedQuery)));
+    if (partialMatches.length === 1)
+        return partialMatches[0];
+    if (partialMatches.length > 1) {
+        throw new Error(`Multiple ${itemLabel}s match "${query}". Narrow the query or inspect ${listCommand}:\n${partialMatches
+            .map((item) => `  ${render(item)}`)
+            .join('\n')}`);
+    }
+    throw new Error(`No ${itemLabel} matched "${query}". Run \`${listCommand}\` to inspect valid targets.`);
+}
+function formatScopeLabel(kind, label) {
+    switch (kind) {
+        case 'team':
+            return 'Team chat';
+        case 'dm':
+            return `Direct message with ${label}`;
+        case 'conversation':
+            return `Conversation: ${label}`;
+    }
+}
+export async function listProjectMembers(env) {
+    return projectApiGet(env, '/members');
+}
+export async function listChatConversations(env) {
+    return projectApiGet(env, '/chat/conversations');
+}
+export async function resolveMessageScope(env, flags) {
+    if (flags.peer && flags.conversation) {
+        throw new Error('Use either `--peer` or `--conversation`, not both.');
+    }
+    if (flags.peer) {
+        const members = await listProjectMembers(env);
+        const peer = resolveUniqueMatch(flags.peer, members, [
+            (member) => member.userId,
+            (member) => member.id,
+            (member) => member.email,
+            (member) => member.name,
+        ], formatMember, 'member', 'btx messages members');
+        return {
+            kind: 'dm',
+            label: formatScopeLabel('dm', formatMember(peer)),
+            peer,
+            requestQuery: { peer: peer.userId },
+            sendPayload: { recipientId: peer.userId },
+        };
+    }
+    if (flags.conversation) {
+        const { conversations } = await listChatConversations(env);
+        const conversation = resolveUniqueMatch(flags.conversation, conversations, [(item) => item.id, (item) => item.name], formatConversation, 'conversation', 'btx messages conversations');
+        return {
+            kind: 'conversation',
+            label: formatScopeLabel('conversation', formatConversation(conversation)),
+            conversation,
+            requestQuery: { conversation: conversation.id },
+            sendPayload: { conversationId: conversation.id },
+        };
+    }
+    return {
+        kind: 'team',
+        label: formatScopeLabel('team', 'Team chat'),
+        requestQuery: {},
+        sendPayload: {},
+    };
+}
+export async function listChatMessages(env, scope, options) {
+    const params = new URLSearchParams(scope.requestQuery);
+    if (options.before)
+        params.set('before', options.before);
+    if (typeof options.limit === 'number')
+        params.set('limit', String(options.limit));
+    const suffix = params.toString();
+    return projectApiGet(env, `/chat${suffix ? `?${suffix}` : ''}`);
+}
+export async function sendChatMessage(env, scope, input) {
+    return projectApiPost(env, '/chat', {
+        body: input.body,
+        replyToId: input.replyToId ?? null,
+        ...scope.sendPayload,
+    });
+}
+//# sourceMappingURL=messages.js.map

package/dist/messages.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"messages.js","sourceRoot":"","sources":["../src/messages.ts"],"names":[],"mappings":"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"}

package/dist/runtime-cli.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"runtime-cli.d.ts","sourceRoot":"","sources":["../src/runtime-cli.ts"],"names":[],"mappings":"AAoLA,MAAM,WAAW,aAAa;IAC5B,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAC1B,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,qBAAqB,CAAC,EAAE,MAAM,CAAA;IAC9B,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,eAAe,CAAC,EAAE,MAAM,CAAA;CACzB;AA6hED,wBAAsB,aAAa,CACjC,IAAI,EAAE,MAAM,EAAE,EACd,GAAG,GAAE,aAA2B,GAC/B,OAAO,CAAC,IAAI,CAAC,CA0Qf"}
+{"version":3,"file":"runtime-cli.d.ts","sourceRoot":"","sources":["../src/runtime-cli.ts"],"names":[],"mappings":"AAmNA,MAAM,WAAW,aAAa;IAC5B,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAC1B,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,qBAAqB,CAAC,EAAE,MAAM,CAAA;IAC9B,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,eAAe,CAAC,EAAE,MAAM,CAAA;CACzB;AAgvED,wBAAsB,aAAa,CACjC,IAAI,EAAE,MAAM,EAAE,EACd,GAAG,GAAE,aAA2B,GAC/B,OAAO,CAAC,IAAI,CAAC,CAiRf"}

package/dist/runtime-cli.js

@@ -138,6 +138,15 @@ function isJson(flags) {
 function printJson(value) {
     process.stdout.write(`${JSON.stringify(value, null, 2)}\n`);
 }
+function readIntFlag(flags, key, defaultValue, min = 1, max = 200) {
+    const raw = flags[key];
+    if (!raw)
+        return defaultValue;
+    const parsed = Number.parseInt(raw, 10);
+    if (!Number.isFinite(parsed))
+        return defaultValue;
+    return Math.max(min, Math.min(max, parsed));
+}
 // ── Formatting ──────────────────────────────────────────────────────────────
 function truncate(str, max) {
     if (!str)
@@ -356,6 +365,94 @@ function formatMeetingTranscript(m) {
         console.log(`[${time}] ${speaker}: ${seg.text}`);
     }
 }
+function sessionPayload(s) {
+    return JSON.stringify({
+        sessionId: s.sessionId,
+        label: s.label,
+        sessionType: s.sessionType,
+        runtime: s.runtime || null,
+        status: s.status,
+        messageCount: s.messageCount ?? 0,
+        activityCount: s.activityCount ?? 0,
+        summary: s.summary ?? null,
+        lastActivityType: s.lastActivityType ?? null,
+        lastActivityContent: s.lastActivityContent ?? null,
+        createdAt: typeof s.createdAt === 'number'
+            ? new Date(s.createdAt).toISOString()
+            : s.createdAt,
+    });
+}
+function sessionPreview(session) {
+    return session.summary || session.lastActivityContent || '';
+}
+function formatSessionTable(sessions) {
+    if (sessions.length === 0) {
+        console.log('No sessions found.');
+        return;
+    }
+    const idW = 12;
+    const dateW = 10;
+    const statusW = 8;
+    const typeW = 14;
+    const runtimeW = 12;
+    const labelW = 28;
+    console.log(`${padRight('ID', idW)}  ${padRight('Date', dateW)}  ${padRight('Status', statusW)}  ${padRight('Type', typeW)}  ${padRight('Runtime', runtimeW)}  ${padRight('Label', labelW)}  Preview`);
+    console.log(`${'\u2500'.repeat(idW)}  ${'\u2500'.repeat(dateW)}  ${'\u2500'.repeat(statusW)}  ${'\u2500'.repeat(typeW)}  ${'\u2500'.repeat(runtimeW)}  ${'\u2500'.repeat(labelW)}  ${'\u2500'.repeat(36)}`);
+    for (const session of sessions) {
+        const created = new Date(session.createdAt).toISOString().slice(0, 10);
+        console.log(`${padRight(truncate(session.sessionId, idW), idW)}  ${padRight(created, dateW)}  ${padRight(session.status, statusW)}  ${padRight(truncate(session.sessionType, typeW), typeW)}  ${padRight(truncate(session.runtime || '', runtimeW), runtimeW)}  ${padRight(truncate(session.label, labelW), labelW)}  ${truncate(sessionPreview(session), 44)}`);
+    }
+    console.log(`\n${sessions.length} session${sessions.length !== 1 ? 's' : ''} found`);
+    console.log('Use `btx sessions get <session-id>` for full details and recent checkpoints.');
+    for (const session of sessions) {
+        console.log(`BTX_SESSION_JSON: ${sessionPayload(session)}`);
+    }
+}
+function formatSessionDetail(session, activities) {
+    console.log(`Session: ${session.label}`);
+    console.log(`ID:            ${session.sessionId}`);
+    console.log(`Status:        ${session.status}`);
+    console.log(`Type:          ${session.sessionType}`);
+    console.log(`Runtime:       ${session.runtime || 'n/a'}`);
+    console.log(`Execution:     ${session.executionMode}`);
+    console.log(`Started:       ${new Date(session.createdAt).toISOString()}`);
+    if (session.updatedAt)
+        console.log(`Updated:       ${new Date(session.updatedAt).toISOString()}`);
+    if (session.closedAt)
+        console.log(`Closed:        ${session.closedAt}`);
+    if (session.userName || session.userEmail) {
+        console.log(`Owner:         ${session.userName || session.userEmail}`);
+    }
+    console.log(`Messages:      ${session.messageCount ?? 0}`);
+    console.log(`Activities:    ${session.activityCount ?? 0}`);
+    if (session.totalCostUsd != null)
+        console.log(`Cost USD:      ${session.totalCostUsd}`);
+    if (session.lastActivityType)
+        console.log(`Last activity: ${session.lastActivityType}`);
+    if (session.lastActivityAt)
+        console.log(`Last updated:  ${session.lastActivityAt}`);
+    if (session.summary) {
+        console.log(`\nSummary:\n  ${session.summary.replace(/\n/g, '\n  ')}`);
+    }
+    if (session.lastActivityContent && session.lastActivityContent !== session.summary) {
+        console.log(`\nLatest checkpoint:\n  ${session.lastActivityContent.replace(/\n/g, '\n  ')}`);
+    }
+    if (activities.length > 0) {
+        console.log('\nRecent activity:');
+        for (const activity of activities) {
+            const date = new Date(activity.createdAt ?? Date.now()).toISOString();
+            const actor = activity.actorName || activity.actorEmail || 'Unknown';
+            const content = activity.content || '';
+            console.log(`  [${date}] ${activity.type} (${actor})`);
+            if (content)
+                console.log(`    ${content.replace(/\n/g, '\n    ')}`);
+        }
+    }
+    else {
+        console.log('\nNo session activity found.');
+    }
+    console.log(`\nBTX_SESSION_JSON: ${sessionPayload(session)}`);
+}
 // ── Help ─────────────────────────────────────────────────────────────────────
 const HELP = {
     top: `BTX CLI - manage tasks, contacts, meetings, and leads from a session.
@@ -366,7 +463,7 @@ Usage:
 
 Resources:
   tasks        Create and manage project tasks
-  sessions     Add and list notes for a session
+  sessions     Browse recent sessions, inspect summaries, add notes
   contacts     View and update contacts, add notes
   orgs         View organizations, add notes
   meetings     View meeting recordings and transcripts
@@ -417,16 +514,24 @@ Examples:
   node "$BTX_CLI_PATH" tasks complete abc123
   node "$BTX_CLI_PATH" tasks notes list abc123
   node "$BTX_CLI_PATH" tasks notes add abc123 --content "Insight: ICP may be wrong on stage" --source "https://..."`,
-    sessions: `BTX sessions - add and list notes for a session.
+    sessions: `BTX sessions - browse recent sessions and inspect a session's checkpoints.
 
 Commands:
+  list                                    List recent sessions (metadata only)
+  get        <session-id>                 Get one session with recent checkpoints
   notes list <session-id>                  List notes for a session
   notes add  <session-id> --content "..."  Add a note to a session
 
 Flags:
+  sessions list       [--status open|closed] [--type <session-type>] [--runtime <runtime>] [--query "text"] [--limit <n>]
+  sessions get        <session-id> [--activity-limit <n>]
   sessions notes add  <session-id> --content "Label: value" [--source "https://..."]
 
 Examples:
+  node "$BTX_CLI_PATH" sessions list --limit 10
+  node "$BTX_CLI_PATH" sessions list --status closed --query "auth"
+  node "$BTX_CLI_PATH" sessions get abc-session-id
+  node "$BTX_CLI_PATH" sessions get abc-session-id --activity-limit 10
   node "$BTX_CLI_PATH" sessions notes list abc-session-id
   node "$BTX_CLI_PATH" sessions notes add abc-session-id --content "Insight: market timing is critical"
   node "$BTX_CLI_PATH" sessions notes add abc-session-id --content "Decision: pivot to enterprise" --source "https://..."`,
@@ -1144,6 +1249,69 @@ async function taskNotesList(taskId, flags) {
     }
 }
 // ── Session notes commands ────────────────────────────────────────────────────
+async function fetchSessions(flags) {
+    const params = new URLSearchParams();
+    if (flags.status)
+        params.set('status', flags.status);
+    if (flags.type)
+        params.set('session_type', flags.type);
+    params.set('limit', String(readIntFlag(flags, 'limit', 20)));
+    const suffix = params.toString();
+    const result = await api('GET', `/sessions${suffix ? `?${suffix}` : ''}`);
+    let sessions = result.sessions ?? [];
+    if (flags.runtime) {
+        const runtime = flags.runtime.toLowerCase();
+        sessions = sessions.filter((session) => (session.runtime || '').toLowerCase().includes(runtime));
+    }
+    if (flags.query) {
+        const query = flags.query.toLowerCase();
+        sessions = sessions.filter((session) => {
+            const haystack = [
+                session.label,
+                session.summary,
+                session.lastActivityContent,
+                session.sessionType,
+                session.runtime,
+                session.userName,
+                session.userEmail,
+            ]
+                .filter(Boolean)
+                .join('\n')
+                .toLowerCase();
+            return haystack.includes(query);
+        });
+    }
+    return sessions;
+}
+async function fetchSession(sessionId) {
+    const result = await api('GET', `/sessions?sessionId=${encodeURIComponent(sessionId)}`);
+    return result.session ?? null;
+}
+async function fetchSessionActivities(sessionId, limit) {
+    const result = await api('GET', `/session-activities?sessionId=${encodeURIComponent(sessionId)}&limit=${limit}`);
+    return Array.isArray(result) ? result : [];
+}
+async function sessionsList(flags) {
+    const sessions = await fetchSessions(flags);
+    if (isJson(flags)) {
+        printJson(sessions);
+        return;
+    }
+    formatSessionTable(sessions);
+}
+async function sessionsGet(sessionId, flags) {
+    if (!sessionId)
+        die('Usage: btx sessions get <session-id> [--activity-limit <n>]');
+    const session = await fetchSession(sessionId);
+    if (!session)
+        die(`Session not found: ${sessionId}`);
+    const activities = await fetchSessionActivities(sessionId, readIntFlag(flags, 'activity-limit', 10, 1, 50));
+    if (isJson(flags)) {
+        printJson({ session, activities });
+        return;
+    }
+    formatSessionDetail(session, activities);
+}
 async function sessionNotesAdd(sessionId, flags) {
     if (!sessionId)
         die('Usage: btx sessions notes add <session-id> --content "..."');
@@ -1328,11 +1496,13 @@ async function globalSearch(flags) {
     }
     if (matches.length === 0) {
         console.log(`No tasks found matching "${query}".`);
-        console.log('\nTo search coding sessions, use Cmd+Shift+F in the BTX app.');
+        console.log('\nFor recent coding context, use `node "$BTX_CLI_PATH" sessions list --limit 10`.');
+        console.log('For full-text transcript search, use Cmd+Shift+F in the BTX app.');
         return;
     }
     formatTaskTable(matches);
-    console.log('\nTo search coding sessions, use Cmd+Shift+F in the BTX app.');
+    console.log('\nFor recent coding context, use `node "$BTX_CLI_PATH" sessions list --limit 10`.');
+    console.log('For full-text transcript search, use Cmd+Shift+F in the BTX app.');
 }
 // ── User profile notes commands ───────────────────────────────────────────────
 async function userNotesAdd(flags) {
@@ -1923,7 +2093,14 @@ export async function runRuntimeCli(args, env = process.env) {
                     die(`Unknown sessions notes command: "${subCommand || '(none)'}". Run: node "$BTX_CLI_PATH" sessions --help`);
             }
         }
-        die(`Unknown sessions command: "${command || '(none)'}". Run: node "$BTX_CLI_PATH" sessions --help`);
+        switch (command) {
+            case 'list':
+                return sessionsList(flags);
+            case 'get':
+                return sessionsGet(positional[2], flags);
+            default:
+                die(`Unknown sessions command: "${command || '(none)'}". Run: node "$BTX_CLI_PATH" sessions --help`);
+        }
     }
     else if (resource === 'contacts') {
         if (command === 'notes') {