broods 0.40.1 → 0.42.0

package/dist/index.d.ts

@@ -8,12 +8,17 @@ declare const AGENT_HOOK_EVENT_NAMES: readonly ["agent.started", "agent.step.fin
 type AgentHookEventName = (typeof AGENT_HOOK_EVENT_NAMES)[number];
 
 /**
- * Every Vercel AI SDK provider that ships language models, plus `custom`
- * (any OpenAI-compatible endpoint) and `minimax`. Image-, speech- and
- * transcription-only providers are deliberately absent: they cannot back
- * `config.model`.
+ * Every Vercel AI SDK provider that ships language models, the community
+ * providers on the same spec that take an API key (`cloudflare`, `llmgateway`,
+ * `ollama`, `openrouter`), and `custom` (any OpenAI-compatible endpoint).
+ * Image-, speech- and transcription-only providers are deliberately absent:
+ * they cannot back `config.model`.
  */
 declare const MODEL_PROVIDERS: {
+    readonly alibaba: {
+        readonly label: "Alibaba Qwen";
+        readonly modelPlaceholder: "qwen3-max";
+    };
     readonly anthropic: {
         readonly label: "Anthropic";
         readonly modelPlaceholder: "claude-sonnet-4-5-20250929";
@@ -34,6 +39,10 @@ declare const MODEL_PROVIDERS: {
         readonly label: "Cerebras";
         readonly modelPlaceholder: "llama3.1-8b";
     };
+    readonly cloudflare: {
+        readonly label: "Cloudflare Workers AI";
+        readonly modelPlaceholder: "@cf/meta/llama-3.3-70b-instruct-fp8-fast";
+    };
     readonly cohere: {
         readonly label: "Cohere";
         readonly modelPlaceholder: "command-a-03-2025";
@@ -62,6 +71,14 @@ declare const MODEL_PROVIDERS: {
         readonly label: "Groq";
         readonly modelPlaceholder: "llama-3.3-70b-versatile";
     };
+    readonly huggingface: {
+        readonly label: "Hugging Face";
+        readonly modelPlaceholder: "meta-llama/Llama-3.3-70B-Instruct";
+    };
+    readonly llmgateway: {
+        readonly label: "LLM Gateway";
+        readonly modelPlaceholder: "openai/gpt-4.1-mini";
+    };
     readonly minimax: {
         readonly label: "MiniMax";
         readonly modelPlaceholder: "MiniMax-M2.7";
@@ -70,13 +87,25 @@ declare const MODEL_PROVIDERS: {
         readonly label: "Mistral";
         readonly modelPlaceholder: "mistral-large-latest";
     };
+    readonly moonshotai: {
+        readonly label: "Moonshot AI Kimi";
+        readonly modelPlaceholder: "kimi-k2.6";
+    };
+    readonly ollama: {
+        readonly label: "Ollama";
+        readonly modelPlaceholder: "gpt-oss:120b";
+    };
     readonly openai: {
         readonly label: "OpenAI";
         readonly modelPlaceholder: "gpt-4.1-mini";
     };
+    readonly openrouter: {
+        readonly label: "OpenRouter";
+        readonly modelPlaceholder: "anthropic/claude-sonnet-4.5";
+    };
     readonly perplexity: {
         readonly label: "Perplexity";
-        readonly modelPlaceholder: "sonar-pro";
+        readonly modelPlaceholder: "low";
     };
     readonly togetherai: {
         readonly label: "Together.ai";
@@ -98,6 +127,10 @@ declare const MODEL_PROVIDERS: {
         readonly label: "xAI Grok";
         readonly modelPlaceholder: "grok-4";
     };
+    readonly zai: {
+        readonly label: "Z.ai GLM";
+        readonly modelPlaceholder: "glm-4.7";
+    };
 };
 type AccountModelProviderName = keyof typeof MODEL_PROVIDERS;
 
@@ -175,6 +208,24 @@ interface AgentConfig {
     allowRunOverrides?: boolean;
     [key: string]: unknown;
 }
+/**
+ * What a code hook reads as ctx.config: the model and the names of what the
+ * agent can use. An allow-list, so no credential field can reach hook code.
+ */
+interface HookAgentConfig {
+    readonly model: {
+        readonly provider?: AccountModelProviderName;
+        readonly modelId?: string;
+    };
+    readonly harness?: AgentHarnessConfig["type"];
+    readonly maxTurn?: number;
+    readonly tools: readonly string[];
+    readonly mcp: readonly string[];
+    readonly channels: readonly string[];
+    readonly skills: readonly string[];
+    readonly subagents: readonly string[];
+    readonly denyTools: readonly string[];
+}
 interface AgentBehaviorConfig {
     maxTurn?: number;
     system?: string | SystemModelMessage | SystemModelMessage[];
@@ -347,12 +398,16 @@ interface AgentMcpEntry {
 }
 interface AgentChannelsConfig {
     telegram?: AgentTelegramChannelConfig;
+    gchat?: AgentGoogleChatChannelConfig;
     github?: AgentGitHubChannelConfig;
     slack?: AgentSlackChannelConfig;
     discord?: AgentDiscordChannelConfig;
     pancake?: AgentPancakeChannelConfig;
+    teams?: AgentTeamsChannelConfig;
+    twilio?: AgentTwilioChannelConfig;
     zalo?: AgentZaloChannelConfig;
     matrix?: AgentMatrixChannelConfig;
+    whatsapp?: AgentWhatsAppChannelConfig;
     [key: string]: unknown;
 }
 /**
@@ -477,6 +532,89 @@ interface AgentZaloChannelConfig {
     partition?: ChannelPartition;
     [key: string]: unknown;
 }
+/**
+ * A Google Chat app on the HTTP endpoint connection. It posts as the service
+ * account in `credentials`, and a webhook is accepted when its Google-signed
+ * token names `endpointUrl` or `googleChatProjectNumber` as the audience.
+ */
+interface AgentGoogleChatChannelConfig {
+    allowedChannelIds?: string[];
+    allowedUserIds?: string[];
+    id?: string;
+    /** The service-account key JSON, as downloaded from Google Cloud. */
+    credentials?: string;
+    /** Audience when the app authenticates with "HTTP endpoint URL". */
+    endpointUrl?: string;
+    /** Audience when the app authenticates with "Project number". */
+    googleChatProjectNumber?: string;
+    /** `service-{projectNumber}@gcp-sa-gsuiteaddons.iam.gserviceaccount.com`, for an app built as a Workspace add-on. */
+    workspaceAddOnServiceAccountEmail?: string;
+    userName?: string;
+    trace?: "enabled" | "disabled";
+    partition?: ChannelPartition;
+    [key: string]: unknown;
+}
+/**
+ * A Microsoft Teams bot registered in Azure Bot Service, authenticated with a
+ * client secret. `appTenantId` is required unless `appType` is `MultiTenant`.
+ */
+interface AgentTeamsChannelConfig {
+    allowedChannelIds?: string[];
+    allowedUserIds?: string[];
+    id?: string;
+    apiUrl?: string;
+    appId?: string;
+    appPassword?: string;
+    appTenantId?: string;
+    appType?: "MultiTenant" | "SingleTenant";
+    userName?: string;
+    trace?: "enabled" | "disabled";
+    partition?: ChannelPartition;
+    [key: string]: unknown;
+}
+/**
+ * A Twilio number or Messaging Service for SMS and MMS. `authToken` checks
+ * Twilio's signature, which covers the exact public URL Twilio called, so
+ * `webhookUrl` is only set when that URL is not the broods webhook URL.
+ */
+interface AgentTwilioChannelConfig {
+    allowedChannelIds?: string[];
+    allowedUserIds?: string[];
+    id?: string;
+    accountSid?: string;
+    apiUrl?: string;
+    authToken?: string;
+    /** `MG...`. Replies go through the service instead of the number texted. */
+    messagingServiceSid?: string;
+    /** E.164 number, e.g. `+15551234567`. Messages to another number go to the agent holding it. */
+    phoneNumber?: string;
+    statusCallbackUrl?: string;
+    userName?: string;
+    /** The URL entered in the Twilio console, when it is not `{PUBLIC_BASE_URL}/v1/webhooks/...`. */
+    webhookUrl?: string;
+    trace?: "enabled" | "disabled";
+    partition?: ChannelPartition;
+    [key: string]: unknown;
+}
+/**
+ * A WhatsApp Business Cloud API number. `appSecret` signs every delivery and
+ * `verifyToken` answers Meta's subscription handshake.
+ */
+interface AgentWhatsAppChannelConfig {
+    allowedChannelIds?: string[];
+    allowedUserIds?: string[];
+    id?: string;
+    accessToken?: string;
+    apiUrl?: string;
+    apiVersion?: string;
+    appSecret?: string;
+    phoneNumberId?: string;
+    userName?: string;
+    verifyToken?: string;
+    trace?: "enabled" | "disabled";
+    partition?: ChannelPartition;
+    [key: string]: unknown;
+}
 
 /**
  * Cron-job records and patch-merge helpers for the runtime. Input
@@ -612,7 +750,7 @@ declare const AGENT_POLICY_ACTIONS: readonly ["agent.invoke", "tool.call", "work
  * resource route. Roles carry the same PolicyDocument shape as agent policies;
  * each caller passes its action set to `normalizePolicyDocument`.
  */
-declare const API_POLICY_ACTIONS: readonly ["account:read", "account:write", "agents:read", "agents:write", "channels:read", "channels:write", "crons:read", "crons:write", "env:read", "env:write", "hooks:read", "hooks:write", "mcp:read", "mcp:write", "policies:read", "policies:write", "sandboxes:read", "sandboxes:write", "skills:read", "skills:write", "tools:read", "tools:write", "workspaces:read", "workspaces:write"];
+declare const API_POLICY_ACTIONS: readonly ["account:read", "account:write", "agents:read", "agents:write", "channels:read", "channels:write", "crons:read", "crons:write", "env:read", "env:write", "hooks:read", "hooks:write", "mcp:read", "mcp:write", "policies:read", "policies:write", "sandboxes:read", "sandboxes:write", "skills:read", "skills:write", "workspaces:read", "workspaces:write"];
 type AgentPolicyAction = (typeof AGENT_POLICY_ACTIONS)[number];
 type ApiPolicyAction = (typeof API_POLICY_ACTIONS)[number];
 type PolicyAction = AgentPolicyAction | ApiPolicyAction;
@@ -674,6 +812,22 @@ interface TelegramSource {
     fromUsername?: string;
 }
 
+/**
+ * Google Chat channel adapter, for a Chat app on an HTTP endpoint. The Chat
+ * SDK adapter is the transport: it verifies Google's signed token, reads the
+ * message and posts the reply as the app's service account. Pub/Sub delivery
+ * is not wired, so the app hears direct messages and @-mentions only.
+ */
+
+interface GoogleChatSource {
+    messageName: string;
+    spaceName: string;
+    threadId: string;
+    threadName?: string;
+    userId?: string;
+    userName?: string;
+}
+
 /**
  * GitHub channel adapter. Event filtering and source mapping live here; auth and
  * API calls go through the Chat SDK.
@@ -763,6 +917,64 @@ interface PancakeSource {
     tagIds?: string[];
 }
 
+/**
+ * Microsoft Teams channel adapter, on the Bot Framework. The Chat SDK adapter
+ * is the transport that reads the activity and posts the reply; the inbound
+ * token is checked with the Teams SDK's JWT validator, set up for Bot Framework
+ * connector tokens only, since the Chat SDK only reaches it through a full
+ * `Chat` instance.
+ */
+
+interface TeamsSource {
+    conversationId: string;
+    messageId: string;
+    threadId: string;
+    userId?: string;
+    userName?: string;
+}
+
+/**
+ * The core HTTP contract every handler speaks, plus generic request/response
+ * helpers. Handlers take a CoreRequest + RequestContext and return a Web
+ * Response; the transport edge (`src/server.ts`) builds the CoreRequest from
+ * a real request. Keep route-specific logic out of here.
+ */
+declare global {
+    interface BunFetchRequestInit {
+        timeout?: number | boolean;
+    }
+}
+
+/**
+ * Twilio channel adapter, for SMS and MMS on a Twilio number or Messaging
+ * Service. The Chat SDK adapter is the transport: it checks Twilio's
+ * signature, reads the form Twilio posts and sends the reply. SMS has no typing
+ * indicator and no reactions, so those actions do nothing.
+ */
+
+interface TwilioSource {
+    /** The person's number, where the reply goes. */
+    from: string;
+    messageSid: string;
+    /** The Twilio number they texted. */
+    to: string;
+}
+
+/**
+ * WhatsApp channel adapter, on the WhatsApp Business Cloud API. The Chat SDK
+ * adapter is the transport: it checks Meta's signature, reads the message and
+ * posts the reply. Meta's GET subscription handshake is answered here too,
+ * because it arrives on the same webhook URL.
+ */
+
+interface WhatsAppSource {
+    messageId: string;
+    phoneNumberId: string;
+    threadId: string;
+    userName?: string;
+    userWaId: string;
+}
+
 /** Zalo channel adapter, on the official Zalo Bot API. */
 
 declare const ZALO_CHAT_TYPES: readonly ["PRIVATE", "GROUP"];
@@ -1018,6 +1230,10 @@ interface AsyncRequestAccepted {
 }
 interface AsyncStatus {
     status: "accepted" | "queued" | "applied" | "processing" | "awaiting_approval" | "awaiting_input" | "completed" | "failed" | "expired" | "not_found";
+    /** Set on every core answer. Absent only on the `not_found` the SDK returns for a 404. */
+    runId?: string;
+    eventId?: string;
+    conversationKey?: string;
     requestedMode?: "reject" | "followup" | "collect" | "steer";
     appliedMode?: "reject" | "followup" | "collect" | "steer";
     appliedToEventId?: string;
@@ -1112,13 +1328,14 @@ type ObservabilitySpanRow = {
     startTimeMs: number;
     endTimeMs: number;
     durationMs: number;
-    status: "running" | "ok" | "error";
+    status: "running" | "waiting" | "needs_input" | "ok" | "error";
     endpointId?: string;
     agentId?: string;
     conversationKey?: string;
     attributes?: Record<string, unknown>;
     error?: string;
 };
+type TaskWaitingOn = "question" | "approval" | "subagent" | "tool";
 type ObservabilitySubscribeMessage = {
     type: "subscribe";
     stream: "logs" | "traces";
@@ -1236,7 +1453,7 @@ interface AgentReference<Name extends string = string> {
 }
 interface ChannelReference {
     readonly kind: "channel";
-    readonly type: "telegram" | "github" | "slack" | "discord" | "matrix" | "pancake" | "zalo";
+    readonly type: "telegram" | "gchat" | "github" | "slack" | "discord" | "matrix" | "pancake" | "teams" | "twilio" | "zalo" | "whatsapp";
     readonly agentName: string;
     readonly agentId: string;
     readonly accountId: string;
@@ -1270,9 +1487,6 @@ type AgentHandle = {
     continue: (input: AgentContinueInput) => Promise<AsyncAgentRun>;
     stream: (input: AgentRunInput) => AsyncGenerator<TextStreamPart<ToolSet>>;
 };
-type CreateClientCronInput = CreateCronInput | (Omit<CreateCronInput, "agentId"> & {
-    agent: AgentReference | string;
-});
 declare class BroodsClient {
     private readonly baseUrl;
     private readonly apiKey?;
@@ -1324,14 +1538,6 @@ declare class BroodsClient {
     getAsyncStatus(status: AsyncRequestAccepted | string): Promise<AsyncStatus>;
     /** Poll async status until it reaches completed, failed, awaiting_approval, awaiting_input, or timeout. */
     waitForAsyncStatus(status: AsyncRequestAccepted | string, options?: AsyncPollOptions): Promise<AsyncStatus>;
-    createCron(input: CreateClientCronInput): Promise<Cron>;
-    listCrons(): Promise<Cron[]>;
-    getCron(cronId: string): Promise<Cron | null>;
-    listCronRuns(cronId: string, options?: {
-        limit?: number;
-    }): Promise<CronRun[]>;
-    updateCron(cronId: string, patch: UpdateCronInput): Promise<Cron>;
-    deleteCron(cronId: string): Promise<boolean>;
     /**
      * Scoped invoke URL for a deployed agent. When codegen embedded the runtime
      * key's scope, this is
@@ -1374,6 +1580,10 @@ declare function normalizeHttpServiceUrl(value: string): string;
  * (`********`) on reads.
  */
 
+/** A config PATCH body: objects merge key by key, `null` deletes a key, arrays and scalars replace. */
+type ConfigPatch<T> = T extends readonly unknown[] ? T : T extends object ? {
+    [K in keyof T]?: ConfigPatch<T[K]> | null;
+} : T;
 interface BroodsAccountClientOptions {
     /** Base URL of the broods gateway. Falls back to `BROODS_BASE_URL`, then `https://gateway.broods.app`. */
     baseUrl?: string;
@@ -1421,7 +1631,7 @@ interface AccountEnvVar {
 interface UpdateAgentInput {
     name?: string;
     description?: string | null;
-    config?: unknown;
+    config?: ConfigPatch<AgentConfig>;
 }
 /** Public workspace record returned by the workspaces routes. */
 interface AccountWorkspace {
@@ -1564,9 +1774,11 @@ interface AccountMcp {
     stageId: string;
     name: string;
     description?: string;
-    transport: "http" | "hosted";
+    transport: "http" | "hosted" | "machine";
     /** External servers only; a hosted row has no endpoint of its own. */
     url?: string;
+    /** Machine servers only: the machine sandbox (by name) whose daemon serves it. */
+    sandbox?: string;
     /** Hosted servers only: content hash of the uploaded bundle. */
     sha256?: string;
     headers?: Record<string, string>;
@@ -1580,12 +1792,14 @@ interface AccountMcp {
 }
 /**
  * Fields accepted by `POST /v1/mcp`: `url` connects, `bundle` uploads inline
- * (≤10 MB); a larger bundle goes through `uploadMcpBundle` first.
+ * (≤10 MB); a larger bundle goes through `uploadMcpBundle` first; `sandbox`
+ * runs it on that machine sandbox's daemon.
  */
 interface CreateMcpInput {
     name: string;
     description?: string;
     url?: string;
+    sandbox?: string;
     bundle?: string;
     bundleStorageId?: string;
     sha256?: string;
@@ -1598,6 +1812,7 @@ interface UpdateMcpInput {
     name?: string;
     description?: string;
     url?: string;
+    sandbox?: string;
     bundle?: string;
     bundleStorageId?: string;
     sha256?: string;
@@ -1707,7 +1922,7 @@ declare class BroodsAccountClient {
     createAgent(input: {
         name: string;
         description?: string;
-        config: unknown;
+        config: AgentConfig;
     }): Promise<CreateAgentResult>;
     getAgent(agentId: string): Promise<AccountAgent | null>;
     /** PATCH an agent. `config` deep-merges into the stored config; `null` leaves delete keys. Returns null when the agent is gone. */
@@ -1732,13 +1947,13 @@ declare class BroodsAccountClient {
     createWorkspace(input: {
         name: string;
         description?: string;
-        config?: unknown;
+        config?: WorkspaceConfig;
     }): Promise<AccountWorkspace>;
     getWorkspace(workspaceId: string): Promise<AccountWorkspace | null>;
     updateWorkspace(workspaceId: string, patch: {
         name?: string;
         description?: string | null;
-        config?: unknown;
+        config?: ConfigPatch<WorkspaceConfig>;
     }): Promise<AccountWorkspace | null>;
     deleteWorkspace(workspaceId: string): Promise<boolean>;
     /** Flat listing of every file in the workspace's S3-backed filesystem. Returns [] when the workspace is gone. */
@@ -1751,22 +1966,22 @@ declare class BroodsAccountClient {
         contentBase64: string;
         contentType?: string;
     }): Promise<WorkspaceFileEntry>;
-    /** Rename a workspace file or folder. Returns false when the workspace or source path is gone. */
-    renameWorkspaceFile(workspaceId: string, path: string, newPath: string): Promise<boolean>;
-    /** Delete a workspace file or folder. Returns false when the workspace or path is gone. */
-    deleteWorkspaceFile(workspaceId: string, path: string): Promise<boolean>;
+    /** Rename a workspace file or folder. Returns how many objects moved; throws when the workspace or source path is gone. */
+    renameWorkspaceFile(workspaceId: string, path: string, newPath: string): Promise<number>;
+    /** Delete a workspace file or folder. Returns how many objects were deleted, 0 when the workspace or path is gone. */
+    deleteWorkspaceFile(workspaceId: string, path: string): Promise<number>;
     listSandboxes(): Promise<AccountSandbox[]>;
     createSandbox(input: {
         name: string;
         description?: string;
-        config?: unknown;
+        config?: SandboxConfig;
     }): Promise<AccountSandbox>;
     getSandbox(sandboxId: string): Promise<AccountSandbox | null>;
-    /** PATCH a sandbox config. `config` fully replaces the stored config. Returns null when the sandbox is gone. */
+    /** PATCH a sandbox config. `config` deep-merges into the stored config; `null` leaves delete keys. Returns null when the sandbox is gone. */
     updateSandbox(sandboxId: string, patch: {
         name?: string;
         description?: string | null;
-        config?: unknown;
+        config?: ConfigPatch<SandboxConfig>;
     }): Promise<AccountSandbox | null>;
     deleteSandbox(sandboxId: string): Promise<boolean>;
     /** Suspend a persistent sandbox reservation. Throws on 404/403/409 (missing sandbox, foreign reservation, or unsupported provider). */
@@ -2090,7 +2305,7 @@ interface McpDefinitionConfig {
     /** Tool names agents may use from this server; omit to allow all. */
     allowedTools?: string[];
 }
-type ChannelType = "telegram" | "github" | "slack" | "discord" | "matrix" | "pancake" | "zalo";
+type ChannelType = "telegram" | "gchat" | "github" | "slack" | "discord" | "matrix" | "pancake" | "teams" | "twilio" | "zalo" | "whatsapp";
 /**
  * A connection is one app install: the credentials an agent needs before a
  * provider can reach it at all. Channels point at a connection; a connection
@@ -2129,28 +2344,36 @@ type ConnectionIdentityInput = {
     allowedUserIds?: readonly string[];
 };
 type TelegramConnectionInput = EnvRefString<RequiredChannelKeys<Pick<AgentTelegramChannelConfig, "apiUrl" | "botToken" | "webhookSecret" | "botUsername" | "reactionEmoji">, "botToken" | "webhookSecret">> & ConnectionIdentityInput;
+type GoogleChatConnectionInput = EnvRefString<RequiredChannelKeys<Pick<AgentGoogleChatChannelConfig, "credentials" | "endpointUrl" | "googleChatProjectNumber" | "userName" | "workspaceAddOnServiceAccountEmail">, "credentials">> & ConnectionIdentityInput;
 type GitHubConnectionInput = EnvRefString<RequiredChannelKeys<Pick<AgentGitHubChannelConfig, "apiUrl" | "webhookSecret" | "appId" | "privateKey" | "botUserName" | "botUserId" | "triggerOnIssueOpen" | "triggerOnPROpen">, "webhookSecret" | "appId" | "privateKey">> & ConnectionIdentityInput;
 type SlackConnectionInput = EnvRefString<RequiredChannelKeys<Pick<AgentSlackChannelConfig, "apiUrl" | "botToken" | "signingSecret" | "reactionEmoji">, "botToken" | "signingSecret">> & ConnectionIdentityInput;
 type DiscordConnectionInput = EnvRefString<RequiredChannelKeys<Pick<AgentDiscordChannelConfig, "apiUrl" | "botToken" | "publicKey" | "botUserId" | "mentionRoleIds">, "botToken" | "publicKey">> & ConnectionIdentityInput;
 type MatrixConnectionInput = EnvRefString<RequiredChannelKeys<Pick<AgentMatrixChannelConfig, "apiUrl" | "botToken" | "botName" | "mentionText">, "apiUrl" | "botToken">> & ConnectionIdentityInput;
+type TeamsConnectionInput = EnvRefString<RequiredChannelKeys<Pick<AgentTeamsChannelConfig, "apiUrl" | "appId" | "appPassword" | "appTenantId" | "appType" | "userName">, "appId" | "appPassword">> & ConnectionIdentityInput;
+type WhatsAppConnectionInput = EnvRefString<RequiredChannelKeys<Pick<AgentWhatsAppChannelConfig, "accessToken" | "apiUrl" | "apiVersion" | "appSecret" | "phoneNumberId" | "userName" | "verifyToken">, "accessToken" | "appSecret" | "phoneNumberId" | "verifyToken">> & ConnectionIdentityInput;
 interface PancakeConnectionInput extends ConnectionIdentityInput {
     pageId: ChannelSecret;
     pageAccessToken: ChannelSecret;
     webhookSecret: ChannelSecret;
     senderId?: string | EnvRef;
 }
+type TwilioConnectionInput = EnvRefString<RequiredChannelKeys<Pick<AgentTwilioChannelConfig, "accountSid" | "apiUrl" | "authToken" | "messagingServiceSid" | "phoneNumber" | "statusCallbackUrl" | "userName" | "webhookUrl">, "accountSid" | "authToken">> & ConnectionIdentityInput;
 interface ZaloConnectionInput extends ConnectionIdentityInput {
     botToken: ChannelSecret;
     webhookSecret: ChannelSecret;
 }
 type TelegramConnectionDefinition = ConnectionDefinition<"telegram", TelegramConnectionInput>;
+type GoogleChatConnectionDefinition = ConnectionDefinition<"gchat", GoogleChatConnectionInput>;
 type GitHubConnectionDefinition = ConnectionDefinition<"github", GitHubConnectionInput>;
 type SlackConnectionDefinition = ConnectionDefinition<"slack", SlackConnectionInput>;
 type DiscordConnectionDefinition = ConnectionDefinition<"discord", DiscordConnectionInput>;
 type MatrixConnectionDefinition = ConnectionDefinition<"matrix", MatrixConnectionInput>;
 type PancakeConnectionDefinition = ConnectionDefinition<"pancake", PancakeConnectionInput>;
+type TeamsConnectionDefinition = ConnectionDefinition<"teams", TeamsConnectionInput>;
+type TwilioConnectionDefinition = ConnectionDefinition<"twilio", TwilioConnectionInput>;
 type ZaloConnectionDefinition = ConnectionDefinition<"zalo", ZaloConnectionInput>;
-type AnyConnectionDefinition = TelegramConnectionDefinition | GitHubConnectionDefinition | SlackConnectionDefinition | DiscordConnectionDefinition | MatrixConnectionDefinition | PancakeConnectionDefinition | ZaloConnectionDefinition;
+type WhatsAppConnectionDefinition = ConnectionDefinition<"whatsapp", WhatsAppConnectionInput>;
+type AnyConnectionDefinition = TelegramConnectionDefinition | GoogleChatConnectionDefinition | GitHubConnectionDefinition | SlackConnectionDefinition | DiscordConnectionDefinition | MatrixConnectionDefinition | PancakeConnectionDefinition | TeamsConnectionDefinition | TwilioConnectionDefinition | ZaloConnectionDefinition | WhatsAppConnectionDefinition;
 /**
  * One real place a team talks: a Slack channel, a Discord channel, a repo. It
  * narrows and adds, and never grants what a bound agent lacks: instructions
@@ -2207,21 +2430,43 @@ type MatrixChannelInput = ChannelRulesInput & {
     /** Matrix room id, e.g. "!abc123:matrix.org". */
     channelId: string;
 };
+type GoogleChatChannelInput = ChannelRulesInput & {
+    connection: GoogleChatConnectionDefinition;
+    /** Google Chat space name, e.g. "spaces/AAAAxxxx". */
+    spaceName: string;
+};
 type GitHubChannelInput = ChannelRulesInput & {
     connection: GitHubConnectionDefinition;
     /** Repository full name, e.g. "beeblast/api". */
     repo: string;
 };
+type TeamsChannelInput = ChannelRulesInput & {
+    connection: TeamsConnectionDefinition;
+    /** Teams channel id, or a chat's conversation id, e.g. "19:abc@thread.tacv2". */
+    channelId: string;
+    /** Team the channel sits in. */
+    teamId?: string;
+};
 type TelegramChannelInput = ChannelRulesInput & {
     connection: TelegramConnectionDefinition;
     /** Telegram chat id, e.g. "-1001234567". */
     chatId: string;
 };
+type TwilioChannelInput = ChannelRulesInput & {
+    connection: TwilioConnectionDefinition;
+    /** Sender's number in E.164, e.g. "+15551234567", or several. */
+    from: string | readonly string[];
+};
 type ZaloChannelInput = ChannelRulesInput & {
     connection: ZaloConnectionDefinition;
     /** Zalo user or group chat id, or several that share one set of rules. */
     chatId: string | readonly string[];
 };
+type WhatsAppChannelInput = ChannelRulesInput & {
+    connection: WhatsAppConnectionDefinition;
+    /** Customer's WhatsApp id, their number with country code and no "+", or several. */
+    waId: string | readonly string[];
+};
 type PancakeChannelInput = ChannelRulesInput & {
     connection: PancakeConnectionDefinition;
     /** Pancake conversation id. */
@@ -2251,7 +2496,8 @@ type AgentSkillsDefinitionConfig = Omit<NonNullable<AgentConfig["skills"]>, "all
 };
 interface HookContext {
     fetch: typeof fetch;
-    config: Record<string, unknown>;
+    /** The model and the names of the agent's tools, MCP servers, channels, skills and subagents. Never credentials. */
+    config: HookAgentConfig;
     /**
      * Mutable per-request scratchpad shared across this agent request's hooks.
      * Seed it in an early hook (e.g. `onStart`) and read or modify it later.
@@ -2269,12 +2515,16 @@ type Handler<Event, Result> = (ctx: HookContext, event: Event) => Result | void
  * Pancake `tagIds`).
  */
 type TelegramMessageSource = TelegramSource;
+type GoogleChatMessageSource = GoogleChatSource;
 type GitHubMessageSource = GitHubSource;
 type SlackMessageSource = SlackSource;
 type DiscordMessageSource = DiscordSource;
 type MatrixMessageSource = MatrixSource;
 type PancakeMessageSource = PancakeSource;
+type TeamsMessageSource = TeamsSource;
+type TwilioMessageSource = TwilioSource;
 type ZaloMessageSource = ZaloSource;
+type WhatsAppMessageSource = WhatsAppSource;
 /**
  * Inbound channel message passed to `onMessageReceived`, discriminated on
  * `channel` so each variant exposes its channel's strongly-typed `source`.
@@ -2283,6 +2533,10 @@ type ChannelMessageReceived = {
     channel: "telegram";
     text: string;
     source: TelegramMessageSource;
+} | {
+    channel: "gchat";
+    text: string;
+    source: GoogleChatMessageSource;
 } | {
     channel: "github";
     text: string;
@@ -2303,10 +2557,22 @@ type ChannelMessageReceived = {
     channel: "pancake";
     text: string;
     source: PancakeMessageSource;
+} | {
+    channel: "teams";
+    text: string;
+    source: TeamsMessageSource;
+} | {
+    channel: "twilio";
+    text: string;
+    source: TwilioMessageSource;
 } | {
     channel: "zalo";
     text: string;
     source: ZaloMessageSource;
+} | {
+    channel: "whatsapp";
+    text: string;
+    source: WhatsAppMessageSource;
 };
 /**
  * Inline agent hook callbacks. Handlers are serialized with `.toString()`,
@@ -2491,21 +2757,29 @@ declare function defineSkill<const Name extends string>(input: ResourceInput<Nam
 declare function defineWorkspace<const Name extends string>(input: ResourceInput<Name, WorkspaceDefinitionConfig>): WorkspaceResource<Name>;
 declare function defineDiscordConnection(config: DiscordConnectionInput): DiscordConnectionDefinition;
 declare function defineGitHubConnection(config: GitHubConnectionInput): GitHubConnectionDefinition;
+declare function defineGoogleChatConnection(config: GoogleChatConnectionInput): GoogleChatConnectionDefinition;
 declare function defineMatrixConnection(config: MatrixConnectionInput): MatrixConnectionDefinition;
 declare function definePancakeConnection(config: PancakeConnectionInput): PancakeConnectionDefinition;
 declare function defineSlackConnection(config: SlackConnectionInput): SlackConnectionDefinition;
+declare function defineTeamsConnection(config: TeamsConnectionInput): TeamsConnectionDefinition;
 declare function defineTelegramConnection(config: TelegramConnectionInput): TelegramConnectionDefinition;
+declare function defineTwilioConnection(config: TwilioConnectionInput): TwilioConnectionDefinition;
+declare function defineWhatsAppConnection(config: WhatsAppConnectionInput): WhatsAppConnectionDefinition;
 declare function defineZaloConnection(config: ZaloConnectionInput): ZaloConnectionDefinition;
 declare function defineDiscordChannel<const Name extends string>(input: ResourceInput<Name, DiscordChannelInput>): ChannelResource<Name>;
 declare function defineGitHubChannel<const Name extends string>(input: ResourceInput<Name, GitHubChannelInput>): ChannelResource<Name>;
+declare function defineGoogleChatChannel<const Name extends string>(input: ResourceInput<Name, GoogleChatChannelInput>): ChannelResource<Name>;
 declare function defineMatrixChannel<const Name extends string>(input: ResourceInput<Name, MatrixChannelInput>): ChannelResource<Name>;
 declare function definePancakeChannel<const Name extends string>(input: ResourceInput<Name, PancakeChannelInput>): ChannelResource<Name>;
 declare function defineSlackChannel<const Name extends string>(input: ResourceInput<Name, SlackChannelInput>): ChannelResource<Name>;
+declare function defineTeamsChannel<const Name extends string>(input: ResourceInput<Name, TeamsChannelInput>): ChannelResource<Name>;
 declare function defineTelegramChannel<const Name extends string>(input: ResourceInput<Name, TelegramChannelInput>): ChannelResource<Name>;
+declare function defineTwilioChannel<const Name extends string>(input: ResourceInput<Name, TwilioChannelInput>): ChannelResource<Name>;
+declare function defineWhatsAppChannel<const Name extends string>(input: ResourceInput<Name, WhatsAppChannelInput>): ChannelResource<Name>;
 declare function defineZaloChannel<const Name extends string>(input: ResourceInput<Name, ZaloChannelInput>): ChannelResource<Name>;
 declare function isBroodsConfig(value: unknown): value is BroodsConfigDefinition;
 declare function isConnectionDefinition(value: unknown): value is AnyConnectionDefinition;
 declare function isResource(value: unknown): value is AnyResource;
 
-export { BroodsAccountApiError, BroodsAccountClient, BroodsClient, BroodsWebSocketClient, DEFAULT_CORE_BASE_URL, IngressAcceptedError, MAX_OBSERVABILITY_BACKFILL, BroodsWebSocketClient as WebSocketClient, BroodsWebSocketClient as WebsocketClient, defineAgent, defineBroods, defineCron, defineDiscordChannel, defineDiscordConnection, defineGitHubChannel, defineGitHubConnection, defineHarness, defineMatrixChannel, defineMatrixConnection, defineMcp, definePancakeChannel, definePancakeConnection, definePolicy, defineSandbox, defineSkill, defineSlackChannel, defineSlackConnection, defineTelegramChannel, defineTelegramConnection, defineWorkspace, defineZaloChannel, defineZaloConnection, env, envPlaceholder, isBroodsConfig, isConnectionDefinition, isLogLevel, isObservabilityClientMessage, isResource, isRootSpanKind, isSandboxLogId, isTraceId, normalizeHttpServiceUrl, readSseStream, resolveEnvCredential, resolveRunEvents, toWebSocketBaseUrl, webSocketSubprotocols };
-export type { Account, AccountAgent, AccountChannel, AccountEnvVar, AccountMcp, AccountPolicy, AccountRole, AccountSandbox, AccountWorkspace, Agent, AgentChannelsConfig, AgentCodeHookConfig, AgentConfig, AgentConfigDoc, AgentContinueInput, AgentDefinitionConfig, AgentDiscordChannelConfig, AgentGitHubChannelConfig, AgentHandle, AgentHookEventName, AgentHooks, AgentHooksConfig, AgentMatrixChannelConfig, AgentPancakeChannelConfig, AgentProviderSettings, AgentReference, AgentResource, AgentRunAnswerInput, AgentRunEventInput, AgentRunInput, AgentRunModelOverrides, AgentRunOverrides, AgentRunResult, AgentSkillsDefinitionConfig, AgentSlackChannelConfig, AgentStreamPart, AgentSubagentDefinitionConfig, AgentTelegramChannelConfig, AgentWebhookHookConfig, AgentWorkspaceInput, AgentWorkspaceRef, AgentWorkspaceRefInput, AgentZaloChannelConfig, AnyConnectionDefinition, AnyResource, AssumeRoleResult, AsyncAgentRun, AsyncPollOptions, AsyncRequestAccepted, AsyncStatus, BroodsAccount, BroodsAccountClientOptions, BroodsClientOptions, BroodsConfigDefinition, BroodsProjectConfig, BroodsWebSocketClientOptions, ChannelAgentInput, ChannelDefinitionConfig, ChannelMessageReceived, ChannelPartition, ChannelRecordConfig, ChannelReference, ChannelReplyIn, ChannelResource, ChannelType, CliManifest, CliManifestResource, ConnectionDefinition, CreateAgentResult, CreateClientCronInput, CreateCronInput, CreateMcpInput, Cron, CronDefinitionConfig, CronDoc, CronLastStatus, CronResource, CronRun, CronStatus, DeleteAccountResult, DiscordChannelInput, DiscordConnectionDefinition, DiscordConnectionInput, DiscordMessageSource, DiscordSource, Doc, EnvAccessor, EnvRef, EnvRefString, GeneratedIds, GitHubChannelInput, GitHubConnectionDefinition, GitHubConnectionInput, GitHubMessageSource, GitHubSource, HarnessDefinition, HarnessType, HookContext, Id, IngressMode, IngressStatus, LogLevel, MatrixChannelInput, MatrixConnectionDefinition, MatrixConnectionInput, MatrixMessageSource, MatrixSource, McpDefinitionConfig, McpHandler, McpOauthInput, McpResource, ObservabilityBackfillMessage, ObservabilityClientMessage, ObservabilityErrorMessage, ObservabilityFetchTraceMessage, ObservabilityLogEntry, ObservabilityLogMessage, ObservabilityReadyMessage, ObservabilityServerMessage, ObservabilitySpanMessage, ObservabilitySpanRow, ObservabilitySubscribeMessage, ObservabilityUnsubscribeMessage, PancakeChannelInput, PancakeConnectionDefinition, PancakeConnectionInput, PancakeMessageSource, PancakeSource, PendingQuestion, PolicyDefinitionConfig, PolicyDocument, PolicyResource, ProjectDoc, ProviderConfigInput, ProviderSettingsInput, QuestionAnswer, ResourceApi, ResourceDefinition, ResourceInput, ResourceKind, RotateSecretResult, Sandbox, SandboxConfig, SandboxConfigDoc, SandboxDefinitionConfig, SandboxDefinitionOptions, SandboxLifecycleResult, SandboxResource, SandboxSnapshotResult, SandboxTerminalTicket, Skill, SkillDefinitionConfig, SkillResource, SkillUploadInput, SlackChannelInput, SlackConnectionDefinition, SlackConnectionInput, SlackMessageSource, SlackSource, StageDoc, StageScope, TelegramChannelInput, TelegramConnectionDefinition, TelegramConnectionInput, TelegramMessageSource, TelegramSource, ToolApprovalSummary, UpdateAgentInput, UpdateCronInput, UpdateMcpInput, WebSocketAttachInput, WebSocketClientAttachMessage, WebSocketClientCancelMessage, WebSocketClientControlMessage, WebSocketClientExecuteMessage, WebSocketClientMessage, WebSocketConstructorLike, WebSocketHandlers, WebSocketLike, WebSocketOutputMessage, WebSocketRunInput, WebSocketServerMessage, WebSocketStreamMessage, WebSocketSubscription, Workspace, WorkspaceConfig, WorkspaceConfigDoc, WorkspaceDefinitionConfig, WorkspaceFileEntry, WorkspaceResource, ZaloChannelInput, ZaloConnectionDefinition, ZaloConnectionInput, ZaloMessageSource, ZaloSource };
+export { BroodsAccountApiError, BroodsAccountClient, BroodsClient, BroodsWebSocketClient, DEFAULT_CORE_BASE_URL, IngressAcceptedError, MAX_OBSERVABILITY_BACKFILL, BroodsWebSocketClient as WebSocketClient, BroodsWebSocketClient as WebsocketClient, defineAgent, defineBroods, defineCron, defineDiscordChannel, defineDiscordConnection, defineGitHubChannel, defineGitHubConnection, defineGoogleChatChannel, defineGoogleChatConnection, defineHarness, defineMatrixChannel, defineMatrixConnection, defineMcp, definePancakeChannel, definePancakeConnection, definePolicy, defineSandbox, defineSkill, defineSlackChannel, defineSlackConnection, defineTeamsChannel, defineTeamsConnection, defineTelegramChannel, defineTelegramConnection, defineTwilioChannel, defineTwilioConnection, defineWhatsAppChannel, defineWhatsAppConnection, defineWorkspace, defineZaloChannel, defineZaloConnection, env, envPlaceholder, isBroodsConfig, isConnectionDefinition, isLogLevel, isObservabilityClientMessage, isResource, isRootSpanKind, isSandboxLogId, isTraceId, normalizeHttpServiceUrl, readSseStream, resolveEnvCredential, resolveRunEvents, toWebSocketBaseUrl, webSocketSubprotocols };
+export type { Account, AccountAgent, AccountChannel, AccountEnvVar, AccountMcp, AccountPolicy, AccountRole, AccountSandbox, AccountWorkspace, Agent, AgentChannelsConfig, AgentCodeHookConfig, AgentConfig, AgentConfigDoc, AgentContinueInput, AgentDefinitionConfig, AgentDiscordChannelConfig, AgentGitHubChannelConfig, AgentGoogleChatChannelConfig, AgentHandle, AgentHookEventName, AgentHooks, AgentHooksConfig, AgentMatrixChannelConfig, AgentPancakeChannelConfig, AgentProviderSettings, AgentReference, AgentResource, AgentRunAnswerInput, AgentRunEventInput, AgentRunInput, AgentRunModelOverrides, AgentRunOverrides, AgentRunResult, AgentSkillsDefinitionConfig, AgentSlackChannelConfig, AgentStreamPart, AgentSubagentDefinitionConfig, AgentTeamsChannelConfig, AgentTelegramChannelConfig, AgentTwilioChannelConfig, AgentWebhookHookConfig, AgentWhatsAppChannelConfig, AgentWorkspaceInput, AgentWorkspaceRef, AgentWorkspaceRefInput, AgentZaloChannelConfig, AnyConnectionDefinition, AnyResource, AssumeRoleResult, AsyncAgentRun, AsyncPollOptions, AsyncRequestAccepted, AsyncStatus, BroodsAccount, BroodsAccountClientOptions, BroodsClientOptions, BroodsConfigDefinition, BroodsProjectConfig, BroodsWebSocketClientOptions, ChannelAgentInput, ChannelDefinitionConfig, ChannelMessageReceived, ChannelPartition, ChannelRecordConfig, ChannelReference, ChannelReplyIn, ChannelResource, ChannelType, CliManifest, CliManifestResource, ConfigPatch, ConnectionDefinition, CreateAgentResult, CreateCronInput, CreateMcpInput, Cron, CronDefinitionConfig, CronDoc, CronLastStatus, CronResource, CronRun, CronStatus, DeleteAccountResult, DiscordChannelInput, DiscordConnectionDefinition, DiscordConnectionInput, DiscordMessageSource, DiscordSource, Doc, EnvAccessor, EnvRef, EnvRefString, GeneratedIds, GitHubChannelInput, GitHubConnectionDefinition, GitHubConnectionInput, GitHubMessageSource, GitHubSource, GoogleChatChannelInput, GoogleChatConnectionDefinition, GoogleChatConnectionInput, GoogleChatMessageSource, GoogleChatSource, HarnessDefinition, HarnessType, HookAgentConfig, HookContext, Id, IngressMode, IngressStatus, LogLevel, MatrixChannelInput, MatrixConnectionDefinition, MatrixConnectionInput, MatrixMessageSource, MatrixSource, McpDefinitionConfig, McpHandler, McpOauthInput, McpResource, ObservabilityBackfillMessage, ObservabilityClientMessage, ObservabilityErrorMessage, ObservabilityFetchTraceMessage, ObservabilityLogEntry, ObservabilityLogMessage, ObservabilityReadyMessage, ObservabilityServerMessage, ObservabilitySpanMessage, ObservabilitySpanRow, ObservabilitySubscribeMessage, ObservabilityUnsubscribeMessage, PancakeChannelInput, PancakeConnectionDefinition, PancakeConnectionInput, PancakeMessageSource, PancakeSource, PendingQuestion, PolicyDefinitionConfig, PolicyDocument, PolicyResource, ProjectDoc, ProviderConfigInput, ProviderSettingsInput, QuestionAnswer, ResourceApi, ResourceDefinition, ResourceInput, ResourceKind, RotateSecretResult, Sandbox, SandboxConfig, SandboxConfigDoc, SandboxDefinitionConfig, SandboxDefinitionOptions, SandboxLifecycleResult, SandboxResource, SandboxSnapshotResult, SandboxTerminalTicket, Skill, SkillDefinitionConfig, SkillResource, SkillUploadInput, SlackChannelInput, SlackConnectionDefinition, SlackConnectionInput, SlackMessageSource, SlackSource, StageDoc, StageScope, TaskWaitingOn, TeamsChannelInput, TeamsConnectionDefinition, TeamsConnectionInput, TeamsMessageSource, TeamsSource, TelegramChannelInput, TelegramConnectionDefinition, TelegramConnectionInput, TelegramMessageSource, TelegramSource, ToolApprovalSummary, TwilioChannelInput, TwilioConnectionDefinition, TwilioConnectionInput, TwilioMessageSource, TwilioSource, UpdateAgentInput, UpdateCronInput, UpdateMcpInput, WebSocketAttachInput, WebSocketClientAttachMessage, WebSocketClientCancelMessage, WebSocketClientControlMessage, WebSocketClientExecuteMessage, WebSocketClientMessage, WebSocketConstructorLike, WebSocketHandlers, WebSocketLike, WebSocketOutputMessage, WebSocketRunInput, WebSocketServerMessage, WebSocketStreamMessage, WebSocketSubscription, WhatsAppChannelInput, WhatsAppConnectionDefinition, WhatsAppConnectionInput, WhatsAppMessageSource, WhatsAppSource, Workspace, WorkspaceConfig, WorkspaceConfigDoc, WorkspaceDefinitionConfig, WorkspaceFileEntry, WorkspaceResource, ZaloChannelInput, ZaloConnectionDefinition, ZaloConnectionInput, ZaloMessageSource, ZaloSource };