@dench.com/cli 2.1.1 → 2.1.3

package/lib/command-registry.ts

@@ -0,0 +1,1816 @@
+import { type ZodTypeAny, z } from "zod";
+import { convexExtras, requestSchemas, responseSchemas } from "./api-schemas";
+
+export type ApiAuthMode = "none" | "bearer" | "optional";
+
+export type ConvexOperation = {
+  kind: "convex";
+  functionType: "query" | "mutation" | "action";
+  functionName: string;
+  auth: ApiAuthMode;
+  tokenArg?: "sessionToken" | "apiKey";
+  includeRunId?: boolean;
+  /** Constant args merged into every call (e.g. enable/disable toggles). */
+  fixedArgs?: Record<string, unknown>;
+  /** Reshape validated input into backend args (e.g. update-many -> batch ops). */
+  transformArgs?: (input: Record<string, unknown>) => Record<string, unknown>;
+};
+
+export type GatewayOperation = {
+  kind: "gateway";
+  method: "GET" | "POST" | "DELETE";
+  path: string;
+  auth: "bearer";
+};
+
+export type CustomOperation = {
+  kind: "custom";
+  handler:
+    | "commandsList"
+    | "chatSpawn"
+    | "chatFollow"
+    | "cronRunNow"
+    | "billingTopup"
+    | "upgrade"
+    | "filesMove"
+    | "filesStage"
+    | "signinOtpStart"
+    | "signinOtpVerify"
+    | "signinOtpFinalize";
+  auth: ApiAuthMode;
+};
+
+export type LocalOnlyOperation = {
+  kind: "local";
+  reason: string;
+};
+
+export type ApiOperationBackend =
+  | ConvexOperation
+  | GatewayOperation
+  | CustomOperation
+  | LocalOnlyOperation;
+
+export type ApiOperation = {
+  id: string;
+  group: string;
+  summary: string;
+  cli: string;
+  aliases?: string[];
+  method: "GET" | "POST" | "PATCH" | "PUT" | "DELETE";
+  path: string;
+  requestSchema: ZodTypeAny;
+  responseSchema: ZodTypeAny;
+  backend: ApiOperationBackend;
+  deprecated?: boolean;
+};
+
+/** Accepts any JSON body (for POST/PATCH endpoints not yet strictly typed). */
+const anyObject = z.object({}).passthrough();
+const anyResponse = z.unknown();
+/** Placeholder for GET/DELETE endpoints that expect no request body. */
+const noBody = z.object({}).passthrough();
+
+function op(operation: ApiOperation): ApiOperation {
+  return operation;
+}
+
+function convex(
+  functionType: ConvexOperation["functionType"],
+  functionName: string,
+  auth: ApiAuthMode = "bearer",
+  options: Pick<ConvexOperation, "tokenArg" | "includeRunId"> = {},
+): ConvexOperation {
+  return {
+    kind: "convex",
+    functionType,
+    functionName,
+    auth,
+    tokenArg:
+      options.tokenArg ?? (auth === "bearer" ? "sessionToken" : undefined),
+    includeRunId: options.includeRunId,
+  };
+}
+
+function gateway(
+  method: GatewayOperation["method"],
+  path: string,
+): GatewayOperation {
+  return { kind: "gateway", method, path, auth: "bearer" };
+}
+
+function custom(
+  handler: CustomOperation["handler"],
+  auth: ApiAuthMode,
+): CustomOperation {
+  return { kind: "custom", handler, auth };
+}
+
+function local(reason: string): LocalOnlyOperation {
+  return { kind: "local", reason };
+}
+
+const rawApiOperations = [
+  op({
+    id: "commands.list",
+    group: "meta",
+    summary: "List all CLI/API operations and parity classifications.",
+    cli: "dench help",
+    method: "GET",
+    path: "/commands",
+    requestSchema: noBody,
+    responseSchema: anyResponse,
+    backend: { kind: "custom", handler: "commandsList", auth: "none" },
+  }),
+
+  // Auth and local session management.
+  op({
+    id: "auth.signin.create",
+    group: "auth",
+    summary: "Create an agent sign-in request.",
+    cli: "dench signin",
+    method: "POST",
+    path: "/auth/signin-requests",
+    requestSchema: anyObject,
+    responseSchema: anyResponse,
+    backend: convex(
+      "mutation",
+      "functions/agentWorkspace:createSignInRequest",
+      "none",
+    ),
+  }),
+  op({
+    id: "auth.signin.poll",
+    group: "auth",
+    summary: "Poll an agent sign-in request until approval.",
+    cli: "dench signin",
+    method: "POST",
+    path: "/auth/signin-requests/{requestId}/poll",
+    requestSchema: anyObject,
+    responseSchema: anyResponse,
+    backend: convex(
+      "mutation",
+      "functions/agentWorkspace:pollSignInRequest",
+      "none",
+    ),
+  }),
+  op({
+    id: "auth.otp.start",
+    group: "auth",
+    summary: "Start the email OTP sign-in flow.",
+    cli: "dench signin --email",
+    method: "POST",
+    path: "/auth/otp/start",
+    requestSchema: anyObject,
+    responseSchema: anyResponse,
+    backend: custom("signinOtpStart", "none"),
+  }),
+  op({
+    id: "auth.otp.verify",
+    group: "auth",
+    summary: "Verify an email OTP sign-in code.",
+    cli: "dench signin --email",
+    method: "POST",
+    path: "/auth/otp/verify",
+    requestSchema: anyObject,
+    responseSchema: anyResponse,
+    backend: custom("signinOtpVerify", "none"),
+  }),
+  op({
+    id: "auth.otp.finalize",
+    group: "auth",
+    summary: "Finalize an email OTP sign-in session.",
+    cli: "dench signin --email",
+    method: "POST",
+    path: "/auth/otp/finalize",
+    requestSchema: anyObject,
+    responseSchema: anyResponse,
+    backend: custom("signinOtpFinalize", "none"),
+  }),
+  op({
+    id: "sessions.local.list",
+    group: "local",
+    summary: "List local CLI sessions.",
+    cli: "dench sessions",
+    method: "GET",
+    path: "/local/sessions",
+    requestSchema: noBody,
+    responseSchema: anyResponse,
+    backend: local("CLI sessions live in the caller's ~/.dench/config.json."),
+  }),
+  op({
+    id: "sessions.local.use",
+    group: "local",
+    summary: "Select a local CLI session.",
+    cli: "dench use <session-key-or-workspace-slug>",
+    method: "POST",
+    path: "/local/sessions/use",
+    requestSchema: anyObject,
+    responseSchema: anyResponse,
+    backend: local("The server cannot mutate the caller's local CLI config."),
+  }),
+  op({
+    id: "sessions.local.logout",
+    group: "local",
+    summary: "Remove local CLI sessions.",
+    cli: "dench logout",
+    method: "POST",
+    path: "/local/logout",
+    requestSchema: anyObject,
+    responseSchema: anyResponse,
+    backend: local("The server cannot mutate the caller's local CLI config."),
+  }),
+  op({
+    id: "backend.local.configure",
+    group: "local",
+    summary: "Configure the CLI backend target.",
+    cli: "dench backend show|set|clear",
+    method: "POST",
+    path: "/local/backend",
+    requestSchema: anyObject,
+    responseSchema: anyResponse,
+    backend: local("Backend selection is local CLI state."),
+  }),
+
+  // Workspace orientation.
+  op({
+    id: "workspace.context",
+    group: "workspace",
+    summary: "Return the current Dench workspace context for the bearer.",
+    cli: "dench context",
+    method: "GET",
+    path: "/context",
+    requestSchema: noBody,
+    responseSchema: anyResponse,
+    backend: convex("query", "functions/agentWorkspace:whatCanIDoHere"),
+  }),
+  op({
+    id: "workspace.status",
+    group: "workspace",
+    summary: "Return workspace and agent status.",
+    cli: "dench status",
+    method: "GET",
+    path: "/status",
+    requestSchema: noBody,
+    responseSchema: anyResponse,
+    backend: convex("query", "functions/agentWorkspace:whatCanIDoHere"),
+  }),
+  op({
+    id: "workspace.agents",
+    group: "workspace",
+    summary: "List agents visible in the workspace status payload.",
+    cli: "dench agents",
+    method: "GET",
+    path: "/agents",
+    requestSchema: noBody,
+    responseSchema: anyResponse,
+    backend: convex("query", "functions/agentWorkspace:whatCanIDoHere"),
+  }),
+  op({
+    id: "workspace.approvals.list",
+    group: "approvals",
+    summary: "List approval requests visible in the workspace status payload.",
+    cli: "dench approvals",
+    method: "GET",
+    path: "/approvals",
+    requestSchema: noBody,
+    responseSchema: anyResponse,
+    backend: convex("query", "functions/agentWorkspace:whatCanIDoHere"),
+  }),
+  op({
+    id: "workspace.artifacts.list",
+    group: "workspace",
+    summary: "List artifacts for the authenticated workspace.",
+    cli: "dench artifacts",
+    method: "GET",
+    path: "/artifacts",
+    requestSchema: noBody,
+    responseSchema: anyResponse,
+    backend: convex("query", "functions/agentWorkspace:agentListArtifacts"),
+  }),
+  op({
+    id: "workspace.suggestedWork.list",
+    group: "workspace",
+    summary: "List draft suggested-work artifacts.",
+    cli: "dench suggested-work",
+    method: "GET",
+    path: "/suggested-work",
+    requestSchema: noBody,
+    responseSchema: anyResponse,
+    backend: convex("query", "functions/agentWorkspace:agentListArtifacts"),
+  }),
+
+  // Memory and approvals.
+  op({
+    id: "memory.search",
+    group: "memory",
+    summary: "Search durable workspace memory.",
+    cli: "dench memory search",
+    method: "GET",
+    path: "/memory/search",
+    requestSchema: z
+      .object({ query: z.string(), limit: z.coerce.number().optional() })
+      .passthrough(),
+    responseSchema: anyResponse,
+    backend: convex("query", "functions/agentWorkspace:agentSearchMemory"),
+  }),
+  op({
+    id: "memory.save",
+    group: "memory",
+    summary: "Save a durable workspace memory fact.",
+    cli: "dench memory save",
+    method: "POST",
+    path: "/memory",
+    requestSchema: anyObject,
+    responseSchema: anyResponse,
+    backend: convex("mutation", "functions/agentWorkspace:agentSaveMemory"),
+  }),
+  op({
+    id: "approval.request",
+    group: "approvals",
+    summary: "Request human approval.",
+    cli: "dench approval request",
+    method: "POST",
+    path: "/approvals",
+    requestSchema: anyObject,
+    responseSchema: anyResponse,
+    backend: convex(
+      "mutation",
+      "functions/agentWorkspace:agentRequestApproval",
+    ),
+  }),
+  op({
+    id: "approval.decide",
+    group: "approvals",
+    summary: "Record an approval decision.",
+    cli: "dench approval approve|reject",
+    method: "POST",
+    path: "/approvals/{approvalId}/decision",
+    requestSchema: anyObject,
+    responseSchema: anyResponse,
+    backend: convex("mutation", "functions/agentWorkspace:agentDecideApproval"),
+  }),
+
+  // Billing.
+  op({
+    id: "billing.status",
+    group: "billing",
+    summary: "Get billing and AI credit status.",
+    cli: "dench billing status",
+    method: "GET",
+    path: "/billing/status",
+    requestSchema: noBody,
+    responseSchema: anyResponse,
+    backend: convex("query", "functions/agentWorkspace:getAgentBillingStatus"),
+  }),
+  op({
+    id: "billing.topup",
+    group: "billing",
+    summary: "Create an AI credit top-up checkout link.",
+    cli: "dench billing topup",
+    method: "POST",
+    path: "/billing/topup",
+    requestSchema: anyObject,
+    responseSchema: anyResponse,
+    backend: custom("billingTopup", "bearer"),
+  }),
+  op({
+    id: "billing.upgrade",
+    group: "billing",
+    summary: "Create a workspace upgrade checkout link.",
+    cli: "dench upgrade",
+    method: "POST",
+    path: "/billing/upgrade",
+    requestSchema: anyObject,
+    responseSchema: anyResponse,
+    backend: custom("upgrade", "bearer"),
+  }),
+
+  // Chat and agent aliases.
+  op({
+    id: "chat.list",
+    group: "chat",
+    summary: "List past chat threads.",
+    cli: "dench chat list",
+    method: "GET",
+    path: "/chat/threads",
+    requestSchema: noBody,
+    responseSchema: anyResponse,
+    backend: convex("query", "functions/chat:listPastChats", "bearer", {
+      includeRunId: true,
+    }),
+  }),
+  op({
+    id: "chat.search",
+    group: "chat",
+    summary: "Search past chat messages.",
+    cli: "dench chat search",
+    method: "GET",
+    path: "/chat/search",
+    requestSchema: anyObject,
+    responseSchema: anyResponse,
+    backend: convex("query", "functions/chat:searchPastChats", "bearer", {
+      includeRunId: true,
+    }),
+  }),
+  op({
+    id: "chat.read",
+    group: "chat",
+    summary: "Read a past chat thread.",
+    cli: "dench chat read",
+    method: "GET",
+    path: "/chat/threads/{threadId}",
+    requestSchema: noBody,
+    responseSchema: anyResponse,
+    backend: convex("query", "functions/chat:readPastChat", "bearer", {
+      includeRunId: true,
+    }),
+  }),
+  op({
+    id: "chat.tree",
+    group: "chat",
+    summary: "Read the parent-child chat thread hierarchy.",
+    cli: "dench chat tree",
+    method: "GET",
+    path: "/chat/tree",
+    requestSchema: noBody,
+    responseSchema: anyResponse,
+    backend: convex("query", "functions/chat:listPastChats", "bearer", {
+      includeRunId: true,
+    }),
+  }),
+  op({
+    id: "chat.rename",
+    group: "chat",
+    summary: "Rename one or more chat threads.",
+    cli: "dench chat rename",
+    method: "PATCH",
+    path: "/chat/threads",
+    requestSchema: anyObject,
+    responseSchema: anyResponse,
+    backend: convex("mutation", "functions/chat:renameThreads", "bearer", {
+      includeRunId: true,
+    }),
+  }),
+  op({
+    id: "chat.delete",
+    group: "chat",
+    summary: "Delete one or more chat threads.",
+    cli: "dench chat delete",
+    method: "DELETE",
+    path: "/chat/threads",
+    requestSchema: anyObject,
+    responseSchema: anyResponse,
+    backend: convex("mutation", "functions/chat:deleteThreads", "bearer", {
+      includeRunId: true,
+    }),
+  }),
+  op({
+    id: "chat.new",
+    group: "chat",
+    summary: "Start a new chat-turn workflow.",
+    cli: "dench chat new",
+    aliases: ["dench agent new"],
+    method: "POST",
+    path: "/chat/threads",
+    requestSchema: anyObject,
+    responseSchema: anyResponse,
+    backend: custom("chatSpawn", "bearer"),
+  }),
+  op({
+    id: "chat.send",
+    group: "chat",
+    summary: "Send a message to an existing chat thread.",
+    cli: "dench chat send",
+    aliases: ["dench agent send"],
+    method: "POST",
+    path: "/chat/threads/{threadId}/messages",
+    requestSchema: anyObject,
+    responseSchema: anyResponse,
+    backend: custom("chatSpawn", "bearer"),
+  }),
+  op({
+    id: "chat.follow",
+    group: "chat",
+    summary: "Follow a live chat response stream.",
+    cli: "dench chat follow",
+    aliases: ["dench agent follow"],
+    method: "GET",
+    path: "/chat/threads/{threadId}/stream",
+    requestSchema: noBody,
+    responseSchema: anyResponse,
+    backend: custom("chatFollow", "bearer"),
+  }),
+
+  // CRM core.
+  op({
+    id: "crm.objects.list",
+    group: "crm",
+    summary: "List CRM objects.",
+    cli: "dench crm objects list",
+    method: "GET",
+    path: "/crm/objects",
+    requestSchema: noBody,
+    responseSchema: anyResponse,
+    backend: convex("query", "functions/crm/objects:list"),
+  }),
+  op({
+    id: "crm.objects.get",
+    group: "crm",
+    summary: "Get a CRM object.",
+    cli: "dench crm objects get",
+    method: "GET",
+    path: "/crm/objects/{name}",
+    requestSchema: noBody,
+    responseSchema: anyResponse,
+    backend: convex("query", "functions/crm/objects:get"),
+  }),
+  op({
+    id: "crm.objects.create",
+    group: "crm",
+    summary: "Create a CRM object.",
+    cli: "dench crm objects create",
+    method: "POST",
+    path: "/crm/objects",
+    requestSchema: anyObject,
+    responseSchema: anyResponse,
+    backend: convex("mutation", "functions/crm/objects:create"),
+  }),
+  op({
+    id: "crm.objects.update",
+    group: "crm",
+    summary: "Update a CRM object.",
+    cli: "dench crm objects update",
+    method: "PATCH",
+    path: "/crm/objects/{name}",
+    requestSchema: anyObject,
+    responseSchema: anyResponse,
+    backend: convex("mutation", "functions/crm/objects:update"),
+  }),
+  op({
+    id: "crm.objects.rename",
+    group: "crm",
+    summary: "Rename a CRM object.",
+    cli: "dench crm objects rename",
+    method: "POST",
+    path: "/crm/objects/{from}/rename",
+    requestSchema: anyObject,
+    responseSchema: anyResponse,
+    backend: convex("mutation", "functions/crm/objects:rename"),
+  }),
+  op({
+    id: "crm.objects.delete",
+    group: "crm",
+    summary: "Delete a CRM object.",
+    cli: "dench crm objects delete",
+    method: "DELETE",
+    path: "/crm/objects/{name}",
+    requestSchema: anyObject,
+    responseSchema: anyResponse,
+    backend: convex("mutation", "functions/crm/objects:remove"),
+  }),
+
+  op({
+    id: "crm.fields.list",
+    group: "crm",
+    summary: "List fields for a CRM object.",
+    cli: "dench crm fields list",
+    method: "GET",
+    path: "/crm/objects/{objectName}/fields",
+    requestSchema: noBody,
+    responseSchema: anyResponse,
+    backend: convex("query", "functions/crm/fields:list"),
+  }),
+  op({
+    id: "crm.fields.create",
+    group: "crm",
+    summary: "Create a CRM field.",
+    cli: "dench crm fields create",
+    method: "POST",
+    path: "/crm/objects/{objectName}/fields",
+    requestSchema: anyObject,
+    responseSchema: anyResponse,
+    backend: convex("mutation", "functions/crm/fields:create"),
+  }),
+  op({
+    id: "crm.fields.update",
+    group: "crm",
+    summary: "Update a CRM field.",
+    cli: "dench crm fields update",
+    method: "PATCH",
+    path: "/crm/objects/{objectName}/fields/{fieldName}",
+    requestSchema: anyObject,
+    responseSchema: anyResponse,
+    backend: convex("mutation", "functions/crm/fields:update"),
+  }),
+  op({
+    id: "crm.fields.delete",
+    group: "crm",
+    summary: "Delete a CRM field.",
+    cli: "dench crm fields delete",
+    method: "DELETE",
+    path: "/crm/objects/{objectName}/fields/{fieldName}",
+    requestSchema: anyObject,
+    responseSchema: anyResponse,
+    backend: convex("mutation", "functions/crm/fields:remove"),
+  }),
+  op({
+    id: "crm.fields.reorder",
+    group: "crm",
+    summary: "Reorder CRM fields.",
+    cli: "dench crm fields reorder",
+    method: "POST",
+    path: "/crm/objects/{objectName}/fields/reorder",
+    requestSchema: anyObject,
+    responseSchema: anyResponse,
+    backend: convex("mutation", "functions/crm/fields:reorder"),
+  }),
+  op({
+    id: "crm.fields.enum.reorder",
+    group: "crm",
+    summary: "Reorder enum values.",
+    cli: "dench crm fields enum-reorder",
+    method: "POST",
+    path: "/crm/objects/{objectName}/fields/{fieldName}/enum/reorder",
+    requestSchema: anyObject,
+    responseSchema: anyResponse,
+    backend: convex("mutation", "functions/crm/fields:reorderEnumValues"),
+  }),
+  op({
+    id: "crm.fields.enum.add",
+    group: "crm",
+    summary: "Add an enum value.",
+    cli: "dench crm fields enum-add",
+    method: "POST",
+    path: "/crm/objects/{objectName}/fields/{fieldName}/enum",
+    requestSchema: anyObject,
+    responseSchema: anyResponse,
+    backend: convex("mutation", "functions/crm/fields:addEnumValue"),
+  }),
+  op({
+    id: "crm.fields.enum.remove",
+    group: "crm",
+    summary: "Remove an enum value.",
+    cli: "dench crm fields enum-remove",
+    method: "DELETE",
+    path: "/crm/objects/{objectName}/fields/{fieldName}/enum/{value}",
+    requestSchema: anyObject,
+    responseSchema: anyResponse,
+    backend: convex("mutation", "functions/crm/fields:removeEnumValue"),
+  }),
+  op({
+    id: "crm.fields.enum.rename",
+    group: "crm",
+    summary: "Rename an enum value.",
+    cli: "dench crm fields enum-rename",
+    method: "POST",
+    path: "/crm/objects/{objectName}/fields/{fieldName}/enum/{oldValue}/rename",
+    requestSchema: anyObject,
+    responseSchema: anyResponse,
+    backend: convex("mutation", "functions/crm/fields:renameEnumValue"),
+  }),
+  op({
+    id: "crm.fields.enum.color",
+    group: "crm",
+    summary: "Set an enum color.",
+    cli: "dench crm fields enum-set-color",
+    method: "POST",
+    path: "/crm/objects/{objectName}/fields/{fieldName}/enum/{value}/color",
+    requestSchema: anyObject,
+    responseSchema: anyResponse,
+    backend: convex("mutation", "functions/crm/fields:setEnumColor"),
+  }),
+
+  op({
+    id: "crm.entries.list",
+    group: "crm",
+    summary: "List CRM entries.",
+    cli: "dench crm entries list",
+    method: "GET",
+    path: "/crm/objects/{objectName}/entries",
+    requestSchema: noBody,
+    responseSchema: anyResponse,
+    backend: convex("query", "functions/crm/entries:list"),
+  }),
+  op({
+    id: "crm.entries.get",
+    group: "crm",
+    summary: "Get a CRM entry.",
+    cli: "dench crm entries get",
+    method: "GET",
+    path: "/crm/objects/{objectName}/entries/{entryId}",
+    requestSchema: noBody,
+    responseSchema: anyResponse,
+    backend: convex("query", "functions/crm/entries:get"),
+  }),
+  op({
+    id: "crm.entries.create",
+    group: "crm",
+    summary: "Create a CRM entry.",
+    cli: "dench crm entries create",
+    method: "POST",
+    path: "/crm/objects/{objectName}/entries",
+    requestSchema: anyObject,
+    responseSchema: anyResponse,
+    backend: convex("mutation", "functions/crm/entries:create"),
+  }),
+  op({
+    id: "crm.entries.createMany",
+    group: "crm",
+    summary: "Create many CRM entries.",
+    cli: "dench crm entries create-many",
+    method: "POST",
+    path: "/crm/objects/{objectName}/entries/batch",
+    requestSchema: anyObject,
+    responseSchema: anyResponse,
+    backend: convex("mutation", "functions/crm/entries:createMany"),
+  }),
+  op({
+    id: "crm.entries.update",
+    group: "crm",
+    summary: "Update a CRM entry.",
+    cli: "dench crm entries update",
+    method: "PATCH",
+    path: "/crm/objects/{objectName}/entries/{entryId}",
+    requestSchema: anyObject,
+    responseSchema: anyResponse,
+    backend: convex("mutation", "functions/crm/entries:update"),
+  }),
+  op({
+    id: "crm.entries.updateMany",
+    group: "crm",
+    summary: "Update many CRM entries.",
+    cli: "dench crm entries update-many",
+    method: "PATCH",
+    path: "/crm/objects/{objectName}/entries/batch",
+    requestSchema: anyObject,
+    responseSchema: anyResponse,
+    backend: convex("mutation", "functions/crm/batch:apply"),
+  }),
+  op({
+    id: "crm.entries.delete",
+    group: "crm",
+    summary: "Delete a CRM entry.",
+    cli: "dench crm entries delete",
+    method: "DELETE",
+    path: "/crm/objects/{objectName}/entries/{entryId}",
+    requestSchema: anyObject,
+    responseSchema: anyResponse,
+    backend: convex("mutation", "functions/crm/entries:remove"),
+  }),
+  op({
+    id: "crm.entries.bulkDelete",
+    group: "crm",
+    summary: "Bulk delete CRM entries.",
+    cli: "dench crm entries bulk-delete",
+    method: "POST",
+    path: "/crm/objects/{objectName}/entries/delete",
+    requestSchema: anyObject,
+    responseSchema: anyResponse,
+    backend: convex("mutation", "functions/crm/entries:bulkDelete"),
+  }),
+
+  op({
+    id: "crm.cells.get",
+    group: "crm",
+    summary: "Get a CRM cell value.",
+    cli: "dench crm cells get",
+    method: "GET",
+    path: "/crm/objects/{objectName}/entries/{entryId}/fields/{fieldName}",
+    requestSchema: noBody,
+    responseSchema: anyResponse,
+    backend: convex("query", "functions/crm/cells:get"),
+  }),
+  op({
+    id: "crm.cells.set",
+    group: "crm",
+    summary: "Set a CRM cell value.",
+    cli: "dench crm cells set",
+    method: "PUT",
+    path: "/crm/objects/{objectName}/entries/{entryId}/fields/{fieldName}",
+    requestSchema: anyObject,
+    responseSchema: anyResponse,
+    backend: convex("mutation", "functions/crm/cells:set"),
+  }),
+  op({
+    id: "crm.cells.setMany",
+    group: "crm",
+    summary: "Set many CRM cell values.",
+    cli: "dench crm cells set-many",
+    method: "POST",
+    path: "/crm/cells/batch",
+    requestSchema: anyObject,
+    responseSchema: anyResponse,
+    backend: convex("mutation", "functions/crm/cells:setMany"),
+  }),
+  op({
+    id: "crm.cells.append",
+    group: "crm",
+    summary: "Append to a CRM cell.",
+    cli: "dench crm cells append",
+    method: "POST",
+    path: "/crm/objects/{objectName}/entries/{entryId}/fields/{fieldName}/append",
+    requestSchema: anyObject,
+    responseSchema: anyResponse,
+    backend: convex("mutation", "functions/crm/cells:append"),
+  }),
+
+  op({
+    id: "crm.query",
+    group: "crm",
+    summary: "Query CRM entries.",
+    cli: "dench crm query",
+    method: "POST",
+    path: "/crm/query",
+    requestSchema: anyObject,
+    responseSchema: anyResponse,
+    backend: convex("query", "functions/crm/query:queryEntries"),
+  }),
+  op({
+    id: "crm.sql",
+    group: "crm",
+    summary: "Run CRM SQL-compatible query.",
+    cli: "dench crm sql",
+    method: "POST",
+    path: "/crm/sql",
+    requestSchema: anyObject,
+    responseSchema: anyResponse,
+    backend: convex("query", "functions/crm/query:queryEntries"),
+  }),
+  op({
+    id: "crm.aggregate",
+    group: "crm",
+    summary: "Aggregate CRM entries.",
+    cli: "dench crm aggregate",
+    method: "POST",
+    path: "/crm/aggregate",
+    requestSchema: anyObject,
+    responseSchema: anyResponse,
+    backend: convex("query", "functions/crm/query:aggregate"),
+  }),
+  op({
+    id: "crm.search",
+    group: "crm",
+    summary: "Search CRM entries.",
+    cli: "dench crm search",
+    method: "GET",
+    path: "/crm/search",
+    requestSchema: anyObject,
+    responseSchema: anyResponse,
+    backend: convex("query", "functions/crm/query:search"),
+  }),
+  op({
+    id: "crm.statuses.list",
+    group: "crm",
+    summary: "List CRM statuses.",
+    cli: "dench crm statuses list",
+    method: "GET",
+    path: "/crm/objects/{objectName}/statuses",
+    requestSchema: noBody,
+    responseSchema: anyResponse,
+    backend: convex("query", "functions/crm/statuses:list"),
+  }),
+  op({
+    id: "crm.statuses.set",
+    group: "crm",
+    summary: "Set CRM statuses.",
+    cli: "dench crm statuses set",
+    method: "PUT",
+    path: "/crm/objects/{objectName}/statuses",
+    requestSchema: anyObject,
+    responseSchema: anyResponse,
+    backend: convex("mutation", "functions/crm/statuses:upsertMany"),
+  }),
+  op({
+    id: "crm.batch",
+    group: "crm",
+    summary: "Apply a CRM batch.",
+    cli: "dench crm batch",
+    method: "POST",
+    path: "/crm/batch",
+    requestSchema: anyObject,
+    responseSchema: anyResponse,
+    backend: convex("mutation", "functions/crm/batch:apply"),
+  }),
+  op({
+    id: "crm.transaction.begin",
+    group: "crm",
+    summary: "Begin a CRM transaction.",
+    cli: "dench crm transaction begin",
+    method: "POST",
+    path: "/crm/transactions",
+    requestSchema: anyObject,
+    responseSchema: anyResponse,
+    backend: convex("mutation", "functions/crm/transaction:begin"),
+  }),
+  op({
+    id: "crm.transaction.add",
+    group: "crm",
+    summary: "Add an operation to a CRM transaction.",
+    cli: "dench crm transaction add",
+    method: "POST",
+    path: "/crm/transactions/{txnId}/operations",
+    requestSchema: anyObject,
+    responseSchema: anyResponse,
+    backend: convex("mutation", "functions/crm/transaction:addOp"),
+  }),
+  op({
+    id: "crm.transaction.commit",
+    group: "crm",
+    summary: "Commit a CRM transaction.",
+    cli: "dench crm transaction commit",
+    method: "POST",
+    path: "/crm/transactions/{txnId}/commit",
+    requestSchema: anyObject,
+    responseSchema: anyResponse,
+    backend: convex("mutation", "functions/crm/transaction:commit"),
+  }),
+  op({
+    id: "crm.transaction.abort",
+    group: "crm",
+    summary: "Abort a CRM transaction.",
+    cli: "dench crm transaction abort",
+    method: "POST",
+    path: "/crm/transactions/{txnId}/abort",
+    requestSchema: anyObject,
+    responseSchema: anyResponse,
+    backend: convex("mutation", "functions/crm/transaction:abort"),
+  }),
+  op({
+    id: "crm.transaction.inspect",
+    group: "crm",
+    summary: "Inspect a CRM transaction.",
+    cli: "dench crm transaction inspect",
+    method: "GET",
+    path: "/crm/transactions/{txnId}",
+    requestSchema: noBody,
+    responseSchema: anyResponse,
+    backend: convex("query", "functions/crm/transaction:inspect"),
+  }),
+  op({
+    id: "crm.docs.list",
+    group: "crm",
+    summary: "List CRM documents.",
+    cli: "dench crm docs list",
+    method: "GET",
+    path: "/crm/docs",
+    requestSchema: noBody,
+    responseSchema: anyResponse,
+    backend: convex("query", "functions/crm/documents:list"),
+  }),
+  op({
+    id: "crm.docs.create",
+    group: "crm",
+    summary: "Create a CRM document.",
+    cli: "dench crm docs create",
+    method: "POST",
+    path: "/crm/docs",
+    requestSchema: anyObject,
+    responseSchema: anyResponse,
+    backend: convex("mutation", "functions/crm/documents:create"),
+  }),
+  op({
+    id: "crm.docs.link",
+    group: "crm",
+    summary: "Link a CRM document.",
+    cli: "dench crm docs link",
+    method: "POST",
+    path: "/crm/docs/link",
+    requestSchema: anyObject,
+    responseSchema: anyResponse,
+    backend: convex("mutation", "functions/crm/documents:link"),
+  }),
+  op({
+    id: "crm.actions.list",
+    group: "crm",
+    summary: "List CRM actions.",
+    cli: "dench crm actions list",
+    method: "GET",
+    path: "/crm/actions",
+    requestSchema: noBody,
+    responseSchema: anyResponse,
+    backend: convex("query", "functions/crm/actions:list"),
+  }),
+  op({
+    id: "crm.actions.run",
+    group: "crm",
+    summary: "Start a CRM action run.",
+    cli: "dench crm actions run",
+    method: "POST",
+    path: "/crm/actions/{actionId}/runs",
+    requestSchema: anyObject,
+    responseSchema: anyResponse,
+    backend: convex("mutation", "functions/crm/actions:startActionRun"),
+  }),
+  op({
+    id: "crm.members.list",
+    group: "crm",
+    summary: "List workspace members for CRM user fields.",
+    cli: "dench members list",
+    method: "GET",
+    path: "/members",
+    requestSchema: noBody,
+    responseSchema: anyResponse,
+    backend: convex("query", "functions/crm/members:list"),
+  }),
+  op({
+    id: "crm.reports.generate",
+    group: "crm",
+    summary: "Generate a CRM report.",
+    cli: "dench crm reports generate",
+    method: "POST",
+    path: "/crm/reports",
+    requestSchema: anyObject,
+    responseSchema: anyResponse,
+    backend: convex("query", "functions/crm/reports:generate"),
+  }),
+  op({
+    id: "crm.enrich.cell",
+    group: "crm",
+    summary: "Request enrichment for one CRM cell.",
+    cli: "dench crm enrich cell",
+    method: "POST",
+    path: "/crm/enrich/cell",
+    requestSchema: anyObject,
+    responseSchema: anyResponse,
+    backend: convex("mutation", "functions/crm/enrich:requestCellEnrichment"),
+  }),
+  op({
+    id: "crm.enrich.object",
+    group: "crm",
+    summary: "Request enrichment for a CRM object.",
+    cli: "dench crm enrich object",
+    method: "POST",
+    path: "/crm/enrich/object",
+    requestSchema: anyObject,
+    responseSchema: anyResponse,
+    backend: convex("mutation", "functions/crm/enrich:requestObjectEnrichment"),
+  }),
+  op({
+    id: "crm.people.search",
+    group: "crm",
+    summary: "Search for people through the enrichment gateway.",
+    cli: "dench crm people search",
+    method: "POST",
+    path: "/crm/people/search",
+    requestSchema: anyObject,
+    responseSchema: anyResponse,
+    backend: gateway("POST", "/enrichment/people/search"),
+  }),
+  op({
+    id: "crm.companies.search",
+    group: "crm",
+    summary: "Search for companies through the enrichment gateway.",
+    cli: "dench crm companies search",
+    method: "POST",
+    path: "/crm/companies/search",
+    requestSchema: anyObject,
+    responseSchema: anyResponse,
+    backend: gateway("POST", "/enrichment/company/search"),
+  }),
+  op({
+    id: "crm.import",
+    group: "local",
+    summary: "Import a local CSV into a CRM object.",
+    cli: "dench crm import",
+    method: "POST",
+    path: "/local/crm/import",
+    requestSchema: anyObject,
+    responseSchema: anyResponse,
+    backend: local(
+      "Reads a CSV from the caller's local filesystem. Over the API, parse the CSV client-side and POST rows to /crm/objects/{objectName}/entries/batch.",
+    ),
+  }),
+  op({
+    id: "crm.export",
+    group: "local",
+    summary: "Export a CRM object to a local CSV.",
+    cli: "dench crm export",
+    method: "POST",
+    path: "/local/crm/export",
+    requestSchema: anyObject,
+    responseSchema: anyResponse,
+    backend: local(
+      "Writes a CSV to the caller's local filesystem. Over the API, call POST /crm/query and format CSV client-side.",
+    ),
+  }),
+
+  // Managed email campaigns.
+  op({
+    id: "email.identity.verify",
+    group: "email",
+    summary: "Start Dench Emailing Service sender verification.",
+    cli: "dench email identity verify",
+    method: "POST",
+    path: "/email/identities/verify",
+    requestSchema: anyObject,
+    responseSchema: anyResponse,
+    backend: gateway("POST", "/email/identities/verify"),
+  }),
+  op({
+    id: "email.identity.create",
+    group: "email",
+    summary: "Create a durable Dench email sending identity record.",
+    cli: "dench email identity verify",
+    method: "POST",
+    path: "/email/sending-identities",
+    requestSchema: anyObject,
+    responseSchema: anyResponse,
+    backend: convex("mutation", "functions/emailCampaigns:createIdentity"),
+  }),
+  op({
+    id: "email.identity.refresh",
+    group: "email",
+    summary: "Refresh a Dench Emailing Service sender verification status.",
+    cli: "dench email identity status --identity-id",
+    method: "POST",
+    path: "/email/sending-identities/{identityId}/status",
+    requestSchema: anyObject,
+    responseSchema: anyResponse,
+    backend: convex(
+      "action",
+      "functions/emailCampaignsNode:refreshIdentityStatus",
+    ),
+  }),
+  op({
+    id: "email.identity.beginVerification",
+    group: "email",
+    summary:
+      "Begin the full Dench sender verification flow for a sending identity.",
+    cli: "dench email identity verify",
+    method: "POST",
+    path: "/email/sending-identities/{identityId}/verify",
+    requestSchema: anyObject,
+    responseSchema: anyResponse,
+    backend: convex(
+      "action",
+      "functions/emailCampaignsNode:beginSenderVerification",
+    ),
+  }),
+  op({
+    id: "email.identity.status",
+    group: "email",
+    summary: "Read Dench Emailing Service sender verification status.",
+    cli: "dench email identity status",
+    method: "GET",
+    path: "/email/identities/{identity}/status",
+    requestSchema: anyObject,
+    responseSchema: anyResponse,
+    backend: gateway("GET", "/email/identities/{identity}/status"),
+  }),
+  op({
+    id: "email.template.create",
+    group: "email",
+    summary: "Create a managed email campaign template.",
+    cli: "dench email template create",
+    method: "POST",
+    path: "/email/templates",
+    requestSchema: anyObject,
+    responseSchema: anyResponse,
+    backend: convex("mutation", "functions/emailCampaigns:createTemplate"),
+  }),
+  op({
+    id: "email.template.preview",
+    group: "email",
+    summary: "Preview a managed email campaign template.",
+    cli: "dench email template preview",
+    method: "POST",
+    path: "/email/templates/{templateId}/preview",
+    requestSchema: anyObject,
+    responseSchema: anyResponse,
+    backend: convex("query", "functions/emailCampaigns:previewTemplate"),
+  }),
+  op({
+    id: "email.campaign.create",
+    group: "email",
+    summary: "Create a managed email campaign draft.",
+    cli: "dench email campaign create",
+    method: "POST",
+    path: "/email/campaigns",
+    requestSchema: anyObject,
+    responseSchema: anyResponse,
+    backend: convex("mutation", "functions/emailCampaigns:createCampaign"),
+  }),
+  op({
+    id: "email.campaign.get",
+    group: "email",
+    summary: "Read campaign status and counters.",
+    cli: "dench email campaign status",
+    method: "GET",
+    path: "/email/campaigns/{campaignId}",
+    requestSchema: anyObject,
+    responseSchema: anyResponse,
+    backend: convex("query", "functions/emailCampaigns:getCampaign"),
+  }),
+  op({
+    id: "email.campaign.recipients.add",
+    group: "email",
+    summary: "Add recipients to a managed email campaign.",
+    cli: "dench email campaign recipients add",
+    method: "POST",
+    path: "/email/campaigns/{campaignId}/recipients",
+    requestSchema: anyObject,
+    responseSchema: anyResponse,
+    backend: convex("mutation", "functions/emailCampaigns:addRecipients"),
+  }),
+  op({
+    id: "email.campaign.preview",
+    group: "email",
+    summary: "Preview rendered messages for a campaign sample.",
+    cli: "dench email campaign preview",
+    method: "POST",
+    path: "/email/campaigns/{campaignId}/preview",
+    requestSchema: anyObject,
+    responseSchema: anyResponse,
+    backend: convex("query", "functions/emailCampaigns:previewCampaign"),
+  }),
+  op({
+    id: "email.campaign.submit",
+    group: "email",
+    summary: "Submit a campaign for approval or sending.",
+    cli: "dench email campaign submit",
+    method: "POST",
+    path: "/email/campaigns/{campaignId}/submit",
+    requestSchema: anyObject,
+    responseSchema: anyResponse,
+    backend: convex("mutation", "functions/emailCampaigns:submitCampaign"),
+  }),
+  op({
+    id: "email.campaign.pause",
+    group: "email",
+    summary: "Pause a sending email campaign.",
+    cli: "dench email campaign pause",
+    method: "POST",
+    path: "/email/campaigns/{campaignId}/pause",
+    requestSchema: anyObject,
+    responseSchema: anyResponse,
+    backend: convex("mutation", "functions/emailCampaigns:pauseCampaign"),
+  }),
+  op({
+    id: "email.campaign.resume",
+    group: "email",
+    summary: "Resume a paused email campaign.",
+    cli: "dench email campaign resume",
+    method: "POST",
+    path: "/email/campaigns/{campaignId}/resume",
+    requestSchema: anyObject,
+    responseSchema: anyResponse,
+    backend: convex("mutation", "functions/emailCampaigns:resumeCampaign"),
+  }),
+  op({
+    id: "email.campaign.cancel",
+    group: "email",
+    summary: "Cancel an email campaign.",
+    cli: "dench email campaign cancel",
+    method: "POST",
+    path: "/email/campaigns/{campaignId}/cancel",
+    requestSchema: anyObject,
+    responseSchema: anyResponse,
+    backend: convex("mutation", "functions/emailCampaigns:cancelCampaign"),
+  }),
+
+  // Routines.
+  op({
+    id: "cron.list",
+    group: "routines",
+    summary: "List routines.",
+    cli: "dench cron list",
+    aliases: ["dench routine list", "dench routines list"],
+    method: "GET",
+    path: "/routines",
+    requestSchema: noBody,
+    responseSchema: anyResponse,
+    backend: convex("query", "functions/triggers:listCronJobs"),
+  }),
+  op({
+    id: "cron.history",
+    group: "routines",
+    summary: "List routine run history.",
+    cli: "dench cron history",
+    method: "GET",
+    path: "/routines/history",
+    requestSchema: noBody,
+    responseSchema: anyResponse,
+    backend: convex("query", "functions/triggers:listOrgCronRunHistory"),
+  }),
+  op({
+    id: "cron.get",
+    group: "routines",
+    summary: "Get a routine.",
+    cli: "dench cron get",
+    method: "GET",
+    path: "/routines/{jobId}",
+    requestSchema: noBody,
+    responseSchema: anyResponse,
+    backend: convex("query", "functions/triggers:getCronJob"),
+  }),
+  op({
+    id: "cron.create",
+    group: "routines",
+    summary: "Create a routine.",
+    cli: "dench cron create",
+    method: "POST",
+    path: "/routines",
+    requestSchema: anyObject,
+    responseSchema: anyResponse,
+    backend: convex("mutation", "functions/triggers:createCronTrigger"),
+  }),
+  op({
+    id: "cron.update",
+    group: "routines",
+    summary: "Update a routine.",
+    cli: "dench cron update",
+    method: "PATCH",
+    path: "/routines/{jobId}",
+    requestSchema: anyObject,
+    responseSchema: anyResponse,
+    backend: convex("mutation", "functions/triggers:updateCronTrigger"),
+  }),
+  op({
+    id: "cron.delete",
+    group: "routines",
+    summary: "Delete a routine.",
+    cli: "dench cron delete",
+    method: "DELETE",
+    path: "/routines/{jobId}",
+    requestSchema: anyObject,
+    responseSchema: anyResponse,
+    backend: convex("mutation", "functions/triggers:deleteCronTrigger"),
+  }),
+  op({
+    id: "cron.enable",
+    group: "routines",
+    summary: "Enable a routine.",
+    cli: "dench cron enable",
+    method: "POST",
+    path: "/routines/{jobId}/enable",
+    requestSchema: anyObject,
+    responseSchema: anyResponse,
+    backend: convex("mutation", "functions/triggers:setCronEnabled"),
+  }),
+  op({
+    id: "cron.disable",
+    group: "routines",
+    summary: "Disable a routine.",
+    cli: "dench cron disable",
+    method: "POST",
+    path: "/routines/{jobId}/disable",
+    requestSchema: anyObject,
+    responseSchema: anyResponse,
+    backend: convex("mutation", "functions/triggers:setCronEnabled"),
+  }),
+  op({
+    id: "cron.run",
+    group: "routines",
+    summary: "Run a routine now.",
+    cli: "dench cron run",
+    method: "POST",
+    path: "/routines/{jobId}/run",
+    requestSchema: anyObject,
+    responseSchema: anyResponse,
+    backend: custom("cronRunNow", "bearer"),
+  }),
+  op({
+    id: "cron.runs",
+    group: "routines",
+    summary: "List runs for a routine.",
+    cli: "dench cron runs",
+    method: "GET",
+    path: "/routines/{jobId}/runs",
+    requestSchema: noBody,
+    responseSchema: anyResponse,
+    backend: convex("query", "functions/triggers:listCronRuns"),
+  }),
+
+  // Files.
+  op({
+    id: "files.list",
+    group: "files",
+    summary: "List workspace files.",
+    cli: "dench files ls",
+    method: "GET",
+    path: "/files",
+    requestSchema: noBody,
+    responseSchema: anyResponse,
+    backend: convex("query", "functions/files:listTree", "bearer", {
+      tokenArg: "apiKey",
+    }),
+  }),
+  op({
+    id: "files.downloadUrl",
+    group: "files",
+    summary: "Get a signed file download URL.",
+    cli: "dench files ls",
+    method: "GET",
+    path: "/files/download-url",
+    requestSchema: noBody,
+    responseSchema: anyResponse,
+    backend: convex(
+      "action",
+      "functions/files:getFileSignedDownloadUrl",
+      "bearer",
+      { tokenArg: "apiKey" },
+    ),
+  }),
+  op({
+    id: "files.delete",
+    group: "files",
+    summary: "Remove a workspace file or directory.",
+    cli: "dench files rm",
+    method: "DELETE",
+    path: "/files",
+    requestSchema: anyObject,
+    responseSchema: anyResponse,
+    backend: convex("mutation", "functions/files:deleteFile", "bearer", {
+      tokenArg: "apiKey",
+    }),
+  }),
+  op({
+    id: "files.move",
+    group: "files",
+    summary: "Move a workspace file or directory.",
+    cli: "dench files mv",
+    method: "POST",
+    path: "/files/move",
+    requestSchema: anyObject,
+    responseSchema: anyResponse,
+    backend: custom("filesMove", "bearer"),
+  }),
+  op({
+    id: "files.stage",
+    group: "files",
+    summary: "Stage uploaded content into the workspace.",
+    cli: "dench stage",
+    method: "POST",
+    path: "/files/stage",
+    requestSchema: anyObject,
+    responseSchema: anyResponse,
+    backend: custom("filesStage", "bearer"),
+  }),
+  op({
+    id: "fs.daemon",
+    group: "local",
+    summary: "Run the local file sync daemon.",
+    cli: "dench fs",
+    method: "POST",
+    path: "/local/fs",
+    requestSchema: anyObject,
+    responseSchema: anyResponse,
+    backend: local(
+      "The fs daemon watches the caller's local /workspace mount.",
+    ),
+  }),
+
+  // Gateway-backed commands.
+  op({
+    id: "search.web",
+    group: "gateway",
+    summary: "Search the web through the Dench gateway.",
+    cli: "dench search",
+    method: "POST",
+    path: "/search",
+    requestSchema: anyObject,
+    responseSchema: anyResponse,
+    backend: gateway("POST", "/search"),
+  }),
+  op({
+    id: "search.contents",
+    group: "gateway",
+    summary: "Fetch page contents through the Dench gateway.",
+    cli: "dench search contents",
+    method: "POST",
+    path: "/search/contents",
+    requestSchema: anyObject,
+    responseSchema: anyResponse,
+    backend: gateway("POST", "/search/contents"),
+  }),
+  op({
+    id: "search.answer",
+    group: "gateway",
+    summary: "Answer a question with web search.",
+    cli: "dench search answer",
+    method: "POST",
+    path: "/search/answer",
+    requestSchema: anyObject,
+    responseSchema: anyResponse,
+    backend: gateway("POST", "/search/answer"),
+  }),
+  op({
+    id: "image.generate",
+    group: "gateway",
+    summary: "Generate an image through the Dench gateway.",
+    cli: "dench image generate",
+    method: "POST",
+    path: "/images/generations",
+    requestSchema: anyObject,
+    responseSchema: anyResponse,
+    backend: gateway("POST", "/images/generations"),
+  }),
+  op({
+    id: "image.edit",
+    group: "gateway",
+    summary: "Edit an image through the Dench gateway.",
+    cli: "dench image edit",
+    method: "POST",
+    path: "/images/edits",
+    requestSchema: anyObject,
+    responseSchema: anyResponse,
+    backend: gateway("POST", "/images/edits"),
+  }),
+  op({
+    id: "apps.list",
+    group: "gateway",
+    summary: "List connected apps.",
+    cli: "dench apps",
+    method: "GET",
+    path: "/apps",
+    requestSchema: noBody,
+    responseSchema: anyResponse,
+    backend: gateway("GET", "/composio/connections"),
+  }),
+  op({
+    id: "tool.status",
+    group: "gateway",
+    summary: "List connected tool accounts.",
+    cli: "dench tool status",
+    method: "GET",
+    path: "/tools/status",
+    requestSchema: noBody,
+    responseSchema: anyResponse,
+    backend: gateway("GET", "/composio/connections"),
+  }),
+  op({
+    id: "tool.connect",
+    group: "gateway",
+    summary: "Create a tool OAuth connection link.",
+    cli: "dench tool connect",
+    method: "POST",
+    path: "/tools/connections",
+    requestSchema: anyObject,
+    responseSchema: anyResponse,
+    backend: gateway("POST", "/composio/connect"),
+  }),
+  op({
+    id: "tool.search",
+    group: "gateway",
+    summary: "Search for external tool actions.",
+    cli: "dench tool search",
+    method: "POST",
+    path: "/tools/search",
+    requestSchema: anyObject,
+    responseSchema: anyResponse,
+    backend: gateway("POST", "/composio/tool-router/search"),
+  }),
+  op({
+    id: "tool.run",
+    group: "gateway",
+    summary: "Run an external tool action.",
+    cli: "dench tool run",
+    method: "POST",
+    path: "/tools/run",
+    requestSchema: anyObject,
+    responseSchema: anyResponse,
+    backend: gateway("POST", "/composio/tool-router/execute"),
+  }),
+  op({
+    id: "tool.disconnect",
+    group: "gateway",
+    summary: "Disconnect an external tool account.",
+    cli: "dench tool disconnect",
+    method: "DELETE",
+    path: "/tools/connections/{connectionId}",
+    requestSchema: anyObject,
+    responseSchema: anyResponse,
+    backend: gateway("DELETE", "/composio/connections/{connectionId}"),
+  }),
+
+  // Agent harness config.
+  op({
+    id: "agentConfig.identity.show",
+    group: "agent-config",
+    summary: "Read IDENTITY.md.",
+    cli: "dench identity show",
+    method: "GET",
+    path: "/agent-config/identity",
+    requestSchema: noBody,
+    responseSchema: anyResponse,
+    backend: convex("query", "functions/agentConfig:getAgentConfig"),
+  }),
+  op({
+    id: "agentConfig.identity.edit",
+    group: "agent-config",
+    summary: "Update IDENTITY.md.",
+    cli: "dench identity edit",
+    method: "PUT",
+    path: "/agent-config/identity",
+    requestSchema: anyObject,
+    responseSchema: anyResponse,
+    backend: convex("mutation", "functions/agentConfig:updateIdentity"),
+  }),
+  op({
+    id: "agentConfig.organisation.show",
+    group: "agent-config",
+    summary: "Read ORGANISATION.md.",
+    cli: "dench organisation show",
+    method: "GET",
+    path: "/agent-config/organisation",
+    requestSchema: noBody,
+    responseSchema: anyResponse,
+    backend: convex("query", "functions/agentConfig:getAgentConfig"),
+  }),
+  op({
+    id: "agentConfig.organisation.edit",
+    group: "agent-config",
+    summary: "Update ORGANISATION.md.",
+    cli: "dench organisation edit",
+    method: "PUT",
+    path: "/agent-config/organisation",
+    requestSchema: anyObject,
+    responseSchema: anyResponse,
+    backend: convex("mutation", "functions/agentConfig:updateOrganisation"),
+  }),
+  op({
+    id: "agentConfig.user.show",
+    group: "agent-config",
+    summary: "Read USER.md.",
+    cli: "dench user show",
+    method: "GET",
+    path: "/agent-config/user",
+    requestSchema: noBody,
+    responseSchema: anyResponse,
+    backend: convex("query", "functions/agentConfig:getAgentConfig"),
+  }),
+  op({
+    id: "agentConfig.user.edit",
+    group: "agent-config",
+    summary: "Update USER.md.",
+    cli: "dench user edit",
+    method: "PUT",
+    path: "/agent-config/user",
+    requestSchema: anyObject,
+    responseSchema: anyResponse,
+    backend: convex("mutation", "functions/agentConfig:updateUserProfile"),
+  }),
+  op({
+    id: "agentConfig.tools.show",
+    group: "agent-config",
+    summary: "Read tool notes.",
+    cli: "dench tools show",
+    method: "GET",
+    path: "/agent-config/tools",
+    requestSchema: noBody,
+    responseSchema: anyResponse,
+    backend: convex("query", "functions/agentConfig:getAgentConfig"),
+  }),
+  op({
+    id: "agentConfig.tools.edit",
+    group: "agent-config",
+    summary: "Update tool notes.",
+    cli: "dench tools notes-edit",
+    method: "PUT",
+    path: "/agent-config/tools",
+    requestSchema: anyObject,
+    responseSchema: anyResponse,
+    backend: convex("mutation", "functions/agentConfig:updateToolsNotes"),
+  }),
+  op({
+    id: "agentConfig.mem.show",
+    group: "agent-config",
+    summary: "Read aggregate memory.",
+    cli: "dench mem show",
+    method: "GET",
+    path: "/agent-config/mem",
+    requestSchema: noBody,
+    responseSchema: anyResponse,
+    backend: convex("query", "functions/agentConfig:getAgentConfig"),
+  }),
+  op({
+    id: "agentConfig.mem.edit",
+    group: "agent-config",
+    summary: "Update aggregate memory.",
+    cli: "dench mem set",
+    method: "PUT",
+    path: "/agent-config/mem",
+    requestSchema: anyObject,
+    responseSchema: anyResponse,
+    backend: convex("mutation", "functions/agentConfig:updateMemory"),
+  }),
+  op({
+    id: "agentConfig.bootstrap.show",
+    group: "agent-config",
+    summary: "Read bootstrap state.",
+    cli: "dench bootstrap status",
+    method: "GET",
+    path: "/agent-config/bootstrap",
+    requestSchema: noBody,
+    responseSchema: anyResponse,
+    backend: convex("query", "functions/agentConfig:getAgentConfig"),
+  }),
+  op({
+    id: "agentConfig.bootstrap.complete",
+    group: "agent-config",
+    summary: "Complete bootstrap.",
+    cli: "dench bootstrap complete",
+    method: "POST",
+    path: "/agent-config/bootstrap/complete",
+    requestSchema: anyObject,
+    responseSchema: anyResponse,
+    backend: convex("mutation", "functions/agentConfig:completeBootstrap"),
+  }),
+  op({
+    id: "agentConfig.bootstrap.template",
+    group: "agent-config",
+    summary: "Update bootstrap template.",
+    cli: "dench bootstrap template",
+    method: "PUT",
+    path: "/agent-config/bootstrap/template",
+    requestSchema: anyObject,
+    responseSchema: anyResponse,
+    backend: convex(
+      "mutation",
+      "functions/agentConfig:updateBootstrapTemplate",
+    ),
+  }),
+  op({
+    id: "agentConfig.model.default",
+    group: "agent-config",
+    summary: "Set the default chat model.",
+    cli: "dench model default",
+    method: "PUT",
+    path: "/agent-config/model/default",
+    requestSchema: anyObject,
+    responseSchema: anyResponse,
+    backend: convex("mutation", "functions/agentConfig:setDefaultChatModelV2"),
+  }),
+  op({
+    id: "agentConfig.model.thread",
+    group: "agent-config",
+    summary: "Set a thread model override.",
+    cli: "dench model thread",
+    method: "PUT",
+    path: "/agent-config/model/threads/{threadId}",
+    requestSchema: anyObject,
+    responseSchema: anyResponse,
+    backend: convex("mutation", "functions/agentConfig:setThreadModelOverride"),
+  }),
+  op({
+    id: "agentConfig.daily.today",
+    group: "agent-config",
+    summary: "Read today's daily activity path.",
+    cli: "dench daily today",
+    method: "GET",
+    path: "/agent-config/daily/today",
+    requestSchema: noBody,
+    responseSchema: anyResponse,
+    backend: convex("query", "functions/agentConfig:getAgentConfig"),
+  }),
+  op({
+    id: "agentConfig.daily.show",
+    group: "agent-config",
+    summary: "Read a daily activity path.",
+    cli: "dench daily show",
+    method: "GET",
+    path: "/agent-config/daily/{date}",
+    requestSchema: noBody,
+    responseSchema: anyResponse,
+    backend: convex("query", "functions/agentConfig:getAgentConfig"),
+  }),
+] as const satisfies readonly ApiOperation[];
+
+/**
+ * Final operation list with deep schemas + backend extras injected from
+ * `api-schemas.ts` by operation id. This keeps the literal above readable
+ * while the parameter-level depth (every field, enum, schedule, etc.)
+ * lives in one schema module shared by the dispatcher, OpenAPI generator,
+ * and curl guide.
+ */
+export const apiOperations: ApiOperation[] = rawApiOperations.map(
+  (operation) => {
+    const requestSchema =
+      requestSchemas[operation.id] ?? operation.requestSchema;
+    const responseSchema =
+      responseSchemas[operation.id] ?? operation.responseSchema;
+    let backend: ApiOperationBackend = operation.backend;
+    if (backend.kind === "convex") {
+      const extras = convexExtras[operation.id];
+      if (extras) backend = { ...backend, ...extras };
+    }
+    return { ...operation, requestSchema, responseSchema, backend };
+  },
+);
+
+export function operationRequiresBearer(operation: ApiOperation): boolean {
+  return (
+    (operation.backend.kind === "convex" &&
+      operation.backend.auth === "bearer") ||
+    (operation.backend.kind === "custom" &&
+      operation.backend.auth === "bearer") ||
+    operation.backend.kind === "gateway"
+  );
+}
+
+export function publicApiOperations(): ApiOperation[] {
+  return apiOperations.filter(
+    (operation) => operation.backend.kind !== "local",
+  );
+}