@circleback/cli 0.1.7 → 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

@@ -21,12 +21,12 @@ exports.standaloneCommands = [
 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/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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@circleback/cli",
-  "version": "0.1.7",
+  "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)",