@circleback/cli 0.5.0 → 0.6.0

package/README.md

@@ -40,26 +40,31 @@ 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 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                                                       |
+| 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 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                                      |
 
 Run `cb --help` or `cb <command> --help` for full usage details.
 
@@ -110,7 +115,7 @@ For stateless automation, set `CIRCLEBACK_API_KEY` instead of logging in:
 CIRCLEBACK_API_KEY=cb_your_api_key cb meetings --json
 ```
 
-Creating, updating, and deleting action items needs write access. Browser logins from before v0.5.0 only granted read access, so run `cb auth login` again; read-only API keys can't make changes.
+Changing action items or tags 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/registry.js

@@ -62,8 +62,15 @@ const commandGroups = [
     },
     {
         name: 'tags',
-        description: 'List tags.',
-        subcommands: [tags_1.listTagsCommand],
+        description: 'List and manage tags.',
+        subcommands: [
+            tags_1.listTagsCommand,
+            tags_1.createTagCommand,
+            tags_1.updateTagCommand,
+            tags_1.deleteTagCommand,
+            tags_1.applyTagCommand,
+            tags_1.unapplyTagCommand,
+        ],
     },
 ];
 const buildCommandGroup = (definition) => definition.subcommands.reduce((group, command, index) => group.addCommand(command, index === 0 ? { isDefault: true } : undefined), new commander_1.Command(definition.name).description(definition.description));

package/dist/commands/tags.js

@@ -1,7 +1,59 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.listTagsCommand = void 0;
+exports.unapplyTagCommand = exports.applyTagCommand = 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 types_1 = require("../types");
+const createColorOption = () => new commander_1.Option('--color <color>', 'Set the display color').choices([
+    'neutral',
+    'red',
+    'rose',
+    'orange',
+    'amber',
+    'emerald',
+    'sky',
+    'blue',
+    'indigo',
+    '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.')
+    .argument('<name>', 'Tag name')
+    .option('--description <description>', 'Set the description')
+    .addOption(createColorOption()), types_1.ToolName.CreateTag, (name, options) => ({
+    name,
+    description: options.description,
+    color: getTagColor(options.color),
+}));
+exports.updateTagCommand = (0, command_1.defineToolCommand)(new commander_1.Command('update')
+    .description('Update a tag.')
+    .argument('<id>', 'Tag ID')
+    .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)) {
+        throw new Error('Provide at least one field to update.');
+    }
+    return {
+        tagId: (0, parse_1.parseIntOption)(identifier, 'id'),
+        name: options.name,
+        description: options.description,
+        color: getTagColor(options.color),
+    };
+});
+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/helpers/formatter.js

@@ -19,6 +19,14 @@ const formatActionItemChange = (verb, data) => {
     const { id, title, status } = result.data;
     return `${verb} action item ${id}: ${title} (${status})`;
 };
+const TagChangeSchema = zod_1.z.object({ id: zod_1.z.number(), name: zod_1.z.string() });
+const formatTagChange = (verb, data) => {
+    const result = TagChangeSchema.safeParse(data);
+    if (!result.success)
+        return;
+    const { id, name } = result.data;
+    return `${verb} tag ${id}: ${name}`;
+};
 const formatForTool = (toolName, data) => {
     switch (toolName) {
         case types_1.ToolName.CreateActionItem:
@@ -27,6 +35,12 @@ const formatForTool = (toolName, data) => {
             return formatActionItemChange('Updated', data);
         case types_1.ToolName.DeleteActionItem:
             return formatActionItemChange('Deleted', data);
+        case types_1.ToolName.CreateTag:
+            return formatTagChange('Created', data);
+        case types_1.ToolName.UpdateTag:
+            return formatTagChange('Updated', data);
+        case types_1.ToolName.DeleteTag:
+            return formatTagChange('Deleted', data);
     }
     if (!Array.isArray(data))
         return;
@@ -53,6 +67,9 @@ 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:
+            return;
         default: {
             const _absurd = toolName;
             return _absurd;

package/dist/types.js

@@ -28,6 +28,11 @@ var ToolName;
     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 || (exports.ToolName = ToolName = {}));
 var ActionItemStatus;
 (function (ActionItemStatus) {

package/package.json

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