crow-central-agency 0.26.11 → 0.26.13

package/dist/_shared/index.js

@@ -1,11 +1,11 @@
-export { CLAUDE_MODELS, GITHUB_COPILOT_MODELS, CLAUDE_CODE_MODEL_OPTIONS, ModelOptionSchema, REASONING_EFFORT, ReasoningEffortSchema, CLAUDE_DEFAULT_MODEL, COPILOT_DEFAULT_MODEL, AgentIdSchema, AgentConfigSchema, AgentConfigTemplateSchema, CreateAgentInputSchema, UpdateAgentInputSchema, ToolConfigSchema, PermissionModeSchema, SettingSourceSchema, DiscoveredSkillSchema, LoopConfigSchema, ConfiguredFeedSchema, MAX_LOOP_TIMES, PERMISSION_MODE, SETTING_SOURCE, DEFAULT_SETTING_SOURCES, TOOL_MODE, CLAUDE_CODE_TOOL, GITHUB_COPILOT_TOOL, DEFAULT_CLAUDE_CODE_AVAILABLE_TOOLS, DEFAULT_GITHUB_COPILOT_AVAILABLE_TOOLS, DEFAULT_AVAILABLE_TOOLS_BY_TYPE, SUBAGENT_TOOL_NAME, AGENT_TYPE, AgentTypeSchema, DEFAULT_AGENT_TYPE, AGENT_NAME_MAX_LENGTH, } from "./schemas/agent.schema.js";
+export { CLAUDE_MODELS, GITHUB_COPILOT_MODELS, CLAUDE_CODE_MODEL_OPTIONS, ModelOptionSchema, REASONING_EFFORT, ReasoningEffortSchema, THINKING_MODE, CLAUDE_DEFAULT_MODEL, COPILOT_DEFAULT_MODEL, CLAUDE_AUTO_COMPACT_TOKENS_MIN, CLAUDE_AUTO_COMPACT_TOKENS_MAX, COPILOT_AUTO_COMPACT_UTILIZATION_MAX, AgentIdSchema, AgentConfigSchema, AgentConfigTemplateSchema, CreateAgentInputSchema, UpdateAgentInputSchema, ToolConfigSchema, PermissionModeSchema, SettingSourceSchema, DiscoveredSkillSchema, LoopConfigSchema, ConfiguredFeedSchema, MAX_LOOP_TIMES, PERMISSION_MODE, SETTING_SOURCE, DEFAULT_SETTING_SOURCES, TOOL_MODE, CLAUDE_CODE_TOOL, GITHUB_COPILOT_TOOL, DEFAULT_CLAUDE_CODE_AVAILABLE_TOOLS, DEFAULT_GITHUB_COPILOT_AVAILABLE_TOOLS, DEFAULT_AVAILABLE_TOOLS_BY_TYPE, SUBAGENT_TOOL_NAME, AGENT_TYPE, AgentTypeSchema, DEFAULT_AGENT_TYPE, AGENT_NAME_MAX_LENGTH, } from "./schemas/agent.schema.js";
 export { SchedulerTimeSchema, DAY_OF_WEEK, DayOfWeekSchema, TimeModeSchema, TIME_MODE, } from "./schemas/scheduler.schema.js";
 export { createApiSuccessSchema, ApiErrorSchema, } from "./schemas/api-response.schema.js";
 export { SessionUsageSchema, PendingPermissionInfoSchema, PendingInstructionReminderSchema, AgentRuntimeStateSchema, AgentActivitySchema, AGENT_ACTIVITY_TYPE, AGENT_STATUS, MAX_INPUT_HISTORY, } from "./schemas/agent-runtime-state.schema.js";
 export { ClientMessageSchema, ServerMessageSchema, SendMessageSchema, InjectMessageSchema, PermissionResponseWsSchema, CommandMessageSchema, AgentTextWsMessageSchema, AgentActivityWsMessageSchema, AgentResultWsMessageSchema, AgentStatusWsMessageSchema, AgentCreatedWsMessageSchema, AgentUpdatedWsMessageSchema, AgentDeletedWsMessageSchema, AgentUsageWsMessageSchema, PermissionRequestWsMessageSchema, PermissionCancelledWsMessageSchema, ErrorWsMessageSchema, AgentMessageWsMessageSchema, AgentToolProgressWsMessageSchema, TaskAddedWsMessageSchema, TaskUpdatedWsMessageSchema, TaskAssignedWsMessageSchema, TaskStateChangedWsMessageSchema, TaskDeletedWsMessageSchema, CircleCreatedWsMessageSchema, CircleUpdatedWsMessageSchema, CircleDeletedWsMessageSchema, RelationshipCreatedWsMessageSchema, RelationshipDeletedWsMessageSchema, AgentBuilderDraftUpdatedWsMessageSchema, isAgentServerMessage, CLIENT_MESSAGE_TYPE, SERVER_MESSAGE_TYPE, } from "./schemas/websocket.schema.js";
 export { PERMISSION_DECISION, PermissionRequestSchema, PermissionResponseSchema, } from "./schemas/permission.schema.js";
 export { AgentMessageSchema, MessageAnnotationSchema, AGENT_MESSAGE_ROLE, AGENT_MESSAGE_TYPE, } from "./schemas/agent-message.schema.js";
-export { ARTIFACT_TYPE, ARTIFACT_CONTENT_TYPE, ArtifactTypeSchema, ArtifactContentTypeSchema, ArtifactMetadataSchema, ArtifactTagsUpdateSchema, } from "./schemas/artifact.schema.js";
+export { ARTIFACT_TYPE, ARTIFACT_CONTENT_TYPE, ArtifactTypeSchema, ArtifactContentTypeSchema, ArtifactMetadataSchema, ArtifactUpdateSchema, } from "./schemas/artifact.schema.js";
 export { AGENT_TASK_STATE, AGENT_TASK_SOURCE_TYPE, AgentTaskStateSchema, AgentTaskSourceSchema, AgentTaskItemSchema, AgentTaskDatabaseSchema, CreateTaskInputSchema, UpdateTaskInputSchema, UpdateTaskStateInputSchema, AssignTaskInputSchema, } from "./schemas/agent-task.schema.js";
 export { MCP_CONFIG_TYPE, InternalMcpConfigSchema, McpServerConfigSchema, CreateMcpConfigInputSchema, UpdateMcpConfigInputSchema, } from "./schemas/mcp-config.schema.js";
 export { SensorInfoSchema } from "./schemas/sensor.schema.js";
@@ -16,7 +16,7 @@ export { SystemCapabilitiesSchema } from "./schemas/system-capabilities.schema.j
 export { GENERATION_TYPE, GenerationTypeSchema, GenerateRequestSchema, } from "./schemas/generation.schema.js";
 export { AGENT_BUILDER_LIMITS, AGENT_BUILDER_WORD_BUDGET, AGENT_BUILDER_DRAFT_STATUS, AgentBuilderDraftStatusSchema, AgentBuilderBuiltAgentSchema, AgentBuilderBuildResultSchema, FleetAgentSchema, FleetResponseSchema, AgentBuilderDraftSchema, AgentBuilderDesignRequestSchema, AgentBuilderPatchRequestSchema, FleetNamedRefSchema, FleetAgentViewSchema, AgentBuilderDraftViewSchema, AgentBuilderDraftResponseSchema, AgentBuilderDraftMutationResponseSchema, } from "./schemas/agent-builder.schema.js";
 export { applyAgentOrder } from "./utils/apply-agent-order.js";
-export { MODEL_ALIASES, resolveModel } from "./utils/resolve-model.js";
+export { MODEL_ALIASES, resolveModel, modelSupportsAdaptiveThinking } from "./utils/resolve-model.js";
 export { BASE_CIRCLE_ID, BASE_CIRCLE_NAME } from "./constants/system-circle.js";
 export { ENTITY_TYPE, RELATIONSHIP_TYPE, AgentCircleSchema, CreateAgentCircleInputSchema, UpdateAgentCircleInputSchema, EntityTypeSchema, RelationshipTypeSchema, RelationshipSchema, CreateRelationshipInputSchema, CircleMemberSchema, } from "./schemas/agent-circle.schema.js";
 export { CROW_SYSTEM_AGENT_ID, CROW_TASK_DISPATCHER_AGENT_ID, CROW_NARRATIVE_ARCHITECT_AGENT_ID, CROW_WORLD_BUILDER_AGENT_ID, } from "./constants/system-agent.js";

package/dist/_shared/schemas/agent.schema.js

@@ -37,23 +37,37 @@ export const ReasoningEffortSchema = z.enum([
     REASONING_EFFORT.XHIGH,
     REASONING_EFFORT.MAX,
 ]);
+export const THINKING_MODE = {
+    ENABLED: "enabled",
+    DISABLED: "disabled",
+    ADAPTIVE: "adaptive",
+};
+export const ThinkingModeSchema = z.enum([THINKING_MODE.ENABLED, THINKING_MODE.DISABLED, THINKING_MODE.ADAPTIVE]);
+/** Extended-thinking control for Claude Code agents; budget applies only to `enabled` mode. */
+export const AgentThinkingConfigSchema = z.object({
+    mode: ThinkingModeSchema,
+    budget: z.number().int().positive().optional(),
+});
 /** A selectable agent model, surfaced to the editor's model picker. */
 export const ModelOptionSchema = z.object({
     value: z.string(),
     label: z.string(),
     /** Reasoning effort levels the model supports; omitted when the model has no effort control. */
     supportedEfforts: z.array(ReasoningEffortSchema).optional(),
+    supportsAdaptiveThinking: z.boolean().optional(),
 });
 export const CLAUDE_CODE_MODEL_OPTIONS = [
     {
         value: CLAUDE_MODELS.SONNET,
         label: "Claude Sonnet 5",
         supportedEfforts: [REASONING_EFFORT.LOW, REASONING_EFFORT.MEDIUM, REASONING_EFFORT.HIGH, REASONING_EFFORT.MAX],
+        supportsAdaptiveThinking: true,
     },
     {
         value: CLAUDE_MODELS.SONNET_4_6,
         label: "Claude Sonnet 4.6",
         supportedEfforts: [REASONING_EFFORT.LOW, REASONING_EFFORT.MEDIUM, REASONING_EFFORT.HIGH, REASONING_EFFORT.MAX],
+        supportsAdaptiveThinking: true,
     },
     {
         value: CLAUDE_MODELS.OPUS,
@@ -65,6 +79,7 @@ export const CLAUDE_CODE_MODEL_OPTIONS = [
             REASONING_EFFORT.XHIGH,
             REASONING_EFFORT.MAX,
         ],
+        supportsAdaptiveThinking: true,
     },
     {
         value: CLAUDE_MODELS.OPUS_4_7,
@@ -76,6 +91,7 @@ export const CLAUDE_CODE_MODEL_OPTIONS = [
             REASONING_EFFORT.XHIGH,
             REASONING_EFFORT.MAX,
         ],
+        supportsAdaptiveThinking: true,
     },
     { value: CLAUDE_MODELS.HAIKU, label: "Claude Haiku 4.5" },
     {
@@ -88,6 +104,7 @@ export const CLAUDE_CODE_MODEL_OPTIONS = [
             REASONING_EFFORT.XHIGH,
             REASONING_EFFORT.MAX,
         ],
+        supportsAdaptiveThinking: true,
     },
 ];
 /** Default model for new agents */
@@ -277,6 +294,23 @@ export const AgentVoiceConfigSchema = z.object({
     voiceName: z.string().optional(),
     stylePrompt: z.string().optional(),
 });
+/**
+ * Bounds the Claude Code SDK enforces on its auto-compact window (`int().min(1e5).max(1e6)`);
+ * out-of-range values are silently dropped by the SDK, so we validate against the same range.
+ */
+export const CLAUDE_AUTO_COMPACT_TOKENS_MIN = 100000;
+export const CLAUDE_AUTO_COMPACT_TOKENS_MAX = 1000000;
+/** GitHub Copilot's background-compaction threshold is a fraction (0-1) of the context window. */
+export const COPILOT_AUTO_COMPACT_UTILIZATION_MAX = 1;
+/**
+ * Manual auto-compaction thresholds. `tokensThreshold` drives Claude Code (context token count),
+ * `utilizationThreshold` drives GitHub Copilot (0-1 fraction of the context window). Each provider
+ * reads only its own field; an unset config leaves the provider's default behavior in place.
+ */
+export const ContextAutoCompactionConfigSchema = z.object({
+    tokensThreshold: z.number().int().min(CLAUDE_AUTO_COMPACT_TOKENS_MIN).max(CLAUDE_AUTO_COMPACT_TOKENS_MAX).optional(),
+    utilizationThreshold: z.number().positive().max(COPILOT_AUTO_COMPACT_UTILIZATION_MAX).optional(),
+});
 /**
  * Full agent configuration - persisted to disk in agents.json
  */
@@ -289,6 +323,8 @@ export const AgentConfigSchema = z.object({
     persona: z.string().optional(),
     model: z.string().default(CLAUDE_DEFAULT_MODEL),
     effort: ReasoningEffortSchema.optional(),
+    thinkingConfig: AgentThinkingConfigSchema.optional(),
+    contextAutoCompactionConfig: ContextAutoCompactionConfigSchema.optional(),
     permissionMode: PermissionModeSchema.default(PERMISSION_MODE.DEFAULT),
     settingSources: z.array(SettingSourceSchema).default([...DEFAULT_SETTING_SOURCES]),
     settingSourceConfig: SettingSourceConfigSchema.optional(),
@@ -323,6 +359,8 @@ export const CreateAgentInputSchema = z.object({
     persona: z.string().optional(),
     model: z.string().optional(),
     effort: ReasoningEffortSchema.optional(),
+    thinkingConfig: AgentThinkingConfigSchema.optional(),
+    contextAutoCompactionConfig: ContextAutoCompactionConfigSchema.optional(),
     permissionMode: PermissionModeSchema.optional(),
     settingSources: z.array(SettingSourceSchema).optional(),
     settingSourceConfig: SettingSourceConfigInputSchema.optional(),
@@ -346,8 +384,9 @@ export const UpdateAgentInputSchema = z.object({
     workspace: z.string().optional(),
     persona: z.string().optional(),
     model: z.string().optional(),
-    // null explicitly clears the effort (back to provider default); undefined leaves it unchanged.
     effort: ReasoningEffortSchema.nullish(),
+    thinkingConfig: AgentThinkingConfigSchema.nullish(),
+    contextAutoCompactionConfig: ContextAutoCompactionConfigSchema.nullish(),
     permissionMode: PermissionModeSchema.optional(),
     settingSources: z.array(SettingSourceSchema).optional(),
     settingSourceConfig: SettingSourceConfigInputSchema.optional(),
@@ -370,6 +409,8 @@ export const AgentConfigTemplateSchema = AgentConfigSchema.pick({
     persona: true,
     model: true,
     effort: true,
+    thinkingConfig: true,
+    contextAutoCompactionConfig: true,
     permissionMode: true,
     settingSources: true,
     availableTools: true,

package/dist/_shared/schemas/artifact.schema.js

@@ -49,11 +49,32 @@ export const ArtifactMetadataSchema = z.object({
     createdBy: AgentTaskSourceSchema,
 });
 /**
- * Request body for updating an artifact's tags. Applies a remove-then-add delta to the
- * current tag set; at least one of addTags/removeTags must be non-empty.
+ * Request body for a PATCH artifact update. Tag changes apply a remove-then-add delta to the current
+ * set; `content` replaces the raw text. `expectedUpdatedTimestamp` guards against clobbering a
+ * concurrent edit — the update is rejected with a conflict when it no longer matches the stored
+ * timestamp. At least one of addTags/removeTags/content must be present, and a content replacement
+ * must carry the expected timestamp.
  */
-export const ArtifactTagsUpdateSchema = z.object({
+export const ArtifactUpdateSchema = z
+    .object({
     addTags: z.array(z.string()).optional(),
     removeTags: z.array(z.string()).optional(),
+    content: z.string().optional(),
+    expectedUpdatedTimestamp: z.number().optional(),
+})
+    .superRefine((update, ctx) => {
+    if ((update.addTags?.length ?? 0) === 0 && (update.removeTags?.length ?? 0) === 0 && update.content === undefined) {
+        ctx.addIssue({
+            code: "custom",
+            message: "At least one of addTags, removeTags, or content is required",
+        });
+    }
+    if (update.content !== undefined && update.expectedUpdatedTimestamp === undefined) {
+        ctx.addIssue({
+            code: "custom",
+            message: "expectedUpdatedTimestamp is required when content is provided",
+            path: ["expectedUpdatedTimestamp"],
+        });
+    }
 });
 //# sourceMappingURL=artifact.schema.js.map

package/dist/_shared/utils/resolve-model.js

@@ -1,4 +1,4 @@
-import { CLAUDE_MODELS } from "../schemas/agent.schema.js";
+import { CLAUDE_CODE_MODEL_OPTIONS, CLAUDE_MODELS, } from "../schemas/agent.schema.js";
 /**
  * Maps retired model IDs to their successor.
  */
@@ -12,4 +12,9 @@ export const COPILOT_MODEL_ALIASES = {};
 export function resolveModel(model) {
     return MODEL_ALIASES[model] ?? COPILOT_MODEL_ALIASES[model] ?? model;
 }
+/** Whether a Claude model supports adaptive thinking, resolving retired IDs to their successor. */
+export function modelSupportsAdaptiveThinking(model) {
+    const resolved = resolveModel(model);
+    return CLAUDE_CODE_MODEL_OPTIONS.find((option) => option.value === resolved)?.supportsAdaptiveThinking ?? false;
+}
 //# sourceMappingURL=resolve-model.js.map

package/dist/mcp/gmail/create-gmail-draft.js

@@ -1,6 +1,6 @@
 import { z } from "zod";
 import { RequestError } from "../../core/error/request-error.js";
-import { GOOGLE_SERVICE_NAME } from "../../services/google/google-client.types.js";
+import { EMAIL_BODY_FORMAT, GOOGLE_SERVICE_NAME } from "../../services/google/google-client.types.js";
 import { getErrorToolResult, textToolResult } from "../tool-utils.js";
 export const CREATE_GMAIL_DRAFT_TOOL_NAME = "create_gmail_draft";
 export function getCreateGmailDraftToolConfig(googleClient) {
@@ -20,7 +20,11 @@ export function getCreateGmailDraftToolConfig(googleClient) {
         cc: z.array(z.string()).optional().describe("New-draft mode: optional Cc recipients."),
         bcc: z.array(z.string()).optional().describe("New-draft mode: optional Bcc recipients."),
         subject: z.string().optional().describe("New-draft mode: subject line. Required without parentMessageId."),
-        body: z.string().min(1).describe("Draft body in markdown."),
+        body: z.string().min(1).describe('Draft body. Defaults to markdown; pass raw HTML when bodyFormat is "html".'),
+        bodyFormat: z
+            .enum([EMAIL_BODY_FORMAT.MARKDOWN, EMAIL_BODY_FORMAT.HTML])
+            .optional()
+            .describe('Body format. Defaults to "markdown"; set to "html" to supply raw HTML.'),
     };
     const handler = async (args) => {
         try {
@@ -28,6 +32,7 @@ export function getCreateGmailDraftToolConfig(googleClient) {
                 const result = await googleClient.createGmailReplyDraft({
                     parentMessageId: args.parentMessageId,
                     body: args.body,
+                    bodyFormat: args.bodyFormat,
                     replyAll: args.replyAll,
                 });
                 return textToolResult([
@@ -46,6 +51,7 @@ export function getCreateGmailDraftToolConfig(googleClient) {
                 bcc: args.bcc,
                 subject: args.subject,
                 body: args.body,
+                bodyFormat: args.bodyFormat,
             });
             return textToolResult([
                 "Draft created.",
@@ -60,7 +66,7 @@ export function getCreateGmailDraftToolConfig(googleClient) {
     };
     const config = {
         name: CREATE_GMAIL_DRAFT_TOOL_NAME,
-        description: "Create a draft email in the Drafts folder. Two modes: new draft or reply draft (parentMessageId required, recipients/subject/threading derived from parent, replyAll optional). Body is markdown.",
+        description: 'Create a draft email in the Drafts folder. Two modes: new draft or reply draft (parentMessageId required, recipients/subject/threading derived from parent, replyAll optional). Body defaults to markdown; set bodyFormat to "html" to supply raw HTML.',
         inputSchema,
         handler,
     };

package/dist/mcp/gmail/reply-to-gmail-message.js

@@ -1,4 +1,5 @@
 import { z } from "zod";
+import { EMAIL_BODY_FORMAT } from "../../services/google/google-client.types.js";
 import { getErrorToolResult, textToolResult } from "../tool-utils.js";
 export const REPLY_TO_GMAIL_MESSAGE_TOOL_NAME = "reply_to_gmail_message";
 export function getReplyToGmailMessageToolConfig(googleClient) {
@@ -6,10 +7,11 @@ export function getReplyToGmailMessageToolConfig(googleClient) {
         messageId: z
             .string()
             .describe("ID of the message being replied to (from list_gmail_messages or get_gmail_thread). Recipients, subject, and threading headers are derived from this parent."),
-        body: z
-            .string()
-            .min(1)
-            .describe("Reply body in markdown. Recipients will receive both a plain-text version (the markdown source) and an HTML version (rendered)."),
+        body: z.string().min(1).describe('Reply body. Defaults to markdown; pass raw HTML when bodyFormat is "html".'),
+        bodyFormat: z
+            .enum([EMAIL_BODY_FORMAT.MARKDOWN, EMAIL_BODY_FORMAT.HTML])
+            .optional()
+            .describe('Body format. Defaults to "markdown"; set to "html" to supply raw HTML.'),
         replyAll: z
             .boolean()
             .optional()
@@ -20,6 +22,7 @@ export function getReplyToGmailMessageToolConfig(googleClient) {
             const result = await googleClient.replyToGmailMessage({
                 parentMessageId: args.messageId,
                 body: args.body,
+                bodyFormat: args.bodyFormat,
                 replyAll: args.replyAll,
             });
             return textToolResult(["Reply sent.", `Message ID: ${result.id}`, `Thread ID: ${result.threadId}`]);
@@ -30,7 +33,7 @@ export function getReplyToGmailMessageToolConfig(googleClient) {
     };
     const config = {
         name: REPLY_TO_GMAIL_MESSAGE_TOOL_NAME,
-        description: "Reply to a Gmail message by ID. Recipients (To/Cc), subject (Re: prefix), and threading headers (In-Reply-To, References, threadId) are all derived from the parent - you only supply the body and an optional replyAll flag. Body is markdown; sent as multipart/alternative.",
+        description: 'Reply to a Gmail message by ID. Recipients (To/Cc), subject (Re: prefix), and threading headers (In-Reply-To, References, threadId) are all derived from the parent - you only supply the body and an optional replyAll flag. Body defaults to markdown; set bodyFormat to "html" to supply raw HTML.',
         inputSchema,
         handler,
     };

package/dist/mcp/gmail/send-gmail-message.js

@@ -1,4 +1,5 @@
 import { z } from "zod";
+import { EMAIL_BODY_FORMAT } from "../../services/google/google-client.types.js";
 import { getErrorToolResult, textToolResult } from "../tool-utils.js";
 export const SEND_GMAIL_MESSAGE_TOOL_NAME = "send_gmail_message";
 export function getSendGmailMessageToolConfig(googleClient) {
@@ -10,10 +11,11 @@ export function getSendGmailMessageToolConfig(googleClient) {
         cc: z.array(z.string()).optional().describe("Optional Cc recipients (same address format as 'to')."),
         bcc: z.array(z.string()).optional().describe("Optional Bcc recipients (same address format as 'to')."),
         subject: z.string().min(1).describe("Email subject line."),
-        body: z
-            .string()
-            .min(1)
-            .describe("Email body in markdown. Recipients will receive both a plain-text version (the markdown source) and an HTML version (rendered)."),
+        body: z.string().min(1).describe('Email body. Defaults to markdown; pass raw HTML when bodyFormat is "html".'),
+        bodyFormat: z
+            .enum([EMAIL_BODY_FORMAT.MARKDOWN, EMAIL_BODY_FORMAT.HTML])
+            .optional()
+            .describe('Body format. Defaults to "markdown"; set to "html" to supply raw HTML.'),
     };
     const handler = async (args) => {
         try {
@@ -23,6 +25,7 @@ export function getSendGmailMessageToolConfig(googleClient) {
                 bcc: args.bcc,
                 subject: args.subject,
                 body: args.body,
+                bodyFormat: args.bodyFormat,
             });
             return textToolResult(["Message sent.", `Message ID: ${result.id}`, `Thread ID: ${result.threadId}`]);
         }
@@ -32,7 +35,7 @@ export function getSendGmailMessageToolConfig(googleClient) {
     };
     const config = {
         name: SEND_GMAIL_MESSAGE_TOOL_NAME,
-        description: "Send a new email via the connected Google account. Body is provided as markdown and delivered as multipart/alternative (text/plain + text/html). For replies, use reply_to_gmail_message instead so threading headers are set correctly.",
+        description: 'Send a new email via the connected Google account. Body defaults to markdown; set bodyFormat to "html" to supply raw HTML. For replies, use reply_to_gmail_message instead so threading headers are set correctly.',
         inputSchema,
         handler,
     };

package/dist/mcp/gmail/update-gmail-draft.js

@@ -1,4 +1,5 @@
 import { z } from "zod";
+import { EMAIL_BODY_FORMAT } from "../../services/google/google-client.types.js";
 import { getErrorToolResult, textToolResult } from "../tool-utils.js";
 export const UPDATE_GMAIL_DRAFT_TOOL_NAME = "update_gmail_draft";
 export function getUpdateGmailDraftToolConfig(googleClient) {
@@ -8,7 +9,14 @@ export function getUpdateGmailDraftToolConfig(googleClient) {
         cc: z.array(z.string()).optional().describe("Replaces Cc; preserved if omitted."),
         bcc: z.array(z.string()).optional().describe("Replaces Bcc; preserved if omitted."),
         subject: z.string().optional().describe("Replaces subject; preserved if omitted."),
-        body: z.string().optional().describe("Markdown. Replaces body; preserved if omitted."),
+        body: z
+            .string()
+            .optional()
+            .describe('Replaces body; preserved if omitted. Defaults to markdown; pass raw HTML when bodyFormat is "html".'),
+        bodyFormat: z
+            .enum([EMAIL_BODY_FORMAT.MARKDOWN, EMAIL_BODY_FORMAT.HTML])
+            .optional()
+            .describe('Body format for `body`; only meaningful when body is also provided. Defaults to "markdown"; set to "html" to supply raw HTML.'),
     };
     const handler = async (args) => {
         try {
@@ -19,6 +27,7 @@ export function getUpdateGmailDraftToolConfig(googleClient) {
                 bcc: args.bcc,
                 subject: args.subject,
                 body: args.body,
+                bodyFormat: args.bodyFormat,
             });
             return textToolResult([
                 "Draft updated.",