@circleback/cli 0.1.4 → 0.1.5

package/dist/commands/actionItems.js

@@ -12,6 +12,7 @@ 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.')
@@ -21,7 +22,7 @@ exports.searchActionItemsCommand = new commander_1.Command('search')
     .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 <ids>', constants_1.TAGS_OPTION_DESCRIPTION)
+    .option('--tags <tags>', constants_1.TAGS_OPTION_DESCRIPTION)
     .option('--assignee <id>', 'Filter by assignee profile ID')
     .action(async (query, options) => {
     try {
@@ -50,8 +51,9 @@ exports.searchActionItemsCommand = new commander_1.Command('search')
         }
         if (options.to)
             args['endDate'] = options.to;
-        if (options.tags)
-            args['tags'] = (0, parse_1.parseNumericIds)(options.tags, 'tag ID');
+        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);

package/dist/commands/meetings.js

@@ -12,6 +12,7 @@ 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 meetings.')
@@ -20,7 +21,7 @@ exports.searchMeetingsCommand = new commander_1.Command('search')
     .option('--last <days>', 'Show meetings 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 <ids>', constants_1.TAGS_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) => {
@@ -48,8 +49,9 @@ exports.searchMeetingsCommand = new commander_1.Command('search')
         }
         if (options.to)
             args['endDate'] = options.to;
-        if (options.tags)
-            args['tags'] = (0, parse_1.parseNumericIds)(options.tags, 'tag ID');
+        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)

package/dist/commands/registry.js

@@ -10,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 = [
@@ -58,6 +59,11 @@ exports.commandGroups = [
         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/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

@@ -11,10 +11,11 @@ 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>', constants_1.TAGS_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)
     .showHelpAfterError(true)
@@ -25,8 +26,9 @@ exports.searchTranscriptsCommand = new commander_1.Command('search')
             intent: query,
             searchTerm: query,
         };
-        if (options.tags)
-            args['tags'] = (0, parse_1.parseNumericIds)(options.tags, 'tag ID');
+        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)

package/dist/constants.js

@@ -42,7 +42,7 @@ 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 IDs';
+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.';

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))
@@ -35,12 +29,14 @@ const formatForTool = (toolName, data) => {
             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,7 +3,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.formatEmails = exports.formatActionItems = 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");
@@ -240,6 +240,21 @@ const formatActionItems = (actionItems) => {
     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.4",
+  "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",