@roj-ai/sdk 0.1.36 → 0.2.1

package/dist/core/agents/agent.d.ts.map

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

package/dist/core/agents/agent.js

@@ -6,6 +6,7 @@
  * - Embedded scheduling with debounce
  * - Spawn child agents
  */
+import { agentWakeKey } from '../../core/wake-key.js';
 import { agentEvents } from '../../core/agents/state.js';
 import { withSessionId } from '../../core/events/test-helpers.js';
 import { applyCacheBreakpoint } from '../../core/llm/cache-breakpoints.js';
@@ -36,7 +37,7 @@ import { isRetryableLLMError, withLLMRetry } from './retry.js';
 export class Agent {
     id;
     config;
-    sessionContext;
+    getSessionContext;
     store;
     logger;
     llmProvider;
@@ -52,18 +53,23 @@ export class Agent {
     /** Merged tools map: config tools + plugin tools (plugins override). Rebuilt each processing cycle. */
     tools;
     // Scheduler state (embedded)
-    debounceTimer;
-    errorRetryTimer;
+    /** Poll timer for the debounceCallback path only — see scheduleProcessing(). */
+    debounceCheckTimer;
+    /** Whether a retry wake is armed. In-memory: a fresh process re-arms from replayed state. */
+    errorRetryArmed = false;
+    releaseScheduledLease;
+    /** Host scheduler, resolved once — the platform never changes for a session. */
+    scheduler;
     processing = false;
     scheduled = false;
     pendingReschedule = false;
+    /** In-flight continue() calls, so disposal can drain a turn instead of racing it. */
+    inFlightContinues = new Set();
     abortController = new AbortController();
-    /** Track conversation turn number for handler context */
-    turnNumber = 0;
     constructor(deps) {
         this.id = deps.id;
         this.config = deps.config;
-        this.sessionContext = deps.sessionContext;
+        this.getSessionContext = deps.getSessionContext;
         this.store = deps.store;
         this.logger = deps.logger;
         this.llmProvider = deps.llmProvider;
@@ -77,11 +83,13 @@ export class Agent {
         this.pluginMethodCaller = deps.pluginMethodCaller;
         this.scheduleCallback = deps.schedule;
         this.tools = this.buildToolsMap();
-        // Initialize turn number from conversation history
-        const state = this.state;
-        if (state) {
-            this.turnNumber = state.conversationHistory.filter((m) => m.role === 'assistant').length;
-        }
+    }
+    /**
+     * Turn the agent is working on: committed turns plus the one in flight.
+     * Read from persisted state so a reload or a compaction can't reset it.
+     */
+    get turnNumber() {
+        return (this.state?.turnNumber ?? 0) + 1;
     }
     /**
      * Get the current agent state from store.
@@ -108,15 +116,49 @@ export class Agent {
     // ============================================================================
     // Public API
     // ============================================================================
+    /** Drop the scheduled lease. Idempotent — the release closure self-guards. */
+    dropScheduledLease() {
+        this.releaseScheduledLease?.();
+        this.releaseScheduledLease = undefined;
+    }
     /**
      * Unified processing entry point - decides what to do next.
      * Safe to call multiple times; skips if already processing.
      */
-    async continue() {
+    continue() {
+        const pending = this.runContinue().finally(() => {
+            this.inFlightContinues.delete(pending);
+        });
+        this.inFlightContinues.add(pending);
+        return pending;
+    }
+    /**
+     * Await the turn that is currently running, if any — including work it starts
+     * while draining. Never rejects: callers use it to drain before teardown, not
+     * to observe processing errors.
+     */
+    async waitForIdle() {
+        while (this.inFlightContinues.size > 0) {
+            await Promise.allSettled([...this.inFlightContinues]);
+        }
+    }
+    async runContinue() {
+        // Release before the guards: both early-return paths are reachable from a
+        // fired timer, and the lease would otherwise outlive the schedule forever.
+        // The retry lease is not touched here — it only ever exists inside the
+        // retry callback, which releases it itself.
+        this.dropScheduledLease();
         if (this.processing)
             return;
         if (this.store.isClosed())
             return;
+        let releaseProcessingLease;
+        try {
+            releaseProcessingLease = this.getSessionContext().runtimeActivity.acquire(`agent:${this.id}:processing`);
+        }
+        catch {
+            return;
+        }
         this.processing = true;
         this.scheduled = false;
         try {
@@ -198,6 +240,7 @@ export class Agent {
                 this.pendingReschedule = false;
                 this.scheduleProcessing();
             }
+            releaseProcessingLease();
         }
     }
     /**
@@ -209,75 +252,111 @@ export class Agent {
             return;
         if (this.store.isClosed())
             return;
+        // After shutdown() a fresh schedule would outlive the drain and fire against
+        // a session that already cleared its agents and plugin contexts.
+        if (this.abortController.signal.aborted)
+            return;
         if (this.processing) {
             this.pendingReschedule = true;
             return;
         }
         this.cancelSchedule();
+        try {
+            this.releaseScheduledLease = this.getSessionContext().runtimeActivity.acquire(`agent:${this.id}:scheduled`);
+        }
+        catch {
+            return;
+        }
         this.scheduled = true;
         const agentState = this.state;
-        if (!agentState)
+        if (!agentState) {
+            this.cancelSchedule();
             return;
+        }
         if (this.config.debounceCallback) {
-            // Callback-based debounce using recursive setTimeout
+            // Stays a plain timer: the poll re-enters with a closure and its own
+            // in-memory `scheduled` guard, neither of which a resumed wake can carry.
             const checkInterval = this.config.checkIntervalMs ?? 100;
             const scheduleCheck = () => {
-                this.debounceTimer = setTimeout(async () => {
-                    // Re-read state fresh each check — no stale data
-                    const currentState = this.state;
-                    if (!currentState) {
-                        this.cancelSchedule();
-                        return;
-                    }
-                    // Guard: schedule could be cancelled between timer fire and here
-                    if (!this.scheduled)
-                        return;
-                    const sessionState = this.store.getState();
-                    const unconsumed = getUnconsumedMessages(sessionState, this.id);
-                    const pendingToolResults = currentState.pendingToolResults;
-                    // If no messages, no pending tool results, and no plugin pending, nothing to do
-                    if (unconsumed.length === 0 && pendingToolResults.length === 0 && !this.hasPluginPendingMessages()) {
-                        this.cancelSchedule();
-                        return;
-                    }
-                    const oldestTimestamp = unconsumed.length > 0
-                        ? Math.min(...unconsumed.map((m) => m.timestamp))
-                        : Date.now();
-                    const oldestWaitingMs = Date.now() - oldestTimestamp;
-                    const decision = await this.config.debounceCallback({
-                        messages: unconsumed,
-                        oldestWaitingMs,
-                        totalPending: unconsumed.length,
-                        pendingToolResults,
-                    });
-                    // Re-check after async callback — schedule could be cancelled during await
-                    if (!this.scheduled)
-                        return;
-                    if (decision === 'process_now') {
-                        this.cancelSchedule();
-                        this.continue().catch((err) => {
-                            this.logger.error('Unhandled error in continue()', err instanceof Error ? err : undefined, { agentId: this.id });
-                        });
-                    }
-                    else {
-                        // Callback said "wait" — schedule next check.
-                        // Fresh state will be read on next iteration.
-                        scheduleCheck();
-                    }
+                this.debounceCheckTimer = setTimeout(() => {
+                    // A throw here (hasPluginPendingMessages, or the preset-supplied
+                    // debounceCallback — user code) must not strand the scheduled lease.
+                    void this.runDebounceCheck(scheduleCheck);
                 }, checkInterval);
             };
             scheduleCheck();
         }
         else {
-            // Timer-based debounce (default: 500ms)
-            const debounceMs = this.config.debounceMs ?? 500;
-            this.debounceTimer = setTimeout(() => {
+            // Debounce by wake (default: 500ms) — nothing but the key is needed to resume.
+            this.armWake('debounce', this.config.debounceMs ?? 500);
+        }
+    }
+    /**
+     * Run the continuation a due wake stands for — the one entry point for a host,
+     * whether this process armed the delay or an alarm held it across an eviction.
+     */
+    async deliverWake(kind) {
+        if (this.abortController.signal.aborted)
+            return;
+        switch (kind) {
+            case 'debounce':
+                // Not scheduleProcessing(): that arms a fresh delay and the turn never runs.
                 this.scheduled = false;
-                this.debounceTimer = undefined;
+                await this.continue();
+                return;
+            case 'retry':
+                this.errorRetryArmed = false;
+                this.scheduleProcessing();
+                return;
+        }
+    }
+    /** One debounce-callback check. Never rejects: on error it cancels the schedule. */
+    async runDebounceCheck(scheduleNext) {
+        try {
+            // Re-read state fresh each check — no stale data
+            const currentState = this.state;
+            if (!currentState) {
+                this.cancelSchedule();
+                return;
+            }
+            // Guard: schedule could be cancelled between timer fire and here
+            if (!this.scheduled)
+                return;
+            const sessionState = this.store.getState();
+            const unconsumed = getUnconsumedMessages(sessionState, this.id);
+            const pendingToolResults = currentState.pendingToolResults;
+            // If no messages, no pending tool results, and no plugin pending, nothing to do
+            if (unconsumed.length === 0 && pendingToolResults.length === 0 && !this.hasPluginPendingMessages()) {
+                this.cancelSchedule();
+                return;
+            }
+            const oldestTimestamp = unconsumed.length > 0
+                ? Math.min(...unconsumed.map((m) => m.timestamp))
+                : Date.now();
+            const oldestWaitingMs = Date.now() - oldestTimestamp;
+            const decision = await this.config.debounceCallback({
+                messages: unconsumed,
+                oldestWaitingMs,
+                totalPending: unconsumed.length,
+                pendingToolResults,
+            });
+            // Re-check after async callback — schedule could be cancelled during await
+            if (!this.scheduled)
+                return;
+            if (decision === 'process_now') {
+                this.cancelSchedule();
                 this.continue().catch((err) => {
                     this.logger.error('Unhandled error in continue()', err instanceof Error ? err : undefined, { agentId: this.id });
                 });
-            }, debounceMs);
+            }
+            else {
+                // Callback said "wait" — schedule next check. Fresh state next iteration.
+                scheduleNext();
+            }
+        }
+        catch (err) {
+            this.logger.error('Debounce check failed', err instanceof Error ? err : undefined, { agentId: this.id });
+            this.cancelSchedule();
         }
     }
     /**
@@ -291,10 +370,8 @@ export class Agent {
             // AbortError may be thrown synchronously by abort signal listeners
         }
         this.cancelSchedule();
-        if (this.errorRetryTimer) {
-            clearTimeout(this.errorRetryTimer);
-            this.errorRetryTimer = undefined;
-        }
+        this.errorRetryArmed = false;
+        this.cancelWake('retry');
     }
     /**
      * Check if processing is scheduled.
@@ -411,14 +488,19 @@ export class Agent {
      * remaining backoff and re-arms if it hasn't elapsed yet.
      */
     scheduleErrorRetry(delayMs) {
-        if (this.errorRetryTimer)
+        if (this.errorRetryArmed)
             return;
         if (this.store.isClosed())
             return;
-        this.errorRetryTimer = setTimeout(() => {
-            this.errorRetryTimer = undefined;
-            this.scheduleProcessing();
-        }, delayMs);
+        // Nothing cancels a wake armed after shutdown(), and delivering it would
+        // reload a session this host has already torn down.
+        if (this.abortController.signal.aborted)
+            return;
+        this.errorRetryArmed = true;
+        // The backoff itself is unleased: a provider that keeps failing would
+        // otherwise pin the runtime resident forever, and the preserved dequeue
+        // token is in the event log, so a rebuilt runtime still has the work.
+        this.armWake('retry', delayMs);
     }
     static MAX_INFERENCE_RETRIES = 3;
     /** Max retries for empty-stop LLM responses (provider glitch). Total attempts = this + 1. */
@@ -435,7 +517,6 @@ export class Agent {
         // Need either tool results or plugin messages to process
         if (!hasToolResults && pluginDequeued.length === 0)
             return;
-        this.turnNumber++;
         // 0. beforeInference handler - can skip LLM entirely or pause
         const beforeResult = await this.executeBeforeInference(agentState);
         if (beforeResult !== null) {
@@ -653,8 +734,7 @@ export class Agent {
                     // double-append. Tokens are still unconsumed, so the recursion
                     // re-collects the same messages — nothing is lost or duplicated.
                     await this.store.emit(withSessionId(this.store.sessionId, llmEvents.create('inference_retried', { agentId: this.id })));
-                    // Retry inference - decrement turn number and recursively call with fresh state
-                    this.turnNumber--;
+                    // Retry inference — the turn never committed, so it keeps its number.
                     const freshState = this.state;
                     if (!freshState)
                         return;
@@ -710,12 +790,41 @@ export class Agent {
      * Cancel any scheduled processing.
      */
     cancelSchedule() {
-        if (this.debounceTimer) {
-            clearTimeout(this.debounceTimer);
-            this.debounceTimer = undefined;
+        if (this.debounceCheckTimer) {
+            clearTimeout(this.debounceCheckTimer);
+            this.debounceCheckTimer = undefined;
         }
+        this.cancelWake('debounce');
         this.scheduled = false;
         this.pendingReschedule = false;
+        this.releaseScheduledLease?.();
+        this.releaseScheduledLease = undefined;
+    }
+    /** The host scheduler, or null once the runtime is gone — a disposed session builds no context. */
+    tryGetScheduler() {
+        if (this.scheduler)
+            return this.scheduler;
+        try {
+            this.scheduler = this.getSessionContext().platform.scheduler;
+            return this.scheduler;
+        }
+        catch {
+            return null;
+        }
+    }
+    /**
+     * Arm a wake without awaiting the host: scheduleProcessing() and shutdown() are
+     * synchronous, while a host may persist the wake asynchronously.
+     */
+    armWake(kind, delayMs) {
+        this.tryGetScheduler()?.wake(agentWakeKey(this.store.sessionId, this.id, kind), delayMs).catch((err) => {
+            this.logger.error('Failed to arm scheduler wake', err instanceof Error ? err : undefined, { agentId: this.id, kind });
+        });
+    }
+    cancelWake(kind) {
+        this.tryGetScheduler()?.cancel(agentWakeKey(this.store.sessionId, this.id, kind)).catch((err) => {
+            this.logger.error('Failed to cancel scheduler wake', err instanceof Error ? err : undefined, { agentId: this.id, kind });
+        });
     }
     /**
      * Execute a single tool call.
@@ -838,20 +947,26 @@ export class Agent {
      * Build base AgentContext for handler/hook calls.
      */
     buildAgentContext(agentState) {
+        const sessionContext = this.getSessionContext();
         return {
-            // SessionContext fields (refreshed from store for up-to-date state)
-            sessionId: this.sessionContext.sessionId,
+            // SessionContext fields are rebuilt for up-to-date state.
+            sessionId: sessionContext.sessionId,
             sessionState: this.store.getState(),
-            sessionInput: this.sessionContext.sessionInput,
-            environment: this.sessionContext.environment,
-            llm: this.sessionContext.llm,
-            files: this.sessionContext.files,
-            eventStore: this.sessionContext.eventStore,
-            llmLogger: this.sessionContext.llmLogger,
-            platform: this.sessionContext.platform,
+            getSessionState: sessionContext.getSessionState,
+            sessionInput: sessionContext.sessionInput,
+            environment: sessionContext.environment,
+            llm: sessionContext.llm,
+            files: sessionContext.files,
+            eventStore: sessionContext.eventStore,
+            llmLogger: sessionContext.llmLogger,
+            platform: sessionContext.platform,
             logger: this.logger,
-            emitEvent: this.sessionContext.emitEvent,
-            notify: this.sessionContext.notify,
+            runtimeActivity: sessionContext.runtimeActivity,
+            reserveSequence: sessionContext.reserveSequence,
+            reserveMailboxMessageSequence: sessionContext.reserveMailboxMessageSequence,
+            emitEvent: sessionContext.emitEvent,
+            emitEvents: sessionContext.emitEvents,
+            notify: sessionContext.notify,
             // AgentContext fields
             agentId: this.id,
             agentState,