@soulcraft/sdk 1.6.2 → 2.0.0

package/dist/server/handlers/chat/engine.js

@@ -0,0 +1,442 @@
+/**
+ * @module server/handlers/chat/engine
+ * @description The core streaming chat engine — agentic tool-use loop with
+ * stuck detection, timeout protection, and fire-and-forget persistence.
+ *
+ * The engine is transport-agnostic: it yields `ChatStreamChunk` frames via
+ * an `AsyncGenerator`. The transport layer (SSE, WebSocket, PostMessage)
+ * delivers those chunks to the client.
+ *
+ * ## Agentic Loop
+ *
+ * When Claude calls a tool, the engine:
+ * 1. Executes the tool via the injected {@link ToolExecutor}
+ * 2. Feeds the result back to Claude as a `tool_result` message
+ * 3. Claude continues (more text, more tool calls, or `message_stop`)
+ * 4. Repeat until no more tool calls, max iterations, or timeout
+ *
+ * ## Stuck Detection
+ *
+ * If the same tool with the same input is called 3 times consecutively,
+ * the engine breaks the loop to prevent infinite spinning.
+ *
+ * ## Fire-and-Forget
+ *
+ * Message storage, auto-titling, and background learning happen async
+ * without blocking the stream.
+ */
+import { retrieveRelevantMemory, loadUserExpertiseProfile, generateExpertisePromptAdditions, learnFromConversation, updateUserExpertiseProfile } from './memory.js';
+import { createConversation, storeMessage, loadConversationHistory, autoTitleConversation } from './conversations.js';
+// ─────────────────────────────────────────────────────────────────────────────
+// Default System Prompt
+// ─────────────────────────────────────────────────────────────────────────────
+/**
+ * Minimal system prompt used when no {@link SystemPromptBuilder} is provided.
+ *
+ * Products should always inject their own prompt builder for full functionality.
+ */
+const DEFAULT_SYSTEM_PROMPT = `You are a helpful AI assistant with access to a knowledge graph. Use the available tools to help the user manage their workspace.`;
+/**
+ * Default system prompt builder — returns the static default prompt.
+ */
+const defaultPromptBuilder = {
+    async build() {
+        return { staticPart: DEFAULT_SYSTEM_PROMPT, dynamicPart: '' };
+    },
+};
+/**
+ * Run the streaming chat engine for a single message.
+ *
+ * Yields {@link ChatStreamChunk} frames: `text`, `tool_use`, `tool_result`,
+ * `status`, `thinking_start`, `thinking_delta`, `thinking_end`, and
+ * terminal `done` or `error`.
+ *
+ * This is the core of the chat system — the full agentic loop with
+ * tool use, stuck detection, timeout, and fire-and-forget persistence.
+ *
+ * @param opts - Message options.
+ * @param handlerCtx - Handler context with brain, user, workspace.
+ * @param config - Chat handler configuration (injected dependencies).
+ * @yields ChatStreamChunk frames.
+ */
+export async function* streamMessage(opts, handlerCtx, config) {
+    const { brain } = handlerCtx;
+    const { aiClient, tools, toolExecutor, systemPromptBuilder = defaultPromptBuilder, billing, events, maxIterations = 100, maxDurationMs = 300_000, enableThinking = true, thinkingBudget = 8000, } = config;
+    const userId = handlerCtx.user?.id ?? 'anonymous';
+    const billingId = handlerCtx.user?.email ?? userId;
+    // ─── Billing Check ───────────────────────────────────────────────────
+    let billingTier = 'subscriber';
+    if (billing) {
+        const limitCheck = await billing.checkLimit(billingId, handlerCtx);
+        if (!limitCheck.ok) {
+            yield {
+                type: 'error',
+                error: limitCheck.tier === 'free'
+                    ? 'Free message limit reached. Subscribe for more.'
+                    : 'Monthly message limit reached.',
+            };
+            return;
+        }
+        billingTier = limitCheck.tier;
+    }
+    // ─── Conversation Setup ──────────────────────────────────────────────
+    let conversationId = opts.conversationId;
+    if (!conversationId) {
+        conversationId = await createConversation(brain, userId);
+    }
+    // Yield conversation ID immediately
+    yield { type: 'status', status: `conversation:${conversationId}` };
+    // ─── Fire-and-Forget: Store user message + auto-title ────────────────
+    storeMessage(brain, conversationId, 'user', opts.message, events).catch(() => { });
+    autoTitleConversation(brain, conversationId, opts.message).catch(() => { });
+    // ─── Parallel Context Loading ────────────────────────────────────────
+    const [conversationHistory, retrievedMemory, expertise] = await Promise.all([
+        loadConversationHistory(brain, conversationId, 20).catch(() => []),
+        retrieveRelevantMemory(brain, opts.message).catch(() => null),
+        loadUserExpertiseProfile(brain).catch(() => null),
+    ]);
+    // ─── Build System Prompt ─────────────────────────────────────────────
+    const promptCtx = {
+        brain,
+        handlerCtx,
+        conversationHistory,
+        memory: retrievedMemory,
+        expertise,
+        ...(opts.productContext != null ? { productContext: opts.productContext } : {}),
+    };
+    const { staticPart, dynamicPart } = await systemPromptBuilder.build(promptCtx);
+    // Add expertise adaptations
+    let fullDynamicPart = dynamicPart;
+    if (expertise) {
+        const expertiseAdditions = generateExpertisePromptAdditions(expertise);
+        if (expertiseAdditions) {
+            fullDynamicPart += '\n\n# User Partnership Profile\n' + expertiseAdditions;
+        }
+    }
+    // System prompt array for prompt caching
+    const systemPromptBlocks = [
+        { type: 'text', text: staticPart, cache_control: { type: 'ephemeral' } },
+        { type: 'text', text: fullDynamicPart },
+    ];
+    // ─── Build Messages Array ────────────────────────────────────────────
+    // Current message isn't in history yet (fire-and-forget), so append it
+    const messages = [
+        ...conversationHistory.map(msg => ({ role: msg.role, content: msg.content })),
+        { role: 'user', content: opts.message },
+    ];
+    // ─── Select Model ───────────────────────────────────────────────────
+    const selectedModel = opts.model
+        ?? (billingTier === 'free' ? (config.freeTierModel ?? 'claude-3-5-haiku-latest') : (config.defaultModel ?? 'claude-3-5-haiku-latest'));
+    // ─── Initial Claude Call ─────────────────────────────────────────────
+    const apiStream = await aiClient.createStream({
+        model: selectedModel,
+        maxTokens: enableThinking ? 16000 : 4096,
+        system: systemPromptBlocks,
+        messages,
+        tools,
+        ...(enableThinking ? { thinking: { type: 'enabled', budget_tokens: thinkingBudget } } : {}),
+    });
+    let fullResponse = '';
+    let toolUseBlock = null;
+    let thinkingActive = false;
+    let assistantMessageId = null;
+    let totalInputTokens = 0;
+    let totalOutputTokens = 0;
+    let agentStep = 0;
+    // ─── Process Initial Stream ──────────────────────────────────────────
+    for await (const event of apiStream) {
+        const chunks = processStreamEvent(event, toolUseBlock, thinkingActive);
+        for (const action of chunks) {
+            switch (action.type) {
+                case 'text':
+                    fullResponse += action.text;
+                    yield { type: 'text', text: action.text };
+                    break;
+                case 'thinking_start':
+                    thinkingActive = true;
+                    yield { type: 'status', status: 'thinking_start' };
+                    break;
+                case 'thinking_delta':
+                    yield { type: 'status', status: `thinking:${action.text}` };
+                    break;
+                case 'thinking_end':
+                    thinkingActive = false;
+                    yield { type: 'status', status: 'thinking_end' };
+                    break;
+                case 'tool_block_start':
+                    toolUseBlock = { id: action.id, name: action.name, inputJson: '' };
+                    break;
+                case 'tool_input_delta':
+                    if (toolUseBlock)
+                        toolUseBlock.inputJson += action.text ?? '';
+                    break;
+                case 'tool_block_stop':
+                    // Handled below after loop iteration
+                    break;
+                case 'usage_input':
+                    totalInputTokens = action.tokens;
+                    break;
+                case 'usage_output':
+                    totalOutputTokens = action.tokens;
+                    break;
+            }
+        }
+        // ─── Tool Execution ──────────────────────────────────────────────
+        if (event.type === 'content_block_stop' && toolUseBlock) {
+            const parsedInput = safeParseJson(toolUseBlock.inputJson);
+            agentStep++;
+            yield {
+                type: 'tool_use',
+                toolCall: { id: toolUseBlock.id, name: toolUseBlock.name, input: parsedInput },
+            };
+            // Store assistant message for tool context
+            if (!assistantMessageId) {
+                assistantMessageId = await storeMessage(brain, conversationId, 'assistant', fullResponse || '[Tool use]', events);
+            }
+            const toolCtx = {
+                brain,
+                conversationId,
+                assistantMessageId,
+                handlerCtx,
+                ...(opts.productContext != null ? { productContext: opts.productContext } : {}),
+            };
+            try {
+                const toolResult = await toolExecutor.execute(toolUseBlock.name, parsedInput, toolCtx);
+                yield {
+                    type: 'tool_result',
+                    toolResult: { toolUseId: toolUseBlock.id, content: JSON.stringify(toolResult) },
+                };
+                // ─── Agentic Loop ──────────────────────────────────────────
+                let conversationMessages = [
+                    ...messages,
+                    { role: 'assistant', content: [{ type: 'tool_use', id: toolUseBlock.id, name: toolUseBlock.name, input: parsedInput }] },
+                    { role: 'user', content: [{ type: 'tool_result', tool_use_id: toolUseBlock.id, content: JSON.stringify(toolResult) }] },
+                ];
+                const loopStartTime = Date.now();
+                const recentToolCalls = [];
+                let continueLoop = true;
+                let loopCount = 0;
+                while (continueLoop && loopCount < maxIterations) {
+                    loopCount++;
+                    // Timeout check
+                    if (Date.now() - loopStartTime > maxDurationMs) {
+                        yield { type: 'text', text: '\n\n*Task taking longer than expected. Pausing here.*' };
+                        break;
+                    }
+                    const followUpStream = await aiClient.createStream({
+                        model: selectedModel,
+                        maxTokens: 4096,
+                        system: systemPromptBlocks,
+                        messages: conversationMessages,
+                        tools,
+                    });
+                    let followUpToolBlock = null;
+                    let hasToolUse = false;
+                    for await (const followUpEvent of followUpStream) {
+                        if (followUpEvent.type === 'content_block_start' && followUpEvent.content_block?.type === 'tool_use') {
+                            followUpToolBlock = {
+                                id: followUpEvent.content_block.id || '',
+                                name: followUpEvent.content_block.name || '',
+                                inputJson: '',
+                            };
+                            hasToolUse = true;
+                        }
+                        if (followUpEvent.type === 'content_block_delta') {
+                            if (followUpEvent.delta?.type === 'text_delta' && followUpEvent.delta.text) {
+                                fullResponse += followUpEvent.delta.text;
+                                yield { type: 'text', text: followUpEvent.delta.text };
+                            }
+                            if (followUpEvent.delta?.type === 'input_json_delta' && followUpToolBlock) {
+                                followUpToolBlock.inputJson += followUpEvent.delta.partial_json ?? '';
+                            }
+                        }
+                        if (followUpEvent.type === 'message_start' && followUpEvent.message?.usage?.input_tokens) {
+                            totalInputTokens += followUpEvent.message.usage.input_tokens;
+                        }
+                        if (followUpEvent.type === 'message_delta' && followUpEvent.usage?.output_tokens) {
+                            totalOutputTokens += followUpEvent.usage.output_tokens;
+                        }
+                        // Tool block stop in follow-up
+                        if (followUpEvent.type === 'content_block_stop' && followUpToolBlock) {
+                            const parsedFollowUpInput = safeParseJson(followUpToolBlock.inputJson);
+                            agentStep++;
+                            // Stuck detection
+                            const inputHash = JSON.stringify(parsedFollowUpInput);
+                            recentToolCalls.push({ name: followUpToolBlock.name, inputHash });
+                            if (recentToolCalls.length >= 3) {
+                                const last3 = recentToolCalls.slice(-3);
+                                if (last3.every(c => c.name === last3[0].name && c.inputHash === last3[0].inputHash)) {
+                                    yield { type: 'text', text: '\n\n*I seem to be repeating the same action. Let me stop here.*' };
+                                    continueLoop = false;
+                                    break;
+                                }
+                            }
+                            yield {
+                                type: 'tool_use',
+                                toolCall: { id: followUpToolBlock.id, name: followUpToolBlock.name, input: parsedFollowUpInput },
+                            };
+                            const followUpToolResult = await toolExecutor.execute(followUpToolBlock.name, parsedFollowUpInput, toolCtx);
+                            yield {
+                                type: 'tool_result',
+                                toolResult: { toolUseId: followUpToolBlock.id, content: JSON.stringify(followUpToolResult) },
+                            };
+                            conversationMessages = [
+                                ...conversationMessages,
+                                { role: 'assistant', content: [{ type: 'tool_use', id: followUpToolBlock.id, name: followUpToolBlock.name, input: parsedFollowUpInput }] },
+                                { role: 'user', content: [{ type: 'tool_result', tool_use_id: followUpToolBlock.id, content: JSON.stringify(followUpToolResult) }] },
+                            ];
+                            followUpToolBlock = null;
+                        }
+                        if (followUpEvent.type === 'message_stop') {
+                            if (!hasToolUse)
+                                continueLoop = false;
+                        }
+                    }
+                }
+                // Max iterations warning
+                if (loopCount >= maxIterations) {
+                    yield { type: 'text', text: '\n\n*Reached maximum tool call limit.*' };
+                }
+            }
+            catch (toolError) {
+                const errMsg = toolError instanceof Error ? toolError.message : String(toolError);
+                yield { type: 'error', error: `Tool error: ${errMsg}` };
+            }
+            toolUseBlock = null;
+        }
+        // ─── Message Complete ────────────────────────────────────────────
+        if (event.type === 'message_stop') {
+            // Store or update assistant message
+            if (fullResponse && !assistantMessageId) {
+                assistantMessageId = await storeMessage(brain, conversationId, 'assistant', fullResponse, events);
+            }
+            else if (fullResponse && assistantMessageId) {
+                try {
+                    const existing = await brain.get(assistantMessageId);
+                    if (existing) {
+                        await brain.update({ id: assistantMessageId, data: { ...existing.data, content: fullResponse } });
+                    }
+                }
+                catch { /* non-fatal */ }
+            }
+            // Background learning (fire-and-forget)
+            backgroundLearn(brain, conversationId).catch(() => { });
+        }
+    }
+    // ─── Record Usage ──────────────────────────────────────────────────
+    if (billing) {
+        billing.recordUsage(billingId, totalInputTokens, totalOutputTokens, selectedModel);
+    }
+    // ─── Terminal Done Frame ───────────────────────────────────────────
+    yield {
+        type: 'done',
+        usage: { inputTokens: totalInputTokens, outputTokens: totalOutputTokens, model: selectedModel },
+    };
+}
+// ─────────────────────────────────────────────────────────────────────────────
+// Non-Streaming Send
+// ─────────────────────────────────────────────────────────────────────────────
+/**
+ * Send a message and collect the full response (non-streaming).
+ *
+ * Internally uses the streaming engine and collects all text chunks.
+ *
+ * @param opts - Message options.
+ * @param handlerCtx - Handler context.
+ * @param config - Chat handler configuration.
+ * @returns Complete response with conversation ID and usage.
+ */
+export async function sendMessage(opts, handlerCtx, config) {
+    let fullText = '';
+    let conversationId = opts.conversationId ?? '';
+    let usage = { inputTokens: 0, outputTokens: 0, model: '' };
+    for await (const chunk of streamMessage(opts, handlerCtx, config)) {
+        if (chunk.type === 'text' && chunk.text)
+            fullText += chunk.text;
+        if (chunk.type === 'status' && chunk.status?.startsWith('conversation:')) {
+            conversationId = chunk.status.slice('conversation:'.length);
+        }
+        if (chunk.type === 'done' && chunk.usage)
+            usage = chunk.usage;
+        if (chunk.type === 'error')
+            throw new Error(chunk.error);
+    }
+    return { response: fullText, conversationId, usage };
+}
+/**
+ * Process a single Anthropic stream event into internal actions.
+ *
+ * @param event - Raw stream event from the AI client.
+ * @param toolUseBlock - Current tool use block (if in progress).
+ * @param thinkingActive - Whether thinking mode is active.
+ * @returns Array of actions to process.
+ */
+function processStreamEvent(event, toolUseBlock, thinkingActive) {
+    const actions = [];
+    if (event.type === 'content_block_start') {
+        if (event.content_block?.type === 'tool_use') {
+            actions.push({
+                type: 'tool_block_start',
+                id: event.content_block.id ?? '',
+                name: event.content_block.name ?? '',
+            });
+        }
+        if (event.content_block?.type === 'thinking') {
+            actions.push({ type: 'thinking_start' });
+        }
+    }
+    if (event.type === 'content_block_delta') {
+        if (event.delta?.type === 'text_delta' && event.delta.text) {
+            actions.push({ type: 'text', text: event.delta.text });
+        }
+        if (event.delta?.type === 'thinking_delta' && event.delta.thinking) {
+            actions.push({ type: 'thinking_delta', text: event.delta.thinking });
+        }
+        if (event.delta?.type === 'input_json_delta' && toolUseBlock) {
+            actions.push({ type: 'tool_input_delta', text: event.delta.partial_json ?? '' });
+        }
+    }
+    if (event.type === 'content_block_stop') {
+        if (thinkingActive) {
+            actions.push({ type: 'thinking_end' });
+        }
+        if (toolUseBlock) {
+            actions.push({ type: 'tool_block_stop' });
+        }
+    }
+    if (event.type === 'message_start' && event.message?.usage?.input_tokens) {
+        actions.push({ type: 'usage_input', tokens: event.message.usage.input_tokens });
+    }
+    if (event.type === 'message_delta' && event.usage?.output_tokens) {
+        actions.push({ type: 'usage_output', tokens: event.usage.output_tokens });
+    }
+    return actions;
+}
+/**
+ * Safely parse JSON, returning an empty object on failure.
+ *
+ * @param json - JSON string to parse.
+ * @returns Parsed object or empty object.
+ */
+function safeParseJson(json) {
+    try {
+        return json ? JSON.parse(json) : {};
+    }
+    catch {
+        return {};
+    }
+}
+/**
+ * Background learning — extract insights and update expertise profile.
+ *
+ * @param brain - Brainy instance.
+ * @param conversationId - Conversation to learn from.
+ */
+async function backgroundLearn(brain, conversationId) {
+    const messages = await loadConversationHistory(brain, conversationId, 10);
+    await Promise.all([
+        learnFromConversation(brain, conversationId, messages),
+        updateUserExpertiseProfile(brain, messages),
+    ]);
+}
+//# sourceMappingURL=engine.js.map

package/dist/server/handlers/chat/engine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine.js","sourceRoot":"","sources":["../../../../src/server/handlers/chat/engine.ts"],"names":[],"mappings":"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"}

package/dist/server/handlers/chat/executor.d.ts

@@ -0,0 +1,65 @@
+/**
+ * @module server/handlers/chat/executor
+ * @description Plan step execution with dependency resolution and auto-escalation.
+ *
+ * The executor runs approved plans step-by-step:
+ * 1. Topologically sorts steps by dependencies
+ * 2. Executes each step using the executor model (Haiku)
+ * 3. Auto-escalates to the fallback model (Sonnet) on step failure
+ * 4. Skips steps whose dependencies failed
+ * 5. Tracks cost and reports progress via callbacks
+ *
+ * Each step is sent to Claude with its description, the plan's goal, and
+ * completed step context. Claude uses the product's tool set to execute.
+ */
+import type { Brainy } from '@soulcraft/brainy';
+import type { ChatAIClient, ToolDefinition, ToolExecutor, ToolExecutionContext, AIPlan, StepProgress, PlanExecutionResult } from './types.js';
+/** Callback for plan execution progress. */
+export type ProgressCallback = (progress: StepProgress) => Promise<void>;
+/**
+ * Options for executing a plan.
+ */
+export interface ExecutePlanOptions {
+    /** The approved plan to execute. */
+    plan: AIPlan;
+    /** Brainy entity ID of the plan. */
+    planId: string;
+    /** Brainy instance. */
+    brain: Brainy;
+    /** AI client for calling Claude. */
+    aiClient: ChatAIClient;
+    /** Available tool definitions. */
+    tools: ToolDefinition[];
+    /** Tool executor. */
+    toolExecutor: ToolExecutor;
+    /** Tool execution context. */
+    toolContext: ToolExecutionContext;
+    /** Progress callback. */
+    onProgress?: ProgressCallback;
+    /** Executor model. Defaults to Haiku. */
+    executeModel?: string;
+    /** Fallback model for escalation. Defaults to Sonnet. */
+    fallbackModel?: string;
+}
+/**
+ * Execute an approved plan step-by-step.
+ *
+ * Steps are topologically sorted by dependencies. Each step is executed with
+ * the executor model; on failure, auto-escalates to the fallback model.
+ * Steps whose dependencies failed are skipped.
+ *
+ * @param options - Plan execution configuration.
+ * @returns Execution result with per-step details and total cost.
+ */
+export declare function executePlan(options: ExecutePlanOptions): Promise<PlanExecutionResult>;
+/**
+ * Resume execution of a partially completed plan.
+ *
+ * Finds pending/failed steps and re-executes them.
+ *
+ * @param options - Execution options (without plan — loaded from Brainy).
+ * @param planId - Brainy entity ID of the plan.
+ * @returns Execution result for the remaining steps.
+ */
+export declare function resumePlanExecution(options: Omit<ExecutePlanOptions, 'plan'>, planId: string): Promise<PlanExecutionResult>;
+//# sourceMappingURL=executor.d.ts.map

package/dist/server/handlers/chat/executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"executor.d.ts","sourceRoot":"","sources":["../../../../src/server/handlers/chat/executor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAA;AAC/C,OAAO,KAAK,EACV,YAAY,EACZ,cAAc,EACd,YAAY,EACZ,oBAAoB,EACpB,MAAM,EAEN,YAAY,EACZ,mBAAmB,EACpB,MAAM,YAAY,CAAA;AAmBnB,4CAA4C;AAC5C,MAAM,MAAM,gBAAgB,GAAG,CAAC,QAAQ,EAAE,YAAY,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;AAExE;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,oCAAoC;IACpC,IAAI,EAAE,MAAM,CAAA;IACZ,oCAAoC;IACpC,MAAM,EAAE,MAAM,CAAA;IACd,uBAAuB;IACvB,KAAK,EAAE,MAAM,CAAA;IACb,oCAAoC;IACpC,QAAQ,EAAE,YAAY,CAAA;IACtB,kCAAkC;IAClC,KAAK,EAAE,cAAc,EAAE,CAAA;IACvB,qBAAqB;IACrB,YAAY,EAAE,YAAY,CAAA;IAC1B,8BAA8B;IAC9B,WAAW,EAAE,oBAAoB,CAAA;IACjC,yBAAyB;IACzB,UAAU,CAAC,EAAE,gBAAgB,CAAA;IAC7B,yCAAyC;IACzC,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,yDAAyD;IACzD,aAAa,CAAC,EAAE,MAAM,CAAA;CACvB;AA0BD;;;;;;;;;GASG;AACH,wBAAsB,WAAW,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAoJ3F;AAED;;;;;;;;GAQG;AACH,wBAAsB,mBAAmB,CACvC,OAAO,EAAE,IAAI,CAAC,kBAAkB,EAAE,MAAM,CAAC,EACzC,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,mBAAmB,CAAC,CA6B9B"}