@bubblebrain-ai/bubble 0.0.52 → 0.0.54

package/README.md

@@ -8,16 +8,9 @@ It is provider-agnostic. Bring an API key for OpenAI, Anthropic, Google, DeepSee
 
 ## Requirements
 
-- Node.js 20 or newer (used to install the launcher)
-- [Bun](https://bun.sh) (used to run the agent)
+- Node.js 22.19 or newer — Bubble's only runtime
 
-Install Bun if you do not already have it:
-
-```bash
-curl -fsSL https://bun.sh/install | bash
-```
-
-The `npm install` step puts a small Node.js launcher named `bubble` on your PATH. When you run `bubble`, the launcher locates Bun and starts the real runtime under it. If Bun is missing, it prints the install command above instead of failing with a low-level error.
+The `npm install` step puts the `bubble` CLI on your PATH. When you run `bubble`, it starts directly on your Node.js runtime; no other runtime is required.
 
 ## Install
 
@@ -33,8 +26,7 @@ Windows (PowerShell):
 powershell -c "irm https://raw.githubusercontent.com/DylanDDeng/bubble/main/install.ps1 | iex"
 ```
 
-The installer checks for Node.js 20+ and Bun (installing Bun for you if it is
-missing), then installs the `bubble` CLI globally via npm.
+The installer checks for Node.js 22.19+, then installs the `bubble` CLI globally via npm.
 
 Or install directly via npm:
 
@@ -281,7 +273,7 @@ NODE_EXTRA_CA_CERTS=/absolute/path/to/ca.pem bubble
 ## Development
 
 ```bash
-bun install        # install dependencies
+npm install         # install dependencies
 npm run build      # compile TypeScript to dist/
 npm test           # run the test suite (vitest)
 npm start          # run the built agent

package/dist/agent/routing-catalog.js

@@ -10,6 +10,7 @@
  */
 import { getBuiltinModel, listBuiltinModels, listDynamicModelMetadata, } from "../model-catalog.js";
 import { mergeAgentCategoriesWithProvenance, resolveSubagentRoute, selectTierCandidates, } from "./categories.js";
+import { filterProviderModels } from "../provider-model-policy.js";
 export const DEFAULT_AGENT_ROUTING = {
     autoTier: true,
     allowCrossProvider: true,
@@ -39,7 +40,7 @@ export function buildRoutingSnapshot(registry, parent, agentCategories, agentRou
     const builtins = listBuiltinModels(effectiveProviderId);
     const builtinIndex = new Map(builtins.map((model, index) => [model.id, index]));
     const dynamic = listDynamicModelMetadata(effectiveProviderId);
-    const custom = registry.getModelConfig().getCustomModels(parent.providerId);
+    const custom = filterProviderModels(parent.providerId, registry.getModelConfig().getCustomModels(parent.providerId));
     const discovery = registry.getCachedDiscoverySnapshot(parent.providerId);
     const metadataFor = (id) => {
         const dynamicEntry = dynamic.find((model) => model.id === id);
@@ -192,7 +193,7 @@ export function createRoutableModelIndex(registry) {
                 seen.add(id);
                 entries.push({ providerId: provider.id, id, name });
             };
-            for (const model of registry.getModelConfig().getCustomModels(provider.id))
+            for (const model of filterProviderModels(provider.id, registry.getModelConfig().getCustomModels(provider.id)))
                 push(model.id, model.name);
             for (const model of listDynamicModelMetadata(effectiveProviderId))
                 push(model.id, model.name);

package/dist/agent/subagent/router.js

@@ -16,6 +16,7 @@ import { nearModelMatches, tierContextFromSnapshot } from "../routing-catalog.js
 import { buildModelRoutingPrompt } from "../../prompt/routing.js";
 import { getBuiltinModel } from "../../model-catalog.js";
 import { getAvailableThinkingLevels, getDefaultThinkingLevel, normalizeInheritedThinkingLevel, normalizeThinkingLevel } from "../../variant/variant-resolver.js";
+import { providerModelPolicyError } from "../../provider-model-policy.js";
 export class SubagentRouter {
     deps;
     constructor(deps) {
@@ -114,6 +115,10 @@ export class SubagentRouter {
      */
     validateForDispatch(route) {
         const parentProviderId = this.deps.parentRoute().providerId;
+        const resolvedProviderId = route.providerId || parentProviderId;
+        const fixedPolicyError = providerModelPolicyError(resolvedProviderId, route.model);
+        if (fixedPolicyError)
+            throw new Error(fixedPolicyError);
         const snapshot = this.currentSnapshot();
         const crossProvider = !!route.providerId && route.providerId !== parentProviderId;
         if (crossProvider) {

package/dist/agent/subagent/runtime.d.ts

@@ -160,6 +160,7 @@ export declare class SubagentRuntime {
         ensureProfileTrusted?: (profile: AgentProfile) => Promise<{
             content: string | unknown;
         } | undefined>;
+        workflowRunId?: string;
     }): Promise<{
         result: {
             ok: true;

package/dist/agent/subagent/runtime.js

@@ -312,6 +312,7 @@ export class SubagentRuntime {
         const profiles = discoverAgentProfiles(cwd, "both").profiles;
         const runRecords = [];
         const logs = [];
+        let currentWorkflowPhase;
         // Per-run isolation (option C review): a concurrency sub-cap below the
         // global limit so a workflow can't starve interactive subagents.
         const interactiveReserve = 2;
@@ -356,6 +357,8 @@ export class SubagentRuntime {
                 task: baseTask,
                 parentToolCallId: options.parentToolCallId,
                 parentToolName: "run_workflow",
+                runId: options.workflowRunId,
+                phase: currentWorkflowPhase,
                 route,
                 workflowInternal: true,
             });
@@ -432,7 +435,10 @@ export class SubagentRuntime {
             args: options.args,
             dispatchAgent,
             onLog: (message) => logs.push(message),
-            onPhase: (title) => logs.push(`— phase: ${title} —`),
+            onPhase: (title) => {
+                currentWorkflowPhase = title;
+                logs.push(`— phase: ${title} —`);
+            },
             budget: {
                 // The ledger is pure accounting (no pool limit); scripts see an
                 // unlimited budget unless a future host contract reintroduces one.
@@ -599,6 +605,7 @@ export class SubagentRuntime {
             nickname,
             profile: options.profile,
             category: options.route?.category,
+            phase: options.phase,
             route: options.route,
             workflowInternal: options.workflowInternal,
             parentToolCallId: options.parentToolCallId,
@@ -724,11 +731,14 @@ export class SubagentRuntime {
             metadata: {
                 kind: "subagent",
                 runId: record.runId,
+                mode: record.parentToolName === "run_workflow" ? "workflow" : "single",
                 subagents: [{
                         subAgentId: record.agentId,
+                        runId: record.runId,
                         agentName: record.profile.name,
                         nickname: record.nickname,
                         category: record.category,
+                        phase: record.phase,
                         route: record.route,
                         status,
                         profileSource: record.profile.source,
@@ -737,6 +747,8 @@ export class SubagentRuntime {
                         toolNotes: record.toolNotes,
                         usage: record.usage,
                         error: record.error,
+                        createdAt: record.createdAt,
+                        updatedAt: record.updatedAt,
                     }],
             },
         };

package/dist/agent/subagent-control.d.ts

@@ -17,6 +17,8 @@ export interface SubagentThreadSnapshot {
     agentName: string;
     profileSource: AgentProfileSource;
     category?: string;
+    /** Workflow phase active when this child was dispatched. */
+    phase?: string;
     route?: ResolvedSubagentRoute;
     status: SubagentThreadStatus;
     finalReason?: SubagentFinalReason;
@@ -40,6 +42,8 @@ export interface SubagentThreadRecord {
     nickname: string;
     profile: AgentProfile;
     category?: string;
+    /** Workflow phase active when this child was dispatched. */
+    phase?: string;
     route?: ResolvedSubagentRoute;
     parentToolCallId: string;
     parentToolName: string;

package/dist/agent/subagent-control.js

@@ -20,6 +20,7 @@ export function snapshotSubagentThread(record) {
         agentName: record.profile.name,
         profileSource: record.profile.source,
         category: record.category,
+        phase: record.phase,
         route: record.route,
         status: record.status,
         finalReason: record.finalReason,

package/dist/agent/subagent-store.js

@@ -102,6 +102,7 @@ export class SubagentStore {
                 nickname: record.nickname,
                 profile: record.profile,
                 category: record.category,
+                phase: record.phase,
                 route: record.route,
                 parentToolCallId: record.parentToolCallId,
                 parentToolName: record.parentToolName,
@@ -152,6 +153,7 @@ export class SubagentStore {
                     nickname: parsed.nickname,
                     profile: parsed.profile,
                     category: parsed.category,
+                    phase: parsed.phase,
                     route: parsed.route,
                     parentToolCallId: parsed.parentToolCallId,
                     parentToolName: parsed.parentToolName,

package/dist/agent/workflow/control.d.ts

@@ -35,6 +35,8 @@ export interface WorkflowRunSnapshot {
     resultPath?: string;
     logs: string[];
     snapshots: SubagentThreadSnapshot[];
+    createdAt: number;
+    updatedAt?: number;
 }
 /** System-reminder injected at the next turn when a background workflow finishes. */
 /**

package/dist/agent/workflow/runs.d.ts

@@ -12,6 +12,7 @@ export interface WorkflowExecuteOptions {
     ensureProfileTrusted?: (profile: AgentProfile) => Promise<{
         content: string | unknown;
     } | undefined>;
+    workflowRunId?: string;
 }
 export interface WorkflowExecuteOutcome {
     result: {

package/dist/agent/workflow/runs.js

@@ -57,6 +57,7 @@ export class WorkflowLedger {
             script: options.script,
             args: options.args,
             parentToolCallId: options.parentToolCallId,
+            workflowRunId: runId,
             abortSignal: abortController.signal,
             queueUpdates: true,
             ensureProfileTrusted: options.ensureProfileTrusted,
@@ -140,6 +141,8 @@ export class WorkflowLedger {
             resultPath: record.resultPath,
             logs: record.logs,
             snapshots: record.snapshots,
+            createdAt: record.createdAt,
+            updatedAt: record.updatedAt,
         };
     }
 }

package/dist/agent.d.ts

@@ -100,6 +100,10 @@ export interface AgentOptions {
 export interface AgentRunOptions {
     abortSignal?: AbortSignal;
     inputController?: AgentInputController;
+    /** Local-only presentation metadata persisted with the submitted user turn. */
+    userMessageUi?: Extract<Message, {
+        role: "user";
+    }>["ui"];
     /**
      * Internal: re-enter the loop without appending the input as a new user
      * message. Used by the subagent scheduler's rate-limit re-entry so a child
@@ -131,6 +135,8 @@ export declare class Agent {
         list: () => import("./tasks/manager.js").BackgroundTaskInfo[];
         version: () => number;
         outputTail: (id: string) => string | undefined;
+        kill?: (id: string) => Promise<import("./tasks/manager.js").BackgroundTaskInfo | undefined>;
+        subscribe?: (listener: () => void) => () => void;
     };
     private lastTaskReminderVersion;
     /**
@@ -223,6 +229,8 @@ export declare class Agent {
     /** All deferred tools in this session (for tool_search to inspect). */
     listDeferredTools(): ToolRegistryEntry[];
     getSystemPromptToolOptions(): Pick<import("./system-prompt.js").SystemPromptOptions, "tools" | "toolSnippets" | "guidelines" | "modelRoutingPrompt" | "memoryPrompt">;
+    /** Refresh the live Skill catalog after /skills reloads or changes enablement. */
+    setSkillSummaries(skills: SkillSummary[]): void;
     /** Current routing menu (design §4); undefined when no accessor is wired. */
     buildModelRoutingPromptSection(): string | undefined;
     /**
@@ -310,7 +318,7 @@ export declare class Agent {
      * (the caller falls back to heuristic compaction in that case). Throws only
      * if the provider stream itself errors.
      */
-    summarizeForCompaction(oldMessages: Message[], onDelta?: (full: string, delta: string) => void, abortSignal?: AbortSignal): Promise<string>;
+    summarizeForCompaction(oldMessages: Message[], onDelta?: (full: string, delta: string) => void, abortSignal?: AbortSignal, userContext?: string): Promise<string>;
     runSubAgent(input: string | ContentPart[], cwd: string, options: Parameters<SubagentRuntime["runSubAgent"]>[2]): Promise<SubagentRunResult>;
     spawnSubAgent(input: string | ContentPart[], cwd: string, options: Parameters<SubagentRuntime["spawnSubAgent"]>[2]): Promise<SubagentThreadSnapshot>;
     waitSubAgents(options?: {
@@ -331,6 +339,8 @@ export declare class Agent {
      */
     activeSubAgentCount(): number;
     listSubAgents(): SubagentThreadSnapshot[];
+    /** Read-only child transcript for the TUI inspector. */
+    getSubAgentMessages(agentId: string): Message[];
     /** Marks a child's full summary as delivered to parent context (design §3.3). */
     markSubagentDelivered(agentId: string): void;
     /**