@timmeck/brain-core 2.36.36 → 2.36.38

package/dist/llm/structured-output.js

@@ -0,0 +1,153 @@
+/**
+ * Structured LLM Output — Typed ContentBlocks statt nur `{ text: string }`
+ *
+ * Inspiriert von LangChain's structured output parsing.
+ * Ermöglicht es, LLM-Antworten in typisierte Blöcke zu zerlegen:
+ * Text, Reasoning, Tool Calls, Citations, JSON.
+ */
+// ── Parsing ─────────────────────────────────────────────
+/**
+ * Parse raw LLM output into structured ContentBlocks.
+ *
+ * Erkennt:
+ * - <thinking>...</thinking> → ReasoningBlock
+ * - <tool_call>{"name":"...","args":{...}}</tool_call> → ToolCallBlock
+ * - <citation source="...">...</citation> → CitationBlock
+ * - ```json ... ``` → JsonBlock
+ * - Alles andere → TextBlock
+ */
+export function parseStructuredOutput(raw) {
+    if (!raw || raw.trim().length === 0)
+        return [];
+    const blocks = [];
+    let remaining = raw;
+    // Regex patterns for structured sections
+    const patterns = [
+        {
+            // <thinking>...</thinking>
+            regex: /<thinking>([\s\S]*?)<\/thinking>/,
+            handler: (m) => ({ type: 'reasoning', content: m[1].trim() }),
+        },
+        {
+            // <tool_call>{"name":"x","args":{...}}</tool_call>
+            regex: /<tool_call>([\s\S]*?)<\/tool_call>/,
+            handler: (m) => {
+                try {
+                    const parsed = JSON.parse(m[1].trim());
+                    return {
+                        type: 'tool_call',
+                        toolName: parsed.name ?? parsed.tool ?? 'unknown',
+                        args: parsed.args ?? parsed.arguments ?? parsed.input ?? {},
+                    };
+                }
+                catch {
+                    return { type: 'text', content: m[0] };
+                }
+            },
+        },
+        {
+            // <citation source="...">...</citation>
+            regex: /<citation\s+source="([^"]*)">([\s\S]*?)<\/citation>/,
+            handler: (m) => ({ type: 'citation', source: m[1], quote: m[2].trim() }),
+        },
+        {
+            // ```json ... ```
+            regex: /```json\s*\n([\s\S]*?)\n```/,
+            handler: (m) => {
+                try {
+                    return { type: 'json', data: JSON.parse(m[1].trim()) };
+                }
+                catch {
+                    return { type: 'text', content: m[0] };
+                }
+            },
+        },
+    ];
+    while (remaining.length > 0) {
+        // Find the earliest matching pattern
+        let earliest = null;
+        for (const p of patterns) {
+            const match = remaining.match(p.regex);
+            if (match && match.index !== undefined) {
+                if (!earliest || match.index < earliest.index) {
+                    earliest = { index: match.index, match, handler: p.handler };
+                }
+            }
+        }
+        if (!earliest) {
+            // No more patterns found — rest is text
+            const trimmed = remaining.trim();
+            if (trimmed.length > 0) {
+                blocks.push({ type: 'text', content: trimmed });
+            }
+            break;
+        }
+        // Text before the match
+        const before = remaining.slice(0, earliest.index).trim();
+        if (before.length > 0) {
+            blocks.push({ type: 'text', content: before });
+        }
+        // The matched block
+        blocks.push(earliest.handler(earliest.match));
+        // Continue after the match
+        remaining = remaining.slice(earliest.index + earliest.match[0].length);
+    }
+    return blocks;
+}
+// ── JSON Mode Helper ────────────────────────────────────
+/**
+ * Extrahiert JSON aus einer LLM-Antwort.
+ * Versucht zuerst die gesamte Antwort als JSON zu parsen,
+ * dann sucht es nach ```json Code-Blöcken.
+ */
+export function extractJson(raw) {
+    // Try full string
+    try {
+        return JSON.parse(raw.trim());
+    }
+    catch {
+        // Try code block
+        const match = raw.match(/```(?:json)?\s*\n([\s\S]*?)\n```/);
+        if (match) {
+            try {
+                return JSON.parse(match[1].trim());
+            }
+            catch {
+                return null;
+            }
+        }
+        return null;
+    }
+}
+/**
+ * Validate parsed JSON against a simple schema (key presence check).
+ * Returns the data if valid, null otherwise.
+ */
+export function validateJsonSchema(data, requiredKeys) {
+    if (!data || typeof data !== 'object')
+        return null;
+    const obj = data;
+    for (const key of requiredKeys) {
+        if (!(key in obj))
+            return null;
+    }
+    return data;
+}
+// ── Block Helpers ────────────────────────────────────────
+/** Get all blocks of a specific type */
+export function getBlocks(blocks, type) {
+    return blocks.filter((b) => b.type === type);
+}
+/** Get combined text from all TextBlocks */
+export function getTextContent(blocks) {
+    return getBlocks(blocks, 'text').map(b => b.content).join('\n\n');
+}
+/** Get all tool calls */
+export function getToolCalls(blocks) {
+    return getBlocks(blocks, 'tool_call');
+}
+/** Check if response contains reasoning */
+export function hasReasoning(blocks) {
+    return blocks.some(b => b.type === 'reasoning');
+}
+//# sourceMappingURL=structured-output.js.map

package/dist/llm/structured-output.js.map

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

package/dist/research/research-orchestrator.d.ts

@@ -118,6 +118,7 @@ export declare class ResearchOrchestrator {
     private repoAbsorber;
     private featureRecommender;
     private contradictionResolver;
+    private checkpointManager;
     private lastAutoMissionTime;
     private onSuggestionCallback;
     private db;
@@ -217,6 +218,7 @@ export declare class ResearchOrchestrator {
     setRepoAbsorber(absorber: RepoAbsorber): void;
     setFeatureRecommender(recommender: import('../codegen/feature-recommender.js').FeatureRecommender): void;
     setContradictionResolver(resolver: import('../knowledge-graph/contradiction-resolver.js').ContradictionResolver): void;
+    setCheckpointManager(cm: import('../checkpoint/checkpoint-manager.js').CheckpointManager): void;
     /** Set the LLMService — propagates to all engines that can use LLM. */
     setLLMService(llm: LLMService): void;
     /** Get the LLMService instance. */

package/dist/research/research-orchestrator.js

@@ -69,6 +69,7 @@ export class ResearchOrchestrator {
     repoAbsorber = null;
     featureRecommender = null;
     contradictionResolver = null;
+    checkpointManager = null;
     lastAutoMissionTime = 0;
     onSuggestionCallback = null;
     db;
@@ -239,6 +240,7 @@ export class ResearchOrchestrator {
     setRepoAbsorber(absorber) { this.repoAbsorber = absorber; }
     setFeatureRecommender(recommender) { this.featureRecommender = recommender; }
     setContradictionResolver(resolver) { this.contradictionResolver = resolver; }
+    setCheckpointManager(cm) { this.checkpointManager = cm; }
     /** Set the LLMService — propagates to all engines that can use LLM. */
     setLLMService(llm) {
         this.llmService = llm;
@@ -1988,6 +1990,13 @@ export class ResearchOrchestrator {
                 duration_ms: duration,
             });
         }
+        // Checkpoint: persist cycle state for crash recovery / time-travel
+        if (this.checkpointManager) {
+            try {
+                this.checkpointManager.save(`orchestrator-${this.brainName}`, this.cycleCount, { cycleCount: this.cycleCount, insights: insights.length, anomalies: anomalies.length, durationMs: duration }, { workflowType: 'orchestrator', metadata: { brainName: this.brainName } });
+            }
+            catch { /* checkpoint save should never break the cycle */ }
+        }
     }
     /** Analyze Brain's own state and generate concrete improvement suggestions.
      *  Tracks suggestion history — if a suggestion repeats 3+ times without resolution,