@dench.com/cli 2.8.7-staging.189 → 2.8.8-staging.192

package/lib/api-schemas.ts

@@ -545,6 +545,73 @@ const crmEntryShape = z
 
 const entryWriteResponse = z.object({ entryId: z.string() });
 
+const commentActorShape = z
+  .object({
+    kind: z.string(),
+    label: z.string(),
+    displayName: z.string().optional(),
+    imageUrl: z.string().optional(),
+    userId: z.string().optional(),
+    isDench: z.boolean(),
+  })
+  .passthrough();
+
+const commentShape = z
+  .object({
+    _id: z.string(),
+    entryId: z.string(),
+    parentCommentId: z.string().optional(),
+    rootCommentId: z.string().optional(),
+    depth: z.number(),
+    body: z.string().describe("Markdown."),
+    actor: commentActorShape,
+    mentionedUserIds: z.array(z.string()),
+    mentionsDench: z.boolean(),
+    replyCount: z.number(),
+    reactionSummary: z.array(
+      z.object({ emoji: z.string(), count: z.number() }),
+    ),
+    viewerReactions: z.array(z.string()),
+    editedAt: z.number().optional(),
+    deletedAt: z.number().optional(),
+    denchStatus: z.enum(["pending", "failed", "done"]).optional(),
+    canEdit: z.boolean(),
+    createdAt: z.number(),
+  })
+  .passthrough()
+  .describe("A comment on a CRM entry.");
+
+const commentPage = z.object({
+  page: z.array(commentShape),
+  isDone: z.boolean(),
+  continueCursor: z.string(),
+});
+
+const notificationShape = z
+  .object({
+    _id: z.string(),
+    kind: z.string(),
+    title: z.string(),
+    body: z.string().optional(),
+    link: z.string().optional(),
+    readAt: z.number().optional(),
+    archivedAt: z.number().optional(),
+    createdAt: z.number(),
+  })
+  .passthrough();
+
+const notificationPreferencesShape = z.object({
+  inAppEnabled: z.boolean(),
+  emailEnabled: z.boolean(),
+  perKind: z.record(
+    z.string(),
+    z.object({ inApp: z.boolean().optional(), email: z.boolean().optional() }),
+  ),
+  timezone: z.string().nullable(),
+  digestWindowMinutes: z.number(),
+  maxEmailsPerDay: z.number(),
+});
+
 const crmBatchResults = z.object({
   results: z.array(
     z
@@ -1593,7 +1660,9 @@ export const requestSchemas: Record<string, ZodTypeAny> = {
     icon: z
       .string()
       .optional()
-      .describe("Hugeicons (or legacy Lucide) icon name, e.g. user-multiple, target-01."),
+      .describe(
+        "Hugeicons (or legacy Lucide) icon name, e.g. user-multiple, target-01.",
+      ),
   }),
   "crm.objects.update": z.object({
     name: z.string(),
@@ -1804,6 +1873,92 @@ export const requestSchemas: Record<string, ZodTypeAny> = {
     entryIds: z.array(z.string()).max(200),
   }),
 
+  // CRM comments
+  "crm.comments.list": z.object({
+    objectName: z.string(),
+    entryId: z.string(),
+    limit: z.coerce.number().int().min(1).max(100).optional(),
+    cursor: z
+      .string()
+      .optional()
+      .describe("continueCursor from the prior page."),
+    replies: z.coerce
+      .number()
+      .int()
+      .min(0)
+      .max(50)
+      .optional()
+      .describe("Preview replies per root (default 2)."),
+  }),
+  "crm.comments.replies": z.object({
+    commentId: z.string().describe("Root comment id."),
+    limit: z.coerce.number().int().min(1).max(100).optional(),
+    cursor: z.string().optional(),
+  }),
+  "crm.comments.get": z.object({ commentId: z.string() }),
+  "crm.comments.create": z.object({
+    objectName: z.string(),
+    entryId: z.string(),
+    body: z
+      .string()
+      .min(1)
+      .describe(
+        "Markdown. Mention a member with [@Name](/?member=<userId>); mention Dench with [@Dench](/?member=dench).",
+      ),
+    parentCommentId: z
+      .string()
+      .optional()
+      .describe("Reply under this comment (any depth)."),
+    mentionUserIds: z
+      .array(z.string())
+      .optional()
+      .describe("Extra members to notify without writing mention links."),
+    mentionDench: z
+      .boolean()
+      .optional()
+      .describe("Summon Dench to reply in the thread."),
+  }),
+  "crm.comments.update": z.object({
+    commentId: z.string(),
+    body: z.string().min(1),
+  }),
+  "crm.comments.delete": z.object({ commentId: z.string() }),
+  "crm.comments.react": z.object({
+    commentId: z.string(),
+    emoji: z.string().describe("A single emoji, e.g. 👍."),
+  }),
+  "crm.watch.get": z.object({ objectName: z.string(), entryId: z.string() }),
+  "crm.watch.set": z.object({
+    objectName: z.string(),
+    entryId: z.string(),
+    watching: z
+      .boolean()
+      .optional()
+      .describe("Defaults to true; false unfollows."),
+  }),
+
+  // CRM tasks
+  "crm.tasks.mine": z.object({
+    limit: z.coerce.number().int().min(1).max(500).optional(),
+  }),
+  "crm.tasks.forEntry": z.object({
+    objectName: z.string(),
+    entryId: z.string(),
+  }),
+  "crm.tasks.createForEntry": z.object({
+    objectName: z.string(),
+    entryId: z.string(),
+    name: z.string().min(1),
+    assigneeUserId: z.string().optional(),
+    dueDateKey: z
+      .string()
+      .regex(/^\d{4}-\d{2}-\d{2}$/)
+      .optional()
+      .describe("YYYY-MM-DD"),
+  }),
+  "crm.tasks.complete": z.object({ entryId: z.string() }),
+  "crm.tasks.reopen": z.object({ entryId: z.string() }),
+
   // CRM cells
   "crm.cells.get": z.object({
     objectName: z.string(),
@@ -2265,6 +2420,39 @@ export const requestSchemas: Record<string, ZodTypeAny> = {
       .string()
       .describe("Human name for the account. Empty clears it."),
   }),
+
+  // Notifications
+  "notifications.list": z.object({
+    filter: z.enum(["inbox", "unread", "archived", "all"]).optional(),
+    limit: z.coerce.number().int().min(1).max(100).optional(),
+  }),
+  "notifications.unreadCount": noInput,
+  "notifications.read": z.object({
+    notificationId: z.string(),
+    read: z
+      .boolean()
+      .optional()
+      .describe("Defaults to true; false marks unread."),
+  }),
+  "notifications.readAll": noInput,
+  "notifications.archive": z.object({ notificationId: z.string() }),
+  "notifications.preferences.get": noInput,
+  "notifications.preferences.update": z.object({
+    inAppEnabled: z.boolean().optional(),
+    emailEnabled: z.boolean().optional(),
+    perKind: z
+      .record(
+        z.string(),
+        z.object({
+          inApp: z.boolean().optional(),
+          email: z.boolean().optional(),
+        }),
+      )
+      .optional(),
+    timezone: z.string().optional(),
+    digestWindowMinutes: z.number().int().optional(),
+    maxEmailsPerDay: z.number().int().optional(),
+  }),
 };
 
 // ---------------------------------------------------------------------------
@@ -2552,6 +2740,54 @@ export const responseSchemas: Record<string, ZodTypeAny> = {
   }),
   "crm.cells.append": entryWriteResponse,
 
+  // CRM comments + tasks
+  "crm.comments.list": commentPage.extend({
+    page: z.array(commentShape.extend({ replies: z.array(commentShape) })),
+  }),
+  "crm.comments.replies": commentPage,
+  "crm.comments.get": commentShape.extend({
+    objectName: z.string(),
+    entryLabel: z.string(),
+  }),
+  "crm.comments.create": z.object({
+    id: z.string(),
+    rootCommentId: z.string().optional(),
+    depth: z.number(),
+    mentionedUserIds: z.array(z.string()),
+    mentionsDench: z.boolean(),
+  }),
+  "crm.comments.update": z.object({
+    ok: z.boolean(),
+    newlyMentioned: z.array(z.string()),
+  }),
+  "crm.comments.delete": z.object({ ok: z.boolean(), tombstoned: z.boolean() }),
+  "crm.comments.react": z.object({
+    reacted: z.boolean(),
+    reactionSummary: z.array(
+      z.object({ emoji: z.string(), count: z.number() }),
+    ),
+  }),
+  "crm.watch.get": z.object({
+    watching: z.boolean(),
+    reason: z.string().optional(),
+    watcherCount: z.number(),
+  }),
+  "crm.watch.set": z.object({ watching: z.boolean() }),
+  "crm.tasks.mine": z.array(z.object({}).passthrough()),
+  "crm.tasks.forEntry": z.array(z.object({}).passthrough()),
+  "crm.tasks.createForEntry": z.object({}).passthrough(),
+  "crm.tasks.complete": z.object({}).passthrough(),
+  "crm.tasks.reopen": z.object({}).passthrough(),
+
+  // Notifications
+  "notifications.list": z.array(notificationShape),
+  "notifications.unreadCount": z.number(),
+  "notifications.read": okResponse,
+  "notifications.readAll": z.object({ ok: z.boolean(), patched: z.number() }),
+  "notifications.archive": okResponse,
+  "notifications.preferences.get": notificationPreferencesShape.nullable(),
+  "notifications.preferences.update": okResponse,
+
   // CRM query + search
   "crm.query": z
     .array(crmEntryShape)
@@ -3147,6 +3383,21 @@ export const requestExamples: Record<string, unknown> = {
       Status: "New",
     },
   },
+  "crm.comments.create": {
+    body: "Kickoff went well — [@Bob](/?member=user_bob) can you send the proposal? [@Dench](/?member=dench) what's the ARR here?",
+  },
+  "crm.comments.update": { body: "Kickoff went well — proposal sent." },
+  "crm.watch.set": { watching: true },
+  "crm.tasks.createForEntry": {
+    name: "Send proposal",
+    assigneeUserId: "user_bob",
+    dueDateKey: "2026-09-05",
+  },
+  "notifications.read": { read: true },
+  "notifications.preferences.update": {
+    emailEnabled: true,
+    perKind: { entry_activity: { email: false } },
+  },
   "crm.entries.createMany": {
     entries: [
       { Name: "Jane", Email: "jane@example.com" },
@@ -3696,6 +3947,79 @@ export const responseExamples: Record<string, unknown> = {
     ok: true,
     enumColors: ["#94a3b8", "#3b82f6", "#22c55e", "#ef4444"],
   },
+  "crm.comments.list": {
+    page: [
+      {
+        _id: "cmt_01",
+        entryId: "ent_lead99",
+        depth: 0,
+        body: "Kickoff went well — [@Bob](/?member=user_bob) can you send the proposal?",
+        actor: {
+          kind: "user",
+          label: "Ada",
+          displayName: "Ada Lovelace",
+          userId: "user_ada",
+          isDench: false,
+        },
+        mentionedUserIds: ["user_bob"],
+        mentionsDench: false,
+        replyCount: 1,
+        reactionSummary: [{ emoji: "👍", count: 2 }],
+        viewerReactions: ["👍"],
+        canEdit: true,
+        createdAt: 1765526400000,
+        replies: [
+          {
+            _id: "cmt_02",
+            entryId: "ent_lead99",
+            parentCommentId: "cmt_01",
+            rootCommentId: "cmt_01",
+            depth: 1,
+            body: "On it.",
+            actor: {
+              kind: "user",
+              label: "Bob",
+              displayName: "Bob Smith",
+              userId: "user_bob",
+              isDench: false,
+            },
+            mentionedUserIds: [],
+            mentionsDench: false,
+            replyCount: 0,
+            reactionSummary: [],
+            viewerReactions: [],
+            canEdit: false,
+            createdAt: 1765530000000,
+          },
+        ],
+      },
+    ],
+    isDone: true,
+    continueCursor: "",
+  },
+  "crm.comments.create": {
+    id: "cmt_03",
+    rootCommentId: "cmt_01",
+    depth: 1,
+    mentionedUserIds: ["user_bob"],
+    mentionsDench: true,
+  },
+  "crm.comments.react": {
+    reacted: true,
+    reactionSummary: [{ emoji: "👍", count: 3 }],
+  },
+  "crm.watch.get": { watching: true, reason: "commented", watcherCount: 3 },
+  "notifications.list": [
+    {
+      _id: "ntf_01",
+      kind: "mention",
+      title: "Ada Lovelace mentioned you in Ramp",
+      body: "Kickoff went well — @Bob can you send the proposal?",
+      link: "/acme?entry=company%3Aent_lead99&comment=cmt_01",
+      createdAt: 1765526400000,
+    },
+  ],
+  "notifications.unreadCount": 3,
   "crm.entries.list": [
     {
       id: "ent_lead99",

package/lib/command-registry.ts

@@ -79,6 +79,24 @@ function op(operation: ApiOperation): ApiOperation {
   return operation;
 }
 
+/** `?limit=&cursor=` → Convex `paginationOpts`. */
+function paginationOptsFrom(
+  input: Record<string, unknown>,
+  defaultLimit: number,
+): { numItems: number; cursor: string | null } {
+  const limit =
+    typeof input.limit === "number"
+      ? Math.min(Math.max(Math.floor(input.limit), 1), 100)
+      : defaultLimit;
+  return {
+    numItems: limit,
+    cursor:
+      typeof input.cursor === "string" && input.cursor.length > 0
+        ? input.cursor
+        : null,
+  };
+}
+
 function convex(
   functionType: ConvexOperation["functionType"],
   functionName: string,
@@ -1042,6 +1060,198 @@ const rawApiOperations = [
       },
     },
   }),
+
+  // CRM comments — threaded conversation on a record, merged with history
+  // into the record's Activity feed. `@Dench` in a body summons the agent.
+  op({
+    id: "crm.comments.list",
+    group: "crm",
+    summary:
+      "List comments on a CRM entry (roots newest first, with preview replies).",
+    cli: "dench crm comments list",
+    method: "GET",
+    path: "/crm/objects/{objectName}/entries/{entryId}/comments",
+    requestSchema: noBody,
+    responseSchema: anyResponse,
+    backend: {
+      ...convex("query", "functions/crm/comments:listForEntry"),
+      transformArgs: (input) => ({
+        objectName: input.objectName,
+        entryId: input.entryId,
+        previewReplies:
+          typeof input.replies === "number"
+            ? Math.min(Math.max(Math.floor(input.replies), 0), 50)
+            : undefined,
+        paginationOpts: paginationOptsFrom(input, 20),
+      }),
+    },
+  }),
+  op({
+    id: "crm.comments.replies",
+    group: "crm",
+    summary: "List every reply under a root comment, oldest first.",
+    cli: "dench crm comments replies",
+    method: "GET",
+    path: "/crm/comments/{commentId}/replies",
+    requestSchema: noBody,
+    responseSchema: anyResponse,
+    backend: {
+      ...convex("query", "functions/crm/comments:listReplies"),
+      transformArgs: (input) => ({
+        rootCommentId: input.commentId,
+        paginationOpts: paginationOptsFrom(input, 50),
+      }),
+    },
+  }),
+  op({
+    id: "crm.comments.get",
+    group: "crm",
+    summary: "Get one comment with its entry label.",
+    cli: "dench crm comments get",
+    method: "GET",
+    path: "/crm/comments/{commentId}",
+    requestSchema: noBody,
+    responseSchema: anyResponse,
+    backend: convex("query", "functions/crm/comments:get"),
+  }),
+  op({
+    id: "crm.comments.create",
+    group: "crm",
+    summary:
+      "Comment on a CRM entry (markdown). Mention members with [@Name](/?member=<userId>); mention Dench with [@Dench](/?member=dench) or mentionDench.",
+    cli: "dench crm comments create",
+    method: "POST",
+    path: "/crm/objects/{objectName}/entries/{entryId}/comments",
+    requestSchema: anyObject,
+    responseSchema: anyResponse,
+    backend: convex("mutation", "functions/crm/comments:create", "bearer", {
+      includeRunId: true,
+    }),
+  }),
+  op({
+    id: "crm.comments.update",
+    group: "crm",
+    summary: "Edit a comment you wrote.",
+    cli: "dench crm comments update",
+    method: "PATCH",
+    path: "/crm/comments/{commentId}",
+    requestSchema: anyObject,
+    responseSchema: anyResponse,
+    backend: convex("mutation", "functions/crm/comments:edit"),
+  }),
+  op({
+    id: "crm.comments.delete",
+    group: "crm",
+    summary: "Delete a comment (kept as a tombstone when it has replies).",
+    cli: "dench crm comments delete",
+    method: "DELETE",
+    path: "/crm/comments/{commentId}",
+    requestSchema: noBody,
+    responseSchema: anyResponse,
+    backend: convex("mutation", "functions/crm/comments:remove"),
+  }),
+  op({
+    id: "crm.comments.react",
+    group: "crm",
+    summary: "Toggle an emoji reaction on a comment.",
+    cli: "dench crm comments react",
+    method: "PUT",
+    path: "/crm/comments/{commentId}/reactions/{emoji}",
+    requestSchema: noBody,
+    responseSchema: anyResponse,
+    backend: convex("mutation", "functions/crm/comments:toggleReaction"),
+  }),
+  op({
+    id: "crm.watch.get",
+    group: "crm",
+    summary: "Whether you follow a CRM entry's activity.",
+    cli: "dench crm watch status",
+    method: "GET",
+    path: "/crm/objects/{objectName}/entries/{entryId}/watch",
+    requestSchema: noBody,
+    responseSchema: anyResponse,
+    backend: {
+      ...convex("query", "functions/crm/comments:getWatchState"),
+      transformArgs: (input) => ({ entryId: input.entryId }),
+    },
+  }),
+  op({
+    id: "crm.watch.set",
+    group: "crm",
+    summary: "Follow or unfollow a CRM entry's activity.",
+    cli: "dench crm watch",
+    method: "PUT",
+    path: "/crm/objects/{objectName}/entries/{entryId}/watch",
+    requestSchema: anyObject,
+    responseSchema: anyResponse,
+    backend: {
+      ...convex("mutation", "functions/crm/comments:setWatching"),
+      transformArgs: (input) => ({
+        entryId: input.entryId,
+        watching: input.watching !== false,
+      }),
+    },
+  }),
+
+  // CRM tasks — conveniences over the protected `task` object. Tasks are
+  // still ordinary entries (`crm.entries.*` works on them); these add the
+  // "mine", "for this record", complete/reopen shortcuts the app uses.
+  op({
+    id: "crm.tasks.mine",
+    group: "crm",
+    summary: "Your open tasks (plus ones completed today).",
+    cli: "dench crm tasks mine",
+    method: "GET",
+    path: "/crm/tasks/mine",
+    requestSchema: noBody,
+    responseSchema: anyResponse,
+    backend: convex("query", "functions/crm/tasks:listMyOpenTasks"),
+  }),
+  op({
+    id: "crm.tasks.forEntry",
+    group: "crm",
+    summary: "Tasks linked to a CRM entry.",
+    cli: "dench crm tasks list",
+    method: "GET",
+    path: "/crm/objects/{objectName}/entries/{entryId}/tasks",
+    requestSchema: noBody,
+    responseSchema: anyResponse,
+    backend: convex("query", "functions/crm/tasks:listEntryTasks"),
+  }),
+  op({
+    id: "crm.tasks.createForEntry",
+    group: "crm",
+    summary: "Create a task linked to a CRM entry.",
+    cli: "dench crm tasks create",
+    method: "POST",
+    path: "/crm/objects/{objectName}/entries/{entryId}/tasks",
+    requestSchema: anyObject,
+    responseSchema: anyResponse,
+    backend: convex("mutation", "functions/crm/tasks:createEntryTask"),
+  }),
+  op({
+    id: "crm.tasks.complete",
+    group: "crm",
+    summary: "Mark a task done.",
+    cli: "dench crm tasks complete",
+    method: "POST",
+    path: "/crm/tasks/{entryId}/complete",
+    requestSchema: noBody,
+    responseSchema: anyResponse,
+    backend: convex("mutation", "functions/crm/tasks:completeTask"),
+  }),
+  op({
+    id: "crm.tasks.reopen",
+    group: "crm",
+    summary: "Reopen a completed task.",
+    cli: "dench crm tasks reopen",
+    method: "POST",
+    path: "/crm/tasks/{entryId}/reopen",
+    requestSchema: noBody,
+    responseSchema: anyResponse,
+    backend: convex("mutation", "functions/crm/tasks:reopenTask"),
+  }),
+
   op({
     id: "crm.entries.create",
     group: "crm",
@@ -2981,6 +3191,99 @@ const rawApiOperations = [
     responseSchema: anyResponse,
     backend: convex("query", "functions/agentConfig:getAgentConfig"),
   }),
+
+  // Notifications — the signed-in member's inbox (the bell). Agent sessions
+  // read their owner's inbox; an org API key with no person behind it is
+  // refused by the backend.
+  op({
+    id: "notifications.list",
+    group: "notifications",
+    summary: "List your notifications (inbox, unread, archived, or all).",
+    cli: "dench notifications list",
+    method: "GET",
+    path: "/notifications",
+    requestSchema: noBody,
+    responseSchema: anyResponse,
+    backend: convex("query", "functions/notifications:listMyNotifications"),
+  }),
+  op({
+    id: "notifications.unreadCount",
+    group: "notifications",
+    summary: "How many unread notifications you have.",
+    cli: "dench notifications count",
+    method: "GET",
+    path: "/notifications/unread-count",
+    requestSchema: noBody,
+    responseSchema: anyResponse,
+    backend: convex("query", "functions/notifications:unreadCount"),
+  }),
+  op({
+    id: "notifications.read",
+    group: "notifications",
+    summary: "Mark a notification read (or unread).",
+    cli: "dench notifications read",
+    method: "PATCH",
+    path: "/notifications/{notificationId}",
+    requestSchema: anyObject,
+    responseSchema: anyResponse,
+    backend: {
+      ...convex("mutation", "functions/notifications:setNotificationRead"),
+      transformArgs: (input) => ({
+        notificationId: input.notificationId,
+        read: input.read !== false,
+      }),
+    },
+  }),
+  op({
+    id: "notifications.readAll",
+    group: "notifications",
+    summary: "Mark every inbox notification read.",
+    cli: "dench notifications read-all",
+    method: "POST",
+    path: "/notifications/read-all",
+    requestSchema: noBody,
+    responseSchema: anyResponse,
+    backend: convex("mutation", "functions/notifications:markAllRead"),
+  }),
+  op({
+    id: "notifications.archive",
+    group: "notifications",
+    summary: "Archive a notification.",
+    cli: "dench notifications archive",
+    method: "POST",
+    path: "/notifications/{notificationId}/archive",
+    requestSchema: noBody,
+    responseSchema: anyResponse,
+    backend: convex("mutation", "functions/notifications:archiveNotification"),
+  }),
+  op({
+    id: "notifications.preferences.get",
+    group: "notifications",
+    summary: "Read your notification preferences.",
+    cli: "dench notifications prefs",
+    method: "GET",
+    path: "/notifications/preferences",
+    requestSchema: noBody,
+    responseSchema: anyResponse,
+    backend: convex(
+      "query",
+      "functions/notifications:getMyNotificationPreferences",
+    ),
+  }),
+  op({
+    id: "notifications.preferences.update",
+    group: "notifications",
+    summary: "Update your notification preferences.",
+    cli: "dench notifications prefs --set",
+    method: "PATCH",
+    path: "/notifications/preferences",
+    requestSchema: anyObject,
+    responseSchema: anyResponse,
+    backend: convex(
+      "mutation",
+      "functions/notifications:updateMyNotificationPreferences",
+    ),
+  }),
 ] as const satisfies readonly ApiOperation[];
 
 /**