@circleback/cli 1.1.0 → 1.2.0

package/README.md

@@ -1,6 +1,6 @@
 # Circleback CLI
 
-Search and access your meetings, transcripts, emails, calendar events, and more from the terminal, and manage your action items, tags, and meeting access.
+Search and access your meetings, transcripts, emails, calendar events, and more from the terminal, and manage your action items, tags, folders, and meeting access.
 
 ## Installation
 
@@ -67,6 +67,12 @@ cb meetings --json
 | `cb tags create <name>`          | Create a tag                                                 |
 | `cb tags update <id>`            | Update a tag                                                 |
 | `cb tags delete <id>`            | Delete a tag                                                 |
+| `cb folders`                     | List folders                                                 |
+| `cb folders read <ids...>`       | Read folders                                                 |
+| `cb folders create <name>`       | Create a folder                                              |
+| `cb folders update <id>`         | Update a folder                                              |
+| `cb folders delete <id>`         | Delete a folder                                              |
+| `cb folders share <id>`          | Share a folder                                               |
 
 Run `cb --help` or `cb <command> --help` for full usage details.
 
@@ -117,7 +123,9 @@ For stateless automation, set `CIRCLEBACK_API_KEY` instead of logging in:
 CIRCLEBACK_API_KEY=cb_your_api_key cb meetings --json
 ```
 
-Changing meetings, action items, tags, or sharing permissions needs write access. Browser logins from before v0.5.0 don't include it, so run `cb auth login` again; read-only API keys can't make changes.
+Changing meetings, action items, tags, folders, or sharing permissions needs write access. Browser logins from before v0.5.0 don't include it, so run `cb auth login` again; read-only API keys can't make changes.
+
+An API key limited to one folder only reaches that folder's meetings, transcripts, and action items, so `cb --help` lists just the commands it can run.
 
 `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.
 

package/dist/auth/credentials.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getCredentialSnapshot = exports.getLoginStatus = exports.getEnvironmentApiKey = void 0;
+exports.getCredentialSnapshot = exports.getCredentialFingerprint = exports.getLoginStatus = exports.getEnvironmentApiKey = void 0;
+const node_crypto_1 = require("node:crypto");
 const node_util_1 = require("node:util");
 const zod_1 = require("zod");
 const constants_1 = require("../constants");
@@ -79,6 +80,18 @@ const requireCredentials = () => {
     }
     return { type: types_1.CredentialType.OAuth, tokens: storedCredentials };
 };
+const getCredentialFingerprint = () => {
+    try {
+        const credentials = requireCredentials();
+        return credentials.type === types_1.CredentialType.ApiKey
+            ? (0, node_crypto_1.createHash)('sha256').update(credentials.apiKey).digest('hex')
+            : types_1.CredentialType.OAuth;
+    }
+    catch {
+        return;
+    }
+};
+exports.getCredentialFingerprint = getCredentialFingerprint;
 const getCredentialSnapshot = async () => {
     const credentials = requireCredentials();
     if (credentials.type === types_1.CredentialType.OAuth) {

package/dist/client/jsonRpc.js

@@ -1,11 +1,15 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.callTool = void 0;
+exports.listTools = exports.callTool = void 0;
 const zod_1 = require("zod");
 const constants_1 = require("../constants");
 const types_1 = require("../types");
 const credentials_1 = require("../auth/credentials");
+const tokenStorage_1 = require("../auth/tokenStorage");
+const value_1 = require("../helpers/value");
 const TOOLS_CALL_METHOD = 'tools/call';
+const TOOLS_LIST_METHOD = 'tools/list';
+const TOOLS_LIST_TIMEOUT_MILLISECONDS = 3_000;
 const errorResponseSchema = zod_1.z.object({
     error: zod_1.z.string().optional(),
     message: zod_1.z.string().optional(),
@@ -32,12 +36,13 @@ const HTTP_ERROR_MESSAGES = {
     404: 'Resource not found.',
     429: 'Rate limit exceeded. Please try again later.',
 };
-const sendRequest = async (method, params, accessToken) => fetch(`${constants_1.BASE_URL}/api/mcp`, {
+const sendRequest = async (method, params, accessToken, signal) => fetch(`${constants_1.BASE_URL}/api/mcp`, {
     method: 'POST',
+    signal,
     headers: {
         'Content-Type': 'application/json',
         Accept: 'application/json, text/event-stream',
-        Authorization: `Bearer ${accessToken}`,
+        ...((0, value_1.isPresent)(accessToken) && { Authorization: `Bearer ${accessToken}` }),
         [constants_1.CLIENT_VERSION_HEADER]: constants_1.CLIENT_VERSION,
     },
     body: JSON.stringify({
@@ -136,8 +141,32 @@ const callTool = async (toolName, toolArguments) => {
         const message = serverMessage ||
             fallback ||
             `Request failed with status ${response.status}.`;
-        throw new Error(response.status === 403 ? `${message} ${WRITE_ACCESS_HINT}` : message);
+        throw new Error(response.status === 403 && message.includes('insufficient scope')
+            ? `${message} ${WRITE_ACCESS_HINT}`
+            : message);
     }
     return parseResponse(response);
 };
 exports.callTool = callTool;
+const listTools = async () => {
+    const bearerCredential = (0, credentials_1.getEnvironmentApiKey)() || (0, tokenStorage_1.loadCredentials)()
+        ? (await (0, credentials_1.getCredentialSnapshot)()).bearerCredential
+        : undefined;
+    const response = await sendRequest(TOOLS_LIST_METHOD, {}, bearerCredential, AbortSignal.timeout(TOOLS_LIST_TIMEOUT_MILLISECONDS));
+    if (!response.ok)
+        throw new Error(await extractErrorMessage(response));
+    const text = await response.text();
+    const body = response.headers
+        .get('content-type')
+        ?.includes('text/event-stream')
+        ? text
+            .split('\n')
+            .find((line) => line.startsWith('data: '))
+            ?.slice(6)
+        : text;
+    return Object.fromEntries(types_1.ToolListResponseSchema.parse(JSON.parse(body ?? '')).result.tools.map(({ name, inputSchema }) => [
+        name,
+        Object.keys(inputSchema.properties ?? {}),
+    ]));
+};
+exports.listTools = listTools;

package/dist/commands/auth.js

@@ -12,6 +12,7 @@ const oauth_1 = require("../auth/oauth");
 const tokenStorage_1 = require("../auth/tokenStorage");
 const constants_1 = require("../constants");
 const output_1 = require("../helpers/output");
+const toolList_1 = require("../helpers/toolList");
 const types_1 = require("../types");
 const loginCommand = new commander_1.Command('login')
     .description('Log in to Circleback.')
@@ -33,11 +34,13 @@ const loginCommand = new commander_1.Command('login')
             const apiKey = await (0, apiKey_1.promptForApiKey)();
             await (0, apiKey_1.validateApiKey)(apiKey);
             (0, tokenStorage_1.saveCredentials)({ type: types_1.CredentialType.ApiKey, apiKey });
+            await (0, toolList_1.refreshToolList)();
             (0, output_1.printText)('Logged in with your API key.', output_1.TextType.Success);
             return;
         }
         (0, output_1.printText)('Opening your browser to log in…', output_1.TextType.Default);
         await (0, oauth_1.login)();
+        await (0, toolList_1.refreshToolList)();
         (0, output_1.printText)('Logged in successfully.', output_1.TextType.Success);
     }
     catch (error) {
@@ -48,9 +51,11 @@ const loginCommand = new commander_1.Command('login')
 });
 const logoutCommand = new commander_1.Command('logout')
     .description('Sign out on this device.')
-    .action(() => {
+    .action(async () => {
     const environmentApiKey = (0, credentials_1.getEnvironmentApiKey)();
     const didClearCredentials = (0, tokenStorage_1.clearCredentials)();
+    if (didClearCredentials)
+        await (0, toolList_1.refreshToolList)();
     if (!didClearCredentials) {
         if (environmentApiKey) {
             (0, output_1.printText)(`No saved login to clear. ${constants_1.API_KEY_ENVIRONMENT_VARIABLE} is still active.`, output_1.TextType.Warning);

package/dist/commands/folders.js

@@ -0,0 +1,113 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.shareFolderCommand = exports.deleteFolderCommand = exports.updateFolderCommand = exports.createFolderCommand = exports.readFoldersCommand = exports.listFoldersCommand = void 0;
+const commander_1 = require("commander");
+const command_1 = require("../helpers/command");
+const parse_1 = require("../helpers/parse");
+const tag_1 = require("../helpers/tag");
+const value_1 = require("../helpers/value");
+const types_1 = require("../types");
+exports.listFoldersCommand = (0, command_1.defineToolCommand)(new commander_1.Command('list').description('List folders.'), types_1.ToolName.ListFolders, () => ({}));
+exports.readFoldersCommand = (0, command_1.defineToolCommand)(new commander_1.Command('read')
+    .description('Read folders with their members, teams, and rules.')
+    .argument('<ids...>', 'Folder IDs (max 20)'), types_1.ToolName.ReadFolders, (folderIds) => ({ intent: 'Reading folders.', folderIds }));
+exports.createFolderCommand = (0, command_1.defineToolCommand)(new commander_1.Command('create')
+    .description('Create a folder.')
+    .argument('<name>', 'Folder name')
+    .requiredOption('--workspace <id>', 'Workspace ID')
+    .option('--private', 'Only show the folder to its members')
+    .option('--icon <icon>', 'Set the icon')
+    .addOption((0, tag_1.createColorOption)())
+    .option('--rules <json>', 'Set the rules (ruleGroups JSON)'), types_1.ToolName.CreateFolder, (name, options) => ({
+    name,
+    workspaceId: (0, parse_1.parseIntOption)(options.workspace, '--workspace'),
+    ...(options.private && { visibility: 'Private' }),
+    ...((0, value_1.isPresent)(options.icon) && { icon: options.icon }),
+    ...((0, value_1.isPresent)(options.color) && { color: (0, tag_1.getTagColor)(options.color) }),
+    ...((0, value_1.isPresent)(options.rules) && {
+        ruleGroups: (0, parse_1.parseJsonOption)(options.rules, '--rules'),
+    }),
+}));
+exports.updateFolderCommand = (0, command_1.defineToolCommand)(new commander_1.Command('update')
+    .description('Update a folder. Each option replaces the current value when provided.')
+    .argument('<id>', 'Folder ID')
+    .option('--name <name>', 'Update the name')
+    .option('--description <description>', 'Update the description, or "" to remove it')
+    .option('--icon <icon>', 'Update the icon, or "" to remove it')
+    .addOption(new commander_1.Option('--color <color>', 'Update the display color, or "" for the default').choices([...tag_1.TAG_COLOR_NAMES, '']))
+    .addOption(new commander_1.Option('--visibility <visibility>', 'Set who can find it').choices([
+    'Closed',
+    'Private',
+]))
+    .option('--rules <json>', 'Replace the rules (ruleGroups JSON, or "[]" to remove all)'), types_1.ToolName.UpdateFolder, (folderId, options) => {
+    if (!Object.values(options).some(value_1.isPresent)) {
+        throw new Error('Provide at least one field to update.');
+    }
+    const { rules, color, description, icon, ...fields } = options;
+    return {
+        folderId,
+        ...fields,
+        description: description === '' ? null : description,
+        icon: icon === '' ? null : icon,
+        color: color === '' ? null : (0, tag_1.getTagColor)(color),
+        ...((0, value_1.isPresent)(rules) && {
+            ruleGroups: (0, parse_1.parseJsonOption)(rules, '--rules'),
+        }),
+    };
+});
+exports.deleteFolderCommand = (0, command_1.defineToolCommand)(new commander_1.Command('delete')
+    .description('Delete a folder.')
+    .argument('<id>', 'Folder ID'), types_1.ToolName.DeleteFolder, (folderId) => ({ folderId }));
+exports.shareFolderCommand = (0, command_1.defineToolCommand)(new commander_1.Command('share')
+    .description('Share a folder, change access, or remove access.')
+    .argument('<id>', 'Folder ID')
+    .option('--email <emails>', 'Share with email addresses (comma-separated)')
+    .option('--profile <ids>', 'Share with people (comma-separated)')
+    .option('--team <ids>', 'Share with teams (comma-separated)')
+    .option('--workspace <ids>', 'Share with workspaces (comma-separated)')
+    .addOption(new commander_1.Option('--access <access>', "Set access to the folder's meetings, or none").choices([...Object.values(types_1.ShareableMeetingAccess), 'none']))
+    .option('--contributor', 'Let them add meetings')
+    .option('--no-contributor', 'Stop them adding meetings')
+    .option('--owner', 'Let people manage the folder')
+    .option('--no-owner', 'Stop people managing the folder')
+    .option('--remove', 'Remove them from the folder'), types_1.ToolName.ShareFolder, (folderId, options) => {
+    if ((0, value_1.isPresent)(options.owner) && (options.team || options.workspace)) {
+        throw new Error('--owner only applies to --email and --profile.');
+    }
+    const grant = {
+        ...((0, value_1.isPresent)(options.access) && {
+            access: options.access === 'none' ? null : options.access,
+        }),
+        ...((0, value_1.isPresent)(options.contributor) && {
+            isContributor: options.contributor,
+        }),
+        ...(options.remove && { remove: true }),
+    };
+    const personGrant = {
+        ...grant,
+        ...((0, value_1.isPresent)(options.owner) && { isOwner: options.owner }),
+    };
+    const parseIds = (value, label) => value ? (0, parse_1.parseNumericIds)(value, label) : [];
+    const shares = [
+        ...(options.email?.split(',') ?? []).map((email) => ({
+            email: email.trim(),
+            ...personGrant,
+        })),
+        ...parseIds(options.profile, 'profile ID').map((profileId) => ({
+            profileId,
+            ...personGrant,
+        })),
+        ...parseIds(options.team, 'team ID').map((teamId) => ({
+            teamId,
+            ...grant,
+        })),
+        ...parseIds(options.workspace, 'workspace ID').map((workspaceId) => ({
+            workspaceId,
+            ...grant,
+        })),
+    ];
+    if (shares.length === 0) {
+        throw new Error('Set at least one of --email, --profile, --team, or --workspace.');
+    }
+    return { folderId, shares };
+});

package/dist/commands/meetings.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.updateMeetingCommand = exports.shareMeetingCommand = exports.readMeetingsCommand = exports.searchMeetingsCommand = void 0;
+exports.createUpdateMeetingCommand = exports.shareMeetingCommand = exports.readMeetingsCommand = exports.createSearchMeetingsCommand = void 0;
 const commander_1 = require("commander");
 const constants_1 = require("../constants");
 const command_1 = require("../helpers/command");
@@ -10,30 +10,37 @@ const tag_1 = require("../helpers/tag");
 const value_1 = require("../helpers/value");
 const types_1 = require("../types");
 const DEFAULT_MEETINGS_SEARCH_LAST_DAYS = 7;
-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')
-    .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 <tags>', constants_1.TAGS_OPTION_DESCRIPTION)
-    .option('--profiles <ids>', constants_1.PROFILES_OPTION_DESCRIPTION)
-    .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,
-}));
+const createSearchMeetingsCommand = ({ canFilterByFolder, }) => {
+    const command = new commander_1.Command('search')
+        .description('Search meetings.')
+        .argument('[search]', 'Search term')
+        .option('-p, --page <index>', constants_1.PAGE_OPTION_DESCRIPTION, '0')
+        .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 <tags>', constants_1.TAGS_OPTION_DESCRIPTION)
+        .option('--profiles <ids>', constants_1.PROFILES_OPTION_DESCRIPTION)
+        .option('--domains <domains>', constants_1.DOMAINS_OPTION_DESCRIPTION);
+    return (0, command_1.defineToolCommand)(canFilterByFolder
+        ? command.option('--folder <id>', constants_1.FOLDER_OPTION_DESCRIPTION)
+        : command, 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 || options.folder
+                ? 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,
+        folderId: options.folder,
+    }));
+};
+exports.createSearchMeetingsCommand = createSearchMeetingsCommand;
 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})`), types_1.ToolName.ReadMeetings, (ids) => {
@@ -99,19 +106,30 @@ exports.shareMeetingCommand = (0, command_1.defineToolCommand)(new commander_1.C
         ],
     };
 });
-exports.updateMeetingCommand = (0, command_1.defineToolCommand)(new commander_1.Command('update')
-    .description('Update a meeting. Each option replaces the current value when provided.')
-    .argument('<id>', 'Meeting ID')
-    .option('--name <name>', 'Update the meeting name')
-    .option('--notes <notes>', 'Update the meeting notes (supports Markdown)')
-    .option('--private-notes <notes>', constants_1.PRIVATE_NOTES_UPDATE_OPTION_DESCRIPTION)
-    .option('--tags <tags>', constants_1.TAGS_UPDATE_OPTION_DESCRIPTION), types_1.ToolName.UpdateMeeting, async (meetingId, { tags, ...fields }) => {
-    if (!(0, value_1.isPresent)(tags) && !Object.values(fields).some(value_1.isPresent)) {
-        throw new Error('Provide at least one field to update.');
-    }
-    return {
-        meetingId,
-        ...fields,
-        ...((0, value_1.isPresent)(tags) && { tagIds: await (0, tag_1.resolveTagValues)(tags) }),
-    };
-});
+const createUpdateMeetingCommand = ({ canSetFolders, }) => {
+    const command = new commander_1.Command('update')
+        .description('Update a meeting. Each option replaces the current value when provided.')
+        .argument('<id>', 'Meeting ID')
+        .option('--name <name>', 'Update the meeting name')
+        .option('--notes <notes>', 'Update the meeting notes (supports Markdown)')
+        .option('--private-notes <notes>', constants_1.PRIVATE_NOTES_UPDATE_OPTION_DESCRIPTION)
+        .option('--tags <tags>', constants_1.TAGS_UPDATE_OPTION_DESCRIPTION);
+    return (0, command_1.defineToolCommand)(canSetFolders
+        ? command.option('--folders <ids>', constants_1.FOLDERS_UPDATE_OPTION_DESCRIPTION)
+        : command, types_1.ToolName.UpdateMeeting, async (meetingId, { tags, folders, ...fields }) => {
+        if (!(0, value_1.isPresent)(tags) &&
+            !(0, value_1.isPresent)(folders) &&
+            !Object.values(fields).some(value_1.isPresent)) {
+            throw new Error('Provide at least one field to update.');
+        }
+        return {
+            meetingId,
+            ...fields,
+            ...((0, value_1.isPresent)(tags) && { tagIds: await (0, tag_1.resolveTagValues)(tags) }),
+            ...((0, value_1.isPresent)(folders) && {
+                folderIds: folders.split(',').filter(Boolean),
+            }),
+        };
+    });
+};
+exports.createUpdateMeetingCommand = createUpdateMeetingCommand;

package/dist/commands/registry.js

@@ -7,6 +7,7 @@ const auth_1 = require("./auth");
 const calendar_1 = require("./calendar");
 const companies_1 = require("./companies");
 const emails_1 = require("./emails");
+const folders_1 = require("./folders");
 const meetings_1 = require("./meetings");
 const profiles_1 = require("./profiles");
 const support_1 = require("./support");
@@ -14,15 +15,31 @@ const tags_1 = require("./tags");
 const teams_1 = require("./teams");
 const transcripts_1 = require("./transcripts");
 const update_1 = require("./update");
+const command_1 = require("../helpers/command");
+const toolList_1 = require("../helpers/toolList");
+const value_1 = require("../helpers/value");
+const types_1 = require("../types");
 const standaloneCommands = [auth_1.authCommand, update_1.updateCommand];
-const commandGroups = [
+const getCommandGroups = (toolList) => [
     {
         name: 'meetings',
         description: 'Find, read, update, and share meetings.',
         subcommands: [
-            meetings_1.searchMeetingsCommand,
+            (0, meetings_1.createSearchMeetingsCommand)({
+                canFilterByFolder: (0, toolList_1.hasToolProperty)({
+                    toolList,
+                    toolName: types_1.ToolName.SearchMeetings,
+                    property: 'folderId',
+                }),
+            }),
             meetings_1.readMeetingsCommand,
-            meetings_1.updateMeetingCommand,
+            (0, meetings_1.createUpdateMeetingCommand)({
+                canSetFolders: (0, toolList_1.hasToolProperty)({
+                    toolList,
+                    toolName: types_1.ToolName.UpdateMeeting,
+                    property: 'folderIds',
+                }),
+            }),
             meetings_1.shareMeetingCommand,
         ],
     },
@@ -61,6 +78,18 @@ const commandGroups = [
         description: 'List your workspace and teams.',
         subcommands: [teams_1.listTeamsCommand],
     },
+    {
+        name: 'folders',
+        description: 'List, manage, and share folders.',
+        subcommands: [
+            folders_1.listFoldersCommand,
+            folders_1.readFoldersCommand,
+            folders_1.createFolderCommand,
+            folders_1.updateFolderCommand,
+            folders_1.deleteFolderCommand,
+            folders_1.shareFolderCommand,
+        ],
+    },
     {
         name: 'action-items',
         description: 'Search, create, update, and delete action items.',
@@ -83,8 +112,16 @@ const commandGroups = [
     },
 ];
 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 = () => [
+const getAllCommands = (toolList) => [
     ...standaloneCommands,
-    ...commandGroups.map(buildCommandGroup),
+    ...(0, value_1.filterMap)(getCommandGroups(toolList), (group) => {
+        const subcommands = group.subcommands.filter((command) => {
+            const toolName = (0, command_1.getCommandToolName)(command);
+            return (!(0, value_1.isPresent)(toolName) || !toolList || Object.hasOwn(toolList, toolName));
+        });
+        return subcommands.length > 0
+            ? buildCommandGroup({ ...group, subcommands })
+            : undefined;
+    }),
 ];
 exports.getAllCommands = getAllCommands;

package/dist/commands/tags.js

@@ -4,37 +4,25 @@ exports.deleteTagCommand = exports.updateTagCommand = exports.createTagCommand =
 const commander_1 = require("commander");
 const command_1 = require("../helpers/command");
 const parse_1 = require("../helpers/parse");
+const tag_1 = require("../helpers/tag");
 const value_1 = require("../helpers/value");
 const types_1 = require("../types");
-const createColorOption = () => new commander_1.Option('--color <color>', 'Set the display color').choices([
-    'neutral',
-    'red',
-    'rose',
-    'orange',
-    'amber',
-    'emerald',
-    'sky',
-    'blue',
-    'indigo',
-    'purple',
-]);
-const getTagColor = (color) => color ? `bg-tag-${color}` : undefined;
 exports.listTagsCommand = (0, command_1.defineToolCommand)(new commander_1.Command('list').description('List all tags.'), types_1.ToolName.ListTags, () => ({ intent: 'Listing all tags.' }));
 exports.createTagCommand = (0, command_1.defineToolCommand)(new commander_1.Command('create')
     .description('Create a tag.')
     .argument('<name>', 'Tag name')
     .option('--description <description>', 'Set the description')
-    .addOption(createColorOption()), types_1.ToolName.CreateTag, (name, options) => ({
+    .addOption((0, tag_1.createColorOption)()), types_1.ToolName.CreateTag, (name, options) => ({
     name,
     description: options.description,
-    color: getTagColor(options.color),
+    color: (0, tag_1.getTagColor)(options.color),
 }));
 exports.updateTagCommand = (0, command_1.defineToolCommand)(new commander_1.Command('update')
     .description('Update a tag.')
     .argument('<id>', 'Tag ID')
     .option('--name <name>', 'Set the name')
     .option('--description <description>', 'Set the description')
-    .addOption(createColorOption()), types_1.ToolName.UpdateTag, (identifier, options) => {
+    .addOption((0, tag_1.createColorOption)()), types_1.ToolName.UpdateTag, (identifier, options) => {
     if (!Object.values(options).some(value_1.isPresent)) {
         throw new Error('Provide at least one field to update.');
     }
@@ -42,7 +30,7 @@ exports.updateTagCommand = (0, command_1.defineToolCommand)(new commander_1.Comm
         tagId: (0, parse_1.parseIntOption)(identifier, 'id'),
         name: options.name,
         description: options.description,
-        color: getTagColor(options.color),
+        color: (0, tag_1.getTagColor)(options.color),
     };
 });
 exports.deleteTagCommand = (0, command_1.defineToolCommand)(new commander_1.Command('delete').description('Delete a tag.').argument('<id>', 'Tag ID'), types_1.ToolName.DeleteTag, (identifier) => ({ tagId: (0, parse_1.parseIntOption)(identifier, 'id') }));

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.DOMAINS_OPTION_DESCRIPTION = exports.PROFILES_OPTION_DESCRIPTION = exports.PRIVATE_NOTES_UPDATE_OPTION_DESCRIPTION = exports.TAGS_UPDATE_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.FOLDERS_UPDATE_OPTION_DESCRIPTION = exports.FOLDER_OPTION_DESCRIPTION = exports.DOMAINS_OPTION_DESCRIPTION = exports.PROFILES_OPTION_DESCRIPTION = exports.PRIVATE_NOTES_UPDATE_OPTION_DESCRIPTION = exports.TAGS_UPDATE_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"));
@@ -56,3 +56,5 @@ exports.TAGS_UPDATE_OPTION_DESCRIPTION = 'Update the tags (comma-separated names
 exports.PRIVATE_NOTES_UPDATE_OPTION_DESCRIPTION = 'Update your private notes (supports Markdown)';
 exports.PROFILES_OPTION_DESCRIPTION = 'Comma-separated profile IDs';
 exports.DOMAINS_OPTION_DESCRIPTION = 'Comma-separated domains';
+exports.FOLDER_OPTION_DESCRIPTION = 'Folder ID';
+exports.FOLDERS_UPDATE_OPTION_DESCRIPTION = 'Update the folders (comma-separated IDs, or "" to remove all)';

package/dist/helpers/command.js

@@ -1,19 +1,25 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.defineToolCommand = void 0;
+exports.defineToolCommand = exports.getCommandToolName = 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);
-    }
-});
+const commandToolNames = new WeakMap();
+const getCommandToolName = (command) => commandToolNames.get(command);
+exports.getCommandToolName = getCommandToolName;
+const defineToolCommand = (command, toolName, getArguments) => {
+    commandToolNames.set(command, toolName);
+    return 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/formatter.js

@@ -27,20 +27,20 @@ const formatTagChange = (verb, data) => {
     const { id, name } = result.data;
     return `${verb} tag ${id}: ${name}`;
 };
-const MeetingShareChangeSchema = zod_1.z.object({
+const ShareChangeSchema = zod_1.z.object({
     id: zod_1.z.string(),
     name: zod_1.z.string().nullable(),
     errors: zod_1.z
         .array(zod_1.z.object({ index: zod_1.z.number(), error: zod_1.z.string() }))
         .optional(),
 });
-const formatMeetingShareChange = (data) => {
-    const result = MeetingShareChangeSchema.safeParse(data);
+const formatShareChange = (kind, data) => {
+    const result = ShareChangeSchema.safeParse(data);
     if (!result.success)
         return;
     const { id, name, errors = [] } = result.data;
     return [
-        `Updated sharing for meeting ${id}${name ? `: ${name}` : ''}`,
+        `Updated sharing for ${kind} ${id}${name ? `: ${name}` : ''}`,
         ...errors.map(({ index, error }) => `Could not share target ${index + 1}: ${error}`),
     ].join('\n');
 };
@@ -59,7 +59,9 @@ const formatForTool = (toolName, data) => {
         case types_1.ToolName.DeleteTag:
             return formatTagChange('Deleted', data);
         case types_1.ToolName.ShareMeeting:
-            return formatMeetingShareChange(data);
+            return formatShareChange('meeting', data);
+        case types_1.ToolName.ShareFolder:
+            return formatShareChange('folder', data);
     }
     if (!Array.isArray(data))
         return;
@@ -87,6 +89,11 @@ const formatForTool = (toolName, data) => {
         case types_1.ToolName.ListTags:
             return (0, table_1.formatTags)(data);
         case types_1.ToolName.ListTeams:
+        case types_1.ToolName.ListFolders:
+        case types_1.ToolName.ReadFolders:
+        case types_1.ToolName.CreateFolder:
+        case types_1.ToolName.UpdateFolder:
+        case types_1.ToolName.DeleteFolder:
         case types_1.ToolName.UpdateMeeting:
         case types_1.ToolName.UpdateCalendarEvent:
             return;
@@ -98,6 +105,10 @@ const formatForTool = (toolName, data) => {
 };
 const formatOutput = (toolName, rawText, jsonMode) => {
     const parsed = (0, parse_1.extractAndValidateObjectFromString)(rawText, zod_1.z.json());
+    const isPartialShare = (toolName === types_1.ToolName.ShareMeeting || toolName === types_1.ToolName.ShareFolder) &&
+        (ShareChangeSchema.safeParse(parsed).data?.errors?.length ?? 0) > 0;
+    if (isPartialShare)
+        process.exitCode = 1;
     if (jsonMode) {
         (0, output_1.printText)(stringify(parsed), output_1.TextType.Default);
         return;

package/dist/helpers/parse.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.validateReadMeetingIdentifierLimit = exports.validateMeetingIdentifiers = exports.parseNumericIds = exports.parseOptionalIntOption = exports.parseIntOption = exports.extractAndValidateObjectFromString = void 0;
+exports.validateReadMeetingIdentifierLimit = exports.validateMeetingIdentifiers = exports.parseNumericIds = exports.parseOptionalIntOption = exports.parseJsonOption = exports.parseIntOption = exports.extractAndValidateObjectFromString = void 0;
 const zod_1 = require("zod");
 const constants_1 = require("../constants");
 const output_1 = require("./output");
@@ -29,6 +29,16 @@ const parseIntOption = (value, flagName) => {
     return result.data;
 };
 exports.parseIntOption = parseIntOption;
+const parseJsonOption = (value, flagName) => {
+    try {
+        return JSON.parse(value);
+    }
+    catch {
+        (0, output_1.printText)(`Invalid JSON for ${flagName}.`, output_1.TextType.Error);
+        process.exit(1);
+    }
+};
+exports.parseJsonOption = parseJsonOption;
 const parseOptionalIntOption = (value, flagName) => (value ? (0, exports.parseIntOption)(value, flagName) : undefined);
 exports.parseOptionalIntOption = parseOptionalIntOption;
 const parseNumericIds = (value, label) => {

package/dist/helpers/tag.js

@@ -1,11 +1,28 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.resolveTagValues = void 0;
+exports.resolveTagValues = exports.getTagColor = exports.createColorOption = exports.TAG_COLOR_NAMES = void 0;
+const commander_1 = require("commander");
 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");
+exports.TAG_COLOR_NAMES = [
+    'neutral',
+    'red',
+    'rose',
+    'orange',
+    'amber',
+    'emerald',
+    'sky',
+    'blue',
+    'indigo',
+    'purple',
+];
+const createColorOption = () => new commander_1.Option('--color <color>', 'Set the display color').choices(exports.TAG_COLOR_NAMES);
+exports.createColorOption = createColorOption;
+const getTagColor = (color) => color ? `bg-tag-${color}` : undefined;
+exports.getTagColor = getTagColor;
 const tagItemSchema = zod_1.z.object({
     id: zod_1.z.number(),
     name: zod_1.z.string(),

package/dist/helpers/toolList.js

@@ -0,0 +1,44 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.hasToolProperty = exports.refreshToolList = exports.readCachedToolList = void 0;
+const node_fs_1 = __importDefault(require("node:fs"));
+const node_path_1 = __importDefault(require("node:path"));
+const credentials_1 = require("../auth/credentials");
+const jsonRpc_1 = require("../client/jsonRpc");
+const constants_1 = require("../constants");
+const types_1 = require("../types");
+const CACHE_FILE = node_path_1.default.join(constants_1.CONFIG_DIRECTORY, 'tool-list.json');
+const REFRESH_INTERVAL_MILLISECONDS = 60 * 60 * 1000; // 1 hour
+const readCachedToolList = () => {
+    try {
+        const { tools, checkedAt, credential } = types_1.ToolListCacheSchema.parse(JSON.parse(node_fs_1.default.readFileSync(CACHE_FILE, 'utf-8')));
+        if (credential !== (0, credentials_1.getCredentialFingerprint)())
+            return { isStale: true };
+        return {
+            toolList: tools,
+            isStale: Date.now() - checkedAt >= REFRESH_INTERVAL_MILLISECONDS,
+        };
+    }
+    catch {
+        return { isStale: true };
+    }
+};
+exports.readCachedToolList = readCachedToolList;
+const refreshToolList = async () => {
+    try {
+        const credential = (0, credentials_1.getCredentialFingerprint)();
+        const tools = await (0, jsonRpc_1.listTools)();
+        node_fs_1.default.mkdirSync(constants_1.CONFIG_DIRECTORY, { recursive: true, mode: 0o700 });
+        node_fs_1.default.writeFileSync(CACHE_FILE, JSON.stringify({ tools, checkedAt: Date.now(), credential }), { mode: 0o600 });
+        return tools;
+    }
+    catch {
+        return;
+    }
+};
+exports.refreshToolList = refreshToolList;
+const hasToolProperty = ({ toolList, toolName, property, }) => !toolList || toolList[toolName]?.includes(property) === true;
+exports.hasToolProperty = hasToolProperty;

package/dist/helpers/value.js

@@ -1,5 +1,10 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.isPresent = void 0;
+exports.filterMap = exports.isPresent = void 0;
 const isPresent = (value) => value !== null && value !== undefined;
 exports.isPresent = isPresent;
+const filterMap = (array, mappingFunction) => array.flatMap((value, index) => {
+    const mapped = mappingFunction(value, index);
+    return (0, exports.isPresent)(mapped) ? [mapped] : [];
+});
+exports.filterMap = filterMap;

package/dist/index.js

@@ -8,9 +8,16 @@ const constants_1 = require("./constants");
 const help_1 = require("./helpers/help");
 const output_1 = require("./helpers/output");
 const style_1 = require("./helpers/style");
+const toolList_1 = require("./helpers/toolList");
 const update_1 = require("./helpers/update");
+const value_1 = require("./helpers/value");
 const program = new commander_1.Command();
 const updateCheck = (0, update_1.getUpdateCheckResult)(constants_1.CLIENT_PACKAGE_NAME);
+const isRootHelp = process.argv
+    .slice(2)
+    .every((argument) => ['--help', '-h', '--json', 'help', '--'].includes(argument));
+const cachedToolList = (0, toolList_1.readCachedToolList)();
+const toolListRefresh = isRootHelp || cachedToolList.isStale ? (0, toolList_1.refreshToolList)() : undefined;
 const configureCommandOutput = (command) => {
     command.helpOption('-h, --help', 'Display help for command');
     if (command.commands.length > 0) {
@@ -27,11 +34,7 @@ program
     .name('circleback')
     .version(constants_1.CLIENT_VERSION, '-V, --version', 'Output the version number')
     .option('--json', 'Output raw JSON instead of formatted text')
-    .allowExcessArguments(false)
-    .action(() => program.help())
     .exitOverride();
-(0, registry_1.getAllCommands)().reduce((p, command) => p.addCommand(command), program);
-configureCommandOutput(program);
 program.hook('postAction', async (_thisCommand, actionCommand) => {
     if (actionCommand.name() === 'update')
         return;
@@ -41,11 +44,13 @@ program.hook('postAction', async (_thisCommand, actionCommand) => {
     catch { }
 });
 const run = async () => {
-    const isRootHelp = process.argv
-        .slice(2)
-        .every((argument) => ['--help', '-h', '--json', 'help', '--'].includes(argument));
-    if (isRootHelp) {
-        const loginStatus = await (0, credentials_1.getLoginStatus)();
+    const [loginStatus, refreshedToolList] = await Promise.all([
+        isRootHelp ? (0, credentials_1.getLoginStatus)() : undefined,
+        toolListRefresh,
+    ]);
+    (0, registry_1.getAllCommands)(refreshedToolList ?? cachedToolList.toolList).reduce((p, command) => p.addCommand(command), program);
+    configureCommandOutput(program);
+    if ((0, value_1.isPresent)(loginStatus)) {
         program
             .addHelpText('before', () => (0, style_1.formatWelcomeBanner)(process.stdout.columns ?? 80, loginStatus))
             .addHelpText('before', [
@@ -57,6 +62,7 @@ const run = async () => {
             '  cb meetings --json             Get JSON for scripts',
             '',
         ].join('\n'));
+        program.help();
     }
     await program.parseAsync();
 };

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.ShareableMeetingAccess = exports.ActionItemStatus = exports.ToolName = exports.CredentialSource = exports.CredentialType = void 0;
+exports.isJsonRpcResponse = exports.jsonRpcResultSchema = exports.isOAuthTokenResponse = exports.isStoredApiKey = exports.parseStoredCredentials = exports.ShareableMeetingAccess = exports.ActionItemStatus = exports.ToolName = exports.ToolListCacheSchema = exports.ToolListResponseSchema = exports.CredentialSource = exports.CredentialType = void 0;
 const zod_1 = require("zod");
 var CredentialType;
 (function (CredentialType) {
@@ -12,6 +12,21 @@ var CredentialSource;
     CredentialSource["Environment"] = "environment";
     CredentialSource["Stored"] = "stored";
 })(CredentialSource || (exports.CredentialSource = CredentialSource = {}));
+exports.ToolListResponseSchema = zod_1.z.object({
+    result: zod_1.z.object({
+        tools: zod_1.z.array(zod_1.z.object({
+            name: zod_1.z.string(),
+            inputSchema: zod_1.z.object({
+                properties: zod_1.z.record(zod_1.z.string(), zod_1.z.unknown()).optional(),
+            }),
+        })),
+    }),
+});
+exports.ToolListCacheSchema = zod_1.z.object({
+    tools: zod_1.z.record(zod_1.z.string(), zod_1.z.array(zod_1.z.string())),
+    checkedAt: zod_1.z.number(),
+    credential: zod_1.z.string().optional(),
+});
 var ToolName;
 (function (ToolName) {
     ToolName["SearchMeetings"] = "SearchMeetings";
@@ -26,12 +41,18 @@ var ToolName;
     ToolName["SearchActionItems"] = "SearchActionItems";
     ToolName["ListTags"] = "ListTags";
     ToolName["ListTeams"] = "ListTeams";
+    ToolName["ListFolders"] = "ListFolders";
+    ToolName["ReadFolders"] = "ReadFolders";
     ToolName["CreateActionItem"] = "CreateActionItem";
     ToolName["UpdateActionItem"] = "UpdateActionItem";
     ToolName["DeleteActionItem"] = "DeleteActionItem";
     ToolName["CreateTag"] = "CreateTag";
     ToolName["UpdateTag"] = "UpdateTag";
     ToolName["DeleteTag"] = "DeleteTag";
+    ToolName["CreateFolder"] = "CreateFolder";
+    ToolName["UpdateFolder"] = "UpdateFolder";
+    ToolName["DeleteFolder"] = "DeleteFolder";
+    ToolName["ShareFolder"] = "ShareFolder";
     ToolName["ShareMeeting"] = "ShareMeeting";
     ToolName["UpdateMeeting"] = "UpdateMeeting";
     ToolName["UpdateCalendarEvent"] = "UpdateCalendarEvent";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@circleback/cli",
-  "version": "1.1.0",
+  "version": "1.2.0",
   "description": "Circleback CLI. Search and access meetings, emails, calendar events, and more.",
   "license": "MIT",
   "author": "Circleback <support@circleback.ai> (https://circleback.ai)",
@@ -24,7 +24,7 @@
   "scripts": {
     "prebuild": "rm -rf dist",
     "build": "tsc && chmod +x dist/index.js",
-    "typecheck": "tsc --noEmit",
+    "typecheck": "bun check --all",
     "test:unit": "jest --runInBand",
     "postinstall": "echo '\n  Welcome to the Circleback CLI. Run `circleback` or `cb` to get started.\n'",
     "prepublishOnly": "pnpm run build"