@circleback/cli 0.1.6 → 0.1.8

package/README.md

@@ -22,9 +22,12 @@ cb meetings
 # Search by keyword
 cb meetings "product review"
 
-# Read full meeting details
+# Read full meeting details by numeric ID
 cb meetings read 12345
 
+# Read by linkId (from the meeting URL, e.g. circleback.ai/meetings/Vd6Pz_kWqLm3xY-c8RhTn)
+cb meetings read Vd6Pz_kWqLm3xY-c8RhTn
+
 # Search transcripts
 cb transcripts "pricing discussion"
 
@@ -37,23 +40,32 @@ cb meetings --json
 
 ## Commands
 
-| Command                        | Description                                         |
-| ------------------------------ | --------------------------------------------------- |
-| `cb login`                     | Authenticate with Circleback via browser            |
-| `cb logout`                    | Clear stored authentication tokens                  |
-| `cb update`                    | Update CLI to the latest version                    |
-| `cb meetings [search]`         | Search meetings                                     |
-| `cb meetings read <ids...>`    | Read detailed meeting info, notes, and action items |
-| `cb transcripts <search>`      | Search transcript content                           |
-| `cb transcripts read <ids...>` | Read full transcripts                               |
-| `cb calendar`                  | Search calendar events                              |
-| `cb people <names...>`         | Search people by name                               |
-| `cb companies <terms...>`      | Search companies by domain                          |
-| `cb emails [search]`           | Search connected email accounts                     |
-| `cb support [search]`          | Search Circleback support articles                  |
+| Command                        | Description                                                                          |
+| ------------------------------ | ------------------------------------------------------------------------------------ |
+| `cb login`                     | Authenticate with Circleback via browser                                             |
+| `cb logout`                    | Clear stored authentication tokens                                                   |
+| `cb update`                    | Update CLI to the latest version                                                     |
+| `cb meetings [search]`         | Search meetings                                                                      |
+| `cb meetings read <ids...>`    | Read detailed meeting info, notes, and action items (numeric IDs or linkIds, max 50) |
+| `cb transcripts <search>`      | Search transcript content                                                            |
+| `cb transcripts read <ids...>` | Read full transcripts (numeric IDs or linkIds, max 50)                               |
+| `cb calendar`                  | Search calendar events                                                               |
+| `cb people <names...>`         | Search people by name                                                                |
+| `cb companies <terms...>`      | Search companies by domain                                                           |
+| `cb emails [search]`           | Search connected email accounts                                                      |
+| `cb support [search]`          | Search Circleback support articles                                                   |
 
 Run `cb --help` or `cb <command> --help` for full usage details.
 
+## Meeting identifiers
+
+`cb meetings read` and `cb transcripts read` accept up to 50 IDs in either form:
+
+- **Numeric ID** — the integer ID returned in search results (e.g. `12345`)
+- **linkId** — the short alphanumeric slug from a meeting URL (e.g. `Vd6Pz_kWqLm3xY-c8RhTn` from `circleback.ai/meetings/Vd6Pz_kWqLm3xY-c8RhTn`)
+
+Both forms can be mixed in a single call: `cb meetings read 12345 Vd6Pz_kWqLm3xY-c8RhTn`
+
 ## Filtering
 
 Meeting, transcript, and calendar searches support filtering by date range. Meeting and transcript searches also support filtering by tag, person, and company:

package/dist/commands/meetings.js

@@ -67,13 +67,13 @@ exports.searchMeetingsCommand = new commander_1.Command('search')
 });
 exports.readMeetingsCommand = new commander_1.Command('read')
     .description('Get detailed meeting information.')
-    .argument('<ids...>', 'Meeting IDs')
+    .argument('<ids...>', 'Meeting numeric IDs or linkIds (max 50)')
     .action(async (ids) => {
     try {
         const jsonMode = exports.readMeetingsCommand.parent?.parent?.opts().json ?? false;
-        const meetingIds = (0, parse_1.validateNumericIds)(ids, 'meeting ID');
+        const meetingIds = (0, parse_1.validateMeetingIdentifiers)(ids);
         const result = await (0, jsonRpc_1.callTool)('ReadMeetings', {
-            intent: `Reading meeting details for IDs: ${meetingIds.join(', ')}.`,
+            intent: `Reading meeting details for IDs or linkIds: ${meetingIds.join(', ')}.`,
             meetingIds,
         });
         (0, formatter_1.formatOutput)('ReadMeetings', result, jsonMode);

package/dist/commands/registry.js

@@ -12,21 +12,21 @@ const profiles_1 = require("./profiles");
 const support_1 = require("./support");
 const tags_1 = require("./tags");
 const transcripts_1 = require("./transcripts");
-const upgrade_1 = require("./upgrade");
+const update_1 = require("./update");
 exports.standaloneCommands = [
     auth_1.loginCommand,
     auth_1.logoutCommand,
-    upgrade_1.updateCommand,
+    update_1.updateCommand,
 ];
 exports.commandGroups = [
     {
         name: 'meetings',
-        description: 'Search and read meetings.',
+        description: 'Search meetings with `cb meetings search [term]` and read them with `cb meetings read <id>`.',
         subcommands: [meetings_1.searchMeetingsCommand, meetings_1.readMeetingsCommand],
     },
     {
         name: 'transcripts',
-        description: 'Search and read transcripts.',
+        description: 'Search transcripts with `cb transcripts search <term>` and read them with `cb transcripts read <id>`.',
         subcommands: [transcripts_1.searchTranscriptsCommand, transcripts_1.getTranscriptsCommand],
     },
     {

package/dist/commands/transcripts.js

@@ -44,14 +44,14 @@ exports.searchTranscriptsCommand = new commander_1.Command('search')
 });
 exports.getTranscriptsCommand = new commander_1.Command('read')
     .description('Get full meeting transcripts.')
-    .argument('<meetingId...>', 'Meeting IDs (max 50)')
+    .argument('<meetingId...>', 'Meeting numeric IDs or linkIds (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 meetingIds = (0, parse_1.validateMeetingIdentifiers)(ids);
         const result = await (0, jsonRpc_1.callTool)('GetTranscriptsForMeetings', {
-            intent: `Getting transcripts for meeting IDs: ${meetingIds.join(', ')}.`,
+            intent: `Getting transcripts for meetings with IDs or linkIds: ${meetingIds.join(', ')}.`,
             meetingIds,
         });
         (0, formatter_1.formatOutput)('GetTranscriptsForMeetings', result, jsonMode);

package/dist/commands/{upgrade.js → update.js}

@@ -14,7 +14,7 @@ exports.updateCommand = new commander_1.Command('update')
     .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);
+    const result = await (0, update_1.getUpdateCheckResult)(constants_1.CLIENT_PACKAGE_NAME);
     if (!result.updateAvailable) {
         console.log(chalk_1.default.green('Already on the latest version.'));
         return;

package/dist/helpers/parse.js

@@ -3,7 +3,7 @@ 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 = exports.extractAndValidateObjectFromString = void 0;
+exports.validateMeetingIdentifiers = exports.validateNumericIds = exports.parseNumericIds = exports.parseIntOption = exports.extractAndValidateObjectFromString = void 0;
 const chalk_1 = __importDefault(require("chalk"));
 const zod_1 = require("zod");
 const extractAndValidateObjectFromString = (rawText, schema) => {
@@ -49,3 +49,14 @@ const validateNumericIds = (values, label) => {
     return result.data;
 };
 exports.validateNumericIds = validateNumericIds;
+const validateMeetingIdentifiers = (values) => {
+    const cleanedValues = values.map((value) => value.trim()).filter(Boolean);
+    const isValidIdentifier = /^[A-Za-z0-9_-]{1,64}$/;
+    if (cleanedValues.length === 0 ||
+        cleanedValues.some((value) => !isValidIdentifier.test(value))) {
+        console.error(chalk_1.default.red('Invalid meeting identifiers. Expected one or more numeric IDs or linkIds.'));
+        process.exit(1);
+    }
+    return cleanedValues;
+};
+exports.validateMeetingIdentifiers = validateMeetingIdentifiers;

package/dist/helpers/update.js

@@ -3,7 +3,7 @@ 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;
+exports.printUpdateNotification = exports.getUpdateCheckResult = void 0;
 const node_fs_1 = __importDefault(require("node:fs"));
 const node_path_1 = __importDefault(require("node:path"));
 const chalk_1 = __importDefault(require("chalk"));
@@ -62,15 +62,16 @@ const isNewerVersion = (latest, current) => {
     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 resultFromCache = (cached) => ({
+    updateAvailable: isNewerVersion(cached.latestVersion, constants_1.CLIENT_VERSION),
+    currentVersion: constants_1.CLIENT_VERSION,
+    latestVersion: cached.latestVersion,
+});
+const getUpdateCheckResult = 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,
-        };
+        return resultFromCache(cached);
     }
     try {
         const latestVersion = await fetchLatestVersion(packageName);
@@ -90,7 +91,7 @@ const checkForUpdate = async (packageName) => {
         };
     }
 };
-exports.checkForUpdate = checkForUpdate;
+exports.getUpdateCheckResult = getUpdateCheckResult;
 const printUpdateNotification = (result) => {
     if (!result.updateAvailable)
         return;

package/dist/index.js

@@ -8,28 +8,30 @@ const help_1 = require("./helpers/help");
 const style_1 = require("./helpers/style");
 const update_1 = require("./helpers/update");
 const program = new commander_1.Command();
+const updateCheck = (0, update_1.getUpdateCheckResult)(constants_1.CLIENT_PACKAGE_NAME);
 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)
+    .exitOverride()
     .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 () => {
+program.hook('postAction', async (_thisCommand, actionCommand) => {
+    if (actionCommand.name() === 'update')
+        return;
     try {
-        const result = await updateCheckPromise;
-        (0, update_1.printUpdateNotification)(result);
-    }
-    catch {
-        // Never let the update check interfere with normal CLI operation.
+        (0, update_1.printUpdateNotification)(await updateCheck);
     }
+    catch { }
+});
+program.parseAsync().catch((error) => {
+    if (error instanceof commander_1.CommanderError)
+        process.exit(error.exitCode);
+    console.error(error);
+    process.exit(1);
 });
-program.parse();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@circleback/cli",
-  "version": "0.1.6",
+  "version": "0.1.8",
   "description": "Circleback CLI. Search and access meetings, emails, calendar events, and more.",
   "license": "MIT",
   "author": "Circleback <support@circleback.ai> (https://circleback.ai)",