@circleback/cli 0.4.1 → 0.6.0

package/README.md

@@ -1,6 +1,6 @@
 # Circleback CLI
 
-Search and access your meetings, transcripts, emails, calendar events, and more from the terminal.
+Search and access your meetings, transcripts, emails, calendar events, and more from the terminal, and manage your action items.
 
 ## Installation
 
@@ -31,27 +31,40 @@ cb transcripts "pricing discussion"
 # Search emails
 cb emails "from:alice@example.com after:2026-01-01"
 
+# Mark an action item done
+cb action-items update 123 --status DONE
+
 # Get raw JSON for scripting
 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                           |
+| 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.
 
@@ -102,6 +115,8 @@ For stateless automation, set `CIRCLEBACK_API_KEY` instead of logging in:
 CIRCLEBACK_API_KEY=cb_your_api_key cb meetings --json
 ```
 
+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.
 
 ## Agents
@@ -117,4 +132,4 @@ The CLI is designed to work well with AI agents and tool-use systems:
 ## Links
 
 - [Circleback](https://circleback.ai)
-- [Support](https://support.circleback.ai)
+- [Support](https://circleback.ai/docs/support)

package/dist/client/jsonRpc.js

@@ -25,6 +25,7 @@ const extractErrorMessage = async (response) => {
         return text;
     }
 };
+const WRITE_ACCESS_HINT = 'Run `circleback auth login` again or use a write-enabled API key.';
 const HTTP_ERROR_MESSAGES = {
     401: 'Authentication expired. Run `circleback auth login` to re-authenticate.',
     403: 'Permission denied.',
@@ -132,9 +133,10 @@ const callTool = async (toolName, toolArguments) => {
     if (!response.ok) {
         const fallback = HTTP_ERROR_MESSAGES[response.status];
         const serverMessage = await extractErrorMessage(response);
-        throw new Error(serverMessage ||
+        const message = serverMessage ||
             fallback ||
-            `Request failed with status ${response.status}.`);
+            `Request failed with status ${response.status}.`;
+        throw new Error(response.status === 403 ? `${message} ${WRITE_ACCESS_HINT}` : message);
     }
     return parseResponse(response);
 };

package/dist/commands/actionItems.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.searchActionItemsCommand = void 0;
+exports.deleteActionItemCommand = exports.updateActionItemCommand = exports.createActionItemCommand = exports.searchActionItemsCommand = void 0;
 const commander_1 = require("commander");
 const constants_1 = require("../constants");
 const command_1 = require("../helpers/command");
@@ -31,3 +31,34 @@ exports.searchActionItemsCommand = (0, command_1.defineToolCommand)(new commande
     tags: options.tags ? await (0, tag_1.resolveTagValues)(options.tags) : undefined,
     assigneeProfileId: (0, parse_1.parseOptionalIntOption)(options.assignee, '--assignee'),
 }));
+exports.createActionItemCommand = (0, command_1.defineToolCommand)(new commander_1.Command('create')
+    .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) => ({
+    title,
+    description: options.description,
+    assigneeProfileId: (0, parse_1.parseOptionalIntOption)(options.assignee, '--assignee'),
+}));
+exports.updateActionItemCommand = (0, command_1.defineToolCommand)(new commander_1.Command('update')
+    .description('Update an action item.')
+    .argument('<id>', 'Action item ID')
+    .option('--title <title>', 'Set the title')
+    .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)) {
+        throw new Error('Provide at least one field to update.');
+    }
+    return {
+        actionItemId: (0, parse_1.parseIntOption)(identifier, 'id'),
+        ...fields,
+        ...(assignee !== undefined && {
+            assigneeProfileId: assignee === 'none' ? null : (0, parse_1.parseIntOption)(assignee, '--assignee'),
+        }),
+    };
+});
+exports.deleteActionItemCommand = (0, command_1.defineToolCommand)(new commander_1.Command('delete')
+    .description('Delete an action item.')
+    .argument('<id>', 'Action item ID'), types_1.ToolName.DeleteActionItem, (identifier) => ({ actionItemId: (0, parse_1.parseIntOption)(identifier, 'id') }));

package/dist/commands/registry.js

@@ -52,13 +52,25 @@ const commandGroups = [
     },
     {
         name: 'action-items',
-        description: 'Search action items.',
-        subcommands: [actionItems_1.searchActionItemsCommand],
+        description: 'Search, create, update, and delete action items.',
+        subcommands: [
+            actionItems_1.searchActionItemsCommand,
+            actionItems_1.createActionItemCommand,
+            actionItems_1.updateActionItemCommand,
+            actionItems_1.deleteActionItemCommand,
+        ],
     },
     {
         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/constants.js

@@ -43,7 +43,7 @@ exports.ASCII_LOGO = `
                 =============            +++++`;
 exports.CONFIG_DIRECTORY = node_path_1.default.join(node_os_1.default.homedir(), '.config', 'circleback');
 exports.TOKENS_FILE = node_path_1.default.join(exports.CONFIG_DIRECTORY, 'tokens.json');
-exports.OAUTH_SCOPE = 'user';
+exports.OAUTH_SCOPE = 'user user:write';
 exports.CALLBACK_TIMEOUT_MILLISECONDS = 120_000;
 exports.MAX_READ_MEETING_IDENTIFIERS = 50;
 exports.DEFAULT_MEETING_NAME = 'New meeting';

package/dist/helpers/formatter.js

@@ -7,7 +7,41 @@ const output_1 = require("./output");
 const zod_1 = require("zod");
 const types_1 = require("../types");
 const stringify = (value) => typeof value === 'string' ? value : JSON.stringify(value, null, 2);
+const ActionItemChangeSchema = zod_1.z.object({
+    id: zod_1.z.number(),
+    title: zod_1.z.string(),
+    status: zod_1.z.string(),
+});
+const formatActionItemChange = (verb, data) => {
+    const result = ActionItemChangeSchema.safeParse(data);
+    if (!result.success)
+        return;
+    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:
+            return formatActionItemChange('Created', data);
+        case types_1.ToolName.UpdateActionItem:
+            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;
     switch (toolName) {
@@ -33,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

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.isJsonRpcResponse = exports.jsonRpcResultSchema = exports.isOAuthTokenResponse = exports.isStoredApiKey = exports.parseStoredCredentials = exports.ToolName = exports.CredentialSource = exports.CredentialType = void 0;
+exports.isJsonRpcResponse = exports.jsonRpcResultSchema = exports.isOAuthTokenResponse = exports.isStoredApiKey = exports.parseStoredCredentials = exports.ActionItemStatus = exports.ToolName = exports.CredentialSource = exports.CredentialType = void 0;
 const zod_1 = require("zod");
 var CredentialType;
 (function (CredentialType) {
@@ -25,7 +25,20 @@ var ToolName;
     ToolName["SearchEmails"] = "SearchEmails";
     ToolName["SearchActionItems"] = "SearchActionItems";
     ToolName["ListTags"] = "ListTags";
+    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) {
+    ActionItemStatus["Pending"] = "PENDING";
+    ActionItemStatus["Done"] = "DONE";
+})(ActionItemStatus || (exports.ActionItemStatus = ActionItemStatus = {}));
 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.4.1",
+  "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)",