@circleback/cli 0.1.3 → 0.1.5

package/dist/commands/actionItems.js

@@ -0,0 +1,67 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.searchActionItemsCommand = void 0;
+const commander_1 = require("commander");
+const chalk_1 = __importDefault(require("chalk"));
+const jsonRpc_1 = require("../client/jsonRpc");
+const constants_1 = require("../constants");
+const date_1 = require("../helpers/date");
+const error_1 = require("../helpers/error");
+const formatter_1 = require("../helpers/formatter");
+const parse_1 = require("../helpers/parse");
+const tag_1 = require("../helpers/tag");
+const DEFAULT_ACTION_ITEMS_SEARCH_LAST_DAYS = 30;
+exports.searchActionItemsCommand = new commander_1.Command('search')
+    .description('Search action items.')
+    .argument('[search]', 'Search term')
+    .option('-p, --page <index>', constants_1.PAGE_OPTION_DESCRIPTION, '0')
+    .option('--status <status>', 'Filter by status (PENDING or DONE)')
+    .option('--last <days>', 'Show action items from the last N days')
+    .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) {
+            console.error(chalk_1.default.red(constants_1.LAST_AND_FROM_CONFLICT_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;
+        console.error(chalk_1.default.red((0, error_1.formatMcpError)(message) ?? message));
+        process.exit(1);
+    }
+});

package/dist/commands/calendar.js

@@ -7,6 +7,7 @@ exports.searchCalendarCommand = void 0;
 const commander_1 = require("commander");
 const chalk_1 = __importDefault(require("chalk"));
 const jsonRpc_1 = require("../client/jsonRpc");
+const constants_1 = require("../constants");
 const date_1 = require("../helpers/date");
 const error_1 = require("../helpers/error");
 const formatter_1 = require("../helpers/formatter");
@@ -14,28 +15,28 @@ const parse_1 = require("../helpers/parse");
 exports.searchCalendarCommand = new commander_1.Command('search')
     .description('Search calendar events.')
     .option('--last <days>', 'Show events from the last N days')
-    .option('--from <date>', 'Start date (YYYY-MM-DD)')
-    .option('--to <date>', 'End date (YYYY-MM-DD)')
+    .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) {
-            console.error(chalk_1.default.red('Cannot use --last and --from together.'));
+            console.error(chalk_1.default.red(constants_1.LAST_AND_FROM_CONFLICT_ERROR));
             process.exit(1);
         }
         const jsonMode = exports.searchCalendarCommand.parent?.parent?.opts().json ?? false;
-        const arguments_ = {
+        const args = {
             intent: 'Listing calendar events.',
             pageIndex: 0,
         };
         if (options.last) {
-            arguments_['startDate'] = (0, date_1.getStartDateFromDaysAgo)((0, parse_1.parseIntOption)(options.last, '--last'));
+            args['startDate'] = (0, date_1.getStartDateFromDaysAgo)((0, parse_1.parseIntOption)(options.last, '--last'));
         }
         else if (options.from) {
-            arguments_['startDate'] = options.from;
+            args['startDate'] = options.from;
         }
         if (options.to)
-            arguments_['endDate'] = options.to;
-        const result = await (0, jsonRpc_1.callTool)('SearchCalendarEvents', arguments_);
+            args['endDate'] = options.to;
+        const result = await (0, jsonRpc_1.callTool)('SearchCalendarEvents', args);
         (0, formatter_1.formatOutput)('SearchCalendarEvents', result, jsonMode);
     }
     catch (error) {

package/dist/commands/emails.js

@@ -7,13 +7,14 @@ exports.searchEmailsCommand = void 0;
 const commander_1 = require("commander");
 const chalk_1 = __importDefault(require("chalk"));
 const jsonRpc_1 = require("../client/jsonRpc");
+const constants_1 = require("../constants");
 const error_1 = require("../helpers/error");
 const formatter_1 = require("../helpers/formatter");
 const parse_1 = require("../helpers/parse");
 exports.searchEmailsCommand = 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>', 'Page index (starts at 0)', '0')
+    .option('-p, --page <index>', constants_1.PAGE_OPTION_DESCRIPTION, '0')
     .action(async (query, options) => {
     try {
         if (query !== undefined && query.trim() === '') {
@@ -22,12 +23,12 @@ exports.searchEmailsCommand = new commander_1.Command('search')
         }
         const jsonMode = exports.searchEmailsCommand.parent?.parent?.opts().json ?? false;
         const pageIndex = (0, parse_1.parseIntOption)(options.page, '--page');
-        const arguments_ = {
+        const args = {
             intent: query ?? 'Listing recent emails.',
             pageIndex,
         };
-        arguments_['searchTerm'] = query ?? '';
-        const result = await (0, jsonRpc_1.callTool)('SearchEmails', arguments_);
+        args['searchTerm'] = query ?? '';
+        const result = await (0, jsonRpc_1.callTool)('SearchEmails', args);
         (0, formatter_1.formatOutput)('SearchEmails', result, jsonMode);
     }
     catch (error) {

package/dist/commands/meetings.js

@@ -7,63 +7,66 @@ exports.readMeetingsCommand = exports.searchMeetingsCommand = void 0;
 const commander_1 = require("commander");
 const chalk_1 = __importDefault(require("chalk"));
 const jsonRpc_1 = require("../client/jsonRpc");
+const constants_1 = require("../constants");
 const date_1 = require("../helpers/date");
 const error_1 = require("../helpers/error");
 const formatter_1 = require("../helpers/formatter");
 const parse_1 = require("../helpers/parse");
+const tag_1 = require("../helpers/tag");
 const DEFAULT_MEETINGS_SEARCH_LAST_DAYS = 7;
 exports.searchMeetingsCommand = new commander_1.Command('search')
-    .description('Search for meetings.')
+    .description('Search meetings.')
     .argument('[search]', 'Search term')
-    .option('-p, --page <index>', 'Page index (starts at 0)', '0')
+    .option('-p, --page <index>', constants_1.PAGE_OPTION_DESCRIPTION, '0')
     .option('--last <days>', 'Show meetings from the last N days')
-    .option('--from <date>', 'Start date (YYYY-MM-DD)')
-    .option('--to <date>', 'End date (YYYY-MM-DD)')
-    .option('--tags <ids>', 'Comma-separated tag IDs')
-    .option('--profiles <ids>', 'Comma-separated profile IDs')
-    .option('--domains <domains>', 'Comma-separated domains')
+    .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('--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) {
-            console.error(chalk_1.default.red('Cannot use --last and --from together.'));
+            console.error(chalk_1.default.red(constants_1.LAST_AND_FROM_CONFLICT_ERROR));
             process.exit(1);
         }
         const jsonMode = exports.searchMeetingsCommand.parent?.parent?.opts().json ?? false;
         const pageIndex = (0, parse_1.parseIntOption)(options.page, '--page');
-        const arguments_ = {
+        const args = {
             intent: query ?? 'Listing recent meetings.',
             pageIndex,
         };
         if (query)
-            arguments_['searchTerm'] = query;
+            args['searchTerm'] = query;
         if (options.last) {
-            arguments_['startDate'] = (0, date_1.getStartDateFromDaysAgo)((0, parse_1.parseIntOption)(options.last, '--last'));
+            args['startDate'] = (0, date_1.getStartDateFromDaysAgo)((0, parse_1.parseIntOption)(options.last, '--last'));
         }
         else if (options.from) {
-            arguments_['startDate'] = options.from;
+            args['startDate'] = options.from;
         }
         else if (!query) {
-            arguments_['startDate'] = (0, date_1.getStartDateFromDaysAgo)(DEFAULT_MEETINGS_SEARCH_LAST_DAYS);
+            args['startDate'] = (0, date_1.getStartDateFromDaysAgo)(DEFAULT_MEETINGS_SEARCH_LAST_DAYS);
         }
         if (options.to)
-            arguments_['endDate'] = options.to;
-        if (options.tags)
-            arguments_['tags'] = (0, parse_1.parseNumericIds)(options.tags, 'tag ID');
+            args['endDate'] = options.to;
+        if (options.tags) {
+            args['tags'] = await (0, tag_1.resolveTagValues)(options.tags);
+        }
         if (options.profiles)
-            arguments_['profiles'] = (0, parse_1.parseNumericIds)(options.profiles, 'profile ID');
+            args['profiles'] = (0, parse_1.parseNumericIds)(options.profiles, 'profile ID');
         if (options.domains)
-            arguments_['domains'] = options.domains.split(',');
-        const result = await (0, jsonRpc_1.callTool)('SearchMeetings', arguments_);
+            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 : 'Search failed.';
+        const message = error instanceof Error ? error.message : constants_1.SEARCH_FAILED_ERROR;
         console.error(chalk_1.default.red((0, error_1.formatMcpError)(message) ?? message));
         process.exit(1);
     }
 });
 exports.readMeetingsCommand = new commander_1.Command('read')
-    .description('Get detailed information for meetings.')
+    .description('Get detailed meeting information.')
     .argument('<ids...>', 'Meeting IDs')
     .action(async (ids) => {
     try {
@@ -76,7 +79,7 @@ exports.readMeetingsCommand = new commander_1.Command('read')
         (0, formatter_1.formatOutput)('ReadMeetings', result, jsonMode);
     }
     catch (error) {
-        const message = error instanceof Error ? error.message : 'Read failed.';
+        const message = error instanceof Error ? error.message : constants_1.READ_FAILED_ERROR;
         console.error(chalk_1.default.red((0, error_1.formatMcpError)(message) ?? message));
         process.exit(1);
     }

package/dist/commands/registry.js

@@ -2,6 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.getAllCommands = exports.commandGroups = exports.standaloneCommands = void 0;
 const commander_1 = require("commander");
+const actionItems_1 = require("./actionItems");
 const auth_1 = require("./auth");
 const calendar_1 = require("./calendar");
 const domains_1 = require("./domains");
@@ -9,6 +10,7 @@ const emails_1 = require("./emails");
 const meetings_1 = require("./meetings");
 const profiles_1 = require("./profiles");
 const support_1 = require("./support");
+const tags_1 = require("./tags");
 const transcripts_1 = require("./transcripts");
 const upgrade_1 = require("./upgrade");
 exports.standaloneCommands = [
@@ -52,6 +54,16 @@ exports.commandGroups = [
         description: 'Search emails.',
         subcommands: [emails_1.searchEmailsCommand],
     },
+    {
+        name: 'action-items',
+        description: 'Search action items.',
+        subcommands: [actionItems_1.searchActionItemsCommand],
+    },
+    {
+        name: 'tags',
+        description: 'List tags.',
+        subcommands: [tags_1.listTagsCommand],
+    },
 ];
 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));
 const getAllCommands = () => [

package/dist/commands/support.js

@@ -15,11 +15,11 @@ exports.searchSupportCommand = new commander_1.Command('search')
     .action(async (query) => {
     try {
         const jsonMode = exports.searchSupportCommand.parent?.parent?.opts().json ?? false;
-        const arguments_ = {
+        const args = {
             intent: query ?? 'Listing support articles.',
         };
-        arguments_['searchTerm'] = query ?? '';
-        const result = await (0, jsonRpc_1.callTool)('SearchSupportArticles', arguments_);
+        args['searchTerm'] = query ?? '';
+        const result = await (0, jsonRpc_1.callTool)('SearchSupportArticles', args);
         (0, formatter_1.formatOutput)('SearchSupportArticles', result, jsonMode);
     }
     catch (error) {

package/dist/commands/tags.js

@@ -0,0 +1,27 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.listTagsCommand = void 0;
+const commander_1 = require("commander");
+const chalk_1 = __importDefault(require("chalk"));
+const jsonRpc_1 = require("../client/jsonRpc");
+const error_1 = require("../helpers/error");
+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.';
+        console.error(chalk_1.default.red((0, error_1.formatMcpError)(message) ?? message));
+        process.exit(1);
+    }
+});

package/dist/commands/transcripts.js

@@ -7,30 +7,33 @@ exports.getTranscriptsCommand = exports.searchTranscriptsCommand = void 0;
 const commander_1 = require("commander");
 const chalk_1 = __importDefault(require("chalk"));
 const jsonRpc_1 = require("../client/jsonRpc");
+const constants_1 = require("../constants");
 const error_1 = require("../helpers/error");
 const formatter_1 = require("../helpers/formatter");
 const parse_1 = require("../helpers/parse");
+const tag_1 = require("../helpers/tag");
 exports.searchTranscriptsCommand = new commander_1.Command('search')
     .description('Search meeting transcripts.')
     .argument('<search>', 'Search term')
-    .option('--tags <ids>', 'Comma-separated tag IDs')
-    .option('--profiles <ids>', 'Comma-separated profile IDs')
-    .option('--domains <domains>', 'Comma-separated domains')
+    .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 arguments_ = {
+        const args = {
             intent: query,
             searchTerm: query,
         };
-        if (options.tags)
-            arguments_['tags'] = (0, parse_1.parseNumericIds)(options.tags, 'tag ID');
+        if (options.tags) {
+            args['tags'] = await (0, tag_1.resolveTagValues)(options.tags);
+        }
         if (options.profiles)
-            arguments_['profiles'] = (0, parse_1.parseNumericIds)(options.profiles, 'profile ID');
+            args['profiles'] = (0, parse_1.parseNumericIds)(options.profiles, 'profile ID');
         if (options.domains)
-            arguments_['domains'] = options.domains.split(',');
-        const result = await (0, jsonRpc_1.callTool)('SearchTranscripts', arguments_);
+            args['domains'] = options.domains.split(',');
+        const result = await (0, jsonRpc_1.callTool)('SearchTranscripts', args);
         (0, formatter_1.formatOutput)('SearchTranscripts', result, jsonMode);
     }
     catch (error) {
@@ -40,7 +43,7 @@ exports.searchTranscriptsCommand = new commander_1.Command('search')
     }
 });
 exports.getTranscriptsCommand = new commander_1.Command('read')
-    .description('Get full transcripts for meetings.')
+    .description('Get full meeting transcripts.')
     .argument('<meetingId...>', 'Meeting IDs (max 50)')
     .showHelpAfterError(true)
     .action(async (ids) => {

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.CALLBACK_TIMEOUT_MILLISECONDS = exports.OAUTH_SCOPE = exports.TOKENS_FILE = exports.CONFIG_DIRECTORY = exports.ASCII_LOGO = exports.SECONDARY_COLOR = exports.BRAND_COLOR = exports.CLIENT_VERSION = exports.CLIENT_PACKAGE_NAME = exports.CLIENT_NAME = exports.BASE_URL = void 0;
+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.CALLBACK_TIMEOUT_MILLISECONDS = exports.OAUTH_SCOPE = exports.TOKENS_FILE = exports.CONFIG_DIRECTORY = exports.ASCII_LOGO = exports.SECONDARY_COLOR = exports.BRAND_COLOR = 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"));
@@ -37,3 +37,14 @@ exports.CONFIG_DIRECTORY = node_path_1.default.join(node_os_1.default.homedir(),
 exports.TOKENS_FILE = node_path_1.default.join(exports.CONFIG_DIRECTORY, 'tokens.json');
 exports.OAUTH_SCOPE = 'user';
 exports.CALLBACK_TIMEOUT_MILLISECONDS = 120_000;
+exports.DEFAULT_MEETING_NAME = 'New meeting';
+exports.UNASSIGNED_ACTION_ITEM_ASSIGNEE_LABEL = 'Unassigned';
+exports.PAGE_OPTION_DESCRIPTION = 'Page index (starts at 0)';
+exports.START_DATE_OPTION_DESCRIPTION = 'Start date (YYYY-MM-DD)';
+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/formatter.js

@@ -2,14 +2,8 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.formatOutput = void 0;
 const table_1 = require("./table");
-const safeParse = (rawText) => {
-    try {
-        return JSON.parse(rawText);
-    }
-    catch {
-        return rawText;
-    }
-};
+const parse_1 = require("./parse");
+const zod_1 = require("zod");
 const stringify = (value) => typeof value === 'string' ? value : JSON.stringify(value, null, 2);
 const formatForTool = (toolName, data) => {
     if (!Array.isArray(data))
@@ -33,12 +27,16 @@ const formatForTool = (toolName, data) => {
             return (0, table_1.formatSupportArticles)(data);
         case 'SearchEmails':
             return (0, table_1.formatEmails)(data);
+        case 'SearchActionItems':
+            return (0, table_1.formatActionItems)(data);
+        case 'ListTags':
+            return (0, table_1.formatTags)(data);
         default:
             return;
     }
 };
 const formatOutput = (toolName, rawText, jsonMode) => {
-    const parsed = safeParse(rawText);
+    const parsed = (0, parse_1.extractAndValidateObjectFromString)(rawText, zod_1.z.json());
     if (jsonMode) {
         console.log(stringify(parsed));
         return;

package/dist/helpers/parse.js

@@ -3,32 +3,49 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.validateNumericIds = exports.parseNumericIds = exports.parseIntOption = void 0;
+exports.validateNumericIds = exports.parseNumericIds = exports.parseIntOption = exports.extractAndValidateObjectFromString = void 0;
 const chalk_1 = __importDefault(require("chalk"));
+const zod_1 = require("zod");
+const extractAndValidateObjectFromString = (rawText, schema) => {
+    try {
+        const json = JSON.parse(rawText);
+        const result = schema.safeParse(json);
+        if (result.success)
+            return result.data;
+        console.error(chalk_1.default.red('Failed to parse response.'));
+        process.exit(1);
+    }
+    catch {
+        return rawText;
+    }
+};
+exports.extractAndValidateObjectFromString = extractAndValidateObjectFromString;
+const intSchema = zod_1.z.coerce.number().int();
+const numericIdsSchema = zod_1.z.array(intSchema);
 const parseIntOption = (value, flagName) => {
-    const parsed = parseInt(value, 10);
-    if (isNaN(parsed)) {
+    const result = intSchema.safeParse(value);
+    if (!result.success) {
         console.error(chalk_1.default.red(`Invalid number for ${flagName}.`));
         process.exit(1);
     }
-    return parsed;
+    return result.data;
 };
 exports.parseIntOption = parseIntOption;
 const parseNumericIds = (value, label) => {
-    const ids = value.split(',').map(Number);
-    if (ids.some(isNaN)) {
+    const result = numericIdsSchema.safeParse(value.split(','));
+    if (!result.success) {
         console.error(chalk_1.default.red(`Invalid ${label}. Expected numeric IDs.`));
         process.exit(1);
     }
-    return ids;
+    return result.data;
 };
 exports.parseNumericIds = parseNumericIds;
 const validateNumericIds = (values, label) => {
-    const ids = values.map(Number);
-    if (ids.some(isNaN)) {
+    const result = numericIdsSchema.safeParse(values);
+    if (!result.success) {
         console.error(chalk_1.default.red(`Invalid ${label}. Expected numeric IDs.`));
         process.exit(1);
     }
-    return ids;
+    return result.data;
 };
 exports.validateNumericIds = validateNumericIds;

package/dist/helpers/table.js

@@ -3,13 +3,14 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.formatEmails = exports.formatSupportArticles = exports.formatDomains = exports.formatProfiles = exports.formatCalendarEvents = exports.formatTranscriptReadResults = exports.formatTranscriptSearchResults = exports.formatMeetingDetails = exports.formatMeetingsList = void 0;
+exports.formatEmails = exports.formatTags = exports.formatActionItems = exports.formatSupportArticles = exports.formatDomains = exports.formatProfiles = exports.formatCalendarEvents = exports.formatTranscriptReadResults = exports.formatTranscriptSearchResults = exports.formatMeetingDetails = exports.formatMeetingsList = void 0;
 const chalk_1 = __importDefault(require("chalk"));
 const cli_table3_1 = __importDefault(require("cli-table3"));
 const date_1 = require("./date");
 const string_1 = require("./string");
 const style_1 = require("./style");
 const lodash_1 = require("lodash");
+const constants_1 = require("../constants");
 const idColumnWidth = (ids) => {
     const maxLength = ids.reduce((max, id) => Math.max(max, String(id).length), 2);
     return maxLength + 2;
@@ -53,14 +54,12 @@ const formatMeetingsList = (meetings) => {
         wordWrap: true,
         style: style_1.tableStyle,
     });
-    meetings.forEach((meeting) => {
-        table.push([
-            (0, string_1.truncate)(meeting.name, nameWidth - 2),
-            meeting.id,
-            (0, date_1.formatDate)(meeting.createdAt),
-            meeting.attendees.map(formatAttendee).join('\n'),
-        ]);
-    });
+    table.push(...meetings.map((meeting) => [
+        (0, string_1.truncate)(meeting.name, nameWidth - 2),
+        meeting.id,
+        (0, date_1.formatDate)(meeting.createdAt),
+        meeting.attendees.map(formatAttendee).join('\n'),
+    ]));
     return `${chalk_1.default.bold(`${(0, string_1.pluralize)(meetings.length, 'meeting', 'meetings')} found`)}\n${table.toString()}`;
 };
 exports.formatMeetingsList = formatMeetingsList;
@@ -106,13 +105,11 @@ const formatTranscriptSearchResults = (results) => {
         wordWrap: true,
         style: style_1.tableStyle,
     });
-    results.forEach((result) => {
-        table.push([
-            (0, string_1.truncate)(result.meetingName || 'New meeting', meetingWidth - 2),
-            result.meetingId,
-            (0, string_1.truncate)(result.text, contentWidth - 2),
-        ]);
-    });
+    table.push(...results.map((result) => [
+        (0, string_1.truncate)(result.meetingName || constants_1.DEFAULT_MEETING_NAME, meetingWidth - 2),
+        result.meetingId,
+        (0, string_1.truncate)(result.text, contentWidth - 2),
+    ]));
     return `${chalk_1.default.bold(`${(0, string_1.pluralize)(results.length, 'match', 'matches')} found`)}\n${table.toString()}`;
 };
 exports.formatTranscriptSearchResults = formatTranscriptSearchResults;
@@ -149,15 +146,13 @@ const formatCalendarEvents = (events) => {
         wordWrap: true,
         style: style_1.tableStyle,
     });
-    events.forEach((event) => {
-        table.push([
-            (0, string_1.truncate)(event.title, 28),
-            (0, date_1.formatDateTime)(event.startTime),
-            (0, date_1.formatDateTime)(event.endTime),
-            event.platform ?? '-',
-            event.attendees?.map(formatAttendee).join('\n') ?? '-',
-        ]);
-    });
+    table.push(...events.map((event) => [
+        (0, string_1.truncate)(event.title, 28),
+        (0, date_1.formatDateTime)(event.startTime),
+        (0, date_1.formatDateTime)(event.endTime),
+        event.platform ?? '-',
+        event.attendees?.map(formatAttendee).join('\n') ?? '-',
+    ]));
     return `${chalk_1.default.bold((0, string_1.pluralize)(events.length, 'event', 'events'))}\n${table.toString()}`;
 };
 exports.formatCalendarEvents = formatCalendarEvents;
@@ -181,15 +176,13 @@ const formatProfiles = (profiles) => {
         wordWrap: true,
         style: style_1.tableStyle,
     });
-    profiles.forEach((profile) => {
-        table.push([
-            [profile.firstName, profile.lastName].filter(Boolean).join(' ') || '-',
-            profile.id,
-            profile.email ?? '-',
-            profile.title ?? '-',
-            profile.company ?? '-',
-        ]);
-    });
+    table.push(...profiles.map((profile) => [
+        [profile.firstName, profile.lastName].filter(Boolean).join(' ') || '-',
+        profile.id,
+        profile.email ?? '-',
+        profile.title ?? '-',
+        profile.company ?? '-',
+    ]));
     return `${chalk_1.default.bold(`${(0, string_1.pluralize)(profiles.length, 'person', 'people')} found`)}\n${table.toString()}`;
 };
 exports.formatProfiles = formatProfiles;
@@ -207,6 +200,61 @@ const formatSupportArticles = (articles) => {
         .join('\n\n');
 };
 exports.formatSupportArticles = formatSupportArticles;
+const formatActionItems = (actionItems) => {
+    if (actionItems.length === 0)
+        return chalk_1.default.yellow('No action items found.');
+    const idWidth = idColumnWidth(actionItems.map((item) => item.id));
+    const titleWidth = 35;
+    const statusWidth = 10;
+    const assigneeWidth = 20;
+    const meetingWidth = 25;
+    const dateWidth = 14;
+    const table = new cli_table3_1.default({
+        head: [
+            style_1.brand.bold('Title'),
+            style_1.brand.bold('ID'),
+            style_1.brand.bold('Status'),
+            style_1.brand.bold('Assignee'),
+            style_1.brand.bold('Meeting'),
+            style_1.brand.bold('Date'),
+        ],
+        colWidths: [
+            titleWidth,
+            idWidth,
+            statusWidth,
+            assigneeWidth,
+            meetingWidth,
+            dateWidth,
+        ],
+        wordWrap: true,
+        style: style_1.tableStyle,
+    });
+    table.push(...actionItems.map((item) => [
+        (0, string_1.truncate)(item.title, titleWidth - 2),
+        item.id,
+        item.status,
+        item.assignee?.name ?? constants_1.UNASSIGNED_ACTION_ITEM_ASSIGNEE_LABEL,
+        (0, string_1.truncate)(item.meeting.name || constants_1.DEFAULT_MEETING_NAME, meetingWidth - 2),
+        (0, date_1.formatDate)(item.createdAt),
+    ]));
+    return `${chalk_1.default.bold(`${(0, string_1.pluralize)(actionItems.length, 'action item', 'action items')} found`)}\n${table.toString()}`;
+};
+exports.formatActionItems = formatActionItems;
+const formatTags = (tags) => {
+    if (tags.length === 0)
+        return chalk_1.default.yellow('No tags found.');
+    const idWidth = idColumnWidth(tags.map((tag) => tag.id));
+    const nameWidth = 40;
+    const table = new cli_table3_1.default({
+        head: [style_1.brand.bold('Name'), style_1.brand.bold('ID')],
+        colWidths: [nameWidth, idWidth],
+        wordWrap: true,
+        style: style_1.tableStyle,
+    });
+    table.push(...tags.map((tag) => [(0, string_1.truncate)(tag.name, nameWidth - 2), tag.id]));
+    return `${chalk_1.default.bold(`${(0, string_1.pluralize)(tags.length, 'tag', 'tags')} found`)}\n${table.toString()}`;
+};
+exports.formatTags = formatTags;
 const formatMessage = (message) => {
     const header = chalk_1.default.bold.cyan(message.subject ?? 'No subject');
     const meta = `${chalk_1.default.bold('From:')} ${formatSender(message.sender)}  ${chalk_1.default.dim((0, date_1.formatDateTime)(message.receivedOn))}`;

package/dist/helpers/tag.js

@@ -0,0 +1,48 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveTagValues = void 0;
+const chalk_1 = __importDefault(require("chalk"));
+const zod_1 = require("zod");
+const jsonRpc_1 = require("../client/jsonRpc");
+const parse_1 = require("./parse");
+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', {
+        intent: 'Resolving tag values.',
+    });
+    return (0, parse_1.extractAndValidateObjectFromString)(rawResult, tagsSchema);
+};
+const resolveTagValues = async (value) => {
+    const parts = value
+        .split(',')
+        .map((part) => part.trim())
+        .filter((part) => part.length > 0);
+    if (parts.length === 0) {
+        console.error(chalk_1.default.red('No tag values provided.'));
+        process.exit(1);
+    }
+    const tagList = await fetchUserTags();
+    if (typeof tagList === 'string') {
+        console.error(chalk_1.default.red('Failed to fetch tags.'));
+        process.exit(1);
+    }
+    return parts.map((part) => {
+        const nameMatch = tagList.find((tag) => tag.name.toLowerCase() === part.toLowerCase());
+        if (nameMatch)
+            return nameMatch.id;
+        const numericId = Number(part);
+        if (!isNaN(numericId) && tagList.some((tag) => tag.id === numericId)) {
+            return numericId;
+        }
+        console.error(chalk_1.default.red(`Tag "${part}" not found.`));
+        process.exit(1);
+    });
+};
+exports.resolveTagValues = resolveTagValues;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@circleback/cli",
-  "version": "0.1.3",
+  "version": "0.1.5",
   "description": "Circleback CLI. Search and access meetings, emails, calendar events, and more.",
   "license": "MIT",
   "author": "Circleback <support@circleback.ai> (https://circleback.ai)",
@@ -38,7 +38,8 @@
     "chalk": "^4.1.2",
     "cli-table3": "^0.6.5",
     "commander": "^13.1.0",
-    "lodash": "^4.17.23"
+    "lodash": "^4.17.23",
+    "zod": "^3.25.76"
   },
   "devDependencies": {
     "@types/lodash": "^4.17.24",