@circleback/cli 0.1.0

package/dist/helpers/table.js

@@ -0,0 +1,211 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.formatEmails = exports.formatSupportArticles = exports.formatDomains = exports.formatProfiles = exports.formatCalendarEvents = exports.formatTranscriptSearchResults = exports.formatTranscripts = exports.formatMeetingDetails = exports.formatMeetingsList = void 0;
+const chalk_1 = __importDefault(require("chalk"));
+const cli_table3_1 = __importDefault(require("cli-table3"));
+const date_1 = require("./date");
+const string_1 = require("./string");
+const style_1 = require("./style");
+const idColumnWidth = (ids) => {
+    const maxLength = ids.reduce((max, id) => Math.max(max, String(id).length), 2);
+    return maxLength + 2;
+};
+const formatAttendee = (attendee) => attendee.email ? `${attendee.name} (${attendee.email})` : attendee.name;
+const formatSender = (sender) => {
+    if (typeof sender === 'string')
+        return sender;
+    if (sender.name && sender.email)
+        return `${sender.name} (${sender.email})`;
+    return sender.name ?? sender.email ?? 'Unknown';
+};
+const formatMeetingsList = (meetings) => {
+    if (meetings.length === 0)
+        return chalk_1.default.yellow('No meetings found.');
+    const idWidth = idColumnWidth(meetings.map((meeting) => meeting.id));
+    const nameWidth = 40;
+    const dateWidth = 14;
+    const attendeesWidth = 30;
+    const table = new cli_table3_1.default({
+        head: [
+            style_1.brand.bold('Name'),
+            style_1.brand.bold('ID'),
+            style_1.brand.bold('Date'),
+            style_1.brand.bold('Attendees'),
+        ],
+        colWidths: [nameWidth, idWidth, dateWidth, attendeesWidth],
+        wordWrap: true,
+        style: style_1.tableStyle,
+    });
+    meetings.forEach((meeting) => {
+        table.push([
+            (0, string_1.truncate)(meeting.name, nameWidth - 2),
+            meeting.id,
+            (0, date_1.formatDate)(meeting.createdAt),
+            meeting.attendees.map(formatAttendee).join('\n'),
+        ]);
+    });
+    return `${chalk_1.default.bold(`${(0, string_1.pluralize)(meetings.length, 'meeting', 'meetings')} found`)}\n${table.toString()}`;
+};
+exports.formatMeetingsList = formatMeetingsList;
+const formatMeetingDetails = (meetings) => {
+    if (meetings.length === 0)
+        return chalk_1.default.yellow('No meetings found.');
+    return meetings
+        .map((meeting) => {
+        const header = chalk_1.default.bold.cyan(`\n# ${meeting.name}`);
+        const meta = [
+            `${chalk_1.default.bold('ID:')} ${meeting.id}`,
+            `${chalk_1.default.bold('Date:')} ${(0, date_1.formatDate)(meeting.createdAt)}`,
+            meeting.duration
+                ? `${chalk_1.default.bold('Duration:')} ${Math.round(meeting.duration / 60)} min`
+                : null,
+            `${chalk_1.default.bold('Attendees:')}\n${meeting.attendees.map((attendee) => `  ${formatAttendee(attendee)}`).join('\n')}`,
+            meeting.tags.length > 0
+                ? `${chalk_1.default.bold('Tags:')} ${meeting.tags.map((tag) => tag.name).join(', ')}`
+                : null,
+        ]
+            .filter(Boolean)
+            .join('\n');
+        const notes = meeting.notes
+            ? `\n${chalk_1.default.bold('Notes:')}\n${meeting.notes}`
+            : '';
+        const actionItems = meeting.actionItems && meeting.actionItems.length > 0
+            ? `\n${chalk_1.default.bold('Action Items:')}\n${meeting.actionItems.map((item) => `  - ${item.text}${item.assignee ? ` (${item.assignee})` : ''}`).join('\n')}`
+            : '';
+        return `${header}\n${meta}${notes}${actionItems}`;
+    })
+        .join('\n\n---\n');
+};
+exports.formatMeetingDetails = formatMeetingDetails;
+const formatTranscripts = (transcripts) => {
+    if (transcripts.length === 0)
+        return chalk_1.default.yellow('No transcripts found.');
+    return transcripts
+        .map((transcript) => {
+        const header = chalk_1.default.bold.cyan(`\n# ${transcript.meetingName} (ID: ${transcript.meetingId})`);
+        const content = transcript.transcriptChunks
+            .map((chunk) => chunk.content)
+            .join('\n');
+        return `${header}\n${content}`;
+    })
+        .join('\n\n---\n');
+};
+exports.formatTranscripts = formatTranscripts;
+const formatTranscriptSearchResults = (results) => {
+    if (results.length === 0)
+        return chalk_1.default.yellow('No transcript matches found.');
+    const idWidth = idColumnWidth(results.map((result) => result.meetingId));
+    const meetingWidth = 25;
+    const contentWidth = 60;
+    const table = new cli_table3_1.default({
+        head: [style_1.brand.bold('Meeting'), style_1.brand.bold('ID'), style_1.brand.bold('Content')],
+        colWidths: [meetingWidth, idWidth, contentWidth],
+        wordWrap: true,
+        style: style_1.tableStyle,
+    });
+    results.forEach((result) => {
+        table.push([
+            (0, string_1.truncate)(result.meetingName ?? 'Unknown', meetingWidth - 2),
+            result.meetingId,
+            (0, string_1.truncate)(result.content, contentWidth - 2),
+        ]);
+    });
+    return `${chalk_1.default.bold(`${(0, string_1.pluralize)(results.length, 'match', 'matches')} found`)}\n${table.toString()}`;
+};
+exports.formatTranscriptSearchResults = formatTranscriptSearchResults;
+const formatCalendarEvents = (events) => {
+    if (events.length === 0)
+        return chalk_1.default.yellow('No calendar events found.');
+    const table = new cli_table3_1.default({
+        head: [
+            style_1.brand.bold('Title'),
+            style_1.brand.bold('Start'),
+            style_1.brand.bold('End'),
+            style_1.brand.bold('Platform'),
+            style_1.brand.bold('Attendees'),
+        ],
+        colWidths: [30, 20, 20, 12, 35],
+        wordWrap: true,
+        style: style_1.tableStyle,
+    });
+    events.forEach((event) => {
+        table.push([
+            (0, string_1.truncate)(event.title, 28),
+            (0, date_1.formatDateTime)(event.startTime),
+            (0, date_1.formatDateTime)(event.endTime),
+            event.platform ?? '-',
+            event.attendees.map(formatAttendee).join('\n'),
+        ]);
+    });
+    return `${chalk_1.default.bold((0, string_1.pluralize)(events.length, 'event', 'events'))}\n${table.toString()}`;
+};
+exports.formatCalendarEvents = formatCalendarEvents;
+const formatProfiles = (profiles) => {
+    if (profiles.length === 0)
+        return chalk_1.default.yellow('No people found.');
+    const idWidth = idColumnWidth(profiles.map((profile) => profile.id));
+    const nameWidth = 25;
+    const emailWidth = 30;
+    const titleWidth = 20;
+    const companyWidth = 15;
+    const table = new cli_table3_1.default({
+        head: [
+            style_1.brand.bold('Name'),
+            style_1.brand.bold('ID'),
+            style_1.brand.bold('Email'),
+            style_1.brand.bold('Title'),
+            style_1.brand.bold('Company'),
+        ],
+        colWidths: [nameWidth, idWidth, emailWidth, titleWidth, companyWidth],
+        wordWrap: true,
+        style: style_1.tableStyle,
+    });
+    profiles.forEach((profile) => {
+        table.push([
+            [profile.firstName, profile.lastName].filter(Boolean).join(' ') || '-',
+            profile.id,
+            profile.email ?? '-',
+            profile.title ?? '-',
+            profile.company ?? '-',
+        ]);
+    });
+    return `${chalk_1.default.bold(`${(0, string_1.pluralize)(profiles.length, 'person', 'people')} found`)}\n${table.toString()}`;
+};
+exports.formatProfiles = formatProfiles;
+const formatDomains = (domains) => {
+    if (domains.length === 0)
+        return chalk_1.default.yellow('No companies found.');
+    return `${chalk_1.default.bold(`${(0, string_1.pluralize)(domains.length, 'company', 'companies')} found`)}\n${domains.map((domain) => `  ${domain}`).join('\n')}`;
+};
+exports.formatDomains = formatDomains;
+const formatSupportArticles = (articles) => {
+    if (articles.length === 0)
+        return chalk_1.default.yellow('No articles found.');
+    return articles
+        .map((article) => `${(0, string_1.link)(chalk_1.default.bold.cyan(article.title), article.url)}\n${(0, string_1.link)(chalk_1.default.dim.underline(article.url), article.url)}\n${article.description}`)
+        .join('\n\n');
+};
+exports.formatSupportArticles = formatSupportArticles;
+const formatEmails = (threads) => {
+    if (threads.length === 0)
+        return chalk_1.default.yellow('No emails found.');
+    return threads
+        .map((thread) => {
+        const latestMessage = thread.messages[0];
+        if (!latestMessage)
+            return '';
+        const header = chalk_1.default.bold.cyan(latestMessage.subject);
+        const meta = `${chalk_1.default.bold('From:')} ${formatSender(latestMessage.sender)}  ${chalk_1.default.dim((0, date_1.formatDateTime)(latestMessage.receivedOn))}`;
+        const messageCount = thread.messages.length > 1
+            ? chalk_1.default.dim(`(${thread.messages.length} messages in thread)`)
+            : '';
+        const preview = (0, string_1.truncate)(latestMessage.content.replace(/\s+/g, ' ').trim(), 200);
+        return `${header}\n${meta} ${messageCount}\n${preview}`;
+    })
+        .filter(Boolean)
+        .join('\n\n---\n');
+};
+exports.formatEmails = formatEmails;

package/dist/helpers/update.js

@@ -0,0 +1,105 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.printUpdateNotification = exports.checkForUpdate = void 0;
+const node_fs_1 = __importDefault(require("node:fs"));
+const node_path_1 = __importDefault(require("node:path"));
+const chalk_1 = __importDefault(require("chalk"));
+const constants_1 = require("../constants");
+const CACHE_FILE = node_path_1.default.join(constants_1.CONFIG_DIRECTORY, 'update-check.json');
+const CHECK_INTERVAL_MILLISECONDS = 60 * 60 * 1000; // 1 hour
+const REGISTRY_TIMEOUT_MILLISECONDS = 3_000;
+const fetchLatestVersion = async (packageName) => {
+    const response = await fetch(`https://registry.npmjs.org/${packageName}/latest`, {
+        headers: { accept: 'application/json' },
+        signal: AbortSignal.timeout(REGISTRY_TIMEOUT_MILLISECONDS),
+    });
+    if (!response.ok) {
+        throw new Error(`Registry returned status ${response.status}.`);
+    }
+    const parsed = await response.json();
+    if (typeof parsed !== 'object' ||
+        parsed === null ||
+        !('version' in parsed) ||
+        typeof parsed.version !== 'string') {
+        throw new Error('Invalid registry response format.');
+    }
+    return parsed.version;
+};
+const loadCache = () => {
+    try {
+        const content = node_fs_1.default.readFileSync(CACHE_FILE, 'utf-8');
+        const parsed = JSON.parse(content);
+        if (typeof parsed !== 'object' || parsed === null)
+            return;
+        if (!('latestVersion' in parsed) ||
+            typeof parsed.latestVersion !== 'string')
+            return;
+        if (!('checkedAt' in parsed) || typeof parsed.checkedAt !== 'number')
+            return;
+        return { latestVersion: parsed.latestVersion, checkedAt: parsed.checkedAt };
+    }
+    catch {
+        return;
+    }
+};
+const saveCache = (cache) => {
+    try {
+        node_fs_1.default.mkdirSync(constants_1.CONFIG_DIRECTORY, { recursive: true, mode: 0o700 });
+        node_fs_1.default.writeFileSync(CACHE_FILE, JSON.stringify(cache), { mode: 0o600 });
+    }
+    catch {
+        // Silently ignore cache write failures.
+    }
+};
+const parseVersion = (version) => version.replace(/^v/, '').split('.').map(Number);
+const isNewerVersion = (latest, current) => {
+    const latestParts = parseVersion(latest);
+    const currentParts = parseVersion(current);
+    const length = Math.max(latestParts.length, currentParts.length);
+    const firstDifference = Array.from({ length }, (_, index) => (latestParts[index] ?? 0) - (currentParts[index] ?? 0)).find((difference) => difference !== 0);
+    return (firstDifference ?? 0) > 0;
+};
+const checkForUpdate = async (packageName) => {
+    const cached = loadCache();
+    const now = Date.now();
+    if (cached && now - cached.checkedAt < CHECK_INTERVAL_MILLISECONDS) {
+        return {
+            updateAvailable: isNewerVersion(cached.latestVersion, constants_1.CLIENT_VERSION),
+            currentVersion: constants_1.CLIENT_VERSION,
+            latestVersion: cached.latestVersion,
+        };
+    }
+    try {
+        const latestVersion = await fetchLatestVersion(packageName);
+        saveCache({ latestVersion, checkedAt: now });
+        return {
+            updateAvailable: isNewerVersion(latestVersion, constants_1.CLIENT_VERSION),
+            currentVersion: constants_1.CLIENT_VERSION,
+            latestVersion,
+        };
+    }
+    catch {
+        // Network failures should never block CLI usage.
+        return {
+            updateAvailable: false,
+            currentVersion: constants_1.CLIENT_VERSION,
+            latestVersion: cached?.latestVersion ?? constants_1.CLIENT_VERSION,
+        };
+    }
+};
+exports.checkForUpdate = checkForUpdate;
+const printUpdateNotification = (result) => {
+    if (!result.updateAvailable)
+        return;
+    const message = [
+        '',
+        chalk_1.default.yellow(`  Update available: ${chalk_1.default.dim(result.currentVersion)} → ${chalk_1.default.green(result.latestVersion)}`),
+        chalk_1.default.yellow(`  Run ${chalk_1.default.cyan('circleback update')} or ${chalk_1.default.cyan('cb update')} to update.`),
+        '',
+    ].join('\n');
+    console.error(message);
+};
+exports.printUpdateNotification = printUpdateNotification;

package/dist/index.js

@@ -0,0 +1,35 @@
+#!/usr/bin/env node
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const commander_1 = require("commander");
+const registry_1 = require("./commands/registry");
+const constants_1 = require("./constants");
+const help_1 = require("./helpers/help");
+const style_1 = require("./helpers/style");
+const update_1 = require("./helpers/update");
+const program = new commander_1.Command();
+program
+    .name('circleback')
+    .description('Search and access meetings, emails, calendar events, and more.')
+    .version(constants_1.CLIENT_VERSION)
+    .option('--json', 'Output raw JSON instead of formatted text')
+    .addHelpText('before', style_1.BANNER)
+    .configureOutput({
+    writeOut: (text) => process.stdout.write((0, help_1.styleHelpOutput)(text)),
+    writeErr: (text) => process.stderr.write((0, help_1.styleHelpOutput)(text)),
+});
+(0, registry_1.getAllCommands)().reduce((p, command) => p.addCommand(command), program);
+// Fire the update check in the background immediately so it runs in parallel
+// with command execution. The result is awaited and printed after the command
+// finishes, adding zero latency to the happy path.
+const updateCheckPromise = (0, update_1.checkForUpdate)(constants_1.CLIENT_PACKAGE_NAME);
+program.hook('postAction', async () => {
+    try {
+        const result = await updateCheckPromise;
+        (0, update_1.printUpdateNotification)(result);
+    }
+    catch {
+        // Never let the update check interfere with normal CLI operation.
+    }
+});
+program.parse();

package/dist/types.js

@@ -0,0 +1,34 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isJsonRpcResponse = exports.isOAuthTokenResponse = exports.isStoredTokens = void 0;
+const isStoredTokens = (value) => typeof value === 'object' &&
+    value !== null &&
+    'accessToken' in value &&
+    typeof value.accessToken === 'string' &&
+    'refreshToken' in value &&
+    typeof value.refreshToken === 'string' &&
+    'expiresAt' in value &&
+    typeof value.expiresAt === 'number' &&
+    'clientId' in value &&
+    typeof value.clientId === 'string' &&
+    'scope' in value &&
+    typeof value.scope === 'string';
+exports.isStoredTokens = isStoredTokens;
+const isOAuthTokenResponse = (value) => typeof value === 'object' &&
+    value !== null &&
+    'access_token' in value &&
+    typeof value.access_token === 'string' &&
+    'refresh_token' in value &&
+    typeof value.refresh_token === 'string' &&
+    'expires_in' in value &&
+    typeof value.expires_in === 'number' &&
+    'scope' in value &&
+    typeof value.scope === 'string';
+exports.isOAuthTokenResponse = isOAuthTokenResponse;
+const isJsonRpcResponse = (value) => typeof value === 'object' &&
+    value !== null &&
+    'jsonrpc' in value &&
+    value.jsonrpc === '2.0' &&
+    'id' in value &&
+    typeof value.id === 'number';
+exports.isJsonRpcResponse = isJsonRpcResponse;

package/package.json

@@ -0,0 +1,45 @@
+{
+  "name": "@circleback/cli",
+  "version": "0.1.0",
+  "description": "Circleback CLI. Search and access meetings, emails, calendar events, and more.",
+  "license": "MIT",
+  "author": "Circleback <support@circleback.ai> (https://circleback.ai)",
+  "homepage": "https://circleback.ai",
+  "keywords": [
+    "circleback",
+    "cli",
+    "meetings",
+    "transcripts",
+    "notes",
+    "calendar",
+    "ai"
+  ],
+  "bin": {
+    "circleback": "./dist/index.js",
+    "cb": "./dist/index.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "prebuild": "rm -rf dist",
+    "build": "tsc && chmod +x dist/index.js",
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "npm run build"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "dependencies": {
+    "chalk": "^4.1.2",
+    "cli-table3": "^0.6.5",
+    "commander": "^13.1.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "typescript": "5.6.2"
+  }
+}