cognitive-core 0.0.2 → 0.1.2

package/dist/search/refinement-types.js

@@ -0,0 +1,99 @@
+/**
+ * Refinement Types
+ *
+ * Types for the ReMem-style refinement loop that iteratively
+ * improves solutions using memory-augmented feedback.
+ */
+import { z } from 'zod';
+/**
+ * Issue type found during evaluation
+ */
+export const IssueTypeSchema = z.enum([
+    'incomplete',
+    'incorrect',
+    'inefficient',
+    'off_topic',
+    'error',
+]);
+/**
+ * Severity of an issue
+ */
+export const IssueSeveritySchema = z.enum(['critical', 'major', 'minor']);
+/**
+ * An issue found during solution evaluation
+ */
+export const EvaluationIssueSchema = z.object({
+    type: IssueTypeSchema,
+    description: z.string(),
+    severity: IssueSeveritySchema,
+    suggestion: z.string().optional(),
+});
+/**
+ * Quality assessment level
+ */
+export const QualityLevelSchema = z.enum([
+    'excellent',
+    'good',
+    'needs_work',
+    'poor',
+]);
+/**
+ * How the evaluation was performed
+ */
+export const EvaluationMethodSchema = z.enum([
+    'verification',
+    'agent',
+    'heuristic',
+]);
+/**
+ * Result of evaluating a solution's quality
+ */
+export const EvaluationResultSchema = z.object({
+    /** Overall quality assessment */
+    quality: QualityLevelSchema,
+    /** Numeric score (0-1) */
+    score: z.number().min(0).max(1),
+    /** Whether this solution is acceptable */
+    acceptable: z.boolean(),
+    /** Specific issues found */
+    issues: z.array(EvaluationIssueSchema),
+    /** How the evaluation was performed */
+    method: EvaluationMethodSchema,
+    /** Raw response from evaluator (for debugging) */
+    rawResponse: z.string().optional(),
+});
+/**
+ * Create an evaluation result
+ */
+export function createEvaluationResult(params) {
+    return EvaluationResultSchema.parse({
+        quality: params.quality,
+        score: params.score,
+        acceptable: params.acceptable,
+        issues: params.issues ?? [],
+        method: params.method,
+        rawResponse: params.rawResponse,
+    });
+}
+/**
+ * Determine quality level from a numeric score
+ */
+export function scoreToQuality(score) {
+    if (score >= 0.85)
+        return 'excellent';
+    if (score >= 0.7)
+        return 'good';
+    if (score >= 0.4)
+        return 'needs_work';
+    return 'poor';
+}
+/**
+ * Check if a quality level is acceptable
+ */
+export function isQualityAcceptable(quality, minAcceptable = 'good') {
+    const levels = ['poor', 'needs_work', 'good', 'excellent'];
+    const qualityIndex = levels.indexOf(quality);
+    const minIndex = levels.indexOf(minAcceptable);
+    return qualityIndex >= minIndex;
+}
+//# sourceMappingURL=refinement-types.js.map

package/dist/search/refinement-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"refinement-types.js","sourceRoot":"","sources":["../../src/search/refinement-types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;GAEG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC,IAAI,CAAC;IACpC,YAAY;IACZ,WAAW;IACX,aAAa;IACb,WAAW;IACX,OAAO;CACR,CAAC,CAAC;AAIH;;GAEG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC;AAI1E;;GAEG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5C,IAAI,EAAE,eAAe;IACrB,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE;IACvB,QAAQ,EAAE,mBAAmB;IAC7B,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAClC,CAAC,CAAC;AAIH;;GAEG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,IAAI,CAAC;IACvC,WAAW;IACX,MAAM;IACN,YAAY;IACZ,MAAM;CACP,CAAC,CAAC;AAIH;;GAEG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC,IAAI,CAAC;IAC3C,cAAc;IACd,OAAO;IACP,WAAW;CACZ,CAAC,CAAC;AAIH;;GAEG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC7C,iCAAiC;IACjC,OAAO,EAAE,kBAAkB;IAC3B,0BAA0B;IAC1B,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IAC/B,0CAA0C;IAC1C,UAAU,EAAE,CAAC,CAAC,OAAO,EAAE;IACvB,4BAA4B;IAC5B,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,qBAAqB,CAAC;IACtC,uCAAuC;IACvC,MAAM,EAAE,sBAAsB;IAC9B,kDAAkD;IAClD,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACnC,CAAC,CAAC;AAoCH;;GAEG;AACH,MAAM,UAAU,sBAAsB,CAAC,MAOtC;IACC,OAAO,sBAAsB,CAAC,KAAK,CAAC;QAClC,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,UAAU,EAAE,MAAM,CAAC,UAAU;QAC7B,MAAM,EAAE,MAAM,CAAC,MAAM,IAAI,EAAE;QAC3B,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,WAAW,EAAE,MAAM,CAAC,WAAW;KAChC,CAAC,CAAC;AACL,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,KAAa;IAC1C,IAAI,KAAK,IAAI,IAAI;QAAE,OAAO,WAAW,CAAC;IACtC,IAAI,KAAK,IAAI,GAAG;QAAE,OAAO,MAAM,CAAC;IAChC,IAAI,KAAK,IAAI,GAAG;QAAE,OAAO,YAAY,CAAC;IACtC,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,mBAAmB,CACjC,OAAqB,EACrB,gBAA8B,MAAM;IAEpC,MAAM,MAAM,GAAmB,CAAC,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC;IAC3E,MAAM,YAAY,GAAG,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IAC7C,MAAM,QAAQ,GAAG,MAAM,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC;IAC/C,OAAO,YAAY,IAAI,QAAQ,CAAC;AAClC,CAAC"}

package/dist/search/router.d.ts

@@ -0,0 +1,61 @@
+import type { Task, RouterConfig } from '../types/index.js';
+import type { MemorySystem, MemoryQueryResultV2 } from '../memory/system.js';
+import type { MetaLearner } from '../learning/meta-learner.js';
+/**
+ * Routing decision with context
+ */
+export interface RoutingDecision {
+    /** Selected strategy for solving */
+    strategy: 'direct' | 'adapt' | 'explore' | 'fallback';
+    /** Confidence in this routing (0-1) */
+    confidence: number;
+    /** Memory query results (playbook format) */
+    memoryContext: MemoryQueryResultV2;
+    /** Estimated compute budget (LLM calls) */
+    estimatedBudget: number;
+    /** Reasoning for the decision */
+    reasoning: string;
+    /** Meta-strategies that were applied */
+    appliedMetaStrategies?: string[];
+}
+/**
+ * Task Router
+ * Determines the best approach for solving a task based on memory
+ * Now with meta-learning integration for adaptive routing
+ */
+export declare class TaskRouter {
+    private memory;
+    private config;
+    private metaLearner?;
+    constructor(memory: MemorySystem, config?: Partial<RouterConfig>, metaLearner?: MetaLearner);
+    /**
+     * Set the meta learner (can be set after construction)
+     */
+    setMetaLearner(metaLearner: MetaLearner): void;
+    /**
+     * Route a task to determine solving strategy
+     * Uses playbook-based memory with meta-learning adjustments
+     */
+    route(task: Task): Promise<RoutingDecision>;
+    /**
+     * Compute base routing decision from memory results
+     */
+    private computeBaseRouting;
+    /**
+     * Extract task characteristics for meta-learning
+     */
+    private extractTaskCharacteristics;
+    /**
+     * Summarize memory state for meta-learning
+     */
+    private summarizeMemoryState;
+    /**
+     * Update configuration
+     */
+    updateConfig(config: Partial<RouterConfig>): void;
+}
+/**
+ * Create a task router
+ */
+export declare function createRouter(memory: MemorySystem, config?: Partial<RouterConfig>, metaLearner?: MetaLearner): TaskRouter;
+//# sourceMappingURL=router.d.ts.map

package/dist/search/router.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"router.d.ts","sourceRoot":"","sources":["../../src/search/router.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAC5D,OAAO,KAAK,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC7E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAE/D;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,oCAAoC;IACpC,QAAQ,EAAE,QAAQ,GAAG,OAAO,GAAG,SAAS,GAAG,UAAU,CAAC;IACtD,uCAAuC;IACvC,UAAU,EAAE,MAAM,CAAC;IACnB,6CAA6C;IAC7C,aAAa,EAAE,mBAAmB,CAAC;IACnC,2CAA2C;IAC3C,eAAe,EAAE,MAAM,CAAC;IACxB,iCAAiC;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,wCAAwC;IACxC,qBAAqB,CAAC,EAAE,MAAM,EAAE,CAAC;CAClC;AAED;;;;GAIG;AACH,qBAAa,UAAU;IACrB,OAAO,CAAC,MAAM,CAAe;IAC7B,OAAO,CAAC,MAAM,CAAe;IAC7B,OAAO,CAAC,WAAW,CAAC,CAAc;gBAGhC,MAAM,EAAE,YAAY,EACpB,MAAM,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,EAC9B,WAAW,CAAC,EAAE,WAAW;IAW3B;;OAEG;IACH,cAAc,CAAC,WAAW,EAAE,WAAW,GAAG,IAAI;IAI9C;;;OAGG;IACG,KAAK,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,eAAe,CAAC;IA6CjD;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAyD1B;;OAEG;IACH,OAAO,CAAC,0BAA0B;IAsClC;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAqC5B;;OAEG;IACH,YAAY,CAAC,MAAM,EAAE,OAAO,CAAC,YAAY,CAAC,GAAG,IAAI;CAGlD;AAED;;GAEG;AACH,wBAAgB,YAAY,CAC1B,MAAM,EAAE,YAAY,EACpB,MAAM,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,EAC9B,WAAW,CAAC,EAAE,WAAW,GACxB,UAAU,CAEZ"}

package/dist/search/router.js

@@ -0,0 +1,197 @@
+/**
+ * Task Router
+ * Determines the best approach for solving a task based on memory
+ * Now with meta-learning integration for adaptive routing
+ */
+export class TaskRouter {
+    memory;
+    config;
+    metaLearner;
+    constructor(memory, config, metaLearner) {
+        this.memory = memory;
+        this.config = {
+            similarityThreshold: config?.similarityThreshold ?? 0.85,
+            useDomainRouting: config?.useDomainRouting ?? true,
+            defaultStrategy: config?.defaultStrategy ?? 'direct',
+        };
+        this.metaLearner = metaLearner;
+    }
+    /**
+     * Set the meta learner (can be set after construction)
+     */
+    setMetaLearner(metaLearner) {
+        this.metaLearner = metaLearner;
+    }
+    /**
+     * Route a task to determine solving strategy
+     * Uses playbook-based memory with meta-learning adjustments
+     */
+    async route(task) {
+        // Query memory for relevant context
+        const memoryContext = await this.memory.queryV2(task.description, {
+            domains: task.domain ? [task.domain] : undefined,
+        });
+        // Compute base routing from playbook memory
+        let decision = this.computeBaseRouting(memoryContext);
+        // Apply meta-learning adjustments if available
+        if (this.metaLearner) {
+            const taskCharacteristics = this.extractTaskCharacteristics(task);
+            const memoryState = this.summarizeMemoryState(memoryContext);
+            try {
+                const adjusted = await this.metaLearner.adjustRouting({
+                    strategy: decision.strategy,
+                    confidence: decision.confidence,
+                    estimatedBudget: decision.estimatedBudget,
+                    reasoning: decision.reasoning,
+                }, taskCharacteristics, memoryState);
+                // Apply adjustments
+                if (adjusted.strategy !== decision.strategy || adjusted.confidence !== decision.confidence) {
+                    decision.strategy = adjusted.strategy;
+                    decision.confidence = adjusted.confidence;
+                    decision.reasoning = adjusted.reasoning;
+                    decision.appliedMetaStrategies = ['meta-learning adjustment'];
+                }
+            }
+            catch (error) {
+                // Meta-learning failed, continue with base routing
+                console.error('[TaskRouter] Meta-learning adjustment failed, using base routing:', error instanceof Error ? error.message : String(error));
+            }
+        }
+        return decision;
+    }
+    /**
+     * Compute base routing decision from memory results
+     */
+    computeBaseRouting(memoryContext) {
+        // Check experience memory
+        const hasHighSimilarityExperience = memoryContext.experiences.some((e) => e.score >= this.config.similarityThreshold && e.experience.success);
+        // Check playbook memory
+        const hasHighConfidencePlaybook = memoryContext.playbooks.some((p) => p.score >= this.config.similarityThreshold && p.playbook.confidence >= 0.7);
+        const hasApplicablePlaybook = memoryContext.playbooks.some((p) => p.score >= this.config.similarityThreshold * 0.8);
+        // Determine routing strategy
+        let strategy;
+        let confidence;
+        let estimatedBudget;
+        let reasoning;
+        if (hasHighSimilarityExperience) {
+            strategy = 'adapt';
+            confidence = 0.9;
+            estimatedBudget = 1;
+            reasoning = 'Found highly similar successful experience to adapt from';
+        }
+        else if (hasHighConfidencePlaybook) {
+            strategy = 'direct';
+            confidence = 0.8;
+            estimatedBudget = 2;
+            reasoning = 'Found high-confidence playbook for guidance';
+        }
+        else if (hasApplicablePlaybook) {
+            strategy = 'direct';
+            confidence = 0.6;
+            estimatedBudget = 4;
+            reasoning = 'Found applicable playbook to guide solving';
+        }
+        else if (memoryContext.experiences.length > 0) {
+            strategy = 'explore';
+            confidence = 0.4;
+            estimatedBudget = 10;
+            reasoning = 'Found some context but need exploration';
+        }
+        else {
+            strategy = 'fallback';
+            confidence = 0.2;
+            estimatedBudget = 20;
+            reasoning = 'No relevant memory found, using fallback strategy';
+        }
+        return {
+            strategy,
+            confidence,
+            memoryContext,
+            estimatedBudget,
+            reasoning,
+        };
+    }
+    /**
+     * Extract task characteristics for meta-learning
+     */
+    extractTaskCharacteristics(task) {
+        const characteristics = [];
+        // Domain
+        if (task.domain) {
+            characteristics.push(`domain: ${task.domain}`);
+        }
+        // Analyze description
+        const desc = task.description.toLowerCase();
+        if (desc.includes('bug') || desc.includes('fix') || desc.includes('error')) {
+            characteristics.push('bug fix');
+        }
+        if (desc.includes('test') || desc.includes('spec')) {
+            characteristics.push('testing');
+        }
+        if (desc.includes('refactor') || desc.includes('clean')) {
+            characteristics.push('refactoring');
+        }
+        if (desc.includes('implement') || desc.includes('create') || desc.includes('add')) {
+            characteristics.push('new feature');
+        }
+        if (desc.includes('multiple') || desc.includes('files') || desc.includes('across')) {
+            characteristics.push('multi-file change');
+        }
+        if (desc.length > 500) {
+            characteristics.push('complex task');
+        }
+        return characteristics;
+    }
+    /**
+     * Summarize memory state for meta-learning
+     */
+    summarizeMemoryState(memoryContext) {
+        const state = [];
+        // Experience state
+        if (memoryContext.experiences.length === 0) {
+            state.push('no similar experiences');
+        }
+        else {
+            const maxScore = Math.max(...memoryContext.experiences.map((e) => e.score), 0);
+            if (maxScore >= 0.8) {
+                state.push('high similarity experience');
+            }
+            else if (maxScore >= 0.5) {
+                state.push('moderate similarity experience');
+            }
+            else {
+                state.push('low similarity experiences');
+            }
+        }
+        // Playbook state
+        if (memoryContext.playbooks.length === 0) {
+            state.push('no applicable playbooks');
+        }
+        else {
+            const maxConfidence = Math.max(...memoryContext.playbooks.map((p) => p.playbook.confidence), 0);
+            if (maxConfidence >= 0.8) {
+                state.push('high confidence playbook');
+            }
+            else if (maxConfidence >= 0.5) {
+                state.push('moderate confidence playbook');
+            }
+            else {
+                state.push('low confidence playbooks');
+            }
+        }
+        return state;
+    }
+    /**
+     * Update configuration
+     */
+    updateConfig(config) {
+        this.config = { ...this.config, ...config };
+    }
+}
+/**
+ * Create a task router
+ */
+export function createRouter(memory, config, metaLearner) {
+    return new TaskRouter(memory, config, metaLearner);
+}
+//# sourceMappingURL=router.js.map

package/dist/search/router.js.map

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

package/dist/search/solver.d.ts

@@ -0,0 +1,75 @@
+import type { Task, Trajectory } from '../types/index.js';
+import type { MemorySystem } from '../memory/system.js';
+import type { LLMProvider } from '../agents/types.js';
+import type { RoutingDecision } from './router.js';
+/**
+ * Solver configuration
+ */
+export interface SolverConfig {
+    maxSteps: number;
+    temperature: number;
+    agentId: string;
+}
+/**
+ * Solver result
+ */
+export interface SolverResult {
+    trajectory: Trajectory;
+    usedMemory: boolean;
+    strategy: string;
+}
+/**
+ * Direct Solver
+ * Solves tasks using memory-augmented LLM calls
+ *
+ * @deprecated Use AgentManager.spawn() instead. DirectSolver will be removed in v2.0.
+ * The AgentManager provides real action execution through configurable backends (ACP, subprocess).
+ *
+ * Migration example:
+ * ```typescript
+ * // Before (deprecated):
+ * const solver = createSolver(memory, provider);
+ * const result = await solver.solve(task, routing);
+ *
+ * // After (recommended):
+ * const manager = createAgentManager(memory);
+ * const result = await manager.spawn({
+ *   agentType: 'claude-code',
+ *   task,
+ *   injectedKnowledge: routing.memoryContext,
+ * });
+ * ```
+ */
+export declare class DirectSolver {
+    private memory;
+    private provider;
+    private config;
+    constructor(memory: MemorySystem, provider: LLMProvider, config?: Partial<SolverConfig>);
+    /**
+     * Solve a task using the routing decision
+     */
+    solve(task: Task, routing: RoutingDecision): Promise<SolverResult>;
+    /**
+     * Build system prompt with memory context
+     */
+    private buildSystemPrompt;
+    /**
+     * Build task prompt
+     */
+    private buildTaskPrompt;
+    /**
+     * Parse LLM response into structured components
+     */
+    private parseResponse;
+    /**
+     * Update configuration
+     */
+    updateConfig(config: Partial<SolverConfig>): void;
+}
+/**
+ * Create a direct solver
+ *
+ * @deprecated Use createAgentManager() instead. See DirectSolver for migration guide.
+ */
+export declare function createSolver(memory: MemorySystem, provider: LLMProvider, config?: Partial<SolverConfig>): DirectSolver;
+//# sourceMappingURL=solver.d.ts.map

package/dist/search/solver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"solver.d.ts","sourceRoot":"","sources":["../../src/search/solver.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,IAAI,EACJ,UAAU,EAGX,MAAM,mBAAmB,CAAC;AAO3B,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,KAAK,EAAE,WAAW,EAAW,MAAM,oBAAoB,CAAC;AAC/D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAEnD;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,UAAU,EAAE,UAAU,CAAC;IACvB,UAAU,EAAE,OAAO,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,MAAM,CAAe;IAC7B,OAAO,CAAC,QAAQ,CAAc;IAC9B,OAAO,CAAC,MAAM,CAAe;gBAG3B,MAAM,EAAE,YAAY,EACpB,QAAQ,EAAE,WAAW,EACrB,MAAM,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC;IAWhC;;OAEG;IACG,KAAK,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,YAAY,CAAC;IAuGxE;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAiDzB;;OAEG;IACH,OAAO,CAAC,eAAe;IAevB;;OAEG;IACH,OAAO,CAAC,aAAa;IA6BrB;;OAEG;IACH,YAAY,CAAC,MAAM,EAAE,OAAO,CAAC,YAAY,CAAC,GAAG,IAAI;CAGlD;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAC1B,MAAM,EAAE,YAAY,EACpB,QAAQ,EAAE,WAAW,EACrB,MAAM,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,GAC7B,YAAY,CAEd"}

package/dist/search/solver.js

@@ -0,0 +1,216 @@
+import { createTrajectory, createStep, successOutcome, failureOutcome, } from '../types/index.js';
+/**
+ * Direct Solver
+ * Solves tasks using memory-augmented LLM calls
+ *
+ * @deprecated Use AgentManager.spawn() instead. DirectSolver will be removed in v2.0.
+ * The AgentManager provides real action execution through configurable backends (ACP, subprocess).
+ *
+ * Migration example:
+ * ```typescript
+ * // Before (deprecated):
+ * const solver = createSolver(memory, provider);
+ * const result = await solver.solve(task, routing);
+ *
+ * // After (recommended):
+ * const manager = createAgentManager(memory);
+ * const result = await manager.spawn({
+ *   agentType: 'claude-code',
+ *   task,
+ *   injectedKnowledge: routing.memoryContext,
+ * });
+ * ```
+ */
+export class DirectSolver {
+    memory;
+    provider;
+    config;
+    constructor(memory, provider, config) {
+        this.memory = memory;
+        this.provider = provider;
+        this.config = {
+            maxSteps: config?.maxSteps ?? 10,
+            temperature: config?.temperature ?? 0.3,
+            agentId: config?.agentId ?? 'direct-solver',
+        };
+    }
+    /**
+     * Solve a task using the routing decision
+     */
+    async solve(task, routing) {
+        const startTime = Date.now();
+        const steps = [];
+        let llmCalls = 0;
+        let totalTokens = 0;
+        try {
+            // Build system prompt with memory context
+            const systemPrompt = this.buildSystemPrompt(task, routing);
+            // Execute solving loop
+            const messages = [
+                { role: 'system', content: systemPrompt },
+                { role: 'user', content: this.buildTaskPrompt(task) },
+            ];
+            let done = false;
+            let outcome = null;
+            while (!done && steps.length < this.config.maxSteps) {
+                // Get LLM response
+                const response = await this.provider.complete(messages, {
+                    temperature: this.config.temperature,
+                });
+                llmCalls++;
+                // Parse response into thought/action
+                const { thought, action, isDone, solution } = this.parseResponse(response);
+                // Create step
+                const step = createStep({
+                    thought,
+                    action,
+                    observation: isDone
+                        ? 'Task completed'
+                        : 'Awaiting next step',
+                });
+                steps.push(step);
+                // Check if done
+                if (isDone) {
+                    done = true;
+                    outcome = successOutcome(solution);
+                }
+                // Add to conversation
+                messages.push({ role: 'assistant', content: response });
+                if (!isDone) {
+                    // In a real implementation, we'd execute the action and get observation
+                    messages.push({
+                        role: 'user',
+                        content: 'Continue with the next step.',
+                    });
+                }
+            }
+            // If we hit max steps without completing
+            if (!outcome) {
+                outcome = failureOutcome('Max steps reached without solution', 0.5);
+            }
+            const wallTimeSeconds = (Date.now() - startTime) / 1000;
+            const trajectory = createTrajectory({
+                task,
+                steps,
+                outcome,
+                agentId: this.config.agentId,
+                llmCalls,
+                totalTokens,
+                wallTimeSeconds,
+            });
+            return {
+                trajectory,
+                usedMemory: routing.memoryContext.experiences.length > 0,
+                strategy: routing.strategy,
+            };
+        }
+        catch (error) {
+            const wallTimeSeconds = (Date.now() - startTime) / 1000;
+            const errorMessage = error instanceof Error ? error.message : 'Unknown error';
+            const trajectory = createTrajectory({
+                task,
+                steps,
+                outcome: failureOutcome(errorMessage),
+                agentId: this.config.agentId,
+                llmCalls,
+                totalTokens,
+                wallTimeSeconds,
+            });
+            return {
+                trajectory,
+                usedMemory: routing.memoryContext.experiences.length > 0,
+                strategy: routing.strategy,
+            };
+        }
+    }
+    /**
+     * Build system prompt with memory context
+     */
+    buildSystemPrompt(_task, routing) {
+        const parts = [
+            'You are a problem-solving agent. Your goal is to solve the given task step by step.',
+            '',
+            'For each step, provide:',
+            '1. THOUGHT: Your reasoning about what to do next',
+            '2. ACTION: The action to take',
+            '',
+            'When you have the final solution, output:',
+            'DONE: [your solution]',
+            '',
+        ];
+        // Add memory context
+        const memoryContext = this.memory.formatForPromptV2(routing.memoryContext);
+        if (memoryContext) {
+            parts.push('## Relevant Memory');
+            parts.push(memoryContext);
+            parts.push('');
+        }
+        // Add strategy-specific guidance
+        switch (routing.strategy) {
+            case 'adapt':
+                parts.push('## Guidance', 'A similar task has been solved successfully before. Adapt the previous solution to this task.', '');
+                break;
+            case 'direct':
+                parts.push('## Guidance', 'Use the applicable strategies and skills from memory to guide your solution.', '');
+                break;
+            case 'explore':
+                parts.push('## Guidance', 'Limited relevant memory found. Explore different approaches carefully.', '');
+                break;
+        }
+        return parts.join('\n');
+    }
+    /**
+     * Build task prompt
+     */
+    buildTaskPrompt(task) {
+        const parts = [
+            `## Task`,
+            task.description,
+        ];
+        if (Object.keys(task.context).length > 0) {
+            parts.push('');
+            parts.push('## Context');
+            parts.push(JSON.stringify(task.context, null, 2));
+        }
+        return parts.join('\n');
+    }
+    /**
+     * Parse LLM response into structured components
+     */
+    parseResponse(response) {
+        // Check for DONE
+        const doneMatch = response.match(/DONE:\s*(.+)/is);
+        if (doneMatch) {
+            return {
+                thought: undefined,
+                action: 'complete',
+                isDone: true,
+                solution: doneMatch[1].trim(),
+            };
+        }
+        // Parse THOUGHT and ACTION
+        const thoughtMatch = response.match(/THOUGHT:\s*(.+?)(?=ACTION:|$)/is);
+        const actionMatch = response.match(/ACTION:\s*(.+?)(?=THOUGHT:|$)/is);
+        return {
+            thought: thoughtMatch?.[1]?.trim(),
+            action: actionMatch?.[1]?.trim() ?? response.trim(),
+            isDone: false,
+            solution: null,
+        };
+    }
+    /**
+     * Update configuration
+     */
+    updateConfig(config) {
+        this.config = { ...this.config, ...config };
+    }
+}
+/**
+ * Create a direct solver
+ *
+ * @deprecated Use createAgentManager() instead. See DirectSolver for migration guide.
+ */
+export function createSolver(memory, provider, config) {
+    return new DirectSolver(memory, provider, config);
+}
+//# sourceMappingURL=solver.js.map