@circleback/cli 0.8.0 → 1.0.0

package/README.md

@@ -40,34 +40,33 @@ 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 update <id>`              | Update a meeting's name, notes, or private notes                |
-| `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 private notes for a meeting before it starts             |
-| `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 teams`                       | List your workspace and teams                                |
+| `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.
 

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')
@@ -35,10 +36,12 @@ exports.createActionItemCommand = (0, command_1.defineToolCommand)(new commander
     .description('Create an action item.')
     .argument('<title>', 'Action item title')
     .option('--description <description>', 'Set the description')
-    .option('--assignee <id>', 'Assign to a profile ID'), types_1.ToolName.CreateActionItem, (title, options) => ({
+    .option('--assignee <id|none>', 'Assign to a profile ID, or none to leave unassigned (defaults to you)'), types_1.ToolName.CreateActionItem, (title, options) => ({
     title,
     description: options.description,
-    assigneeProfileId: (0, parse_1.parseOptionalIntOption)(options.assignee, '--assignee'),
+    assigneeProfileId: options.assignee === 'none'
+        ? null
+        : (0, parse_1.parseOptionalIntOption)(options.assignee, '--assignee'),
 }));
 exports.updateActionItemCommand = (0, command_1.defineToolCommand)(new commander_1.Command('update')
     .description('Update an action item.')
@@ -47,14 +50,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

@@ -5,6 +5,8 @@ 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.')
@@ -17,9 +19,16 @@ exports.searchCalendarCommand = (0, command_1.defineToolCommand)(new commander_1
     endDate: options.to || undefined,
 }));
 exports.updateCalendarEventCommand = (0, command_1.defineToolCommand)(new commander_1.Command('update')
-    .description('Update private notes for a meeting before it starts. Replaces the current notes.')
+    .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`')
-    .requiredOption('--private-notes <notes>', 'Your private notes (Markdown)'), types_1.ToolName.UpdateCalendarEvent, (calendarMeetingId, { privateNotes }) => ({
-    calendarMeetingId,
-    privateNotes,
-}));
+    .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

@@ -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_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,19 +99,19 @@ exports.shareMeetingCommand = (0, command_1.defineToolCommand)(new commander_1.C
         ],
     };
 });
-const addMeetingFieldOptions = (command) => command
-    .option('--name <name>', 'Set the name')
-    .option('--notes <notes>', 'Set the notes (Markdown)')
-    .option('--private-notes <notes>', 'Set your private notes (Markdown)');
-const getMeetingFields = (fields) => {
-    if (!Object.values(fields).some((value) => value !== undefined)) {
+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 fields;
-};
-exports.updateMeetingCommand = (0, command_1.defineToolCommand)(addMeetingFieldOptions(new commander_1.Command('update')
-    .description('Update a meeting. Each option replaces the current value.')
-    .argument('<id>', 'Meeting ID')), types_1.ToolName.UpdateMeeting, (meetingId, fields) => ({
-    meetingId,
-    ...getMeetingFields(fields),
-}));
+    return {
+        meetingId,
+        ...fields,
+        ...((0, value_1.isPresent)(tags) && { tagIds: await (0, tag_1.resolveTagValues)(tags) }),
+    };
+});

package/dist/commands/registry.js

@@ -11,6 +11,7 @@ const meetings_1 = require("./meetings");
 const profiles_1 = require("./profiles");
 const support_1 = require("./support");
 const tags_1 = require("./tags");
+const teams_1 = require("./teams");
 const transcripts_1 = require("./transcripts");
 const update_1 = require("./update");
 const standaloneCommands = [auth_1.authCommand, update_1.updateCommand];
@@ -55,6 +56,11 @@ const commandGroups = [
         description: 'Search emails.',
         subcommands: [emails_1.searchEmailsCommand],
     },
+    {
+        name: 'teams',
+        description: 'List your workspace and teams.',
+        subcommands: [teams_1.listTeamsCommand],
+    },
     {
         name: 'action-items',
         description: 'Search, create, update, and delete action items.',
@@ -73,8 +79,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/commands/teams.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.listTeamsCommand = void 0;
+const commander_1 = require("commander");
+const command_1 = require("../helpers/command");
+const types_1 = require("../types");
+exports.listTeamsCommand = (0, command_1.defineToolCommand)(new commander_1.Command('list').description('List your workspace and teams.'), types_1.ToolName.ListTeams, () => ({}));

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,7 @@ 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.ListTeams:
         case types_1.ToolName.UpdateMeeting:
         case types_1.ToolName.UpdateCalendarEvent:
             return;

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

@@ -25,14 +25,13 @@ var ToolName;
     ToolName["SearchEmails"] = "SearchEmails";
     ToolName["SearchActionItems"] = "SearchActionItems";
     ToolName["ListTags"] = "ListTags";
+    ToolName["ListTeams"] = "ListTeams";
     ToolName["CreateActionItem"] = "CreateActionItem";
     ToolName["UpdateActionItem"] = "UpdateActionItem";
     ToolName["DeleteActionItem"] = "DeleteActionItem";
     ToolName["CreateTag"] = "CreateTag";
     ToolName["UpdateTag"] = "UpdateTag";
     ToolName["DeleteTag"] = "DeleteTag";
-    ToolName["AddTagToMeetings"] = "AddTagToMeetings";
-    ToolName["RemoveTagFromMeetings"] = "RemoveTagFromMeetings";
     ToolName["ShareMeeting"] = "ShareMeeting";
     ToolName["UpdateMeeting"] = "UpdateMeeting";
     ToolName["UpdateCalendarEvent"] = "UpdateCalendarEvent";

package/package.json

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