opencode-agentic-engine 0.1.0

package/dist/evolution/continuous-evolution.d.ts

@@ -0,0 +1,92 @@
+/**
+ * ContinuousEvolution — auto-feedback pipeline for self-evolving agents.
+ *
+ * Tracks a rolling window of step results, detects performance degradation,
+ * and triggers evolution analysis when anomalies are found.
+ *
+ * Aligns with the paper's "continuous evolution" vision:
+ * agents that monitor their own performance and self-improve over time.
+ */
+export interface StepResult {
+    stepId: string;
+    success: boolean;
+    output: string;
+    sessionId: string;
+    timestamp: number;
+    category?: string;
+}
+export interface ForecastData {
+    /** Predicted success rate for the next window */
+    nextWindowRate: number;
+    /** Estimated remaining steps until success rate drops below 50%, or null if not predictable */
+    stepsUntilCritical: number | null;
+    /** True if the forecast shows imminent critical degradation */
+    critical: boolean;
+    /** Per-bucket success rates for transparency */
+    bucketRates: number[];
+}
+export interface PerformanceTrend {
+    overall: {
+        total: number;
+        success: number;
+        successRate: number;
+    };
+    rolling: {
+        windowSize: number;
+        successRate: number;
+        direction: "improving" | "stable" | "degrading";
+    };
+    degradationDetected: boolean;
+    anomalyCount: number;
+    recentErrors: Array<{
+        stepId: string;
+        output: string;
+        category: string;
+        timestamp: number;
+    }>;
+    recommendations: string[];
+    /** Predictive degradation forecast (Gap #12) */
+    forecast: ForecastData;
+}
+export interface EvolutionTrigger {
+    reason: string;
+    type: "degradation" | "anomaly_spike" | "milestone";
+    metrics: {
+        recentRate: number;
+        overallRate: number;
+        anomalyRatio: number;
+    };
+}
+export type DegradationCallback = (trend: PerformanceTrend, trigger: EvolutionTrigger) => void;
+export declare class ContinuousEvolution {
+    private windowSize;
+    private results;
+    private degradationCallbacks;
+    private lastEvolveSession;
+    private evolveCount;
+    constructor(windowSize?: number);
+    /** Feed a step result into the rolling window */
+    feedStepResult(result: StepResult): void;
+    /** Feed multiple results at once (e.g. after a session completes) */
+    feedBatch(results: StepResult[]): void;
+    /** Register a callback that fires when degradation is detected */
+    onDegradation(cb: DegradationCallback): void;
+    /** Get current performance trend */
+    getTrend(): PerformanceTrend;
+    /** Check trend and fire callbacks if degradation found. Returns current trend. */
+    checkAndNotify(): PerformanceTrend;
+    /**
+     * Decide whether to auto-trigger evolution analysis.
+     * Returns null if no trigger needed, or an EvolutionTrigger explaining why.
+     */
+    shouldEvolve(sessionId: string): EvolutionTrigger | null;
+    /** Reset state (for testing) */
+    reset(): void;
+    /** Get raw counts */
+    getStats(): {
+        totalResults: number;
+        evolveCount: number;
+        windowSize: number;
+    };
+}
+//# sourceMappingURL=continuous-evolution.d.ts.map

package/dist/evolution/continuous-evolution.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"continuous-evolution.d.ts","sourceRoot":"","sources":["../../src/evolution/continuous-evolution.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,EAAE,OAAO,CAAA;IAChB,MAAM,EAAE,MAAM,CAAA;IACd,SAAS,EAAE,MAAM,CAAA;IACjB,SAAS,EAAE,MAAM,CAAA;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB;AAED,MAAM,WAAW,YAAY;IAC3B,iDAAiD;IACjD,cAAc,EAAE,MAAM,CAAA;IACtB,+FAA+F;IAC/F,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAA;IACjC,+DAA+D;IAC/D,QAAQ,EAAE,OAAO,CAAA;IACjB,gDAAgD;IAChD,WAAW,EAAE,MAAM,EAAE,CAAA;CACtB;AAED,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAA;IAChE,OAAO,EAAE;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,WAAW,GAAG,QAAQ,GAAG,WAAW,CAAA;KAAE,CAAA;IACrG,mBAAmB,EAAE,OAAO,CAAA;IAC5B,YAAY,EAAE,MAAM,CAAA;IACpB,YAAY,EAAE,KAAK,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;IAC5F,eAAe,EAAE,MAAM,EAAE,CAAA;IACzB,gDAAgD;IAChD,QAAQ,EAAE,YAAY,CAAA;CACvB;AAED,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,EAAE,aAAa,GAAG,eAAe,GAAG,WAAW,CAAA;IACnD,OAAO,EAAE;QACP,UAAU,EAAE,MAAM,CAAA;QAClB,WAAW,EAAE,MAAM,CAAA;QACnB,YAAY,EAAE,MAAM,CAAA;KACrB,CAAA;CACF;AAED,MAAM,MAAM,mBAAmB,GAAG,CAAC,KAAK,EAAE,gBAAgB,EAAE,OAAO,EAAE,gBAAgB,KAAK,IAAI,CAAA;AAE9F,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,UAAU,CAAQ;IAC1B,OAAO,CAAC,OAAO,CAAmB;IAClC,OAAO,CAAC,oBAAoB,CAA4B;IACxD,OAAO,CAAC,iBAAiB,CAAsB;IAC/C,OAAO,CAAC,WAAW,CAAI;gBAEX,UAAU,SAAK;IAI3B,iDAAiD;IACjD,cAAc,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI;IAQxC,qEAAqE;IACrE,SAAS,CAAC,OAAO,EAAE,UAAU,EAAE,GAAG,IAAI;IAMtC,kEAAkE;IAClE,aAAa,CAAC,EAAE,EAAE,mBAAmB,GAAG,IAAI;IAI5C,oCAAoC;IACpC,QAAQ,IAAI,gBAAgB;IAqH5B,kFAAkF;IAClF,cAAc,IAAI,gBAAgB;IAmBlC;;;OAGG;IACH,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,gBAAgB,GAAG,IAAI;IA0CxD,gCAAgC;IAChC,KAAK,IAAI,IAAI;IAMb,qBAAqB;IACrB,QAAQ,IAAI;QAAE,YAAY,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE;CAO9E"}

package/dist/evolution/self-evolver.d.ts

@@ -0,0 +1,85 @@
+import type { SkillRecord } from "../memory/skill-store.js";
+import type { Episode } from "../memory/episodic-store.js";
+import type { AgentTask } from "../agents/coordinator.js";
+export interface EvolutionMetrics {
+    totalSessions: number;
+    totalSteps: number;
+    successRate: number;
+    retryRate: number;
+    avgRetriesPerFailure: number;
+    topErrorCategories: Array<{
+        category: string;
+        count: number;
+    }>;
+    skillEffectiveness: Array<{
+        name: string;
+        successRate: number;
+        usage: number;
+    }>;
+    toolUsage: Array<{
+        tool: string;
+        calls: number;
+        failureRate: number;
+    }>;
+    recommendations: string[];
+}
+export interface SkillPatch {
+    skillId: string;
+    skillName: string;
+    failures: number;
+    suggestedChanges: Array<{
+        type: "add_step" | "add_tool" | "add_rollback" | "reorder" | "split";
+        description: string;
+        detail: string;
+    }>;
+}
+export interface RoleSuggestion {
+    name: string;
+    triggerPattern: string;
+    suggestedTools: string[];
+    reason: string;
+}
+export interface PromptPatch {
+    role: string;
+    errorCategory: string;
+    instruction: string;
+    priority: "high" | "medium" | "low";
+    occurrences: number;
+}
+export interface EvolutionReport {
+    metrics: EvolutionMetrics;
+    skillPatches: SkillPatch[];
+    roleSuggestions: RoleSuggestion[];
+    promptPatches: PromptPatch[];
+    improvementScore: number;
+}
+export declare class SelfEvolver {
+    private skills;
+    private episodes;
+    private tasks;
+    private stepStates;
+    private traceEntries;
+    feedSkills(skills: SkillRecord[]): void;
+    feedEpisodes(episodes: Episode[]): void;
+    feedTasks(tasks: AgentTask[]): void;
+    feedStepStates(steps: Array<{
+        stepId: string;
+        success: boolean;
+        output: string;
+    }>): void;
+    feedTraces(traces: Array<{
+        toolUsed: string;
+        success: boolean;
+        step: string;
+    }>): void;
+    evolve(): EvolutionReport;
+    private computeMetrics;
+    private analyzeSkills;
+    private suggestRoles;
+    /**
+     * Generate prompt patches from recurring error patterns (Gap #1: prompt auto-patching).
+     * Maps error categories → specific instruction additions for the relevant agent role.
+     */
+    private suggestPromptPatches;
+}
+//# sourceMappingURL=self-evolver.d.ts.map

package/dist/evolution/self-evolver.d.ts.map

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

package/dist/index.d.ts

@@ -0,0 +1,16 @@
+import type { Plugin, PluginModule } from "@opencode-ai/plugin";
+export declare const AgenticEngine: Plugin;
+declare const pluginModule: PluginModule;
+export default pluginModule;
+export { ErrorAnalyzer } from "./core/error-analyzer.js";
+export { RoleRegistry } from "./agents/role-registry.js";
+export { VectorStore } from "./memory/vector-store.js";
+export { Verifier } from "./core/verifier.js";
+export { ContinuousEvolution } from "./evolution/continuous-evolution.js";
+export { SelfEvolver } from "./evolution/self-evolver.js";
+export { AgentCoordinator } from "./agents/coordinator.js";
+export { Executor } from "./core/executor.js";
+export { PatternDiscovery } from "./drift/pattern-discovery.js";
+export { skillToTrainingExample, skillsToTrainingData, exportOpenAIJSONL, exportInstructionsJSON, trainingDatasetSummary } from "./memory/skill-training.js";
+export { LiveEvaluator } from "./evaluation/live-evaluator.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAi5F/D,eAAO,MAAM,aAAa,EAAE,MAAqB,CAAA;AAEjD,QAAA,MAAM,YAAY,EAAE,YAGnB,CAAA;AACD,eAAe,YAAY,CAAA;AAG3B,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAA;AACxD,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAA;AACxD,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAA;AACtD,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAA;AAC7C,OAAO,EAAE,mBAAmB,EAAE,MAAM,qCAAqC,CAAA;AACzE,OAAO,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAA;AACzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAA;AAC1D,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAA;AAC7C,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAA;AAC/D,OAAO,EAAE,sBAAsB,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,sBAAsB,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAA;AAC5J,OAAO,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAA"}