@honeybee-ai/waggle-cli 1.0.22 → 1.0.24

package/dist/brood.d.ts

@@ -40,7 +40,8 @@ export interface ScheduleEntry {
     action: string;
     config?: Record<string, string>;
 }
-export interface HoneycombConfig {
+/** Per-namespace event routing + trigger config. Canonical key: 'events'. */
+export interface EventsConfig {
     publishes?: string[];
     subscribes?: string[];
     compute?: ComputeTier;
@@ -48,14 +49,19 @@ export interface HoneycombConfig {
     on?: Record<string, string | TriggerActionConfig>;
     schedule?: Record<string, ScheduleEntry>;
 }
+/** @deprecated Use EventsConfig. Kept for backwards compatibility. */
+export type HoneycombConfig = EventsConfig;
 export interface AgentEntry {
     role: string;
-    count?: number;
+    /** Number of agents, or "min-max" range string (e.g. "0-5"). */
+    count?: number | string;
     /** 'worker' = in-process tools (default), 'drone' = MCP tools, 'claude' = Claude Code instance */
     type?: 'worker' | 'drone' | 'claude';
     model_hint?: string;
     /** Custom prompt for claude agents. Overrides the default generic prompt. */
     prompt?: string;
+    /** Path to a Claude Code plugin directory (--plugin-dir). */
+    pluginDir?: string;
     /** Propolis tool names to expose. Omit or 'all' = no filtering. */
     tools?: string[] | 'all';
     /** Incubator tools in no-ACP mode. 'lite'=4 core, 'full'=all, 'none'=zero, or array of names. */
@@ -67,7 +73,8 @@ export interface AgentEntry {
     /** Workspace backend: 'memfs' for in-memory filesystem, 'real' for disk (default). */
     workspace?: 'memfs' | 'real';
 }
-export interface HiveConfig {
+/** Config for a single namespace within a brood. Canonical YAML key: entries under 'hive:'. */
+export interface NamespaceConfig {
     worktree?: string;
     /** ACP spec: file path, URL, or inline spec object. Aliases: 'protocol', 'spec'. */
     acp?: string | Record<string, unknown>;
@@ -75,15 +82,32 @@ export interface HiveConfig {
     protocol?: string | Record<string, unknown>;
     /** @deprecated Use 'acp'. */
     spec?: string | Record<string, unknown>;
+    /** @deprecated Use top-level port. Per-namespace ports removed in single-process model. */
     port?: number;
     /** Dance file path. Aliases: 'logic'. */
     dances?: string;
     /** Agent definitions. Accepts both 'agents' and 'workers' in YAML (alias). */
     agents?: AgentEntry[];
-    /** Cross-hive event routing + triggers. Alias: 'comb'. */
-    honeycomb?: HoneycombConfig;
-    /** @deprecated Use 'honeycomb'. */
-    comb?: HoneycombConfig;
+    /** Per-namespace event routing + triggers. Canonical: 'events'. Aliases: 'honeycomb', 'comb'. */
+    events?: EventsConfig;
+    /** @deprecated Use 'events'. */
+    honeycomb?: EventsConfig;
+    /** @deprecated Use 'events'. */
+    comb?: EventsConfig;
+}
+/** @deprecated Use NamespaceConfig. Kept for backwards compatibility. */
+export type HiveConfig = NamespaceConfig;
+/** Optional hive-level orchestrator. */
+export interface QueenConfig {
+    /** LLM provider for the queen (overrides top-level provider). */
+    provider?: string;
+    /** Instructions: inline markdown string, file path (.md/.js/.ts/.mjs), or array of mixed. */
+    orders?: string | string[];
+}
+/** Hive-wide schedule interval. */
+export interface TopLevelScheduleConfig {
+    /** Duration string: "1h", "30m", "10s", etc. */
+    every: string;
 }
 /** Apiary VPS config for remote shell bridging with memfs agents. */
 export interface ApiaryConfig {
@@ -92,6 +116,33 @@ export interface ApiaryConfig {
     branch?: string;
     setup?: string;
 }
+/** Funnel config — auto-start a funnel alongside the brood. */
+export interface FunnelConfig {
+    /** Colony hive ID to connect to. */
+    hiveId: string;
+    /** Colony URL (default: https://colony.honeyb.dev). */
+    colony?: string;
+    /** Path restriction (default: cwd, false = no scope). */
+    scope?: string | false;
+    /** Dance files to load for custom tools. */
+    dances?: string[];
+    /** One-off "name=command" shell tools. */
+    tools?: string[];
+    /** Per-tool role ACLs (tool name -> allowed roles). */
+    acls?: Record<string, string[]>;
+    /** OpenAPI 3.x spec file paths. */
+    api?: string[];
+    /** Base URL for OpenAPI requests (overrides spec servers[0].url). */
+    apiUrl?: string;
+    /** GraphQL sources — URLs (introspect) or file paths. */
+    graphql?: string[];
+    /** Query endpoint URL (required when graphql source is a file). */
+    graphqlUrl?: string;
+    /** Headers for API requests. Supports ${VAR} env interpolation. */
+    apiHeaders?: string[];
+    /** Labels for routing (key-value pairs). Agents can target funnels by label. */
+    labels?: Record<string, string>;
+}
 export interface BroodConfig {
     name: string;
     version?: string;
@@ -103,14 +154,29 @@ export interface BroodConfig {
     env?: Record<string, string>;
     /** Seconds between each agent spawn (default: 2). Increase for remote providers. */
     stagger?: number;
-    /** Top-level dance file path. Aliases: 'logic'. Per-hive dances override this. */
+    /** Top-level dance file path. Aliases: 'logic'. Per-namespace dances override this. */
     dances?: string;
     /** Apiary VPS config. Secret comes from APIARY_SECRET env var. */
     apiary?: ApiaryConfig;
-    hives: Record<string, HiveConfig>;
+    /** Funnel config — auto-start a funnel connection to Colony. */
+    funnel?: FunnelConfig;
+    /** Optional queen orchestrator. */
+    queen?: QueenConfig;
+    /** Hive-wide schedule interval. */
+    schedule?: TopLevelScheduleConfig;
+    /** Top-level cross-namespace event routing, keyed by namespace name. */
+    events?: Record<string, EventsConfig>;
+    /** Namespace definitions. Canonical key: 'hive'. */
+    hive: Record<string, NamespaceConfig>;
+    /** @deprecated Use 'hive'. Same object reference. */
+    hives: Record<string, NamespaceConfig>;
+    /** @deprecated Use 'events'. Same object reference for top-level honeycomb config. */
+    honeycomb?: Record<string, EventsConfig>;
 }
 /** Parse a duration string ("30s", "15m", "1h", "2h30m") to milliseconds. */
 export declare function parseDuration(str: string): number;
+/** Validate a "min-max" count range string. Returns the string if valid. */
+export declare function parseCountRange(value: string): string;
 /** Find brood file in directory or via explicit path. */
 export declare function findBroodFile(fileArg?: string): string | null;
 /** Parse and validate a brood file. */