@yuaone/core 0.9.8 → 0.9.9

package/dist/__tests__/context-manager.test.js

@@ -5,7 +5,6 @@
 import { describe, it } from "node:test";
 import assert from "node:assert/strict";
 import { ContextManager } from "../context-manager.js";
-import { ContextOverflowError } from "../errors.js";
 // ─── Helpers ───
 function makeManager(overrides = {}) {
     return new ContextManager({
@@ -190,8 +189,8 @@ describe("ContextManager", () => {
         const tokensWith = cm.estimateTokens(withTools);
         assert.ok(tokensWith > tokensWithout, "Messages with tool calls should have higher token count");
     });
-    // === 13. ContextOverflowError when compaction is insufficient ===
-    it("throws ContextOverflowError when even compaction cannot fit", () => {
+    // === 13. Emergency trim when compaction is insufficient ===
+    it("returns trimmed messages when even compaction cannot fit", () => {
         // Extremely small limit
         const cm = makeManager({
             maxContextTokens: 20,
@@ -201,12 +200,9 @@ describe("ContextManager", () => {
         // Add a system message and a very long user message
         cm.addMessage(makeSystemMessage("System prompt that is fairly long to exceed the tiny limit we set."));
         cm.addMessage(makeUserMessage("x".repeat(500)));
-        assert.throws(() => cm.prepareForLLM(), (err) => {
-            assert.ok(err instanceof ContextOverflowError);
-            assert.ok(err.currentTokens > 0);
-            assert.ok(err.maxTokens > 0);
-            return true;
-        });
+        // prepareForLLM no longer throws — it emergency-trims instead
+        const result = cm.prepareForLLM();
+        assert.ok(Array.isArray(result), "should return an array");
     });
     // === 14. Compression preserves head and tail ===
     it("compression keeps head and tail of long tool results", () => {

package/dist/__tests__/context-manager.test.js.map

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

package/dist/agent-coordinator.d.ts

@@ -0,0 +1,172 @@
+/**
+ * @module agent-coordinator
+ * @description Role-aware multi-agent coordinator.
+ *
+ * Sits above individual agent loops. Routes tasks to appropriate role agents,
+ * prevents resource conflicts, collects/merges results, enforces budget and
+ * approval constraints.
+ *
+ * Relationship to DAGOrchestrator:
+ *   - DAGOrchestrator: raw DAG execution, parallel task scheduling, retry logic
+ *   - AgentCoordinator: role routing, resource conflict prevention, budget
+ *     enforcement, task history persistence — the orchestration layer
+ */
+import { EventEmitter } from "node:events";
+import type { RoleAgentType } from "./agent-reputation.js";
+export type { RoleAgentType } from "./agent-reputation.js";
+export interface CoordinatorTask {
+    /** Unique task ID */
+    id: string;
+    /** Human-readable goal for the agent */
+    goal: string;
+    /** Classifier-style task type (e.g. "feature", "security", "test") */
+    taskType: string;
+    /** Optional execution environment hint */
+    environment?: string;
+    /** Which role agent should handle this task */
+    requiredRole: RoleAgentType;
+    /** Execution priority */
+    priority: "high" | "normal" | "low";
+    /** Per-task wall-time limit in ms (default: no limit) */
+    timeoutMs?: number;
+    /** Max tokens this task is allowed to consume */
+    budgetTokens?: number;
+    /** Task IDs that must complete successfully before this task can run */
+    dependencies?: string[];
+}
+export interface CoordinatorResult {
+    taskId: string;
+    role: RoleAgentType;
+    outcome: "success" | "failure" | "skipped" | "timeout";
+    output: string;
+    tokenUsed: number;
+    latencyMs: number;
+    /** Resource IDs that were in conflict when this task started */
+    conflicts: string[];
+}
+export interface CoordinatorConfig {
+    /** Max concurrent tasks. Default: 1 (sequential — prevents conflicts) */
+    maxConcurrent?: number;
+    /** How long a resource lock stays active in ms. Default: 30000 */
+    conflictWindowMs?: number;
+    /** Directory for task history storage. Default: ~/.yuan/coordinator */
+    storageDir?: string;
+}
+/**
+ * Routes tasks to specialized role agents, prevents resource conflicts,
+ * and persists task history for audit and analysis.
+ *
+ * @example
+ * ```ts
+ * const coordinator = new AgentCoordinator();
+ *
+ * const result = await coordinator.dispatch(
+ *   {
+ *     id: "task-1",
+ *     goal: "Implement user authentication",
+ *     taskType: "feature",
+ *     requiredRole: "coder",
+ *     priority: "high",
+ *     timeoutMs: 120_000,
+ *   },
+ *   async (goal, role) => {
+ *     // Call your actual agent loop here
+ *     return agentLoop.run(goal, role);
+ *   }
+ * );
+ * ```
+ */
+export declare class AgentCoordinator extends EventEmitter {
+    private readonly maxConcurrent;
+    private readonly conflictWindowMs;
+    private readonly storageFile;
+    /** resource ID → lock info */
+    private readonly locks;
+    /** Currently executing task IDs */
+    private readonly activeTasks;
+    /** Completed task IDs in this session (used for dependency checks) */
+    private readonly completedIds;
+    /** Failed task IDs in this session (used to skip dependents) */
+    private readonly failedIds;
+    constructor(config?: CoordinatorConfig);
+    /**
+     * Dispatch a single task to the appropriate role agent.
+     *
+     * Steps:
+     * 1. Verify dependencies are complete
+     * 2. Check for resource conflicts (goal keywords as resource IDs)
+     * 3. Lock resources
+     * 4. Execute runAgent with optional timeout
+     * 5. Release locks
+     * 6. Persist to history
+     * 7. Emit events and return result
+     *
+     * @param task - Task to execute
+     * @param runAgent - Caller-provided execution function
+     */
+    dispatch(task: CoordinatorTask, runAgent: (goal: string, role: RoleAgentType) => Promise<string>): Promise<CoordinatorResult>;
+    /**
+     * Dispatch multiple tasks in dependency order (topological sort).
+     *
+     * Respects maxConcurrent (default 1 = sequential). Skips tasks whose
+     * dependencies have failed.
+     *
+     * @param tasks - List of tasks; may include cross-task dependencies
+     * @param runAgent - Caller-provided execution function
+     */
+    dispatchBatch(tasks: CoordinatorTask[], runAgent: (goal: string, role: RoleAgentType) => Promise<string>): Promise<CoordinatorResult[]>;
+    /**
+     * Check whether a resource is currently locked by another task.
+     *
+     * A lock is considered active if it exists and has not expired.
+     *
+     * @param resourceId - Resource identifier to check
+     */
+    isConflict(resourceId: string): boolean;
+    /**
+     * Acquire an exclusive lock on a resource for the given task.
+     * Overwrites any existing (possibly expired) lock.
+     *
+     * @param resourceId - Resource to lock
+     * @param taskId - Task acquiring the lock
+     */
+    lockResource(resourceId: string, taskId: string): void;
+    /**
+     * Release a resource lock.
+     *
+     * @param resourceId - Resource to unlock
+     */
+    releaseResource(resourceId: string): void;
+    /**
+     * Get all currently executing tasks.
+     */
+    getActiveTasks(): CoordinatorTask[];
+    /**
+     * Return dependency task IDs that have not yet completed.
+     */
+    private getUnmetDependencies;
+    /**
+     * Extract resource IDs from a goal string.
+     * Uses significant words (>3 chars, non-common) as resource keys.
+     * This is a lightweight heuristic — callers can pre-lock specific resources
+     * with lockResource() for precise control.
+     */
+    private extractResourceIds;
+    /**
+     * Topological sort of tasks by their dependency graph.
+     * Tasks with no dependencies come first; tasks with satisfied dependencies
+     * come after their prerequisites.
+     * Ties broken by priority (high > normal > low) then by original order.
+     */
+    private topoSort;
+    /**
+     * Append a result to the persistent task history file (last HISTORY_MAX entries).
+     * Uses atomic rename to prevent partial writes.
+     */
+    private appendHistory;
+    /**
+     * Ensure the storage directory exists.
+     */
+    private ensureStorageDir;
+}
+//# sourceMappingURL=agent-coordinator.d.ts.map

package/dist/agent-coordinator.d.ts.map

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

package/dist/agent-coordinator.js

@@ -0,0 +1,390 @@
+/**
+ * @module agent-coordinator
+ * @description Role-aware multi-agent coordinator.
+ *
+ * Sits above individual agent loops. Routes tasks to appropriate role agents,
+ * prevents resource conflicts, collects/merges results, enforces budget and
+ * approval constraints.
+ *
+ * Relationship to DAGOrchestrator:
+ *   - DAGOrchestrator: raw DAG execution, parallel task scheduling, retry logic
+ *   - AgentCoordinator: role routing, resource conflict prevention, budget
+ *     enforcement, task history persistence — the orchestration layer
+ */
+import { EventEmitter } from "node:events";
+import { existsSync, mkdirSync, readFileSync, renameSync, writeFileSync } from "node:fs";
+import { homedir } from "node:os";
+import { join } from "node:path";
+// ─── Constants ───
+const HISTORY_MAX = 500;
+const DEFAULT_MAX_CONCURRENT = 1;
+const DEFAULT_CONFLICT_WINDOW_MS = 30_000;
+// ─── AgentCoordinator ───
+/**
+ * Routes tasks to specialized role agents, prevents resource conflicts,
+ * and persists task history for audit and analysis.
+ *
+ * @example
+ * ```ts
+ * const coordinator = new AgentCoordinator();
+ *
+ * const result = await coordinator.dispatch(
+ *   {
+ *     id: "task-1",
+ *     goal: "Implement user authentication",
+ *     taskType: "feature",
+ *     requiredRole: "coder",
+ *     priority: "high",
+ *     timeoutMs: 120_000,
+ *   },
+ *   async (goal, role) => {
+ *     // Call your actual agent loop here
+ *     return agentLoop.run(goal, role);
+ *   }
+ * );
+ * ```
+ */
+export class AgentCoordinator extends EventEmitter {
+    maxConcurrent;
+    conflictWindowMs;
+    storageFile;
+    /** resource ID → lock info */
+    locks = new Map();
+    /** Currently executing task IDs */
+    activeTasks = new Map();
+    /** Completed task IDs in this session (used for dependency checks) */
+    completedIds = new Set();
+    /** Failed task IDs in this session (used to skip dependents) */
+    failedIds = new Set();
+    constructor(config) {
+        super();
+        this.maxConcurrent = config?.maxConcurrent ?? DEFAULT_MAX_CONCURRENT;
+        this.conflictWindowMs = config?.conflictWindowMs ?? DEFAULT_CONFLICT_WINDOW_MS;
+        const storageDir = config?.storageDir ?? join(homedir(), ".yuan", "coordinator");
+        this.storageFile = join(storageDir, "task-history.json");
+        this.ensureStorageDir(storageDir);
+    }
+    // ─── Public API ───
+    /**
+     * Dispatch a single task to the appropriate role agent.
+     *
+     * Steps:
+     * 1. Verify dependencies are complete
+     * 2. Check for resource conflicts (goal keywords as resource IDs)
+     * 3. Lock resources
+     * 4. Execute runAgent with optional timeout
+     * 5. Release locks
+     * 6. Persist to history
+     * 7. Emit events and return result
+     *
+     * @param task - Task to execute
+     * @param runAgent - Caller-provided execution function
+     */
+    async dispatch(task, runAgent) {
+        // 1. Dependency check
+        const unmet = this.getUnmetDependencies(task);
+        if (unmet.length > 0) {
+            const result = {
+                taskId: task.id,
+                role: task.requiredRole,
+                outcome: "skipped",
+                output: `Skipped: unmet dependencies [${unmet.join(", ")}]`,
+                tokenUsed: 0,
+                latencyMs: 0,
+                conflicts: [],
+            };
+            this.appendHistory(task, result);
+            return result;
+        }
+        // 2. Check for resource conflicts
+        const resourceIds = this.extractResourceIds(task.goal);
+        const conflicts = resourceIds.filter((r) => this.isConflict(r));
+        if (conflicts.length > 0) {
+            this.emit("agent:coordinator_conflict", {
+                kind: "agent:coordinator_conflict",
+                taskId: task.id,
+                conflictedWith: conflicts,
+                resourceId: conflicts[0],
+                timestamp: new Date().toISOString(),
+            });
+        }
+        // 3. Lock resources and mark as active
+        for (const resourceId of resourceIds) {
+            this.lockResource(resourceId, task.id);
+        }
+        this.activeTasks.set(task.id, task);
+        this.emit("agent:coordinator_task_started", {
+            kind: "agent:coordinator_task_started",
+            taskId: task.id,
+            role: task.requiredRole,
+            goal: task.goal,
+            timestamp: new Date().toISOString(),
+        });
+        // 4. Execute with optional timeout
+        const startTime = Date.now();
+        let outcome = "success";
+        let output = "";
+        let tokenUsed = 0;
+        try {
+            const agentPromise = runAgent(task.goal, task.requiredRole);
+            if (task.timeoutMs != null) {
+                const timeoutPromise = new Promise((_, reject) => setTimeout(() => reject(new Error(`Task timed out after ${task.timeoutMs}ms`)), task.timeoutMs));
+                output = await Promise.race([agentPromise, timeoutPromise]);
+            }
+            else {
+                output = await agentPromise;
+            }
+            this.completedIds.add(task.id);
+        }
+        catch (err) {
+            const errMsg = err instanceof Error ? err.message : String(err);
+            outcome = errMsg.includes("timed out") ? "timeout" : "failure";
+            output = errMsg;
+            this.failedIds.add(task.id);
+        }
+        finally {
+            // 5. Release locks
+            for (const resourceId of resourceIds) {
+                this.releaseResource(resourceId);
+            }
+            this.activeTasks.delete(task.id);
+        }
+        const latencyMs = Date.now() - startTime;
+        const result = {
+            taskId: task.id,
+            role: task.requiredRole,
+            outcome,
+            output,
+            tokenUsed,
+            latencyMs,
+            conflicts,
+        };
+        // 6. Persist history
+        this.appendHistory(task, result);
+        // 7. Emit completion event
+        this.emit("agent:coordinator_task_complete", {
+            kind: "agent:coordinator_task_complete",
+            taskId: task.id,
+            role: task.requiredRole,
+            outcome,
+            tokenUsed,
+            latencyMs,
+            timestamp: new Date().toISOString(),
+        });
+        return result;
+    }
+    /**
+     * Dispatch multiple tasks in dependency order (topological sort).
+     *
+     * Respects maxConcurrent (default 1 = sequential). Skips tasks whose
+     * dependencies have failed.
+     *
+     * @param tasks - List of tasks; may include cross-task dependencies
+     * @param runAgent - Caller-provided execution function
+     */
+    async dispatchBatch(tasks, runAgent) {
+        const sorted = this.topoSort(tasks);
+        const results = [];
+        // Sequential execution (maxConcurrent=1 is default and the safe path)
+        // Future: implement concurrent slot tracking when maxConcurrent > 1
+        for (const task of sorted) {
+            // Skip if a dependency failed
+            const hasFailed = (task.dependencies ?? []).some((dep) => this.failedIds.has(dep));
+            if (hasFailed) {
+                const skipped = {
+                    taskId: task.id,
+                    role: task.requiredRole,
+                    outcome: "skipped",
+                    output: `Skipped: dependency failed`,
+                    tokenUsed: 0,
+                    latencyMs: 0,
+                    conflicts: [],
+                };
+                this.failedIds.add(task.id); // propagate skip as failure for downstream
+                this.appendHistory(task, skipped);
+                results.push(skipped);
+                continue;
+            }
+            const result = await this.dispatch(task, runAgent);
+            results.push(result);
+        }
+        return results;
+    }
+    /**
+     * Check whether a resource is currently locked by another task.
+     *
+     * A lock is considered active if it exists and has not expired.
+     *
+     * @param resourceId - Resource identifier to check
+     */
+    isConflict(resourceId) {
+        const lock = this.locks.get(resourceId);
+        if (!lock)
+            return false;
+        if (Date.now() > lock.expiresAt) {
+            this.locks.delete(resourceId);
+            return false;
+        }
+        return true;
+    }
+    /**
+     * Acquire an exclusive lock on a resource for the given task.
+     * Overwrites any existing (possibly expired) lock.
+     *
+     * @param resourceId - Resource to lock
+     * @param taskId - Task acquiring the lock
+     */
+    lockResource(resourceId, taskId) {
+        this.locks.set(resourceId, {
+            taskId,
+            expiresAt: Date.now() + this.conflictWindowMs,
+        });
+    }
+    /**
+     * Release a resource lock.
+     *
+     * @param resourceId - Resource to unlock
+     */
+    releaseResource(resourceId) {
+        this.locks.delete(resourceId);
+    }
+    /**
+     * Get all currently executing tasks.
+     */
+    getActiveTasks() {
+        return Array.from(this.activeTasks.values());
+    }
+    // ─── Private helpers ───
+    /**
+     * Return dependency task IDs that have not yet completed.
+     */
+    getUnmetDependencies(task) {
+        if (!task.dependencies || task.dependencies.length === 0)
+            return [];
+        return task.dependencies.filter((dep) => !this.completedIds.has(dep));
+    }
+    /**
+     * Extract resource IDs from a goal string.
+     * Uses significant words (>3 chars, non-common) as resource keys.
+     * This is a lightweight heuristic — callers can pre-lock specific resources
+     * with lockResource() for precise control.
+     */
+    extractResourceIds(goal) {
+        const stopWords = new Set([
+            "the", "and", "for", "with", "that", "this", "from", "into",
+            "have", "will", "should", "must", "also", "only", "then",
+        ]);
+        return goal
+            .toLowerCase()
+            .replace(/[^a-z0-9\s_/-]/g, " ")
+            .split(/\s+/)
+            .filter((w) => w.length > 3 && !stopWords.has(w))
+            .slice(0, 5); // cap to 5 resource IDs per task
+    }
+    /**
+     * Topological sort of tasks by their dependency graph.
+     * Tasks with no dependencies come first; tasks with satisfied dependencies
+     * come after their prerequisites.
+     * Ties broken by priority (high > normal > low) then by original order.
+     */
+    topoSort(tasks) {
+        const PRIORITY_WEIGHT = {
+            high: 3,
+            normal: 2,
+            low: 1,
+        };
+        const taskMap = new Map(tasks.map((t) => [t.id, t]));
+        const inDegree = new Map(tasks.map((t) => [t.id, 0]));
+        const reverseDeps = new Map(tasks.map((t) => [t.id, []]));
+        for (const task of tasks) {
+            for (const dep of task.dependencies ?? []) {
+                inDegree.set(task.id, (inDegree.get(task.id) ?? 0) + 1);
+                if (taskMap.has(dep)) {
+                    reverseDeps.get(dep).push(task.id);
+                }
+                else {
+                    // External dependency — treat as already satisfied
+                    inDegree.set(task.id, Math.max(0, (inDegree.get(task.id) ?? 0) - 1));
+                }
+            }
+        }
+        const queue = tasks
+            .filter((t) => (inDegree.get(t.id) ?? 0) === 0)
+            .sort((a, b) => PRIORITY_WEIGHT[b.priority] - PRIORITY_WEIGHT[a.priority]);
+        const sorted = [];
+        while (queue.length > 0) {
+            const task = queue.shift();
+            sorted.push(task);
+            const dependents = reverseDeps.get(task.id) ?? [];
+            const unblocked = [];
+            for (const depId of dependents) {
+                const newDeg = (inDegree.get(depId) ?? 0) - 1;
+                inDegree.set(depId, newDeg);
+                if (newDeg === 0) {
+                    const depTask = taskMap.get(depId);
+                    if (depTask)
+                        unblocked.push(depTask);
+                }
+            }
+            // Insert unblocked tasks in priority order
+            unblocked.sort((a, b) => PRIORITY_WEIGHT[b.priority] - PRIORITY_WEIGHT[a.priority]);
+            queue.push(...unblocked);
+        }
+        // Any tasks not in sorted (circular deps) go at the end in original order
+        const sortedIds = new Set(sorted.map((t) => t.id));
+        for (const task of tasks) {
+            if (!sortedIds.has(task.id))
+                sorted.push(task);
+        }
+        return sorted;
+    }
+    /**
+     * Append a result to the persistent task history file (last HISTORY_MAX entries).
+     * Uses atomic rename to prevent partial writes.
+     */
+    appendHistory(task, result) {
+        try {
+            let history = [];
+            if (existsSync(this.storageFile)) {
+                const raw = readFileSync(this.storageFile, "utf-8");
+                const parsed = JSON.parse(raw);
+                if (Array.isArray(parsed))
+                    history = parsed;
+            }
+            history.push({
+                taskId: task.id,
+                role: task.requiredRole,
+                goal: task.goal,
+                taskType: task.taskType,
+                outcome: result.outcome,
+                tokenUsed: result.tokenUsed,
+                latencyMs: result.latencyMs,
+                timestamp: new Date().toISOString(),
+            });
+            // Keep only the last HISTORY_MAX entries
+            if (history.length > HISTORY_MAX) {
+                history = history.slice(history.length - HISTORY_MAX);
+            }
+            const tmpFile = `${this.storageFile}.tmp`;
+            writeFileSync(tmpFile, JSON.stringify(history, null, 2), "utf-8");
+            renameSync(tmpFile, this.storageFile);
+        }
+        catch {
+            // Non-fatal: storage failures must not crash the agent loop
+        }
+    }
+    /**
+     * Ensure the storage directory exists.
+     */
+    ensureStorageDir(dir) {
+        try {
+            if (!existsSync(dir)) {
+                mkdirSync(dir, { recursive: true });
+            }
+        }
+        catch {
+            // Non-fatal
+        }
+    }
+}
+//# sourceMappingURL=agent-coordinator.js.map

package/dist/agent-coordinator.js.map

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