@circleback/cli 0.6.0 → 0.8.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.
+Search and access your meetings, transcripts, emails, calendar events, and more from the terminal, and manage your action items, tags, and meeting access.
 
 ## Installation
 
@@ -22,8 +22,8 @@ cb meetings
 # Search by keyword
 cb meetings "product review"
 
-# Read by ID (from the meeting URL, e.g. circleback.ai/meetings/Vd6Pz8WqLm3xY2cRhTn7K)
-cb meetings read Vd6Pz8WqLm3xY2cRhTn7K
+# Read by ID (from the meeting URL, e.g. circleback.ai/meetings/abc123)
+cb meetings read abc123
 
 # Search transcripts
 cb transcripts "pricing discussion"
@@ -48,9 +48,12 @@ cb meetings --json
 | `cb update`                            | Update CLI to the latest version                                |
 | `cb meetings [search]`                 | Search meetings                                                 |
 | `cb meetings read <ids...>`            | Read detailed meeting info, notes, and action items (max 50)    |
+| `cb meetings update <id>`              | Update a meeting's name, notes, or private notes                |
+| `cb meetings share <id>`               | Share a meeting or remove access                                |
 | `cb transcripts <search>`              | Search transcript content                                       |
 | `cb transcripts read <ids...>`         | Read full transcripts (max 50)                                  |
 | `cb calendar`                          | Search calendar events                                          |
+| `cb calendar update <id>`              | Update private notes for a meeting before it starts             |
 | `cb people <names...>`                 | Search people by name                                           |
 | `cb companies <terms...>`              | Search companies by name or domain                              |
 | `cb emails [search]`                   | Search connected email accounts                                 |
@@ -115,7 +118,7 @@ For stateless automation, set `CIRCLEBACK_API_KEY` instead of logging in:
 CIRCLEBACK_API_KEY=cb_your_api_key cb meetings --json
 ```
 
-Changing action items or tags 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, 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.
 
 `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/commands/calendar.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.searchCalendarCommand = void 0;
+exports.updateCalendarEventCommand = exports.searchCalendarCommand = void 0;
 const commander_1 = require("commander");
 const constants_1 = require("../constants");
 const command_1 = require("../helpers/command");
@@ -16,3 +16,10 @@ exports.searchCalendarCommand = (0, command_1.defineToolCommand)(new commander_1
     startDate: (0, date_1.getStartDate)(options),
     endDate: options.to || undefined,
 }));
+exports.updateCalendarEventCommand = (0, command_1.defineToolCommand)(new commander_1.Command('update')
+    .description('Update private notes for a meeting before it starts. Replaces the current notes.')
+    .argument('<id>', 'Event ID from `cb calendar`')
+    .requiredOption('--private-notes <notes>', 'Your private notes (Markdown)'), types_1.ToolName.UpdateCalendarEvent, (calendarMeetingId, { privateNotes }) => ({
+    calendarMeetingId,
+    privateNotes,
+}));

package/dist/commands/meetings.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.readMeetingsCommand = exports.searchMeetingsCommand = void 0;
+exports.updateMeetingCommand = exports.shareMeetingCommand = exports.readMeetingsCommand = exports.searchMeetingsCommand = void 0;
 const commander_1 = require("commander");
 const constants_1 = require("../constants");
 const command_1 = require("../helpers/command");
@@ -43,3 +43,74 @@ exports.readMeetingsCommand = (0, command_1.defineToolCommand)(new commander_1.C
         meetingIds,
     };
 });
+const ACCESS_LEVELS = [...Object.values(types_1.ShareableMeetingAccess), 'none'];
+const getAccess = (access) => access === 'none' ? null : access;
+exports.shareMeetingCommand = (0, command_1.defineToolCommand)(new commander_1.Command('share')
+    .description('Share a meeting, or remove access with --access none.')
+    .argument('<id>', 'Meeting ID')
+    .option('--email <emails>', 'Share with email addresses (comma-separated)')
+    .option('--profile <ids>', 'Share with people (comma-separated)')
+    .option('--workspace <ids>', 'Share with workspaces (comma-separated)')
+    .option('--team <ids>', 'Share with teams (comma-separated)')
+    .addOption(new commander_1.Option('--access <access>', 'Set the access level, or none to remove access (required with --email or --profile)').choices(ACCESS_LEVELS))
+    .addOption(new commander_1.Option('--link <access>', 'Set the meeting link access, or none to turn it off').choices(ACCESS_LEVELS))
+    .option('--send-email', 'Email the people the meeting is shared with'), types_1.ToolName.ShareMeeting, (meetingId, options) => {
+    const targets = [
+        options.email,
+        options.profile,
+        options.team,
+        options.workspace,
+        options.link,
+    ];
+    if (targets.every((target) => target === undefined)) {
+        throw new Error('Set at least one of --email, --profile, --team, --workspace, or --link.');
+    }
+    if ((options.email || options.profile) && !options.access) {
+        throw new Error('--access is required with --email or --profile.');
+    }
+    const access = getAccess(options.access);
+    const sendEmail = options.sendEmail;
+    const parseIds = (value, label) => value ? (0, parse_1.parseNumericIds)(value, label) : [];
+    return {
+        meetingId,
+        shares: [
+            ...(options.email?.split(',') ?? []).map((email) => ({
+                email: email.trim(),
+                access,
+                sendEmail,
+            })),
+            ...parseIds(options.profile, 'profile ID').map((profileId) => ({
+                profileId,
+                access,
+                sendEmail,
+            })),
+            ...parseIds(options.team, 'team ID').map((teamId) => ({
+                teamId,
+                access,
+                sendEmail,
+            })),
+            ...parseIds(options.workspace, 'workspace ID').map((workspaceId) => ({
+                workspaceId,
+                access,
+                sendEmail,
+            })),
+            ...(options.link ? [{ linkAccess: getAccess(options.link) }] : []),
+        ],
+    };
+});
+const addMeetingFieldOptions = (command) => command
+    .option('--name <name>', 'Set the name')
+    .option('--notes <notes>', 'Set the notes (Markdown)')
+    .option('--private-notes <notes>', 'Set your private notes (Markdown)');
+const getMeetingFields = (fields) => {
+    if (!Object.values(fields).some((value) => value !== undefined)) {
+        throw new Error('Provide at least one field to update.');
+    }
+    return fields;
+};
+exports.updateMeetingCommand = (0, command_1.defineToolCommand)(addMeetingFieldOptions(new commander_1.Command('update')
+    .description('Update a meeting. Each option replaces the current value.')
+    .argument('<id>', 'Meeting ID')), types_1.ToolName.UpdateMeeting, (meetingId, fields) => ({
+    meetingId,
+    ...getMeetingFields(fields),
+}));

package/dist/commands/registry.js

@@ -17,8 +17,13 @@ const standaloneCommands = [auth_1.authCommand, update_1.updateCommand];
 const commandGroups = [
     {
         name: 'meetings',
-        description: 'Find meetings and read notes.',
-        subcommands: [meetings_1.searchMeetingsCommand, meetings_1.readMeetingsCommand],
+        description: 'Find, read, update, and share meetings.',
+        subcommands: [
+            meetings_1.searchMeetingsCommand,
+            meetings_1.readMeetingsCommand,
+            meetings_1.updateMeetingCommand,
+            meetings_1.shareMeetingCommand,
+        ],
     },
     {
         name: 'transcripts',
@@ -27,8 +32,8 @@ const commandGroups = [
     },
     {
         name: 'calendar',
-        description: 'Search calendar events.',
-        subcommands: [calendar_1.searchCalendarCommand],
+        description: 'Search and update calendar events.',
+        subcommands: [calendar_1.searchCalendarCommand, calendar_1.updateCalendarEventCommand],
     },
     {
         name: 'people',

package/dist/helpers/formatter.js

@@ -27,6 +27,23 @@ const formatTagChange = (verb, data) => {
     const { id, name } = result.data;
     return `${verb} tag ${id}: ${name}`;
 };
+const MeetingShareChangeSchema = 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);
+    if (!result.success)
+        return;
+    const { id, name, errors = [] } = result.data;
+    return [
+        `Updated sharing for meeting ${id}${name ? `: ${name}` : ''}`,
+        ...errors.map(({ index, error }) => `Could not share target ${index + 1}: ${error}`),
+    ].join('\n');
+};
 const formatForTool = (toolName, data) => {
     switch (toolName) {
         case types_1.ToolName.CreateActionItem:
@@ -41,6 +58,8 @@ const formatForTool = (toolName, data) => {
             return formatTagChange('Updated', data);
         case types_1.ToolName.DeleteTag:
             return formatTagChange('Deleted', data);
+        case types_1.ToolName.ShareMeeting:
+            return formatMeetingShareChange(data);
     }
     if (!Array.isArray(data))
         return;
@@ -69,6 +88,8 @@ const formatForTool = (toolName, data) => {
             return (0, table_1.formatTags)(data);
         case types_1.ToolName.AddTagToMeetings:
         case types_1.ToolName.RemoveTagFromMeetings:
+        case types_1.ToolName.UpdateMeeting:
+        case types_1.ToolName.UpdateCalendarEvent:
             return;
         default: {
             const _absurd = toolName;

package/dist/helpers/table.js

@@ -140,17 +140,26 @@ const formatCalendarEvents = (events) => {
     const table = new cli_table3_1.default({
         head: [
             style_1.brand.bold('Title'),
+            style_1.brand.bold('ID'),
             style_1.brand.bold('Start'),
             style_1.brand.bold('End'),
             style_1.brand.bold('Platform'),
             style_1.brand.bold('Attendees'),
         ],
-        colWidths: [30, 20, 20, 12, 35],
+        colWidths: [
+            30,
+            idColumnWidth(events.map((event) => event.id)),
+            20,
+            20,
+            12,
+            35,
+        ],
         wordWrap: true,
         style: style_1.tableStyle,
     });
     table.push(...events.map((event) => [
         (0, string_1.truncate)(event.title, 28),
+        event.id,
         (0, date_1.formatDateTime)(event.startTime),
         (0, date_1.formatDateTime)(event.endTime),
         event.platform ?? '-',

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.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.CredentialSource = exports.CredentialType = void 0;
 const zod_1 = require("zod");
 var CredentialType;
 (function (CredentialType) {
@@ -33,12 +33,21 @@ var ToolName;
     ToolName["DeleteTag"] = "DeleteTag";
     ToolName["AddTagToMeetings"] = "AddTagToMeetings";
     ToolName["RemoveTagFromMeetings"] = "RemoveTagFromMeetings";
+    ToolName["ShareMeeting"] = "ShareMeeting";
+    ToolName["UpdateMeeting"] = "UpdateMeeting";
+    ToolName["UpdateCalendarEvent"] = "UpdateCalendarEvent";
 })(ToolName || (exports.ToolName = ToolName = {}));
 var ActionItemStatus;
 (function (ActionItemStatus) {
     ActionItemStatus["Pending"] = "PENDING";
     ActionItemStatus["Done"] = "DONE";
 })(ActionItemStatus || (exports.ActionItemStatus = ActionItemStatus = {}));
+var ShareableMeetingAccess;
+(function (ShareableMeetingAccess) {
+    ShareableMeetingAccess["Editor"] = "Editor";
+    ShareableMeetingAccess["Viewer"] = "Viewer";
+    ShareableMeetingAccess["LimitedViewer"] = "LimitedViewer";
+})(ShareableMeetingAccess || (exports.ShareableMeetingAccess = ShareableMeetingAccess = {}));
 const storedTokensSchema = zod_1.z.object({
     accessToken: zod_1.z.string(),
     refreshToken: zod_1.z.string(),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@circleback/cli",
-  "version": "0.6.0",
+  "version": "0.8.0",
   "description": "Circleback CLI. Search and access meetings, emails, calendar events, and more.",
   "license": "MIT",
   "author": "Circleback <support@circleback.ai> (https://circleback.ai)",