@circleback/cli 0.7.0 → 0.9.0

package/README.md

@@ -40,32 +40,32 @@ cb meetings --json
 
 ## Commands
 
-| Command                                | Description                                                     |
-| -------------------------------------- | --------------------------------------------------------------- |
-| `cb auth login`                        | Log in to Circleback with your browser                          |
-| `cb auth login --api-key`              | Log in with an API key                                          |
-| `cb auth logout`                       | Sign out on this device                                         |
-| `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 (max 50)    |
-| `cb meetings share <id>`               | Share a meeting or remove access                                |
-| `cb transcripts <search>`              | Search transcript content                                       |
-| `cb transcripts read <ids...>`         | Read full transcripts (max 50)                                  |
-| `cb calendar`                          | Search calendar events                                          |
-| `cb people <names...>`                 | Search people by name                                           |
-| `cb companies <terms...>`              | Search companies by name or domain                              |
-| `cb emails [search]`                   | Search connected email accounts                                 |
-| `cb support [search]`                  | Search Circleback support articles                              |
-| `cb action-items [search]`             | Search action items                                             |
-| `cb action-items create <title>`       | Create an action item                                           |
-| `cb action-items update <id>`          | Update an action item's title, description, status, or assignee |
-| `cb action-items delete <id>`          | Delete an action item                                           |
-| `cb tags`                              | List tags                                                       |
-| `cb tags create <name>`                | Create a tag                                                    |
-| `cb tags update <id>`                  | Update a tag's name, description, or color                      |
-| `cb tags delete <id>`                  | Delete a tag                                                    |
-| `cb tags apply <id> <meetingIds...>`   | Add a tag to meetings                                           |
-| `cb tags unapply <id> <meetingIds...>` | Remove a tag from meetings                                      |
+| Command                          | Description                                                  |
+| -------------------------------- | ------------------------------------------------------------ |
+| `cb auth login`                  | Log in to Circleback with your browser                       |
+| `cb auth login --api-key`        | Log in with an API key                                       |
+| `cb auth logout`                 | Sign out on this device                                      |
+| `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 (max 50) |
+| `cb meetings update <id>`        | Update a meeting                                             |
+| `cb meetings share <id>`         | Share a meeting or remove access                             |
+| `cb transcripts <search>`        | Search transcript content                                    |
+| `cb transcripts read <ids...>`   | Read full transcripts (max 50)                               |
+| `cb calendar`                    | Search calendar events                                       |
+| `cb calendar update <id>`        | Update a calendar event                                      |
+| `cb people <names...>`           | Search people by name                                        |
+| `cb companies <terms...>`        | Search companies by name or domain                           |
+| `cb emails [search]`             | Search connected email accounts                              |
+| `cb support [search]`            | Search Circleback support articles                           |
+| `cb action-items [search]`       | Search action items                                          |
+| `cb action-items create <title>` | Create an action item                                        |
+| `cb action-items update <id>`    | Update an action item                                        |
+| `cb action-items delete <id>`    | Delete an action item                                        |
+| `cb tags`                        | List tags                                                    |
+| `cb tags create <name>`          | Create a tag                                                 |
+| `cb tags update <id>`            | Update a tag                                                 |
+| `cb tags delete <id>`            | Delete a tag                                                 |
 
 Run `cb --help` or `cb <command> --help` for full usage details.
 
@@ -116,7 +116,7 @@ For stateless automation, set `CIRCLEBACK_API_KEY` instead of logging in:
 CIRCLEBACK_API_KEY=cb_your_api_key cb meetings --json
 ```
 
-Changing action items, tags, or meeting access needs write access. Browser logins from before v0.5.0 don't include it, so run `cb auth login` again; read-only API keys can't make changes.
+Changing meetings, action items, tags, or sharing permissions needs write access. Browser logins from before v0.5.0 don't include it, so run `cb auth login` again; read-only API keys can't make changes.
 
 `CIRCLEBACK_API_KEY` takes precedence over stored credentials. Unset it before running `cb auth login`; `cb auth logout` cannot clear an environment variable from your shell.
 

package/dist/commands/actionItems.js

@@ -7,6 +7,7 @@ const command_1 = require("../helpers/command");
 const date_1 = require("../helpers/date");
 const parse_1 = require("../helpers/parse");
 const tag_1 = require("../helpers/tag");
+const value_1 = require("../helpers/value");
 const types_1 = require("../types");
 const DEFAULT_ACTION_ITEMS_SEARCH_LAST_DAYS = 30;
 exports.searchActionItemsCommand = (0, command_1.defineToolCommand)(new commander_1.Command('search')
@@ -47,14 +48,13 @@ exports.updateActionItemCommand = (0, command_1.defineToolCommand)(new commander
     .option('--description <description>', 'Set the description')
     .addOption(new commander_1.Option('--status <status>', 'Set completion status').choices(Object.values(types_1.ActionItemStatus)))
     .option('--assignee <id|none>', 'Set or remove the assignee'), types_1.ToolName.UpdateActionItem, (identifier, { assignee, ...fields }) => {
-    if (assignee === undefined &&
-        !Object.values(fields).some((value) => value !== undefined)) {
+    if (!(0, value_1.isPresent)(assignee) && !Object.values(fields).some(value_1.isPresent)) {
         throw new Error('Provide at least one field to update.');
     }
     return {
         actionItemId: (0, parse_1.parseIntOption)(identifier, 'id'),
         ...fields,
-        ...(assignee !== undefined && {
+        ...((0, value_1.isPresent)(assignee) && {
             assigneeProfileId: assignee === 'none' ? null : (0, parse_1.parseIntOption)(assignee, '--assignee'),
         }),
     };

package/dist/commands/calendar.js

@@ -1,10 +1,12 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.searchCalendarCommand = void 0;
+exports.updateCalendarEventCommand = exports.searchCalendarCommand = void 0;
 const commander_1 = require("commander");
 const constants_1 = require("../constants");
 const command_1 = require("../helpers/command");
 const date_1 = require("../helpers/date");
+const tag_1 = require("../helpers/tag");
+const value_1 = require("../helpers/value");
 const types_1 = require("../types");
 exports.searchCalendarCommand = (0, command_1.defineToolCommand)(new commander_1.Command('search')
     .description('Search calendar events.')
@@ -16,3 +18,17 @@ exports.searchCalendarCommand = (0, command_1.defineToolCommand)(new commander_1
     startDate: (0, date_1.getStartDate)(options),
     endDate: options.to || undefined,
 }));
+exports.updateCalendarEventCommand = (0, command_1.defineToolCommand)(new commander_1.Command('update')
+    .description('Update private notes or tags for a meeting before it starts. Each option replaces the current value when provided.')
+    .argument('<id>', 'Event ID from `cb calendar`')
+    .option('--private-notes <notes>', constants_1.PRIVATE_NOTES_UPDATE_OPTION_DESCRIPTION)
+    .option('--tags <tags>', constants_1.TAGS_UPDATE_OPTION_DESCRIPTION), types_1.ToolName.UpdateCalendarEvent, async (calendarMeetingId, { privateNotes, tags }) => {
+    if (!(0, value_1.isPresent)(privateNotes) && !(0, value_1.isPresent)(tags)) {
+        throw new Error('Provide --private-notes or --tags.');
+    }
+    return {
+        calendarMeetingId,
+        privateNotes,
+        ...((0, value_1.isPresent)(tags) && { tagIds: await (0, tag_1.resolveTagValues)(tags) }),
+    };
+});

package/dist/commands/meetings.js

@@ -1,12 +1,13 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.shareMeetingCommand = exports.readMeetingsCommand = exports.searchMeetingsCommand = void 0;
+exports.updateMeetingCommand = exports.shareMeetingCommand = exports.readMeetingsCommand = exports.searchMeetingsCommand = void 0;
 const commander_1 = require("commander");
 const constants_1 = require("../constants");
 const command_1 = require("../helpers/command");
 const date_1 = require("../helpers/date");
 const parse_1 = require("../helpers/parse");
 const tag_1 = require("../helpers/tag");
+const value_1 = require("../helpers/value");
 const types_1 = require("../types");
 const DEFAULT_MEETINGS_SEARCH_LAST_DAYS = 7;
 exports.searchMeetingsCommand = (0, command_1.defineToolCommand)(new commander_1.Command('search')
@@ -62,7 +63,7 @@ exports.shareMeetingCommand = (0, command_1.defineToolCommand)(new commander_1.C
         options.workspace,
         options.link,
     ];
-    if (targets.every((target) => target === undefined)) {
+    if (!targets.some(value_1.isPresent)) {
         throw new Error('Set at least one of --email, --profile, --team, --workspace, or --link.');
     }
     if ((options.email || options.profile) && !options.access) {
@@ -98,3 +99,19 @@ exports.shareMeetingCommand = (0, command_1.defineToolCommand)(new commander_1.C
         ],
     };
 });
+exports.updateMeetingCommand = (0, command_1.defineToolCommand)(new commander_1.Command('update')
+    .description('Update a meeting. Each option replaces the current value when provided.')
+    .argument('<id>', 'Meeting ID')
+    .option('--name <name>', 'Update the meeting name')
+    .option('--notes <notes>', 'Update the meeting notes (supports Markdown)')
+    .option('--private-notes <notes>', constants_1.PRIVATE_NOTES_UPDATE_OPTION_DESCRIPTION)
+    .option('--tags <tags>', constants_1.TAGS_UPDATE_OPTION_DESCRIPTION), types_1.ToolName.UpdateMeeting, async (meetingId, { tags, ...fields }) => {
+    if (!(0, value_1.isPresent)(tags) && !Object.values(fields).some(value_1.isPresent)) {
+        throw new Error('Provide at least one field to update.');
+    }
+    return {
+        meetingId,
+        ...fields,
+        ...((0, value_1.isPresent)(tags) && { tagIds: await (0, tag_1.resolveTagValues)(tags) }),
+    };
+});

package/dist/commands/registry.js

@@ -17,10 +17,11 @@ const standaloneCommands = [auth_1.authCommand, update_1.updateCommand];
 const commandGroups = [
     {
         name: 'meetings',
-        description: 'Find, read, and share meetings.',
+        description: 'Find, read, update, and share meetings.',
         subcommands: [
             meetings_1.searchMeetingsCommand,
             meetings_1.readMeetingsCommand,
+            meetings_1.updateMeetingCommand,
             meetings_1.shareMeetingCommand,
         ],
     },
@@ -31,8 +32,8 @@ const commandGroups = [
     },
     {
         name: 'calendar',
-        description: 'Search calendar events.',
-        subcommands: [calendar_1.searchCalendarCommand],
+        description: 'Search and update calendar events.',
+        subcommands: [calendar_1.searchCalendarCommand, calendar_1.updateCalendarEventCommand],
     },
     {
         name: 'people',
@@ -72,8 +73,6 @@ const commandGroups = [
             tags_1.createTagCommand,
             tags_1.updateTagCommand,
             tags_1.deleteTagCommand,
-            tags_1.applyTagCommand,
-            tags_1.unapplyTagCommand,
         ],
     },
 ];

package/dist/commands/tags.js

@@ -1,9 +1,10 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.unapplyTagCommand = exports.applyTagCommand = exports.deleteTagCommand = exports.updateTagCommand = exports.createTagCommand = exports.listTagsCommand = void 0;
+exports.deleteTagCommand = exports.updateTagCommand = exports.createTagCommand = exports.listTagsCommand = void 0;
 const commander_1 = require("commander");
 const command_1 = require("../helpers/command");
 const parse_1 = require("../helpers/parse");
+const value_1 = require("../helpers/value");
 const types_1 = require("../types");
 const createColorOption = () => new commander_1.Option('--color <color>', 'Set the display color').choices([
     'neutral',
@@ -18,10 +19,6 @@ const createColorOption = () => new commander_1.Option('--color <color>', 'Set t
     'purple',
 ]);
 const getTagColor = (color) => color ? `bg-tag-${color}` : undefined;
-const getTagAssignment = (identifier, meetingIds) => ({
-    tagId: (0, parse_1.parseIntOption)(identifier, 'id'),
-    meetingIds,
-});
 exports.listTagsCommand = (0, command_1.defineToolCommand)(new commander_1.Command('list').description('List all tags.'), types_1.ToolName.ListTags, () => ({ intent: 'Listing all tags.' }));
 exports.createTagCommand = (0, command_1.defineToolCommand)(new commander_1.Command('create')
     .description('Create a tag.')
@@ -38,7 +35,7 @@ exports.updateTagCommand = (0, command_1.defineToolCommand)(new commander_1.Comm
     .option('--name <name>', 'Set the name')
     .option('--description <description>', 'Set the description')
     .addOption(createColorOption()), types_1.ToolName.UpdateTag, (identifier, options) => {
-    if (!Object.values(options).some((value) => value !== undefined)) {
+    if (!Object.values(options).some(value_1.isPresent)) {
         throw new Error('Provide at least one field to update.');
     }
     return {
@@ -49,11 +46,3 @@ exports.updateTagCommand = (0, command_1.defineToolCommand)(new commander_1.Comm
     };
 });
 exports.deleteTagCommand = (0, command_1.defineToolCommand)(new commander_1.Command('delete').description('Delete a tag.').argument('<id>', 'Tag ID'), types_1.ToolName.DeleteTag, (identifier) => ({ tagId: (0, parse_1.parseIntOption)(identifier, 'id') }));
-exports.applyTagCommand = (0, command_1.defineToolCommand)(new commander_1.Command('apply')
-    .description('Add a tag to meetings.')
-    .argument('<id>', 'Tag ID')
-    .argument('<meetingIds...>', 'Meeting IDs'), types_1.ToolName.AddTagToMeetings, getTagAssignment);
-exports.unapplyTagCommand = (0, command_1.defineToolCommand)(new commander_1.Command('unapply')
-    .description('Remove a tag from meetings.')
-    .argument('<id>', 'Tag ID')
-    .argument('<meetingIds...>', 'Meeting IDs'), types_1.ToolName.RemoveTagFromMeetings, getTagAssignment);

package/dist/constants.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.DOMAINS_OPTION_DESCRIPTION = exports.PROFILES_OPTION_DESCRIPTION = exports.TAGS_OPTION_DESCRIPTION = exports.END_DATE_OPTION_DESCRIPTION = exports.START_DATE_OPTION_DESCRIPTION = exports.PAGE_OPTION_DESCRIPTION = exports.UNASSIGNED_ACTION_ITEM_ASSIGNEE_LABEL = exports.DEFAULT_MEETING_NAME = exports.MAX_READ_MEETING_IDENTIFIERS = exports.CALLBACK_TIMEOUT_MILLISECONDS = exports.OAUTH_SCOPE = exports.TOKENS_FILE = exports.CONFIG_DIRECTORY = exports.ASCII_LOGO = exports.SECONDARY_COLOR = exports.BRAND_COLOR = exports.API_KEY_SETTINGS_URL = exports.API_KEY_ENVIRONMENT_VARIABLE = exports.API_KEY_PREFIX = exports.CLIENT_VERSION_HEADER = exports.CLIENT_VERSION = exports.CLIENT_PACKAGE_NAME = exports.CLIENT_NAME = exports.BASE_URL = void 0;
+exports.DOMAINS_OPTION_DESCRIPTION = exports.PROFILES_OPTION_DESCRIPTION = exports.PRIVATE_NOTES_UPDATE_OPTION_DESCRIPTION = exports.TAGS_UPDATE_OPTION_DESCRIPTION = exports.TAGS_OPTION_DESCRIPTION = exports.END_DATE_OPTION_DESCRIPTION = exports.START_DATE_OPTION_DESCRIPTION = exports.PAGE_OPTION_DESCRIPTION = exports.UNASSIGNED_ACTION_ITEM_ASSIGNEE_LABEL = exports.DEFAULT_MEETING_NAME = exports.MAX_READ_MEETING_IDENTIFIERS = exports.CALLBACK_TIMEOUT_MILLISECONDS = exports.OAUTH_SCOPE = exports.TOKENS_FILE = exports.CONFIG_DIRECTORY = exports.ASCII_LOGO = exports.SECONDARY_COLOR = exports.BRAND_COLOR = exports.API_KEY_SETTINGS_URL = exports.API_KEY_ENVIRONMENT_VARIABLE = exports.API_KEY_PREFIX = exports.CLIENT_VERSION_HEADER = 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"));
@@ -52,5 +52,7 @@ exports.PAGE_OPTION_DESCRIPTION = 'Page index (starts at 0)';
 exports.START_DATE_OPTION_DESCRIPTION = 'Start date (YYYY-MM-DD)';
 exports.END_DATE_OPTION_DESCRIPTION = 'End date (YYYY-MM-DD)';
 exports.TAGS_OPTION_DESCRIPTION = 'Comma-separated tag names or IDs';
+exports.TAGS_UPDATE_OPTION_DESCRIPTION = 'Update the tags (comma-separated names or IDs, or "" to remove all)';
+exports.PRIVATE_NOTES_UPDATE_OPTION_DESCRIPTION = 'Update your private notes (supports Markdown)';
 exports.PROFILES_OPTION_DESCRIPTION = 'Comma-separated profile IDs';
 exports.DOMAINS_OPTION_DESCRIPTION = 'Comma-separated domains';

package/dist/helpers/formatter.js

@@ -86,8 +86,8 @@ const formatForTool = (toolName, data) => {
             return (0, table_1.formatActionItems)(data);
         case types_1.ToolName.ListTags:
             return (0, table_1.formatTags)(data);
-        case types_1.ToolName.AddTagToMeetings:
-        case types_1.ToolName.RemoveTagFromMeetings:
+        case types_1.ToolName.UpdateMeeting:
+        case types_1.ToolName.UpdateCalendarEvent:
             return;
         default: {
             const _absurd = toolName;

package/dist/helpers/table.js

@@ -140,17 +140,26 @@ const formatCalendarEvents = (events) => {
     const table = new cli_table3_1.default({
         head: [
             style_1.brand.bold('Title'),
+            style_1.brand.bold('ID'),
             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],
+        colWidths: [
+            30,
+            idColumnWidth(events.map((event) => event.id)),
+            20,
+            20,
+            12,
+            35,
+        ],
         wordWrap: true,
         style: style_1.tableStyle,
     });
     table.push(...events.map((event) => [
         (0, string_1.truncate)(event.title, 28),
+        event.id,
         (0, date_1.formatDateTime)(event.startTime),
         (0, date_1.formatDateTime)(event.endTime),
         event.platform ?? '-',

package/dist/helpers/tag.js

@@ -22,10 +22,8 @@ const resolveTagValues = async (value) => {
         .split(',')
         .map((part) => part.trim())
         .filter((part) => part.length > 0);
-    if (parts.length === 0) {
-        (0, output_1.printText)('No tag values provided.', output_1.TextType.Error);
-        process.exit(1);
-    }
+    if (parts.length === 0)
+        return [];
     const tagList = await fetchUserTags();
     if (typeof tagList === 'string') {
         (0, output_1.printText)('Failed to fetch tags.', output_1.TextType.Error);

package/dist/helpers/value.js

@@ -0,0 +1,5 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isPresent = void 0;
+const isPresent = (value) => value !== null && value !== undefined;
+exports.isPresent = isPresent;

package/dist/types.js

@@ -31,9 +31,9 @@ var ToolName;
     ToolName["CreateTag"] = "CreateTag";
     ToolName["UpdateTag"] = "UpdateTag";
     ToolName["DeleteTag"] = "DeleteTag";
-    ToolName["AddTagToMeetings"] = "AddTagToMeetings";
-    ToolName["RemoveTagFromMeetings"] = "RemoveTagFromMeetings";
     ToolName["ShareMeeting"] = "ShareMeeting";
+    ToolName["UpdateMeeting"] = "UpdateMeeting";
+    ToolName["UpdateCalendarEvent"] = "UpdateCalendarEvent";
 })(ToolName || (exports.ToolName = ToolName = {}));
 var ActionItemStatus;
 (function (ActionItemStatus) {

package/package.json

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