@secondcontext/btx-cli 0.0.3 → 0.0.6

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":"AAiPA,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;AA48ED,wBAAsB,aAAa,CACjC,IAAI,EAAE,MAAM,EAAE,EACd,GAAG,GAAE,aAA2B,GAC/B,OAAO,CAAC,IAAI,CAAC,CA+Rf"}

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,9 +365,198 @@ function formatMeetingTranscript(m) {
         console.log(`[${time}] ${speaker}: ${seg.text}`);
     }
 }
+function recordingTitle(recording) {
+    return (recording.meetingTitle?.trim() ||
+        recording.originalFilename?.trim() ||
+        'Untitled recording');
+}
+function recordingTimestamp(recording) {
+    return recording.meetingDate || recording.uploadedAt || recording.transcribedAt || recording.createdAt || null;
+}
+function formatRecordingDuration(durationMs) {
+    if (!durationMs || durationMs <= 0)
+        return '';
+    const totalSeconds = Math.max(0, Math.floor(durationMs / 1000));
+    const minutes = Math.floor(totalSeconds / 60);
+    const seconds = totalSeconds % 60;
+    const hours = Math.floor(minutes / 60);
+    if (hours > 0) {
+        return `${hours}:${String(minutes % 60).padStart(2, '0')}:${String(seconds).padStart(2, '0')}`;
+    }
+    return `${minutes}:${String(seconds).padStart(2, '0')}`;
+}
+function formatRecordingTable(recordings) {
+    if (recordings.length === 0) {
+        console.log('No recordings found.');
+        return;
+    }
+    const idW = 10;
+    const dateW = 12;
+    const statusW = 12;
+    const sourceW = 12;
+    const durationW = 8;
+    console.log(`${padRight('ID', idW)}  ${padRight('Date', dateW)}  ${padRight('Status', statusW)}  ${padRight('Source', sourceW)}  ${padRight('Dur', durationW)}  Title`);
+    console.log(`${'\u2500'.repeat(idW)}  ${'\u2500'.repeat(dateW)}  ${'\u2500'.repeat(statusW)}  ${'\u2500'.repeat(sourceW)}  ${'\u2500'.repeat(durationW)}  ${'\u2500'.repeat(40)}`);
+    for (const recording of recordings) {
+        const date = recordingTimestamp(recording)
+            ? new Date(recordingTimestamp(recording)).toISOString().slice(0, 10)
+            : '';
+        console.log(`${padRight(truncate(recording.id, idW), idW)}  ${padRight(date, dateW)}  ${padRight(truncate(recording.status || '', statusW), statusW)}  ${padRight(truncate(recording.source || '', sourceW), sourceW)}  ${padRight(formatRecordingDuration(recording.durationMs), durationW)}  ${truncate(recordingTitle(recording), 52)}`);
+    }
+    console.log(`\n${recordings.length} recording${recordings.length !== 1 ? 's' : ''} found`);
+}
+function formatRecordingDetail(recording) {
+    console.log(`Recording: ${recordingTitle(recording)}`);
+    console.log(`ID:          ${recording.id}`);
+    if (recording.meetingId)
+        console.log(`Meeting ID:   ${recording.meetingId}`);
+    if (recordingTimestamp(recording)) {
+        console.log(`Date:        ${new Date(recordingTimestamp(recording)).toISOString().slice(0, 10)}`);
+    }
+    if (recording.source)
+        console.log(`Source:      ${recording.source}`);
+    if (recording.status)
+        console.log(`Status:      ${recording.status}`);
+    if (recording.kind)
+        console.log(`Kind:        ${recording.kind}`);
+    if (recording.captureMode)
+        console.log(`Capture:     ${recording.captureMode}`);
+    if (recording.languageHint) {
+        const detected = recording.detectedLanguage ? ` (detected ${recording.detectedLanguage})` : '';
+        console.log(`Language:    ${recording.languageHint}${detected}`);
+    }
+    if (recording.durationMs)
+        console.log(`Duration:    ${formatRecordingDuration(recording.durationMs)}`);
+    if (recording.originalFilename)
+        console.log(`Filename:    ${recording.originalFilename}`);
+    if (recording.mimeType)
+        console.log(`MIME:        ${recording.mimeType}`);
+    if (recording.error)
+        console.log(`Error:       ${recording.error}`);
+    if (recording.transcriptText?.trim()) {
+        console.log(`\nTranscript Preview:\n  ${recording.transcriptText.trim().replace(/\n/g, '\n  ')}`);
+    }
+}
+function recordingSpeakerLabel(source) {
+    const normalized = source?.trim();
+    if (!normalized)
+        return 'Speaker';
+    return normalized.replace(/[_-]+/g, ' ');
+}
+function formatRecordingTranscript(recording) {
+    const transcript = recording.transcript ?? [];
+    const transcriptText = recording.transcriptText?.trim() ?? '';
+    if (transcript.length === 0 && !transcriptText) {
+        console.log('No transcript available for this recording.');
+        return;
+    }
+    console.log(`Transcript: ${recordingTitle(recording)}`);
+    if (recordingTimestamp(recording)) {
+        console.log(`Date: ${new Date(recordingTimestamp(recording)).toISOString().slice(0, 10)}`);
+    }
+    if (transcript.length > 0) {
+        console.log(`Segments: ${transcript.length}`);
+        console.log('');
+        for (const segment of transcript) {
+            const time = segment.start_time || '';
+            console.log(`[${time}] ${recordingSpeakerLabel(segment.speaker?.source)}: ${segment.text}`);
+        }
+        return;
+    }
+    console.log('');
+    console.log(transcriptText);
+}
+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.
+    top: `BTX CLI - manage tasks, contacts, meetings, recordings, and leads from a session.
 
 Usage:
   node "$BTX_CLI_PATH" <resource> <command> [flags]
@@ -366,10 +564,11 @@ 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
+  recordings   View recording imports and transcripts
   leads        List lead types
   user         Manage your profile notes
   intro-paths  Find warm intro paths in your network
@@ -380,8 +579,10 @@ Resources:
 Examples:
   node "$BTX_CLI_PATH" tasks list --status todo
   node "$BTX_CLI_PATH" tasks list --json
+  node "$BTX_CLI_PATH" recordings list --days 7
+  node "$BTX_CLI_PATH" recordings transcript <recording-id>
   node "$BTX_CLI_PATH" meetings list --days 7
-  node "$BTX_CLI_PATH" meetings get <meeting-id> --transcript
+  node "$BTX_CLI_PATH" meetings transcript <meeting-id>
   node "$BTX_CLI_PATH" contacts --help
 
 All resource commands support --json for machine-readable output.`,
@@ -417,16 +618,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://..."`,
@@ -547,6 +756,27 @@ Examples:
   node "$BTX_CLI_PATH" meetings list --query "onboarding"
   node "$BTX_CLI_PATH" meetings get abc123
   node "$BTX_CLI_PATH" meetings transcript abc123`,
+    recordings: `BTX recordings - view synced recordings and transcripts.
+
+Commands:
+  list         List recordings (filterable by date, source, status)
+  get          Get recording details
+  transcript   Get the full transcript for a recording
+
+Flags:
+  recordings list        [--days <n>] [--query "text"] [--status <status>] [--source <source>]
+  recordings get         <recording-id>
+  recordings transcript  <recording-id>
+
+The --days flag filters to recordings from the last N days (default: all).
+Use "list" to browse imported or uploaded recordings, "get" for metadata,
+and "transcript" for the transcript text coding agents can consume directly.
+
+Examples:
+  node "$BTX_CLI_PATH" recordings list
+  node "$BTX_CLI_PATH" recordings list --days 7
+  node "$BTX_CLI_PATH" recordings list --source granola
+  node "$BTX_CLI_PATH" recordings transcript abc123`,
     context: `BTX context - fetch the current project business context.
 
 Commands:
@@ -1144,6 +1374,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/${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 +1621,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) {
@@ -1796,6 +2091,10 @@ async function fetchMeetings() {
     const result = await api('GET', '/meetings');
     return result?.meetings ?? [];
 }
+async function fetchRecordings() {
+    const result = await api('GET', '/recordings');
+    return result?.recordings ?? [];
+}
 async function meetingsList(flags) {
     let meetings = await fetchMeetings();
     if (flags.days) {
@@ -1842,6 +2141,71 @@ async function meetingsTranscript(id, flags) {
     }
     formatMeetingTranscript(meeting);
 }
+async function recordingsList(flags) {
+    let recordings = await fetchRecordings();
+    if (flags.days) {
+        const cutoff = new Date();
+        cutoff.setDate(cutoff.getDate() - Number(flags.days));
+        const cutoffStr = cutoff.toISOString();
+        recordings = recordings.filter((recording) => {
+            const timestamp = recordingTimestamp(recording);
+            return timestamp != null && timestamp >= cutoffStr;
+        });
+    }
+    if (flags.status) {
+        const expected = flags.status.toLowerCase();
+        recordings = recordings.filter((recording) => (recording.status || '').toLowerCase() === expected);
+    }
+    if (flags.source) {
+        const expected = flags.source.toLowerCase();
+        recordings = recordings.filter((recording) => (recording.source || '').toLowerCase() === expected);
+    }
+    if (flags.query) {
+        const q = flags.query.toLowerCase();
+        recordings = recordings.filter((recording) => recordingTitle(recording).toLowerCase().includes(q) ||
+            (recording.originalFilename || '').toLowerCase().includes(q) ||
+            (recording.transcriptText || '').toLowerCase().includes(q) ||
+            (recording.source || '').toLowerCase().includes(q) ||
+            (recording.status || '').toLowerCase().includes(q));
+    }
+    if (isJson(flags)) {
+        printJson(recordings);
+        return;
+    }
+    formatRecordingTable(recordings);
+}
+async function recordingsGet(id, flags) {
+    if (!id)
+        die('Usage: btx recordings get <recording-id>');
+    const recordings = await fetchRecordings();
+    const recording = recordings.find((item) => item.id === id);
+    if (!recording)
+        die(`Recording not found: ${id}`);
+    if (isJson(flags)) {
+        printJson(recording);
+        return;
+    }
+    formatRecordingDetail(recording);
+}
+async function recordingsTranscript(id, flags) {
+    if (!id)
+        die('Usage: btx recordings transcript <recording-id>');
+    const recordings = await fetchRecordings();
+    const recording = recordings.find((item) => item.id === id);
+    if (!recording)
+        die(`Recording not found: ${id}`);
+    if (isJson(flags)) {
+        printJson({
+            id: recording.id,
+            meetingId: recording.meetingId ?? null,
+            title: recordingTitle(recording),
+            transcriptText: recording.transcriptText ?? '',
+            transcript: recording.transcript ?? [],
+        });
+        return;
+    }
+    formatRecordingTranscript(recording);
+}
 // ── Main ────────────────────────────────────────────────────────────────────
 export async function runRuntimeCli(args, env = process.env) {
     configureRuntime(env);
@@ -1862,6 +2226,7 @@ export async function runRuntimeCli(args, env = process.env) {
             'contacts',
             'orgs',
             'meetings',
+            'recordings',
             'leads',
             'user',
             'intro-paths',
@@ -1923,7 +2288,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') {
@@ -1997,6 +2369,18 @@ export async function runRuntimeCli(args, env = process.env) {
                 die(`Unknown meetings command: "${command || '(none)'}". Run: node "$BTX_CLI_PATH" meetings --help`);
         }
     }
+    else if (resource === 'recordings') {
+        switch (command) {
+            case 'list':
+                return recordingsList(flags);
+            case 'get':
+                return recordingsGet(positional[2], flags);
+            case 'transcript':
+                return recordingsTranscript(positional[2], flags);
+            default:
+                die(`Unknown recordings command: "${command || '(none)'}". Run: node "$BTX_CLI_PATH" recordings --help`);
+        }
+    }
     else if (resource === 'intro-paths') {
         switch (command) {
             case 'find':