@circleback/cli 0.5.0 → 0.7.0

package/README.md

@@ -1,6 +1,6 @@
 # Circleback CLI
 
-Search and access your meetings, transcripts, emails, calendar events, and more from the terminal, and manage your action items.
+Search and access your meetings, transcripts, emails, calendar events, and more from the terminal, and manage your action items, tags, and meeting access.
 
 ## Installation
 
@@ -22,8 +22,8 @@ cb meetings
 # Search by keyword
 cb meetings "product review"
 
-# Read by ID (from the meeting URL, e.g. circleback.ai/meetings/Vd6Pz8WqLm3xY2cRhTn7K)
-cb meetings read Vd6Pz8WqLm3xY2cRhTn7K
+# Read by ID (from the meeting URL, e.g. circleback.ai/meetings/abc123)
+cb meetings read abc123
 
 # Search transcripts
 cb transcripts "pricing discussion"
@@ -40,26 +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 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 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                                      |
 
 Run `cb --help` or `cb <command> --help` for full usage details.
 
@@ -110,7 +116,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, 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.
 
 `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/meetings.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.readMeetingsCommand = exports.searchMeetingsCommand = void 0;
+exports.shareMeetingCommand = exports.readMeetingsCommand = exports.searchMeetingsCommand = void 0;
 const commander_1 = require("commander");
 const constants_1 = require("../constants");
 const command_1 = require("../helpers/command");
@@ -43,3 +43,58 @@ exports.readMeetingsCommand = (0, command_1.defineToolCommand)(new commander_1.C
         meetingIds,
     };
 });
+const ACCESS_LEVELS = [...Object.values(types_1.ShareableMeetingAccess), 'none'];
+const getAccess = (access) => access === 'none' ? null : access;
+exports.shareMeetingCommand = (0, command_1.defineToolCommand)(new commander_1.Command('share')
+    .description('Share a meeting, or remove access with --access none.')
+    .argument('<id>', 'Meeting ID')
+    .option('--email <emails>', 'Share with email addresses (comma-separated)')
+    .option('--profile <ids>', 'Share with people (comma-separated)')
+    .option('--workspace <ids>', 'Share with workspaces (comma-separated)')
+    .option('--team <ids>', 'Share with teams (comma-separated)')
+    .addOption(new commander_1.Option('--access <access>', 'Set the access level, or none to remove access (required with --email or --profile)').choices(ACCESS_LEVELS))
+    .addOption(new commander_1.Option('--link <access>', 'Set the meeting link access, or none to turn it off').choices(ACCESS_LEVELS))
+    .option('--send-email', 'Email the people the meeting is shared with'), types_1.ToolName.ShareMeeting, (meetingId, options) => {
+    const targets = [
+        options.email,
+        options.profile,
+        options.team,
+        options.workspace,
+        options.link,
+    ];
+    if (targets.every((target) => target === undefined)) {
+        throw new Error('Set at least one of --email, --profile, --team, --workspace, or --link.');
+    }
+    if ((options.email || options.profile) && !options.access) {
+        throw new Error('--access is required with --email or --profile.');
+    }
+    const access = getAccess(options.access);
+    const sendEmail = options.sendEmail;
+    const parseIds = (value, label) => value ? (0, parse_1.parseNumericIds)(value, label) : [];
+    return {
+        meetingId,
+        shares: [
+            ...(options.email?.split(',') ?? []).map((email) => ({
+                email: email.trim(),
+                access,
+                sendEmail,
+            })),
+            ...parseIds(options.profile, 'profile ID').map((profileId) => ({
+                profileId,
+                access,
+                sendEmail,
+            })),
+            ...parseIds(options.team, 'team ID').map((teamId) => ({
+                teamId,
+                access,
+                sendEmail,
+            })),
+            ...parseIds(options.workspace, 'workspace ID').map((workspaceId) => ({
+                workspaceId,
+                access,
+                sendEmail,
+            })),
+            ...(options.link ? [{ linkAccess: getAccess(options.link) }] : []),
+        ],
+    };
+});

package/dist/commands/registry.js

@@ -17,8 +17,12 @@ const standaloneCommands = [auth_1.authCommand, update_1.updateCommand];
 const commandGroups = [
     {
         name: 'meetings',
-        description: 'Find meetings and read notes.',
-        subcommands: [meetings_1.searchMeetingsCommand, meetings_1.readMeetingsCommand],
+        description: 'Find, read, and share meetings.',
+        subcommands: [
+            meetings_1.searchMeetingsCommand,
+            meetings_1.readMeetingsCommand,
+            meetings_1.shareMeetingCommand,
+        ],
     },
     {
         name: 'transcripts',
@@ -62,8 +66,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,31 @@ 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 MeetingShareChangeSchema = zod_1.z.object({
+    id: zod_1.z.string(),
+    name: zod_1.z.string().nullable(),
+    errors: zod_1.z
+        .array(zod_1.z.object({ index: zod_1.z.number(), error: zod_1.z.string() }))
+        .optional(),
+});
+const formatMeetingShareChange = (data) => {
+    const result = MeetingShareChangeSchema.safeParse(data);
+    if (!result.success)
+        return;
+    const { id, name, errors = [] } = result.data;
+    return [
+        `Updated sharing for meeting ${id}${name ? `: ${name}` : ''}`,
+        ...errors.map(({ index, error }) => `Could not share target ${index + 1}: ${error}`),
+    ].join('\n');
+};
 const formatForTool = (toolName, data) => {
     switch (toolName) {
         case types_1.ToolName.CreateActionItem:
@@ -27,6 +52,14 @@ 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);
+        case types_1.ToolName.ShareMeeting:
+            return formatMeetingShareChange(data);
     }
     if (!Array.isArray(data))
         return;
@@ -53,6 +86,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

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.isJsonRpcResponse = exports.jsonRpcResultSchema = exports.isOAuthTokenResponse = exports.isStoredApiKey = exports.parseStoredCredentials = exports.ActionItemStatus = exports.ToolName = exports.CredentialSource = exports.CredentialType = void 0;
+exports.isJsonRpcResponse = exports.jsonRpcResultSchema = exports.isOAuthTokenResponse = exports.isStoredApiKey = exports.parseStoredCredentials = exports.ShareableMeetingAccess = exports.ActionItemStatus = exports.ToolName = exports.CredentialSource = exports.CredentialType = void 0;
 const zod_1 = require("zod");
 var CredentialType;
 (function (CredentialType) {
@@ -28,12 +28,24 @@ 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["ShareMeeting"] = "ShareMeeting";
 })(ToolName || (exports.ToolName = ToolName = {}));
 var ActionItemStatus;
 (function (ActionItemStatus) {
     ActionItemStatus["Pending"] = "PENDING";
     ActionItemStatus["Done"] = "DONE";
 })(ActionItemStatus || (exports.ActionItemStatus = ActionItemStatus = {}));
+var ShareableMeetingAccess;
+(function (ShareableMeetingAccess) {
+    ShareableMeetingAccess["Editor"] = "Editor";
+    ShareableMeetingAccess["Viewer"] = "Viewer";
+    ShareableMeetingAccess["LimitedViewer"] = "LimitedViewer";
+})(ShareableMeetingAccess || (exports.ShareableMeetingAccess = ShareableMeetingAccess = {}));
 const storedTokensSchema = zod_1.z.object({
     accessToken: zod_1.z.string(),
     refreshToken: zod_1.z.string(),

package/package.json

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