@bubblebrain-ai/bubble 0.0.4 → 0.0.6

package/dist/agent/task-size.d.ts

@@ -0,0 +1,9 @@
+import type { ContentPart } from "../types.js";
+/**
+ * Coarse "is this a small / focused task" classifier. Used to inject a hint
+ * that suppresses the default exploration-first protocol when the user's
+ * request is clearly a one-shot create or single-file tweak. Counterpart to
+ * `task-classifier.ts` which categorizes by *kind*, not *size*.
+ */
+export type TaskSize = "small" | "normal";
+export declare function classifyTaskSize(input: string | ContentPart[]): TaskSize;

package/dist/agent/task-size.js

@@ -0,0 +1,33 @@
+// Two-part match: a "create" verb AND a "deliverable" noun in the same
+// sentence is a strong signal of a focused, one-shot task.
+const SMALL_TASK_VERBS = [
+    /\b(write|create|generate|make|draft|build|add)\b/i,
+    /帮我写|帮我创建|帮我生成|写(个|一个|一份)|新建一个|做(个|一个|一份)|生成(个|一个|一份)|搞(个|一个|一份)/i,
+];
+const SMALL_TASK_NOUNS = [
+    /\b(file|page|component|script|snippet|function|class|test|html|css|js|ts|tsx|jsx|md|markdown|hello world)\b/i,
+    /(文件|页面|组件|脚本|片段|函数|类|测试|html|css|介绍|文章|页|说明|示例|demo)/i,
+];
+function matchesSmallTaskPattern(text) {
+    return SMALL_TASK_VERBS.some((re) => re.test(text))
+        && SMALL_TASK_NOUNS.some((re) => re.test(text));
+}
+const LARGE_TASK_NEGATIONS = [
+    /\b(refactor|rewrite|migrate|overhaul|integrate|architect|review the codebase|whole project|across the codebase)\b/i,
+    /多个|批量|全部|所有|整个项目|整个仓库|架构|重构|端到端|跨模块/i,
+];
+export function classifyTaskSize(input) {
+    const text = (typeof input === "string"
+        ? input
+        : input
+            .filter((part) => part.type === "text")
+            .map((part) => part.text)
+            .join("\n")).trim();
+    if (!text)
+        return "normal";
+    // Up to ~120 chars with a small-task verb+noun match and no negation: small.
+    if (text.length <= 120 && matchesSmallTaskPattern(text)) {
+        return LARGE_TASK_NEGATIONS.some((re) => re.test(text)) ? "normal" : "small";
+    }
+    return "normal";
+}

package/dist/agent/tool-intent.d.ts

@@ -32,3 +32,4 @@ export interface ParsedReadCommand {
 }
 export declare function parseSearchBashCommand(command: string): ParsedSearchCommand | undefined;
 export declare function parseReadBashCommand(command: string): ParsedReadCommand | undefined;
+export declare function shellSplit(command: string): string[];

package/dist/agent/tool-intent.js

@@ -256,7 +256,7 @@ function parseLineCount(value) {
     const parsed = Number(value.replace(/^\+/, ""));
     return Number.isFinite(parsed) && parsed > 0 ? parsed : undefined;
 }
-function shellSplit(command) {
+export function shellSplit(command) {
     const tokens = [];
     let current = "";
     let quote = null;

package/dist/agent.d.ts

@@ -2,8 +2,12 @@
  * Agent - The core decision loop.
  * It maintains message state, calls the LLM, executes tools, and auto-continues.
  */
-import type { AgentEvent, ContentPart, PermissionMode, Message, Provider, ThinkingLevel, Todo, ToolResult, ToolRegistryEntry } from "./types.js";
+import type { AgentEvent, ContentPart, PermissionMode, Message, Provider, ThinkingLevel, Todo, ToolResult, ToolRegistryEntry, ToolUpdate } from "./types.js";
 import { type TurnHooks } from "./orchestrator/hooks.js";
+import { BudgetLedger } from "./agent/budget-ledger.js";
+import { type AgentProfile, type SubagentRunResult } from "./agent/profiles.js";
+import { type SubagentThreadSnapshot } from "./agent/subagent-control.js";
+import type { SkillSummary } from "./skills/types.js";
 export declare class AgentAbortError extends Error {
     constructor(message?: string);
 }
@@ -28,6 +32,13 @@ export interface AgentOptions {
     onTodosUpdate?: (todos: Todo[]) => void;
     onModeUpdate?: (mode: PermissionMode) => void;
     hooks?: TurnHooks[];
+    budgetLedger?: BudgetLedger;
+    budgetSource?: {
+        runId: string;
+        subAgentId?: string;
+    };
+    skills?: SkillSummary[];
+    memoryPrompt?: string;
 }
 export declare class Agent {
     messages: Message[];
@@ -50,6 +61,12 @@ export declare class Agent {
     private hookDefinitions;
     private maxTurns?;
     private taskBudget?;
+    private budgetLedger?;
+    private budgetSource;
+    private skillSummaries;
+    private memoryPrompt?;
+    private subagentThreads;
+    private pendingSubagentUpdates;
     private lastInputTokens;
     private lastAnchorMessageCount;
     constructor(options: AgentOptions);
@@ -96,6 +113,48 @@ export declare class Agent {
         subtaskType?: string;
         description?: string;
     }): Promise<ToolResult>;
+    runSubAgent(input: string | ContentPart[], cwd: string, options: {
+        profile: AgentProfile;
+        runId: string;
+        subAgentId: string;
+        parentToolCallId: string;
+        approval?: "fail" | "disabled";
+        emitUpdate?: (update: ToolUpdate) => void;
+        description?: string;
+        abortSignal?: AbortSignal;
+        nickname?: string;
+        forkContext?: boolean;
+    }): Promise<SubagentRunResult>;
+    spawnSubAgent(input: string | ContentPart[], cwd: string, options: {
+        profile: AgentProfile;
+        parentToolCallId: string;
+        approval?: "fail" | "disabled";
+        description?: string;
+        abortSignal?: AbortSignal;
+        forkContext?: boolean;
+    }): Promise<SubagentThreadSnapshot>;
+    waitSubAgents(options?: {
+        agentIds?: string[];
+        timeoutMs?: number;
+    }): Promise<SubagentThreadSnapshot[]>;
+    sendSubAgentInput(agentId: string, input: string | ContentPart[], cwd: string, options?: {
+        interrupt?: boolean;
+        parentToolCallId?: string;
+        abortSignal?: AbortSignal;
+    }): Promise<SubagentThreadSnapshot>;
+    closeSubAgent(agentId: string): Promise<SubagentThreadSnapshot>;
+    listSubAgents(): SubagentThreadSnapshot[];
+    private createSubagentThreadRecord;
+    private runSubagentThread;
+    private runSubagentFinalSummaryTurn;
+    private createSubAgentInstance;
+    private forkMessagesForSubagent;
+    private buildSubagentUpdate;
+    private queueSubagentUpdate;
+    private drainSubagentToolUpdates;
+    private activeSubagentNicknames;
+    private resolveSubagentTargets;
+    private notifySubagentWaiters;
     private maybeCompactResidentHistory;
     private appendMessage;
     private executeTool;