broods 0.12.0 → 0.14.0

package/dist/index.d.ts

@@ -1,19 +1,98 @@
 import { SystemModelMessage, LanguageModelCallOptions, RequestOptions, streamText, JSONSchema7, ModelMessage, TextStreamPart, ToolSet } from 'ai';
 
 /**
- * Supported account model provider names.
- * Keep provider identifiers here so config validation and model resolution share one source.
+ * 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`.
  */
-declare const ACCOUNT_MODEL_PROVIDERS: {
-    readonly google: true;
-    readonly openai: true;
-    readonly anthropic: true;
-    readonly bedrock: true;
-    readonly vercel: true;
-    readonly minimax: true;
-    readonly custom: true;
+declare const MODEL_PROVIDERS: {
+    readonly anthropic: {
+        readonly label: "Anthropic";
+        readonly modelPlaceholder: "claude-sonnet-4-5-20250929";
+    };
+    readonly azure: {
+        readonly label: "Azure OpenAI";
+        readonly modelPlaceholder: "gpt-4.1-mini";
+    };
+    readonly baseten: {
+        readonly label: "Baseten";
+        readonly modelPlaceholder: "deepseek-ai/DeepSeek-V3";
+    };
+    readonly bedrock: {
+        readonly label: "Amazon Bedrock";
+        readonly modelPlaceholder: "anthropic.claude-sonnet-4-5-20250929-v1:0";
+    };
+    readonly cerebras: {
+        readonly label: "Cerebras";
+        readonly modelPlaceholder: "llama3.1-8b";
+    };
+    readonly cohere: {
+        readonly label: "Cohere";
+        readonly modelPlaceholder: "command-a-03-2025";
+    };
+    readonly custom: {
+        readonly label: "Custom OpenAI-compatible";
+        readonly modelPlaceholder: "gpt-oss-120b";
+    };
+    readonly deepinfra: {
+        readonly label: "DeepInfra";
+        readonly modelPlaceholder: "deepseek-ai/DeepSeek-V3";
+    };
+    readonly deepseek: {
+        readonly label: "DeepSeek";
+        readonly modelPlaceholder: "deepseek-chat";
+    };
+    readonly fireworks: {
+        readonly label: "Fireworks";
+        readonly modelPlaceholder: "accounts/fireworks/models/deepseek-v3";
+    };
+    readonly google: {
+        readonly label: "Google";
+        readonly modelPlaceholder: "gemini-2.5-flash";
+    };
+    readonly groq: {
+        readonly label: "Groq";
+        readonly modelPlaceholder: "llama-3.3-70b-versatile";
+    };
+    readonly minimax: {
+        readonly label: "MiniMax";
+        readonly modelPlaceholder: "MiniMax-M2.7";
+    };
+    readonly mistral: {
+        readonly label: "Mistral";
+        readonly modelPlaceholder: "mistral-large-latest";
+    };
+    readonly openai: {
+        readonly label: "OpenAI";
+        readonly modelPlaceholder: "gpt-4.1-mini";
+    };
+    readonly perplexity: {
+        readonly label: "Perplexity";
+        readonly modelPlaceholder: "sonar-pro";
+    };
+    readonly togetherai: {
+        readonly label: "Together.ai";
+        readonly modelPlaceholder: "deepseek-ai/DeepSeek-V3";
+    };
+    readonly v0: {
+        readonly label: "Vercel v0";
+        readonly modelPlaceholder: "v0-1.0-md";
+    };
+    readonly vercel: {
+        readonly label: "Vercel AI Gateway";
+        readonly modelPlaceholder: "openai/gpt-4.1-mini";
+    };
+    readonly vertex: {
+        readonly label: "Google Vertex AI";
+        readonly modelPlaceholder: "gemini-2.5-flash";
+    };
+    readonly xai: {
+        readonly label: "xAI Grok";
+        readonly modelPlaceholder: "grok-4";
+    };
 };
-type AccountModelProviderName = keyof typeof ACCOUNT_MODEL_PROVIDERS;
+type AccountModelProviderName = keyof typeof MODEL_PROVIDERS;
 
 /**
  * Agent policy contracts and validation.
@@ -166,14 +245,6 @@ type AgentModelOutputMetadata = {
     [key: string]: unknown;
 };
 type AgentProviderConfig = Partial<Record<AccountModelProviderName, AgentProviderSettings>>;
-/**
- * Constructor settings for a model provider. The keys are an explicit allow-list
- * (no open index signature) so a misspelled option — most commonly the camel
- * `baseUrl` instead of the canonical `base_url`/`baseURL` — is a compile-time
- * error in the SDK and is caught by `normalizeProviderSettings` at runtime.
- * Keep this list in sync with `normalizeProviderSettings` and the SDK's
- * `KNOWN_PROVIDER_SETTING_KEYS`.
- */
 interface AgentProviderSettings {
     apiKey?: string;
     /** OpenAI-compatible endpoint (`custom`). Snake form, as documented. */
@@ -181,13 +252,11 @@ interface AgentProviderSettings {
     /** OpenAI-compatible endpoint (`custom`). AI-SDK form; the dashboard writes both. */
     baseURL?: string;
     headers?: Record<string, string>;
+    /** Endpoint label; becomes the provider id and the pi harness env prefix. */
+    name?: string;
     organization?: string;
     project?: string;
-    name?: string;
-    region?: string;
-    accessKeyId?: string;
-    secretAccessKey?: string;
-    sessionToken?: string;
+    [key: string]: unknown;
 }
 interface AgentWorkspaceRef {
     name: string;
@@ -876,7 +945,7 @@ type ObservabilitySpanRow = {
     spanId: string;
     parentSpanId?: string;
     name: string;
-    kind: "task" | "subtask" | "model.step" | "tool.call" | "phase";
+    kind: "task" | "cron" | "subtask" | "model.step" | "tool.call" | "phase";
     startTimeMs: number;
     endTimeMs: number;
     durationMs: number;
@@ -921,6 +990,8 @@ type ObservabilityErrorMessage = {
 };
 type ObservabilityServerMessage = ObservabilityReadyMessage | ObservabilityBackfillMessage | ObservabilityLogMessage | ObservabilitySpanMessage | ObservabilityErrorMessage;
 declare function isObservabilityClientMessage(v: unknown): v is ObservabilityClientMessage;
+/** Whether a span is a top-level run, each of which owns its own trace. */
+declare function isRootSpanKind(kind: ObservabilitySpanRow["kind"]): boolean;
 
 /**
  * Configurable client for running deployed agents over direct core SSE.
@@ -1900,26 +1971,18 @@ type AgentPolicyDefinitionConfig = Omit<AgentPolicyConfig, "policyIds"> & {
  * gains a new top-level field that should be code-definable.
  */
 /**
- * SDK-facing model-provider constructor settings. Written as an explicit
- * interface — NOT `EnvRefString<AgentProviderSettings>` — because TypeScript
- * suppresses excess-property checks through mapped types, which would let a
- * typo like the camel `baseUrl` (instead of `base_url`/`baseURL`) slip past
- * `tsc`. Keep the keys in lockstep with core's `AgentProviderSettings`; the
- * `_ProviderKeyParity` assertion below fails `broods check` if they drift.
- * Every string field also accepts an `env("NAME")` reference.
+ * SDK-facing model-provider constructor settings. Open by design: everything a
+ * provider's Vercel AI SDK factory accepts is forwarded verbatim, so there is no
+ * key list to keep in sync. Only the keys broods reads itself are named (and so
+ * typo-checked at run time by `validateProviderConfig`); every string field also
+ * accepts an `env("NAME")` reference.
  */
 interface ProviderSettingsInput {
     apiKey?: string | EnvRef;
     base_url?: string | EnvRef;
     baseURL?: string | EnvRef;
     headers?: Record<string, string | EnvRef>;
-    organization?: string | EnvRef;
-    project?: string | EnvRef;
-    name?: string | EnvRef;
-    region?: string | EnvRef;
-    accessKeyId?: string | EnvRef;
-    secretAccessKey?: string | EnvRef;
-    sessionToken?: string | EnvRef;
+    [key: string]: unknown;
 }
 /** Per-provider settings; provider names stay synced with core's `AgentConfig`. */
 type ProviderConfigInput = Partial<Record<keyof NonNullable<AgentConfig["provider"]>, ProviderSettingsInput>>;
@@ -2021,5 +2084,5 @@ declare function isResource(value: unknown): value is AnyResource;
 declare function isChannelDefinition(value: unknown): value is AnyChannelDefinition;
 declare function isBroodsConfig(value: unknown): value is BroodsConfigDefinition;
 
-export { BroodsAccountApiError, BroodsAccountClient, BroodsClient, BroodsWebSocketClient, DEFAULT_CORE_BASE_URL, IngressAcceptedError, MAX_OBSERVABILITY_BACKFILL, BroodsWebSocketClient as WebSocketClient, BroodsWebSocketClient as WebsocketClient, defineAgent, defineBroods, defineChannelRecord, defineCron, defineDiscordChannel, defineGitHubChannel, defineHarness, definePancakeChannel, definePolicy, defineSandbox, defineSkill, defineSlackChannel, defineTelegramChannel, defineTool, defineWorkspace, defineZaloChannel, env, envPlaceholder, isBroodsConfig, isChannelDefinition, isObservabilityClientMessage, isResource, normalizeHttpServiceUrl, readSseStream, resolveRunEvents, toWebSocketBaseUrl };
+export { BroodsAccountApiError, BroodsAccountClient, BroodsClient, BroodsWebSocketClient, DEFAULT_CORE_BASE_URL, IngressAcceptedError, MAX_OBSERVABILITY_BACKFILL, BroodsWebSocketClient as WebSocketClient, BroodsWebSocketClient as WebsocketClient, defineAgent, defineBroods, defineChannelRecord, defineCron, defineDiscordChannel, defineGitHubChannel, defineHarness, definePancakeChannel, definePolicy, defineSandbox, defineSkill, defineSlackChannel, defineTelegramChannel, defineTool, defineWorkspace, defineZaloChannel, env, envPlaceholder, isBroodsConfig, isChannelDefinition, isObservabilityClientMessage, isResource, isRootSpanKind, normalizeHttpServiceUrl, readSseStream, resolveRunEvents, toWebSocketBaseUrl };
 export type { Account, AccountAgent, AccountChannel, AccountEnvVar, AccountPolicy, AccountSandbox, AccountTool, AccountWorkspace, Agent, AgentChannelWorkspaceScope, AgentChannelsConfig, AgentCodeHookConfig, AgentConfig, AgentConfigDoc, AgentDefinitionConfig, AgentDiscordChannelConfig, AgentGitHubChannelConfig, AgentHandle, AgentHookEventName, AgentHooks, AgentHooksConfig, AgentPancakeChannelConfig, AgentPolicyConfig, AgentPolicyDefinitionConfig, AgentPolicyDocument, AgentProviderSettings, AgentReference, AgentResource, AgentRunEventInput, AgentRunInput, AgentRunModelOverrides, AgentRunOverrides, AgentRunResult, AgentSkillsDefinitionConfig, AgentSlackChannelConfig, AgentStreamPart, AgentSubagentDefinitionConfig, AgentTelegramChannelConfig, AgentWebhookHookConfig, AgentWorkspaceInput, AgentWorkspaceRef, AgentWorkspaceRefInput, AgentZaloChannelConfig, AnyChannelDefinition, AnyResource, AsyncAgentRun, AsyncPollOptions, AsyncRequestAccepted, AsyncStatus, BroodsAccount, BroodsAccountClientOptions, BroodsClientOptions, BroodsConfigDefinition, BroodsProjectConfig, BroodsWebSocketClientOptions, ChannelDefinition, ChannelMessageReceived, ChannelRecordConfig, ChannelRecordDefinitionConfig, ChannelRecordResource, ChannelReference, ChannelType, CliManifest, CliManifestResource, CliResourceKind, CreateAgentResult, CreateClientCronInput, CreateCronInput, CreateToolInput, Cron, CronDefinitionConfig, CronDoc, CronLastStatus, CronResource, CronRun, CronStatus, CustomTool, DeleteAccountResult, DiscordChannelDefinition, DiscordChannelInput, DiscordMessageSource, DiscordSource, Doc, EnvAccessor, EnvRef, EnvRefString, GeneratedIds, GitHubChannelDefinition, GitHubChannelInput, GitHubMessageSource, GitHubSource, HarnessDefinition, HarnessType, HookContext, Id, IngressMode, IngressStatus, LogLevel, ObservabilityBackfillMessage, ObservabilityClientMessage, ObservabilityErrorMessage, ObservabilityLogEntry, ObservabilityLogMessage, ObservabilityReadyMessage, ObservabilityServerMessage, ObservabilitySpanMessage, ObservabilitySpanRow, ObservabilitySubscribeMessage, ObservabilityUnsubscribeMessage, PancakeChannelDefinition, PancakeChannelInput, PancakeMessageSource, PancakeSource, PolicyDefinitionConfig, PolicyResource, ProjectDoc, ProviderConfigInput, ProviderSettingsInput, ResourceApi, ResourceDefinition, ResourceInput, ResourceKind, RotateSecretResult, Sandbox, SandboxConfig, SandboxConfigDoc, SandboxDefinitionConfig, SandboxLifecycleResult, SandboxResource, SandboxSnapshotResult, SandboxTerminalTicket, Skill, SkillDefinitionConfig, SkillResource, SkillUploadInput, SlackChannelDefinition, SlackChannelInput, SlackMessageSource, SlackSource, StageDoc, TelegramChannelDefinition, TelegramChannelInput, TelegramMessageSource, TelegramSource, ToolApprovalSummary, ToolDefinitionConfig, ToolExecuteContext, ToolExecuteOptions, ToolResource, ToolScope, UpdateAgentInput, UpdateCronInput, UpdateToolInput, WebSocketAttachInput, WebSocketClientAttachMessage, WebSocketClientCancelMessage, WebSocketClientControlMessage, WebSocketClientExecuteMessage, WebSocketClientMessage, WebSocketConstructorLike, WebSocketHandlers, WebSocketLike, WebSocketOutputMessage, WebSocketRunInput, WebSocketServerMessage, WebSocketStreamMessage, WebSocketSubscription, Workspace, WorkspaceConfig, WorkspaceConfigDoc, WorkspaceFileEntry, WorkspaceResource, ZaloChannelDefinition, ZaloChannelInput, ZaloMessageSource, ZaloSource };

package/dist/index.js

@@ -1 +1 @@
-import{a as M,b as h,c as O}from"./chunk-ce3yb3yz.js";import{A as q,B as N,C as _,D as P,E as H,F as U,G as B,H as K,I as j,J as F,K as G,L as z,M as Z,N as V,O as X,d as x,e as I,p as v,q as k,r as S,s as A,t as R,u as W,v as L,w,x as E,y as D,z as T}from"./chunk-rr4srzb6.js";import"./chunk-pfhy5049.js";var o=500;function a(s){if(typeof s!=="object"||s===null)return!1;let e=s;if(e.type==="subscribe"){let t=e.stream;if(t!=="logs"&&t!=="traces")return!1;let r=e.backfill;if(r!==void 0&&(typeof r!=="number"||!Number.isSafeInteger(r)||r<0||r>500))return!1;if(e.liveOnly!==void 0&&typeof e.liveOnly!=="boolean")return!1;let n=e.minLevel;if(n!==void 0&&n!=="INFO"&&n!=="WARN"&&n!=="ERROR")return!1;return!0}if(e.type==="unsubscribe"){let t=e.stream;return t==="logs"||t==="traces"}return!1}export{h as BroodsAccountApiError,O as BroodsAccountClient,S as BroodsClient,R as BroodsWebSocketClient,v as DEFAULT_CORE_BASE_URL,k as IngressAcceptedError,o as MAX_OBSERVABILITY_BACKFILL,R as WebSocketClient,R as WebsocketClient,P as defineAgent,_ as defineBroods,G as defineChannelRecord,z as defineCron,T as defineDiscordChannel,E as defineGitHubChannel,H as defineHarness,q as definePancakeChannel,F as definePolicy,B as defineSandbox,K as defineSkill,D as defineSlackChannel,w as defineTelegramChannel,j as defineTool,U as defineWorkspace,N as defineZaloChannel,L as env,M as envPlaceholder,X as isBroodsConfig,V as isChannelDefinition,a as isObservabilityClientMessage,Z as isResource,A as normalizeHttpServiceUrl,I as readSseStream,x as resolveRunEvents,W as toWebSocketBaseUrl};
+import{a as h,b as O,c as R}from"./chunk-ce3yb3yz.js";import{A as N,B as _,C as P,D as H,E as K,F as U,G as B,H as j,I as F,J as G,K as z,L as Z,M as V,N as X,O as Y,d as I,e as v,p as k,q as S,r as A,s as M,t as W,u as L,v as w,w as E,x as D,y as T,z as q}from"./chunk-9v4kpqb1.js";import"./chunk-pfhy5049.js";var o=500;function a(t){if(typeof t!=="object"||t===null)return!1;let e=t;if(e.type==="subscribe"){let r=e.stream;if(r!=="logs"&&r!=="traces")return!1;let n=e.backfill;if(n!==void 0&&(typeof n!=="number"||!Number.isSafeInteger(n)||n<0||n>500))return!1;if(e.liveOnly!==void 0&&typeof e.liveOnly!=="boolean")return!1;let s=e.minLevel;if(s!==void 0&&s!=="INFO"&&s!=="WARN"&&s!=="ERROR")return!1;return!0}if(e.type==="unsubscribe"){let r=e.stream;return r==="logs"||r==="traces"}return!1}function i(t){return t==="task"||t==="cron"||t==="subtask"}export{O as BroodsAccountApiError,R as BroodsAccountClient,A as BroodsClient,W as BroodsWebSocketClient,k as DEFAULT_CORE_BASE_URL,S as IngressAcceptedError,o as MAX_OBSERVABILITY_BACKFILL,W as WebSocketClient,W as WebsocketClient,H as defineAgent,P as defineBroods,z as defineChannelRecord,Z as defineCron,q as defineDiscordChannel,D as defineGitHubChannel,K as defineHarness,N as definePancakeChannel,G as definePolicy,B as defineSandbox,j as defineSkill,T as defineSlackChannel,E as defineTelegramChannel,F as defineTool,U as defineWorkspace,_ as defineZaloChannel,w as env,h as envPlaceholder,Y as isBroodsConfig,X as isChannelDefinition,a as isObservabilityClientMessage,V as isResource,i as isRootSpanKind,M as normalizeHttpServiceUrl,v as readSseStream,I as resolveRunEvents,L as toWebSocketBaseUrl};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "broods",
-  "version": "0.12.0",
+  "version": "0.14.0",
   "description": "CLI + TypeScript SDK for the broods agent platform.",
   "type": "module",
   "license": "MIT",
@@ -33,6 +33,13 @@
       "import": "./dist/account.js"
     }
   },
+  "typesVersions": {
+    "*": {
+      "account": [
+        "./dist/account.d.ts"
+      ]
+    }
+  },
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
   "files": [
@@ -41,9 +48,9 @@
     "LICENSE.md"
   ],
   "scripts": {
-    "build": "bun scripts/build.ts && rollup -c rollup.dts.config.mjs && bun scripts/clean-dts-side-effects.ts && rm -rf .dts-temp",
+    "build": "bun scripts/build.ts && rollup -c rollup.dts.config.mjs && rm -rf .dts-temp",
     "check": "tsc --noEmit",
-    "pack:check": "bun run build && npm pack --dry-run",
+    "pack:check": "bun run build && publint && attw --pack .",
     "test": "bun test"
   },
   "engines": {
@@ -57,14 +64,16 @@
   },
   "devDependencies": {
     "@ai-sdk/tui": "^1.0.59",
-    "ai": "^7.0.58",
+    "@arethetypeswrong/cli": "^0.18.5",
     "@chat-adapter/discord": "^4.35.0",
     "@chat-adapter/github": "^4.35.0",
     "@chat-adapter/slack": "^4.35.0",
     "@chat-adapter/telegram": "^4.35.0",
     "@types/bun": "^1.3.14",
+    "ai": "^7.0.58",
+    "publint": "^0.3.23",
     "rollup": "^4.62.2",
-    "typescript": "^6.0.3",
-    "rollup-plugin-dts": "^6.4.1"
+    "rollup-plugin-dts": "^6.4.1",
+    "typescript": "^6.0.3"
   }
 }