@circleback/cli 0.4.0 → 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,17 +1,15 @@
 "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 jsonRpc_1 = require("../client/jsonRpc");
 const constants_1 = require("../constants");
+const command_1 = require("../helpers/command");
 const date_1 = require("../helpers/date");
-const error_1 = require("../helpers/error");
-const output_1 = require("../helpers/output");
-const formatter_1 = require("../helpers/formatter");
 const parse_1 = require("../helpers/parse");
 const tag_1 = require("../helpers/tag");
+const types_1 = require("../types");
 const DEFAULT_ACTION_ITEMS_SEARCH_LAST_DAYS = 30;
-exports.searchActionItemsCommand = new commander_1.Command('search')
+exports.searchActionItemsCommand = (0, command_1.defineToolCommand)(new commander_1.Command('search')
     .description('Search action items.')
     .argument('[search]', 'Search term')
     .option('-p, --page <index>', constants_1.PAGE_OPTION_DESCRIPTION, '0')
@@ -20,45 +18,47 @@ exports.searchActionItemsCommand = new commander_1.Command('search')
     .option('--from <date>', constants_1.START_DATE_OPTION_DESCRIPTION)
     .option('--to <date>', constants_1.END_DATE_OPTION_DESCRIPTION)
     .option('--tags <tags>', constants_1.TAGS_OPTION_DESCRIPTION)
-    .option('--assignee <id>', 'Filter by assignee profile ID')
-    .action(async (query, options) => {
-    try {
-        if (options.last && options.from) {
-            (0, output_1.printText)(constants_1.LAST_AND_FROM_CONFLICT_ERROR, output_1.TextType.Error);
-            process.exit(1);
-        }
-        const jsonMode = exports.searchActionItemsCommand.parent?.parent?.opts().json ?? false;
-        const pageIndex = (0, parse_1.parseIntOption)(options.page, '--page');
-        const args = {
-            intent: query ?? 'Listing recent action items.',
-            pageIndex,
-        };
-        if (query)
-            args['searchTerms'] = [query];
-        if (options.status)
-            args['status'] = options.status;
-        if (options.last) {
-            args['startDate'] = (0, date_1.getStartDateFromDaysAgo)((0, parse_1.parseIntOption)(options.last, '--last'));
-        }
-        else if (options.from) {
-            args['startDate'] = options.from;
-        }
-        else if (!query) {
-            args['startDate'] = (0, date_1.getStartDateFromDaysAgo)(DEFAULT_ACTION_ITEMS_SEARCH_LAST_DAYS);
-        }
-        if (options.to)
-            args['endDate'] = options.to;
-        if (options.tags) {
-            args['tags'] = await (0, tag_1.resolveTagValues)(options.tags);
-        }
-        if (options.assignee)
-            args['assigneeProfileId'] = (0, parse_1.parseIntOption)(options.assignee, '--assignee');
-        const result = await (0, jsonRpc_1.callTool)('SearchActionItems', args);
-        (0, formatter_1.formatOutput)('SearchActionItems', result, jsonMode);
-    }
-    catch (error) {
-        const message = error instanceof Error ? error.message : constants_1.SEARCH_FAILED_ERROR;
-        (0, output_1.printText)((0, error_1.formatMcpError)(message) ?? message, output_1.TextType.Error);
-        process.exit(1);
+    .option('--assignee <id>', 'Filter by assignee profile ID'), types_1.ToolName.SearchActionItems, async (query, options) => ({
+    intent: query ?? 'Listing recent action items.',
+    pageIndex: (0, parse_1.parseIntOption)(options.page, '--page'),
+    searchTerms: query ? [query] : undefined,
+    status: options.status || undefined,
+    startDate: (0, date_1.getStartDate)(options) ??
+        (query
+            ? undefined
+            : (0, date_1.getStartDateFromDaysAgo)(DEFAULT_ACTION_ITEMS_SEARCH_LAST_DAYS)),
+    endDate: options.to || undefined,
+    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/calendar.js

@@ -2,43 +2,17 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.searchCalendarCommand = void 0;
 const commander_1 = require("commander");
-const jsonRpc_1 = require("../client/jsonRpc");
 const constants_1 = require("../constants");
+const command_1 = require("../helpers/command");
 const date_1 = require("../helpers/date");
-const error_1 = require("../helpers/error");
-const output_1 = require("../helpers/output");
-const formatter_1 = require("../helpers/formatter");
-const parse_1 = require("../helpers/parse");
-exports.searchCalendarCommand = new commander_1.Command('search')
+const types_1 = require("../types");
+exports.searchCalendarCommand = (0, command_1.defineToolCommand)(new commander_1.Command('search')
     .description('Search calendar events.')
     .option('--last <days>', 'Show events from the last N days')
     .option('--from <date>', constants_1.START_DATE_OPTION_DESCRIPTION)
-    .option('--to <date>', constants_1.END_DATE_OPTION_DESCRIPTION)
-    .action(async (options) => {
-    try {
-        if (options.last && options.from) {
-            (0, output_1.printText)(constants_1.LAST_AND_FROM_CONFLICT_ERROR, output_1.TextType.Error);
-            process.exit(1);
-        }
-        const jsonMode = exports.searchCalendarCommand.parent?.parent?.opts().json ?? false;
-        const args = {
-            intent: 'Listing calendar events.',
-            pageIndex: 0,
-        };
-        if (options.last) {
-            args['startDate'] = (0, date_1.getStartDateFromDaysAgo)((0, parse_1.parseIntOption)(options.last, '--last'));
-        }
-        else if (options.from) {
-            args['startDate'] = options.from;
-        }
-        if (options.to)
-            args['endDate'] = options.to;
-        const result = await (0, jsonRpc_1.callTool)('SearchCalendarEvents', args);
-        (0, formatter_1.formatOutput)('SearchCalendarEvents', result, jsonMode);
-    }
-    catch (error) {
-        const message = error instanceof Error ? error.message : 'Calendar search failed.';
-        (0, output_1.printText)((0, error_1.formatMcpError)(message) ?? message, output_1.TextType.Error);
-        process.exit(1);
-    }
-});
+    .option('--to <date>', constants_1.END_DATE_OPTION_DESCRIPTION), types_1.ToolName.SearchCalendarEvents, (options) => ({
+    intent: 'Listing calendar events.',
+    pageIndex: 0,
+    startDate: (0, date_1.getStartDate)(options),
+    endDate: options.to || undefined,
+}));

package/dist/commands/companies.js

@@ -2,24 +2,8 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.searchCompaniesCommand = void 0;
 const commander_1 = require("commander");
-const jsonRpc_1 = require("../client/jsonRpc");
-const error_1 = require("../helpers/error");
-const output_1 = require("../helpers/output");
-const formatter_1 = require("../helpers/formatter");
-exports.searchCompaniesCommand = new commander_1.Command('search')
+const command_1 = require("../helpers/command");
+const types_1 = require("../types");
+exports.searchCompaniesCommand = (0, command_1.defineToolCommand)(new commander_1.Command('search')
     .description('Search companies.')
-    .argument('<terms...>', 'Search terms for company names or domains')
-    .action(async (terms) => {
-    try {
-        const jsonMode = exports.searchCompaniesCommand.parent?.parent?.opts().json ?? false;
-        const result = await (0, jsonRpc_1.callTool)('FindCompanies', {
-            searchTerms: terms,
-        });
-        (0, formatter_1.formatOutput)('FindCompanies', result, jsonMode);
-    }
-    catch (error) {
-        const message = error instanceof Error ? error.message : 'Company search failed.';
-        (0, output_1.printText)((0, error_1.formatMcpError)(message) ?? message, output_1.TextType.Error);
-        process.exit(1);
-    }
-});
+    .argument('<terms...>', 'Search terms for company names or domains'), types_1.ToolName.FindCompanies, (terms) => ({ searchTerms: terms }));

package/dist/commands/emails.js

@@ -2,35 +2,20 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.searchEmailsCommand = void 0;
 const commander_1 = require("commander");
-const jsonRpc_1 = require("../client/jsonRpc");
 const constants_1 = require("../constants");
-const error_1 = require("../helpers/error");
-const output_1 = require("../helpers/output");
-const formatter_1 = require("../helpers/formatter");
+const command_1 = require("../helpers/command");
 const parse_1 = require("../helpers/parse");
-exports.searchEmailsCommand = new commander_1.Command('search')
+const types_1 = require("../types");
+exports.searchEmailsCommand = (0, command_1.defineToolCommand)(new commander_1.Command('search')
     .description('Search connected email accounts. Supports filters: from:email, to:email, participant:email, before:YYYY-MM-DD, after:YYYY-MM-DD.')
     .argument('[search]', 'Search term')
-    .option('-p, --page <index>', constants_1.PAGE_OPTION_DESCRIPTION, '0')
-    .action(async (query, options) => {
-    try {
-        if (query !== undefined && query.trim() === '') {
-            (0, output_1.printText)('Search term cannot be empty.', output_1.TextType.Error);
-            process.exit(1);
-        }
-        const jsonMode = exports.searchEmailsCommand.parent?.parent?.opts().json ?? false;
-        const pageIndex = (0, parse_1.parseIntOption)(options.page, '--page');
-        const args = {
-            intent: query ?? 'Listing recent emails.',
-            pageIndex,
-        };
-        args['searchTerm'] = query ?? '';
-        const result = await (0, jsonRpc_1.callTool)('SearchEmails', args);
-        (0, formatter_1.formatOutput)('SearchEmails', result, jsonMode);
-    }
-    catch (error) {
-        const message = error instanceof Error ? error.message : 'Email search failed.';
-        (0, output_1.printText)((0, error_1.formatMcpError)(message) ?? message, output_1.TextType.Error);
-        process.exit(1);
+    .option('-p, --page <index>', constants_1.PAGE_OPTION_DESCRIPTION, '0'), types_1.ToolName.SearchEmails, (query, options) => {
+    if (query?.trim() === '') {
+        throw new Error('Search term cannot be empty.');
     }
+    return {
+        intent: query ?? 'Listing recent emails.',
+        pageIndex: (0, parse_1.parseIntOption)(options.page, '--page'),
+        searchTerm: query ?? '',
+    };
 });

package/dist/commands/meetings.js

@@ -2,16 +2,14 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.readMeetingsCommand = exports.searchMeetingsCommand = void 0;
 const commander_1 = require("commander");
-const jsonRpc_1 = require("../client/jsonRpc");
 const constants_1 = require("../constants");
+const command_1 = require("../helpers/command");
 const date_1 = require("../helpers/date");
-const error_1 = require("../helpers/error");
-const output_1 = require("../helpers/output");
-const formatter_1 = require("../helpers/formatter");
 const parse_1 = require("../helpers/parse");
 const tag_1 = require("../helpers/tag");
+const types_1 = require("../types");
 const DEFAULT_MEETINGS_SEARCH_LAST_DAYS = 7;
-exports.searchMeetingsCommand = new commander_1.Command('search')
+exports.searchMeetingsCommand = (0, command_1.defineToolCommand)(new commander_1.Command('search')
     .description('Search meetings.')
     .argument('[search]', 'Search term')
     .option('-p, --page <index>', constants_1.PAGE_OPTION_DESCRIPTION, '0')
@@ -20,65 +18,28 @@ exports.searchMeetingsCommand = new commander_1.Command('search')
     .option('--to <date>', constants_1.END_DATE_OPTION_DESCRIPTION)
     .option('--tags <tags>', constants_1.TAGS_OPTION_DESCRIPTION)
     .option('--profiles <ids>', constants_1.PROFILES_OPTION_DESCRIPTION)
-    .option('--domains <domains>', constants_1.DOMAINS_OPTION_DESCRIPTION)
-    .action(async (query, options) => {
-    try {
-        if (options.last && options.from) {
-            (0, output_1.printText)(constants_1.LAST_AND_FROM_CONFLICT_ERROR, output_1.TextType.Error);
-            process.exit(1);
-        }
-        const jsonMode = exports.searchMeetingsCommand.parent?.parent?.opts().json ?? false;
-        const pageIndex = (0, parse_1.parseIntOption)(options.page, '--page');
-        const args = {
-            intent: query ?? 'Listing recent meetings.',
-            pageIndex,
-        };
-        if (typeof query === 'string')
-            args['searchTerm'] = query;
-        if (options.last) {
-            args['startDate'] = (0, date_1.getStartDateFromDaysAgo)((0, parse_1.parseIntOption)(options.last, '--last'));
-        }
-        else if (options.from) {
-            args['startDate'] = options.from;
-        }
-        else if (!query) {
-            args['startDate'] = (0, date_1.getStartDateFromDaysAgo)(DEFAULT_MEETINGS_SEARCH_LAST_DAYS);
-        }
-        if (options.to)
-            args['endDate'] = options.to;
-        if (options.tags) {
-            args['tags'] = await (0, tag_1.resolveTagValues)(options.tags);
-        }
-        if (options.profiles)
-            args['profiles'] = (0, parse_1.parseNumericIds)(options.profiles, 'profile ID');
-        if (options.domains)
-            args['domains'] = options.domains.split(',');
-        const result = await (0, jsonRpc_1.callTool)('SearchMeetings', args);
-        (0, formatter_1.formatOutput)('SearchMeetings', result, jsonMode);
-    }
-    catch (error) {
-        const message = error instanceof Error ? error.message : constants_1.SEARCH_FAILED_ERROR;
-        (0, output_1.printText)((0, error_1.formatMcpError)(message) ?? message, output_1.TextType.Error);
-        process.exit(1);
-    }
-});
-exports.readMeetingsCommand = new commander_1.Command('read')
+    .option('--domains <domains>', constants_1.DOMAINS_OPTION_DESCRIPTION), types_1.ToolName.SearchMeetings, async (query, options) => ({
+    intent: query ?? 'Listing recent meetings.',
+    pageIndex: (0, parse_1.parseIntOption)(options.page, '--page'),
+    searchTerm: query,
+    startDate: (0, date_1.getStartDate)(options) ??
+        (query
+            ? undefined
+            : (0, date_1.getStartDateFromDaysAgo)(DEFAULT_MEETINGS_SEARCH_LAST_DAYS)),
+    endDate: options.to || undefined,
+    tags: options.tags ? await (0, tag_1.resolveTagValues)(options.tags) : undefined,
+    profiles: options.profiles
+        ? (0, parse_1.parseNumericIds)(options.profiles, 'profile ID')
+        : undefined,
+    domains: options.domains ? options.domains.split(',') : undefined,
+}));
+exports.readMeetingsCommand = (0, command_1.defineToolCommand)(new commander_1.Command('read')
     .description('Get detailed meeting information.')
-    .argument('<ids...>', `Meeting IDs (max ${constants_1.MAX_READ_MEETING_IDENTIFIERS})`)
-    .action(async (ids) => {
-    try {
-        const jsonMode = exports.readMeetingsCommand.parent?.parent?.opts().json ?? false;
-        const meetingIds = (0, parse_1.validateMeetingIdentifiers)(ids);
-        (0, parse_1.validateReadMeetingIdentifierLimit)(meetingIds);
-        const result = await (0, jsonRpc_1.callTool)('ReadMeetings', {
-            intent: `Reading meeting details for IDs: ${meetingIds.join(', ')}.`,
-            meetingIds,
-        });
-        (0, formatter_1.formatOutput)('ReadMeetings', result, jsonMode);
-    }
-    catch (error) {
-        const message = error instanceof Error ? error.message : constants_1.READ_FAILED_ERROR;
-        (0, output_1.printText)((0, error_1.formatMcpError)(message) ?? message, output_1.TextType.Error);
-        process.exit(1);
-    }
+    .argument('<ids...>', `Meeting IDs (max ${constants_1.MAX_READ_MEETING_IDENTIFIERS})`), types_1.ToolName.ReadMeetings, (ids) => {
+    const meetingIds = (0, parse_1.validateMeetingIdentifiers)(ids);
+    (0, parse_1.validateReadMeetingIdentifierLimit)(meetingIds);
+    return {
+        intent: `Reading meeting details for IDs: ${meetingIds.join(', ')}.`,
+        meetingIds,
+    };
 });

package/dist/commands/profiles.js

@@ -2,24 +2,8 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.searchProfilesCommand = void 0;
 const commander_1 = require("commander");
-const jsonRpc_1 = require("../client/jsonRpc");
-const error_1 = require("../helpers/error");
-const output_1 = require("../helpers/output");
-const formatter_1 = require("../helpers/formatter");
-exports.searchProfilesCommand = new commander_1.Command('search')
+const command_1 = require("../helpers/command");
+const types_1 = require("../types");
+exports.searchProfilesCommand = (0, command_1.defineToolCommand)(new commander_1.Command('search')
     .description('Search people by name.')
-    .argument('<names...>', 'Names to search for')
-    .action(async (names) => {
-    try {
-        const jsonMode = exports.searchProfilesCommand.parent?.parent?.opts().json ?? false;
-        const result = await (0, jsonRpc_1.callTool)('FindProfiles', {
-            searchTerms: names,
-        });
-        (0, formatter_1.formatOutput)('FindProfiles', result, jsonMode);
-    }
-    catch (error) {
-        const message = error instanceof Error ? error.message : 'People search failed.';
-        (0, output_1.printText)((0, error_1.formatMcpError)(message) ?? message, output_1.TextType.Error);
-        process.exit(1);
-    }
-});
+    .argument('<names...>', 'Names to search for'), types_1.ToolName.FindProfiles, (names) => ({ searchTerms: names }));

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/commands/support.js

@@ -2,26 +2,11 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.searchSupportCommand = void 0;
 const commander_1 = require("commander");
-const jsonRpc_1 = require("../client/jsonRpc");
-const error_1 = require("../helpers/error");
-const output_1 = require("../helpers/output");
-const formatter_1 = require("../helpers/formatter");
-exports.searchSupportCommand = new commander_1.Command('search')
+const command_1 = require("../helpers/command");
+const types_1 = require("../types");
+exports.searchSupportCommand = (0, command_1.defineToolCommand)(new commander_1.Command('search')
     .description('Search Circleback support articles.')
-    .argument('[search]', 'Search term')
-    .action(async (query) => {
-    try {
-        const jsonMode = exports.searchSupportCommand.parent?.parent?.opts().json ?? false;
-        const args = {
-            intent: query ?? 'Listing support articles.',
-        };
-        args['searchTerm'] = query ?? '';
-        const result = await (0, jsonRpc_1.callTool)('SearchSupportArticles', args);
-        (0, formatter_1.formatOutput)('SearchSupportArticles', result, jsonMode);
-    }
-    catch (error) {
-        const message = error instanceof Error ? error.message : 'Support search failed.';
-        (0, output_1.printText)((0, error_1.formatMcpError)(message) ?? message, output_1.TextType.Error);
-        process.exit(1);
-    }
-});
+    .argument('[search]', 'Search term'), types_1.ToolName.SearchSupportArticles, (query) => ({
+    intent: query ?? 'Listing support articles.',
+    searchTerm: query ?? '',
+}));

package/dist/commands/tags.js

@@ -2,23 +2,6 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.listTagsCommand = void 0;
 const commander_1 = require("commander");
-const jsonRpc_1 = require("../client/jsonRpc");
-const error_1 = require("../helpers/error");
-const output_1 = require("../helpers/output");
-const formatter_1 = require("../helpers/formatter");
-exports.listTagsCommand = new commander_1.Command('list')
-    .description('List all tags.')
-    .action(async () => {
-    try {
-        const jsonMode = exports.listTagsCommand.parent?.parent?.opts().json ?? false;
-        const result = await (0, jsonRpc_1.callTool)('ListTags', {
-            intent: 'Listing all tags.',
-        });
-        (0, formatter_1.formatOutput)('ListTags', result, jsonMode);
-    }
-    catch (error) {
-        const message = error instanceof Error ? error.message : 'Failed to list tags.';
-        (0, output_1.printText)((0, error_1.formatMcpError)(message) ?? message, output_1.TextType.Error);
-        process.exit(1);
-    }
-});
+const command_1 = require("../helpers/command");
+const types_1 = require("../types");
+exports.listTagsCommand = (0, command_1.defineToolCommand)(new commander_1.Command('list').description('List all tags.'), types_1.ToolName.ListTags, () => ({ intent: 'Listing all tags.' }));

package/dist/commands/transcripts.js

@@ -2,60 +2,33 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.getTranscriptsCommand = exports.searchTranscriptsCommand = void 0;
 const commander_1 = require("commander");
-const jsonRpc_1 = require("../client/jsonRpc");
 const constants_1 = require("../constants");
-const error_1 = require("../helpers/error");
-const output_1 = require("../helpers/output");
-const formatter_1 = require("../helpers/formatter");
+const command_1 = require("../helpers/command");
 const parse_1 = require("../helpers/parse");
 const tag_1 = require("../helpers/tag");
-exports.searchTranscriptsCommand = new commander_1.Command('search')
+const types_1 = require("../types");
+exports.searchTranscriptsCommand = (0, command_1.defineToolCommand)(new commander_1.Command('search')
     .description('Search meeting transcripts.')
     .argument('<search>', 'Search term')
     .option('--tags <tags>', constants_1.TAGS_OPTION_DESCRIPTION)
     .option('--profiles <ids>', constants_1.PROFILES_OPTION_DESCRIPTION)
     .option('--domains <domains>', constants_1.DOMAINS_OPTION_DESCRIPTION)
-    .showHelpAfterError(true)
-    .action(async (query, options) => {
-    try {
-        const jsonMode = exports.searchTranscriptsCommand.parent?.parent?.opts().json ?? false;
-        const args = {
-            intent: query,
-            searchTerm: query,
-        };
-        if (options.tags) {
-            args['tags'] = await (0, tag_1.resolveTagValues)(options.tags);
-        }
-        if (options.profiles)
-            args['profiles'] = (0, parse_1.parseNumericIds)(options.profiles, 'profile ID');
-        if (options.domains)
-            args['domains'] = options.domains.split(',');
-        const result = await (0, jsonRpc_1.callTool)('SearchTranscripts', args);
-        (0, formatter_1.formatOutput)('SearchTranscripts', result, jsonMode);
-    }
-    catch (error) {
-        const message = error instanceof Error ? error.message : 'Transcript search failed.';
-        (0, output_1.printText)((0, error_1.formatMcpError)(message) ?? message, output_1.TextType.Error);
-        process.exit(1);
-    }
-});
-exports.getTranscriptsCommand = new commander_1.Command('read')
+    .showHelpAfterError(), types_1.ToolName.SearchTranscripts, async (query, options) => ({
+    intent: query,
+    searchTerm: query,
+    tags: options.tags ? await (0, tag_1.resolveTagValues)(options.tags) : undefined,
+    profiles: options.profiles
+        ? (0, parse_1.parseNumericIds)(options.profiles, 'profile ID')
+        : undefined,
+    domains: options.domains ? options.domains.split(',') : undefined,
+}));
+exports.getTranscriptsCommand = (0, command_1.defineToolCommand)(new commander_1.Command('read')
     .description('Get full meeting transcripts.')
     .argument('<ids...>', 'Meeting IDs (max 50)')
-    .showHelpAfterError(true)
-    .action(async (ids) => {
-    try {
-        const jsonMode = exports.getTranscriptsCommand.parent?.parent?.opts().json ?? false;
-        const meetingIds = (0, parse_1.validateMeetingIdentifiers)(ids);
-        const result = await (0, jsonRpc_1.callTool)('GetTranscriptsForMeetings', {
-            intent: `Getting transcripts for meetings with IDs: ${meetingIds.join(', ')}.`,
-            meetingIds,
-        });
-        (0, formatter_1.formatOutput)('GetTranscriptsForMeetings', result, jsonMode);
-    }
-    catch (error) {
-        const message = error instanceof Error ? error.message : 'Transcript retrieval failed.';
-        (0, output_1.printText)((0, error_1.formatMcpError)(message) ?? message, output_1.TextType.Error);
-        process.exit(1);
-    }
+    .showHelpAfterError(), types_1.ToolName.GetTranscriptsForMeetings, (ids) => {
+    const meetingIds = (0, parse_1.validateMeetingIdentifiers)(ids);
+    return {
+        intent: `Getting transcripts for meetings with IDs: ${meetingIds.join(', ')}.`,
+        meetingIds,
+    };
 });

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.READ_FAILED_ERROR = exports.SEARCH_FAILED_ERROR = exports.LAST_AND_FROM_CONFLICT_ERROR = 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.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"));
@@ -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';
@@ -54,6 +54,3 @@ exports.END_DATE_OPTION_DESCRIPTION = 'End date (YYYY-MM-DD)';
 exports.TAGS_OPTION_DESCRIPTION = 'Comma-separated tag names or IDs';
 exports.PROFILES_OPTION_DESCRIPTION = 'Comma-separated profile IDs';
 exports.DOMAINS_OPTION_DESCRIPTION = 'Comma-separated domains';
-exports.LAST_AND_FROM_CONFLICT_ERROR = 'Cannot use --last and --from together.';
-exports.SEARCH_FAILED_ERROR = 'Search failed.';
-exports.READ_FAILED_ERROR = 'Read failed.';

package/dist/helpers/command.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.defineToolCommand = void 0;
+const jsonRpc_1 = require("../client/jsonRpc");
+const error_1 = require("./error");
+const formatter_1 = require("./formatter");
+const output_1 = require("./output");
+const defineToolCommand = (command, toolName, getArguments) => command.action(async (...args) => {
+    try {
+        const result = await (0, jsonRpc_1.callTool)(toolName, await getArguments(...args));
+        (0, formatter_1.formatOutput)(toolName, result, Boolean(command.optsWithGlobals().json));
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : `${toolName} failed.`;
+        (0, output_1.printText)((0, error_1.formatMcpError)(message) ?? message, output_1.TextType.Error);
+        process.exit(1);
+    }
+});
+exports.defineToolCommand = defineToolCommand;

package/dist/helpers/date.js

@@ -1,8 +1,17 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.formatDateTime = exports.formatDate = exports.getStartDateFromDaysAgo = void 0;
+exports.formatDateTime = exports.formatDate = exports.getStartDate = exports.getStartDateFromDaysAgo = void 0;
+const parse_1 = require("./parse");
 const getStartDateFromDaysAgo = (days) => new Date(Date.now() - days * 86400000).toISOString().slice(0, 10);
 exports.getStartDateFromDaysAgo = getStartDateFromDaysAgo;
+const getStartDate = ({ last, from, }) => {
+    if (last && from)
+        throw new Error('Cannot use --last and --from together.');
+    return last
+        ? (0, exports.getStartDateFromDaysAgo)((0, parse_1.parseIntOption)(last, '--last'))
+        : from || undefined;
+};
+exports.getStartDate = getStartDate;
 const formatDate = (dateString) => {
     const date = new Date(dateString);
     return date.toLocaleDateString('en-US', {

package/dist/helpers/formatter.js

@@ -5,35 +5,58 @@ const table_1 = require("./table");
 const parse_1 = require("./parse");
 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) {
-        case 'SearchMeetings':
+        case types_1.ToolName.SearchMeetings:
             return (0, table_1.formatMeetingsList)(data);
-        case 'ReadMeetings':
+        case types_1.ToolName.ReadMeetings:
             return (0, table_1.formatMeetingDetails)(data);
-        case 'GetTranscriptsForMeetings':
+        case types_1.ToolName.GetTranscriptsForMeetings:
             return (0, table_1.formatTranscriptReadResults)(data);
-        case 'SearchTranscripts':
+        case types_1.ToolName.SearchTranscripts:
             return (0, table_1.formatTranscriptSearchResults)(data);
-        case 'SearchCalendarEvents':
+        case types_1.ToolName.SearchCalendarEvents:
             return (0, table_1.formatCalendarEvents)(data);
-        case 'FindProfiles':
+        case types_1.ToolName.FindProfiles:
             return (0, table_1.formatProfiles)(data);
-        case 'FindCompanies':
+        case types_1.ToolName.FindCompanies:
             return (0, table_1.formatCompanies)(data);
-        case 'SearchSupportArticles':
+        case types_1.ToolName.SearchSupportArticles:
             return (0, table_1.formatSupportArticles)(data);
-        case 'SearchEmails':
+        case types_1.ToolName.SearchEmails:
             return (0, table_1.formatEmails)(data);
-        case 'SearchActionItems':
+        case types_1.ToolName.SearchActionItems:
             return (0, table_1.formatActionItems)(data);
-        case 'ListTags':
+        case types_1.ToolName.ListTags:
             return (0, table_1.formatTags)(data);
-        default:
-            return;
+        default: {
+            const _absurd = toolName;
+            return _absurd;
+        }
     }
 };
 const formatOutput = (toolName, rawText, jsonMode) => {

package/dist/helpers/parse.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.validateReadMeetingIdentifierLimit = exports.validateMeetingIdentifiers = exports.parseNumericIds = exports.parseIntOption = exports.extractAndValidateObjectFromString = void 0;
+exports.validateReadMeetingIdentifierLimit = exports.validateMeetingIdentifiers = exports.parseNumericIds = exports.parseOptionalIntOption = exports.parseIntOption = exports.extractAndValidateObjectFromString = void 0;
 const zod_1 = require("zod");
 const constants_1 = require("../constants");
 const output_1 = require("./output");
@@ -29,6 +29,8 @@ const parseIntOption = (value, flagName) => {
     return result.data;
 };
 exports.parseIntOption = parseIntOption;
+const parseOptionalIntOption = (value, flagName) => (value ? (0, exports.parseIntOption)(value, flagName) : undefined);
+exports.parseOptionalIntOption = parseOptionalIntOption;
 const parseNumericIds = (value, label) => {
     const result = numericIdsSchema.safeParse(value.split(','));
     if (!result.success) {

package/dist/helpers/tag.js

@@ -5,13 +5,14 @@ const zod_1 = require("zod");
 const jsonRpc_1 = require("../client/jsonRpc");
 const output_1 = require("./output");
 const parse_1 = require("./parse");
+const types_1 = require("../types");
 const tagItemSchema = zod_1.z.object({
     id: zod_1.z.number(),
     name: zod_1.z.string(),
 });
 const tagsSchema = zod_1.z.array(tagItemSchema);
 const fetchUserTags = async () => {
-    const rawResult = await (0, jsonRpc_1.callTool)('ListTags', {
+    const rawResult = await (0, jsonRpc_1.callTool)(types_1.ToolName.ListTags, {
         intent: 'Resolving tag values.',
     });
     return (0, parse_1.extractAndValidateObjectFromString)(rawResult, tagsSchema);

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.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) {
@@ -12,6 +12,28 @@ var CredentialSource;
     CredentialSource["Environment"] = "environment";
     CredentialSource["Stored"] = "stored";
 })(CredentialSource || (exports.CredentialSource = CredentialSource = {}));
+var ToolName;
+(function (ToolName) {
+    ToolName["SearchMeetings"] = "SearchMeetings";
+    ToolName["ReadMeetings"] = "ReadMeetings";
+    ToolName["GetTranscriptsForMeetings"] = "GetTranscriptsForMeetings";
+    ToolName["SearchTranscripts"] = "SearchTranscripts";
+    ToolName["SearchCalendarEvents"] = "SearchCalendarEvents";
+    ToolName["FindProfiles"] = "FindProfiles";
+    ToolName["FindCompanies"] = "FindCompanies";
+    ToolName["SearchSupportArticles"] = "SearchSupportArticles";
+    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.0",
+  "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)",