@circleback/cli 0.1.7 → 0.1.9

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/auth/oauth.js

@@ -90,7 +90,7 @@ const refreshAccessToken = async (refreshToken, clientId) => {
     return tokenData;
 };
 exports.refreshAccessToken = refreshAccessToken;
-const login = async () => {
+const login = async (options = {}) => {
     const { port, waitForCallback, shutdown } = await (0, server_1.startCallbackServer)();
     const redirectUri = `http://127.0.0.1:${port}`;
     try {
@@ -106,6 +106,7 @@ const login = async () => {
         authorizeUrl.searchParams.set('code_challenge', challenge);
         authorizeUrl.searchParams.set('code_challenge_method', 'S256');
         const url = authorizeUrl.toString();
+        options.onAuthorizeUrl?.(url);
         const isWindows = process.platform === 'win32';
         const escapedUrl = isWindows ? url.replace(/&/g, '^&') : url;
         const [command, ...arguments_] = isWindows

package/dist/commands/auth.js

@@ -8,6 +8,24 @@ const commander_1 = require("commander");
 const chalk_1 = __importDefault(require("chalk"));
 const oauth_1 = require("../auth/oauth");
 const tokenStorage_1 = require("../auth/tokenStorage");
+const AUTHORIZATION_URL_FALLBACK_DELAY_MILLISECONDS = 500;
+const getOpenUrlInstruction = () => process.platform === 'darwin' ? '⌘-click' : 'Ctrl-click';
+const createAuthorizationUrlFallback = () => {
+    const abortController = new AbortController();
+    const schedule = (url) => {
+        const timeout = setTimeout(() => {
+            if (abortController.signal.aborted)
+                return;
+            console.log(`Browser didn't open? ${getOpenUrlInstruction()} the URL below to log in.\n`);
+            console.log(chalk_1.default.cyan(url));
+        }, AUTHORIZATION_URL_FALLBACK_DELAY_MILLISECONDS);
+        abortController.signal.addEventListener('abort', () => clearTimeout(timeout), { once: true });
+    };
+    return {
+        schedule,
+        cleanup: () => abortController.abort(),
+    };
+};
 exports.loginCommand = new commander_1.Command('login')
     .description('Authenticate with Circleback via browser.')
     .action(async () => {
@@ -17,8 +35,16 @@ exports.loginCommand = new commander_1.Command('login')
             console.log(chalk_1.default.yellow('Already authenticated. Run `circleback logout` first to re-authenticate.'));
             return;
         }
-        console.log('Opening browser for authentication…');
-        await (0, oauth_1.login)();
+        console.log('Opening your browser for authentication…\n');
+        const authorizationUrlFallback = createAuthorizationUrlFallback();
+        try {
+            await (0, oauth_1.login)({
+                onAuthorizeUrl: authorizationUrlFallback.schedule,
+            });
+        }
+        finally {
+            authorizationUrlFallback.cleanup();
+        }
         console.log(chalk_1.default.green('Authentication successful.'));
     }
     catch (error) {

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.9",
   "description": "Circleback CLI. Search and access meetings, emails, calendar events, and more.",
   "license": "MIT",
   "author": "Circleback <support@circleback.ai> (https://circleback.ai)",