@soulcraft/sdk 1.7.0 → 2.0.0

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

@@ -0,0 +1,375 @@
+/**
+ * @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 { DEFAULT_MODEL_TIERS, getModelPricing, getModelShortName } from './models.js';
+import { updatePlan, loadPlan } from './planner.js';
+// ─────────────────────────────────────────────────────────────────────────────
+// Step Execution Prompt
+// ─────────────────────────────────────────────────────────────────────────────
+const STEP_EXECUTION_PROMPT = `You are an AI assistant executing a specific step in a larger plan.
+
+Your task is to execute ONLY the following step:
+{step_description}
+
+Context from the plan:
+- Overall goal: {plan_goal}
+- Previous steps completed: {completed_steps}
+
+Available tools: {available_tools}
+
+Execute this step by using the appropriate tools. Be focused and efficient.
+Only do what this step requires — nothing more, nothing less.
+
+After completing the step, briefly summarize what was done.`;
+// ─────────────────────────────────────────────────────────────────────────────
+// Plan Execution
+// ─────────────────────────────────────────────────────────────────────────────
+/**
+ * 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 async function executePlan(options) {
+    const { plan, planId, brain, aiClient, tools, toolExecutor, toolContext, onProgress, executeModel = DEFAULT_MODEL_TIERS.executor, fallbackModel = DEFAULT_MODEL_TIERS.fallback, } = options;
+    if (plan.status !== 'approved') {
+        throw new Error(`Plan must be approved before execution. Current status: ${plan.status}`);
+    }
+    // Mark plan as executing
+    await updatePlan(brain, planId, {
+        status: 'executing',
+        startedAt: new Date().toISOString(),
+    });
+    const stepResults = [];
+    let totalInputTokens = 0;
+    let totalOutputTokens = 0;
+    let escalationCount = 0;
+    const executionOrder = topologicalSort(plan.steps);
+    for (let i = 0; i < executionOrder.length; i++) {
+        const step = executionOrder[i];
+        // Check dependency satisfaction
+        const depsFailed = step.dependencies.some(depId => {
+            const depResult = stepResults.find(r => r.stepId === depId);
+            return !depResult || depResult.status === 'failed';
+        });
+        if (depsFailed) {
+            const skipResult = {
+                stepId: step.id,
+                status: 'skipped',
+                error: 'Dependencies not satisfied',
+                model: executeModel,
+                tokens: { input: 0, output: 0 },
+                escalated: false,
+            };
+            stepResults.push(skipResult);
+            await updateStepStatus(brain, planId, step.id, 'skipped');
+            continue;
+        }
+        // Progress notification
+        if (onProgress) {
+            await onProgress({
+                type: 'step_start',
+                stepId: step.id,
+                stepIndex: i,
+                totalSteps: executionOrder.length,
+                description: step.activeDescription,
+                model: getModelShortName(executeModel),
+            });
+        }
+        // Execute step
+        let result = await executeStep({
+            step, plan, aiClient, tools, toolExecutor, toolContext,
+            completedSteps: stepResults.filter(r => r.status === 'completed'),
+            model: executeModel,
+        });
+        // Auto-escalate on failure
+        if (result.status === 'failed' && fallbackModel !== executeModel) {
+            escalationCount++;
+            if (onProgress) {
+                await onProgress({
+                    type: 'escalating',
+                    stepId: step.id,
+                    stepIndex: i,
+                    totalSteps: executionOrder.length,
+                    description: `Retrying with ${getModelShortName(fallbackModel)}`,
+                    model: getModelShortName(fallbackModel),
+                });
+            }
+            result = await executeStep({
+                step, plan, aiClient, tools, toolExecutor, toolContext,
+                completedSteps: stepResults.filter(r => r.status === 'completed'),
+                model: fallbackModel,
+            });
+            result.escalated = true;
+        }
+        stepResults.push(result);
+        totalInputTokens += result.tokens.input;
+        totalOutputTokens += result.tokens.output;
+        // Update step in the stored plan
+        await updateStepInPlan(brain, planId, step.id, result);
+        // Progress notification
+        if (onProgress) {
+            await onProgress({
+                type: result.status === 'failed' ? 'step_error' : 'step_complete',
+                stepId: step.id,
+                stepIndex: i,
+                totalSteps: executionOrder.length,
+                description: step.description,
+                ...(result.result != null ? { result: result.result } : {}),
+                ...(result.error != null ? { error: result.error } : {}),
+            });
+        }
+    }
+    // Calculate final status and cost
+    const anyError = stepResults.some(r => r.status === 'failed');
+    const finalStatus = anyError ? 'failed' : 'completed';
+    const actualCost = calculateActualCost(stepResults);
+    const planCost = calculatePlanCost(plan);
+    await updatePlan(brain, planId, {
+        status: finalStatus,
+        completedAt: new Date().toISOString(),
+        actualCost: {
+            inputTokens: totalInputTokens,
+            outputTokens: totalOutputTokens,
+            totalUSD: actualCost + planCost,
+        },
+    });
+    return {
+        success: !anyError,
+        stepResults: stepResults.map(r => ({
+            stepId: r.stepId,
+            status: r.status,
+            ...(r.result != null ? { result: r.result } : {}),
+            ...(r.error != null ? { error: r.error } : {}),
+            model: r.model,
+            tokens: r.tokens,
+            escalated: r.escalated,
+        })),
+        totalTokens: { input: totalInputTokens, output: totalOutputTokens },
+        actualCost: actualCost + planCost,
+        escalationCount,
+    };
+}
+/**
+ * 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 async function resumePlanExecution(options, planId) {
+    const { brain } = options;
+    const plan = await loadPlan(brain, planId);
+    if (!plan)
+        throw new Error(`Plan not found: ${planId}`);
+    const pendingSteps = plan.steps.filter(s => s.status === 'pending' || s.status === 'failed');
+    if (pendingSteps.length === 0) {
+        return {
+            success: true,
+            stepResults: [],
+            totalTokens: { input: 0, output: 0 },
+            actualCost: 0,
+            escalationCount: 0,
+        };
+    }
+    await updatePlan(brain, planId, { status: 'executing' });
+    const modifiedPlan = {
+        ...plan,
+        status: 'approved',
+        steps: pendingSteps.map(s => ({ ...s, status: 'pending' })),
+    };
+    return executePlan({ ...options, plan: modifiedPlan, planId });
+}
+/**
+ * Execute a single plan step using a specific model.
+ *
+ * @param options - Step execution options.
+ * @returns Step result.
+ */
+async function executeStep(options) {
+    const { step, plan, aiClient, tools, toolExecutor, toolContext, completedSteps, model } = options;
+    const completedSummary = completedSteps.length > 0
+        ? completedSteps.map(s => `- ${s.stepId}: ${s.result ? 'Completed' : 'Error'}`).join('\n')
+        : 'None yet';
+    const availableTools = step.tools.length > 0
+        ? step.tools.join(', ')
+        : 'All available tools';
+    const prompt = STEP_EXECUTION_PROMPT
+        .replace('{step_description}', step.description)
+        .replace('{plan_goal}', plan.userMessage)
+        .replace('{completed_steps}', completedSummary)
+        .replace('{available_tools}', availableTools);
+    try {
+        const response = await aiClient.create({
+            model,
+            maxTokens: 8192,
+            system: prompt,
+            messages: [{ role: 'user', content: `Execute step: ${step.description}` }],
+            tools,
+        });
+        let result = null;
+        let textResponse = '';
+        const inputTokens = response.usage?.input_tokens || 0;
+        const outputTokens = response.usage?.output_tokens || 0;
+        for (const block of response.content) {
+            if (block.type === 'text' && block.text) {
+                textResponse += block.text;
+            }
+            else if (block.type === 'tool_use' && block.name) {
+                try {
+                    result = await toolExecutor.execute(block.name, (block.input || {}), toolContext);
+                }
+                catch (toolError) {
+                    const message = toolError instanceof Error ? toolError.message : String(toolError);
+                    return {
+                        stepId: step.id,
+                        status: 'failed',
+                        error: `Tool error: ${message}`,
+                        model,
+                        tokens: { input: inputTokens, output: outputTokens },
+                        escalated: false,
+                    };
+                }
+            }
+        }
+        return {
+            stepId: step.id,
+            status: 'completed',
+            result: result ?? textResponse,
+            model,
+            tokens: { input: inputTokens, output: outputTokens },
+            escalated: false,
+        };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        return {
+            stepId: step.id,
+            status: 'failed',
+            error: message,
+            model,
+            tokens: { input: 0, output: 0 },
+            escalated: false,
+        };
+    }
+}
+// ─────────────────────────────────────────────────────────────────────────────
+// Internal: Helpers
+// ─────────────────────────────────────────────────────────────────────────────
+/**
+ * Topological sort of plan steps based on dependency edges.
+ *
+ * Detects circular dependencies and throws.
+ *
+ * @param steps - Plan steps with dependency references.
+ * @returns Steps in execution order.
+ */
+function topologicalSort(steps) {
+    const sorted = [];
+    const visited = new Set();
+    const visiting = new Set();
+    function visit(step) {
+        if (visited.has(step.id))
+            return;
+        if (visiting.has(step.id)) {
+            throw new Error(`Circular dependency detected at step ${step.id}`);
+        }
+        visiting.add(step.id);
+        for (const depId of step.dependencies) {
+            const depStep = steps.find(s => s.id === depId);
+            if (depStep)
+                visit(depStep);
+        }
+        visiting.delete(step.id);
+        visited.add(step.id);
+        sorted.push(step);
+    }
+    for (const step of steps) {
+        visit(step);
+    }
+    return sorted;
+}
+/**
+ * Update a step's status in the stored plan.
+ *
+ * @param brain - Brainy instance.
+ * @param planId - Plan entity ID.
+ * @param stepId - Step to update.
+ * @param status - New status.
+ */
+async function updateStepStatus(brain, planId, stepId, status) {
+    const plan = await loadPlan(brain, planId);
+    if (!plan)
+        return;
+    const updatedSteps = plan.steps.map(s => s.id === stepId
+        ? { ...s, status: status, ...(status === 'running' ? { startedAt: new Date().toISOString() } : {}) }
+        : s);
+    await updatePlan(brain, planId, { steps: updatedSteps });
+}
+/**
+ * Update a step with its execution result.
+ *
+ * @param brain - Brainy instance.
+ * @param planId - Plan entity ID.
+ * @param stepId - Step to update.
+ * @param result - Step execution result.
+ */
+async function updateStepInPlan(brain, planId, stepId, result) {
+    const plan = await loadPlan(brain, planId);
+    if (!plan)
+        return;
+    const updatedSteps = plan.steps.map(s => s.id === stepId
+        ? {
+            ...s,
+            status: result.status,
+            ...(result.result != null ? { result: result.result } : {}),
+            ...(result.error != null ? { error: result.error } : {}),
+            completedAt: new Date().toISOString(),
+        }
+        : s);
+    await updatePlan(brain, planId, { steps: updatedSteps });
+}
+/**
+ * Calculate actual execution cost from step results.
+ *
+ * @param stepResults - Completed step results.
+ * @returns Total cost in USD.
+ */
+function calculateActualCost(stepResults) {
+    let cost = 0;
+    for (const result of stepResults) {
+        const pricing = getModelPricing(result.model);
+        cost += (result.tokens.input / 1_000_000) * pricing.input;
+        cost += (result.tokens.output / 1_000_000) * pricing.output;
+    }
+    return cost;
+}
+/**
+ * Calculate the planning phase cost from the plan's estimated token usage.
+ *
+ * @param plan - The executed plan.
+ * @returns Planning phase cost in USD.
+ */
+function calculatePlanCost(plan) {
+    const pricing = getModelPricing(plan.planModel);
+    // estimatedCost.planTokens is the sum of input + output
+    return (plan.estimatedCost.planTokens / 1_000_000) * pricing.input;
+}
+//# sourceMappingURL=executor.js.map

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

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

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

@@ -0,0 +1,62 @@
+/**
+ * @module server/handlers/chat
+ * @description Chat namespace handler factory and barrel exports.
+ *
+ * Creates the `chat` namespace handler that implements {@link ChatNamespace}
+ * from `namespaces.ts`. The handler provides:
+ *
+ * - **`send`** — Non-streaming message with full response
+ * - **`sendStreaming`** — Streaming message with agentic tool-use loop
+ * - **`listConversations`** — List all conversations for the current user
+ * - **`getConversation`** — Get full conversation with message history
+ * - **`createConversation`** — Create a new conversation
+ * - **`deleteConversation`** — Soft-delete a conversation
+ * - **`renameConversation`** — Rename a conversation
+ * - **`getExpertise`** — Get the user's AI-learned expertise profile
+ * - **`getContext`** — Get the chat engine's context for the current message
+ *
+ * Products inject their dependencies via {@link ChatHandlerOptions}:
+ * - **Required**: `aiClient`, `tools`, `toolExecutor`
+ * - **Optional**: `systemPromptBuilder`, `modelSelector`, `billing`, `events`
+ *
+ * @example Workshop setup
+ * ```typescript
+ * import { createChatHandler } from '@soulcraft/sdk/server'
+ *
+ * const chatHandler = createChatHandler({
+ *   aiClient: workshopAIClient,
+ *   tools: workshopToolDefinitions,
+ *   toolExecutor: workshopToolExecutor,
+ *   systemPromptBuilder: workshopPromptBuilder,
+ *   billing: workshopBilling,
+ * })
+ * ```
+ */
+import type { NamespaceProvider } from '../../namespace-router.js';
+import type { ChatHandlerOptions } from './types.js';
+/**
+ * Creates the `chat` namespace handler.
+ *
+ * The returned provider implements all methods defined in {@link ChatNamespace}.
+ * The handler is stateless — all state lives in Brainy entities (conversations,
+ * messages, expertise profiles, insights).
+ *
+ * @param options - Chat handler dependencies. `aiClient`, `tools`, and
+ *   `toolExecutor` are required. All others have sensible defaults.
+ * @returns A {@link NamespaceProvider} implementing {@link ChatNamespace}.
+ */
+export declare function createChatHandler(options: ChatHandlerOptions): NamespaceProvider;
+export type { ChatHandlerOptions, ChatAIClient, AnthropicStreamEvent, ToolDefinition, ToolExecutor, ToolExecutionContext, SystemPromptBuilder, SystemPromptContext, ChatBillingCheck, ChatEventEmitter, ModelSelector, TieredRouting, RetrievedMemory, UserExpertiseProfile, RoutingDecisionType, RoutingDecision, DelegatedTask, TriageResult, TaskExecutionResult, DelegationResult, AIPlan, PlanStep, StepProgress, PlanExecutionResult, } from './types.js';
+export { analyzeComplexity, calculateComplexityScore, selectTieredRouting, createDefaultModelSelector, estimateCost, formatCost, getModelPricing, getModelShortName, DEFAULT_MODELS, DEFAULT_MODEL_TIERS, } from './models.js';
+export type { ModelConfig, ComplexitySignals, CostEstimate } from './models.js';
+export { triageMessage, executeTask, synthesizeResults, delegateAndExecute } from './delegator.js';
+export type { TriageOptions, ExecuteTaskOptions, SynthesizeOptions, DelegateOptions } from './delegator.js';
+export { generatePlan, storePlan, loadPlan, updatePlan, approvePlan, cancelPlan, getPendingPlans, addPlanStep, removePlanStep } from './planner.js';
+export type { GeneratePlanOptions } from './planner.js';
+export { executePlan, resumePlanExecution } from './executor.js';
+export type { ExecutePlanOptions, ProgressCallback } from './executor.js';
+export { createConversation, listConversations, getConversation, deleteConversation, renameConversation, storeMessage, loadConversationHistory, autoTitleConversation } from './conversations.js';
+export { retrieveRelevantMemory, learnFromConversation, loadUserExpertiseProfile, updateUserExpertiseProfile, generateExpertisePromptAdditions } from './memory.js';
+export { streamMessage, sendMessage } from './engine.js';
+export type { StreamMessageOptions } from './engine.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/server/handlers/chat/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAkB,MAAM,2BAA2B,CAAA;AAClF,OAAO,KAAK,EACV,kBAAkB,EAGnB,MAAM,YAAY,CAAA;AAmBnB;;;;;;;;;;GAUG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,kBAAkB,GAAG,iBAAiB,CA6KhF;AAOD,YAAY,EACV,kBAAkB,EAClB,YAAY,EACZ,oBAAoB,EACpB,cAAc,EACd,YAAY,EACZ,oBAAoB,EACpB,mBAAmB,EACnB,mBAAmB,EACnB,gBAAgB,EAChB,gBAAgB,EAChB,aAAa,EACb,aAAa,EACb,eAAe,EACf,oBAAoB,EACpB,mBAAmB,EACnB,eAAe,EACf,aAAa,EACb,YAAY,EACZ,mBAAmB,EACnB,gBAAgB,EAChB,MAAM,EACN,QAAQ,EACR,YAAY,EACZ,mBAAmB,GACpB,MAAM,YAAY,CAAA;AAGnB,OAAO,EACL,iBAAiB,EACjB,wBAAwB,EACxB,mBAAmB,EACnB,0BAA0B,EAC1B,YAAY,EACZ,UAAU,EACV,eAAe,EACf,iBAAiB,EACjB,cAAc,EACd,mBAAmB,GACpB,MAAM,aAAa,CAAA;AACpB,YAAY,EAAE,WAAW,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAG/E,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAA;AAClG,YAAY,EAAE,aAAa,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAA;AAG3G,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,QAAQ,EAAE,UAAU,EAAE,WAAW,EAAE,UAAU,EAAE,eAAe,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,cAAc,CAAA;AACnJ,YAAY,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAA;AAGvD,OAAO,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAA;AAChE,YAAY,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAA;AAGzE,OAAO,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,eAAe,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,YAAY,EAAE,uBAAuB,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAA;AAGjM,OAAO,EAAE,sBAAsB,EAAE,qBAAqB,EAAE,wBAAwB,EAAE,0BAA0B,EAAE,gCAAgC,EAAE,MAAM,aAAa,CAAA;AAGnK,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AACxD,YAAY,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAA"}

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

@@ -0,0 +1,182 @@
+/**
+ * @module server/handlers/chat
+ * @description Chat namespace handler factory and barrel exports.
+ *
+ * Creates the `chat` namespace handler that implements {@link ChatNamespace}
+ * from `namespaces.ts`. The handler provides:
+ *
+ * - **`send`** — Non-streaming message with full response
+ * - **`sendStreaming`** — Streaming message with agentic tool-use loop
+ * - **`listConversations`** — List all conversations for the current user
+ * - **`getConversation`** — Get full conversation with message history
+ * - **`createConversation`** — Create a new conversation
+ * - **`deleteConversation`** — Soft-delete a conversation
+ * - **`renameConversation`** — Rename a conversation
+ * - **`getExpertise`** — Get the user's AI-learned expertise profile
+ * - **`getContext`** — Get the chat engine's context for the current message
+ *
+ * Products inject their dependencies via {@link ChatHandlerOptions}:
+ * - **Required**: `aiClient`, `tools`, `toolExecutor`
+ * - **Optional**: `systemPromptBuilder`, `modelSelector`, `billing`, `events`
+ *
+ * @example Workshop setup
+ * ```typescript
+ * import { createChatHandler } from '@soulcraft/sdk/server'
+ *
+ * const chatHandler = createChatHandler({
+ *   aiClient: workshopAIClient,
+ *   tools: workshopToolDefinitions,
+ *   toolExecutor: workshopToolExecutor,
+ *   systemPromptBuilder: workshopPromptBuilder,
+ *   billing: workshopBilling,
+ * })
+ * ```
+ */
+import { streamMessage, sendMessage } from './engine.js';
+import { createConversation as createConv, listConversations as listConvs, getConversation as getConv, deleteConversation as deleteConv, renameConversation as renameConv, } from './conversations.js';
+import { retrieveRelevantMemory, loadUserExpertiseProfile, } from './memory.js';
+// ─────────────────────────────────────────────────────────────────────────────
+// Handler Factory
+// ─────────────────────────────────────────────────────────────────────────────
+/**
+ * Creates the `chat` namespace handler.
+ *
+ * The returned provider implements all methods defined in {@link ChatNamespace}.
+ * The handler is stateless — all state lives in Brainy entities (conversations,
+ * messages, expertise profiles, insights).
+ *
+ * @param options - Chat handler dependencies. `aiClient`, `tools`, and
+ *   `toolExecutor` are required. All others have sensible defaults.
+ * @returns A {@link NamespaceProvider} implementing {@link ChatNamespace}.
+ */
+export function createChatHandler(options) {
+    return {
+        /**
+         * Send a message and receive the full response (non-streaming).
+         *
+         * @param message - The user's message text.
+         * @param sendOptions - Conversation and model options.
+         * @param ctx - Handler context with brain, user, workspace.
+         * @returns Response text, conversation ID, and token usage.
+         */
+        async send(message, sendOptions, ctx) {
+            return sendMessage({
+                message,
+                ...(sendOptions?.conversationId != null ? { conversationId: sendOptions.conversationId } : {}),
+                ...(sendOptions?.model != null ? { model: sendOptions.model } : {}),
+                ...(sendOptions != null ? { productContext: sendOptions } : {}),
+            }, ctx, options);
+        },
+        /**
+         * Send a message and stream the response as chunks.
+         *
+         * Returns an AsyncIterable that the transport layer delivers as SSE,
+         * WebSocket frames, or PostMessage events.
+         *
+         * @param message - The user's message text.
+         * @param streamOptions - Conversation and model options.
+         * @param ctx - Handler context.
+         * @returns AsyncIterable of ChatStreamChunk frames.
+         */
+        sendStreaming(message, streamOptions, ctx) {
+            return streamMessage({
+                message,
+                ...(streamOptions?.conversationId != null ? { conversationId: streamOptions.conversationId } : {}),
+                ...(streamOptions?.model != null ? { model: streamOptions.model } : {}),
+                ...(streamOptions?.planModeEnabled != null ? { planModeEnabled: streamOptions.planModeEnabled } : {}),
+                ...(streamOptions != null ? { productContext: streamOptions } : {}),
+            }, ctx, options);
+        },
+        /**
+         * List all conversations for the current user.
+         *
+         * @param ctx - Handler context.
+         * @returns Array of conversation summaries.
+         */
+        async listConversations(ctx) {
+            const userId = ctx.user?.id ?? 'anonymous';
+            return listConvs(ctx.brain, userId);
+        },
+        /**
+         * Get a conversation with its full message history.
+         *
+         * @param conversationId - Conversation ID.
+         * @param ctx - Handler context.
+         * @returns Full conversation or null.
+         */
+        async getConversation(conversationId, ctx) {
+            return getConv(ctx.brain, conversationId);
+        },
+        /**
+         * Create a new conversation.
+         *
+         * @param createOptions - Optional title.
+         * @param ctx - Handler context.
+         * @returns The new conversation's ID.
+         */
+        async createConversation(createOptions, ctx) {
+            const userId = ctx.user?.id ?? 'anonymous';
+            return createConv(ctx.brain, userId, createOptions?.title);
+        },
+        /**
+         * Soft-delete a conversation.
+         *
+         * @param conversationId - Conversation to delete.
+         * @param ctx - Handler context.
+         */
+        async deleteConversation(conversationId, ctx) {
+            await deleteConv(ctx.brain, conversationId);
+        },
+        /**
+         * Rename a conversation.
+         *
+         * @param conversationId - Conversation to rename.
+         * @param title - New title.
+         * @param ctx - Handler context.
+         */
+        async renameConversation(conversationId, title, ctx) {
+            await renameConv(ctx.brain, conversationId, title);
+        },
+        /**
+         * Get the user's AI-learned expertise profile.
+         *
+         * @param ctx - Handler context.
+         * @returns The expertise profile.
+         */
+        async getExpertise(ctx) {
+            return loadUserExpertiseProfile(ctx.brain);
+        },
+        /**
+         * Get the chat engine's current context for a message.
+         *
+         * Returns the retrieved memory and expertise profile that would be used
+         * to build the system prompt. Useful for transparency UIs (Glass Box).
+         *
+         * @param message - The message to analyze context for.
+         * @param ctx - Handler context.
+         * @returns Memory and expertise context.
+         */
+        async getContext(message, ctx) {
+            const [memory, expertise] = await Promise.all([
+                retrieveRelevantMemory(ctx.brain, message),
+                loadUserExpertiseProfile(ctx.brain),
+            ]);
+            return { memory, expertise };
+        },
+    };
+}
+// Model routing
+export { analyzeComplexity, calculateComplexityScore, selectTieredRouting, createDefaultModelSelector, estimateCost, formatCost, getModelPricing, getModelShortName, DEFAULT_MODELS, DEFAULT_MODEL_TIERS, } from './models.js';
+// Delegator
+export { triageMessage, executeTask, synthesizeResults, delegateAndExecute } from './delegator.js';
+// Planner
+export { generatePlan, storePlan, loadPlan, updatePlan, approvePlan, cancelPlan, getPendingPlans, addPlanStep, removePlanStep } from './planner.js';
+// Executor
+export { executePlan, resumePlanExecution } from './executor.js';
+// Conversations
+export { createConversation, listConversations, getConversation, deleteConversation, renameConversation, storeMessage, loadConversationHistory, autoTitleConversation } from './conversations.js';
+// Memory
+export { retrieveRelevantMemory, learnFromConversation, loadUserExpertiseProfile, updateUserExpertiseProfile, generateExpertisePromptAdditions } from './memory.js';
+// Engine
+export { streamMessage, sendMessage } from './engine.js';
+//# sourceMappingURL=index.js.map

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

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