@circleback/cli 0.1.0

package/dist/commands/profiles.js

@@ -0,0 +1,28 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.searchProfilesCommand = void 0;
+const commander_1 = require("commander");
+const chalk_1 = __importDefault(require("chalk"));
+const jsonRpc_1 = require("../client/jsonRpc");
+const error_1 = require("../helpers/error");
+const formatter_1 = require("../helpers/formatter");
+exports.searchProfilesCommand = new commander_1.Command('search')
+    .description('Search people by name.')
+    .argument('<names...>', 'Names to search for')
+    .action(async (names) => {
+    try {
+        const jsonMode = exports.searchProfilesCommand.parent?.parent?.opts().json ?? false;
+        const result = await (0, jsonRpc_1.callTool)('FindProfiles', {
+            searchTerms: names,
+        });
+        (0, formatter_1.formatOutput)('FindProfiles', result, jsonMode);
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : 'People search failed.';
+        console.error(chalk_1.default.red((0, error_1.formatMcpError)(message) ?? message));
+        process.exit(1);
+    }
+});

package/dist/commands/registry.js

@@ -0,0 +1,61 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getAllCommands = exports.commandGroups = exports.standaloneCommands = void 0;
+const commander_1 = require("commander");
+const auth_1 = require("./auth");
+const calendar_1 = require("./calendar");
+const domains_1 = require("./domains");
+const emails_1 = require("./emails");
+const meetings_1 = require("./meetings");
+const profiles_1 = require("./profiles");
+const support_1 = require("./support");
+const transcripts_1 = require("./transcripts");
+const upgrade_1 = require("./upgrade");
+exports.standaloneCommands = [
+    auth_1.loginCommand,
+    auth_1.logoutCommand,
+    upgrade_1.updateCommand,
+];
+exports.commandGroups = [
+    {
+        name: 'meetings',
+        description: 'Search and read meetings.',
+        subcommands: [meetings_1.searchMeetingsCommand, meetings_1.readMeetingsCommand],
+    },
+    {
+        name: 'transcripts',
+        description: 'Search and read transcripts.',
+        subcommands: [transcripts_1.searchTranscriptsCommand, transcripts_1.getTranscriptsCommand],
+    },
+    {
+        name: 'calendar',
+        description: 'Search calendar events.',
+        subcommands: [calendar_1.searchCalendarCommand],
+    },
+    {
+        name: 'people',
+        description: 'Search people.',
+        subcommands: [profiles_1.searchProfilesCommand],
+    },
+    {
+        name: 'companies',
+        description: 'Search companies.',
+        subcommands: [domains_1.searchDomainsCommand],
+    },
+    {
+        name: 'support',
+        description: 'Search support articles.',
+        subcommands: [support_1.searchSupportCommand],
+    },
+    {
+        name: 'emails',
+        description: 'Search emails.',
+        subcommands: [emails_1.searchEmailsCommand],
+    },
+];
+const buildCommandGroup = (definition) => definition.subcommands.reduce((group, command, index) => group.addCommand(command, index === 0 ? { isDefault: true } : undefined), new commander_1.Command(definition.name).description(definition.description));
+const getAllCommands = () => [
+    ...exports.standaloneCommands,
+    ...exports.commandGroups.map(buildCommandGroup),
+];
+exports.getAllCommands = getAllCommands;

package/dist/commands/support.js

@@ -0,0 +1,30 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.searchSupportCommand = void 0;
+const commander_1 = require("commander");
+const chalk_1 = __importDefault(require("chalk"));
+const jsonRpc_1 = require("../client/jsonRpc");
+const error_1 = require("../helpers/error");
+const formatter_1 = require("../helpers/formatter");
+exports.searchSupportCommand = new commander_1.Command('search')
+    .description('Search Circleback support articles.')
+    .argument('[search]', 'Search term')
+    .action(async (query) => {
+    try {
+        const jsonMode = exports.searchSupportCommand.parent?.parent?.opts().json ?? false;
+        const arguments_ = {
+            intent: query ?? 'Listing support articles.',
+        };
+        arguments_['searchTerm'] = query ?? '';
+        const result = await (0, jsonRpc_1.callTool)('SearchSupportArticles', arguments_);
+        (0, formatter_1.formatOutput)('SearchSupportArticles', result, jsonMode);
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : 'Support search failed.';
+        console.error(chalk_1.default.red((0, error_1.formatMcpError)(message) ?? message));
+        process.exit(1);
+    }
+});

package/dist/commands/transcripts.js

@@ -0,0 +1,61 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getTranscriptsCommand = exports.searchTranscriptsCommand = void 0;
+const commander_1 = require("commander");
+const chalk_1 = __importDefault(require("chalk"));
+const jsonRpc_1 = require("../client/jsonRpc");
+const error_1 = require("../helpers/error");
+const formatter_1 = require("../helpers/formatter");
+const parse_1 = require("../helpers/parse");
+exports.searchTranscriptsCommand = new commander_1.Command('search')
+    .description('Search meeting transcripts.')
+    .argument('[search]', 'Search term')
+    .option('--tags <ids>', 'Comma-separated tag IDs')
+    .option('--profiles <ids>', 'Comma-separated profile IDs')
+    .option('--domains <domains>', 'Comma-separated domains')
+    .action(async (query, options) => {
+    try {
+        const jsonMode = exports.searchTranscriptsCommand.parent?.parent?.opts().json ?? false;
+        const arguments_ = {
+            intent: query ?? 'Listing recent transcripts.',
+        };
+        if (query)
+            arguments_['searchTerm'] = query;
+        if (options.tags)
+            arguments_['tags'] = (0, parse_1.parseNumericIds)(options.tags, 'tag ID');
+        if (options.profiles)
+            arguments_['profiles'] = (0, parse_1.parseNumericIds)(options.profiles, 'profile ID');
+        if (options.domains)
+            arguments_['domains'] = options.domains.split(',');
+        const result = await (0, jsonRpc_1.callTool)('SearchTranscripts', arguments_);
+        (0, formatter_1.formatOutput)('SearchTranscripts', result, jsonMode);
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : 'Transcript search failed.';
+        console.error(chalk_1.default.red((0, error_1.formatMcpError)(message) ?? message));
+        process.exit(1);
+    }
+});
+exports.getTranscriptsCommand = new commander_1.Command('read')
+    .description('Get full transcripts for meetings.')
+    .argument('<meetingId…>', 'Meeting IDs (max 50)')
+    .showHelpAfterError(true)
+    .action(async (ids) => {
+    try {
+        const jsonMode = exports.getTranscriptsCommand.parent?.parent?.opts().json ?? false;
+        const meetingIds = (0, parse_1.validateNumericIds)(ids, 'meeting ID');
+        const result = await (0, jsonRpc_1.callTool)('GetTranscriptsForMeetings', {
+            intent: `Getting transcripts for meeting IDs: ${meetingIds.join(', ')}.`,
+            meetingIds,
+        });
+        (0, formatter_1.formatOutput)('GetTranscriptsForMeetings', result, jsonMode);
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : 'Transcript retrieval failed.';
+        console.error(chalk_1.default.red((0, error_1.formatMcpError)(message) ?? message));
+        process.exit(1);
+    }
+});

package/dist/commands/upgrade.js

@@ -0,0 +1,35 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.updateCommand = void 0;
+const commander_1 = require("commander");
+const node_child_process_1 = require("node:child_process");
+const chalk_1 = __importDefault(require("chalk"));
+const constants_1 = require("../constants");
+const update_1 = require("../helpers/update");
+exports.updateCommand = new commander_1.Command('update')
+    .description('Update Circleback CLI to the latest version.')
+    .action(async () => {
+    console.log(chalk_1.default.dim(`Current version: ${constants_1.CLIENT_VERSION}`));
+    console.log(chalk_1.default.dim('Checking for updates…'));
+    const result = await (0, update_1.checkForUpdate)(constants_1.CLIENT_PACKAGE_NAME);
+    if (!result.updateAvailable) {
+        console.log(chalk_1.default.green('Already on the latest version.'));
+        return;
+    }
+    console.log(chalk_1.default.yellow(`New version available: ${result.currentVersion} → ${result.latestVersion}`));
+    console.log(chalk_1.default.dim(`Running: npm install -g ${constants_1.CLIENT_PACKAGE_NAME}@latest`));
+    try {
+        (0, node_child_process_1.execSync)(`npm install -g ${constants_1.CLIENT_PACKAGE_NAME}@latest`, {
+            stdio: 'inherit',
+        });
+        console.log(chalk_1.default.green(`\nSuccessfully updated to ${result.latestVersion}.`));
+    }
+    catch {
+        console.error(chalk_1.default.red('\nUpdate failed. Try running manually with sudo:'));
+        console.error(chalk_1.default.cyan(`  sudo npm install -g ${constants_1.CLIENT_PACKAGE_NAME}@latest`));
+        process.exit(1);
+    }
+});

package/dist/constants.js

@@ -0,0 +1,39 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CALLBACK_TIMEOUT_MILLISECONDS = exports.OAUTH_SCOPE = exports.TOKENS_FILE = exports.CONFIG_DIRECTORY = exports.ASCII_LOGO = exports.SECONDARY_COLOR = exports.BRAND_COLOR = exports.CLIENT_VERSION = exports.CLIENT_PACKAGE_NAME = exports.CLIENT_NAME = exports.BASE_URL = void 0;
+const node_fs_1 = __importDefault(require("node:fs"));
+const node_path_1 = __importDefault(require("node:path"));
+const node_os_1 = __importDefault(require("node:os"));
+const packageJson = JSON.parse(node_fs_1.default.readFileSync(node_path_1.default.join(__dirname, '..', 'package.json'), 'utf-8'));
+exports.BASE_URL = 'https://app.circleback.ai';
+exports.CLIENT_NAME = 'Circleback CLI';
+exports.CLIENT_PACKAGE_NAME = '@circleback/cli';
+exports.CLIENT_VERSION = packageJson.version;
+exports.BRAND_COLOR = '#F24E1D';
+exports.SECONDARY_COLOR = '#4262FF';
+exports.ASCII_LOGO = `
+               ==============
+            ====================
+          ========================
+         ==========================
+       ==========          =========
+      =========              =====
+      ========
+      ========
+      =======
+      =======
+      ========
+      ========
+       ========              ======
+        =========          =========
+         ==========================      +++++
+          ========================      +++++++
+             ===================        +++++++
+                =============            +++++`;
+exports.CONFIG_DIRECTORY = node_path_1.default.join(node_os_1.default.homedir(), '.config', 'circleback');
+exports.TOKENS_FILE = node_path_1.default.join(exports.CONFIG_DIRECTORY, 'tokens.json');
+exports.OAUTH_SCOPE = 'user';
+exports.CALLBACK_TIMEOUT_MILLISECONDS = 120_000;

package/dist/helpers/date.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.formatDateTime = exports.formatDate = exports.getStartDateFromDaysAgo = void 0;
+const getStartDateFromDaysAgo = (days) => new Date(Date.now() - days * 86400000).toISOString().slice(0, 10);
+exports.getStartDateFromDaysAgo = getStartDateFromDaysAgo;
+const formatDate = (dateString) => {
+    const date = new Date(dateString);
+    return date.toLocaleDateString('en-US', {
+        month: 'short',
+        day: 'numeric',
+        year: 'numeric',
+    });
+};
+exports.formatDate = formatDate;
+const formatDateTime = (dateString) => {
+    const date = new Date(dateString);
+    return date.toLocaleString('en-US', {
+        month: 'short',
+        day: 'numeric',
+        year: 'numeric',
+        hour: 'numeric',
+        minute: '2-digit',
+    });
+};
+exports.formatDateTime = formatDateTime;

package/dist/helpers/error.js

@@ -0,0 +1,59 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.formatMcpError = void 0;
+const VALIDATION_ERROR_PATTERN = /Input validation error: Invalid arguments for tool (\w+): (\[.*\])/s;
+const TOOL_EXAMPLES = {
+    SearchMeetings: 'cb meetings search "standup" --last 7',
+    ReadMeetings: 'cb meetings read 123',
+    SearchCalendarEvents: 'cb calendar search --last 7',
+    SearchTranscripts: 'cb transcripts search "action items"',
+    GetTranscriptsForMeetings: 'cb transcripts read 123',
+    SearchEmails: 'cb emails search "invoice"',
+    FindProfiles: 'cb people search "John"',
+    FindDomains: 'cb companies search "acme"',
+    SearchSupportArticles: 'cb support "recording"',
+};
+const isValidationIssue = (value) => {
+    if (typeof value !== 'object' || value === null)
+        return false;
+    if (!('path' in value) || !Array.isArray(value.path))
+        return false;
+    if (!('message' in value) || typeof value.message !== 'string')
+        return false;
+    return true;
+};
+const formatIssue = (issue) => {
+    const field = issue.path.join('.');
+    if (issue.code === 'invalid_type' && issue.expected) {
+        return `  Missing required field: ${field} (expected ${issue.expected}).`;
+    }
+    return `  ${field}: ${issue.message}.`;
+};
+const formatMcpError = (message) => {
+    const match = message.match(VALIDATION_ERROR_PATTERN);
+    if (!match)
+        return;
+    const toolName = match[1];
+    const issuesJson = match[2];
+    if (!toolName || !issuesJson)
+        return;
+    let parsed;
+    try {
+        parsed = JSON.parse(issuesJson);
+    }
+    catch {
+        return;
+    }
+    if (!Array.isArray(parsed) || !parsed.every(isValidationIssue))
+        return;
+    const lines = [
+        `Invalid arguments for ${toolName}:`,
+        ...parsed.map(formatIssue),
+    ];
+    const example = TOOL_EXAMPLES[toolName];
+    if (example) {
+        lines.push('', `Example: ${example}`);
+    }
+    return lines.join('\n');
+};
+exports.formatMcpError = formatMcpError;

package/dist/helpers/formatter.js

@@ -0,0 +1,49 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.formatOutput = void 0;
+const table_1 = require("./table");
+const safeParse = (rawText) => {
+    try {
+        return JSON.parse(rawText);
+    }
+    catch {
+        return rawText;
+    }
+};
+const stringify = (value) => typeof value === 'string' ? value : JSON.stringify(value, null, 2);
+const formatArrayForTool = (toolName, data) => {
+    if (!Array.isArray(data))
+        return;
+    switch (toolName) {
+        case 'SearchMeetings':
+            return (0, table_1.formatMeetingsList)(data);
+        case 'ReadMeetings':
+            return (0, table_1.formatMeetingDetails)(data);
+        case 'GetTranscriptsForMeetings':
+            return (0, table_1.formatTranscripts)(data);
+        case 'SearchTranscripts':
+            return (0, table_1.formatTranscriptSearchResults)(data);
+        case 'SearchCalendarEvents':
+            return (0, table_1.formatCalendarEvents)(data);
+        case 'FindProfiles':
+            return (0, table_1.formatProfiles)(data);
+        case 'FindDomains':
+            return (0, table_1.formatDomains)(data);
+        case 'SearchSupportArticles':
+            return (0, table_1.formatSupportArticles)(data);
+        case 'SearchEmails':
+            return (0, table_1.formatEmails)(data);
+        default:
+            return;
+    }
+};
+const formatOutput = (toolName, rawText, jsonMode) => {
+    const parsed = safeParse(rawText);
+    if (jsonMode) {
+        console.log(stringify(parsed));
+        return;
+    }
+    const formatted = formatArrayForTool(toolName, parsed);
+    console.log(formatted ?? stringify(parsed));
+};
+exports.formatOutput = formatOutput;

package/dist/helpers/help.js

@@ -0,0 +1,42 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.styleHelpOutput = void 0;
+const chalk_1 = __importDefault(require("chalk"));
+const SECTION_HEADERS = {
+    'Options:': 'options',
+    'Commands:': 'commands',
+    'Arguments:': 'arguments',
+};
+const styleLine = (line, section) => {
+    if (/^Usage:/.test(line)) {
+        return [line.replace(/^Usage:/, chalk_1.default.bold('Usage:')), 'none'];
+    }
+    const nextSection = SECTION_HEADERS[line];
+    if (nextSection) {
+        return [chalk_1.default.bold(line), nextSection];
+    }
+    if (line.trim() === '')
+        return [line, section];
+    const isStyledSection = section === 'options' || section === 'commands' || section === 'arguments';
+    if (isStyledSection && /^\s+\S/.test(line)) {
+        const match = line.match(/^(\s+)(.+?)(  +)(.*)$/);
+        if (match) {
+            return [
+                `${match[1]}${chalk_1.default.bold(match[2])}${match[3]}${match[4]}`,
+                section,
+            ];
+        }
+    }
+    return [line, section];
+};
+const styleHelpOutput = (text) => text
+    .split('\n')
+    .reduce(({ section, lines }, line) => {
+    const [styled, nextSection] = styleLine(line, section);
+    return { section: nextSection, lines: [...lines, styled] };
+}, { section: 'none', lines: [] })
+    .lines.join('\n');
+exports.styleHelpOutput = styleHelpOutput;

package/dist/helpers/parse.js

@@ -0,0 +1,34 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateNumericIds = exports.parseNumericIds = exports.parseIntOption = void 0;
+const chalk_1 = __importDefault(require("chalk"));
+const parseIntOption = (value, flagName) => {
+    const parsed = parseInt(value, 10);
+    if (isNaN(parsed)) {
+        console.error(chalk_1.default.red(`Invalid number for ${flagName}.`));
+        process.exit(1);
+    }
+    return parsed;
+};
+exports.parseIntOption = parseIntOption;
+const parseNumericIds = (value, label) => {
+    const ids = value.split(',').map(Number);
+    if (ids.some(isNaN)) {
+        console.error(chalk_1.default.red(`Invalid ${label}. Expected numeric IDs.`));
+        process.exit(1);
+    }
+    return ids;
+};
+exports.parseNumericIds = parseNumericIds;
+const validateNumericIds = (values, label) => {
+    const ids = values.map(Number);
+    if (ids.some(isNaN)) {
+        console.error(chalk_1.default.red(`Invalid ${label}. Expected numeric IDs.`));
+        process.exit(1);
+    }
+    return ids;
+};
+exports.validateNumericIds = validateNumericIds;

package/dist/helpers/string.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.pluralize = exports.link = exports.truncate = void 0;
+const truncate = (text, maxLength) => text.length > maxLength ? `${text.slice(0, maxLength - 1)}…` : text;
+exports.truncate = truncate;
+const link = (text, url) => `\u001B]8;;${url}\u0007${text}\u001B]8;;\u0007`;
+exports.link = link;
+const pluralize = (count, singular, plural) => `${count} ${count === 1 ? singular : plural}`;
+exports.pluralize = pluralize;

package/dist/helpers/style.js

@@ -0,0 +1,21 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BANNER = exports.tableStyle = exports.secondary = exports.brand = void 0;
+const chalk_1 = __importDefault(require("chalk"));
+const constants_1 = require("../constants");
+exports.brand = chalk_1.default.hex(constants_1.BRAND_COLOR);
+exports.secondary = chalk_1.default.hex(constants_1.SECONDARY_COLOR);
+exports.tableStyle = { head: [], border: [] };
+exports.BANNER = [
+    '',
+    `  ${exports.brand.bold(constants_1.CLIENT_PACKAGE_NAME)}  ${chalk_1.default.dim(`v${constants_1.CLIENT_VERSION}`)}`,
+    constants_1.ASCII_LOGO.split('\n')
+        .map((line) => line
+        .replace(/=+/g, (match) => (0, exports.brand)(match))
+        .replace(/\++/g, (match) => (0, exports.secondary)(match)))
+        .join('\n'),
+    '',
+].join('\n');