@dench.com/cli 2.7.5 → 2.7.7-staging.21

package/README.md

@@ -198,7 +198,7 @@ For staging:
 
 ```bash
 dench signin --staging
-dench signin --host https://workspace-staging.dench.com
+dench signin --host https://staging.dench.com
 ```
 
 ## Sandbox / API key auth (no `dench signin` required)

package/crm.ts

@@ -687,6 +687,21 @@ const api = {
     reposition: makeFunctionReference<"mutation">(
       "functions/workspaceNav:repositionMyNavItem",
     ),
+    createGroup: makeFunctionReference<"mutation">(
+      "functions/workspaceNav:createNavGroup",
+    ),
+    renameGroup: makeFunctionReference<"mutation">(
+      "functions/workspaceNav:renameNavGroup",
+    ),
+    deleteGroup: makeFunctionReference<"mutation">(
+      "functions/workspaceNav:deleteNavGroup",
+    ),
+    moveItemToGroup: makeFunctionReference<"mutation">(
+      "functions/workspaceNav:moveNavItemToGroup",
+    ),
+    setRootPin: makeFunctionReference<"mutation">(
+      "functions/workspaceNav:setNavRootPin",
+    ),
   },
   fields: {
     list: makeFunctionReference<"query">("functions/crm/fields:list"),
@@ -959,13 +974,15 @@ async function runCrmMembersCommand(ctx: CrmCliContext): Promise<void> {
 }
 
 /**
- * `dench crm sidebar …` — the workspace app rail.
+ * `dench crm sidebar …` — the workspace app rail's Library.
  *
- * Row VISIBILITY is team-shared and lives on the CRM records themselves
- * (`crm objects archive`, `crm views pin/archive`). Row ORDER is a
- * per-member preference, which is what `move` writes. `list` shows both
- * halves: the visible rows with their 1-based positions, plus what's
- * hidden and why.
+ * The whole layout is WORKSPACE-SHARED: one tree of rows and named
+ * groups for every member. Permissions split by operation — `move` (and
+ * `crm objects archive` / `crm views archive`) are ADMIN-ONLY because
+ * they change what everyone sees; `group …` operations and view pinning
+ * are open to any member. `list` shows the visible rows in tree order
+ * (rows inside a group carry `groupId`/`groupName`), the groups, what's
+ * hidden and why, and whether YOU are an admin (`viewerIsAdmin`).
  */
 async function runSidebarCommand(ctx: CrmCliContext): Promise<void> {
   const verb = ctx.args.shift() ?? "list";
@@ -997,6 +1014,85 @@ async function runSidebarCommand(ctx: CrmCliContext): Promise<void> {
       );
       return;
     }
+    // Pin/unpin a Library row (or a whole group) on the Sidebar's home
+    // level shortcut strip. Member-level, workspace-shared — like view
+    // pinning.
+    case "pin":
+    case "unpin": {
+      const navId = shift(ctx.args, "nav id");
+      assertNoUnknownFlags(ctx.args, `crm sidebar ${verb}`);
+      out(
+        ctx,
+        await callMutation(ctx, api.sidebar.setRootPin, {
+          navId,
+          pinned: verb === "pin",
+        }),
+      );
+      return;
+    }
+    case "group": {
+      const groupVerb = ctx.args.shift();
+      switch (groupVerb) {
+        case "create": {
+          const name = shift(ctx.args, "group name");
+          assertNoUnknownFlags(ctx.args, "crm sidebar group create");
+          out(ctx, await callMutation(ctx, api.sidebar.createGroup, { name }));
+          return;
+        }
+        case "rename": {
+          const groupId = shift(ctx.args, "group id");
+          const name = shift(ctx.args, "new name");
+          assertNoUnknownFlags(ctx.args, "crm sidebar group rename");
+          out(
+            ctx,
+            await callMutation(ctx, api.sidebar.renameGroup, {
+              groupId,
+              name,
+            }),
+          );
+          return;
+        }
+        case "delete": {
+          const groupId = shift(ctx.args, "group id");
+          assertNoUnknownFlags(ctx.args, "crm sidebar group delete");
+          out(
+            ctx,
+            await callMutation(ctx, api.sidebar.deleteGroup, { groupId }),
+          );
+          return;
+        }
+        case "add": {
+          const navId = shift(ctx.args, "nav id");
+          const groupId = shift(ctx.args, "group id");
+          assertNoUnknownFlags(ctx.args, "crm sidebar group add");
+          out(
+            ctx,
+            await callMutation(ctx, api.sidebar.moveItemToGroup, {
+              navId,
+              groupId,
+            }),
+          );
+          return;
+        }
+        case "remove": {
+          const navId = shift(ctx.args, "nav id");
+          assertNoUnknownFlags(ctx.args, "crm sidebar group remove");
+          out(
+            ctx,
+            await callMutation(ctx, api.sidebar.moveItemToGroup, {
+              navId,
+              groupId: null,
+            }),
+          );
+          return;
+        }
+        default:
+          throw new CrmCliError(
+            `Unknown crm sidebar group verb: ${groupVerb ?? "(none)"}. ` +
+              "Use create|rename|delete|add|remove.",
+          );
+      }
+    }
     default:
       throw new CrmCliError(`Unknown crm sidebar verb: ${verb}`);
   }
@@ -1071,9 +1167,10 @@ async function runObjectsCommand(ctx: CrmCliContext): Promise<void> {
       out(ctx, await callMutation(ctx, api.objects.remove, { name }));
       return;
     }
-    // Archive is the sidebar's "remove from my rail", NOT a delete: the
+    // Archive is the sidebar's "remove from the rail", NOT a delete: the
     // table, its rows and every link to it keep working, the row just
-    // moves into the rail's Archived flyout. Team-shared.
+    // moves into the rail's Archived flyout. Team-shared, and ADMIN-ONLY
+    // (the server rejects non-admin members).
     case "archive":
     case "unarchive": {
       const name = shift(ctx.args, "object name");
@@ -2785,7 +2882,8 @@ type CrmFieldForEnrichment = FieldCandidate & {
     category: EnrichmentCategory;
     key: string;
     apolloPath: string;
-    inputFieldName: string;
+    inputFieldName?: string;
+    strategy?: Record<string, unknown>;
   };
 };
 
@@ -2794,6 +2892,8 @@ type CrmEntryForEnrichment = {
   fields: Record<string, unknown>;
 };
 
+type CliEnrichmentProvider = "fullenrich" | "aviato";
+
 type EnrichmentTarget = {
   category: EnrichmentCategory;
   column: EnrichmentColumnDef;
@@ -2805,7 +2905,7 @@ type CellEnrichmentArgs = {
   objectName: string;
   entryId: string;
   fieldName: string;
-  provider?: string;
+  provider?: CliEnrichmentProvider;
   category?: EnrichmentCategory;
   inputFieldName?: string;
   apolloPath?: string;
@@ -2825,6 +2925,16 @@ function parseCategoryFlag(
   throw new CrmCliError("--category must be people or company");
 }
 
+function parseProviderFlag(
+  value: string | undefined,
+): CliEnrichmentProvider | undefined {
+  if (value === undefined) return undefined;
+  if (value === "fullenrich" || value === "aviato") return value;
+  throw new CrmCliError(
+    `--provider must be fullenrich or aviato; received "${value}"`,
+  );
+}
+
 function parsePositiveInt(
   flag: string,
   value: string | undefined,
@@ -2877,8 +2987,16 @@ function readFieldEnrichment(
     typeof candidate.inputFieldName === "string"
       ? candidate.inputFieldName
       : undefined;
-  if (!category || !key || !apolloPath || !inputFieldName) return undefined;
-  return { category, key, apolloPath, inputFieldName };
+  const strategy =
+    candidate.strategy &&
+    typeof candidate.strategy === "object" &&
+    !Array.isArray(candidate.strategy)
+      ? (candidate.strategy as Record<string, unknown>)
+      : undefined;
+  if (!category || !key || !apolloPath || (!inputFieldName && !strategy)) {
+    return undefined;
+  }
+  return { category, key, apolloPath, inputFieldName, strategy };
 }
 
 function asEntry(value: unknown): CrmEntryForEnrichment | null {
@@ -3003,7 +3121,7 @@ async function callEnrichmentGatewayForEntry(args: {
   target: EnrichmentTarget;
   entry: CrmEntryForEnrichment;
   /** Explicit provider override. Defaults: people=fullenrich, company=aviato. */
-  provider?: string;
+  provider?: CliEnrichmentProvider;
   gateway?: Pick<EnrichmentGatewayOptions, "apiKey" | "baseUrl">;
 }): Promise<Record<string, unknown>> {
   const { entry, target } = args;
@@ -3340,7 +3458,7 @@ async function runPeopleCommand(ctx: CrmCliContext): Promise<void> {
     }
     case "enrich": {
       const entryId = shift(ctx.args, "person entry id");
-      const provider = getFlag(ctx.args, "--provider");
+      const provider = parseProviderFlag(getFlag(ctx.args, "--provider"));
       const fieldName = getFlag(ctx.args, "--field") ?? "LinkedIn URL";
       const inputFieldName = getFlag(ctx.args, "--input-field");
       const overwrite = hasFlag(ctx.args, "--overwrite");
@@ -3405,7 +3523,7 @@ async function runCompaniesCommand(ctx: CrmCliContext): Promise<void> {
     }
     case "enrich": {
       const entryId = shift(ctx.args, "company entry id");
-      const provider = getFlag(ctx.args, "--provider");
+      const provider = parseProviderFlag(getFlag(ctx.args, "--provider"));
       const fieldName = getFlag(ctx.args, "--field") ?? "Company Name";
       const inputFieldName = getFlag(ctx.args, "--input-field") ?? "Domain";
       const overwrite = hasFlag(ctx.args, "--overwrite");
@@ -3438,7 +3556,7 @@ async function runEnrichCommand(ctx: CrmCliContext): Promise<void> {
       const objectName = shift(ctx.args, "object name");
       const entryId = shift(ctx.args, "entry id");
       const fieldName = shift(ctx.args, "field name");
-      const provider = getFlag(ctx.args, "--provider");
+      const provider = parseProviderFlag(getFlag(ctx.args, "--provider"));
       const inputFieldName = getFlag(ctx.args, "--input-field");
       const category = parseCategoryFlag(getFlag(ctx.args, "--category"));
       const apolloPath = getFlag(ctx.args, "--apollo-path");
@@ -3463,7 +3581,7 @@ async function runEnrichCommand(ctx: CrmCliContext): Promise<void> {
       const objectName = shift(ctx.args, "object name");
       const fieldName = getFlag(ctx.args, "--field");
       const missingOnly = !hasFlag(ctx.args, "--all");
-      const provider = getFlag(ctx.args, "--provider");
+      const provider = parseProviderFlag(getFlag(ctx.args, "--provider"));
       const inputFieldName = getFlag(ctx.args, "--input-field");
       const category = parseCategoryFlag(getFlag(ctx.args, "--category"));
       const apolloPath = getFlag(ctx.args, "--apollo-path");
@@ -3550,7 +3668,7 @@ Objects (CRM tables):
   dench crm objects archive <name> | unarchive <name>
       Hides/restores the object's workspace SIDEBAR row. Not a delete —
       the table, its rows and every link keep working; the row just moves
-      into the rail's Archived flyout. Team-shared.
+      into the rail's Archived flyout. Team-shared and ADMIN-ONLY.
 
 Views (saved CRM subsets):
   dench crm views list <object> [--json]
@@ -3575,17 +3693,37 @@ Views (saved CRM subsets):
       clears any archive stamp.
   dench crm views archive <object> <view-name> | unarchive <object> <view-name>
       Moves the view's sidebar row into the Archived flyout. Unarchiving
-      re-asserts the pin so the row comes back.
+      re-asserts the pin so the row comes back. ADMIN-ONLY: archiving
+      hides the row for the whole workspace.
 
-Sidebar (the workspace app rail):
+Sidebar (the workspace app rail's Library — layout is WORKSPACE-SHARED):
   dench crm sidebar list [--json]
-      Visible rows in order with 1-based positions, plus what's hidden
-      from the rail and why (archived vs. an unpinned view).
+      Visible rows in tree order (rows inside a group carry groupId/
+      groupName), the groups, what's hidden and why (archived vs. an
+      unpinned view), and whether you are an admin (viewerIsAdmin).
   dench crm sidebar move <nav-id> <top|bottom|N>
-      Reposition one row. Nav ids come from 'sidebar list' — e.g.
-      'crm-object:task', 'crm-view:task:Due%20today', 'crm-people',
-      'automation'. Row ORDER is per-member; row visibility (above) is
-      team-shared.
+      Reposition one row (or a whole group by its group id) among the
+      TOP-LEVEL slots — a group counts as one slot, and a row inside a
+      group is pulled out to the top level. Nav ids come from 'sidebar
+      list' — e.g. 'crm-object:task', 'crm-view:task:Due%20today',
+      'crm-people', 'group:abc123'. Automations and Outreach are fixed
+      home-level tabs, not Library rows. ADMIN-ONLY: the order is
+      shared by every member.
+  dench crm sidebar group create <name>
+      New named group (e.g. "Hiring") at the bottom of the Library.
+      Open to any member; prints the group id.
+  dench crm sidebar group rename <group-id> <new-name>
+  dench crm sidebar group delete <group-id>
+      Dissolves the group; its rows return to the top level in its slot.
+  dench crm sidebar group add <nav-id> <group-id>
+      File a row into a group (appended at its end).
+  dench crm sidebar group remove <nav-id>
+      Move a row out of its group, back to the top level.
+  dench crm sidebar pin <nav-id> | unpin <nav-id>
+      Pin/unpin a Library row — or a whole group (group id) — on the
+      Sidebar's home level, under Chats/Inbox/Meetings/Automations/
+      Outreach/Library.
+      A pin is a shared shortcut, not a move; open to any member.
 
 Fields (columns):
   dench crm fields list <object> [--json]

package/dench.ts

@@ -538,9 +538,8 @@ Monetize the AI "thinking…" line (supported hooks only — no file patching):
   dench ads uninstall [--target claude|shell|agentmd|all]
   Aliases: dench ad, dench adline.  Help: dench ads help
 
-Managed email campaigns (Dench Emailing Service):
-  dench email identity verify --from founder@example.com [--json]
-  dench email template create --name "Intro" --subject "Hi {{firstName}}" --html-file body.html [--json]
+Managed email campaigns:
+  dench email campaign create --name "Q2 outreach" --mailbox you@gmail.com --template <id> [--json]
   dench email campaign create --name "Q2 outreach" --identity <id> --template <id> [--json]
   dench email campaign recipients add --campaign <id> --file recipients.jsonl [--json]
   dench email campaign submit --campaign <id> [--json]

package/email.ts

@@ -118,6 +118,48 @@ function requiredFlag(args: string[], name: string): string {
   return value;
 }
 
+async function resolveMailboxAccountIds(
+  ctx: EmailCliContext,
+  mailbox: string,
+): Promise<string[]> {
+  const payload = await callQuery(
+    ctx,
+    "functions/emailMailboxAccounts:listAccounts",
+    {},
+  );
+  const accounts = Array.isArray(payload) ? (payload as JsonRecord[]) : [];
+  const needle = mailbox.trim().toLowerCase();
+  const match = accounts.find((row) => {
+    const id = typeof row._id === "string" ? row._id : "";
+    const email = typeof row.email === "string" ? row.email.toLowerCase() : "";
+    return id === mailbox.trim() || email === needle;
+  });
+  if (!match || typeof match._id !== "string") {
+    throw new EmailCliError(
+      `Connected inbox not found: ${mailbox}. Connect Gmail or Outlook in Outreach → Accounts.`,
+    );
+  }
+  return [match._id];
+}
+
+async function campaignSenderArgs(ctx: EmailCliContext): Promise<{
+  identityId?: string;
+  mailboxAccountIds?: string[];
+}> {
+  const identity = getFlag(ctx.args, "--identity")?.trim();
+  const mailbox = getFlag(ctx.args, "--mailbox")?.trim();
+  if (identity && mailbox) {
+    throw new EmailCliError("Pass --mailbox or --identity, not both.");
+  }
+  if (mailbox) {
+    return { mailboxAccountIds: await resolveMailboxAccountIds(ctx, mailbox) };
+  }
+  if (identity) return { identityId: identity };
+  throw new EmailCliError(
+    "Pass --mailbox <email> (connected inbox) or --identity <sender>.",
+  );
+}
+
 function optionalJsonFlag(args: string[], name: string): unknown | undefined {
   const raw = getFlag(args, name);
   return raw === undefined ? undefined : parseJson(raw);
@@ -185,7 +227,7 @@ function toRecipients(rows: JsonRecord[]) {
 }
 
 export function emailHelp() {
-  console.log(`dench email — Dench Emailing Service campaign commands
+  console.log(`dench email — outbound email from a connected inbox (or Dench Emailing Service)
 
 Usage:
   dench email identity verify --from founder@example.com [--json]
@@ -204,7 +246,7 @@ Usage:
   dench email message list [--limit 25] [--json]
   dench email template create --name "Intro" --subject "Hi {{firstName}}" --html-file body.html [--text-file body.txt] [--json]
   dench email template preview --template <id> --data '{"firstName":"Ada"}' [--json]
-  dench email campaign create --name "Q2 outreach" --identity <identityId|fromEmail> --template <id> [--json]
+  dench email campaign create --name "Q2 outreach" (--mailbox you@gmail.com | --identity <identityId|fromEmail>) --template <id> [--json]
   dench email campaign list [--status sending] [--limit 25] [--json]
   dench email campaign recipients add --campaign <id> --file recipients.jsonl [--json]
   dench email campaign recipients list --campaign <id> [--status queued] [--limit 50] [--json]
@@ -215,7 +257,7 @@ Usage:
   dench email campaign pause|resume|cancel --campaign <id> [--json]
 
 Sequences (automatic multi-step follow-ups):
-  dench email sequence create --name "New-customer follow-up" --identity <identityId|fromEmail> [--stop-on-click] [--no-stop-on-reply] [--json]
+  dench email sequence create --name "New-customer follow-up" (--mailbox you@gmail.com | --identity <identityId|fromEmail>) [--stop-on-click] [--no-stop-on-reply] [--json]
   dench email sequence list [--all] [--json]
   dench email sequence status --sequence <id> [--json]
   dench email sequence steps add --sequence <id> --subject "Hi {{firstName}}" --html-file step1.html [--delay-days 0] [--delay-hours 0] [--json]
@@ -495,7 +537,7 @@ async function runIdentity(ctx: EmailCliContext) {
     const identities = await listIdentitiesQuery(ctx, domain);
     const text =
       identities.length === 0
-        ? "No sending identities yet. Run `dench email identity verify --from you@example.com`."
+        ? "No sending identities. Connect Gmail or Outlook in Outreach → Accounts."
         : identities
             .map(
               (identity) =>
@@ -716,12 +758,13 @@ async function runTemplate(ctx: EmailCliContext) {
 async function runCampaign(ctx: EmailCliContext) {
   const sub = ctx.args.shift();
   if (sub === "create") {
+    const sender = await campaignSenderArgs(ctx);
     const payload = await callMutation(
       ctx,
       "functions/emailCampaigns:createCampaign",
       {
         name: requiredFlag(ctx.args, "--name"),
-        identityId: requiredFlag(ctx.args, "--identity"),
+        ...sender,
         templateId: requiredFlag(ctx.args, "--template"),
         scheduledAt: getFlag(ctx.args, "--scheduled-at")
           ? Date.parse(requiredFlag(ctx.args, "--scheduled-at"))
@@ -867,12 +910,13 @@ async function runSequence(ctx: EmailCliContext) {
   const sub = ctx.args.shift();
   if (sub === "create") {
     const stopOnReply = !hasFlag(ctx.args, "--no-stop-on-reply");
+    const sender = await campaignSenderArgs(ctx);
     const payload = await callMutation(
       ctx,
       "functions/emailSequences:createSequence",
       {
         name: requiredFlag(ctx.args, "--name"),
-        identityId: requiredFlag(ctx.args, "--identity"),
+        ...sender,
         replyToMode: getFlag(ctx.args, "--reply-to-mode"),
         stopOnReply,
         stopOnClick: getFlag(ctx.args, "--stop-on-click") !== undefined,

package/host.ts

@@ -1,5 +1,5 @@
 export const PRODUCTION_HOST = "https://dench.com";
-export const STAGING_HOST = "https://workspace-staging.dench.com";
+export const STAGING_HOST = "https://staging.dench.com";
 export const LOCAL_HOST = "http://localhost:3000";
 export const DEFAULT_HOST = PRODUCTION_HOST;
 

package/lib/api-schemas.ts

@@ -791,6 +791,12 @@ const exaResultItem = z
     image: z.string().optional(),
     favicon: z.string().optional(),
     id: z.string().optional(),
+    entities: z
+      .array(z.record(z.string(), z.unknown()))
+      .optional()
+      .describe(
+        "Structured entity metadata returned by category=people or category=company.",
+      ),
   })
   .passthrough()
   .describe("An Exa search/contents result (provider passthrough).");
@@ -1058,11 +1064,26 @@ const exaSearch = z.object({
       "financial report",
       "people",
     ])
-    .optional(),
-  includeDomains: z.array(z.string()).optional(),
-  excludeDomains: z.array(z.string()).optional(),
-  startPublishedDate: z.string().optional(),
-  endPublishedDate: z.string().optional(),
+    .optional()
+    .describe(
+      "Entity categories return structured entities. Domain filters are unsupported for people; published-date filters are unsupported for people and company.",
+    ),
+  includeDomains: z
+    .array(z.string())
+    .optional()
+    .describe("Unsupported for category=people."),
+  excludeDomains: z
+    .array(z.string())
+    .optional()
+    .describe("Unsupported for category=people."),
+  startPublishedDate: z
+    .string()
+    .optional()
+    .describe("Unsupported for category=people and category=company."),
+  endPublishedDate: z
+    .string()
+    .optional()
+    .describe("Unsupported for category=people and category=company."),
   includeText: z.array(z.string()).optional(),
   excludeText: z.array(z.string()).optional(),
   userLocation: z.string().optional(),
@@ -1384,6 +1405,19 @@ export const requestSchemas: Record<string, ZodTypeAny> = {
     to: z.string().describe("New object name."),
   }),
   "crm.objects.delete": z.object({ name: z.string() }),
+  "crm.objects.archive": z.object({ name: z.string() }),
+  "crm.objects.unarchive": z.object({ name: z.string() }),
+
+  // The workspace app rail
+  "crm.sidebar.list": z.object({}),
+  "crm.sidebar.move": z.object({
+    navId: z
+      .string()
+      .describe("Nav id from `sidebar list`, e.g. crm-object:task."),
+    position: z
+      .union([z.literal("top"), z.literal("bottom"), z.number().int().min(1)])
+      .describe("Where to land among the visible rows; N is 1-based."),
+  }),
 
   // CRM saved views
   "crm.views.list": z.object({ objectName: z.string() }),
@@ -1424,6 +1458,14 @@ export const requestSchemas: Record<string, ZodTypeAny> = {
     objectName: z.string(),
     viewName: z.string(),
   }),
+  "crm.views.archive": z.object({
+    objectName: z.string(),
+    viewName: z.string(),
+  }),
+  "crm.views.unarchive": z.object({
+    objectName: z.string(),
+    viewName: z.string(),
+  }),
 
   // CRM fields
   "crm.fields.list": z.object({ objectName: z.string() }),
@@ -1991,6 +2033,12 @@ export const requestSchemas: Record<string, ZodTypeAny> = {
   "tool.search": composioToolSearch,
   "tool.run": composioToolRun,
   "tool.disconnect": z.object({ connectionId: z.string() }),
+  "tool.label.set": z.object({
+    connectionId: z.string(),
+    displayName: z
+      .string()
+      .describe("Human name for the account. Empty clears it."),
+  }),
 };
 
 // ---------------------------------------------------------------------------
@@ -2177,6 +2225,22 @@ export const responseSchemas: Record<string, ZodTypeAny> = {
   "crm.objects.update": okResponse,
   "crm.objects.rename": okResponse,
   "crm.objects.delete": okResponse,
+  "crm.objects.archive": okResponse,
+  "crm.objects.unarchive": okResponse,
+
+  // The workspace app rail
+  "crm.sidebar.list": z.object({
+    visible: z.array(z.record(z.string(), z.unknown())),
+    hidden: z.array(z.record(z.string(), z.unknown())),
+  }),
+  "crm.sidebar.move": z.object({
+    ok: z.boolean(),
+    navId: z.string(),
+    /** 1-based slot the row landed in, or null when the move was refused. */
+    position: z.number().nullable(),
+    visibleOrder: z.array(z.string()).optional(),
+    error: z.string().optional(),
+  }),
 
   // CRM saved views
   "crm.views.list": z.object({
@@ -2205,6 +2269,8 @@ export const responseSchemas: Record<string, ZodTypeAny> = {
     viewName: z.string(),
     removed: z.boolean(),
   }),
+  "crm.views.archive": okResponse,
+  "crm.views.unarchive": okResponse,
 
   // CRM fields
   "crm.fields.list": z.array(crmFieldDoc),
@@ -2676,6 +2742,15 @@ export const responseSchemas: Record<string, ZodTypeAny> = {
     })
     .passthrough()
     .describe("Composio delete response (provider passthrough)."),
+  "tool.labels.list": z.object({
+    labels: z.array(
+      z.object({ composioConnectionId: z.string(), displayName: z.string() }),
+    ),
+  }),
+  "tool.label.set": z.object({
+    ok: z.boolean(),
+    displayName: z.string().nullable(),
+  }),
 
   // Agent config
   "agentConfig.identity.show": agentConfigPayload,
@@ -2714,6 +2789,27 @@ export type ConvexExtras = {
 export const convexExtras: Record<string, ConvexExtras> = {
   "cron.enable": { fixedArgs: { enabled: true } },
   "cron.disable": { fixedArgs: { enabled: false } },
+  // Archive/unarchive are one mutation behind two paths, so the flag comes
+  // from the route rather than the body — a caller cannot un-archive by
+  // POSTing `{ archived: false }` to `/archive`.
+  "crm.objects.archive": { fixedArgs: { archived: true } },
+  "crm.objects.unarchive": { fixedArgs: { archived: false } },
+  // Same mutation for a saved view, but the path calls the object
+  // `objectName` while `setArchived` calls it `name`.
+  "crm.views.archive": {
+    transformArgs: (input) => ({
+      name: input.objectName,
+      viewName: input.viewName,
+    }),
+    fixedArgs: { archived: true },
+  },
+  "crm.views.unarchive": {
+    transformArgs: (input) => ({
+      name: input.objectName,
+      viewName: input.viewName,
+    }),
+    fixedArgs: { archived: false },
+  },
   // PATCH /crm/objects/{objectName}/views/{viewName} — the path's
   // viewName is the upsert key: fold it into `view.name` and force
   // replaceExisting so the mutation overwrites instead of erroring on