broods 0.41.0 → 0.43.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,10 +87,22 @@ 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: "low";
@@ -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,19 @@ interface AgentMcpEntry {
 }
 interface AgentChannelsConfig {
     telegram?: AgentTelegramChannelConfig;
+    gchat?: AgentGoogleChatChannelConfig;
     github?: AgentGitHubChannelConfig;
+    linear?: AgentLinearChannelConfig;
     slack?: AgentSlackChannelConfig;
     discord?: AgentDiscordChannelConfig;
     pancake?: AgentPancakeChannelConfig;
+    teams?: AgentTeamsChannelConfig;
+    twilio?: AgentTwilioChannelConfig;
     zalo?: AgentZaloChannelConfig;
     matrix?: AgentMatrixChannelConfig;
+    instagram?: AgentInstagramChannelConfig;
+    messenger?: AgentMessengerChannelConfig;
+    whatsapp?: AgentWhatsAppChannelConfig;
     [key: string]: unknown;
 }
 /**
@@ -401,6 +459,25 @@ interface AgentGitHubChannelConfig {
     partition?: ChannelPartition;
     [key: string]: unknown;
 }
+/**
+ * A Linear member the agent comments as, through that member's personal API
+ * key. The agent answers comments that mention `@userName` on issues, and
+ * `webhookSecret` checks every delivery.
+ */
+interface AgentLinearChannelConfig {
+    allowedChannelIds?: string[];
+    allowedUserIds?: string[];
+    id?: string;
+    apiKey?: string;
+    /** Linear GraphQL endpoint. Defaults to `https://api.linear.app/graphql`. */
+    apiUrl?: string;
+    /** The member's display name, e.g. `acme-agent`. `@acme-agent` addresses the agent. */
+    userName?: string;
+    webhookSecret?: string;
+    trace?: "enabled" | "disabled";
+    partition?: ChannelPartition;
+    [key: string]: unknown;
+}
 interface AgentSlackChannelConfig {
     id?: string;
     apiUrl?: string;
@@ -477,6 +554,130 @@ interface AgentZaloChannelConfig {
     partition?: ChannelPartition;
     [key: string]: unknown;
 }
+/**
+ * An Instagram professional account, reached through a Meta app with
+ * Instagram Login. `accountId` is the account the webhook entries name.
+ */
+interface AgentInstagramChannelConfig {
+    allowedChannelIds?: string[];
+    allowedUserIds?: string[];
+    id?: string;
+    /** Instagram user access token with `instagram_business_manage_messages`. */
+    accessToken?: string;
+    /** Instagram professional account id. */
+    accountId?: string;
+    /** Graph API version, e.g. `v26.0`. Defaults to the SDK's. */
+    apiVersion?: string;
+    /** Meta app secret; signs every webhook POST. */
+    appSecret?: string;
+    userName?: string;
+    /** The verify token typed into the Meta webhook settings. */
+    verifyToken?: string;
+    trace?: "enabled" | "disabled";
+    partition?: ChannelPartition;
+    [key: string]: unknown;
+}
+/** A Facebook Page the agent answers Messenger DMs for. */
+interface AgentMessengerChannelConfig {
+    allowedChannelIds?: string[];
+    allowedUserIds?: string[];
+    id?: string;
+    /** Graph API version, e.g. `v21.0`. Defaults to the SDK's. */
+    apiVersion?: string;
+    /** Meta app secret; signs every webhook POST. */
+    appSecret?: string;
+    /** Page access token for the Page the app is subscribed to. */
+    pageAccessToken?: string;
+    userName?: string;
+    /** The verify token typed into the Meta webhook settings. */
+    verifyToken?: string;
+    trace?: "enabled" | "disabled";
+    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
@@ -674,6 +875,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.
@@ -691,6 +908,22 @@ interface GitHubSource {
     target: "issue" | "issue_comment" | "pull_request" | "pull_request_review_comment";
 }
 
+/**
+ * Linear channel adapter, for @-mentions in issue comments. The Chat SDK
+ * adapter is the transport: it posts the reply under the comment thread and
+ * reacts to the comment. The signature check is the Linear SDK's webhook
+ * client, the same one the adapter runs. There is no streaming: every edit of
+ * a Linear comment comes back as another webhook delivery.
+ */
+
+interface LinearSource {
+    /** The comment that mentioned the agent, where the reaction goes. */
+    commentId: string;
+    issueId: string;
+    /** `linear:{issueId}:c:{rootCommentId}`: the reply nests under the root comment. */
+    threadId: string;
+}
+
 /** Slack channel adapter. */
 
 interface SlackSource {
@@ -763,6 +996,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"];
@@ -777,6 +1068,45 @@ interface ZaloSource {
     date?: number;
 }
 
+/**
+ * What Messenger and Instagram share. Both deliver Meta Graph webhooks: a GET
+ * subscription handshake answered with the verify token, an
+ * `X-Hub-Signature-256` HMAC over every POST, and one envelope of batched
+ * messaging events whose entries each name the Page or account they are for.
+ * Both reply through a Chat SDK adapter used as transport only. Each channel
+ * file builds its transport and names how the two differ.
+ */
+
+/**
+ * Where a Messenger or Instagram message came from. `recipientId` is the Page
+ * or Instagram professional account that received it; `threadId` is the Chat
+ * SDK thread the reply goes to.
+ */
+interface MetaSource {
+    messageId: string;
+    recipientId: string;
+    senderId: string;
+    threadId: string;
+}
+
+/**
+ * Instagram DM channel adapter, on the Instagram API with Instagram Login. The
+ * Chat SDK adapter reads the message and posts the reply, media included; the
+ * Meta webhook handshake, signature check and event walk are shared with
+ * Messenger in `meta-channel.ts`.
+ */
+
+type InstagramSource = MetaSource;
+
+/**
+ * Facebook Messenger channel adapter, on the Messenger Platform Send API. The
+ * Chat SDK adapter reads the message, posts the reply and names the Page its
+ * token belongs to; the Meta webhook handshake, signature check and event walk
+ * are shared with Instagram in `meta-channel.ts`.
+ */
+
+type MessengerSource = MetaSource;
+
 /**
  * Canonical CLI manifest wire types, the single source of truth shared by the
  * backend (cliSync.ts, cliHttp.ts) and the SDK/CLI (packages/broods).
@@ -1241,7 +1571,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" | "linear" | "slack" | "discord" | "matrix" | "pancake" | "teams" | "twilio" | "zalo" | "whatsapp" | "instagram" | "messenger";
     readonly agentName: string;
     readonly agentId: string;
     readonly accountId: string;
@@ -2093,7 +2423,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" | "linear" | "slack" | "discord" | "matrix" | "pancake" | "teams" | "twilio" | "zalo" | "whatsapp" | "instagram" | "messenger";
 /**
  * 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
@@ -2132,28 +2462,42 @@ 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 LinearConnectionInput = EnvRefString<RequiredChannelKeys<Pick<AgentLinearChannelConfig, "apiKey" | "apiUrl" | "userName" | "webhookSecret">, "apiKey" | "userName" | "webhookSecret">> & 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 InstagramConnectionInput = EnvRefString<RequiredChannelKeys<Pick<AgentInstagramChannelConfig, "accessToken" | "accountId" | "apiVersion" | "appSecret" | "userName" | "verifyToken">, "accessToken" | "accountId" | "appSecret" | "verifyToken">> & ConnectionIdentityInput;
+type MessengerConnectionInput = EnvRefString<RequiredChannelKeys<Pick<AgentMessengerChannelConfig, "apiVersion" | "appSecret" | "pageAccessToken" | "userName" | "verifyToken">, "appSecret" | "pageAccessToken" | "verifyToken">> & ConnectionIdentityInput;
 type TelegramConnectionDefinition = ConnectionDefinition<"telegram", TelegramConnectionInput>;
+type GoogleChatConnectionDefinition = ConnectionDefinition<"gchat", GoogleChatConnectionInput>;
 type GitHubConnectionDefinition = ConnectionDefinition<"github", GitHubConnectionInput>;
+type LinearConnectionDefinition = ConnectionDefinition<"linear", LinearConnectionInput>;
 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 InstagramConnectionDefinition = ConnectionDefinition<"instagram", InstagramConnectionInput>;
+type MessengerConnectionDefinition = ConnectionDefinition<"messenger", MessengerConnectionInput>;
+type WhatsAppConnectionDefinition = ConnectionDefinition<"whatsapp", WhatsAppConnectionInput>;
+type AnyConnectionDefinition = TelegramConnectionDefinition | GoogleChatConnectionDefinition | GitHubConnectionDefinition | LinearConnectionDefinition | SlackConnectionDefinition | DiscordConnectionDefinition | MatrixConnectionDefinition | PancakeConnectionDefinition | TeamsConnectionDefinition | TwilioConnectionDefinition | ZaloConnectionDefinition | WhatsAppConnectionDefinition | InstagramConnectionDefinition | MessengerConnectionDefinition;
 /**
  * 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
@@ -2210,21 +2554,58 @@ 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 LinearChannelInput = ChannelRulesInput & {
+    connection: LinearConnectionDefinition;
+    /** Team key, e.g. "ENG", or several that share one set of rules. */
+    team: string | readonly 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 InstagramChannelInput = ChannelRulesInput & {
+    connection: InstagramConnectionDefinition;
+    /** Instagram-scoped id (IGSID) of the person, or several. */
+    igsid: string | readonly string[];
+};
+type MessengerChannelInput = ChannelRulesInput & {
+    connection: MessengerConnectionDefinition;
+    /** Page-scoped id (PSID) of the person, or several. */
+    psid: 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. */
@@ -2254,7 +2635,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.
@@ -2272,12 +2654,19 @@ type Handler<Event, Result> = (ctx: HookContext, event: Event) => Result | void
  * Pancake `tagIds`).
  */
 type TelegramMessageSource = TelegramSource;
+type GoogleChatMessageSource = GoogleChatSource;
 type GitHubMessageSource = GitHubSource;
+type LinearMessageSource = LinearSource;
 type SlackMessageSource = SlackSource;
 type DiscordMessageSource = DiscordSource;
 type MatrixMessageSource = MatrixSource;
 type PancakeMessageSource = PancakeSource;
+type TeamsMessageSource = TeamsSource;
+type TwilioMessageSource = TwilioSource;
 type ZaloMessageSource = ZaloSource;
+type InstagramMessageSource = InstagramSource;
+type MessengerMessageSource = MessengerSource;
+type WhatsAppMessageSource = WhatsAppSource;
 /**
  * Inbound channel message passed to `onMessageReceived`, discriminated on
  * `channel` so each variant exposes its channel's strongly-typed `source`.
@@ -2286,10 +2675,18 @@ type ChannelMessageReceived = {
     channel: "telegram";
     text: string;
     source: TelegramMessageSource;
+} | {
+    channel: "gchat";
+    text: string;
+    source: GoogleChatMessageSource;
 } | {
     channel: "github";
     text: string;
     source: GitHubMessageSource;
+} | {
+    channel: "linear";
+    text: string;
+    source: LinearMessageSource;
 } | {
     channel: "slack";
     text: string;
@@ -2306,10 +2703,30 @@ 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;
+} | {
+    channel: "instagram";
+    text: string;
+    source: InstagramMessageSource;
+} | {
+    channel: "messenger";
+    text: string;
+    source: MessengerMessageSource;
 };
 /**
  * Inline agent hook callbacks. Handlers are serialized with `.toString()`,
@@ -2494,21 +2911,35 @@ 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 defineInstagramConnection(config: InstagramConnectionInput): InstagramConnectionDefinition;
+declare function defineLinearConnection(config: LinearConnectionInput): LinearConnectionDefinition;
 declare function defineMatrixConnection(config: MatrixConnectionInput): MatrixConnectionDefinition;
+declare function defineMessengerConnection(config: MessengerConnectionInput): MessengerConnectionDefinition;
 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 defineInstagramChannel<const Name extends string>(input: ResourceInput<Name, InstagramChannelInput>): ChannelResource<Name>;
+declare function defineLinearChannel<const Name extends string>(input: ResourceInput<Name, LinearChannelInput>): ChannelResource<Name>;
 declare function defineMatrixChannel<const Name extends string>(input: ResourceInput<Name, MatrixChannelInput>): ChannelResource<Name>;
+declare function defineMessengerChannel<const Name extends string>(input: ResourceInput<Name, MessengerChannelInput>): 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, 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, 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, TaskWaitingOn, 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, defineInstagramChannel, defineInstagramConnection, defineLinearChannel, defineLinearConnection, defineMatrixChannel, defineMatrixConnection, defineMcp, defineMessengerChannel, defineMessengerConnection, 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, AgentInstagramChannelConfig, AgentLinearChannelConfig, AgentMatrixChannelConfig, AgentMessengerChannelConfig, 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, InstagramChannelInput, InstagramConnectionDefinition, InstagramConnectionInput, InstagramMessageSource, InstagramSource, LinearChannelInput, LinearConnectionDefinition, LinearConnectionInput, LinearMessageSource, LinearSource, LogLevel, MatrixChannelInput, MatrixConnectionDefinition, MatrixConnectionInput, MatrixMessageSource, MatrixSource, McpDefinitionConfig, McpHandler, McpOauthInput, McpResource, MessengerChannelInput, MessengerConnectionDefinition, MessengerConnectionInput, MessengerMessageSource, MessengerSource, 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 };