@dench.com/cli 2.7.5 → 2.7.6-staging.1

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

@@ -2785,7 +2785,8 @@ type CrmFieldForEnrichment = FieldCandidate & {
     category: EnrichmentCategory;
     key: string;
     apolloPath: string;
-    inputFieldName: string;
+    inputFieldName?: string;
+    strategy?: Record<string, unknown>;
   };
 };
 
@@ -2794,6 +2795,8 @@ type CrmEntryForEnrichment = {
   fields: Record<string, unknown>;
 };
 
+type CliEnrichmentProvider = "fullenrich" | "aviato";
+
 type EnrichmentTarget = {
   category: EnrichmentCategory;
   column: EnrichmentColumnDef;
@@ -2805,7 +2808,7 @@ type CellEnrichmentArgs = {
   objectName: string;
   entryId: string;
   fieldName: string;
-  provider?: string;
+  provider?: CliEnrichmentProvider;
   category?: EnrichmentCategory;
   inputFieldName?: string;
   apolloPath?: string;
@@ -2825,6 +2828,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 +2890,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 +3024,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 +3361,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 +3426,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 +3459,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 +3484,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");

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

package/lib/command-registry.ts

@@ -31,6 +31,7 @@ export type CustomOperation = {
     | "chatFollow"
     | "cronDelete"
     | "cronRunNow"
+    | "toolDisconnect"
     | "billingTopup"
     | "upgrade"
     | "filesMove"
@@ -583,6 +584,29 @@ const rawApiOperations = [
     responseSchema: anyResponse,
     backend: convex("mutation", "functions/crm/objects:remove"),
   }),
+  op({
+    id: "crm.objects.archive",
+    group: "crm",
+    summary:
+      "Hide a CRM object's workspace sidebar row. Not a delete — the table keeps working.",
+    cli: "dench crm objects archive",
+    method: "POST",
+    path: "/crm/objects/{name}/archive",
+    requestSchema: anyObject,
+    responseSchema: anyResponse,
+    backend: convex("mutation", "functions/crm/objects:setArchived"),
+  }),
+  op({
+    id: "crm.objects.unarchive",
+    group: "crm",
+    summary: "Restore a CRM object's workspace sidebar row.",
+    cli: "dench crm objects unarchive",
+    method: "POST",
+    path: "/crm/objects/{name}/unarchive",
+    requestSchema: anyObject,
+    responseSchema: anyResponse,
+    backend: convex("mutation", "functions/crm/objects:setArchived"),
+  }),
 
   op({
     id: "crm.views.list",
@@ -652,6 +676,56 @@ const rawApiOperations = [
     responseSchema: anyResponse,
     backend: convex("mutation", "functions/crm/objects:deleteView"),
   }),
+  op({
+    id: "crm.views.archive",
+    group: "crm",
+    summary: "Move a pinned view's sidebar row into the Archived flyout.",
+    cli: "dench crm views archive",
+    method: "POST",
+    path: "/crm/objects/{objectName}/views/{viewName}/archive",
+    requestSchema: anyObject,
+    responseSchema: anyResponse,
+    backend: convex("mutation", "functions/crm/objects:setArchived"),
+  }),
+  op({
+    id: "crm.views.unarchive",
+    group: "crm",
+    summary: "Restore a view's sidebar row (re-asserts its pin).",
+    cli: "dench crm views unarchive",
+    method: "POST",
+    path: "/crm/objects/{objectName}/views/{viewName}/unarchive",
+    requestSchema: anyObject,
+    responseSchema: anyResponse,
+    backend: convex("mutation", "functions/crm/objects:setArchived"),
+  }),
+
+  // The workspace app rail. Row VISIBILITY is team-shared and lives on the
+  // CRM records above (archive / view pins); row ORDER is a per-member
+  // preference, so `move` needs a caller that resolves to a user — an
+  // org-scoped API key cannot reorder somebody's sidebar.
+  op({
+    id: "crm.sidebar.list",
+    group: "crm",
+    summary:
+      "Describe the workspace sidebar: visible rows in order, plus what is hidden and why.",
+    cli: "dench crm sidebar list",
+    method: "GET",
+    path: "/crm/sidebar",
+    requestSchema: noBody,
+    responseSchema: anyResponse,
+    backend: convex("query", "functions/workspaceNav:describeMySidebar"),
+  }),
+  op({
+    id: "crm.sidebar.move",
+    group: "crm",
+    summary: "Reposition one sidebar row among the visible rows.",
+    cli: "dench crm sidebar move",
+    method: "POST",
+    path: "/crm/sidebar/move",
+    requestSchema: anyObject,
+    responseSchema: anyResponse,
+    backend: convex("mutation", "functions/workspaceNav:repositionMyNavItem"),
+  }),
 
   op({
     id: "crm.fields.list",
@@ -2256,7 +2330,35 @@ const rawApiOperations = [
     path: "/tools/connections/{connectionId}",
     requestSchema: anyObject,
     responseSchema: anyResponse,
-    backend: gateway("DELETE", "/composio/connections/{connectionId}"),
+    // Proxies the same gateway route, then drops the account's label; the
+    // name lives in Convex and would otherwise outlive the connection.
+    backend: custom("toolDisconnect", "bearer"),
+  }),
+  // Composio reports no account identity for most toolkits, so a workspace
+  // with three Gmail accounts sees three identical rows. These let a human
+  // name a connection once; the label is presentational and grants nothing.
+  op({
+    id: "tool.labels.list",
+    group: "gateway",
+    summary: "List human names given to connected accounts.",
+    cli: "dench tool labels",
+    method: "GET",
+    path: "/tools/labels",
+    requestSchema: noBody,
+    responseSchema: anyResponse,
+    backend: convex("query", "functions/composioConnectionLabels:list"),
+  }),
+  op({
+    id: "tool.label.set",
+    group: "gateway",
+    summary:
+      "Name a connected account, or clear its name with an empty string.",
+    cli: "dench tool label",
+    method: "PUT",
+    path: "/tools/connections/{connectionId}/label",
+    requestSchema: anyObject,
+    responseSchema: anyResponse,
+    backend: convex("mutation", "functions/composioConnectionLabels:set"),
   }),
 
   // Browser automation (Dench Browser). The provider stays server-side; the

package/lib/enrichment-gateway.ts

@@ -1215,6 +1215,67 @@ export async function searchPeople(
   });
 }
 
+/**
+ * Number of Exa candidates to pull when resolving ONE person for enrichment.
+ *
+ * Kept small on purpose. Exa's per-request price includes the first 10
+ * results and charges per result beyond that, and column enrichment issues
+ * one search PER ROW — so a bulk fill over 500 rows is 500 searches. Five is
+ * enough for the match gate to find the right person when they are in the
+ * index, and stays inside the included tier.
+ */
+export const EXA_ENRICHMENT_NUM_RESULTS = 5;
+
+/**
+ * Exa People Search through the gateway's `/v1/search` route.
+ *
+ * Unlike the other helpers in this file this is a SEARCH, not an identifier
+ * lookup — it returns relevance-ranked strangers, so callers must run the
+ * result through `matchExaPerson` before writing anything. See
+ * cli/lib/exa-people.ts.
+ *
+ * `type` is pinned to "auto": "deep"/"deep-reasoning" cost roughly 2x and buy
+ * nothing when we are resolving a person we can already name.
+ */
+export async function searchExaPeople(
+  body: { query: string; numResults?: number },
+  options: EnrichmentGatewayOptions = {},
+): Promise<Record<string, unknown>> {
+  return callGatewayJson("/v1/search", {
+    method: "POST",
+    body: {
+      query: body.query,
+      category: "people",
+      type: "auto",
+      numResults: body.numResults ?? EXA_ENRICHMENT_NUM_RESULTS,
+      contents: { highlights: { maxCharacters: 200 } },
+    },
+    options,
+  });
+}
+
+/**
+ * Exa Company Search through the gateway's `/v1/search` route. Same
+ * search-not-lookup caveat as `searchExaPeople`: run the result through
+ * `matchExaCompany` before writing anything. See cli/lib/exa-companies.ts.
+ */
+export async function searchExaCompanies(
+  body: { query: string; numResults?: number },
+  options: EnrichmentGatewayOptions = {},
+): Promise<Record<string, unknown>> {
+  return callGatewayJson("/v1/search", {
+    method: "POST",
+    body: {
+      query: body.query,
+      category: "company",
+      type: "auto",
+      numResults: body.numResults ?? EXA_ENRICHMENT_NUM_RESULTS,
+      contents: { highlights: { maxCharacters: 200 } },
+    },
+    options,
+  });
+}
+
 // ---------------------------------------------------------------------------
 // Shared HTTP helpers
 // ---------------------------------------------------------------------------