@bubblebrain-ai/bubble 0.0.51 → 0.0.53

package/dist/tui/composer-autocomplete.js

@@ -0,0 +1,383 @@
+import { CombinedAutocompleteProvider, } from "@bubblebrain-ai/pi-tui";
+import { BUILTIN_PROVIDERS, encodeModel, isUserVisibleProvider, } from "../provider-registry.js";
+import { getAvailableThinkingLevels, isThinkingToggleModel, normalizeThinkingLevel, } from "../provider-transform.js";
+import { discoverModelProviderGroups, getVisibleModelProviders, localModelsForProvider, } from "./model-picker-data.js";
+const MODEL_COMMAND_PREFIX = "/model ";
+const REASONING_EFFORT_SEPARATOR = " --reasoning-effort ";
+const PROVIDER_COMMAND_PREFIX = "/provider ";
+const THEME_COMMAND_PREFIX = "/theme ";
+const EFFORT_DESCRIPTIONS = {
+    off: "no reasoning effort",
+    minimal: "fastest reasoning",
+    low: "light reasoning",
+    medium: "balanced reasoning",
+    high: "deeper reasoning",
+    xhigh: "extra high reasoning",
+    max: "maximum provider effort",
+    ultra: "maximum effort with delegation",
+};
+function selectableModels(groups) {
+    const seen = new Set();
+    const selections = [];
+    for (const { provider, models } of groups) {
+        for (const model of models) {
+            const value = encodeModel(provider.id, model.id);
+            if (seen.has(value))
+                continue;
+            seen.add(value);
+            const declaredLevels = model.reasoningLevels ?? getAvailableThinkingLevels(provider.id, model.id);
+            selections.push({
+                provider,
+                model,
+                value,
+                levels: declaredLevels.length > 0 ? declaredLevels : ["off"],
+            });
+        }
+    }
+    return selections;
+}
+function preferredThinkingLevel(selection, current) {
+    if (selection.levels.includes(current))
+        return current;
+    if (selection.model.defaultReasoningLevel &&
+        selection.levels.includes(selection.model.defaultReasoningLevel)) {
+        return selection.model.defaultReasoningLevel;
+    }
+    return normalizeThinkingLevel(current, selection.levels);
+}
+function effortPhase(selections, argumentPrefix) {
+    const separatorIndex = argumentPrefix.indexOf(REASONING_EFFORT_SEPARATOR);
+    if (separatorIndex < 0)
+        return null;
+    const modelValue = argumentPrefix.slice(0, separatorIndex);
+    const selection = selections.find((candidate) => candidate.value === modelValue);
+    if (!selection || selection.levels.length <= 1)
+        return null;
+    return {
+        selection,
+        query: argumentPrefix.slice(separatorIndex + REASONING_EFFORT_SEPARATOR.length),
+    };
+}
+function modelCatalogKey(groups) {
+    return JSON.stringify(groups.map(({ provider, models }) => [
+        provider.id,
+        provider.baseURL,
+        provider.authType ?? "api",
+        provider.protocol ?? "default",
+        provider.apiKey,
+        models.map((model) => [
+            model.id,
+            model.name,
+            model.reasoningLevels,
+            model.defaultReasoningLevel,
+            model.contextWindow,
+            model.useResponsesLite,
+            model.toolOutputTokenLimit,
+            model.tier,
+        ]),
+    ]));
+}
+export function buildModelAutocompleteItems(groups, argumentPrefix = "", currentThinkingLevel = "off") {
+    const selections = selectableModels(groups);
+    const effort = effortPhase(selections, argumentPrefix);
+    if (effort) {
+        const toggle = isThinkingToggleModel(effort.selection.provider.id, effort.selection.model.id);
+        const query = effort.query.trim().toLowerCase();
+        const baseValue = `${effort.selection.value}${REASONING_EFFORT_SEPARATOR}`;
+        return effort.selection.levels.flatMap((level) => {
+            const label = toggle ? (level === "off" ? "off" : "on") : level;
+            const description = toggle
+                ? (level === "off" ? "thinking disabled" : "thinking enabled")
+                : EFFORT_DESCRIPTIONS[level];
+            if (query && !`${label} ${level} ${description}`.toLowerCase().includes(query))
+                return [];
+            return [{
+                    value: `${baseValue}${level}`,
+                    label,
+                    description,
+                    submitOnSelect: true,
+                }];
+        });
+    }
+    const query = argumentPrefix.trim().toLowerCase();
+    const items = [];
+    for (const selection of selections) {
+        const { provider, model, value, levels } = selection;
+        const label = model.name || model.id;
+        const description = label === model.id
+            ? provider.name
+            : `${provider.name} · ${model.id}`;
+        const searchable = `${value} ${label} ${description}`.toLowerCase();
+        if (query && !searchable.includes(query))
+            continue;
+        const level = preferredThinkingLevel(selection, currentThinkingLevel);
+        items.push({
+            value: levels.length > 1
+                ? `${value}${REASONING_EFFORT_SEPARATOR}`
+                : `${value}${REASONING_EFFORT_SEPARATOR}${level}`,
+            label,
+            description,
+            submitOnSelect: levels.length <= 1,
+        });
+    }
+    return items;
+}
+export function buildProviderAutocompleteItems(registry, argumentPrefix = "", currentProviderId) {
+    const query = argumentPrefix.trim().toLowerCase();
+    if (query.startsWith("--"))
+        return [];
+    const configured = registry.getConfigured();
+    const configuredById = new Map(configured.map((provider) => [provider.id, provider]));
+    const seen = new Set();
+    const candidates = [
+        ...BUILTIN_PROVIDERS.filter((provider) => isUserVisibleProvider(provider.id)),
+        ...configured.filter((provider) => isUserVisibleProvider(provider.id)),
+    ];
+    return candidates.flatMap((provider) => {
+        if (seen.has(provider.id))
+            return [];
+        seen.add(provider.id);
+        const profile = configuredById.get(provider.id);
+        const builtin = BUILTIN_PROVIDERS.find((candidate) => candidate.id === provider.id);
+        const managedByFile = registry.getModelConfig().hasProvider(provider.id);
+        const status = profile?.apiKey
+            ? (profile.authType === "oauth" ? "OAuth connected" : "Configured")
+            : builtin?.supportsOAuth
+                ? "OAuth available"
+                : "Needs API key";
+        const current = provider.id === currentProviderId;
+        const action = profile?.apiKey || provider.id === "grok" ? "--set" : "--add";
+        const source = managedByFile ? " · models.json" : "";
+        const description = `${current ? "Current · " : ""}${provider.id} · ${status}${source}`;
+        const searchable = `${provider.id} ${provider.name} ${description}`.toLowerCase();
+        if (query && !searchable.includes(query))
+            return [];
+        return [{
+                value: `${action} ${provider.id}`,
+                label: provider.name,
+                description,
+                submitOnSelect: true,
+            }];
+    });
+}
+export function buildThemeAutocompleteItems(argumentPrefix = "", detectedTheme = "dark") {
+    const query = argumentPrefix.trim().toLowerCase();
+    const candidates = [
+        { value: "auto", label: "Auto", description: `Match terminal · currently ${detectedTheme}` },
+        { value: "light", label: "Light", description: "Light surfaces and dark text" },
+        { value: "dark", label: "Dark", description: "Dark surfaces and light text" },
+    ];
+    return candidates.flatMap((candidate) => {
+        const searchable = `${candidate.value} ${candidate.label} ${candidate.description}`.toLowerCase();
+        if (query && !searchable.includes(query))
+            return [];
+        return [{ ...candidate, submitOnSelect: true }];
+    });
+}
+/**
+ * Build the command surface in execution-priority order. The registry remains
+ * live so MCP prompts that connect after startup appear on the next keypress.
+ */
+export function buildComposerSlashCommands(commands, skills, uiMode = "regular", modelCompletions, providerCompletions, themeCompletions) {
+    const result = new Map();
+    const add = (command) => {
+        if (!result.has(command.name))
+            result.set(command.name, command);
+    };
+    // Renderer-local commands execute before the shared registry.
+    if (uiMode === "regular") {
+        add({ name: "fullscreen", description: "Open the alternate-screen transcript view" });
+    }
+    for (const command of commands.filter((entry) => entry.source === "builtin")) {
+        if (command.name === "model" && modelCompletions) {
+            add({
+                name: command.name,
+                description: command.description,
+                argumentHint: "<model>",
+                submitOnSelect: false,
+                argumentInputHint: {
+                    prompt: "⌕ ",
+                    placeholder: "Search models…",
+                    valuePrefix: "/model ",
+                },
+                keepArgumentMenuOnEmpty: true,
+                argumentEmptyMessage: "No matching models",
+                getArgumentCompletions: modelCompletions,
+            });
+        }
+        else if (command.name === "provider" && providerCompletions) {
+            add({
+                name: command.name,
+                description: command.description,
+                argumentHint: "<provider>",
+                submitOnSelect: false,
+                argumentInputHint: {
+                    prompt: "⌕ ",
+                    placeholder: "Search providers…",
+                    valuePrefix: PROVIDER_COMMAND_PREFIX,
+                },
+                keepArgumentMenuOnEmpty: true,
+                argumentEmptyMessage: "No matching providers",
+                getArgumentCompletions: providerCompletions,
+            });
+        }
+        else if (command.name === "theme" && themeCompletions) {
+            add({
+                name: command.name,
+                description: command.description,
+                argumentHint: "<auto|light|dark>",
+                submitOnSelect: false,
+                argumentInputHint: {
+                    prompt: "◐ ",
+                    placeholder: "Select theme…",
+                    valuePrefix: THEME_COMMAND_PREFIX,
+                },
+                keepArgumentMenuOnEmpty: true,
+                argumentEmptyMessage: "No matching themes",
+                getArgumentCompletions: themeCompletions,
+            });
+        }
+        else {
+            add({ name: command.name, description: command.description });
+        }
+    }
+    for (const skill of skills) {
+        const source = skill.source ? ` · ${skill.source}` : "";
+        add({
+            name: skill.name,
+            argumentHint: "<request>",
+            submitOnSelect: false,
+            description: `[skill${source}] ${skill.description}`,
+        });
+    }
+    for (const command of commands.filter((entry) => entry.source !== "builtin")) {
+        const source = command.sourceLabel ? `mcp:${command.sourceLabel}` : command.source;
+        add({ name: command.name, description: `[${source}] ${command.description}` });
+    }
+    return [...result.values()];
+}
+/** A live adapter around pi-tui's command/file completion implementation. */
+export class ComposerAutocompleteProvider {
+    sources;
+    discoveredModels = null;
+    modelRefresh = null;
+    constructor(sources) {
+        this.sources = sources;
+    }
+    async getSuggestions(lines, cursorLine, cursorCol, options) {
+        return this.delegate().getSuggestions(lines, cursorLine, cursorCol, options);
+    }
+    applyCompletion(lines, cursorLine, cursorCol, item, prefix) {
+        return this.delegate().applyCompletion(lines, cursorLine, cursorCol, item, prefix);
+    }
+    shouldTriggerFileCompletion(lines, cursorLine, cursorCol) {
+        return this.delegate().shouldTriggerFileCompletion?.(lines, cursorLine, cursorCol) ?? true;
+    }
+    delegate() {
+        return new CombinedAutocompleteProvider(buildComposerSlashCommands(this.sources.commands(), this.sources.skills(), this.sources.uiMode?.() ?? "regular", this.sources.registry ? (prefix) => this.getModelCompletions(prefix) : undefined, this.sources.registry ? (prefix) => this.getProviderCompletions(prefix) : undefined, (prefix) => this.getThemeCompletions(prefix)), this.sources.cwd, this.sources.fdPath ?? null);
+    }
+    getThemeCompletions(argumentPrefix) {
+        const items = buildThemeAutocompleteItems(argumentPrefix, this.sources.detectedTheme?.() ?? "dark");
+        const current = this.sources.themeMode?.() ?? "auto";
+        return {
+            items,
+            inputHint: {
+                prompt: "◐ ",
+                placeholder: "Select theme…",
+                valuePrefix: THEME_COMMAND_PREFIX,
+            },
+            keepOpenOnEmpty: true,
+            emptyMessage: "No matching themes",
+            ...(argumentPrefix.length === 0 ? { preferredValue: current } : {}),
+        };
+    }
+    getProviderCompletions(argumentPrefix) {
+        const registry = this.sources.registry;
+        if (!registry || argumentPrefix.trimStart().startsWith("--"))
+            return null;
+        const currentProviderId = this.sources.providerId?.() ?? registry.getDefault()?.id;
+        const items = buildProviderAutocompleteItems(registry, argumentPrefix, currentProviderId);
+        return {
+            items,
+            inputHint: {
+                prompt: "⌕ ",
+                placeholder: "Search providers…",
+                valuePrefix: PROVIDER_COMMAND_PREFIX,
+            },
+            keepOpenOnEmpty: true,
+            emptyMessage: "No matching providers",
+            ...(argumentPrefix.length === 0 && currentProviderId
+                ? { preferredValue: `--set ${currentProviderId}` }
+                : {}),
+        };
+    }
+    getModelCompletions(argumentPrefix) {
+        const registry = this.sources.registry;
+        if (!registry)
+            return null;
+        const localGroups = getVisibleModelProviders(registry).map((provider) => ({
+            provider,
+            models: localModelsForProvider(registry, provider),
+        }));
+        const key = modelCatalogKey(localGroups);
+        const groups = this.discoveredModels?.key === key ? this.discoveredModels.groups : localGroups;
+        this.refreshModelCatalog(key);
+        const currentThinkingLevel = this.sources.thinkingLevel?.() ?? "off";
+        const items = buildModelAutocompleteItems(groups, argumentPrefix, currentThinkingLevel);
+        const selections = selectableModels(groups);
+        const effort = effortPhase(selections, argumentPrefix);
+        if (!effort) {
+            return {
+                items,
+                inputHint: {
+                    prompt: "⌕ ",
+                    placeholder: "Search models…",
+                    valuePrefix: MODEL_COMMAND_PREFIX,
+                },
+                keepOpenOnEmpty: true,
+                emptyMessage: "No matching models",
+            };
+        }
+        const toggle = isThinkingToggleModel(effort.selection.provider.id, effort.selection.model.id);
+        const baseValue = `${effort.selection.value}${REASONING_EFFORT_SEPARATOR}`;
+        const preferredLevel = preferredThinkingLevel(effort.selection, currentThinkingLevel);
+        return {
+            items,
+            inputHint: {
+                prompt: "◆ ",
+                placeholder: toggle ? "Select thinking mode…" : "Select reasoning effort…",
+                valuePrefix: `${MODEL_COMMAND_PREFIX}${baseValue}`,
+                backValue: MODEL_COMMAND_PREFIX,
+            },
+            keepOpenOnEmpty: true,
+            emptyMessage: toggle ? "No matching modes" : "No matching efforts",
+            ...(effort.query.length === 0
+                ? { preferredValue: `${baseValue}${preferredLevel}` }
+                : {}),
+        };
+    }
+    /**
+     * Remote discovery enriches the already-visible local catalog. It is shared
+     * per provider snapshot and runs all providers concurrently, so opening the
+     * composer menu never waits on network latency.
+     */
+    refreshModelCatalog(key) {
+        const registry = this.sources.registry;
+        if (!registry || this.discoveredModels?.key === key || this.modelRefresh?.key === key)
+            return;
+        const task = discoverModelProviderGroups(registry).then((groups) => {
+            const currentGroups = getVisibleModelProviders(registry).map((provider) => ({
+                provider,
+                models: localModelsForProvider(registry, provider),
+            }));
+            if (modelCatalogKey(currentGroups) !== key)
+                return;
+            this.discoveredModels = { key, groups };
+            this.sources.onModelSuggestionsChanged?.();
+        }).finally(() => {
+            if (this.modelRefresh?.task === task)
+                this.modelRefresh = null;
+        });
+        this.modelRefresh = { key, task };
+    }
+}

package/dist/tui/composer-style.d.ts

@@ -0,0 +1,7 @@
+import type { EditorOptions, EditorTheme } from "@bubblebrain-ai/pi-tui";
+import { type Theme } from "./model/theme.js";
+/** Bubble's primary composer: lightweight square box with an agent prompt. */
+export declare function createComposerEditorTheme(getTheme: () => Theme): EditorTheme;
+/** Backward-compatible dark default for isolated components and tests. */
+export declare const COMPOSER_EDITOR_THEME: EditorTheme;
+export declare const COMPOSER_EDITOR_OPTIONS: EditorOptions;

package/dist/tui/composer-style.js

@@ -0,0 +1,29 @@
+import { darkTheme } from "./model/theme.js";
+import { themeBackground, themeDim, themeForeground } from "./model/theme-style.js";
+/** Bubble's primary composer: lightweight square box with an agent prompt. */
+export function createComposerEditorTheme(getTheme) {
+    return {
+        // The callbacks read the current palette on every render. Editor keeps the
+        // theme object for its lifetime, so this is what makes /theme repaint an
+        // already-mounted composer and autocomplete menu without reconstruction.
+        borderColor: (str) => themeDim(getTheme().border, str),
+        autocompleteBackground: (str) => themeBackground(getTheme().backgroundPanel, str),
+        selectList: {
+            selectedPrefix: () => themeForeground(getTheme().accent, "› "),
+            selectedText: (str) => themeForeground(getTheme().inputText, str),
+            selectedRow: (str) => themeForeground(getTheme().inputText, themeBackground(getTheme().traceSelectedBg, str)),
+            description: (str) => themeDim(getTheme().dim, str),
+            scrollInfo: (str) => themeDim(getTheme().dim, str),
+            noMatch: (str) => themeDim(getTheme().dim, str),
+        },
+    };
+}
+/** Backward-compatible dark default for isolated components and tests. */
+export const COMPOSER_EDITOR_THEME = createComposerEditorTheme(() => darkTheme);
+export const COMPOSER_EDITOR_OPTIONS = {
+    borderStyle: "box",
+    paddingX: 1,
+    prompt: "> ",
+    autocompletePlacement: "above",
+    autocompleteBorderStyle: "none",
+};

package/dist/tui/controller/agent-event-reducer.d.ts

@@ -0,0 +1,75 @@
+/**
+ * Pure Agent-event reducer for a single agent run.
+ *
+ * Mechanical extraction of the legacy application event switch plus
+ * its finally-block semantics (1888-1958) into a pure function: state in,
+ * (state, effects) out. No React, no Ink, no ports — the controller applies
+ * effects and owns scheduling (40ms flush) via ports.
+ *
+ * Migration rule (docs/pi-tui-controller-extraction.md §2): each case is
+ * case-for-case equivalent to the legacy implementation; no opportunistic
+ * refactoring. Behavior deltas are called out in comments.
+ */
+import type { AgentEvent, AgentRunInput } from "../../types.js";
+import { setUserInputStatus, type DisplayMessage, type DisplayMessagePart, type DisplayToolCall } from "../model/display-history.js";
+import type { ControllerEffect } from "./effects.js";
+export declare const STREAMING_FLUSH_INTERVAL_MS = 40;
+export interface RunAccumulator {
+    readonly runId: number;
+    content: string;
+    reasoning: string;
+    systemFingerprint?: string;
+    toolCalls: DisplayToolCall[];
+    parts: DisplayMessagePart[];
+    usageTokens: number;
+    usageReported: boolean;
+}
+export type RunOutcome = "running" | "cancelled" | "errored";
+export interface RunDirty {
+    content: boolean;
+    reasoning: boolean;
+    parts: boolean;
+    tools: boolean;
+}
+export interface RunState {
+    readonly accumulator: RunAccumulator;
+    readonly dirty: RunDirty;
+    readonly outcome: RunOutcome;
+}
+export interface RunContext {
+    readonly external: boolean;
+    readonly externalModelId?: string;
+    isCurrentRun(): boolean;
+    now(): number;
+    readonly runStartedAt: number | null;
+    /** Steer placeholders correlated by input id (controller-owned map). */
+    readonly pendingSteers: ReadonlyMap<string, {
+        displayKey: string;
+        sessionFile?: string;
+    }>;
+}
+export interface EventReduceResult {
+    readonly state: RunState;
+    readonly effects: readonly ControllerEffect[];
+}
+export declare function createRunState(runId: number): RunState;
+/** Grok policy guard: events outside the whitelist abort the session. */
+export declare function grokEventAllowed(event: AgentEvent): boolean;
+export declare function reduceAgentEvent(state: RunState, event: AgentEvent, ctx: RunContext): EventReduceResult;
+export interface RunFinishOptions {
+    cancelled: boolean;
+    errored: boolean;
+    /** Steers still pending at run end (inputController.clear() upstream). */
+    leftoverSteers: Array<{
+        input: AgentRunInput;
+        displayKey?: string;
+        sessionFile?: string;
+    }>;
+    /** Placeholder-row bookkeeping stays with the controller's queue state. */
+    ownsCurrentGeneration: boolean;
+}
+/** finally-block semantics (app.tsx:1888-1958) as a pure transition. */
+export declare function reduceRunFinish(state: RunState, opts: RunFinishOptions): EventReduceResult;
+/** Build the committed assistant message from the accumulator (app.tsx:1567-1607). */
+export declare function buildAssistantMessage(state: RunState, taskElapsedMs?: number): DisplayMessage | null;
+export type { setUserInputStatus };