@bubblebrain-ai/bubble 0.0.11 → 0.0.13

package/dist/session-title.d.ts

@@ -0,0 +1,16 @@
+import type { SessionManager } from "./session.js";
+import type { ContentPart, Message, ProviderMessage, ThinkingLevel } from "./types.js";
+export interface SessionTitleUpdater {
+    handlePersistedMessage(message: Message): void;
+}
+export declare function createSessionTitleUpdater(options: {
+    sessionManager: SessionManager;
+    complete: (messages: ProviderMessage[], options?: {
+        model?: string;
+        temperature?: number;
+        thinkingLevel?: ThinkingLevel;
+        abortSignal?: AbortSignal;
+    }) => Promise<string>;
+}): SessionTitleUpdater;
+export declare function cleanGeneratedTitle(raw: string): string;
+export declare function deterministicTitleFromUserContent(content: string | ContentPart[]): string;

package/dist/session-title.js

@@ -0,0 +1,134 @@
+import { normalizeSingleLine, truncateVisual } from "./text-display.js";
+const LONG_PASTE_CHAR_THRESHOLD = 1000;
+const LONG_PASTE_LINE_THRESHOLD = 20;
+const TITLE_INPUT_MAX_CHARS = 4000;
+const TITLE_MAX_WIDTH = 80;
+const TITLE_SYSTEM_PROMPT = [
+    "You are a title generator. Output ONLY a conversation title.",
+    "",
+    "Rules:",
+    "- Single line only.",
+    "- Use the same language as the user message.",
+    "- Keep it brief and useful for finding this conversation later.",
+    "- Do not answer the user's request.",
+    "- Do not mention tools unless the tool itself is the topic.",
+    "- No explanations, no markdown, no quotes.",
+].join("\n");
+export function createSessionTitleUpdater(options) {
+    let pending;
+    let inFlight = false;
+    const run = async (candidate) => {
+        const raw = await options.complete(buildTitleMessages(candidate.input), {
+            temperature: 0.3,
+            thinkingLevel: "off",
+        });
+        const title = cleanGeneratedTitle(raw);
+        if (!title)
+            return;
+        if (!isCandidateCurrent(options.sessionManager.getEntries(), candidate.userMessageId))
+            return;
+        if (options.sessionManager.getMetadata().title?.trim())
+            return;
+        options.sessionManager.updateMetadata({
+            title,
+            titleSource: "llm",
+            titleUpdatedAt: Date.now(),
+            titleUserMessageId: candidate.userMessageId,
+        });
+    };
+    return {
+        handlePersistedMessage(message) {
+            if (message.role === "user") {
+                if (pending || inFlight)
+                    return;
+                if (options.sessionManager.getMetadata().title?.trim())
+                    return;
+                if (currentUserMessageCount(options.sessionManager.getMessages()) !== 1)
+                    return;
+                const userEntryId = latestUserMessageEntryId(options.sessionManager.getEntries());
+                if (!userEntryId)
+                    return;
+                const input = titleInputFromUserContent(message.content);
+                if (!input)
+                    return;
+                pending = { input, userMessageId: userEntryId };
+                return;
+            }
+            if (message.role !== "assistant" || !pending || inFlight)
+                return;
+            const candidate = pending;
+            pending = undefined;
+            inFlight = true;
+            void run(candidate).catch(() => undefined).finally(() => {
+                inFlight = false;
+            });
+        },
+    };
+}
+export function cleanGeneratedTitle(raw) {
+    const withoutThinking = raw.replace(/<think>[\s\S]*?<\/think>/gi, "");
+    const withoutFences = withoutThinking.replace(/```[a-zA-Z0-9_-]*\s*/g, "").replace(/```/g, "");
+    const line = withoutFences
+        .split(/\r?\n/)
+        .map((item) => item.trim())
+        .find(Boolean);
+    if (!line)
+        return "";
+    const unquoted = line.replace(/^["'“”‘’]+|["'“”‘’]+$/g, "");
+    return truncateVisual(normalizeSingleLine(unquoted), TITLE_MAX_WIDTH);
+}
+export function deterministicTitleFromUserContent(content) {
+    const text = userContentText(content);
+    if (!text)
+        return "User message";
+    const charCount = text.length;
+    const lineCount = text.split(/\r?\n/).length;
+    if (charCount > LONG_PASTE_CHAR_THRESHOLD || lineCount > LONG_PASTE_LINE_THRESHOLD) {
+        return `[Pasted Content ${charCount} chars]`;
+    }
+    return truncateVisual(normalizeSingleLine(text), TITLE_MAX_WIDTH) || "User message";
+}
+function titleInputFromUserContent(content) {
+    const title = deterministicTitleFromUserContent(content);
+    const text = userContentText(content);
+    if (!text)
+        return title;
+    return normalizeSingleLine(text).slice(0, TITLE_INPUT_MAX_CHARS);
+}
+function userContentText(content) {
+    if (typeof content === "string")
+        return content;
+    const text = content.map((part) => part.type === "text" ? part.text : "").filter(Boolean).join("\n");
+    if (text.trim())
+        return text;
+    return content.some((part) => part.type === "image_url") ? "Image attachment" : "";
+}
+function buildTitleMessages(input) {
+    return [
+        { role: "system", content: TITLE_SYSTEM_PROMPT },
+        { role: "user", content: `Generate a title for this conversation:\n\n${input}` },
+    ];
+}
+function currentUserMessageCount(messages) {
+    return messages.filter((message) => message.role === "user").length;
+}
+function latestUserMessageEntryId(entries) {
+    for (let i = entries.length - 1; i >= 0; i--) {
+        const entry = entries[i];
+        if (entry.type === "user_message")
+            return entry.id;
+    }
+    return undefined;
+}
+function isCandidateCurrent(entries, userMessageId) {
+    let clearIndex = -1;
+    let userIndex = -1;
+    for (let i = 0; i < entries.length; i++) {
+        const entry = entries[i];
+        if (entry.type === "marker" && entry.kind === "conversation_clear")
+            clearIndex = i;
+        if (entry.id === userMessageId)
+            userIndex = i;
+    }
+    return userIndex > clearIndex;
+}

package/dist/session-types.d.ts

@@ -4,6 +4,11 @@ export interface SessionMetadata {
     thinkingLevel?: ThinkingLevel;
     reasoningEffort?: ThinkingLevel;
     cwd?: string;
+    title?: string;
+    titleSource?: "llm" | "manual";
+    titleUpdatedAt?: number;
+    titleUserMessageId?: string;
+    promptCacheKey?: string;
 }
 export type SessionMarkerKind = "model_switch" | "provider_switch" | "thinking_level_switch" | "skill_activated" | "mode_switch" | "conversation_clear";
 interface BaseSessionLogEntry {

package/dist/session.d.ts

@@ -9,6 +9,8 @@ export interface SessionSummary {
     name: string;
     cwd?: string;
     cwdLabel: string;
+    title: string;
+    preview: string;
     firstUserMessage: string;
     messageCount: number;
     mtime: number;
@@ -28,7 +30,10 @@ export declare class SessionManager {
     private persist;
     private rewrite;
     getMetadata(): SessionMetadata;
+    getOrCreatePromptCacheKey(): string;
     setMetadata(metadata: SessionMetadata): void;
+    updateMetadata(patch: Partial<SessionMetadata>): void;
+    clearTitleMetadata(): void;
     appendMessage(message: Message): void;
     appendCompaction(summary: string): void;
     appendMarker(kind: SessionMarkerKind, value: string): void;

package/dist/session.js

@@ -1,11 +1,14 @@
 /**
  * Session Manager - Append-only JSONL persistence over a structured session log.
  */
+import { randomUUID } from "node:crypto";
 import { mkdirSync, appendFileSync, existsSync, readFileSync, readdirSync, statSync, writeFileSync } from "node:fs";
 import { basename, dirname, join } from "node:path";
 import { getBubbleHome } from "./bubble-home.js";
 import { compactSessionEntries } from "./context/compact.js";
 import { SessionLog } from "./session-log.js";
+import { normalizeSingleLine, truncateVisual } from "./text-display.js";
+import { deterministicTitleFromUserContent } from "./session-title.js";
 const AUTO_COMPACT_ENTRY_THRESHOLD = 180;
 const AUTO_COMPACT_KEEP_RECENT_TURNS = 3;
 export class SessionManager {
@@ -107,10 +110,28 @@ export class SessionManager {
     getMetadata() {
         return this.log.getMetadata();
     }
+    getOrCreatePromptCacheKey() {
+        const existing = this.log.getMetadata().promptCacheKey;
+        if (existing)
+            return existing;
+        const promptCacheKey = randomUUID();
+        this.updateMetadata({ promptCacheKey });
+        return promptCacheKey;
+    }
     setMetadata(metadata) {
         const nextEntries = this.log.setMetadata(metadata);
         this.rewrite(nextEntries);
     }
+    updateMetadata(patch) {
+        this.setMetadata({
+            ...this.log.getMetadata(),
+            ...dropUndefined(patch),
+        });
+    }
+    clearTitleMetadata() {
+        const { title: _title, titleSource: _titleSource, titleUpdatedAt: _titleUpdatedAt, titleUserMessageId: _titleUserMessageId, ...metadata } = this.log.getMetadata();
+        this.setMetadata(metadata);
+    }
     appendMessage(message) {
         const entries = this.log.appendMessage(message);
         this.persist(entries);
@@ -192,21 +213,23 @@ function summarizeSessionFile(file, cwdDir) {
     const log = new SessionLog();
     log.load(lines);
     const metadata = log.getMetadata();
+    const entries = log.list();
     const messages = log.toMessages();
-    const firstUser = messages.find((m) => m.role === "user");
-    let firstUserText = "";
-    if (firstUser) {
-        firstUserText = typeof firstUser.content === "string"
-            ? firstUser.content
-            : firstUser.content.map((part) => part.type === "text" ? part.text : "").join("");
-    }
-    const snippet = firstUserText.trim().replace(/\s+/g, " ").slice(0, 80);
+    const firstUserEntry = firstUserEntryAfterLatestClear(entries);
+    const firstUserText = firstUserEntry ? messageText(firstUserEntry.message) : "";
+    const preview = firstUserText
+        ? sessionPreviewFromText(firstUserText)
+        : (messages.length > 0 ? "No user message" : "No messages");
+    const title = usableStoredTitle(metadata, entries)
+        ?? (firstUserEntry ? deterministicTitleFromUserContent(firstUserEntry.message.content) : (messages.length > 0 ? "Assistant-only session" : "Empty session"));
     return {
         file,
         name: basename(file).replace(/\.jsonl$/, ""),
         cwd: metadata.cwd,
         cwdLabel: metadata.cwd ?? decodeCwdDir(cwdDir),
-        firstUserMessage: snippet || "(no user message)",
+        title,
+        preview,
+        firstUserMessage: preview,
         messageCount: messages.length,
         mtime: stat.mtimeMs,
     };
@@ -219,3 +242,46 @@ function decodeCwdDir(safe) {
         return "/" + safe.slice(1).replace(/_/g, "/");
     return safe.replace(/_/g, "/");
 }
+function dropUndefined(value) {
+    return Object.fromEntries(Object.entries(value).filter(([, item]) => item !== undefined));
+}
+function firstUserEntryAfterLatestClear(entries) {
+    const startIndex = latestClearIndex(entries) + 1;
+    for (let i = startIndex; i < entries.length; i++) {
+        const entry = entries[i];
+        if (entry.type === "user_message")
+            return entry;
+    }
+    return undefined;
+}
+function latestClearIndex(entries) {
+    for (let i = entries.length - 1; i >= 0; i--) {
+        const entry = entries[i];
+        if (entry.type === "marker" && entry.kind === "conversation_clear")
+            return i;
+    }
+    return -1;
+}
+function usableStoredTitle(metadata, entries) {
+    const title = normalizeSingleLine(metadata.title ?? "");
+    if (!title)
+        return undefined;
+    if (!metadata.titleUserMessageId)
+        return title;
+    const anchorIndex = entries.findIndex((entry) => entry.id === metadata.titleUserMessageId);
+    if (anchorIndex < 0)
+        return undefined;
+    if (anchorIndex <= latestClearIndex(entries))
+        return undefined;
+    return title;
+}
+function messageText(message) {
+    if (message.role !== "user")
+        return "";
+    if (typeof message.content === "string")
+        return message.content;
+    return message.content.map((part) => part.type === "text" ? part.text : "").join("\n");
+}
+function sessionPreviewFromText(text) {
+    return truncateVisual(normalizeSingleLine(text), 100) || "No user message";
+}

package/dist/skills/invocation.js

@@ -5,24 +5,6 @@ export function parseSkillInvocation(input, registry) {
     const withoutSlash = trimmed.slice(1).trim();
     if (!withoutSlash)
         return undefined;
-    if (withoutSlash.startsWith("skill ")) {
-        const rest = withoutSlash.slice("skill ".length).trim();
-        const firstSpace = rest.indexOf(" ");
-        if (firstSpace === -1)
-            return undefined;
-        const skillName = rest.slice(0, firstSpace).trim();
-        const task = rest.slice(firstSpace + 1).trim();
-        if (!skillName || !task)
-            return undefined;
-        const skill = registry.get(skillName);
-        if (!skill)
-            return undefined;
-        return {
-            skill,
-            task,
-            actualPrompt: buildSkillExecutionPrompt(skill, task),
-        };
-    }
     const firstSpace = withoutSlash.indexOf(" ");
     if (firstSpace === -1)
         return undefined;

package/dist/skills/registry.d.ts

@@ -3,6 +3,7 @@ export interface SkillRegistryOptions {
     cwd?: string;
     bubbleHome?: string;
     agentsHome?: string;
+    claudeHome?: string;
     skillPaths?: string[];
 }
 export declare class SkillRegistry {

package/dist/skills/registry.js

@@ -9,9 +9,11 @@ export class SkillRegistry {
         const cwd = options.cwd ?? process.cwd();
         const bubbleHome = options.bubbleHome ?? getBubbleHome();
         const agentsHome = options.agentsHome ?? join(homedir(), ".agents");
+        const claudeHome = options.claudeHome ?? join(homedir(), ".claude");
         const roots = [
             { path: join(bubbleHome, "skills"), source: "user" },
             { path: join(agentsHome, "skills"), source: "user" },
+            { path: join(claudeHome, "skills"), source: "user" },
             { path: join(cwd, ".bubble", "skills"), source: "project" },
             ...(options.skillPaths ?? []).map((path) => ({ path, source: "configured" })),
         ];

package/dist/slash-commands/commands.js

@@ -6,7 +6,6 @@ import { parseRule } from "../permissions/rule.js";
 import { encodeModel, decodeModel, displayModel, BUILTIN_PROVIDERS, isUserVisibleProvider } from "../provider-registry.js";
 import { getAvailableThinkingLevels, normalizeThinkingLevel } from "../provider-transform.js";
 import { buildSystemPrompt } from "../system-prompt.js";
-import { formatLoadedSkill } from "../tools/skill.js";
 import { isThinkingLevel } from "../variant/thinking-level.js";
 import { buildMemoryPrompt, getMemoryStatus, isMemoryDisabled, resetMemory, searchMemory, } from "../memory/index.js";
 import { feishuCommand } from "./feishu.js";
@@ -55,7 +54,7 @@ function persistSelectedModel(model, ctx) {
     userConfig.setDefaultThinkingLevel(ctx.agent.thinking);
     userConfig.pushRecentModel(model);
     if (ctx.sessionManager) {
-        ctx.sessionManager.setMetadata({ model, thinkingLevel: ctx.agent.thinking, reasoningEffort: ctx.agent.thinking });
+        ctx.sessionManager.updateMetadata({ model, thinkingLevel: ctx.agent.thinking, reasoningEffort: ctx.agent.thinking });
         ctx.sessionManager.appendMarker("model_switch", model);
     }
 }
@@ -68,7 +67,6 @@ function syncSystemPrompt(ctx, model) {
         configuredModelId: model,
         thinkingLevel: ctx.agent.thinking,
         workingDir: ctx.cwd,
-        skills: ctx.skillRegistry.summaries(),
         memoryPrompt: buildMemoryPrompt(ctx.cwd),
     }));
 }
@@ -257,25 +255,6 @@ const builtinSlashCommandEntries = [
             ctx.openPicker("skill");
         },
     },
-    {
-        name: "skill",
-        description: "Load a skill explicitly. Usage: /skill <name>",
-        async handler(args, ctx) {
-            const name = args.trim();
-            if (!name) {
-                return "Usage: /skill <name>";
-            }
-            const skill = ctx.skillRegistry.get(name);
-            if (!skill) {
-                const available = ctx.skillRegistry.summaries().map((item) => item.name).join(", ");
-                return available
-                    ? `Unknown skill "${name}". Available skills: ${available}`
-                    : `Unknown skill "${name}". No skills are currently available.`;
-            }
-            ctx.sessionManager?.appendMarker("skill_activated", skill.meta.name);
-            return formatLoadedSkill(skill);
-        },
-    },
     {
         name: "help",
         description: "Show available slash commands",
@@ -333,12 +312,40 @@ const builtinSlashCommandEntries = [
             return `Theme set to ${arg}${arg === "auto" ? ` (resolved to ${resolved})` : ""}.`;
         },
     },
+    {
+        name: "sidebar",
+        description: "Toggle the right sidebar. Usage: /sidebar [open|close|auto]",
+        async handler(args, ctx) {
+            if (!ctx.toggleSidebar || !ctx.setSidebarMode) {
+                return "Sidebar control is only available inside the TUI.";
+            }
+            const arg = args.trim().toLowerCase();
+            if (!arg) {
+                ctx.toggleSidebar();
+                return;
+            }
+            if (["open", "show", "expand", "expanded", "on"].includes(arg)) {
+                ctx.setSidebarMode("expanded");
+                return;
+            }
+            if (["close", "hide", "collapse", "collapsed", "off"].includes(arg)) {
+                ctx.setSidebarMode("collapsed");
+                return;
+            }
+            if (arg === "auto") {
+                ctx.setSidebarMode("auto");
+                return;
+            }
+            return "Usage: /sidebar [open|close|auto]";
+        },
+    },
     {
         name: "clear",
         description: "Clear the current conversation history",
         async handler(args, ctx) {
             ctx.agent.messages = ctx.agent.messages.filter((m) => m.role === "system" || m.role === "meta");
             ctx.sessionManager?.appendMarker("conversation_clear", "");
+            ctx.sessionManager?.clearTitleMetadata?.();
             if (ctx.agent.getTodos().length > 0) {
                 ctx.agent.setTodos([]);
             }

package/dist/slash-commands/registry.js

@@ -48,7 +48,7 @@ export class SlashCommandRegistry {
             if (skill) {
                 return {
                     handled: true,
-                    result: `Skill "${skill.meta.name}": ${skill.meta.description}\nUse /${skill.meta.name} <your request> to run with this skill, or /skill ${skill.meta.name} to inspect it.`,
+                    result: `Skill "${skill.meta.name}": ${skill.meta.description}\nUse /${skill.meta.name} <your request> to run with this skill, or /skills to choose from the picker.`,
                 };
             }
             return {

package/dist/slash-commands/types.d.ts

@@ -9,6 +9,12 @@ import type { McpManager } from "../mcp/manager.js";
 import type { LspService } from "../lsp/index.js";
 import type { MemoryScope } from "../memory/index.js";
 import type { ThemeMode } from "../config.js";
+export type SidebarMode = "auto" | "expanded" | "collapsed";
+export interface SidebarCommandState {
+    mode: SidebarMode;
+    visible: boolean;
+    active: boolean;
+}
 export interface SlashCommandContext {
     agent: Agent;
     addMessage: (role: "user" | "assistant" | "error", content: string) => void;
@@ -34,6 +40,10 @@ export interface SlashCommandContext {
     getResolvedTheme?: () => "light" | "dark";
     /** Persist a new theme mode AND apply it to the running TUI. */
     setThemeMode?: (mode: ThemeMode) => void;
+    /** Toggle the right session sidebar in the running TUI. */
+    toggleSidebar?: () => SidebarCommandState;
+    /** Set the right session sidebar mode in the running TUI. */
+    setSidebarMode?: (mode: SidebarMode) => SidebarCommandState;
     /** Open the feedback dialog. `initialDescription` prefills the description field. */
     openFeedback?: (initialDescription: string) => void;
 }

package/dist/text-display.d.ts

@@ -0,0 +1,3 @@
+export declare function normalizeSingleLine(text: string): string;
+export declare function truncateVisual(text: string, maxWidth: number): string;
+export declare function padVisual(text: string, width: number): string;

package/dist/text-display.js

@@ -0,0 +1,25 @@
+import stringWidth from "string-width";
+export function normalizeSingleLine(text) {
+    return text.replace(/\s+/g, " ").trim();
+}
+export function truncateVisual(text, maxWidth) {
+    if (maxWidth <= 0)
+        return "";
+    if (stringWidth(text) <= maxWidth)
+        return text;
+    if (maxWidth === 1)
+        return "…";
+    let out = "";
+    let width = 0;
+    for (const ch of text) {
+        const chWidth = stringWidth(ch);
+        if (width + chWidth > maxWidth - 1)
+            break;
+        out += ch;
+        width += chWidth;
+    }
+    return `${out}…`;
+}
+export function padVisual(text, width) {
+    return `${text}${" ".repeat(Math.max(0, width - stringWidth(text)))}`;
+}

package/dist/tools/index.d.ts

@@ -11,6 +11,7 @@ export { createLspTool } from "./lsp.js";
 export { createWebFetchTool } from "./web-fetch.js";
 export { createWebSearchTool } from "./web-search.js";
 export { createSkillTool } from "./skill.js";
+export { createSkillSearchTool } from "./skill-search.js";
 export { createAgentLifecycleTools, createCloseAgentTool, createSendInputTool, createSpawnAgentTool, createWaitAgentTool } from "./agent-lifecycle.js";
 export { createTodoTool, type TodoStore } from "./todo.js";
 export { createExitPlanModeTool, type PlanController } from "./exit-plan-mode.js";

package/dist/tools/index.js

@@ -11,6 +11,7 @@ export { createLspTool } from "./lsp.js";
 export { createWebFetchTool } from "./web-fetch.js";
 export { createWebSearchTool } from "./web-search.js";
 export { createSkillTool } from "./skill.js";
+export { createSkillSearchTool } from "./skill-search.js";
 export { createAgentLifecycleTools, createCloseAgentTool, createSendInputTool, createSpawnAgentTool, createWaitAgentTool } from "./agent-lifecycle.js";
 export { createTodoTool } from "./todo.js";
 export { createExitPlanModeTool } from "./exit-plan-mode.js";
@@ -26,6 +27,7 @@ import { getLspService } from "../lsp/index.js";
 import { createLspTool } from "./lsp.js";
 import { createReadTool } from "./read.js";
 import { createSkillTool } from "./skill.js";
+import { createSkillSearchTool } from "./skill-search.js";
 import { createAgentLifecycleTools } from "./agent-lifecycle.js";
 import { createTodoTool } from "./todo.js";
 import { createToolSearchTool } from "./tool-search.js";
@@ -53,7 +55,7 @@ export function createAllTools(cwd, skillRegistry, options = {}) {
         createMemoryReadSummaryTool(cwd),
         ...createAgentLifecycleTools(),
         ...(options.questionController ? [createQuestionTool(options.questionController)] : []),
-        ...(skillRegistry ? [createSkillTool(skillRegistry)] : []),
+        ...(skillRegistry ? [createSkillSearchTool(skillRegistry), createSkillTool(skillRegistry)] : []),
         ...(options.todoStore ? [createTodoTool(options.todoStore)] : []),
         ...(options.planController ? [createExitPlanModeTool(options.planController)] : []),
         ...(options.toolSearchController ? [createToolSearchTool(options.toolSearchController)] : []),

package/dist/tools/skill-search.d.ts

@@ -0,0 +1,10 @@
+import type { SkillRegistry } from "../skills/registry.js";
+import type { SkillSummary } from "../skills/types.js";
+import type { ToolRegistryEntry } from "../types.js";
+interface SkillSearchMatch {
+    skill: SkillSummary;
+    score: number;
+}
+export declare function createSkillSearchTool(registry: SkillRegistry): ToolRegistryEntry;
+export declare function searchSkillSummaries(skills: SkillSummary[], query: string): SkillSearchMatch[];
+export {};