@telora/daemon 0.13.17 → 0.13.19

package/dist/loop-engine.d.ts

@@ -0,0 +1,115 @@
+/**
+ * LoopEngine -- ExecutionEngine adapter for the Loop Agent (differential receiver).
+ *
+ * The Loop Agent is a monitoring-only engine that does NOT spawn Claude Code
+ * processes. It polls for strategies with loop data, computes variance between
+ * intent (loop documents/questions) and forecasted reality (metrics/projections),
+ * and when variance shifts enough, calls the LLM to re-evaluate loop data.
+ *
+ * Lifecycle (called by the process shell):
+ *   1. init(config)           -- validate config, initialize API client
+ *   2. recoverFromCrash()     -- no-op (no worktrees or processes to recover)
+ *   3. start()                -- begin adaptive poll loop
+ *   4. stop()                 -- clear intervals, set shutting-down flag
+ *   5. shutdown()             -- no-op (no processes to kill)
+ */
+import type { ExecutionEngine, EngineHealth, ResourceUsage, BaseConfig, ResourceGovernor } from '@telora/daemon-core';
+export interface LoopEventTriggerConfig {
+    /** Trigger on delivery completion. Default: true. */
+    deliveryCompleted: boolean;
+    /** Trigger on strategy status change. Default: true. */
+    strategyStatusChanged: boolean;
+    /** Trigger on review completion. Default: true. */
+    reviewCompleted: boolean;
+}
+export interface LoopEngineConfig {
+    /** Whether the loop engine is enabled. Default: true. */
+    enabled: boolean;
+    /** Poll interval when active strategies with loop data exist (ms). Default: 60000. */
+    activeIntervalMs: number;
+    /** Poll interval when idle (no active strategies). Default: 300000 (5min). */
+    idleIntervalMs: number;
+    /** Minimum interval between LLM evaluations per strategy (ms). Default: 300000 (5min). */
+    minEvaluationIntervalMs: number;
+    /** Force re-evaluation even without events after this threshold (ms). Default: 86400000 (24h). */
+    staleThresholdMs: number;
+    /** Event triggers that cause immediate re-evaluation. Default: all enabled. */
+    eventTriggers: LoopEventTriggerConfig;
+}
+export declare class LoopEngine implements ExecutionEngine {
+    readonly name = "loop";
+    private config;
+    private loopConfig;
+    private governor;
+    private pollTimeout;
+    private shuttingDown;
+    /** Number of active strategies with loop data from last poll. */
+    private activeStrategyCount;
+    /** Last poll timestamp for health reporting. */
+    private lastPollAt;
+    /** Per-strategy last LLM evaluation timestamp. */
+    private lastEvaluationAt;
+    /** Per-strategy last computed variance (for threshold comparison). */
+    private lastVariance;
+    /** Strategies that have been triggered by lifecycle events (pending immediate evaluation). */
+    private triggeredStrategies;
+    /** Cleanup function for event bus subscription. */
+    private unsubscribeEvents;
+    setGovernor(gov: ResourceGovernor): void;
+    init(config: BaseConfig & Record<string, unknown>): Promise<void>;
+    recoverFromCrash(): Promise<void>;
+    start(): Promise<void>;
+    stop(): void;
+    shutdown(): Promise<void>;
+    healthCheck(): EngineHealth;
+    getResourceUsage(): ResourceUsage;
+    private runPollCycle;
+    /**
+     * Poll a single product for strategies with loop data.
+     * Returns the number of active strategies processed.
+     */
+    private pollProduct;
+    /**
+     * Process a single strategy: load intent + reality, compute variance,
+     * optionally call LLM for updates, persist variance snapshot.
+     */
+    private processStrategy;
+    /**
+     * Load loop data (intent) for a strategy.
+     */
+    private loadIntentData;
+    /**
+     * Load reality data (metrics + projections) for a strategy.
+     */
+    private loadRealityData;
+    /**
+     * Persist variance snapshot to the database.
+     */
+    private persistVarianceSnapshot;
+    /**
+     * Determine whether to trigger an LLM update based on:
+     * - Minimum interval between evaluations (debounce)
+     * - Event-aware: new activity since last evaluation
+     * - Variance change beyond threshold
+     * - Stale loop data
+     */
+    private shouldTriggerLLMUpdate;
+    /**
+     * Run the LLM to re-evaluate loop data given current variance.
+     */
+    private runLLMUpdate;
+    /**
+     * Apply parsed LLM updates back to loop data via edge function.
+     */
+    private applyLoopUpdates;
+    /**
+     * Handle a lifecycle event from the strategy engine.
+     * Marks the strategy for immediate re-evaluation on the next poll cycle.
+     */
+    private handleLifecycleEvent;
+    /**
+     * Schedule the next poll cycle using adaptive interval.
+     */
+    private scheduleNextPoll;
+}
+//# sourceMappingURL=loop-engine.d.ts.map

package/dist/loop-engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loop-engine.d.ts","sourceRoot":"","sources":["../src/loop-engine.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EACV,eAAe,EACf,YAAY,EACZ,aAAa,EACb,UAAU,EACV,gBAAgB,EACjB,MAAM,qBAAqB,CAAC;AAY7B,MAAM,WAAW,sBAAsB;IACrC,qDAAqD;IACrD,iBAAiB,EAAE,OAAO,CAAC;IAC3B,wDAAwD;IACxD,qBAAqB,EAAE,OAAO,CAAC;IAC/B,mDAAmD;IACnD,eAAe,EAAE,OAAO,CAAC;CAC1B;AAED,MAAM,WAAW,gBAAgB;IAC/B,yDAAyD;IACzD,OAAO,EAAE,OAAO,CAAC;IACjB,sFAAsF;IACtF,gBAAgB,EAAE,MAAM,CAAC;IACzB,8EAA8E;IAC9E,cAAc,EAAE,MAAM,CAAC;IACvB,0FAA0F;IAC1F,uBAAuB,EAAE,MAAM,CAAC;IAChC,kGAAkG;IAClG,gBAAgB,EAAE,MAAM,CAAC;IACzB,+EAA+E;IAC/E,aAAa,EAAE,sBAAsB,CAAC;CACvC;AA2DD,qBAAa,UAAW,YAAW,eAAe;IAChD,QAAQ,CAAC,IAAI,UAAU;IAEvB,OAAO,CAAC,MAAM,CAA6B;IAC3C,OAAO,CAAC,UAAU,CAAgD;IAClE,OAAO,CAAC,QAAQ,CAAiC;IAEjD,OAAO,CAAC,WAAW,CAA8C;IACjE,OAAO,CAAC,YAAY,CAAS;IAE7B,iEAAiE;IACjE,OAAO,CAAC,mBAAmB,CAAK;IAEhC,gDAAgD;IAChD,OAAO,CAAC,UAAU,CAAqB;IAEvC,kDAAkD;IAClD,OAAO,CAAC,gBAAgB,CAAkC;IAE1D,sEAAsE;IACtE,OAAO,CAAC,YAAY,CAA0C;IAE9D,8FAA8F;IAC9F,OAAO,CAAC,mBAAmB,CAA0B;IAErD,mDAAmD;IACnD,OAAO,CAAC,iBAAiB,CAA6B;IAMtD,WAAW,CAAC,GAAG,EAAE,gBAAgB,GAAG,IAAI;IASlC,IAAI,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAuCjE,gBAAgB,IAAI,OAAO,CAAC,IAAI,CAAC;IAQjC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAmB5B,IAAI,IAAI,IAAI;IAgBN,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAQ/B,WAAW,IAAI,YAAY;IAkB3B,gBAAgB,IAAI,aAAa;YAWnB,YAAY;IAqB1B;;;OAGG;YACW,WAAW;IAgCzB;;;OAGG;YACW,eAAe;IAgC7B;;OAEG;YACW,cAAc;IA6C5B;;OAEG;YACW,eAAe;IAe7B;;OAEG;YACW,uBAAuB;IAerC;;;;;;OAMG;IACH,OAAO,CAAC,sBAAsB;IAoE9B;;OAEG;YACW,YAAY;IAmC1B;;OAEG;YACW,gBAAgB;IAsD9B;;;OAGG;IACH,OAAO,CAAC,oBAAoB;IAe5B;;OAEG;IACH,OAAO,CAAC,gBAAgB;CAqBzB"}

package/dist/loop-engine.js

@@ -0,0 +1,498 @@
+/**
+ * LoopEngine -- ExecutionEngine adapter for the Loop Agent (differential receiver).
+ *
+ * The Loop Agent is a monitoring-only engine that does NOT spawn Claude Code
+ * processes. It polls for strategies with loop data, computes variance between
+ * intent (loop documents/questions) and forecasted reality (metrics/projections),
+ * and when variance shifts enough, calls the LLM to re-evaluate loop data.
+ *
+ * Lifecycle (called by the process shell):
+ *   1. init(config)           -- validate config, initialize API client
+ *   2. recoverFromCrash()     -- no-op (no worktrees or processes to recover)
+ *   3. start()                -- begin adaptive poll loop
+ *   4. stop()                 -- clear intervals, set shutting-down flag
+ *   5. shutdown()             -- no-op (no processes to kill)
+ */
+import { initSupabase, callApi } from './queries/shared.js';
+import { computeVariance } from './loop-variance.js';
+import { buildLoopUpdatePrompt, parseLoopUpdateResponse } from './loop-prompt-builder.js';
+import { callLoopLLM } from './loop-llm-client.js';
+import { onLoopTrigger } from './loop-event-bus.js';
+const DEFAULT_EVENT_TRIGGERS = {
+    deliveryCompleted: true,
+    strategyStatusChanged: true,
+    reviewCompleted: true,
+};
+const DEFAULT_LOOP_CONFIG = {
+    enabled: true,
+    activeIntervalMs: 60_000,
+    idleIntervalMs: 300_000,
+    minEvaluationIntervalMs: 300_000,
+    staleThresholdMs: 86_400_000,
+    eventTriggers: { ...DEFAULT_EVENT_TRIGGERS },
+};
+// ---------------------------------------------------------------------------
+// LoopEngine
+// ---------------------------------------------------------------------------
+export class LoopEngine {
+    name = 'loop';
+    config = null;
+    loopConfig = { ...DEFAULT_LOOP_CONFIG };
+    governor = null;
+    pollTimeout = null;
+    shuttingDown = false;
+    /** Number of active strategies with loop data from last poll. */
+    activeStrategyCount = 0;
+    /** Last poll timestamp for health reporting. */
+    lastPollAt = null;
+    /** Per-strategy last LLM evaluation timestamp. */
+    lastEvaluationAt = new Map();
+    /** Per-strategy last computed variance (for threshold comparison). */
+    lastVariance = new Map();
+    /** Strategies that have been triggered by lifecycle events (pending immediate evaluation). */
+    triggeredStrategies = new Set();
+    /** Cleanup function for event bus subscription. */
+    unsubscribeEvents = null;
+    // -----------------------------------------------------------------------
+    // setGovernor
+    // -----------------------------------------------------------------------
+    setGovernor(gov) {
+        this.governor = gov;
+        // Loop engine does not acquire governor slots (no Claude processes)
+    }
+    // -----------------------------------------------------------------------
+    // init
+    // -----------------------------------------------------------------------
+    async init(config) {
+        this.config = config;
+        // Resolve loop config from the raw config
+        const loopSection = config.loop;
+        if (loopSection && typeof loopSection === 'object') {
+            const lc = loopSection;
+            // Parse event triggers config
+            const etRaw = lc.eventTriggers;
+            let eventTriggers = { ...DEFAULT_EVENT_TRIGGERS };
+            if (etRaw && typeof etRaw === 'object') {
+                const et = etRaw;
+                eventTriggers = {
+                    deliveryCompleted: typeof et.deliveryCompleted === 'boolean' ? et.deliveryCompleted : DEFAULT_EVENT_TRIGGERS.deliveryCompleted,
+                    strategyStatusChanged: typeof et.strategyStatusChanged === 'boolean' ? et.strategyStatusChanged : DEFAULT_EVENT_TRIGGERS.strategyStatusChanged,
+                    reviewCompleted: typeof et.reviewCompleted === 'boolean' ? et.reviewCompleted : DEFAULT_EVENT_TRIGGERS.reviewCompleted,
+                };
+            }
+            this.loopConfig = {
+                enabled: typeof lc.enabled === 'boolean' ? lc.enabled : DEFAULT_LOOP_CONFIG.enabled,
+                activeIntervalMs: typeof lc.activeIntervalMs === 'number' ? lc.activeIntervalMs : DEFAULT_LOOP_CONFIG.activeIntervalMs,
+                idleIntervalMs: typeof lc.idleIntervalMs === 'number' ? lc.idleIntervalMs : DEFAULT_LOOP_CONFIG.idleIntervalMs,
+                minEvaluationIntervalMs: typeof lc.minEvaluationIntervalMs === 'number' ? lc.minEvaluationIntervalMs : DEFAULT_LOOP_CONFIG.minEvaluationIntervalMs,
+                staleThresholdMs: typeof lc.staleThresholdMs === 'number' ? lc.staleThresholdMs : DEFAULT_LOOP_CONFIG.staleThresholdMs,
+                eventTriggers,
+            };
+        }
+        // Initialize API client (idempotent)
+        initSupabase(this.config);
+        console.log('[Loop] Engine initialized');
+    }
+    // -----------------------------------------------------------------------
+    // recoverFromCrash
+    // -----------------------------------------------------------------------
+    async recoverFromCrash() {
+        console.log('[Loop] No crash recovery needed (monitoring-only engine)');
+    }
+    // -----------------------------------------------------------------------
+    // start
+    // -----------------------------------------------------------------------
+    async start() {
+        this.shuttingDown = false;
+        // Subscribe to lifecycle events from the strategy engine
+        this.unsubscribeEvents = onLoopTrigger((event) => this.handleLifecycleEvent(event));
+        // Run initial poll immediately
+        await this.runPollCycle();
+        // Schedule next poll with adaptive interval
+        this.scheduleNextPoll();
+        console.log('[Loop] Engine started (adaptive polling active, event triggers subscribed)');
+    }
+    // -----------------------------------------------------------------------
+    // stop
+    // -----------------------------------------------------------------------
+    stop() {
+        this.shuttingDown = true;
+        if (this.pollTimeout !== null) {
+            clearTimeout(this.pollTimeout);
+            this.pollTimeout = null;
+        }
+        if (this.unsubscribeEvents) {
+            this.unsubscribeEvents();
+            this.unsubscribeEvents = null;
+        }
+    }
+    // -----------------------------------------------------------------------
+    // shutdown
+    // -----------------------------------------------------------------------
+    async shutdown() {
+        console.log('[Loop] Shutdown complete');
+    }
+    // -----------------------------------------------------------------------
+    // healthCheck
+    // -----------------------------------------------------------------------
+    healthCheck() {
+        return {
+            status: this.config ? 'healthy' : 'unhealthy',
+            activeWorkItems: this.activeStrategyCount,
+            details: {
+                activeStrategyCount: this.activeStrategyCount,
+                lastPollAt: this.lastPollAt?.toISOString() ?? null,
+                currentPollIntervalMs: this.activeStrategyCount > 0
+                    ? this.loopConfig.activeIntervalMs
+                    : this.loopConfig.idleIntervalMs,
+            },
+        };
+    }
+    // -----------------------------------------------------------------------
+    // getResourceUsage
+    // -----------------------------------------------------------------------
+    getResourceUsage() {
+        return {
+            activeClaudeProcesses: 0,
+            activeWorktrees: 0,
+        };
+    }
+    // -----------------------------------------------------------------------
+    // Private: poll cycle
+    // -----------------------------------------------------------------------
+    async runPollCycle() {
+        const config = this.config;
+        if (!config)
+            return;
+        this.lastPollAt = new Date();
+        let totalActiveStrategies = 0;
+        for (const product of config.products) {
+            try {
+                const count = await this.pollProduct(product.id);
+                totalActiveStrategies += count;
+            }
+            catch (err) {
+                console.log(`[Loop] Poll failed for product ${product.id}: ${err instanceof Error ? err.message : String(err)}`);
+            }
+        }
+        this.activeStrategyCount = totalActiveStrategies;
+    }
+    /**
+     * Poll a single product for strategies with loop data.
+     * Returns the number of active strategies processed.
+     */
+    async pollProduct(productId) {
+        // Fetch active strategies for this product
+        let strategies;
+        try {
+            const result = await callApi('strategy_list', {
+                productId,
+                status: 'active',
+            });
+            strategies = result.items ?? [];
+        }
+        catch (err) {
+            console.log(`[Loop] Failed to fetch strategies for product ${productId}: ${err instanceof Error ? err.message : String(err)}`);
+            return 0;
+        }
+        if (strategies.length === 0)
+            return 0;
+        let processed = 0;
+        for (const strategy of strategies) {
+            try {
+                await this.processStrategy(strategy);
+                processed++;
+            }
+            catch (err) {
+                console.log(`[Loop] Failed to process strategy ${strategy.id}: ${err instanceof Error ? err.message : String(err)}`);
+            }
+        }
+        return processed;
+    }
+    /**
+     * Process a single strategy: load intent + reality, compute variance,
+     * optionally call LLM for updates, persist variance snapshot.
+     */
+    async processStrategy(strategy) {
+        // 1. Load intent data (loop documents + questions + answers)
+        const intent = await this.loadIntentData(strategy.id);
+        // Skip strategies with no loop data (not yet initialized)
+        if (intent.documents.length === 0 && intent.questions.length === 0) {
+            return;
+        }
+        // 2. Load reality data (metrics + projections)
+        const reality = await this.loadRealityData(strategy.id);
+        // 3. Compute variance (pass previous for trend direction)
+        const previousVariance = this.lastVariance.get(strategy.id) ?? null;
+        const variance = computeVariance(intent, reality, strategy.targetDate ?? null, previousVariance);
+        // 4. Persist variance snapshot
+        await this.persistVarianceSnapshot(strategy, variance);
+        // 5. Determine if LLM update is needed
+        const shouldUpdate = this.shouldTriggerLLMUpdate(strategy.id, variance, reality);
+        if (shouldUpdate) {
+            console.log(`[Loop] Triggering LLM update for strategy "${strategy.name}" (${strategy.id.slice(0, 8)}) -- lock: ${variance.lockStatus}`);
+            await this.runLLMUpdate(strategy, intent, reality, variance);
+            this.lastEvaluationAt.set(strategy.id, Date.now());
+        }
+        // 6. Store variance for threshold comparison
+        this.lastVariance.set(strategy.id, variance);
+    }
+    /**
+     * Load loop data (intent) for a strategy.
+     */
+    async loadIntentData(strategyId) {
+        const [docsResult, questionsResult, personaResult] = await Promise.all([
+            callApi('loop_document_list', {
+                entityType: 'strategy',
+                entityId: strategyId,
+                detail: 'full',
+                limit: 50,
+            }).catch(() => ({ items: [] })),
+            callApi('loop_question_list', {
+                entityType: 'strategy',
+                entityId: strategyId,
+                detail: 'full',
+                limit: 50,
+            }).catch(() => ({ items: [] })),
+            callApi('loop_persona_get', {
+                entityType: 'strategy',
+                entityId: strategyId,
+            }).catch(() => ({ persona: null })),
+        ]);
+        // Fetch answers for each question
+        const questionsWithAnswers = await Promise.all((questionsResult.items ?? []).map(async (q) => {
+            try {
+                const answerResult = await callApi('loop_answer_get', {
+                    questionId: q.id,
+                });
+                return {
+                    ...q,
+                    answer: answerResult.answer?.content ?? null,
+                };
+            }
+            catch {
+                return { ...q, answer: null };
+            }
+        }));
+        return {
+            documents: docsResult.items ?? [],
+            questions: questionsWithAnswers,
+            persona: personaResult.persona?.content ?? null,
+            proposedPersona: personaResult.persona?.proposedContent ?? null,
+        };
+    }
+    /**
+     * Load reality data (metrics + projections) for a strategy.
+     */
+    async loadRealityData(strategyId) {
+        try {
+            const result = await callApi('reality_metrics_strategy', {
+                strategyId,
+            });
+            return {
+                metrics: result.metrics,
+                projections: result.projections,
+            };
+        }
+        catch (err) {
+            console.log(`[Loop] Failed to load reality data for strategy ${strategyId}: ${err instanceof Error ? err.message : String(err)}`);
+            return { metrics: null, projections: { completion: null, cost: null } };
+        }
+    }
+    /**
+     * Persist variance snapshot to the database.
+     */
+    async persistVarianceSnapshot(strategy, variance) {
+        try {
+            await callApi('loop_variance_upsert', {
+                entityType: 'strategy',
+                entityId: strategy.id,
+                varianceData: variance,
+            });
+        }
+        catch (err) {
+            console.log(`[Loop] Failed to persist variance snapshot for strategy ${strategy.id}: ${err instanceof Error ? err.message : String(err)}`);
+        }
+    }
+    /**
+     * Determine whether to trigger an LLM update based on:
+     * - Minimum interval between evaluations (debounce)
+     * - Event-aware: new activity since last evaluation
+     * - Variance change beyond threshold
+     * - Stale loop data
+     */
+    shouldTriggerLLMUpdate(strategyId, variance, reality) {
+        const now = Date.now();
+        const lastEval = this.lastEvaluationAt.get(strategyId) ?? 0;
+        // Enforce minimum interval (debounce bursts)
+        if (now - lastEval < this.loopConfig.minEvaluationIntervalMs) {
+            return false;
+        }
+        // Force update if stale
+        if (now - lastEval > this.loopConfig.staleThresholdMs) {
+            return true;
+        }
+        // Event-driven trigger: lifecycle event flagged this strategy for re-evaluation
+        if (this.triggeredStrategies.has(strategyId)) {
+            this.triggeredStrategies.delete(strategyId);
+            return true;
+        }
+        // Event-aware trigger: check if new activity occurred since last evaluation
+        // Uses last_session_at from reality metrics as a proxy for recent events
+        const metrics = reality.metrics;
+        if (metrics?.last_session_at && lastEval > 0) {
+            const lastSessionAt = new Date(metrics.last_session_at).getTime();
+            if (lastSessionAt > lastEval) {
+                return true; // New agent activity since last evaluation
+            }
+        }
+        // Compare with previous variance
+        const prevVariance = this.lastVariance.get(strategyId);
+        if (!prevVariance) {
+            // First evaluation -- always run
+            return true;
+        }
+        // Trigger if lock status changed
+        if (prevVariance.lockStatus !== variance.lockStatus) {
+            return true;
+        }
+        // Trigger if any noise flag changed
+        if (JSON.stringify(prevVariance.noiseFlags) !== JSON.stringify(variance.noiseFlags)) {
+            return true;
+        }
+        // Trigger if schedule variance crossed a threshold (>= 2 day change)
+        const prevScheduleDays = prevVariance.dimensions.schedule?.varianceDays ?? 0;
+        const currScheduleDays = variance.dimensions.schedule?.varianceDays ?? 0;
+        if (Math.abs(currScheduleDays - prevScheduleDays) >= 2) {
+            return true;
+        }
+        // Trigger if throughput trend changed
+        const prevTrend = prevVariance.dimensions.throughput?.trend;
+        const currTrend = variance.dimensions.throughput?.trend;
+        if (prevTrend && currTrend && prevTrend !== currTrend) {
+            return true;
+        }
+        return false;
+    }
+    /**
+     * Run the LLM to re-evaluate loop data given current variance.
+     */
+    async runLLMUpdate(strategy, intent, reality, variance) {
+        try {
+            // Build the prompt
+            const prompt = buildLoopUpdatePrompt(intent, reality, variance);
+            // Call the LLM
+            const rawResponse = await callLoopLLM(strategy.organizationId, prompt);
+            if (!rawResponse) {
+                console.log(`[Loop] LLM returned empty response for strategy ${strategy.id}`);
+                return;
+            }
+            // Parse the response
+            const updates = parseLoopUpdateResponse(rawResponse);
+            // Write updates back
+            await this.applyLoopUpdates(strategy.id, updates);
+            console.log(`[Loop] Applied updates for strategy "${strategy.name}": ` +
+                `${updates.documentReorders.length} re-ranks, ` +
+                `${updates.answerUpdates.length} answers, ` +
+                `${updates.newQuestions.length} new questions` +
+                `${updates.personaProposal ? ', 1 persona proposal' : ''}`);
+        }
+        catch (err) {
+            console.log(`[Loop] LLM update failed for strategy ${strategy.id}: ${err instanceof Error ? err.message : String(err)}`);
+        }
+    }
+    /**
+     * Apply parsed LLM updates back to loop data via edge function.
+     */
+    async applyLoopUpdates(strategyId, updates) {
+        // Re-rank documents
+        if (updates.documentReorders.length > 0) {
+            try {
+                await callApi('loop_document_reorder', {
+                    entityType: 'strategy',
+                    entityId: strategyId,
+                    documentIds: updates.documentReorders,
+                });
+            }
+            catch (err) {
+                console.log(`[Loop] Failed to reorder documents: ${err instanceof Error ? err.message : String(err)}`);
+            }
+        }
+        // Update answers
+        for (const answerUpdate of updates.answerUpdates) {
+            try {
+                await callApi('loop_answer_upsert', {
+                    questionId: answerUpdate.questionId,
+                    content: answerUpdate.content,
+                });
+            }
+            catch (err) {
+                console.log(`[Loop] Failed to update answer for question ${answerUpdate.questionId}: ${err instanceof Error ? err.message : String(err)}`);
+            }
+        }
+        // Create new questions
+        for (const newQuestion of updates.newQuestions) {
+            try {
+                await callApi('loop_question_create', {
+                    entityType: 'strategy',
+                    entityId: strategyId,
+                    text: newQuestion.text,
+                    questionType: 'generated',
+                });
+            }
+            catch (err) {
+                console.log(`[Loop] Failed to create question: ${err instanceof Error ? err.message : String(err)}`);
+            }
+        }
+        // Propose persona adjustment
+        if (updates.personaProposal) {
+            try {
+                await callApi('loop_persona_propose', {
+                    entityType: 'strategy',
+                    entityId: strategyId,
+                    proposedContent: updates.personaProposal,
+                });
+            }
+            catch (err) {
+                console.log(`[Loop] Failed to propose persona: ${err instanceof Error ? err.message : String(err)}`);
+            }
+        }
+    }
+    /**
+     * Handle a lifecycle event from the strategy engine.
+     * Marks the strategy for immediate re-evaluation on the next poll cycle.
+     */
+    handleLifecycleEvent(event) {
+        const triggers = this.loopConfig.eventTriggers;
+        // Check if this event type is enabled
+        const eventEnabled = (event.type === 'delivery_completed' && triggers.deliveryCompleted) ||
+            (event.type === 'strategy_status_changed' && triggers.strategyStatusChanged) ||
+            (event.type === 'review_completed' && triggers.reviewCompleted);
+        if (!eventEnabled)
+            return;
+        this.triggeredStrategies.add(event.strategyId);
+        console.log(`[Loop] Event trigger: ${event.type} for strategy ${event.strategyId.slice(0, 8)}${event.detail ? ` (${event.detail})` : ''}`);
+    }
+    /**
+     * Schedule the next poll cycle using adaptive interval.
+     */
+    scheduleNextPoll() {
+        if (this.shuttingDown)
+            return;
+        const intervalMs = this.activeStrategyCount > 0
+            ? this.loopConfig.activeIntervalMs
+            : this.loopConfig.idleIntervalMs;
+        this.pollTimeout = setTimeout(async () => {
+            if (this.shuttingDown)
+                return;
+            try {
+                await this.runPollCycle();
+            }
+            catch (err) {
+                console.log(`[Loop] Poll cycle error: ${err instanceof Error ? err.message : String(err)}`);
+            }
+            this.scheduleNextPoll();
+        }, intervalMs);
+    }
+}
+//# sourceMappingURL=loop-engine.js.map

package/dist/loop-engine.js.map

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

package/dist/loop-event-bus.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Loop Event Bus -- lightweight pub/sub for lifecycle events that trigger
+ * Loop Agent re-evaluation.
+ *
+ * The strategy engine emits events when deliveries complete, strategies change,
+ * or reviews finish. The Loop Engine subscribes and schedules immediate
+ * re-evaluation for the affected strategy (subject to debounce).
+ *
+ * Singleton pattern: both emitter and subscriber import this module.
+ */
+export type LoopTriggerEventType = 'delivery_completed' | 'strategy_status_changed' | 'review_completed';
+export interface LoopTriggerEvent {
+    type: LoopTriggerEventType;
+    strategyId: string;
+    /** Optional context about what triggered the event. */
+    detail?: string;
+}
+/**
+ * Emit a lifecycle event that may trigger Loop Agent re-evaluation.
+ * Called from strategy engine components (delivery-lifecycle, state-cascade, etc.).
+ */
+export declare function emitLoopTrigger(event: LoopTriggerEvent): void;
+/**
+ * Subscribe to lifecycle events. Called by LoopEngine on start.
+ * Returns a cleanup function to unsubscribe.
+ */
+export declare function onLoopTrigger(handler: (event: LoopTriggerEvent) => void): () => void;
+//# sourceMappingURL=loop-event-bus.d.ts.map