@circleback/cli 0.4.1 → 0.5.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,35 @@ 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                                                       |
 
 Run `cb --help` or `cb <command> --help` for full usage details.
 
@@ -102,6 +110,8 @@ 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.
+
 `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 +127,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,8 +52,13 @@ 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',

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,27 @@ 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 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);
+    }
     if (!Array.isArray(data))
         return;
     switch (toolName) {

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,15 @@ var ToolName;
     ToolName["SearchEmails"] = "SearchEmails";
     ToolName["SearchActionItems"] = "SearchActionItems";
     ToolName["ListTags"] = "ListTags";
+    ToolName["CreateActionItem"] = "CreateActionItem";
+    ToolName["UpdateActionItem"] = "UpdateActionItem";
+    ToolName["DeleteActionItem"] = "DeleteActionItem";
 })(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.5.0",
   "description": "Circleback CLI. Search and access meetings, emails, calendar events, and more.",
   "license": "MIT",
   "author": "Circleback <support@circleback.ai> (https://circleback.ai)",