atabey 0.0.22 → 0.0.25

package/dist/atabey/src/modules/contracts/api.d.ts

@@ -11,12 +11,12 @@ export declare const ApiResponseSchema: <T extends z.ZodTypeAny>(dataSchema: T)
         message: z.ZodString;
         details: z.ZodOptional<z.ZodUnknown>;
     }, "strip", z.ZodTypeAny, {
-        code: string;
         message: string;
+        code: string;
         details?: unknown;
     }, {
-        code: string;
         message: string;
+        code: string;
         details?: unknown;
     }>>;
     meta: z.ZodOptional<z.ZodObject<{
@@ -43,12 +43,12 @@ export declare const ApiResponseSchema: <T extends z.ZodTypeAny>(dataSchema: T)
         message: z.ZodString;
         details: z.ZodOptional<z.ZodUnknown>;
     }, "strip", z.ZodTypeAny, {
-        code: string;
         message: string;
+        code: string;
         details?: unknown;
     }, {
-        code: string;
         message: string;
+        code: string;
         details?: unknown;
     }>>;
     meta: z.ZodOptional<z.ZodObject<{
@@ -75,12 +75,12 @@ export declare const ApiResponseSchema: <T extends z.ZodTypeAny>(dataSchema: T)
         message: z.ZodString;
         details: z.ZodOptional<z.ZodUnknown>;
     }, "strip", z.ZodTypeAny, {
-        code: string;
         message: string;
+        code: string;
         details?: unknown;
     }, {
-        code: string;
         message: string;
+        code: string;
         details?: unknown;
     }>>;
     meta: z.ZodOptional<z.ZodObject<{

package/dist/atabey/src/modules/engines/agent-executor.js

@@ -1,3 +1,4 @@
+import { getCircuitBreaker, withRetry } from "atabey-shared/resilience.js";
 import { logger } from "../../shared/logger.js";
 import { maskObject, maskText } from "../../shared/pii.js";
 import { AtabeyStorage } from "../../shared/storage.js";
@@ -30,56 +31,92 @@ export class AgentExecutor {
         const agent = routingResult.agent;
         const subTasks = routingResult.subTasks;
         logger.info(`[EXECUTOR] Routing: ${taskDescription.substring(0, 80)}... → ${agent} (confidence: ${routingResult.confidence})`);
-        // 2. Execute with retry logic (max 3 attempts)
+        // 2. Execute with exponential backoff + circuit breaker (Polly-style, no external deps)
         let lastOutput = "";
         let lastError = "";
-        for (let attempt = 1; attempt <= 3; attempt++) {
-            const startTime = Date.now();
-            try {
+        let attemptsUsed = 0;
+        const breaker = getCircuitBreaker(`agent:${agent}`, {
+            failureThreshold: 5,
+            openMs: 30_000,
+            name: `agent:${agent}`,
+        });
+        // Check circuit breaker state upfront — fail fast if open
+        try {
+            breaker.exec(() => Promise.resolve()); // dry-run to check state
+        }
+        catch {
+            return {
+                success: false,
+                agent,
+                output: "",
+                attempts: 0,
+            };
+        }
+        try {
+            const result = await withRetry(async (attempt) => {
+                attemptsUsed = attempt;
+                const startTime = Date.now();
                 logger.info(`[EXECUTOR] Attempt ${attempt}/3: ${agent} executing...`);
-                // Execute the agent task via Hermes messaging
                 const output = await AgentExecutor.runAgentTask(agent, taskDescription, subTasks, traceId);
                 lastOutput = output;
-                // 3. Quality check
                 const qualityResult = await QualityGate.check(agent, output, taskDescription);
-                if (qualityResult.passed) {
-                    const durationMs = Date.now() - startTime;
-                    logger.info(`[EXECUTOR] ${agent} task PASSED quality check (attempt ${attempt})`);
-                    // 4. Save to memory
-                    await AgentExecutor.saveToMemory(agent, taskDescription, output, traceId);
-                    // Update agent status
-                    AtabeyStorage.updateAgentStatus(agent.replace("@", ""), "COMPLETED", taskDescription);
-                    // Evaluate task to update specialty memory
-                    try {
-                        EvaluationEngine.evaluateTask(traceId, agent, durationMs, taskDescription);
-                    }
-                    catch (evalErr) {
-                        logger.error(`[EXECUTOR] Failed to evaluate task for ${agent}: ${evalErr.message}`);
-                    }
-                    return {
-                        success: true,
+                if (!qualityResult.passed) {
+                    lastError = qualityResult.reason;
+                    logger.warn(`[EXECUTOR] Quality check FAILED: ${qualityResult.reason}`, {
                         agent,
-                        output,
-                        attempts: attempt,
-                    };
+                        attempt,
+                    });
+                    // Track failure in circuit breaker
+                    breaker.exec(() => Promise.reject(new Error(`QUALITY_GATE: ${qualityResult.reason}`)))
+                        .catch(() => { });
+                    // Retry quality failures with backoff
+                    throw new Error(`QUALITY_GATE: ${qualityResult.reason}`);
                 }
-                lastError = qualityResult.reason;
-                logger.warn(`[EXECUTOR] Quality check FAILED: ${qualityResult.reason}`, { agent, attempt });
-            }
-            catch (err) {
-                lastError = err.message;
-                logger.error(`[EXECUTOR] Agent execution error: ${lastError}`, { agent, attempt });
-            }
+                // Track success in circuit breaker
+                breaker.exec(() => Promise.resolve()).catch(() => { });
+                const durationMs = Date.now() - startTime;
+                logger.info(`[EXECUTOR] ${agent} task PASSED quality check (attempt ${attempt})`);
+                await AgentExecutor.saveToMemory(agent, taskDescription, output, traceId);
+                AtabeyStorage.updateAgentStatus(agent.replace("@", ""), "COMPLETED", taskDescription);
+                try {
+                    EvaluationEngine.evaluateTask(traceId, agent, durationMs, taskDescription);
+                }
+                catch (evalErr) {
+                    logger.error(`[EXECUTOR] Failed to evaluate task for ${agent}: ${evalErr.message}`);
+                }
+                return {
+                    success: true,
+                    agent,
+                    output,
+                    attempts: attempt,
+                };
+            }, {
+                maxAttempts: 3,
+                baseDelayMs: 200,
+                maxDelayMs: 5_000,
+                factor: 2,
+                jitter: true,
+                retryIf: () => {
+                    // All errors retry (circuit was checked upfront)
+                    return true;
+                },
+                onRetry: (err, attempt, delayMs) => {
+                    logger.warn(`[EXECUTOR] Retry ${attempt} for ${agent} in ${delayMs}ms: ${err instanceof Error ? err.message : String(err)}`);
+                },
+            });
+            return result;
+        }
+        catch (err) {
+            lastError = err instanceof Error ? err.message : String(err);
+            logger.error(`[EXECUTOR] ${agent} FAILED after ${attemptsUsed || 3} attempts. Last error: ${lastError}`);
+            AtabeyStorage.updateAgentStatus(agent.replace("@", ""), "BLOCKED", `Failed: ${taskDescription.substring(0, 60)}`);
+            return {
+                success: false,
+                agent,
+                output: lastOutput,
+                attempts: attemptsUsed || 3,
+            };
         }
-        // All attempts failed
-        logger.error(`[EXECUTOR] ${agent} FAILED after 3 attempts. Last error: ${lastError}`);
-        AtabeyStorage.updateAgentStatus(agent.replace("@", ""), "BLOCKED", `Failed: ${taskDescription.substring(0, 60)}`);
-        return {
-            success: false,
-            agent,
-            output: lastOutput,
-            attempts: 3,
-        };
     }
     /**
      * Directly acknowledges a task for a specific agent.
@@ -119,13 +156,11 @@ export class AgentExecutor {
         const from = "@manager";
         // ─── 1. Send Hermes Message ──────────────────────────────────────
         // [KVKK/GDPR] Mask PII in task description before sending to message queue
-        const maskedTask = maskText(taskDescription);
-        const maskedSubTasks = subTasks.map(st => maskText(st));
-        // [KVKK/GDPR] Strict mode: mask any object fields that may contain PII
+        // maskObject handles all string fields recursively — no need for pre-masking
         const safePayload = maskObject({
             type: "DELEGATION",
-            task: maskedTask,
-            subTasks: maskedSubTasks,
+            task: taskDescription,
+            subTasks,
             traceId,
             from,
         }, 0, true);
@@ -148,7 +183,7 @@ export class AgentExecutor {
             action: "DELEGATION_SENT",
             trace_id: traceId,
             status: "IN_PROGRESS",
-            summary: maskedTask.substring(0, 200)
+            summary: typeof safePayload.task === "string" ? safePayload.task.substring(0, 200) : taskDescription.substring(0, 200)
         });
         logger.info(`[HERMES] Delegation sent to ${agent} (trace: ${traceId})`);
         // ─── 2. Wait for Agent Response (Polling) ────────────────────────

package/dist/atabey/src/modules/engines/agent-executor.js.map

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

package/dist/atabey/src/modules/engines/agent-loop.d.ts

@@ -4,14 +4,16 @@
  * Runs as a background loop polling and consuming DELEGATION messages from the
  * Hermes queue and forwarding them to agents for acknowledgment.
  *
- * Acts as a message-polling and workflow enforcer, ensuring task messages are
- * routed to their designated target agents, which then get processed by the AI client interface.
+ * Dispatch is concurrency-limited via InMemoryJobQueue (default: os.cpus().length)
+ * so parallel agent work cannot unbounded-swell main-thread memory. No Redis/BullMQ.
  *
  * v0.0.14: First real implementation. Agents are now reliably acknowledged and routed.
+ * v0.0.26: Job-queue backpressure + concurrent-limited dispatch.
  */
 export declare class AgentLoop {
     private static loopHandle;
     private static running;
+    private static cycleInFlight;
     /**
      * Start the agent dispatch loop.
      * @param activeAgents - Agent names to process (empty = all registered agents)
@@ -29,6 +31,7 @@ export declare class AgentLoop {
     /**
      * Single dispatch cycle — reads pending DELEGATION messages and executes them.
      * Marks each message as PROCESSED immediately to prevent duplicate dispatch.
+     * Execution is enqueued on the shared agent job queue (concurrency capped).
      */
     private static processDelegations;
 }

package/dist/atabey/src/modules/engines/agent-loop.js

@@ -1,3 +1,4 @@
+import { getAgentJobQueue } from "atabey-shared/job-queue.js";
 import { logger } from "../../shared/logger.js";
 import { AtabeyStorage } from "../../shared/storage.js";
 import { AgentExecutor } from "./agent-executor.js";
@@ -7,14 +8,16 @@ import { AgentExecutor } from "./agent-executor.js";
  * Runs as a background loop polling and consuming DELEGATION messages from the
  * Hermes queue and forwarding them to agents for acknowledgment.
  *
- * Acts as a message-polling and workflow enforcer, ensuring task messages are
- * routed to their designated target agents, which then get processed by the AI client interface.
+ * Dispatch is concurrency-limited via InMemoryJobQueue (default: os.cpus().length)
+ * so parallel agent work cannot unbounded-swell main-thread memory. No Redis/BullMQ.
  *
  * v0.0.14: First real implementation. Agents are now reliably acknowledged and routed.
+ * v0.0.26: Job-queue backpressure + concurrent-limited dispatch.
  */
 export class AgentLoop {
     static loopHandle = null;
     static running = false;
+    static cycleInFlight = false;
     /**
      * Start the agent dispatch loop.
      * @param activeAgents - Agent names to process (empty = all registered agents)
@@ -26,12 +29,25 @@ export class AgentLoop {
             return;
         }
         this.running = true;
-        logger.info(`[AGENT_LOOP] Starting. Active agents: ${activeAgents.length === 0 ? "all" : activeAgents.join(", ")} | Interval: ${intervalMs}ms`);
+        const queueStats = getAgentJobQueue().getStats();
+        logger.info(`[AGENT_LOOP] Starting. Active agents: ${activeAgents.length === 0 ? "all" : activeAgents.join(", ")} | Interval: ${intervalMs}ms | Job concurrency: ${queueStats.maxConcurrency}`);
         this.loopHandle = setInterval(() => {
-            this.processDelegations(activeAgents).catch((err) => {
+            // Skip overlapping cycles if previous dispatch is still draining
+            if (this.cycleInFlight)
+                return;
+            this.cycleInFlight = true;
+            this.processDelegations(activeAgents)
+                .catch((err) => {
                 logger.error("[AGENT_LOOP] Error in dispatch cycle", {
                     error: err.message,
                 });
+            })
+                .finally(() => {
+                // Use setTimeout to defer flag reset so same-interval ticks
+                // don't accidentally trigger a redundant cycle
+                setTimeout(() => {
+                    this.cycleInFlight = false;
+                }, 0);
             });
         }, intervalMs);
     }
@@ -44,6 +60,7 @@ export class AgentLoop {
             this.loopHandle = null;
         }
         this.running = false;
+        this.cycleInFlight = false;
         logger.info("[AGENT_LOOP] Stopped.");
     }
     /**
@@ -55,6 +72,7 @@ export class AgentLoop {
     /**
      * Single dispatch cycle — reads pending DELEGATION messages and executes them.
      * Marks each message as PROCESSED immediately to prevent duplicate dispatch.
+     * Execution is enqueued on the shared agent job queue (concurrency capped).
      */
     static async processDelegations(activeAgents) {
         const pendingMessages = AtabeyStorage.getPendingMessages();
@@ -62,6 +80,8 @@ export class AgentLoop {
         if (delegations.length === 0)
             return;
         logger.debug(`[AGENT_LOOP] Processing ${delegations.length} pending DELEGATION(s)`);
+        const queue = getAgentJobQueue();
+        const jobs = [];
         for (const msg of delegations) {
             const rawTarget = String(msg.to);
             const agentName = rawTarget.startsWith("@") ? rawTarget : `@${rawTarget}`;
@@ -87,15 +107,21 @@ export class AgentLoop {
                 traceId: String(msg.traceId),
                 task: taskDescription.substring(0, 80),
             });
-            try {
-                await AgentExecutor.executeForAgent(agentName, taskDescription, String(msg.traceId));
-            }
-            catch (err) {
-                logger.error(`[AGENT_LOOP] Failed to execute task for ${agentName}`, {
-                    error: err.message,
-                    traceId: String(msg.traceId),
-                });
-            }
+            jobs.push(queue.enqueue(async () => {
+                try {
+                    await AgentExecutor.executeForAgent(agentName, taskDescription, String(msg.traceId));
+                }
+                catch (err) {
+                    logger.error(`[AGENT_LOOP] Failed to execute task for ${agentName}`, {
+                        error: err.message,
+                        traceId: String(msg.traceId),
+                    });
+                }
+            }));
+        }
+        // Wait for this cycle's jobs (queue still limits concurrency globally)
+        if (jobs.length > 0) {
+            await Promise.all(jobs);
         }
     }
 }

package/dist/atabey/src/modules/engines/agent-loop.js.map

@@ -1 +1 @@
-{"version":3,"file":"agent-loop.js","sourceRoot":"","sources":["../../../../../src/modules/engines/agent-loop.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACxD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEpD;;;;;;;;;;GAUG;AACH,MAAM,OAAO,SAAS;IACV,MAAM,CAAC,UAAU,GAA0C,IAAI,CAAC;IAChE,MAAM,CAAC,OAAO,GAAG,KAAK,CAAC;IAE/B;;;;OAIG;IACI,MAAM,CAAC,KAAK,CAAC,eAAyB,EAAE,EAAE,UAAU,GAAG,IAAI;QAC9D,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACf,MAAM,CAAC,IAAI,CAAC,8DAA8D,CAAC,CAAC;YAC5E,OAAO;QACX,CAAC;QACD,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;QACpB,MAAM,CAAC,IAAI,CACP,yCACI,YAAY,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAC9D,gBAAgB,UAAU,IAAI,CACjC,CAAC;QAEF,IAAI,CAAC,UAAU,GAAG,WAAW,CAAC,GAAG,EAAE;YAC/B,IAAI,CAAC,kBAAkB,CAAC,YAAY,CAAC,CAAC,KAAK,CAAC,CAAC,GAAY,EAAE,EAAE;gBACzD,MAAM,CAAC,KAAK,CAAC,sCAAsC,EAAE;oBACjD,KAAK,EAAG,GAAa,CAAC,OAAO;iBAChC,CAAC,CAAC;YACP,CAAC,CAAC,CAAC;QACP,CAAC,EAAE,UAAU,CAAC,CAAC;IACnB,CAAC;IAED;;OAEG;IACI,MAAM,CAAC,IAAI;QACd,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;YAClB,aAAa,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;YAC/B,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC;QAC3B,CAAC;QACD,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC;QACrB,MAAM,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAC;IACzC,CAAC;IAED;;OAEG;IACI,MAAM,CAAC,SAAS;QACnB,OAAO,IAAI,CAAC,OAAO,CAAC;IACxB,CAAC;IAED;;;OAGG;IACK,MAAM,CAAC,KAAK,CAAC,kBAAkB,CAAC,YAAsB;QAC1D,MAAM,eAAe,GAAG,aAAa,CAAC,kBAAkB,EAAE,CAAC;QAC3D,MAAM,WAAW,GAAG,eAAe,CAAC,MAAM,CACtC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,YAAY,IAAI,CAAC,CAAC,MAAM,KAAK,SAAS,CAC7D,CAAC;QAEF,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO;QAErC,MAAM,CAAC,KAAK,CAAC,2BAA2B,WAAW,CAAC,MAAM,wBAAwB,CAAC,CAAC;QAEpF,KAAK,MAAM,GAAG,IAAI,WAAW,EAAE,CAAC;YAC5B,MAAM,SAAS,GAAG,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YACjC,MAAM,SAAS,GAAG,SAAS,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,SAAS,EAAE,CAAC;YAE1E,0DAA0D;YAC1D,IAAI,YAAY,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;gBAC/D,SAAS;YACb,CAAC;YAED,gEAAgE;YAChE,IAAI,GAAG,CAAC,EAAE,KAAK,SAAS,EAAE,CAAC;gBACvB,aAAa,CAAC,mBAAmB,CAAC,GAAG,CAAC,EAAY,EAAE,WAAW,CAAC,CAAC;YACrE,CAAC;YAED,8DAA8D;YAC9D,IAAI,eAAe,GAAG,GAAG,CAAC,OAAO,CAAC;YAClC,IAAI,CAAC;gBACD,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,OAAO,CAAsB,CAAC;gBAC5D,IAAI,MAAM,CAAC,IAAI;oBAAE,eAAe,GAAG,MAAM,CAAC,IAAI,CAAC;YACnD,CAAC;YAAC,MAAM,CAAC;gBACL,qDAAqD;YACzD,CAAC;YAED,MAAM,CAAC,IAAI,CAAC,8BAA8B,SAAS,EAAE,EAAE;gBACnD,OAAO,EAAE,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC;gBAC5B,IAAI,EAAE,eAAe,CAAC,SAAS,CAAC,CAAC,EAAE,EAAE,CAAC;aACzC,CAAC,CAAC;YAEH,IAAI,CAAC;gBACD,MAAM,aAAa,CAAC,eAAe,CAC/B,SAAS,EACT,eAAe,EACf,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,CACtB,CAAC;YACN,CAAC;YAAC,OAAO,GAAY,EAAE,CAAC;gBACpB,MAAM,CAAC,KAAK,CAAC,2CAA2C,SAAS,EAAE,EAAE;oBACjE,KAAK,EAAG,GAAa,CAAC,OAAO;oBAC7B,OAAO,EAAE,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC;iBAC/B,CAAC,CAAC;YACP,CAAC;QACL,CAAC;IACL,CAAC"}
+{"version":3,"file":"agent-loop.js","sourceRoot":"","sources":["../../../../../src/modules/engines/agent-loop.ts"],"names":[],"mappings":"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"}

package/dist/atabey/src/modules/engines/file-lock.d.ts

@@ -2,23 +2,30 @@
  * [ENGINE] File Lock — Conflict Resolution for Multi-Agent File Access
  *
  * Prevents two agents from writing to the same file simultaneously.
- * Uses .atabey/locks/ directory with per-file lock files.
+ * Uses atomic exclusive create (`fs.openSync(path, "wx")`) under `.atabey/locks/`.
  *
  * Flow:
- * 1. Agent A acquires lock on src/file.ts → writes .atabey/locks/src/file.ts.lock
- * 2. Agent B tries to write src/file.ts → lock exists → WAITING state
- * 3. Agent A releases lock → Agent B can proceed
+ * 1. Agent A acquires lock on src/file.ts → exclusive .lock file created
+ * 2. Agent B tries same path → EEXIST → WAITING / false
+ * 3. Agent A releases → unlink → Agent B can proceed
  *
- * Stale lock detection: locks older than 5 minutes are auto-released.
+ * Stale lock detection: locks older than TTL (default 5 min) are reclaimed.
  */
 export declare class FileLock {
-    private static LOCKS_DIR;
     private static STALE_TIMEOUT_MS;
+    /** Prefer ATABEY_PROJECT_ROOT (MCP) over process.cwd(). */
+    private static projectRoot;
+    private static locksDir;
+    private static locker;
     /**
      * Attempts to acquire a lock for a file on behalf of an agent.
      * Returns true if lock acquired, false if another agent holds it.
      */
     static acquire(agentName: string, filePath: string): boolean;
+    /**
+     * Async acquire with retry until timeout (default 10s).
+     */
+    static acquireAsync(agentName: string, filePath: string, timeoutMs?: number): Promise<boolean>;
     /**
      * Releases a lock held by an agent.
      * Only the lock-owning agent can release (others get warning).
@@ -30,12 +37,15 @@ export declare class FileLock {
      */
     static isLocked(filePath: string): string | null;
     /**
-     * Lists all currently active locks.
+     * Run fn while holding an exclusive lock on filePath.
+     */
+    static withLock<T>(agentName: string, filePath: string, fn: () => Promise<T> | T, timeoutMs?: number): Promise<T>;
+    /**
+     * Lists all currently active locks under `.atabey/locks`.
      */
     static listLocks(): Array<{
         agent: string;
         file: string;
         acquiredAt: string;
     }>;
-    private static getLockPath;
 }